@wular/coder 0.4.12 → 0.4.13

package/dist/sdk.d.ts

@@ -1,20 +1,164 @@
-import { A as flowSdk, At as TaskSource, B as review, Ct as AgentDefinition, Dt as InstallationSettings, Et as AgentUsage, F as archiveRuns, I as deleteRuns, J as DiscoveredFlow, L as RunOptions, M as readTask, Mt as CustomModelConfig, N as CoderError, Nt as config$1, Ot as Preset, P as RunResult$1, Q as FlowStep, R as RunSummary, St as Agent, Tt as AgentTask, V as readTurnResults, X as FlowRecord, Y as FlowEvent, _t as RunnerRow, at as TaskStatus$1, bt as RunnerUpdate, ct as TokenUsage, dt as LocalFolder, ft as LocalFolders, gt as RunnerPairing, ht as RunnerKind, it as Task, j as TaskResult, jt as CoderConfig, kt as TaskContext, l as ReviewResult, lt as AppSync, mt as RunnerInput, nt as Approval, ot as TurnResult, pt as ProbeResult, r as ReviewArgs, rt as Availability, st as TaskLogEntry, ut as ConnectionRow, vt as RunnerSpec, wt as AgentEvent, xt as TaskTurn, yt as RunnerTest, z as StopSummary } from "./index-BdkdNI1v.js";
+import { A as flowSdk, B as review, Ct as SinceMessage, Dt as McpConfigEntry, Et as Effort, F as archiveRuns, I as deleteRuns, J as DiscoveredFlow, L as RunOptions, M as readTask, N as CoderError, Ot as Permission, P as RunResult$1, Q as FlowStep, R as RunSummary, St as Preset, Tt as CustomModelConfig, V as readTurnResults, X as FlowRecord, Y as FlowEvent, _t as RunnerSpec, at as TurnResult, bt as TaskTurn, ct as AppSync, dt as LocalFolders, ft as ProbeResult, gt as RunnerRow, ht as RunnerPairing, it as Task, j as TaskResult, kt as config$1, l as ReviewResult, lt as ConnectionRow, mt as RunnerKind, nt as Approval, ot as TaskLogEntry, pt as RunnerInput, r as ReviewArgs, rt as Availability, st as TokenUsage, ut as LocalFolder, vt as RunnerTest, wt as CoderConfig, xt as PlatformEvent, yt as RunnerUpdate, z as StopSummary } from "./index-ChcxzFdB.js";
 import "zod/mini";
-//#region src/core/engines/codex/index.d.ts
-declare function getCodexAvailability(cwd: string): Availability;
-//#endregion
-//#region src/core/task/actions.d.ts
-/** How a steer was applied to a task. */
-type SteerOutcome = 'live' | 'queued' | 'resumed';
-/** Filters for the task list, mirroring the CLI flags. */
-interface ListOptions {
-  running?: boolean;
-  stopped?: boolean;
-  archived?: boolean;
-  /** Narrow to a workspace (matched by git root). */
+//#region src/agent/types.d.ts
+/** Per-integration wiring in a definition. `events` list = default behavior, map = event -> flow. */
+/** Event value in a definition map: a flow name, or options. */
+interface AgentEventOptions {
+  /** Flow to run; omit for the default agent. */
+  flow?: string;
+  /** Regex the event text must match (e.g. keywords on Slack `message`). */
+  match?: string;
+  /** May only narrow the agent's default permission for this event. */
+  permissions?: Permission;
+  /** `requester`: the task acts with the linked requester's own platform token. */
+  actAs?: 'requester';
+}
+interface AgentDefinitionIntegration {
+  events?: string[] | Record<string, string | true | AgentEventOptions>;
+}
+/** What an agent IS: `.coder/agents/<id>/agent.json` beside its system.md. */
+interface AgentDefinition {
+  /** Display name used in replies; defaults to the id. */
+  name?: string;
+  description?: string;
+  engine?: string;
+  runner?: string;
+  model?: string;
+  effort?: Effort;
+  permissions?: Permission;
+  /** Read-only or Read-write on its handles and connections; defaults to `write`. */
+  access?: Preset;
+  /** MCP servers every task of this agent attaches, in the `.mcp.json` entry shape. */
+  mcp?: Record<string, McpConfigEntry>;
+  integrations: Record<string, AgentDefinitionIntegration>;
+}
+/** Per-integration caps in usage: `allowedEvents` intersects the definition's. */
+interface AgentUsageIntegration {
+  allowedEvents?: string[];
+}
+/** How a repo RUNS an agent: one entry under `agents` in .coder/config.json. */
+interface AgentUsage {
+  engine?: string;
+  model?: string;
+  effort?: Effort;
+  permissions?: Permission;
+  /** May only lower the definition's access. */
+  access?: Preset;
+  integrations?: Record<string, AgentUsageIntegration>;
+  /** Connections its tasks may use, by id; absent allows every connection the task is granted. */
+  connections?: string[];
+  /** Off in this workspace; the other settings stay for when it is enabled again. */
+  disabled?: boolean;
+}
+interface Agent {
+  id: string;
+  /** definition.name ?? id. */
+  name: string;
+  definition: AgentDefinition;
+  usage?: AgentUsage;
+  /** Absolute folder path when the agent's body is on disk; remote agents have none. */
   dir?: string;
-  /** Max rows; 'all' or undefined means no limit. */
-  limit?: number | 'all';
+  /** Stored agent body, including system.md, when there is no on-disk folder. */
+  files?: Record<string, string>;
+  builtin: boolean;
+}
+/** A platform event, already typed by its integration. */
+interface AgentEvent extends PlatformEvent {
+  /** Whether the agent must answer: a mention, a 1:1 direct message, or a handle that answers every prompt. */
+  mustReply?: boolean;
+  /** The event's place in its conversation, gathered at dispatch; `more` counts messages past `since`'s cap. */
+  conversation?: {
+    index?: number;
+    since?: SinceMessage[];
+    more?: number;
+    /** Internal acknowledgement watermark of the recorded unseen snapshot. */
+    unseen?: {
+      version: number;
+      epoch?: string;
+    };
+  };
+}
+/** Per-installation settings a user sets from the platform (`/setup` in Slack). */
+interface InstallationSettings {
+  model?: string;
+  engine?: string;
+  effort?: string;
+}
+/** Where a task came from: a Coder surface, or the id of the integration whose event started it. */
+type TaskSource = 'dashboard' | 'cli' | 'schedule' | (string & {});
+interface AgentTask {
+  cwd?: string;
+  id: string;
+  name?: string;
+  source: TaskSource;
+  agent: string;
+  /** Flow name, or `default` for the built-in single-task behavior. */
+  flow: string;
+  runner: RunnerKind;
+  /** Registered `http` runner the task routes to. */
+  runnerId?: string;
+  /** Effective permission after host, usage, and event narrowing. */
+  permissions?: Permission;
+  /** The platform event, or for a dashboard or CLI task on a repo, that repo through its install. */
+  event?: AgentEvent;
+  /** What a dashboard or CLI task asks; the newest turn after a continue. */
+  prompt?: string;
+  /** Flow arguments given directly, instead of derived from the event. */
+  args?: Record<string, unknown>;
+  /** Workspace MCP servers the task attaches, by name. */
+  mcp?: string[];
+  /** Standing instructions appended to the task's system prompt. */
+  appendSystem?: string;
+  /** Absolute directories beyond cwd the task may reach, kept only for runners on the caller's machine. */
+  addDirs?: string[];
+  /** Connection ids granted when the task was made; secrets are resolved only when it starts. */
+  connections?: string[];
+  /** Handle the task posts as (GitHub `slug[bot]`, Slack bot user), so flows can trust only their own comments. */
+  author?: string;
+  definition: AgentDefinition;
+  /** Frozen id of the credential selected for this task. */
+  credential?: string;
+  /** The engine order for this task; a pinned engine has one entry. */
+  engineChain?: string[];
+  /** Applicable credentials frozen with the engine order, without their values. */
+  engineCredentials?: Record<string, string>;
+  /** Wular user who asked, when known; their personal credential comes first. */
+  requester?: string;
+  /** Stored agent body for runners whose checkout does not contain the agent. */
+  files?: Record<string, string>;
+  usage?: AgentUsage;
+  /** Effective tools per integration the agent declares, by its access mode; every installation of the agent's apps serves them. */
+  tools: Record<string, string[]>;
+  /** Context gathered by the receiver: notes for the turn and who asked. */
+  context?: TaskContext;
+  /** What the platform thread gets when the run fails without an answer. */
+  failureReply?: string;
+  /** The task's dashboard page, linked when the agent returns no reply where one is due. */
+  taskUrl?: string;
+}
+interface TaskContext {
+  outputSchema?: object;
+  /** Earlier turns a dashboard continuation pastes in, oldest first. */
+  messages?: Array<{
+    user: string;
+    text: string;
+    ts: string;
+  }>;
+  /** Completed turns of this task, kept across dashboard continuations. */
+  turns?: TaskTurn[];
+  /** Notes the receiver adds for the agent, such as a missing account connection. */
+  instructions?: string;
+  /** Whether this turn requires a reply. */
+  mustReply?: boolean;
+  /** The last conversation batch each kind admitted, by steer or resume. */
+  admissions?: Partial<Record<'batch' | 'reactions', string>>;
+  /** The Coder account behind the event's actor, when they connected it. */
+  user?: {
+    name: string;
+    email: string;
+  };
+  /** The task's escalations, answers included; a late answer resumes the task with them. */
+  approvals?: Approval[];
 }
 //#endregion
 //#region ../node_modules/.bun/drizzle-orm@0.45.2+2a53ce3fb4b067cf/node_modules/drizzle-orm/entity.d.ts
@@ -4671,7 +4815,9 @@ interface TaskStatus {
   archivedAt?: number;
   /** Archived by the auto-archive sweep, which lists take up on their next read rather than as an event. */
   autoArchived?: true;
-  approval?: unknown;
+  approval?: Approval;
+  /** Derived for task rows returned by the server: `task.context.approvals`. */
+  approvals?: Approval[];
   /** Ask-sidecar answers in arrival order. */
   answer?: unknown[];
   createdAt: number;
@@ -5308,7 +5454,7 @@ declare const secret: PgTableWithColumns<{
       tableName: "secret";
       dataType: "string";
       columnType: "PgText";
-      data: "app" | "installation" | "engine" | "runner";
+      data: "runner" | "engine" | "installation" | "app";
       driverParam: string;
       notNull: true;
       hasDefault: false;
@@ -5320,7 +5466,7 @@ declare const secret: PgTableWithColumns<{
       identity: undefined;
       generated: undefined;
     }, {}, {
-      $type: "app" | "installation" | "engine" | "runner";
+      $type: "runner" | "engine" | "installation" | "app";
     }>;
     iv: PgColumn<{
       name: "iv";
@@ -6199,7 +6345,7 @@ declare const runner: PgTableWithColumns<{
       tableName: "runner";
       dataType: "string";
       columnType: "PgText";
-      data: "personal" | "workspace";
+      data: "workspace" | "personal";
       driverParam: string;
       notNull: true;
       hasDefault: false;
@@ -6211,7 +6357,7 @@ declare const runner: PgTableWithColumns<{
       identity: undefined;
       generated: undefined;
     }, {}, {
-      $type: "personal" | "workspace";
+      $type: "workspace" | "personal";
     }>;
     config: PgColumn<{
       name: "config";
@@ -6966,7 +7112,7 @@ declare const task$1: PgTableWithColumns<{
       tableName: "task";
       dataType: "json";
       columnType: "PgJsonb";
-      data: unknown;
+      data: Approval;
       driverParam: unknown;
       notNull: false;
       hasDefault: false;
@@ -6977,7 +7123,9 @@ declare const task$1: PgTableWithColumns<{
       baseColumn: never;
       identity: undefined;
       generated: undefined;
-    }, {}, {}>;
+    }, {}, {
+      $type: Approval;
+    }>;
     answer: PgColumn<{
       name: "answer";
       tableName: "task";
@@ -7470,7 +7618,7 @@ declare const taskHistory: PgTableWithColumns<{
       tableName: "task_history";
       dataType: "string";
       columnType: "PgText";
-      data: "claude" | "codex";
+      data: "codex" | "claude";
       driverParam: string;
       notNull: true;
       hasDefault: false;
@@ -7482,7 +7630,7 @@ declare const taskHistory: PgTableWithColumns<{
       identity: undefined;
       generated: undefined;
     }, {}, {
-      $type: "claude" | "codex";
+      $type: "codex" | "claude";
     }>;
     conversation: PgColumn<{
       name: "conversation";
@@ -8634,7 +8782,7 @@ declare const tables: {
         tableName: "secret";
         dataType: "string";
         columnType: "PgText";
-        data: "app" | "installation" | "engine" | "runner";
+        data: "runner" | "engine" | "installation" | "app";
         driverParam: string;
         notNull: true;
         hasDefault: false;
@@ -8646,7 +8794,7 @@ declare const tables: {
         identity: undefined;
         generated: undefined;
       }, {}, {
-        $type: "app" | "installation" | "engine" | "runner";
+        $type: "runner" | "engine" | "installation" | "app";
       }>;
       iv: PgColumn<{
         name: "iv";
@@ -9521,7 +9669,7 @@ declare const tables: {
         tableName: "runner";
         dataType: "string";
         columnType: "PgText";
-        data: "personal" | "workspace";
+        data: "workspace" | "personal";
         driverParam: string;
         notNull: true;
         hasDefault: false;
@@ -9533,7 +9681,7 @@ declare const tables: {
         identity: undefined;
         generated: undefined;
       }, {}, {
-        $type: "personal" | "workspace";
+        $type: "workspace" | "personal";
       }>;
       config: PgColumn<{
         name: "config";
@@ -10287,7 +10435,7 @@ declare const tables: {
         tableName: "task";
         dataType: "json";
         columnType: "PgJsonb";
-        data: unknown;
+        data: Approval;
         driverParam: unknown;
         notNull: false;
         hasDefault: false;
@@ -10298,7 +10446,9 @@ declare const tables: {
         baseColumn: never;
         identity: undefined;
         generated: undefined;
-      }, {}, {}>;
+      }, {}, {
+        $type: Approval;
+      }>;
       answer: PgColumn<{
         name: "answer";
         tableName: "task";
@@ -10788,7 +10938,7 @@ declare const tables: {
         tableName: "task_history";
         dataType: "string";
         columnType: "PgText";
-        data: "claude" | "codex";
+        data: "codex" | "claude";
         driverParam: string;
         notNull: true;
         hasDefault: false;
@@ -10800,7 +10950,7 @@ declare const tables: {
         identity: undefined;
         generated: undefined;
       }, {}, {
-        $type: "claude" | "codex";
+        $type: "codex" | "claude";
       }>;
       conversation: PgColumn<{
         name: "conversation";
@@ -11411,6 +11561,23 @@ declare const credentials: {
   login: typeof loginCredential;
 };
 //#endregion
+//#region src/core/engines/codex/index.d.ts
+declare function getCodexAvailability(cwd: string): Availability;
+//#endregion
+//#region src/core/task/actions.d.ts
+/** How a steer was applied to a task. */
+type SteerOutcome = 'live' | 'queued' | 'resumed';
+/** Filters for the task list, mirroring the CLI flags. */
+interface ListOptions {
+  running?: boolean;
+  stopped?: boolean;
+  archived?: boolean;
+  /** Narrow to a workspace (matched by git root). */
+  dir?: string;
+  /** Max rows; 'all' or undefined means no limit. */
+  limit?: number | 'all';
+}
+//#endregion
 //#region src/core/task/index.d.ts
 /** Where a task call runs: this machine's tasks under `cwd`, or the server named by `server`. */
 type TaskOptions = {
@@ -11425,7 +11592,7 @@ interface TaskRunOptions {
   effort?: string;
   permissions?: string;
   name?: string;
-  system?: string;
+  appendSystem?: string;
   /** Extra directories the task may reach, resolved against cwd. */
   addDirs?: string[];
   /** MCP servers to attach, by name from config. */
@@ -11434,7 +11601,6 @@ interface TaskRunOptions {
   connections?: string[];
   /** Block until the task finishes, walking the engine chain when a turn fails to start. */
   wait?: boolean;
-  simulateApproval?: boolean;
   /** Server tasks: the repository and runner to use. */
   repo?: string;
   runner?: string;
@@ -11446,8 +11612,6 @@ interface TaskRunOptions {
   onNote?: (note: string) => void;
   /** Each time a wait starts on a task id. */
   onWaiting?: (taskId: string) => void;
-  /** Server task log lines while waiting. */
-  onLog?: (line: TaskLogLine) => void;
 }
 interface RunResult {
   taskId: string;
@@ -11468,8 +11632,8 @@ interface TaskInspection {
   turns: ReturnType<typeof readTurnResults>;
   pendingApprovals: Array<{
     id: string;
-    summary: string;
-    cwd: string | null;
+    reason: string;
+    actions: string[];
   }>;
   /** While running: time since the last sign of life, and whether it looks stalled. */
   idleMs?: number;
@@ -11494,25 +11658,47 @@ interface TaskRow {
   flowRunId: string | null;
   idleMs: number | null;
 }
+/** One page of tasks; `next` continues it, and `archived` counts archived tasks when a default view is empty. */
+interface TaskPage {
+  items: TaskRow[] & {
+    archived: number;
+  };
+  next?: string;
+}
 interface TaskWatch {
-  task: Task | TaskStatus;
+  task: Task;
   /** Progress entries as they land, ending when the task is terminal. */
-  events: AsyncGenerator<TaskLogEntry | TaskLogLine>;
+  events: AsyncGenerator<TaskLogEntry>;
   /** The task once the stream ends. */
   final(): Promise<{
     taskId: string;
     status: string;
     result: any;
     task: Task;
-  } | TaskStatus>;
+  }>;
+}
+interface SteerResult {
+  taskId: string;
+  steered: SteerOutcome;
+  /** With `wait`, once a live or resumed turn finishes. */
+  status?: string | null;
+  finalMessage?: string | null;
+}
+/** Ask about a task through a read-only sidecar; its thread is never touched. */
+interface AskResult {
+  taskId: string;
+  answer: string | null;
+  error?: string;
+  ok: boolean;
 }
 interface ApprovalRow {
   taskId: string;
   id: string;
-  summary: string;
-  cwd?: string | null;
+  reason: string;
+  actions: string[];
   createdAt?: string;
-  answered?: string | null;
+  answered?: 'accept' | 'decline' | 'closed' | null;
+  deniedReason?: string | null;
 }
 //#endregion
 //#region src/client/auth/session.d.ts
@@ -11682,6 +11868,7 @@ interface ModelWriteOptions {
   baseUrl?: string;
   model?: string;
   envKey?: string;
+  contextWindow?: number;
   workspace?: boolean;
 }
 declare const models: {
@@ -11739,6 +11926,7 @@ declare const models: {
       model: string;
       envKey?: string | undefined;
       wireApi?: "chat" | "responses" | undefined;
+      contextWindow?: number | undefined;
       disabled?: boolean | undefined;
       name: string;
     }[];
@@ -11748,7 +11936,7 @@ declare const models: {
     workspace?: boolean;
     cwd?: string;
   }) => {
-    provider: "claude" | "codex";
+    provider: "codex" | "claude";
     model: string;
     effort?: "low" | "medium" | "high" | undefined;
     disabled?: boolean | undefined;
@@ -11949,49 +12137,45 @@ interface DeclaredServer {
 //#region src/sdk.d.ts
 /** Run and control coder tasks. Mirrors `coder task`. */
 declare const task: {
-  run: (prompt: string, opts?: TaskRunOptions & TaskOptions) => Promise<RunResult | TaskStatus>;
+  run: (prompt: string, opts?: TaskRunOptions & TaskOptions) => Promise<RunResult>;
   result: (id?: string, opts?: TaskOptions & {
     wait?: boolean;
     tail?: number | "all";
     onWaiting?: (taskId: string) => void;
-  }) => Promise<TaskInspection | TaskStatus>;
-  list: (opts?: TaskOptions & ListOptions) => Promise<(TaskRow[] & {
-    clipped: number;
-    archived: number;
-  }) | TaskStatus[]>;
+  }) => Promise<TaskInspection>;
+  list: (opts?: TaskOptions & ListOptions & {
+    cursor?: string;
+  }) => Promise<TaskPage>;
   watch: (id?: string, opts?: TaskOptions & {
     tail?: number | "all";
     from?: number;
   }) => Promise<TaskWatch>;
   stream: (id?: string, opts?: TaskOptions & {
     tail?: number | "all";
-  }) => AsyncGenerator<TaskLogLine | TaskLogEntry, void, any>;
+  }) => AsyncGenerator<TaskLogEntry, void, any>;
   steer: (id: string, text: string, opts?: TaskOptions & {
     model?: string;
     effort?: string;
     permissions?: string;
     wait?: boolean;
-  }) => Promise<Record<string, unknown> | {
-    taskId: string;
-    steered: SteerOutcome;
-  } | {
-    status: TaskStatus$1 | null;
-    finalMessage: any;
-    taskId: string;
-    steered: SteerOutcome;
-  }>;
+  }) => Promise<SteerResult>;
   ask: (id: string, question: string, opts?: TaskOptions & {
     model?: string;
     effort?: string;
     onAsking?: (taskId: string) => void;
-  }) => Promise<Record<string, unknown>>;
-  approvals: (id?: string, opts?: TaskOptions) => Promise<ApprovalRow[] | Record<string, unknown>[]>;
+  }) => Promise<AskResult>;
+  approvals: (id?: string, opts?: TaskOptions & {
+    denied?: boolean;
+  }) => Promise<ApprovalRow[]>;
   approve: (reference: string | undefined, approvalId?: string, opts?: TaskOptions & {
     deny?: boolean;
-  }) => Promise<unknown>;
+    reason?: string;
+  }) => Promise<{
+    taskId: string;
+    approvalId: string;
+    decision: string;
+  }>;
   stop: (id?: string, opts?: TaskOptions) => Promise<{
-    ok: true;
-  } | {
     taskId: string;
     status: "cancelled";
     interrupt: string;
@@ -11999,24 +12183,24 @@ declare const task: {
   archive: (id?: string, opts?: TaskOptions & {
     allStopped?: boolean;
   }) => Promise<{
-    archived: string[];
-    count: number;
-    taskId?: undefined;
-  } | {
     taskId: string;
     archived: true;
     count?: undefined;
+  } | {
+    archived: string[];
+    count: number;
+    taskId?: undefined;
   }>;
   delete: (id?: string, opts?: TaskOptions & {
     allArchived?: boolean;
   }) => Promise<{
-    deleted: string[];
-    count: number;
-    taskId?: undefined;
-  } | {
     taskId: string;
     deleted: true;
     count?: undefined;
+  } | {
+    deleted: string[];
+    count: number;
+    taskId?: undefined;
   }>;
 };
 /** Platform accounts, API keys and MCP servers tasks use, on this machine or a Coder server. Mirrors `coder connection`. */
@@ -12171,49 +12355,45 @@ declare const agent: {
 };
 declare const _default: {
   task: {
-    run: (prompt: string, opts?: TaskRunOptions & TaskOptions) => Promise<RunResult | TaskStatus>;
+    run: (prompt: string, opts?: TaskRunOptions & TaskOptions) => Promise<RunResult>;
     result: (id?: string, opts?: TaskOptions & {
       wait?: boolean;
       tail?: number | "all";
       onWaiting?: (taskId: string) => void;
-    }) => Promise<TaskInspection | TaskStatus>;
-    list: (opts?: TaskOptions & ListOptions) => Promise<(TaskRow[] & {
-      clipped: number;
-      archived: number;
-    }) | TaskStatus[]>;
+    }) => Promise<TaskInspection>;
+    list: (opts?: TaskOptions & ListOptions & {
+      cursor?: string;
+    }) => Promise<TaskPage>;
     watch: (id?: string, opts?: TaskOptions & {
       tail?: number | "all";
       from?: number;
     }) => Promise<TaskWatch>;
     stream: (id?: string, opts?: TaskOptions & {
       tail?: number | "all";
-    }) => AsyncGenerator<TaskLogLine | TaskLogEntry, void, any>;
+    }) => AsyncGenerator<TaskLogEntry, void, any>;
     steer: (id: string, text: string, opts?: TaskOptions & {
       model?: string;
       effort?: string;
       permissions?: string;
       wait?: boolean;
-    }) => Promise<Record<string, unknown> | {
-      taskId: string;
-      steered: SteerOutcome;
-    } | {
-      status: TaskStatus$1 | null;
-      finalMessage: any;
-      taskId: string;
-      steered: SteerOutcome;
-    }>;
+    }) => Promise<SteerResult>;
     ask: (id: string, question: string, opts?: TaskOptions & {
       model?: string;
       effort?: string;
       onAsking?: (taskId: string) => void;
-    }) => Promise<Record<string, unknown>>;
-    approvals: (id?: string, opts?: TaskOptions) => Promise<ApprovalRow[] | Record<string, unknown>[]>;
+    }) => Promise<AskResult>;
+    approvals: (id?: string, opts?: TaskOptions & {
+      denied?: boolean;
+    }) => Promise<ApprovalRow[]>;
     approve: (reference: string | undefined, approvalId?: string, opts?: TaskOptions & {
       deny?: boolean;
-    }) => Promise<unknown>;
+      reason?: string;
+    }) => Promise<{
+      taskId: string;
+      approvalId: string;
+      decision: string;
+    }>;
     stop: (id?: string, opts?: TaskOptions) => Promise<{
-      ok: true;
-    } | {
       taskId: string;
       status: "cancelled";
       interrupt: string;
@@ -12221,24 +12401,24 @@ declare const _default: {
     archive: (id?: string, opts?: TaskOptions & {
       allStopped?: boolean;
     }) => Promise<{
-      archived: string[];
-      count: number;
-      taskId?: undefined;
-    } | {
       taskId: string;
       archived: true;
       count?: undefined;
+    } | {
+      archived: string[];
+      count: number;
+      taskId?: undefined;
     }>;
     delete: (id?: string, opts?: TaskOptions & {
       allArchived?: boolean;
     }) => Promise<{
-      deleted: string[];
-      count: number;
-      taskId?: undefined;
-    } | {
       taskId: string;
       deleted: true;
       count?: undefined;
+    } | {
+      deleted: string[];
+      count: number;
+      taskId?: undefined;
     }>;
   };
   flow: {
@@ -12312,6 +12492,7 @@ declare const _default: {
         model: string;
         envKey?: string | undefined;
         wireApi?: "chat" | "responses" | undefined;
+        contextWindow?: number | undefined;
         disabled?: boolean | undefined;
         name: string;
       }[];
@@ -12320,7 +12501,7 @@ declare const _default: {
       workspace?: boolean;
       cwd?: string;
     }) => {
-      provider: "claude" | "codex";
+      provider: "codex" | "claude";
       model: string;
       effort?: "low" | "medium" | "high" | undefined;
       disabled?: boolean | undefined;