@miosa/sdk 3.6.0 → 3.7.0

package/dist/index.js

@@ -10,7 +10,7 @@ import * as http2 from 'http2';
 import { createRequire } from 'module';
 
 // src/version.ts
-var SDK_VERSION = "3.6.0";
+var SDK_VERSION = "3.7.0";
 var SDK_USER_AGENT = `@miosa/sdk/${SDK_VERSION}`;
 
 // src/http.ts
@@ -10557,6 +10557,31 @@ var Regions = class {
   }
 };
 
+// src/resources/runtimes.ts
+var SANDBOX_RUNTIME_PROFILE = {
+  firecracker: "standard",
+  soma: "soma",
+  auto: "auto"
+};
+function runtimeProfile(runtime) {
+  return runtime === void 0 ? void 0 : SANDBOX_RUNTIME_PROFILE[runtime];
+}
+var Runtimes = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * `GET /sandboxes/runtimes`: list selectable sandbox runtimes with their gate
+   * state and capabilities.
+   */
+  async list() {
+    const res = await this.http.get("/sandboxes/runtimes");
+    const data = Array.isArray(res) ? res : res?.data ?? [];
+    return data;
+  }
+};
+
 // src/resources/runtime-env.ts
 function unwrap47(payload) {
   if (payload !== null && typeof payload === "object" && "data" in payload && payload.data !== void 0) {
@@ -11269,6 +11294,7 @@ function createBody2(params = {}) {
     github_clone_path: params.githubClonePath ?? params.github_clone_path,
     name: params.name,
     region: params.region,
+    runtime_profile: runtimeProfile(params.runtime),
     entrypoint: params.entrypoint,
     tags: params.tags,
     slug: params.slug,
@@ -12341,6 +12367,48 @@ var Sandbox = class _Sandbox {
     this.data = { ...this.data, ...data };
     return this;
   }
+  /**
+   * Run one cell in the sandbox's persistent interpreter and return its output.
+   *
+   * `language` is `"python"` (default) or `"javascript"`. `context` names an
+   * independent namespace (default `"default"`), so one sandbox can keep several
+   * sessions. Variables, imports, and definitions persist across calls until
+   * {@link resetCode}.
+   */
+  async runCode(code, options = {}) {
+    const body5 = { code };
+    if (options.language !== void 0) body5.language = options.language;
+    if (options.context !== void 0) body5.context = options.context;
+    if (options.timeout !== void 0) body5.timeout = options.timeout;
+    return unwrap49(
+      await this.http.post(
+        `/sandboxes/${this.id}/code/run`,
+        body5
+      )
+    );
+  }
+  /** List the interpreter contexts that exist for `language`. */
+  async codeContexts(options = {}) {
+    const data = unwrap49(
+      await this.http.get(
+        `/sandboxes/${this.id}/code/contexts`,
+        options.language !== void 0 ? { language: options.language } : void 0
+      )
+    );
+    return data.contexts ?? [];
+  }
+  /** Reset a single `context`, or every context for `language`. */
+  async resetCode(options = {}) {
+    const query3 = options.language !== void 0 ? { language: options.language } : void 0;
+    if (options.context !== void 0) {
+      await this.http.delete(
+        `/sandboxes/${this.id}/code/contexts/${encodeURIComponent(options.context)}`,
+        query3
+      );
+    } else {
+      await this.http.delete(`/sandboxes/${this.id}/code`, query3);
+    }
+  }
   /**
    * Resume a paused (or persistent-stopped) sandbox.
    *
@@ -12874,6 +12942,28 @@ var Sandboxes = class {
   async usage(id) {
     return (await this.get(id)).usage();
   }
+  /**
+   * Mint a scoped, expiring, revocable CDP grant for a sandbox browser
+   * session (`POST /sandboxes/:id/browser/cdp-url`).
+   *
+   * Returns every URL a Chrome DevTools Protocol client needs. Point Selenium
+   * at `cdp_debugger_address` (or `127.0.0.1:9222` through the MIOSA CLI port
+   * forward) and chromedp at `cdp_host` as its base URL. The grant embeds the
+   * token in the path for `cdp_ws_url` / `cdp_http_url`; use `cdp_url` when the
+   * client can set an auth header. Pass `options.ttlSeconds` (60-604800) to
+   * request a lifetime; the server default applies otherwise. The call only
+   * mints the grant - it does not start or proxy a browser; run a CDP-speaking
+   * browser inside the sandbox.
+   */
+  async browserCdpUrl(id, options = {}) {
+    const body5 = options.ttlSeconds === void 0 ? {} : { ttl_seconds: options.ttlSeconds };
+    return unwrap49(
+      await this.http.post(
+        `/sandboxes/${id}/browser/cdp-url`,
+        body5
+      )
+    );
+  }
   async pause(id) {
     return (await this.get(id)).pause();
   }
@@ -15562,6 +15652,8 @@ var Miosa = class _Miosa {
   tenant;
   /** Datacenter regions, compute sizes, pricing, community templates. */
   regions;
+  /** Selectable sandbox runtimes (firecracker | soma | auto) with gate state. */
+  runtimes;
   /** Tenant settings — workspace config, branding, BYOK provider keys. */
   settings;
   /** Aggregated platform dashboard and health overview. */
@@ -15781,6 +15873,7 @@ var Miosa = class _Miosa {
     this.forge = new Forge(this.http);
     this.tenant = new Tenant(this.http);
     this.regions = new Regions(this.http);
+    this.runtimes = new Runtimes(this.http);
     this.settings = new Settings(this.http);
     this.dashboard = new Dashboard(this.http);
     this.analytics = new Analytics(this.http);
@@ -16362,6 +16455,6 @@ var AppAuth = class {
   }
 };
 
-export { AGENT_BUILD_KIND_SPECS, Admin, AgentChats, AgentDefinitions, AgentRuntimeProfiles, AgentSettingsResource, AgentSignins, AiGateway, Analytics, ApiKeys, AppAuth, AppDocuments, AuditLog, Benchmarks, BillTo, BuilderSessions, BulkResource, Channels, Checkpoints, Cloud, CommandCenter, Community, Completions, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, ComputerEnv, ComputerInbox, ComputerLogs, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, ComputerShares, ComputerTerminal, ComputerVolumes, Computers, Connections, Connectors, Credits, CronJobs, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, Databases, DeploymentConnectors, DeploymentDomains, DeploymentReleases, DeploymentRuntimeInstances, DeploymentVersions, Deployments, Desktop, Devices, DnsAddressResolver, DockerDeploy, Domains, EgressAudit, EgressNetwork, EgressSecrets, Email, EmailCampaigns, EmailInbox, EmailTemplates, Embeddings, Environments, EventSubscriptions, Exec, ExternalKeys, ExternalQuotas, ExternalUsers, Files, FlatCustomDomains, Forge, ForgeContractError, ForgePolicyViolationError, ForgeRepositories, ForgeStorageError, ForgeUnavailableError, FsApi, Functions, HealthChecks, Http2Transport, Http3Transport, Integrations, MachineAgent, Mcp, Miosa, Models, NamedSnapshots, NetworkPolicy, OAuthFlow, OpenComputers, OrgInvites, OrganizationMembers, Organizations, PortTunnel, ProjectAuth, ProjectIntegrations, ProviderDefaults, Quotas, RacingTransport, Regions, RunGroups, RunnerClient, RunnerConnectError, RunnerError, RunnerTimeoutError, Runs, RuntimeCapabilitiesResource, RuntimeEnv, SANDBOX_TEMPLATE, Sandbox, SandboxAudit, SandboxBatches, SandboxCommands, SandboxConnectors, SandboxEnv, SandboxEvents, SandboxFiles, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, SandboxSsh, SandboxTags, SandboxTemplates, SandboxTerminal, SandboxTunnel, Sandboxes, ScopedFs, ScopedTokens, ServiceAccounts, Settings, SharedLinks, SnapshotWarmingError, Snapshots, SnapshotsStandalone, StaticAddressResolver, Storage, TUNNEL_CLOSE_REASONS, TUNNEL_SUBPROTOCOL, Templates, Tenant, TenantEventStreamResource, TenantMembersResource, TenantPolicy, Tokens, TunnelClosedError, Usage, Volumes, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WebhookSignatureError, Webhooks, WorkspaceInvites, WorkspaceMembers, WorkspaceMembersResource, WorkspacePolicyResource, WorkspaceProxy, Workspaces, buildSshCommand, buildSshConfig, constructWebhookEvent, createAgentBuildExecutionPacket, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBestTransport, createBuildRunParams, daysUntil, decodeSomaBytes, detectHttp3Support, encodeSomaBytes, generateSshKeyPair, getAgentBuildKindSpec, hyphenateInstanceId, isConnectFailure, regionFromApiKey, regionHostname, resetHttp3DetectionCache, resolveAgentBuildKind, sandboxTag, signWebhookBody, tagHostname, unwrapSomaEnvelope, verifySignature, verifyWebhookSignature, verifyWebhookSignatureAsync };
+export { AGENT_BUILD_KIND_SPECS, Admin, AgentChats, AgentDefinitions, AgentRuntimeProfiles, AgentSettingsResource, AgentSignins, AiGateway, Analytics, ApiKeys, AppAuth, AppDocuments, AuditLog, Benchmarks, BillTo, BuilderSessions, BulkResource, Channels, Checkpoints, Cloud, CommandCenter, Community, Completions, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, ComputerEnv, ComputerInbox, ComputerLogs, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, ComputerShares, ComputerTerminal, ComputerVolumes, Computers, Connections, Connectors, Credits, CronJobs, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, Databases, DeploymentConnectors, DeploymentDomains, DeploymentReleases, DeploymentRuntimeInstances, DeploymentVersions, Deployments, Desktop, Devices, DnsAddressResolver, DockerDeploy, Domains, EgressAudit, EgressNetwork, EgressSecrets, Email, EmailCampaigns, EmailInbox, EmailTemplates, Embeddings, Environments, EventSubscriptions, Exec, ExternalKeys, ExternalQuotas, ExternalUsers, Files, FlatCustomDomains, Forge, ForgeContractError, ForgePolicyViolationError, ForgeRepositories, ForgeStorageError, ForgeUnavailableError, FsApi, Functions, HealthChecks, Http2Transport, Http3Transport, Integrations, MachineAgent, Mcp, Miosa, Models, NamedSnapshots, NetworkPolicy, OAuthFlow, OpenComputers, OrgInvites, OrganizationMembers, Organizations, PortTunnel, ProjectAuth, ProjectIntegrations, ProviderDefaults, Quotas, RacingTransport, Regions, RunGroups, RunnerClient, RunnerConnectError, RunnerError, RunnerTimeoutError, Runs, RuntimeCapabilitiesResource, RuntimeEnv, Runtimes, SANDBOX_RUNTIME_PROFILE, SANDBOX_TEMPLATE, Sandbox, SandboxAudit, SandboxBatches, SandboxCommands, SandboxConnectors, SandboxEnv, SandboxEvents, SandboxFiles, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, SandboxSsh, SandboxTags, SandboxTemplates, SandboxTerminal, SandboxTunnel, Sandboxes, ScopedFs, ScopedTokens, ServiceAccounts, Settings, SharedLinks, SnapshotWarmingError, Snapshots, SnapshotsStandalone, StaticAddressResolver, Storage, TUNNEL_CLOSE_REASONS, TUNNEL_SUBPROTOCOL, Templates, Tenant, TenantEventStreamResource, TenantMembersResource, TenantPolicy, Tokens, TunnelClosedError, Usage, Volumes, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WebhookSignatureError, Webhooks, WorkspaceInvites, WorkspaceMembers, WorkspaceMembersResource, WorkspacePolicyResource, WorkspaceProxy, Workspaces, buildSshCommand, buildSshConfig, constructWebhookEvent, createAgentBuildExecutionPacket, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBestTransport, createBuildRunParams, daysUntil, decodeSomaBytes, detectHttp3Support, encodeSomaBytes, generateSshKeyPair, getAgentBuildKindSpec, hyphenateInstanceId, isConnectFailure, regionFromApiKey, regionHostname, resetHttp3DetectionCache, resolveAgentBuildKind, runtimeProfile, sandboxTag, signWebhookBody, tagHostname, unwrapSomaEnvelope, verifySignature, verifyWebhookSignature, verifyWebhookSignatureAsync };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map