@adhd/agent-engine-orchestrator 2.1.0

package/src/clients/tool-naming.js

@@ -0,0 +1,26 @@
+export const TOOL_NAME_SEPARATOR = "__";
+export function normalizeToolName(name) {
+    return name.replace(/[^A-Za-z0-9_]/g, "_");
+}
+function splitToolName(name) {
+    const i = name.indexOf(TOOL_NAME_SEPARATOR);
+    return i === -1
+        ? { server: name, tool: name }
+        : { server: name.slice(0, i), tool: name.slice(i + TOOL_NAME_SEPARATOR.length) };
+}
+export function resolveToolCallName(rawName, advertised = []) {
+    if (rawName.includes(TOOL_NAME_SEPARATOR))
+        return splitToolName(rawName);
+    const norm = normalizeToolName(rawName);
+    const candidates = Array.from(new Set(advertised)).filter((a) => {
+        const { tool } = splitToolName(a);
+        return tool === rawName || normalizeToolName(tool) === norm;
+    });
+    if (candidates.length === 1)
+        return splitToolName(candidates[0]);
+    if (candidates.length > 1) {
+        throw new Error(`Ambiguous tool name '${rawName}': multiple servers expose it — qualify with a server prefix, one of: ${candidates.join(", ")}`);
+    }
+    return splitToolName(rawName);
+}
+//# sourceMappingURL=tool-naming.js.map

package/src/clients/tool-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-naming.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/clients/tool-naming.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAOD,SAAS,aAAa,CAAC,IAAY;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,CAAC;QACX,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAC9B,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,aAAgC,EAAE;IACnF,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAEzE,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,KAAK,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACX,wBAAwB,OAAO,yEAAyE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClI,CAAC;IACN,CAAC;IACD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/src/clients/types.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "../providers/types.js";
+export interface IMcpClient {
+    listTools(): Promise<ToolDefinition[]>;
+    callTool(toolName: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/clients/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,UAAU;IACvB,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/src/clients/types.js

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

package/src/clients/types.js.map

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

package/src/engine/context-window.d.ts

@@ -0,0 +1,74 @@
+import type { Message } from '../validation/index.js';
+/**
+ * Context-window management for the tool-calling loop.
+ *
+ * Chat APIs are stateless: the whole history is re-sent every call, and providers make
+ * that affordable with PREFIX caching (an unchanged leading prefix bills at a ~50x
+ * discount). The old enforcement — drop the oldest message every call — mutated that
+ * prefix and forced the entire context to be re-billed at full price on every trim
+ * (BUG-ORCH-008), which on one measured run was ~70% of total spend.
+ *
+ * The cache-preserving strategy here (mirroring Anthropic's server-side compaction and
+ * OpenAI Realtime's retention_ratio) is:
+ *   1. keep tool defs + system prompt as a permanently stable head,
+ *   2. let history grow append-only (so the prefix is stable and caches between calls),
+ *   3. only when the REAL context (provider-reported prompt_tokens) approaches the model's
+ *      TRUE window, compact a large contiguous middle chunk into one summary message —
+ *      ONCE, rarely, not a little every turn.
+ */
+/** Fraction of the true context window at which we compact. */
+export declare const DEFAULT_COMPACTION_TRIGGER_FRACTION = 0.75;
+/** Resolve a model's true input context window (tokens). */
+export declare function contextWindowFor(model: string | undefined): number;
+/**
+ * Estimate a message's cost at ~4 chars/token, over its full serialized wire form —
+ * content + toolCalls arguments + toolResults payload. Counting only `content` scores
+ * every tool result as zero, which is the payload that actually blows up context.
+ */
+export declare function estimateMessageTokens(message: Message): number;
+/**
+ * Group messages into atomic units that must be kept or dropped together.
+ *
+ * An `assistant` message bearing `toolCalls` and the `tool` messages answering it form
+ * one indivisible unit: the wire format requires every `tool` message to be preceded by
+ * the `assistant` message carrying the matching `tool_calls`, so splitting the pair
+ * produces a provider 400 (BUG-ORCH-003).
+ */
+export declare function groupIntoAtomicUnits(messages: Message[]): Message[][];
+export interface CompactionDecision {
+    /** Should we compact before the next model call? */
+    shouldCompact: boolean;
+    /** The window used for the decision (tokens). */
+    window: number;
+    /** The trigger threshold (tokens). */
+    threshold: number;
+}
+/**
+ * Decide whether to compact, driven by the PROVIDER-REPORTED context size — the exact,
+ * free ground truth in every response's `prompt_tokens` — rather than the local estimator
+ * (which historically undercounted by ignoring the tools array; BUG-ORCH-006).
+ *
+ * `reportedContextTokens` is the last call's true input size, or undefined before the
+ * first call (in which case we fall back to a local estimate of the pending messages).
+ */
+export declare function decideCompaction(reportedContextTokens: number | undefined, pendingMessages: Message[], model: string | undefined, triggerFraction?: number): CompactionDecision;
+export interface CompactMessagesOptions {
+    /** Atomic units to keep verbatim at the tail (most recent turns). Default 4. */
+    keepRecentUnits?: number;
+    /** Don't compact if fewer than this many middle units would be folded. Default 2. */
+    minUnitsToCompact?: number;
+}
+/**
+ * Summarise a contiguous middle chunk of history into ONE synthetic message, preserving
+ * the stable system-prompt head and the most-recent turns verbatim.
+ *
+ * `summarise` is injected so this is unit-testable without a live model, and so the
+ * orchestrator can route the summary call through the same provider. If it throws, we
+ * return the messages UNCHANGED (compaction is best-effort — a failed summary must never
+ * drop history or crash the task; the provider's own context error is the backstop).
+ *
+ * Cache note: compaction changes the prefix from the summary point onward, so it MUST be
+ * rare. Between compactions the head stays byte-identical and the cache survives.
+ */
+export declare function compactMessages(messages: Message[], summarise: (toSummarise: Message[]) => Promise<string>, opts?: CompactMessagesOptions): Promise<Message[]>;
+//# sourceMappingURL=context-window.d.ts.map

package/src/engine/context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/engine/context-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAItD;;;;;;;;;;;;;;;;GAgBG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAwBxD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWlE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAS9D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAiBrE;AAED,MAAM,WAAW,kBAAkB;IAC/B,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC5B,qBAAqB,EAAE,MAAM,GAAG,SAAS,EACzC,eAAe,EAAE,OAAO,EAAE,EAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,eAAe,GAAE,MAA4C,GAC9D,kBAAkB,CAOpB;AAED,MAAM,WAAW,sBAAsB;IACnC,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,EACtD,IAAI,GAAE,sBAA2B,GAClC,OAAO,CAAC,OAAO,EAAE,CAAC,CAqCpB"}

package/src/engine/context-window.js

@@ -0,0 +1,156 @@
+import { generateId } from '../utils/ids.js';
+import { nowIso } from '../utils/timestamps.js';
+/**
+ * Context-window management for the tool-calling loop.
+ *
+ * Chat APIs are stateless: the whole history is re-sent every call, and providers make
+ * that affordable with PREFIX caching (an unchanged leading prefix bills at a ~50x
+ * discount). The old enforcement — drop the oldest message every call — mutated that
+ * prefix and forced the entire context to be re-billed at full price on every trim
+ * (BUG-ORCH-008), which on one measured run was ~70% of total spend.
+ *
+ * The cache-preserving strategy here (mirroring Anthropic's server-side compaction and
+ * OpenAI Realtime's retention_ratio) is:
+ *   1. keep tool defs + system prompt as a permanently stable head,
+ *   2. let history grow append-only (so the prefix is stable and caches between calls),
+ *   3. only when the REAL context (provider-reported prompt_tokens) approaches the model's
+ *      TRUE window, compact a large contiguous middle chunk into one summary message —
+ *      ONCE, rarely, not a little every turn.
+ */
+/** Fraction of the true context window at which we compact. */
+export const DEFAULT_COMPACTION_TRIGGER_FRACTION = 0.75;
+/**
+ * True input context window (tokens) per model family. Used to decide WHEN to compact.
+ * Deliberately conservative — an unknown model falls back to a safe small window rather
+ * than never compacting. Longest-prefix match wins.
+ */
+const CONTEXT_WINDOWS = [
+    ['deepseek-v4', 1_000_000],
+    ['deepseek', 128_000],
+    ['claude-opus-4', 200_000],
+    ['claude-sonnet-4', 200_000],
+    ['claude-haiku-4', 200_000],
+    ['claude-fable', 200_000],
+    ['claude-3', 200_000],
+    ['gpt-4o', 128_000],
+    ['gpt-4.1', 1_000_000],
+    ['gpt-5', 400_000],
+    ['o1', 200_000],
+    ['o3', 200_000],
+];
+const FALLBACK_CONTEXT_WINDOW = 128_000;
+/** Resolve a model's true input context window (tokens). */
+export function contextWindowFor(model) {
+    if (!model)
+        return FALLBACK_CONTEXT_WINDOW;
+    let best;
+    let bestLen = -1;
+    for (const [prefix, window] of CONTEXT_WINDOWS) {
+        if (model.startsWith(prefix) && prefix.length > bestLen) {
+            best = window;
+            bestLen = prefix.length;
+        }
+    }
+    return best ?? FALLBACK_CONTEXT_WINDOW;
+}
+/**
+ * Estimate a message's cost at ~4 chars/token, over its full serialized wire form —
+ * content + toolCalls arguments + toolResults payload. Counting only `content` scores
+ * every tool result as zero, which is the payload that actually blows up context.
+ */
+export function estimateMessageTokens(message) {
+    let chars = message.content?.length ?? 0;
+    for (const toolCall of message.toolCalls ?? []) {
+        chars += JSON.stringify(toolCall.arguments ?? {}).length;
+    }
+    for (const toolResult of message.toolResults ?? []) {
+        chars += JSON.stringify(toolResult.result ?? null).length;
+    }
+    return chars / 4;
+}
+/**
+ * Group messages into atomic units that must be kept or dropped together.
+ *
+ * An `assistant` message bearing `toolCalls` and the `tool` messages answering it form
+ * one indivisible unit: the wire format requires every `tool` message to be preceded by
+ * the `assistant` message carrying the matching `tool_calls`, so splitting the pair
+ * produces a provider 400 (BUG-ORCH-003).
+ */
+export function groupIntoAtomicUnits(messages) {
+    const units = [];
+    for (const message of messages) {
+        const current = units[units.length - 1];
+        const isToolReplyToOpenUnit = message.role === 'tool' &&
+            current !== undefined &&
+            current[0].role === 'assistant' &&
+            (current[0].toolCalls?.length ?? 0) > 0;
+        if (isToolReplyToOpenUnit) {
+            current.push(message);
+        }
+        else {
+            units.push([message]);
+        }
+    }
+    return units;
+}
+/**
+ * Decide whether to compact, driven by the PROVIDER-REPORTED context size — the exact,
+ * free ground truth in every response's `prompt_tokens` — rather than the local estimator
+ * (which historically undercounted by ignoring the tools array; BUG-ORCH-006).
+ *
+ * `reportedContextTokens` is the last call's true input size, or undefined before the
+ * first call (in which case we fall back to a local estimate of the pending messages).
+ */
+export function decideCompaction(reportedContextTokens, pendingMessages, model, triggerFraction = DEFAULT_COMPACTION_TRIGGER_FRACTION) {
+    const window = contextWindowFor(model);
+    const threshold = Math.floor(window * triggerFraction);
+    const realContext = reportedContextTokens ??
+        Math.ceil(pendingMessages.reduce((n, m) => n + estimateMessageTokens(m), 0));
+    return { shouldCompact: realContext > threshold, window, threshold };
+}
+/**
+ * Summarise a contiguous middle chunk of history into ONE synthetic message, preserving
+ * the stable system-prompt head and the most-recent turns verbatim.
+ *
+ * `summarise` is injected so this is unit-testable without a live model, and so the
+ * orchestrator can route the summary call through the same provider. If it throws, we
+ * return the messages UNCHANGED (compaction is best-effort — a failed summary must never
+ * drop history or crash the task; the provider's own context error is the backstop).
+ *
+ * Cache note: compaction changes the prefix from the summary point onward, so it MUST be
+ * rare. Between compactions the head stays byte-identical and the cache survives.
+ */
+export async function compactMessages(messages, summarise, opts = {}) {
+    const keepRecentUnits = opts.keepRecentUnits ?? 4;
+    const minUnitsToCompact = opts.minUnitsToCompact ?? 2;
+    // Preserve all leading system messages as the stable head.
+    let headEnd = 0;
+    while (headEnd < messages.length && messages[headEnd].role === 'system')
+        headEnd++;
+    const head = messages.slice(0, headEnd);
+    const units = groupIntoAtomicUnits(messages.slice(headEnd));
+    const middleCount = units.length - keepRecentUnits;
+    if (middleCount < minUnitsToCompact) {
+        // Not enough to fold — leave history untouched.
+        return messages;
+    }
+    const middle = units.slice(0, middleCount).flat();
+    const tail = units.slice(middleCount).flat();
+    let summaryText;
+    try {
+        summaryText = await summarise(middle);
+    }
+    catch {
+        return messages; // best-effort: never lose history on a failed summary
+    }
+    const summaryMessage = {
+        id: generateId(),
+        sessionId: messages[0]?.sessionId ?? '',
+        role: 'user',
+        content: `[Earlier conversation compacted to fit the context window. ` +
+            `Summary of ${middle.length} prior message(s):]\n\n${summaryText}`,
+        createdAt: nowIso(),
+    };
+    return [...head, summaryMessage, ...tail];
+}
+//# sourceMappingURL=context-window.js.map

package/src/engine/context-window.js.map

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

package/src/engine/dag-engine.d.ts

@@ -0,0 +1,69 @@
+import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+import type { EngineLogger } from "../interfaces.js";
+export interface DagTaskStore {
+    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;
+        dependsOn?: string[] | null;
+        inputs?: Record<string, string> | null;
+        onUpstreamFailure?: string | null;
+    };
+    read(taskId: string): {
+        id: string;
+        status: string;
+        result?: string;
+        error?: string;
+        dependsOn?: string[] | null;
+        inputs?: Record<string, string> | null;
+        onUpstreamFailure?: string | null;
+        sessionId?: string | null;
+        isEphemeral?: boolean;
+        prompt: string;
+        recursionDepth: number;
+    };
+    updateStatus(taskId: string, status: string, fields?: Record<string, unknown>): void;
+    list(filter?: Record<string, unknown>): Array<{
+        id: string;
+        status: string;
+        result?: string;
+        error?: string;
+        dependsOn?: string[] | null;
+        inputs?: Record<string, string> | null;
+        onUpstreamFailure?: string | null;
+    }>;
+    registerCancellation(taskId: string, controller: AbortController): void;
+    unregisterCancellation(taskId: string): void;
+    cancel(taskId: string): void;
+    appendEvent(evt: {
+        taskId: string;
+        type: string;
+        payload?: unknown;
+    }): void;
+}
+export interface DagQueue {
+    enqueue(taskId: string, fn: () => Promise<void>): void;
+    pending: number;
+    size: number;
+}
+export declare class DagEngine {
+    private readonly db;
+    private readonly queue;
+    private readonly taskStore;
+    private readonly dispatchFn;
+    private readonly logger;
+    constructor(db: BetterSQLite3Database<Record<string, never>>, queue: DagQueue, taskStore: DagTaskStore, dispatchFn: (taskId: string) => Promise<void>, logger?: EngineLogger);
+    validateNoCycle(newTaskId: string, dependsOn: string[]): void;
+    dispatchReady(completedTaskId: string): Promise<void>;
+}
+//# sourceMappingURL=dag-engine.d.ts.map

package/src/engine/dag-engine.d.ts.map

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

package/src/engine/dag-engine.js

@@ -0,0 +1,103 @@
+import { and, eq, inArray } from "drizzle-orm";
+import { tasksTable } from "@adhd/agent-store-runtime";
+import { ToolError } from "../validation/errors.js";
+import { nowIso } from "../utils/timestamps.js";
+export class DagEngine {
+    db;
+    queue;
+    taskStore;
+    dispatchFn;
+    logger;
+    constructor(db, queue, taskStore, dispatchFn, logger) {
+        this.db = db;
+        this.queue = queue;
+        this.taskStore = taskStore;
+        this.dispatchFn = dispatchFn;
+        this.logger = logger ?? { info: () => { }, warn: () => { }, error: () => { }, debug: () => { } };
+    }
+    validateNoCycle(newTaskId, dependsOn) {
+        const visited = new Set();
+        const queue = [...dependsOn];
+        while (queue.length > 0) {
+            const id = queue.shift();
+            if (!id)
+                throw new Error('Empty queue in validateNoCycle');
+            if (id === newTaskId) {
+                throw new ToolError("VALIDATION_ERROR", `Dependency cycle detected: task ${newTaskId} would depend on itself via its dependency chain`);
+            }
+            if (!visited.has(id)) {
+                visited.add(id);
+                const row = this.db
+                    .select({ dependsOn: tasksTable.depends_on })
+                    .from(tasksTable)
+                    .where(eq(tasksTable.id, id))
+                    .get();
+                const upstreamDeps = row?.dependsOn
+                    ? JSON.parse(row.dependsOn)
+                    : [];
+                queue.push(...upstreamDeps);
+            }
+        }
+    }
+    async dispatchReady(completedTaskId) {
+        const waitingTasks = this.db
+            .select()
+            .from(tasksTable)
+            .where(eq(tasksTable.status, "waiting"))
+            .all();
+        for (const task of waitingTasks) {
+            const deps = task.depends_on
+                ? JSON.parse(task.depends_on)
+                : [];
+            if (!deps.includes(completedTaskId))
+                continue;
+            if (deps.length === 0)
+                continue;
+            const depRows = this.db
+                .select({
+                id: tasksTable.id,
+                status: tasksTable.status,
+                result: tasksTable.result,
+            })
+                .from(tasksTable)
+                .where(inArray(tasksTable.id, deps))
+                .all();
+            const terminalStatuses = new Set(["completed", "failed", "cancelled"]);
+            const allTerminal = depRows.every(r => terminalStatuses.has(r.status));
+            if (!allTerminal)
+                continue;
+            const policy = (task.on_upstream_failure ?? "fail");
+            const failedDep = depRows.find(r => r.status === "failed" || r.status === "cancelled");
+            if (failedDep && policy === "fail") {
+                this.logger.info({ taskId: task.id, failedDepId: failedDep.id, status: failedDep.status }, "Propagating upstream failure to waiting task");
+                this.taskStore.updateStatus(task.id, "failed", {
+                    error: `Upstream task ${failedDep.id} ${failedDep.status}`,
+                });
+                await this.dispatchReady(task.id);
+                continue;
+            }
+            const inputs = {};
+            for (const dep of depRows) {
+                if (dep.status === "completed" && dep.result != null) {
+                    inputs[dep.id] = dep.result;
+                }
+            }
+            const updated = this.db
+                .update(tasksTable)
+                .set({
+                status: "pending",
+                inputs: JSON.stringify(inputs),
+                updatedAt: nowIso(),
+            })
+                .where(and(eq(tasksTable.id, task.id), eq(tasksTable.status, "waiting")))
+                .run();
+            if (updated.changes === 0) {
+                this.logger.debug({ taskId: task.id }, "DagEngine: lost optimistic lock, skipping enqueue");
+                continue;
+            }
+            this.logger.info({ taskId: task.id, deps, inputs: Object.keys(inputs) }, "DagEngine: dispatching ready task");
+            await this.dispatchFn(task.id);
+        }
+    }
+}
+//# sourceMappingURL=dag-engine.js.map

package/src/engine/dag-engine.js.map

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

package/src/engine/hooks.d.ts

@@ -0,0 +1,10 @@
+import type { HookEvent, HookEventMap, HookHandler, IHookRegistry, EnforcementEvent, EnforcementHandler } from '@adhd/agent-base-types';
+export declare class HookRegistry implements IHookRegistry {
+    private readonly handlers;
+    private readonly enforcementHandlers;
+    register<E extends HookEvent>(event: E, handler: HookHandler<E>): void;
+    emit<E extends HookEvent>(event: E, payload: HookEventMap[E]): Promise<void>;
+    registerEnforcement<E extends EnforcementEvent>(event: E, handler: EnforcementHandler<E>): void;
+    enforce<E extends EnforcementEvent>(event: E, payload: HookEventMap[E]): Promise<void>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/src/engine/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/engine/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;IAC3E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGhC;IAEJ,QAAQ,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAMhE,IAAI,CAAC,CAAC,SAAS,SAAS,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,IAAI,CAAC;IAehB,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,EAC5C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,IAAI;IAMD,OAAO,CAAC,CAAC,SAAS,gBAAgB,EACtC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,IAAI,CAAC;CAOjB"}

package/src/engine/hooks.js

@@ -0,0 +1,39 @@
+export class HookRegistry {
+    handlers = new Map();
+    enforcementHandlers = new Map();
+    register(event, handler) {
+        const list = this.handlers.get(event) ?? [];
+        list.push(handler);
+        this.handlers.set(event, list);
+    }
+    async emit(event, payload) {
+        const list = this.handlers.get(event);
+        if (!list?.length)
+            return;
+        for (const handler of list) {
+            try {
+                await handler(payload);
+            }
+            catch (err) {
+                console.warn('[HookRegistry] hook handler error (swallowed)', {
+                    event,
+                    err,
+                });
+            }
+        }
+    }
+    registerEnforcement(event, handler) {
+        const list = this.enforcementHandlers.get(event) ?? [];
+        list.push(handler);
+        this.enforcementHandlers.set(event, list);
+    }
+    async enforce(event, payload) {
+        const list = this.enforcementHandlers.get(event);
+        if (!list?.length)
+            return;
+        for (const handler of list) {
+            await handler(payload);
+        }
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/src/engine/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/engine/hooks.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,YAAY;IACN,QAAQ,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC1D,mBAAmB,GAAG,IAAI,GAAG,EAG3C,CAAC;IAEJ,QAAQ,CAAsB,KAAQ,EAAE,OAAuB;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAiC,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,KAAQ,EACR,OAAwB;QAExB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAO,OAA0B,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE;oBAC5D,KAAK;oBACL,GAAG;iBACJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,mBAAmB,CACjB,KAAQ,EACR,OAA8B;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,OAA+C,CAAC,CAAC;QAC3D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAQ,EACR,OAAwB;QAExB,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAO,OAAiC,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF"}

package/src/engine/orchestrator.d.ts

@@ -0,0 +1,59 @@
+import type { LLMProvider } from '../providers/types.js';
+import type { ExecutionContext, Message } from '../validation/index.js';
+import type { IHookRegistry } from '@adhd/agent-base-types';
+import type { EngineConfig, EngineLogger } from '../interfaces.js';
+import type { McpClientRegistry } from '../clients/registry.js';
+import type { PolicyEngine } from './policy.js';
+/** TaskStore-like interface for orchestrator consumption */
+export interface OrchestratorTaskStore {
+    updateStatus(taskId: string, status: string, fields?: Record<string, unknown>): void;
+    appendEvent(evt: {
+        taskId: string;
+        type: string;
+        payload?: unknown;
+    }): void;
+    unregisterCancellation(taskId: string): void;
+}
+/** SessionStore-like interface for orchestrator consumption */
+export interface OrchestratorSessionStore {
+    appendMessage(sessionId: string, message: Message): Promise<void>;
+    close(sessionId: string): void;
+}
+export declare function resolveHitl(taskId: string, userInput: string): boolean;
+export interface OrchestratorRunInput {
+    executionContext: ExecutionContext;
+    messages: Message[];
+    registry: McpClientRegistry;
+    provider: LLMProvider;
+    policy: PolicyEngine;
+    taskStore: OrchestratorTaskStore;
+    sessionStore: OrchestratorSessionStore;
+    signal: AbortSignal;
+    taskId: string;
+    hooks?: IHookRegistry;
+    isEphemeral?: boolean;
+    /** Injected emitTaskEvent callback (replaces streaming/event-bus import). */
+    emitTaskEvent?: (event: {
+        type: string;
+        taskId: string;
+        status?: string;
+        result?: string | null;
+        error?: string | null;
+        toolName?: string;
+        toolCallId?: string;
+        input?: unknown;
+        content?: unknown;
+    }) => void;
+    /** Injected logger (replaces logger.js import). */
+    logger?: EngineLogger;
+    /** Injected config (replaces config.js import). */
+    config?: EngineConfig;
+}
+export interface OrchestratorRunResult {
+    result: string;
+}
+export declare class Orchestrator {
+    run(input: OrchestratorRunInput): Promise<OrchestratorRunResult>;
+}
+export declare function windowMessages(messages: Message[], limit: number): Message[];
+//# sourceMappingURL=orchestrator.d.ts.map

package/src/engine/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/engine/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EAId,MAAM,wBAAwB,CAAC;AAIhC,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmChD,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IAClC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrF,WAAW,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACrC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAID,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,qBAAqB,CAAC;IACjC,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9M,mDAAmD;IACnD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAkBD,qBAAa,YAAY;IACjB,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA0vBvE;AAyBD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAkB5E"}