@sealant/sdk 0.5.0 → 0.5.2

package/dist/effect/api-client.d.ts

@@ -756,12 +756,13 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
                     readonly github?: string | undefined;
                 } | undefined;
                 readonly spec: unknown;
+                readonly ttlSeconds?: number | undefined;
             };
             readonly responseMode?: Mode;
         }) => Effect.Effect<HttpApiClient.Client.Response<{
             readonly workspaceId: string;
             readonly name: string;
-            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
             readonly registryId: string;
             readonly repository: string;
             readonly tag: string;
@@ -795,6 +796,19 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly createdAt: string;
             readonly updatedAt: string;
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
+        readonly expireWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
+            readonly params: {
+                readonly workspaceId: string;
+            };
+            readonly payload: {
+                readonly ownerUserId: string;
+                readonly ttlSeconds?: number | null | undefined;
+            };
+            readonly responseMode?: Mode;
+        }) => Effect.Effect<HttpApiClient.Client.Response<{
+            readonly workspaceId: string;
+            readonly expiresAt: string | null;
+        }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
         readonly getWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
             readonly params: {
                 readonly workspaceId: string;
@@ -804,7 +818,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly workspaceId: string;
             readonly name: string;
             readonly ownerUserId: string;
-            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
             readonly registryId?: string | undefined;
             readonly repository?: string | undefined;
             readonly tag?: string | undefined;
@@ -828,6 +842,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly updatedAt: string;
             readonly startedAt?: string | undefined;
             readonly finishedAt?: string | undefined;
+            readonly expiresAt?: string | undefined;
             readonly spec?: unknown;
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
         readonly getWorkspaceSshTarget: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
@@ -862,7 +877,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly items: readonly {
                 readonly attemptId: string;
                 readonly relation: "launch" | "rebuild" | "resume" | "retry";
-                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
                 readonly triggerType: "api" | "manual" | "retry" | "schedule";
                 readonly triggerRef?: string | undefined;
                 readonly runtime?: {
@@ -913,7 +928,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
         readonly listWorkspaces: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
             readonly query: {
                 readonly ownerUserId: string;
-                readonly status?: "cancelled" | "failed" | "queued" | "ready" | "running" | undefined;
+                readonly status?: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped" | undefined;
                 readonly limit?: string | undefined;
             };
             readonly responseMode?: Mode;
@@ -922,7 +937,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
                 readonly workspaceId: string;
                 readonly name: string;
                 readonly ownerUserId: string;
-                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
                 readonly registryId?: string | undefined;
                 readonly repository?: string | undefined;
                 readonly tag?: string | undefined;
@@ -946,6 +961,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
                 readonly updatedAt: string;
                 readonly startedAt?: string | undefined;
                 readonly finishedAt?: string | undefined;
+                readonly expiresAt?: string | undefined;
             }[];
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceInternalServerError), [Mode] extends ["response-only"] ? never : never>;
         readonly renameWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
@@ -961,6 +977,31 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly name: string;
             readonly updatedAt: string;
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
+        readonly restartWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
+            readonly params: {
+                readonly workspaceId: string;
+            };
+            readonly payload: {
+                readonly ownerUserId: string;
+            };
+            readonly responseMode?: Mode;
+        }) => Effect.Effect<HttpApiClient.Client.Response<{
+            readonly workspaceId: string;
+            readonly runId: string;
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
+        }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadGatewayError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
+        readonly stopWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
+            readonly params: {
+                readonly workspaceId: string;
+            };
+            readonly payload: {
+                readonly ownerUserId: string;
+            };
+            readonly responseMode?: Mode;
+        }) => Effect.Effect<HttpApiClient.Client.Response<{
+            readonly workspaceId: string;
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
+        }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadGatewayError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
     };
 }, never, HttpClient.HttpClient>;
 /** The fully-typed control-plane client, derived from the `@sealant/api-contracts` HttpApi. */
@@ -1718,12 +1759,13 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
                     readonly github?: string | undefined;
                 } | undefined;
                 readonly spec: unknown;
+                readonly ttlSeconds?: number | undefined;
             };
             readonly responseMode?: Mode;
         }) => Effect.Effect<HttpApiClient.Client.Response<{
             readonly workspaceId: string;
             readonly name: string;
-            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
             readonly registryId: string;
             readonly repository: string;
             readonly tag: string;
@@ -1757,6 +1799,19 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly createdAt: string;
             readonly updatedAt: string;
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
+        readonly expireWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
+            readonly params: {
+                readonly workspaceId: string;
+            };
+            readonly payload: {
+                readonly ownerUserId: string;
+                readonly ttlSeconds?: number | null | undefined;
+            };
+            readonly responseMode?: Mode;
+        }) => Effect.Effect<HttpApiClient.Client.Response<{
+            readonly workspaceId: string;
+            readonly expiresAt: string | null;
+        }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
         readonly getWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
             readonly params: {
                 readonly workspaceId: string;
@@ -1766,7 +1821,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly workspaceId: string;
             readonly name: string;
             readonly ownerUserId: string;
-            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
             readonly registryId?: string | undefined;
             readonly repository?: string | undefined;
             readonly tag?: string | undefined;
@@ -1790,6 +1845,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly updatedAt: string;
             readonly startedAt?: string | undefined;
             readonly finishedAt?: string | undefined;
+            readonly expiresAt?: string | undefined;
             readonly spec?: unknown;
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
         readonly getWorkspaceSshTarget: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
@@ -1824,7 +1880,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly items: readonly {
                 readonly attemptId: string;
                 readonly relation: "launch" | "rebuild" | "resume" | "retry";
-                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
                 readonly triggerType: "api" | "manual" | "retry" | "schedule";
                 readonly triggerRef?: string | undefined;
                 readonly runtime?: {
@@ -1875,7 +1931,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
         readonly listWorkspaces: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
             readonly query: {
                 readonly ownerUserId: string;
-                readonly status?: "cancelled" | "failed" | "queued" | "ready" | "running" | undefined;
+                readonly status?: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped" | undefined;
                 readonly limit?: string | undefined;
             };
             readonly responseMode?: Mode;
@@ -1884,7 +1940,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
                 readonly workspaceId: string;
                 readonly name: string;
                 readonly ownerUserId: string;
-                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+                readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
                 readonly registryId?: string | undefined;
                 readonly repository?: string | undefined;
                 readonly tag?: string | undefined;
@@ -1908,6 +1964,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
                 readonly updatedAt: string;
                 readonly startedAt?: string | undefined;
                 readonly finishedAt?: string | undefined;
+                readonly expiresAt?: string | undefined;
             }[];
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceInternalServerError), [Mode] extends ["response-only"] ? never : never>;
         readonly renameWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
@@ -1923,6 +1980,31 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly name: string;
             readonly updatedAt: string;
         }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
+        readonly restartWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
+            readonly params: {
+                readonly workspaceId: string;
+            };
+            readonly payload: {
+                readonly ownerUserId: string;
+            };
+            readonly responseMode?: Mode;
+        }) => Effect.Effect<HttpApiClient.Client.Response<{
+            readonly workspaceId: string;
+            readonly runId: string;
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
+        }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadGatewayError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
+        readonly stopWorkspace: <Mode extends import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode = import("effect/unstable/httpapi/HttpApiEndpoint").ClientResponseMode>(request: {
+            readonly params: {
+                readonly workspaceId: string;
+            };
+            readonly payload: {
+                readonly ownerUserId: string;
+            };
+            readonly responseMode?: Mode;
+        }) => Effect.Effect<HttpApiClient.Client.Response<{
+            readonly workspaceId: string;
+            readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
+        }, Mode>, import("effect/unstable/http/HttpClientError").HttpClientError | ([Mode] extends ["response-only"] ? never : import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadGatewayError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError), [Mode] extends ["response-only"] ? never : never>;
     };
 }>;
 export declare class SealantApiClient extends SealantApiClient_base {

package/dist/effect/operations.d.ts

@@ -25,10 +25,11 @@ export declare const createWorkspaceOp: (payload: {
         readonly github?: string | undefined;
     } | undefined;
     readonly spec: unknown;
+    readonly ttlSeconds?: number | undefined;
 }, idempotencyKey?: string | undefined) => Effect.Effect<{
     readonly workspaceId: string;
     readonly name: string;
-    readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+    readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
     readonly registryId: string;
     readonly repository: string;
     readonly tag: string;
@@ -37,7 +38,7 @@ export declare const getWorkspaceOp: (workspaceId: string) => Effect.Effect<{
     readonly workspaceId: string;
     readonly name: string;
     readonly ownerUserId: string;
-    readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+    readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
     readonly registryId?: string | undefined;
     readonly repository?: string | undefined;
     readonly tag?: string | undefined;
@@ -61,18 +62,19 @@ export declare const getWorkspaceOp: (workspaceId: string) => Effect.Effect<{
     readonly updatedAt: string;
     readonly startedAt?: string | undefined;
     readonly finishedAt?: string | undefined;
+    readonly expiresAt?: string | undefined;
     readonly spec?: unknown;
 }, import("effect/unstable/http/HttpClientError").HttpClientError | import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError, SealantApiClient>;
 export declare const listWorkspacesOp: (query: {
     readonly ownerUserId: string;
-    readonly status?: "cancelled" | "failed" | "queued" | "ready" | "running" | undefined;
+    readonly status?: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped" | undefined;
     readonly limit?: string | undefined;
 }) => Effect.Effect<{
     readonly items: readonly {
         readonly workspaceId: string;
         readonly name: string;
         readonly ownerUserId: string;
-        readonly status: "cancelled" | "failed" | "queued" | "ready" | "running";
+        readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
         readonly registryId?: string | undefined;
         readonly repository?: string | undefined;
         readonly tag?: string | undefined;
@@ -96,6 +98,7 @@ export declare const listWorkspacesOp: (query: {
         readonly updatedAt: string;
         readonly startedAt?: string | undefined;
         readonly finishedAt?: string | undefined;
+        readonly expiresAt?: string | undefined;
     }[];
 }, import("effect/unstable/http/HttpClientError").HttpClientError | import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceInternalServerError, SealantApiClient>;
 export declare const execWorkspaceOp: (workspaceId: string, payload: {
@@ -121,6 +124,26 @@ export declare const execWorkspaceOp: (workspaceId: string, payload: {
     readonly createdAt: string;
     readonly updatedAt: string;
 }, import("effect/unstable/http/HttpClientError").HttpClientError | import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError, SealantApiClient>;
+export declare const stopWorkspaceOp: (workspaceId: string, payload: {
+    readonly ownerUserId: string;
+}) => Effect.Effect<{
+    readonly workspaceId: string;
+    readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
+}, import("effect/unstable/http/HttpClientError").HttpClientError | import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadGatewayError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError, SealantApiClient>;
+export declare const restartWorkspaceOp: (workspaceId: string, payload: {
+    readonly ownerUserId: string;
+}) => Effect.Effect<{
+    readonly workspaceId: string;
+    readonly runId: string;
+    readonly status: "cancelled" | "failed" | "queued" | "ready" | "running" | "stopped";
+}, import("effect/unstable/http/HttpClientError").HttpClientError | import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadGatewayError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceConflictError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError, SealantApiClient>;
+export declare const expireWorkspaceOp: (workspaceId: string, payload: {
+    readonly ownerUserId: string;
+    readonly ttlSeconds?: number | null | undefined;
+}) => Effect.Effect<{
+    readonly workspaceId: string;
+    readonly expiresAt: string | null;
+}, import("effect/unstable/http/HttpClientError").HttpClientError | import("effect/Schema").SchemaError | import("@sealant/api-contracts").WorkspaceBadRequestError | import("@sealant/api-contracts").WorkspaceInternalServerError | import("@sealant/api-contracts").WorkspaceNotFoundError, SealantApiClient>;
 export declare const createRunOp: (payload: {
     readonly workspaceId: string;
     readonly harnessId: string;

package/dist/effect/operations.js

@@ -8,6 +8,9 @@ export const createWorkspaceOp = (payload, idempotencyKey) => Effect.flatMap(Sea
 export const getWorkspaceOp = (workspaceId) => Effect.flatMap(SealantApiClient, (client) => client.workspaces.getWorkspace({ params: { workspaceId } }));
 export const listWorkspacesOp = (query) => Effect.flatMap(SealantApiClient, (client) => client.workspaces.listWorkspaces({ query }));
 export const execWorkspaceOp = (workspaceId, payload) => Effect.flatMap(SealantApiClient, (client) => client.workspaces.execWorkspace({ params: { workspaceId }, payload }));
+export const stopWorkspaceOp = (workspaceId, payload) => Effect.flatMap(SealantApiClient, (client) => client.workspaces.stopWorkspace({ params: { workspaceId }, payload }));
+export const restartWorkspaceOp = (workspaceId, payload) => Effect.flatMap(SealantApiClient, (client) => client.workspaces.restartWorkspace({ params: { workspaceId }, payload }));
+export const expireWorkspaceOp = (workspaceId, payload) => Effect.flatMap(SealantApiClient, (client) => client.workspaces.expireWorkspace({ params: { workspaceId }, payload }));
 // ---- runs ----
 export const createRunOp = (payload) => Effect.flatMap(SealantApiClient, (client) => client.runs.createRun({ payload }));
 export const getRunOp = (runId) => Effect.flatMap(SealantApiClient, (client) => client.runs.getRun({ params: { runId } }));

package/dist/facade/workspace.js

@@ -1,9 +1,15 @@
 import { execWorkspace } from "../effect/exec-workspace.js";
-import { getWorkspaceOp } from "../effect/operations.js";
+import { expireWorkspaceOp, getWorkspaceOp, restartWorkspaceOp, stopWorkspaceOp, } from "../effect/operations.js";
 import { SealantError, SealantNotImplementedError } from "../errors.js";
-const FAILED_STATUSES = new Set(["failed", "cancelled"]);
+import { parseTtlSeconds } from "../internal/duration.js";
+// Terminal statuses a workspace can never leave: ready()/events() fail fast (or end the stream)
+// on these instead of polling out their deadline. "stopped" is terminal too — a TTL expiry or a
+// concurrent stop while ready() polls must surface immediately, not as a 10-minute timeout.
+const FAILED_STATUSES = new Set(["failed", "cancelled", "stopped"]);
 const READY_POLL_INTERVAL_MS = 2_000;
 const READY_TIMEOUT_MS = 10 * 60 * 1_000;
+const STOP_POLL_INTERVAL_MS = 1_000;
+const STOP_TIMEOUT_MS = 60 * 1_000;
 const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 let harnessExecutors;
 export const registerHarnessExecutors = (executors) => {
@@ -83,9 +89,48 @@ export const makeWorkspace = (ctx, init) => {
             }
             return iterate();
         },
-        stop: () => Promise.reject(new SealantNotImplementedError("workspace.stop (lifecycle, Phase 3)")),
-        restart: () => Promise.reject(new SealantNotImplementedError("workspace.restart (lifecycle, Phase 3)")),
-        expire: () => Promise.reject(new SealantNotImplementedError("workspace.expire (lifecycle, Phase 3)")),
+        // BLOCKING stop: the control plane accepts the stop (202) and the worker tears the container
+        // down; resolve only once the workspace reports the terminal "stopped" status, so callers can
+        // trust the container is gone when this settles.
+        stop: async () => {
+            const ownerUserId = ctx.config.hostLocal.ownerUserId;
+            await ctx.runtime.run(stopWorkspaceOp(init.id, { ownerUserId }));
+            const deadline = Date.now() + STOP_TIMEOUT_MS;
+            for (;;) {
+                const details = await ctx.runtime.run(getWorkspaceOp(init.id));
+                if (details.status === "stopped") {
+                    return;
+                }
+                if (Date.now() > deadline) {
+                    throw new SealantError(`Timed out waiting for workspace ${init.id} to stop.`, {
+                        code: "workspace_stop_timeout",
+                    });
+                }
+                await delay(STOP_POLL_INTERVAL_MS);
+            }
+        },
+        // Restart drives a fresh launch (new attempt, new container, same resolved spec) and returns a
+        // handle that resolves readiness against the NEW runtime via the usual ready() gate.
+        restart: async () => {
+            const ownerUserId = ctx.config.hostLocal.ownerUserId;
+            await ctx.runtime.run(restartWorkspaceOp(init.id, { ownerUserId }));
+            return makeWorkspace(ctx, {
+                id: init.id,
+                name: init.name,
+                status: "queued",
+                ...(init.harness === undefined ? {} : { harness: init.harness }),
+            });
+        },
+        // expire({in: "2h"}) sets the TTL, expire() expires now (the platform reaper stops it on its
+        // next tick), expire({in: null}) clears the TTL. Resolves once the expiry is recorded.
+        expire: async (options) => {
+            const ownerUserId = ctx.config.hostLocal.ownerUserId;
+            const ttl = options?.in;
+            await ctx.runtime.run(expireWorkspaceOp(init.id, {
+                ownerUserId,
+                ...(ttl === undefined ? {} : { ttlSeconds: ttl === null ? null : parseTtlSeconds(ttl) }),
+            }));
+        },
     };
     return workspace;
 };

package/dist/internal/blueprint.d.ts

@@ -26,5 +26,6 @@ export declare const buildCreateWorkspaceRequest: (options: CreateOptions, confi
             readonly github?: string | undefined;
         } | undefined;
         readonly spec: unknown;
+        readonly ttlSeconds?: number | undefined;
     };
 };

package/dist/internal/blueprint.js

@@ -12,6 +12,7 @@
  */
 import { randomUUID } from "node:crypto";
 import { mapWorkspaceCredentials } from "./credentials.js";
+import { parseTtlSeconds } from "./duration.js";
 const sanitizeRepoSlug = (value) => {
     const slug = value
         .toLowerCase()
@@ -39,7 +40,8 @@ export const buildCreateWorkspaceRequest = (options, config) => {
                 kind: "git",
                 provider: "generic",
                 url: toGitUrl(options.repository),
-                ref: options.ref ?? "main",
+                // Omitted ref = the repository's default branch, resolved by the clone itself.
+                ...(options.ref === undefined ? {} : { ref: options.ref }),
             },
         },
         harness: { id: options.harness.id },
@@ -63,6 +65,7 @@ export const buildCreateWorkspaceRequest = (options, config) => {
             repository: sanitizeRepoSlug(tail),
             tag: `sdk-${randomUUID().slice(0, 8)}`,
             ...(options.name === undefined ? {} : { name: options.name }),
+            ...(options.ttl === undefined ? {} : { ttlSeconds: parseTtlSeconds(options.ttl) }),
             spec,
         },
     };

package/dist/internal/duration.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse a human TTL like `"90m"`, `"2h"`, `"45s"`, `"1d"` into whole seconds (milliseconds round
+ * up to at least 1s — the wire TTL is second-granular). Throws a typed `SealantError` on anything
+ * else so a typo'd TTL fails at the call site instead of silently never expiring.
+ */
+export declare const parseTtlSeconds: (ttl: string) => number;

package/dist/internal/duration.js

@@ -0,0 +1,34 @@
+import { SealantError } from "../errors.js";
+const DURATION_PATTERN = /^(\d+)(ms|s|m|h|d)$/;
+const UNIT_SECONDS = {
+    s: 1,
+    m: 60,
+    h: 3600,
+    d: 86400,
+};
+/**
+ * Parse a human TTL like `"90m"`, `"2h"`, `"45s"`, `"1d"` into whole seconds (milliseconds round
+ * up to at least 1s — the wire TTL is second-granular). Throws a typed `SealantError` on anything
+ * else so a typo'd TTL fails at the call site instead of silently never expiring.
+ */
+export const parseTtlSeconds = (ttl) => {
+    const match = DURATION_PATTERN.exec(ttl.trim());
+    if (match === null) {
+        throw new SealantError(`Invalid TTL duration "${ttl}". Use a positive integer with a unit: e.g. "45s", "90m", "2h", "1d".`, { code: "invalid_ttl" });
+    }
+    const value = Number.parseInt(match[1] ?? "", 10);
+    const unit = match[2] ?? "";
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new SealantError(`Invalid TTL duration "${ttl}". The value must be a positive integer.`, {
+            code: "invalid_ttl",
+        });
+    }
+    if (unit === "ms") {
+        return Math.max(1, Math.ceil(value / 1000));
+    }
+    const multiplier = UNIT_SECONDS[unit];
+    if (multiplier === undefined) {
+        throw new SealantError(`Invalid TTL duration "${ttl}".`, { code: "invalid_ttl" });
+    }
+    return value * multiplier;
+};

package/dist/types.d.ts

@@ -56,8 +56,8 @@ export interface Harness {
     /** Optional launch command for an interactive session (defaults to the executable). */
     readonly launchCommand?: string;
 }
-/** Lifecycle status of a workspace. `stopped`/`expired` arrive with lifecycle close-out (Phase 3). */
-export type WorkspaceStatus = "queued" | "running" | "ready" | "failed" | "cancelled";
+/** Lifecycle status of a workspace. */
+export type WorkspaceStatus = "queued" | "running" | "ready" | "failed" | "cancelled" | "stopped";
 /** A coarse lifecycle event observed while a workspace is being provisioned. */
 export interface WorkspaceEvent {
     readonly type: string;
@@ -109,6 +109,12 @@ export interface CreateOptions {
     readonly onEvent?: (event: WorkspaceEvent) => void;
     /** Connected-account credentials to attach to the workspace (see `WorkspaceCredentialsOptions`). */
     readonly credentials?: WorkspaceCredentialsOptions;
+    /**
+     * Time-to-live for the workspace, e.g. `"90m"`, `"2h"` (also `"45s"`, `"1d"`). Once it elapses
+     * the platform stops the workspace and removes its container. Omitted = the server default TTL
+     * (if the install configures one).
+     */
+    readonly ttl?: string;
 }
 export interface ListOptions {
     readonly status?: WorkspaceStatus;
@@ -152,13 +158,16 @@ export interface Workspace {
     exec(argv: readonly string[], options?: WorkspaceExecOptions): Promise<WorkspaceExecResult>;
     /** Lifecycle events as an async stream. */
     events(): AsyncIterable<WorkspaceEvent>;
-    /** Stop the workspace now (Phase 3). */
+    /** Stop the workspace: remove its container and settle it in the terminal "stopped" status. */
     stop(): Promise<void>;
-    /** Restart the workspace into a fresh runtime (Phase 3). */
+    /** Restart the workspace into a fresh runtime — a new container, no filesystem carry-over. */
     restart(): Promise<Workspace>;
-    /** Schedule the workspace to expire (Phase 3). */
+    /**
+     * Schedule the workspace to expire: `expire({ in: "2h" })` sets the TTL, `expire()` expires it
+     * now (the platform reaper stops it shortly), `expire({ in: null })` clears the TTL.
+     */
     expire(options?: {
-        readonly in?: string;
+        readonly in?: string | null;
     }): Promise<void>;
 }
 export interface RunOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sealant/sdk",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "The fluent public SDK for Sealant — create a workspace, run a harness, replay the record.",
   "license": "Apache-2.0",
   "repository": {
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "effect": "^4.0.0-beta.85",
-    "@sealant/api-contracts": "^0.5.0"
+    "@sealant/api-contracts": "^0.5.2"
   },
   "devDependencies": {
     "@effect/vitest": "^4.0.0-beta.85",