@cofy-x/axern-sdk 0.5.1 → 0.7.0

package/dist/sandbox/index.js

@@ -6,13 +6,13 @@
 import { SandboxStateError } from "../errors/index.js";
 import { startTunnelRuntime, tunnelMetadata } from "../tunnel/runtime.js";
 import { directoryArchiveChunks, extractDirectoryArchive } from "./archive.js";
-import { defaultSandboxArgv, sandboxLabels, sandboxMetadata, validateSandboxOptions, waitReadyReplica } from "./lifecycle.js";
+import { defaultSandboxArgv, sandboxLabels, sandboxMetadata, validateSandboxOptions, waitRunningRun } from "./lifecycle.js";
 export class Sandbox {
     client;
     options;
     createdEnvironment = false;
     environmentId = "";
-    serviceId = "";
+    runId = "";
     currentState;
     currentMetadata;
     tunnelRuntime;
@@ -52,15 +52,14 @@ export class Sandbox {
                 this.environmentId = environmentId;
                 this.createdEnvironment = true;
             }
-            const service = await this.client.createService({
+            const run = await this.client.createRun({
                 namespace: this.options.namespace,
                 environmentId,
                 argv: this.options.argv ?? defaultSandboxArgv,
                 env: this.options.env,
                 cwd: this.options.cwd,
-                runtimeClass: this.options.runtimeClass,
+                networkPolicy: this.options.networkPolicy,
                 extensionCapabilities: this.options.extensionCapabilities,
-                volumes: this.options.volumes,
                 requestCpu: this.options.requestCpu,
                 requestMemory: this.options.requestMemory,
                 requestEphemeralStorage: this.options.requestEphemeralStorage,
@@ -69,14 +68,13 @@ export class Sandbox {
                 limitEphemeralStorage: this.options.limitEphemeralStorage,
                 labels: sandboxLabels(this.options.labels),
             });
-            this.serviceId = String(service.id ?? "");
-            const replica = await waitReadyReplica(this.serviceId, this.options.readyTimeoutMs ?? 180_000, (serviceId) => this.client.listServiceReplicas(serviceId));
+            this.runId = String(run.id ?? "");
+            const runningRun = await waitRunningRun(this.runId, this.options.readyTimeoutMs ?? 180_000, (runId, signal) => this.client.watchRun(runId, { signal }));
             this.currentState = {
                 environmentId,
-                serviceId: this.serviceId,
-                allocationId: String(replica.id ?? ""),
-                nodeId: String(replica.node_id ?? ""),
-                attempt: Number(replica.attempt ?? 0),
+                runId: this.runId,
+                allocationId: String(runningRun.allocation_id ?? ""),
+                nodeId: String(runningRun.node_id ?? ""),
                 startedAt: new Date(),
             };
             this.currentMetadata = sandboxMetadata(this.options, this.currentState);
@@ -100,17 +98,17 @@ export class Sandbox {
         }
     }
     async close() {
-        const serviceId = this.serviceId;
+        const runId = this.runId;
         const tunnelRuntime = this.tunnelRuntime;
-        this.serviceId = "";
+        this.runId = "";
         this.tunnelRuntime = undefined;
         this.currentState = undefined;
         this.currentMetadata = undefined;
         if (tunnelRuntime !== undefined) {
             await tunnelRuntime.stop().catch(() => undefined);
         }
-        if (serviceId !== "") {
-            await this.client.deleteService(serviceId).catch(() => undefined);
+        if (runId !== "") {
+            await this.client.cancelRun(runId).catch(() => undefined);
         }
         if (this.createdEnvironment && this.environmentId !== "") {
             const environmentId = this.environmentId;
@@ -125,12 +123,6 @@ export class Sandbox {
     async process(command, options = {}) {
         return this.nodeClient().process(command, options);
     }
-    async execImage(image, command, options = {}) {
-        return this.nodeClient().execImage(image, command, options);
-    }
-    async processImage(image, command, options = {}) {
-        return this.nodeClient().processImage(image, command, options);
-    }
     async capabilityStatus(options = {}) {
         return this.nodeClient().capabilityStatus(options);
     }
@@ -202,6 +194,6 @@ export class Sandbox {
         if (this.currentState === undefined) {
             throw new SandboxStateError("sandbox is not started");
         }
-        return this.client.nodeSandbox(this.currentState.allocationId);
+        return this.client.allocation(this.currentState.allocationId);
     }
 }

package/dist/sandbox/lifecycle.d.ts

@@ -8,4 +8,4 @@ export declare const defaultSandboxArgv: string[];
 export declare function validateSandboxOptions(options: SandboxOptions): void;
 export declare function sandboxLabels(labels: Record<string, string> | undefined): Record<string, string>;
 export declare function sandboxMetadata(options: SandboxOptions, state: SandboxState): SandboxMetadata;
-export declare function waitReadyReplica(serviceId: string, timeoutMs: number, listReplicas: (serviceId: string) => Promise<Record<string, unknown>[]>): Promise<Record<string, unknown>>;
+export declare function waitRunningRun(runId: string, timeoutMs: number, watchRun: (runId: string, signal: AbortSignal) => AsyncIterable<Record<string, unknown>>): Promise<Record<string, unknown>>;

package/dist/sandbox/lifecycle.js

@@ -5,6 +5,12 @@
  */
 import { SandboxTimeoutError, SandboxValidationError } from "../errors/index.js";
 export const defaultSandboxArgv = ["/bin/sh", "-lc", "sleep infinity"];
+const runStatus = {
+    running: 3,
+    succeeded: 4,
+    failed: 5,
+    cancelled: 6,
+};
 export function validateSandboxOptions(options) {
     const sourceCount = [options.templateId, options.image, options.environmentId].filter((source) => source !== undefined && source !== "").length;
     if (sourceCount !== 1) {
@@ -21,27 +27,62 @@ export function sandboxMetadata(options, state) {
     return {
         ...state,
         namespace: options.namespace ?? "default",
-        runtimeClass: options.runtimeClass ?? "",
         labels: sandboxLabels(options.labels),
         source: sandboxSource(options),
     };
 }
-export async function waitReadyReplica(serviceId, timeoutMs, listReplicas) {
+export async function waitRunningRun(runId, timeoutMs, watchRun) {
     const deadline = Date.now() + timeoutMs;
-    let lastReplicas = [];
-    while (Date.now() < deadline) {
-        lastReplicas = await listReplicas(serviceId);
-        const candidate = lastReplicas.find((replica) => replica.ready === true &&
-            replica.ended !== true &&
-            replica.outdated !== true &&
-            Number(replica.status ?? 0) === 4);
-        if (candidate !== undefined) {
-            return candidate;
+    let lastRun;
+    const controller = new AbortController();
+    const iterator = watchRun(runId, controller.signal)[Symbol.asyncIterator]();
+    try {
+        for (;;) {
+            const remainingMs = deadline - Date.now();
+            if (remainingMs <= 0)
+                break;
+            const result = await nextBeforeDeadline(iterator, remainingMs);
+            if (result === undefined || result.done)
+                break;
+            const run = result.value;
+            lastRun = run;
+            const status = Number(run.status ?? 0);
+            if (status === runStatus.running && String(run.allocation_id ?? "") !== "") {
+                return run;
+            }
+            if (status === runStatus.succeeded || status === runStatus.failed || status === runStatus.cancelled) {
+                throw new Error(`run ${runId} became ${String(run.status ?? "")} before its sandbox allocation was running: ${String(run.message ?? "")}`);
+            }
         }
-        await sleep(2_000);
     }
-    const details = lastReplicas.map((replica) => `${String(replica.id ?? "")}:${String(replica.status ?? "")}`).join(", ");
-    throw new SandboxTimeoutError(`service ${serviceId} did not produce a ready sandbox replica: ${details}`);
+    finally {
+        controller.abort();
+        try {
+            const close = iterator.return?.();
+            if (close !== undefined)
+                void close.catch(() => undefined);
+        }
+        catch {
+            // The readiness result owns the error surface; stream cleanup is best effort.
+        }
+    }
+    const details = lastRun === undefined ? "no state observed" : `${String(lastRun.status ?? "")}: ${String(lastRun.message ?? "")}`;
+    throw new SandboxTimeoutError(`run ${runId} did not reach a running sandbox allocation: ${details}`);
+}
+async function nextBeforeDeadline(iterator, timeoutMs) {
+    let timer;
+    try {
+        return await Promise.race([
+            iterator.next(),
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
 }
 function sandboxSource(options) {
     if (options.templateId !== undefined && options.templateId !== "") {
@@ -52,6 +93,3 @@ function sandboxSource(options) {
     }
     return "environment";
 }
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/dist/tunnel/connector.js

@@ -26,7 +26,7 @@ export class TunnelConnector {
         this.config = config;
     }
     async start() {
-        const target = this.config.session.client_edge_target || this.config.session.edge_target;
+        const target = this.config.session.client_edge_target;
         if (target === undefined || target === "") {
             throw new Error(`tunnel session ${this.config.session.session_id ?? ""} has no relay target`);
         }

package/dist/tunnel/control.d.ts

@@ -10,7 +10,6 @@ export declare class TunnelControlClient {
     constructor(client: grpc.Client);
     createSession(options: {
         allocationId: string;
-        upstream: string;
         proxyPort: number;
         ttlSeconds: number;
         readyTimeoutMs: number;

package/dist/tunnel/control.js

@@ -16,7 +16,6 @@ export class TunnelControlClient {
             const response = await unary(this.client, "CreateTunnelSession", {
                 allocation_id: required("allocationId", options.allocationId),
                 remote_port: options.proxyPort,
-                local_target: required("upstream", options.upstream),
                 ttl: duration(options.ttlSeconds * 1000),
                 wait_ready: true,
                 ready_timeout: duration(options.readyTimeoutMs),

package/dist/tunnel/runtime.d.ts

@@ -14,7 +14,6 @@ export interface TunnelConnectorRunner {
 export interface TunnelControl {
     createSession(options: {
         allocationId: string;
-        upstream: string;
         proxyPort: number;
         ttlSeconds: number;
         readyTimeoutMs: number;

package/dist/tunnel/runtime.js

@@ -15,7 +15,6 @@ export async function startTunnelRuntime(options) {
     const proxyPort = options.tunnel.proxyPort ?? defaultProxyPort;
     const result = await options.control.createSession({
         allocationId: options.allocationId,
-        upstream: options.tunnel.upstream,
         proxyPort,
         ttlSeconds,
         readyTimeoutMs: options.tunnel.readyTimeoutMs ?? defaultReadyTimeoutMs,

package/dist/tunnel/types.d.ts

@@ -6,7 +6,6 @@
 export interface TunnelSession {
     session_id?: string;
     allocation_id?: string;
-    edge_target?: string;
     client_edge_target?: string;
     bound_addr?: string;
     remote_port?: number;

package/dist/types.d.ts

@@ -24,22 +24,6 @@ export interface ExecResult {
     stdoutText(encoding?: BufferEncoding): string;
     stderrText(encoding?: BufferEncoding): string;
 }
-export interface ImageProcessMount {
-    sandboxPath: string;
-    targetPath: string;
-    readonly?: boolean;
-    options?: readonly string[];
-}
-export interface VolumeMount {
-    name: string;
-    target: string;
-    readonly?: boolean;
-    options?: readonly string[];
-}
-export declare function workspaceMount(path?: string): ImageProcessMount;
-export interface ImageExecOptions extends ExecOptions {
-    mounts?: readonly ImageProcessMount[];
-}
 export type ProcessEvent = {
     kind: "ready";
 } | {
@@ -54,9 +38,8 @@ export type ProcessEvent = {
     message: string;
 };
 export interface ProcessOptions extends Omit<ExecOptions, "check"> {
-}
-export interface ImageProcessOptions extends ProcessOptions {
-    mounts?: readonly ImageProcessMount[];
+    initialCols?: number;
+    initialRows?: number;
 }
 export interface ProcessResult {
     exitCode: number;
@@ -134,7 +117,7 @@ export interface TunnelMetadata {
     upstream: string;
     proxyPort: number;
 }
-export interface CapabilityDependencyStatus {
+export interface CapabilityProviderDependencyStatus {
     name: string;
     available: boolean;
     reason: string;
@@ -146,7 +129,7 @@ export interface CapabilityProviderStatus {
     capabilities: string[];
     backend: string;
     reason: string;
-    dependencies: CapabilityDependencyStatus[];
+    dependencies: CapabilityProviderDependencyStatus[];
 }
 export interface CapabilityProviderSummary {
     total: number;

package/dist/types.js

@@ -3,6 +3,4 @@
  * Copyright 2026 cofy-x
  * SPDX-License-Identifier: Apache-2.0
  */
-export function workspaceMount(path = "/workspace") {
-    return { sandboxPath: path, targetPath: path };
-}
+export {};

package/dist/version.d.ts

@@ -3,5 +3,5 @@
  * Copyright 2026 cofy-x
  * SPDX-License-Identifier: Apache-2.0
  */
-export declare const AXERN_VERSION = "0.5.1";
+export declare const AXERN_VERSION = "0.7.0";
 export declare function platformName(): string;

package/dist/version.js

@@ -3,7 +3,7 @@
  * Copyright 2026 cofy-x
  * SPDX-License-Identifier: Apache-2.0
  */
-export const AXERN_VERSION = "0.5.1";
+export const AXERN_VERSION = "0.7.0";
 export function platformName() {
     return "axern";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cofy-x/axern-sdk",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "TypeScript SDK for Axern agentic infrastructure and isolated sandboxes",
   "license": "Apache-2.0",
   "repository": {

package/dist/proto/axern/control/admin/v1/allocation_lifecycle.proto

@@ -1,91 +0,0 @@
-syntax = "proto3";
-
-package axern.control.admin.v1;
-
-option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
-
-import "google/protobuf/timestamp.proto";
-
-enum AllocationLifecycleRetryOwnerType {
-  ALLOCATION_LIFECYCLE_RETRY_OWNER_TYPE_UNSPECIFIED = 0;
-  ALLOCATION_LIFECYCLE_RETRY_OWNER_TYPE_RUN = 1;
-  ALLOCATION_LIFECYCLE_RETRY_OWNER_TYPE_SERVICE = 2;
-}
-
-enum AllocationLifecycleRetryReason {
-  ALLOCATION_LIFECYCLE_RETRY_REASON_UNSPECIFIED = 0;
-  ALLOCATION_LIFECYCLE_RETRY_REASON_CREATE = 1;
-  ALLOCATION_LIFECYCLE_RETRY_REASON_DELETE = 2;
-}
-
-message AllocationLifecycleRetry {
-  string allocation_id = 1;
-  string owner_id = 2;
-  AllocationLifecycleRetryOwnerType owner_type = 3;
-  string environment_id = 4;
-  AllocationLifecycleRetryReason reason = 5;
-  string node_id = 6;
-  string node_target = 7;
-  int64 attempt = 8;
-  int32 reconcile_attempts = 9;
-  string last_error = 10;
-  google.protobuf.Timestamp next_run_at = 11;
-  google.protobuf.Timestamp created_at = 12;
-  google.protobuf.Timestamp updated_at = 13;
-  int64 age_seconds = 14;
-  bool due = 15;
-  bool clearable = 16;
-  string clear_blocked_reason = 17;
-}
-
-message AllocationLifecycleRetryFilter {
-  AllocationLifecycleRetryOwnerType owner_type = 1;
-  AllocationLifecycleRetryReason reason = 2;
-  bool due_only = 3;
-}
-
-message ListAllocationLifecycleRetriesRequest {
-  AllocationLifecycleRetryFilter filter = 1;
-  int32 limit = 2;
-}
-
-message ListAllocationLifecycleRetriesResponse {
-  repeated AllocationLifecycleRetry retries = 1;
-}
-
-message ForceAllocationLifecycleRetryRequest {
-  string allocation_id = 1;
-  AllocationLifecycleRetryReason reason = 2;
-  string operator_reason = 3;
-}
-
-message ForceAllocationLifecycleRetryResponse {
-  AllocationLifecycleRetry retry = 1;
-}
-
-message FailAllocationLifecycleRetryRequest {
-  string allocation_id = 1;
-  AllocationLifecycleRetryReason reason = 2;
-  string operator_reason = 3;
-}
-
-message FailAllocationLifecycleRetryResponse {
-  AllocationLifecycleRetry failed_retry = 1;
-}
-
-message ClearAllocationLifecycleRetryRequest {
-  string allocation_id = 1;
-  AllocationLifecycleRetryReason reason = 2;
-  string operator_reason = 3;
-}
-
-message ClearAllocationLifecycleRetryResponse {
-  AllocationLifecycleRetry cleared_retry = 1;
-}
-
-service AllocationLifecycleAdmin {
-  rpc ListAllocationLifecycleRetries(ListAllocationLifecycleRetriesRequest) returns (ListAllocationLifecycleRetriesResponse) {}
-  rpc ForceAllocationLifecycleRetry(ForceAllocationLifecycleRetryRequest) returns (ForceAllocationLifecycleRetryResponse) {}
-  rpc FailAllocationLifecycleRetry(FailAllocationLifecycleRetryRequest) returns (FailAllocationLifecycleRetryResponse) {}
-  rpc ClearAllocationLifecycleRetry(ClearAllocationLifecycleRetryRequest) returns (ClearAllocationLifecycleRetryResponse) {}
-}

package/dist/proto/axern/control/admin/v1/service.proto

@@ -1,18 +0,0 @@
-syntax = "proto3";
-
-package axern.control.admin.v1;
-
-option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
-
-message PurgeServiceRequest {
-  string service_id = 1;
-  string operator_reason = 2;
-}
-
-message PurgeServiceResponse {
-  string service_id = 1;
-}
-
-service ServiceAdmin {
-  rpc PurgeService(PurgeServiceRequest) returns (PurgeServiceResponse) {}
-}

package/dist/proto/axern/control/admin/v1/storage.proto

@@ -1,81 +0,0 @@
-syntax = "proto3";
-
-package axern.control.admin.v1;
-
-option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
-
-import "axern/control/storage/v1/storage_types.proto";
-import "google/protobuf/timestamp.proto";
-
-message StorageBinding {
-  string binding_id = 1;
-  string claim_id = 2;
-  string namespace = 3;
-  string claim_name = 4;
-  string workload_id = 5;
-  string workload_type = 6;
-  string allocation_id = 7;
-  string node_id = 8;
-  axern.control.storage.v1.VolumeStatus status = 9;
-  string message = 10;
-  google.protobuf.Timestamp created_at = 11;
-  google.protobuf.Timestamp updated_at = 12;
-  google.protobuf.Timestamp published_at = 13;
-  google.protobuf.Timestamp released_at = 14;
-}
-
-message StorageBindingFilter {
-  repeated axern.control.storage.v1.VolumeStatus statuses = 1;
-  string namespace = 2;
-  string claim_name = 3;
-  string workload_id = 4;
-  string allocation_id = 5;
-  string node_id = 6;
-}
-
-message ListStorageBindingsRequest {
-  StorageBindingFilter filter = 1;
-  int32 limit = 2;
-}
-
-message ListStorageBindingsResponse {
-  repeated StorageBinding bindings = 1;
-}
-
-message RetryStorageBindingRequest {
-  string binding_id = 1;
-  string operator_reason = 2;
-}
-
-message RetryStorageBindingResponse {
-  StorageBinding binding = 1;
-}
-
-message StorageReclaim {
-  string claim_id = 1;
-  string namespace = 2;
-  string claim_name = 3;
-  string service_id = 4;
-  string node_id = 5;
-  int64 attempt = 6;
-  google.protobuf.Timestamp next_retry_at = 7;
-  string last_error = 8;
-  google.protobuf.Timestamp updated_at = 9;
-}
-
-message ListStorageReclaimsRequest {
-  string namespace = 1;
-  string service_id = 2;
-  string node_id = 3;
-  int32 limit = 4;
-}
-
-message ListStorageReclaimsResponse {
-  repeated StorageReclaim reclaims = 1;
-}
-
-service StorageAdmin {
-  rpc ListStorageBindings(ListStorageBindingsRequest) returns (ListStorageBindingsResponse) {}
-  rpc RetryStorageBinding(RetryStorageBindingRequest) returns (RetryStorageBindingResponse) {}
-  rpc ListStorageReclaims(ListStorageReclaimsRequest) returns (ListStorageReclaimsResponse) {}
-}