@astralform/js 7.3.0 → 7.4.1

package/dist/index.d.cts

@@ -563,6 +563,12 @@ interface Conversation {
     messageCount: number;
     createdAt: string;
     updatedAt: string;
+    /**
+     * The project this task belongs to (`owner/repo`), or `null` for an ordinary
+     * conversation. Set on the first turn and immutable after. Absent (rather than
+     * null) from an Astralform older than 0.70.0.
+     */
+    repository?: string | null;
 }
 interface Message {
     id: string;
@@ -612,6 +618,18 @@ interface AgentInfo {
     isOrchestrator: boolean;
     isEnabled: boolean;
     avatarUrl?: string;
+    /**
+     * What the agent is for. A client shows Projects and Tasks only for `"code"`.
+     * Absent on Astralform older than 0.70.0 — treat that as `"chat"`, which is
+     * also the server's default.
+     *
+     * It is a property of the WORKSPACE, not of a persona: `GET /v1/agents` selects
+     * the workspace row itself and returns exactly one entry, so the mode is
+     * `agents[0].mode` rather than something that varies across the list. The
+     * workspace picker (`listAgents`) does not carry it, so a client learns an
+     * agent's mode after opening it.
+     */
+    mode?: "chat" | "code";
 }
 interface TeamSummary {
     id: string;
@@ -738,6 +756,17 @@ interface ModelChoiceOptions {
 interface ChatStreamRequest {
     message?: string;
     conversation_id?: string;
+    /**
+     * Which project (GitHub repository, `owner/repo`) this task belongs to.
+     *
+     * Required on the FIRST turn of a conversation on a code-mode agent, which
+     * binds it. A later turn may omit it or repeat the same value; a DIFFERENT
+     * value is refused (409), not ignored — a task is bound to one repository for
+     * life, so a different repository means a new task. Chat-mode agents ignore
+     * it entirely.
+     * Astralform >= 0.70.0.
+     */
+    repository?: string;
     mcp_manifest?: ToolDefinition[];
     enabled_mcp?: string[];
     continue_from_message?: string;
@@ -762,6 +791,37 @@ interface ChatStreamRequest {
     reasoning_effort?: ReasoningEffort;
     temperature?: number;
 }
+/** One repository an app user works with on a code-mode agent. */
+interface CodeProject {
+    repoFullName: string;
+    addedAt: string;
+}
+/** A repository the workspace's GitHub installations cover. */
+interface AvailableRepository {
+    fullName: string;
+    private: boolean;
+}
+/**
+ * What an app user may add, and why the list might be empty.
+ *
+ * `state` separates the three empty cases a picker must not conflate:
+ * `ok` (connected, covers nothing new), `not_installed` (no installation to ask)
+ * and `unavailable` (GitHub could not be reached — try again, do not tell the
+ * user they have no repositories). `totalCount` is the installations' raw total
+ * BEFORE already-added projects are subtracted, so it is not the list's length.
+ */
+interface AvailableRepositories {
+    state: "ok" | "unavailable" | "not_installed";
+    repositories: AvailableRepository[];
+    totalCount: number;
+    /**
+     * At least one of the workspace's GitHub installations could not be
+     * enumerated, so the list is missing whatever that one covers. It is NOT
+     * pagination — there is no next page to ask for. A picker should say some
+     * repositories may be missing rather than present the list as complete.
+     */
+    partial: boolean;
+}
 interface ToolResultRequest {
     conversation_id: string;
     message_id: string;
@@ -1003,6 +1063,16 @@ interface SendOptions$1 extends ModelChoiceOptions {
      * it's complete. Omit for a normal turn.
      */
     goal?: string;
+    /**
+     * The project this task belongs to (`owner/repo`), on a code-mode agent.
+     *
+     * Send it on the turn that STARTS a task; the binding is write-once, so a
+     * later turn may omit it or repeat the same value, and a DIFFERENT value is
+     * refused (409) rather than ignored. A first turn without it on a code-mode
+     * agent is refused too (400) — the run needs a repository before it can hold a
+     * credential scoped to one. Astralform >= 0.70.0.
+     */
+    repository?: string;
 }
 /**
  * A selectable model for one of the team's connected providers, from
@@ -1150,7 +1220,16 @@ declare class AstralformClient {
         ollama_connected: boolean;
     }>;
     getAgentStatus(): Promise<AgentStatus>;
-    getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
+    /**
+     * A page of conversations, newest-updated first.
+     *
+     * `options.repository` narrows to one project's tasks (`owner/repo`) on a
+     * code-mode agent — the same paging applies within the filter, so a client
+     * showing tasks per project pages each project separately.
+     */
+    getConversations(limit?: number, offset?: number, options?: {
+        repository?: string;
+    }): Promise<Conversation[]>;
     getMessages(conversationId: string): Promise<Message[]>;
     /**
      * Replace the title the server generated from the conversation's first turn.
@@ -1235,6 +1314,39 @@ declare class AstralformClient {
      * `getAgents()`, which lists the AI personas inside the active agent.
      */
     listAgents(teamId: string): Promise<TeamAgentSummary[]>;
+    /**
+     * The projects (GitHub repositories) this app user works with, and what they
+     * may add.
+     *
+     * A project list is per app user within a code-mode agent: the developer
+     * connects the workspace's GitHub account, and each user curates their own
+     * list from what that connection covers. Every method 404s on a chat-mode
+     * agent, so the surface is invisible rather than empty there.
+     */
+    readonly code: {
+        projects: {
+            /** This user's projects on the active agent, oldest first. */
+            list: () => Promise<CodeProject[]>;
+            /**
+             * What the workspace's GitHub installations cover, minus what this user
+             * has already added. Read `state` before the list: an empty `repositories`
+             * means something different in each of its three values.
+             */
+            available: () => Promise<AvailableRepositories>;
+            /**
+             * Add a repository. The server checks it against the workspace's own
+             * installations and answers a repository it cannot reach the same way it
+             * answers one owned by someone else — deliberately, so this call cannot be
+             * used to discover which organisations use Astralform.
+             */
+            add: (repoFullName: string) => Promise<CodeProject>;
+            /**
+             * Remove a project. Tasks already bound to that repository keep their
+             * binding — they simply stop grouping under it.
+             */
+            remove: (owner: string, repo: string) => Promise<void>;
+        };
+    };
     createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
     streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
     cancelJob(jobId: string): Promise<void>;
@@ -1707,6 +1819,17 @@ interface SendOptions extends ModelChoiceOptions {
      * goal objective the backend drives to completion. Omit for a normal turn.
      */
     goal?: string;
+    /**
+     * The project this task belongs to (`owner/repo`), on a code-mode agent.
+     *
+     * Write-once server-side, and the refusal is the part that matters: the FIRST
+     * turn binds the task, a later turn may omit it or repeat the same value, and
+     * a DIFFERENT value is refused (409) rather than ignored — silently acting on
+     * the wrong repository is the failure that rule exists to prevent. A first
+     * turn without it on a code-mode agent is refused too (400). Astralform
+     * >= 0.70.0.
+     */
+    repository?: string;
 }
 type StreamManagerEvent = {
     type: "stateChange";
@@ -2003,4 +2126,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 BlockDeltaPayload, CONVERSATION_PAGE_SIZE, type ChatEvent, ChatEventType, type ChatEventTypeValue, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SkillInfo, 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 ToolPermissionDeniedPayload, ToolRegistry, type ToolResult, type ToolResultRequest, 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, 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 CodeProject, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SkillInfo, 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 ToolPermissionDeniedPayload, ToolRegistry, type ToolResult, type ToolResultRequest, 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, isVoiceLLMMode, isVoicePolishMode, mapSseToChat, parseEmbeddedResource, parseVoicePolishFrame, replayEvents, streamJobSSE, translateDelta };

package/dist/index.d.ts

@@ -563,6 +563,12 @@ interface Conversation {
     messageCount: number;
     createdAt: string;
     updatedAt: string;
+    /**
+     * The project this task belongs to (`owner/repo`), or `null` for an ordinary
+     * conversation. Set on the first turn and immutable after. Absent (rather than
+     * null) from an Astralform older than 0.70.0.
+     */
+    repository?: string | null;
 }
 interface Message {
     id: string;
@@ -612,6 +618,18 @@ interface AgentInfo {
     isOrchestrator: boolean;
     isEnabled: boolean;
     avatarUrl?: string;
+    /**
+     * What the agent is for. A client shows Projects and Tasks only for `"code"`.
+     * Absent on Astralform older than 0.70.0 — treat that as `"chat"`, which is
+     * also the server's default.
+     *
+     * It is a property of the WORKSPACE, not of a persona: `GET /v1/agents` selects
+     * the workspace row itself and returns exactly one entry, so the mode is
+     * `agents[0].mode` rather than something that varies across the list. The
+     * workspace picker (`listAgents`) does not carry it, so a client learns an
+     * agent's mode after opening it.
+     */
+    mode?: "chat" | "code";
 }
 interface TeamSummary {
     id: string;
@@ -738,6 +756,17 @@ interface ModelChoiceOptions {
 interface ChatStreamRequest {
     message?: string;
     conversation_id?: string;
+    /**
+     * Which project (GitHub repository, `owner/repo`) this task belongs to.
+     *
+     * Required on the FIRST turn of a conversation on a code-mode agent, which
+     * binds it. A later turn may omit it or repeat the same value; a DIFFERENT
+     * value is refused (409), not ignored — a task is bound to one repository for
+     * life, so a different repository means a new task. Chat-mode agents ignore
+     * it entirely.
+     * Astralform >= 0.70.0.
+     */
+    repository?: string;
     mcp_manifest?: ToolDefinition[];
     enabled_mcp?: string[];
     continue_from_message?: string;
@@ -762,6 +791,37 @@ interface ChatStreamRequest {
     reasoning_effort?: ReasoningEffort;
     temperature?: number;
 }
+/** One repository an app user works with on a code-mode agent. */
+interface CodeProject {
+    repoFullName: string;
+    addedAt: string;
+}
+/** A repository the workspace's GitHub installations cover. */
+interface AvailableRepository {
+    fullName: string;
+    private: boolean;
+}
+/**
+ * What an app user may add, and why the list might be empty.
+ *
+ * `state` separates the three empty cases a picker must not conflate:
+ * `ok` (connected, covers nothing new), `not_installed` (no installation to ask)
+ * and `unavailable` (GitHub could not be reached — try again, do not tell the
+ * user they have no repositories). `totalCount` is the installations' raw total
+ * BEFORE already-added projects are subtracted, so it is not the list's length.
+ */
+interface AvailableRepositories {
+    state: "ok" | "unavailable" | "not_installed";
+    repositories: AvailableRepository[];
+    totalCount: number;
+    /**
+     * At least one of the workspace's GitHub installations could not be
+     * enumerated, so the list is missing whatever that one covers. It is NOT
+     * pagination — there is no next page to ask for. A picker should say some
+     * repositories may be missing rather than present the list as complete.
+     */
+    partial: boolean;
+}
 interface ToolResultRequest {
     conversation_id: string;
     message_id: string;
@@ -1003,6 +1063,16 @@ interface SendOptions$1 extends ModelChoiceOptions {
      * it's complete. Omit for a normal turn.
      */
     goal?: string;
+    /**
+     * The project this task belongs to (`owner/repo`), on a code-mode agent.
+     *
+     * Send it on the turn that STARTS a task; the binding is write-once, so a
+     * later turn may omit it or repeat the same value, and a DIFFERENT value is
+     * refused (409) rather than ignored. A first turn without it on a code-mode
+     * agent is refused too (400) — the run needs a repository before it can hold a
+     * credential scoped to one. Astralform >= 0.70.0.
+     */
+    repository?: string;
 }
 /**
  * A selectable model for one of the team's connected providers, from
@@ -1150,7 +1220,16 @@ declare class AstralformClient {
         ollama_connected: boolean;
     }>;
     getAgentStatus(): Promise<AgentStatus>;
-    getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
+    /**
+     * A page of conversations, newest-updated first.
+     *
+     * `options.repository` narrows to one project's tasks (`owner/repo`) on a
+     * code-mode agent — the same paging applies within the filter, so a client
+     * showing tasks per project pages each project separately.
+     */
+    getConversations(limit?: number, offset?: number, options?: {
+        repository?: string;
+    }): Promise<Conversation[]>;
     getMessages(conversationId: string): Promise<Message[]>;
     /**
      * Replace the title the server generated from the conversation's first turn.
@@ -1235,6 +1314,39 @@ declare class AstralformClient {
      * `getAgents()`, which lists the AI personas inside the active agent.
      */
     listAgents(teamId: string): Promise<TeamAgentSummary[]>;
+    /**
+     * The projects (GitHub repositories) this app user works with, and what they
+     * may add.
+     *
+     * A project list is per app user within a code-mode agent: the developer
+     * connects the workspace's GitHub account, and each user curates their own
+     * list from what that connection covers. Every method 404s on a chat-mode
+     * agent, so the surface is invisible rather than empty there.
+     */
+    readonly code: {
+        projects: {
+            /** This user's projects on the active agent, oldest first. */
+            list: () => Promise<CodeProject[]>;
+            /**
+             * What the workspace's GitHub installations cover, minus what this user
+             * has already added. Read `state` before the list: an empty `repositories`
+             * means something different in each of its three values.
+             */
+            available: () => Promise<AvailableRepositories>;
+            /**
+             * Add a repository. The server checks it against the workspace's own
+             * installations and answers a repository it cannot reach the same way it
+             * answers one owned by someone else — deliberately, so this call cannot be
+             * used to discover which organisations use Astralform.
+             */
+            add: (repoFullName: string) => Promise<CodeProject>;
+            /**
+             * Remove a project. Tasks already bound to that repository keep their
+             * binding — they simply stop grouping under it.
+             */
+            remove: (owner: string, repo: string) => Promise<void>;
+        };
+    };
     createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
     streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
     cancelJob(jobId: string): Promise<void>;
@@ -1707,6 +1819,17 @@ interface SendOptions extends ModelChoiceOptions {
      * goal objective the backend drives to completion. Omit for a normal turn.
      */
     goal?: string;
+    /**
+     * The project this task belongs to (`owner/repo`), on a code-mode agent.
+     *
+     * Write-once server-side, and the refusal is the part that matters: the FIRST
+     * turn binds the task, a later turn may omit it or repeat the same value, and
+     * a DIFFERENT value is refused (409) rather than ignored — silently acting on
+     * the wrong repository is the failure that rule exists to prevent. A first
+     * turn without it on a code-mode agent is refused too (400). Astralform
+     * >= 0.70.0.
+     */
+    repository?: string;
 }
 type StreamManagerEvent = {
     type: "stateChange";
@@ -2003,4 +2126,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 BlockDeltaPayload, CONVERSATION_PAGE_SIZE, type ChatEvent, ChatEventType, type ChatEventTypeValue, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SkillInfo, 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 ToolPermissionDeniedPayload, ToolRegistry, type ToolResult, type ToolResultRequest, 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, 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 CodeProject, ConnectionError, type ContextUpdatePayload, type ContextWarningPayload, type Conversation, type ConversationAsset, type ConversationEvent, type DesktopStreamPayload, type EffortRung, type EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type ModelChoiceOptions, type ModelOption, type MyToolGrantsPage, type NoteUpdatePayload, type PlanUpdatePayload, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type ReasoningEffort, type SendOptions, ServerError, type SkillInfo, 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 ToolPermissionDeniedPayload, ToolRegistry, type ToolResult, type ToolResultRequest, 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, isVoiceLLMMode, isVoicePolishMode, mapSseToChat, parseEmbeddedResource, parseVoicePolishFrame, replayEvents, streamJobSSE, translateDelta };

package/dist/index.js

@@ -338,6 +338,69 @@ function isApiKeyConfig(config) {
 }
 var AstralformClient = class {
   constructor(config) {
+    // --- Code mode: the app user's projects ---
+    /**
+     * The projects (GitHub repositories) this app user works with, and what they
+     * may add.
+     *
+     * A project list is per app user within a code-mode agent: the developer
+     * connects the workspace's GitHub account, and each user curates their own
+     * list from what that connection covers. Every method 404s on a chat-mode
+     * agent, so the surface is invisible rather than empty there.
+     */
+    this.code = {
+      projects: {
+        /** This user's projects on the active agent, oldest first. */
+        list: async () => {
+          const raw = await this.get(
+            "/v1/code/projects"
+          );
+          return raw.map((p) => camelizeKeys(p));
+        },
+        /**
+         * What the workspace's GitHub installations cover, minus what this user
+         * has already added. Read `state` before the list: an empty `repositories`
+         * means something different in each of its three values.
+         */
+        available: async () => {
+          const raw = await this.get("/v1/code/projects/available");
+          return {
+            state: raw.state,
+            repositories: (raw.repositories ?? []).map((r) => ({
+              fullName: r.full_name,
+              private: r.private
+            })),
+            // Defaulted like its neighbours: the `unavailable` branch has nothing
+            // to count, and an absent field behind a `number` type prints
+            // "undefined" in a picker rather than a number.
+            totalCount: raw.total_count ?? 0,
+            partial: raw.partial ?? false
+          };
+        },
+        /**
+         * Add a repository. The server checks it against the workspace's own
+         * installations and answers a repository it cannot reach the same way it
+         * answers one owned by someone else — deliberately, so this call cannot be
+         * used to discover which organisations use Astralform.
+         */
+        add: async (repoFullName) => {
+          const raw = await this.post(
+            "/v1/code/projects",
+            { repo_full_name: repoFullName }
+          );
+          return camelizeKeys(raw);
+        },
+        /**
+         * Remove a project. Tasks already bound to that repository keep their
+         * binding — they simply stop grouping under it.
+         */
+        remove: async (owner, repo) => {
+          await this.del(
+            `/v1/code/projects/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`
+          );
+        }
+      }
+    };
     if (isApiKeyConfig(config)) {
       if (!config.apiKey || typeof config.apiKey !== "string") {
         throw new Error("apiKey is required and must be a non-empty string");
@@ -578,10 +641,18 @@ var AstralformClient = class {
       }
     };
   }
-  async getConversations(limit = 50, offset = 0) {
+  /**
+   * A page of conversations, newest-updated first.
+   *
+   * `options.repository` narrows to one project's tasks (`owner/repo`) on a
+   * code-mode agent — the same paging applies within the filter, so a client
+   * showing tasks per project pages each project separately.
+   */
+  async getConversations(limit = 50, offset = 0, options) {
     const safeLimit = Math.max(1, Math.min(200, Math.floor(Number(limit))));
     const safeOffset = Math.max(0, Math.floor(Number(offset)));
-    const raw = await this.get(`/v1/conversations?limit=${safeLimit}&offset=${safeOffset}`);
+    const filter = options?.repository ? `&repository=${encodeURIComponent(options.repository)}` : "";
+    const raw = await this.get(`/v1/conversations?limit=${safeLimit}&offset=${safeOffset}${filter}`);
     return raw.map((c) => camelizeKeys(c));
   }
   async getMessages(conversationId) {
@@ -1676,6 +1747,9 @@ var ChatSession = class {
       image_mode: options?.imageMode,
       video_mode: options?.videoMode,
       goal: options?.goal,
+      // The project this task belongs to, on a code-mode agent. Write-once
+      // server-side: sent on every turn, honoured on the first.
+      repository: options?.repository,
       // Per-request model choice (client-side model selection).
       provider: options?.provider,
       model: options?.model,
@@ -2528,23 +2602,8 @@ var StreamManager = class {
     this.setState("streaming");
     try {
       await this.session.send(content, {
-        // Address the send explicitly. `ChatSession.send` otherwise falls back
-        // to `session.conversationId`, which LAGS this pointer: a restore
-        // assigns it synchronously but only reaches the next switch's own
-        // `loadConversation` an await later, so between the two the session
-        // still names the conversation the user left. The manager's pointer
-        // moved the moment the user clicked; it is the authority.
-        conversationId: target ?? void 0,
-        agentName: options?.agentName,
-        uploadIds: options?.uploadIds,
-        planMode: options?.planMode,
-        imageMode: options?.imageMode,
-        videoMode: options?.videoMode,
-        goal: options?.goal,
-        provider: options?.provider,
-        model: options?.model,
-        reasoningEffort: options?.reasoningEffort,
-        temperature: options?.temperature
+        ...options,
+        conversationId: target ?? void 0
       });
     } catch {
     }