@namzu/cli 18.1.0 → 20.0.0

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

@@ -3,33 +3,35 @@
  * DEFINE a specialist on the fly — pass a `role` (the persona / system prompt)
  * 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 blocks until the child finishes and its final text returns as the
- * tool result, so a delegation surfaces in the transcript as a normal
- * `⏺ Agent(...)` call.
+ * The call waits for a final result unless operator input releases the wait.
+ * The child then stays owned by the parent run, and its completion reaches the
+ * same query's inbox. Headless callers without an input waiter remain blocking.
  *
  * The runtime is fully self-contained: a dedicated in-memory session/thread
  * store backs the AgentManager, so sub-agent bookkeeping never touches the
  * CLI's on-disk `/resume` conversation store.
  */
-import { type AuthorizationGateConfig, type LLMProvider, type PathBuilder, type ProjectInstructionContext, type ResumeHandler, type RunEvent, type SandboxProvider, type TaskScheduler, type ToolContext, type ToolDefinition, type ToolRegistryContract } from '@namzu/sdk';
+import { type AgentFileDefinition, type AuthorizationGateConfig, CompletionInbox, type LLMProvider, type PathBuilder, type Project, type ProjectInstructionContext, type ResumeHandler, type RunEvent, type RunId, type SandboxProvider, type SessionId, type TaskScheduler, type ToolContext, type ToolDefinition, type ToolRegistryContract, type Topic } from '@namzu/sdk';
 import { type SubagentActivitySource } from './activity.js';
 export declare const GENERAL_PURPOSE_SUBAGENT = "general-purpose";
 /**
- * A sub-agent that can only look.
- *
- * "Find where X is defined", "which files reference Y", "how does Z work" are
- * the delegations a parent makes most, and every one of them ran with
- * `write`, `edit` and `bash` in the child's roster — so a lookup needed the
- * same approvals as a change, and an operator in `accept-edits` mode was
- * still asked about a child's shell command that only wanted to `cat`. This
- * definition's registry is the parent's working set filtered to tools that
- * declare themselves read-only, so a child that cannot change anything is
- * never asked whether it may.
+ * The kernel's read-only delegate, with this application's doctrine under
+ * its prompt. Roster and prompt come from `@namzu/sdk`; what is added here is
+ * the same working rules every namzu child gets.
  */
 export declare const EXPLORE_SUBAGENT = "explore";
+export interface SubagentParent {
+    readonly project: Project;
+    readonly topic: Topic;
+    readonly sessionId: SessionId;
+}
 export interface SubagentRuntimeOptions {
+    /** Resolve the actual invoking run; reject calls whose parent no longer exists. */
+    readonly resolveParent: (runId: RunId) => Promise<SubagentParent>;
     readonly cwd: string;
     readonly model: string;
+    /** Aggregate parent-and-descendant limit; defaults to the CLI's one million tokens. */
+    readonly tokenBudget?: number;
     /** Durable layout for child runs; omitted preserves the SDK default. */
     readonly pathBuilder?: PathBuilder;
     /** Root every child allocation at the session workspace or a fresh temp tree. */
@@ -44,6 +46,8 @@ export interface SubagentRuntimeOptions {
      * the Agent tool. Absent means the child has no human review channel.
      */
     readonly resolveResumeHandler?: (runId: ToolContext['runId']) => ResumeHandler | undefined;
+    /** Wake a delegation wait when this parent has undelivered operator input. */
+    readonly resolveWaitForInbound?: (runId: RunId) => ((signal: AbortSignal) => Promise<void>) | undefined;
     /** Use the same execution boundary the parent session reports. */
     readonly sandboxProvider?: SandboxProvider;
     /** Bound child teardown with the parent's operator-selected value. */
@@ -62,10 +66,23 @@ export interface SubagentRuntimeOptions {
     readonly readEnvironment?: () => Promise<string>;
     /** Receives the child's RunEvents (lineage-stamped) — for the tree view. */
     readonly onEvent?: (event: RunEvent) => void;
+    /**
+     * Agents a project or user defined in `.namzu/agents/<name>.md`. Each
+     * becomes a type the `Agent` tool offers beside the built-in two, with
+     * its own prompt, roster and model. See `definitions.ts`.
+     */
+    readonly definitions?: readonly AgentFileDefinition[];
 }
 export interface SubagentRuntime {
-    readonly gateway: TaskScheduler;
+    /** One immutable scheduler context per actual parent run. */
+    gatewayForRun(runId: RunId): Promise<TaskScheduler>;
+    /** The same inbox the parent query drains after a delegation yields. */
+    completionInboxForRun(runId: RunId): Promise<CompletionInbox>;
+    /** Release a settled parent's bookkeeping and cancel children it still owns. */
+    releaseRun(runId: RunId): Promise<void>;
     readonly agentTool: ToolDefinition;
+    /** Retrieve a child result without starting another task. */
+    readonly waitForTaskTool: ToolDefinition;
     readonly allowedAgentIds: readonly string[];
     /** Live, bounded observation of children created by this CLI session. */
     readonly activity: SubagentActivitySource;
@@ -74,7 +91,7 @@ export interface SubagentRuntime {
 }
 /**
  * Stand up the AgentManager + gateway + `Agent` tool. Returns the tool to
- * register on the parent and the gateway to pass to `query({ taskGateway })`.
+ * register on the parent and the gateway to pass to `query({ taskScheduler })`.
  */
 export declare function createSubagentRuntime(opts: SubagentRuntimeOptions): Promise<SubagentRuntime>;
 //# sourceMappingURL=runtime.d.ts.map

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;;;;;;;;;;;;GAYG;AAEH,OAAO,EAMN,KAAK,uBAAuB,EAQ5B,KAAK,WAAW,EAEhB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAG9B,KAAK,aAAa,EAElB,KAAK,QAAQ,EACb,KAAK,eAAe,EAGpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EASzB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAIN,KAAK,sBAAsB,EAC3B,MAAM,eAAe,CAAA;AAGtB,eAAO,MAAM,wBAAwB,oBAAoB,CAAA;AACzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAA;AA6CzC,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAAA;IAC7D,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,MAAM,WAAW,CAAA;IACzC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,oBAAoB,CAAA;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,CAAA;IACpD;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,aAAa,GAAG,SAAS,CAAA;IAC1F,kEAAkE;IAClE,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAA;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,yBAAyB,CAAA;IACpE;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAChD,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;IACzC,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAQD;;;GAGG;AACH,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,sBAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA2R1B"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/runtime.ts"],"names":[],"mappings":"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"}