@llmsafespaces/sdk 0.13.0 → 0.14.1

package/dist/index.cjs

@@ -258,6 +258,18 @@ var WorkspacesAPI = class {
   deleteEnv(id, varName) {
     return this.client.request("DELETE", `/workspaces/${id}/env/${varName}`);
   }
+  setDevPreview(id, enabled) {
+    return this.client.request("PUT", `/workspaces/${id}/dev-preview`, { enabled });
+  }
+  /**
+   * Returns the URL to open the dev-preview proxy in a browser.
+   * The URL is authenticated via session cookie; no token in the URL.
+   * The dev server must be running on `port` inside the workspace.
+   */
+  devPreviewUrl(id, port, path = "/") {
+    const p = path.startsWith("/") ? path : `/${path}`;
+    return `${this.client.baseUrl}/api/v1/workspaces/${id}/dev-preview/${port}${p}`;
+  }
 };
 var SessionsAPI = class {
   constructor(client) {
@@ -302,9 +314,21 @@ var SessionsAPI = class {
   enqueue(workspaceId, sessionId, text) {
     return this.client.request("POST", `/workspaces/${workspaceId}/sessions/${sessionId}/queue`, { text });
   }
+  /**
+   * @deprecated Under the V2 session-queue model (Epic 63), the queue is
+   * inboard in opencode and this endpoint returns a best-effort shadow
+   * derived from SSE events. Subscribe to the workspace SSE stream and
+   * track `queue.update` events instead. Removed in next major.
+   */
   listQueue(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}/queue`);
   }
+  /**
+   * @deprecated Under the V2 session-queue model (Epic 63), abort is
+   * non-destructive and queued messages survive. This removes from the
+   * best-effort shadow only; it does not revoke the durable input.
+   * Removed in next major.
+   */
   dismissQueued(workspaceId, sessionId, messageId) {
     return this.client.request("DELETE", `/workspaces/${workspaceId}/sessions/${sessionId}/queue/${messageId}`);
   }

package/dist/index.d.cts

@@ -182,6 +182,13 @@ interface UpdateProviderCredentialRequest {
     modelContextLimits?: Record<string, number>;
     modelOutputLimits?: Record<string, number>;
 }
+/**
+ * A message waiting in the session queue.
+ *
+ * Under the V2 session-queue model (Epic 63), this is a best-effort shadow
+ * derived from SSE events. `retry_count` is vestigial (V2 has no retry —
+ * opencode handles durability internally).
+ */
 interface QueuedMessage {
     id: string;
     text: string;
@@ -192,7 +199,7 @@ interface QueuedMessage {
 }
 
 declare class LLMSafeSpaces {
-    private readonly baseUrl;
+    readonly baseUrl: string;
     private readonly timeout;
     private readonly fetchFn;
     private token;
@@ -255,6 +262,13 @@ declare class WorkspacesAPI {
         vars: string[];
     }>;
     deleteEnv(id: string, varName: string): Promise<void>;
+    setDevPreview(id: string, enabled: boolean): Promise<void>;
+    /**
+     * Returns the URL to open the dev-preview proxy in a browser.
+     * The URL is authenticated via session cookie; no token in the URL.
+     * The dev server must be running on `port` inside the workspace.
+     */
+    devPreviewUrl(id: string, port: number, path?: string): string;
 }
 declare class SessionsAPI {
     private client;
@@ -272,9 +286,21 @@ declare class SessionsAPI {
     enqueue(workspaceId: string, sessionId: string, text: string): Promise<{
         messageID: string;
     }>;
+    /**
+     * @deprecated Under the V2 session-queue model (Epic 63), the queue is
+     * inboard in opencode and this endpoint returns a best-effort shadow
+     * derived from SSE events. Subscribe to the workspace SSE stream and
+     * track `queue.update` events instead. Removed in next major.
+     */
     listQueue(workspaceId: string, sessionId: string): Promise<{
         messages: QueuedMessage[];
     }>;
+    /**
+     * @deprecated Under the V2 session-queue model (Epic 63), abort is
+     * non-destructive and queued messages survive. This removes from the
+     * best-effort shadow only; it does not revoke the durable input.
+     * Removed in next major.
+     */
     dismissQueued(workspaceId: string, sessionId: string, messageId: string): Promise<void>;
     markSeen(workspaceId: string, sessionId: string): Promise<void>;
 }

package/dist/index.d.ts

@@ -182,6 +182,13 @@ interface UpdateProviderCredentialRequest {
     modelContextLimits?: Record<string, number>;
     modelOutputLimits?: Record<string, number>;
 }
+/**
+ * A message waiting in the session queue.
+ *
+ * Under the V2 session-queue model (Epic 63), this is a best-effort shadow
+ * derived from SSE events. `retry_count` is vestigial (V2 has no retry —
+ * opencode handles durability internally).
+ */
 interface QueuedMessage {
     id: string;
     text: string;
@@ -192,7 +199,7 @@ interface QueuedMessage {
 }
 
 declare class LLMSafeSpaces {
-    private readonly baseUrl;
+    readonly baseUrl: string;
     private readonly timeout;
     private readonly fetchFn;
     private token;
@@ -255,6 +262,13 @@ declare class WorkspacesAPI {
         vars: string[];
     }>;
     deleteEnv(id: string, varName: string): Promise<void>;
+    setDevPreview(id: string, enabled: boolean): Promise<void>;
+    /**
+     * Returns the URL to open the dev-preview proxy in a browser.
+     * The URL is authenticated via session cookie; no token in the URL.
+     * The dev server must be running on `port` inside the workspace.
+     */
+    devPreviewUrl(id: string, port: number, path?: string): string;
 }
 declare class SessionsAPI {
     private client;
@@ -272,9 +286,21 @@ declare class SessionsAPI {
     enqueue(workspaceId: string, sessionId: string, text: string): Promise<{
         messageID: string;
     }>;
+    /**
+     * @deprecated Under the V2 session-queue model (Epic 63), the queue is
+     * inboard in opencode and this endpoint returns a best-effort shadow
+     * derived from SSE events. Subscribe to the workspace SSE stream and
+     * track `queue.update` events instead. Removed in next major.
+     */
     listQueue(workspaceId: string, sessionId: string): Promise<{
         messages: QueuedMessage[];
     }>;
+    /**
+     * @deprecated Under the V2 session-queue model (Epic 63), abort is
+     * non-destructive and queued messages survive. This removes from the
+     * best-effort shadow only; it does not revoke the durable input.
+     * Removed in next major.
+     */
     dismissQueued(workspaceId: string, sessionId: string, messageId: string): Promise<void>;
     markSeen(workspaceId: string, sessionId: string): Promise<void>;
 }

package/dist/index.js

@@ -225,6 +225,18 @@ var WorkspacesAPI = class {
   deleteEnv(id, varName) {
     return this.client.request("DELETE", `/workspaces/${id}/env/${varName}`);
   }
+  setDevPreview(id, enabled) {
+    return this.client.request("PUT", `/workspaces/${id}/dev-preview`, { enabled });
+  }
+  /**
+   * Returns the URL to open the dev-preview proxy in a browser.
+   * The URL is authenticated via session cookie; no token in the URL.
+   * The dev server must be running on `port` inside the workspace.
+   */
+  devPreviewUrl(id, port, path = "/") {
+    const p = path.startsWith("/") ? path : `/${path}`;
+    return `${this.client.baseUrl}/api/v1/workspaces/${id}/dev-preview/${port}${p}`;
+  }
 };
 var SessionsAPI = class {
   constructor(client) {
@@ -269,9 +281,21 @@ var SessionsAPI = class {
   enqueue(workspaceId, sessionId, text) {
     return this.client.request("POST", `/workspaces/${workspaceId}/sessions/${sessionId}/queue`, { text });
   }
+  /**
+   * @deprecated Under the V2 session-queue model (Epic 63), the queue is
+   * inboard in opencode and this endpoint returns a best-effort shadow
+   * derived from SSE events. Subscribe to the workspace SSE stream and
+   * track `queue.update` events instead. Removed in next major.
+   */
   listQueue(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}/queue`);
   }
+  /**
+   * @deprecated Under the V2 session-queue model (Epic 63), abort is
+   * non-destructive and queued messages survive. This removes from the
+   * best-effort shadow only; it does not revoke the durable input.
+   * Removed in next major.
+   */
   dismissQueued(workspaceId, sessionId, messageId) {
     return this.client.request("DELETE", `/workspaces/${workspaceId}/sessions/${sessionId}/queue/${messageId}`);
   }

package/package.json

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