@coder/ai-sdk-agent 0.10.1 → 0.11.1

package/README.md

@@ -919,6 +919,7 @@ sequence pinpoints _where_ a turn died:
 | `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                                            |
+| `reasoningEffort`                 | reasoning effort for chat creation and every user-message submission (see below)                                   |
 | `instructions`                    | system prompt                                                                                                      |
 | `tools`                           | AI SDK `ToolSet` (client‑executed)                                                                                 |
 | `workspaceId`                     | bind the chat to a Coder workspace (enables workspace‑scoped tools)                                                |
@@ -947,6 +948,37 @@ match on the fields they carry), and an unresolvable hint falls back to the
 server's default model instead of failing. Use
 `agent.listModels()` to see what's available.
 
+### Reasoning effort
+
+Set `reasoningEffort` on `CoderAgentSettings` (or `CoderLanguageModelConfig`
+when using the model directly). The global scale is `none`, `minimal`, `low`,
+`medium`, `high`, `xhigh`, `max`. The exported `ReasoningEffort` type also accepts
+other strings for forward compatibility. Model configs returned by
+`agent.listModels()` / `client.listModelConfigs(organizationId)` expose the
+optional `reasoning_efforts` list of selectable values for each model.
+
+```ts
+import { CoderAgent } from "@coder/ai-sdk-agent";
+
+const agent = new CoderAgent({
+  organizationId: "your-org-uuid",
+  reasoningEffort: "low",
+});
+await agent.generate({ prompt: "Reply with exactly: pong" });
+const chat = await agent.client.getChat(agent.chatId!);
+console.log(chat.last_reasoning_effort); // string, null, or absent on the wire
+await agent.archive();
+```
+
+The setting is independent of the `model` hint. It is sent as `reasoning_effort`
+on chat creation and every user-message submission, including submissions to
+resumed or busy chats that queue the message. When unset, the request key is
+omitted entirely. Tool-result submissions and WebSocket reconnects do not post
+user messages and do not send this field. There is no per-call reasoning-effort
+override; configure it on the agent/model instance. Older Coder servers that do
+not recognize `reasoning_effort` ignore the unknown JSON field, so setting it is
+safe but has no effect there.
+
 ## How it works
 
 ```

package/dist/index.d.ts

@@ -78,6 +78,8 @@ declare const MAX_CHAT_FILE_SIZE_BYTES: number;
 type ChatClientType = "ui" | "api";
 type ChatPlanMode = "" | "plan";
 type ChatBusyBehavior = "queue" | "interrupt";
+/** Coder's global reasoning effort scale; accepts future server-defined values. */
+type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | (string & {});
 /**
  * A client-executed ("dynamic") tool definition. chatd never executes these;
  * when the model calls one, the chat enters `requires_action` and the client
@@ -97,6 +99,7 @@ interface CreateChatRequest {
     system_prompt?: string;
     workspace_id?: string;
     model_config_id?: string;
+    reasoning_effort?: ReasoningEffort;
     mcp_server_ids?: string[];
     labels?: Record<string, string>;
     unsafe_dynamic_tools?: DynamicTool[];
@@ -106,6 +109,7 @@ interface CreateChatRequest {
 interface CreateChatMessageRequest {
     content: ChatInputPart[];
     model_config_id?: string;
+    reasoning_effort?: ReasoningEffort;
     mcp_server_ids?: string[];
     busy_behavior?: ChatBusyBehavior;
     plan_mode?: ChatPlanMode;
@@ -211,6 +215,7 @@ interface Chat {
     parent_chat_id?: string | null;
     root_chat_id?: string | null;
     last_model_config_id?: string;
+    last_reasoning_effort?: ReasoningEffort | null;
     title: string;
     status: ChatStatus;
     plan_mode?: ChatPlanMode;
@@ -262,6 +267,7 @@ interface ChatModelConfig {
     is_default?: boolean;
     context_limit?: number;
     compression_threshold?: number;
+    reasoning_efforts?: ReasoningEffort[];
 }
 /**
  * An organization-scoped chat model, as returned by
@@ -282,7 +288,7 @@ interface ChatModel {
     is_default?: boolean;
     context_limit?: number;
     compression_threshold?: number;
-    reasoning_efforts?: string[];
+    reasoning_efforts?: ReasoningEffort[];
     created_at?: string;
     updated_at?: string;
 }
@@ -999,6 +1005,8 @@ interface CoderAgentSettings<TOOLS extends ToolSet = {}> {
     organizationId: string;
     /** Model hint: UUID, `provider:model`, model id, or display-name substring. */
     model?: string;
+    /** Reasoning effort sent on chat creation and each user-message submission. */
+    reasoningEffort?: ReasoningEffort;
     /** Bind the chat to a Coder workspace (enables workspace-scoped tools). */
     workspaceId?: string;
     /**
@@ -1286,6 +1294,8 @@ interface CoderLanguageModelConfig {
     organizationId: string;
     /** Model hint (UUID, `provider:model`, model id, or display-name substring). */
     model?: string;
+    /** Reasoning effort sent on chat creation and each user-message submission. */
+    reasoningEffort?: ReasoningEffort;
     /** Bind the chat to a Coder workspace (enables workspace tools). */
     workspaceId?: string;
     /** chatd-side MCP servers to enable. */
@@ -1707,4 +1717,4 @@ declare class CoderChatError extends CoderAgentError {
     constructor(payload: ChatErrorPayload);
 }
 
-export { CHAT_ATTACHMENT_MEDIA_TYPES, CODER_PROVIDER_OPTIONS, type Chat, type ChatAttachment, type ChatAttachmentMediaType, type ChatBusyBehavior, type ChatClientType, type ChatErrorPayload, type ChatFileInput, type ChatInputPart, type ChatInputPartType, type ChatMessage, type ChatMessagePart, type ChatMessagePartType, type ChatMessageRole, type ChatMessageUsage, type ChatMessagesResponse, type ChatMessagesToUIMessagesOptions, type ChatModel, type ChatModelConfig, type ChatModelProviderDescriptor, type ChatPlanMode, type ChatQueuedMessage, type ChatStatus, type ChatStreamActionRequired, type ChatStreamEvent, type ChatStreamEventType, type ChatStreamMessagePart, type ChatStreamRetry, type ChatStreamStatus, type ChatStreamToolCall, type ChatUnsupportedProvider, type ChatWatchEvent, type ChatWatchEventKind, CoderAgent, CoderAgentError, type CoderAgentSettings, CoderApiError, type CoderArchiveResult, CoderChatClient, type CoderChatClientOptions, CoderChatError, type CoderClientOperation, type CoderFileProviderOptions, type CoderInterruptResult, CoderLanguageModel, type CoderLanguageModelConfig, CoderStreamError, type CoderTransportEvent, type CreateChatMessageRequest, type CreateChatMessageResponse, type CreateChatRequest, type DynamicTool, type FileContent, type FilePartUploader, type HttpErrorTransportEvent, type HttpRequestTransportEvent, type HttpResponseTransportEvent, MAX_CHAT_FILE_SIZE_BYTES, type OrganizationChatModelsResponse, type PreviewShareLevel, type ResolvedFile, type SegmentSettleTransportEvent, type SegmentStartTransportEvent, type SharePreviewOptions, type SharedWorkspacePreview, type StreamCloseTransportEvent, type StreamDialTransportEvent, type StreamErrorTransportEvent, type StreamEventTransportEvent, type StreamOpenTransportEvent, type StreamRedialTransportEvent, type SubmitToolResultsRequest, TERMINAL_STATUSES, type ToolResult, type TransportEventHandler, type TurnAction, TurnTranslator, type TurnTranslatorOptions, type UpdateChatRequest, type UploadChatFileResponse, type UploadedChatFile, type UserContent, type WatchChatEventsOptions, type WebSocketFactory, type WebSocketLike, type WorkspaceFileStore, type WorkspacePlacement, type WorkspacePreview, type WorkspacePreviewOptions, chatMessagesToUIMessages, classifyTurnAction, dataContentToFileContent, dynamicToolNames, extractSystemPrompt, resolveFileContent, streamChatEvents, toolsToDynamicTools, userContentToInputParts, watchChatEvents };
+export { CHAT_ATTACHMENT_MEDIA_TYPES, CODER_PROVIDER_OPTIONS, type Chat, type ChatAttachment, type ChatAttachmentMediaType, type ChatBusyBehavior, type ChatClientType, type ChatErrorPayload, type ChatFileInput, type ChatInputPart, type ChatInputPartType, type ChatMessage, type ChatMessagePart, type ChatMessagePartType, type ChatMessageRole, type ChatMessageUsage, type ChatMessagesResponse, type ChatMessagesToUIMessagesOptions, type ChatModel, type ChatModelConfig, type ChatModelProviderDescriptor, type ChatPlanMode, type ChatQueuedMessage, type ChatStatus, type ChatStreamActionRequired, type ChatStreamEvent, type ChatStreamEventType, type ChatStreamMessagePart, type ChatStreamRetry, type ChatStreamStatus, type ChatStreamToolCall, type ChatUnsupportedProvider, type ChatWatchEvent, type ChatWatchEventKind, CoderAgent, CoderAgentError, type CoderAgentSettings, CoderApiError, type CoderArchiveResult, CoderChatClient, type CoderChatClientOptions, CoderChatError, type CoderClientOperation, type CoderFileProviderOptions, type CoderInterruptResult, CoderLanguageModel, type CoderLanguageModelConfig, CoderStreamError, type CoderTransportEvent, type CreateChatMessageRequest, type CreateChatMessageResponse, type CreateChatRequest, type DynamicTool, type FileContent, type FilePartUploader, type HttpErrorTransportEvent, type HttpRequestTransportEvent, type HttpResponseTransportEvent, MAX_CHAT_FILE_SIZE_BYTES, type OrganizationChatModelsResponse, type PreviewShareLevel, type ReasoningEffort, type ResolvedFile, type SegmentSettleTransportEvent, type SegmentStartTransportEvent, type SharePreviewOptions, type SharedWorkspacePreview, type StreamCloseTransportEvent, type StreamDialTransportEvent, type StreamErrorTransportEvent, type StreamEventTransportEvent, type StreamOpenTransportEvent, type StreamRedialTransportEvent, type SubmitToolResultsRequest, TERMINAL_STATUSES, type ToolResult, type TransportEventHandler, type TurnAction, TurnTranslator, type TurnTranslatorOptions, type UpdateChatRequest, type UploadChatFileResponse, type UploadedChatFile, type UserContent, type WatchChatEventsOptions, type WebSocketFactory, type WebSocketLike, type WorkspaceFileStore, type WorkspacePlacement, type WorkspacePreview, type WorkspacePreviewOptions, chatMessagesToUIMessages, classifyTurnAction, dataContentToFileContent, dynamicToolNames, extractSystemPrompt, resolveFileContent, streamChatEvents, toolsToDynamicTools, userContentToInputParts, watchChatEvents };

package/dist/index.js

@@ -1125,6 +1125,7 @@ function joinOrgModels(res) {
   for (const m of models) {
     if (typeof m !== "object" || m === null) continue;
     const config = { ...m };
+    if (m.reasoning_efforts !== void 0) config.reasoning_efforts = m.reasoning_efforts;
     const providerType = typeof m.ai_provider_id === "string" ? providerTypeById.get(m.ai_provider_id) : void 0;
     if (providerType !== void 0) config.provider = providerType;
     configs.push(config);
@@ -2570,6 +2571,9 @@ var CoderLanguageModel = class {
           const tools = toolsToDynamicTools(options.tools);
           if (tools.length > 0) req.unsafe_dynamic_tools = tools;
           if (modelConfigId) req.model_config_id = modelConfigId;
+          if (this.#config.reasoningEffort !== void 0) {
+            req.reasoning_effort = this.#config.reasoningEffort;
+          }
           if (this.#config.workspaceId) req.workspace_id = this.#config.workspaceId;
           if (this.#config.mcpServerIds?.length) req.mcp_server_ids = this.#config.mcpServerIds;
           if (this.#config.planMode) req.plan_mode = this.#config.planMode;
@@ -2580,14 +2584,12 @@ var CoderLanguageModel = class {
           if (chat.mcp_server_ids?.length) chatHasMcpServers = true;
           afterId = this.#lastSeenMessageId > 0 ? this.#lastSeenMessageId : void 0;
         } else {
-          const resp = await this.#config.client.createChatMessage(
-            this.#chatId,
-            {
-              content,
-              ...modelConfigId ? { model_config_id: modelConfigId } : {}
-            },
-            signal
-          );
+          const req = { content };
+          if (modelConfigId) req.model_config_id = modelConfigId;
+          if (this.#config.reasoningEffort !== void 0) {
+            req.reasoning_effort = this.#config.reasoningEffort;
+          }
+          const resp = await this.#config.client.createChatMessage(this.#chatId, req, signal);
           if (resp.message) {
             afterId = resp.message.id;
           } else if (resp.queued) {
@@ -2986,6 +2988,7 @@ var CoderAgent = class {
       client: this.#client,
       organizationId: settings.organizationId,
       model: settings.model,
+      reasoningEffort: settings.reasoningEffort,
       workspaceId: settings.workspaceId,
       mcpServerIds: settings.mcpServerIds,
       planMode: settings.planMode,