@adhd/agent-engine-orchestrator 2.1.0

package/src/tools/task.js

@@ -0,0 +1,336 @@
+import { resolveHitl } from '../engine/orchestrator.js';
+import { createProvider } from '../providers/factory.js';
+import { McpClientRegistry } from '../clients/registry.js';
+import { ToolError } from '../validation/errors.js';
+import { generateId } from '../utils/ids.js';
+import { nowIso } from '../utils/timestamps.js';
+import { buildTaskUsageReport } from './usage.js';
+async function runEphemeralTask(input, deps, callerContext) {
+    const agentDefinition = deps.agentStore.read(input.agent_name);
+    const taskId = generateId();
+    const ephemeralSessionId = generateId();
+    const rootTaskId = callerContext
+        ? callerContext.rootTaskId ?? callerContext.taskId
+        : undefined;
+    deps.taskStore.create({
+        id: taskId,
+        sessionId: null,
+        isEphemeral: true,
+        prompt: input.prompt,
+        parentTaskId: callerContext?.taskId,
+        recursionDepth: (callerContext?.recursionDepth ?? -1) + 1,
+    });
+    const executionContext = {
+        taskId,
+        sessionId: ephemeralSessionId,
+        agentName: agentDefinition.name,
+        agentDefinition,
+        callingAgentName: callerContext?.agentName,
+        parentTaskId: callerContext?.taskId,
+        rootTaskId: rootTaskId ?? undefined,
+        recursionDepth: (callerContext?.recursionDepth ?? -1) + 1,
+        toolCallCount: 0,
+    };
+    const provider = createProvider(agentDefinition.provider, agentDefinition.mcpServers, deps.config, deps.logger);
+    const userMessage = {
+        id: generateId(),
+        sessionId: ephemeralSessionId,
+        role: 'user',
+        content: input.prompt,
+        createdAt: nowIso(),
+    };
+    const messages = agentDefinition.systemPrompt
+        ? [
+            {
+                id: generateId(),
+                sessionId: ephemeralSessionId,
+                role: 'system',
+                content: agentDefinition.systemPrompt,
+                createdAt: nowIso(),
+            },
+            userMessage,
+        ]
+        : [userMessage];
+    const noopSessionStore = {
+        appendMessage: async () => { },
+        close: () => { },
+    };
+    const registry = new McpClientRegistry(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agentDefinition.mcpServers, deps.selfUrl, deps.inProcessDescriptors, deps.inProcessHandler, executionContext);
+    const controller = new AbortController();
+    deps.taskStore.registerCancellation(taskId, controller);
+    try {
+        await deps.orchestrator.run({
+            executionContext,
+            messages,
+            registry,
+            provider,
+            policy: deps.policy,
+            taskStore: deps.taskStore,
+            sessionStore: noopSessionStore,
+            signal: controller.signal,
+            taskId,
+            hooks: deps.hooks,
+            isEphemeral: true,
+            emitTaskEvent: deps.emitTaskEvent,
+            logger: deps.logger,
+            config: deps.config,
+        });
+    }
+    catch {
+        // Orchestrator already updated status via deps.taskStore
+    }
+    finally {
+        deps.taskStore.unregisterCancellation(taskId);
+    }
+    const finalTask = deps.taskStore.read(taskId);
+    const usage = buildTaskUsageReport(deps.db, taskId);
+    return {
+        task_id: taskId,
+        status: finalTask.status,
+        result: finalTask.result,
+        usage,
+    };
+}
+export async function taskTool(input, deps, callerContext) {
+    if ('agent_name' in input) {
+        return runEphemeralTask(input, deps, callerContext);
+    }
+    const session = deps.sessionStore.read(input.session_id);
+    if (session.status !== 'active') {
+        throw new ToolError('SESSION_CLOSED', `Session '${input.session_id}' is closed`);
+    }
+    const agentDefinition = deps.sessionStore.getAgentDefinition(input.session_id);
+    const dependsOn = input.depends_on ?? [];
+    const onUpstreamFailure = input
+        .on_upstream_failure;
+    const newTaskId = generateId();
+    if (dependsOn.length > 0) {
+        deps.dagEngine.validateNoCycle(newTaskId, dependsOn);
+    }
+    const task = deps.taskStore.create({
+        id: newTaskId,
+        sessionId: input.session_id,
+        prompt: input.prompt,
+        parentTaskId: callerContext?.taskId,
+        recursionDepth: (callerContext?.recursionDepth ?? -1) + 1,
+        dependsOn: dependsOn.length > 0 ? dependsOn : undefined,
+        onUpstreamFailure,
+    });
+    const rootTaskId = callerContext
+        ? callerContext.rootTaskId ?? callerContext.taskId
+        : undefined;
+    const executionContext = {
+        taskId: task.id,
+        sessionId: input.session_id,
+        agentName: agentDefinition.name,
+        agentDefinition,
+        callingAgentName: callerContext?.agentName,
+        parentTaskId: callerContext?.taskId,
+        rootTaskId: rootTaskId ?? undefined,
+        recursionDepth: (callerContext?.recursionDepth ?? -1) + 1,
+        toolCallCount: 0,
+    };
+    const controller = new AbortController();
+    deps.taskStore.registerCancellation(task.id, controller);
+    const provider = createProvider(agentDefinition.provider, agentDefinition.mcpServers, deps.config, deps.logger);
+    const existingMessages = deps.sessionStore.getMessages(input.session_id);
+    const userMessage = {
+        id: generateId(),
+        sessionId: input.session_id,
+        role: 'user',
+        content: input.prompt,
+        createdAt: nowIso(),
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    await deps.sessionStore.appendMessage(input.session_id, userMessage);
+    const messages = [...existingMessages, userMessage];
+    const allMessages = agentDefinition.systemPrompt
+        ? [
+            {
+                id: generateId(),
+                sessionId: input.session_id,
+                role: 'system',
+                content: agentDefinition.systemPrompt,
+                createdAt: nowIso(),
+            },
+            ...messages,
+        ]
+        : messages;
+    const registry = new McpClientRegistry(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agentDefinition.mcpServers, deps.selfUrl, deps.inProcessDescriptors, deps.inProcessHandler, executionContext);
+    const runTask = async () => {
+        try {
+            await deps.orchestrator.run({
+                executionContext,
+                messages: allMessages,
+                registry,
+                provider,
+                policy: deps.policy,
+                taskStore: deps.taskStore,
+                sessionStore: deps.sessionStore,
+                signal: controller.signal,
+                taskId: task.id,
+                hooks: deps.hooks,
+                emitTaskEvent: deps.emitTaskEvent,
+                logger: deps.logger,
+                config: deps.config,
+            });
+        }
+        finally {
+            await deps.dagEngine.dispatchReady(task.id);
+        }
+    };
+    const sseBaseUrl = deps.config.sse.baseUrl;
+    const streamUrl = input.stream && input.background
+        ? `${sseBaseUrl}/tasks/${task.id}/stream`
+        : undefined;
+    if (input.background) {
+        deps.queue.enqueue(task.id, runTask);
+        deps.logger.info({ taskId: task.id, sessionId: input.session_id }, 'Task enqueued for background execution');
+        const response = {
+            task_id: task.id,
+            status: 'pending',
+        };
+        if (streamUrl) {
+            response.stream_url = streamUrl;
+        }
+        return response;
+    }
+    else {
+        try {
+            await runTask();
+        }
+        catch (error) {
+            // Orchestrator already updated the task status
+        }
+        const finalTask = deps.taskStore.read(task.id);
+        const usage = buildTaskUsageReport(deps.db, finalTask.id);
+        const response = {
+            task_id: finalTask.id,
+            status: finalTask.status,
+            result: finalTask.result,
+            usage,
+        };
+        if (streamUrl) {
+            response.stream_url = streamUrl;
+        }
+        return response;
+    }
+}
+export async function enqueueExistingTask(taskId, deps) {
+    const task = deps.taskStore.read(taskId);
+    if (task.isEphemeral || !task.sessionId) {
+        deps.logger.warn({ taskId, isEphemeral: task.isEphemeral }, 'enqueueExistingTask: skipping ephemeral task — context lost on restart');
+        try {
+            deps.taskStore.updateStatus(taskId, 'failed', {
+                error: 'Ephemeral task context lost on server restart; create a new task.',
+            });
+        }
+        catch {
+            // Already in a terminal state — ignore
+        }
+        return;
+    }
+    const session = deps.sessionStore.read(task.sessionId);
+    if (session.status !== 'active') {
+        deps.logger.warn({ taskId, sessionId: task.sessionId }, 'enqueueExistingTask: session is not active, skipping dispatch');
+        return;
+    }
+    const agentDefinition = deps.sessionStore.getAgentDefinition(task.sessionId);
+    const executionContext = {
+        taskId,
+        sessionId: task.sessionId,
+        agentName: agentDefinition.name,
+        agentDefinition,
+        recursionDepth: task.recursionDepth,
+        toolCallCount: 0,
+        inputs: task.inputs ?? undefined,
+    };
+    const controller = new AbortController();
+    deps.taskStore.registerCancellation(taskId, controller);
+    const provider = createProvider(agentDefinition.provider, agentDefinition.mcpServers, deps.config, deps.logger);
+    const existingMessages = deps.sessionStore.getMessages(task.sessionId);
+    const userMessage = {
+        id: generateId(),
+        sessionId: task.sessionId,
+        role: 'user',
+        content: task.prompt,
+        createdAt: nowIso(),
+    };
+    const messages = [...existingMessages, userMessage];
+    const allMessages = agentDefinition.systemPrompt
+        ? [
+            {
+                id: generateId(),
+                sessionId: task.sessionId,
+                role: 'system',
+                content: agentDefinition.systemPrompt,
+                createdAt: nowIso(),
+            },
+            ...messages,
+        ]
+        : messages;
+    const registry = new McpClientRegistry(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agentDefinition.mcpServers, deps.selfUrl, deps.inProcessDescriptors, deps.inProcessHandler, executionContext);
+    deps.queue.enqueue(taskId, async () => {
+        try {
+            await deps.orchestrator.run({
+                executionContext,
+                messages: allMessages,
+                registry,
+                provider,
+                policy: deps.policy,
+                taskStore: deps.taskStore,
+                sessionStore: deps.sessionStore,
+                signal: controller.signal,
+                taskId,
+                hooks: deps.hooks,
+                emitTaskEvent: deps.emitTaskEvent,
+                logger: deps.logger,
+                config: deps.config,
+            });
+        }
+        finally {
+            await deps.dagEngine.dispatchReady(taskId);
+        }
+    });
+}
+export function taskList(input, deps) {
+    return deps.taskStore.list(input);
+}
+export function taskCancel(input, deps) {
+    const task = deps.taskStore.read(input.task_id);
+    const cancellableStatuses = ['pending', 'running', 'awaiting_input'];
+    if (!cancellableStatuses.includes(task.status)) {
+        throw new ToolError('TASK_NOT_CANCELLABLE', `Task '${input.task_id}' has status '${task.status}' and cannot be cancelled`);
+    }
+    deps.taskStore.cancel(input.task_id);
+    return { success: true };
+}
+export async function taskResume(input, deps) {
+    const task = deps.taskStore.read(input.taskId);
+    if (task.status !== 'awaiting_input') {
+        throw new ToolError('VALIDATION_ERROR', `Task '${input.taskId}' is not awaiting input (status: ${task.status})`);
+    }
+    if (task.resumeToken !== input.resumeToken) {
+        throw new ToolError('VALIDATION_ERROR', 'Invalid resumeToken');
+    }
+    const resolved = resolveHitl(input.taskId, input.userInput);
+    if (!resolved) {
+        deps.taskStore.updateStatus(input.taskId, 'failed', {
+            error: 'Task could not be resumed: server restarted while task was suspended. Create a new task.',
+        });
+        throw new ToolError('TASK_NOT_RESUMABLE', `Task '${input.taskId}' has no active suspension (process restarted; task has been failed)`);
+    }
+    return { success: true, taskId: input.taskId };
+}
+export function resultTool(input, deps) {
+    const task = deps.taskStore.read(input.task_id);
+    const usage = buildTaskUsageReport(deps.db, task.id);
+    return { ...task, usage };
+}
+//# sourceMappingURL=task.js.map

package/src/tools/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/task.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAMxD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAY3D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAiB,MAAM,YAAY,CAAC;AAwCjE,KAAK,UAAU,gBAAgB,CAC7B,KAA6C,EAC7C,IAAc,EACd,aAAgC;IAEhC,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,kBAAkB,GAAG,UAAU,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAC,aAAa,CAAC,UAAU,IAAI,aAAa,CAAC,MAAM;QAClD,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,MAAM;QACV,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,aAAa,EAAE,MAAM;QACnC,cAAc,EAAE,CAAC,aAAa,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;KAC1D,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAqB;QACzC,MAAM;QACN,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,eAAe,CAAC,IAAI;QAC/B,eAAe;QACf,gBAAgB,EAAE,aAAa,EAAE,SAAS;QAC1C,YAAY,EAAE,aAAa,EAAE,MAAM;QACnC,UAAU,EAAE,UAAU,IAAI,SAAS;QACnC,cAAc,EAAE,CAAC,aAAa,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,aAAa,EAAE,CAAC;KACjB,CAAC;IAEF,MAAM,QAAQ,GAAG,cAAc,CAC7B,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,UAAU,EAC1B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CACZ,CAAC;IAEF,MAAM,WAAW,GAAG;QAClB,EAAE,EAAE,UAAU,EAAE;QAChB,SAAS,EAAE,kBAAkB;QAC7B,IAAI,EAAE,MAAe;QACrB,OAAO,EAAE,KAAK,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;IACF,MAAM,QAAQ,GAAG,eAAe,CAAC,YAAY;QAC3C,CAAC,CAAC;YACE;gBACE,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,kBAAkB;gBAC7B,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,eAAe,CAAC,YAAY;gBACrC,SAAS,EAAE,MAAM,EAAE;aACpB;YACD,WAAW;SACZ;QACH,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAElB,MAAM,gBAAgB,GAAG;QACvB,aAAa,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC7B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;KAChB,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,iBAAiB;IACpC,8DAA8D;IAC9D,eAAe,CAAC,UAAiB,EACjC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gBAAgB,EACrB,gBAAgB,CACjB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;YAC1B,gBAAgB;YAChB,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,gBAAgB;YAC9B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEpD,OAAO;QACL,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,SAAS,CAAC,MAAoB;QACtC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAoB,EACpB,IAAc,EACd,aAAgC;IAEhC,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;QAC1B,OAAO,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CACjB,gBAAgB,EAChB,YAAY,KAAK,CAAC,UAAU,aAAa,CAC1C,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAC1D,KAAK,CAAC,UAAU,CACjB,CAAC;IAEF,MAAM,SAAS,GAAI,KAAmC,CAAC,UAAU,IAAI,EAAE,CAAC;IACxE,MAAM,iBAAiB,GAAI,KAAmD;SAC3E,mBAAmB,CAAC;IACvB,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACjC,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,aAAa,EAAE,MAAM;QACnC,cAAc,EAAE,CAAC,aAAa,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACvD,iBAAiB;KAClB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAC,aAAa,CAAC,UAAU,IAAI,aAAa,CAAC,MAAM;QAClD,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,gBAAgB,GAAqB;QACzC,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,SAAS,EAAE,eAAe,CAAC,IAAI;QAC/B,eAAe;QACf,gBAAgB,EAAE,aAAa,EAAE,SAAS;QAC1C,YAAY,EAAE,aAAa,EAAE,MAAM;QACnC,UAAU,EAAE,UAAU,IAAI,SAAS;QACnC,cAAc,EAAE,CAAC,aAAa,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,aAAa,EAAE,CAAC;KACjB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,cAAc,CAC7B,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,UAAU,EAC1B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CACZ,CAAC;IAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG;QAClB,EAAE,EAAE,UAAU,EAAE;QAChB,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,IAAI,EAAE,MAAe;QACrB,OAAO,EAAE,KAAK,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;IACF,8DAA8D;IAC9D,MAAO,IAAI,CAAC,YAAoB,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,CAAC,GAAG,gBAAgB,EAAE,WAAW,CAAyB,CAAC;IAE5E,MAAM,WAAW,GAAG,eAAe,CAAC,YAAY;QAC9C,CAAC,CAAC;YACE;gBACE,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,KAAK,CAAC,UAAU;gBAC3B,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,eAAe,CAAC,YAAY;gBACrC,SAAS,EAAE,MAAM,EAAE;aACpB;YACD,GAAG,QAAQ;SACZ;QACH,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,QAAQ,GAAG,IAAI,iBAAiB;IACpC,8DAA8D;IAC9D,eAAe,CAAC,UAAiB,EACjC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gBAAgB,EACrB,gBAAgB,CACjB,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;gBAC1B,gBAAgB;gBAChB,QAAQ,EAAE,WAAW;gBACrB,QAAQ;gBACR,QAAQ;gBACR,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,YAAY,EAAE,IAAI,CAAC,YAAuF;gBAC1G,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;IAC3C,MAAM,SAAS,GACb,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU;QAC9B,CAAC,CAAC,GAAG,UAAU,UAAU,IAAI,CAAC,EAAE,SAAS;QACzC,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAErC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,EAChD,wCAAwC,CACzC,CAAC;QAEF,MAAM,QAAQ,GAAmB;YAC/B,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAClC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;QACjD,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAmB;YAC/B,OAAO,EAAE,SAAS,CAAC,EAAE;YACvB,MAAM,EAAE,SAAS,CAAC,MAAoB;YACpC,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,KAAK;SACN,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAClC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,IAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EACzC,wEAAwE,CACzE,CAAC;QACF,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE;gBAC5C,KAAK,EACH,mEAAmE;aACtE,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EACrC,+DAA+D,CAChE,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7E,MAAM,gBAAgB,GAAqB;QACzC,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,eAAe,CAAC,IAAI;QAC/B,eAAe;QACf,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;KACjC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,cAAc,CAC7B,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,UAAU,EAC1B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CACZ,CAAC;IAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG;QAClB,EAAE,EAAE,UAAU,EAAE;QAChB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,MAAe;QACrB,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,GAAG,gBAAgB,EAAE,WAAW,CAAyB,CAAC;IAE5E,MAAM,WAAW,GAAG,eAAe,CAAC,YAAY;QAC9C,CAAC,CAAC;YACE;gBACE,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,eAAe,CAAC,YAAY;gBACrC,SAAS,EAAE,MAAM,EAAE;aACpB;YACD,GAAG,QAAQ;SACZ;QACH,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,QAAQ,GAAG,IAAI,iBAAiB;IACpC,8DAA8D;IAC9D,eAAe,CAAC,UAAiB,EACjC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gBAAgB,EACrB,gBAAgB,CACjB,CAAC;IAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;gBAC1B,gBAAgB;gBAChB,QAAQ,EAAE,WAAW;gBACrB,QAAQ;gBACR,QAAQ;gBACR,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,YAAY,EAAE,IAAI,CAAC,YAAuF;gBAC1G,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,MAAM;gBACN,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,KAAoB,EACpB,IAAiC;IAEjC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAsB,EACtB,IAAiC;IAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEhD,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAU,CAAC;IAC9E,IACE,CAAC,mBAAmB,CAAC,QAAQ,CAC3B,IAAI,CAAC,MAA8C,CACpD,EACD,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,sBAAsB,EACtB,SAAS,KAAK,CAAC,OAAO,iBAAiB,IAAI,CAAC,MAAM,2BAA2B,CAC9E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAiE,EACjE,IAAiC;IAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,SAAS,CACjB,kBAAkB,EAClB,SAAS,KAAK,CAAC,MAAM,oCAAoC,IAAI,CAAC,MAAM,GAAG,CACxE,CAAC;IACJ,CAAC;IAED,IAAK,IAA4C,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;QACpF,MAAM,IAAI,SAAS,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE;YAClD,KAAK,EACH,0FAA0F;SAC7F,CAAC,CAAC;QACH,MAAM,IAAI,SAAS,CACjB,oBAAoB,EACpB,SAAS,KAAK,CAAC,MAAM,sEAAsE,CAC5F,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAkB,EAClB,IAAwC;IAExC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAwC,CAAC;AAClE,CAAC"}

package/src/tools/usage.d.ts

@@ -0,0 +1,19 @@
+import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+import { taskUsageTable } from "@adhd/agent-store-runtime";
+import type { GroupedUsageRow, TaskUsageInput, TaskUsageReport } from "../validation/usage.js";
+export type Database = BetterSQLite3Database<any>;
+export type TaskUsageRow = typeof taskUsageTable.$inferSelect;
+export interface UsageQueryResult {
+    rows: TaskUsageRow[];
+    groups?: GroupedUsageRow[];
+    summary: {
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        totalToolCalls: number;
+        totalModelCalls: number;
+        taskCount: number;
+    };
+}
+export declare function usageQuery(db: Database, input: TaskUsageInput): UsageQueryResult;
+export declare function buildTaskUsageReport(db: Database, taskId: string): TaskUsageReport | undefined;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/tools/usage.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,cAAc,EAAc,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EAEhB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AA4CD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,GAAG,gBAAgB,CA0FhF;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,GACb,eAAe,GAAG,SAAS,CAkB7B"}

package/src/tools/usage.js

@@ -0,0 +1,152 @@
+import { and, desc, eq, gte, or, sql } from "drizzle-orm";
+const SEVERITY = { length: 3, tool_calls: 2, stop: 1, unknown: 0 };
+function mostSevereStr(a, b) {
+    if (!a && !b)
+        return undefined;
+    const sa = SEVERITY[a ?? ""] ?? 0;
+    const sb = SEVERITY[b ?? ""] ?? 0;
+    return sa >= sb ? a : b;
+}
+import { taskUsageTable, tasksTable } from "@adhd/agent-store-runtime";
+/**
+ * `inputTokens` is CUMULATIVE BILLED input across model calls — the whole history is
+ * re-sent on every call, so it is not a context size and must never be compared against a
+ * model's context window. `peakContextTokens` is the real high-water mark and is a MAX,
+ * so it is maxed here rather than summed. Conflating the two is what produced a "710K
+ * context" post-mortem for a run whose largest context was 43K (FINDING-ORCH-007).
+ *
+ * Cache fields are surfaced because cache-hit vs cache-miss input is a 50x price
+ * difference — without them a caller cannot tell a cheap run from an expensive one of
+ * identical token count (BUG-ORCH-009).
+ */
+function summarise(rows) {
+    return rows.reduce((acc, row) => ({
+        inputTokens: acc.inputTokens + (row.inputTokens ?? 0),
+        outputTokens: acc.outputTokens + (row.outputTokens ?? 0),
+        modelCalls: acc.modelCalls + (row.modelCalls ?? 0),
+        toolCallCount: acc.toolCallCount + (row.toolCallCount ?? 0),
+        latencyMs: acc.latencyMs + (row.latencyMs ?? 0),
+        stopReason: mostSevereStr(acc.stopReason, row.stopReason ?? undefined),
+        uncachedInputTokens: acc.uncachedInputTokens + (row.uncachedInputTokens ?? 0),
+        cacheReadTokens: acc.cacheReadTokens + (row.cacheReadTokens ?? 0),
+        cacheCreationTokens: acc.cacheCreationTokens + (row.cacheCreationTokens ?? 0),
+        reasoningTokens: acc.reasoningTokens + (row.reasoningTokens ?? 0),
+        // MAX across rows — deliberately NOT a sum.
+        peakContextTokens: Math.max(acc.peakContextTokens, row.peakContextTokens ?? 0),
+    }), {
+        inputTokens: 0,
+        outputTokens: 0,
+        modelCalls: 0,
+        toolCallCount: 0,
+        latencyMs: 0,
+        uncachedInputTokens: 0,
+        cacheReadTokens: 0,
+        cacheCreationTokens: 0,
+        reasoningTokens: 0,
+        peakContextTokens: 0,
+    });
+}
+export function usageQuery(db, input) {
+    const filters = [];
+    if (input?.task_id) {
+        const id = input.task_id;
+        const subtree = or(eq(taskUsageTable.taskId, id), eq(taskUsageTable.rootTaskId, id));
+        if (subtree)
+            filters.push(subtree);
+    }
+    if (input?.root_task_id) {
+        const id = input.root_task_id;
+        const subtree = or(eq(taskUsageTable.taskId, id), eq(taskUsageTable.rootTaskId, id));
+        if (subtree)
+            filters.push(subtree);
+    }
+    if (input?.agent_name) {
+        filters.push(eq(taskUsageTable.agentName, input.agent_name));
+    }
+    if (input?.since) {
+        filters.push(gte(taskUsageTable.createdAt, input.since));
+    }
+    if (!input?.include_incomplete) {
+        filters.push(eq(taskUsageTable.isComplete, 1));
+    }
+    const whereClause = filters.length > 0 ? and(...filters) : undefined;
+    const limit = input?.limit ?? 50;
+    if (input?.group_by) {
+        let groupCol;
+        if (input.group_by === "model") {
+            groupCol = taskUsageTable.model;
+        }
+        else if (input.group_by === "provider") {
+            groupCol = taskUsageTable.providerType;
+        }
+        else {
+            groupCol = taskUsageTable.agentName;
+        }
+        const groups = db
+            .select({
+            key: groupCol,
+            taskCount: sql `count(*)`,
+            completedCount: sql `sum(case when ${tasksTable.status} = 'completed' then 1 else 0 end)`,
+            failedCount: sql `sum(case when ${tasksTable.status} = 'failed' then 1 else 0 end)`,
+            cancelledCount: sql `sum(case when ${tasksTable.status} = 'cancelled' then 1 else 0 end)`,
+            inputTokens: sql `sum(${taskUsageTable.inputTokens})`,
+            outputTokens: sql `sum(${taskUsageTable.outputTokens})`,
+            toolCallCount: sql `sum(${taskUsageTable.toolCallCount})`,
+            modelCalls: sql `sum(${taskUsageTable.modelCalls})`,
+            avgLatencyMs: sql `avg(case when ${taskUsageTable.latencyMs} > 0 then ${taskUsageTable.latencyMs} else null end)`,
+            cacheReadTokens: sql `sum(${taskUsageTable.cacheReadTokens})`,
+            cacheCreationTokens: sql `sum(${taskUsageTable.cacheCreationTokens})`,
+        })
+            .from(taskUsageTable)
+            .leftJoin(tasksTable, eq(taskUsageTable.taskId, tasksTable.id))
+            .where(whereClause)
+            .groupBy(groupCol)
+            .orderBy(desc(sql `sum(${taskUsageTable.inputTokens} + ${taskUsageTable.outputTokens})`))
+            .limit(limit)
+            .all();
+        const totalInputTokens = groups.reduce((n, r) => n + r.inputTokens, 0);
+        const totalOutputTokens = groups.reduce((n, r) => n + r.outputTokens, 0);
+        const totalToolCalls = groups.reduce((n, r) => n + r.toolCallCount, 0);
+        const totalModelCalls = groups.reduce((n, r) => n + r.modelCalls, 0);
+        const taskCount = groups.reduce((n, r) => n + r.taskCount, 0);
+        return {
+            rows: [],
+            groups,
+            summary: { totalInputTokens, totalOutputTokens, totalToolCalls, totalModelCalls, taskCount },
+        };
+    }
+    const rows = db
+        .select()
+        .from(taskUsageTable)
+        .where(whereClause)
+        .orderBy(desc(taskUsageTable.createdAt))
+        .limit(limit)
+        .all();
+    return {
+        rows,
+        summary: {
+            totalInputTokens: rows.reduce((n, r) => n + (r.inputTokens ?? 0), 0),
+            totalOutputTokens: rows.reduce((n, r) => n + (r.outputTokens ?? 0), 0),
+            totalToolCalls: rows.reduce((n, r) => n + (r.toolCallCount ?? 0), 0),
+            totalModelCalls: rows.reduce((n, r) => n + (r.modelCalls ?? 0), 0),
+            taskCount: rows.length,
+        },
+    };
+}
+export function buildTaskUsageReport(db, taskId) {
+    const subtreeRows = db
+        .select()
+        .from(taskUsageTable)
+        .where(or(eq(taskUsageTable.taskId, taskId), eq(taskUsageTable.rootTaskId, taskId)))
+        .all();
+    if (subtreeRows.length === 0) {
+        return undefined;
+    }
+    const directRows = subtreeRows.filter(row => row.taskId === taskId);
+    return {
+        direct: summarise(directRows),
+        subtree: summarise(subtreeRows),
+        taskCount: subtreeRows.length,
+    };
+}
+//# sourceMappingURL=usage.js.map

package/src/tools/usage.js.map

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

package/src/utils/ids.d.ts

@@ -0,0 +1,2 @@
+export declare function generateId(): string;
+//# sourceMappingURL=ids.d.ts.map

package/src/utils/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/utils/ids.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/src/utils/ids.js

@@ -0,0 +1,5 @@
+import { v4 as uuidv4 } from "uuid";
+export function generateId() {
+    return uuidv4();
+}
+//# sourceMappingURL=ids.js.map

package/src/utils/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/utils/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC,MAAM,UAAU,UAAU;IACtB,OAAO,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/src/utils/timestamps.d.ts

@@ -0,0 +1,2 @@
+export declare function nowIso(): string;
+//# sourceMappingURL=timestamps.d.ts.map

package/src/utils/timestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/utils/timestamps.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/src/utils/timestamps.js

@@ -0,0 +1,4 @@
+export function nowIso() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=timestamps.js.map

package/src/utils/timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/utils/timestamps.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM;IAClB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}