@astralform/js 4.6.1 → 4.8.0

package/dist/index.d.cts

@@ -19,6 +19,16 @@ interface TodoItem {
 interface TodoUpdatePayload {
     todos: TodoItem[];
 }
+/** The conversation's plan, as markdown, after the agent wrote or revised it.
+ *  Full body rather than a diff — `write_plan` replaces the document wholesale. */
+interface PlanUpdatePayload {
+    plan: string;
+}
+/** Names of the conversation's notes, after one was written or deleted.
+ *  Names only; bodies are unbounded and read on demand. */
+interface NoteUpdatePayload {
+    notes: string[];
+}
 interface TitleGeneratedPayload {
     title: string;
 }
@@ -188,6 +198,8 @@ declare const ChatEventType: {
     readonly UserMessage: "user_message";
     readonly TitleGenerated: "title_generated";
     readonly TodoUpdate: "todo_update";
+    readonly PlanUpdate: "plan_update";
+    readonly NoteUpdate: "note_update";
     readonly ContextUpdate: "context_update";
     readonly SubagentStart: "subagent_start";
     readonly SubagentStop: "subagent_stop";
@@ -432,6 +444,20 @@ type ChatEvent = {
 } | {
     type: "todo_update";
     todos: TodoItem[];
+}
+/** The conversation's plan, as markdown, after the agent wrote or revised it.
+ *  Carries the FULL body rather than a diff: the backend replaces the plan
+ *  wholesale (`write_plan` — "Replaces any existing plan"), so a consumer that
+ *  merged deltas would drift from the stored document. */
+ | {
+    type: "plan_update";
+    plan: string;
+}
+/** Names of the conversation's notes, after one was written or deleted. Names
+ *  only — bodies are unbounded and read on demand. */
+ | {
+    type: "note_update";
+    notes: string[];
 } | {
     type: "context_update";
     context: Record<string, unknown>;
@@ -889,6 +915,7 @@ declare class AstralformClient {
     private send;
     get<T>(path: string): Promise<T>;
     post<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
     private del;
     private handleError;
     getHealth(): Promise<{
@@ -899,6 +926,16 @@ declare class AstralformClient {
     getAgentStatus(): Promise<AgentStatus>;
     getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
     getMessages(conversationId: string): Promise<Message[]>;
+    /**
+     * Replace the title the server generated from the conversation's first turn.
+     *
+     * The server does NOT bump `updated_at` for a rename — conversations list
+     * newest-updated first, and relabelling one is not activity — so the
+     * timestamp coming back is the original. Callers should merge the response
+     * rather than stamp their own, or they reintroduce the reordering the
+     * server deliberately avoids.
+     */
+    renameConversation(id: string, title: string): Promise<Conversation>;
     deleteConversation(id: string): Promise<void>;
     /**
      * List the AI personas (sub-agents) available INSIDE the client's active
@@ -1223,6 +1260,19 @@ declare class ChatSession {
      * already scanned.
      */
     loadMoreConversations(): Promise<Conversation[]>;
+    /**
+     * Rename a conversation, server first.
+     *
+     * Deliberately NOT optimistic, unlike the delete below. A failed delete is
+     * self-correcting (the row is still there on the next page fetch), but a
+     * failed rename that had already been written locally would leave the
+     * sidebar showing a title the server never accepted — and nothing refetches
+     * a conversation that is already in the loaded list.
+     *
+     * Mirrors the `title_generated` path: the entry in `conversations` is
+     * mutated in place, which is what every consumer of the list reads.
+     */
+    renameConversation(id: string, title: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
     toggleClientTool(name: string): boolean;
 }
@@ -1349,6 +1399,11 @@ declare class StreamManager {
         skipHistoryReplay?: boolean;
     }): Promise<void>;
     createConversation(): Promise<string>;
+    /**
+     * Rename a conversation. Purely a relabel — no active-conversation or
+     * background-job bookkeeping to do, unlike delete, so this is a passthrough.
+     */
+    renameConversation(id: string, title: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
     stop(): void;
     destroy(): void;
@@ -1441,4 +1496,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 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 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 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 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 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 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

@@ -19,6 +19,16 @@ interface TodoItem {
 interface TodoUpdatePayload {
     todos: TodoItem[];
 }
+/** The conversation's plan, as markdown, after the agent wrote or revised it.
+ *  Full body rather than a diff — `write_plan` replaces the document wholesale. */
+interface PlanUpdatePayload {
+    plan: string;
+}
+/** Names of the conversation's notes, after one was written or deleted.
+ *  Names only; bodies are unbounded and read on demand. */
+interface NoteUpdatePayload {
+    notes: string[];
+}
 interface TitleGeneratedPayload {
     title: string;
 }
@@ -188,6 +198,8 @@ declare const ChatEventType: {
     readonly UserMessage: "user_message";
     readonly TitleGenerated: "title_generated";
     readonly TodoUpdate: "todo_update";
+    readonly PlanUpdate: "plan_update";
+    readonly NoteUpdate: "note_update";
     readonly ContextUpdate: "context_update";
     readonly SubagentStart: "subagent_start";
     readonly SubagentStop: "subagent_stop";
@@ -432,6 +444,20 @@ type ChatEvent = {
 } | {
     type: "todo_update";
     todos: TodoItem[];
+}
+/** The conversation's plan, as markdown, after the agent wrote or revised it.
+ *  Carries the FULL body rather than a diff: the backend replaces the plan
+ *  wholesale (`write_plan` — "Replaces any existing plan"), so a consumer that
+ *  merged deltas would drift from the stored document. */
+ | {
+    type: "plan_update";
+    plan: string;
+}
+/** Names of the conversation's notes, after one was written or deleted. Names
+ *  only — bodies are unbounded and read on demand. */
+ | {
+    type: "note_update";
+    notes: string[];
 } | {
     type: "context_update";
     context: Record<string, unknown>;
@@ -889,6 +915,7 @@ declare class AstralformClient {
     private send;
     get<T>(path: string): Promise<T>;
     post<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
     private del;
     private handleError;
     getHealth(): Promise<{
@@ -899,6 +926,16 @@ declare class AstralformClient {
     getAgentStatus(): Promise<AgentStatus>;
     getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
     getMessages(conversationId: string): Promise<Message[]>;
+    /**
+     * Replace the title the server generated from the conversation's first turn.
+     *
+     * The server does NOT bump `updated_at` for a rename — conversations list
+     * newest-updated first, and relabelling one is not activity — so the
+     * timestamp coming back is the original. Callers should merge the response
+     * rather than stamp their own, or they reintroduce the reordering the
+     * server deliberately avoids.
+     */
+    renameConversation(id: string, title: string): Promise<Conversation>;
     deleteConversation(id: string): Promise<void>;
     /**
      * List the AI personas (sub-agents) available INSIDE the client's active
@@ -1223,6 +1260,19 @@ declare class ChatSession {
      * already scanned.
      */
     loadMoreConversations(): Promise<Conversation[]>;
+    /**
+     * Rename a conversation, server first.
+     *
+     * Deliberately NOT optimistic, unlike the delete below. A failed delete is
+     * self-correcting (the row is still there on the next page fetch), but a
+     * failed rename that had already been written locally would leave the
+     * sidebar showing a title the server never accepted — and nothing refetches
+     * a conversation that is already in the loaded list.
+     *
+     * Mirrors the `title_generated` path: the entry in `conversations` is
+     * mutated in place, which is what every consumer of the list reads.
+     */
+    renameConversation(id: string, title: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
     toggleClientTool(name: string): boolean;
 }
@@ -1349,6 +1399,11 @@ declare class StreamManager {
         skipHistoryReplay?: boolean;
     }): Promise<void>;
     createConversation(): Promise<string>;
+    /**
+     * Rename a conversation. Purely a relabel — no active-conversation or
+     * background-job bookkeeping to do, unlike delete, so this is a passthrough.
+     */
+    renameConversation(id: string, title: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
     stop(): void;
     destroy(): void;
@@ -1441,4 +1496,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 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 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 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 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 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 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

@@ -460,6 +460,12 @@ var AstralformClient = class {
       return await response.json();
     });
   }
+  async patch(path, body) {
+    return this.withDeadline(async (signal) => {
+      const response = await this.send("PATCH", path, body, signal);
+      return await response.json();
+    });
+  }
   async del(path) {
     await this.request("DELETE", path);
   }
@@ -530,6 +536,25 @@ var AstralformClient = class {
       createdAt: m.created_at
     }));
   }
+  /**
+   * Replace the title the server generated from the conversation's first turn.
+   *
+   * The server does NOT bump `updated_at` for a rename — conversations list
+   * newest-updated first, and relabelling one is not activity — so the
+   * timestamp coming back is the original. Callers should merge the response
+   * rather than stamp their own, or they reintroduce the reordering the
+   * server deliberately avoids.
+   */
+  async renameConversation(id, title) {
+    const c = await this.patch(`/v1/conversations/${encodeURIComponent(id)}`, { title });
+    return {
+      id: c.id,
+      title: c.title,
+      messageCount: c.message_count,
+      createdAt: c.created_at,
+      updatedAt: c.updated_at
+    };
+  }
   async deleteConversation(id) {
     await this.del(`/v1/conversations/${encodeURIComponent(id)}`);
   }
@@ -1012,6 +1037,16 @@ function translateCustomEvent(name, data) {
         type: "todo_update",
         todos: data.todos ?? []
       };
+    case "plan_update":
+      return {
+        type: "plan_update",
+        plan: data.plan ?? ""
+      };
+    case "note_update":
+      return {
+        type: "note_update",
+        notes: data.notes ?? []
+      };
     case "context_update":
       return {
         type: "context_update",
@@ -1879,6 +1914,26 @@ var ChatSession = class {
       this.isLoadingConversations = false;
     }
   }
+  /**
+   * Rename a conversation, server first.
+   *
+   * Deliberately NOT optimistic, unlike the delete below. A failed delete is
+   * self-correcting (the row is still there on the next page fetch), but a
+   * failed rename that had already been written locally would leave the
+   * sidebar showing a title the server never accepted — and nothing refetches
+   * a conversation that is already in the loaded list.
+   *
+   * Mirrors the `title_generated` path: the entry in `conversations` is
+   * mutated in place, which is what every consumer of the list reads.
+   */
+  async renameConversation(id, title) {
+    const updated = await this.client.renameConversation(id, title);
+    const conv = this.conversations.find((c) => c.id === id);
+    if (conv) {
+      conv.title = updated.title;
+    }
+    await this.storage.updateConversationTitle(id, updated.title);
+  }
   async deleteConversation(id) {
     try {
       await this.client.deleteConversation(id);
@@ -1983,6 +2038,8 @@ var ChatEventType = {
   UserMessage: "user_message",
   TitleGenerated: "title_generated",
   TodoUpdate: "todo_update",
+  PlanUpdate: "plan_update",
+  NoteUpdate: "note_update",
   ContextUpdate: "context_update",
   SubagentStart: "subagent_start",
   SubagentStop: "subagent_stop",
@@ -2169,12 +2226,19 @@ var StreamManager = class {
     }
     await this.restore(conversationId);
   }
-  // ── Create / delete conversation ──────────────────────────────
+  // ── Create / rename / delete conversation ─────────────────────
   async createConversation() {
     const id = await this.session.createNewConversation();
     this.setActiveConversation(id);
     return id;
   }
+  /**
+   * Rename a conversation. Purely a relabel — no active-conversation or
+   * background-job bookkeeping to do, unlike delete, so this is a passthrough.
+   */
+  async renameConversation(id, title) {
+    await this.session.renameConversation(id, title);
+  }
   async deleteConversation(id) {
     await this.session.deleteConversation(id);
     this._backgroundJobs.delete(id);