@vercel/factory 0.0.14 → 0.0.16

package/dist/api-contracts.d.mts

@@ -0,0 +1,1768 @@
+import { ChangeId, TaskId } from "./schema/id.mjs";
+import { RepositorySlug } from "./schema/repository.mjs";
+import { AgentRouteBinding, AgentRouteBindingInput } from "./schema/agent-route.mjs";
+import { JsonValue } from "./schema/work.mjs";
+import { Task, TaskKind } from "./schema/task.mjs";
+import "./workflows.mjs";
+import { ImageAttachment } from "./image-input.mjs";
+import { AgentSession } from "./schema/session.mjs";
+import "./tasks.mjs";
+import "./client.mjs";
+import { z } from "zod";
+//#region src/api-contracts.d.ts
+/** Validates an agent exposed by the operator API. */
+declare const apiAgentSchema: z.ZodObject<{
+  id: z.ZodString;
+  description: z.ZodString;
+  route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+  }, z.core.$strict>, "AgentRouteBinding", "out">>;
+  canStart: z.ZodBoolean;
+  requiresRepository: z.ZodBoolean;
+  requiresChange: z.ZodBoolean;
+}, z.core.$strict>;
+/** An agent exposed for operator discovery, filtering, or session creation. */
+type ApiAgent = Readonly<Omit<z.infer<typeof apiAgentSchema>, "route"> & {
+  readonly route?: AgentRouteBinding;
+}>;
+/** Caller input for exposing an agent through the operator API before validation and branding. */
+interface ApiAgentInput {
+  readonly id: string;
+  readonly description: string;
+  readonly route?: AgentRouteBindingInput;
+  readonly canStart: boolean;
+  readonly requiresRepository: boolean;
+  readonly requiresChange: boolean;
+}
+/** Validates an idempotent request to create an operator session. */
+declare const createSessionRequestSchema: z.ZodObject<{
+  operationId: z.ZodString;
+  agent: z.ZodString;
+  model: z.ZodOptional<z.ZodString>;
+  repository: z.ZodOptional<z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>>;
+  changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+  message: z.ZodString;
+  attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+    filename: z.ZodString;
+    mediaType: z.ZodEnum<{
+      "image/png": "image/png";
+      "image/jpeg": "image/jpeg";
+      "image/webp": "image/webp";
+    }>;
+    size: z.ZodNumber;
+  }, z.core.$strict>>>>;
+}, z.core.$strict>;
+/** An idempotent request to create an operator session. */
+type CreateSessionRequest = Readonly<Omit<z.input<typeof createSessionRequestSchema>, "attachments" | "repository" | "changeId">> & {
+  readonly repository?: RepositorySlug;
+  readonly changeId?: ChangeId;
+  readonly attachments?: readonly ImageAttachment[];
+};
+/** Validates a message sent to an existing session with optimistic execution matching. */
+declare const sendSessionMessageRequestSchema: z.ZodObject<{
+  message: z.ZodString;
+  attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+    filename: z.ZodString;
+    mediaType: z.ZodEnum<{
+      "image/png": "image/png";
+      "image/jpeg": "image/jpeg";
+      "image/webp": "image/webp";
+    }>;
+    size: z.ZodNumber;
+  }, z.core.$strict>>>>;
+  operationId: z.ZodOptional<z.ZodString>;
+  turnPolicy: z.ZodDefault<z.ZodEnum<{
+    steer: "steer";
+    queue: "queue";
+  }>>;
+  executionId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+/** Message sent to an existing session with optimistic execution matching. */
+type SendSessionMessageRequest = Readonly<Omit<z.input<typeof sendSessionMessageRequestSchema>, "attachments">> & {
+  readonly attachments?: readonly ImageAttachment[];
+};
+/** Validates an option selection or freeform answer to one provider input request. */
+declare const sessionInputResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+  optionId: z.ZodString;
+  text: z.ZodOptional<z.ZodNever>;
+  requestId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  optionId: z.ZodOptional<z.ZodNever>;
+  text: z.ZodString;
+  requestId: z.ZodString;
+}, z.core.$strict>]>;
+/** A response to one pending provider input request. */
+type SessionInputResponse = Readonly<z.input<typeof sessionInputResponseSchema>>;
+/** Validates responses submitted to pending provider input requests. */
+declare const submitSessionInputRequestSchema: z.ZodObject<{
+  executionId: z.ZodString;
+  inputResponses: z.ZodReadonly<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    optionId: z.ZodString;
+    text: z.ZodOptional<z.ZodNever>;
+    requestId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    optionId: z.ZodOptional<z.ZodNever>;
+    text: z.ZodString;
+    requestId: z.ZodString;
+  }, z.core.$strict>]>>>;
+}, z.core.$strict>;
+/** Responses submitted to pending provider input requests. */
+interface SubmitSessionInputRequest {
+  readonly executionId: string;
+  readonly inputResponses: readonly SessionInputResponse[];
+}
+/** Validates an execution-aware session control request. */
+declare const controlSessionRequestSchema: z.ZodObject<{
+  executionId: z.ZodOptional<z.ZodString>;
+  turnId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Execution and turn observed before requesting a session control operation. */
+type ControlSessionRequest = Readonly<z.input<typeof controlSessionRequestSchema>>;
+/** Validates an authenticated answer to a workflow question. */
+declare const answerSessionQuestionRequestSchema: z.ZodObject<{
+  questionId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+  answer: z.ZodString;
+}, z.core.$strict>;
+/** Authenticated answer to a workflow question in a session. */
+interface AnswerSessionQuestionRequest {
+  readonly questionId: TaskId;
+  readonly answer: string;
+}
+/** Validates the current operator-facing projection of a Factory session. */
+declare const sessionViewSchema: z.ZodObject<{
+  session: z.ZodType<AgentSession, unknown, z.core.$ZodTypeInternals<AgentSession, unknown>>;
+  task: z.ZodNullable<Omit<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+    kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+    model: z.ZodOptional<z.ZodString>;
+    area: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<{
+      queued: "queued";
+      running: "running";
+      stalled: "stalled";
+      verifying: "verifying";
+      succeeded: "succeeded";
+      failed: "failed";
+      needs_human: "needs_human";
+      cancelled: "cancelled";
+    }>;
+    approval: z.ZodOptional<z.ZodEnum<{
+      required: "required";
+      granted: "granted";
+      denied: "denied";
+    }>>;
+    origin: z.ZodObject<{
+      signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+      operator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    work: z.ZodObject<{
+      title: z.ZodString;
+      input: z.ZodCustom<JsonValue, JsonValue>;
+      completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+      workflow: z.core.$ZodBranded<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+      }, z.core.$strict>, "WorkflowBinding", "out">;
+      route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+      }, z.core.$strict>, "AgentRouteBinding", "out">>;
+    }, z.core.$strict>;
+    workResult: z.ZodOptional<z.ZodObject<{
+      output: z.ZodCustom<JsonValue, JsonValue>;
+      completedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+    workflowPhase: z.ZodOptional<z.ZodString>;
+    rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+    replyTo: z.ZodObject<{
+      channel: z.ZodString;
+      address: z.ZodString;
+    }, z.core.$strict>;
+    pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+    failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+    attempt: z.ZodNumber;
+    execution: z.ZodOptional<z.ZodObject<{
+      provider: z.ZodString;
+      sessionId: z.ZodString;
+      environmentId: z.ZodOptional<z.ZodString>;
+      harness: z.ZodOptional<z.ZodString>;
+      traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+    stalledAt: z.ZodOptional<z.ZodISODateTime>;
+    stalledReason: z.ZodOptional<z.ZodString>;
+    needsHumanAction: z.ZodOptional<z.ZodString>;
+    needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+    reservedUsd: z.ZodOptional<z.ZodNumber>;
+    reservedAt: z.ZodOptional<z.ZodISODateTime>;
+    usage: z.ZodOptional<z.ZodObject<{
+      costUsd: z.ZodNumber;
+      inputTokens: z.ZodNumber;
+      outputTokens: z.ZodNumber;
+      cacheReadTokens: z.ZodNumber;
+      cacheWriteTokens: z.ZodNumber;
+      steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strict>>;
+    settledUsd: z.ZodOptional<z.ZodNumber>;
+    question: z.ZodOptional<z.ZodObject<{
+      text: z.ZodString;
+      options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+      closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+      answer: z.ZodOptional<z.ZodString>;
+      answeredBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+    changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+    reportRef: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+  }, z.core.$strict>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<Task, {
+    schemaVersion: 1;
+    id: string;
+    repositoryIds: readonly [string, ...string[]];
+    kind: unknown;
+    state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    origin: {
+      signalId?: string | undefined;
+      operator?: string | undefined;
+    };
+    work: {
+      title: string;
+      input: JsonValue;
+      completionCriteria: readonly string[];
+      workflow: {
+        id: string;
+        version: number;
+      };
+      route?: {
+        id: string;
+        version: number;
+      } | undefined;
+    };
+    rootTaskId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    attempt: number;
+    createdAt: string;
+    updatedAt: string;
+    model?: string | undefined;
+    area?: string | undefined;
+    approval?: "required" | "granted" | "denied" | undefined;
+    workResult?: {
+      output: JsonValue;
+      completedAt: string;
+    } | undefined;
+    waitingForMessages?: boolean | undefined;
+    workflowPhase?: string | undefined;
+    parentTaskId?: string | undefined;
+    parentTaskAttempt?: number | undefined;
+    pendingCommunicationReceiptIds?: readonly string[] | undefined;
+    failureReceiptId?: string | undefined;
+    execution?: {
+      provider: string;
+      sessionId: string;
+      environmentId?: string | undefined;
+      harness?: string | undefined;
+      traceId?: string | undefined;
+    } | undefined;
+    lastProgressAt?: string | undefined;
+    stalledAt?: string | undefined;
+    stalledReason?: string | undefined;
+    needsHumanAction?: string | undefined;
+    needsHumanNotifiedAt?: string | undefined;
+    reservedUsd?: number | undefined;
+    reservedAt?: string | undefined;
+    usage?: {
+      costUsd: number;
+      inputTokens: number;
+      outputTokens: number;
+      cacheReadTokens: number;
+      cacheWriteTokens: number;
+      steps: Record<string, number>;
+    } | undefined;
+    settledUsd?: number | undefined;
+    question?: {
+      text: string;
+      options: readonly string[];
+      closingOptions?: readonly string[] | undefined;
+      answer?: string | undefined;
+      answeredBy?: string | undefined;
+    } | undefined;
+    questionTaskId?: string | undefined;
+    answerEventIds?: readonly string[] | undefined;
+    changeId?: string | undefined;
+    reportRef?: string | undefined;
+  }, z.core.$ZodTypeInternals<Task, {
+    schemaVersion: 1;
+    id: string;
+    repositoryIds: readonly [string, ...string[]];
+    kind: unknown;
+    state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    origin: {
+      signalId?: string | undefined;
+      operator?: string | undefined;
+    };
+    work: {
+      title: string;
+      input: JsonValue;
+      completionCriteria: readonly string[];
+      workflow: {
+        id: string;
+        version: number;
+      };
+      route?: {
+        id: string;
+        version: number;
+      } | undefined;
+    };
+    rootTaskId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    attempt: number;
+    createdAt: string;
+    updatedAt: string;
+    model?: string | undefined;
+    area?: string | undefined;
+    approval?: "required" | "granted" | "denied" | undefined;
+    workResult?: {
+      output: JsonValue;
+      completedAt: string;
+    } | undefined;
+    waitingForMessages?: boolean | undefined;
+    workflowPhase?: string | undefined;
+    parentTaskId?: string | undefined;
+    parentTaskAttempt?: number | undefined;
+    pendingCommunicationReceiptIds?: readonly string[] | undefined;
+    failureReceiptId?: string | undefined;
+    execution?: {
+      provider: string;
+      sessionId: string;
+      environmentId?: string | undefined;
+      harness?: string | undefined;
+      traceId?: string | undefined;
+    } | undefined;
+    lastProgressAt?: string | undefined;
+    stalledAt?: string | undefined;
+    stalledReason?: string | undefined;
+    needsHumanAction?: string | undefined;
+    needsHumanNotifiedAt?: string | undefined;
+    reservedUsd?: number | undefined;
+    reservedAt?: string | undefined;
+    usage?: {
+      costUsd: number;
+      inputTokens: number;
+      outputTokens: number;
+      cacheReadTokens: number;
+      cacheWriteTokens: number;
+      steps: Record<string, number>;
+    } | undefined;
+    settledUsd?: number | undefined;
+    question?: {
+      text: string;
+      options: readonly string[];
+      closingOptions?: readonly string[] | undefined;
+      answer?: string | undefined;
+      answeredBy?: string | undefined;
+    } | undefined;
+    questionTaskId?: string | undefined;
+    answerEventIds?: readonly string[] | undefined;
+    changeId?: string | undefined;
+    reportRef?: string | undefined;
+  }>>>;
+  dependencyTaskIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>>>;
+  execution: z.ZodNullable<z.ZodObject<{
+    provider: z.ZodString;
+    sessionId: z.ZodString;
+    environmentId: z.ZodOptional<z.ZodString>;
+    harness: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  activeAgent: z.ZodOptional<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
+  prUrl: z.ZodOptional<z.ZodString>;
+  attention: z.ZodOptional<z.ZodEnum<{
+    stalled: "stalled";
+    failed: "failed";
+    question: "question";
+    review: "review";
+    conversation: "conversation";
+  }>>;
+  canFollowUp: z.ZodOptional<z.ZodBoolean>;
+  hasWorkflowFailure: z.ZodOptional<z.ZodBoolean>;
+  canCancel: z.ZodOptional<z.ZodBoolean>;
+  history: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    taskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    agent: z.ZodString;
+    message: z.ZodString;
+    attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+      id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+      filename: z.ZodString;
+      mediaType: z.ZodEnum<{
+        "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
+        "image/webp": "image/webp";
+      }>;
+      size: z.ZodNumber;
+    }, z.core.$strict>>>>;
+    execution: z.ZodObject<{
+      provider: z.ZodString;
+      sessionId: z.ZodString;
+      environmentId: z.ZodOptional<z.ZodString>;
+      harness: z.ZodOptional<z.ZodString>;
+      traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+  }, z.core.$strict>>>>;
+  relatedTasks: z.ZodOptional<z.ZodReadonly<z.ZodArray<Omit<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+    kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+    model: z.ZodOptional<z.ZodString>;
+    area: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<{
+      queued: "queued";
+      running: "running";
+      stalled: "stalled";
+      verifying: "verifying";
+      succeeded: "succeeded";
+      failed: "failed";
+      needs_human: "needs_human";
+      cancelled: "cancelled";
+    }>;
+    approval: z.ZodOptional<z.ZodEnum<{
+      required: "required";
+      granted: "granted";
+      denied: "denied";
+    }>>;
+    origin: z.ZodObject<{
+      signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+      operator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    work: z.ZodObject<{
+      title: z.ZodString;
+      input: z.ZodCustom<JsonValue, JsonValue>;
+      completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+      workflow: z.core.$ZodBranded<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+      }, z.core.$strict>, "WorkflowBinding", "out">;
+      route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+      }, z.core.$strict>, "AgentRouteBinding", "out">>;
+    }, z.core.$strict>;
+    workResult: z.ZodOptional<z.ZodObject<{
+      output: z.ZodCustom<JsonValue, JsonValue>;
+      completedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+    workflowPhase: z.ZodOptional<z.ZodString>;
+    rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+    replyTo: z.ZodObject<{
+      channel: z.ZodString;
+      address: z.ZodString;
+    }, z.core.$strict>;
+    pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+    failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+    attempt: z.ZodNumber;
+    execution: z.ZodOptional<z.ZodObject<{
+      provider: z.ZodString;
+      sessionId: z.ZodString;
+      environmentId: z.ZodOptional<z.ZodString>;
+      harness: z.ZodOptional<z.ZodString>;
+      traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+    stalledAt: z.ZodOptional<z.ZodISODateTime>;
+    stalledReason: z.ZodOptional<z.ZodString>;
+    needsHumanAction: z.ZodOptional<z.ZodString>;
+    needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+    reservedUsd: z.ZodOptional<z.ZodNumber>;
+    reservedAt: z.ZodOptional<z.ZodISODateTime>;
+    usage: z.ZodOptional<z.ZodObject<{
+      costUsd: z.ZodNumber;
+      inputTokens: z.ZodNumber;
+      outputTokens: z.ZodNumber;
+      cacheReadTokens: z.ZodNumber;
+      cacheWriteTokens: z.ZodNumber;
+      steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strict>>;
+    settledUsd: z.ZodOptional<z.ZodNumber>;
+    question: z.ZodOptional<z.ZodObject<{
+      text: z.ZodString;
+      options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+      closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+      answer: z.ZodOptional<z.ZodString>;
+      answeredBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+    changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+    reportRef: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+  }, z.core.$strict>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<Task, {
+    schemaVersion: 1;
+    id: string;
+    repositoryIds: readonly [string, ...string[]];
+    kind: unknown;
+    state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    origin: {
+      signalId?: string | undefined;
+      operator?: string | undefined;
+    };
+    work: {
+      title: string;
+      input: JsonValue;
+      completionCriteria: readonly string[];
+      workflow: {
+        id: string;
+        version: number;
+      };
+      route?: {
+        id: string;
+        version: number;
+      } | undefined;
+    };
+    rootTaskId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    attempt: number;
+    createdAt: string;
+    updatedAt: string;
+    model?: string | undefined;
+    area?: string | undefined;
+    approval?: "required" | "granted" | "denied" | undefined;
+    workResult?: {
+      output: JsonValue;
+      completedAt: string;
+    } | undefined;
+    waitingForMessages?: boolean | undefined;
+    workflowPhase?: string | undefined;
+    parentTaskId?: string | undefined;
+    parentTaskAttempt?: number | undefined;
+    pendingCommunicationReceiptIds?: readonly string[] | undefined;
+    failureReceiptId?: string | undefined;
+    execution?: {
+      provider: string;
+      sessionId: string;
+      environmentId?: string | undefined;
+      harness?: string | undefined;
+      traceId?: string | undefined;
+    } | undefined;
+    lastProgressAt?: string | undefined;
+    stalledAt?: string | undefined;
+    stalledReason?: string | undefined;
+    needsHumanAction?: string | undefined;
+    needsHumanNotifiedAt?: string | undefined;
+    reservedUsd?: number | undefined;
+    reservedAt?: string | undefined;
+    usage?: {
+      costUsd: number;
+      inputTokens: number;
+      outputTokens: number;
+      cacheReadTokens: number;
+      cacheWriteTokens: number;
+      steps: Record<string, number>;
+    } | undefined;
+    settledUsd?: number | undefined;
+    question?: {
+      text: string;
+      options: readonly string[];
+      closingOptions?: readonly string[] | undefined;
+      answer?: string | undefined;
+      answeredBy?: string | undefined;
+    } | undefined;
+    questionTaskId?: string | undefined;
+    answerEventIds?: readonly string[] | undefined;
+    changeId?: string | undefined;
+    reportRef?: string | undefined;
+  }, z.core.$ZodTypeInternals<Task, {
+    schemaVersion: 1;
+    id: string;
+    repositoryIds: readonly [string, ...string[]];
+    kind: unknown;
+    state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    origin: {
+      signalId?: string | undefined;
+      operator?: string | undefined;
+    };
+    work: {
+      title: string;
+      input: JsonValue;
+      completionCriteria: readonly string[];
+      workflow: {
+        id: string;
+        version: number;
+      };
+      route?: {
+        id: string;
+        version: number;
+      } | undefined;
+    };
+    rootTaskId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    attempt: number;
+    createdAt: string;
+    updatedAt: string;
+    model?: string | undefined;
+    area?: string | undefined;
+    approval?: "required" | "granted" | "denied" | undefined;
+    workResult?: {
+      output: JsonValue;
+      completedAt: string;
+    } | undefined;
+    waitingForMessages?: boolean | undefined;
+    workflowPhase?: string | undefined;
+    parentTaskId?: string | undefined;
+    parentTaskAttempt?: number | undefined;
+    pendingCommunicationReceiptIds?: readonly string[] | undefined;
+    failureReceiptId?: string | undefined;
+    execution?: {
+      provider: string;
+      sessionId: string;
+      environmentId?: string | undefined;
+      harness?: string | undefined;
+      traceId?: string | undefined;
+    } | undefined;
+    lastProgressAt?: string | undefined;
+    stalledAt?: string | undefined;
+    stalledReason?: string | undefined;
+    needsHumanAction?: string | undefined;
+    needsHumanNotifiedAt?: string | undefined;
+    reservedUsd?: number | undefined;
+    reservedAt?: string | undefined;
+    usage?: {
+      costUsd: number;
+      inputTokens: number;
+      outputTokens: number;
+      cacheReadTokens: number;
+      cacheWriteTokens: number;
+      steps: Record<string, number>;
+    } | undefined;
+    settledUsd?: number | undefined;
+    question?: {
+      text: string;
+      options: readonly string[];
+      closingOptions?: readonly string[] | undefined;
+      answer?: string | undefined;
+      answeredBy?: string | undefined;
+    } | undefined;
+    questionTaskId?: string | undefined;
+    answerEventIds?: readonly string[] | undefined;
+    changeId?: string | undefined;
+    reportRef?: string | undefined;
+  }>>>>>;
+  question: z.ZodNullable<Omit<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+    kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+    model: z.ZodOptional<z.ZodString>;
+    area: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<{
+      queued: "queued";
+      running: "running";
+      stalled: "stalled";
+      verifying: "verifying";
+      succeeded: "succeeded";
+      failed: "failed";
+      needs_human: "needs_human";
+      cancelled: "cancelled";
+    }>;
+    approval: z.ZodOptional<z.ZodEnum<{
+      required: "required";
+      granted: "granted";
+      denied: "denied";
+    }>>;
+    origin: z.ZodObject<{
+      signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+      operator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    work: z.ZodObject<{
+      title: z.ZodString;
+      input: z.ZodCustom<JsonValue, JsonValue>;
+      completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+      workflow: z.core.$ZodBranded<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+      }, z.core.$strict>, "WorkflowBinding", "out">;
+      route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+      }, z.core.$strict>, "AgentRouteBinding", "out">>;
+    }, z.core.$strict>;
+    workResult: z.ZodOptional<z.ZodObject<{
+      output: z.ZodCustom<JsonValue, JsonValue>;
+      completedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+    workflowPhase: z.ZodOptional<z.ZodString>;
+    rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+    parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+    replyTo: z.ZodObject<{
+      channel: z.ZodString;
+      address: z.ZodString;
+    }, z.core.$strict>;
+    pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+    failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+    attempt: z.ZodNumber;
+    execution: z.ZodOptional<z.ZodObject<{
+      provider: z.ZodString;
+      sessionId: z.ZodString;
+      environmentId: z.ZodOptional<z.ZodString>;
+      harness: z.ZodOptional<z.ZodString>;
+      traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+    stalledAt: z.ZodOptional<z.ZodISODateTime>;
+    stalledReason: z.ZodOptional<z.ZodString>;
+    needsHumanAction: z.ZodOptional<z.ZodString>;
+    needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+    reservedUsd: z.ZodOptional<z.ZodNumber>;
+    reservedAt: z.ZodOptional<z.ZodISODateTime>;
+    usage: z.ZodOptional<z.ZodObject<{
+      costUsd: z.ZodNumber;
+      inputTokens: z.ZodNumber;
+      outputTokens: z.ZodNumber;
+      cacheReadTokens: z.ZodNumber;
+      cacheWriteTokens: z.ZodNumber;
+      steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strict>>;
+    settledUsd: z.ZodOptional<z.ZodNumber>;
+    question: z.ZodOptional<z.ZodObject<{
+      text: z.ZodString;
+      options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+      closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+      answer: z.ZodOptional<z.ZodString>;
+      answeredBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+    answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+    changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+    reportRef: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+  }, z.core.$strict>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<Task, {
+    schemaVersion: 1;
+    id: string;
+    repositoryIds: readonly [string, ...string[]];
+    kind: unknown;
+    state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    origin: {
+      signalId?: string | undefined;
+      operator?: string | undefined;
+    };
+    work: {
+      title: string;
+      input: JsonValue;
+      completionCriteria: readonly string[];
+      workflow: {
+        id: string;
+        version: number;
+      };
+      route?: {
+        id: string;
+        version: number;
+      } | undefined;
+    };
+    rootTaskId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    attempt: number;
+    createdAt: string;
+    updatedAt: string;
+    model?: string | undefined;
+    area?: string | undefined;
+    approval?: "required" | "granted" | "denied" | undefined;
+    workResult?: {
+      output: JsonValue;
+      completedAt: string;
+    } | undefined;
+    waitingForMessages?: boolean | undefined;
+    workflowPhase?: string | undefined;
+    parentTaskId?: string | undefined;
+    parentTaskAttempt?: number | undefined;
+    pendingCommunicationReceiptIds?: readonly string[] | undefined;
+    failureReceiptId?: string | undefined;
+    execution?: {
+      provider: string;
+      sessionId: string;
+      environmentId?: string | undefined;
+      harness?: string | undefined;
+      traceId?: string | undefined;
+    } | undefined;
+    lastProgressAt?: string | undefined;
+    stalledAt?: string | undefined;
+    stalledReason?: string | undefined;
+    needsHumanAction?: string | undefined;
+    needsHumanNotifiedAt?: string | undefined;
+    reservedUsd?: number | undefined;
+    reservedAt?: string | undefined;
+    usage?: {
+      costUsd: number;
+      inputTokens: number;
+      outputTokens: number;
+      cacheReadTokens: number;
+      cacheWriteTokens: number;
+      steps: Record<string, number>;
+    } | undefined;
+    settledUsd?: number | undefined;
+    question?: {
+      text: string;
+      options: readonly string[];
+      closingOptions?: readonly string[] | undefined;
+      answer?: string | undefined;
+      answeredBy?: string | undefined;
+    } | undefined;
+    questionTaskId?: string | undefined;
+    answerEventIds?: readonly string[] | undefined;
+    changeId?: string | undefined;
+    reportRef?: string | undefined;
+  }, z.core.$ZodTypeInternals<Task, {
+    schemaVersion: 1;
+    id: string;
+    repositoryIds: readonly [string, ...string[]];
+    kind: unknown;
+    state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    origin: {
+      signalId?: string | undefined;
+      operator?: string | undefined;
+    };
+    work: {
+      title: string;
+      input: JsonValue;
+      completionCriteria: readonly string[];
+      workflow: {
+        id: string;
+        version: number;
+      };
+      route?: {
+        id: string;
+        version: number;
+      } | undefined;
+    };
+    rootTaskId: string;
+    replyTo: {
+      channel: string;
+      address: string;
+    };
+    attempt: number;
+    createdAt: string;
+    updatedAt: string;
+    model?: string | undefined;
+    area?: string | undefined;
+    approval?: "required" | "granted" | "denied" | undefined;
+    workResult?: {
+      output: JsonValue;
+      completedAt: string;
+    } | undefined;
+    waitingForMessages?: boolean | undefined;
+    workflowPhase?: string | undefined;
+    parentTaskId?: string | undefined;
+    parentTaskAttempt?: number | undefined;
+    pendingCommunicationReceiptIds?: readonly string[] | undefined;
+    failureReceiptId?: string | undefined;
+    execution?: {
+      provider: string;
+      sessionId: string;
+      environmentId?: string | undefined;
+      harness?: string | undefined;
+      traceId?: string | undefined;
+    } | undefined;
+    lastProgressAt?: string | undefined;
+    stalledAt?: string | undefined;
+    stalledReason?: string | undefined;
+    needsHumanAction?: string | undefined;
+    needsHumanNotifiedAt?: string | undefined;
+    reservedUsd?: number | undefined;
+    reservedAt?: string | undefined;
+    usage?: {
+      costUsd: number;
+      inputTokens: number;
+      outputTokens: number;
+      cacheReadTokens: number;
+      cacheWriteTokens: number;
+      steps: Record<string, number>;
+    } | undefined;
+    settledUsd?: number | undefined;
+    question?: {
+      text: string;
+      options: readonly string[];
+      closingOptions?: readonly string[] | undefined;
+      answer?: string | undefined;
+      answeredBy?: string | undefined;
+    } | undefined;
+    questionTaskId?: string | undefined;
+    answerEventIds?: readonly string[] | undefined;
+    changeId?: string | undefined;
+    reportRef?: string | undefined;
+  }>>>;
+}, z.core.$strict>;
+/** The current operator-facing projection of a Factory session. */
+type SessionView = z.infer<typeof sessionViewSchema>;
+/** Validates a cursor-paginated page of operator-facing sessions. */
+declare const sessionPageSchema: z.ZodObject<{
+  sessions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    session: z.ZodType<AgentSession, unknown, z.core.$ZodTypeInternals<AgentSession, unknown>>;
+    task: z.ZodNullable<Omit<z.ZodObject<{
+      schemaVersion: z.ZodLiteral<1>;
+      id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+      repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+      kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+      model: z.ZodOptional<z.ZodString>;
+      area: z.ZodOptional<z.ZodString>;
+      state: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        stalled: "stalled";
+        verifying: "verifying";
+        succeeded: "succeeded";
+        failed: "failed";
+        needs_human: "needs_human";
+        cancelled: "cancelled";
+      }>;
+      approval: z.ZodOptional<z.ZodEnum<{
+        required: "required";
+        granted: "granted";
+        denied: "denied";
+      }>>;
+      origin: z.ZodObject<{
+        signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+        operator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+      work: z.ZodObject<{
+        title: z.ZodString;
+        input: z.ZodCustom<JsonValue, JsonValue>;
+        completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        workflow: z.core.$ZodBranded<z.ZodObject<{
+          id: z.ZodString;
+          version: z.ZodNumber;
+        }, z.core.$strict>, "WorkflowBinding", "out">;
+        route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+          id: z.ZodString;
+          version: z.ZodNumber;
+        }, z.core.$strict>, "AgentRouteBinding", "out">>;
+      }, z.core.$strict>;
+      workResult: z.ZodOptional<z.ZodObject<{
+        output: z.ZodCustom<JsonValue, JsonValue>;
+        completedAt: z.ZodISODateTime;
+      }, z.core.$strict>>;
+      waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+      workflowPhase: z.ZodOptional<z.ZodString>;
+      rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+      parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+      replyTo: z.ZodObject<{
+        channel: z.ZodString;
+        address: z.ZodString;
+      }, z.core.$strict>;
+      pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+      failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+      attempt: z.ZodNumber;
+      execution: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        sessionId: z.ZodString;
+        environmentId: z.ZodOptional<z.ZodString>;
+        harness: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+      lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+      stalledAt: z.ZodOptional<z.ZodISODateTime>;
+      stalledReason: z.ZodOptional<z.ZodString>;
+      needsHumanAction: z.ZodOptional<z.ZodString>;
+      needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+      reservedUsd: z.ZodOptional<z.ZodNumber>;
+      reservedAt: z.ZodOptional<z.ZodISODateTime>;
+      usage: z.ZodOptional<z.ZodObject<{
+        costUsd: z.ZodNumber;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+        cacheWriteTokens: z.ZodNumber;
+        steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+      }, z.core.$strict>>;
+      settledUsd: z.ZodOptional<z.ZodNumber>;
+      question: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        answer: z.ZodOptional<z.ZodString>;
+        answeredBy: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+      questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+      changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+      reportRef: z.ZodOptional<z.ZodString>;
+      createdAt: z.ZodISODateTime;
+      updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<Task, {
+      schemaVersion: 1;
+      id: string;
+      repositoryIds: readonly [string, ...string[]];
+      kind: unknown;
+      state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      origin: {
+        signalId?: string | undefined;
+        operator?: string | undefined;
+      };
+      work: {
+        title: string;
+        input: JsonValue;
+        completionCriteria: readonly string[];
+        workflow: {
+          id: string;
+          version: number;
+        };
+        route?: {
+          id: string;
+          version: number;
+        } | undefined;
+      };
+      rootTaskId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      attempt: number;
+      createdAt: string;
+      updatedAt: string;
+      model?: string | undefined;
+      area?: string | undefined;
+      approval?: "required" | "granted" | "denied" | undefined;
+      workResult?: {
+        output: JsonValue;
+        completedAt: string;
+      } | undefined;
+      waitingForMessages?: boolean | undefined;
+      workflowPhase?: string | undefined;
+      parentTaskId?: string | undefined;
+      parentTaskAttempt?: number | undefined;
+      pendingCommunicationReceiptIds?: readonly string[] | undefined;
+      failureReceiptId?: string | undefined;
+      execution?: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      } | undefined;
+      lastProgressAt?: string | undefined;
+      stalledAt?: string | undefined;
+      stalledReason?: string | undefined;
+      needsHumanAction?: string | undefined;
+      needsHumanNotifiedAt?: string | undefined;
+      reservedUsd?: number | undefined;
+      reservedAt?: string | undefined;
+      usage?: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        steps: Record<string, number>;
+      } | undefined;
+      settledUsd?: number | undefined;
+      question?: {
+        text: string;
+        options: readonly string[];
+        closingOptions?: readonly string[] | undefined;
+        answer?: string | undefined;
+        answeredBy?: string | undefined;
+      } | undefined;
+      questionTaskId?: string | undefined;
+      answerEventIds?: readonly string[] | undefined;
+      changeId?: string | undefined;
+      reportRef?: string | undefined;
+    }, z.core.$ZodTypeInternals<Task, {
+      schemaVersion: 1;
+      id: string;
+      repositoryIds: readonly [string, ...string[]];
+      kind: unknown;
+      state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      origin: {
+        signalId?: string | undefined;
+        operator?: string | undefined;
+      };
+      work: {
+        title: string;
+        input: JsonValue;
+        completionCriteria: readonly string[];
+        workflow: {
+          id: string;
+          version: number;
+        };
+        route?: {
+          id: string;
+          version: number;
+        } | undefined;
+      };
+      rootTaskId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      attempt: number;
+      createdAt: string;
+      updatedAt: string;
+      model?: string | undefined;
+      area?: string | undefined;
+      approval?: "required" | "granted" | "denied" | undefined;
+      workResult?: {
+        output: JsonValue;
+        completedAt: string;
+      } | undefined;
+      waitingForMessages?: boolean | undefined;
+      workflowPhase?: string | undefined;
+      parentTaskId?: string | undefined;
+      parentTaskAttempt?: number | undefined;
+      pendingCommunicationReceiptIds?: readonly string[] | undefined;
+      failureReceiptId?: string | undefined;
+      execution?: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      } | undefined;
+      lastProgressAt?: string | undefined;
+      stalledAt?: string | undefined;
+      stalledReason?: string | undefined;
+      needsHumanAction?: string | undefined;
+      needsHumanNotifiedAt?: string | undefined;
+      reservedUsd?: number | undefined;
+      reservedAt?: string | undefined;
+      usage?: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        steps: Record<string, number>;
+      } | undefined;
+      settledUsd?: number | undefined;
+      question?: {
+        text: string;
+        options: readonly string[];
+        closingOptions?: readonly string[] | undefined;
+        answer?: string | undefined;
+        answeredBy?: string | undefined;
+      } | undefined;
+      questionTaskId?: string | undefined;
+      answerEventIds?: readonly string[] | undefined;
+      changeId?: string | undefined;
+      reportRef?: string | undefined;
+    }>>>;
+    dependencyTaskIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>>>;
+    execution: z.ZodNullable<z.ZodObject<{
+      provider: z.ZodString;
+      sessionId: z.ZodString;
+      environmentId: z.ZodOptional<z.ZodString>;
+      harness: z.ZodOptional<z.ZodString>;
+      traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    activeAgent: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    prUrl: z.ZodOptional<z.ZodString>;
+    attention: z.ZodOptional<z.ZodEnum<{
+      stalled: "stalled";
+      failed: "failed";
+      question: "question";
+      review: "review";
+      conversation: "conversation";
+    }>>;
+    canFollowUp: z.ZodOptional<z.ZodBoolean>;
+    hasWorkflowFailure: z.ZodOptional<z.ZodBoolean>;
+    canCancel: z.ZodOptional<z.ZodBoolean>;
+    history: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+      taskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      agent: z.ZodString;
+      message: z.ZodString;
+      attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+        filename: z.ZodString;
+        mediaType: z.ZodEnum<{
+          "image/png": "image/png";
+          "image/jpeg": "image/jpeg";
+          "image/webp": "image/webp";
+        }>;
+        size: z.ZodNumber;
+      }, z.core.$strict>>>>;
+      execution: z.ZodObject<{
+        provider: z.ZodString;
+        sessionId: z.ZodString;
+        environmentId: z.ZodOptional<z.ZodString>;
+        harness: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+    }, z.core.$strict>>>>;
+    relatedTasks: z.ZodOptional<z.ZodReadonly<z.ZodArray<Omit<z.ZodObject<{
+      schemaVersion: z.ZodLiteral<1>;
+      id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+      repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+      kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+      model: z.ZodOptional<z.ZodString>;
+      area: z.ZodOptional<z.ZodString>;
+      state: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        stalled: "stalled";
+        verifying: "verifying";
+        succeeded: "succeeded";
+        failed: "failed";
+        needs_human: "needs_human";
+        cancelled: "cancelled";
+      }>;
+      approval: z.ZodOptional<z.ZodEnum<{
+        required: "required";
+        granted: "granted";
+        denied: "denied";
+      }>>;
+      origin: z.ZodObject<{
+        signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+        operator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+      work: z.ZodObject<{
+        title: z.ZodString;
+        input: z.ZodCustom<JsonValue, JsonValue>;
+        completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        workflow: z.core.$ZodBranded<z.ZodObject<{
+          id: z.ZodString;
+          version: z.ZodNumber;
+        }, z.core.$strict>, "WorkflowBinding", "out">;
+        route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+          id: z.ZodString;
+          version: z.ZodNumber;
+        }, z.core.$strict>, "AgentRouteBinding", "out">>;
+      }, z.core.$strict>;
+      workResult: z.ZodOptional<z.ZodObject<{
+        output: z.ZodCustom<JsonValue, JsonValue>;
+        completedAt: z.ZodISODateTime;
+      }, z.core.$strict>>;
+      waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+      workflowPhase: z.ZodOptional<z.ZodString>;
+      rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+      parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+      replyTo: z.ZodObject<{
+        channel: z.ZodString;
+        address: z.ZodString;
+      }, z.core.$strict>;
+      pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+      failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+      attempt: z.ZodNumber;
+      execution: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        sessionId: z.ZodString;
+        environmentId: z.ZodOptional<z.ZodString>;
+        harness: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+      lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+      stalledAt: z.ZodOptional<z.ZodISODateTime>;
+      stalledReason: z.ZodOptional<z.ZodString>;
+      needsHumanAction: z.ZodOptional<z.ZodString>;
+      needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+      reservedUsd: z.ZodOptional<z.ZodNumber>;
+      reservedAt: z.ZodOptional<z.ZodISODateTime>;
+      usage: z.ZodOptional<z.ZodObject<{
+        costUsd: z.ZodNumber;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+        cacheWriteTokens: z.ZodNumber;
+        steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+      }, z.core.$strict>>;
+      settledUsd: z.ZodOptional<z.ZodNumber>;
+      question: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        answer: z.ZodOptional<z.ZodString>;
+        answeredBy: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+      questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+      changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+      reportRef: z.ZodOptional<z.ZodString>;
+      createdAt: z.ZodISODateTime;
+      updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<Task, {
+      schemaVersion: 1;
+      id: string;
+      repositoryIds: readonly [string, ...string[]];
+      kind: unknown;
+      state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      origin: {
+        signalId?: string | undefined;
+        operator?: string | undefined;
+      };
+      work: {
+        title: string;
+        input: JsonValue;
+        completionCriteria: readonly string[];
+        workflow: {
+          id: string;
+          version: number;
+        };
+        route?: {
+          id: string;
+          version: number;
+        } | undefined;
+      };
+      rootTaskId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      attempt: number;
+      createdAt: string;
+      updatedAt: string;
+      model?: string | undefined;
+      area?: string | undefined;
+      approval?: "required" | "granted" | "denied" | undefined;
+      workResult?: {
+        output: JsonValue;
+        completedAt: string;
+      } | undefined;
+      waitingForMessages?: boolean | undefined;
+      workflowPhase?: string | undefined;
+      parentTaskId?: string | undefined;
+      parentTaskAttempt?: number | undefined;
+      pendingCommunicationReceiptIds?: readonly string[] | undefined;
+      failureReceiptId?: string | undefined;
+      execution?: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      } | undefined;
+      lastProgressAt?: string | undefined;
+      stalledAt?: string | undefined;
+      stalledReason?: string | undefined;
+      needsHumanAction?: string | undefined;
+      needsHumanNotifiedAt?: string | undefined;
+      reservedUsd?: number | undefined;
+      reservedAt?: string | undefined;
+      usage?: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        steps: Record<string, number>;
+      } | undefined;
+      settledUsd?: number | undefined;
+      question?: {
+        text: string;
+        options: readonly string[];
+        closingOptions?: readonly string[] | undefined;
+        answer?: string | undefined;
+        answeredBy?: string | undefined;
+      } | undefined;
+      questionTaskId?: string | undefined;
+      answerEventIds?: readonly string[] | undefined;
+      changeId?: string | undefined;
+      reportRef?: string | undefined;
+    }, z.core.$ZodTypeInternals<Task, {
+      schemaVersion: 1;
+      id: string;
+      repositoryIds: readonly [string, ...string[]];
+      kind: unknown;
+      state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      origin: {
+        signalId?: string | undefined;
+        operator?: string | undefined;
+      };
+      work: {
+        title: string;
+        input: JsonValue;
+        completionCriteria: readonly string[];
+        workflow: {
+          id: string;
+          version: number;
+        };
+        route?: {
+          id: string;
+          version: number;
+        } | undefined;
+      };
+      rootTaskId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      attempt: number;
+      createdAt: string;
+      updatedAt: string;
+      model?: string | undefined;
+      area?: string | undefined;
+      approval?: "required" | "granted" | "denied" | undefined;
+      workResult?: {
+        output: JsonValue;
+        completedAt: string;
+      } | undefined;
+      waitingForMessages?: boolean | undefined;
+      workflowPhase?: string | undefined;
+      parentTaskId?: string | undefined;
+      parentTaskAttempt?: number | undefined;
+      pendingCommunicationReceiptIds?: readonly string[] | undefined;
+      failureReceiptId?: string | undefined;
+      execution?: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      } | undefined;
+      lastProgressAt?: string | undefined;
+      stalledAt?: string | undefined;
+      stalledReason?: string | undefined;
+      needsHumanAction?: string | undefined;
+      needsHumanNotifiedAt?: string | undefined;
+      reservedUsd?: number | undefined;
+      reservedAt?: string | undefined;
+      usage?: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        steps: Record<string, number>;
+      } | undefined;
+      settledUsd?: number | undefined;
+      question?: {
+        text: string;
+        options: readonly string[];
+        closingOptions?: readonly string[] | undefined;
+        answer?: string | undefined;
+        answeredBy?: string | undefined;
+      } | undefined;
+      questionTaskId?: string | undefined;
+      answerEventIds?: readonly string[] | undefined;
+      changeId?: string | undefined;
+      reportRef?: string | undefined;
+    }>>>>>;
+    question: z.ZodNullable<Omit<z.ZodObject<{
+      schemaVersion: z.ZodLiteral<1>;
+      id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+      repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+      kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+      model: z.ZodOptional<z.ZodString>;
+      area: z.ZodOptional<z.ZodString>;
+      state: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        stalled: "stalled";
+        verifying: "verifying";
+        succeeded: "succeeded";
+        failed: "failed";
+        needs_human: "needs_human";
+        cancelled: "cancelled";
+      }>;
+      approval: z.ZodOptional<z.ZodEnum<{
+        required: "required";
+        granted: "granted";
+        denied: "denied";
+      }>>;
+      origin: z.ZodObject<{
+        signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+        operator: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+      work: z.ZodObject<{
+        title: z.ZodString;
+        input: z.ZodCustom<JsonValue, JsonValue>;
+        completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        workflow: z.core.$ZodBranded<z.ZodObject<{
+          id: z.ZodString;
+          version: z.ZodNumber;
+        }, z.core.$strict>, "WorkflowBinding", "out">;
+        route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+          id: z.ZodString;
+          version: z.ZodNumber;
+        }, z.core.$strict>, "AgentRouteBinding", "out">>;
+      }, z.core.$strict>;
+      workResult: z.ZodOptional<z.ZodObject<{
+        output: z.ZodCustom<JsonValue, JsonValue>;
+        completedAt: z.ZodISODateTime;
+      }, z.core.$strict>>;
+      waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+      workflowPhase: z.ZodOptional<z.ZodString>;
+      rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+      parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+      replyTo: z.ZodObject<{
+        channel: z.ZodString;
+        address: z.ZodString;
+      }, z.core.$strict>;
+      pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+      failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+      attempt: z.ZodNumber;
+      execution: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        sessionId: z.ZodString;
+        environmentId: z.ZodOptional<z.ZodString>;
+        harness: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+      lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+      stalledAt: z.ZodOptional<z.ZodISODateTime>;
+      stalledReason: z.ZodOptional<z.ZodString>;
+      needsHumanAction: z.ZodOptional<z.ZodString>;
+      needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+      reservedUsd: z.ZodOptional<z.ZodNumber>;
+      reservedAt: z.ZodOptional<z.ZodISODateTime>;
+      usage: z.ZodOptional<z.ZodObject<{
+        costUsd: z.ZodNumber;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+        cacheWriteTokens: z.ZodNumber;
+        steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+      }, z.core.$strict>>;
+      settledUsd: z.ZodOptional<z.ZodNumber>;
+      question: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        answer: z.ZodOptional<z.ZodString>;
+        answeredBy: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+      questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+      answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+      changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+      reportRef: z.ZodOptional<z.ZodString>;
+      createdAt: z.ZodISODateTime;
+      updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<Task, {
+      schemaVersion: 1;
+      id: string;
+      repositoryIds: readonly [string, ...string[]];
+      kind: unknown;
+      state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      origin: {
+        signalId?: string | undefined;
+        operator?: string | undefined;
+      };
+      work: {
+        title: string;
+        input: JsonValue;
+        completionCriteria: readonly string[];
+        workflow: {
+          id: string;
+          version: number;
+        };
+        route?: {
+          id: string;
+          version: number;
+        } | undefined;
+      };
+      rootTaskId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      attempt: number;
+      createdAt: string;
+      updatedAt: string;
+      model?: string | undefined;
+      area?: string | undefined;
+      approval?: "required" | "granted" | "denied" | undefined;
+      workResult?: {
+        output: JsonValue;
+        completedAt: string;
+      } | undefined;
+      waitingForMessages?: boolean | undefined;
+      workflowPhase?: string | undefined;
+      parentTaskId?: string | undefined;
+      parentTaskAttempt?: number | undefined;
+      pendingCommunicationReceiptIds?: readonly string[] | undefined;
+      failureReceiptId?: string | undefined;
+      execution?: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      } | undefined;
+      lastProgressAt?: string | undefined;
+      stalledAt?: string | undefined;
+      stalledReason?: string | undefined;
+      needsHumanAction?: string | undefined;
+      needsHumanNotifiedAt?: string | undefined;
+      reservedUsd?: number | undefined;
+      reservedAt?: string | undefined;
+      usage?: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        steps: Record<string, number>;
+      } | undefined;
+      settledUsd?: number | undefined;
+      question?: {
+        text: string;
+        options: readonly string[];
+        closingOptions?: readonly string[] | undefined;
+        answer?: string | undefined;
+        answeredBy?: string | undefined;
+      } | undefined;
+      questionTaskId?: string | undefined;
+      answerEventIds?: readonly string[] | undefined;
+      changeId?: string | undefined;
+      reportRef?: string | undefined;
+    }, z.core.$ZodTypeInternals<Task, {
+      schemaVersion: 1;
+      id: string;
+      repositoryIds: readonly [string, ...string[]];
+      kind: unknown;
+      state: "queued" | "running" | "stalled" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      origin: {
+        signalId?: string | undefined;
+        operator?: string | undefined;
+      };
+      work: {
+        title: string;
+        input: JsonValue;
+        completionCriteria: readonly string[];
+        workflow: {
+          id: string;
+          version: number;
+        };
+        route?: {
+          id: string;
+          version: number;
+        } | undefined;
+      };
+      rootTaskId: string;
+      replyTo: {
+        channel: string;
+        address: string;
+      };
+      attempt: number;
+      createdAt: string;
+      updatedAt: string;
+      model?: string | undefined;
+      area?: string | undefined;
+      approval?: "required" | "granted" | "denied" | undefined;
+      workResult?: {
+        output: JsonValue;
+        completedAt: string;
+      } | undefined;
+      waitingForMessages?: boolean | undefined;
+      workflowPhase?: string | undefined;
+      parentTaskId?: string | undefined;
+      parentTaskAttempt?: number | undefined;
+      pendingCommunicationReceiptIds?: readonly string[] | undefined;
+      failureReceiptId?: string | undefined;
+      execution?: {
+        provider: string;
+        sessionId: string;
+        environmentId?: string | undefined;
+        harness?: string | undefined;
+        traceId?: string | undefined;
+      } | undefined;
+      lastProgressAt?: string | undefined;
+      stalledAt?: string | undefined;
+      stalledReason?: string | undefined;
+      needsHumanAction?: string | undefined;
+      needsHumanNotifiedAt?: string | undefined;
+      reservedUsd?: number | undefined;
+      reservedAt?: string | undefined;
+      usage?: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        steps: Record<string, number>;
+      } | undefined;
+      settledUsd?: number | undefined;
+      question?: {
+        text: string;
+        options: readonly string[];
+        closingOptions?: readonly string[] | undefined;
+        answer?: string | undefined;
+        answeredBy?: string | undefined;
+      } | undefined;
+      questionTaskId?: string | undefined;
+      answerEventIds?: readonly string[] | undefined;
+      changeId?: string | undefined;
+      reportRef?: string | undefined;
+    }>>>;
+  }, z.core.$strict>>>;
+  nextCursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  totalCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/** Cursor-paginated operator-facing sessions. */
+type SessionPage = z.infer<typeof sessionPageSchema>;
+/** Validates one configured repository exposed by the operator API. */
+declare const repositorySummarySchema: z.ZodObject<{
+  id: z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>;
+  slug: z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+}, z.core.$strict>;
+/** Configured repository exposed by the operator API. */
+type RepositorySummary = z.infer<typeof repositorySummarySchema>;
+/** Validates repository slugs and their stable identifiers. */
+declare const repositoryDetailsSchema: z.ZodObject<{
+  repositories: z.ZodReadonly<z.ZodArray<z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>>>;
+  details: z.ZodDefault<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    id: z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>;
+    slug: z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+  }, z.core.$strict>>>>;
+}, z.core.$strict>;
+/** Repository slugs and their stable configured identifiers. */
+type RepositoryDetails = z.infer<typeof repositoryDetailsSchema>;
+/** Validates a locally retained follow-up awaiting confirmed API acceptance. */
+declare const pendingFollowUpSchema: z.ZodObject<{
+  sessionId: z.ZodType<`ses_${string}`, string, z.core.$ZodTypeInternals<`ses_${string}`, string>>;
+  operationId: z.ZodString;
+  executionId: z.ZodNullable<z.ZodString>;
+  message: z.ZodString;
+  attachments: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    id: z.ZodType<`img_${string}`, string, z.core.$ZodTypeInternals<`img_${string}`, string>>;
+    filename: z.ZodString;
+    mediaType: z.ZodEnum<{
+      "image/png": "image/png";
+      "image/jpeg": "image/jpeg";
+      "image/webp": "image/webp";
+    }>;
+    size: z.ZodNumber;
+  }, z.core.$strict>>>>;
+  turnPolicy: z.ZodEnum<{
+    steer: "steer";
+    queue: "queue";
+  }>;
+}, z.core.$strict>;
+/** A locally retained follow-up awaiting confirmed API acceptance. */
+type PendingFollowUp = Readonly<Omit<z.output<typeof pendingFollowUpSchema>, "attachments">> & {
+  readonly attachments?: readonly ImageAttachment[];
+};
+//#endregion
+export { AnswerSessionQuestionRequest, ApiAgent, ApiAgentInput, ControlSessionRequest, CreateSessionRequest, PendingFollowUp, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionView, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, pendingFollowUpSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema };
+//# sourceMappingURL=api-contracts.d.mts.map