@sealant/sdk-next 0.40.0-next.790 → 0.40.0-next.791

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

@@ -856,6 +856,14 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
                 }>>;
             }>>;
         }>>, import("effect/Schema").toCodecJson<typeof import("@sealant/api-contracts").ResourceDomainForbiddenError | typeof import("@sealant/api-contracts").ResourceDomainNotFoundError | typeof import("@sealant/api-contracts").ResourceDomainInternalServerError | typeof import("@sealant/api-contracts").ResourceInstanceSpecRefusedError | typeof import("@sealant/api-contracts").ResourceRuntimeUnsupportedError | typeof import("@sealant/api-contracts").ResourceInstanceBusyError | typeof import("@sealant/api-contracts").ResourceInstanceBudgetError>, import("@sealant/api-contracts").RequestBudget | import("@sealant/api-contracts").RequestRefusal, never>, never, never>;
+        readonly purgeResourceInstance: HttpApiClient.Client.Method<import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<"purgeResourceInstance", "POST", "/v1/resource-domains/:resourceDomainId/instances/:key/purge", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+            readonly resourceDomainId: import("effect/Schema").String;
+            readonly key: import("effect/Schema").brand<import("effect/Schema").String, "ResourceInstanceKey">;
+        }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+            readonly expectedInstanceId: import("effect/Schema").brand<import("effect/Schema").String, "ResourceInstanceId">;
+        }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+            readonly kind: import("effect/Schema").Literals<readonly ["purged", "already-purged"]>;
+        }>>, import("effect/Schema").toCodecJson<typeof import("@sealant/api-contracts").ResourceDomainForbiddenError | typeof import("@sealant/api-contracts").ResourceDomainNotFoundError | typeof import("@sealant/api-contracts").ResourceDomainInternalServerError | typeof import("@sealant/api-contracts").ResourceInstanceSpecRefusedError | typeof import("@sealant/api-contracts").ResourceRuntimeUnsupportedError | typeof import("@sealant/api-contracts").ResourceInstancePurgeRefusedError | typeof import("@sealant/api-contracts").ResourceInstanceBusyError | typeof import("@sealant/api-contracts").ResourceInstanceBudgetError>, import("@sealant/api-contracts").RequestBudget | import("@sealant/api-contracts").RequestRefusal, never>, never, never>;
         readonly stopResourceInstance: HttpApiClient.Client.Method<import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<"stopResourceInstance", "POST", "/v1/resource-domains/:resourceDomainId/instances/:key/stop", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
             readonly resourceDomainId: import("effect/Schema").String;
             readonly key: import("effect/Schema").brand<import("effect/Schema").String, "ResourceInstanceKey">;
@@ -3253,6 +3261,14 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
                 }>>;
             }>>;
         }>>, import("effect/Schema").toCodecJson<typeof import("@sealant/api-contracts").ResourceDomainForbiddenError | typeof import("@sealant/api-contracts").ResourceDomainNotFoundError | typeof import("@sealant/api-contracts").ResourceDomainInternalServerError | typeof import("@sealant/api-contracts").ResourceInstanceSpecRefusedError | typeof import("@sealant/api-contracts").ResourceRuntimeUnsupportedError | typeof import("@sealant/api-contracts").ResourceInstanceBusyError | typeof import("@sealant/api-contracts").ResourceInstanceBudgetError>, import("@sealant/api-contracts").RequestBudget | import("@sealant/api-contracts").RequestRefusal, never>, never, never>;
+        readonly purgeResourceInstance: HttpApiClient.Client.Method<import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<"purgeResourceInstance", "POST", "/v1/resource-domains/:resourceDomainId/instances/:key/purge", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+            readonly resourceDomainId: import("effect/Schema").String;
+            readonly key: import("effect/Schema").brand<import("effect/Schema").String, "ResourceInstanceKey">;
+        }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+            readonly expectedInstanceId: import("effect/Schema").brand<import("effect/Schema").String, "ResourceInstanceId">;
+        }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
+            readonly kind: import("effect/Schema").Literals<readonly ["purged", "already-purged"]>;
+        }>>, import("effect/Schema").toCodecJson<typeof import("@sealant/api-contracts").ResourceDomainForbiddenError | typeof import("@sealant/api-contracts").ResourceDomainNotFoundError | typeof import("@sealant/api-contracts").ResourceDomainInternalServerError | typeof import("@sealant/api-contracts").ResourceInstanceSpecRefusedError | typeof import("@sealant/api-contracts").ResourceRuntimeUnsupportedError | typeof import("@sealant/api-contracts").ResourceInstancePurgeRefusedError | typeof import("@sealant/api-contracts").ResourceInstanceBusyError | typeof import("@sealant/api-contracts").ResourceInstanceBudgetError>, import("@sealant/api-contracts").RequestBudget | import("@sealant/api-contracts").RequestRefusal, never>, never, never>;
         readonly stopResourceInstance: HttpApiClient.Client.Method<import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<"stopResourceInstance", "POST", "/v1/resource-domains/:resourceDomainId/instances/:key/stop", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
             readonly resourceDomainId: import("effect/Schema").String;
             readonly key: import("effect/Schema").brand<import("effect/Schema").String, "ResourceInstanceKey">;

package/dist/effect/operations.d.ts

@@ -1507,6 +1507,9 @@ export declare const archiveResourceInstanceOp: (resourceDomainId: string, key:
         readonly bytes: number | null;
     }[];
 }, import("@sealant/api-contracts").BudgetExceededError | import("effect/http/HttpClientError").HttpClientError | import("@sealant/api-contracts").RequestRefusedError | import("@sealant/api-contracts").ResourceDomainForbiddenError | import("@sealant/api-contracts").ResourceDomainInternalServerError | import("@sealant/api-contracts").ResourceDomainNotFoundError | import("@sealant/api-contracts").ResourceInstanceBudgetError | import("@sealant/api-contracts").ResourceInstanceBusyError | import("@sealant/api-contracts").ResourceInstanceNotFoundError | import("@sealant/api-contracts").ResourceInstanceSpecRefusedError | import("@sealant/api-contracts").ResourceRuntimeUnsupportedError | Schema.SchemaError | import("effect/Cause").UnknownError, SealantApiClient>;
+export declare const purgeResourceInstanceOp: (resourceDomainId: string, key: string, expectedInstanceId: string) => Effect.Effect<{
+    readonly kind: "already-purged" | "purged";
+}, import("@sealant/api-contracts").BudgetExceededError | import("effect/http/HttpClientError").HttpClientError | import("@sealant/api-contracts").RequestRefusedError | import("@sealant/api-contracts").ResourceDomainForbiddenError | import("@sealant/api-contracts").ResourceDomainInternalServerError | import("@sealant/api-contracts").ResourceDomainNotFoundError | import("@sealant/api-contracts").ResourceInstanceBudgetError | import("@sealant/api-contracts").ResourceInstanceBusyError | import("@sealant/api-contracts").ResourceInstancePurgeRefusedError | import("@sealant/api-contracts").ResourceInstanceSpecRefusedError | import("@sealant/api-contracts").ResourceRuntimeUnsupportedError | Schema.SchemaError | import("effect/Cause").UnknownError, SealantApiClient>;
 export declare const linkResourceWorkspaceOp: (resourceDomainId: string, workspaceId: string, worktreeKey: string, aliases?: Readonly<Record<string, "project" | "worktree">>) => Effect.Effect<{
     readonly workspaceId: string;
     readonly worktreeKey: string & import("effect/Brand").Brand<"ResourceWorktreeKey">;

package/dist/effect/operations.js

@@ -1,4 +1,4 @@
-import { ResourceInstanceKey, ResourceReachAliases, ResourceWorktreeKey, } from "@sealant/api-contracts";
+import { ResourceInstanceId, ResourceInstanceKey, ResourceReachAliases, ResourceWorktreeKey, } from "@sealant/api-contracts";
 import { Effect, Schema } from "effect";
 import { CurrentRequestPriority, SealantApiClient } from "./api-client.js";
 // ---- workspaces ----
@@ -127,6 +127,14 @@ export const stopResourceInstanceOp = (resourceDomainId, key, by) => Effect.flat
 export const archiveResourceInstanceOp = (resourceDomainId, key) => Effect.flatMap(Effect.all([SealantApiClient, instanceKey(key)]), ([client, checked]) => client.resourceInstances.archiveResourceInstance({
     params: { resourceDomainId, key: checked },
 }));
+export const purgeResourceInstanceOp = (resourceDomainId, key, expectedInstanceId) => Effect.flatMap(Effect.all([
+    SealantApiClient,
+    instanceKey(key),
+    Effect.try(() => ResourceInstanceId.make(expectedInstanceId)),
+]), ([client, checked, id]) => client.resourceInstances.purgeResourceInstance({
+    params: { resourceDomainId, key: checked },
+    payload: { expectedInstanceId: id },
+})).pipe(Effect.provideService(CurrentRequestPriority, "interactive"));
 export const linkResourceWorkspaceOp = (resourceDomainId, workspaceId, worktreeKey, aliases) => Effect.flatMap(Effect.all([
     SealantApiClient,
     Effect.try(() => ResourceWorktreeKey.make(worktreeKey)),

package/dist/index.d.ts

@@ -19,6 +19,6 @@ export { claudeCode, codex, customHarness, opencode, pi } from "./harness.js";
 export { ForwardDialError, type ForwardDialFailure, type ForwardDialReason, ForwardResetError, SealantApiError, SealantBudgetExceededError, SealantError, SealantNotImplementedError, SealantRuntimeError, } from "./errors.js";
 export type * from "./types.js";
 export type { EnsuredScope, ScopeBudget, ScopeBudgetDimension, ScopeBudgetLimits, ScopeBudgets, ScopeClient, ScopeInfo, ScopeMember, ScopeMemberDecision, ScopeMemberPage, ScopeMembers, ScopesNamespace, } from "./scopes.js";
-export type { ScopeArchivedVolume, ScopeExecResult, ScopeInstance, ScopeInstances, ScopeInstanceSpec, ScopeInstanceState, ScopeInstanceStopReason, ScopeWorkspaces, } from "./scope-instances.js";
+export type { ScopeArchivedVolume, ScopeExecResult, ScopeInstance, ScopeInstances, ScopeInstanceSpec, ScopeInstanceState, ScopeInstanceStopReason, ScopeInstancePurgeResult, ScopeWorkspaces, } from "./scope-instances.js";
 export { findWorkspaceEnvReservedRule, findWorkspaceSecretEnvReservedRule, formatWorkspaceEnvIssue, parseWorkspaceEnv, parseWorkspaceSecretEnv, WORKSPACE_ENV_MAX_ENTRIES, WORKSPACE_ENV_MAX_NAME_LENGTH, WORKSPACE_ENV_MAX_TOTAL_BYTES, WORKSPACE_ENV_MAX_VALUE_BYTES, WORKSPACE_ENV_NAME_PATTERN, WORKSPACE_ENV_SECRET_MARKERS, } from "@sealant/api-contracts/workspace-environment";
 export type { WorkspaceEnvIssue, WorkspaceEnvParseResult, WorkspaceEnvReservedRule, } from "@sealant/api-contracts/workspace-environment";

package/dist/scope-instances.d.ts

@@ -1,3 +1,9 @@
+/**
+ * A scope's long-running instances (a project's Postgres, Redis or any image), the workspaces that
+ * reach them, and the scope's archive. Organization and installation scopes use caller-only
+ * reach on Docker or Kubernetes. Other providers reject with `ResourceRuntimeUnsupportedError`.
+ */
+import { type ResourceInstancePurgeResult } from "@sealant/api-contracts";
 import type { SdkRuntime } from "./effect/runtime.js";
 import { type SealantInternalConfig } from "./internal/config.js";
 /**
@@ -124,7 +130,17 @@ export interface ScopeExecResult {
     readonly truncated: boolean;
     readonly timedOut: boolean;
 }
+/** Whether this call removed the instance or found its key already absent. */
+export type ScopeInstancePurgeResult = ResourceInstancePurgeResult;
 export interface ScopeInstances {
+    /**
+     * Irreversibly delete a stopped or archived caller-owned instance, including retained volumes
+     * and sealed env. Pass its observed id to protect a replacement using the same key. No Core
+     * backup is retained; previously downloaded copies belong to their recipient.
+     */
+    purge(key: string, options: {
+        readonly expectedInstanceId: string;
+    }): Promise<ScopeInstancePurgeResult>;
     /**
      * Create or update the instance by key, start it and answer once its ready check passed or its
      * start failed (`state.kind`). `cause: "use"` (a launch, a wake) leaves an instance a person

package/dist/scope-instances.js

@@ -4,7 +4,7 @@
  * reach on Docker or Kubernetes. Other providers reject with `ResourceRuntimeUnsupportedError`.
  */
 import { RESOURCE_INSTANCE_EXEC, RESOURCE_INSTANCE_BACKUP, } from "@sealant/api-contracts";
-import { archiveResourceDomainOp, archiveResourceInstanceOp, getResourceInstanceOp, linkResourceWorkspaceOp, listResourceInstancesOp, stopResourceInstanceOp, upResourceInstanceOp, } from "./effect/operations.js";
+import { archiveResourceDomainOp, archiveResourceInstanceOp, purgeResourceInstanceOp, getResourceInstanceOp, linkResourceWorkspaceOp, listResourceInstancesOp, stopResourceInstanceOp, upResourceInstanceOp, } from "./effect/operations.js";
 import { SealantApiError, SealantBudgetExceededError, SealantError } from "./errors.js";
 import { resolveRequestPriority } from "./internal/config.js";
 import { toSealantError } from "./internal/map-error.js";
@@ -138,6 +138,7 @@ const exec = async (config, scopeId, key, options) => {
 };
 export const makeScopeInstances = (runtime, config, scopeId) => ({
     instances: {
+        purge: (key, options) => runtime.run(purgeResourceInstanceOp(scopeId, key, options.expectedInstanceId)),
         up: async (key, spec, { cause, secretEnv }) => toInstance(await runtime.run(upResourceInstanceOp(scopeId, key, {
             spec: { ...spec },
             cause,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sealant/sdk-next",
-  "version": "0.40.0-next.790",
+  "version": "0.40.0-next.791",
   "description": "The fluent public SDK for Sealant — create a workspace, run a harness, replay the record.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,12 +26,12 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@sealant/api-contracts": "npm:@sealant/api-contracts-next@0.40.0-next.790"
+    "@sealant/api-contracts": "npm:@sealant/api-contracts-next@0.40.0-next.791"
   },
   "peerDependencies": {
     "effect": "^4.0.5"
   },
-  "gitHead": "67830c522d414c65ba5ee22db29bac4b0fa31fc4",
+  "gitHead": "b18cfe790bde2ec8f715311c5fa21ac1b2a8e68e",
   "publishConfig": {
     "access": "public"
   }