@tangle-network/sandbox 0.0.3

package/dist/index-CIkhycpG.d.ts

@@ -0,0 +1,131 @@
+//#region src/collaboration/types.d.ts
+/**
+ * Collaboration Types
+ *
+ * Shared type contracts for collaborative document identity and bootstrap.
+ */
+interface CollaborationDocumentRef {
+  workspaceId: string;
+  relativePath: string;
+}
+interface CollaborationTransportConfig {
+  websocketUrl: string;
+  token: string;
+  expiresAt: number;
+}
+interface CollaborationPermissions {
+  access: "read" | "write";
+  canSnapshot: boolean;
+}
+interface CollaborationBootstrapRequest {
+  workspaceId: string;
+  relativePath: string;
+}
+interface CollaborationBootstrapResponse {
+  documentId: string;
+  transport: CollaborationTransportConfig;
+  permissions: CollaborationPermissions;
+  source: "crdt" | "filesystem";
+  initialContent: string;
+  snapshotVersion?: string;
+}
+interface CollaborationTokenRefreshRequest {
+  workspaceId: string;
+  documentId: string;
+}
+interface CollaborationTokenRefreshResponse {
+  token: string;
+  expiresAt: number;
+  access: "read" | "write";
+}
+interface SaveCollaborationSnapshotRequest {
+  workspaceId: string;
+  relativePath: string;
+  documentId: string;
+}
+interface SaveCollaborationSnapshotResponse {
+  snapshotVersion: string;
+  savedAt: string;
+}
+interface CollaborationFileEvent {
+  path: string;
+  type: "updated" | "deleted" | "renamed";
+  content?: string;
+  nextPath?: string;
+  origin?: "agent" | "user" | "system" | "bridge";
+  version?: string;
+}
+interface CollaborationDocumentChange {
+  content: string;
+  origin?: string;
+  version?: string;
+}
+interface CollaborationDocumentAdapter {
+  getContent(): string;
+  replaceContent(content: string, meta?: {
+    origin?: string;
+    version?: string;
+  }): void;
+  subscribe(listener: (change: CollaborationDocumentChange) => void): () => void;
+}
+interface CollaborationFileBridgeOptions {
+  documentId: string;
+  relativePath: string;
+  writeFile: (path: string, content: string) => Promise<void>;
+  subscribeToFileEvents: (path: string, onChange: (event: CollaborationFileEvent) => void) => () => void;
+  debounceMs?: number;
+  onFileDeleted?: (event: CollaborationFileEvent) => void;
+  onFileRenamed?: (event: CollaborationFileEvent) => void;
+}
+interface CollaborationClientConfig {
+  baseUrl: string;
+  timeoutMs?: number;
+  headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+  fetch?: typeof globalThis.fetch;
+}
+//#endregion
+//#region src/collaboration/client.d.ts
+declare class CollaborationClient {
+  private readonly baseUrl;
+  private readonly timeoutMs;
+  private readonly fetchImpl;
+  private readonly headers?;
+  constructor(config: CollaborationClientConfig);
+  bootstrap(request: CollaborationBootstrapRequest): Promise<CollaborationBootstrapResponse>;
+  refreshToken(request: CollaborationTokenRefreshRequest): Promise<CollaborationTokenRefreshResponse>;
+  saveSnapshot(request: SaveCollaborationSnapshotRequest): Promise<SaveCollaborationSnapshotResponse>;
+  private requestJson;
+  private resolveHeaders;
+}
+//#endregion
+//#region src/collaboration/document-id.d.ts
+declare function normalizeCollaborationPath(path: string): string;
+declare function buildCollaborationDocumentId(ref: CollaborationDocumentRef): string;
+declare function parseCollaborationDocumentId(documentId: string): CollaborationDocumentRef | null;
+//#endregion
+//#region src/collaboration/file-bridge.d.ts
+/**
+ * Headless bridge between a collaborative document adapter and the sandbox
+ * filesystem. Keeps this package free of direct Yjs assumptions.
+ */
+declare class CollaborationFileBridge {
+  private readonly debounceMs;
+  private readonly options;
+  private adapter;
+  private unsubscribeDocument;
+  private unsubscribeFileEvents;
+  private pendingWriteTimer;
+  private destroyed;
+  private boundPath;
+  private lastWrittenContent;
+  constructor(options: CollaborationFileBridgeOptions);
+  bind(adapter: CollaborationDocumentAdapter): void;
+  flush(): Promise<void>;
+  getPath(): string;
+  destroy(): void;
+  private scheduleWrite;
+  private write;
+  private handleFileEvent;
+}
+//#endregion
+export { CollaborationTransportConfig as _, CollaborationClient as a, CollaborationClientConfig as c, CollaborationDocumentRef as d, CollaborationFileBridgeOptions as f, CollaborationTokenRefreshResponse as g, CollaborationTokenRefreshRequest as h, parseCollaborationDocumentId as i, CollaborationDocumentAdapter as l, CollaborationPermissions as m, buildCollaborationDocumentId as n, CollaborationBootstrapRequest as o, CollaborationFileEvent as p, normalizeCollaborationPath as r, CollaborationBootstrapResponse as s, CollaborationFileBridge as t, CollaborationDocumentChange as u, SaveCollaborationSnapshotRequest as v, SaveCollaborationSnapshotResponse as y };

package/dist/index-DAcOU3eO.d.ts

@@ -0,0 +1,356 @@
+import { b as CreateSandboxOptions, n as SandboxInstance, t as HttpClient } from "./sandbox-D-1E98ow.js";
+
+//#region src/tangle/abi.d.ts
+/**
+ * Tangle Contract ABI Definitions
+ *
+ * Viem-compatible ABI for the ITangleJobs precompile, the AgentSandbox
+ * blueprint contract views/events, and ABI parameter definitions for
+ * encoding/decoding blueprint job inputs and outputs.
+ */
+declare const ITangleJobsAbi: readonly [{
+  readonly type: "function";
+  readonly name: "submitJob";
+  readonly inputs: readonly [{
+    readonly name: "serviceId";
+    readonly type: "uint64";
+  }, {
+    readonly name: "jobIndex";
+    readonly type: "uint8";
+  }, {
+    readonly name: "inputs";
+    readonly type: "bytes";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "callId";
+    readonly type: "uint64";
+  }];
+  readonly stateMutability: "payable";
+}, {
+  readonly type: "function";
+  readonly name: "getJobCall";
+  readonly inputs: readonly [{
+    readonly name: "serviceId";
+    readonly type: "uint64";
+  }, {
+    readonly name: "callId";
+    readonly type: "uint64";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "tuple";
+    readonly components: readonly [{
+      readonly name: "jobIndex";
+      readonly type: "uint8";
+    }, {
+      readonly name: "caller";
+      readonly type: "address";
+    }, {
+      readonly name: "createdAt";
+      readonly type: "uint64";
+    }, {
+      readonly name: "resultCount";
+      readonly type: "uint32";
+    }, {
+      readonly name: "payment";
+      readonly type: "uint256";
+    }, {
+      readonly name: "completed";
+      readonly type: "bool";
+    }];
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "event";
+  readonly name: "JobSubmitted";
+  readonly inputs: readonly [{
+    readonly name: "serviceId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "callId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "jobIndex";
+    readonly type: "uint8";
+    readonly indexed: true;
+  }, {
+    readonly name: "caller";
+    readonly type: "address";
+    readonly indexed: false;
+  }, {
+    readonly name: "inputs";
+    readonly type: "bytes";
+    readonly indexed: false;
+  }];
+}, {
+  readonly type: "event";
+  readonly name: "JobResultSubmitted";
+  readonly inputs: readonly [{
+    readonly name: "serviceId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "callId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "operator";
+    readonly type: "address";
+    readonly indexed: true;
+  }, {
+    readonly name: "result";
+    readonly type: "bytes";
+    readonly indexed: false;
+  }];
+}];
+declare const SandboxCreateParamTypes: readonly [{
+  readonly name: "name";
+  readonly type: "string";
+}, {
+  readonly name: "image";
+  readonly type: "string";
+}, {
+  readonly name: "stack";
+  readonly type: "string";
+}, {
+  readonly name: "agent_identifier";
+  readonly type: "string";
+}, {
+  readonly name: "env_json";
+  readonly type: "string";
+}, {
+  readonly name: "metadata_json";
+  readonly type: "string";
+}, {
+  readonly name: "ssh_enabled";
+  readonly type: "bool";
+}, {
+  readonly name: "ssh_public_key";
+  readonly type: "string";
+}, {
+  readonly name: "web_terminal_enabled";
+  readonly type: "bool";
+}, {
+  readonly name: "max_lifetime_seconds";
+  readonly type: "uint64";
+}, {
+  readonly name: "idle_timeout_seconds";
+  readonly type: "uint64";
+}, {
+  readonly name: "cpu_cores";
+  readonly type: "uint64";
+}, {
+  readonly name: "memory_mb";
+  readonly type: "uint64";
+}, {
+  readonly name: "disk_gb";
+  readonly type: "uint64";
+}, {
+  readonly name: "sidecar_token";
+  readonly type: "string";
+}];
+declare const SandboxIdParamTypes: readonly [{
+  readonly name: "sandbox_id";
+  readonly type: "string";
+}];
+declare const SandboxCreateResponseParamTypes: readonly [{
+  readonly name: "sandboxId";
+  readonly type: "string";
+}, {
+  readonly name: "json";
+  readonly type: "string";
+}];
+declare const JsonResponseParamTypes: readonly [{
+  readonly name: "json";
+  readonly type: "string";
+}];
+declare const AgentSandboxBlueprintAbi: readonly [{
+  readonly type: "function";
+  readonly name: "getAvailableCapacity";
+  readonly inputs: readonly [];
+  readonly outputs: readonly [{
+    readonly name: "available";
+    readonly type: "uint32";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly name: "getServiceStats";
+  readonly inputs: readonly [];
+  readonly outputs: readonly [{
+    readonly name: "totalSandboxes";
+    readonly type: "uint32";
+  }, {
+    readonly name: "totalCapacity";
+    readonly type: "uint32";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly name: "getOperatorLoad";
+  readonly inputs: readonly [{
+    readonly name: "operator";
+    readonly type: "address";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "active";
+    readonly type: "uint32";
+  }, {
+    readonly name: "max";
+    readonly type: "uint32";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly name: "getSandboxOperator";
+  readonly inputs: readonly [{
+    readonly name: "sandboxId";
+    readonly type: "string";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "address";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "function";
+  readonly name: "isSandboxActive";
+  readonly inputs: readonly [{
+    readonly name: "sandboxId";
+    readonly type: "string";
+  }];
+  readonly outputs: readonly [{
+    readonly name: "";
+    readonly type: "bool";
+  }];
+  readonly stateMutability: "view";
+}, {
+  readonly type: "event";
+  readonly name: "OperatorAssigned";
+  readonly inputs: readonly [{
+    readonly name: "serviceId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "callId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "operator";
+    readonly type: "address";
+    readonly indexed: true;
+  }];
+}, {
+  readonly type: "event";
+  readonly name: "OperatorRouted";
+  readonly inputs: readonly [{
+    readonly name: "serviceId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "callId";
+    readonly type: "uint64";
+    readonly indexed: true;
+  }, {
+    readonly name: "operator";
+    readonly type: "address";
+    readonly indexed: true;
+  }];
+}, {
+  readonly type: "event";
+  readonly name: "SandboxCreated";
+  readonly inputs: readonly [{
+    readonly name: "sandboxHash";
+    readonly type: "bytes32";
+    readonly indexed: true;
+  }, {
+    readonly name: "operator";
+    readonly type: "address";
+    readonly indexed: true;
+  }];
+}, {
+  readonly type: "event";
+  readonly name: "SandboxDeleted";
+  readonly inputs: readonly [{
+    readonly name: "sandboxHash";
+    readonly type: "bytes32";
+    readonly indexed: true;
+  }, {
+    readonly name: "operator";
+    readonly type: "address";
+    readonly indexed: true;
+  }];
+}];
+//#endregion
+//#region src/tangle/types.d.ts
+/**
+ * Tangle Sandbox Client types and constants.
+ */
+/** Tangle mainnet chain ID. */
+declare const TANGLE_CHAIN_ID = 5845;
+/** Tangle mainnet RPC endpoint. */
+declare const TANGLE_MAINNET_RPC = "https://rpc.tangle.tools";
+/** ITangleJobs precompile contract address. */
+declare const TANGLE_JOBS_CONTRACT: "0x0000000000000000000000000000000000000808";
+/** Job indices matching the blueprint's job IDs. */
+declare const JOB_SANDBOX_CREATE = 0;
+declare const JOB_SANDBOX_STOP = 1;
+declare const JOB_SANDBOX_RESUME = 2;
+declare const JOB_SANDBOX_DELETE = 3;
+interface TangleSandboxClientConfig {
+  /** Tangle service instance ID for the sandbox blueprint. */
+  serviceId: bigint;
+  /** viem WalletClient for browser environments. Mutually exclusive with privateKey. */
+  wallet?: unknown;
+  /** Hex-encoded private key for Node.js environments. Mutually exclusive with wallet. */
+  privateKey?: `0x${string}`;
+  /** RPC URL. Required when using privateKey. Defaults to Tangle mainnet. */
+  rpcUrl?: string;
+  /** Blueprint contract address for view calls (getAvailableCapacity, etc). */
+  blueprintContractAddress?: `0x${string}`;
+  /** ITangleJobs precompile address. Defaults to 0x...0808. */
+  contractAddress?: `0x${string}`;
+  /** Max time to wait for a job to complete. No hard limit — agent jobs can run hours. Default: 14400000 (4h). */
+  jobTimeoutMs?: number;
+  /** Interval between job completion polls. Default: 5000 (5s). */
+  pollIntervalMs?: number;
+}
+//#endregion
+//#region src/tangle/client.d.ts
+declare class TangleSandboxClient implements HttpClient {
+  private readonly chain;
+  private readonly sandboxes;
+  constructor(config: TangleSandboxClientConfig);
+  /**
+   * Create a sandbox via on-chain job submission.
+   */
+  create(options?: CreateSandboxOptions): Promise<SandboxInstance>;
+  /**
+   * Route interception for SandboxInstance lifecycle calls.
+   *
+   * SandboxInstance calls this.client.fetch() for:
+   * - GET /v1/sandboxes/:id → return from local tracking
+   * - POST /v1/sandboxes/:id/stop → on-chain JOB_SANDBOX_STOP
+   * - POST /v1/sandboxes/:id/resume → on-chain JOB_SANDBOX_RESUME
+   * - DELETE /v1/sandboxes/:id → on-chain JOB_SANDBOX_DELETE
+   */
+  fetch(path: string, options?: RequestInit): Promise<Response>;
+  private fetchRuntime;
+  /**
+   * Get available capacity from the blueprint contract.
+   * Requires blueprintContractAddress in config.
+   */
+  getAvailableCapacity(): Promise<number>;
+  /**
+   * Get service stats from the blueprint contract.
+   * Requires blueprintContractAddress in config.
+   */
+  getServiceStats(): Promise<{
+    totalSandboxes: number;
+    totalCapacity: number;
+  }>;
+}
+//#endregion
+export { JOB_SANDBOX_STOP as a, TANGLE_MAINNET_RPC as c, ITangleJobsAbi as d, JsonResponseParamTypes as f, SandboxIdParamTypes as h, JOB_SANDBOX_RESUME as i, TangleSandboxClientConfig as l, SandboxCreateResponseParamTypes as m, JOB_SANDBOX_CREATE as n, TANGLE_CHAIN_ID as o, SandboxCreateParamTypes as p, JOB_SANDBOX_DELETE as r, TANGLE_JOBS_CONTRACT as s, TangleSandboxClient as t, AgentSandboxBlueprintAbi as u };