@enclave-run/sdk 0.0.0 → 0.2.0

package/dist/index.d.mts

@@ -589,7 +589,7 @@ interface paths {
                 400: components["responses"]["400"];
                 401: components["responses"]["401"];
                 403: components["responses"]["403"];
-                503: components["responses"]["503"];
+                503: components["responses"]["500"];
             };
         };
         put?: never;
@@ -821,7 +821,7 @@ interface paths {
                 };
                 401: components["responses"]["401"];
                 403: components["responses"]["403"];
-                503: components["responses"]["503"];
+                503: components["responses"]["500"];
             };
         };
         delete?: never;
@@ -1598,85 +1598,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/templates/{templateID}/activations/{region}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Get desired and locally observed activation for one exact template build in a region. */
-        get: {
-            parameters: {
-                query?: {
-                    /** @description Exact immutable build generation. When omitted, the build selected by the template identifier's tag (default when untagged) is used. */
-                    buildID?: string;
-                };
-                header?: never;
-                path: {
-                    region: string;
-                    templateID: components["parameters"]["templateID"];
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Activation status. */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TemplateRegionActivation"];
-                    };
-                };
-                401: components["responses"]["401"];
-                403: components["responses"]["403"];
-                404: components["responses"]["404"];
-                500: components["responses"]["500"];
-            };
-        };
-        put?: never;
-        /** @description Set the desired activation of one exact template build in a region. */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    region: string;
-                    templateID: components["parameters"]["templateID"];
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["TemplateRegionActivationRequest"];
-                };
-            };
-            responses: {
-                /** @description Desired activation was recorded. */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["TemplateRegionActivation"];
-                    };
-                };
-                400: components["responses"]["400"];
-                401: components["responses"]["401"];
-                403: components["responses"]["403"];
-                404: components["responses"]["404"];
-                409: components["responses"]["409"];
-                500: components["responses"]["500"];
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/templates/{templateID}/builds/{buildID}/logs": {
         parameters: {
             query?: never;
@@ -3669,65 +3590,6 @@ interface components {
          * @enum {string}
          */
         TemplateBuildStatus: "building" | "waiting" | "ready" | "error";
-        TemplateRegionActivation: {
-            allowRemoteFallback: boolean;
-            artifactGeneration: string;
-            /** Format: uuid */
-            buildID: string;
-            /** @enum {string} */
-            desiredState: "active" | "inactive";
-            nodes: components["schemas"]["TemplateRegionActivationNode"][];
-            /** Format: int32 */
-            readyNodes: number;
-            region: string;
-            /** Format: int32 */
-            requiredReadyNodes: number;
-            /** @enum {string} */
-            status: "requested" | "warming" | "ready" | "degraded" | "failed" | "inactive";
-            templateID: string;
-            /** Format: date-time */
-            updatedAt: string;
-            /** Format: int64 */
-            version: number;
-        };
-        TemplateRegionActivationNode: {
-            /** Format: int32 */
-            attempts: number;
-            /** Format: int64 */
-            bytesMaterialized: number;
-            errorCode?: string;
-            nodeID: string;
-            /** Format: date-time */
-            observedAt: string;
-            /** Format: date-time */
-            readyAt?: string;
-            /** @enum {string} */
-            state: "requested" | "warming" | "ready" | "degraded" | "failed";
-        };
-        TemplateRegionActivationRequest: {
-            /** @default true */
-            active?: boolean;
-            /**
-             * @description Permit explicitly classified remote-backed creates while this generation is not ready.
-             * @default false
-             */
-            allowRemoteFallback?: boolean;
-            /**
-             * Format: uuid
-             * @description Exact immutable build generation to materialize.
-             */
-            buildID: string;
-            /**
-             * Format: int64
-             * @description Compare-and-swap precondition for this exact build activation. Use 0 to require that it does not yet exist, or the last observed version to update it.
-             */
-            expectedVersion?: number;
-            /**
-             * Format: int32
-             * @default 1
-             */
-            requiredReadyNodes?: number;
-        };
         TemplateRequestResponseV3: {
             /** @description Identifier of the last successful build for given template */
             buildID: string;
@@ -3770,6 +3632,11 @@ interface components {
             createdAt: string;
             /** @description The tag name */
             tag: string;
+            /**
+             * Format: int64
+             * @description Compare-and-swap version of this tag head. Pass it with the build ID as the expected head when moving the tag. Omitted when the tag is not a current, promotable head.
+             */
+            version?: number;
         };
         TemplateTagHead: {
             /** Format: uuid */
@@ -4130,6 +3997,14 @@ declare class OutcomeUnknownError extends SandboxError {
     readonly cause?: unknown;
     constructor(message: string, recovery: SandboxCreateRecovery, cause?: unknown);
 }
+/**
+ * The durable create operation reached an authoritative failed state after
+ * admission. The recovery identity remains available for audit and support.
+ */
+declare class SandboxCreateFailedError extends SandboxError {
+    readonly recovery: SandboxCreateRecovery;
+    constructor(message: string, recovery: SandboxCreateRecovery);
+}
 /**
  * The selected region explicitly rejected the request before admission.
  */
@@ -4216,7 +4091,7 @@ type TemplateTagConflictReason = "tag_changed" | "concurrent_mutation";
 /**
  * A concurrent template tag mutation prevented an atomic promotion.
  *
- * Fetch the current head with `Template.getTagHead`, decide whether the
+ * Read the current head with `Template.getTags`, decide whether the
  * promotion is still appropriate, and retry with that newly observed token.
  */
 declare class TemplateTagConflictError extends TemplateError {
@@ -9372,55 +9247,6 @@ type TemplateBuildStatusResponse = {
      */
     reason?: BuildStatusReason;
 };
-type TemplateRegionActivation = components["schemas"]["TemplateRegionActivation"];
-type TemplateActivationOptions = ConnectionOpts & {
-    /**
-     * Region in which the exact build generation should be ready.
-     * @default ENCLAVE_REGION, then yyz
-     */
-    region?: string;
-    /**
-     * Number of eligible nodes that must report this exact generation ready.
-     * @default 1
-     */
-    requiredReadyNodes?: number;
-    /**
-     * Explicitly permit separately classified remote-backed creates while the
-     * region warms. The normal activated path remains local-only.
-     * @default false
-     */
-    allowRemoteFallback?: boolean;
-    /**
-     * Compare-and-swap precondition for this exact build activation.
-     * Use `0` to require a new activation, or the last observed version when
-     * changing one.
-     */
-    expectedVersion?: number;
-};
-type GetTemplateActivationOptions = ConnectionOpts & {
-    /**
-     * Region whose cell-local activation evidence should be returned.
-     * @default ENCLAVE_REGION, then yyz
-     */
-    region?: string;
-    /**
-     * Exact immutable build generation whose regional state should be returned.
-     * When omitted, Enclave resolves the tag in `templateId` (`default` when
-     * untagged) for compatibility with existing callers.
-     */
-    buildId?: string;
-};
-type DeactivateTemplateOptions = ConnectionOpts & {
-    /**
-     * Region in which the exact build generation should be deactivated.
-     * @default ENCLAVE_REGION, then yyz
-     */
-    region?: string;
-    /**
-     * Compare-and-swap precondition using the last observed activation version.
-     */
-    expectedVersion?: number;
-};
 /**
  * Information about assigned template tags.
  */
@@ -9433,6 +9259,11 @@ type TemplateTagInfo = {
      * Assigned tags of the template.
      */
     tags: string[];
+    /**
+     * Compare-and-swap version of the moved tag. Set when the tag was assigned
+     * with an `expect` precondition.
+     */
+    version?: number;
 };
 /**
  * Detailed information about a single template tag.
@@ -9450,34 +9281,36 @@ type TemplateTag = {
      * When this tag was assigned.
      */
     createdAt: Date;
+    /**
+     * Compare-and-swap version of this tag head. Pass it with `buildId` as the
+     * `expect` precondition of {@link Template.assignTags}. Undefined when the
+     * tag is not a current, promotable head.
+     */
+    version?: number;
 };
 /**
  * Authoritative traffic-selection token for one template tag.
  */
-type TemplateTagHead = {
-    /**
-     * Name of the tag.
-     */
-    tag: string;
-    /**
-     * Exact build currently selected by the tag.
-     */
+/**
+ * The head a tag must still point at for {@link Template.assignTags} to move
+ * it, as read from {@link Template.getTags}. `null` requires the tag to not
+ * exist yet.
+ */
+type TemplateTagExpectation = {
     buildId: string;
-    /**
-     * Monotonic version used to fence concurrent promotion attempts.
-     */
     version: number;
+} | null;
+/**
+ * Options for {@link Template.assignTags}.
+ */
+type AssignTagsOptions = ConnectionOpts & {
     /**
-     * When this head was assigned.
+     * Move the tag only if it still points at this head (compare-and-swap).
+     * Requires an exact build target and exactly one tag. A mismatch throws
+     * `TemplateTagConflictError`.
      */
-    createdAt: Date;
+    expect?: TemplateTagExpectation;
 };
-/**
- * The previously observed tag head required for a safe promotion.
- *
- * Pass `null` to require that the tag does not yet exist.
- */
-type TemplateTagHeadExpectation = Pick<TemplateTagHead, "buildId" | "version"> | null;
 /**
  * Configuration for a single file/directory copy operation.
  */
@@ -10099,23 +9932,6 @@ declare class TemplateBase implements TemplateFromImage, TemplateBuilder, Templa
      * ```
      */
     static getBuildStatus(data: Pick<BuildInfo, "templateId" | "buildId">, options?: GetBuildStatusOptions): Promise<TemplateBuildStatusResponse>;
-    /**
-     * Materialize one immutable template build in a region before create.
-     *
-     * The request is recorded on the global control plane; hydration then runs
-     * asynchronously inside the selected region. Poll {@link getActivation}
-     * until the returned status is `ready`.
-     */
-    static activate(data: Pick<BuildInfo, "templateId" | "buildId">, options?: TemplateActivationOptions): Promise<TemplateRegionActivation>;
-    /**
-     * Return desired state plus exact-generation evidence from the selected
-     * regional cell.
-     */
-    static getActivation(templateId: string, options?: GetTemplateActivationOptions): Promise<TemplateRegionActivation>;
-    /**
-     * Stop pinning and maintaining one exact build generation in a region.
-     */
-    static deactivate(data: Pick<BuildInfo, "templateId" | "buildId">, options?: DeactivateTemplateOptions): Promise<TemplateRegionActivation>;
     /**
      * Check if a template with the given name exists.
      *
@@ -10149,7 +9965,7 @@ declare class TemplateBase implements TemplateFromImage, TemplateBuilder, Templa
      * await Template.assignTags('my-template:v1.0', ['production', 'stable'])
      * ```
      */
-    static assignTags(targetName: string, tags: string | string[], options?: ConnectionOpts): Promise<TemplateTagInfo>;
+    static assignTags(target: string | Pick<BuildInfo, "templateId" | "buildId">, tags: string | string[], options?: AssignTagsOptions): Promise<TemplateTagInfo>;
     /**
      * Remove tag(s) from a template.
      *
@@ -10183,23 +9999,6 @@ declare class TemplateBase implements TemplateFromImage, TemplateBuilder, Templa
      * ```
      */
     static getTags(templateId: string, options?: ConnectionOpts): Promise<TemplateTag[]>;
-    /**
-     * Get the authoritative traffic-selection token for one template tag.
-     *
-     * Pass the returned head directly to {@link promoteTag}; its monotonic
-     * version prevents concurrent releasers from silently overwriting each
-     * other.
-     */
-    static getTagHead(templateId: string, tag: string, options?: ConnectionOpts): Promise<TemplateTagHead>;
-    /**
-     * Atomically move one template tag to an exact ready, durable build.
-     *
-     * Use a head returned by {@link getTagHead} as `expected`. Pass `null` only
-     * when creating a tag that must not already exist. A concurrent change throws
-     * `TemplateTagConflictError`; fetch the head again before deciding whether to
-     * retry.
-     */
-    static promoteTag(candidate: Pick<BuildInfo, "templateId" | "buildId">, tag: string, expected: TemplateTagHeadExpectation, options?: ConnectionOpts): Promise<TemplateTagHead>;
     fromDebianImage(variant?: string): TemplateBuilder;
     fromUbuntuImage(variant?: string): TemplateBuilder;
     fromPythonImage(version?: string): TemplateBuilder;
@@ -10370,17 +10169,12 @@ declare namespace Template {
     var build: typeof TemplateBase.build;
     var buildInBackground: typeof TemplateBase.buildInBackground;
     var getBuildStatus: typeof TemplateBase.getBuildStatus;
-    var activate: typeof TemplateBase.activate;
-    var getActivation: typeof TemplateBase.getActivation;
-    var deactivate: typeof TemplateBase.deactivate;
     var exists: typeof TemplateBase.exists;
     var assignTags: typeof TemplateBase.assignTags;
     var removeTags: typeof TemplateBase.removeTags;
     var getTags: typeof TemplateBase.getTags;
-    var getTagHead: typeof TemplateBase.getTagHead;
-    var promoteTag: typeof TemplateBase.promoteTag;
     var toJSON: typeof TemplateBase.toJSON;
     var toDockerfile: typeof TemplateBase.toDockerfile;
 }
 
-export { ALL_TRAFFIC, ApiClient, AuthenticationError, BuildError, type BuildInfo, type BuildOptions, type BuildStatusReason, type CommandConnectOpts, CommandExitError, CommandHandle, type CommandRequestOpts, type CommandResult, type CommandStartOpts, Commands, ConnectionConfig, type ConnectionOpts, type CopyItem, type CredentialAuditEvent, type DeactivateTemplateOptions, type EntryInfo, FileType, FileUploadError, Filesystem, type FilesystemEvent, FilesystemEventType, type GetBuildStatusOptions, type GetTemplateActivationOptions, Git, type GitAddOpts, GitAuthError, type GitBranches, type GitCloneOpts, type GitCommitOpts, type GitConfigOpts, type GitConfigScope, type GitDangerouslyAuthenticateOpts, type GitDeleteBranchOpts, type GitFileStatus, GitHubApp, type GitHubAuditQuery, type GitHubCredentialGrant, type GitHubGrantScope, type GitHubInstallation, type GitHubInstallationCallback, type GitHubInstallationLink, type GitHubRepositoryBinding, type GitHubRepositoryBindingOpts, type GitHubRepositoryPermissions, type GitInitOpts, type GitPullOpts, type GitPushOpts, type GitRemoteAddOpts, type GitRequestOpts, type GitStatus, GitUpstreamError, IdempotencyMismatchError, InvalidArgumentError, LogEntry, LogEntryEnd, type LogEntryLevel, LogEntryStart, type Logger, type McpServer$1 as McpServer, type McpServerName, NotEnoughSpaceError, NotFoundError, OutcomeUnknownError, type ProcessInfo, Pty, type PtyOutput, RateLimitError, ReadyCmd, RegionCapacityError, Sandbox, type SandboxApiOpts, type SandboxConnectOpts, type SandboxCreateRecovery, SandboxCreateRejectedError, type SandboxCreateRejectionReason, SandboxError, type SandboxInfo, type SandboxLifecycle, type SandboxListOpts, type SandboxMetrics, type SandboxMetricsOpts, type SandboxNetworkOpts, type SandboxOpts, SandboxPaginator, type SandboxRef, SandboxRegionScope, type SandboxState, type SandboxTarget, type SnapshotInfo, type SnapshotListOpts, SnapshotPaginator, type Stderr, type Stdout, Template, type TemplateActivationOptions, TemplateBase, type TemplateBuildStatus, type TemplateBuildStatusResponse, type TemplateBuilder, type TemplateClass, TemplateError, type TemplateRegionActivation, type TemplateTag, TemplateTagConflictError, type TemplateTagConflictReason, type TemplateTagHead, type TemplateTagHeadExpectation, type TemplateTagInfo, TimeoutError, type Username, WatchHandle, type WriteInfo, type components, Sandbox as default, defaultBuildLogger, getSignature, type paths, waitForFile, waitForPort, waitForProcess, waitForTimeout, waitForURL };
+export { ALL_TRAFFIC, ApiClient, type AssignTagsOptions, AuthenticationError, BuildError, type BuildInfo, type BuildOptions, type BuildStatusReason, type CommandConnectOpts, CommandExitError, CommandHandle, type CommandRequestOpts, type CommandResult, type CommandStartOpts, Commands, ConnectionConfig, type ConnectionOpts, type CopyItem, type CredentialAuditEvent, type EntryInfo, FileType, FileUploadError, Filesystem, type FilesystemEvent, FilesystemEventType, type GetBuildStatusOptions, Git, type GitAddOpts, GitAuthError, type GitBranches, type GitCloneOpts, type GitCommitOpts, type GitConfigOpts, type GitConfigScope, type GitDangerouslyAuthenticateOpts, type GitDeleteBranchOpts, type GitFileStatus, GitHubApp, type GitHubAuditQuery, type GitHubCredentialGrant, type GitHubGrantScope, type GitHubInstallation, type GitHubInstallationCallback, type GitHubInstallationLink, type GitHubRepositoryBinding, type GitHubRepositoryBindingOpts, type GitHubRepositoryPermissions, type GitInitOpts, type GitPullOpts, type GitPushOpts, type GitRemoteAddOpts, type GitRequestOpts, type GitStatus, GitUpstreamError, IdempotencyMismatchError, InvalidArgumentError, LogEntry, LogEntryEnd, type LogEntryLevel, LogEntryStart, type Logger, type McpServer$1 as McpServer, type McpServerName, NotEnoughSpaceError, NotFoundError, OutcomeUnknownError, type ProcessInfo, Pty, type PtyOutput, RateLimitError, ReadyCmd, RegionCapacityError, Sandbox, type SandboxApiOpts, type SandboxConnectOpts, SandboxCreateFailedError, type SandboxCreateRecovery, SandboxCreateRejectedError, type SandboxCreateRejectionReason, SandboxError, type SandboxInfo, type SandboxLifecycle, type SandboxListOpts, type SandboxMetrics, type SandboxMetricsOpts, type SandboxNetworkOpts, type SandboxOpts, SandboxPaginator, type SandboxRef, SandboxRegionScope, type SandboxState, type SandboxTarget, type SnapshotInfo, type SnapshotListOpts, SnapshotPaginator, type Stderr, type Stdout, Template, TemplateBase, type TemplateBuildStatus, type TemplateBuildStatusResponse, type TemplateBuilder, type TemplateClass, TemplateError, type TemplateTag, TemplateTagConflictError, type TemplateTagConflictReason, type TemplateTagExpectation, type TemplateTagInfo, TimeoutError, type Username, WatchHandle, type WriteInfo, type components, Sandbox as default, defaultBuildLogger, getSignature, type paths, waitForFile, waitForPort, waitForProcess, waitForTimeout, waitForURL };