@miosa/sdk 1.2.25 → 1.2.27

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 = {
@@ -4156,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)`.
@@ -4163,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)`.
@@ -4170,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)`.
@@ -4285,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(
@@ -7057,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");
@@ -7250,6 +7311,7 @@ function createBody(params = {}) {
     timeout_sec: params.timeoutSec ?? params.timeout_sec ?? (persistent === true ? 86400 : void 0),
     idle_timeout_sec: params.idleTimeoutSec ?? params.idle_timeout_sec ?? (persistent === true ? 1800 : void 0),
     always_on: params.alwaysOn ?? params.always_on,
+    allow_provision: params.allowProvision ?? params.allow_provision,
     env: params.env,
     metadata: Object.keys(metadata).length > 0 ? metadata : void 0,
     services: params.services,
@@ -7444,6 +7506,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;
@@ -7584,6 +7655,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);
@@ -7606,6 +7678,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. */
@@ -7748,6 +7822,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(
@@ -7786,6 +7868,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(
@@ -7837,7 +7930,8 @@ var Sandbox = class _Sandbox {
   async update(params) {
     const snapshotExpirationSec = snapshotExpirationSeconds(params);
     const metadata = { ...params.metadata ?? {} };
-    if (params.persistent !== void 0) metadata.miosa_persistent = params.persistent;
+    if (params.persistent !== void 0)
+      metadata.miosa_persistent = params.persistent;
     if (snapshotExpirationSec !== void 0) {
       metadata.snapshot_expiration_sec = snapshotExpirationSec;
     }
@@ -8775,6 +8869,50 @@ var Tenant = class {
   }
 };
 
+// src/resources/templates.ts
+function unwrapCatalog(payload) {
+  if (!payload || typeof payload !== "object") return { templates: [] };
+  const data = "data" in payload && typeof payload.data === "object" ? payload.data : payload;
+  const templates = Array.isArray(data.templates) ? data.templates : [];
+  return {
+    ...data,
+    templates
+  };
+}
+var Templates = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List product-aware templates across sandbox, computer, and appliance.
+   *
+   * Use `sandboxTemplates` for tenant-owned sandbox template CRUD/builds.
+   */
+  async list(params = {}) {
+    const data = await this.http.get("/templates");
+    const catalog = unwrapCatalog(data);
+    if (!params.product) return catalog.templates;
+    return catalog.templates.filter((template) => template.product === params.product);
+  }
+  async catalog() {
+    const data = await this.http.get("/templates");
+    return unwrapCatalog(data);
+  }
+  async get(templateId, params = {}) {
+    const templates = await this.list(params);
+    const match = templates.find((template) => template.id === templateId);
+    if (!match) {
+      throw new Error(`Template not found: ${templateId}`);
+    }
+    return match;
+  }
+  async readiness(templateId, params = {}) {
+    const template = await this.get(templateId, params);
+    return template.sizes ?? [];
+  }
+};
+
 // src/resources/usage.ts
 function unwrap50(payload) {
   if (payload && typeof payload === "object") {
@@ -8869,6 +9007,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) {
@@ -9226,6 +9397,8 @@ var Miosa = class {
   webhooks;
   /** Sandbox templates — CRUD, build-spec schema, builds. */
   sandboxTemplates;
+  /** Product-aware templates — catalog/readiness for sandbox, computer, appliance. */
+  templates;
   /** API key management — list, create, delete. */
   apiKeys;
   // ── P3 / P4 resources ──────────────────────────────────────────────────────
@@ -9314,6 +9487,7 @@ var Miosa = class {
     this.healthChecks = new HealthChecks(this.http);
     this.webhooks = new Webhooks(this.http);
     this.sandboxTemplates = new SandboxTemplates(this.http);
+    this.templates = new Templates(this.http);
     this.apiKeys = new ApiKeys(this.http);
     this.models = new Models(this.http);
     this.completions = new Completions(this.http);
@@ -9812,6 +9986,6 @@ var AppAuth = class {
   }
 };
 
-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 };
+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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map