@adhd/agent-engine-orchestrator 2.1.0

package/src/validation/session.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export declare const sessionStatusSchema: z.ZodEnum<{
+    active: "active";
+    closed: "closed";
+}>;
+export type { SessionStatus } from '@adhd/agent-base-types';
+export declare const sessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    agentName: z.ZodString;
+    agentVersion: z.ZodNumber;
+    status: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    closedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type { Session } from '@adhd/agent-base-types';
+export declare const agentToolInputSchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const agentToolOutputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, z.core.$strip>;
+export declare const sessionListInputSchema: z.ZodObject<{
+    agentName: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+    }>>;
+}, z.core.$strip>;
+export declare const sessionCloseInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, z.core.$strip>;
+export declare const sessionClearInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, z.core.$strip>;
+export declare const sessionClearOutputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    cleared: z.ZodNumber;
+}, z.core.$strip>;
+export type AgentToolInput = z.infer<typeof agentToolInputSchema>;
+export type AgentToolOutput = z.infer<typeof agentToolOutputSchema>;
+export type SessionListInput = z.infer<typeof sessionListInputSchema>;
+export type SessionCloseInput = z.infer<typeof sessionCloseInputSchema>;
+export type SessionClearInput = z.infer<typeof sessionClearInputSchema>;
+export type SessionClearOutput = z.infer<typeof sessionClearOutputSchema>;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/validation/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;EAA+B,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,aAAa;;;;;;;;;;;iBAQxB,CAAC;AAEH,YAAY,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;iBAGjC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/src/validation/session.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const sessionStatusSchema = z.enum(['active', 'closed']);
+export const sessionSchema = z.object({
+    id: z.string().uuid(),
+    agentName: z.string(),
+    agentVersion: z.number().int().positive(),
+    status: sessionStatusSchema,
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    closedAt: z.string().datetime().optional(),
+});
+export const agentToolInputSchema = z.object({
+    name: z.string().min(1),
+});
+export const agentToolOutputSchema = z.object({
+    session_id: z.string().uuid(),
+});
+export const sessionListInputSchema = z.object({
+    agentName: z.string().optional(),
+    status: sessionStatusSchema.optional(),
+});
+export const sessionCloseInputSchema = z.object({
+    session_id: z.string().uuid(),
+});
+export const sessionClearInputSchema = z.object({
+    session_id: z.string().uuid(),
+});
+export const sessionClearOutputSchema = z.object({
+    session_id: z.string().uuid(),
+    cleared: z.number().int().nonnegative(),
+});
+//# sourceMappingURL=session.js.map

package/src/validation/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/validation/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGhE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC,CAAC"}

package/src/validation/task.d.ts

@@ -0,0 +1,156 @@
+import { z } from 'zod';
+export declare const taskStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    cancelled: "cancelled";
+    waiting: "waiting";
+    awaiting_input: "awaiting_input";
+}>;
+export type { TaskStatus } from '@adhd/agent-base-types';
+export declare const taskSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    isEphemeral: z.ZodDefault<z.ZodBoolean>;
+    parentTaskId: z.ZodOptional<z.ZodString>;
+    recursionDepth: z.ZodNumber;
+    status: z.ZodEnum<{
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+        waiting: "waiting";
+        awaiting_input: "awaiting_input";
+    }>;
+    prompt: z.ZodString;
+    result: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    cancelledAt: z.ZodOptional<z.ZodString>;
+    dependsOn: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    onUpstreamFailure: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        skip: "skip";
+    }>>>;
+    inputs: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    resumeToken: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type { Task } from '@adhd/agent-base-types';
+export declare const taskEventTypeSchema: z.ZodEnum<{
+    MODEL_REQUEST: "MODEL_REQUEST";
+    MODEL_RESPONSE: "MODEL_RESPONSE";
+    TOOL_CALL: "TOOL_CALL";
+    TOOL_RESULT: "TOOL_RESULT";
+    TASK_COMPLETED: "TASK_COMPLETED";
+    TASK_FAILED: "TASK_FAILED";
+    TASK_CANCELLED: "TASK_CANCELLED";
+}>;
+export type { TaskEventType } from '@adhd/agent-base-types';
+export declare const taskEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    taskId: z.ZodString;
+    type: z.ZodEnum<{
+        MODEL_REQUEST: "MODEL_REQUEST";
+        MODEL_RESPONSE: "MODEL_RESPONSE";
+        TOOL_CALL: "TOOL_CALL";
+        TOOL_RESULT: "TOOL_RESULT";
+        TASK_COMPLETED: "TASK_COMPLETED";
+        TASK_FAILED: "TASK_FAILED";
+        TASK_CANCELLED: "TASK_CANCELLED";
+    }>;
+    payload: z.ZodUnknown;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type { TaskEvent } from '@adhd/agent-base-types';
+export declare const taskToolInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    session_id: z.ZodString;
+    prompt: z.ZodString;
+    background: z.ZodDefault<z.ZodBoolean>;
+    depends_on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    on_upstream_failure: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        skip: "skip";
+    }>>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    agent_name: z.ZodString;
+    prompt: z.ZodString;
+    depends_on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    on_upstream_failure: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        skip: "skip";
+    }>>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>]>;
+export declare const taskToolOutputSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+        waiting: "waiting";
+        awaiting_input: "awaiting_input";
+    }>;
+    result: z.ZodOptional<z.ZodString>;
+    stream_url: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        direct: z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            modelCalls: z.ZodNumber;
+            toolCallCount: z.ZodNumber;
+            latencyMs: z.ZodNumber;
+            stopReason: z.ZodOptional<z.ZodString>;
+            uncachedInputTokens: z.ZodNumber;
+            cacheReadTokens: z.ZodNumber;
+            cacheCreationTokens: z.ZodNumber;
+            reasoningTokens: z.ZodNumber;
+            peakContextTokens: z.ZodNumber;
+        }, z.core.$strip>;
+        subtree: z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            modelCalls: z.ZodNumber;
+            toolCallCount: z.ZodNumber;
+            latencyMs: z.ZodNumber;
+            stopReason: z.ZodOptional<z.ZodString>;
+            uncachedInputTokens: z.ZodNumber;
+            cacheReadTokens: z.ZodNumber;
+            cacheCreationTokens: z.ZodNumber;
+            reasoningTokens: z.ZodNumber;
+            peakContextTokens: z.ZodNumber;
+        }, z.core.$strip>;
+        taskCount: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const taskListInputSchema: z.ZodObject<{
+    session_id: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+        waiting: "waiting";
+        awaiting_input: "awaiting_input";
+    }>>;
+    is_ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const taskCancelInputSchema: z.ZodObject<{
+    task_id: z.ZodString;
+}, z.core.$strip>;
+export declare const resultInputSchema: z.ZodObject<{
+    task_id: z.ZodString;
+}, z.core.$strip>;
+export type TaskToolInput = z.infer<typeof taskToolInputSchema>;
+export type TaskToolOutput = z.infer<typeof taskToolOutputSchema>;
+export type TaskListInput = z.infer<typeof taskListInputSchema>;
+export type TaskCancelInput = z.infer<typeof taskCancelInputSchema>;
+export type ResultInput = z.infer<typeof resultInputSchema>;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/validation/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;EAQ3B,CAAC;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBrB,CAAC;AAEH,YAAY,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,mBAAmB;;;;;;;;EAQ9B,CAAC;AAEH,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;iBAM1B,CAAC;AAEH,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAmBxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;mBAG9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM/B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/src/validation/task.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { taskUsageReportSchema } from './usage.js';
+export const taskStatusSchema = z.enum([
+    'pending',
+    'running',
+    'completed',
+    'failed',
+    'cancelled',
+    'waiting',
+    'awaiting_input',
+]);
+export const taskSchema = z.object({
+    id: z.string().uuid(),
+    sessionId: z.string().uuid().optional(),
+    isEphemeral: z.boolean().default(false),
+    parentTaskId: z.string().uuid().optional(),
+    recursionDepth: z.number().int().nonnegative(),
+    status: taskStatusSchema,
+    prompt: z.string(),
+    result: z.string().optional(),
+    error: z.string().optional(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    completedAt: z.string().datetime().optional(),
+    cancelledAt: z.string().datetime().optional(),
+    dependsOn: z.array(z.string().uuid()).optional().nullable(),
+    onUpstreamFailure: z.enum(['fail', 'skip']).optional().nullable(),
+    inputs: z.record(z.string(), z.string()).optional().nullable(),
+    resumeToken: z.string().uuid().optional().nullable(),
+});
+export const taskEventTypeSchema = z.enum([
+    'MODEL_REQUEST',
+    'MODEL_RESPONSE',
+    'TOOL_CALL',
+    'TOOL_RESULT',
+    'TASK_COMPLETED',
+    'TASK_FAILED',
+    'TASK_CANCELLED',
+]);
+export const taskEventSchema = z.object({
+    id: z.string().uuid(),
+    taskId: z.string().uuid(),
+    type: taskEventTypeSchema,
+    payload: z.unknown(),
+    createdAt: z.string().datetime(),
+});
+const sessionModeSchema = z.object({
+    session_id: z.string().uuid(),
+    prompt: z.string().min(1),
+    background: z.boolean().default(false),
+    depends_on: z.array(z.string().uuid()).optional(),
+    on_upstream_failure: z.enum(['fail', 'skip']).optional(),
+    stream: z.boolean().optional(),
+});
+const ephemeralModeSchema = z.object({
+    agent_name: z.string().min(1),
+    prompt: z.string().min(1),
+    depends_on: z.array(z.string().uuid()).optional(),
+    on_upstream_failure: z.enum(['fail', 'skip']).optional(),
+    stream: z.boolean().optional(),
+});
+export const taskToolInputSchema = z.union([
+    sessionModeSchema,
+    ephemeralModeSchema,
+]);
+export const taskToolOutputSchema = z.object({
+    task_id: z.string().uuid(),
+    status: taskStatusSchema,
+    result: z.string().optional(),
+    stream_url: z.string().optional(),
+    usage: taskUsageReportSchema.optional(),
+});
+export const taskListInputSchema = z.object({
+    session_id: z.string().uuid().optional(),
+    status: taskStatusSchema.optional(),
+    is_ephemeral: z.boolean().optional(),
+});
+export const taskCancelInputSchema = z.object({
+    task_id: z.string().uuid(),
+});
+export const resultInputSchema = z.object({
+    task_id: z.string().uuid(),
+});
+//# sourceMappingURL=task.js.map

package/src/validation/task.js.map

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

package/src/validation/tasks.d.ts

@@ -0,0 +1,2 @@
+export * from "./task.js";
+//# sourceMappingURL=tasks.d.ts.map

package/src/validation/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/validation/tasks.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC"}

package/src/validation/tasks.js

@@ -0,0 +1,3 @@
+// Replaced by task.ts — see src/validation/task.ts
+export * from "./task.js";
+//# sourceMappingURL=tasks.js.map

package/src/validation/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/validation/tasks.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,cAAc,WAAW,CAAC"}

package/src/validation/usage.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+export declare const taskUsageInputSchema: z.ZodOptional<z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    root_task_id: z.ZodOptional<z.ZodString>;
+    agent_name: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    include_incomplete: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    group_by: z.ZodOptional<z.ZodEnum<{
+        model: "model";
+        provider: "provider";
+        agent: "agent";
+    }>>;
+}, z.core.$strip>>;
+export type TaskUsageInput = z.infer<typeof taskUsageInputSchema>;
+export declare const groupedUsageRowSchema: z.ZodObject<{
+    key: z.ZodString;
+    taskCount: z.ZodNumber;
+    completedCount: z.ZodNumber;
+    failedCount: z.ZodNumber;
+    cancelledCount: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    toolCallCount: z.ZodNumber;
+    modelCalls: z.ZodNumber;
+    avgLatencyMs: z.ZodNumber;
+    cacheReadTokens: z.ZodNullable<z.ZodNumber>;
+    cacheCreationTokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type GroupedUsageRow = z.infer<typeof groupedUsageRowSchema>;
+export declare const usageSummarySchema: z.ZodObject<{
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    modelCalls: z.ZodNumber;
+    toolCallCount: z.ZodNumber;
+    latencyMs: z.ZodNumber;
+    stopReason: z.ZodOptional<z.ZodString>;
+    uncachedInputTokens: z.ZodNumber;
+    cacheReadTokens: z.ZodNumber;
+    cacheCreationTokens: z.ZodNumber;
+    reasoningTokens: z.ZodNumber;
+    peakContextTokens: z.ZodNumber;
+}, z.core.$strip>;
+export type UsageSummary = z.infer<typeof usageSummarySchema>;
+export declare const taskUsageReportSchema: z.ZodObject<{
+    direct: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        modelCalls: z.ZodNumber;
+        toolCallCount: z.ZodNumber;
+        latencyMs: z.ZodNumber;
+        stopReason: z.ZodOptional<z.ZodString>;
+        uncachedInputTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+        cacheCreationTokens: z.ZodNumber;
+        reasoningTokens: z.ZodNumber;
+        peakContextTokens: z.ZodNumber;
+    }, z.core.$strip>;
+    subtree: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        modelCalls: z.ZodNumber;
+        toolCallCount: z.ZodNumber;
+        latencyMs: z.ZodNumber;
+        stopReason: z.ZodOptional<z.ZodString>;
+        uncachedInputTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+        cacheCreationTokens: z.ZodNumber;
+        reasoningTokens: z.ZodNumber;
+        peakContextTokens: z.ZodNumber;
+    }, z.core.$strip>;
+    taskCount: z.ZodNumber;
+}, z.core.$strip>;
+export type TaskUsageReport = z.infer<typeof taskUsageReportSchema>;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-engine-orchestrator/src/validation/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;kBAUpB,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;iBAahC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAkB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/src/validation/usage.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export const taskUsageInputSchema = z
+    .object({
+    task_id: z.string().optional(),
+    root_task_id: z.string().optional(),
+    agent_name: z.string().optional(),
+    since: z.string().datetime().optional(),
+    include_incomplete: z.boolean().default(false),
+    limit: z.number().int().positive().max(500).default(50),
+    group_by: z.enum(["agent", "model", "provider"]).optional(),
+})
+    .optional();
+export const groupedUsageRowSchema = z.object({
+    key: z.string(),
+    taskCount: z.number().int().nonnegative(),
+    completedCount: z.number().int().nonnegative(),
+    failedCount: z.number().int().nonnegative(),
+    cancelledCount: z.number().int().nonnegative(),
+    inputTokens: z.number().int().nonnegative(),
+    outputTokens: z.number().int().nonnegative(),
+    toolCallCount: z.number().int().nonnegative(),
+    modelCalls: z.number().int().nonnegative(),
+    avgLatencyMs: z.number().nonnegative(),
+    cacheReadTokens: z.number().int().nonnegative().nullable(),
+    cacheCreationTokens: z.number().int().nonnegative().nullable(),
+});
+export const usageSummarySchema = z.object({
+    /** CUMULATIVE billed input across model calls. NOT a context size — see peakContextTokens. */
+    inputTokens: z.number().int().nonnegative(),
+    outputTokens: z.number().int().nonnegative(),
+    modelCalls: z.number().int().nonnegative(),
+    toolCallCount: z.number().int().nonnegative(),
+    latencyMs: z.number().int().nonnegative(),
+    stopReason: z.string().optional(),
+    /** Full-price (cache-miss) input. This — not inputTokens — is what actually drives cost. */
+    uncachedInputTokens: z.number().int().nonnegative(),
+    /** Discounted cache-hit input (~50x cheaper than a miss on deepseek-v4-flash). */
+    cacheReadTokens: z.number().int().nonnegative(),
+    /** Cache-write input (premium on Anthropic/OpenAI; free on DeepSeek/Gemini). */
+    cacheCreationTokens: z.number().int().nonnegative(),
+    /** Reasoning tokens (reasoning models); billed as output. */
+    reasoningTokens: z.number().int().nonnegative(),
+    /** PEAK single-call input — the real context high-water mark (a MAX, not a sum). */
+    peakContextTokens: z.number().int().nonnegative(),
+});
+export const taskUsageReportSchema = z.object({
+    direct: usageSummarySchema,
+    subtree: usageSummarySchema,
+    taskCount: z.number().int().positive(),
+});
+//# sourceMappingURL=usage.js.map

package/src/validation/usage.js.map

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