Skip to content
Pharaoh Pharaoh Pharaoh Docs

Action Builder

Action Builder is the endpoint-scoped Start Session flow for preparing a safety-first session-launch draft before the operator creates the final launch record.

Where It Lives

Section titled “Where It Lives”

This flow uses the endpoint-scoped Start Session route:

  • /endpoints/<endpoint-id>/session-launch

In the shell, the page title is Start Session and the page header title is Session Launch Wizard.

Session launch wizard showing the real confirmation step before creating an endpoint session.

What The Wizard Does

Section titled “What The Wizard Does”

The wizard breaks the launch draft into explicit steps:

  1. Instruction Builder
  2. Execution Guardrails
  3. Application Guardrails
  4. File & Folder Guardrails
  5. Network Guardrails
  6. Soft Policies
  7. Confirmation

The right-side context panel keeps the operator anchored with:

  • flow context
  • an impact snapshot for the target endpoint
  • builder status and prediction state

Operator Expectations

Section titled “Operator Expectations”

The wizard is for drafting and confirming a guarded session launch, not for free-form chat.

Key behaviors to expect:

  • the instruction step includes an Instruction Assistant Chat area plus the current Instruction plan
  • hard-guardrail steps require deterministic choices such as enforcement mode and rules
  • Soft Policies accepts natural-language AI constraints, one policy per line
  • Confirmation requires an explicit acknowledgment before Confirm and Create

When confirmation succeeds, Pharaoh creates an auditable launch record and returns the operator to the endpoint sessions area.

Important Boundary

Section titled “Important Boundary”

The action-builder flow is distinct from the simpler “start from the session workspace” path. The workspace can create a session directly from a selected guardrail template, while the action-builder route walks through a fuller launch-draft process first.

Use the action-builder route when your workflow needs a reviewed launch draft and explicit guardrail-by-guardrail setup before session creation.

Section titled “Related Pages”