@miosa/sdk 1.2.22 → 1.2.24

package/dist/index.d.ts

@@ -253,6 +253,19 @@ interface AgentRunCreateParams {
     timeout?: number;
     wait?: boolean;
     env?: Record<string, string>;
+    /** Claude Code: `--output-format`, e.g. "json" or "stream-json". */
+    outputFormat?: "text" | "json" | "stream-json" | string;
+    output_format?: "text" | "json" | "stream-json" | string;
+    /** Claude Code: `--resume <session_id>`. */
+    resumeSessionId?: string;
+    resume_session_id?: string;
+    /** Codex: pass `--json` for JSONL event output. */
+    json?: boolean;
+    /** Codex: path to a JSON Schema file inside the runtime. */
+    outputSchema?: string;
+    output_schema?: string;
+    /** Codex: path to an image file inside the runtime. */
+    image?: string;
     agentRuntimeProfileId?: string;
     agentProfileId?: string;
     agentRunGroupId?: string;
@@ -2339,12 +2352,24 @@ declare class Desktop$1 {
     screenshot(): Promise<Uint8Array>;
     /** Click at the given coordinates. */
     click(x: number, y: number, button?: ClickParams["button"]): Promise<DesktopActionResult>;
+    /** Explicit left-button click. Alias for click(x, y, "left"). */
+    leftClick(x: number, y: number): Promise<DesktopActionResult>;
+    /** Right-button click. Alias for click(x, y, "right"). */
+    rightClick(x: number, y: number): Promise<DesktopActionResult>;
+    /** Middle-button click. Alias for click(x, y, "middle"). */
+    middleClick(x: number, y: number): Promise<DesktopActionResult>;
     /** Double-click at the given coordinates. */
     doubleClick(x: number, y: number): Promise<DesktopActionResult>;
+    /** Move the mouse pointer without clicking. */
+    moveMouse(x: number, y: number): Promise<DesktopActionResult>;
     /** Type text into the currently focused element. */
     type(text: string, delay?: number): Promise<DesktopActionResult>;
+    /** Alias for `type(text)` used by simple computer-control loops. */
+    write(text: string, delay?: number): Promise<DesktopActionResult>;
     /** Send a key or key combination (e.g. "Enter", "ctrl+c"). */
     key(key: string): Promise<DesktopActionResult>;
+    /** Alias for `key(key)` used by simple computer-control loops. */
+    press(key: string): Promise<DesktopActionResult>;
     /** Scroll in a direction at an optional position. */
     scroll(direction: ScrollParams["direction"], clicks?: number, x?: number, y?: number): Promise<DesktopActionResult>;
     /** Click and drag from one coordinate to another. */
@@ -3123,6 +3148,7 @@ declare class ComputerInbox {
     get(): Promise<Record<string, unknown>>;
     update(fields: Record<string, unknown>): Promise<Record<string, unknown>>;
 }
+type ComputerPromptOptions = Omit<AgentRunCreateParams, "prompt" | "targetKind" | "targetId" | "sandboxId" | "computerId">;
 /**
  * A Computer instance bound to a specific computer ID.
  *
@@ -3207,6 +3233,13 @@ declare class Computer {
     destroy(): Promise<void>;
     /** Reload metadata from the API and update `this.data`. */
     reload(): Promise<Computer>;
+    /**
+     * Run an AI agent inside this Computer.
+     *
+     * The Computer is the graphical desktop VM product. This dispatches the
+     * same Agent Runs API as `miosa agent run --computer`, scoped to this VM.
+     */
+    prompt(instruction: string, options?: ComputerPromptOptions): Promise<AgentRun>;
     /**
      * Capture a desktop screenshot as PNG bytes.
      * Shortcut for `computer.desktop.screenshot()`.
@@ -3228,16 +3261,24 @@ declare class Computer {
     rightClick(x: number, y: number): Promise<void>;
     /** Double-click at the given coordinates. */
     doubleClick(x: number, y: number): Promise<void>;
+    /** Middle-button click. */
+    middleClick(x: number, y: number): Promise<void>;
+    /** Move the pointer without clicking. */
+    moveMouse(x: number, y: number): Promise<void>;
     /**
      * Type text into the focused element.
      * Shortcut for `computer.desktop.type(text)`.
      */
     type(text: string): Promise<void>;
+    /** Alias for `type(text)`. */
+    write(text: string): Promise<void>;
     /**
      * Send a key or key combo.
      * Shortcut for `computer.desktop.key(key)`.
      */
     key(key: string): Promise<void>;
+    /** Alias for `key(key)`. */
+    press(key: string): Promise<void>;
     /**
      * Scroll in a direction.
      * Shortcut for `computer.desktop.scroll(direction, clicks)`.
@@ -3305,6 +3346,13 @@ declare class Computer {
     urls(): Promise<Record<string, unknown>>;
     /** Mint a short-lived stream token for this computer. */
     streamToken(): Promise<Record<string, unknown>>;
+    /**
+     * Mint a passwordless browser embed URL for authenticated platform sessions.
+     *
+     * Use this inside MIOSA or tenant apps. Raw shared desktop URLs can still use
+     * the viewer password flow when opened outside an authenticated platform.
+     */
+    embed(): Promise<Record<string, unknown>>;
     /** Clone this computer into a new one. */
     clone(opts?: Record<string, unknown>): Promise<Computer>;
     /** Resize the computer (change CPU/memory/disk). */
@@ -5641,11 +5689,20 @@ interface TemplateData {
     slug?: string;
     [key: string]: unknown;
 }
+interface ComputeCatalogData {
+    products?: Array<Record<string, unknown>>;
+    regions?: Array<Record<string, unknown>>;
+    sizes?: Array<Record<string, unknown>>;
+    templates?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}
 declare class Regions {
     private readonly http;
     constructor(http: HttpClient);
     /** List datacenter regions. */
     listRegions(): Promise<RegionData[]>;
+    /** Get canonical compute catalog, including product templates and readiness. */
+    catalog(): Promise<ComputeCatalogData>;
     /** List available compute sizes. */
     listSizes(): Promise<SizeData[]>;
     /** Get static compute pricing data. */
@@ -6084,6 +6141,7 @@ interface SandboxDeployParams {
     idempotencyKey?: string;
     idempotency_key?: string;
 }
+type SandboxPromptOptions = Omit<AgentRunCreateParams, "prompt" | "targetKind" | "targetId" | "sandboxId" | "computerId">;
 declare class SandboxCommands {
     private readonly sandbox;
     constructor(sandbox: Sandbox);
@@ -6150,6 +6208,11 @@ declare class SandboxEvents {
     /** Stream live sandbox events via SSE. */
     stream(): AsyncIterableIterator<Record<string, unknown>>;
 }
+declare class SandboxMetrics {
+    private readonly sandbox;
+    constructor(sandbox: Sandbox);
+    get(window?: string): Promise<Record<string, unknown>>;
+}
 declare class SandboxPreviews {
     private readonly sandbox;
     constructor(sandbox: Sandbox);
@@ -6203,6 +6266,8 @@ declare class Sandbox {
     readonly terminal: SandboxTerminal;
     /** SSE event stream. */
     readonly events: SandboxEvents;
+    /** Operational metrics and current resource state. */
+    readonly metricsResource: SandboxMetrics;
     /** Preview CRUD + share/revokeShare. */
     readonly previews: SandboxPreviews;
     /** Read-only env var listing. */
@@ -6223,6 +6288,13 @@ declare class Sandbox {
     get ready(): boolean;
     get templateId(): string;
     refresh(): Promise<Sandbox>;
+    /**
+     * Run an AI coding agent inside this Sandbox.
+     *
+     * Defaults to Claude Code, waits for completion, and runs from `/workspace`.
+     * Pass `{ provider: "codex", env: { CODEX_API_KEY } }` to run Codex.
+     */
+    prompt(instruction: string, options?: SandboxPromptOptions): Promise<AgentRun>;
     private runExec;
     private execStream;
     writeFile(path: string, content: string | Uint8Array): Promise<void>;
@@ -6235,11 +6307,15 @@ declare class Sandbox {
     listFiles(path?: string): Promise<SandboxFileList>;
     statFile(path: string): Promise<SandboxFileStat>;
     expose(port?: number): Promise<string>;
+    getUrl(port?: number, path?: string): Promise<string>;
+    getHost(port?: number): Promise<string>;
     exposeInfo(port?: number): Promise<PreviewUrlInfo>;
     startTemplate(options?: Record<string, unknown>): Promise<Record<string, unknown>>;
     getArtifacts(): Promise<Record<string, unknown>>;
     getLogs(lines?: number): Promise<string | Record<string, unknown>>;
     streamLogs(): AsyncIterableIterator<Record<string, unknown>>;
+    metrics(window?: string): Promise<Record<string, unknown>>;
+    getMetrics(window?: string): Promise<Record<string, unknown>>;
     createSnapshot(comment?: string): Promise<SandboxSnapshot>;
     listSnapshots(): Promise<SandboxSnapshot[]>;
     restoreSnapshot(snapshotId: string): Promise<Sandbox>;
@@ -6839,6 +6915,26 @@ interface VolumeCreateParams {
     idempotencyKey?: string;
     [key: string]: unknown;
 }
+interface VolumeAttachmentData {
+    id: string;
+    volume_id: string;
+    computer_id: string;
+    mount_path: string;
+    read_only?: boolean;
+    state?: string;
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+interface VolumeAttachParams {
+    volumeId?: string;
+    volume_id?: string;
+    mountPath?: string;
+    mount_path?: string;
+    readOnly?: boolean;
+    read_only?: boolean;
+    [key: string]: unknown;
+}
 declare class Volumes {
     private readonly http;
     constructor(http: HttpClient);
@@ -6846,6 +6942,9 @@ declare class Volumes {
     get(volumeId: string): Promise<VolumeData>;
     create(params: VolumeCreateParams): Promise<VolumeData>;
     delete(volumeId: string): Promise<void>;
+    listAttachments(computerId: string): Promise<VolumeAttachmentData[]>;
+    attach(computerId: string, params: VolumeAttachParams): Promise<VolumeAttachmentData>;
+    detach(computerId: string, attachmentId: string): Promise<void>;
 }
 
 /**
@@ -7555,4 +7654,4 @@ declare class TokenRefreshFailedError extends MiosaError {
     constructor(message: string, status?: number, details?: unknown, requestId?: string);
 }
 
-export { AGENT_BUILD_KIND_SPECS, type AcceptOrgInviteResponse, type AcceptWorkspaceInviteResponse, type AddDomainParams, type AddWorkspaceMemberParams, Admin, type AgentBuildArtifactSpec, type AgentBuildExecutionPacket, type AgentBuildKind, type AgentBuildKindSpec, type AgentBuildPlannerDocument, type AgentDispatchParams, type AgentEvent$1 as AgentEvent, type AgentEventType, type AgentRun, type AgentRunCreateParams, type AgentRunEvent, type AgentRunGroup, type AgentRunGroupArtifact, type AgentRunGroupCounts, type AgentRunGroupCreateParams, type AgentRunGroupDispatchEntry, type AgentRunGroupDispatchResult, type AgentRunGroupEvent, type AgentRunGroupListParams, type AgentRunGroupStatus, type AgentRunGroupWaitOptions, AgentRunGroups, type AgentRunListParams, type AgentRunStatus, type AgentRunTargetKind, type AgentRunWaitOptions, AgentRuns, 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, 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 CreateBuildAgentRunParams, 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 DeploymentReleaseData, type DeploymentReleaseId, DeploymentReleases, DeploymentRuntimeInstances, type DeploymentServiceData, type DeploymentServiceId, type DeploymentServiceType, type DeploymentSourceType, type DeploymentState, type DeploymentUpdateParams, type DeploymentVersionData, type DeploymentVersionId, type DeploymentVersionKind, type DeploymentVersionState, DeploymentVersions, Deployments, Desktop$1 as Desktop, type DesktopActionResult, type DeviceBootstrapParams, type DeviceBootstrapResult, type DeviceBrowserResult, type DeviceCapabilities, type DeviceData, type DeviceExecParams, type DeviceExecResult, type DeviceExposeParams, type DeviceExposeResult, type DeviceExtendParams, type DeviceFileEntry, type DeviceFileListParams, type DeviceKind, type DeviceLifecycleResult, type DeviceListParams, type DeviceReadFileParams, type DeviceReadFileResult, type DeviceWriteFileParams, type DeviceWriteFileResult, Devices, type DirEntry, type DirListResult, type DiscordSendTestParams, DockerDeploy, type DockerDeployApplianceStatus, type DockerDeployCreateParams, type DockerDeployDoctorCheck, type DockerDeployDoctorParams, type DockerDeployDoctorProbe, type DockerDeployDoctorResult, type DockerDeployHostData, type DockerDeployHostEnsureParams, type DockerDeployHostId, type DockerDeployHostListParams, type DockerDeployHostListResponse, type DockerDeployHostResponse, type DockerDeployHostStatus, type DoubleClickParams, type DragParams, type EgressAllowlistRule, EgressAudit, type EgressAuditEvent, type EgressBindingData, EgressHostNotAllowedError, EgressNetwork, type EgressPolicyData, type EgressPolicyMode, type EgressRuleEffect, type EgressSecretData, type EgressSecretScope, type EgressSecretType, EgressSecrets, type EgressSuggestion, Email, EmailCampaigns, EmailInbox, EmailTemplates, type EmbeddingCreateParams, Embeddings, Exec, type ExecParams, type ExecPythonParams, type ExecResult, type ExternalAttribution, type ExternalKeyCreateParams, type ExternalKeyData, ExternalKeys, type FileDeleteParams, type FileDownloadParams, type FileEntry, type FileExportParams, type FileExportResult, type FileListParams, type FileListResult, type FileStat, Files, FlatCustomDomains, type FsEntry, type FsListResponse, type FsStat, type FunctionCreateParams, type FunctionData, type FunctionId, type FunctionInvokeParams, type FunctionListParams, type FunctionUpdateParams, Functions, type GithubRepo, type GithubSshKey, type HealthCheckCreateParams, type HealthCheckData, type HealthCheckId, type HealthCheckListParams, type HealthCheckUpdateParams, HealthChecks, type HostCreateParams, type HostData, type HostEvent, type HostId, type HostListResponse, type HostStatus, type HostUpdateParams, InstallationRequiredError, InsufficientCreditsError, type IntegrationCatalogEntry, type IntegrationData, Integrations, type JobData, type JobEvent, type JobEventType, type JobId, type JobListResponse, type JobRunParams, type JobStatus, type KeyParams, type LaunchParams, type LinearCreateIssueParams, type ListAdminApiKeysParams, type ListAdminComputersParams, type ListAdminTenantsParams, type ListAdminUsersParams, ManagedProviderBindingOnlyError, Mcp, type McpDispatchParams, Miosa, type MiosaClientConfig, MiosaError, type MiosaErrorBody, type MkdirParams, type ModeParams, Models, type MouseButton, NetworkError, NetworkPolicy, type NetworkPolicyData, type NetworkPolicyEffect, type NetworkPolicyProtocol, type NetworkPolicyRule, type NetworkPolicySetParams, NotFoundError, type NotificationPrefsUpdateParams, OAuthFlow, type OauthConnectParams, type OauthProvider, type OauthStartResult, type OauthStatusResult, type ObjectListParams, type AgentEvent as OcAgentEvent, type OcAgentSessionData, type AgentSessionListResponse as OcAgentSessionListResponse, type OcWorkspaceCreateParams, type OcWorkspaceData, type OcWorkspaceEvent, type OcWorkspaceListResponse, type OcWorkspaceStatus, type OcWorkspaceUpdateParams, OpenComputers, type OrgInvite, type OrgInviteCreated, type OrgInviteCreatedResponse, type OrgInviteListResponse, type OrgInvitePreview, type OrgInviteRevokeResponse, OrgInvites, type OrgRole, type OverviewData, type PolicyCreateParams, type PolicyListParams, type PolicyUpdateParams, type PresignParams, type PresignResult, type PreviewDomainData, 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 RuntimeCapabilities, RuntimeCapabilitiesResource, RuntimeEnv, type RuntimeEnvListParams, type RuntimeEnvScope, type RuntimeEnvSetParams, type RuntimeEnvTarget, type RuntimeEnvVar, type RuntimeInstanceData, type RuntimeInstanceId, type RuntimeInstanceState, type RuntimeLogsResult, SANDBOX_TEMPLATE, Sandbox, SandboxArtifacts, 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 TemplateBuildCreateParams, type TemplateCreateParams, type TemplateData, Tenant, type TenantBrandingUpdateParams, type TenantId, type TenantPlan, type TenantSummary, type TerminalCreateParams, TimeoutError, type TimeseriesParams, TokenRefreshFailedError, type TunnelAuthMode, type TunnelCreateParams, type TunnelData, type TunnelId, type TunnelListResponse, type TunnelUpdateParams, type TypeParams, type UpdateWorkspaceMemberRoleParams, Usage, type UsageReportParams, type UsageSession, type UsageSessionsParams, type UsageSummary, UserAuthorizationRequiredError, type UserId, ValidationError, type VersionListParams, type VolumeCreateParams, type VolumeData, type VolumeId, type VolumeListParams, Volumes, type WaitParams, type WebhookCreateParams, type WebhookData, type WebhookDeliveryData, type WebhookDeliveryId, type WebhookId, type WebhookListParams, type WebhookUpdateParams, Webhooks, type WindowFocusParams, type WindowInfo, type WorkspaceId, type WorkspaceInvite, type WorkspaceInviteCreatedResponse, type WorkspaceInviteListResponse, type WorkspaceInvitePreview, type WorkspaceInviteRevokeResponse, WorkspaceInvites, type WorkspaceMember, type WorkspaceMemberAddedResponse, type WorkspaceMemberDeleteResponse, type WorkspaceMemberListResponse, type WorkspaceMemberRecord, type WorkspaceMemberRecordResponse, WorkspaceMembers, type WorkspaceRole, type WsTicket, createAgentBuildExecutionPacket, createAgentBuildOutputContract, createAgentBuildPrompt, createBuildAgentRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
+export { AGENT_BUILD_KIND_SPECS, type AcceptOrgInviteResponse, type AcceptWorkspaceInviteResponse, type AddDomainParams, type AddWorkspaceMemberParams, Admin, type AgentBuildArtifactSpec, type AgentBuildExecutionPacket, type AgentBuildKind, type AgentBuildKindSpec, type AgentBuildPlannerDocument, type AgentDispatchParams, type AgentEvent$1 as AgentEvent, type AgentEventType, type AgentRun, type AgentRunCreateParams, type AgentRunEvent, type AgentRunGroup, type AgentRunGroupArtifact, type AgentRunGroupCounts, type AgentRunGroupCreateParams, type AgentRunGroupDispatchEntry, type AgentRunGroupDispatchResult, type AgentRunGroupEvent, type AgentRunGroupListParams, type AgentRunGroupStatus, type AgentRunGroupWaitOptions, AgentRunGroups, type AgentRunListParams, type AgentRunStatus, type AgentRunTargetKind, type AgentRunWaitOptions, AgentRuns, 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, 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 CreateBuildAgentRunParams, 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 DeploymentReleaseData, type DeploymentReleaseId, DeploymentReleases, DeploymentRuntimeInstances, type DeploymentServiceData, type DeploymentServiceId, type DeploymentServiceType, type DeploymentSourceType, type DeploymentState, type DeploymentUpdateParams, type DeploymentVersionData, type DeploymentVersionId, type DeploymentVersionKind, type DeploymentVersionState, DeploymentVersions, Deployments, Desktop$1 as Desktop, type DesktopActionResult, type DeviceBootstrapParams, type DeviceBootstrapResult, type DeviceBrowserResult, type DeviceCapabilities, type DeviceData, type DeviceExecParams, type DeviceExecResult, type DeviceExposeParams, type DeviceExposeResult, type DeviceExtendParams, type DeviceFileEntry, type DeviceFileListParams, type DeviceKind, type DeviceLifecycleResult, type DeviceListParams, type DeviceReadFileParams, type DeviceReadFileResult, type DeviceWriteFileParams, type DeviceWriteFileResult, Devices, type DirEntry, type DirListResult, type DiscordSendTestParams, DockerDeploy, type DockerDeployApplianceStatus, type DockerDeployCreateParams, type DockerDeployDoctorCheck, type DockerDeployDoctorParams, type DockerDeployDoctorProbe, type DockerDeployDoctorResult, type DockerDeployHostData, type DockerDeployHostEnsureParams, type DockerDeployHostId, type DockerDeployHostListParams, type DockerDeployHostListResponse, type DockerDeployHostResponse, type DockerDeployHostStatus, type DoubleClickParams, type DragParams, type EgressAllowlistRule, EgressAudit, type EgressAuditEvent, type EgressBindingData, EgressHostNotAllowedError, EgressNetwork, type EgressPolicyData, type EgressPolicyMode, type EgressRuleEffect, type EgressSecretData, type EgressSecretScope, type EgressSecretType, EgressSecrets, type EgressSuggestion, Email, EmailCampaigns, EmailInbox, EmailTemplates, type EmbeddingCreateParams, Embeddings, Exec, type ExecParams, type ExecPythonParams, type ExecResult, type ExternalAttribution, type ExternalKeyCreateParams, type ExternalKeyData, ExternalKeys, type FileDeleteParams, type FileDownloadParams, type FileEntry, type FileExportParams, type FileExportResult, type FileListParams, type FileListResult, type FileStat, Files, FlatCustomDomains, type FsEntry, type FsListResponse, type FsStat, type FunctionCreateParams, type FunctionData, type FunctionId, type FunctionInvokeParams, type FunctionListParams, type FunctionUpdateParams, Functions, type GithubRepo, type GithubSshKey, type HealthCheckCreateParams, type HealthCheckData, type HealthCheckId, type HealthCheckListParams, type HealthCheckUpdateParams, HealthChecks, type HostCreateParams, type HostData, type HostEvent, type HostId, type HostListResponse, type HostStatus, type HostUpdateParams, InstallationRequiredError, InsufficientCreditsError, type IntegrationCatalogEntry, type IntegrationData, Integrations, type JobData, type JobEvent, type JobEventType, type JobId, type JobListResponse, type JobRunParams, type JobStatus, type KeyParams, type LaunchParams, type LinearCreateIssueParams, type ListAdminApiKeysParams, type ListAdminComputersParams, type ListAdminTenantsParams, type ListAdminUsersParams, ManagedProviderBindingOnlyError, Mcp, type McpDispatchParams, Miosa, type MiosaClientConfig, MiosaError, type MiosaErrorBody, type MkdirParams, type ModeParams, Models, type MouseButton, NetworkError, NetworkPolicy, type NetworkPolicyData, type NetworkPolicyEffect, type NetworkPolicyProtocol, type NetworkPolicyRule, type NetworkPolicySetParams, NotFoundError, type NotificationPrefsUpdateParams, OAuthFlow, type OauthConnectParams, type OauthProvider, type OauthStartResult, type OauthStatusResult, type ObjectListParams, type AgentEvent as OcAgentEvent, type OcAgentSessionData, type AgentSessionListResponse as OcAgentSessionListResponse, type OcWorkspaceCreateParams, type OcWorkspaceData, type OcWorkspaceEvent, type OcWorkspaceListResponse, type OcWorkspaceStatus, type OcWorkspaceUpdateParams, OpenComputers, type OrgInvite, type OrgInviteCreated, type OrgInviteCreatedResponse, type OrgInviteListResponse, type OrgInvitePreview, type OrgInviteRevokeResponse, OrgInvites, type OrgRole, type OverviewData, type PolicyCreateParams, type PolicyListParams, type PolicyUpdateParams, type PresignParams, type PresignResult, type PreviewDomainData, 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 RuntimeCapabilities, RuntimeCapabilitiesResource, RuntimeEnv, type RuntimeEnvListParams, type RuntimeEnvScope, type RuntimeEnvSetParams, type RuntimeEnvTarget, type RuntimeEnvVar, type RuntimeInstanceData, type RuntimeInstanceId, type RuntimeInstanceState, type RuntimeLogsResult, SANDBOX_TEMPLATE, Sandbox, SandboxArtifacts, 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 TemplateBuildCreateParams, type TemplateCreateParams, type TemplateData, 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, createAgentBuildOutputContract, createAgentBuildPrompt, createBuildAgentRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };

package/dist/index.js

@@ -1047,6 +1047,11 @@ var AgentRuns = class {
       timeout: params.timeout,
       wait: params.wait,
       env: params.env,
+      output_format: params.outputFormat ?? params.output_format,
+      resume_session_id: params.resumeSessionId ?? params.resume_session_id,
+      json: params.json,
+      output_schema: params.outputSchema ?? params.output_schema,
+      image: params.image,
       agent_runtime_profile_id: params.agentRuntimeProfileId,
       agent_profile_id: params.agentProfileId,
       agent_run_group_id: params.agentRunGroupId,
@@ -2684,6 +2689,18 @@ var Desktop = class {
       button
     });
   }
+  /** Explicit left-button click. Alias for click(x, y, "left"). */
+  async leftClick(x, y) {
+    return this.click(x, y, "left");
+  }
+  /** Right-button click. Alias for click(x, y, "right"). */
+  async rightClick(x, y) {
+    return this.click(x, y, "right");
+  }
+  /** Middle-button click. Alias for click(x, y, "middle"). */
+  async middleClick(x, y) {
+    return this.click(x, y, "middle");
+  }
   /** Double-click at the given coordinates. */
   async doubleClick(x, y) {
     const params = { x, y };
@@ -2692,16 +2709,28 @@ var Desktop = class {
       params
     );
   }
+  /** Move the mouse pointer without clicking. */
+  async moveMouse(x, y) {
+    return this.http.post(`${this.base()}/move`, { x, y });
+  }
   /** Type text into the currently focused element. */
   async type(text, delay) {
     const params = { text, ...delay !== void 0 && { delay } };
     return this.http.post(`${this.base()}/type`, params);
   }
+  /** Alias for `type(text)` used by simple computer-control loops. */
+  async write(text, delay) {
+    return this.type(text, delay);
+  }
   /** Send a key or key combination (e.g. "Enter", "ctrl+c"). */
   async key(key) {
     const params = { key };
     return this.http.post(`${this.base()}/key`, params);
   }
+  /** Alias for `key(key)` used by simple computer-control loops. */
+  async press(key) {
+    return this.key(key);
+  }
   /** Scroll in a direction at an optional position. */
   async scroll(direction, clicks = 3, x, y) {
     const params = {
@@ -4099,6 +4128,24 @@ var Computer = class _Computer {
     this.data = await this.http.get(`/computers/${this.id}`);
     return this;
   }
+  /**
+   * Run an AI agent inside this Computer.
+   *
+   * The Computer is the graphical desktop VM product. This dispatches the
+   * same Agent Runs API as `miosa agent run --computer`, scoped to this VM.
+   */
+  async prompt(instruction, options = {}) {
+    return new AgentRuns(this.http).run({
+      ...options,
+      prompt: instruction,
+      targetKind: "computer",
+      targetId: this.id,
+      computerId: this.id,
+      provider: options.provider ?? "claude",
+      cwd: options.cwd ?? "/workspace",
+      wait: options.wait ?? true
+    });
+  }
   // ─── Desktop shortcuts ─────────────────────────────────────────────────────
   /**
    * Capture a desktop screenshot as PNG bytes.
@@ -4138,6 +4185,14 @@ var Computer = class _Computer {
   async doubleClick(x, y) {
     await this.desktop.doubleClick(x, y);
   }
+  /** Middle-button click. */
+  async middleClick(x, y) {
+    await this.desktop.click(x, y, "middle");
+  }
+  /** Move the pointer without clicking. */
+  async moveMouse(x, y) {
+    await this.desktop.moveMouse(x, y);
+  }
   /**
    * Type text into the focused element.
    * Shortcut for `computer.desktop.type(text)`.
@@ -4145,6 +4200,10 @@ var Computer = class _Computer {
   async type(text) {
     await this.desktop.type(text);
   }
+  /** Alias for `type(text)`. */
+  async write(text) {
+    await this.desktop.write(text);
+  }
   /**
    * Send a key or key combo.
    * Shortcut for `computer.desktop.key(key)`.
@@ -4152,6 +4211,10 @@ var Computer = class _Computer {
   async key(key) {
     await this.desktop.key(key);
   }
+  /** Alias for `key(key)`. */
+  async press(key) {
+    await this.desktop.press(key);
+  }
   /**
    * Scroll in a direction.
    * Shortcut for `computer.desktop.scroll(direction, clicks)`.
@@ -4267,6 +4330,17 @@ var Computer = class _Computer {
       await this.http.post(`/computers/${this.id}/stream-token`)
     );
   }
+  /**
+   * Mint a passwordless browser embed URL for authenticated platform sessions.
+   *
+   * Use this inside MIOSA or tenant apps. Raw shared desktop URLs can still use
+   * the viewer password flow when opened outside an authenticated platform.
+   */
+  async embed() {
+    return unwrapData(
+      await this.http.get(`/computers/${this.id}/embed`)
+    );
+  }
   /** Clone this computer into a new one. */
   async clone(opts = {}) {
     const body4 = Object.fromEntries(
@@ -7039,6 +7113,11 @@ var Regions = class {
     const data = await this.http.get("/compute/regions");
     return listItems10(data);
   }
+  /** Get canonical compute catalog, including product templates and readiness. */
+  async catalog() {
+    const data = await this.http.get("/compute/catalog");
+    return unwrap41(data);
+  }
   /** List available compute sizes. */
   async listSizes() {
     const data = await this.http.get("/compute/sizes");
@@ -7426,6 +7505,15 @@ var SandboxEvents = class {
     return this.sandbox.http.stream(`/sandboxes/${this.sandbox.id}/events`);
   }
 };
+var SandboxMetrics = class {
+  constructor(sandbox) {
+    this.sandbox = sandbox;
+  }
+  sandbox;
+  get(window2 = "1h") {
+    return this.sandbox.metrics(window2);
+  }
+};
 var SandboxPreviews = class {
   constructor(sandbox) {
     this.sandbox = sandbox;
@@ -7566,6 +7654,7 @@ var Sandbox = class _Sandbox {
     this.snapshots = new SandboxSnapshots(this);
     this.terminal = new SandboxTerminal(this);
     this.events = new SandboxEvents(this);
+    this.metricsResource = new SandboxMetrics(this);
     this.previews = new SandboxPreviews(this);
     this.env = new SandboxEnv(this);
     this.tags = new SandboxTags(this);
@@ -7588,6 +7677,8 @@ var Sandbox = class _Sandbox {
   terminal;
   /** SSE event stream. */
   events;
+  /** Operational metrics and current resource state. */
+  metricsResource;
   /** Preview CRUD + share/revokeShare. */
   previews;
   /** Read-only env var listing. */
@@ -7620,6 +7711,24 @@ var Sandbox = class _Sandbox {
     );
     return this;
   }
+  /**
+   * Run an AI coding agent inside this Sandbox.
+   *
+   * Defaults to Claude Code, waits for completion, and runs from `/workspace`.
+   * Pass `{ provider: "codex", env: { CODEX_API_KEY } }` to run Codex.
+   */
+  async prompt(instruction, options = {}) {
+    return new AgentRuns(this.http).run({
+      ...options,
+      prompt: instruction,
+      targetKind: "sandbox",
+      targetId: this.id,
+      sandboxId: this.id,
+      provider: options.provider ?? "claude",
+      cwd: options.cwd ?? "/workspace",
+      wait: options.wait ?? true
+    });
+  }
   async runExec(command, options) {
     this.assertRunning("exec");
     const response = unwrap44(
@@ -7712,6 +7821,14 @@ var Sandbox = class _Sandbox {
   async expose(port) {
     return (await this.exposeInfo(port)).url;
   }
+  async getUrl(port, path = "/") {
+    const url = new URL((await this.exposeInfo(port)).url);
+    url.pathname = path.startsWith("/") ? path : `/${path}`;
+    return url.toString();
+  }
+  async getHost(port) {
+    return new URL((await this.exposeInfo(port)).url).host;
+  }
   async exposeInfo(port) {
     this.assertRunning("expose");
     const response = unwrap44(
@@ -7750,6 +7867,17 @@ var Sandbox = class _Sandbox {
       `/sandboxes/${this.id}/logs/stream`
     );
   }
+  async metrics(window2 = "1h") {
+    return unwrap44(
+      await this.http.get(
+        `/sandboxes/${this.id}/metrics`,
+        { window: window2 }
+      )
+    );
+  }
+  async getMetrics(window2 = "1h") {
+    return this.metrics(window2);
+  }
   async createSnapshot(comment) {
     this.assertRunning("snapshots.create");
     return unwrap44(
@@ -8833,6 +8961,39 @@ var Volumes = class {
   async delete(volumeId) {
     await this.http.delete(`/volumes/${volumeId}`);
   }
+  async listAttachments(computerId) {
+    const data = await this.http.get(`/computers/${computerId}/volumes`);
+    return listItems15(data, [
+      "data",
+      "attachments",
+      "volumes",
+      "items"
+    ]);
+  }
+  async attach(computerId, params) {
+    const volumeId = params.volumeId ?? params.volume_id;
+    const mountPath = params.mountPath ?? params.mount_path;
+    const readOnly = params.readOnly ?? params.read_only;
+    const body4 = stripUndefined30({
+      ...params,
+      volumeId: void 0,
+      mountPath: void 0,
+      readOnly: void 0,
+      volume_id: volumeId,
+      mount_path: mountPath,
+      read_only: readOnly
+    });
+    const data = await this.http.post(
+      `/computers/${computerId}/volumes`,
+      body4
+    );
+    return unwrap51(data);
+  }
+  async detach(computerId, attachmentId) {
+    await this.http.delete(
+      `/computers/${computerId}/volumes/${attachmentId}`
+    );
+  }
 };
 function unwrap52(payload) {
   if (payload && typeof payload === "object" && "data" in payload) {
@@ -9540,7 +9701,7 @@ function createAgentBuildExecutionPacket(params) {
     quality_rules: params.qualityRules ?? [],
     output_contract: outputContract,
     runtime_instructions: {
-      agent: "claude-code",
+      agent: "claude",
       template: runtimeTemplate,
       input_materialization: {
         directory: DEFAULT_AGENT_BUILD_INPUT_ROOT,
@@ -9590,7 +9751,7 @@ function createBuildAgentRunParams(params) {
     targetId: params.targetId,
     sandboxId: params.sandboxId,
     computerId: params.computerId,
-    provider: params.provider ?? "claude-code",
+    provider: params.provider ?? "claude",
     model: params.model,
     cwd: params.cwd ?? "/workspace",
     timeout: params.timeout ?? 1800,