@miosa/sdk 3.0.1 → 3.1.0

package/dist/index.d.ts

@@ -13,6 +13,13 @@ interface RequestOptions {
     /** Expected response is binary */
     binary?: boolean;
 }
+/** One parsed Server-Sent Events frame: its `event:` name plus `data:` payload. */
+interface SseFrame<T> {
+    /** The SSE `event:` name, or `null` when the frame carried no event field. */
+    event: string | null;
+    /** The parsed JSON payload from the frame's `data:` line(s). */
+    data: T;
+}
 interface HttpClientConfig {
     baseUrl: string;
     apiKey: string;
@@ -39,6 +46,14 @@ declare class HttpClient {
     delete<T>(path: string, body?: unknown): Promise<T>;
     getBinary(path: string): Promise<Uint8Array>;
     postFormData<T>(path: string, formData: FormData): Promise<T>;
+    /**
+     * Open a Server-Sent Events stream and yield each frame's parsed `data:`
+     * payload together with its SSE `event:` name (when present). Most callers
+     * want {@link stream}; use this when the event name carries meaning — e.g. the
+     * sandbox exec stream tags frames as `stdout` / `stderr` / `exit`. The caller
+     * is responsible for breaking the loop.
+     */
+    streamFrames<T>(path: string, options?: RequestOptions): AsyncIterableIterator<SseFrame<T>>;
     /**
      * Open a Server-Sent Events stream. Returns an AsyncIterableIterator of
      * parsed event data objects. The caller is responsible for breaking the loop.
@@ -443,6 +458,9 @@ type RunTargetKind = "sandbox" | "computer";
 type RunStatus = "running" | "succeeded" | "failed" | "canceled";
 interface Run {
     id: string;
+    agent_definition_id?: string | null;
+    agent_version_id?: string | null;
+    configuration_receipt?: Record<string, unknown> | null;
     run_group_id?: string;
     parent_run_id?: string;
     orchestration_role?: string;
@@ -603,6 +621,9 @@ interface RunCreateParams {
     env?: Record<string, string>;
     agentRuntimeProfileId?: string;
     agentProfileId?: string;
+    agentDefinitionId?: string;
+    agentVersionId?: string;
+    configurationReceipt?: Record<string, unknown>;
     runGroupId?: string;
     parentRunId?: string;
     orchestrationRole?: string;
@@ -850,6 +871,62 @@ declare class AgentRuntimeProfiles {
     delete(id: string): Promise<void>;
 }
 
+interface AgentVersionData {
+    id: string;
+    agent_definition_id: string;
+    version: number;
+    fingerprint: string;
+    configuration: Record<string, unknown>;
+    published_by_user_id?: string | null;
+    published_at: string;
+}
+interface AgentDefinitionData {
+    id: string;
+    tenant_id: string;
+    workspace_id: string;
+    project_id?: string | null;
+    name: string;
+    description?: string | null;
+    status: "active" | "archived" | string;
+    metadata: Record<string, unknown>;
+    latest_version: AgentVersionData;
+    versions?: AgentVersionData[];
+    created_at: string;
+    updated_at: string;
+}
+interface AgentDefinitionListParams {
+    workspaceId?: string;
+    workspace_id?: string;
+    projectId?: string;
+    project_id?: string;
+    status?: "active" | "archived" | "all" | string;
+}
+interface AgentDefinitionCreateParams {
+    workspaceId?: string;
+    workspace_id?: string;
+    projectId?: string;
+    project_id?: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    configuration: Record<string, unknown>;
+}
+interface AgentDefinitionUpdateParams {
+    name?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class AgentDefinitions {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: AgentDefinitionListParams): Promise<AgentDefinitionData[]>;
+    get(id: string): Promise<AgentDefinitionData>;
+    create(params: AgentDefinitionCreateParams): Promise<AgentDefinitionData>;
+    update(id: string, params: AgentDefinitionUpdateParams): Promise<AgentDefinitionData>;
+    publish(id: string, configuration: Record<string, unknown>): Promise<AgentVersionData>;
+    archive(id: string): Promise<void>;
+}
+
 /**
  * Analytics — overview + timeseries (admin scope).
  */
@@ -923,6 +1000,195 @@ declare class ApiKeys {
     delete(keyId: string): Promise<void>;
 }
 
+type AppJson = null | boolean | number | string | AppJson[] | {
+    [key: string]: AppJson;
+};
+interface AppDocument {
+    id: string;
+    name: string;
+    format: "miosa-app/v1";
+    metadata?: Record<string, AppJson>;
+    view: {
+        kind: "generated";
+        source: string;
+        artifact?: {
+            entrypoint: string;
+            files: Record<string, string>;
+        };
+    } | {
+        kind: "served";
+        deploymentId: string;
+        releaseId: string;
+    };
+    capabilities: string[];
+    collections: string[];
+    connectors: string[];
+    automations: Array<{
+        id: string;
+        trigger: {
+            kind: "schedule";
+            cron: string;
+        } | {
+            kind: "event";
+            event: string;
+        };
+        steps: Array<{
+            capability: string;
+            input: AppJson;
+        }>;
+    }>;
+    pins: Array<{
+        slot: string;
+        component: string;
+        baseHash: string;
+        source: string;
+        editIntents: AppJson[];
+    }>;
+    bindings?: Array<{
+        id: string;
+        capability: string;
+        samples: AppJson[];
+        path: string[];
+    }>;
+}
+interface AppReleaseApproval {
+    id: string;
+    app_document_id: string;
+    version_hash: string;
+    approved_by_user_id: string | null;
+    reason: string | null;
+    compiled_requirements: Record<string, AppJson>;
+    deployment_id: string | null;
+    deployment_version_id: string | null;
+    release_id: string | null;
+    artifact_sha256: string | null;
+    source_snapshot_sha256: string | null;
+    approved_at: string;
+    revoked_at: string | null;
+    revoked_by_user_id: string | null;
+}
+interface AppReleaseCandidate {
+    deployment_id: string;
+    deployment_version_id: string;
+    release_id: string;
+    artifact_sha256: string;
+    source_snapshot_sha256: string;
+}
+interface AppDocumentDiagnostics {
+    ok: boolean;
+    issues: Array<Record<string, AppJson>>;
+    manifest: Record<string, AppJson> | null;
+}
+interface AppCollectionRecord<T extends Record<string, AppJson> = Record<string, AppJson>> {
+    key: string;
+    collection: string;
+    value: T;
+    version: number;
+    inserted_at: string;
+    updated_at: string;
+}
+interface AppPublication {
+    deployment_id: string;
+    release_id: string;
+    version_hash: string;
+    published_at: string;
+}
+interface AppActionDecision {
+    decision: "allow" | "pending_approval" | "deny";
+    receipt_id?: string;
+    approval_request_id?: string;
+    reason?: string;
+    capability?: Record<string, AppJson>;
+}
+interface AppRuntimeToken {
+    token: string;
+    release_id: string;
+    expires_in: number;
+}
+interface AppBindingResolution {
+    binding_id: string;
+    receipt_id: string;
+    capability_fingerprint: string;
+    value: AppJson;
+}
+interface AppAutomationRun {
+    id: string;
+    app_document_id: string;
+    release_id: string;
+    automation_id: string;
+    trigger: Record<string, AppJson>;
+    cursor: number;
+    status: "running" | "executing" | "waiting_approval" | "completed" | "failed" | "stopped";
+    current_step: Record<string, AppJson> | null;
+    claim: {
+        receipt_id: string;
+        idempotency_key: string;
+        cursor: number;
+    } | null;
+    pending_approval_request_id: string | null;
+    history: Array<Record<string, AppJson>>;
+    last_error: Record<string, AppJson> | null;
+    inserted_at: string;
+    updated_at: string;
+}
+interface AppDocumentRecord {
+    id: string;
+    tenant_id: string;
+    workspace_id: string;
+    created_by_user_id: string | null;
+    name: string;
+    document: AppDocument;
+    version_hash: string;
+    state: "draft" | "published" | "archived";
+    version_approved: boolean;
+    approval: AppReleaseApproval | null;
+    publication: AppPublication | null;
+    inserted_at: string;
+    updated_at: string;
+}
+interface AppDocumentCreateParams {
+    workspaceId: string;
+    name: string;
+    document: AppDocument;
+}
+interface AppDocumentUpdateParams {
+    name?: string;
+    document?: AppDocument;
+}
+declare class AppDocuments {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(workspaceId: string): Promise<AppDocumentRecord[]>;
+    get(id: string): Promise<AppDocumentRecord>;
+    create(params: AppDocumentCreateParams): Promise<AppDocumentRecord>;
+    update(id: string, params: AppDocumentUpdateParams): Promise<AppDocumentRecord>;
+    archive(id: string): Promise<void>;
+    diagnostics(id: string): Promise<AppDocumentDiagnostics>;
+    stageCandidate(id: string): Promise<AppReleaseCandidate>;
+    approveExactVersion(id: string, releaseId: string, reason?: string): Promise<AppReleaseApproval>;
+    publishExactRelease(id: string): Promise<AppDocumentRecord>;
+    listData<T extends Record<string, AppJson> = Record<string, AppJson>>(id: string, collection: string): Promise<AppCollectionRecord<T>[]>;
+    getData<T extends Record<string, AppJson> = Record<string, AppJson>>(id: string, collection: string, key: string): Promise<AppCollectionRecord<T>>;
+    putData<T extends Record<string, AppJson>>(id: string, collection: string, key: string, value: T, expectedVersion?: number): Promise<AppCollectionRecord<T>>;
+    deleteData(id: string, collection: string, key: string, expectedVersion?: number): Promise<void>;
+    authorizeAction(id: string, input: {
+        releaseId: string;
+        callbackToken: string;
+        capability: Record<string, AppJson>;
+        requestFingerprint: string;
+        paramsFingerprint: string;
+        connectorId?: string;
+    }): Promise<AppActionDecision>;
+    mintRuntimeToken(id: string): Promise<AppRuntimeToken>;
+    resolveBinding(id: string, bindingId: string, receiptId: string, callbackToken: string): Promise<AppBindingResolution>;
+    listAutomationRuns(id: string): Promise<AppAutomationRun[]>;
+    startAutomationRun(id: string, automationId: string, trigger?: Record<string, AppJson>): Promise<AppAutomationRun>;
+    claimAutomationStep(id: string, runId: string): Promise<AppAutomationRun>;
+    completeAutomationStep(id: string, runId: string, cursor: number, idempotencyKey: string, output?: AppJson): Promise<AppAutomationRun>;
+    failAutomationStep(id: string, runId: string, cursor: number, idempotencyKey: string, reason: string): Promise<AppAutomationRun>;
+    revokeApproval(id: string, approvalId: string): Promise<void>;
+}
+
 /**
  * Audit log — admin-scoped event history.
  */
@@ -4943,6 +5209,259 @@ declare class Functions {
     invoke(functionId: string, params?: FunctionInvokeParams): Promise<Record<string, unknown>>;
 }
 
+interface MiosaErrorBody {
+    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;
+    readonly code: string;
+    readonly details: unknown;
+    readonly requestId: string | undefined;
+    constructor(message: string, status: number, code: string, details?: unknown, requestId?: string);
+    static fromResponse(status: number, body: MiosaErrorBody, requestId?: string): MiosaError;
+}
+declare class AuthError extends MiosaError {
+    constructor(message: string, status?: number, code?: string, details?: unknown, requestId?: string);
+}
+declare class NotFoundError extends MiosaError {
+    constructor(message: string, code?: string, details?: unknown, requestId?: string);
+}
+declare class RateLimitError extends MiosaError {
+    readonly retryAfter: number | undefined;
+    constructor(message: string, details?: unknown, requestId?: string, retryAfter?: number);
+}
+declare class InsufficientCreditsError extends MiosaError {
+    constructor(message: string, details?: unknown, requestId?: string);
+}
+declare class ValidationError extends MiosaError {
+    constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string);
+}
+declare class TimeoutError extends MiosaError {
+    constructor(message?: string);
+}
+declare class NetworkError extends MiosaError {
+    readonly cause: Error;
+    constructor(message: string, cause: Error);
+}
+declare class ProjectNotLinkedError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class SubjectNotAllowedError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class ScopeNotAllowedError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class ManagedProviderBindingOnlyError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class InstallationRequiredError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class UserAuthorizationRequiredError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class EgressHostNotAllowedError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+declare class TokenRefreshFailedError extends MiosaError {
+    constructor(message: string, status?: number, details?: unknown, requestId?: string);
+}
+
+type ForgeRepositoryId = string & {
+    readonly __brand: "ForgeRepositoryId";
+};
+type ForgeOrganizationId = string & {
+    readonly __brand: "ForgeOrganizationId";
+};
+type ForgeRepositoryVisibility = "public" | "private" | "internal";
+type ForgeRepositoryState = "provisioning" | "active" | "error" | "deletion_pending" | "deleted";
+interface ForgeRepository {
+    id: ForgeRepositoryId;
+    name: string;
+    slug: string;
+    default_branch: string;
+    visibility: ForgeRepositoryVisibility;
+    state: ForgeRepositoryState;
+    clone_ready: boolean;
+    clone_url: string | null;
+    project_ids: string[];
+    created_at: string;
+    updated_at: string;
+}
+interface ForgeRepositoryCreateParams {
+    name: string;
+    slug?: string;
+    defaultBranch?: string;
+    visibility?: ForgeRepositoryVisibility;
+    projectIds?: string[];
+    idempotencyKey?: string;
+}
+interface ForgeRepositoryUpdateParams {
+    name?: string;
+    slug?: string;
+    visibility?: ForgeRepositoryVisibility;
+    projectIds?: string[];
+}
+interface ForgeRepositoryDeleteOptions {
+    /** Deprecated: delete is inherently replay-safe and accepts no key in v1. */
+    idempotencyKey?: never;
+}
+interface ForgeCapabilities {
+    api_version: "v1";
+    ownership: "organization";
+    detail_locator: "repository_id";
+    lifecycle_states: ForgeRepositoryState[];
+    visibility_values: ForgeRepositoryVisibility[];
+    clone_ready_states: ["active"];
+    base_url: string;
+    features: Record<string, boolean>;
+}
+interface ForgeDeleteReceipt {
+    operation_id: ForgeRepositoryId;
+    replayed: boolean;
+}
+interface ForgeNamedRef {
+    name: string;
+    oid: string;
+}
+interface ForgeBranch extends ForgeNamedRef {
+    is_default: boolean;
+}
+interface ForgeRepositoryRefs {
+    default_branch: string;
+    head_oid: string | null;
+    branches: ForgeBranch[];
+    tags: ForgeNamedRef[];
+}
+type ForgeTreeEntryType = "blob" | "tree";
+interface ForgeTreeEntry {
+    name: string;
+    path: string;
+    type: ForgeTreeEntryType;
+    oid: string;
+    size: number | null;
+}
+interface ForgeRepositoryTree {
+    ref: string;
+    commit_oid: string;
+    path: string;
+    entries: ForgeTreeEntry[];
+    truncated: boolean;
+}
+type ForgeBlobEncoding = "utf-8" | "base64";
+interface ForgeRepositoryBlob {
+    ref: string;
+    commit_oid: string;
+    path: string;
+    oid: string;
+    size: number;
+    encoding: ForgeBlobEncoding;
+    content: string;
+}
+interface ForgeCommit {
+    oid: string;
+    short_oid: string;
+    subject: string;
+    author_name: string;
+    author_email: string;
+    authored_at: string;
+    committer_name: string;
+    committed_at: string;
+    parents: string[];
+}
+interface ForgeCommitHistory {
+    ref: string;
+    path: string;
+    commits: ForgeCommit[];
+    page: {
+        has_more: boolean;
+        next_cursor: string | null;
+    };
+}
+interface ForgeContentLocation {
+    ref?: string;
+    path?: string;
+}
+interface ForgeCommitQuery extends ForgeContentLocation {
+    limit?: number;
+    cursor?: string;
+}
+interface ForgeFileAuthoringParams {
+    branch?: string;
+    expectedHead: string;
+    message?: string;
+    content?: string;
+    idempotencyKey?: string;
+}
+interface ForgeFileOperationReceipt {
+    operation_id: string;
+    repository_id: ForgeRepositoryId;
+    branch: string;
+    path: string;
+    action: "create" | "update" | "delete";
+    previous_head: string;
+    new_head: string;
+    commit: Omit<ForgeCommit, "parents"> & {
+        committer_email: string;
+        signature_status: "unsigned";
+    };
+    policy: {
+        decision: "allowed";
+        receipt_ids: string[];
+    };
+    replayed: boolean;
+}
+declare class ForgeContractError extends MiosaError {
+    constructor(message: string, details?: unknown);
+}
+declare class ForgeUnavailableError extends MiosaError {
+    constructor(message: string, cause: MiosaError);
+}
+declare class ForgeStorageError extends MiosaError {
+    constructor(message: string, cause: MiosaError);
+}
+declare class ForgePolicyViolationError extends MiosaError {
+    constructor(message: string, cause: MiosaError);
+}
+declare class ForgeRepositories {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: ForgeRepositoryCreateParams): Promise<ForgeRepository>;
+    list(): Promise<ForgeRepository[]>;
+    get(id: ForgeRepositoryId): Promise<ForgeRepository>;
+    refs(id: ForgeRepositoryId): Promise<ForgeRepositoryRefs>;
+    tree(id: ForgeRepositoryId, location?: ForgeContentLocation): Promise<ForgeRepositoryTree>;
+    blob(id: ForgeRepositoryId, location: ForgeContentLocation & {
+        path: string;
+    }): Promise<ForgeRepositoryBlob>;
+    readme(id: ForgeRepositoryId, location?: ForgeContentLocation): Promise<ForgeRepositoryBlob>;
+    commits(id: ForgeRepositoryId, query?: ForgeCommitQuery): Promise<ForgeCommitHistory>;
+    putFile(id: ForgeRepositoryId, path: string, params: ForgeFileAuthoringParams & {
+        content: string;
+    }): Promise<ForgeFileOperationReceipt>;
+    deleteFile(id: ForgeRepositoryId, path: string, params: ForgeFileAuthoringParams): Promise<ForgeFileOperationReceipt>;
+    private authorFile;
+    update(id: ForgeRepositoryId, params: ForgeRepositoryUpdateParams): Promise<ForgeRepository>;
+    delete(id: ForgeRepositoryId, _options?: ForgeRepositoryDeleteOptions): Promise<ForgeDeleteReceipt>;
+}
+declare class Forge {
+    readonly repositories: ForgeRepositories;
+    constructor(http: HttpClient);
+    private readonly http;
+    capabilities(): Promise<ForgeCapabilities>;
+}
+
 /**
  * HealthChecks resource — uptime monitoring.
  */
@@ -6280,6 +6799,18 @@ interface SandboxCreateParams {
     agent_profile_id?: string;
     skipRuntimeProfile?: boolean;
     skip_agent_runtime_profile?: boolean;
+    workspaceId?: string;
+    workspace_id?: string;
+    workspaceSlug?: string;
+    workspace_slug?: string;
+    workspaceName?: string;
+    workspace_name?: string;
+    projectId?: string;
+    project_id?: string;
+    projectSlug?: string;
+    project_slug?: string;
+    projectName?: string;
+    project_name?: string;
     externalWorkspaceId?: string;
     external_workspace_id?: string;
     externalUserId?: string;
@@ -6347,17 +6878,29 @@ interface SandboxExportParams {
     label?: string;
     filename?: string;
 }
+/**
+ * A single frame from {@link SandboxExecRunner.stream}, normalized so callers
+ * can always switch on `type` to separate stdout from stderr and detect the
+ * terminal exit frame.
+ *
+ * The server tags each SSE frame with an `event:` name (`stdout` / `stderr` /
+ * `exit`); the SDK maps that name onto `type`. For output frames `data` (and
+ * its legacy alias `line`) carry the text chunk. The exit frame carries the
+ * process exit code as both `exit_code` and its camelCase alias `exitCode`.
+ */
 type SandboxExecEvent = {
-    type?: "stdout";
+    type: "stdout";
+    data: string;
     line: string;
 } | {
-    type?: "stderr";
+    type: "stderr";
+    data: string;
     line: string;
 } | {
-    type?: "exit";
+    type: "exit";
     exit_code: number;
-    exitCode?: number;
-} | Record<string, unknown>;
+    exitCode: number;
+};
 interface SandboxExecRunner {
     (command: string, options?: SandboxExecOptions): Promise<SandboxExecResult>;
     run(command: string, options?: SandboxExecOptions): Promise<SandboxExecResult>;
@@ -6371,6 +6914,9 @@ interface SandboxData {
     ready?: boolean;
     template_id?: string;
     image_id?: string | null;
+    size?: SandboxSize | string | null;
+    /** Resolved resource contract the control plane placed this sandbox on. */
+    resource_contract?: SandboxResourceContract | null;
     cpu_count?: number | null;
     memory_mb?: number | null;
     disk_mb?: number | null;
@@ -6403,6 +6949,8 @@ interface SandboxUsage {
     state: string;
     runtime_sec: number;
     provisioned_vcpu_ms: number;
+    provisioned_memory_mb_ms: number | null;
+    creation_count: number;
     active_cpu_ms: number | null;
     network_ingress_bytes: number | null;
     network_egress_bytes: number | null;
@@ -6416,6 +6964,8 @@ interface SandboxUsage {
     timeout_remaining_ms: number | null;
 }
 interface SandboxForkParams {
+    snapshotId?: string;
+    snapshot_id?: string;
     timeoutSec?: number;
     timeout_sec?: number;
     templateId?: string;
@@ -6427,6 +6977,15 @@ interface SandboxLegacyForkParams extends SandboxForkParams {
     name?: string;
     metadata?: Record<string, unknown>;
 }
+interface SandboxResourceContract {
+    id: string;
+    version: string;
+    product: string;
+    size: SandboxSize | string;
+    vcpus: number;
+    memory_mb: number;
+    disk_size_mb: number;
+}
 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 & {});
 interface PreviewUrlInfo {
@@ -6854,6 +7413,11 @@ declare class Sandbox {
     resume(idempotencyKey?: string): Promise<Sandbox>;
     deploy(params?: SandboxDeployParams): Promise<Record<string, unknown>>;
     deployDocker(params?: SandboxDeployParams): Promise<Record<string, unknown>>;
+    /** Deploy an immutable snapshot without modifying the editable sandbox. */
+    deploySnapshot(snapshotId: string, params?: SandboxDeployParams, options?: {
+        cleanup?: boolean;
+        forkIdempotencyKey?: string;
+    }): Promise<Record<string, unknown>>;
     /** Check readiness of the sandbox (GET /sandboxes/:id/readiness). */
     readiness(): Promise<Record<string, unknown>>;
     /**
@@ -6876,6 +7440,16 @@ declare class Sandbox {
         timeout?: number;
         stream?: boolean;
     }): Promise<boolean>;
+    /**
+     * Readiness answers from the server; `assertRunning` reads the local
+     * snapshot. Leaving that snapshot behind meant a caller could await
+     * `waitUntilReady()`, receive `true`, and have the very next call refused
+     * for being "provisioning" — the sandbox was running the whole time, only
+     * this object had not been told. Nothing here can fail the wait: readiness
+     * has already answered, so a refresh that does not land is not the caller's
+     * problem.
+     */
+    private adoptReadyState;
     /**
      * Returns `true` / `false` for terminal SSE events, or `null` if the
      * stream endpoint is unavailable (404 or transport error) so callers
@@ -7914,6 +8488,7 @@ declare class Miosa {
     readonly orgInvites: OrgInvites;
     /** Organizations available to the user session, membership, invites, and switching. */
     readonly organizations: Organizations;
+    readonly forge: Forge;
     /** Current tenant plan, limits, and live usage counters. */
     readonly tenant: Tenant;
     /** Datacenter regions, compute sizes, pricing, community templates. */
@@ -7938,6 +8513,8 @@ declare class Miosa {
     readonly projectIntegrations: ProjectIntegrations;
     /** Built-in auth for generated apps inside sandboxes/deployments. */
     readonly projectAuth: ProjectAuth;
+    /** Durable generated App Documents, exact-version reviews, and publication bindings. */
+    readonly appDocuments: AppDocuments;
     /** BYOK encrypted per-user provider keys. */
     readonly externalKeys: ExternalKeys;
     /** Model Context Protocol — JSON-RPC dispatch + streaming channel. */
@@ -7952,6 +8529,8 @@ declare class Miosa {
     readonly agentRunGroups: AgentRunGroups;
     /** Agent runtime profiles — tenant/workspace defaults for sandbox/computer agents. */
     readonly agentRuntimeProfiles: AgentRuntimeProfiles;
+    /** Persisted workspace Agent definitions and immutable versions. */
+    readonly agents: AgentDefinitions;
     /** MIOSA Connect — provider connectors and runtime tokens. */
     readonly connectors: Connectors;
     /** Inherited runtime env — tenant/workspace/project defaults for agent runtimes. */
@@ -8247,73 +8826,4 @@ declare class AppAuth {
     private _post;
 }
 
-interface MiosaErrorBody {
-    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;
-    readonly code: string;
-    readonly details: unknown;
-    readonly requestId: string | undefined;
-    constructor(message: string, status: number, code: string, details?: unknown, requestId?: string);
-    static fromResponse(status: number, body: MiosaErrorBody, requestId?: string): MiosaError;
-}
-declare class AuthError extends MiosaError {
-    constructor(message: string, status?: number, code?: string, details?: unknown, requestId?: string);
-}
-declare class NotFoundError extends MiosaError {
-    constructor(message: string, code?: string, details?: unknown, requestId?: string);
-}
-declare class RateLimitError extends MiosaError {
-    readonly retryAfter: number | undefined;
-    constructor(message: string, details?: unknown, requestId?: string, retryAfter?: number);
-}
-declare class InsufficientCreditsError extends MiosaError {
-    constructor(message: string, details?: unknown, requestId?: string);
-}
-declare class ValidationError extends MiosaError {
-    constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string);
-}
-declare class TimeoutError extends MiosaError {
-    constructor(message?: string);
-}
-declare class NetworkError extends MiosaError {
-    readonly cause: Error;
-    constructor(message: string, cause: Error);
-}
-declare class ProjectNotLinkedError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-declare class SubjectNotAllowedError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-declare class ScopeNotAllowedError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-declare class ManagedProviderBindingOnlyError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-declare class InstallationRequiredError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-declare class UserAuthorizationRequiredError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-declare class EgressHostNotAllowedError extends MiosaError {
-    constructor(message: string, status?: number, details?: unknown, requestId?: string);
-}
-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 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 };
+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 AgentDefinitionCreateParams, type AgentDefinitionData, type AgentDefinitionListParams, type AgentDefinitionUpdateParams, AgentDefinitions, 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 AgentVersionData, type AllowParams, Analytics, type AnalyticsFilters, type ApiKeyCreateParams, type ApiKeyCreateResult, type ApiKeyData, type ApiKeyId, type ApiKeyListParams, ApiKeys, type AppActionDecision, AppAuth, type AppAuthConfig, type AppAuthResourceType, type AppAuthSession, type AppAuthTokenPayload, type AppAutomationRun, type AppCatalogEntry, type AppCollectionRecord, type AppDocument, type AppDocumentCreateParams, type AppDocumentDiagnostics, type AppDocumentRecord, type AppDocumentUpdateParams, AppDocuments, type AppInstallData, type AppInstallEvent, type AppJson, type AppReleaseApproval, type AppReleaseCandidate, 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, Forge, ForgeContractError, type ForgeDeleteReceipt, type ForgeOrganizationId, ForgePolicyViolationError, ForgeRepositories, type ForgeRepository, type ForgeRepositoryCreateParams, type ForgeRepositoryDeleteOptions, type ForgeRepositoryId, type ForgeRepositoryState, type ForgeRepositoryUpdateParams, type ForgeRepositoryVisibility, ForgeStorageError, ForgeUnavailableError, 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 };