@llmsafespaces/sdk 0.17.0 → 0.18.0

package/dist/index.cjs

@@ -315,14 +315,15 @@ var SessionsAPI = class {
   rename(workspaceId, sessionId, title) {
     return this.client.request("PUT", `/workspaces/${workspaceId}/sessions/${sessionId}/title`, { title });
   }
-  async sendMessage(workspaceId, sessionId, content) {
-    const raw = await this.client.request(
+  /** Sends synchronously; returns the completed assistant Message (contract shape). */
+  sendMessage(workspaceId, sessionId, content) {
+    return this.client.request(
       "POST",
       `/workspaces/${workspaceId}/sessions/${sessionId}/message`,
       { content, parts: [{ type: "text", text: content }] }
     );
-    return { raw, content: extractTextContent(raw) };
   }
+  /** Returns the session transcript in contract shape. */
   getHistory(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}/message`);
   }
@@ -554,12 +555,6 @@ var ProbeAPI = class {
     return this.client.request("POST", "/probe-models", { apiKey, baseURL });
   }
 };
-function extractTextContent(raw) {
-  if (!raw || typeof raw !== "object") return "";
-  const obj = raw;
-  if (!Array.isArray(obj.parts)) return "";
-  return obj.parts.filter((p) => p.type === "text" && p.text).map((p) => p.text).join("");
-}
 var PromptsAPI = class {
   constructor(client) {
     this.client = client;

package/dist/index.d.cts

@@ -107,10 +107,106 @@ interface ActiveSessionsResponse {
     active: string[];
     maxActive: number;
 }
-/** Opencode message response (proxy passthrough). */
-interface MessageResponse {
-    raw: unknown;
-    content: string;
+/**
+ * One entry in a session transcript (pkg/session contract, design 0049).
+ * Flat discriminated struct: type selects which fields are meaningful.
+ */
+interface Message {
+    id: string;
+    sessionId?: string;
+    type: "user" | "assistant" | "shell" | "agent_switch" | "model_switch" | "compaction" | "system";
+    createdAt?: string;
+    parts?: Part[];
+    model?: ModelRef;
+    cost?: Cost;
+    /** Plain-text form (user/system/compaction messages). */
+    text?: string;
+    /** Shell-message fields. */
+    command?: string;
+    exitCode?: number;
+    /** Agent/model-switch fields. */
+    fromAgent?: string;
+    toAgent?: string;
+    fromModel?: ModelRef;
+    toModel?: ModelRef;
+    error?: {
+        code?: string;
+        message: string;
+    };
+}
+/** One renderable part of a message — the closed 5-type union. */
+interface Part {
+    type: "text" | "reasoning" | "tool" | "file-change" | "custom";
+    id?: string;
+    text?: string;
+    reasoning?: string;
+    tool?: ToolPart;
+    fileChange?: FileDiff;
+    custom?: {
+        kind: string;
+        data?: unknown;
+    };
+}
+/** Every tool call is a ToolPart discriminated by name. */
+interface ToolPart {
+    callId?: string;
+    name: string;
+    input?: unknown;
+    output?: unknown;
+    state: {
+        status: "pending" | "running" | "completed" | "error";
+        error?: string;
+        startedAt?: string;
+        completedAt?: string;
+    };
+}
+/** Unified-diff payload of a file-change part (patch text is authoritative). */
+interface FileDiff {
+    path: string;
+    oldPath?: string;
+    status: "added" | "modified" | "deleted" | "renamed";
+    patch: string;
+    additions?: number;
+    deletions?: number;
+}
+/** The unified pending-input shape ("the agent needs a human"). */
+interface InputRequest {
+    id: string;
+    sessionId?: string;
+    rootSessionId?: string;
+    kind: "question" | "permission";
+    question?: string;
+    header?: string;
+    options?: InputOption[];
+    multiple?: boolean;
+    custom?: boolean;
+    permission?: string;
+    patterns?: string[];
+    always?: string[];
+    metadata?: Record<string, unknown>;
+    tool?: ToolRef;
+}
+interface InputOption {
+    label: string;
+    description?: string;
+}
+interface ToolRef {
+    messageId?: string;
+    callId?: string;
+}
+interface ModelRef {
+    id: string;
+    provider?: string;
+}
+/** Display-only token/cost data (never billing). */
+interface Cost {
+    inputTokens?: number;
+    outputTokens?: number;
+    reasoningTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    totalTokens?: number;
+    costUsd?: number;
 }
 interface AuthResponse {
     token: string;
@@ -278,8 +374,10 @@ declare class SessionsAPI {
     list(workspaceId: string): Promise<SessionListItem[]>;
     getActive(workspaceId: string): Promise<ActiveSessionsResponse>;
     rename(workspaceId: string, sessionId: string, title: string): Promise<void>;
-    sendMessage(workspaceId: string, sessionId: string, content: string): Promise<MessageResponse>;
-    getHistory(workspaceId: string, sessionId: string): Promise<unknown[]>;
+    /** Sends synchronously; returns the completed assistant Message (contract shape). */
+    sendMessage(workspaceId: string, sessionId: string, content: string): Promise<Message>;
+    /** Returns the session transcript in contract shape. */
+    getHistory(workspaceId: string, sessionId: string): Promise<Message[]>;
     abort(workspaceId: string, sessionId: string): Promise<void>;
     get(workspaceId: string, sessionId: string): Promise<Record<string, unknown>>;
     sendPromptAsync(workspaceId: string, sessionId: string, message: string): Promise<void>;
@@ -580,4 +678,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 CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, LLMSafeSpaces, LLMSafeSpacesError, type MessageResponse, NotFoundError, type PaginationMetadata, type ProviderCredential, type QueuedMessage, RateLimitError, type RefreshWorkspaceResult, SECRET_NAME_PATTERN, type SecretResponse, ServiceUnavailableError, type SessionListItem, type TerminalTicket, TimeoutError, 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 Cost, type CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, type FileDiff, type InputOption, type InputRequest, LLMSafeSpaces, LLMSafeSpacesError, 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 UpdateProviderCredentialRequest, type User, type Workspace, type WorkspaceCondition, type WorkspaceListItem, type WorkspaceListResult, type WorkspaceStatusResult };

package/dist/index.d.ts

@@ -107,10 +107,106 @@ interface ActiveSessionsResponse {
     active: string[];
     maxActive: number;
 }
-/** Opencode message response (proxy passthrough). */
-interface MessageResponse {
-    raw: unknown;
-    content: string;
+/**
+ * One entry in a session transcript (pkg/session contract, design 0049).
+ * Flat discriminated struct: type selects which fields are meaningful.
+ */
+interface Message {
+    id: string;
+    sessionId?: string;
+    type: "user" | "assistant" | "shell" | "agent_switch" | "model_switch" | "compaction" | "system";
+    createdAt?: string;
+    parts?: Part[];
+    model?: ModelRef;
+    cost?: Cost;
+    /** Plain-text form (user/system/compaction messages). */
+    text?: string;
+    /** Shell-message fields. */
+    command?: string;
+    exitCode?: number;
+    /** Agent/model-switch fields. */
+    fromAgent?: string;
+    toAgent?: string;
+    fromModel?: ModelRef;
+    toModel?: ModelRef;
+    error?: {
+        code?: string;
+        message: string;
+    };
+}
+/** One renderable part of a message — the closed 5-type union. */
+interface Part {
+    type: "text" | "reasoning" | "tool" | "file-change" | "custom";
+    id?: string;
+    text?: string;
+    reasoning?: string;
+    tool?: ToolPart;
+    fileChange?: FileDiff;
+    custom?: {
+        kind: string;
+        data?: unknown;
+    };
+}
+/** Every tool call is a ToolPart discriminated by name. */
+interface ToolPart {
+    callId?: string;
+    name: string;
+    input?: unknown;
+    output?: unknown;
+    state: {
+        status: "pending" | "running" | "completed" | "error";
+        error?: string;
+        startedAt?: string;
+        completedAt?: string;
+    };
+}
+/** Unified-diff payload of a file-change part (patch text is authoritative). */
+interface FileDiff {
+    path: string;
+    oldPath?: string;
+    status: "added" | "modified" | "deleted" | "renamed";
+    patch: string;
+    additions?: number;
+    deletions?: number;
+}
+/** The unified pending-input shape ("the agent needs a human"). */
+interface InputRequest {
+    id: string;
+    sessionId?: string;
+    rootSessionId?: string;
+    kind: "question" | "permission";
+    question?: string;
+    header?: string;
+    options?: InputOption[];
+    multiple?: boolean;
+    custom?: boolean;
+    permission?: string;
+    patterns?: string[];
+    always?: string[];
+    metadata?: Record<string, unknown>;
+    tool?: ToolRef;
+}
+interface InputOption {
+    label: string;
+    description?: string;
+}
+interface ToolRef {
+    messageId?: string;
+    callId?: string;
+}
+interface ModelRef {
+    id: string;
+    provider?: string;
+}
+/** Display-only token/cost data (never billing). */
+interface Cost {
+    inputTokens?: number;
+    outputTokens?: number;
+    reasoningTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    totalTokens?: number;
+    costUsd?: number;
 }
 interface AuthResponse {
     token: string;
@@ -278,8 +374,10 @@ declare class SessionsAPI {
     list(workspaceId: string): Promise<SessionListItem[]>;
     getActive(workspaceId: string): Promise<ActiveSessionsResponse>;
     rename(workspaceId: string, sessionId: string, title: string): Promise<void>;
-    sendMessage(workspaceId: string, sessionId: string, content: string): Promise<MessageResponse>;
-    getHistory(workspaceId: string, sessionId: string): Promise<unknown[]>;
+    /** Sends synchronously; returns the completed assistant Message (contract shape). */
+    sendMessage(workspaceId: string, sessionId: string, content: string): Promise<Message>;
+    /** Returns the session transcript in contract shape. */
+    getHistory(workspaceId: string, sessionId: string): Promise<Message[]>;
     abort(workspaceId: string, sessionId: string): Promise<void>;
     get(workspaceId: string, sessionId: string): Promise<Record<string, unknown>>;
     sendPromptAsync(workspaceId: string, sessionId: string, message: string): Promise<void>;
@@ -580,4 +678,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 CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, LLMSafeSpaces, LLMSafeSpacesError, type MessageResponse, NotFoundError, type PaginationMetadata, type ProviderCredential, type QueuedMessage, RateLimitError, type RefreshWorkspaceResult, SECRET_NAME_PATTERN, type SecretResponse, ServiceUnavailableError, type SessionListItem, type TerminalTicket, TimeoutError, 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 Cost, type CreateProviderCredentialRequest, type CreateSecretRequest, type CreateWorkspaceRequest, type EnsureSessionResponse, type FetchFn, type FileDiff, type InputOption, type InputRequest, LLMSafeSpaces, LLMSafeSpacesError, 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 UpdateProviderCredentialRequest, type User, type Workspace, type WorkspaceCondition, type WorkspaceListItem, type WorkspaceListResult, type WorkspaceStatusResult };

package/dist/index.js

@@ -281,14 +281,15 @@ var SessionsAPI = class {
   rename(workspaceId, sessionId, title) {
     return this.client.request("PUT", `/workspaces/${workspaceId}/sessions/${sessionId}/title`, { title });
   }
-  async sendMessage(workspaceId, sessionId, content) {
-    const raw = await this.client.request(
+  /** Sends synchronously; returns the completed assistant Message (contract shape). */
+  sendMessage(workspaceId, sessionId, content) {
+    return this.client.request(
       "POST",
       `/workspaces/${workspaceId}/sessions/${sessionId}/message`,
       { content, parts: [{ type: "text", text: content }] }
     );
-    return { raw, content: extractTextContent(raw) };
   }
+  /** Returns the session transcript in contract shape. */
   getHistory(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}/message`);
   }
@@ -520,12 +521,6 @@ var ProbeAPI = class {
     return this.client.request("POST", "/probe-models", { apiKey, baseURL });
   }
 };
-function extractTextContent(raw) {
-  if (!raw || typeof raw !== "object") return "";
-  const obj = raw;
-  if (!Array.isArray(obj.parts)) return "";
-  return obj.parts.filter((p) => p.type === "text" && p.text).map((p) => p.text).join("");
-}
 var PromptsAPI = class {
   constructor(client) {
     this.client = client;

package/package.json

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