@wjarka/cezarion 0.14.4 → 0.14.5-pr465.718

package/README.md

@@ -472,6 +472,7 @@ The provisioned command has these forms (the session instructions supply the abs
 ```sh
 cez worker spawn --baseline parent-head --request-id <UUID> 'Implement the assigned change'
 cez worker spawn --baseline parent-head --request-id <UUID> --backend codex --effort high --context-file ./selected-context.txt 'Review the parser'
+cez worker spawn --baseline parent-head --request-id <UUID> --workflow review 'Review the parser change'
 cez worker inspect <worker-id>
 cez worker steer <worker-id> 'Consider this additional constraint'
 cez worker diff <worker-id>
@@ -492,7 +493,9 @@ cez worker stop <worker-id>
 cez worker destroy <worker-id>
 ```
 
-Commands return bounded JSON and a nonzero exit on failure or incomplete cleanup. Spawn requires a committed baseline (`parent-head` or an explicit ref) and pins its SHA at acceptance; dirty parent edits are excluded. Optional `--context '<text>'` or `--context-file <UTF-8-file>` supplies selected context, not the parent's conversation. The two flags are mutually exclusive, and combined task/context text is limited to 100,000 characters. The API also accepts up to 32 pinned-baseline file or parent-attachment references, with at most 8 MiB of copied attachments. Inspect reports worker-local input locations. Reuse a request ID only with the same task, baseline, context, backend, model and effort when retrying a lost response. There are at most 32 accepted creations per parent, counting destroyed workers, and 32 undelivered steering messages per worker.
+Use `cez worker --help` to list operations and flags, or `cez worker <operation> --help` for one operation. Explicit help prints human-readable text and exits successfully without an active delegation session. Commands otherwise return bounded JSON and a nonzero exit on failure or incomplete cleanup. Spawn requires a committed baseline (`parent-head` or an explicit ref) and pins its SHA at acceptance; dirty parent edits are excluded. Optional `--context '<text>'` or `--context-file <UTF-8-file>` supplies selected context, not the parent's conversation. The two flags are mutually exclusive, and combined task/context text is limited to 100,000 characters. The API also accepts up to 32 pinned-baseline file or parent-attachment references, with at most 8 MiB of copied attachments. Inspect reports worker-local input locations. Reuse a request ID only with the same task, baseline, context, backend, model, effort and workflow when retrying a lost response. There are at most 32 accepted creations per parent, counting destroyed workers, and 32 undelivered steering messages per worker.
+
+`--workflow <name>` runs a catalog workflow inside the worker: the built-in `quick-task` or any `.ai/cezar/workflows/*.yaml` by name, with its agent and check steps, `skill:` bodies and `onFail` loops, so a repo's `review.yaml` becomes a dedicated reviewer. Omitted `--workflow` runs `quick-task` exactly as before. `--backend`, `--model` and `--effort` fill only the steps that leave those fields unset; a step's own `allowedTools`/`bashAllowlist` narrow the parent's grants and never widen them. An unknown name is refused. Agent steps may mix runners: at spawn every agent step is resolved and pinned separately, so an implement-with-codex, review-with-claude chain runs each step under its own runner, account, model, effort and grants. A step's optional `agentProfile` names the account it runs under (an id the registry does not know is refused); same-backend steps otherwise inherit the parent's account and other runners resolve their project/default one. Run-level columns show the first agent step.
 
 Omitted `--backend` inherits the parent's active backend. Same-backend workers inherit omitted model/account/effort; `--backend <claude|codex|opencode|pi|cursor>` selecting another backend resolves that backend's project/default account and model without forwarding another provider's settings. `--model <model>` selects a supported model, subject to existing locks. `--effort <low|medium|high|xhigh|max>` pins reasoning effort on same-backend and mixed-backend spawn; omitted `--effort` still inherits the parent pin on same-backend spawn and drops it on mixed-backend spawn. Accepted identity and grants remain fixed across queuing, restart and Continue, including explicit empty grants. Changing or deleting an account registry entry does not rebind a worker. Missing accepted identity evidence or account homes, incompatible Claude state-file layouts, and conflicting later model locks refuse execution explicitly. Credentials and vendor configuration are never copied; each worker receives its own delegation credential, and unspecified native models stay unspecified.
 
@@ -527,6 +530,7 @@ steps:
     prompt: "{{task}}"
     skill: project-conventions   # optional — from .ai/skills or .ai/cezar/skills
     # model: opus                # optional per-step model override
+    # effort: high               # optional per-step effort: low · medium · high · xhigh · max
     # runner: codex              # optional per-step backend: claude · codex · opencode · pi
     # allowedTools: [Read, Edit, Write, Grep, Glob, Bash]
   - id: verify
@@ -713,10 +717,12 @@ steps:
     name: Implement
     prompt: "{{task}}"
     runner: codex                # one vendor writes the code…
+    effort: medium               # …with a cheaper reasoning pass
   - id: review
     name: Cross-review
     prompt: "Review the diff produced for: {{task}}. Fix real issues only."
     runner: claude               # …another one reviews it
+    effort: high                 # …with more reasoning for review
   - id: verify
     name: Verify
     command: "npm test"

package/dist/automations/types.d.ts

@@ -24,6 +24,7 @@ export declare const automationTaskSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -31,6 +32,7 @@ export declare const automationTaskSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;
@@ -86,6 +88,7 @@ export declare const automationDefinitionSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -93,6 +96,7 @@ export declare const automationDefinitionSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;

package/dist/contract/automations.d.ts

@@ -65,6 +65,7 @@ export declare const automationTaskSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -72,6 +73,7 @@ export declare const automationTaskSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;
@@ -130,6 +132,7 @@ export declare const automationDefinitionSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -137,6 +140,7 @@ export declare const automationDefinitionSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -288,6 +292,7 @@ export declare const automationListEntrySchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -295,6 +300,7 @@ export declare const automationListEntrySchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -436,6 +442,7 @@ export declare const automationsResponseSchema: z.ZodObject<{
                 prompt: z.ZodOptional<z.ZodString>;
                 skill: z.ZodOptional<z.ZodString>;
                 model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
                 runner: z.ZodOptional<z.ZodEnum<{
                     claude: "claude";
                     codex: "codex";
@@ -443,6 +450,7 @@ export declare const automationsResponseSchema: z.ZodObject<{
                     opencode: "opencode";
                     pi: "pi";
                 }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
                 allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 command: z.ZodOptional<z.ZodString>;
@@ -569,6 +577,7 @@ export declare const automationResponseSchema: z.ZodObject<{
                 prompt: z.ZodOptional<z.ZodString>;
                 skill: z.ZodOptional<z.ZodString>;
                 model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
                 runner: z.ZodOptional<z.ZodEnum<{
                     claude: "claude";
                     codex: "codex";
@@ -576,6 +585,7 @@ export declare const automationResponseSchema: z.ZodObject<{
                     opencode: "opencode";
                     pi: "pi";
                 }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
                 allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 command: z.ZodOptional<z.ZodString>;
@@ -639,6 +649,7 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
                 prompt: z.ZodOptional<z.ZodString>;
                 skill: z.ZodOptional<z.ZodString>;
                 model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
                 runner: z.ZodOptional<z.ZodEnum<{
                     claude: "claude";
                     codex: "codex";
@@ -646,6 +657,7 @@ export declare const automationDetailResponseSchema: z.ZodObject<{
                     opencode: "opencode";
                     pi: "pi";
                 }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
                 allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 command: z.ZodOptional<z.ZodString>;
@@ -845,6 +857,7 @@ export declare const createAutomationInputSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -852,6 +865,7 @@ export declare const createAutomationInputSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -913,6 +927,7 @@ export declare const updateAutomationInputSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -920,6 +935,7 @@ export declare const updateAutomationInputSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;

package/dist/contract/delegation.d.ts

@@ -927,6 +927,7 @@ export declare const workerSpawnRequestSchema: z.ZodObject<{
     }>>;
     model: z.ZodOptional<z.ZodString>;
     effort: z.ZodOptional<z.ZodString>;
+    workflow: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type WorkerSpawnRequest = z.infer<typeof workerSpawnRequestSchema>;
 export declare const workerSteerRequestSchema: z.ZodObject<{

package/dist/contract/index.js

@@ -228,7 +228,9 @@ var workerSpawnRequestSchema = z3.object({
   context: workerContextSchema.optional(),
   backend: workerBackendSchema.optional(),
   model: z3.string().trim().min(1).max(512).optional(),
-  effort: effortFieldSchema
+  effort: effortFieldSchema,
+  /** Catalog workflow name (built-in quick-task or `.ai/cezar/workflows/*.yaml`, #451). Absent means quick-task. */
+  workflow: z3.string().trim().min(1).max(200).optional()
 }).strict().refine((request) => request.task.length + (request.context?.text?.length ?? 0) <= 1e5, { message: "Combined task and context exceed 100000 characters" });
 var workerSteerRequestSchema = z3.object({
   text: z3.string().max(1e5).refine((text) => text.trim().length > 0)
@@ -731,8 +733,11 @@ var workflowStepDefSchema = z8.object({
   prompt: z8.string().optional(),
   skill: z8.string().optional(),
   model: z8.string().optional(),
+  effort: z8.string().max(32).optional(),
   /** Per-step agent backend override (falls back to the task / config default). */
   runner: runnerSchema.optional(),
+  /** Agent account id for this step (spec 2026-07-29-agent-profiles); resolved per step for owned workers (#452). */
+  agentProfile: z8.string().min(1).max(64).optional(),
   allowedTools: z8.array(z8.string()).optional(),
   bashAllowlist: z8.array(z8.string()).optional(),
   // check step
@@ -1037,6 +1042,9 @@ var runRecordSchema = z9.object({
   workflowDef: workflowDefSchema.optional()
 });
 var apiRunSchema = runRecordSchema.extend({
+  /** Read-only GET /runs/:id verdict: null permits Finish, a string explains refusal.
+   * Absent on lists, stored records and mutation responses; absence is not permission. */
+  finishBlocked: z9.string().nullable().optional(),
   /** Server-resolved Cursor CLI command, including the configured executable. Never persisted. */
   cliResumeCommand: z9.string().optional(),
   usage: processUsageSchema.optional()

package/dist/contract/runs.d.ts

@@ -678,6 +678,7 @@ export declare const runRecordSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -685,6 +686,7 @@ export declare const runRecordSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -704,8 +706,8 @@ export type RunRecord = z.infer<typeof runRecordSchema>;
 /**
  * What `GET /runs` and `GET /runs/:id` answer: the stored record plus host-derived fields.
  * The live `usage` sample is absent for finished runs and wherever `ps` yields nothing.
- * Cursor resume commands use the server executable override. Neither field is persisted
- * or attached by mutation routes.
+ * Cursor resume commands use the server executable override. Finish eligibility is computed
+ * only for detail reads. These fields are never persisted or attached by mutation routes.
  */
 export declare const apiRunSchema: z.ZodObject<{
     id: z.ZodString;
@@ -1253,6 +1255,7 @@ export declare const apiRunSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -1260,6 +1263,7 @@ export declare const apiRunSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -1274,6 +1278,7 @@ export declare const apiRunSchema: z.ZodObject<{
         }>;
         path: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    finishBlocked: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cliResumeCommand: z.ZodOptional<z.ZodString>;
     usage: z.ZodOptional<z.ZodObject<{
         cpuPct: z.ZodNumber;
@@ -2074,6 +2079,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -2081,6 +2087,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -2642,6 +2649,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                 prompt: z.ZodOptional<z.ZodString>;
                 skill: z.ZodOptional<z.ZodString>;
                 model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
                 runner: z.ZodOptional<z.ZodEnum<{
                     claude: "claude";
                     codex: "codex";
@@ -2649,6 +2657,7 @@ export declare const createRunResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
                     opencode: "opencode";
                     pi: "pi";
                 }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
                 allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 command: z.ZodOptional<z.ZodString>;
@@ -3417,6 +3426,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                 prompt: z.ZodOptional<z.ZodString>;
                 skill: z.ZodOptional<z.ZodString>;
                 model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
                 runner: z.ZodOptional<z.ZodEnum<{
                     claude: "claude";
                     codex: "codex";
@@ -3424,6 +3434,7 @@ export declare const pickVariantResponseSchema: z.ZodObject<{
                     opencode: "opencode";
                     pi: "pi";
                 }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
                 allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 command: z.ZodOptional<z.ZodString>;
@@ -3512,6 +3523,7 @@ export declare const createRunInputBaseSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -3519,6 +3531,7 @@ export declare const createRunInputBaseSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;
@@ -3563,6 +3576,7 @@ export declare const createRunInputSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -3570,6 +3584,7 @@ export declare const createRunInputSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;

package/dist/contract/skills.d.ts

@@ -613,6 +613,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                 prompt: z.ZodOptional<z.ZodString>;
                 skill: z.ZodOptional<z.ZodString>;
                 model: z.ZodOptional<z.ZodString>;
+                effort: z.ZodOptional<z.ZodString>;
                 runner: z.ZodOptional<z.ZodEnum<{
                     claude: "claude";
                     codex: "codex";
@@ -620,6 +621,7 @@ export declare const startTodoResponseSchema: z.ZodObject<{
                     opencode: "opencode";
                     pi: "pi";
                 }>>;
+                agentProfile: z.ZodOptional<z.ZodString>;
                 allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 command: z.ZodOptional<z.ZodString>;

package/dist/contract/workflows.d.ts

@@ -21,6 +21,7 @@ export declare const workflowStepDefSchema: z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
     skill: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
     runner: z.ZodOptional<z.ZodEnum<{
         claude: "claude";
         codex: "codex";
@@ -28,6 +29,7 @@ export declare const workflowStepDefSchema: z.ZodObject<{
         opencode: "opencode";
         pi: "pi";
     }>>;
+    agentProfile: z.ZodOptional<z.ZodString>;
     allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
     command: z.ZodOptional<z.ZodString>;
@@ -47,6 +49,7 @@ export declare const workflowDefSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -54,6 +57,7 @@ export declare const workflowDefSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;
@@ -88,6 +92,7 @@ export declare const workflowsResponseSchema: z.ZodObject<{
             prompt: z.ZodOptional<z.ZodString>;
             skill: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             runner: z.ZodOptional<z.ZodEnum<{
                 claude: "claude";
                 codex: "codex";
@@ -95,6 +100,7 @@ export declare const workflowsResponseSchema: z.ZodObject<{
                 opencode: "opencode";
                 pi: "pi";
             }>>;
+            agentProfile: z.ZodOptional<z.ZodString>;
             allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
             command: z.ZodOptional<z.ZodString>;
@@ -130,6 +136,7 @@ export declare const saveWorkflowInputSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -137,6 +144,7 @@ export declare const saveWorkflowInputSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;
@@ -165,6 +173,7 @@ export declare const parsedWorkflowSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -172,6 +181,7 @@ export declare const parsedWorkflowSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;
@@ -206,6 +216,7 @@ export declare const planResponseSchema: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         skill: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         runner: z.ZodOptional<z.ZodEnum<{
             claude: "claude";
             codex: "codex";
@@ -213,6 +224,7 @@ export declare const planResponseSchema: z.ZodObject<{
             opencode: "opencode";
             pi: "pi";
         }>>;
+        agentProfile: z.ZodOptional<z.ZodString>;
         allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bashAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
         command: z.ZodOptional<z.ZodString>;

package/dist/delegation/cli.js

@@ -18,13 +18,13 @@ const responseSchemas = { send: conversationSendResultSchema, progress: conversa
     stop: workerStopResultSchema, destroy: workerDestroyResultSchema, diff: workerDiffSchema, wait: workerWaitResultSchema, 'cancel-wait': workerCancelWaitResultSchema };
 const RESPONSE_BYTES = 3_145_728;
 const CLI_FLAG = {
-    requestId: '--request-id', baseline: '--baseline', backend: '--backend', model: '--model', effort: '--effort',
+    requestId: '--request-id', baseline: '--baseline', backend: '--backend', model: '--model', effort: '--effort', workflow: '--workflow',
     timeoutSeconds: '--timeout-seconds', mode: '--mode', kind: '--kind', id: '--id', context: '--context',
     requestIds: '--request', workerIds: 'worker-id', workerId: 'worker-id', waitId: 'wait-id', recipientRunId: 'recipient-run-id',
     task: 'task', text: 'text',
 };
 const WORKER_USAGE = { operations: [
-        { name: 'spawn', positionals: 1, required: ['--baseline', '--request-id'], optional: ['--backend', '--model', '--effort', '--context', '--context-file'] },
+        { name: 'spawn', positionals: 1, required: ['--baseline', '--request-id'], optional: ['--workflow', '--backend', '--model', '--effort', '--context', '--context-file'] },
         { name: 'inspect', positionals: 1 },
         { name: 'steer', positionals: 2 },
         { name: 'stop', positionals: 1 },
@@ -42,6 +42,57 @@ const WORKER_USAGE = { operations: [
         { name: 'wait-requests', positionals: 1, optional: ['--mode', '--timeout-seconds'] },
         { name: 'cancel-request', positionals: 1 },
     ] };
+const WORKER_HELP = {
+    spawn: { args: '"<task>" --baseline <ref> --request-id <UUID>', description: 'Create an owned worker from a committed baseline.' },
+    inspect: { args: '<worker-id>', description: 'Show worker state and input locations.' },
+    steer: { args: '<worker-id> "<text>"', description: 'Send instructions to a running worker.' },
+    stop: { args: '<worker-id>', description: 'Stop a worker.' },
+    destroy: { args: '<worker-id>', description: 'Remove owned worker resources after collecting results.' },
+    diff: { args: '<worker-id>', description: 'Show the bounded worker diff.' },
+    collect: { args: '<worker-id>', description: 'Collect the latest worker results; does not merge changes.' },
+    wait: { args: '<worker-id>... | --request <UUID> [--request <UUID>...]', description: 'Register a wait for workers or message requests, then end your turn.' },
+    'cancel-wait': { args: '<wait-id>', description: 'Cancel a wait without cancelling requests or workers.' },
+    send: { args: '<recipient-run-id> "<text>" --id <UUID> --kind <request|progress>', description: 'Send a request requiring a reply, or a progress update.' },
+    progress: { args: '<recipient-run-id> "<text>" --id <UUID>', description: 'Send an update without a reply obligation.' },
+    'follow-up': { args: '<recipient-run-id> "<text>" --id <UUID> --request-id <UUID>', description: 'Clarify an existing request.' },
+    reply: { args: '<recipient-run-id> "<text>" --id <UUID> --request-id <UUID>', description: 'Reply to an existing request.' },
+    conversation: { args: '<recipient-run-id>', description: 'Inspect conversation messages and outcomes.' },
+    'wait-requests': { args: '<request-id>...', description: 'Register a wait for message requests, then end your turn.' },
+    'cancel-request': { args: '<request-id>', description: 'Cancel a request obligation.' },
+};
+const WORKER_FLAG_HELP = {
+    '--baseline': '<ref>                 Committed ref or parent-head; excludes dirty edits.',
+    '--request-id': '<UUID>              Spawn retry ID, or request being followed up/replied to.',
+    '--backend': '<name>                 claude | codex | opencode | pi | cursor.',
+    '--model': '<model>                  Model override.',
+    '--effort': '<level>                 low | medium | high | xhigh | max | auto.',
+    '--workflow': '<name>                Catalog workflow to run (built-in quick-task or .ai/cezar/workflows); default quick-task.',
+    '--context': '<text>                 Selected context; mutually exclusive with --context-file.',
+    '--context-file': '<path>            UTF-8 context file; mutually exclusive with --context.',
+    '--mode': '<one|any|all>             Wait mode (default any); one requires one target.',
+    '--timeout-seconds': '<1-1800>       Wait or request deadline (default 600 seconds).',
+    '--request': '<UUID>                 Request to wait for; repeat for multiple requests.',
+    '--id': '<UUID>                      Message ID; reuse only for an exact retry.',
+    '--kind': '<request|progress>        Whether the message requires an explicit reply.',
+};
+function workerHelp(operation) {
+    const operations = WORKER_USAGE.operations.filter(entry => operation === undefined || entry.name === operation);
+    const names = [...new Set(operations.map(entry => entry.name))];
+    const flags = [...new Set(operations.flatMap(entry => [...(entry.required ?? []), ...(entry.optional ?? [])]))];
+    return [
+        'cezar worker — manage owned coding workers and conversations', '', 'Usage:',
+        ...names.flatMap(name => {
+            const help = WORKER_HELP[name];
+            return [`  cez worker ${name} ${help.args}`, `    ${help.description}`];
+        }), '', 'Options:',
+        ...flags.map(flag => `  ${flag} ${WORKER_FLAG_HELP[flag]}`),
+        '  -h, --help                       Show help without a delegation session.', '',
+        'Required flags are shown in each synopsis. Other flags are optional.',
+        'Use cez worker <operation> --help for operation help.',
+        'Commands require an active cezar delegation session and return JSON.',
+        'Explicit help prints text and exits successfully; invalid commands return JSON errors.',
+    ].join('\n');
+}
 class WorkerCliError extends Error {
 }
 function cliName(path) {
@@ -108,16 +159,25 @@ export async function runWorkerCommand(argv, env) {
         console.log(token ? json.replaceAll(token, '[REDACTED]') : json);
     };
     try {
-        if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        if (argv.length === 1 && (argv[0] === '-h' || argv[0] === '--help')) {
+            console.log(workerHelp());
+            return 0;
+        }
+        if (argv.length === 0) {
             print({ code: 'invalid_input', error: 'Invalid worker command arguments', usage: WORKER_USAGE });
             return 1;
         }
         const operation = argv[0] === 'collect' ? 'collect' : argv[0] === 'cancel-wait' ? 'cancel-wait' : z.union([workerOperationSchema, conversationOperationSchema]).parse(argv[0]);
         const { values, positionals } = parseArgs({ args: argv.slice(1), allowPositionals: true, strict: true, options: {
-                ...(operation === 'spawn' ? { baseline: { type: 'string' }, 'request-id': { type: 'string' }, backend: { type: 'string' }, model: { type: 'string' }, effort: { type: 'string' }, context: { type: 'string' }, 'context-file': { type: 'string' } } : {}),
+                help: { type: 'boolean', short: 'h' },
+                ...(operation === 'spawn' ? { baseline: { type: 'string' }, 'request-id': { type: 'string' }, workflow: { type: 'string' }, backend: { type: 'string' }, model: { type: 'string' }, effort: { type: 'string' }, context: { type: 'string' }, 'context-file': { type: 'string' } } : {}),
                 ...(['send', 'progress', 'reply', 'follow-up'].includes(operation) ? { id: { type: 'string' }, kind: { type: 'string' }, 'request-id': { type: 'string' }, 'timeout-seconds': { type: 'string' } } : {}),
                 ...(operation === 'wait' || operation === 'wait-requests' ? { request: { type: 'string', multiple: true }, 'timeout-seconds': { type: 'string' }, mode: { type: 'string' } } : {}),
             } });
+        if (values.help) {
+            console.log(workerHelp(operation));
+            return 0;
+        }
         let path = operation;
         let body;
         if (operation === 'send' || operation === 'progress' || operation === 'reply' || operation === 'follow-up') {
@@ -145,6 +205,7 @@ export async function runWorkerCommand(argv, env) {
             body = workerSpawnRequestSchema.parse({ task: positionals[0], baseline: values.baseline, requestId: values['request-id'],
                 ...(values.backend === undefined ? {} : { backend: values.backend }), ...(values.model === undefined ? {} : { model: values.model }),
                 ...(values.effort === undefined ? {} : { effort: values.effort }),
+                ...(values.workflow === undefined ? {} : { workflow: values.workflow }),
                 ...(contextText === undefined ? {} : { context: { text: contextText } }),
             });
         }