@miosa/sdk 3.0.0 → 3.0.2

package/README.md

@@ -244,25 +244,7 @@ const result = await sbx.exec.run("python /workspace/app.py");
 for await (const event of sbx.exec.stream("tail -f /var/log/app.log")) {
   if ("line" in event) console.log(event.line);
 }
-```
-
-> **`sbx.exec.stream()` vs `computer.exec.stream()` - not the same thing.**
-> They share a name and nothing else, by design:
->
-> | | `sbx.exec.stream(command)` (Sandbox) | `computer.exec.stream({ command, tty })` (Computer) |
-> |---|---|---|
-> | Transport | SSE, one-way (server → client) | WebSocket, full duplex |
-> | Purpose | Tail output from a batch command | Interactive shell/PTY session |
-> | Input | Takes a fixed command string up front | `sendStdin()` any time after connecting; supports `tty`/`rows`/`cols` |
-> | Event shape | `{ type: "stdout" \| "stderr" \| "exit", ... }` parsed from JSON lines | Raw `Uint8Array` frames over the wire protocol |
->
-> Use the Sandbox one to watch a log or long-running batch job finish.
-> Use the Computer one to drive an interactive terminal. They will not be
-> merged into one API - a one-way log tail and a duplex PTY session need
-> different guarantees (backpressure, input, framing) that a single shape
-> would blur.
 
-```ts
 // Snapshots
 const snap = await sbx.snapshots.create("pre-migration");
 const restored = await sbx.snapshots.restore(snap.id);
@@ -445,32 +427,6 @@ const miosa = new Miosa({
 });
 ```
 
-### Two sandbox streams need the sandboxes base URL
-
-The API serves two routers, selected by Host header. Two SSE routes exist
-only on the `sandboxes.miosa.ai` router, so they return `404` against the
-default `api.miosa.ai` base URL:
-
-| Method | Route |
-|---|---|
-| `sbx.files.watch()` | `GET /sandboxes/{id}/files/watch` |
-| `sbx.processes.stream(pid)` | `GET /sandboxes/{id}/processes/{pid}/stream` |
-
-Both are implemented server-side; only the platform router is missing them.
-Point the client at the sandboxes host to use them:
-
-```ts
-const miosa = new Miosa({
-  apiKey: process.env.MIOSA_API_KEY!,
-  baseUrl: "https://sandboxes.miosa.ai/api/v1",
-});
-```
-
-The alternative is polling: `sbx.files.list()` / `stat()` instead of
-`watch()`, and `sbx.processes.logs(pid)` instead of `stream(pid)`. Calling
-either against the default base URL raises a `NotFoundError` that names this
-gap rather than a bare `404`.
-
 ## Links
 
 - [Full documentation](https://miosa.ai/docs/sdks/typescript)

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.
@@ -5687,120 +5702,44 @@ interface HostEvent {
     data: unknown;
     timestamp: string;
 }
-/** Job lifecycle, from `Schemas.Job` `@valid_states`. */
-type JobState = "queued" | "running" | "succeeded" | "failed" | "timeout" | "canceled";
-/**
- * @deprecated Renamed to {@link JobState}: the field is `state`, not
- * `status`, and the old union carried two values (`completed`, `cancelled`)
- * that the server never emits. Kept as an alias so existing imports still
- * compile.
- */
-type JobStatus = JobState;
-/**
- * A persisted exec job, as returned by
- * `GET /opencomputers/hosts/{id}/exec/{job_id}` (unwrapped from its `job`
- * envelope by {@link Jobs.get}).
- */
+type JobStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
 interface JobData {
     id: JobId;
     host_id: HostId;
-    tenant_id: string;
-    cmd: string;
+    status: JobStatus;
+    command: string;
     args: string[];
+    env: string[];
     cwd: string | null;
-    timeout_ms: number;
-    state: JobState;
     exit_code: number | null;
-    started_at: string | null;
-    ended_at: string | null;
-    inserted_at: string;
+    stdout: string | null;
+    stderr: string | null;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
 }
-/**
- * Body of `POST /opencomputers/hosts/{id}/exec`.
- *
- * `cmd`, not `command`: the controller reads `params["cmd"]` and 422s with
- * `{"error": "cmd is required"}` when it is missing. `timeout_ms`, not
- * `timeout`. `env` is a list of `{name, value}` maps, not `KEY=value`
- * strings - see `Secrets.Injector.merge_env/2`, which keys off `name`.
- *
- * The `stream` flag is deliberately absent: {@link Jobs.run} pins it false
- * (JSON response) and {@link Jobs.runStream} pins it true (SSE response),
- * because the response type depends on it.
- */
 interface JobRunParams {
-    cmd: string;
+    command: string;
     args?: string[];
-    env?: Array<{
-        name: string;
-        value: string;
-    }>;
+    env?: string[];
     cwd?: string;
-    timeout_ms?: number;
-}
-/**
- * Response of `POST /opencomputers/hosts/{id}/exec` with `stream: false` -
- * the buffered result of the whole command. This is an exec result, not a
- * job record: it has no state, no timing, and no id beyond `job_id`.
- */
-interface JobExecResult {
-    job_id: JobId;
-    exit_code: number | null;
-    stdout: string;
-    stderr: string;
-}
-/**
- * One row of `GET /opencomputers/hosts/{id}/jobs`.
- *
- * This endpoint reads the audit log (`job.dispatched` / `job.done` /
- * `job.failed` events), not the jobs table, so a row is an event about a
- * job rather than the job itself. Multiple rows can share a `job_id`.
- */
-interface JobAuditEvent {
-    id: string;
-    job_id: JobId | null;
-    kind: string | null;
-    status: "dispatched" | "done" | "failed" | "unknown";
-    duration_ms: number | null;
-    dispatched_at: string | null;
-    completed_at: string | null;
-    event_at: string;
-    payload: Record<string, unknown>;
+    timeout?: number;
 }
-/** Response of `GET /opencomputers/hosts/{id}/jobs`. */
 interface JobListResponse {
-    jobs: JobAuditEvent[];
-}
-/** The three SSE `event:` names the exec stream actually emits. */
-type JobEventType = "exec_chunk" | "exec_result" | "exec_error";
-/** A slice of output. `data` is whatever the host sent, unmodified. */
-interface JobChunkEvent {
-    type: "exec_chunk";
-    /** Defaults to `stdout` server-side when the host omits it. */
-    stream: "stdout" | "stderr";
-    data: string | null;
-}
-/** Terminal event for a command that ran to completion. */
-interface JobResultEvent {
-    type: "exec_result";
-    exit_code: number | null;
-    elapsed_ms: number | null;
+    data: JobData[];
+    meta: {
+        total: number;
+        page: number;
+        per_page: number;
+    };
 }
-/** Terminal event for a command that failed to complete. */
-interface JobErrorEvent {
-    type: "exec_error";
-    reason: string | null;
-    /** Present only on the server-side timeout path. */
-    job_id?: JobId;
+type JobEventType = "stdout" | "stderr" | "exit" | "error" | "started" | "done";
+interface JobEvent {
+    type: JobEventType;
+    job_id: JobId;
+    data: string | number | null;
+    timestamp: string;
 }
-/**
- * An exec SSE event, discriminated on the SSE `event:` name.
- *
- * There is no `timestamp` and no per-event `job_id` (outside the timeout
- * case) because the server sends neither. Anything the client synthesised
- * to fill those in would be fabricated data that the compiler would then
- * force callers to trust.
- */
-type JobEvent = JobChunkEvent | JobResultEvent | JobErrorEvent;
 interface FsEntry {
     name: string;
     path: string;
@@ -6276,23 +6215,10 @@ declare class Hosts {
  * Jobs resource — run commands on a remote OpenComputers host and stream output.
  *
  * ```ts
- * // Buffered: one call, one result.
- * const result = await client.openComputers.jobs.run(hostId, { cmd: "npm test" });
- * console.log(result.exit_code, result.stdout);
- *
- * // Streamed: same endpoint, live output.
- * for await (const event of client.openComputers.jobs.runStream(hostId, { cmd: "npm test" })) {
- *   switch (event.type) {
- *     case "exec_chunk":
- *       process.stdout.write(event.data ?? "");
- *       break;
- *     case "exec_result":
- *       console.log(`exit ${event.exit_code} in ${event.elapsed_ms}ms`);
- *       break;
- *     case "exec_error":
- *       console.error(event.reason);
- *       break;
- *   }
+ * const job = await client.openComputers.jobs.run(hostId, { command: "npm test" });
+ * for await (const event of client.openComputers.jobs.stream(hostId, job.id)) {
+ *   process.stdout.write(String(event.data ?? ""));
+ *   if (event.type === "done") break;
  * }
  * ```
  */
@@ -6301,53 +6227,26 @@ declare class Jobs {
     constructor(http: HttpClient);
     private base;
     /**
-     * Run a command on the host and wait for the buffered result.
-     *
-     * Sends `stream: false` so the server buffers output and answers with JSON.
-     * `stream` defaults to *true* server-side, which answers with a chunked SSE
-     * body instead - use {@link runStream} for that.
-     *
-     * Note this holds the connection open for the life of the command
-     * (`timeout_ms`, 30 s default), because the server does not answer until
-     * the command finishes.
-     */
-    run(hostId: HostId | string, params: JobRunParams): Promise<JobExecResult>;
-    /**
-     * Run a command on the host and stream its output as it happens.
-     *
-     * Same endpoint as {@link run} with `stream: true`, which is the server's
-     * default mode. Terminates with one `exec_result` or one `exec_error`.
+     * Dispatch a command to run on the remote host.
      */
-    runStream(hostId: HostId | string, params: JobRunParams): AsyncIterableIterator<JobEvent>;
+    run(hostId: HostId | string, params: JobRunParams): Promise<JobData>;
     /**
-     * List recent job activity for a host.
-     *
-     * Hits `/jobs`, not `/exec`: there is no `GET /opencomputers/hosts/{id}/exec`
-     * route on the server, so the old path 404'd. The rows are audit-log events
-     * about jobs (`job.dispatched` / `job.done` / `job.failed`), newest first,
-     * not job records - see {@link JobAuditEvent}.
-     *
-     * @param limit Server caps this at 100 and defaults to 20.
+     * List all jobs for a host.
      */
-    list(hostId: HostId | string, limit?: number): Promise<JobListResponse>;
+    list(hostId: HostId | string): Promise<JobListResponse>;
     /**
      * Fetch the current state of a job.
-     *
-     * The server wraps the record in a `job` envelope; this unwraps it.
      */
     get(hostId: HostId | string, jobId: JobId | string): Promise<JobData>;
     /**
-     * Re-attach to a job that is already running and stream what is left.
+     * Stream live output from a running job.
      *
-     * This is the reconnect endpoint. If the job has already reached a terminal
-     * state the server answers `204 No Content` and this yields nothing, rather
-     * than replaying output - the server never stored it.
+     * Yields `JobEvent` objects with `type` of `stdout`, `stderr`, `exit`, or
+     * `done`. Break the loop when you receive `done` or `exit`.
      */
     stream(hostId: HostId | string, jobId: JobId | string): AsyncIterableIterator<JobEvent>;
     /**
      * Cancel a running or queued job.
-     *
-     * Answers `204` on success and `409` when the job is already terminal.
      */
     cancel(hostId: HostId | string, jobId: JobId | string): Promise<void>;
 }
@@ -6541,14 +6440,13 @@ declare class OcWorkspaces {
  * // Register a host — save host_key immediately, shown only once
  * const host = await miosa.openComputers.hosts.create({ name: "my-mac" });
  *
- * // Run a command and wait for the buffered result
- * const result = await miosa.openComputers.jobs.run(host.id, { cmd: "npm test" });
- * console.log(result.exit_code, result.stdout);
+ * // Run a command
+ * const job = await miosa.openComputers.jobs.run(host.id, { command: "npm test" });
  *
- * // Or stream the output live
- * for await (const event of miosa.openComputers.jobs.runStream(host.id, { cmd: "npm test" })) {
- *   if (event.type === "exec_chunk") process.stdout.write(event.data ?? "");
- *   if (event.type === "exec_result") console.log(`exit ${event.exit_code}`);
+ * // Stream output
+ * for await (const event of miosa.openComputers.jobs.stream(host.id, job.id)) {
+ *   process.stdout.write(String(event.data ?? ""));
+ *   if (event.type === "done") break;
  * }
  *
  * // Expose a port
@@ -6980,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>;
@@ -7004,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;
@@ -7064,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 {
@@ -7274,22 +7196,7 @@ declare class SandboxFiles {
     tree(path?: string, depth?: number): Promise<SandboxFileTreeNode>;
     /** POST /api/v1/sandboxes/{id}/files/write-many — write multiple files atomically. */
     writeMany(files: SandboxWriteManyEntry[]): Promise<SandboxWriteManyResult>;
-    /**
-     * GET /api/v1/sandboxes/{id}/files/watch (SSE) — live file change events.
-     *
-     * SANDBOXES-HOST ONLY. This route is declared in `Web.Router.Sandboxes`
-     * and not in `Web.Router.Platform`, so it 404s against the SDK's default
-     * `https://api.miosa.ai/api/v1` base URL. Construct the client with
-     * `baseUrl: "https://sandboxes.miosa.ai/api/v1"` to reach it, or poll
-     * {@link list}/{@link stat} instead. See `./sandbox-host-routes.ts`.
-     *
-     * The server opens with a handshake record (`event: connected` /
-     * `data: {"sandbox_id":...}`) before any change events. That record is
-     * not a file change, so it is dropped here rather than yielded as a
-     * `SandboxFileChange` with `type: "connected"` and no `path`. Real change
-     * records carry their own `type` (`created` | `modified` | `deleted`) in
-     * the JSON body, so the SSE `event: file_change` name never overwrites it.
-     */
+    /** GET /api/v1/sandboxes/{id}/files/watch (SSE) — live file change events. */
     watch(): AsyncIterableIterator<SandboxFileChange>;
 }
 declare class SandboxPreview {
@@ -8919,4 +8826,4 @@ declare class AppAuth {
     private _post;
 }
 
-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 JobAuditEvent, type JobChunkEvent, type JobData, type JobErrorEvent, type JobEvent, type JobEventType, type JobExecResult, type JobId, type JobListResponse, type JobResultEvent, type JobRunParams, type JobState, 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 };