@astralform/js 9.3.0 → 9.4.1

package/dist/index.d.cts

@@ -258,7 +258,7 @@ declare const ChatEventType: {
 type ChatEventTypeValue = (typeof ChatEventType)[keyof typeof ChatEventType];
 type WireBlockKind = "text" | "thinking" | "tool_use";
 type WireBlockStatus = "streaming" | "awaiting_client_result" | "ok" | "error" | "denied" | "cancelled";
-type WireStopReason = "end_turn" | "tool_use" | "max_tokens" | "context_overflow" | "error";
+type WireStopReason = "end_turn" | "tool_use" | "max_tokens" | "context_overflow" | "incomplete" | "error";
 interface WireTextDelta {
     channel: "text";
     text: string;
@@ -644,6 +644,17 @@ interface Conversation {
      * null) from an Astralform older than 0.69.46.
      */
     repository?: string | null;
+    /**
+     * The code group this task is filed under, or `null`/absent when it is not in
+     * one. MUTABLE — unlike `repository`, which is written once on the first turn:
+     * a group is a label the user applies to work that already exists, so a task
+     * may join, move between, or leave groups at any time.
+     *
+     * Absent from an Astralform older than the one that introduced groups (phase 1
+     * of `docs/refactor/workspace-groups`), which is why it is optional rather
+     * than `string | null`.
+     */
+    groupId?: string | null;
 }
 /** One citation on a `web_search`-style tool row, as the clients parse it. */
 interface ToolSource {
@@ -959,6 +970,31 @@ interface CodeProject {
     repoFullName: string;
     addedAt: string;
 }
+/**
+ * One group of tasks working a single feature, under one repository.
+ *
+ * Groups are the app user's own, on one agent, under one repository: two people
+ * using the same agent curate their own. The title is user-supplied and
+ * renameable, and membership is mutable — see {@link Conversation.groupId}.
+ */
+interface ConversationGroup {
+    id: string;
+    repository: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A task filed under a group, as the assign call answers it.
+ *
+ * The server returns this body rather than `204`: `post` always parses a JSON
+ * body, so a No Content reply would surface as a parse error on a successful
+ * write. It is also the confirmation that the write landed.
+ */
+interface CodeGroupMembership {
+    groupId: string;
+    conversationId: string;
+}
 /** A repository the workspace's GitHub installations cover. */
 interface AvailableRepository {
     fullName: string;
@@ -1084,7 +1120,11 @@ interface VoiceConfig {
      * (or compare against `"raw"`) before polishing.
      */
     defaultMode: VoicePolishMode;
-    /** In tap-to-talk mode, the pause that ends a recording. */
+    /**
+     * @deprecated Always `2`. The server no longer sends the field and no
+     * shipped client implements pause detection; kept so existing code compiles,
+     * slated for removal in the next major.
+     */
     silenceAutoStopSeconds: number;
     /**
      * @deprecated Always `false`. Auto-send was removed from the platform
@@ -1790,6 +1830,57 @@ declare class AstralformClient {
              */
             remove: (owner: string, repo: string) => Promise<void>;
         };
+        /**
+         * Code groups: a user-named container under one repository, for a feature
+         * whose work outlives a single session. Its sessions share one plan and one
+         * set of notes, so what one writes the others read.
+         *
+         * A group is a LABEL, not a binding — unlike a task's project, which is
+         * written once on the first turn. A task may join, move between, or leave
+         * groups at any time, and a deleted group's sessions survive as ungrouped.
+         *
+         * The server enforces three things worth knowing before you render a
+         * failure: a group that is not this user's answers `404` (never `403`, so a
+         * group id cannot be probed); filing a task into a group under a DIFFERENT
+         * repository than the task's answers `409`; and the group's plan and notes
+         * are deleted with the group, while each session keeps its own.
+         */
+        groups: {
+            /**
+             * This user's groups, oldest first. Pass a repository to narrow to one
+             * repository's — the composer's picker does; the sidebar asks once and
+             * nests them itself.
+             */
+            list: (repository?: string) => Promise<ConversationGroup[]>;
+            /**
+             * Create a group under a repository. The repository goes through the same
+             * normaliser the Projects surface uses, so a pasted GitHub URL is accepted
+             * and anything that is not `owner/repo` is refused.
+             */
+            create: (repository: string, title: string) => Promise<ConversationGroup>;
+            /** Rename a group. A group that is not this user's answers `404`. */
+            rename: (groupId: string, title: string) => Promise<ConversationGroup>;
+            /**
+             * Delete a group. Its tasks survive and become ungrouped, each keeping its
+             * own plan and notes; the group's SHARED documents are deleted with it.
+             */
+            remove: (groupId: string) => Promise<void>;
+            /**
+             * File a task into a group. Idempotent — filing an already-filed task
+             * again is the same state, not an error. Refused with `409` when the task
+             * belongs to a different repository than the group, because it would
+             * render nowhere in the sidebar.
+             */
+            assign: (groupId: string, conversationId: string) => Promise<CodeGroupMembership>;
+            /**
+             * Take a task out of its group. The task and its documents are untouched.
+             *
+             * Deliberately not strict about WHICH group the task is in: a task that is
+             * in a different one (or in none) already satisfies "this task should not
+             * be grouped", so the call clears it rather than refusing.
+             */
+            unassign: (groupId: string, conversationId: string) => Promise<void>;
+        };
     };
     createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
     streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
@@ -2766,4 +2857,4 @@ declare function isEmbeddedResource(value: unknown): value is {
  */
 declare function parseEmbeddedResource(value: unknown): EmbeddedResource | null;
 
-export { type ActiveJob, type AgentCapability, type AgentIdentity, type AgentInfo, type AgentStatus, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type AvailableRepositories, type AvailableRepository, type BlockDeltaPayload, CONVERSATION_PAGE_SIZE, type ChatEvent, ChatEventType, type ChatEventTypeValue, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, type CodeProject, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type ConversationJob, type ConversationJobAttachment, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, type JobsPage, LLMNotConfiguredError, type MemoryProviderErrorPayload, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MessagesPage, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NestedLlmUsagePayload, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SendOptions$1 as SessionSendOptions, type SkillInfo, type SlashCommand, type SlashCommandSurface, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamAgentSummary, type TeamSummary, type ThinkingDescriptor, type ThinkingRungOption, type TitleGeneratedPayload, type TodoItem, type TodoUpdatePayload, type ToolApprovalDecision, type ToolApprovalGrantedPayload, type ToolApprovalRequest, type ToolApprovalRequestedPayload, type ToolApprovalScope, type ToolCallRequest, type ToolDefinition, type ToolGrant, type ToolHandler, type ToolHarnessWarningPayload, type ToolImageMode, type ToolImageStub, type ToolOutputMode, type ToolOutputStub, type ToolProgressPayload, ToolRegistry, type ToolResult, type ToolResultRequest, type ToolSource, type TurnUsage, type UIComponentsConfig, type UserUnavailablePayload, VOICE_POLISH_MODES, type VoiceConfig, type VoiceLLMMode, type VoicePolishEvent, type VoicePolishMode, type VoicePolishRequest, type VoiceTranscribeOptions, type VoiceTranscript, type WireBlockDelta, type WireBlockDeltaPayload, type WireBlockKind, type WireBlockStart, type WireBlockStatus, type WireBlockStop, type WireCustomEvent, type WireErrorEvent, type WireEvent, type WireInputArgDelta, type WireInputDelta, type WireKeepalive, type WireMessageStart, type WireMessageStop, type WireOutputDelta, type WireRetryEvent, type WireSignatureDelta, type WireStallWarning, type WireStatusDelta, type WireStopReason, type WireTextDelta, type WireThinkingDelta, type WorkspaceReadyPayload, generateId, isEmbeddedResource, isToolImageStub, isToolOutputStub, isVoiceLLMMode, isVoicePolishMode, mapSseToChat, parseEmbeddedResource, parseVoicePolishFrame, replayEvents, streamJobSSE, translateDelta };
+export { type ActiveJob, type AgentCapability, type AgentIdentity, type AgentInfo, type AgentStatus, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type AvailableRepositories, type AvailableRepository, type BlockDeltaPayload, CONVERSATION_PAGE_SIZE, type ChatEvent, ChatEventType, type ChatEventTypeValue, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, type CodeGroupMembership, type CodeProject, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type ConversationGroup, type ConversationJob, type ConversationJobAttachment, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, type JobsPage, LLMNotConfiguredError, type MemoryProviderErrorPayload, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MessagesPage, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NestedLlmUsagePayload, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SendOptions$1 as SessionSendOptions, type SkillInfo, type SlashCommand, type SlashCommandSurface, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamAgentSummary, type TeamSummary, type ThinkingDescriptor, type ThinkingRungOption, type TitleGeneratedPayload, type TodoItem, type TodoUpdatePayload, type ToolApprovalDecision, type ToolApprovalGrantedPayload, type ToolApprovalRequest, type ToolApprovalRequestedPayload, type ToolApprovalScope, type ToolCallRequest, type ToolDefinition, type ToolGrant, type ToolHandler, type ToolHarnessWarningPayload, type ToolImageMode, type ToolImageStub, type ToolOutputMode, type ToolOutputStub, type ToolProgressPayload, ToolRegistry, type ToolResult, type ToolResultRequest, type ToolSource, type TurnUsage, type UIComponentsConfig, type UserUnavailablePayload, VOICE_POLISH_MODES, type VoiceConfig, type VoiceLLMMode, type VoicePolishEvent, type VoicePolishMode, type VoicePolishRequest, type VoiceTranscribeOptions, type VoiceTranscript, type WireBlockDelta, type WireBlockDeltaPayload, type WireBlockKind, type WireBlockStart, type WireBlockStatus, type WireBlockStop, type WireCustomEvent, type WireErrorEvent, type WireEvent, type WireInputArgDelta, type WireInputDelta, type WireKeepalive, type WireMessageStart, type WireMessageStop, type WireOutputDelta, type WireRetryEvent, type WireSignatureDelta, type WireStallWarning, type WireStatusDelta, type WireStopReason, type WireTextDelta, type WireThinkingDelta, type WorkspaceReadyPayload, generateId, isEmbeddedResource, isToolImageStub, isToolOutputStub, isVoiceLLMMode, isVoicePolishMode, mapSseToChat, parseEmbeddedResource, parseVoicePolishFrame, replayEvents, streamJobSSE, translateDelta };

package/dist/index.d.ts

@@ -258,7 +258,7 @@ declare const ChatEventType: {
 type ChatEventTypeValue = (typeof ChatEventType)[keyof typeof ChatEventType];
 type WireBlockKind = "text" | "thinking" | "tool_use";
 type WireBlockStatus = "streaming" | "awaiting_client_result" | "ok" | "error" | "denied" | "cancelled";
-type WireStopReason = "end_turn" | "tool_use" | "max_tokens" | "context_overflow" | "error";
+type WireStopReason = "end_turn" | "tool_use" | "max_tokens" | "context_overflow" | "incomplete" | "error";
 interface WireTextDelta {
     channel: "text";
     text: string;
@@ -644,6 +644,17 @@ interface Conversation {
      * null) from an Astralform older than 0.69.46.
      */
     repository?: string | null;
+    /**
+     * The code group this task is filed under, or `null`/absent when it is not in
+     * one. MUTABLE — unlike `repository`, which is written once on the first turn:
+     * a group is a label the user applies to work that already exists, so a task
+     * may join, move between, or leave groups at any time.
+     *
+     * Absent from an Astralform older than the one that introduced groups (phase 1
+     * of `docs/refactor/workspace-groups`), which is why it is optional rather
+     * than `string | null`.
+     */
+    groupId?: string | null;
 }
 /** One citation on a `web_search`-style tool row, as the clients parse it. */
 interface ToolSource {
@@ -959,6 +970,31 @@ interface CodeProject {
     repoFullName: string;
     addedAt: string;
 }
+/**
+ * One group of tasks working a single feature, under one repository.
+ *
+ * Groups are the app user's own, on one agent, under one repository: two people
+ * using the same agent curate their own. The title is user-supplied and
+ * renameable, and membership is mutable — see {@link Conversation.groupId}.
+ */
+interface ConversationGroup {
+    id: string;
+    repository: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A task filed under a group, as the assign call answers it.
+ *
+ * The server returns this body rather than `204`: `post` always parses a JSON
+ * body, so a No Content reply would surface as a parse error on a successful
+ * write. It is also the confirmation that the write landed.
+ */
+interface CodeGroupMembership {
+    groupId: string;
+    conversationId: string;
+}
 /** A repository the workspace's GitHub installations cover. */
 interface AvailableRepository {
     fullName: string;
@@ -1084,7 +1120,11 @@ interface VoiceConfig {
      * (or compare against `"raw"`) before polishing.
      */
     defaultMode: VoicePolishMode;
-    /** In tap-to-talk mode, the pause that ends a recording. */
+    /**
+     * @deprecated Always `2`. The server no longer sends the field and no
+     * shipped client implements pause detection; kept so existing code compiles,
+     * slated for removal in the next major.
+     */
     silenceAutoStopSeconds: number;
     /**
      * @deprecated Always `false`. Auto-send was removed from the platform
@@ -1790,6 +1830,57 @@ declare class AstralformClient {
              */
             remove: (owner: string, repo: string) => Promise<void>;
         };
+        /**
+         * Code groups: a user-named container under one repository, for a feature
+         * whose work outlives a single session. Its sessions share one plan and one
+         * set of notes, so what one writes the others read.
+         *
+         * A group is a LABEL, not a binding — unlike a task's project, which is
+         * written once on the first turn. A task may join, move between, or leave
+         * groups at any time, and a deleted group's sessions survive as ungrouped.
+         *
+         * The server enforces three things worth knowing before you render a
+         * failure: a group that is not this user's answers `404` (never `403`, so a
+         * group id cannot be probed); filing a task into a group under a DIFFERENT
+         * repository than the task's answers `409`; and the group's plan and notes
+         * are deleted with the group, while each session keeps its own.
+         */
+        groups: {
+            /**
+             * This user's groups, oldest first. Pass a repository to narrow to one
+             * repository's — the composer's picker does; the sidebar asks once and
+             * nests them itself.
+             */
+            list: (repository?: string) => Promise<ConversationGroup[]>;
+            /**
+             * Create a group under a repository. The repository goes through the same
+             * normaliser the Projects surface uses, so a pasted GitHub URL is accepted
+             * and anything that is not `owner/repo` is refused.
+             */
+            create: (repository: string, title: string) => Promise<ConversationGroup>;
+            /** Rename a group. A group that is not this user's answers `404`. */
+            rename: (groupId: string, title: string) => Promise<ConversationGroup>;
+            /**
+             * Delete a group. Its tasks survive and become ungrouped, each keeping its
+             * own plan and notes; the group's SHARED documents are deleted with it.
+             */
+            remove: (groupId: string) => Promise<void>;
+            /**
+             * File a task into a group. Idempotent — filing an already-filed task
+             * again is the same state, not an error. Refused with `409` when the task
+             * belongs to a different repository than the group, because it would
+             * render nowhere in the sidebar.
+             */
+            assign: (groupId: string, conversationId: string) => Promise<CodeGroupMembership>;
+            /**
+             * Take a task out of its group. The task and its documents are untouched.
+             *
+             * Deliberately not strict about WHICH group the task is in: a task that is
+             * in a different one (or in none) already satisfies "this task should not
+             * be grouped", so the call clears it rather than refusing.
+             */
+            unassign: (groupId: string, conversationId: string) => Promise<void>;
+        };
     };
     createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
     streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
@@ -2766,4 +2857,4 @@ declare function isEmbeddedResource(value: unknown): value is {
  */
 declare function parseEmbeddedResource(value: unknown): EmbeddedResource | null;
 
-export { type ActiveJob, type AgentCapability, type AgentIdentity, type AgentInfo, type AgentStatus, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type AvailableRepositories, type AvailableRepository, type BlockDeltaPayload, CONVERSATION_PAGE_SIZE, type ChatEvent, ChatEventType, type ChatEventTypeValue, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, type CodeProject, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type ConversationJob, type ConversationJobAttachment, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, type JobsPage, LLMNotConfiguredError, type MemoryProviderErrorPayload, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MessagesPage, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NestedLlmUsagePayload, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SendOptions$1 as SessionSendOptions, type SkillInfo, type SlashCommand, type SlashCommandSurface, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamAgentSummary, type TeamSummary, type ThinkingDescriptor, type ThinkingRungOption, type TitleGeneratedPayload, type TodoItem, type TodoUpdatePayload, type ToolApprovalDecision, type ToolApprovalGrantedPayload, type ToolApprovalRequest, type ToolApprovalRequestedPayload, type ToolApprovalScope, type ToolCallRequest, type ToolDefinition, type ToolGrant, type ToolHandler, type ToolHarnessWarningPayload, type ToolImageMode, type ToolImageStub, type ToolOutputMode, type ToolOutputStub, type ToolProgressPayload, ToolRegistry, type ToolResult, type ToolResultRequest, type ToolSource, type TurnUsage, type UIComponentsConfig, type UserUnavailablePayload, VOICE_POLISH_MODES, type VoiceConfig, type VoiceLLMMode, type VoicePolishEvent, type VoicePolishMode, type VoicePolishRequest, type VoiceTranscribeOptions, type VoiceTranscript, type WireBlockDelta, type WireBlockDeltaPayload, type WireBlockKind, type WireBlockStart, type WireBlockStatus, type WireBlockStop, type WireCustomEvent, type WireErrorEvent, type WireEvent, type WireInputArgDelta, type WireInputDelta, type WireKeepalive, type WireMessageStart, type WireMessageStop, type WireOutputDelta, type WireRetryEvent, type WireSignatureDelta, type WireStallWarning, type WireStatusDelta, type WireStopReason, type WireTextDelta, type WireThinkingDelta, type WorkspaceReadyPayload, generateId, isEmbeddedResource, isToolImageStub, isToolOutputStub, isVoiceLLMMode, isVoicePolishMode, mapSseToChat, parseEmbeddedResource, parseVoicePolishFrame, replayEvents, streamJobSSE, translateDelta };
+export { type ActiveJob, type AgentCapability, type AgentIdentity, type AgentInfo, type AgentStatus, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type AvailableRepositories, type AvailableRepository, type BlockDeltaPayload, CONVERSATION_PAGE_SIZE, type ChatEvent, ChatEventType, type ChatEventTypeValue, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, type CodeGroupMembership, type CodeProject, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type ConversationGroup, type ConversationJob, type ConversationJobAttachment, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, type JobsPage, LLMNotConfiguredError, type MemoryProviderErrorPayload, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MessagesPage, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NestedLlmUsagePayload, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SendOptions$1 as SessionSendOptions, type SkillInfo, type SlashCommand, type SlashCommandSurface, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamAgentSummary, type TeamSummary, type ThinkingDescriptor, type ThinkingRungOption, type TitleGeneratedPayload, type TodoItem, type TodoUpdatePayload, type ToolApprovalDecision, type ToolApprovalGrantedPayload, type ToolApprovalRequest, type ToolApprovalRequestedPayload, type ToolApprovalScope, type ToolCallRequest, type ToolDefinition, type ToolGrant, type ToolHandler, type ToolHarnessWarningPayload, type ToolImageMode, type ToolImageStub, type ToolOutputMode, type ToolOutputStub, type ToolProgressPayload, ToolRegistry, type ToolResult, type ToolResultRequest, type ToolSource, type TurnUsage, type UIComponentsConfig, type UserUnavailablePayload, VOICE_POLISH_MODES, type VoiceConfig, type VoiceLLMMode, type VoicePolishEvent, type VoicePolishMode, type VoicePolishRequest, type VoiceTranscribeOptions, type VoiceTranscript, type WireBlockDelta, type WireBlockDeltaPayload, type WireBlockKind, type WireBlockStart, type WireBlockStatus, type WireBlockStop, type WireCustomEvent, type WireErrorEvent, type WireEvent, type WireInputArgDelta, type WireInputDelta, type WireKeepalive, type WireMessageStart, type WireMessageStop, type WireOutputDelta, type WireRetryEvent, type WireSignatureDelta, type WireStallWarning, type WireStatusDelta, type WireStopReason, type WireTextDelta, type WireThinkingDelta, type WorkspaceReadyPayload, generateId, isEmbeddedResource, isToolImageStub, isToolOutputStub, isVoiceLLMMode, isVoicePolishMode, mapSseToChat, parseEmbeddedResource, parseVoicePolishFrame, replayEvents, streamJobSSE, translateDelta };

package/dist/index.js

@@ -447,6 +447,79 @@ var AstralformClient = class {
             `/v1/code/projects/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`
           );
         }
+      },
+      /**
+       * Code groups: a user-named container under one repository, for a feature
+       * whose work outlives a single session. Its sessions share one plan and one
+       * set of notes, so what one writes the others read.
+       *
+       * A group is a LABEL, not a binding — unlike a task's project, which is
+       * written once on the first turn. A task may join, move between, or leave
+       * groups at any time, and a deleted group's sessions survive as ungrouped.
+       *
+       * The server enforces three things worth knowing before you render a
+       * failure: a group that is not this user's answers `404` (never `403`, so a
+       * group id cannot be probed); filing a task into a group under a DIFFERENT
+       * repository than the task's answers `409`; and the group's plan and notes
+       * are deleted with the group, while each session keeps its own.
+       */
+      groups: {
+        /**
+         * This user's groups, oldest first. Pass a repository to narrow to one
+         * repository's — the composer's picker does; the sidebar asks once and
+         * nests them itself.
+         */
+        list: async (repository) => {
+          const query = repository ? `?repository=${encodeURIComponent(repository)}` : "";
+          const raw = await this.get(`/v1/code/groups${query}`);
+          return raw.map((g) => camelizeKeys(g));
+        },
+        /**
+         * Create a group under a repository. The repository goes through the same
+         * normaliser the Projects surface uses, so a pasted GitHub URL is accepted
+         * and anything that is not `owner/repo` is refused.
+         */
+        create: async (repository, title) => {
+          const raw = await this.post("/v1/code/groups", { repository, title });
+          return camelizeKeys(raw);
+        },
+        /** Rename a group. A group that is not this user's answers `404`. */
+        rename: async (groupId, title) => {
+          const raw = await this.patch(`/v1/code/groups/${encodeURIComponent(groupId)}`, { title });
+          return camelizeKeys(raw);
+        },
+        /**
+         * Delete a group. Its tasks survive and become ungrouped, each keeping its
+         * own plan and notes; the group's SHARED documents are deleted with it.
+         */
+        remove: async (groupId) => {
+          await this.del(`/v1/code/groups/${encodeURIComponent(groupId)}`);
+        },
+        /**
+         * File a task into a group. Idempotent — filing an already-filed task
+         * again is the same state, not an error. Refused with `409` when the task
+         * belongs to a different repository than the group, because it would
+         * render nowhere in the sidebar.
+         */
+        assign: async (groupId, conversationId) => {
+          const raw = await this.post(
+            `/v1/code/groups/${encodeURIComponent(groupId)}/tasks/${encodeURIComponent(conversationId)}`,
+            void 0
+          );
+          return camelizeKeys(raw);
+        },
+        /**
+         * Take a task out of its group. The task and its documents are untouched.
+         *
+         * Deliberately not strict about WHICH group the task is in: a task that is
+         * in a different one (or in none) already satisfies "this task should not
+         * be grouped", so the call clears it rather than refusing.
+         */
+        unassign: async (groupId, conversationId) => {
+          await this.del(
+            `/v1/code/groups/${encodeURIComponent(groupId)}/tasks/${encodeURIComponent(conversationId)}`
+          );
+        }
       }
     };
     if (isApiKeyConfig(config)) {
@@ -1008,7 +1081,11 @@ var AstralformClient = class {
       // A mode this SDK does not know must not reach a `switch` typed as
       // `VoicePolishMode`; `structured` is the server's own default.
       defaultMode: isVoicePolishMode(raw.default_mode) ? raw.default_mode : "structured",
-      silenceAutoStopSeconds: raw.silence_auto_stop_seconds ?? 2,
+      // Deliberately not read from the wire. The field was retired from the
+      // platform (2026-10-09): no shipped client implements pause detection
+      // and the server no longer sends it, so an older server's stored value
+      // must not resurrect it.
+      silenceAutoStopSeconds: 2,
       // Deliberately not read from the wire. Auto-send was removed from the
       // platform (2026-09-14) and the server pins `auto_send` to false; an
       // older server still sending `true` must not make a client auto-send, so
@@ -1665,22 +1742,24 @@ function translateWireEvent(wire) {
         status: wire.status,
         final: wire.final
       };
-    case "message_stop":
+    case "message_stop": {
+      const usage = wire.usage ?? {};
       return {
         type: "message_stop",
         turnId: wire.turn_id,
         jobId: wire.job_id,
         stopReason: wire.stop_reason,
         usage: {
-          inputTokens: wire.usage.input_tokens ?? 0,
-          outputTokens: wire.usage.output_tokens ?? 0,
-          cachedTokens: wire.usage.cached_tokens ?? 0,
-          cacheCreationTokens: wire.usage.cache_creation_tokens ?? 0
+          inputTokens: usage.input_tokens ?? 0,
+          outputTokens: usage.output_tokens ?? 0,
+          cachedTokens: usage.cached_tokens ?? 0,
+          cacheCreationTokens: usage.cache_creation_tokens ?? 0
         },
         ttfbMs: wire.ttfb_ms,
         totalMs: wire.total_ms,
         stallCount: wire.stall_count
       };
+    }
     case "stall":
       return {
         type: "stall",
@@ -2032,7 +2111,7 @@ var ChatSession = class {
       if (!(err instanceof DOMException && err.name === "AbortError")) {
         this.emit({
           type: "error",
-          code: "connection_error",
+          code: err instanceof AstralformError ? err.code : "connection_error",
           message: err instanceof Error ? err.message : String(err),
           blockPath: null
         });
@@ -2184,6 +2263,9 @@ var ChatSession = class {
             if (typeof data?.seq === "number") {
               this.lastSeq = data.seq;
             }
+            if (typeof data === "object" && data !== null && "data" in data && data.data === "[DONE]") {
+              sawTerminal = true;
+            }
             continue;
           }
           parsed = data;
@@ -2313,7 +2395,7 @@ var ChatSession = class {
         }
         return;
       case "block_delta":
-        if (ownsTurnState && wire.delta.channel === "text" && this.currentTextPath !== null && pathEquals(this.currentTextPath, wire.path)) {
+        if (ownsTurnState && wire.delta?.channel === "text" && this.currentTextPath !== null && pathEquals(this.currentTextPath, wire.path)) {
           this.accumulatedText += wire.delta.text;
         }
         return;