@coder/ai-sdk-agent 0.7.2 → 0.8.0

package/README.md

@@ -196,6 +196,15 @@ Pass a Coder **API token** or **session token** as `token`; it is sent as the
 `Coder-Session-Token` header (REST) and used to authenticate the streaming WebSocket. Create
 a token with `coder tokens create`, or reuse your CLI session.
 
+When `baseUrl`/`token` are not passed, they default from the `CODER_URL` and
+`CODER_SESSION_TOKEN` environment variables (the same convention as
+`@coder/ai-sdk-sandbox`'s transports); explicit settings win over the
+environment. With the variables set, connection config disappears entirely:
+
+```ts
+const agent = new CoderAgent({ organizationId }); // uses CODER_URL + CODER_SESSION_TOKEN
+```
+
 You can also pass a pre‑built client:
 
 ```ts
@@ -675,7 +684,8 @@ Coder servers — no experimental endpoints.
   named "80" and never resolve; serve the preview on a higher port.
 
 The preview helpers call non‑chat endpoints, so they need `baseUrl` + `token`
-credentials — pass them alongside `client` if you construct one yourself.
+credentials — pass them alongside `client` if you construct one yourself (or
+let them default from `CODER_URL`/`CODER_SESSION_TOKEN`).
 
 ## Workspaces & quota
 
@@ -835,7 +845,7 @@ sequence pinpoints _where_ a turn died:
 
 | field                             | description                                                                                      |
 | --------------------------------- | ------------------------------------------------------------------------------------------------ |
-| `client` \| (`baseUrl` + `token`) | connection (one or the other)                                                                    |
+| `client` \| (`baseUrl` + `token`) | connection (one or the other; `baseUrl`/`token` default from `CODER_URL`/`CODER_SESSION_TOKEN`)  |
 | `organizationId`                  | org UUID that owns the chat (required)                                                           |
 | `model`                           | model hint: UUID, `provider:model`, model id, or display‑name substring                          |
 | `instructions`                    | system prompt                                                                                    |

package/dist/index.d.ts

@@ -820,13 +820,13 @@ interface CoderAgentSettings<TOOLS extends ToolSet = {}> {
      * A pre-built {@link CoderChatClient}, used instead of constructing one from
      * `baseUrl`/`token`. The preview helpers ({@link CoderAgent.getPreview},
      * {@link CoderAgent.sharePreview}) call non-chat endpoints and therefore
-     * still need credentials — pass `baseUrl` + `token` alongside `client` to
-     * enable them.
+     * still need credentials — pass `baseUrl` + `token` alongside `client` (or
+     * set `CODER_URL` + `CODER_SESSION_TOKEN`) to enable them.
      */
     client?: CoderChatClient;
-    /** Coder deployment base URL, e.g. `https://dev.coder.com`. */
+    /** Coder deployment base URL, e.g. `https://dev.coder.com`. Defaults to `CODER_URL`. */
     baseUrl?: string;
-    /** Coder API/session token (sent as `Coder-Session-Token`). */
+    /** Coder API/session token (sent as `Coder-Session-Token`). Defaults to `CODER_SESSION_TOKEN`. */
     token?: string;
     fetch?: CoderChatClientOptions["fetch"];
     webSocketFactory?: CoderChatClientOptions["webSocketFactory"];

package/dist/index.js

@@ -2466,25 +2466,28 @@ var CoderAgent = class {
   #settleRetryDelayMs;
   constructor(settings) {
     assertSupportedAiVersion();
+    const env = globalThis.process?.env;
+    const baseUrl = settings.baseUrl ?? env?.CODER_URL;
+    const token = settings.token ?? env?.CODER_SESSION_TOKEN;
     if (settings.client) {
       this.#client = settings.client;
-    } else if (settings.baseUrl && settings.token) {
+    } else if (baseUrl && token) {
       this.#client = new CoderChatClient({
-        baseUrl: settings.baseUrl,
-        token: settings.token,
+        baseUrl,
+        token,
         fetch: settings.fetch,
         webSocketFactory: settings.webSocketFactory,
         onTransportEvent: settings.onTransportEvent
       });
     } else {
       throw new CoderAgentError(
-        "CoderAgent requires either `client` or both `baseUrl` and `token`."
+        "CoderAgent requires either `client` or both `baseUrl` and `token` (or the CODER_URL and CODER_SESSION_TOKEN environment variables)."
       );
     }
     this.#organizationId = settings.organizationId;
     this.#workspaceFiles = settings.workspaceFiles;
     this.#workspaceId = settings.workspaceId;
-    this.#workspaceApi = settings.baseUrl && settings.token ? { baseUrl: settings.baseUrl, token: settings.token, fetch: settings.fetch } : void 0;
+    this.#workspaceApi = baseUrl && token ? { baseUrl, token, fetch: settings.fetch } : void 0;
     this.#settleDeadlineMs = sanitizeDelayMs(settings.settleDeadlineMs, SETTLE_DEADLINE_MS);
     this.#settleRetryDelayMs = sanitizeDelayMs(settings.settleRetryDelayMs, SETTLE_RETRY_DELAY_MS);
     if (settings.workspaceFiles && settings.workspaceId && settings.workspaceFiles.workspaceId !== settings.workspaceId) {
@@ -2658,7 +2661,7 @@ var CoderAgent = class {
     }
     if (!this.#workspaceApi) {
       throw new CoderAgentError(
-        `${method}() needs the deployment's REST credentials \u2014 construct the CoderAgent with \`baseUrl\` and \`token\` (they can accompany \`client\`).`
+        `${method}() needs the deployment's REST credentials \u2014 construct the CoderAgent with \`baseUrl\` and \`token\` (they can accompany \`client\`), or set the CODER_URL and CODER_SESSION_TOKEN environment variables.`
       );
     }
     return { conn: this.#workspaceApi, workspaceId: this.#workspaceId };