@adhd/agent-engine-orchestrator 2.1.0

package/src/providers/factory.js

@@ -0,0 +1,18 @@
+import { AnthropicProvider } from "./anthropic.js";
+import { ClaudeCliProvider } from "./claudecli.js";
+import { OpenAIProvider } from "./openai.js";
+export function createProvider(providerConfig, mcpServers, engineConfig, engineLogger) {
+    switch (providerConfig.type) {
+        case "anthropic":
+            return new AnthropicProvider(providerConfig, engineConfig ?? {}, engineLogger ?? { info: () => { }, warn: () => { }, error: () => { }, debug: () => { } });
+        case "claudecli":
+            return new ClaudeCliProvider(providerConfig, mcpServers ?? {}, undefined, engineConfig, engineLogger);
+        case "openai":
+            return new OpenAIProvider(providerConfig, engineConfig ?? {});
+        default: {
+            const exhaustive = providerConfig;
+            throw new Error(`Unknown provider type: ${exhaustive.type}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/src/providers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,UAAU,cAAc,CAC1B,cAA8B,EAC9B,UAA4C,EAC5C,YAA2B,EAC3B,YAA2B;IAE3B,QAAQ,cAAc,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,WAAW;YACZ,OAAO,IAAI,iBAAiB,CAAC,cAAc,EAAE,YAAY,IAAI,EAAkB,EAAE,YAAY,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAkB,CAAC,CAAC;QAC3L,KAAK,WAAW;YACZ,OAAO,IAAI,iBAAiB,CAAC,cAAc,EAAE,UAAU,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAC1G,KAAK,QAAQ;YACT,OAAO,IAAI,cAAc,CAAC,cAAc,EAAE,YAAY,IAAI,EAAkB,CAAC,CAAC;QAClF,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,UAAU,GAAU,cAAc,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,0BAA2B,UAA+B,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;AACL,CAAC"}

package/src/providers/index.d.ts

@@ -0,0 +1,6 @@
+export { AnthropicProvider } from "./anthropic.js";
+export { OpenAIProvider } from "./openai.js";
+export { ClaudeCliProvider, computeClaudeBuiltinArgs } from "./claudecli.js";
+export { createProvider } from "./factory.js";
+export type { LLMProvider, ProviderChatRequest, ProviderChatResponse, ToolDefinition } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/src/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/src/providers/index.js

@@ -0,0 +1,5 @@
+export { AnthropicProvider } from "./anthropic.js";
+export { OpenAIProvider } from "./openai.js";
+export { ClaudeCliProvider, computeClaudeBuiltinArgs } from "./claudecli.js";
+export { createProvider } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/src/providers/openai.d.ts

@@ -0,0 +1,30 @@
+import OpenAI from "openai";
+import type { EngineConfig } from "../interfaces.js";
+import type { ProviderConfig } from "../validation/index.js";
+import type { TokenUsage } from "@adhd/agent-base-types";
+import type { LLMProvider, ProviderChatRequest, ProviderChatResponse } from "./types.js";
+/**
+ * OpenAI-compatible usage payloads report cached input two different ways:
+ *   - OpenAI:   `prompt_tokens_details.cached_tokens`
+ *   - DeepSeek: `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens`
+ * Both are INCLUSIVE — `prompt_tokens` already contains the cached portion
+ * (DeepSeek documents `prompt_tokens = hit + miss` explicitly).
+ *
+ * Cache-hit vs cache-miss input differs 50x in price on deepseek-v4-flash
+ * ($0.0028/M vs $0.14/M), so dropping these fields hides the largest cost signal
+ * in the system. See BUG-ORCH-009.
+ */
+export declare function normaliseOpenAIUsage(sdkUsage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+}, stopReason: string, maxTokens?: number): TokenUsage;
+export declare class OpenAIProvider implements LLMProvider {
+    protected readonly client: OpenAI;
+    private readonly providerConfig;
+    protected readonly resolvedModel: string;
+    constructor(providerConfig: Extract<ProviderConfig, {
+        type: "openai";
+    }>, config: EngineConfig);
+    chat(request: ProviderChatRequest): Promise<ProviderChatResponse>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/src/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAO5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EACR,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EAEvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAC9D,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACnB,UAAU,CA4BZ;AA6DD,qBAAa,cAAe,YAAW,WAAW;IAC9C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8C;IAC7E,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAGrC,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,EAC3D,MAAM,EAAE,YAAY;IAsBlB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2E1E"}

package/src/providers/openai.js

@@ -0,0 +1,177 @@
+import OpenAI from "openai";
+import pRetry from "p-retry";
+import { generateId } from "../utils/ids.js";
+import { nowIso } from "../utils/timestamps.js";
+import { resolveToolCallName } from "../clients/tool-naming.js";
+/**
+ * OpenAI-compatible usage payloads report cached input two different ways:
+ *   - OpenAI:   `prompt_tokens_details.cached_tokens`
+ *   - DeepSeek: `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens`
+ * Both are INCLUSIVE — `prompt_tokens` already contains the cached portion
+ * (DeepSeek documents `prompt_tokens = hit + miss` explicitly).
+ *
+ * Cache-hit vs cache-miss input differs 50x in price on deepseek-v4-flash
+ * ($0.0028/M vs $0.14/M), so dropping these fields hides the largest cost signal
+ * in the system. See BUG-ORCH-009.
+ */
+export function normaliseOpenAIUsage(sdkUsage, stopReason, maxTokens) {
+    // DeepSeek's cache fields are not in the OpenAI SDK's CompletionUsage type, but they
+    // are present on the wire (`prompt_tokens = hit + miss`, documented). Widen to read them.
+    const usage = sdkUsage;
+    const cacheRead = usage.prompt_cache_hit_tokens ?? usage.prompt_tokens_details?.cached_tokens ?? 0;
+    // Prefer the provider's own miss count; otherwise derive it (the headline is inclusive).
+    const uncached = usage.prompt_cache_miss_tokens ?? Math.max(0, usage.prompt_tokens - cacheRead);
+    return {
+        // Already the true total on this family — the headline includes cached tokens.
+        inputTokens: usage.prompt_tokens,
+        outputTokens: usage.completion_tokens,
+        uncachedInputTokens: uncached,
+        cacheReadTokens: cacheRead,
+        // No OpenAI-compatible endpoint we target bills a separate cache write today.
+        cacheCreationTokens: 0,
+        reasoningTokens: usage.completion_tokens_details?.reasoning_tokens ?? undefined,
+        stopReason,
+        maxTokens,
+    };
+}
+function toOpenAIMessages(messages) {
+    return messages.map(message => {
+        switch (message.role) {
+            case "system":
+                return { role: "system", content: message.content || "" };
+            case "user":
+                return { role: "user", content: message.content || "" };
+            case "assistant": {
+                if (message.toolCalls && message.toolCalls.length > 0) {
+                    return {
+                        role: "assistant",
+                        content: message.content ?? null,
+                        tool_calls: message.toolCalls.map(tc => ({
+                            id: tc.id,
+                            type: "function",
+                            function: {
+                                name: `${tc.server}__${tc.tool}`,
+                                arguments: JSON.stringify(tc.arguments),
+                            },
+                        })),
+                    };
+                }
+                return { role: "assistant", content: message.content || "" };
+            }
+            case "tool": {
+                const toolResult = message.toolResults?.[0];
+                if (!toolResult) {
+                    throw new Error("Tool message missing tool result");
+                }
+                return {
+                    role: "tool",
+                    tool_call_id: toolResult.toolCallId,
+                    content: JSON.stringify(toolResult.result),
+                };
+            }
+            default: {
+                const exhaustive = message.role;
+                throw new Error(`Unsupported message role: ${exhaustive}`);
+            }
+        }
+    });
+}
+function toOpenAITools(tools) {
+    if (!tools)
+        return undefined;
+    return tools.map(tool => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description || "",
+            parameters: (tool.inputSchema || {
+                type: "object",
+                properties: {},
+            }),
+        },
+    }));
+}
+export class OpenAIProvider {
+    client;
+    providerConfig;
+    resolvedModel;
+    constructor(providerConfig, config) {
+        this.providerConfig = providerConfig;
+        const resolved = config.getProviderConfig({
+            provider: "openai",
+            secret: providerConfig.env?.secret,
+            url: providerConfig.env?.base_url,
+            model: providerConfig.env?.model,
+            inlineBaseURL: providerConfig.baseURL,
+            inlineModel: providerConfig.model,
+        });
+        this.resolvedModel = resolved.model ?? providerConfig.model ?? "";
+        this.client = new OpenAI({
+            apiKey: resolved.secret ?? "no-auth",
+            baseURL: resolved.baseURL,
+            timeout: providerConfig.timeoutMs ?? 60_000,
+        });
+    }
+    async chat(request) {
+        const retryConfig = this.providerConfig.retryConfig;
+        const run = async () => {
+            const response = await this.client.chat.completions.create({
+                model: this.resolvedModel,
+                temperature: this.providerConfig.temperature,
+                max_tokens: this.providerConfig.maxTokens,
+                messages: toOpenAIMessages(request.messages),
+                tools: toOpenAITools(request.tools),
+            }, { signal: request.signal });
+            const choice = response.choices[0];
+            const toolCalls = [];
+            if (choice?.message.tool_calls) {
+                for (const tc of choice.message.tool_calls) {
+                    if (tc.type !== "function")
+                        continue;
+                    const { server, tool } = resolveToolCallName(tc.function.name, (request.tools ?? []).map((t) => t.name));
+                    toolCalls.push({
+                        id: tc.id,
+                        server,
+                        tool,
+                        arguments: JSON.parse(tc.function.arguments),
+                    });
+                }
+            }
+            const message = {
+                id: generateId(),
+                sessionId: "",
+                role: "assistant",
+                content: choice?.message.content ?? undefined,
+                toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+                createdAt: nowIso(),
+            };
+            const sdkUsage = response.usage;
+            const STOP_REASON = {
+                stop: "stop", length: "length", tool_calls: "tool_calls",
+            };
+            const rawFinishReason = choice?.finish_reason ?? null;
+            const normalisedStopReason = STOP_REASON[rawFinishReason ?? ""] ?? "unknown";
+            return {
+                message,
+                stopReason: toolCalls.length > 0 ? "tool_calls" : "completed",
+                rawUsage: sdkUsage,
+                usage: sdkUsage ? normaliseOpenAIUsage(sdkUsage, normalisedStopReason, this.providerConfig.maxTokens) : undefined,
+            };
+        };
+        if (retryConfig) {
+            return pRetry(run, {
+                retries: retryConfig.retries,
+                minTimeout: retryConfig.minTimeout,
+                maxTimeout: retryConfig.maxTimeout,
+                factor: retryConfig.factor,
+                onFailedAttempt: error => {
+                    if (request.signal?.aborted) {
+                        throw error;
+                    }
+                },
+            });
+        }
+        return run();
+    }
+}
+//# sourceMappingURL=openai.js.map

package/src/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/openai.ts"],"names":[],"mappings":"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"}

package/src/providers/types.d.ts

@@ -0,0 +1,22 @@
+import type { Message } from '../validation/index.js';
+import type { ToolDefinition, TokenUsage } from '@adhd/agent-base-types';
+export type { ToolDefinition, TokenUsage };
+export interface ProviderChatRequest {
+    messages: Message[];
+    tools?: ToolDefinition[];
+    signal?: AbortSignal;
+    executeTool?: (server: string, tool: string, args: unknown) => Promise<{
+        result: unknown;
+        isError: boolean;
+    }>;
+}
+export interface ProviderChatResponse {
+    message: Message;
+    stopReason: 'completed' | 'tool_calls';
+    usage?: TokenUsage;
+    rawUsage?: unknown;
+}
+export interface LLMProvider {
+    chat(request: ProviderChatRequest): Promise<ProviderChatResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,KACV,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnE"}

package/src/providers/types.js

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

package/src/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/providers/types.ts"],"names":[],"mappings":""}

package/src/tools/agent-crud.d.ts

@@ -0,0 +1,29 @@
+import type { AgentCreateInput, AgentDefinition, AgentDeleteInput, AgentReadInput, AgentUpdateInput } from "../validation/index.js";
+export interface AgentStore {
+    create(input: AgentCreateInput): AgentDefinition;
+    read(name: string): AgentDefinition;
+    update(input: AgentUpdateInput): AgentDefinition;
+    delete(name: string): void;
+    list(): AgentDefinition[];
+}
+export interface SessionStoreForCrud {
+    list(filter: {
+        agentName: string;
+        status: string;
+    }): Array<{
+        id: string;
+    }>;
+    close(sessionId: string): void;
+}
+export interface AgentCrudDeps {
+    agentStore: AgentStore;
+    sessionStore: SessionStoreForCrud;
+}
+export declare function agentCreate(input: AgentCreateInput, deps: AgentCrudDeps): AgentDefinition;
+export declare function agentRead(input: AgentReadInput, deps: AgentCrudDeps): AgentDefinition;
+export declare function agentUpdate(input: AgentUpdateInput, deps: AgentCrudDeps): AgentDefinition;
+export declare function agentDelete(input: AgentDeleteInput, deps: AgentCrudDeps): {
+    success: true;
+};
+export declare function agentList(_input: unknown, deps: AgentCrudDeps): AgentDefinition[];
+//# sourceMappingURL=agent-crud.d.ts.map

package/src/tools/agent-crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-crud.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/agent-crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,UAAU;IACvB,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;IACpC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,IAAI,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,mBAAmB,CAAC;CACrC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAEzF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAErF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAEzF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAa3F;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,EAAE,CAEjF"}

package/src/tools/agent-crud.js

@@ -0,0 +1,28 @@
+export function agentCreate(input, deps) {
+    return deps.agentStore.create(input);
+}
+export function agentRead(input, deps) {
+    return deps.agentStore.read(input.name);
+}
+export function agentUpdate(input, deps) {
+    return deps.agentStore.update(input);
+}
+export function agentDelete(input, deps) {
+    if (input.force) {
+        const activeSessions = deps.sessionStore.list({ agentName: input.name, status: "active" });
+        for (const session of activeSessions) {
+            try {
+                deps.sessionStore.close(session.id);
+            }
+            catch {
+                // Already closed in a race — ignore
+            }
+        }
+    }
+    deps.agentStore.delete(input.name);
+    return { success: true };
+}
+export function agentList(_input, deps) {
+    return deps.agentStore.list();
+}
+//# sourceMappingURL=agent-crud.js.map

package/src/tools/agent-crud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-crud.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/agent-crud.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,WAAW,CAAC,KAAuB,EAAE,IAAmB;IACpE,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAqB,EAAE,IAAmB;IAChE,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB,EAAE,IAAmB;IACpE,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB,EAAE,IAAmB;IACpE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3F,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACnC,IAAI,CAAC;gBACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACL,oCAAoC;YACxC,CAAC;QACL,CAAC;IACL,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAe,EAAE,IAAmB;IAC1D,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/src/tools/session.d.ts

@@ -0,0 +1,35 @@
+import type { AgentStore } from "./agent-crud.js";
+import type { ExecutionContext } from "../validation/index.js";
+import type { EngineLogger } from "../interfaces.js";
+import type { AgentToolInput, AgentToolOutput, Session, SessionCloseInput, SessionClearInput, SessionClearOutput, SessionListInput } from "../validation/index.js";
+import type { PolicyEngine } from "../engine/policy.js";
+import type { PromptResolverDeps } from "../engine/prompt-resolver.js";
+export interface SessionStoreForTool {
+    create(input: {
+        agentName: string;
+        agentDefinition: unknown;
+        composedPromptId?: string;
+    }): {
+        id: string;
+    };
+    read(sessionId: string): {
+        status: string;
+    };
+    getAgentDefinition(sessionId: string): any;
+    getMessages(sessionId: string): unknown[];
+    list(input: SessionListInput): Session[];
+    close(sessionId: string): Session;
+    clearMessages(sessionId: string): number;
+}
+export interface SessionDeps {
+    agentStore: AgentStore;
+    sessionStore: SessionStoreForTool;
+    policy: PolicyEngine;
+    promptResolver?: PromptResolverDeps;
+    logger?: EngineLogger;
+}
+export declare function agentTool(input: AgentToolInput, deps: SessionDeps, executionContext?: ExecutionContext): Promise<AgentToolOutput>;
+export declare function sessionList(input: SessionListInput, deps: SessionDeps): Session[];
+export declare function sessionClose(input: SessionCloseInput, deps: SessionDeps): Session;
+export declare function sessionClear(input: SessionClearInput, deps: SessionDeps): SessionClearOutput;
+//# sourceMappingURL=session.d.ts.map

package/src/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EACR,cAAc,EACd,eAAe,EACf,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5C,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IAC3C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,EAAE,CAAC;IACzC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,wBAAsB,SAAS,CAC3B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,WAAW,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,GACpC,OAAO,CAAC,eAAe,CAAC,CAoD1B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE,CAEjF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAEjF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,GAAG,kBAAkB,CAG5F"}

package/src/tools/session.js

@@ -0,0 +1,52 @@
+import { resolveComposedPrompt } from "../engine/prompt-resolver.js";
+export async function agentTool(input, deps, executionContext) {
+    const agentDefinition = deps.agentStore.read(input.name);
+    if (executionContext) {
+        deps.policy.check({
+            executionContext,
+            targetTool: "agent-mcp__agent",
+            targetAgentName: input.name,
+        });
+        const log = deps.logger;
+        if (log) {
+            log.info({
+                taskId: executionContext.taskId,
+                targetAgent: input.name,
+                newDepth: executionContext.recursionDepth + 1,
+            }, "AGENT_DELEGATION");
+        }
+    }
+    let resolvedSystemPrompt;
+    let composedPromptId;
+    if (deps.promptResolver) {
+        const resolved = resolveComposedPrompt({
+            agentSlug: input.name,
+            platform: agentDefinition.provider.type,
+            context: {},
+        }, deps.promptResolver);
+        if (resolved !== null) {
+            resolvedSystemPrompt = resolved.content;
+            composedPromptId = resolved.id;
+        }
+    }
+    const snapshotDefinition = resolvedSystemPrompt !== undefined
+        ? { ...agentDefinition, systemPrompt: resolvedSystemPrompt }
+        : agentDefinition;
+    const session = deps.sessionStore.create({
+        agentName: input.name,
+        agentDefinition: snapshotDefinition,
+        composedPromptId,
+    });
+    return { session_id: session.id };
+}
+export function sessionList(input, deps) {
+    return deps.sessionStore.list(input);
+}
+export function sessionClose(input, deps) {
+    return deps.sessionStore.close(input.session_id);
+}
+export function sessionClear(input, deps) {
+    const cleared = deps.sessionStore.clearMessages(input.session_id);
+    return { session_id: input.session_id, cleared };
+}
+//# sourceMappingURL=session.js.map

package/src/tools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/session.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAqBrE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,KAAqB,EACrB,IAAiB,EACjB,gBAAmC;IAEnC,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,gBAAgB,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACd,gBAAgB;YAChB,UAAU,EAAE,kBAAkB;YAC9B,eAAe,EAAE,KAAK,CAAC,IAAI;SAC9B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACxB,IAAI,GAAG,EAAE,CAAC;YACN,GAAG,CAAC,IAAI,CACJ;gBACI,MAAM,EAAE,gBAAgB,CAAC,MAAM;gBAC/B,WAAW,EAAE,KAAK,CAAC,IAAI;gBACvB,QAAQ,EAAE,gBAAgB,CAAC,cAAc,GAAG,CAAC;aAChD,EACD,kBAAkB,CACrB,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,oBAAwC,CAAC;IAC7C,IAAI,gBAAoC,CAAC;IAEzC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,qBAAqB,CAClC;YACI,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,IAAI;YACvC,OAAO,EAAE,EAAE;SACd,EACD,IAAI,CAAC,cAAc,CACtB,CAAC;QACF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,oBAAoB,GAAG,QAAQ,CAAC,OAAO,CAAC;YACxC,gBAAgB,GAAG,QAAQ,CAAC,EAAE,CAAC;QACnC,CAAC;IACL,CAAC;IAED,MAAM,kBAAkB,GAAG,oBAAoB,KAAK,SAAS;QACzD,CAAC,CAAC,EAAE,GAAG,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE;QAC5D,CAAC,CAAC,eAAe,CAAC;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QACrC,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,eAAe,EAAE,kBAAkB;QACnC,gBAAgB;KACnB,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB,EAAE,IAAiB;IAClE,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAwB,EAAE,IAAiB;IACpE,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAwB,EAAE,IAAiB;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/src/tools/task.d.ts

@@ -0,0 +1,94 @@
+import type { EngineConfig, EngineLogger } from '../interfaces.js';
+import type { BackgroundQueue } from '../engine/queue.js';
+import type { DagEngine } from '../engine/dag-engine.js';
+import type { Orchestrator } from '../engine/orchestrator.js';
+import type { PolicyEngine } from '../engine/policy.js';
+import type { InProcessToolDescriptor, InProcessToolHandler } from '../clients/in-process.js';
+import type { AgentStore } from './agent-crud.js';
+import type { SessionStoreForTool } from './session.js';
+import type { ExecutionContext, ResultInput, Task, TaskCancelInput, TaskListInput, TaskToolInput, TaskToolOutput, TaskUsageReport } from '../validation/index.js';
+import type { IHookRegistry } from '@adhd/agent-base-types';
+import { type Database } from './usage.js';
+export interface TaskStore {
+    create(input: {
+        id?: string;
+        sessionId: string | null;
+        prompt: string;
+        parentTaskId?: string;
+        recursionDepth?: number;
+        dependsOn?: string[];
+        onUpstreamFailure?: "fail" | "skip";
+        isEphemeral?: boolean;
+    }): {
+        id: string;
+        status: string;
+        result?: string;
+        error?: string;
+    };
+    read(taskId: string): {
+        id: string;
+        status: string;
+        result?: string;
+        error?: string;
+        sessionId?: string | null;
+        isEphemeral?: boolean;
+        prompt: string;
+        recursionDepth: number;
+        inputs?: Record<string, string> | null;
+    };
+    updateStatus(taskId: string, status: string, fields?: Record<string, unknown>): void;
+    list(filter: TaskListInput): Task[];
+    cancel(taskId: string): void;
+    registerCancellation(taskId: string, controller: AbortController): void;
+    unregisterCancellation(taskId: string): void;
+    appendEvent(evt: {
+        taskId: string;
+        type: string;
+        payload?: unknown;
+    }): void;
+}
+export interface TaskDeps {
+    agentStore: AgentStore;
+    sessionStore: SessionStoreForTool;
+    taskStore: TaskStore;
+    orchestrator: Orchestrator;
+    queue: BackgroundQueue;
+    policy: PolicyEngine;
+    hooks: IHookRegistry;
+    selfUrl: string | undefined;
+    inProcessDescriptors: InProcessToolDescriptor[];
+    inProcessHandler: InProcessToolHandler;
+    db: Database;
+    dagEngine: DagEngine;
+    config: EngineConfig;
+    logger: EngineLogger;
+    emitTaskEvent?: (event: {
+        type: string;
+        taskId: string;
+        status?: string;
+        result?: string | null;
+        error?: string | null;
+        toolName?: string;
+        toolCallId?: string;
+        input?: unknown;
+        content?: unknown;
+    }) => void;
+}
+export declare function taskTool(input: TaskToolInput, deps: TaskDeps, callerContext?: ExecutionContext): Promise<TaskToolOutput>;
+export declare function enqueueExistingTask(taskId: string, deps: TaskDeps): Promise<void>;
+export declare function taskList(input: TaskListInput, deps: Pick<TaskDeps, 'taskStore'>): Task[];
+export declare function taskCancel(input: TaskCancelInput, deps: Pick<TaskDeps, 'taskStore'>): {
+    success: true;
+};
+export declare function taskResume(input: {
+    taskId: string;
+    resumeToken: string;
+    userInput: string;
+}, deps: Pick<TaskDeps, 'taskStore'>): Promise<{
+    success: true;
+    taskId: string;
+}>;
+export declare function resultTool(input: ResultInput, deps: Pick<TaskDeps, 'taskStore' | 'db'>): Task & {
+    usage?: TaskUsageReport;
+};
+//# sourceMappingURL=task.d.ts.map

package/src/tools/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/task.ts"],"names":[],"mappings":"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"}