@tangle-network/sandbox 0.6.1 → 0.8.1

package/dist/{sandbox-BQbq1EGP.d.ts → sandbox-CNcyBhPp.d.ts}

@@ -1,272 +1,5 @@
-//#region src/agent-profile.d.ts
-/**
- * Provider-neutral agent profile types for public SDK consumers.
- *
- * These model portable agent intent at the application boundary.
- * Individual backends can translate this shape into their own native
- * profile/configuration formats internally.
- */
-/**
- * Permission policy value for a capability.
- */
-type AgentProfilePermissionValue = "allow" | "ask" | "deny";
-type AgentProfilePermission = AgentProfilePermissionValue | Record<string, AgentProfilePermissionValue>;
-/**
- * Generic resource reference that can be resolved into a file or instruction.
- */
-type AgentProfileResourceRef = {
-  kind: "inline";
-  name: string;
-  content: string;
-} | {
-  kind: "github";
-  /**
-   * Optional repository in "owner/repo" form. When omitted, providers may
-   * only resolve the path if they have an ambient repository context.
-   */
-  repository?: string;
-  path: string;
-  ref?: string;
-  name?: string;
-};
-/**
- * Helper for creating typed inline resource refs.
- */
-declare function defineInlineResource(name: string, content: string): AgentProfileResourceRef;
-/**
- * Helper for creating typed GitHub-backed resource refs.
- */
-declare function defineGitHubResource(path: string, options?: {
-  repository?: string;
-  ref?: string;
-  name?: string;
-}): AgentProfileResourceRef;
-/**
- * Resource mounted into a backend workspace.
- */
-interface AgentProfileFileMount {
-  path: string;
-  resource: AgentProfileResourceRef;
-  executable?: boolean;
-}
-/**
- * Provider-neutral resource bundle.
- */
-interface AgentProfileResources {
-  /**
-   * Generic files to materialize into the agent workspace before execution.
-   */
-  files?: AgentProfileFileMount[];
-  /**
-   * Provider-native tool files. Backends materialize these into their standard
-   * discovery location when they support file-based tools.
-   */
-  tools?: AgentProfileResourceRef[];
-  /**
-   * Agent Skills (`SKILL.md`) packages. Supported by Cursor, Claude Code,
-   * Codex-compatible layouts, OpenCode, and Hermes-style skill harnesses.
-   */
-  skills?: AgentProfileResourceRef[];
-  /**
-   * Provider-native subagent definition files.
-   */
-  agents?: AgentProfileResourceRef[];
-  /**
-   * Provider-native slash command files.
-   */
-  commands?: AgentProfileResourceRef[];
-  /**
-   * Additional instructions injected into the agent context.
-   */
-  instructions?: string | AgentProfileResourceRef;
-  /**
-   * Fail initialization when a provider cannot materialize a resource.
-   */
-  failOnError?: boolean;
-}
-/**
- * Model selection hints for backends.
- */
-interface AgentProfileModelHints {
-  /**
-   * Preferred default model (format depends on backend, commonly "provider/model").
-   */
-  default?: string;
-  /**
-   * Preferred small/cheap model for lightweight work.
-   */
-  small?: string;
-  /**
-   * Optional provider preference hint.
-   */
-  provider?: string;
-  /**
-   * Backend-agnostic model metadata/hints.
-   */
-  metadata?: Record<string, unknown>;
-}
-/**
- * Prompt shaping for an agent.
- */
-interface AgentProfilePrompt {
-  /**
-   * Full system prompt replacement, when supported.
-   */
-  systemPrompt?: string;
-  /**
-   * Additional instruction lines appended to the active prompt.
-   */
-  instructions?: string[];
-}
-/**
- * Generic subagent definition.
- */
-interface AgentSubagentProfile {
-  description?: string;
-  prompt?: string;
-  model?: string;
-  tools?: Record<string, boolean>;
-  permissions?: Record<string, AgentProfilePermission>;
-  maxSteps?: number;
-  metadata?: Record<string, unknown>;
-}
-interface AgentProfileHookCommand {
-  command: string;
-  timeoutMs?: number;
-  blocking?: boolean;
-  matcher?: string;
-  env?: Record<string, string>;
-}
-interface AgentProfileMode {
-  description?: string;
-  model?: string;
-  prompt?: string;
-  tools?: Record<string, boolean>;
-  permissions?: Record<string, AgentProfilePermission>;
-  metadata?: Record<string, unknown>;
-}
-/**
- * Confidential-execution options for sandbox backends.
- *
- * The Tangle blueprint path translates this into TEE job parameters and fails
- * closed when the requested TEE is unavailable. Callers should verify returned
- * attestation evidence before treating a session as confidential.
- */
-interface AgentProfileConfidential {
-  /**
-   * TEE variant requested from the operator.
-   */
-  tee?: "tdx" | "nitro" | "phala-dstack" | "sev-snp" | "any" | (string & {});
-  /**
-   * Optional hex-encoded 32-64 byte challenge for deploy-time report data.
-   */
-  attestationNonce?: string;
-  /**
-   * Require no persistence across session end when supported by the backend.
-   */
-  sealed?: boolean;
-  /**
-   * Ask the SDK/backend to create or require a fresh attestation challenge.
-   */
-  attestationRefresh?: boolean;
-}
-/**
- * Generic MCP server configuration.
- */
-interface AgentProfileMcpServer {
-  transport?: "stdio" | "sse" | "http";
-  command?: string;
-  args?: string[];
-  env?: Record<string, string>;
-  cwd?: string;
-  url?: string;
-  headers?: Record<string, string>;
-  enabled?: boolean;
-  metadata?: Record<string, unknown>;
-}
-/**
- * Public provider-neutral agent profile contract.
- */
-interface AgentProfile {
-  name?: string;
-  description?: string;
-  version?: string;
-  tags?: string[];
-  prompt?: AgentProfilePrompt;
-  model?: AgentProfileModelHints;
-  permissions?: Record<string, AgentProfilePermission>;
-  tools?: Record<string, boolean>;
-  mcp?: Record<string, AgentProfileMcpServer>;
-  subagents?: Record<string, AgentSubagentProfile>;
-  resources?: AgentProfileResources;
-  hooks?: Record<string, AgentProfileHookCommand[]>;
-  modes?: Record<string, AgentProfileMode>;
-  confidential?: AgentProfileConfidential;
-  metadata?: Record<string, unknown>;
-  /**
-   * Non-portable backend-specific extensions.
-   *
-   * Use this only for features that cannot be expressed generically.
-   * SDK consumers should treat extension keys as backend namespaces.
-   */
-  extensions?: Record<string, Record<string, unknown> | undefined>;
-}
-/**
- * Helper for declaring typed profiles in application code.
- */
-declare function defineAgentProfile<T extends AgentProfile>(profile: T): T;
-/**
- * Capabilities describing how a backend interprets AgentProfile.
- */
-interface AgentProfileCapabilities {
-  namedProfiles: boolean;
-  systemPrompt: boolean;
-  instructions: boolean;
-  tools: boolean;
-  permissions: boolean;
-  mcp: boolean;
-  subagents: boolean;
-  resources: {
-    files: boolean;
-    instructions: boolean;
-    tools?: boolean;
-    skills?: boolean;
-    agents?: boolean;
-    commands?: boolean;
-  };
-  hooks?: boolean;
-  modes?: boolean;
-  runtimeUpdate: boolean;
-  validation: boolean;
-  /**
-   * Backend extension namespaces understood by this backend.
-   */
-  extensions?: string[];
-}
-/**
- * Validation issue for a profile/backend pairing.
- */
-interface AgentProfileValidationIssue {
-  level: "error" | "warning" | "info";
-  code: string;
-  message: string;
-  path?: string;
-}
-/**
- * Validation output for a provider adapter.
- */
-interface AgentProfileValidationResult {
-  ok: boolean;
-  issues: AgentProfileValidationIssue[];
-  normalizedProfile?: AgentProfile;
-}
-/**
- * Merge two public AgentProfile values.
- *
- * Overlay fields win on conflicts. Array-like instruction sets are appended.
- */
-declare function mergeAgentProfiles(base: AgentProfile | undefined, overlay: AgentProfile | undefined): AgentProfile | undefined;
-//#endregion
+import { AgentProfile, AgentProfileCapabilities, AgentProfileConfidential, AgentProfileFileMount, AgentProfileMcpServer, AgentProfileModelHints, AgentProfilePermissionValue, AgentProfilePrompt, AgentProfileResourceRef, AgentProfileResources, AgentProfileValidationIssue, AgentProfileValidationResult, AgentSubagentProfile, defineAgentProfile, defineGitHubResource, defineInlineResource, mergeAgentProfiles } from "@tangle-network/agent-interface";
+
 //#region src/types.d.ts
 type JsonValue = string | number | boolean | null | JsonValue[] | {
   [key: string]: JsonValue;
@@ -817,10 +550,8 @@ interface CreateSandboxOptions {
    *
    * The capability is enforced at two layers:
    * 1. The sidecar refuses to start if a capability's binaries are
-   *    missing (computer_use needs the universal Nix profile, which
-   *    Docker / host-agent / Firecracker drivers ship via the host
-   *    bind-mount or the universal sidecar image variant; Firecracker
-   *    host profiles built without the universal flake do not).
+   *    missing (`computer_use` needs the mounted Nix profile with
+   *    Xvfb, dbus, xdotool, and scrot available at runtime).
    * 2. The MCP token endpoint refuses to mint a `cap: ["computer_use"]`
    *    JWT for a sandbox that wasn't created with that capability.
    *
@@ -937,6 +668,12 @@ interface SandboxConnection {
   authToken?: string;
   /** Token expiration timestamp (ISO 8601). Refresh before this time. */
   authTokenExpiresAt?: string;
+  /** Public inbound edge attachment state for `runtimeUrl`. */
+  edgeStatus?: "pending" | "ready" | "failed" | "skipped";
+  /** Timestamp when the public edge reached this sandbox. */
+  edgeReadyAt?: string;
+  /** Last public edge attachment error message. */
+  edgeError?: string;
   /** SSH connection info if `sshEnabled` was true during creation */
   ssh?: SSHCredentials;
   /** Web terminal URL if `webTerminalEnabled` was true during creation */
@@ -3530,8 +3267,11 @@ interface Process {
   /**
    * Kill the process.
    * @param signal - Signal to send (default: SIGTERM)
+   * @param options - Kill behavior options
    */
-  kill(signal?: ProcessSignal): Promise<void>;
+  kill(signal?: ProcessSignal, options?: {
+    tree?: boolean;
+  }): Promise<void>;
   /**
    * Stream stdout/stderr logs in real-time.
    * Includes buffered logs from process start.