@miosa/sdk 1.2.28 → 2.0.1

package/dist/index.d.ts

@@ -16,6 +16,7 @@ interface RequestOptions {
 interface HttpClientConfig {
     baseUrl: string;
     apiKey: string;
+    tenant?: string;
     timeout: number;
     maxRetries: number;
 }
@@ -24,6 +25,7 @@ declare class HttpClient {
     readonly baseUrl: string;
     /** Public for WebSocket clients that need to send the same auth. */
     readonly apiKey: string;
+    readonly tenant: string | undefined;
     private readonly timeout;
     private readonly maxRetries;
     constructor(config: HttpClientConfig);
@@ -164,6 +166,279 @@ declare class Admin {
     }>;
 }
 
+type AgentRunTargetKind = "sandbox" | "computer";
+type AgentRunStatus = "running" | "succeeded" | "failed" | "canceled";
+interface AgentRun {
+    id: string;
+    agent_run_group_id?: string;
+    parent_agent_run_id?: string;
+    orchestration_role?: string;
+    external_workspace_id?: string | null;
+    external_user_id?: string | null;
+    external_project_id?: string | null;
+    target_kind: AgentRunTargetKind;
+    target_id: string;
+    provider: string;
+    prompt: string;
+    status: AgentRunStatus;
+    output?: string;
+    stderr?: string;
+    exit_code?: number;
+    metadata?: Record<string, unknown>;
+    started_at?: string;
+    finished_at?: string;
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+interface AgentRunArtifact {
+    id: string;
+    agent_run_id?: string;
+    target_kind?: AgentRunTargetKind;
+    target_id?: string;
+    path: string;
+    kind?: string;
+    mime_type?: string;
+    size_bytes?: number;
+    sha256?: string;
+    status?: string;
+    persisted?: boolean;
+    storage_backend?: string | null;
+    persisted_at?: string | null;
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+interface AgentRunEvent {
+    id: string;
+    agent_run_id?: string;
+    sequence?: number;
+    type: string;
+    message?: string | null;
+    payload?: Record<string, unknown>;
+    created_at?: string | null;
+    [key: string]: unknown;
+}
+interface AgentRunExecutionPacket {
+    goal?: string;
+    context?: Record<string, unknown>;
+    plan?: unknown;
+    constraints?: unknown;
+    acceptance_criteria?: unknown;
+    [key: string]: unknown;
+}
+interface AgentRunOutputContract {
+    artifacts?: Array<string | Partial<AgentRunArtifact>>;
+    artifact_paths?: string[];
+    preview_port?: number;
+    required_files?: string[];
+    [key: string]: unknown;
+}
+interface AgentRunApprovalPolicy {
+    publish?: "manual" | "automatic" | string;
+    external_write?: "manual" | "automatic" | string;
+    destructive_actions?: "forbidden" | "manual" | "automatic" | string;
+    [key: string]: unknown;
+}
+interface AgentRunCreateParams {
+    prompt: string;
+    targetKind?: AgentRunTargetKind;
+    targetId?: string;
+    sandboxId?: string;
+    /** Shortcut for a computer-backed Agent Run. */
+    computerId?: string;
+    provider?: string;
+    model?: string;
+    command?: string;
+    runtimeCommand?: string;
+    cwd?: string;
+    timeout?: number;
+    wait?: boolean;
+    env?: Record<string, string>;
+    /** Claude Code: `--output-format`, e.g. "json" or "stream-json". */
+    outputFormat?: "text" | "json" | "stream-json" | string;
+    output_format?: "text" | "json" | "stream-json" | string;
+    /** Claude Code: `--resume <session_id>`. */
+    resumeSessionId?: string;
+    resume_session_id?: string;
+    /** Codex: pass `--json` for JSONL event output. */
+    json?: boolean;
+    /** Codex: path to a JSON Schema file inside the runtime. */
+    outputSchema?: string;
+    output_schema?: string;
+    /** Codex: path to an image file inside the runtime. */
+    image?: string;
+    agentRuntimeProfileId?: string;
+    agentProfileId?: string;
+    agentRunGroupId?: string;
+    parentAgentRunId?: string;
+    orchestrationRole?: string;
+    externalWorkspaceId?: string;
+    external_workspace_id?: string;
+    externalUserId?: string;
+    external_user_id?: string;
+    externalProjectId?: string;
+    external_project_id?: string;
+    skipAgentRuntimeProfile?: boolean;
+    executionPacket?: AgentRunExecutionPacket;
+    outputContract?: AgentRunOutputContract;
+    approvalPolicy?: AgentRunApprovalPolicy;
+    capabilityRequirements?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface AgentRunListParams {
+    targetKind?: AgentRunTargetKind;
+    targetId?: string;
+    sandboxId?: string;
+    computerId?: string;
+    agentRunGroupId?: string;
+    externalWorkspaceId?: string;
+    external_workspace_id?: string;
+    externalUserId?: string;
+    external_user_id?: string;
+    externalProjectId?: string;
+    external_project_id?: string;
+    status?: AgentRunStatus | string;
+}
+interface AgentRunWaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    terminalStatuses?: string[];
+}
+declare class AgentRuns {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: AgentRunListParams): Promise<AgentRun[]>;
+    get(id: string): Promise<AgentRun>;
+    artifacts(id: string): Promise<AgentRunArtifact[]>;
+    downloadArtifact(id: string, artifactId: string, options?: {
+        inline?: boolean;
+    }): Promise<Uint8Array>;
+    events(id: string): Promise<AgentRunEvent[]>;
+    streamEvents(id: string): AsyncIterableIterator<AgentRunEvent>;
+    waitForCompletion(id: string, options?: AgentRunWaitOptions): Promise<AgentRun>;
+    run(params: AgentRunCreateParams): Promise<AgentRun>;
+    cancel(id: string): Promise<AgentRun>;
+}
+
+type AgentRunGroupStatus = "running" | "succeeded" | "failed" | "canceled";
+interface AgentRunGroupCounts {
+    total: number;
+    running: number;
+    succeeded: number;
+    failed: number;
+    canceled: number;
+}
+interface AgentRunGroupEntryCounts extends AgentRunGroupCounts {
+    queued: number;
+}
+type AgentRunGroupEntryStatus = "queued" | "running" | "succeeded" | "failed" | "canceled";
+interface AgentRunGroupEntry {
+    id: string;
+    agent_run_group_id: string;
+    agent_run_id?: string;
+    index: number;
+    status: AgentRunGroupEntryStatus;
+    attempts?: number;
+    error?: Record<string, unknown>;
+    queued_at?: string;
+    claimed_at?: string;
+    finished_at?: string;
+    updated_at?: string;
+}
+interface AgentRunGroup {
+    id: string;
+    tenant_id?: string;
+    user_id?: string;
+    workspace_id?: string;
+    project_id?: string;
+    name: string;
+    description?: string;
+    status: AgentRunGroupStatus;
+    concurrency_limit?: number;
+    expected_runs?: number;
+    counts?: AgentRunGroupCounts;
+    entry_counts?: AgentRunGroupEntryCounts;
+    metadata?: Record<string, unknown>;
+    started_at?: string;
+    finished_at?: string;
+    created_at?: string;
+    updated_at?: string;
+    runs?: AgentRun[];
+    [key: string]: unknown;
+}
+interface AgentRunGroupCreateParams {
+    name: string;
+    description?: string;
+    workspaceId?: string;
+    projectId?: string;
+    concurrencyLimit?: number;
+    expectedRuns?: number;
+    metadata?: Record<string, unknown>;
+}
+interface AgentRunGroupListParams {
+    workspaceId?: string;
+    projectId?: string;
+    status?: AgentRunGroupStatus | string;
+    limit?: number;
+}
+type AgentRunGroupDispatchEntry = AgentRunCreateParams & {
+    targetId?: string;
+    sandboxId?: string;
+    computerId?: string;
+};
+interface AgentRunGroupDispatchResult {
+    group: AgentRunGroup;
+    results?: Array<{
+        index: number;
+        ok: true;
+        run: AgentRun;
+    } | {
+        index: number;
+        ok: false;
+        error: Record<string, unknown>;
+    }>;
+    entries?: AgentRunGroupEntry[];
+}
+interface AgentRunGroupDispatchOptions {
+    async?: boolean;
+}
+interface AgentRunGroupWaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    terminalStatuses?: string[];
+    includeRuns?: boolean;
+}
+interface AgentRunGroupEvent {
+    id: string;
+    agent_run_group_id?: string;
+    agent_run_id?: string;
+    sequence?: number;
+    type: string;
+    message?: string | null;
+    payload?: Record<string, unknown>;
+    created_at?: string | null;
+    [key: string]: unknown;
+}
+type AgentRunGroupArtifact = AgentRunArtifact & {
+    agent_run_id: string;
+};
+declare class AgentRunGroups {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: AgentRunGroupListParams): Promise<AgentRunGroup[]>;
+    create(params: AgentRunGroupCreateParams): Promise<AgentRunGroup>;
+    get(id: string, options?: {
+        includeRuns?: boolean;
+    }): Promise<AgentRunGroup>;
+    dispatch(id: string, runs: AgentRunGroupDispatchEntry[], options?: AgentRunGroupDispatchOptions): Promise<AgentRunGroupDispatchResult>;
+    cancel(id: string): Promise<AgentRunGroup>;
+    events(id: string): Promise<AgentRunGroupEvent[]>;
+    streamEvents(id: string): AsyncIterableIterator<AgentRunGroupEvent>;
+    artifacts(id: string): Promise<AgentRunGroupArtifact[]>;
+    waitForCompletion(id: string, options?: AgentRunGroupWaitOptions): Promise<AgentRunGroup>;
+}
+
 type RunTargetKind = "sandbox" | "computer";
 type RunStatus = "running" | "succeeded" | "failed" | "canceled";
 interface Run {
@@ -1677,7 +1952,11 @@ interface CreditUsage {
 }
 
 interface MiosaClientConfig {
-    apiKey: string;
+    apiKey?: string;
+    /** User JWT required for organization switching. */
+    accessToken?: string;
+    /** Organization UUID or slug sent as X-MIOSA-Tenant on every request. */
+    tenant?: string;
     baseUrl?: string;
     timeout?: number;
     maxRetries?: number;
@@ -2419,12 +2698,24 @@ declare class Desktop$1 {
     screenshot(): Promise<Uint8Array>;
     /** Click at the given coordinates. */
     click(x: number, y: number, button?: ClickParams["button"]): Promise<DesktopActionResult>;
+    /** Explicit left-button click. Alias for click(x, y, "left"). */
+    leftClick(x: number, y: number): Promise<DesktopActionResult>;
+    /** Right-button click. Alias for click(x, y, "right"). */
+    rightClick(x: number, y: number): Promise<DesktopActionResult>;
+    /** Middle-button click. Alias for click(x, y, "middle"). */
+    middleClick(x: number, y: number): Promise<DesktopActionResult>;
     /** Double-click at the given coordinates. */
     doubleClick(x: number, y: number): Promise<DesktopActionResult>;
+    /** Move the mouse pointer without clicking. */
+    moveMouse(x: number, y: number): Promise<DesktopActionResult>;
     /** Type text into the currently focused element. */
     type(text: string, delay?: number): Promise<DesktopActionResult>;
+    /** Alias for `type(text)` used by simple computer-control loops. */
+    write(text: string, delay?: number): Promise<DesktopActionResult>;
     /** Send a key or key combination (e.g. "Enter", "ctrl+c"). */
     key(key: string): Promise<DesktopActionResult>;
+    /** Alias for `key(key)` used by simple computer-control loops. */
+    press(key: string): Promise<DesktopActionResult>;
     /** Scroll in a direction at an optional position. */
     scroll(direction: ScrollParams["direction"], clicks?: number, x?: number, y?: number): Promise<DesktopActionResult>;
     /** Click and drag from one coordinate to another. */
@@ -3204,6 +3495,7 @@ declare class ComputerInbox {
     update(fields: Record<string, unknown>): Promise<Record<string, unknown>>;
 }
 type ComputerRunOptions = Omit<RunCreateParams, "instruction" | "targetKind" | "targetId" | "sandboxId" | "computerId">;
+type ComputerPromptOptions = Omit<AgentRunCreateParams, "prompt" | "targetKind" | "targetId" | "sandboxId" | "computerId">;
 /**
  * A Computer instance bound to a specific computer ID.
  *
@@ -3295,6 +3587,10 @@ declare class Computer {
      * same Runs API as `miosa agent run --computer`, scoped to this VM.
      */
     run(instruction: string, options?: ComputerRunOptions): Promise<Run>;
+    /**
+     * Dispatch a prompt into this Computer through the Agent Runs API.
+     */
+    prompt(prompt: string, options?: ComputerPromptOptions): Promise<AgentRun>;
     /**
      * Capture a desktop screenshot as PNG bytes.
      * Shortcut for `computer.desktop.screenshot()`.
@@ -3316,16 +3612,24 @@ declare class Computer {
     rightClick(x: number, y: number): Promise<void>;
     /** Double-click at the given coordinates. */
     doubleClick(x: number, y: number): Promise<void>;
+    /** Middle-button click. */
+    middleClick(x: number, y: number): Promise<void>;
+    /** Move the pointer without clicking. */
+    moveMouse(x: number, y: number): Promise<void>;
     /**
      * Type text into the focused element.
      * Shortcut for `computer.desktop.type(text)`.
      */
     type(text: string): Promise<void>;
+    /** Alias for `type(text)`. */
+    write(text: string): Promise<void>;
     /**
      * Send a key or key combo.
      * Shortcut for `computer.desktop.key(key)`.
      */
     key(key: string): Promise<void>;
+    /** Alias for `key(key)`. */
+    press(key: string): Promise<void>;
     /**
      * Scroll in a direction.
      * Shortcut for `computer.desktop.scroll(direction, clicks)`.
@@ -3393,6 +3697,13 @@ declare class Computer {
     urls(): Promise<Record<string, unknown>>;
     /** Mint a short-lived stream token for this computer. */
     streamToken(): Promise<Record<string, unknown>>;
+    /**
+     * Mint a passwordless browser embed URL for authenticated platform sessions.
+     *
+     * Use this inside MIOSA or tenant apps. Raw shared desktop URLs can still use
+     * the viewer password flow when opened outside an authenticated platform.
+     */
+    embed(): Promise<Record<string, unknown>>;
     /** Clone this computer into a new one. */
     clone(opts?: Record<string, unknown>): Promise<Computer>;
     /** Resize the computer (change CPU/memory/disk). */
@@ -3586,6 +3897,7 @@ type DatabaseId = string & {
 interface DatabaseData {
     id: DatabaseId;
     tenant_id: string;
+    environment_id?: string | null;
     name: string;
     state?: string;
     engine?: string;
@@ -3637,6 +3949,9 @@ interface DatabaseCreateParams {
     /** @deprecated use cpu_count/memory_mb/storage_mb. */
     size?: string;
     region?: string;
+    workspace_id?: string;
+    project_id?: string;
+    environment_id?: string;
     idempotencyKey?: string;
     idempotency_key?: string;
     [key: string]: unknown;
@@ -3790,6 +4105,8 @@ interface DeploymentData {
     id: DeploymentId;
     tenant_id: string;
     owner_id?: string;
+    workspace_id?: string | null;
+    project_id?: string | null;
     name: string;
     slug: string;
     /**
@@ -3804,6 +4121,8 @@ interface DeploymentData {
     runtime_image?: string | null;
     current_build_id?: string | null;
     active_version_id?: string | null;
+    active_release_id?: string | null;
+    running_artifact_sha256?: string | null;
     source_type?: DeploymentSourceType;
     state: DeploymentState;
     auto_deploy?: boolean;
@@ -3813,7 +4132,10 @@ interface DeploymentData {
     docker_deploy_host_id?: string | null;
     docker_deploy_app?: {
         id?: string | null;
+        deployment_id?: string | null;
+        deployment_version_id?: string | null;
         docker_deploy_host_id?: string | null;
+        name?: string | null;
         app_id?: string | null;
         container_id?: string | null;
         status?: string | null;
@@ -3821,12 +4143,18 @@ interface DeploymentData {
         runtime_port?: number | string | null;
         public_url?: string | null;
         last_health_status?: string | null;
+        last_error?: string | null;
+        last_seen_at?: string | null;
+        deployed_at?: string | null;
+        stopped_at?: string | null;
     } | null;
     metadata?: Record<string, unknown>;
     external_workspace_id?: string | null;
     external_user_id?: string | null;
     external_project_id?: string | null;
     public_url?: string | null;
+    /** Backend-computed default hostname. Prefer public_url as the canonical URL. */
+    auto_subdomain?: string | null;
     created_at?: string;
     updated_at?: string;
 }
@@ -3840,6 +4168,8 @@ interface DeploymentVersionData {
     id: DeploymentVersionId;
     deployment_id: DeploymentId;
     tenant_id: string;
+    workspace_id?: string | null;
+    project_id?: string | null;
     created_by?: string | null;
     source_sandbox_id?: string | null;
     build_id?: string | null;
@@ -3863,6 +4193,16 @@ interface DeploymentVersionData {
     created_at?: string;
     updated_at?: string;
 }
+interface MigrationBackupData {
+    id: string;
+    database_id: string;
+    state: string;
+    backup_type?: string;
+    size_bytes?: number | null;
+    started_at?: string | null;
+    completed_at?: string | null;
+    created_at?: string | null;
+}
 interface DeploymentReleaseData {
     id: DeploymentReleaseId;
     deployment_id?: DeploymentId;
@@ -3870,6 +4210,8 @@ interface DeploymentReleaseData {
     deployment_version_id: DeploymentVersionId;
     service_id?: DeploymentServiceId | null;
     tenant_id: string;
+    workspace_id?: string | null;
+    project_id?: string | null;
     external_workspace_id?: string | null;
     external_user_id?: string | null;
     external_project_id?: string | null;
@@ -4132,6 +4474,10 @@ declare class DeploymentVersions {
         environment?: string;
         idempotencyKey?: string;
     }): Promise<DeploymentData>;
+    prepareMigrationBackup(versionId: string): Promise<{
+        backup: MigrationBackupData;
+        version: DeploymentVersionData;
+    }>;
 }
 declare class DeploymentReleases {
     private readonly http;
@@ -4139,6 +4485,7 @@ declare class DeploymentReleases {
     constructor(http: HttpClient, deploymentId: string);
     list(): Promise<DeploymentReleaseData[]>;
     get(releaseId: string): Promise<DeploymentReleaseData>;
+    promote(releaseId: string, idempotencyKey?: string): Promise<DeploymentData>;
 }
 declare class DeploymentRuntimeInstances {
     private readonly http;
@@ -5770,11 +6117,20 @@ interface TemplateData {
     slug?: string;
     [key: string]: unknown;
 }
+interface ComputeCatalogData {
+    products?: Array<Record<string, unknown>>;
+    regions?: Array<Record<string, unknown>>;
+    sizes?: Array<Record<string, unknown>>;
+    templates?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}
 declare class Regions {
     private readonly http;
     constructor(http: HttpClient);
     /** List datacenter regions. */
     listRegions(): Promise<RegionData[]>;
+    /** Get canonical compute catalog, including product templates and readiness. */
+    catalog(): Promise<ComputeCatalogData>;
     /** List available compute sizes. */
     listSizes(): Promise<SizeData[]>;
     /** Get static compute pricing data. */
@@ -5846,6 +6202,7 @@ declare class RuntimeCapabilitiesResource {
 }
 
 declare const SANDBOX_TEMPLATE = "miosa-sandbox";
+type SandboxSize = "xs" | "small" | "medium" | "large" | "xl";
 type SandboxId = string & {
     readonly __brand: "SandboxId";
 };
@@ -5854,6 +6211,7 @@ interface SandboxCreateParams {
     templateId?: string;
     template_id?: string;
     image?: string;
+    size?: SandboxSize;
     cpuCount?: number;
     cpu_count?: number;
     memoryMb?: number;
@@ -5890,6 +6248,13 @@ interface SandboxCreateParams {
     };
     alwaysOn?: boolean;
     always_on?: boolean;
+    /**
+     * Opt in to the in-sandbox L3 token carrying the `provision` scope, so code
+     * running inside the sandbox can call database/deployment create. Defaults
+     * to false on the server when omitted.
+     */
+    allowProvision?: boolean;
+    allow_provision?: boolean;
     env?: Record<string, string>;
     metadata?: Record<string, unknown>;
     services?: Array<Record<string, unknown>>;
@@ -6001,6 +6366,8 @@ interface SandboxExecRunner {
 interface SandboxData {
     id: SandboxId;
     state: SandboxState;
+    slug?: string;
+    name?: string | null;
     ready?: boolean;
     template_id?: string;
     image_id?: string | null;
@@ -6009,6 +6376,9 @@ interface SandboxData {
     disk_mb?: number | null;
     disk_size_mb?: number | null;
     timeout_sec?: number | null;
+    timeout_remaining_ms?: number | null;
+    idle_timeout_sec?: number;
+    always_on?: boolean;
     persistent?: boolean;
     boot_path?: string | null;
     boot_ms?: number | null;
@@ -6024,6 +6394,38 @@ interface SandboxData {
     started_at?: string | null;
     destroyed_at?: string | null;
     total_runtime_sec?: number | null;
+    external_workspace_id?: string | null;
+    external_user_id?: string | null;
+    external_project_id?: string | null;
+}
+interface SandboxUsage {
+    sandbox_id: string;
+    state: string;
+    runtime_sec: number;
+    provisioned_vcpu_ms: number;
+    active_cpu_ms: number | null;
+    network_ingress_bytes: number | null;
+    network_egress_bytes: number | null;
+    measurement_status: {
+        active_cpu: string;
+        network: string;
+        provisioned_resources: "measured";
+    };
+    estimated_cost_cents: number;
+    timeout_sec: number;
+    timeout_remaining_ms: number | null;
+}
+interface SandboxForkParams {
+    timeoutSec?: number;
+    timeout_sec?: number;
+    templateId?: string;
+    template_id?: string;
+    idempotencyKey?: string;
+    idempotency_key?: string;
+}
+interface SandboxLegacyForkParams extends SandboxForkParams {
+    name?: string;
+    metadata?: Record<string, unknown>;
 }
 type PreviewUrlClass = "temporary_preview" | "always_on_preview" | "stable_sandbox_embed" | "durable_deployment" | (string & {});
 type PreviewUrlAction = "create_alias_or_publish" | "publish_when_ready" | "attach_custom_domain" | (string & {});
@@ -6214,6 +6616,7 @@ interface SandboxDeployParams {
     idempotency_key?: string;
 }
 type SandboxRunOptions = Omit<RunCreateParams, "instruction" | "targetKind" | "targetId" | "sandboxId" | "computerId">;
+type SandboxPromptOptions = Omit<AgentRunCreateParams, "prompt" | "targetKind" | "targetId" | "sandboxId" | "computerId">;
 declare class SandboxCommands {
     private readonly sandbox;
     constructor(sandbox: Sandbox);
@@ -6280,6 +6683,11 @@ declare class SandboxEvents {
     /** Stream live sandbox events via SSE. */
     stream(): AsyncIterableIterator<Record<string, unknown>>;
 }
+declare class SandboxMetrics {
+    private readonly sandbox;
+    constructor(sandbox: Sandbox);
+    get(window?: string): Promise<Record<string, unknown>>;
+}
 declare class SandboxPreviews {
     private readonly sandbox;
     constructor(sandbox: Sandbox);
@@ -6333,6 +6741,8 @@ declare class Sandbox {
     readonly terminal: SandboxTerminal;
     /** SSE event stream. */
     readonly events: SandboxEvents;
+    /** Operational metrics and current resource state. */
+    readonly metricsResource: SandboxMetrics;
     /** Preview CRUD + share/revokeShare. */
     readonly previews: SandboxPreviews;
     /** Read-only env var listing. */
@@ -6360,6 +6770,10 @@ declare class Sandbox {
      * Pass `{ runner: "codex", env: { CODEX_API_KEY } }` to run Codex.
      */
     run(instruction: string, options?: SandboxRunOptions): Promise<Run>;
+    /**
+     * Dispatch a prompt into this Sandbox through the Agent Runs API.
+     */
+    prompt(prompt: string, options?: SandboxPromptOptions): Promise<AgentRun>;
     private runExec;
     private execStream;
     writeFile(path: string, content: string | Uint8Array): Promise<void>;
@@ -6372,11 +6786,15 @@ declare class Sandbox {
     listFiles(path?: string): Promise<SandboxFileList>;
     statFile(path: string): Promise<SandboxFileStat>;
     expose(port?: number): Promise<string>;
+    getUrl(port?: number, path?: string): Promise<string>;
+    getHost(port?: number): Promise<string>;
     exposeInfo(port?: number): Promise<PreviewUrlInfo>;
     startTemplate(options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     getArtifacts(): Promise<Record<string, unknown>>;
     getLogs(lines?: number): Promise<string | Record<string, unknown>>;
     streamLogs(): AsyncIterableIterator<Record<string, unknown>>;
+    metrics(window?: string): Promise<Record<string, unknown>>;
+    getMetrics(window?: string): Promise<Record<string, unknown>>;
     createSnapshot(comment?: string): Promise<SandboxSnapshot>;
     listSnapshots(): Promise<SandboxSnapshot[]>;
     restoreSnapshot(snapshotId: string): Promise<Sandbox>;
@@ -6385,10 +6803,11 @@ declare class Sandbox {
      * Fork (clone) this sandbox into a new sandbox via copy-on-write snapshot.
      * The original sandbox continues running unchanged.
      */
-    fork(opts?: {
-        name?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<Sandbox>;
+    fork(opts?: SandboxForkParams): Promise<Sandbox>;
+    /** @deprecated Use forkLegacy() for private name/metadata fork fields. */
+    fork(opts: SandboxLegacyForkParams): Promise<Sandbox>;
+    /** Fork using private compatibility fields excluded from the public V1 contract. */
+    forkLegacy(opts?: SandboxLegacyForkParams): Promise<Sandbox>;
     /**
      * PATCH /api/v1/sandboxes/{id} — update mutable sandbox fields.
      */
@@ -6419,7 +6838,8 @@ declare class Sandbox {
             delete_evicted?: boolean;
         };
     }): Promise<Sandbox>;
-    extend(timeoutSec: number): Promise<Sandbox>;
+    extend(timeoutSec?: number): Promise<Sandbox>;
+    usage(): Promise<SandboxUsage>;
     /**
      * POST /api/v1/sandboxes/{id}/preview-token → {token, url, expires_at, scope}
      */
@@ -6431,7 +6851,7 @@ declare class Sandbox {
         [key: string]: unknown;
     }>;
     pause(): Promise<Sandbox>;
-    resume(): Promise<Sandbox>;
+    resume(idempotencyKey?: string): Promise<Sandbox>;
     deploy(params?: SandboxDeployParams): Promise<Record<string, unknown>>;
     deployDocker(params?: SandboxDeployParams): Promise<Record<string, unknown>>;
     /** Check readiness of the sandbox (GET /sandboxes/:id/readiness). */
@@ -6483,6 +6903,14 @@ declare class Sandboxes {
     create(params?: SandboxCreateParams): Promise<Sandbox>;
     list(params?: SandboxListParams): Promise<Sandbox[]>;
     get(id: SandboxId | string): Promise<Sandbox>;
+    extend(id: SandboxId | string, timeoutSec?: number): Promise<Sandbox>;
+    usage(id: SandboxId | string): Promise<SandboxUsage>;
+    pause(id: SandboxId | string): Promise<Sandbox>;
+    resume(id: SandboxId | string, idempotencyKey?: string): Promise<Sandbox>;
+    fork(id: SandboxId | string, params?: SandboxForkParams): Promise<Sandbox>;
+    /** @deprecated Use forkLegacy() for private name/metadata fork fields. */
+    fork(id: SandboxId | string, params: SandboxLegacyForkParams): Promise<Sandbox>;
+    forkLegacy(id: SandboxId | string, params?: SandboxLegacyForkParams): Promise<Sandbox>;
     connect(id: SandboxId | string): Promise<Sandbox>;
     getByName(name: string): Promise<Sandbox>;
     /**
@@ -6835,6 +7263,67 @@ declare class OrgInvites {
     accept(token: string): Promise<AcceptOrgInviteResponse>;
 }
 
+type OrganizationRole = "owner" | "admin" | "member";
+interface OrganizationSummary {
+    id: string;
+    name: string;
+    slug: string;
+    role?: OrganizationRole;
+    owner_user_id?: string | null;
+    plan_id?: string | null;
+    plan?: Record<string, unknown> | null;
+    plan_name?: string | null;
+    credit_balance?: number;
+    settings?: Record<string, unknown>;
+    branding?: Record<string, unknown> | null;
+    inserted_at?: string;
+    updated_at?: string;
+}
+interface OrganizationMember {
+    id: string;
+    tenant_id: string;
+    user_id: string;
+    role: OrganizationRole;
+    status: "invited" | "active" | string;
+    invited_at?: string | null;
+    joined_at?: string | null;
+    created_at?: string;
+    user_name?: string | null;
+    user_email?: string | null;
+    user_avatar_url?: string | null;
+}
+interface OrganizationSwitchResult {
+    tenant: OrganizationSummary;
+    token: string;
+    refresh_token: string;
+}
+interface OrganizationMemberList {
+    members: OrganizationMember[];
+    total: number;
+}
+interface OrganizationMemberRemoved {
+    tenant_id: string;
+    user_id: string;
+    removed: boolean;
+}
+declare class OrganizationMembers {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(organizationId: string): Promise<OrganizationMemberList>;
+    add(organizationId: string, userId: string, role?: OrganizationRole): Promise<OrganizationMember>;
+    remove(organizationId: string, userId: string): Promise<OrganizationMemberRemoved>;
+}
+declare class Organizations {
+    private readonly http;
+    readonly members: OrganizationMembers;
+    readonly invites: OrgInvites;
+    constructor(http: HttpClient);
+    list(): Promise<OrganizationSummary[]>;
+    current(): Promise<OrganizationSummary>;
+    /** Requires a user JWT. API keys are pinned to their organization. */
+    switch(idOrSlug: string): Promise<OrganizationSwitchResult>;
+}
+
 /**
  * Tenant — current tenant info and plan/usage.
  */
@@ -6981,6 +7470,7 @@ interface TemplatesListParams {
     product?: ComputeProduct | string;
 }
 interface ProductTemplateCatalog {
+    data?: ProductTemplate[];
     templates: ProductTemplate[];
     products?: ProductCatalogEntry[];
     sizes?: Array<Record<string, unknown>>;
@@ -7074,6 +7564,26 @@ interface VolumeCreateParams {
     idempotencyKey?: string;
     [key: string]: unknown;
 }
+interface VolumeAttachmentData {
+    id: string;
+    volume_id: string;
+    computer_id: string;
+    mount_path: string;
+    read_only?: boolean;
+    state?: string;
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+interface VolumeAttachParams {
+    volumeId?: string;
+    volume_id?: string;
+    mountPath?: string;
+    mount_path?: string;
+    readOnly?: boolean;
+    read_only?: boolean;
+    [key: string]: unknown;
+}
 declare class Volumes {
     private readonly http;
     constructor(http: HttpClient);
@@ -7081,6 +7591,9 @@ declare class Volumes {
     get(volumeId: string): Promise<VolumeData>;
     create(params: VolumeCreateParams): Promise<VolumeData>;
     delete(volumeId: string): Promise<void>;
+    listAttachments(computerId: string): Promise<VolumeAttachmentData[]>;
+    attach(computerId: string, params: VolumeAttachParams): Promise<VolumeAttachmentData>;
+    detach(computerId: string, attachmentId: string): Promise<void>;
 }
 
 /**
@@ -7399,6 +7912,8 @@ declare class Miosa {
      * Requires admin/owner role for write operations.
      */
     readonly orgInvites: OrgInvites;
+    /** Organizations available to the user session, membership, invites, and switching. */
+    readonly organizations: Organizations;
     /** Current tenant plan, limits, and live usage counters. */
     readonly tenant: Tenant;
     /** Datacenter regions, compute sizes, pricing, community templates. */
@@ -7431,6 +7946,10 @@ declare class Miosa {
     readonly runs: Runs;
     /** Run groups - durable multi-run orchestration groups. */
     readonly runGroups: RunGroups;
+    /** Agent runs - compatibility API for prompt dispatch. */
+    readonly agentRuns: AgentRuns;
+    /** Agent run groups - compatibility API for multi-agent orchestration. */
+    readonly agentRunGroups: AgentRunGroups;
     /** Agent runtime profiles — tenant/workspace defaults for sandbox/computer agents. */
     readonly agentRuntimeProfiles: AgentRuntimeProfiles;
     /** MIOSA Connect — provider connectors and runtime tokens. */
@@ -7729,13 +8248,17 @@ declare class AppAuth {
 }
 
 interface MiosaErrorBody {
-    error?: {
+    error?: string | {
         code?: string;
         message?: string;
         details?: unknown;
     };
     message?: string;
     code?: string;
+    detail?: string;
+    details?: unknown;
+    reason?: string;
+    request_id?: string;
 }
 declare class MiosaError extends Error {
     readonly status: number;
@@ -7793,4 +8316,4 @@ declare class TokenRefreshFailedError extends MiosaError {
     constructor(message: string, status?: number, details?: unknown, requestId?: string);
 }
 
-export { AGENT_BUILD_KIND_SPECS, type AcceptOrgInviteResponse, type AcceptWorkspaceInviteResponse, type AddDomainParams, type AddWorkspaceMemberParams, Admin, type AgentBuildExecutionPacket, type AgentBuildFileSpec, type AgentBuildKind, type AgentBuildKindSpec, type AgentBuildPlannerDocument, type AgentDispatchParams, type AgentEvent$1 as AgentEvent, type AgentEventType, AgentRuntimeProfiles, type AgentSessionCreateParams, type AgentSessionData, type AgentSessionListResponse$1 as AgentSessionListResponse, type AgentSessionStatus$1 as AgentSessionStatus, type AllowParams, Analytics, type AnalyticsFilters, type ApiKeyCreateParams, type ApiKeyCreateResult, type ApiKeyData, type ApiKeyId, type ApiKeyListParams, ApiKeys, AppAuth, type AppAuthConfig, type AppAuthResourceType, type AppAuthSession, type AppAuthTokenPayload, type AppCatalogEntry, type AppInstallData, type AppInstallEvent, type AttachAwsRoleParams, type AuditListParams, AuditLog, type AuditLogEvent, type AuditLogListParams, type AuditTailParams, AuthError, type AuthToken, type BenchmarkCompareParams, type BenchmarkCreateParams, Benchmarks, type BindingCreateParams, type BindingListParams, type BrandingData, type BrandingUpdateParams, type BucketCreateParams, type BucketData, type BucketId, type BuilderSessionListParams, BuilderSessions, type BulkUserActionParams, type ChannelCreateParams, type ChannelData, type ChannelListParams, type ChannelUpdateParams, Channels, type ChatCompletionCreateParams, type ChatCompletionCreateStreamParams, Checkpoints, type ClickParams, Cloud, type CloudAccount, type CloudAccountCreateParams, type CloudAccountMode, type CloudAccountStatus, type CloudCredentialType, type CloudListParams, type CloudPlacementScope, type CloudPool, type CloudPoolCreateParams, type CloudPoolKind, type CloudPreflightRecordParams, type CloudPreflightRun, type CloudPreflightStatus, type CloudProvider, type CloudRegion, type CloudRegionCreateParams, type ClusterCreateParams, type ClusterData, type ClusterEvent, type ClusterId, type ClusterListResponse, type ClusterStatus, CommandCenter, Community, type CompletionCreateParams, type CompletionCreateStreamParams, Completions, type ComputeProduct, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, type ComputerCreateParams, type ComputerData, ComputerEnv, type ComputerId, ComputerInbox, type ComputerListParams, type ComputerListResponse, ComputerLogs, type ComputerLogsGetParams, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, type ComputerSize, type ComputerStatus, type ComputerTemplateType, ComputerTerminal, type ComputerUpdateParams, type ComputerVisibility, ComputerVolumes, Computers, type ConnectorApplicableDefaultParams, type ConnectorCreateParams, type ConnectorData, type ConnectorDefault, type ConnectorDefaultListParams, type ConnectorDefaultParams, type ConnectorListParams, type ConnectorSubject, type ConnectorTokenParams, type ConnectorTokenResponse, Connectors, type CopyParams, type CreateAdminApiKeyParams, type CreateAgentBuildPacketParams, type CreateBuildRunParams, type CreateOrgInviteParams, type CreateWorkspaceInviteParams, type CreateWorkspaceInviteResponse, type CreditBalance, type CreditTransaction, type CreditTransactionListResponse, type CreditUsage, Credits, type CronJobCreateParams, type CronJobData, type CronJobExecutionData, type CronJobExecutionId, type CronJobId, type CronJobListParams, type CronJobUpdateParams, CronJobs, type CursorInfo, type CustomDomainCreateParams, type CustomDomainData, type CustomDomainId, type CustomDomainListParams, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, type DashboardSummary, type DatabaseCreateParams, type DatabaseCredentials, type DatabaseData, type DatabaseId, type DatabaseListParams, type DatabaseLogsParams, type DatabaseLogsResult, Databases, type DeploymentBuildData, DeploymentConnectors, type DeploymentCreateParams, type DeploymentData, DeploymentDomains, type DeploymentId, type DeploymentListParams, type DeploymentProduct, type DeploymentProofCheck, type DeploymentProofParams, type DeploymentProofProbe, type DeploymentProofResult, type DeploymentReleaseData, type DeploymentReleaseId, DeploymentReleases, DeploymentRuntimeInstances, type DeploymentServiceData, type DeploymentServiceId, type DeploymentServiceType, type DeploymentSourceType, type DeploymentState, type DeploymentUpdateParams, type DeploymentVersionData, type DeploymentVersionId, type DeploymentVersionKind, type DeploymentVersionState, DeploymentVersions, Deployments, Desktop$1 as Desktop, type DesktopActionResult, type DeviceBootstrapParams, type DeviceBootstrapResult, type DeviceBrowserResult, type DeviceCapabilities, type DeviceData, type DeviceExecParams, type DeviceExecResult, type DeviceExposeParams, type DeviceExposeResult, type DeviceExtendParams, type DeviceFileEntry, type DeviceFileListParams, type DeviceKind, type DeviceLifecycleResult, type DeviceListParams, type DeviceReadFileParams, type DeviceReadFileResult, type DeviceWriteFileParams, type DeviceWriteFileResult, Devices, type DirEntry, type DirListResult, type DiscordSendTestParams, DockerDeploy, type DockerDeployApplianceStatus, type DockerDeployCreateParams, type DockerDeployDoctorCheck, type DockerDeployDoctorParams, type DockerDeployDoctorProbe, type DockerDeployDoctorResult, type DockerDeployHostData, type DockerDeployHostEnsureParams, type DockerDeployHostId, type DockerDeployHostListParams, type DockerDeployHostListResponse, type DockerDeployHostResponse, type DockerDeployHostStatus, type DoubleClickParams, type DragParams, type EgressAllowlistRule, EgressAudit, type EgressAuditEvent, type EgressBindingData, EgressHostNotAllowedError, EgressNetwork, type EgressPolicyData, type EgressPolicyMode, type EgressRuleEffect, type EgressSecretData, type EgressSecretScope, type EgressSecretType, EgressSecrets, type EgressSuggestion, Email, EmailCampaigns, EmailInbox, EmailTemplates, type EmbeddingCreateParams, Embeddings, Exec, type ExecParams, type ExecPythonParams, type ExecResult, type ExternalAttribution, type ExternalKeyCreateParams, type ExternalKeyData, ExternalKeys, type FileDeleteParams, type FileDownloadParams, type FileEntry, type FileExportParams, type FileExportResult, type FileListParams, type FileListResult, type FileStat, Files, FlatCustomDomains, type FsEntry, type FsListResponse, type FsStat, type FunctionCreateParams, type FunctionData, type FunctionId, type FunctionInvokeParams, type FunctionListParams, type FunctionUpdateParams, Functions, type GithubRepo, type GithubSshKey, type HealthCheckCreateParams, type HealthCheckData, type HealthCheckId, type HealthCheckListParams, type HealthCheckUpdateParams, HealthChecks, type HostCreateParams, type HostData, type HostEvent, type HostId, type HostListResponse, type HostStatus, type HostUpdateParams, InstallationRequiredError, InsufficientCreditsError, type IntegrationCatalogEntry, type IntegrationData, Integrations, type JobData, type JobEvent, type JobEventType, type JobId, type JobListResponse, type JobRunParams, type JobStatus, type KeyParams, type LaunchParams, type LinearCreateIssueParams, type ListAdminApiKeysParams, type ListAdminComputersParams, type ListAdminTenantsParams, type ListAdminUsersParams, ManagedProviderBindingOnlyError, Mcp, type McpDispatchParams, Miosa, type MiosaClientConfig, MiosaError, type MiosaErrorBody, type MkdirParams, type ModeParams, Models, type MouseButton, NetworkError, NetworkPolicy, type NetworkPolicyData, type NetworkPolicyEffect, type NetworkPolicyProtocol, type NetworkPolicyRule, type NetworkPolicySetParams, NotFoundError, type NotificationPrefsUpdateParams, OAuthFlow, type OauthConnectParams, type OauthProvider, type OauthStartResult, type OauthStatusResult, type ObjectListParams, type AgentEvent as OcAgentEvent, type OcAgentSessionData, type AgentSessionListResponse as OcAgentSessionListResponse, type OcWorkspaceCreateParams, type OcWorkspaceData, type OcWorkspaceEvent, type OcWorkspaceListResponse, type OcWorkspaceStatus, type OcWorkspaceUpdateParams, OpenComputers, type OrgInvite, type OrgInviteCreated, type OrgInviteCreatedResponse, type OrgInviteListResponse, type OrgInvitePreview, type OrgInviteRevokeResponse, OrgInvites, type OrgRole, type OverviewData, type PolicyCreateParams, type PolicyListParams, type PolicyUpdateParams, type PresignParams, type PresignResult, type PreviewDomainData, type ProductCatalogEntry, type ProductTemplate, type ProductTemplateCatalog, ProjectAuth, type ProjectAuthEnableParams, type ProjectAuthStatus, type ProjectAuthUpdateParams, type ProjectIntegrationCatalogEntry, type ProjectIntegrationCreateParams, type ProjectIntegrationData, type ProjectIntegrationListParams, type ProjectIntegrationUpdateParams, ProjectIntegrations, ProjectNotLinkedError, ProviderDefaults, type ProviderKeyUpsertParams, type PublishFromSandboxParams, type PublishParams, type PublishResult, RateLimitError, type RegionData, Regions, type RollbackParams, type RulesListParams, type Run, type RunActivity, type RunCommandOutput, type RunCreateParams, type RunDiagnostic, type RunDownload, type RunFile, type RunGroup, type RunGroupActivity, type RunGroupCounts, type RunGroupCreateParams, type RunGroupDispatchEntry, type RunGroupDispatchResult, type RunGroupFile, type RunGroupListParams, type RunGroupStatus, type RunGroupWaitOptions, RunGroups, type RunListParams, type RunMessage, type RunOutputs, type RunPreview, type RunStatus, type RunTargetKind, type RunWaitOptions, Runs, type RuntimeCapabilities, RuntimeCapabilitiesResource, RuntimeEnv, type RuntimeEnvListParams, type RuntimeEnvScope, type RuntimeEnvSetParams, type RuntimeEnvTarget, type RuntimeEnvVar, type RuntimeInstanceData, type RuntimeInstanceId, type RuntimeInstanceState, type RuntimeLogsResult, SANDBOX_TEMPLATE, Sandbox, SandboxAudit, type SandboxBuildSpec, type SandboxBuildSpecError, type SandboxBuildSpecValidation, SandboxCommands, type SandboxConnectorAttachParams, type SandboxConnectorBinding, type SandboxConnectorPreflightParams, type SandboxConnectorPreflightResult, SandboxConnectors, type SandboxCreateParams, type SandboxData, SandboxEnv, SandboxEvents, type SandboxExecOptions, type SandboxExecResult, SandboxFiles, type SandboxGetOrCreateParams, type SandboxId, type SandboxListParams, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, type SandboxState, SandboxTags, type SandboxTemplate, type SandboxTemplateBuild, type SandboxTemplateBuildCreateParams, type SandboxTemplateBuildResourceData, type SandboxTemplateBuildResourceId, type SandboxTemplateCreateParams, type SandboxTemplateList, type SandboxTemplateListParams, type SandboxTemplateResourceData, type SandboxTemplateResourceId, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, type ScrollDirection, type ScrollParams, type SecretCreateParams, type SecretData, type SecretId, type SecretListParams, type SecretRotateParams, type SecretSetParams, type SecretUpdateParams, type SessionId, Settings, type SettingsUpdateParams, type SizeData, type SlackSendTestParams, type SnapshotCreateParams, type SnapshotData, type SnapshotListResponse, type SnapshotProgressEvent, type SnapshotRestoreResult, type SnapshotStatus, SnapshotsStandalone, Storage, type StorageObjectData, SubjectNotAllowedError, type SuggestionsParams, type TemplateBenchmarkLane, type TemplateBuildCreateParams, type TemplateCreateParams, type TemplateData, type TemplateReadinessContract, type TemplateReadinessState, type TemplateSizeReadiness, Templates, type TemplatesListParams, Tenant, type TenantBrandingUpdateParams, type TenantId, type TenantPlan, type TenantSummary, type TerminalCreateParams, TimeoutError, type TimeseriesParams, TokenRefreshFailedError, type TunnelAuthMode, type TunnelCreateParams, type TunnelData, type TunnelId, type TunnelListResponse, type TunnelUpdateParams, type TypeParams, type UpdateWorkspaceMemberRoleParams, Usage, type UsageReportParams, type UsageSession, type UsageSessionsParams, type UsageSummary, UserAuthorizationRequiredError, type UserId, ValidationError, type VersionListParams, type VolumeCreateParams, type VolumeData, type VolumeId, type VolumeListParams, Volumes, type WaitParams, type WebhookCreateParams, type WebhookData, type WebhookDeliveryData, type WebhookDeliveryId, type WebhookId, type WebhookListParams, type WebhookUpdateParams, Webhooks, type WindowFocusParams, type WindowInfo, type WorkspaceId, type WorkspaceInvite, type WorkspaceInviteCreatedResponse, type WorkspaceInviteListResponse, type WorkspaceInvitePreview, type WorkspaceInviteRevokeResponse, WorkspaceInvites, type WorkspaceMember, type WorkspaceMemberAddedResponse, type WorkspaceMemberDeleteResponse, type WorkspaceMemberListResponse, type WorkspaceMemberRecord, type WorkspaceMemberRecordResponse, WorkspaceMembers, type WorkspaceRole, type WsTicket, createAgentBuildExecutionPacket, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBuildRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
+export { AGENT_BUILD_KIND_SPECS, type AcceptOrgInviteResponse, type AcceptWorkspaceInviteResponse, type AddDomainParams, type AddWorkspaceMemberParams, Admin, type AgentBuildExecutionPacket, type AgentBuildFileSpec, type AgentBuildKind, type AgentBuildKindSpec, type AgentBuildPlannerDocument, type AgentDispatchParams, type AgentEvent$1 as AgentEvent, type AgentEventType, AgentRuntimeProfiles, type AgentSessionCreateParams, type AgentSessionData, type AgentSessionListResponse$1 as AgentSessionListResponse, type AgentSessionStatus$1 as AgentSessionStatus, type AllowParams, Analytics, type AnalyticsFilters, type ApiKeyCreateParams, type ApiKeyCreateResult, type ApiKeyData, type ApiKeyId, type ApiKeyListParams, ApiKeys, AppAuth, type AppAuthConfig, type AppAuthResourceType, type AppAuthSession, type AppAuthTokenPayload, type AppCatalogEntry, type AppInstallData, type AppInstallEvent, type AttachAwsRoleParams, type AuditListParams, AuditLog, type AuditLogEvent, type AuditLogListParams, type AuditTailParams, AuthError, type AuthToken, type BenchmarkCompareParams, type BenchmarkCreateParams, Benchmarks, type BindingCreateParams, type BindingListParams, type BrandingData, type BrandingUpdateParams, type BucketCreateParams, type BucketData, type BucketId, type BuilderSessionListParams, BuilderSessions, type BulkUserActionParams, type ChannelCreateParams, type ChannelData, type ChannelListParams, type ChannelUpdateParams, Channels, type ChatCompletionCreateParams, type ChatCompletionCreateStreamParams, Checkpoints, type ClickParams, Cloud, type CloudAccount, type CloudAccountCreateParams, type CloudAccountMode, type CloudAccountStatus, type CloudCredentialType, type CloudListParams, type CloudPlacementScope, type CloudPool, type CloudPoolCreateParams, type CloudPoolKind, type CloudPreflightRecordParams, type CloudPreflightRun, type CloudPreflightStatus, type CloudProvider, type CloudRegion, type CloudRegionCreateParams, type ClusterCreateParams, type ClusterData, type ClusterEvent, type ClusterId, type ClusterListResponse, type ClusterStatus, CommandCenter, Community, type CompletionCreateParams, type CompletionCreateStreamParams, Completions, type ComputeProduct, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, type ComputerCreateParams, type ComputerData, ComputerEnv, type ComputerId, ComputerInbox, type ComputerListParams, type ComputerListResponse, ComputerLogs, type ComputerLogsGetParams, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, type ComputerSize, type ComputerStatus, type ComputerTemplateType, ComputerTerminal, type ComputerUpdateParams, type ComputerVisibility, ComputerVolumes, Computers, type ConnectorApplicableDefaultParams, type ConnectorCreateParams, type ConnectorData, type ConnectorDefault, type ConnectorDefaultListParams, type ConnectorDefaultParams, type ConnectorListParams, type ConnectorSubject, type ConnectorTokenParams, type ConnectorTokenResponse, Connectors, type CopyParams, type CreateAdminApiKeyParams, type CreateAgentBuildPacketParams, type CreateBuildRunParams, type CreateOrgInviteParams, type CreateWorkspaceInviteParams, type CreateWorkspaceInviteResponse, type CreditBalance, type CreditTransaction, type CreditTransactionListResponse, type CreditUsage, Credits, type CronJobCreateParams, type CronJobData, type CronJobExecutionData, type CronJobExecutionId, type CronJobId, type CronJobListParams, type CronJobUpdateParams, CronJobs, type CursorInfo, type CustomDomainCreateParams, type CustomDomainData, type CustomDomainId, type CustomDomainListParams, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, type DashboardSummary, type DatabaseCreateParams, type DatabaseCredentials, type DatabaseData, type DatabaseId, type DatabaseListParams, type DatabaseLogsParams, type DatabaseLogsResult, Databases, type DeploymentBuildData, DeploymentConnectors, type DeploymentCreateParams, type DeploymentData, DeploymentDomains, type DeploymentId, type DeploymentListParams, type DeploymentProduct, type DeploymentProofCheck, type DeploymentProofParams, type DeploymentProofProbe, type DeploymentProofResult, type DeploymentReleaseData, type DeploymentReleaseId, DeploymentReleases, DeploymentRuntimeInstances, type DeploymentServiceData, type DeploymentServiceId, type DeploymentServiceType, type DeploymentSourceType, type DeploymentState, type DeploymentUpdateParams, type DeploymentVersionData, type DeploymentVersionId, type DeploymentVersionKind, type DeploymentVersionState, DeploymentVersions, Deployments, Desktop$1 as Desktop, type DesktopActionResult, type DeviceBootstrapParams, type DeviceBootstrapResult, type DeviceBrowserResult, type DeviceCapabilities, type DeviceData, type DeviceExecParams, type DeviceExecResult, type DeviceExposeParams, type DeviceExposeResult, type DeviceExtendParams, type DeviceFileEntry, type DeviceFileListParams, type DeviceKind, type DeviceLifecycleResult, type DeviceListParams, type DeviceReadFileParams, type DeviceReadFileResult, type DeviceWriteFileParams, type DeviceWriteFileResult, Devices, type DirEntry, type DirListResult, type DiscordSendTestParams, DockerDeploy, type DockerDeployApplianceStatus, type DockerDeployCreateParams, type DockerDeployDoctorCheck, type DockerDeployDoctorParams, type DockerDeployDoctorProbe, type DockerDeployDoctorResult, type DockerDeployHostData, type DockerDeployHostEnsureParams, type DockerDeployHostId, type DockerDeployHostListParams, type DockerDeployHostListResponse, type DockerDeployHostResponse, type DockerDeployHostStatus, type DoubleClickParams, type DragParams, type EgressAllowlistRule, EgressAudit, type EgressAuditEvent, type EgressBindingData, EgressHostNotAllowedError, EgressNetwork, type EgressPolicyData, type EgressPolicyMode, type EgressRuleEffect, type EgressSecretData, type EgressSecretScope, type EgressSecretType, EgressSecrets, type EgressSuggestion, Email, EmailCampaigns, EmailInbox, EmailTemplates, type EmbeddingCreateParams, Embeddings, Exec, type ExecParams, type ExecPythonParams, type ExecResult, type ExternalAttribution, type ExternalKeyCreateParams, type ExternalKeyData, ExternalKeys, type FileDeleteParams, type FileDownloadParams, type FileEntry, type FileExportParams, type FileExportResult, type FileListParams, type FileListResult, type FileStat, Files, FlatCustomDomains, type FsEntry, type FsListResponse, type FsStat, type FunctionCreateParams, type FunctionData, type FunctionId, type FunctionInvokeParams, type FunctionListParams, type FunctionUpdateParams, Functions, type GithubRepo, type GithubSshKey, type HealthCheckCreateParams, type HealthCheckData, type HealthCheckId, type HealthCheckListParams, type HealthCheckUpdateParams, HealthChecks, type HostCreateParams, type HostData, type HostEvent, type HostId, type HostListResponse, type HostStatus, type HostUpdateParams, InstallationRequiredError, InsufficientCreditsError, type IntegrationCatalogEntry, type IntegrationData, Integrations, type JobData, type JobEvent, type JobEventType, type JobId, type JobListResponse, type JobRunParams, type JobStatus, type KeyParams, type LaunchParams, type LinearCreateIssueParams, type ListAdminApiKeysParams, type ListAdminComputersParams, type ListAdminTenantsParams, type ListAdminUsersParams, ManagedProviderBindingOnlyError, Mcp, type McpDispatchParams, Miosa, type MiosaClientConfig, MiosaError, type MiosaErrorBody, type MkdirParams, type ModeParams, Models, type MouseButton, NetworkError, NetworkPolicy, type NetworkPolicyData, type NetworkPolicyEffect, type NetworkPolicyProtocol, type NetworkPolicyRule, type NetworkPolicySetParams, NotFoundError, type NotificationPrefsUpdateParams, OAuthFlow, type OauthConnectParams, type OauthProvider, type OauthStartResult, type OauthStatusResult, type ObjectListParams, type AgentEvent as OcAgentEvent, type OcAgentSessionData, type AgentSessionListResponse as OcAgentSessionListResponse, type OcWorkspaceCreateParams, type OcWorkspaceData, type OcWorkspaceEvent, type OcWorkspaceListResponse, type OcWorkspaceStatus, type OcWorkspaceUpdateParams, OpenComputers, type OrgInvite, type OrgInviteCreated, type OrgInviteCreatedResponse, type OrgInviteListResponse, type OrgInvitePreview, type OrgInviteRevokeResponse, OrgInvites, type OrgRole, type OrganizationMember, type OrganizationMemberList, type OrganizationMemberRemoved, OrganizationMembers, type OrganizationRole, type OrganizationSummary, type OrganizationSwitchResult, Organizations, type OverviewData, type PolicyCreateParams, type PolicyListParams, type PolicyUpdateParams, type PresignParams, type PresignResult, type PreviewDomainData, type ProductCatalogEntry, type ProductTemplate, type ProductTemplateCatalog, ProjectAuth, type ProjectAuthEnableParams, type ProjectAuthStatus, type ProjectAuthUpdateParams, type ProjectIntegrationCatalogEntry, type ProjectIntegrationCreateParams, type ProjectIntegrationData, type ProjectIntegrationListParams, type ProjectIntegrationUpdateParams, ProjectIntegrations, ProjectNotLinkedError, ProviderDefaults, type ProviderKeyUpsertParams, type PublishFromSandboxParams, type PublishParams, type PublishResult, RateLimitError, type RegionData, Regions, type RollbackParams, type RulesListParams, type Run, type RunActivity, type RunCommandOutput, type RunCreateParams, type RunDiagnostic, type RunDownload, type RunFile, type RunGroup, type RunGroupActivity, type RunGroupCounts, type RunGroupCreateParams, type RunGroupDispatchEntry, type RunGroupDispatchResult, type RunGroupFile, type RunGroupListParams, type RunGroupStatus, type RunGroupWaitOptions, RunGroups, type RunListParams, type RunMessage, type RunOutputs, type RunPreview, type RunStatus, type RunTargetKind, type RunWaitOptions, Runs, type RuntimeCapabilities, RuntimeCapabilitiesResource, RuntimeEnv, type RuntimeEnvListParams, type RuntimeEnvScope, type RuntimeEnvSetParams, type RuntimeEnvTarget, type RuntimeEnvVar, type RuntimeInstanceData, type RuntimeInstanceId, type RuntimeInstanceState, type RuntimeLogsResult, SANDBOX_TEMPLATE, Sandbox, SandboxAudit, type SandboxBuildSpec, type SandboxBuildSpecError, type SandboxBuildSpecValidation, SandboxCommands, type SandboxConnectorAttachParams, type SandboxConnectorBinding, type SandboxConnectorPreflightParams, type SandboxConnectorPreflightResult, SandboxConnectors, type SandboxCreateParams, type SandboxData, SandboxEnv, SandboxEvents, type SandboxExecEvent, type SandboxExecOptions, type SandboxExecResult, type SandboxExecRunner, SandboxFiles, type SandboxGetOrCreateParams, type SandboxId, type SandboxListParams, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, type SandboxState, SandboxTags, type SandboxTemplate, type SandboxTemplateBuild, type SandboxTemplateBuildCreateParams, type SandboxTemplateBuildResourceData, type SandboxTemplateBuildResourceId, type SandboxTemplateCreateParams, type SandboxTemplateList, type SandboxTemplateListParams, type SandboxTemplateResourceData, type SandboxTemplateResourceId, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, type ScrollDirection, type ScrollParams, type SecretCreateParams, type SecretData, type SecretId, type SecretListParams, type SecretRotateParams, type SecretSetParams, type SecretUpdateParams, type SessionId, Settings, type SettingsUpdateParams, type SizeData, type SlackSendTestParams, type SnapshotCreateParams, type SnapshotData, type SnapshotListResponse, type SnapshotProgressEvent, type SnapshotRestoreResult, type SnapshotStatus, SnapshotsStandalone, Storage, type StorageObjectData, SubjectNotAllowedError, type SuggestionsParams, type TemplateBenchmarkLane, type TemplateBuildCreateParams, type TemplateCreateParams, type TemplateData, type TemplateReadinessContract, type TemplateReadinessState, type TemplateSizeReadiness, Templates, type TemplatesListParams, Tenant, type TenantBrandingUpdateParams, type TenantId, type TenantPlan, type TenantSummary, type TerminalCreateParams, TimeoutError, type TimeseriesParams, TokenRefreshFailedError, type TunnelAuthMode, type TunnelCreateParams, type TunnelData, type TunnelId, type TunnelListResponse, type TunnelUpdateParams, type TypeParams, type UpdateWorkspaceMemberRoleParams, Usage, type UsageReportParams, type UsageSession, type UsageSessionsParams, type UsageSummary, UserAuthorizationRequiredError, type UserId, ValidationError, type VersionListParams, type VolumeAttachParams, type VolumeAttachmentData, type VolumeCreateParams, type VolumeData, type VolumeId, type VolumeListParams, Volumes, type WaitParams, type WebhookCreateParams, type WebhookData, type WebhookDeliveryData, type WebhookDeliveryId, type WebhookId, type WebhookListParams, type WebhookUpdateParams, Webhooks, type WindowFocusParams, type WindowInfo, type WorkspaceId, type WorkspaceInvite, type WorkspaceInviteCreatedResponse, type WorkspaceInviteListResponse, type WorkspaceInvitePreview, type WorkspaceInviteRevokeResponse, WorkspaceInvites, type WorkspaceMember, type WorkspaceMemberAddedResponse, type WorkspaceMemberDeleteResponse, type WorkspaceMemberListResponse, type WorkspaceMemberRecord, type WorkspaceMemberRecordResponse, WorkspaceMembers, type WorkspaceRole, type WsTicket, createAgentBuildExecutionPacket, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBuildRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };