@astralform/js 1.2.0 → 2.0.0

package/dist/index.d.cts

@@ -122,7 +122,7 @@ interface AstralformBaseConfig {
     fetch?: typeof globalThis.fetch;
 }
 interface AstralformApiKeyConfig extends AstralformBaseConfig {
-    /** Project API key (`sk_live_...` or `sk_test_...`). */
+    /** Agent API key (`sk_live_...` or `sk_test_...`). */
     apiKey: string;
     /**
      * The customer's own identifier for the end user making this call.
@@ -138,16 +138,16 @@ interface AstralformUserTokenConfig extends AstralformBaseConfig {
      */
     accessToken: string;
     /**
-     * Active project context. Sent as the `X-Project-ID` header. The backend
-     * verifies the token's developer has access to this project on every
-     * request; switching projects is a local `updateProjectId()` call.
+     * Active agent context. Sent as the `X-Project-ID` header (legacy wire name). The backend
+     * verifies the token's developer has access to this agent on every
+     * request; switching agents is a local `updateAgentId()` call.
      *
      * Optional so a pre-pick client (right after login, before the user has
-     * chosen a team/project) can still call account-scoped discovery routes
-     * like `listTeams()` / `listProjects(teamId)`. Project-scoped calls
+     * chosen a team/agent) can still call account-scoped discovery routes
+     * like `listTeams()` / `listAgents(teamId)`. Agent-scoped calls
      * (conversations, messages, chat) will error out until one is set.
      */
-    projectId?: string;
+    agentId?: string;
     /**
      * Optional end-user override — lets a developer acting under a user
      * token impersonate a downstream end-user identity for testing
@@ -533,7 +533,7 @@ interface UIComponentsConfig {
     /** MIME type to match against embedded resources (e.g. "application/json+a2ui"). */
     mimeType: string | null;
 }
-interface ProjectStatus {
+interface AgentStatus {
     isReady: boolean;
     llmConfigured: boolean;
     llmProvider?: string;
@@ -557,7 +557,12 @@ interface TeamSummary {
     /** Caller's role in this team (e.g. "owner", "admin", "member"). */
     role: string;
 }
-interface ProjectSummary {
+/**
+ * A team-level agent (formerly "project") — the workspace a user opens to
+ * chat. Distinct from `AgentInfo`, which describes the AI personas available
+ * INSIDE an agent workspace (orchestrator + specialists).
+ */
+interface TeamAgentSummary {
     id: string;
     name: string;
     teamId: string;
@@ -717,7 +722,7 @@ declare class AstralformClient {
     private readonly fetchFn;
     /**
      * Auth state is mutable so callers can rotate access tokens or switch
-     * project context without re-instantiating the client. API-key mode is
+     * agent context without re-instantiating the client. API-key mode is
      * effectively immutable in practice but uses the same shape for uniformity.
      */
     private auth;
@@ -729,10 +734,10 @@ declare class AstralformClient {
      */
     updateAccessToken(accessToken: string): void;
     /**
-     * Swap the active project for a user-token client. The backend verifies the
-     * current developer has access to the new project; a 403 comes back if not.
+     * Swap the active agent for a user-token client. The backend verifies the
+     * current developer has access to the new agent; a 403 comes back if not.
      */
-    updateProjectId(projectId: string): void;
+    updateAgentId(agentId: string): void;
     /**
      * Set (or clear) the end-user override for user-token mode.
      *
@@ -745,12 +750,12 @@ declare class AstralformClient {
     /** Current end-user override in user-token mode, or `null` if unset. */
     get endUserId(): string | null;
     /**
-     * Active project for user-token mode, or `null` if pre-pick (client
-     * was constructed without one). For API-key mode the project is baked
+     * Active agent for user-token mode, or `null` if pre-pick (client
+     * was constructed without one). For API-key mode the agent is baked
      * into the key, so this getter returns `null` there too — use
      * `authMode` to disambiguate.
      */
-    get projectId(): string | null;
+    get agentId(): string | null;
     /** Which auth mode this client was constructed with. */
     get authMode(): "api_key" | "user_token";
     /**
@@ -771,10 +776,16 @@ declare class AstralformClient {
         version: string;
         ollama_connected: boolean;
     }>;
-    getProjectStatus(): Promise<ProjectStatus>;
+    getAgentStatus(): Promise<AgentStatus>;
     getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
     getMessages(conversationId: string): Promise<Message[]>;
     deleteConversation(id: string): Promise<void>;
+    /**
+     * List the AI personas (sub-agents) available INSIDE the client's active
+     * agent workspace — orchestrator + specialists, addressed per message via
+     * `ChatStreamRequest.agent_name`. Not to be confused with `listAgents()`,
+     * which enumerates the team-level agents a signed-in user can open.
+     */
     getAgents(): Promise<AgentInfo[]>;
     getSkills(): Promise<SkillInfo[]>;
     getConversationEvents(conversationId: string, jobId?: string): Promise<ConversationEvent[]>;
@@ -800,7 +811,12 @@ declare class AstralformClient {
     listUploads(conversationId: string): Promise<ConversationAsset[]>;
     listOutputs(conversationId: string): Promise<ConversationAsset[]>;
     listTeams(): Promise<TeamSummary[]>;
-    listProjects(teamId: string): Promise<ProjectSummary[]>;
+    /**
+     * List the team-level agents (formerly "projects") the signed-in user can
+     * open — the pickable workspaces under a team. Not to be confused with
+     * `getAgents()`, which lists the AI personas inside the active agent.
+     */
+    listAgents(teamId: string): Promise<TeamAgentSummary[]>;
     createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
     streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
     cancelJob(jobId: string): Promise<void>;
@@ -887,7 +903,7 @@ declare class ChatSession {
     /**
      * Pluggable UI protocol adapters. Consumers register a framework-
      * specific adapter (e.g. React) for each MIME type they can render,
-     * typically gated on ``session.projectStatus.uiComponents.protocol``.
+     * typically gated on ``session.agentStatus.uiComponents.protocol``.
      * ``ToolBlock``-style consumers look up the adapter for an incoming
      * embedded resource and hand off rendering.
      */
@@ -896,7 +912,7 @@ declare class ChatSession {
     conversations: Conversation[];
     messages: Message[];
     isStreaming: boolean;
-    projectStatus: ProjectStatus | null;
+    agentStatus: AgentStatus | null;
     agents: AgentInfo[];
     skills: SkillInfo[];
     enabledClientTools: Set<string>;
@@ -1175,4 +1191,4 @@ declare function isEmbeddedResource(value: unknown): value is {
  */
 declare function parseEmbeddedResource(value: unknown): EmbeddedResource | null;
 
-export { type ActiveJob, type AgentIdentity, type AgentInfo, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type BlockDeltaPayload, 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 EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MyToolGrantsPage, type ProjectStatus, type ProjectSummary, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type SendOptions, ServerError, type SkillInfo, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamSummary, 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, 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, mapSseToChat, parseEmbeddedResource, replayEvents, streamJobSSE, translateDelta };
+export { type ActiveJob, type AgentIdentity, type AgentInfo, type AgentStatus, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type BlockDeltaPayload, 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 EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MyToolGrantsPage, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type SendOptions, ServerError, type SkillInfo, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamAgentSummary, type TeamSummary, 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, 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, mapSseToChat, parseEmbeddedResource, replayEvents, streamJobSSE, translateDelta };

package/dist/index.d.ts

@@ -122,7 +122,7 @@ interface AstralformBaseConfig {
     fetch?: typeof globalThis.fetch;
 }
 interface AstralformApiKeyConfig extends AstralformBaseConfig {
-    /** Project API key (`sk_live_...` or `sk_test_...`). */
+    /** Agent API key (`sk_live_...` or `sk_test_...`). */
     apiKey: string;
     /**
      * The customer's own identifier for the end user making this call.
@@ -138,16 +138,16 @@ interface AstralformUserTokenConfig extends AstralformBaseConfig {
      */
     accessToken: string;
     /**
-     * Active project context. Sent as the `X-Project-ID` header. The backend
-     * verifies the token's developer has access to this project on every
-     * request; switching projects is a local `updateProjectId()` call.
+     * Active agent context. Sent as the `X-Project-ID` header (legacy wire name). The backend
+     * verifies the token's developer has access to this agent on every
+     * request; switching agents is a local `updateAgentId()` call.
      *
      * Optional so a pre-pick client (right after login, before the user has
-     * chosen a team/project) can still call account-scoped discovery routes
-     * like `listTeams()` / `listProjects(teamId)`. Project-scoped calls
+     * chosen a team/agent) can still call account-scoped discovery routes
+     * like `listTeams()` / `listAgents(teamId)`. Agent-scoped calls
      * (conversations, messages, chat) will error out until one is set.
      */
-    projectId?: string;
+    agentId?: string;
     /**
      * Optional end-user override — lets a developer acting under a user
      * token impersonate a downstream end-user identity for testing
@@ -533,7 +533,7 @@ interface UIComponentsConfig {
     /** MIME type to match against embedded resources (e.g. "application/json+a2ui"). */
     mimeType: string | null;
 }
-interface ProjectStatus {
+interface AgentStatus {
     isReady: boolean;
     llmConfigured: boolean;
     llmProvider?: string;
@@ -557,7 +557,12 @@ interface TeamSummary {
     /** Caller's role in this team (e.g. "owner", "admin", "member"). */
     role: string;
 }
-interface ProjectSummary {
+/**
+ * A team-level agent (formerly "project") — the workspace a user opens to
+ * chat. Distinct from `AgentInfo`, which describes the AI personas available
+ * INSIDE an agent workspace (orchestrator + specialists).
+ */
+interface TeamAgentSummary {
     id: string;
     name: string;
     teamId: string;
@@ -717,7 +722,7 @@ declare class AstralformClient {
     private readonly fetchFn;
     /**
      * Auth state is mutable so callers can rotate access tokens or switch
-     * project context without re-instantiating the client. API-key mode is
+     * agent context without re-instantiating the client. API-key mode is
      * effectively immutable in practice but uses the same shape for uniformity.
      */
     private auth;
@@ -729,10 +734,10 @@ declare class AstralformClient {
      */
     updateAccessToken(accessToken: string): void;
     /**
-     * Swap the active project for a user-token client. The backend verifies the
-     * current developer has access to the new project; a 403 comes back if not.
+     * Swap the active agent for a user-token client. The backend verifies the
+     * current developer has access to the new agent; a 403 comes back if not.
      */
-    updateProjectId(projectId: string): void;
+    updateAgentId(agentId: string): void;
     /**
      * Set (or clear) the end-user override for user-token mode.
      *
@@ -745,12 +750,12 @@ declare class AstralformClient {
     /** Current end-user override in user-token mode, or `null` if unset. */
     get endUserId(): string | null;
     /**
-     * Active project for user-token mode, or `null` if pre-pick (client
-     * was constructed without one). For API-key mode the project is baked
+     * Active agent for user-token mode, or `null` if pre-pick (client
+     * was constructed without one). For API-key mode the agent is baked
      * into the key, so this getter returns `null` there too — use
      * `authMode` to disambiguate.
      */
-    get projectId(): string | null;
+    get agentId(): string | null;
     /** Which auth mode this client was constructed with. */
     get authMode(): "api_key" | "user_token";
     /**
@@ -771,10 +776,16 @@ declare class AstralformClient {
         version: string;
         ollama_connected: boolean;
     }>;
-    getProjectStatus(): Promise<ProjectStatus>;
+    getAgentStatus(): Promise<AgentStatus>;
     getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
     getMessages(conversationId: string): Promise<Message[]>;
     deleteConversation(id: string): Promise<void>;
+    /**
+     * List the AI personas (sub-agents) available INSIDE the client's active
+     * agent workspace — orchestrator + specialists, addressed per message via
+     * `ChatStreamRequest.agent_name`. Not to be confused with `listAgents()`,
+     * which enumerates the team-level agents a signed-in user can open.
+     */
     getAgents(): Promise<AgentInfo[]>;
     getSkills(): Promise<SkillInfo[]>;
     getConversationEvents(conversationId: string, jobId?: string): Promise<ConversationEvent[]>;
@@ -800,7 +811,12 @@ declare class AstralformClient {
     listUploads(conversationId: string): Promise<ConversationAsset[]>;
     listOutputs(conversationId: string): Promise<ConversationAsset[]>;
     listTeams(): Promise<TeamSummary[]>;
-    listProjects(teamId: string): Promise<ProjectSummary[]>;
+    /**
+     * List the team-level agents (formerly "projects") the signed-in user can
+     * open — the pickable workspaces under a team. Not to be confused with
+     * `getAgents()`, which lists the AI personas inside the active agent.
+     */
+    listAgents(teamId: string): Promise<TeamAgentSummary[]>;
     createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
     streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
     cancelJob(jobId: string): Promise<void>;
@@ -887,7 +903,7 @@ declare class ChatSession {
     /**
      * Pluggable UI protocol adapters. Consumers register a framework-
      * specific adapter (e.g. React) for each MIME type they can render,
-     * typically gated on ``session.projectStatus.uiComponents.protocol``.
+     * typically gated on ``session.agentStatus.uiComponents.protocol``.
      * ``ToolBlock``-style consumers look up the adapter for an incoming
      * embedded resource and hand off rendering.
      */
@@ -896,7 +912,7 @@ declare class ChatSession {
     conversations: Conversation[];
     messages: Message[];
     isStreaming: boolean;
-    projectStatus: ProjectStatus | null;
+    agentStatus: AgentStatus | null;
     agents: AgentInfo[];
     skills: SkillInfo[];
     enabledClientTools: Set<string>;
@@ -1175,4 +1191,4 @@ declare function isEmbeddedResource(value: unknown): value is {
  */
 declare function parseEmbeddedResource(value: unknown): EmbeddedResource | null;
 
-export { type ActiveJob, type AgentIdentity, type AgentInfo, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type BlockDeltaPayload, 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 EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MyToolGrantsPage, type ProjectStatus, type ProjectSummary, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type SendOptions, ServerError, type SkillInfo, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamSummary, 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, 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, mapSseToChat, parseEmbeddedResource, replayEvents, streamJobSSE, translateDelta };
+export { type ActiveJob, type AgentIdentity, type AgentInfo, type AgentStatus, type AssetCreatedPayload, type AstralformApiKeyConfig, AstralformClient, type AstralformConfig, AstralformError, type AstralformUserTokenConfig, type AttachmentStagedPayload, AuthenticationError, type BlockDeltaPayload, 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 EmbeddedResource, type FeedbackRequest, type FeedbackResponse, InMemoryStorage, type JobCreateResponse, type JobStatus, type JobSummary, LLMNotConfiguredError, type MemoryRecallPayload, type MemoryRecord, type MemoryUpdatePayload, type Message, type MyToolGrantsPage, type PromptSuggestionPayload, type ProtocolAdapter, ProtocolRegistry, RateLimitError, type RateLimitErrorDetails, type RawSseEvent, type SendOptions, ServerError, type SkillInfo, StreamAbortedError, type StreamJobSSEOptions, StreamManager, type StreamManagerEvent, type StreamState, type SubagentStartPayload, type SubagentStopPayload, type TaskStatus, type TeamAgentSummary, type TeamSummary, 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, 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, mapSseToChat, parseEmbeddedResource, replayEvents, streamJobSSE, translateDelta };

package/dist/index.js

@@ -20,7 +20,7 @@ var RateLimitError = class extends AstralformError {
   }
 };
 var LLMNotConfiguredError = class extends AstralformError {
-  constructor(message = "LLM provider not configured for this project") {
+  constructor(message = "LLM provider not configured for this agent") {
     super(message, "llm_not_configured");
     this.name = "LLMNotConfiguredError";
   }
@@ -292,11 +292,11 @@ var AstralformClient = class {
           "accessToken is required and must be a non-empty string in user-token mode"
         );
       }
-      const projectId = typeof config.projectId === "string" && config.projectId.length > 0 ? config.projectId : null;
+      const agentId = typeof config.agentId === "string" && config.agentId.length > 0 ? config.agentId : null;
       this.auth = {
         kind: "user_token",
         accessToken: config.accessToken,
-        projectId,
+        agentId,
         endUserId: typeof config.endUserId === "string" && config.endUserId.length > 0 ? config.endUserId : null
       };
     }
@@ -318,17 +318,17 @@ var AstralformClient = class {
     this.auth = { ...this.auth, accessToken };
   }
   /**
-   * Swap the active project for a user-token client. The backend verifies the
-   * current developer has access to the new project; a 403 comes back if not.
+   * Swap the active agent for a user-token client. The backend verifies the
+   * current developer has access to the new agent; a 403 comes back if not.
    */
-  updateProjectId(projectId) {
+  updateAgentId(agentId) {
     if (this.auth.kind !== "user_token") {
-      throw new Error("updateProjectId is only valid in user-token mode");
+      throw new Error("updateAgentId is only valid in user-token mode");
     }
-    if (!projectId || typeof projectId !== "string") {
-      throw new Error("projectId must be a non-empty string");
+    if (!agentId || typeof agentId !== "string") {
+      throw new Error("agentId must be a non-empty string");
     }
-    this.auth = { ...this.auth, projectId };
+    this.auth = { ...this.auth, agentId };
   }
   /**
    * Set (or clear) the end-user override for user-token mode.
@@ -350,13 +350,13 @@ var AstralformClient = class {
     return this.auth.kind === "user_token" ? this.auth.endUserId : null;
   }
   /**
-   * Active project for user-token mode, or `null` if pre-pick (client
-   * was constructed without one). For API-key mode the project is baked
+   * Active agent for user-token mode, or `null` if pre-pick (client
+   * was constructed without one). For API-key mode the agent is baked
    * into the key, so this getter returns `null` there too — use
    * `authMode` to disambiguate.
    */
-  get projectId() {
-    return this.auth.kind === "user_token" ? this.auth.projectId : null;
+  get agentId() {
+    return this.auth.kind === "user_token" ? this.auth.agentId : null;
   }
   /** Which auth mode this client was constructed with. */
   get authMode() {
@@ -378,8 +378,8 @@ var AstralformClient = class {
     const headers = {
       Authorization: `Bearer ${this.auth.accessToken}`
     };
-    if (this.auth.projectId) {
-      headers["X-Project-ID"] = this.auth.projectId;
+    if (this.auth.agentId) {
+      headers["X-Project-ID"] = this.auth.agentId;
     }
     if (this.auth.endUserId) {
       headers["X-End-User-ID"] = this.auth.endUserId;
@@ -434,7 +434,9 @@ var AstralformClient = class {
   async getHealth() {
     return this.get("/v1/health");
   }
-  async getProjectStatus() {
+  // Agent readiness check. The path is a legacy wire name (shared with the
+  // iOS SDK) — it scopes to the client's active agent via X-Project-ID.
+  async getAgentStatus() {
     const raw = await this.get("/v1/project/status");
     const ui = raw.ui_components ?? {};
     return {
@@ -477,6 +479,12 @@ var AstralformClient = class {
   async deleteConversation(id) {
     await this.del(`/v1/conversations/${encodeURIComponent(id)}`);
   }
+  /**
+   * List the AI personas (sub-agents) available INSIDE the client's active
+   * agent workspace — orchestrator + specialists, addressed per message via
+   * `ChatStreamRequest.agent_name`. Not to be confused with `listAgents()`,
+   * which enumerates the team-level agents a signed-in user can open.
+   */
   async getAgents() {
     const raw = await this.get("/v1/agents");
     return raw.map((a) => ({
@@ -598,7 +606,7 @@ var AstralformClient = class {
   }
   // --- Account-scoped discovery (user-token mode) ---
   //
-  // Lets a signed-in user pick which team/project they want to act on.
+  // Lets a signed-in user pick which team/agent they want to act on.
   // Backend gates these on OIDC user context (no X-Project-ID required) —
   // sending them in API-key mode yields 401.
   async listTeams() {
@@ -611,14 +619,19 @@ var AstralformClient = class {
       role: t.role
     }));
   }
-  async listProjects(teamId) {
-    const raw = await this.get(`/v1/teams/${encodeURIComponent(teamId)}/projects`);
-    return raw.map((p) => ({
-      id: p.id,
-      name: p.name,
-      teamId: p.team_id,
-      createdAt: p.created_at,
-      updatedAt: p.updated_at
+  /**
+   * List the team-level agents (formerly "projects") the signed-in user can
+   * open — the pickable workspaces under a team. Not to be confused with
+   * `getAgents()`, which lists the AI personas inside the active agent.
+   */
+  async listAgents(teamId) {
+    const raw = await this.get(`/v1/teams/${encodeURIComponent(teamId)}/agents`);
+    return raw.map((a) => ({
+      id: a.id,
+      name: a.name,
+      teamId: a.team_id,
+      createdAt: a.created_at,
+      updatedAt: a.updated_at
     }));
   }
   // --- Jobs API ---
@@ -1161,7 +1174,7 @@ var ChatSession = class {
     /**
      * Pluggable UI protocol adapters. Consumers register a framework-
      * specific adapter (e.g. React) for each MIME type they can render,
-     * typically gated on ``session.projectStatus.uiComponents.protocol``.
+     * typically gated on ``session.agentStatus.uiComponents.protocol``.
      * ``ToolBlock``-style consumers look up the adapter for an incoming
      * embedded resource and hand off rendering.
      */
@@ -1171,7 +1184,7 @@ var ChatSession = class {
     this.conversations = [];
     this.messages = [];
     this.isStreaming = false;
-    this.projectStatus = null;
+    this.agentStatus = null;
     this.agents = [];
     this.skills = [];
     this.enabledClientTools = /* @__PURE__ */ new Set();
@@ -1214,13 +1227,13 @@ var ChatSession = class {
   }
   async connect() {
     const [status, conversations, agents, skills] = await Promise.allSettled([
-      this.client.getProjectStatus(),
+      this.client.getAgentStatus(),
       this.client.getConversations(),
       this.client.getAgents().catch(() => []),
       this.client.getSkills().catch(() => [])
     ]);
     if (status.status === "fulfilled") {
-      this.projectStatus = status.value;
+      this.agentStatus = status.value;
     }
     if (conversations.status === "fulfilled") {
       this.conversations = conversations.value;