@llmsafespaces/sdk 0.30.1 → 0.31.0

package/dist/index.cjs

@@ -419,13 +419,17 @@ var SessionsAPI = class {
   abort(workspaceId, sessionId) {
     return this.client.request("POST", `/workspaces/${workspaceId}/sessions/${sessionId}/abort`);
   }
+  /** Gets one session in contract shape (pkg/session Session). */
   get(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}`);
   }
   /**
-   * Sends a prompt asynchronously (202; the reply arrives on the workspace
-   * SSE stream). Optional `files` (Epic 68) are upload-namespace paths —
-   * the API composes the v1 attachment manifest into the dispatched text.
+   * Sends a prompt asynchronously into the delivery outbox (202) and
+   * returns the accepted-entry receipt; the agent's reply arrives on the
+   * workspace SSE stream. A retried clientMessageID answers 200 with the
+   * ORIGINAL accepted entry (status "duplicate"). Optional `files`
+   * (Epic 68) are upload-namespace paths — the API composes the v1
+   * attachment manifest into the dispatched text.
    */
   sendPromptAsync(workspaceId, sessionId, message, files) {
     const body = { parts: [{ type: "text", text: message }] };

package/dist/index.d.cts

@@ -103,6 +103,44 @@ interface SessionListItem {
     messageCount: number;
     status: string;
 }
+/**
+ * The platform-owned view of one agent session (pkg/session contract,
+ * design 0049) — the getSession response shape.
+ */
+interface Session {
+    id: string;
+    workspaceId: string;
+    parentId?: string;
+    title?: string;
+    agentId?: string;
+    model?: ModelRef;
+    status: "unknown" | "idle" | "busy" | "error" | "compacting" | "archived";
+    cost?: Cost;
+    contextUsage?: ContextUsage;
+    time?: TimeRange;
+    summary?: string;
+    archived?: boolean;
+}
+/** The session's live context occupancy (non-monotonic: compaction resets it). */
+interface ContextUsage {
+    used: number;
+    window?: number;
+}
+/** Bounds a session or message. completedAt is absent while busy. */
+interface TimeRange {
+    startedAt: string;
+    completedAt?: string;
+}
+/**
+ * The delivery-outbox receipt for an async prompt: the 202 body of a
+ * fresh accept, and the 200 body of a retried clientMessageID (which
+ * echoes the ORIGINAL accepted entry with status "duplicate").
+ */
+interface PromptAccepted {
+    messageID: string;
+    clientMessageID?: string;
+    status: "queued" | "duplicate";
+}
 interface ActiveSessionsResponse {
     active: string[];
     maxActive: number;
@@ -136,7 +174,7 @@ interface Message {
 }
 /** One renderable part of a message — the closed 5-type union. */
 interface Part {
-    type: "text" | "reasoning" | "tool" | "file-change" | "custom";
+    type: "text" | "reasoning" | "tool" | "file_change" | "custom";
     id?: string;
     text?: string;
     reasoning?: string;
@@ -477,13 +515,17 @@ declare class SessionsAPI {
         nextCursor: string;
     }>;
     abort(workspaceId: string, sessionId: string): Promise<void>;
-    get(workspaceId: string, sessionId: string): Promise<Record<string, unknown>>;
+    /** Gets one session in contract shape (pkg/session Session). */
+    get(workspaceId: string, sessionId: string): Promise<Session>;
     /**
-     * Sends a prompt asynchronously (202; the reply arrives on the workspace
-     * SSE stream). Optional `files` (Epic 68) are upload-namespace paths —
-     * the API composes the v1 attachment manifest into the dispatched text.
+     * Sends a prompt asynchronously into the delivery outbox (202) and
+     * returns the accepted-entry receipt; the agent's reply arrives on the
+     * workspace SSE stream. A retried clientMessageID answers 200 with the
+     * ORIGINAL accepted entry (status "duplicate"). Optional `files`
+     * (Epic 68) are upload-namespace paths — the API composes the v1
+     * attachment manifest into the dispatched text.
      */
-    sendPromptAsync(workspaceId: string, sessionId: string, message: string, files?: string[]): Promise<void>;
+    sendPromptAsync(workspaceId: string, sessionId: string, message: string, files?: string[]): Promise<PromptAccepted>;
     delete(workspaceId: string, sessionId: string): Promise<void>;
     /** Enqueues a message for a busy session; optional `files` as in sendPromptAsync. */
     enqueue(workspaceId: string, sessionId: string, text: string, files?: string[]): Promise<{
@@ -851,4 +893,4 @@ declare class ServiceUnavailableError extends LLMSafeSpacesError {
     constructor(message?: string, reason?: string, retryAfter?: number);
 }
 
-export { type APIKey, type ActivateWorkspaceResponse, type ActiveSessionsResponse, AuthError, type AuthResponse, type ClientOptions, ConflictError, type Cost, type CreateMcpServerRequest, type CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, type FileDiff, type FileUpload, type InboxLateAnswerAccepted, type InputOption, type InputRequest, LLMSafeSpaces, LLMSafeSpacesError, type McpAutoApplyRule, type McpServer, type Message, type ModelRef, NotFoundError, type PaginationMetadata, type Part, type ProviderCredential, type QueuedMessage, RateLimitError, type RefreshWorkspaceResult, SECRET_NAME_PATTERN, type SecretResponse, ServiceUnavailableError, type SessionListItem, type TerminalTicket, TimeoutError, type ToolPart, type ToolRef, type UpdateMcpServerRequest, type UpdateProviderCredentialRequest, type User, type Workspace, type WorkspaceCondition, type WorkspaceListItem, type WorkspaceListResult, type WorkspaceStatusResult };
+export { type APIKey, type ActivateWorkspaceResponse, type ActiveSessionsResponse, AuthError, type AuthResponse, type ClientOptions, ConflictError, type ContextUsage, type Cost, type CreateMcpServerRequest, type CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, type FileDiff, type FileUpload, type InboxLateAnswerAccepted, type InputOption, type InputRequest, LLMSafeSpaces, LLMSafeSpacesError, type McpAutoApplyRule, type McpServer, type Message, type ModelRef, NotFoundError, type PaginationMetadata, type Part, type PromptAccepted, type ProviderCredential, type QueuedMessage, RateLimitError, type RefreshWorkspaceResult, SECRET_NAME_PATTERN, type SecretResponse, ServiceUnavailableError, type Session, type SessionListItem, type TerminalTicket, type TimeRange, TimeoutError, type ToolPart, type ToolRef, type UpdateMcpServerRequest, type UpdateProviderCredentialRequest, type User, type Workspace, type WorkspaceCondition, type WorkspaceListItem, type WorkspaceListResult, type WorkspaceStatusResult };

package/dist/index.d.ts

@@ -103,6 +103,44 @@ interface SessionListItem {
     messageCount: number;
     status: string;
 }
+/**
+ * The platform-owned view of one agent session (pkg/session contract,
+ * design 0049) — the getSession response shape.
+ */
+interface Session {
+    id: string;
+    workspaceId: string;
+    parentId?: string;
+    title?: string;
+    agentId?: string;
+    model?: ModelRef;
+    status: "unknown" | "idle" | "busy" | "error" | "compacting" | "archived";
+    cost?: Cost;
+    contextUsage?: ContextUsage;
+    time?: TimeRange;
+    summary?: string;
+    archived?: boolean;
+}
+/** The session's live context occupancy (non-monotonic: compaction resets it). */
+interface ContextUsage {
+    used: number;
+    window?: number;
+}
+/** Bounds a session or message. completedAt is absent while busy. */
+interface TimeRange {
+    startedAt: string;
+    completedAt?: string;
+}
+/**
+ * The delivery-outbox receipt for an async prompt: the 202 body of a
+ * fresh accept, and the 200 body of a retried clientMessageID (which
+ * echoes the ORIGINAL accepted entry with status "duplicate").
+ */
+interface PromptAccepted {
+    messageID: string;
+    clientMessageID?: string;
+    status: "queued" | "duplicate";
+}
 interface ActiveSessionsResponse {
     active: string[];
     maxActive: number;
@@ -136,7 +174,7 @@ interface Message {
 }
 /** One renderable part of a message — the closed 5-type union. */
 interface Part {
-    type: "text" | "reasoning" | "tool" | "file-change" | "custom";
+    type: "text" | "reasoning" | "tool" | "file_change" | "custom";
     id?: string;
     text?: string;
     reasoning?: string;
@@ -477,13 +515,17 @@ declare class SessionsAPI {
         nextCursor: string;
     }>;
     abort(workspaceId: string, sessionId: string): Promise<void>;
-    get(workspaceId: string, sessionId: string): Promise<Record<string, unknown>>;
+    /** Gets one session in contract shape (pkg/session Session). */
+    get(workspaceId: string, sessionId: string): Promise<Session>;
     /**
-     * Sends a prompt asynchronously (202; the reply arrives on the workspace
-     * SSE stream). Optional `files` (Epic 68) are upload-namespace paths —
-     * the API composes the v1 attachment manifest into the dispatched text.
+     * Sends a prompt asynchronously into the delivery outbox (202) and
+     * returns the accepted-entry receipt; the agent's reply arrives on the
+     * workspace SSE stream. A retried clientMessageID answers 200 with the
+     * ORIGINAL accepted entry (status "duplicate"). Optional `files`
+     * (Epic 68) are upload-namespace paths — the API composes the v1
+     * attachment manifest into the dispatched text.
      */
-    sendPromptAsync(workspaceId: string, sessionId: string, message: string, files?: string[]): Promise<void>;
+    sendPromptAsync(workspaceId: string, sessionId: string, message: string, files?: string[]): Promise<PromptAccepted>;
     delete(workspaceId: string, sessionId: string): Promise<void>;
     /** Enqueues a message for a busy session; optional `files` as in sendPromptAsync. */
     enqueue(workspaceId: string, sessionId: string, text: string, files?: string[]): Promise<{
@@ -851,4 +893,4 @@ declare class ServiceUnavailableError extends LLMSafeSpacesError {
     constructor(message?: string, reason?: string, retryAfter?: number);
 }
 
-export { type APIKey, type ActivateWorkspaceResponse, type ActiveSessionsResponse, AuthError, type AuthResponse, type ClientOptions, ConflictError, type Cost, type CreateMcpServerRequest, type CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, type FileDiff, type FileUpload, type InboxLateAnswerAccepted, type InputOption, type InputRequest, LLMSafeSpaces, LLMSafeSpacesError, type McpAutoApplyRule, type McpServer, type Message, type ModelRef, NotFoundError, type PaginationMetadata, type Part, type ProviderCredential, type QueuedMessage, RateLimitError, type RefreshWorkspaceResult, SECRET_NAME_PATTERN, type SecretResponse, ServiceUnavailableError, type SessionListItem, type TerminalTicket, TimeoutError, type ToolPart, type ToolRef, type UpdateMcpServerRequest, type UpdateProviderCredentialRequest, type User, type Workspace, type WorkspaceCondition, type WorkspaceListItem, type WorkspaceListResult, type WorkspaceStatusResult };
+export { type APIKey, type ActivateWorkspaceResponse, type ActiveSessionsResponse, AuthError, type AuthResponse, type ClientOptions, ConflictError, type ContextUsage, type Cost, type CreateMcpServerRequest, type CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, type FileDiff, type FileUpload, type InboxLateAnswerAccepted, type InputOption, type InputRequest, LLMSafeSpaces, LLMSafeSpacesError, type McpAutoApplyRule, type McpServer, type Message, type ModelRef, NotFoundError, type PaginationMetadata, type Part, type PromptAccepted, type ProviderCredential, type QueuedMessage, RateLimitError, type RefreshWorkspaceResult, SECRET_NAME_PATTERN, type SecretResponse, ServiceUnavailableError, type Session, type SessionListItem, type TerminalTicket, type TimeRange, TimeoutError, type ToolPart, type ToolRef, type UpdateMcpServerRequest, type UpdateProviderCredentialRequest, type User, type Workspace, type WorkspaceCondition, type WorkspaceListItem, type WorkspaceListResult, type WorkspaceStatusResult };

package/dist/index.js

@@ -385,13 +385,17 @@ var SessionsAPI = class {
   abort(workspaceId, sessionId) {
     return this.client.request("POST", `/workspaces/${workspaceId}/sessions/${sessionId}/abort`);
   }
+  /** Gets one session in contract shape (pkg/session Session). */
   get(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}`);
   }
   /**
-   * Sends a prompt asynchronously (202; the reply arrives on the workspace
-   * SSE stream). Optional `files` (Epic 68) are upload-namespace paths —
-   * the API composes the v1 attachment manifest into the dispatched text.
+   * Sends a prompt asynchronously into the delivery outbox (202) and
+   * returns the accepted-entry receipt; the agent's reply arrives on the
+   * workspace SSE stream. A retried clientMessageID answers 200 with the
+   * ORIGINAL accepted entry (status "duplicate"). Optional `files`
+   * (Epic 68) are upload-namespace paths — the API composes the v1
+   * attachment manifest into the dispatched text.
    */
   sendPromptAsync(workspaceId, sessionId, message, files) {
     const body = { parts: [{ type: "text", text: message }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmsafespaces/sdk",
-  "version": "0.30.1",
+  "version": "0.31.0",
   "description": "TypeScript SDK for LLMSafeSpaces API",
   "type": "module",
   "main": "./dist/index.cjs",