@bridge4dev/runner 0.29.0 → 0.31.0

package/dist/protocol.d.ts

@@ -26,6 +26,18 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
          * every project the moment a runner updated ahead of its API.
          */
         agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The project's own prompt file, relative to `path` — its contents reach
+         * the agent as SYSTEM-prompt text (see `agent-prompt.ts` for why the level
+         * matters).
+         *
+         * `.catch(undefined)` for the same reason as `branchHint` and `branchPlan`:
+         * this field travels inside `hello_ack`, which carries EVERY session of the
+         * server, so a malformed value must cost its own session's prompt at most —
+         * never the frame (QA-100 MAJOR-1). The runner re-validates the path from
+         * scratch anyway; the bounds here only keep nonsense off the wire.
+         */
+        agentPromptPath: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         budgetUsd: z.ZodNullable<z.ZodNumber>;
         budgetMinutes: z.ZodNullable<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
@@ -36,6 +48,7 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         budgetUsd: number | null;
         budgetMinutes: number | null;
         agentAutoCommit?: boolean | undefined;
+        agentPromptPath?: string | null | undefined;
     }, {
         id: string;
         path: string;
@@ -44,7 +57,14 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         budgetUsd: number | null;
         budgetMinutes: number | null;
         agentAutoCommit?: boolean | undefined;
+        agentPromptPath?: unknown;
     }>;
+    /**
+     * «Run this one without the project's agent prompt.» Absent means no — both
+     * because an older API never sends it and because that is the default a human
+     * gets when they do not touch the checkbox.
+     */
+    skipAgentPrompt: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
     tickets: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         number: z.ZodNumber;
@@ -119,8 +139,8 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     mode: "ask" | "plan" | "auto" | "full";
-    status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
     id: string;
+    status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
     agent: "CLAUDE" | "CODEX";
     kind: "TICKET" | "CHAT";
     model: string | null;
@@ -140,6 +160,7 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         budgetUsd: number | null;
         budgetMinutes: number | null;
         agentAutoCommit?: boolean | undefined;
+        agentPromptPath?: string | null | undefined;
     };
     tickets: {
         number: number;
@@ -150,6 +171,7 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         url: string;
         token: string;
     } | undefined;
+    skipAgentPrompt?: boolean | undefined;
     branchHint?: string | undefined;
     branchPlan?: {
         branch: string;
@@ -159,8 +181,8 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
     } | undefined;
     workMode?: "DIRECT" | "BRANCH" | undefined;
 }, {
-    status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
     id: string;
+    status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
     agent: "CLAUDE" | "CODEX";
     kind: "TICKET" | "CHAT";
     prompt: string;
@@ -173,6 +195,7 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
         budgetUsd: number | null;
         budgetMinutes: number | null;
         agentAutoCommit?: boolean | undefined;
+        agentPromptPath?: unknown;
     };
     tickets: {
         number: number;
@@ -191,6 +214,7 @@ export declare const SessionDescriptorSchema: z.ZodObject<{
     costUsd?: number | undefined;
     activeMsBase?: number | undefined;
     extraBudgetMinutes?: number | null | undefined;
+    skipAgentPrompt?: unknown;
     branchHint?: unknown;
     branchPlan?: unknown;
     workMode?: unknown;
@@ -228,6 +252,18 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
              * every project the moment a runner updated ahead of its API.
              */
             agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * The project's own prompt file, relative to `path` — its contents reach
+             * the agent as SYSTEM-prompt text (see `agent-prompt.ts` for why the level
+             * matters).
+             *
+             * `.catch(undefined)` for the same reason as `branchHint` and `branchPlan`:
+             * this field travels inside `hello_ack`, which carries EVERY session of the
+             * server, so a malformed value must cost its own session's prompt at most —
+             * never the frame (QA-100 MAJOR-1). The runner re-validates the path from
+             * scratch anyway; the bounds here only keep nonsense off the wire.
+             */
+            agentPromptPath: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
             budgetUsd: z.ZodNullable<z.ZodNumber>;
             budgetMinutes: z.ZodNullable<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
@@ -238,6 +274,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: string | null | undefined;
         }, {
             id: string;
             path: string;
@@ -246,7 +283,14 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: unknown;
         }>;
+        /**
+         * «Run this one without the project's agent prompt.» Absent means no — both
+         * because an older API never sends it and because that is the default a human
+         * gets when they do not touch the checkbox.
+         */
+        skipAgentPrompt: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
         tickets: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             number: z.ZodNumber;
@@ -321,8 +365,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         }>>;
     }, "strip", z.ZodTypeAny, {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
@@ -342,6 +386,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: string | null | undefined;
         };
         tickets: {
             number: number;
@@ -352,6 +397,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             url: string;
             token: string;
         } | undefined;
+        skipAgentPrompt?: boolean | undefined;
         branchHint?: string | undefined;
         branchPlan?: {
             branch: string;
@@ -361,8 +407,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         } | undefined;
         workMode?: "DIRECT" | "BRANCH" | undefined;
     }, {
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
@@ -375,6 +421,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: unknown;
         };
         tickets: {
             number: number;
@@ -393,6 +440,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         costUsd?: number | undefined;
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
+        skipAgentPrompt?: unknown;
         branchHint?: unknown;
         branchPlan?: unknown;
         workMode?: unknown;
@@ -403,8 +451,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     serverId: string;
     sessions: {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
@@ -424,6 +472,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: string | null | undefined;
         };
         tickets: {
             number: number;
@@ -434,6 +483,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             url: string;
             token: string;
         } | undefined;
+        skipAgentPrompt?: boolean | undefined;
         branchHint?: string | undefined;
         branchPlan?: {
             branch: string;
@@ -449,8 +499,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     serverName: string;
     serverId: string;
     sessions: {
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
@@ -463,6 +513,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: unknown;
         };
         tickets: {
             number: number;
@@ -481,6 +532,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         costUsd?: number | undefined;
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
+        skipAgentPrompt?: unknown;
         branchHint?: unknown;
         branchPlan?: unknown;
         workMode?: unknown;
@@ -542,6 +594,18 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
              * every project the moment a runner updated ahead of its API.
              */
             agentAutoCommit: z.ZodOptional<z.ZodBoolean>;
+            /**
+             * The project's own prompt file, relative to `path` — its contents reach
+             * the agent as SYSTEM-prompt text (see `agent-prompt.ts` for why the level
+             * matters).
+             *
+             * `.catch(undefined)` for the same reason as `branchHint` and `branchPlan`:
+             * this field travels inside `hello_ack`, which carries EVERY session of the
+             * server, so a malformed value must cost its own session's prompt at most —
+             * never the frame (QA-100 MAJOR-1). The runner re-validates the path from
+             * scratch anyway; the bounds here only keep nonsense off the wire.
+             */
+            agentPromptPath: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
             budgetUsd: z.ZodNullable<z.ZodNumber>;
             budgetMinutes: z.ZodNullable<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
@@ -552,6 +616,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: string | null | undefined;
         }, {
             id: string;
             path: string;
@@ -560,7 +625,14 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: unknown;
         }>;
+        /**
+         * «Run this one without the project's agent prompt.» Absent means no — both
+         * because an older API never sends it and because that is the default a human
+         * gets when they do not touch the checkbox.
+         */
+        skipAgentPrompt: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
         tickets: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             number: z.ZodNumber;
@@ -635,8 +707,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         }>>;
     }, "strip", z.ZodTypeAny, {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
@@ -656,6 +728,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: string | null | undefined;
         };
         tickets: {
             number: number;
@@ -666,6 +739,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             url: string;
             token: string;
         } | undefined;
+        skipAgentPrompt?: boolean | undefined;
         branchHint?: string | undefined;
         branchPlan?: {
             branch: string;
@@ -675,8 +749,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         } | undefined;
         workMode?: "DIRECT" | "BRANCH" | undefined;
     }, {
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
@@ -689,6 +763,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: unknown;
         };
         tickets: {
             number: number;
@@ -707,6 +782,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         costUsd?: number | undefined;
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
+        skipAgentPrompt?: unknown;
         branchHint?: unknown;
         branchPlan?: unknown;
         workMode?: unknown;
@@ -715,8 +791,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     type: "session_start";
     session: {
         mode: "ask" | "plan" | "auto" | "full";
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         model: string | null;
@@ -736,6 +812,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: string | null | undefined;
         };
         tickets: {
             number: number;
@@ -746,6 +823,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             url: string;
             token: string;
         } | undefined;
+        skipAgentPrompt?: boolean | undefined;
         branchHint?: string | undefined;
         branchPlan?: {
             branch: string;
@@ -758,8 +836,8 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
 }, {
     type: "session_start";
     session: {
-        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         id: string;
+        status: "RUNNING" | "FAILED" | "STARTING" | "WAITING_INPUT" | "WAITING_PERMISSION" | "REVIEW" | "DONE" | "STOPPED";
         agent: "CLAUDE" | "CODEX";
         kind: "TICKET" | "CHAT";
         prompt: string;
@@ -772,6 +850,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
             budgetUsd: number | null;
             budgetMinutes: number | null;
             agentAutoCommit?: boolean | undefined;
+            agentPromptPath?: unknown;
         };
         tickets: {
             number: number;
@@ -790,6 +869,7 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         costUsd?: number | undefined;
         activeMsBase?: number | undefined;
         extraBudgetMinutes?: number | null | undefined;
+        skipAgentPrompt?: unknown;
         branchHint?: unknown;
         branchPlan?: unknown;
         workMode?: unknown;
@@ -815,9 +895,9 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         fileSize: number;
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
+    text: string;
     sessionId: string;
     type: "session_message";
-    text: string;
     attachments?: {
         id: string;
         fileName: string;
@@ -825,9 +905,9 @@ export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
         fileSize: number;
     }[] | undefined;
 }, {
+    text: string;
     sessionId: string;
     type: "session_message";
-    text: string;
     attachments?: unknown;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"permission_answer">;

package/dist/protocol.js

@@ -52,9 +52,27 @@ export const SessionDescriptorSchema = z.object({
          * every project the moment a runner updated ahead of its API.
          */
         agentAutoCommit: z.boolean().optional(),
+        /**
+         * The project's own prompt file, relative to `path` — its contents reach
+         * the agent as SYSTEM-prompt text (see `agent-prompt.ts` for why the level
+         * matters).
+         *
+         * `.catch(undefined)` for the same reason as `branchHint` and `branchPlan`:
+         * this field travels inside `hello_ack`, which carries EVERY session of the
+         * server, so a malformed value must cost its own session's prompt at most —
+         * never the frame (QA-100 MAJOR-1). The runner re-validates the path from
+         * scratch anyway; the bounds here only keep nonsense off the wire.
+         */
+        agentPromptPath: z.string().max(300).nullable().optional().catch(undefined),
         budgetUsd: z.number().nullable(),
         budgetMinutes: z.number().nullable(),
     }),
+    /**
+     * «Run this one without the project's agent prompt.» Absent means no — both
+     * because an older API never sends it and because that is the default a human
+     * gets when they do not touch the checkbox.
+     */
+    skipAgentPrompt: z.boolean().optional().catch(undefined),
     tickets: z.array(z.object({ id: z.string().uuid(), number: z.number(), title: z.string() })),
     // Branch the API would like this session to use (derived from its ticket
     // group). Optional: an older API omits it and the runner keeps its

package/dist/supervisor.d.ts

@@ -118,6 +118,26 @@ export declare class Supervisor {
      * stay queued rather than be marked delivered (session 9).
      */
     private launchAgent;
+    /**
+     * The project's own prompt file, read fresh for THIS agent process.
+     *
+     * Read per launch rather than per session on purpose: a system prompt only
+     * ever changes when the process restarts, so «edit the file, then press
+     * Continue» is the honest contract, and re-reading is what makes it true.
+     *
+     * Every outcome is said out loud. The whole point of moving the project's
+     * rules into the system prompt is that they can no longer be quietly
+     * outranked — so «the prompt did not load» must never be indistinguishable
+     * from «the prompt loaded». Supervisor notices repeat on every launch (only
+     * ADAPTER notices are de-duplicated — gotcha #148), which is exactly what is
+     * wanted here: each agent process either has the prompt or does not.
+     *
+     * Returns the text AND the absolute file, because layer 1 needs the second to
+     * refuse writes to it: in `workMode: DIRECT` the project folder is the
+     * agent's own working directory, so without that rule a session could rewrite
+     * the prompt it will itself be started with next time (QA-130 MAJOR-3).
+     */
+    private resolveAgentPrompt;
     /** Warn the user when this share of the budget is gone. */
     private static readonly BUDGET_WARN_RATIO;
     /** Is the agent actually working right now (i.e. should the clock run)? */
@@ -317,6 +337,10 @@ export declare class Supervisor {
     private interruptSession;
     /** Live model / interaction-mode switch (persisted for the next relaunch). */
     private applySettings;
+    /** Is a turn (or a question the agent is parked on) in flight right now? */
+    private isMidTurn;
+    /** The three live setters, in the order that lets an explicit pick win. */
+    private applyLiveSettings;
     private stopSession;
     private reconcile;
     /**
@@ -404,6 +428,14 @@ export declare function composeInitialPrompt(descriptor: SessionDescriptor): str
  * A repository that wants both agents equipped ships both files, or symlinks
  * one to the other. That is a repository convention and not something a runner
  * should paper over.
+ *
+ * `agentPrompt` is the one exception, and it is an exception for a reason this
+ * function cannot do anything about: `CLAUDE.md` and `AGENTS.md` arrive at the
+ * USER level, and a project's standing process rules have to sit at the system
+ * level to survive both a compaction and a rule the CLI states about itself
+ * (`agent-prompt.ts`). It arrives here already read and already checked — this
+ * function still opens no files — and it goes LAST, so a project overrides us
+ * exactly the way `CLAUDE.md` does by being read last.
  */
-export declare function composeWorkspaceContext(descriptor: SessionDescriptor): string;
+export declare function composeWorkspaceContext(descriptor: SessionDescriptor, agentPrompt?: string): string;
 //# sourceMappingURL=supervisor.d.ts.map