@mcp-abap-adt/llm-agent 16.2.0 → 18.0.0

package/dist/interfaces/knowledge-rag.d.ts

@@ -0,0 +1,40 @@
+import type { LlmTool } from './types.js';
+export interface KnowledgeEntryMetadata {
+    traceId: string;
+    turnId: string;
+    stepperId: string;
+    parentStepperId?: string;
+    task: string;
+    artifactType: string;
+    toolName?: string;
+    createdAt: string;
+}
+export interface KnowledgeEntry {
+    content: string;
+    metadata: KnowledgeEntryMetadata;
+}
+export interface KnowledgeFilter {
+    traceId?: string;
+    turnId?: string;
+    stepperId?: string;
+    parentStepperId?: string;
+    artifactType?: string | readonly string[];
+    toolName?: string;
+}
+export interface IKnowledgeRagHandle {
+    query(text: string, opts?: {
+        k?: number;
+        filter?: KnowledgeFilter;
+    }): Promise<readonly KnowledgeEntry[]>;
+    list(filter: KnowledgeFilter): Promise<readonly KnowledgeEntry[]>;
+    write(entry: {
+        content: string;
+        metadata: KnowledgeEntryMetadata;
+    }): Promise<void>;
+    fingerprint(): string;
+}
+export interface IToolsRagHandle {
+    query(text: string, k?: number): Promise<readonly LlmTool[]>;
+    lookup(name: string): LlmTool | undefined;
+}
+//# sourceMappingURL=knowledge-rag.d.ts.map

package/dist/interfaces/knowledge-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-rag.d.ts","sourceRoot":"","sources":["../../src/interfaces/knowledge-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAA;KAAE,GAC9C,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAClE,KAAK,CAAC,KAAK,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,sBAAsB,CAAC;KAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC3C"}

package/dist/interfaces/knowledge-rag.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knowledge-rag.js.map

package/dist/interfaces/knowledge-rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-rag.js","sourceRoot":"","sources":["../../src/interfaces/knowledge-rag.ts"],"names":[],"mappings":""}

package/dist/interfaces/need-resolver.d.ts

@@ -0,0 +1,12 @@
+export interface INeedResolver {
+    /** Inspect an LLM utterance for an unmet-capability signal. Returns a
+     *  tools-RAG query string to discover the needed capability, or undefined
+     *  for a clean answer / normal tool call.
+     *  v1 scope: only `queryToolsRag`. (Reserved for 18.x: queryKnowledgeRag,
+     *  injectTools — intentionally NOT in the v1 contract so there are no dead
+     *  public fields the executor ignores; see review R1-F5.) */
+    resolve(llmResponse: string): Promise<{
+        queryToolsRag: string;
+    } | undefined>;
+}
+//# sourceMappingURL=need-resolver.d.ts.map

package/dist/interfaces/need-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"need-resolver.d.ts","sourceRoot":"","sources":["../../src/interfaces/need-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B;;;;;iEAK6D;IAC7D,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;CAC9E"}

package/dist/interfaces/need-resolver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=need-resolver.js.map

package/dist/interfaces/need-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"need-resolver.js","sourceRoot":"","sources":["../../src/interfaces/need-resolver.ts"],"names":[],"mappings":""}

package/dist/interfaces/planner.d.ts

@@ -0,0 +1,33 @@
+import type { ContextPath } from './context-path.js';
+import type { DagPlan } from './dag-plan.js';
+import type { LlmUsage } from './types.js';
+export interface PlannerCatalogEntry {
+    name: string;
+    description?: string;
+}
+export interface PlannerInput {
+    prompt: string;
+    agents: PlannerCatalogEntry[];
+    sessionId: string;
+    signal?: AbortSignal;
+    ancestorContext?: ContextPath;
+    reviewerFeedback?: string;
+}
+/** Wrapper returned by `IPlanner.plan`. Splits the pure domain plan from the
+ *  optional runtime telemetry, so the plan itself stays free of LLM-overhead
+ *  metadata that would otherwise leak into prompts (the reviewer serializes
+ *  `input.plan` via JSON.stringify into the critic prompt) or into
+ *  persistence. Non-LLM planners may omit `usage`. */
+export interface PlannerResult {
+    plan: DagPlan;
+    usage?: LlmUsage;
+}
+export interface IPlanner {
+    readonly name: string;
+    /** Optional model identifier (best-effort), surfaced to the coordinator so
+     *  per-role LLM usage can be attributed to a specific model in the request
+     *  logger. Non-LLM planners may omit it. */
+    readonly model?: string;
+    plan(input: PlannerInput): Promise<PlannerResult>;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/interfaces/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/interfaces/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;sDAIsD;AACtD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;gDAE4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACnD"}

package/dist/interfaces/planner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=planner.js.map

package/dist/interfaces/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/interfaces/planner.ts"],"names":[],"mappings":""}

package/dist/interfaces/request-logger.d.ts

@@ -1,4 +1,4 @@
-export type LlmComponent = 'tool-loop' | 'classifier' | 'helper' | 'translate' | 'query-expander' | 'embedding';
+export type LlmComponent = 'tool-loop' | 'classifier' | 'tool-definer' | 'helper' | 'translate' | 'query-expander' | 'embedding' | 'planner' | 'reviewer' | 'finalizer' | 'oracle';
 export type TokenCategory = 'initialization' | 'auxiliary' | 'request';
 export interface TokenBucket {
     promptTokens: number;
@@ -17,6 +17,9 @@ export interface LlmCallEntry {
     estimated?: boolean;
     scope?: 'initialization' | 'request';
     detail?: string;
+    /** Request correlation id (the server's traceId). Routes the entry to the
+     *  per-request delta; absent → session-cumulative only. */
+    requestId?: string;
 }
 export interface RagQueryEntry {
     store: string;
@@ -31,6 +34,9 @@ export interface ToolCallEntry {
     cached: boolean;
 }
 export interface RequestSummary {
+    /** Faithful sum across all byComponent entries (promptTokens, completionTokens,
+     *  totalTokens, requests). Equal to reducing byComponent values; never null. */
+    totals: TokenBucket;
     /** Per-model aggregated token usage. */
     byModel: Record<string, TokenBucket>;
     /** Per-component aggregated token usage. */
@@ -44,13 +50,21 @@ export interface RequestSummary {
 }
 export interface IRequestLogger {
     logLlmCall(entry: LlmCallEntry): void;
-    logRagQuery(entry: RagQueryEntry): void;
-    logToolCall(entry: ToolCallEntry): void;
-    /** Mark the start of a request for wall-clock duration tracking. */
-    startRequest(): void;
-    /** Mark the end of a request for wall-clock duration tracking. */
-    endRequest(): void;
-    getSummary(): RequestSummary;
+    logRagQuery(entry: RagQueryEntry & {
+        requestId?: string;
+    }): void;
+    logToolCall(entry: ToolCallEntry & {
+        requestId?: string;
+    }): void;
+    /** Enter a request scope. Nested-safe: depth-counted, bucket created if absent,
+     *  NEVER clears an existing bucket. */
+    startRequest(requestId?: string): void;
+    /** Leave a request scope. Depth-counted; NEVER deletes the bucket. */
+    endRequest(requestId?: string): void;
+    /** Explicitly free a request delta. The top-level owner (server) calls this
+     *  AFTER reading getSummary(requestId) for the response usage. */
+    dropRequest(requestId?: string): void;
+    getSummary(requestId?: string): RequestSummary;
     reset(): void;
 }
 //# sourceMappingURL=request-logger.d.ts.map

package/dist/interfaces/request-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../src/interfaces/request-logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,gBAAgB,GAChB,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,oEAAoE;IACpE,YAAY,IAAI,IAAI,CAAC;IACrB,kEAAkE;IAClE,UAAU,IAAI,IAAI,CAAC;IACnB,UAAU,IAAI,cAAc,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../src/interfaces/request-logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,YAAY,GACZ,cAAc,GACd,QAAQ,GACR,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;+DAC2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;oFACgF;IAChF,MAAM,EAAE,WAAW,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE;2CACuC;IACvC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,sEAAsE;IACtE,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;sEACkE;IAClE,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC/C,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/interfaces/review.d.ts

@@ -0,0 +1,66 @@
+import type { ContextPath } from './context-path.js';
+import type { DagPlan } from './dag-plan.js';
+import type { NodeResult } from './interpreter.js';
+import type { PlannerCatalogEntry } from './planner.js';
+import type { LlmUsage } from './types.js';
+export interface ReviewInput {
+    prompt: string;
+    plan: DagPlan;
+    agents: PlannerCatalogEntry[];
+    sessionId: string;
+    signal?: AbortSignal;
+    ancestorContext?: ContextPath;
+}
+/** Pure domain verdict from the reviewer. Telemetry (LLM usage) is carried
+ *  separately on the wrapper (`ReviewResult`) so it does not contaminate the
+ *  verdict object itself. */
+export type ReviewVerdict = {
+    pass: true;
+} | {
+    pass: false;
+    feedback: string;
+};
+/** Wrapper returned by `IReviewStrategy.review`. Keeps optional LLM-usage
+ *  telemetry OUT of the verdict (which is a pure domain decision); the
+ *  coordinator forwards `usage` into the session request logger. */
+export interface ReviewResult {
+    verdict: ReviewVerdict;
+    usage?: LlmUsage;
+}
+/** Input to the reviewer when a node FAILED during execution (slice 4a). */
+export interface ExecutionFailureInput {
+    objective?: string;
+    /** The plan as it stands now. */
+    plan: DagPlan;
+    /** Completed/failed nodes so far — the reviewer's view of current state. */
+    trace: NodeResult[];
+    failedNodeId: string;
+    error: string;
+    agents: PlannerCatalogEntry[];
+    sessionId: string;
+    signal?: AbortSignal;
+    ancestorContext?: ContextPath;
+}
+/** Pure domain recovery decision. Telemetry is carried on the wrapper. */
+export type ExecutionReviewDecision = {
+    action: 'abort';
+} | {
+    action: 'revise';
+    revisedPlan: DagPlan;
+};
+export interface ExecutionReviewResult {
+    decision: ExecutionReviewDecision;
+    usage?: LlmUsage;
+}
+export interface IReviewStrategy {
+    readonly name: string;
+    /** Optional model identifier (best-effort), surfaced to the coordinator so
+     *  per-role LLM usage can be attributed to a specific model in the request
+     *  logger. Non-LLM reviewers may omit it. */
+    readonly model?: string;
+    review(input: ReviewInput): Promise<ReviewResult>;
+    /** Decide recovery for an execution failure (slice 4a). OPTIONAL — a reviewer
+     *  that omits it cannot drive recovery (the strategy treats that as abort). */
+    reviewExecutionFailure?(input: ExecutionFailureInput): Promise<ExecutionReviewResult>;
+}
+//# sourceMappingURL=review.d.ts.map

package/dist/interfaces/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/interfaces/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;6BAE6B;AAC7B,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E;;oEAEoE;AACpE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,4EAA4E;IAC5E,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;iDAE6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD;mFAC+E;IAC/E,sBAAsB,CAAC,CACrB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC"}

package/dist/interfaces/review.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=review.js.map

package/dist/interfaces/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/interfaces/review.ts"],"names":[],"mappings":""}

package/dist/interfaces/session-identity.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Identity context for a session. `sessionId` is always present (server-issued
+ * cookie, RFC 6265). `userId` is populated only by authorization-enabled builds;
+ * the default server leaves it undefined. Extensible for future identity facets.
+ */
+export interface SessionIdentity {
+    readonly sessionId: string;
+    readonly userId?: string;
+}
+//# sourceMappingURL=session-identity.d.ts.map

package/dist/interfaces/session-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-identity.d.ts","sourceRoot":"","sources":["../../src/interfaces/session-identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/interfaces/session-identity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-identity.js.map

package/dist/interfaces/session-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-identity.js","sourceRoot":"","sources":["../../src/interfaces/session-identity.ts"],"names":[],"mappings":""}

package/dist/interfaces/state-oracle.d.ts

@@ -0,0 +1,22 @@
+import type { LlmUsage } from './types.js';
+export interface StateOracleInput {
+    query: string;
+    sessionId?: string;
+    signal?: AbortSignal;
+    trace?: {
+        traceId: string;
+    };
+    sessionLogger?: {
+        logStep(name: string, data: unknown): void;
+    };
+}
+export interface StateOracleResult {
+    answer: string;
+    usage?: LlmUsage;
+}
+export interface IStateOracle {
+    readonly name: string;
+    readonly model?: string;
+    query(input: StateOracleInput): Promise<StateOracleResult>;
+}
+//# sourceMappingURL=state-oracle.d.ts.map

package/dist/interfaces/state-oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-oracle.d.ts","sourceRoot":"","sources":["../../src/interfaces/state-oracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,aAAa,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5D"}

package/dist/interfaces/state-oracle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state-oracle.js.map

package/dist/interfaces/state-oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-oracle.js","sourceRoot":"","sources":["../../src/interfaces/state-oracle.ts"],"names":[],"mappings":""}

package/dist/interfaces/stepper-interpreter.d.ts

@@ -0,0 +1,27 @@
+import type { DagPlan } from './dag-plan.js';
+import type { IExecutor } from './executor.js';
+import type { IKnowledgeRagHandle, IToolsRagHandle } from './knowledge-rag.js';
+import type { Budget, IStepper, IStepperResult, RunIdentity } from './stepper.js';
+import type { StreamChunk } from './streaming.js';
+import type { ITaskSpec } from './task-spec.js';
+export interface IStepperInterpreter {
+    readonly name: string;
+    interpret(plan: DagPlan, ctx: {
+        prompt: string;
+        knowledgeRag: IKnowledgeRagHandle;
+        toolsRag: IToolsRagHandle;
+        childSteppers: ReadonlyMap<string, IStepper>;
+        executor: IExecutor;
+        budget: Budget;
+        identity: RunIdentity;
+        taskSpec?: ITaskSpec;
+        maxParallelSteps: number;
+        mintStepperId: () => string;
+        signal?: AbortSignal;
+        sessionLogger?: {
+            logStep(name: string, data: unknown): void;
+        };
+        onProgress?: (event: StreamChunk) => void;
+    }): Promise<IStepperResult>;
+}
+//# sourceMappingURL=stepper-interpreter.d.ts.map

package/dist/interfaces/stepper-interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper-interpreter.d.ts","sourceRoot":"","sources":["../../src/interfaces/stepper-interpreter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CACP,IAAI,EAAE,OAAO,EACb,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,mBAAmB,CAAC;QAClC,QAAQ,EAAE,eAAe,CAAC;QAC1B,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC7C,QAAQ,EAAE,SAAS,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,WAAW,CAAC;QACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,MAAM,CAAC;QAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,aAAa,CAAC,EAAE;YAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;SAAE,CAAC;QAC/D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;KAC3C,GACA,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B"}

package/dist/interfaces/stepper-interpreter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stepper-interpreter.js.map

package/dist/interfaces/stepper-interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper-interpreter.js","sourceRoot":"","sources":["../../src/interfaces/stepper-interpreter.ts"],"names":[],"mappings":""}

package/dist/interfaces/stepper-planner.d.ts

@@ -0,0 +1,32 @@
+import type { DagPlan } from './dag-plan.js';
+import type { IKnowledgeRagHandle, IToolsRagHandle } from './knowledge-rag.js';
+import type { RunIdentity } from './stepper.js';
+import type { ITaskSpec } from './task-spec.js';
+export interface IStepperPlanner {
+    readonly name: string;
+    plan(input: {
+        prompt: string;
+        knowledgeRag: IKnowledgeRagHandle;
+        toolsRag: IToolsRagHandle;
+        parentPath: string[];
+        identity: RunIdentity;
+        /**
+         * Formalized overall task (optional). When present, every planner at every
+         * level sees the overall task — not just its local sub-prompt — so plans
+         * stay aligned to the whole. Absent → behaves as before.
+         */
+        taskSpec?: ITaskSpec;
+        /**
+         * Child worker Steppers available for delegation (deep-stepper mode). The
+         * planner renders these into its prompt and may set a node's `agent` to one
+         * of these names to recurse into that child. Empty/omitted → the planner
+         * emits only leaves (executor-handled), i.e. flat planned-react behaviour.
+         */
+        agents?: ReadonlyArray<{
+            name: string;
+            description?: string;
+        }>;
+        signal?: AbortSignal;
+    }): Promise<DagPlan>;
+}
+//# sourceMappingURL=stepper-planner.d.ts.map

package/dist/interfaces/stepper-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper-planner.d.ts","sourceRoot":"","sources":["../../src/interfaces/stepper-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,mBAAmB,CAAC;QAClC,QAAQ,EAAE,eAAe,CAAC;QAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,EAAE,WAAW,CAAC;QACtB;;;;WAIG;QACH,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB;;;;;WAKG;QACH,MAAM,CAAC,EAAE,aAAa,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB"}

package/dist/interfaces/stepper-planner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stepper-planner.js.map

package/dist/interfaces/stepper-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper-planner.js","sourceRoot":"","sources":["../../src/interfaces/stepper-planner.ts"],"names":[],"mappings":""}

package/dist/interfaces/stepper.d.ts

@@ -0,0 +1,73 @@
+import type { IKnowledgeRagHandle, IToolsRagHandle } from './knowledge-rag.js';
+import type { StreamChunk } from './streaming.js';
+import type { ITaskSpec } from './task-spec.js';
+import type { LlmUsage } from './types.js';
+/** Identity carried through every layer so executors can stamp
+ *  KnowledgeEntryMetadata and the coordinator can attribute streaming
+ *  + usage. Minted at the coordinator boundary; the interpreter rewrites
+ *  stepperId/parentStepperId at each dispatch. */
+export interface RunIdentity {
+    traceId: string;
+    turnId: string;
+    sessionId: string;
+    stepperId: string;
+    parentStepperId?: string;
+}
+/** Shared, live token ledger (review R2-F1). ONE instance is created at the
+ *  coordinator boundary and passed BY REFERENCE through the whole run. Every
+ *  Stepper and executor reads `exhausted()` before each LLM call and calls
+ *  `spend(usage)` after. This is a SOFT cap (review R3-F2/R5-F1): parallel
+ *  siblings can each pass the pre-check before any records its spend, so the
+ *  run can overshoot by at most (total in-flight calls across the tree ×
+ *  tokens-per-call). maxParallelSteps bounds only each LOCAL scheduler; the
+ *  global in-flight count is ≈ maxParallelSteps^depth worst case. The
+ *  budget-extension ClarifySignal is the real net. Tokens bound WORK; depth
+ *  (a per-branch value below) bounds RECURSION. A reserve-before-call hard
+ *  cap is deferred. */
+export interface ITokenLedger {
+    readonly remaining: number;
+    spend(usage: LlmUsage): void;
+    exhausted(): boolean;
+}
+export interface Budget {
+    /** Per-branch recursion bound — a plain value, decremented by 1 at each
+     *  child dispatch (NOT shared). */
+    depthRemaining: number;
+    /** Shared run-wide token ledger — the SAME object reference for every
+     *  Stepper/executor in the run. */
+    tokens: ITokenLedger;
+}
+export interface IStepperInput {
+    prompt: string;
+    knowledgeRag: IKnowledgeRagHandle;
+    toolsRag: IToolsRagHandle;
+    budget: Budget;
+    identity: RunIdentity;
+    /** Formalized overall task (optional). Threaded down to every planner and
+     *  executor as a compact anchor. Absent → behaves as before. */
+    taskSpec?: ITaskSpec;
+    signal?: AbortSignal;
+    sessionLogger?: {
+        logStep(name: string, data: unknown): void;
+    };
+    onProgress?: (event: StreamChunk) => void;
+}
+export interface IStepperResult {
+    status: 'ok' | 'incomplete' | 'budget-exhausted';
+    missing?: string[];
+    usage: LlmUsage;
+}
+export interface IStepper {
+    readonly name: string;
+    run(input: IStepperInput): Promise<IStepperResult>;
+}
+/** Default mutable ledger. Created once per run with the configured token
+ *  budget; shared by reference. */
+export declare class TokenLedger implements ITokenLedger {
+    private _remaining;
+    constructor(total: number);
+    get remaining(): number;
+    spend(usage: LlmUsage): void;
+    exhausted(): boolean;
+}
+//# sourceMappingURL=stepper.d.ts.map

package/dist/interfaces/stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/interfaces/stepper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;kDAGkD;AAClD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;uBAUuB;AACvB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB;uCACmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB;uCACmC;IACnC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,mBAAmB,CAAC;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB;oEACgE;IAChE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,kBAAkB,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACpD;AAED;mCACmC;AACnC,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,UAAU,CAAS;gBACf,KAAK,EAAE,MAAM;IAGzB,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAG5B,SAAS,IAAI,OAAO;CAGrB"}

package/dist/interfaces/stepper.js

@@ -0,0 +1,18 @@
+/** Default mutable ledger. Created once per run with the configured token
+ *  budget; shared by reference. */
+export class TokenLedger {
+    _remaining;
+    constructor(total) {
+        this._remaining = total;
+    }
+    get remaining() {
+        return this._remaining;
+    }
+    spend(usage) {
+        this._remaining -= usage.totalTokens;
+    }
+    exhausted() {
+        return this._remaining <= 0;
+    }
+}
+//# sourceMappingURL=stepper.js.map

package/dist/interfaces/stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.js","sourceRoot":"","sources":["../../src/interfaces/stepper.ts"],"names":[],"mappings":"AAoEA;mCACmC;AACnC,MAAM,OAAO,WAAW;IACd,UAAU,CAAS;IAC3B,YAAY,KAAa;QACvB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IACD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,KAAK,CAAC,KAAe;QACnB,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IACD,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/interfaces/streaming.d.ts

@@ -0,0 +1,69 @@
+import type { LlmComponent } from './request-logger.js';
+import type { LlmUsage } from './types.js';
+/**
+ * Stable reference to a Stepper execution. Minted at dispatch (for recursive
+ * Stepper construction) or synthesized for terminal executor invocations.
+ * Unique across the whole run.
+ */
+export interface StepperRef {
+    /** Stable UUID minted at each dispatch. */
+    stepperId: string;
+    /** Parent Stepper ID (undefined at root or for terminal executors). */
+    parentStepperId?: string;
+    /** Human-readable name (goal name or executor type). */
+    name: string;
+}
+/**
+ * Per-event chunk type emitted by `onPartial` callbacks along the
+ * worker → Stepper → coordinator path.
+ *
+ * `content` carries an LLM-output delta. The 18.0 progress-event variants
+ * (`stepper-spawned`, `stepper-done`, `mcp-call`, `mcp-result`,
+ * `tokens-used`, `llm-call-start`, `llm-call-end`) each carry
+ * `source: StepperRef` for precise attribution in nested execution trees.
+ *
+ * BREAKING (18.0 / Task 19e): the 17.0 `tool-call`, `node-start`, and
+ * `node-end` variants have been removed. SSE clients must migrate to
+ * `mcp-call` / `mcp-result` / `stepper-spawned` / `stepper-done`.
+ */
+export type StreamChunk = {
+    kind: 'content';
+    nodeId?: string;
+    delta: string;
+} | {
+    kind: 'stepper-spawned';
+    source: StepperRef;
+    goal: string;
+} | {
+    kind: 'stepper-done';
+    source: StepperRef;
+    ok: boolean;
+} | {
+    kind: 'mcp-call';
+    source: StepperRef;
+    tool: string;
+    args?: unknown;
+} | {
+    kind: 'mcp-result';
+    source: StepperRef;
+    tool: string;
+    durationMs: number;
+    bytes?: number;
+} | {
+    kind: 'tokens-used';
+    source: StepperRef;
+    component: LlmComponent;
+    delta: LlmUsage;
+} | {
+    kind: 'llm-call-start';
+    source: StepperRef;
+    component: LlmComponent;
+    model: string;
+} | {
+    kind: 'llm-call-end';
+    source: StepperRef;
+    component: LlmComponent;
+    durationMs: number;
+};
+export type OnPartial = (chunk: StreamChunk) => void;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/interfaces/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/interfaces/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAEnD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACtE;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,QAAQ,CAAC;CACjB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}

package/dist/interfaces/streaming.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streaming.js.map

package/dist/interfaces/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/interfaces/streaming.ts"],"names":[],"mappings":""}

package/dist/interfaces/subagent-context.d.ts

@@ -8,7 +8,6 @@ export interface SubAgentContextRequest {
     task: string;
     step: PlanStep;
     agent: ISubAgent;
-    layer: number;
     inputText: string;
     sessionId: string;
     signal?: AbortSignal;

package/dist/interfaces/subagent-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-context.d.ts","sourceRoot":"","sources":["../../src/interfaces/subagent-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpE"}
+{"version":3,"file":"subagent-context.d.ts","sourceRoot":"","sources":["../../src/interfaces/subagent-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpE"}