@namzu/cli 38.2.0 → 39.1.0

package/dist/integrations/subagents/runtime.d.ts

@@ -4,9 +4,11 @@
  * and namzu spins up a fresh sub-agent with that role at runtime, no
  * pre-registered definition needed. Omit `role` for a general-purpose one.
  * The call waits for a final result unless background execution is requested
- * or operator input releases the wait.
- * The child then stays owned by the parent turn, and its completion reaches the
- * same query's inbox. Headless callers also support explicit background work.
+ * or operator input releases the wait. With `backgroundByDefault` (an operator
+ * is watching) background is the default and the turn ends without waiting: the
+ * child outlives the turn, and its end is reported through
+ * `onBackgroundCompletion`. Otherwise the child stays owned by the parent turn
+ * and its completion reaches the same query's inbox.
  *
  * The runtime is fully self-contained: a dedicated in-memory session/thread
  * store backs the AgentManager, so sub-agent bookkeeping never touches the
@@ -16,6 +18,7 @@
  * (`saved-agents.ts`) reads those records back as evidence, never as execution
  * authority.
  */
+import { WORKFLOW_STEP_ASSIGNMENT } from './workflow-assignment.js';
 import { type AgentFileDefinition, type AuthorizationGateConfig, CompletionInbox, type LLMProvider, type Project, type ProjectInstructionContext, type ReasoningEffort, type ResumeHandler, type SandboxProvider, type SessionEvent, type SessionId, type SessionPaths, type SessionTokenBudgetStore, type TaskScheduler, type ToolContext, type ToolDefinition, type Toolset, type Topic, type TurnId } from '@namzu/sdk';
 import type { TurnLimitsConfig } from '../../config/schema.js';
 import type { SideLedger } from '../small-model/side-model.js';
@@ -33,8 +36,7 @@ import { type SavedAgentHistory } from './saved-agents.js';
  * sentence rather than an error.
  */
 export declare const NARRATION_TOOL_NAME = "narrate_work";
-/** Opens every workflow agent's prompt: the step is the job, so a note about authority cannot read as a reason to skip it. */
-export declare const WORKFLOW_STEP_ASSIGNMENT = "This step is your assigned job. The person who started this workflow approved the script that gives it to you, so carry it out and report what you found or did; do not decline it or skip it.";
+export { WORKFLOW_STEP_ASSIGNMENT };
 export declare const GENERAL_PURPOSE_SUBAGENT = "general-purpose";
 /**
  * The kernel's read-only delegate, with this application's doctrine under
@@ -53,6 +55,15 @@ export interface DelegatedModel {
     readonly effort?: ReasoningEffort;
 }
 export interface SubagentRuntimeOptions {
+    /**
+     * An operator is watching and the turn must not wait for its agents: `Agent`
+     * runs in the background unless the call says `run_in_background: false`, a
+     * turn ends when the model has answered while background agents run on, and
+     * each one that ends later is reported through
+     * {@link SubagentRuntime.onBackgroundCompletion}. Headless callers leave it
+     * off and keep the turn waiting for what it launched.
+     */
+    readonly backgroundByDefault?: boolean;
     /**
      * Tools every child gets beside its roster, whatever that roster was
      * narrowed to. Set by the runtime itself, never by a host: a file's
@@ -209,6 +220,19 @@ export interface SubagentMessageReceipt {
     readonly parentNotice: string;
     readonly auditWarning?: string;
 }
+/** A background agent that ended after the turn that launched it was over. */
+export interface SubagentCompletion {
+    readonly parentSessionId: string;
+    readonly taskId: string;
+    readonly viewId?: string;
+    readonly agentId: string;
+    readonly description: string;
+    readonly state: 'completed' | 'failed' | 'cancelled';
+    /** Who stopped it, when it was stopped: the operator's own stop is not news. */
+    readonly stoppedBy?: 'user' | 'parent';
+    /** The result as the model reads it: the same envelope a task notification carries. */
+    readonly text: string;
+}
 /** A message a running child sent to the main conversation. */
 export interface SubagentMessage {
     readonly parentSessionId: string;
@@ -225,11 +249,21 @@ export interface SubagentRuntime {
      * cannot show or deliver it never promises a child it will.
      */
     onChildMessage(listener: (message: SubagentMessage) => void): () => void;
+    /**
+     * Hear a background agent that ends after its turn did. While the turn that
+     * launched it is still running, the turn's own inbox delivers the result and
+     * nothing is said here. Only with `backgroundByDefault`.
+     */
+    onBackgroundCompletion(listener: (completion: SubagentCompletion) => void): () => void;
     /** One immutable scheduler context per actual parent turn. */
     gatewayForTurn(turnId: TurnId): Promise<TaskScheduler>;
     /** The same inbox the parent query drains after a delegation yields. */
     completionInboxForTurn(turnId: TurnId): Promise<CompletionInbox>;
-    /** Release a settled parent turn's bookkeeping and cancel children it still owns. */
+    /**
+     * Release a settled parent turn's bookkeeping. Children it still owns are
+     * cancelled, except background ones under `backgroundByDefault`: those keep
+     * running until they end or the session closes.
+     */
     releaseTurn(turnId: TurnId): Promise<void>;
     /**
      * Where requests beside the conversation (a title, the answer `web_fetch`

package/dist/integrations/subagents/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAGN,KAAK,mBAAmB,EAIxB,KAAK,uBAAuB,EAI5B,eAAe,EAWf,KAAK,WAAW,EAEhB,KAAK,OAAO,EACZ,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EAGjB,KAAK,uBAAuB,EAG5B,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,OAAO,EACZ,KAAK,KAAK,EAIV,KAAK,MAAM,EAiBX,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE5E,OAAO,EAON,KAAK,sBAAsB,EAC3B,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGjF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAYjD,8HAA8H;AAC9H,eAAO,MAAM,wBAAwB,mMAC4J,CAAA;AAEjM,eAAO,MAAM,wBAAwB,oBAAoB,CAAA;AACzD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAAmB,CAAA;AA+ChD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CACjC;AA4CD,MAAM,WAAW,sBAAsB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;IACnD,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,iBAAiB,CAAA;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAA;IACzE,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;IACnD,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAAA;IAC7D,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,CACvB,eAAe,CAAC,EAAE,SAAS,EAC3B,SAAS,CAAC,EAAE,cAAc,KACtB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACvC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAA;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,CACvB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9D,MAAM,EAAE,WAAW,KACf,OAAO,CAAC,cAAc,CAAC,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7E,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;IAC7C,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC7B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,OAAO,EAAE,KACxB,mBAAmB,CAAC,WAAW,CAAC,CAAA;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,CAAA;IACpD;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,aAAa,GAAG,SAAS,CAAA;IAC5F;;;;;;;OAOG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAA;IACpF,8EAA8E;IAC9E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAChC,MAAM,EAAE,MAAM,KACV,CAAC,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IACzD,kEAAkE;IAClE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAA;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAChD,gDAAgD;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,yBAAyB,CAAA;IAC/E;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3D,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAChD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACrD;AAED,uGAAuG;AACvG,MAAM,WAAW,mBAAmB;IACnC,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,0GAA0G;IAC1G,QAAQ,CAAC,OAAO,CAAC,EAAE;QAClB,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;QACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAA;KACnE,CAAA;IACD,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAC1B,KAAK,IAAI,CAAA;CACV;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,QAAQ,CAAA;AAE9C,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACxE,8DAA8D;IAC9D,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IACtD,wEAAwE;IACxE,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAChE,qFAAqF;IACrF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,mFAAmF;IACnF,YAAY,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAClC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,cAAc,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAA;IACxC,QAAQ,CAAC,iBAAiB,EAAE,cAAc,CAAA;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAA;IACxC,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAA;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAA;IACtC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C;;;;;;;;;;;;;;OAcG;IACH,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;IACzC;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC9E,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AA0DD;;;GAGG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,sBAAsB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAkmD1B"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/runtime.ts"],"names":[],"mappings":"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"}

package/dist/integrations/subagents/workflow-assignment.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The sentence that opens every workflow agent's prompt, kept apart from the
+ * runtime so the activity record can leave it out of what the person reads.
+ */
+/** Opens every workflow agent's prompt: the step is the job, so a note about authority cannot read as a reason to skip it. */
+export declare const WORKFLOW_STEP_ASSIGNMENT = "This step is your assigned job. The person who started this workflow approved the script that gives it to you, so carry it out and report what you found or did; do not decline it or skip it.";
+/**
+ * The prompt as the person should see it: the step task only. The assignment
+ * sentence is for the model; shown as the person's prompt it reads as raw
+ * instructions they never wrote.
+ */
+export declare function stepTaskOnly(prompt: string): string;
+//# sourceMappingURL=workflow-assignment.d.ts.map

package/dist/integrations/subagents/workflow-assignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-assignment.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/workflow-assignment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8HAA8H;AAC9H,eAAO,MAAM,wBAAwB,mMAC4J,CAAA;AAEjM;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/dist/integrations/workflows/doctrine.d.ts

@@ -1,7 +1,8 @@
 /**
- * What the model is told on a turn that offers the `workflow` tool, beside the
- * delegation doctrine. Said only when the tool is in the list: guidance about
- * a capability the turn does not have reads as one it should go looking for.
+ * What the model is told, beside the delegation doctrine, whenever the
+ * `workflow` tool is in its list. The tool is listed on every turn of a host
+ * that can run one, so this is the opt-in rule: stable text, so it does not
+ * change the cached prefix from one message to the next.
  */
 export declare const WORKFLOW_DOCTRINE: string;
 //# sourceMappingURL=doctrine.d.ts.map

package/dist/integrations/workflows/doctrine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctrine.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/doctrine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAIlB,CAAA"}
+{"version":3,"file":"doctrine.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/doctrine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAQlB,CAAA"}

package/dist/integrations/workflows/host.d.ts

@@ -37,6 +37,11 @@ export interface WorkflowHostOptions {
     readonly refusal: (turnId: TurnId) => string | undefined;
     /** Register the run with the delegation path under a turn id of its own. */
     readonly openRunTurn: (originTurnId: TurnId, runId: string) => WorkflowRunTurn;
+    /**
+     * The size advice paragraph for the tool description (see `workflowSizeAdvice`),
+     * fixed for the session. Absent or empty adds nothing.
+     */
+    readonly sizeAdvice?: string;
     /** Limits the run is held to, from the turn that started it. */
     readonly limitsFor?: (turnId: TurnId) => WorkflowLimits | undefined;
     /** Called once when a run ends (the conversation line and the model's message). */

package/dist/integrations/workflows/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/host.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAGN,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,cAAc,EAMnB,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAG9D,OAAO,EAAE,KAAK,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExE,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,SAAU,CAAA;AAChD,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAI7C,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAqB,GAAG,MAAM,CAa1F;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAA;IAChE;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACxD,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,eAAe,CAAA;IAC9E,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAA;IACnE,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CACvC;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAC7B;AAED,UAAU,iBAAiB;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAatD;AAoCD,kHAAkH;AAClH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAa9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA0L7E"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/host.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAGN,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,cAAc,EAMnB,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAG9D,OAAO,EAAE,KAAK,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExE,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,SAAU,CAAA;AAChD,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAI7C,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAqB,GAAG,MAAM,CAa1F;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAA;IAChE;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACxD,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,eAAe,CAAA;IAC9E;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAA;IACnE,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CACvC;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAC7B;AAED,UAAU,iBAAiB;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAatD;AAoCD,kHAAkH;AAClH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAa9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA0L7E"}

package/dist/integrations/workflows/offering.d.ts

@@ -1,38 +1,20 @@
 /**
- * When the `workflow` tool is in the model's tool list.
+ * The `workflow` tool: its name, the text
+ * the model reads, and who may start a run.
  *
- * A workflow is a lot of work started on one decision, so the tool is only
- * offered when the operator asked for orchestration: hypermode is on, or the
- * message armed the `workflow` composer trigger (the word "workflow", shown as
- * a tag and dropped with Alt+W), or it is the
- * `/workflow` command. Everything else gets the `Agent` tool alone. Pure.
+ * A workflow is a lot of work started on one decision, so the model is told
+ * when it may call the tool; the tool itself is listed on every turn of a host
+ * that can run one (the model is gated by wording, not by the list).
+ * The opt-in is the operator's keyword (`hypermode`, shown as a tag and
+ * dropped with Alt+W), hypermode being on, or their own words. Pure.
  */
 export declare const WORKFLOW_TOOL_NAME = "workflow";
 /** The line under a workflow's launch row in the conversation. */
 export declare const WORKFLOW_BACKGROUND_NOTE = "Running in the background (\u2193 to manage)";
-/**
- * Whether a message is the one `/workflow` composes. The bare word in a
- * message the operator typed is not a request by itself: it goes through the
- * composer-trigger matcher (`tui/triggers/`), which shows a tag and lets
- * Alt+W drop it.
- */
-export declare function isWorkflowCommandPrompt(text: string): boolean;
-export interface WorkflowOffering {
-    /** The session's hypermode. */
-    readonly hypermode: boolean;
-    /** The operator's `workflow` trigger is armed for this turn. */
-    readonly workflow: boolean;
-    /** The text of the operator's latest message. */
-    readonly userText: string;
-}
-export declare function workflowOffered(input: WorkflowOffering): boolean;
-/**
- * The `/workflow <task>` command, as the message the model receives: the
- * operator's task, plus the words that make the request explicit.
- */
-export declare function workflowCommandPrompt(task: string): string;
 /** The tool's description, as the model reads it. */
 export declare const WORKFLOW_TOOL_DESCRIPTION: string;
+/** The tool's description with the session's size advice (if any) after it. */
+export declare function workflowToolDescription(sizeAdvice?: string): string;
 /**
  * Why a turn may not start a workflow, or `undefined` when it may.
  *

package/dist/integrations/workflows/offering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offering.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/offering.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAE5C,kEAAkE;AAClE,eAAO,MAAM,wBAAwB,iDAA4C,CAAA;AAKjF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,MAAM,WAAW,gBAAgB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,qDAAqD;AACrD,eAAO,MAAM,yBAAyB,QAmB1B,CAAA;AAEZ;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB,GAAG,MAAM,GAAG,SAAS,CAGrB"}
+{"version":3,"file":"offering.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/offering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,kBAAkB,aAAa,CAAA;AAE5C,kEAAkE;AAClE,eAAO,MAAM,wBAAwB,iDAA4C,CAAA;AAEjF,qDAAqD;AACrD,eAAO,MAAM,yBAAyB,QAqB1B,CAAA;AAEZ,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,UAAU,SAAK,GAAG,MAAM,CAI/D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACrB,GAAG,MAAM,GAAG,SAAS,CAGrB"}

package/dist/integrations/workflows/size.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Workflow size: the advisory guideline the model reads, the "+500k" token
+ * target the person can type, and the large-run warning on the rail. Pure.
+ *
+ * The guideline is advice, never a limit; the target is a ceiling that
+ * `budget.total` carries into the script; the warning fires above 25 agents
+ * or 1.5M tokens unless the standing hypermode is on.
+ */
+export declare const WORKFLOW_SIZE_GUIDELINES: readonly ["unrestricted", "small", "medium", "large"];
+export type WorkflowSizeGuideline = (typeof WORKFLOW_SIZE_GUIDELINES)[number];
+/** The guideline when none is configured. */
+export declare const DEFAULT_WORKFLOW_SIZE_GUIDELINE: WorkflowSizeGuideline;
+export declare function isWorkflowSizeGuideline(value: unknown): value is WorkflowSizeGuideline;
+/** The agent count a guideline stays under, or undefined for `unrestricted`. */
+export declare function guidelineAgents(guideline: WorkflowSizeGuideline): number | undefined;
+/**
+ * The advisory paragraph appended to the tool description, or '' for
+ * `unrestricted`. `configured` is false when the guideline is the default.
+ */
+export declare function workflowSizeAdvice(guideline: WorkflowSizeGuideline, configured: boolean): string;
+/**
+ * The token target in a message the person typed: a standalone `+500k`,
+ * `+1.5m` or `+2b` (case-insensitive; the k, m or b suffix is required, so a
+ * bare number such as `+5000` in prose or a diff is never a target). The last
+ * one wins. Returns undefined when there is none. Call it only with the
+ * person's own text, never with model output or tool results.
+ */
+export declare function parseTokenTarget(text: string): number | undefined;
+/**
+ * The token ceiling a workflow runs under: the smaller of the turn's own
+ * budget (when positive) and the typed target, or undefined for neither.
+ */
+export declare function workflowTokenCeiling(turnBudget: number | undefined, typedTarget: number | undefined): number | undefined;
+export interface LargeRunInput {
+    /** Agents the script asked for so far, queued ones included. */
+    readonly scheduledAgents: number;
+    /** Agents that started. */
+    readonly startedAgents: number;
+    readonly totalTokens: number;
+    /** The standing hypermode is on: the person already asked for scale. */
+    readonly hypermode: boolean;
+    /** The guideline only when the person configured one. */
+    readonly configuredGuideline?: WorkflowSizeGuideline;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+/** Whether a running workflow is big enough to warn about. */
+export declare function isLargeRun(input: LargeRunInput): boolean;
+/** The rail row's warning, long form and short form. */
+export declare const LARGE_WORKFLOW_WARNING = "Large workflow \u00B7 /workflows to stop";
+export declare const LARGE_WORKFLOW_WARNING_SHORT = "Large workflow";
+//# sourceMappingURL=size.d.ts.map

package/dist/integrations/workflows/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../../../src/integrations/workflows/size.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,wBAAwB,uDAAwD,CAAA;AAC7F,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E,6CAA6C;AAC7C,eAAO,MAAM,+BAA+B,EAAE,qBAAgC,CAAA;AAI9E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,SAAS,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAEpF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAUhG;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,GAAG,SAAS,CAMpB;AAMD,MAAM,WAAW,aAAa;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,qBAAqB,CAAA;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;CAC3D;AAQD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAWxD;AAED,wDAAwD;AACxD,eAAO,MAAM,sBAAsB,6CAAwC,CAAA;AAC3E,eAAO,MAAM,4BAA4B,mBAAmB,CAAA"}

package/dist/permissions/live-mode.d.ts

@@ -5,8 +5,7 @@ import { type PermissionMode } from './mode.js';
  *
  * The mode used to be fixed when a turn began, so the interactive terminal
  * refused to change it until the turn ended ("Permissions were not changed.
- * Finish or stop the current work first."). The reference terminal does the
- * opposite: Shift+Tab takes effect at once, mid-turn, and only its footer
+ * Finish or stop the current work first."). Shift+Tab takes effect at once, mid-turn, and only its footer
  * changes. This is the half of that which decides tool calls.
  *
  * The rules, and why each is the safe one:

package/dist/permissions/live-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-mode.d.ts","sourceRoot":"","sources":["../../src/permissions/live-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,qBAAqB,EAA2B,MAAM,YAAY,CAAA;AAEpG,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,WAAW,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,eAAe;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,uFAAuF;IACvF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,cAAc,CAAA;IACpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,aAAa,CAAA;CAC5D;AAED,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,mDAAmD;IACnD,OAAO,IAAI,cAAc,CAAA;IACzB;;;;;;;OAOG;IACH,kBAAkB,IAAI,OAAO,CAAA;IAC7B,mEAAmE;IACnE,MAAM,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACxC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,KAAK,GAAG,eAAe,GAC3B,MAAM,CASR;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAwD/E"}
+{"version":3,"file":"live-mode.d.ts","sourceRoot":"","sources":["../../src/permissions/live-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,qBAAqB,EAA2B,MAAM,YAAY,CAAA;AAEpG,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,WAAW,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,WAAW,eAAe;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,uFAAuF;IACvF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,cAAc,CAAA;IACpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,aAAa,CAAA;CAC5D;AAED,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,mDAAmD;IACnD,OAAO,IAAI,cAAc,CAAA;IACzB;;;;;;;OAOG;IACH,kBAAkB,IAAI,OAAO,CAAA;IAC7B,mEAAmE;IACnE,MAAM,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACxC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,KAAK,GAAG,eAAe,GAC3B,MAAM,CASR;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAwD/E"}

package/dist/permissions/local-settings.d.ts

@@ -1,8 +1,8 @@
 /**
  * Where a "don't ask again" answer is written.
  *
- * The reference terminal writes an allow rule to the project's local settings
- * file, which git does not track, and keeps git
+ * An allow rule is written to the project's local settings
+ * file, which git does not track, and Namzu keeps git
  * from tracking it by adding `**` + the file's name to the person's GLOBAL
  * git ignore (`core.excludesFile`, else `$XDG_CONFIG_HOME/git/ignore`, else
  * `~/.config/git/ignore`) the first time it writes one, when the folder is in
@@ -46,8 +46,8 @@ export type IgnoreOutcome = {
     readonly reason: string;
 };
 /**
- * Make git ignore the local config in every repository, as the reference does
- * for its own: one `**` + name line in the global ignore file, only when the
+ * Make git ignore the local config in every repository: one `**` + name line in the global ignore
+ * file, only when the
  * folder is in a git work tree and git does not ignore the file already.
  * Never throws; the answer was remembered either way.
  */

package/dist/permissions/mode.d.ts

@@ -59,7 +59,7 @@ export interface ModeAvailability {
 /** The cycle with every stop on it. */
 export declare const FULL_AVAILABILITY: ModeAvailability;
 /**
- * The mode Shift+Tab moves to. The reference's cycle runs default, accept
+ * The mode Shift+Tab moves to. The cycle runs default, accept
  * edits, plan, then bypass and auto when the session may use them, then back
  * to default. `strict` is not on it, and neither is the kernel's unattended
  * `auto`: leaving either goes back to `prompt`.

package/dist/permissions/rules.d.ts

@@ -169,8 +169,7 @@ export declare function permissionLayersOf(config: {
  *
  * Each layer decides on its own, by the rules it always had: first match, the
  * most specific pattern first, a narrower allow beating a broader deny of the
- * same table. The layers are then combined the way the reference terminal
- * combines its sources: a layer that denies the call denies it, else a layer
+ * same table. The layers are then combined this way: a layer that denies the call denies it, else a layer
  * that asks asks, else a layer that allows allows, and no layer's word is lost
  * because a higher one wrote a table of its own. Which layer is higher does
  * not matter to the outcome, so a managed table adds to the rules below it

package/dist/permissions/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/permissions/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAGN,KAAK,iBAAiB,EACtB,KAAK,MAAM,EAIX,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,KAAK,sBAAsB,EAA0B,MAAM,aAAa,CAAA;AAEjF,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAIvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAE1F,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAExE,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAEjG;AAID,qFAAqF;AACrF,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,GAAG,GAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAe,GACrC,IAAI,CAWN;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAClD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,OAAO,GAAG,MAAe,GACjC,MAAM,CASR;AA+CD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,MAAM,CAAC,EAAE,sBAAsB,GAC7B,mBAAmB,CAwJrB;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,GAChD,iBAAiB,CASnB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACxD,GAAG,SAAS,iBAAiB,EAAE,CAG/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,SAAS,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,EAClD,MAAM,CAAC,EAAE,sBAAsB,GAC7B,mBAAmB,CAiDrB"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/permissions/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAGN,KAAK,iBAAiB,EACtB,KAAK,MAAM,EAIX,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,KAAK,sBAAsB,EAA0B,MAAM,aAAa,CAAA;AAEjF,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAIvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAE1F,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAExE,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAEjG;AAID,qFAAqF;AACrF,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,GAAG,GAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAe,GACrC,IAAI,CAWN;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAClD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,OAAO,GAAG,MAAe,GACjC,MAAM,CASR;AA+CD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,MAAM,CAAC,EAAE,sBAAsB,GAC7B,mBAAmB,CAwJrB;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,GAChD,iBAAiB,CASnB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACxD,GAAG,SAAS,iBAAiB,EAAE,CAG/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,SAAS,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,EAClD,MAAM,CAAC,EAAE,sBAAsB,GAC7B,mBAAmB,CAiDrB"}

package/dist/permissions/session-allow.d.ts

@@ -1,8 +1,8 @@
 /**
  * What a "don't ask again" answer remembers.
  *
- * The reference turns an answer into a permission suggestion that "yes"
- * applies and writes it to the project's local settings file. This is the
+ * Each answer is offered as a permission suggestion that "yes"
+ * applies and that is written to the project's local settings file. This is the
  * Namzu side of that: an allow the operator gave at a prompt, written to the
  * project's `namzu.config.local.json` (see `local-settings.ts`), where the next
  * session reads it back as the local layer of the config cascade, and held in
@@ -12,7 +12,7 @@
  * kernel escalation (a sandbox escape, a path outside the roots, a protected
  * path, a catastrophic removal) is reviewed whatever any rule says.
  *
- * A command is remembered the way the reference suggests it: the first two
+ * A command is remembered as its first two
  * words and a star (`git commit *`) when the second word is a plain
  * subcommand and the first is not a shell or a wrapper; the exact command
  * otherwise. A compound line gets one rule per command in it.
@@ -52,31 +52,31 @@ export interface AllowableCall {
     readonly escalation?: unknown;
 }
 export declare const WEB_FETCH_TOOL = "web_fetch";
-/** Rules one answer may write; the reference stops at five for a compound line. */
+/** Rules one answer may write; a compound line stops at five. */
 export declare const MAX_RULES_PER_ANSWER = 5;
 /** Tools whose command line is one argument; `bash` today. */
 export type CommandArguments = ReadonlyMap<string, string>;
 /**
- * The first two words of a command, when the reference would offer them as a
+ * The first two words of a command, when they would be offered as a
  * rule: at least two words, the first not a shell or a wrapper, the second a
  * plain subcommand. `git commit -m x` gives `git commit`; `git -C dir status`,
  * `bash -c x`, `sudo ls` and `ls -la` give nothing.
  *
- * A line that starts with a variable assignment gives nothing either. The
- * reference strips safe assignments and offers the prefix; a Namzu rule is
- * matched against the command as written, assignments included, so the prefix
- * would never match the line it was offered for.
+ * A line that starts with a variable assignment gives nothing either. Namzu does not strip safe
+ * assignments: a rule is matched against the
+ * command as written, assignments included, so the prefix would never match
+ * the line it was offered for.
  */
 export declare function twoWordPrefix(command: string): string | undefined;
 /**
  * The allows a "don't ask again" answer would remember for one call, or none.
  *
  * One plain command gives one rule. A compound line gives one rule per command
- * in it, as the reference does, up to five; the rules only help together, so a
+ * in it, up to five; the rules only help together, so a
  * line any of whose commands has no rule form (a glob, a substitution, a
  * redirection) gives none. A line that spans several lines, or carries a
- * here-document, gives none either: the reference offers the first line's
- * prefix there, which would cover whatever follows it, and a Namzu rule is
+ * here-document, gives none either: the first line's prefix would cover
+ * whatever follows it, and a Namzu rule is
  * matched command by command.
  */
 export declare function allowsFor(call: AllowableCall, commands: CommandArguments): readonly SessionAllow[] | undefined;

package/dist/permissions/session-allow.d.ts.map

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

package/dist/plan/approval.d.ts

@@ -2,8 +2,7 @@ import type { PermissionMode } from '../permissions/mode.js';
 /**
  * The approval the person gives a plan.
  *
- * Rows and order follow the reference terminal's dialog when no "clear the
- * context" row is configured: the first row leaves plan mode for auto-accepting
+ * Rows and order, when no "clear the context" row is configured: the first row leaves plan mode for auto-accepting
  * edits (or, when the session may run without asking, for that), the second for
  * asking before each edit, and the last is a text row, "keep planning", whose
  * typed words go back to the model. Approving keeps the conversation as it is.

package/dist/plan/approval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/plan/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CACjC;AAED,MAAM,MAAM,kBAAkB;AAC7B,oFAAoF;AAClF;IACA,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACzB;AACH,+FAA+F;GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,8GAA8G;AAC9G,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,WAAW,KAChB,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEhC,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,sBAAsB,GAAG,aAAa,GAAG,eAAe,CAAA;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAC9B;AAED,eAAO,MAAM,yBAAyB,8BAA8B,CAAA;AAEpE,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAoBrF;AAED,eAAO,MAAM,wBAAwB,mBAAmB,CAAA"}
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/plan/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CACjC;AAED,MAAM,MAAM,kBAAkB;AAC7B,oFAAoF;AAClF;IACA,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACzB;AACH,+FAA+F;GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,8GAA8G;AAC9G,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,WAAW,KAChB,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEhC,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,sBAAsB,GAAG,aAAa,GAAG,eAAe,CAAA;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAC9B;AAED,eAAO,MAAM,yBAAyB,8BAA8B,CAAA;AAEpE,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAoBrF;AAED,eAAO,MAAM,wBAAwB,mBAAmB,CAAA"}

package/dist/reminders/frame.d.ts

@@ -7,7 +7,7 @@ import type { Message } from '@namzu/sdk';
  * it has already sent: the conversation is the only record, so a resumed or
  * compacted conversation needs no counter of its own.
  */
-export type ReminderKind = 'plan-mode' | 'plan-reentry' | 'plan-exit' | 'task-nudge';
+export type ReminderKind = 'plan-mode' | 'plan-reentry' | 'plan-exit' | 'task-nudge' | 'hypermode-on' | 'hypermode-exit';
 export declare function frameReminder(kind: ReminderKind, text: string, form?: 'full' | 'sparse'): string;
 /** Which of this terminal's reminders a message is, or `undefined` for any other message. */
 export declare function reminderKindOf(message: Message): ReminderKind | undefined;

package/dist/reminders/frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/reminders/frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,CAAA;AAIpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAKhG;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CASzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQxD"}
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/reminders/frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GACrB,WAAW,GACX,cAAc,GACd,WAAW,GACX,YAAY,GACZ,cAAc,GACd,gBAAgB,CAAA;AAInB,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAKhG;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAWzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQxD"}

package/dist/reminders/hypermode.d.ts

@@ -0,0 +1,31 @@
+import type { Message } from '@namzu/sdk';
+/**
+ * What the model is told about the standing hypermode, turn by turn.
+ *
+ * - on, and the last thing said was not "on": the full text;
+ * - on, said, and {@link HYPERMODE_REMINDER_EVERY} operator messages have
+ *   passed since: the sparse text;
+ * - off, and the last thing said was "on": the exit text, once.
+ *
+ * Like the plan-mode reminders, the count runs over the conversation: what was
+ * said is the reminders already in it. A resumed conversation therefore does
+ * not hear the full text again, and one whose history was compacted away
+ * hears it once more.
+ */
+export declare const HYPERMODE_REMINDER_EVERY = 10;
+export interface HypermodeReminderInput {
+    readonly messages: readonly Message[];
+    /** Whether hypermode is on for the request about to be made. */
+    readonly on: boolean;
+    /** Whether the `workflow` tool is in this request's tool list. */
+    readonly toolListed: boolean;
+}
+/**
+ * Whether the latest thing said about hypermode in this conversation was
+ * "on", so the exit text is still owed when the mode is off now. A host
+ * that does not otherwise feed reminders uses it to make a source anyway.
+ */
+export declare function hypermodeExitOwed(messages: readonly Message[]): boolean;
+/** The reminders to append before the next request; empty when there is nothing to say. */
+export declare function hypermodeReminders(input: HypermodeReminderInput): string[];
+//# sourceMappingURL=hypermode.d.ts.map

package/dist/reminders/hypermode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypermode.d.ts","sourceRoot":"","sources":["../../src/reminders/hypermode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIzC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAe1C,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC5B;AAiBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAEvE;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAkB1E"}

package/dist/reminders/index.d.ts

@@ -1,6 +1,7 @@
 import type { ReminderSource, Task } from '@namzu/sdk';
 import type { PermissionMode } from '../permissions/mode.js';
 export { frameReminder, reminderKindOf } from './frame.js';
+export { HYPERMODE_REMINDER_EVERY, hypermodeExitOwed, hypermodeReminders } from './hypermode.js';
 export { planModeReminders } from './plan-mode.js';
 export { taskNudge } from './task-nudge.js';
 export interface CliReminderOptions {
@@ -12,11 +13,16 @@ export interface CliReminderOptions {
     readonly canAsk?: boolean;
     /** The session's tasks, when it has task tools; absent means no nudge. */
     readonly tasks?: () => Promise<readonly Pick<Task, 'id' | 'status' | 'subject'>[]>;
+    /** Whether hypermode is on, and whether the `workflow` tool is listed; absent means no hypermode reminders. */
+    readonly hypermode?: () => {
+        readonly on: boolean;
+        readonly toolListed: boolean;
+    };
     /** Whether the plan file exists; defaults to the filesystem. */
     readonly planExists?: (path: string) => boolean;
 }
 /**
- * The reminders this terminal feeds a turn: plan mode's, then the task nudge.
+ * The reminders this terminal feeds a turn: plan mode's, hypermode's, then the task nudge.
  * Both read the conversation they are handed, so there is nothing to carry
  * between requests.
  */

package/dist/reminders/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reminders/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAI5D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,WAAW,kBAAkB;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,cAAc,CAAA;IACnC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IAChC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;IAClF,gEAAgE;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAC/C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAsBnF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reminders/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAK5D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,WAAW,kBAAkB;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,cAAc,CAAA;IACnC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IAChC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;IAClF,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;QAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAA;IACjF,gEAAgE;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAC/C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAuBnF"}

package/dist/reminders/plan-mode.d.ts

@@ -1,6 +1,6 @@
 import type { Message } from '@namzu/sdk';
 /**
- * Plan-mode reminders, on the cadence the reference terminal uses: a reminder
+ * Plan-mode reminders: a reminder
  * is sent when plan mode is on and none has been sent in the last 5 operator
  * turns; the first of a stretch is the full text, and so is every 5th after it
  * (1st, 6th, 11th …); the ones between are one short line. Leaving plan mode

package/dist/reminders/task-nudge.d.ts

@@ -1,6 +1,6 @@
 import type { Message, Task } from '@namzu/sdk';
 /**
- * The task-list nudge, on the reference terminal's numbers: after 10 model
+ * The task-list nudge: after 10 model
  * turns without a task tool, and no more than once per 10 model turns, the
  * model is reminded the list exists and shown its current contents.
  *

package/dist/schedule/fire/fire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fire.d.ts","sourceRoot":"","sources":["../../../src/schedule/fire/fire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAeH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAsB7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOhD,OAAO,EACN,KAAK,WAAW,EAGhB,KAAK,kBAAkB,EAEvB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAyB,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAQhF,eAAO,MAAM,WAAW,uDAAuD,CAAA;AAC/E,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BnF;AAmDD,eAAO,MAAM,2BAA2B,wLACoI,CAAA;AAE5K,MAAM,WAAW,gBAAgB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IAChC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CACpB,cAAc,oBAAoB,CAAC,EACnC,mBAAmB,GAAG,oBAAoB,CAC1C,CAAA;IACD,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAA;CACnD;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC5B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,GAAE,gBAAqB,GACzB,OAAO,CAAC,MAAM,CAAC,CAwjBjB;AAiFD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD,GAAG,MAAM,CAGT;AAcD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"fire.d.ts","sourceRoot":"","sources":["../../../src/schedule/fire/fire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAeH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAsB7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOhD,OAAO,EACN,KAAK,WAAW,EAGhB,KAAK,kBAAkB,EAEvB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAyB,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAQhF,eAAO,MAAM,WAAW,uDAAuD,CAAA;AAC/E,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BnF;AAmDD,eAAO,MAAM,2BAA2B,wLACoI,CAAA;AAE5K,MAAM,WAAW,gBAAgB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IAChC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CACpB,cAAc,oBAAoB,CAAC,EACnC,mBAAmB,GAAG,oBAAoB,CAC1C,CAAA;IACD,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAA;CACnD;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC5B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,GAAE,gBAAqB,GACzB,OAAO,CAAC,MAAM,CAAC,CA2jBjB;AAiFD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD,GAAG,MAAM,CAGT;AAcD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAEpD"}