@llmsafespaces/sdk 0.15.3 → 0.15.4

package/dist/index.cjs

@@ -27,6 +27,7 @@ __export(index_exports, {
   NotFoundError: () => NotFoundError,
   RateLimitError: () => RateLimitError,
   SECRET_NAME_PATTERN: () => SECRET_NAME_PATTERN,
+  ServiceUnavailableError: () => ServiceUnavailableError,
   TimeoutError: () => TimeoutError
 });
 module.exports = __toCommonJS(index_exports);
@@ -72,6 +73,26 @@ var RateLimitError = class extends LLMSafeSpacesError {
     this.name = "RateLimitError";
   }
 };
+var ServiceUnavailableError = class extends LLMSafeSpacesError {
+  /**
+   * The workspace exists but cannot service requests (503). The `reason`
+   * field distinguishes the cause:
+   * - "not_ready" — workspace is booting or resuming
+   * - "agent_unreachable" — the agent process hung or crashed
+   * - "agent_restarting" — the agent is being restarted by the health
+   *   watchdog or a credential reload
+   *
+   * Retry after `retryAfter` seconds (defaults to 10).
+   */
+  reason;
+  retryAfter;
+  constructor(message = "Service temporarily unavailable", reason, retryAfter) {
+    super(message, 503, "SERVICE_UNAVAILABLE");
+    this.name = "ServiceUnavailableError";
+    this.reason = reason;
+    this.retryAfter = retryAfter;
+  }
+};
 
 // src/client.ts
 var DEFAULT_TIMEOUT = 12e4;
@@ -169,6 +190,12 @@ var LLMSafeSpaces = class {
           throw new ConflictError(msg);
         case 429:
           throw new RateLimitError(msg);
+        case 503: {
+          const reason = errBody.reason;
+          const retryAfter = errBody.retryAfter;
+          const apiMessage = errBody.message ?? msg;
+          throw new ServiceUnavailableError(apiMessage, reason, retryAfter);
+        }
         default:
           throw new LLMSafeSpacesError(msg, res.status);
       }
@@ -665,5 +692,6 @@ var SECRET_NAME_PATTERN = /^[a-z0-9._-]+$/;
   NotFoundError,
   RateLimitError,
   SECRET_NAME_PATTERN,
+  ServiceUnavailableError,
   TimeoutError
 });

package/dist/index.d.cts

@@ -563,5 +563,20 @@ declare class TimeoutError extends LLMSafeSpacesError {
 declare class RateLimitError extends LLMSafeSpacesError {
     constructor(message?: string);
 }
+declare class ServiceUnavailableError extends LLMSafeSpacesError {
+    /**
+     * The workspace exists but cannot service requests (503). The `reason`
+     * field distinguishes the cause:
+     * - "not_ready" — workspace is booting or resuming
+     * - "agent_unreachable" — the agent process hung or crashed
+     * - "agent_restarting" — the agent is being restarted by the health
+     *   watchdog or a credential reload
+     *
+     * Retry after `retryAfter` seconds (defaults to 10).
+     */
+    readonly reason?: string;
+    readonly retryAfter?: number;
+    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, 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 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 };

package/dist/index.d.ts

@@ -563,5 +563,20 @@ declare class TimeoutError extends LLMSafeSpacesError {
 declare class RateLimitError extends LLMSafeSpacesError {
     constructor(message?: string);
 }
+declare class ServiceUnavailableError extends LLMSafeSpacesError {
+    /**
+     * The workspace exists but cannot service requests (503). The `reason`
+     * field distinguishes the cause:
+     * - "not_ready" — workspace is booting or resuming
+     * - "agent_unreachable" — the agent process hung or crashed
+     * - "agent_restarting" — the agent is being restarted by the health
+     *   watchdog or a credential reload
+     *
+     * Retry after `retryAfter` seconds (defaults to 10).
+     */
+    readonly reason?: string;
+    readonly retryAfter?: number;
+    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, 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 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 };

package/dist/index.js

@@ -39,6 +39,26 @@ var RateLimitError = class extends LLMSafeSpacesError {
     this.name = "RateLimitError";
   }
 };
+var ServiceUnavailableError = class extends LLMSafeSpacesError {
+  /**
+   * The workspace exists but cannot service requests (503). The `reason`
+   * field distinguishes the cause:
+   * - "not_ready" — workspace is booting or resuming
+   * - "agent_unreachable" — the agent process hung or crashed
+   * - "agent_restarting" — the agent is being restarted by the health
+   *   watchdog or a credential reload
+   *
+   * Retry after `retryAfter` seconds (defaults to 10).
+   */
+  reason;
+  retryAfter;
+  constructor(message = "Service temporarily unavailable", reason, retryAfter) {
+    super(message, 503, "SERVICE_UNAVAILABLE");
+    this.name = "ServiceUnavailableError";
+    this.reason = reason;
+    this.retryAfter = retryAfter;
+  }
+};
 
 // src/client.ts
 var DEFAULT_TIMEOUT = 12e4;
@@ -136,6 +156,12 @@ var LLMSafeSpaces = class {
           throw new ConflictError(msg);
         case 429:
           throw new RateLimitError(msg);
+        case 503: {
+          const reason = errBody.reason;
+          const retryAfter = errBody.retryAfter;
+          const apiMessage = errBody.message ?? msg;
+          throw new ServiceUnavailableError(apiMessage, reason, retryAfter);
+        }
         default:
           throw new LLMSafeSpacesError(msg, res.status);
       }
@@ -631,5 +657,6 @@ export {
   NotFoundError,
   RateLimitError,
   SECRET_NAME_PATTERN,
+  ServiceUnavailableError,
   TimeoutError
 };

package/package.json

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