@intentius/chant-lexicon-fountain 0.106.1 → 0.106.3

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "a8525549701de716ae91d92c3965e91ab8993ec47b4b30ae9c1e5746a6918bc4",
+    "manifest.json": "d991df566d8002caaa016de270498899957eae346f481467997be3bd0e339def",
     "meta.json": "3301437a2a56eaf1a5cc8f6eabb18a40767f916e09701b2d9bf20aba4066738c",
     "types/index.d.ts": "cf6b634fe0a8e9e96f1d9d07e3df53838def2683dc93dbe3c7fd971c6d3908ae",
     "rules/ftn001-no-secret-literals.ts": "a417b194cd7039911cca9a0f14c49b042dfa6b1ee48517f7c2e22b16590a8599",
@@ -23,5 +23,5 @@
     "skills/chant-fountain-ops.md": "4e72f0a0c7477a9e98f85ea45e49ba69e8a699f9c13ba0f0cf1cb20a88151373",
     "skills/chant-fountain-locked-sandboxes.md": "7404ece96f2a3bc9105942fd3b6db156a3537db7e34c8cf2faa9ba87f5512567"
   },
-  "composite": "ee0015b352b6395456b2c8a5099b69666d65efb9afa333b117390452bdc9081a"
+  "composite": "6f4edb83df0d0f55abea6e8fbed09896f4a6a94a73e6f6a81aa21ccb093a916e"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "fountain",
-  "version": "0.106.1",
+  "version": "0.106.3",
   "chantVersion": ">=0.1.0",
   "namespace": "Fountain",
   "specVersion": "v0.21.0"

package/dist/op/run-prompt.d.ts

@@ -27,6 +27,14 @@ export interface HostedRunPromptOptions {
     env?: string;
     /** `--param name=value`, one flag per entry, in order (#3539). */
     params?: Record<string, unknown>;
+    /**
+     * `--work <item>` and `--holder <name>` (#3555): the work item the run is
+     * for and who holds its lease. The sandbox's run takes the lease.
+     */
+    work?: {
+        item?: string;
+        holder?: string;
+    };
     /** Flags after `--on local`, as `[flag, value]`; each value is quoted as needed. */
     flags?: Array<[string, string]>;
     /** Words appended as they are, already spelled for the command line. */
@@ -35,7 +43,8 @@ export interface HostedRunPromptOptions {
 /**
  * The prompt a hosted run is posted as: {@link runPrompt}, then `--env <env>`
  * when the caller named one (#3232), then each `--param` (#3539), then
- * `--on local` (#3225), then any further flags.
+ * `--work` and `--holder` (#3555), then `--on local` (#3225), then any
+ * further flags.
  *
  * `--env` carries the environment the caller asked for into the sandbox,
  * where `chant acp` hands it to the run as `currentOpRun().env`. `--param`
@@ -47,10 +56,10 @@ export interface HostedRunPromptOptions {
  *
  * A turn still matches {@link runPrompt} by prefix (`turnRunsOp`), and a
  * steward's Schedule keeps the bare line. An `--env` value that is not one
- * plain word is refused by name rather than posted; a `--param` or flag value
- * is quoted ({@link quoteArg}).
+ * plain word is refused by name rather than posted, as is a `--work` or
+ * `--holder` value the sandbox's parser would not read as a value (empty, or
+ * starting with `-`); a `--param`, `--work`, `--holder` or flag value is
+ * quoted ({@link quoteArg}).
  */
 export declare function hostedRunPrompt(op: string, opts?: HostedRunPromptOptions): string;
-/** The `--env` a posted prompt carries, or undefined. */
-export declare function envOfPrompt(prompt: string | undefined): string | undefined;
 //# sourceMappingURL=run-prompt.d.ts.map

package/dist/op/run-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-prompt.d.ts","sourceRoot":"","sources":["../../src/op/run-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAeD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oFAAoF;IACpF,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,CAkBrF;AASD,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK1E"}
+{"version":3,"file":"run-prompt.d.ts","sourceRoot":"","sources":["../../src/op/run-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAeD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,oFAAoF;IACpF,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,CA4BrF"}

package/dist/op/runtime.d.ts

@@ -3,7 +3,7 @@
  *
  * `chant run <op> --on fountain` hands the run to a fountain teammate instead
  * of executing it here. This module is the client for that: it posts the
- * command line `chant run <op> [--env <env>] [--param k=v ...] --on local` ({@link hostedRunPrompt})
+ * command line `chant run <op> [--env <env>] [--param k=v ...] [--work <id>] [--holder <name>] --on local` ({@link hostedRunPrompt})
  * as a prompt on the steward's thread, tails the
  * conversation's SSE stream, and reports what comes back through the
  * {@link OpRuntimeProvider} contract core defines in
@@ -63,8 +63,8 @@
 import { type ChantConfig } from "@intentius/chant/config";
 import type { OpRunRecord, OpRunState, OpRunStatus, OpRuntimeProvider, StepRecord } from "@intentius/chant/op";
 import { type FountainHttp } from "./activities/fountain-apply.js";
-import { runPrompt, hostedRunPrompt, envOfPrompt, quoteArg } from "./run-prompt.js";
-export { runPrompt, hostedRunPrompt, envOfPrompt, quoteArg };
+import { runPrompt, hostedRunPrompt, quoteArg } from "./run-prompt.js";
+export { runPrompt, hostedRunPrompt, quoteArg };
 /** One server-sent event, already framed. `data` is the raw payload text. */
 export interface FountainSseEvent {
     /** The event id, which becomes the next connection's `Last-Event-ID`. */
@@ -209,13 +209,17 @@ export declare function runStateOfTurn(conversationStatus?: string, turnState?:
  */
 export declare function createFountainOpRuntime(opts?: FountainOpRuntimeOptions): OpRuntimeProvider;
 /**
- * The `--env` and `--param`s a posted prompt carries, read with the same
- * quote-aware split `chant acp` uses. A prompt that does not split (an
- * unterminated quote) carries neither.
+ * The `--env`, `--param`s, `--work` and `--holder` a posted prompt carries,
+ * read with the same quote-aware split `chant acp` uses. A prompt that does
+ * not split (an unterminated quote) carries none of them.
  */
 export declare function flagsOfPrompt(prompt: string | undefined): {
     env?: string;
     params?: Record<string, string>;
+    work?: {
+        item?: string;
+        holder?: string;
+    };
 };
 interface TailOptions {
     sse: FountainSse;

package/dist/op/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/op/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/op/runtime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-fountain",
-  "version": "0.106.1",
+  "version": "0.106.3",
   "type": "module",
   "description": "Fountain lexicon for chant — sandboxed agent environments, vaults, and agents as typed estate",
   "license": "Apache-2.0",
@@ -50,7 +50,7 @@
     "bundle": "tsx src/package-cli.ts"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.106.1",
+    "@intentius/chant": "^0.106.3",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },

package/src/op/run-prompt.ts

@@ -48,6 +48,11 @@ export interface HostedRunPromptOptions {
   env?: string;
   /** `--param name=value`, one flag per entry, in order (#3539). */
   params?: Record<string, unknown>;
+  /**
+   * `--work <item>` and `--holder <name>` (#3555): the work item the run is
+   * for and who holds its lease. The sandbox's run takes the lease.
+   */
+  work?: { item?: string; holder?: string };
   /** Flags after `--on local`, as `[flag, value]`; each value is quoted as needed. */
   flags?: Array<[string, string]>;
   /** Words appended as they are, already spelled for the command line. */
@@ -57,7 +62,8 @@ export interface HostedRunPromptOptions {
 /**
  * The prompt a hosted run is posted as: {@link runPrompt}, then `--env <env>`
  * when the caller named one (#3232), then each `--param` (#3539), then
- * `--on local` (#3225), then any further flags.
+ * `--work` and `--holder` (#3555), then `--on local` (#3225), then any
+ * further flags.
  *
  * `--env` carries the environment the caller asked for into the sandbox,
  * where `chant acp` hands it to the run as `currentOpRun().env`. `--param`
@@ -69,8 +75,10 @@ export interface HostedRunPromptOptions {
  *
  * A turn still matches {@link runPrompt} by prefix (`turnRunsOp`), and a
  * steward's Schedule keeps the bare line. An `--env` value that is not one
- * plain word is refused by name rather than posted; a `--param` or flag value
- * is quoted ({@link quoteArg}).
+ * plain word is refused by name rather than posted, as is a `--work` or
+ * `--holder` value the sandbox's parser would not read as a value (empty, or
+ * starting with `-`); a `--param`, `--work`, `--holder` or flag value is
+ * quoted ({@link quoteArg}).
  */
 export function hostedRunPrompt(op: string, opts: HostedRunPromptOptions = {}): string {
   const parts = [runPrompt(op)];
@@ -86,6 +94,16 @@ export function hostedRunPrompt(op: string, opts: HostedRunPromptOptions = {}):
   for (const [name, value] of Object.entries(opts.params ?? {})) {
     parts.push(`--param ${quoteArg(`${name}=${paramText(value)}`)}`);
   }
+  for (const [flag, value] of [["--work", opts.work?.item], ["--holder", opts.work?.holder]] as const) {
+    if (value === undefined) continue;
+    if (value === "" || value.startsWith("-")) {
+      throw new Error(
+        `fountain runtime: ${flag} "${value}" cannot be posted to the steward: chant reads a value that is empty ` +
+          `or starts with "-" as a missing one`,
+      );
+    }
+    parts.push(`${flag} ${quoteArg(value)}`);
+  }
   parts.push("--on local");
   for (const [flag, value] of opts.flags ?? []) parts.push(`${flag} ${quoteArg(value)}`);
   for (const part of opts.extra ?? []) parts.push(part);
@@ -98,11 +116,3 @@ function paramText(value: unknown): string {
   if (value === undefined || value === null) return "";
   return typeof value === "object" ? JSON.stringify(value) : String(value);
 }
-
-/** The `--env` a posted prompt carries, or undefined. */
-export function envOfPrompt(prompt: string | undefined): string | undefined {
-  const words = (prompt ?? "").trim().split(/\s+/);
-  const at = words.indexOf("--env");
-  const env = at >= 0 ? words[at + 1] : undefined;
-  return env && !env.startsWith("-") ? env : undefined;
-}

package/src/op/runtime.test.ts

@@ -197,6 +197,13 @@ describe("quoteArg and flagsOfPrompt (#3539)", () => {
     });
     expect(flagsOfPrompt("chant run x --env=prod --param=a=1")).toEqual({ env: "prod", params: { a: "1" } });
     expect(flagsOfPrompt("chant run x --on local")).toEqual({});
+    // #3555: --work and --holder too.
+    expect(flagsOfPrompt('chant run x --work ISSUE-7 --holder "box steward" --on local')).toEqual({
+      work: { item: "ISSUE-7", holder: "box steward" },
+    });
+    expect(flagsOfPrompt("chant run x --work=ISSUE-7")).toEqual({ work: { item: "ISSUE-7" } });
+    // An env that is quoted is read as one value, where a whitespace split read half of it.
+    expect(flagsOfPrompt('chant run x --env "prod east"')).toEqual({ env: "prod east" });
     expect(flagsOfPrompt('chant run x --env "unterminated')).toEqual({});
     expect(flagsOfPrompt(undefined)).toEqual({});
   });
@@ -328,13 +335,49 @@ describe("start", () => {
     expect(parsed.ok && parsed.command.args.on).toBe("local");
   });
 
-  it("refuses --work by name before posting anything (#3539)", async () => {
+  // #3555: `--work` and `--holder` ride on the posted line, so an Op whose
+  // work lease leaves the item to the run can run on fountain; the sandbox's
+  // parser reads both back.
+  it("posts --work and --holder on the command line (#3555)", async () => {
+    const { http, calls } = fakeHttp(
+      stewardRoutes({
+        "POST /api/team/agent-1/messages": { status: 202, json: { data: { conversation_id: "conv-1" } } },
+      }),
+    );
+    const { sse } = fakeSse([
+      [
+        sseEvent("1", { stream: "stdout", blocks: [{ kind: "text", body: JSON.stringify(RECORD) }] }),
+        sseEvent("2", { stream: "stage", stage: "turn", state: "done" }),
+      ],
+    ]);
+    const runtime = createFountainOpRuntime({
+      config: CONFIG, endpoint: "https://fountain.example.com", token: "t", http, sse, now: fakeClock(),
+    });
+    expect(runtime.carriesWork).toBe(true);
+
+    const handle = await runtime.start(OP, { env: "staging", work: { item: "ISSUE-7", holder: "box steward" } });
+    await handle.result();
+
+    const post = calls.find((c) => c.method === "POST");
+    const prompt = (post?.body as { prompt: string }).prompt;
+    expect(prompt).toBe('chant run alb-deploy --env staging --work ISSUE-7 --holder "box steward" --on local');
+
+    const { parseChantCommandLine } = await import("../acp/command-line");
+    const parsed = await parseChantCommandLine(prompt);
+    expect(parsed.ok && parsed.command.kind === "op-run" && parsed.command.op).toBe("alb-deploy");
+    expect(parsed.ok && parsed.command.args.work).toBe("ISSUE-7");
+    expect(parsed.ok && parsed.command.args.holder).toBe("box steward");
+    expect(parsed.ok && parsed.command.args.on).toBe("local");
+  });
+
+  it("refuses a --work the sandbox would read as missing, by name, before posting anything (#3555)", async () => {
     const { http, calls } = fakeHttp(stewardRoutes({}));
     const runtime = createFountainOpRuntime({
       config: CONFIG, endpoint: "https://fountain.example.com", token: "t", http, now: fakeClock(),
     });
 
-    await expect(runtime.start(OP, { work: { item: "ISSUE-7" } })).rejects.toThrow(/--work and --holder are not posted/);
+    await expect(runtime.start(OP, { work: { item: "-7" } })).rejects.toThrow(/--work "-7" cannot be posted/);
+    await expect(runtime.start(OP, { work: { holder: "" } })).rejects.toThrow(/--holder "" cannot be posted/);
     expect(calls).toEqual([]);
   });
 
@@ -1194,6 +1237,34 @@ describe("resolveGate", () => {
     });
   });
 
+  // #3555: the gated turn's work item and holder ride on the re-run, so the
+  // re-run of an Op that needs a work item is told it again.
+  it("carries the gated turn's --work and --holder onto the re-run prompt", async () => {
+    const { http, calls } = fakeHttp(
+      stewardRoutes({
+        ...routes,
+        "GET /api/conversations/conv-1/turns": {
+          status: 200,
+          json: {
+            data: [{ id: "turn-1", prompt: 'chant run alb-deploy --work ISSUE-7 --holder "box steward" --on local', state: "done" }],
+          },
+        },
+      }),
+    );
+    const runtime = createFountainOpRuntime({
+      config: CONFIG, endpoint: "https://fountain.example.com", token: "t", http, now: fakeClock(),
+    });
+
+    await runtime.resolveGate!("alb-deploy", "release", resolution);
+
+    const post = calls.find((c) => c.path === "/api/conversations/conv-1/prompts");
+    expect(post?.body).toEqual({
+      prompt:
+        'chant run alb-deploy --work ISSUE-7 --holder "box steward" --on local ' +
+        "--approver alex --url https://github.com/o/r/pull/1",
+    });
+  });
+
   it("reports conversation_busy rather than retrying the prompt", async () => {
     const { http, calls } = fakeHttp(
       stewardRoutes({

package/src/op/runtime.ts

@@ -3,7 +3,7 @@
  *
  * `chant run <op> --on fountain` hands the run to a fountain teammate instead
  * of executing it here. This module is the client for that: it posts the
- * command line `chant run <op> [--env <env>] [--param k=v ...] --on local` ({@link hostedRunPrompt})
+ * command line `chant run <op> [--env <env>] [--param k=v ...] [--work <id>] [--holder <name>] --on local` ({@link hostedRunPrompt})
  * as a prompt on the steward's thread, tails the
  * conversation's SSE stream, and reports what comes back through the
  * {@link OpRuntimeProvider} contract core defines in
@@ -73,10 +73,10 @@ import {
 } from "./activities/fountain-apply";
 import { resolveAgentId } from "./activities/fountain-run";
 import { stewardForOp } from "../composites/steward";
-import { runPrompt, hostedRunPrompt, envOfPrompt, quoteArg } from "./run-prompt";
+import { runPrompt, hostedRunPrompt, quoteArg } from "./run-prompt";
 import { tokenize } from "../acp/command-line";
 
-export { runPrompt, hostedRunPrompt, envOfPrompt, quoteArg };
+export { runPrompt, hostedRunPrompt, quoteArg };
 
 // ── The SSE seam ──────────────────────────────────────────────────────────
 
@@ -745,6 +745,10 @@ export function createFountainOpRuntime(opts: FountainOpRuntimeOptions = {}): Op
 
   return {
     name: "fountain",
+    // `--work` and `--holder` ride on the posted line (#3555), so an Op whose
+    // work lease leaves the item to the run can run here; the sandbox's run
+    // takes the lease.
+    carriesWork: true,
 
     async start(op: OpConfig, startOpts: OpRunStartOptions): Promise<OpRunHandle> {
       known.set(op.name, op);
@@ -753,12 +757,12 @@ export function createFountainOpRuntime(opts: FountainOpRuntimeOptions = {}): Op
       selectProfile(startOpts.profile);
       // Before any request: an `--env` the command line cannot carry is
       // refused here, by name, rather than dropped (#3232). `--param` rides
-      // on the line (#3539); `--work` is refused, since the posted line does
-      // not carry the lease the caller named.
-      refuseWork(op.name, startOpts.work);
+      // on the line (#3539), and so do `--work` and `--holder` (#3555): the
+      // run in the sandbox takes the work lease the caller named.
       const prompt = hostedRunPrompt(op.name, {
         env: startOpts.env,
         ...(startOpts.params ? { params: startOpts.params } : {}),
+        ...(startOpts.work ? { work: startOpts.work } : {}),
       });
       const http = await rest();
       const steward = await resolveSteward(op, startOpts.params);
@@ -928,15 +932,20 @@ export function createFountainOpRuntime(opts: FountainOpRuntimeOptions = {}): Op
       // a space stays one value (#3539). The re-run runs in the environment
       // the approver named (`chant run approve ... --env`, #3539), or else the
       // one the gated run did: the `--env` on the op's latest turn (#3232).
-      // The gated turn's `--param`s ride along too, and `--on local` as on
-      // every posted run (#3225).
+      // The gated turn's `--param`s, `--work` and `--holder` ride along too
+      // (#3555), and `--on local` as on every posted run (#3225).
       const flags: Array<[string, string]> = [];
       if (resolution.resolvedBy) flags.push(["--approver", resolution.resolvedBy]);
       if (resolution.url) flags.push(["--url", resolution.url]);
       const gated = flagsOfPrompt(found?.turns[0]?.prompt);
       const env = resolveOpts?.env !== undefined && resolveOpts.env !== "" ? resolveOpts.env : gated.env;
       const { status, json } = await http("POST", `/api/conversations/${conversationId}/prompts`, {
-        prompt: hostedRunPrompt(op, { env, ...(gated.params ? { params: gated.params } : {}), flags }),
+        prompt: hostedRunPrompt(op, {
+          env,
+          ...(gated.params ? { params: gated.params } : {}),
+          ...(gated.work ? { work: gated.work } : {}),
+          flags,
+        }),
       });
 
       if (status === 400 && errorCode(json) === "conversation_busy") {
@@ -953,25 +962,15 @@ export function createFountainOpRuntime(opts: FountainOpRuntimeOptions = {}): Op
 }
 
 /**
- * Refuse `--work`/`--holder` on a hosted run, by name (#3539). The posted
- * line does not carry them, so the run in the sandbox would hold no lease, or
- * one the caller did not name. Core's `chant run` refuses them before any
- * runtime is reached; this covers a caller that holds the provider directly.
- */
-function refuseWork(op: string, work: OpRunStartOptions["work"]): void {
-  if (!work || (work.item === undefined && work.holder === undefined)) return;
-  throw new Error(
-    `fountain runtime: --work and --holder are not posted to the steward, so the hosted run of "${op}" ` +
-      `would not hold the lease named here. Run it with --on local to hold the lease in this process.`,
-  );
-}
-
-/**
- * The `--env` and `--param`s a posted prompt carries, read with the same
- * quote-aware split `chant acp` uses. A prompt that does not split (an
- * unterminated quote) carries neither.
+ * The `--env`, `--param`s, `--work` and `--holder` a posted prompt carries,
+ * read with the same quote-aware split `chant acp` uses. A prompt that does
+ * not split (an unterminated quote) carries none of them.
  */
-export function flagsOfPrompt(prompt: string | undefined): { env?: string; params?: Record<string, string> } {
+export function flagsOfPrompt(prompt: string | undefined): {
+  env?: string;
+  params?: Record<string, string>;
+  work?: { item?: string; holder?: string };
+} {
   let words: string[];
   try {
     words = tokenize(prompt ?? "");
@@ -979,6 +978,7 @@ export function flagsOfPrompt(prompt: string | undefined): { env?: string; param
     return {};
   }
   let env: string | undefined;
+  const work: { item?: string; holder?: string } = {};
   const params: Record<string, string> = {};
   let any = false;
   for (let i = 0; i < words.length; i++) {
@@ -989,20 +989,26 @@ export function flagsOfPrompt(prompt: string | undefined): { env?: string; param
     if (eq > 0) {
       flag = word.slice(0, eq);
       value = word.slice(eq + 1);
-    } else if (word === "--env" || word === "--param") {
+    } else if (word === "--env" || word === "--param" || word === "--work" || word === "--holder") {
       value = words[i + 1];
       if (value === undefined || value.startsWith("-")) continue;
       i++;
     }
     if (value === undefined) continue;
     if (flag === "--env") env = value;
+    else if (flag === "--work") work.item = value;
+    else if (flag === "--holder") work.holder = value;
     else if (flag === "--param") {
       const at = value.indexOf("=");
       params[at === -1 ? value : value.slice(0, at)] = at === -1 ? "" : value.slice(at + 1);
       any = true;
     }
   }
-  return { ...(env ? { env } : {}), ...(any ? { params } : {}) };
+  return {
+    ...(env ? { env } : {}),
+    ...(any ? { params } : {}),
+    ...(work.item !== undefined || work.holder !== undefined ? { work } : {}),
+  };
 }
 
 /** Was `--durable-requests` asked for on this invocation? */