@miosa/sdk 1.2.25 → 1.2.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -253,6 +253,19 @@ interface AgentRunCreateParams {
253
253
  timeout?: number;
254
254
  wait?: boolean;
255
255
  env?: Record<string, string>;
256
+ /** Claude Code: `--output-format`, e.g. "json" or "stream-json". */
257
+ outputFormat?: "text" | "json" | "stream-json" | string;
258
+ output_format?: "text" | "json" | "stream-json" | string;
259
+ /** Claude Code: `--resume <session_id>`. */
260
+ resumeSessionId?: string;
261
+ resume_session_id?: string;
262
+ /** Codex: pass `--json` for JSONL event output. */
263
+ json?: boolean;
264
+ /** Codex: path to a JSON Schema file inside the runtime. */
265
+ outputSchema?: string;
266
+ output_schema?: string;
267
+ /** Codex: path to an image file inside the runtime. */
268
+ image?: string;
256
269
  agentRuntimeProfileId?: string;
257
270
  agentProfileId?: string;
258
271
  agentRunGroupId?: string;
@@ -2339,12 +2352,24 @@ declare class Desktop$1 {
2339
2352
  screenshot(): Promise<Uint8Array>;
2340
2353
  /** Click at the given coordinates. */
2341
2354
  click(x: number, y: number, button?: ClickParams["button"]): Promise<DesktopActionResult>;
2355
+ /** Explicit left-button click. Alias for click(x, y, "left"). */
2356
+ leftClick(x: number, y: number): Promise<DesktopActionResult>;
2357
+ /** Right-button click. Alias for click(x, y, "right"). */
2358
+ rightClick(x: number, y: number): Promise<DesktopActionResult>;
2359
+ /** Middle-button click. Alias for click(x, y, "middle"). */
2360
+ middleClick(x: number, y: number): Promise<DesktopActionResult>;
2342
2361
  /** Double-click at the given coordinates. */
2343
2362
  doubleClick(x: number, y: number): Promise<DesktopActionResult>;
2363
+ /** Move the mouse pointer without clicking. */
2364
+ moveMouse(x: number, y: number): Promise<DesktopActionResult>;
2344
2365
  /** Type text into the currently focused element. */
2345
2366
  type(text: string, delay?: number): Promise<DesktopActionResult>;
2367
+ /** Alias for `type(text)` used by simple computer-control loops. */
2368
+ write(text: string, delay?: number): Promise<DesktopActionResult>;
2346
2369
  /** Send a key or key combination (e.g. "Enter", "ctrl+c"). */
2347
2370
  key(key: string): Promise<DesktopActionResult>;
2371
+ /** Alias for `key(key)` used by simple computer-control loops. */
2372
+ press(key: string): Promise<DesktopActionResult>;
2348
2373
  /** Scroll in a direction at an optional position. */
2349
2374
  scroll(direction: ScrollParams["direction"], clicks?: number, x?: number, y?: number): Promise<DesktopActionResult>;
2350
2375
  /** Click and drag from one coordinate to another. */
@@ -3236,16 +3261,24 @@ declare class Computer {
3236
3261
  rightClick(x: number, y: number): Promise<void>;
3237
3262
  /** Double-click at the given coordinates. */
3238
3263
  doubleClick(x: number, y: number): Promise<void>;
3264
+ /** Middle-button click. */
3265
+ middleClick(x: number, y: number): Promise<void>;
3266
+ /** Move the pointer without clicking. */
3267
+ moveMouse(x: number, y: number): Promise<void>;
3239
3268
  /**
3240
3269
  * Type text into the focused element.
3241
3270
  * Shortcut for `computer.desktop.type(text)`.
3242
3271
  */
3243
3272
  type(text: string): Promise<void>;
3273
+ /** Alias for `type(text)`. */
3274
+ write(text: string): Promise<void>;
3244
3275
  /**
3245
3276
  * Send a key or key combo.
3246
3277
  * Shortcut for `computer.desktop.key(key)`.
3247
3278
  */
3248
3279
  key(key: string): Promise<void>;
3280
+ /** Alias for `key(key)`. */
3281
+ press(key: string): Promise<void>;
3249
3282
  /**
3250
3283
  * Scroll in a direction.
3251
3284
  * Shortcut for `computer.desktop.scroll(direction, clicks)`.
@@ -3313,6 +3346,13 @@ declare class Computer {
3313
3346
  urls(): Promise<Record<string, unknown>>;
3314
3347
  /** Mint a short-lived stream token for this computer. */
3315
3348
  streamToken(): Promise<Record<string, unknown>>;
3349
+ /**
3350
+ * Mint a passwordless browser embed URL for authenticated platform sessions.
3351
+ *
3352
+ * Use this inside MIOSA or tenant apps. Raw shared desktop URLs can still use
3353
+ * the viewer password flow when opened outside an authenticated platform.
3354
+ */
3355
+ embed(): Promise<Record<string, unknown>>;
3316
3356
  /** Clone this computer into a new one. */
3317
3357
  clone(opts?: Record<string, unknown>): Promise<Computer>;
3318
3358
  /** Resize the computer (change CPU/memory/disk). */
@@ -5649,11 +5689,20 @@ interface TemplateData {
5649
5689
  slug?: string;
5650
5690
  [key: string]: unknown;
5651
5691
  }
5692
+ interface ComputeCatalogData {
5693
+ products?: Array<Record<string, unknown>>;
5694
+ regions?: Array<Record<string, unknown>>;
5695
+ sizes?: Array<Record<string, unknown>>;
5696
+ templates?: Array<Record<string, unknown>>;
5697
+ [key: string]: unknown;
5698
+ }
5652
5699
  declare class Regions {
5653
5700
  private readonly http;
5654
5701
  constructor(http: HttpClient);
5655
5702
  /** List datacenter regions. */
5656
5703
  listRegions(): Promise<RegionData[]>;
5704
+ /** Get canonical compute catalog, including product templates and readiness. */
5705
+ catalog(): Promise<ComputeCatalogData>;
5657
5706
  /** List available compute sizes. */
5658
5707
  listSizes(): Promise<SizeData[]>;
5659
5708
  /** Get static compute pricing data. */
@@ -6159,6 +6208,11 @@ declare class SandboxEvents {
6159
6208
  /** Stream live sandbox events via SSE. */
6160
6209
  stream(): AsyncIterableIterator<Record<string, unknown>>;
6161
6210
  }
6211
+ declare class SandboxMetrics {
6212
+ private readonly sandbox;
6213
+ constructor(sandbox: Sandbox);
6214
+ get(window?: string): Promise<Record<string, unknown>>;
6215
+ }
6162
6216
  declare class SandboxPreviews {
6163
6217
  private readonly sandbox;
6164
6218
  constructor(sandbox: Sandbox);
@@ -6212,6 +6266,8 @@ declare class Sandbox {
6212
6266
  readonly terminal: SandboxTerminal;
6213
6267
  /** SSE event stream. */
6214
6268
  readonly events: SandboxEvents;
6269
+ /** Operational metrics and current resource state. */
6270
+ readonly metricsResource: SandboxMetrics;
6215
6271
  /** Preview CRUD + share/revokeShare. */
6216
6272
  readonly previews: SandboxPreviews;
6217
6273
  /** Read-only env var listing. */
@@ -6251,11 +6307,15 @@ declare class Sandbox {
6251
6307
  listFiles(path?: string): Promise<SandboxFileList>;
6252
6308
  statFile(path: string): Promise<SandboxFileStat>;
6253
6309
  expose(port?: number): Promise<string>;
6310
+ getUrl(port?: number, path?: string): Promise<string>;
6311
+ getHost(port?: number): Promise<string>;
6254
6312
  exposeInfo(port?: number): Promise<PreviewUrlInfo>;
6255
6313
  startTemplate(options?: Record<string, unknown>): Promise<Record<string, unknown>>;
6256
6314
  getArtifacts(): Promise<Record<string, unknown>>;
6257
6315
  getLogs(lines?: number): Promise<string | Record<string, unknown>>;
6258
6316
  streamLogs(): AsyncIterableIterator<Record<string, unknown>>;
6317
+ metrics(window?: string): Promise<Record<string, unknown>>;
6318
+ getMetrics(window?: string): Promise<Record<string, unknown>>;
6259
6319
  createSnapshot(comment?: string): Promise<SandboxSnapshot>;
6260
6320
  listSnapshots(): Promise<SandboxSnapshot[]>;
6261
6321
  restoreSnapshot(snapshotId: string): Promise<Sandbox>;
@@ -6783,6 +6843,104 @@ declare class Tenant {
6783
6843
  deleteBranding(): Promise<void>;
6784
6844
  }
6785
6845
 
6846
+ /**
6847
+ * Product-aware template catalog.
6848
+ *
6849
+ * This is different from `sandboxTemplates`, which manages tenant-owned
6850
+ * sandbox template build records. `templates` is the canonical discovery
6851
+ * surface for product/template/size/readiness primitives across sandboxes,
6852
+ * computers, and appliances.
6853
+ */
6854
+
6855
+ type ComputeProduct = "sandbox" | "computer" | "docker_deploy_host" | "managed_database" | "deployment";
6856
+ type TemplateReadinessState = "fast_ready" | "cold_boot_only" | "missing" | "partial_fast_ready" | "unavailable";
6857
+ interface TemplateSizeReadiness {
6858
+ size: string;
6859
+ state: TemplateReadinessState | string;
6860
+ fast_ready?: boolean;
6861
+ cold_boot_only?: boolean;
6862
+ readiness_scope?: string;
6863
+ checked_nodes?: number;
6864
+ ready_nodes?: number;
6865
+ cold_boot_nodes?: number;
6866
+ missing_nodes?: number;
6867
+ unavailable_nodes?: number;
6868
+ [key: string]: unknown;
6869
+ }
6870
+ interface TemplateBenchmarkLane {
6871
+ id: string;
6872
+ name?: string;
6873
+ command?: string;
6874
+ purpose?: string;
6875
+ [key: string]: unknown;
6876
+ }
6877
+ interface TemplateReadinessContract {
6878
+ exec_ready?: boolean;
6879
+ preview_ready?: boolean;
6880
+ desktop_ready?: boolean;
6881
+ app_ready?: boolean;
6882
+ benchmark_command?: string;
6883
+ start_command?: string | null;
6884
+ readiness_probe?: Record<string, unknown> | null;
6885
+ [key: string]: unknown;
6886
+ }
6887
+ interface ProductTemplate {
6888
+ id: string;
6889
+ name: string;
6890
+ product: ComputeProduct | string;
6891
+ primitive?: "template" | string;
6892
+ default_size?: string;
6893
+ image_id?: string;
6894
+ description?: string | null;
6895
+ sdk_name?: string;
6896
+ cli_name?: string;
6897
+ installed_tools?: string[];
6898
+ install_command?: string | null;
6899
+ start_command?: string | null;
6900
+ readiness_probe?: Record<string, unknown> | null;
6901
+ readiness_contract?: TemplateReadinessContract;
6902
+ benchmark_lane?: TemplateBenchmarkLane;
6903
+ aliases?: string[];
6904
+ sizes?: TemplateSizeReadiness[];
6905
+ readiness?: TemplateReadinessState | string;
6906
+ [key: string]: unknown;
6907
+ }
6908
+ interface ProductCatalogEntry {
6909
+ id: ComputeProduct | string;
6910
+ name: string;
6911
+ primitive?: "product" | string;
6912
+ description?: string;
6913
+ default_template?: string;
6914
+ default_size?: string;
6915
+ templates?: ProductTemplate[];
6916
+ size_ids?: string[];
6917
+ [key: string]: unknown;
6918
+ }
6919
+ interface TemplatesListParams {
6920
+ product?: ComputeProduct | string;
6921
+ }
6922
+ interface ProductTemplateCatalog {
6923
+ templates: ProductTemplate[];
6924
+ products?: ProductCatalogEntry[];
6925
+ sizes?: Array<Record<string, unknown>>;
6926
+ readiness_states?: string[];
6927
+ rules?: Record<string, unknown>;
6928
+ [key: string]: unknown;
6929
+ }
6930
+ declare class Templates {
6931
+ private readonly http;
6932
+ constructor(http: HttpClient);
6933
+ /**
6934
+ * List product-aware templates across sandbox, computer, and appliance.
6935
+ *
6936
+ * Use `sandboxTemplates` for tenant-owned sandbox template CRUD/builds.
6937
+ */
6938
+ list(params?: TemplatesListParams): Promise<ProductTemplate[]>;
6939
+ catalog(): Promise<ProductTemplateCatalog>;
6940
+ get(templateId: string, params?: TemplatesListParams): Promise<ProductTemplate>;
6941
+ readiness(templateId: string, params?: TemplatesListParams): Promise<TemplateSizeReadiness[]>;
6942
+ }
6943
+
6786
6944
  /**
6787
6945
  * Usage — per-session metering, summary, and reports.
6788
6946
  */
@@ -6855,6 +7013,26 @@ interface VolumeCreateParams {
6855
7013
  idempotencyKey?: string;
6856
7014
  [key: string]: unknown;
6857
7015
  }
7016
+ interface VolumeAttachmentData {
7017
+ id: string;
7018
+ volume_id: string;
7019
+ computer_id: string;
7020
+ mount_path: string;
7021
+ read_only?: boolean;
7022
+ state?: string;
7023
+ created_at?: string;
7024
+ updated_at?: string;
7025
+ [key: string]: unknown;
7026
+ }
7027
+ interface VolumeAttachParams {
7028
+ volumeId?: string;
7029
+ volume_id?: string;
7030
+ mountPath?: string;
7031
+ mount_path?: string;
7032
+ readOnly?: boolean;
7033
+ read_only?: boolean;
7034
+ [key: string]: unknown;
7035
+ }
6858
7036
  declare class Volumes {
6859
7037
  private readonly http;
6860
7038
  constructor(http: HttpClient);
@@ -6862,6 +7040,9 @@ declare class Volumes {
6862
7040
  get(volumeId: string): Promise<VolumeData>;
6863
7041
  create(params: VolumeCreateParams): Promise<VolumeData>;
6864
7042
  delete(volumeId: string): Promise<void>;
7043
+ listAttachments(computerId: string): Promise<VolumeAttachmentData[]>;
7044
+ attach(computerId: string, params: VolumeAttachParams): Promise<VolumeAttachmentData>;
7045
+ detach(computerId: string, attachmentId: string): Promise<void>;
6865
7046
  }
6866
7047
 
6867
7048
  /**
@@ -7260,6 +7441,8 @@ declare class Miosa {
7260
7441
  readonly webhooks: Webhooks;
7261
7442
  /** Sandbox templates — CRUD, build-spec schema, builds. */
7262
7443
  readonly sandboxTemplates: SandboxTemplates;
7444
+ /** Product-aware templates — catalog/readiness for sandbox, computer, appliance. */
7445
+ readonly templates: Templates;
7263
7446
  /** API key management — list, create, delete. */
7264
7447
  readonly apiKeys: ApiKeys;
7265
7448
  /** Available LLM models via the intelligence gateway. */
@@ -7571,4 +7754,4 @@ declare class TokenRefreshFailedError extends MiosaError {
7571
7754
  constructor(message: string, status?: number, details?: unknown, requestId?: string);
7572
7755
  }
7573
7756
 
7574
- 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 SandboxExecOptions, type SandboxExecResult, SandboxFiles, type SandboxGetOrCreateParams, type SandboxId, type SandboxListParams, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, type SandboxState, SandboxTags, type SandboxTemplate, type SandboxTemplateBuild, type SandboxTemplateBuildCreateParams, type SandboxTemplateBuildResourceData, type SandboxTemplateBuildResourceId, type SandboxTemplateCreateParams, type SandboxTemplateList, type SandboxTemplateListParams, type SandboxTemplateResourceData, type SandboxTemplateResourceId, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, type ScrollDirection, type ScrollParams, type SecretCreateParams, type SecretData, type SecretId, type SecretListParams, type SecretRotateParams, type SecretSetParams, type SecretUpdateParams, type SessionId, Settings, type SettingsUpdateParams, type SizeData, type SlackSendTestParams, type SnapshotCreateParams, type SnapshotData, type SnapshotListResponse, type SnapshotProgressEvent, type SnapshotRestoreResult, type SnapshotStatus, SnapshotsStandalone, Storage, type StorageObjectData, SubjectNotAllowedError, type SuggestionsParams, type 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 };
7757
+ 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, 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 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, 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 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 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, createAgentBuildOutputContract, createAgentBuildPrompt, createBuildAgentRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
package/dist/index.js CHANGED
@@ -1047,6 +1047,11 @@ var AgentRuns = class {
1047
1047
  timeout: params.timeout,
1048
1048
  wait: params.wait,
1049
1049
  env: params.env,
1050
+ output_format: params.outputFormat ?? params.output_format,
1051
+ resume_session_id: params.resumeSessionId ?? params.resume_session_id,
1052
+ json: params.json,
1053
+ output_schema: params.outputSchema ?? params.output_schema,
1054
+ image: params.image,
1050
1055
  agent_runtime_profile_id: params.agentRuntimeProfileId,
1051
1056
  agent_profile_id: params.agentProfileId,
1052
1057
  agent_run_group_id: params.agentRunGroupId,
@@ -2684,6 +2689,18 @@ var Desktop = class {
2684
2689
  button
2685
2690
  });
2686
2691
  }
2692
+ /** Explicit left-button click. Alias for click(x, y, "left"). */
2693
+ async leftClick(x, y) {
2694
+ return this.click(x, y, "left");
2695
+ }
2696
+ /** Right-button click. Alias for click(x, y, "right"). */
2697
+ async rightClick(x, y) {
2698
+ return this.click(x, y, "right");
2699
+ }
2700
+ /** Middle-button click. Alias for click(x, y, "middle"). */
2701
+ async middleClick(x, y) {
2702
+ return this.click(x, y, "middle");
2703
+ }
2687
2704
  /** Double-click at the given coordinates. */
2688
2705
  async doubleClick(x, y) {
2689
2706
  const params = { x, y };
@@ -2692,16 +2709,28 @@ var Desktop = class {
2692
2709
  params
2693
2710
  );
2694
2711
  }
2712
+ /** Move the mouse pointer without clicking. */
2713
+ async moveMouse(x, y) {
2714
+ return this.http.post(`${this.base()}/move`, { x, y });
2715
+ }
2695
2716
  /** Type text into the currently focused element. */
2696
2717
  async type(text, delay) {
2697
2718
  const params = { text, ...delay !== void 0 && { delay } };
2698
2719
  return this.http.post(`${this.base()}/type`, params);
2699
2720
  }
2721
+ /** Alias for `type(text)` used by simple computer-control loops. */
2722
+ async write(text, delay) {
2723
+ return this.type(text, delay);
2724
+ }
2700
2725
  /** Send a key or key combination (e.g. "Enter", "ctrl+c"). */
2701
2726
  async key(key) {
2702
2727
  const params = { key };
2703
2728
  return this.http.post(`${this.base()}/key`, params);
2704
2729
  }
2730
+ /** Alias for `key(key)` used by simple computer-control loops. */
2731
+ async press(key) {
2732
+ return this.key(key);
2733
+ }
2705
2734
  /** Scroll in a direction at an optional position. */
2706
2735
  async scroll(direction, clicks = 3, x, y) {
2707
2736
  const params = {
@@ -4156,6 +4185,14 @@ var Computer = class _Computer {
4156
4185
  async doubleClick(x, y) {
4157
4186
  await this.desktop.doubleClick(x, y);
4158
4187
  }
4188
+ /** Middle-button click. */
4189
+ async middleClick(x, y) {
4190
+ await this.desktop.click(x, y, "middle");
4191
+ }
4192
+ /** Move the pointer without clicking. */
4193
+ async moveMouse(x, y) {
4194
+ await this.desktop.moveMouse(x, y);
4195
+ }
4159
4196
  /**
4160
4197
  * Type text into the focused element.
4161
4198
  * Shortcut for `computer.desktop.type(text)`.
@@ -4163,6 +4200,10 @@ var Computer = class _Computer {
4163
4200
  async type(text) {
4164
4201
  await this.desktop.type(text);
4165
4202
  }
4203
+ /** Alias for `type(text)`. */
4204
+ async write(text) {
4205
+ await this.desktop.write(text);
4206
+ }
4166
4207
  /**
4167
4208
  * Send a key or key combo.
4168
4209
  * Shortcut for `computer.desktop.key(key)`.
@@ -4170,6 +4211,10 @@ var Computer = class _Computer {
4170
4211
  async key(key) {
4171
4212
  await this.desktop.key(key);
4172
4213
  }
4214
+ /** Alias for `key(key)`. */
4215
+ async press(key) {
4216
+ await this.desktop.press(key);
4217
+ }
4173
4218
  /**
4174
4219
  * Scroll in a direction.
4175
4220
  * Shortcut for `computer.desktop.scroll(direction, clicks)`.
@@ -4285,6 +4330,17 @@ var Computer = class _Computer {
4285
4330
  await this.http.post(`/computers/${this.id}/stream-token`)
4286
4331
  );
4287
4332
  }
4333
+ /**
4334
+ * Mint a passwordless browser embed URL for authenticated platform sessions.
4335
+ *
4336
+ * Use this inside MIOSA or tenant apps. Raw shared desktop URLs can still use
4337
+ * the viewer password flow when opened outside an authenticated platform.
4338
+ */
4339
+ async embed() {
4340
+ return unwrapData(
4341
+ await this.http.get(`/computers/${this.id}/embed`)
4342
+ );
4343
+ }
4288
4344
  /** Clone this computer into a new one. */
4289
4345
  async clone(opts = {}) {
4290
4346
  const body4 = Object.fromEntries(
@@ -7057,6 +7113,11 @@ var Regions = class {
7057
7113
  const data = await this.http.get("/compute/regions");
7058
7114
  return listItems10(data);
7059
7115
  }
7116
+ /** Get canonical compute catalog, including product templates and readiness. */
7117
+ async catalog() {
7118
+ const data = await this.http.get("/compute/catalog");
7119
+ return unwrap41(data);
7120
+ }
7060
7121
  /** List available compute sizes. */
7061
7122
  async listSizes() {
7062
7123
  const data = await this.http.get("/compute/sizes");
@@ -7444,6 +7505,15 @@ var SandboxEvents = class {
7444
7505
  return this.sandbox.http.stream(`/sandboxes/${this.sandbox.id}/events`);
7445
7506
  }
7446
7507
  };
7508
+ var SandboxMetrics = class {
7509
+ constructor(sandbox) {
7510
+ this.sandbox = sandbox;
7511
+ }
7512
+ sandbox;
7513
+ get(window2 = "1h") {
7514
+ return this.sandbox.metrics(window2);
7515
+ }
7516
+ };
7447
7517
  var SandboxPreviews = class {
7448
7518
  constructor(sandbox) {
7449
7519
  this.sandbox = sandbox;
@@ -7584,6 +7654,7 @@ var Sandbox = class _Sandbox {
7584
7654
  this.snapshots = new SandboxSnapshots(this);
7585
7655
  this.terminal = new SandboxTerminal(this);
7586
7656
  this.events = new SandboxEvents(this);
7657
+ this.metricsResource = new SandboxMetrics(this);
7587
7658
  this.previews = new SandboxPreviews(this);
7588
7659
  this.env = new SandboxEnv(this);
7589
7660
  this.tags = new SandboxTags(this);
@@ -7606,6 +7677,8 @@ var Sandbox = class _Sandbox {
7606
7677
  terminal;
7607
7678
  /** SSE event stream. */
7608
7679
  events;
7680
+ /** Operational metrics and current resource state. */
7681
+ metricsResource;
7609
7682
  /** Preview CRUD + share/revokeShare. */
7610
7683
  previews;
7611
7684
  /** Read-only env var listing. */
@@ -7748,6 +7821,14 @@ var Sandbox = class _Sandbox {
7748
7821
  async expose(port) {
7749
7822
  return (await this.exposeInfo(port)).url;
7750
7823
  }
7824
+ async getUrl(port, path = "/") {
7825
+ const url = new URL((await this.exposeInfo(port)).url);
7826
+ url.pathname = path.startsWith("/") ? path : `/${path}`;
7827
+ return url.toString();
7828
+ }
7829
+ async getHost(port) {
7830
+ return new URL((await this.exposeInfo(port)).url).host;
7831
+ }
7751
7832
  async exposeInfo(port) {
7752
7833
  this.assertRunning("expose");
7753
7834
  const response = unwrap44(
@@ -7786,6 +7867,17 @@ var Sandbox = class _Sandbox {
7786
7867
  `/sandboxes/${this.id}/logs/stream`
7787
7868
  );
7788
7869
  }
7870
+ async metrics(window2 = "1h") {
7871
+ return unwrap44(
7872
+ await this.http.get(
7873
+ `/sandboxes/${this.id}/metrics`,
7874
+ { window: window2 }
7875
+ )
7876
+ );
7877
+ }
7878
+ async getMetrics(window2 = "1h") {
7879
+ return this.metrics(window2);
7880
+ }
7789
7881
  async createSnapshot(comment) {
7790
7882
  this.assertRunning("snapshots.create");
7791
7883
  return unwrap44(
@@ -8775,6 +8867,50 @@ var Tenant = class {
8775
8867
  }
8776
8868
  };
8777
8869
 
8870
+ // src/resources/templates.ts
8871
+ function unwrapCatalog(payload) {
8872
+ if (!payload || typeof payload !== "object") return { templates: [] };
8873
+ const data = "data" in payload && typeof payload.data === "object" ? payload.data : payload;
8874
+ const templates = Array.isArray(data.templates) ? data.templates : [];
8875
+ return {
8876
+ ...data,
8877
+ templates
8878
+ };
8879
+ }
8880
+ var Templates = class {
8881
+ constructor(http) {
8882
+ this.http = http;
8883
+ }
8884
+ http;
8885
+ /**
8886
+ * List product-aware templates across sandbox, computer, and appliance.
8887
+ *
8888
+ * Use `sandboxTemplates` for tenant-owned sandbox template CRUD/builds.
8889
+ */
8890
+ async list(params = {}) {
8891
+ const data = await this.http.get("/templates");
8892
+ const catalog = unwrapCatalog(data);
8893
+ if (!params.product) return catalog.templates;
8894
+ return catalog.templates.filter((template) => template.product === params.product);
8895
+ }
8896
+ async catalog() {
8897
+ const data = await this.http.get("/templates");
8898
+ return unwrapCatalog(data);
8899
+ }
8900
+ async get(templateId, params = {}) {
8901
+ const templates = await this.list(params);
8902
+ const match = templates.find((template) => template.id === templateId);
8903
+ if (!match) {
8904
+ throw new Error(`Template not found: ${templateId}`);
8905
+ }
8906
+ return match;
8907
+ }
8908
+ async readiness(templateId, params = {}) {
8909
+ const template = await this.get(templateId, params);
8910
+ return template.sizes ?? [];
8911
+ }
8912
+ };
8913
+
8778
8914
  // src/resources/usage.ts
8779
8915
  function unwrap50(payload) {
8780
8916
  if (payload && typeof payload === "object") {
@@ -8869,6 +9005,39 @@ var Volumes = class {
8869
9005
  async delete(volumeId) {
8870
9006
  await this.http.delete(`/volumes/${volumeId}`);
8871
9007
  }
9008
+ async listAttachments(computerId) {
9009
+ const data = await this.http.get(`/computers/${computerId}/volumes`);
9010
+ return listItems15(data, [
9011
+ "data",
9012
+ "attachments",
9013
+ "volumes",
9014
+ "items"
9015
+ ]);
9016
+ }
9017
+ async attach(computerId, params) {
9018
+ const volumeId = params.volumeId ?? params.volume_id;
9019
+ const mountPath = params.mountPath ?? params.mount_path;
9020
+ const readOnly = params.readOnly ?? params.read_only;
9021
+ const body4 = stripUndefined30({
9022
+ ...params,
9023
+ volumeId: void 0,
9024
+ mountPath: void 0,
9025
+ readOnly: void 0,
9026
+ volume_id: volumeId,
9027
+ mount_path: mountPath,
9028
+ read_only: readOnly
9029
+ });
9030
+ const data = await this.http.post(
9031
+ `/computers/${computerId}/volumes`,
9032
+ body4
9033
+ );
9034
+ return unwrap51(data);
9035
+ }
9036
+ async detach(computerId, attachmentId) {
9037
+ await this.http.delete(
9038
+ `/computers/${computerId}/volumes/${attachmentId}`
9039
+ );
9040
+ }
8872
9041
  };
8873
9042
  function unwrap52(payload) {
8874
9043
  if (payload && typeof payload === "object" && "data" in payload) {
@@ -9226,6 +9395,8 @@ var Miosa = class {
9226
9395
  webhooks;
9227
9396
  /** Sandbox templates — CRUD, build-spec schema, builds. */
9228
9397
  sandboxTemplates;
9398
+ /** Product-aware templates — catalog/readiness for sandbox, computer, appliance. */
9399
+ templates;
9229
9400
  /** API key management — list, create, delete. */
9230
9401
  apiKeys;
9231
9402
  // ── P3 / P4 resources ──────────────────────────────────────────────────────
@@ -9314,6 +9485,7 @@ var Miosa = class {
9314
9485
  this.healthChecks = new HealthChecks(this.http);
9315
9486
  this.webhooks = new Webhooks(this.http);
9316
9487
  this.sandboxTemplates = new SandboxTemplates(this.http);
9488
+ this.templates = new Templates(this.http);
9317
9489
  this.apiKeys = new ApiKeys(this.http);
9318
9490
  this.models = new Models(this.http);
9319
9491
  this.completions = new Completions(this.http);
@@ -9812,6 +9984,6 @@ var AppAuth = class {
9812
9984
  }
9813
9985
  };
9814
9986
 
9815
- export { AGENT_BUILD_KIND_SPECS, Admin, AgentRunGroups, AgentRuns, AgentRuntimeProfiles, Analytics, ApiKeys, AppAuth, AuditLog, AuthError, Benchmarks, BuilderSessions, Channels, Checkpoints, Cloud, CommandCenter, Community, Completions, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, ComputerEnv, ComputerInbox, ComputerLogs, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, ComputerTerminal, ComputerVolumes, Computers, Connectors, Credits, CronJobs, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, Databases, DeploymentConnectors, DeploymentDomains, DeploymentReleases, DeploymentRuntimeInstances, DeploymentVersions, Deployments, Desktop, Devices, DockerDeploy, EgressAudit, EgressHostNotAllowedError, EgressNetwork, EgressSecrets, Email, EmailCampaigns, EmailInbox, EmailTemplates, Embeddings, Exec, ExternalKeys, Files, FlatCustomDomains, Functions, HealthChecks, InstallationRequiredError, InsufficientCreditsError, Integrations, ManagedProviderBindingOnlyError, Mcp, Miosa, MiosaError, Models, NetworkError, NetworkPolicy, NotFoundError, OAuthFlow, OpenComputers, OrgInvites, ProjectAuth, ProjectIntegrations, ProjectNotLinkedError, ProviderDefaults, RateLimitError, Regions, RuntimeCapabilitiesResource, RuntimeEnv, SANDBOX_TEMPLATE, Sandbox, SandboxArtifacts, SandboxAudit, SandboxCommands, SandboxConnectors, SandboxEnv, SandboxEvents, SandboxFiles, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, SandboxTags, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, Settings, SnapshotsStandalone, Storage, SubjectNotAllowedError, Tenant, TimeoutError, TokenRefreshFailedError, Usage, UserAuthorizationRequiredError, ValidationError, Volumes, Webhooks, WorkspaceInvites, WorkspaceMembers, createAgentBuildExecutionPacket, createAgentBuildOutputContract, createAgentBuildPrompt, createBuildAgentRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
9987
+ export { AGENT_BUILD_KIND_SPECS, Admin, AgentRunGroups, AgentRuns, AgentRuntimeProfiles, Analytics, ApiKeys, AppAuth, AuditLog, AuthError, Benchmarks, BuilderSessions, Channels, Checkpoints, Cloud, CommandCenter, Community, Completions, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, ComputerEnv, ComputerInbox, ComputerLogs, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, ComputerTerminal, ComputerVolumes, Computers, Connectors, Credits, CronJobs, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, Databases, DeploymentConnectors, DeploymentDomains, DeploymentReleases, DeploymentRuntimeInstances, DeploymentVersions, Deployments, Desktop, Devices, DockerDeploy, EgressAudit, EgressHostNotAllowedError, EgressNetwork, EgressSecrets, Email, EmailCampaigns, EmailInbox, EmailTemplates, Embeddings, Exec, ExternalKeys, Files, FlatCustomDomains, Functions, HealthChecks, InstallationRequiredError, InsufficientCreditsError, Integrations, ManagedProviderBindingOnlyError, Mcp, Miosa, MiosaError, Models, NetworkError, NetworkPolicy, NotFoundError, OAuthFlow, OpenComputers, OrgInvites, ProjectAuth, ProjectIntegrations, ProjectNotLinkedError, ProviderDefaults, RateLimitError, Regions, RuntimeCapabilitiesResource, RuntimeEnv, SANDBOX_TEMPLATE, Sandbox, SandboxArtifacts, SandboxAudit, SandboxCommands, SandboxConnectors, SandboxEnv, SandboxEvents, SandboxFiles, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, SandboxTags, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, Settings, SnapshotsStandalone, Storage, SubjectNotAllowedError, Templates, Tenant, TimeoutError, TokenRefreshFailedError, Usage, UserAuthorizationRequiredError, ValidationError, Volumes, Webhooks, WorkspaceInvites, WorkspaceMembers, createAgentBuildExecutionPacket, createAgentBuildOutputContract, createAgentBuildPrompt, createBuildAgentRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
9816
9988
  //# sourceMappingURL=index.js.map
9817
9989
  //# sourceMappingURL=index.js.map