@wular/coder 0.3.2 → 0.3.3

package/dist/sdk.d.ts

@@ -1,22 +1,4 @@
-import {
-  C as Job,
-  E as CustomModelConfig,
-  S as Availability,
-  T as CoderConfig,
-  _ as FlowStep,
-  a as JobLogEntry,
-  c as StopSummary,
-  g as FlowRecord,
-  h as FlowEvent,
-  i as TaskResult,
-  m as DiscoveredFlow,
-  n as flowSdk,
-  o as RunOptions,
-  r as CoderError,
-  s as RunSummary,
-  w as TurnResult,
-  x as Approval,
-} from './index-CUy_WPvw.js';
+import { C as Job, E as CustomModelConfig, S as Availability, T as CoderConfig, _ as FlowStep, a as JobLogEntry, c as StopSummary, g as FlowRecord, h as FlowEvent, i as TaskResult, m as DiscoveredFlow, n as flowSdk, o as RunOptions, r as CoderError, s as RunSummary, w as TurnResult, x as Approval } from "./index-CTrgzW3M.js";
 //#region src/lib/codex-core.d.ts
 declare function getCodexAvailability(cwd: string): Availability;
 //#endregion
@@ -28,17 +10,14 @@ interface PluginResult {
   note: string;
 }
 /** Outcome of the codex auto-update check; null when nothing to do. */
-type CodexUpdateResult =
-  | {
-      updated: true;
-      from: string;
-    }
-  | {
-      updated: false;
-      from: string;
-      note: string;
-    }
-  | null;
+type CodexUpdateResult = {
+  updated: true;
+  from: string;
+} | {
+  updated: false;
+  from: string;
+  note: string;
+} | null;
 /** Outcome of an on-demand codex install; null when codex was already present. */
 type CodexInstallResult = {
   installed: boolean;
@@ -146,10 +125,7 @@ interface TaskRunOptions {
 /** Run and control coder tasks. Mirrors `coder task`. */
 declare const task: {
   /** Dispatch a task to the agent chain; returns as soon as it is live. */
-  run(
-    prompt: string,
-    opts?: TaskRunOptions,
-  ): Promise<{
+  run(prompt: string, opts?: TaskRunOptions): Promise<{
     taskId: string;
   }>;
   /**
@@ -158,214 +134,170 @@ declare const task: {
    * `steps` with the last n log entries (default 0: []). Omit the id for the
    * most recent task.
    */
-  result(
-    id?: string,
-    opts?: {
-      wait?: boolean;
-      tail?: number | 'all';
-      cwd?: string;
-    },
-  ): Promise<TaskResult>;
+  result(id?: string, opts?: {
+    wait?: boolean;
+    tail?: number | "all";
+    cwd?: string;
+  }): Promise<TaskResult>;
   /** Recent tasks (mirrors `coder list` / `coder task list`). */
-  list(
-    opts?: ListOptions & {
-      cwd?: string;
-    },
-  ): Job[];
+  list(opts?: ListOptions & {
+    cwd?: string;
+  }): Job[];
   /** Steer a follow-up into a task (live, queued, or resumed on its thread). */
-  steer(
-    id: string,
-    text: string,
-    opts?: {
-      cwd?: string;
-    },
-  ): Promise<{
+  steer(id: string, text: string, opts?: {
+    model?: string;
+    effort?: string;
+    permissions?: string;
+    cwd?: string;
+  }): Promise<{
     taskId: string;
     steered: SteerOutcome;
   }>;
+  /** Ask about a task via a read-only sidecar; its thread is never touched. */
+  ask(id: string, question: string, opts?: {
+    model?: string;
+    effort?: string;
+    cwd?: string;
+  }): Promise<{
+    taskId: string;
+    answer: string | null;
+  }>;
   /** Stop a running task. */
-  stop(
-    id: string,
-    opts?: {
-      cwd?: string;
-    },
-  ): Promise<{
+  stop(id: string, opts?: {
+    cwd?: string;
+  }): Promise<{
     taskId: string;
-    status: 'cancelled';
+    status: "cancelled";
     interrupt: string;
   }>;
   /** Archive a task (hide it from the default list). */
-  archive(
-    id: string,
-    opts?: {
-      cwd?: string;
-    },
-  ): {
+  archive(id: string, opts?: {
+    cwd?: string;
+  }): {
     taskId: string;
     archived: true;
   };
   /** Delete a task and its engine session from disk. */
-  delete(
-    id: string,
-    opts?: {
-      cwd?: string;
-    },
-  ): {
+  delete(id: string, opts?: {
+    cwd?: string;
+  }): {
     taskId: string;
     deleted: boolean;
   };
   /** Answer a pending approval (accept, or `deny`). */
-  approve(
-    id: string,
-    approvalId: string,
-    opts?: {
-      deny?: boolean;
-      cwd?: string;
-    },
-  ): {
+  approve(id: string, approvalId: string, opts?: {
+    deny?: boolean;
+    cwd?: string;
+  }): {
     taskId: string;
     approvalId: string;
-    decision: 'accept' | 'decline';
+    decision: "accept" | "decline";
   };
   /** Pending approvals for a task (omit the id for the most recent task). */
-  approvals(
-    id?: string,
-    opts?: {
-      cwd?: string;
-    },
-  ): Approval[];
+  approvals(id?: string, opts?: {
+    cwd?: string;
+  }): Approval[];
   /** Follow a task live: an async iterable of progress log entries. `tail` replays only the last n (default 1). */
-  stream(
-    id?: string,
-    opts?: {
-      tail?: number | 'all';
-      cwd?: string;
-    },
-  ): AsyncGenerator<JobLogEntry>;
+  stream(id?: string, opts?: {
+    tail?: number | "all";
+    cwd?: string;
+  }): AsyncGenerator<JobLogEntry>;
 };
 /** Manage models: custom endpoints, engine aliases, disable toggles. Mirrors `coder model`. */
 declare const model: {
   /** Register a custom OpenAI-compatible endpoint model. */
-  add: (
-    name: string,
-    opts: ModelWriteOptions & {
-      cwd?: string;
-    },
-  ) => Promise<PersistedModel>;
+  add: (name: string, opts: ModelWriteOptions & {
+    cwd?: string;
+  }) => Promise<PersistedModel>;
   /** Update fields of a configured model entry. */
-  update: (
-    name: string,
-    opts: ModelWriteOptions & {
-      cwd?: string;
-    },
-  ) => Promise<PersistedModel>;
+  update: (name: string, opts: ModelWriteOptions & {
+    cwd?: string;
+  }) => Promise<PersistedModel>;
   /** Remove a configured model entry. */
-  remove: (
-    name: string,
-    opts?: {
-      workspace?: boolean;
-      cwd?: string;
-    },
-  ) => {
+  remove: (name: string, opts?: {
+    workspace?: boolean;
+    cwd?: string;
+  }) => {
     removed: string;
     file: string;
   };
   /** Every dispatchable model: built-ins, aliases, custom endpoints. */
-  list: (opts?: { cwd?: string }) => Promise<{
-    toggles?:
-      | {
-          name: string;
-          disabled: boolean;
-        }[]
-      | undefined;
-    codex: (
-      | {
-          alias: string;
-          model: string;
-          builtin: boolean;
-          disabled: boolean;
-          spec?: undefined;
-          overrides?: undefined;
-        }
-      | {
-          alias: string;
-          spec: string;
-          disabled: boolean;
-        }
-    )[];
-    claude: (
-      | {
-          alias: string;
-          model: string;
-          builtin: boolean;
-          disabled: boolean;
-          spec?: undefined;
-          overrides?: undefined;
-        }
-      | {
-          alias: string;
-          spec: string;
-          disabled: boolean;
-        }
-    )[];
+  list: (opts?: {
+    cwd?: string;
+  }) => Promise<{
+    toggles?: {
+      name: string;
+      disabled: boolean;
+    }[] | undefined;
+    codex: ({
+      alias: string;
+      model: string;
+      builtin: boolean;
+      disabled: boolean;
+      spec?: undefined;
+      overrides?: undefined;
+    } | {
+      alias: string;
+      spec: string;
+      disabled: boolean;
+    })[];
+    claude: ({
+      alias: string;
+      model: string;
+      builtin: boolean;
+      disabled: boolean;
+      spec?: undefined;
+      overrides?: undefined;
+    } | {
+      alias: string;
+      spec: string;
+      disabled: boolean;
+    })[];
     custom: {
       probe: ProbeResult;
       baseUrl: string;
       model: string;
       envKey?: string | undefined;
-      wireApi?: 'chat' | 'responses' | undefined;
+      wireApi?: "chat" | "responses" | undefined;
       disabled?: boolean | undefined;
       name: string;
     }[];
   }>;
   /** Alias a name to an engine spec, e.g. alias('fast', 'codex:mini'). */
-  alias: (
-    name: string,
-    spec: string,
-    opts?: {
-      workspace?: boolean;
-      cwd?: string;
-    },
-  ) => {
-    provider: 'codex' | 'claude';
+  alias: (name: string, spec: string, opts?: {
+    workspace?: boolean;
+    cwd?: string;
+  }) => {
+    provider: "codex" | "claude";
     model: string;
-    effort?: 'low' | 'medium' | 'high' | undefined;
+    effort?: "low" | "medium" | "high" | undefined;
     disabled?: boolean | undefined;
   } & {
     alias: string;
     file: string;
   };
   /** Remove a user-defined alias. */
-  unalias: (
-    name: string,
-    opts?: {
-      workspace?: boolean;
-      cwd?: string;
-    },
-  ) => {
+  unalias: (name: string, opts?: {
+    workspace?: boolean;
+    cwd?: string;
+  }) => {
     unaliased: string;
     file: string;
   };
   /** Disable a model name (built-in, alias, or raw slug) without removing it. */
-  disable: (
-    name: string,
-    opts?: {
-      workspace?: boolean;
-      cwd?: string;
-    },
-  ) => {
+  disable: (name: string, opts?: {
+    workspace?: boolean;
+    cwd?: string;
+  }) => {
     name: string;
     disabled: boolean;
     file: string;
   };
   /** Re-enable a disabled model name. */
-  enable: (
-    name: string,
-    opts?: {
-      workspace?: boolean;
-      cwd?: string;
-    },
-  ) => {
+  enable: (name: string, opts?: {
+    workspace?: boolean;
+    cwd?: string;
+  }) => {
     name: string;
     disabled: boolean;
     file: string;
@@ -374,21 +306,14 @@ declare const model: {
 /** Read and write coder configuration. Mirrors `coder config`. */
 declare const config: {
   /** A config value by dotted key (or the whole effective config). */
-  get: (
-    key?: string,
-    opts?: {
-      cwd?: string;
-    },
-  ) => unknown;
+  get: (key?: string, opts?: {
+    cwd?: string;
+  }) => unknown;
   /** Set a config value; `workspace` targets the repo file instead of the user file. */
-  set: (
-    key: string,
-    value: unknown,
-    opts?: {
-      workspace?: boolean;
-      cwd?: string;
-    },
-  ) => {
+  set: (key: string, value: unknown, opts?: {
+    workspace?: boolean;
+    cwd?: string;
+  }) => {
     file: string;
     key: string;
     effective: unknown;
@@ -397,36 +322,28 @@ declare const config: {
   };
 };
 /** Probe engines, seed the chain, install requested host plugins. */
-declare function setupHost(
-  hosts?: string[],
-  opts?: {
-    cwd?: string;
-  },
-): Promise<SetupHostReport>;
+declare function setupHost(hosts?: string[], opts?: {
+  cwd?: string;
+}): Promise<SetupHostReport>;
 /** Update the CLI and/or host plugin installs; returns what moved. */
 declare function upgrade(opts?: {
   cliOnly?: boolean;
   pluginsOnly?: boolean;
 }): Promise<UpgradeReport>;
 /** List bundled docs, or return one topic's raw markdown. */
-declare function docs(topic?: string):
-  | {
-      topics: {
-        name: string;
-        description: string;
-      }[];
-    }
-  | {
-      name: string;
-      content: string;
-    };
+declare function docs(topic?: string): {
+  topics: {
+    name: string;
+    description: string;
+  }[];
+} | {
+  name: string;
+  content: string;
+};
 declare const _default: {
   task: {
     /** Dispatch a task to the agent chain; returns as soon as it is live. */
-    run(
-      prompt: string,
-      opts?: TaskRunOptions,
-    ): Promise<{
+    run(prompt: string, opts?: TaskRunOptions): Promise<{
       taskId: string;
     }>;
     /**
@@ -435,117 +352,93 @@ declare const _default: {
      * `steps` with the last n log entries (default 0: []). Omit the id for the
      * most recent task.
      */
-    result(
-      id?: string,
-      opts?: {
-        wait?: boolean;
-        tail?: number | 'all';
-        cwd?: string;
-      },
-    ): Promise<TaskResult>;
+    result(id?: string, opts?: {
+      wait?: boolean;
+      tail?: number | "all";
+      cwd?: string;
+    }): Promise<TaskResult>;
     /** Recent tasks (mirrors `coder list` / `coder task list`). */
-    list(
-      opts?: ListOptions & {
-        cwd?: string;
-      },
-    ): Job[];
+    list(opts?: ListOptions & {
+      cwd?: string;
+    }): Job[];
     /** Steer a follow-up into a task (live, queued, or resumed on its thread). */
-    steer(
-      id: string,
-      text: string,
-      opts?: {
-        cwd?: string;
-      },
-    ): Promise<{
+    steer(id: string, text: string, opts?: {
+      model?: string;
+      effort?: string;
+      permissions?: string;
+      cwd?: string;
+    }): Promise<{
       taskId: string;
       steered: SteerOutcome;
     }>;
+    /** Ask about a task via a read-only sidecar; its thread is never touched. */
+    ask(id: string, question: string, opts?: {
+      model?: string;
+      effort?: string;
+      cwd?: string;
+    }): Promise<{
+      taskId: string;
+      answer: string | null;
+    }>;
     /** Stop a running task. */
-    stop(
-      id: string,
-      opts?: {
-        cwd?: string;
-      },
-    ): Promise<{
+    stop(id: string, opts?: {
+      cwd?: string;
+    }): Promise<{
       taskId: string;
-      status: 'cancelled';
+      status: "cancelled";
       interrupt: string;
     }>;
     /** Archive a task (hide it from the default list). */
-    archive(
-      id: string,
-      opts?: {
-        cwd?: string;
-      },
-    ): {
+    archive(id: string, opts?: {
+      cwd?: string;
+    }): {
       taskId: string;
       archived: true;
     };
     /** Delete a task and its engine session from disk. */
-    delete(
-      id: string,
-      opts?: {
-        cwd?: string;
-      },
-    ): {
+    delete(id: string, opts?: {
+      cwd?: string;
+    }): {
       taskId: string;
       deleted: boolean;
     };
     /** Answer a pending approval (accept, or `deny`). */
-    approve(
-      id: string,
-      approvalId: string,
-      opts?: {
-        deny?: boolean;
-        cwd?: string;
-      },
-    ): {
+    approve(id: string, approvalId: string, opts?: {
+      deny?: boolean;
+      cwd?: string;
+    }): {
       taskId: string;
       approvalId: string;
-      decision: 'accept' | 'decline';
+      decision: "accept" | "decline";
     };
     /** Pending approvals for a task (omit the id for the most recent task). */
-    approvals(
-      id?: string,
-      opts?: {
-        cwd?: string;
-      },
-    ): Approval[];
+    approvals(id?: string, opts?: {
+      cwd?: string;
+    }): Approval[];
     /** Follow a task live: an async iterable of progress log entries. `tail` replays only the last n (default 1). */
-    stream(
-      id?: string,
-      opts?: {
-        tail?: number | 'all';
-        cwd?: string;
-      },
-    ): AsyncGenerator<JobLogEntry>;
+    stream(id?: string, opts?: {
+      tail?: number | "all";
+      cwd?: string;
+    }): AsyncGenerator<JobLogEntry>;
   };
   flow: {
     run(nameOrPath: string, opts?: RunOptions): Promise<RunSummary>;
-    list(opts?: { archived?: boolean; limit?: number }): FlowRecord[];
+    list(opts?: {
+      archived?: boolean;
+      limit?: number;
+    }): FlowRecord[];
     discover(cwd?: string): DiscoveredFlow[];
-    result(
-      runId?: string,
-      opts?: {
-        tail?: number | 'all';
-      },
-    ):
-      | (FlowRecord & {
-          steps: FlowStep[];
-        })
-      | null;
-    stream(
-      runId?: string,
-      opts?: {
-        tail?: number | 'all';
-      },
-    ): AsyncGenerator<FlowEvent>;
-    stop(
-      runId?: string,
-      opts?: {
-        keepTasks?: boolean;
-      },
-    ): Promise<StopSummary>;
+    result(runId?: string, opts?: {
+      tail?: number | "all";
+    }): (FlowRecord & {
+      steps: FlowStep[];
+    }) | null;
+    stream(runId?: string, opts?: {
+      tail?: number | "all";
+    }): AsyncGenerator<FlowEvent>;
+    stop(runId?: string, opts?: {
+      keepTasks?: boolean;
+    }): Promise<StopSummary>;
     resume(runId?: string, opts?: RunOptions): Promise<RunSummary>;
     archive(runId: string): {
       runId: string;
@@ -558,126 +451,98 @@ declare const _default: {
   };
   model: {
     /** Register a custom OpenAI-compatible endpoint model. */
-    add: (
-      name: string,
-      opts: ModelWriteOptions & {
-        cwd?: string;
-      },
-    ) => Promise<PersistedModel>;
+    add: (name: string, opts: ModelWriteOptions & {
+      cwd?: string;
+    }) => Promise<PersistedModel>;
     /** Update fields of a configured model entry. */
-    update: (
-      name: string,
-      opts: ModelWriteOptions & {
-        cwd?: string;
-      },
-    ) => Promise<PersistedModel>;
+    update: (name: string, opts: ModelWriteOptions & {
+      cwd?: string;
+    }) => Promise<PersistedModel>;
     /** Remove a configured model entry. */
-    remove: (
-      name: string,
-      opts?: {
-        workspace?: boolean;
-        cwd?: string;
-      },
-    ) => {
+    remove: (name: string, opts?: {
+      workspace?: boolean;
+      cwd?: string;
+    }) => {
       removed: string;
       file: string;
     };
     /** Every dispatchable model: built-ins, aliases, custom endpoints. */
-    list: (opts?: { cwd?: string }) => Promise<{
-      toggles?:
-        | {
-            name: string;
-            disabled: boolean;
-          }[]
-        | undefined;
-      codex: (
-        | {
-            alias: string;
-            model: string;
-            builtin: boolean;
-            disabled: boolean;
-            spec?: undefined;
-            overrides?: undefined;
-          }
-        | {
-            alias: string;
-            spec: string;
-            disabled: boolean;
-          }
-      )[];
-      claude: (
-        | {
-            alias: string;
-            model: string;
-            builtin: boolean;
-            disabled: boolean;
-            spec?: undefined;
-            overrides?: undefined;
-          }
-        | {
-            alias: string;
-            spec: string;
-            disabled: boolean;
-          }
-      )[];
+    list: (opts?: {
+      cwd?: string;
+    }) => Promise<{
+      toggles?: {
+        name: string;
+        disabled: boolean;
+      }[] | undefined;
+      codex: ({
+        alias: string;
+        model: string;
+        builtin: boolean;
+        disabled: boolean;
+        spec?: undefined;
+        overrides?: undefined;
+      } | {
+        alias: string;
+        spec: string;
+        disabled: boolean;
+      })[];
+      claude: ({
+        alias: string;
+        model: string;
+        builtin: boolean;
+        disabled: boolean;
+        spec?: undefined;
+        overrides?: undefined;
+      } | {
+        alias: string;
+        spec: string;
+        disabled: boolean;
+      })[];
       custom: {
         probe: ProbeResult;
         baseUrl: string;
         model: string;
         envKey?: string | undefined;
-        wireApi?: 'chat' | 'responses' | undefined;
+        wireApi?: "chat" | "responses" | undefined;
         disabled?: boolean | undefined;
         name: string;
       }[];
     }>;
     /** Alias a name to an engine spec, e.g. alias('fast', 'codex:mini'). */
-    alias: (
-      name: string,
-      spec: string,
-      opts?: {
-        workspace?: boolean;
-        cwd?: string;
-      },
-    ) => {
-      provider: 'codex' | 'claude';
+    alias: (name: string, spec: string, opts?: {
+      workspace?: boolean;
+      cwd?: string;
+    }) => {
+      provider: "codex" | "claude";
       model: string;
-      effort?: 'low' | 'medium' | 'high' | undefined;
+      effort?: "low" | "medium" | "high" | undefined;
       disabled?: boolean | undefined;
     } & {
       alias: string;
       file: string;
     };
     /** Remove a user-defined alias. */
-    unalias: (
-      name: string,
-      opts?: {
-        workspace?: boolean;
-        cwd?: string;
-      },
-    ) => {
+    unalias: (name: string, opts?: {
+      workspace?: boolean;
+      cwd?: string;
+    }) => {
       unaliased: string;
       file: string;
     };
     /** Disable a model name (built-in, alias, or raw slug) without removing it. */
-    disable: (
-      name: string,
-      opts?: {
-        workspace?: boolean;
-        cwd?: string;
-      },
-    ) => {
+    disable: (name: string, opts?: {
+      workspace?: boolean;
+      cwd?: string;
+    }) => {
       name: string;
       disabled: boolean;
       file: string;
     };
     /** Re-enable a disabled model name. */
-    enable: (
-      name: string,
-      opts?: {
-        workspace?: boolean;
-        cwd?: string;
-      },
-    ) => {
+    enable: (name: string, opts?: {
+      workspace?: boolean;
+      cwd?: string;
+    }) => {
       name: string;
       disabled: boolean;
       file: string;
@@ -685,21 +550,14 @@ declare const _default: {
   };
   config: {
     /** A config value by dotted key (or the whole effective config). */
-    get: (
-      key?: string,
-      opts?: {
-        cwd?: string;
-      },
-    ) => unknown;
+    get: (key?: string, opts?: {
+      cwd?: string;
+    }) => unknown;
     /** Set a config value; `workspace` targets the repo file instead of the user file. */
-    set: (
-      key: string,
-      value: unknown,
-      opts?: {
-        workspace?: boolean;
-        cwd?: string;
-      },
-    ) => {
+    set: (key: string, value: unknown, opts?: {
+      workspace?: boolean;
+      cwd?: string;
+    }) => {
       file: string;
       key: string;
       effective: unknown;
@@ -712,23 +570,4 @@ declare const _default: {
   docs: typeof docs;
 };
 //#endregion
-export {
-  type Approval,
-  CoderError,
-  type FlowEvent,
-  type FlowStep,
-  type Job,
-  type JobLogEntry,
-  type SteerOutcome,
-  type TaskResult,
-  TaskRunOptions,
-  type TurnResult,
-  config,
-  _default as default,
-  docs,
-  flowSdk as flow,
-  model,
-  setupHost,
-  task,
-  upgrade,
-};
+export { type Approval, CoderError, type FlowEvent, type FlowStep, type Job, type JobLogEntry, type SteerOutcome, type TaskResult, TaskRunOptions, type TurnResult, config, _default as default, docs, flowSdk as flow, model, setupHost, task, upgrade };