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

package/dist/interfaces/executor.d.ts

@@ -0,0 +1,36 @@
+import type { IKnowledgeRagHandle, IToolsRagHandle } from './knowledge-rag.js';
+import type { INeedResolver } from './need-resolver.js';
+import type { Budget, RunIdentity } from './stepper.js';
+import type { StreamChunk } from './streaming.js';
+import type { ITaskSpec } from './task-spec.js';
+import type { LlmTool, LlmUsage } from './types.js';
+export interface IExecutor {
+    readonly name: string;
+    execute(input: {
+        prompt: string;
+        tools: readonly LlmTool[];
+        knowledgeRag: IKnowledgeRagHandle;
+        toolsRag: IToolsRagHandle;
+        needResolver?: INeedResolver;
+        /**
+         * Formalized overall task (optional). When present it is kept as a
+         * persistent anchor in EVERY iteration and prefixes the tool-search query
+         * so the executor never loses sight of the overall task. Absent → behaves
+         * as before.
+         */
+        taskSpec?: ITaskSpec;
+        /** Executor is a LEAF; ignores depthRemaining, stops when budget.tokens.exhausted(). */
+        budget: Budget;
+        identity: RunIdentity;
+        signal?: AbortSignal;
+        sessionLogger?: {
+            logStep(name: string, data: unknown): void;
+        };
+        onProgress?: (event: StreamChunk) => void;
+    }): Promise<{
+        status: 'ok' | 'incomplete' | 'budget-exhausted';
+        missing?: string[];
+        usage: LlmUsage;
+    }>;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/interfaces/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;QAC1B,YAAY,EAAE,mBAAmB,CAAC;QAClC,QAAQ,EAAE,eAAe,CAAC;QAC1B,YAAY,CAAC,EAAE,aAAa,CAAC;QAC7B;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB,wFAAwF;QACxF,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,WAAW,CAAC;QACtB,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,GAAG,OAAO,CAAC;QACV,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,kBAAkB,CAAC;QACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,QAAQ,CAAC;KACjB,CAAC,CAAC;CACJ"}

package/dist/interfaces/executor.js

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

package/dist/interfaces/executor.js.map

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

package/dist/interfaces/index.d.ts

@@ -7,11 +7,14 @@ export type { ContextPath } from './context-path.js';
 export type { EpicFailTrace, IActivationStrategy, ICoordinatorConfig, ICoordinatorContext, IDispatchStrategy, IPlanningStrategy, Plan, PlanStep, StepResult, SubAgentWithDescription, } from './coordinator.js';
 export type { DagPlan, PlanNode } from './dag-plan.js';
 export type { ErrorContext, ErrorReaction, IErrorStrategy, } from './error-strategy.js';
+export type { IExecutor } from './executor.js';
 export type { FinalizerInput, FinalizerResult, IFinalizer, } from './finalizer.js';
 export type { CircuitBreakerStatus, HealthComponentStatus, HealthStatus, } from './health.js';
 export type { IHistoryMemory } from './history-memory.js';
 export type { HistoryTurn, IHistorySummarizer, } from './history-summarizer.js';
+export { InsufficientSignal } from './insufficient-signal.js';
 export type { IInterpreter, InterpretContext, InterpretResult, NodeResult, } from './interpreter.js';
+export type { IKnowledgeRagHandle, IToolsRagHandle, KnowledgeEntry, KnowledgeEntryMetadata, KnowledgeFilter, } from './knowledge-rag.js';
 export type { ILlm } from './llm.js';
 export type { ILlmCallStrategy } from './llm-call-strategy.js';
 export type { IMcpClient } from './mcp-client.js';
@@ -19,6 +22,7 @@ export type { ConnectionStrategyOptions, IMcpConnectionStrategy, McpClientFactor
 export type { CounterSnapshot, HistogramSnapshot, ICounter, IHistogram, IMetrics, MetricsSnapshot, } from './metrics.js';
 export type { IModelFilter, IModelInfo, IModelProvider, } from './model-provider.js';
 export type { IModelResolver } from './model-resolver.js';
+export type { INeedResolver } from './need-resolver.js';
 export type { BuiltInStageType, ControlFlowType, StageDefinition, StageType, } from './pipeline.js';
 export type { IPlanner, PlannerCatalogEntry, PlannerInput, PlannerResult, } from './planner.js';
 export type { IPluginLoader, IRagStoreConfig, ISmartAgentPlugin, IStageHandler, LoadedPlugins, PluginExports, RagScope, } from './plugin.js';
@@ -33,9 +37,15 @@ export type { ISessionManager } from './session.js';
 export type { SessionIdentity } from './session-identity.js';
 export type { ISkill, ISkillManager, ISkillMeta, ISkillResource, } from './skill.js';
 export type { IStateOracle, StateOracleInput, StateOracleResult, } from './state-oracle.js';
-export type { OnPartial, StreamChunk } from './streaming.js';
+export type { Budget, IStepper, IStepperInput, IStepperResult, ITokenLedger, RunIdentity, } from './stepper.js';
+export { TokenLedger } from './stepper.js';
+export type { IStepperInterpreter } from './stepper-interpreter.js';
+export type { IStepperPlanner } from './stepper-planner.js';
+export type { OnPartial, StepperRef, StreamChunk } from './streaming.js';
 export type { ISubAgent, ISubAgentInput, ISubAgentResult, SubAgentCapabilities, SubAgentRegistry, } from './subagent.js';
 export type { ISubAgentContextBuilder, SubAgentContextRequest, SubAgentContextResult, } from './subagent-context.js';
+export type { ITaskFormalizer, ITaskSpec } from './task-spec.js';
+export { renderTaskSpec } from './task-spec.js';
 export type { IToolSelectionStrategy } from './tool-selection-strategy.js';
 export type { ISpan, ITracer, SpanOptions, SpanStatus } from './tracer.js';
 export type { AgentConfig, CallOptions, ContextFrame, LlmFinishReason, LlmResponse, LlmStreamChunk, LlmTool, LlmToolCall, LlmToolCallDelta, LlmUsage, McpTool, McpToolResult, ModelUsageEntry, RagMetadata, RagResult, Result, StreamHookContext, StreamToolCall, Subprompt, SubpromptType, TimingEntry, ToolCallRecord, ToolHeartbeat, TraceContext, } from './types.js';

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

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

package/dist/interfaces/index.js

@@ -1,5 +1,8 @@
 export { OrchestratorError, } from './agent-contracts.js';
+export { InsufficientSignal } from './insufficient-signal.js';
 export { isBatchEmbedder } from './rag.js';
+export { TokenLedger } from './stepper.js';
+export { renderTaskSpec } from './task-spec.js';
 export { AssemblerError, ClassifierError, LlmError, McpError, RagError, SkillError, SmartAgentError, } from './types.js';
 export { ValidatorError } from './validator.js';
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AA+G9B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA4E3C,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AA2C9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AA8E9D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA2C3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiB3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA6BhD,OAAO,EACL,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/interfaces/insufficient-signal.d.ts

@@ -0,0 +1,7 @@
+import type { LlmUsage } from './types.js';
+export declare class InsufficientSignal extends Error {
+    readonly missing: string[];
+    readonly usage?: LlmUsage;
+    constructor(missing: string[], usage?: LlmUsage);
+}
+//# sourceMappingURL=insufficient-signal.d.ts.map

package/dist/interfaces/insufficient-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insufficient-signal.d.ts","sourceRoot":"","sources":["../../src/interfaces/insufficient-signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ;CAMhD"}

package/dist/interfaces/insufficient-signal.js

@@ -0,0 +1,11 @@
+export class InsufficientSignal extends Error {
+    missing;
+    usage;
+    constructor(missing, usage) {
+        super('insufficient');
+        this.name = 'InsufficientSignal';
+        this.missing = missing;
+        this.usage = usage;
+    }
+}
+//# sourceMappingURL=insufficient-signal.js.map

package/dist/interfaces/insufficient-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insufficient-signal.js","sourceRoot":"","sources":["../../src/interfaces/insufficient-signal.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,OAAO,CAAW;IAClB,KAAK,CAAY;IAC1B,YAAY,OAAiB,EAAE,KAAgB;QAC7C,KAAK,CAAC,cAAc,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

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/request-logger.d.ts

@@ -1,4 +1,4 @@
-export type LlmComponent = 'tool-loop' | 'classifier' | 'helper' | 'translate' | 'query-expander' | 'embedding' | 'planner' | 'reviewer' | 'finalizer' | 'oracle';
+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;
@@ -34,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. */

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,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,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"}
+{"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/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

@@ -1,29 +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 → interpreter → coordinator path.
+ * 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.
  *
- * `content` carries an LLM-output delta; `tool-call` flags a tool
- * invocation; `node-start` / `node-end` wrap a DAG node execution at
- * the interpreter layer. `nodeId` is supplied by the interpreter when
- * forwarding worker-emitted chunks (workers don't know their node id).
+ * 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: 'tool-call';
-    nodeId?: string;
-    name: string;
-    args?: unknown;
-} | {
-    kind: 'node-start';
-    nodeId: string;
+    kind: 'stepper-spawned';
+    source: StepperRef;
     goal: string;
 } | {
-    kind: 'node-end';
-    nodeId: 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

@@ -1 +1 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/interfaces/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}
+{"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/task-spec.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TaskSpec — the formalized overall task.
+ *
+ * Produced ONCE at the coordinator root by an {@link ITaskFormalizer} and then
+ * threaded down through every planner and executor (as a compact anchor) so no
+ * level "forgets" it is part of the overall task. It is BOUNDED on purpose — a
+ * few short fields, never the full conversation — to anchor context without a
+ * context explosion. Optional everywhere: when absent, the runtime behaves
+ * exactly as before (backward-compatible).
+ */
+export interface ITaskSpec {
+    /** The overall objective in one sentence. */
+    objective: string;
+    /** What the task should cover (optional). */
+    scope?: string;
+    /** Hard constraints the work must respect (optional). */
+    constraints?: readonly string[];
+    /** Expected shape of the final deliverable (optional). */
+    deliverable?: string;
+    /** The original user request, verbatim — the ground truth. */
+    raw: string;
+}
+/**
+ * Turns a raw prompt into a {@link ITaskSpec}. Implemented once with the
+ * strong (planner-tier) model at the coordinator root. MUST never throw on a
+ * bad LLM response — fall back to `{ objective: prompt, raw: prompt }`.
+ */
+export interface ITaskFormalizer {
+    readonly name: string;
+    formalize(input: {
+        prompt: string;
+        signal?: AbortSignal;
+    }): Promise<ITaskSpec>;
+}
+/**
+ * Render a TaskSpec as a compact, bounded anchor block for planner/executor
+ * prompts. A few lines — NOT the full history. Used both as a persistent
+ * "main task" reminder in the executor and as the overall-intent prefix for the
+ * tool-search query.
+ */
+export declare function renderTaskSpec(spec: ITaskSpec): string;
+//# sourceMappingURL=task-spec.d.ts.map

package/dist/interfaces/task-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-spec.d.ts","sourceRoot":"","sources":["../../src/interfaces/task-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,KAAK,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAOtD"}

package/dist/interfaces/task-spec.js

@@ -0,0 +1,17 @@
+/**
+ * Render a TaskSpec as a compact, bounded anchor block for planner/executor
+ * prompts. A few lines — NOT the full history. Used both as a persistent
+ * "main task" reminder in the executor and as the overall-intent prefix for the
+ * tool-search query.
+ */
+export function renderTaskSpec(spec) {
+    const lines = [`Overall task: ${spec.objective}`];
+    if (spec.scope)
+        lines.push(`Scope: ${spec.scope}`);
+    if (spec.constraints && spec.constraints.length > 0)
+        lines.push(`Constraints: ${spec.constraints.join('; ')}`);
+    if (spec.deliverable)
+        lines.push(`Deliverable: ${spec.deliverable}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=task-spec.js.map

package/dist/interfaces/task-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-spec.js","sourceRoot":"","sources":["../../src/interfaces/task-spec.ts"],"names":[],"mappings":"AAoCA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,MAAM,KAAK,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/llm-agent",
-  "version": "17.0.0",
+  "version": "18.0.0",
   "description": "Core interfaces, types, and lightweight default implementations for LLM agent orchestration.",
   "type": "module",
   "main": "dist/index.js",