@miosa/sdk 1.2.27 → 1.2.28

package/dist/index.js

@@ -673,17 +673,17 @@ var Admin = class {
   }
 };
 
-// src/resources/agent-run-groups.ts
+// src/resources/run-groups.ts
 function unwrap(payload) {
   if (payload && typeof payload === "object" && "data" in payload) {
     return payload.data;
   }
   return payload;
 }
-function artifactRows(raw) {
+function fileRows(raw) {
   const data = unwrap(raw);
   if (Array.isArray(data)) return data;
-  return data.artifacts ?? data.items ?? [];
+  return data.files ?? data.items ?? [];
 }
 function stripUndefined(input) {
   return Object.fromEntries(
@@ -703,12 +703,14 @@ function body(params) {
 }
 function runBody(entry) {
   return stripUndefined({
-    prompt: entry.prompt,
+    instruction: entry.instruction,
     target_kind: entry.targetKind,
     target_id: entry.targetId,
+    runtime_id: entry.runtimeId,
     sandbox_id: entry.sandboxId,
     computer_id: entry.computerId,
     provider: entry.provider,
+    runner: entry.runner,
     model: entry.model,
     command: entry.command,
     runtime_command: entry.runtimeCommand,
@@ -717,11 +719,11 @@ function runBody(entry) {
     env: entry.env,
     agent_runtime_profile_id: entry.agentRuntimeProfileId,
     agent_profile_id: entry.agentProfileId,
-    parent_agent_run_id: entry.parentAgentRunId,
+    parent_run_id: entry.parentRunId,
     orchestration_role: entry.orchestrationRole,
-    skip_agent_runtime_profile: entry.skipAgentRuntimeProfile,
+    skip_agent_runtime_profile: entry.skipRuntimeProfile,
     execution_packet: entry.executionPacket,
-    output_contract: entry.outputContract,
+    expected_outputs: entry.expectedOutputs,
     approval_policy: entry.approvalPolicy,
     capability_requirements: entry.capabilityRequirements,
     metadata: entry.metadata
@@ -734,14 +736,14 @@ function sleep2(ms) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-var AgentRunGroups = class {
+var RunGroups = class {
   constructor(http) {
     this.http = http;
   }
   http;
   async list(params = {}) {
     const response = await this.http.get(
-      "/agent-run-groups",
+      "/run-groups",
       stripUndefined({
         workspace_id: params.workspaceId,
         project_id: params.projectId,
@@ -757,19 +759,19 @@ var AgentRunGroups = class {
   }
   async create(params) {
     return unwrap(
-      await this.http.post("/agent-run-groups", body(params))
+      await this.http.post("/run-groups", body(params))
     );
   }
   async get(id, options = {}) {
     const query3 = options.includeRuns ? "?include=runs" : "";
     return unwrap(
-      await this.http.get(`/agent-run-groups/${encodeURIComponent(id)}${query3}`)
+      await this.http.get(`/run-groups/${encodeURIComponent(id)}${query3}`)
     );
   }
   async dispatch(id, runs, options = {}) {
     return unwrap(
       await this.http.post(
-        `/agent-run-groups/${encodeURIComponent(id)}/dispatch`,
+        `/run-groups/${encodeURIComponent(id)}/dispatch`,
         stripUndefined({ runs: runs.map(runBody), async: options.async })
       )
     );
@@ -777,38 +779,38 @@ var AgentRunGroups = class {
   async cancel(id) {
     return unwrap(
       await this.http.post(
-        `/agent-run-groups/${encodeURIComponent(id)}/cancel`,
+        `/run-groups/${encodeURIComponent(id)}/cancel`,
         {}
       )
     );
   }
-  async events(id) {
+  async activity(id) {
     const data = unwrap(
       await this.http.get(
-        `/agent-run-groups/${encodeURIComponent(id)}/events`
+        `/run-groups/${encodeURIComponent(id)}/activity`
       )
     );
     if (Array.isArray(data)) return data;
-    return data.events ?? data.items ?? [];
+    return data.activity ?? data.items ?? [];
   }
-  streamEvents(id) {
+  streamActivity(id) {
     return this.http.stream(
-      `/agent-run-groups/${encodeURIComponent(id)}/events`
+      `/run-groups/${encodeURIComponent(id)}/activity`
     );
   }
-  async artifacts(id) {
+  async files(id) {
     const group = await this.get(id, { includeRuns: true });
     const runs = (group.runs ?? []).filter((run) => Boolean(run.id));
     const nested = await Promise.all(
       runs.map(async (run) => {
-        const artifacts = artifactRows(
+        const files = fileRows(
           await this.http.get(
-            `/agent-runs/${encodeURIComponent(run.id)}/artifacts`
+            `/runs/${encodeURIComponent(run.id)}/files`
           )
         );
-        return artifacts.map((artifact) => ({
-          ...artifact,
-          agent_run_id: artifact.agent_run_id ?? run.id
+        return files.map((file) => ({
+          ...file,
+          run_id: file.run_id ?? run.id
         }));
       })
     );
@@ -831,7 +833,7 @@ var AgentRunGroups = class {
       );
       if (isTerminalStatus(group.status, terminalStatuses)) return group;
       if (Date.now() >= deadline) {
-        throw new Error(`Timed out waiting for agent run group ${id}`);
+        throw new Error(`Timed out waiting for run group ${id}`);
       }
       await sleep2(Math.min(pollIntervalMs, Math.max(0, deadline - Date.now())));
     }
@@ -934,7 +936,7 @@ var AgentRuntimeProfiles = class {
   }
 };
 
-// src/resources/agent-runs.ts
+// src/resources/runs.ts
 function unwrap3(payload) {
   if (payload && typeof payload === "object" && "data" in payload) {
     return payload.data;
@@ -953,20 +955,21 @@ function sleep3(ms) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-var AgentRuns = class {
+var Runs = class {
   constructor(http) {
     this.http = http;
   }
   http;
   async list(params = {}) {
     const response = await this.http.get(
-      "/agent-runs",
+      "/runs",
       stripUndefined2({
         target_kind: params.targetKind,
         target_id: params.targetId,
+        runtime_id: params.runtimeId,
         sandbox_id: params.sandboxId,
         computer_id: params.computerId,
-        agent_run_group_id: params.agentRunGroupId,
+        run_group_id: params.runGroupId,
         external_workspace_id: params.externalWorkspaceId ?? params.external_workspace_id,
         external_user_id: params.externalUserId ?? params.external_user_id,
         external_project_id: params.externalProjectId ?? params.external_project_id,
@@ -981,36 +984,63 @@ var AgentRuns = class {
   }
   async get(id) {
     return unwrap3(
-      await this.http.get(`/agent-runs/${encodeURIComponent(id)}`)
+      await this.http.get(`/runs/${encodeURIComponent(id)}`)
     );
   }
-  async artifacts(id) {
+  async outputs(id) {
+    return unwrap3(
+      await this.http.get(`/runs/${encodeURIComponent(id)}/outputs`)
+    );
+  }
+  async files(id) {
     const data = unwrap3(
-      await this.http.get(
-        `/agent-runs/${encodeURIComponent(id)}/artifacts`
-      )
+      await this.http.get(`/runs/${encodeURIComponent(id)}/files`)
     );
     if (Array.isArray(data)) return data;
-    return data.artifacts ?? data.items ?? [];
+    return data.files ?? data.items ?? [];
   }
-  async downloadArtifact(id, artifactId, options = {}) {
+  async downloadFile(id, fileId, options = {}) {
     const query3 = options.inline ? "?disposition=inline" : "";
     return this.http.getBinary(
-      `/agent-runs/${encodeURIComponent(id)}/artifacts/${encodeURIComponent(
-        artifactId
+      `/runs/${encodeURIComponent(id)}/files/${encodeURIComponent(
+        fileId
       )}/download${query3}`
     );
   }
-  async events(id) {
+  async messages(id) {
+    const data = unwrap3(
+      await this.http.get(`/runs/${encodeURIComponent(id)}/messages`)
+    );
+    if (Array.isArray(data)) return data;
+    return data.messages ?? data.items ?? [];
+  }
+  async commandOutput(id) {
+    return unwrap3(
+      await this.http.get(`/runs/${encodeURIComponent(id)}/command-output`)
+    );
+  }
+  async activity(id) {
+    const data = unwrap3(
+      await this.http.get(`/runs/${encodeURIComponent(id)}/activity`)
+    );
+    if (Array.isArray(data)) return data;
+    return data.activity ?? data.items ?? [];
+  }
+  async previews(id) {
     const data = unwrap3(
-      await this.http.get(`/agent-runs/${encodeURIComponent(id)}/events`)
+      await this.http.get(`/runs/${encodeURIComponent(id)}/previews`)
     );
     if (Array.isArray(data)) return data;
-    return data.events ?? data.items ?? [];
+    return data.previews ?? data.items ?? [];
   }
-  streamEvents(id) {
+  async diagnostics(id) {
+    const data = unwrap3(await this.http.get(`/runs/${encodeURIComponent(id)}/diagnostics`));
+    if (Array.isArray(data)) return data;
+    return data.diagnostics ?? data.items ?? [];
+  }
+  streamActivity(id) {
     return this.http.stream(
-      `/agent-runs/${encodeURIComponent(id)}/events`
+      `/runs/${encodeURIComponent(id)}/activity`
     );
   }
   async waitForCompletion(id, options = {}) {
@@ -1027,19 +1057,21 @@ var AgentRuns = class {
       const run = await this.get(id);
       if (isTerminalStatus2(run.status, terminalStatuses)) return run;
       if (Date.now() >= deadline) {
-        throw new Error(`Timed out waiting for agent run ${id}`);
+        throw new Error(`Timed out waiting for run ${id}`);
       }
       await sleep3(Math.min(pollIntervalMs, Math.max(0, deadline - Date.now())));
     }
   }
   async run(params) {
     const body4 = stripUndefined2({
-      prompt: params.prompt,
+      instruction: params.instruction,
       target_kind: params.targetKind,
       target_id: params.targetId,
+      runtime_id: params.runtimeId,
       sandbox_id: params.sandboxId,
       computer_id: params.computerId,
       provider: params.provider,
+      runner: params.runner,
       model: params.model,
       command: params.command,
       runtime_command: params.runtimeCommand,
@@ -1047,32 +1079,27 @@ 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,
-      parent_agent_run_id: params.parentAgentRunId,
+      run_group_id: params.runGroupId,
+      parent_run_id: params.parentRunId,
       orchestration_role: params.orchestrationRole,
       external_workspace_id: params.externalWorkspaceId ?? params.external_workspace_id,
       external_user_id: params.externalUserId ?? params.external_user_id,
       external_project_id: params.externalProjectId ?? params.external_project_id,
-      skip_agent_runtime_profile: params.skipAgentRuntimeProfile,
+      skip_agent_runtime_profile: params.skipRuntimeProfile,
       execution_packet: params.executionPacket,
-      output_contract: params.outputContract,
+      expected_outputs: params.expectedOutputs,
       approval_policy: params.approvalPolicy,
       capability_requirements: params.capabilityRequirements,
       metadata: params.metadata
     });
-    return unwrap3(await this.http.post("/agent-runs", body4));
+    return unwrap3(await this.http.post("/runs", body4));
   }
   async cancel(id) {
     return unwrap3(
       await this.http.post(
-        `/agent-runs/${encodeURIComponent(id)}/cancel`,
+        `/runs/${encodeURIComponent(id)}/cancel`,
         {}
       )
     );
@@ -2689,18 +2716,6 @@ 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 };
@@ -2709,28 +2724,16 @@ 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 = {
@@ -4132,16 +4135,18 @@ var Computer = class _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.
+   * same Runs API as `miosa agent run --computer`, scoped to this VM.
    */
-  async prompt(instruction, options = {}) {
-    return new AgentRuns(this.http).run({
+  async run(instruction, options = {}) {
+    const runner = options.runner ?? "claude-code";
+    return new Runs(this.http).run({
       ...options,
-      prompt: instruction,
+      instruction,
       targetKind: "computer",
       targetId: this.id,
+      runtimeId: this.id,
       computerId: this.id,
-      provider: options.provider ?? "claude",
+      runner,
       cwd: options.cwd ?? "/workspace",
       wait: options.wait ?? true
     });
@@ -4185,14 +4190,6 @@ 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)`.
@@ -4200,10 +4197,6 @@ 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)`.
@@ -4211,10 +4204,6 @@ 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)`.
@@ -4330,17 +4319,6 @@ 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(
@@ -4451,6 +4429,7 @@ var Computers = class {
       agentRuntimeProfileId,
       agentProfileId,
       skipAgentRuntimeProfile,
+      skipRuntimeProfile,
       ...body4
     } = params;
     const data = await this.http.post("/computers", {
@@ -4458,7 +4437,7 @@ var Computers = class {
       ...body4,
       size: normalizeComputerSize(body4.size ?? "small"),
       agent_runtime_profile_id: agentRuntimeProfileId ?? params.agent_runtime_profile_id ?? agentProfileId ?? params.agent_profile_id,
-      skip_agent_runtime_profile: skipAgentRuntimeProfile ?? params.skip_agent_runtime_profile
+      skip_agent_runtime_profile: skipAgentRuntimeProfile ?? skipRuntimeProfile ?? params.skip_agent_runtime_profile
     });
     return new Computer(this.http, data);
   }
@@ -4819,14 +4798,21 @@ function dockerDeployProduct(deployment) {
 }
 function dockerDeployHostId(deployment) {
   const metadataHost = deployment.metadata?.docker_deploy_host_id;
-  return deployment.docker_deploy_host_id ?? (typeof metadataHost === "string" ? metadataHost : null);
+  const appHost = dockerDeployApp(deployment)?.docker_deploy_host_id;
+  return deployment.docker_deploy_host_id ?? (typeof metadataHost === "string" ? metadataHost : null) ?? (typeof appHost === "string" ? appHost : null);
 }
 function dockerDeployApp(deployment) {
+  if (deployment.docker_deploy_app && typeof deployment.docker_deploy_app === "object" && !Array.isArray(deployment.docker_deploy_app)) {
+    return deployment.docker_deploy_app;
+  }
   const app = deployment.metadata?.docker_deploy;
   if (!app || typeof app !== "object" || Array.isArray(app)) return null;
   return app;
 }
 function dockerDeployAppPort(app) {
+  const runtimePort = app?.runtime_port;
+  if (typeof runtimePort === "number" && Number.isFinite(runtimePort)) return runtimePort;
+  if (typeof runtimePort === "string" && /^\d+$/.test(runtimePort)) return Number(runtimePort);
   const url = app?.url;
   if (typeof url !== "string") return null;
   try {
@@ -4840,6 +4826,21 @@ function dockerDeployAppPort(app) {
 function addDoctorCheck(checks, name, ok, message, details) {
   checks.push({ name, ok, message, ...details ? { details } : {} });
 }
+function addProofCheck(checks, id, ok, message, details, recovery) {
+  checks.push({
+    id,
+    ok,
+    message,
+    ...details ? { details } : {},
+    ...recovery ? { recovery } : {}
+  });
+}
+function deploymentPublicUrl(deployment) {
+  const app = dockerDeployApp(deployment);
+  const appUrl = app?.public_url;
+  if (typeof appUrl === "string" && appUrl) return appUrl;
+  return deployment.public_url ?? null;
+}
 function hostHealthy(host) {
   return Boolean(
     host && host.status === "active" && host.appliance_status === "healthy"
@@ -5033,7 +5034,7 @@ var Deployments = class {
     return unwrap28(data);
   }
   /**
-   * Create a deployment that runs on the workspace's dedicated Docker Deploy
+   * Create a deployment that runs on the workspace's dedicated App Engine
    * runtime. It uses the same /deployments API as MIOSA Deploy, but marks the
    * deployment so the control plane attaches it to the workspace Docker host.
    */
@@ -5044,7 +5045,7 @@ var Deployments = class {
     });
   }
   /**
-   * Verify a Docker Deploy deployment before telling a user or agent it is
+   * Verify a App Engine deployment before telling a user or agent it is
    * live. Checks product markers, appliance host health, route metadata, and
    * optionally probes the public URL.
    */
@@ -5058,14 +5059,14 @@ var Deployments = class {
       checks,
       "deployment_product",
       product === "docker_deploy",
-      product === "docker_deploy" ? "Deployment is marked for Docker Deploy." : `Expected deployment_product=docker_deploy, got ${String(product ?? "missing")}.`,
+      product === "docker_deploy" ? "Deployment is marked for App Engine." : `Expected deployment_product=docker_deploy, got ${String(product ?? "missing")}.`,
       { deployment_product: product ?? null }
     );
     addDoctorCheck(
       checks,
       "docker_deploy_host_id",
       Boolean(hostId),
-      hostId ? "Deployment has a Docker Deploy host id." : "Deployment has no docker_deploy_host_id.",
+      hostId ? "Deployment has a App Engine host id." : "Deployment has no docker_deploy_host_id.",
       { docker_deploy_host_id: hostId }
     );
     let host;
@@ -5081,7 +5082,7 @@ var Deployments = class {
           checks,
           "docker_deploy_host_health",
           hostHealthy(host),
-          hostHealthy(host) ? "Docker Deploy host is active and healthy." : `Docker Deploy host status=${host.status} appliance=${host.appliance_status}.`,
+          hostHealthy(host) ? "App Engine host is active and healthy." : `App Engine host status=${host.status} appliance=${host.appliance_status}.`,
           {
             status: host.status,
             appliance_status: host.appliance_status
@@ -5103,7 +5104,7 @@ var Deployments = class {
       checks,
       "docker_deploy_app",
       appRunning,
-      appRunning ? "Docker Deploy app metadata points at a running container." : "Deployment is missing running Docker Deploy app metadata.",
+      appRunning ? "App Engine app metadata points at a running container." : "Deployment is missing running App Engine app metadata.",
       app ? {
         app_id: app.app_id,
         container_id: app.container_id,
@@ -5114,8 +5115,12 @@ var Deployments = class {
     );
     const runtime = metadata.runtime;
     const runtimeCandidate = typeof runtime === "object" && runtime !== null ? runtime : void 0;
-    const hasRuntimeRoute = typeof runtimeCandidate?.ip === "string" && typeof runtimeCandidate.port === "number";
-    const runtimeRecord = hasRuntimeRoute ? runtimeCandidate : void 0;
+    const appRuntimeIp = app?.runtime_ip;
+    const appRuntimePort = app?.runtime_port;
+    const appRuntimeCandidate = typeof appRuntimeIp === "string" && (typeof appRuntimePort === "number" || typeof appRuntimePort === "string") ? { ip: appRuntimeIp, port: Number(appRuntimePort) } : void 0;
+    const effectiveRuntime = appRuntimeCandidate ?? runtimeCandidate;
+    const hasRuntimeRoute = typeof effectiveRuntime?.ip === "string" && typeof effectiveRuntime.port === "number" && Number.isFinite(effectiveRuntime.port);
+    const runtimeRecord = hasRuntimeRoute ? effectiveRuntime : void 0;
     const routeMatchesContainerPort = hasRuntimeRoute && (appPort === null || runtimeRecord?.port === appPort);
     addDoctorCheck(
       checks,
@@ -5129,7 +5134,7 @@ var Deployments = class {
       } : void 0
     );
     let probe;
-    const publicUrl = deployment.public_url;
+    const publicUrl = deploymentPublicUrl(deployment);
     const path = params.probePath ?? params.probe_path ?? "/";
     if (publicUrl && typeof fetch === "function") {
       const url = probeUrl(publicUrl, path);
@@ -5176,6 +5181,146 @@ var Deployments = class {
       ...probe ? { probe } : {}
     };
   }
+  async prove(deploymentId, params = {}) {
+    const deployment = await this.get(deploymentId);
+    const product = dockerDeployProduct(deployment);
+    const checks = [];
+    const publicUrl = deploymentPublicUrl(deployment);
+    addProofCheck(
+      checks,
+      "deployment_row",
+      true,
+      `Deployment ${deployment.id} exists with state=${deployment.state}.`,
+      { state: deployment.state }
+    );
+    addProofCheck(
+      checks,
+      "deployment_running",
+      deployment.state === "running",
+      deployment.state === "running" ? "Deployment is marked running." : `Deployment state is ${deployment.state}, expected running.`,
+      { state: deployment.state },
+      ["Inspect deployment logs.", "Redeploy the deployment."]
+    );
+    addProofCheck(
+      checks,
+      "public_url_present",
+      Boolean(publicUrl),
+      publicUrl ? `Public URL is ${publicUrl}.` : "Deployment has no public URL.",
+      { public_url: publicUrl }
+    );
+    if (product === "docker_deploy") {
+      const app = dockerDeployApp(deployment);
+      const appPort = dockerDeployAppPort(app);
+      const hostId = dockerDeployHostId(deployment);
+      const runtimeIp = typeof app?.runtime_ip === "string" ? app.runtime_ip : typeof deployment.metadata?.runtime === "object" && deployment.metadata.runtime !== null ? deployment.metadata.runtime.ip : null;
+      addProofCheck(
+        checks,
+        "docker_deploy_host_link",
+        Boolean(hostId),
+        hostId ? `Deployment links App Engine host ${hostId}.` : "Deployment has no App Engine host id.",
+        { docker_deploy_host_id: hostId },
+        ["Ensure the workspace App Engine appliance."]
+      );
+      if (hostId) {
+        try {
+          const rawHost = await this.http.get(
+            `/docker-deploy/hosts/${hostId}`
+          );
+          const host = unwrap28(
+            rawHost
+          );
+          addProofCheck(
+            checks,
+            "docker_deploy_host_ready",
+            hostHealthy(host),
+            `Host status=${host.status}, appliance=${host.appliance_status}.`,
+            {
+              status: host.status,
+              appliance_status: host.appliance_status
+            },
+            ["Check App Engine host health."]
+          );
+        } catch (error) {
+          addProofCheck(
+            checks,
+            "docker_deploy_host_ready",
+            false,
+            error instanceof Error ? error.message : String(error),
+            { docker_deploy_host_id: hostId }
+          );
+        }
+      }
+      addProofCheck(
+        checks,
+        "docker_deploy_app_row",
+        Boolean(app),
+        app ? `App Engine app status=${String(app.status ?? "unknown")}.` : "App Engine app row is missing.",
+        app ? {
+          app_id: app.app_id,
+          container_id: app.container_id,
+          status: app.status
+        } : void 0,
+        ["Publish through App Engine again."]
+      );
+      addProofCheck(
+        checks,
+        "docker_deploy_container_route",
+        Boolean(
+          app && app.status === "running" && typeof app.container_id === "string" && typeof runtimeIp === "string" && appPort !== null
+        ),
+        app ? `Container=${String(app.container_id ?? "missing")}, route=${String(runtimeIp ?? "missing")}:${String(appPort ?? "missing")}.` : "Cannot verify container route without App Engine app row.",
+        {
+          container_id: app?.container_id ?? null,
+          runtime_ip: runtimeIp ?? null,
+          runtime_port: appPort
+        },
+        ["Run App Engine doctor.", "Check appliance container health."]
+      );
+    }
+    let probe;
+    const shouldProbe = params.probe ?? true;
+    if (shouldProbe && publicUrl && typeof fetch === "function") {
+      const url = probeUrl(publicUrl, params.probePath ?? params.probe_path ?? "/");
+      const controller = new AbortController();
+      const timeout = setTimeout(
+        () => controller.abort(),
+        params.timeoutMs ?? params.timeout_ms ?? 1e4
+      );
+      try {
+        const response = await fetch(url, {
+          method: "GET",
+          signal: controller.signal
+        });
+        probe = { url, ok: response.ok, status: response.status };
+      } catch (error) {
+        probe = {
+          url,
+          ok: false,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      } finally {
+        clearTimeout(timeout);
+      }
+      addProofCheck(
+        checks,
+        "public_url_probe",
+        probe.ok,
+        probe.ok ? `Public URL returned HTTP ${probe.status}.` : `Public URL probe failed: ${probe.error ?? `HTTP ${probe.status}`}.`,
+        { ...probe },
+        ["Check DNS/custom domain routing.", "Check app logs and container health."]
+      );
+    }
+    const nextActions = checks.filter((check) => !check.ok).flatMap((check) => check.recovery ?? []).filter((action, index, all) => all.indexOf(action) === index);
+    return {
+      ok: checks.every((check) => check.ok),
+      deployment,
+      deployment_product: typeof product === "string" ? product : null,
+      public_url: publicUrl,
+      checks,
+      ...probe ? { probe } : {},
+      next_actions: nextActions
+    };
+  }
   async update(deploymentId, params) {
     const body4 = stripUndefined14({
       name: params.name,
@@ -5560,7 +5705,7 @@ function ensureBody(params) {
 function unwrapHost(response) {
   const host = response.data ?? response.host;
   if (!host) {
-    throw new Error("Docker Deploy host response was empty.");
+    throw new Error("App Engine host response was empty.");
   }
   return host;
 }
@@ -5570,7 +5715,7 @@ function unwrapTemplates(response) {
 function unwrapTemplate(response) {
   const template = response.data ?? response.template;
   if (!template) {
-    throw new Error("Docker Deploy template response was empty.");
+    throw new Error("App Engine template response was empty.");
   }
   return template;
 }
@@ -5580,7 +5725,7 @@ var DockerDeploy = class {
   }
   http;
   /**
-   * List Docker Deploy appliance hosts scoped to the current tenant.
+   * List App Engine appliance hosts scoped to the current tenant.
    *
    * Pass a workspace ID to inspect the dedicated always-on appliance machine
    * for one white-label workspace.
@@ -5593,7 +5738,7 @@ var DockerDeploy = class {
     return res.data ?? res.hosts ?? [];
   }
   /**
-   * Ensure a workspace has its dedicated Docker Deploy appliance host.
+   * Ensure a workspace has its dedicated App Engine appliance host.
    *
    * The host may still be `pending`, `provisioning`, or `bootstrapping` after
    * this call. Treat `status === "active"` and `appliance_status === "healthy"`
@@ -5606,21 +5751,21 @@ var DockerDeploy = class {
     );
     return { host: unwrapHost(res), queued: res.queued ?? false };
   }
-  /** Fetch one Docker Deploy host by ID. */
+  /** Fetch one App Engine host by ID. */
   async getHost(hostId) {
     const res = await this.http.get(
       `/docker-deploy/hosts/${hostId}`
     );
     return unwrapHost(res);
   }
-  /** List Docker Deploy starter templates. */
+  /** List App Engine starter templates. */
   async listTemplates() {
     const res = await this.http.get(
       "/docker-deploy/templates"
     );
     return unwrapTemplates(res);
   }
-  /** Fetch one Docker Deploy starter template by ID. */
+  /** Fetch one App Engine starter template by ID. */
   async getTemplate(templateId) {
     const res = await this.http.get(
       `/docker-deploy/templates/${encodeURIComponent(templateId)}`
@@ -7113,11 +7258,6 @@ 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");
@@ -7311,7 +7451,6 @@ 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,
@@ -7326,7 +7465,7 @@ function createBody(params = {}) {
     tags: params.tags,
     slug: params.slug,
     agent_runtime_profile_id: params.agentRuntimeProfileId ?? params.agent_runtime_profile_id ?? params.agentProfileId ?? params.agent_profile_id,
-    skip_agent_runtime_profile: params.skipAgentRuntimeProfile ?? params.skip_agent_runtime_profile,
+    skip_agent_runtime_profile: params.skipRuntimeProfile ?? params.skip_agent_runtime_profile,
     external_workspace_id: params.externalWorkspaceId ?? params.external_workspace_id,
     external_user_id: params.externalUserId ?? params.external_user_id,
     external_project_id: params.externalProjectId ?? params.external_project_id
@@ -7506,15 +7645,6 @@ 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;
@@ -7655,7 +7785,6 @@ 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);
@@ -7678,8 +7807,6 @@ 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. */
@@ -7716,16 +7843,18 @@ var Sandbox = class _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.
+   * Pass `{ runner: "codex", env: { CODEX_API_KEY } }` to run Codex.
    */
-  async prompt(instruction, options = {}) {
-    return new AgentRuns(this.http).run({
+  async run(instruction, options = {}) {
+    const runner = options.runner ?? "claude-code";
+    return new Runs(this.http).run({
       ...options,
-      prompt: instruction,
+      instruction,
       targetKind: "sandbox",
       targetId: this.id,
+      runtimeId: this.id,
       sandboxId: this.id,
-      provider: options.provider ?? "claude",
+      runner,
       cwd: options.cwd ?? "/workspace",
       wait: options.wait ?? true
     });
@@ -7822,14 +7951,6 @@ 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(
@@ -7868,17 +7989,6 @@ 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(
@@ -7930,8 +8040,7 @@ 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;
     }
@@ -9007,39 +9116,6 @@ 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) {
@@ -9345,10 +9421,10 @@ var Miosa = class {
   externalKeys;
   /** Model Context Protocol — JSON-RPC dispatch + streaming channel. */
   mcp;
-  /** Agent Runs — prompt dispatch into sandbox targets. */
-  agentRuns;
-  /** Agent Run Groups — durable multi-agent orchestration groups. */
-  agentRunGroups;
+  /** Runs - instruction dispatch into sandbox and computer targets. */
+  runs;
+  /** Run groups - durable multi-run orchestration groups. */
+  runGroups;
   /** Agent runtime profiles — tenant/workspace defaults for sandbox/computer agents. */
   agentRuntimeProfiles;
   /** MIOSA Connect — provider connectors and runtime tokens. */
@@ -9368,7 +9444,7 @@ var Miosa = class {
    * Versions, releases, rollback, custom domains.
    */
   deployments;
-  /** Docker Deploy appliance hosts — one always-on workspace host, many apps. */
+  /** App Engine appliance hosts — one always-on workspace host, many apps. */
   dockerDeploy;
   /** Credit balance and usage. */
   credits;
@@ -9464,8 +9540,8 @@ var Miosa = class {
     this.projectAuth = new ProjectAuth(this.http);
     this.externalKeys = new ExternalKeys(this.http);
     this.mcp = new Mcp(this.http);
-    this.agentRuns = new AgentRuns(this.http);
-    this.agentRunGroups = new AgentRunGroups(this.http);
+    this.runs = new Runs(this.http);
+    this.runGroups = new RunGroups(this.http);
     this.agentRuntimeProfiles = new AgentRuntimeProfiles(this.http);
     this.connectors = new Connectors(this.http);
     this.runtimeEnv = new RuntimeEnv(this.http);
@@ -9519,7 +9595,7 @@ var NEXTJS_RUNTIME_TEMPLATE = {
   start_command: "npm run dev -- --hostname 0.0.0.0 --port 3000",
   build_command: "npm run build"
 };
-function artifactBundle(kind) {
+function fileBundle(kind) {
   return {
     kind,
     workspace_root: "/workspace",
@@ -9583,15 +9659,15 @@ var BUILD_KIND_ALIASES = {
   webinar: "webinar",
   website: "website"
 };
-function spec(kind, label, artifactType, runtimeTemplate, artifacts, options = {}) {
+function spec(kind, label, deliverableType, runtimeTemplate, files, options = {}) {
   const resolved = {
     kind,
     label,
-    artifactType,
+    deliverableType,
     runtimeTemplate,
     requestedOutputs: options.requestedOutputs ?? ["requested deliverables", "manifest"],
     plannerDocumentKinds: options.plannerDocumentKinds ?? COMMON_PLANNER_DOCUMENT_KINDS,
-    artifacts,
+    files,
     designResearchRequired: options.designResearchRequired ?? false
   };
   if (options.previewPort !== void 0) resolved.previewPort = options.previewPort;
@@ -9621,50 +9697,50 @@ var AGENT_BUILD_KIND_SPECS = {
     { kind: "html", path: "webinar-page.html", mime_type: "text/html", name: "Webinar page", previewable: true },
     { kind: "markdown", path: "webinar-script.md", mime_type: "text/markdown", name: "Webinar script" }
   ], { requestedOutputs: ["webinar registration page", "script", "slides"], designResearchRequired: true, previewPort: 3e3 }),
-  slides_deck: spec("slides_deck", "Slides deck", "slides_deck", artifactBundle("html_deck"), [
+  slides_deck: spec("slides_deck", "Slides deck", "slides_deck", fileBundle("html_deck"), [
     { kind: "html", path: "deck.html", mime_type: "text/html", name: "Slide deck", previewable: true }
   ], { designResearchRequired: true }),
-  email_sequence: spec("email_sequence", "Email sequence", "email_sms_sequence", artifactBundle("email_bundle"), [
+  email_sequence: spec("email_sequence", "Email sequence", "email_sms_sequence", fileBundle("email_bundle"), [
     { kind: "markdown", path: "email-sequence.md", mime_type: "text/markdown", name: "Email sequence", previewable: true }
   ]),
-  social_content: spec("social_content", "Social content", "social_media_post", artifactBundle("html_image_bundle"), [
+  social_content: spec("social_content", "Social content", "social_media_post", fileBundle("html_image_bundle"), [
     { kind: "html", path: "social-carousel.html", mime_type: "text/html", name: "Social carousel", previewable: true },
     { kind: "markdown", path: "captions.md", mime_type: "text/markdown", name: "Caption bank" }
   ], { designResearchRequired: true }),
-  ad_creative: spec("ad_creative", "Ad creative", "ad_creative", artifactBundle("html_image_bundle"), [
+  ad_creative: spec("ad_creative", "Ad creative", "ad_creative", fileBundle("html_image_bundle"), [
     { kind: "html", path: "ad-creative.html", mime_type: "text/html", name: "Ad creative previews", previewable: true }
   ], { designResearchRequired: true }),
   booking_page: spec("booking_page", "Booking page", "booking_page", NEXTJS_RUNTIME_TEMPLATE, [
     { kind: "html", path: "booking-page.html", mime_type: "text/html", name: "Booking page", previewable: true }
   ], { requestedOutputs: ["booking page", "confirmation copy", "source files"], designResearchRequired: true, previewPort: 3e3 }),
-  brand_identity: spec("brand_identity", "Brand identity", "brand_identity", artifactBundle("brand_bundle"), [
+  brand_identity: spec("brand_identity", "Brand identity", "brand_identity", fileBundle("brand_bundle"), [
     { kind: "markdown", path: "brand-guide.md", mime_type: "text/markdown", name: "Brand guide", previewable: true }
   ], { designResearchRequired: true }),
-  offer: spec("offer", "Offer", "offer", artifactBundle("offer_bundle"), [
+  offer: spec("offer", "Offer", "offer", fileBundle("offer_bundle"), [
     { kind: "markdown", path: "offer-stack.md", mime_type: "text/markdown", name: "Offer stack", previewable: true }
   ]),
-  program: spec("program", "Program", "program_lms", artifactBundle("program_lms"), [
+  program: spec("program", "Program", "program_lms", fileBundle("program_lms"), [
     { kind: "html", path: "program.html", mime_type: "text/html", name: "Program preview", previewable: true },
     { kind: "markdown", path: "program.md", mime_type: "text/markdown", name: "Program outline" }
   ], { designResearchRequired: true }),
-  podcast: spec("podcast", "Podcast", "podcast_audio", artifactBundle("podcast_audio"), [
+  podcast: spec("podcast", "Podcast", "podcast_audio", fileBundle("podcast_audio"), [
     { kind: "html", path: "podcast.html", mime_type: "text/html", name: "Podcast preview", previewable: true },
     { kind: "markdown", path: "show-notes.md", mime_type: "text/markdown", name: "Show notes" }
   ]),
-  sales_script: spec("sales_script", "Sales script", "sales_script", artifactBundle("script_bundle"), [
+  sales_script: spec("sales_script", "Sales script", "sales_script", fileBundle("script_bundle"), [
     { kind: "markdown", path: "sales-script.md", mime_type: "text/markdown", name: "Sales script", previewable: true }
   ]),
-  campaign: spec("campaign", "Campaign", "campaign", artifactBundle("campaign_bundle"), [
+  campaign: spec("campaign", "Campaign", "campaign", fileBundle("campaign_bundle"), [
     { kind: "markdown", path: "campaign-plan.md", mime_type: "text/markdown", name: "Campaign plan", previewable: true },
     { kind: "html", path: "campaign-assets.html", mime_type: "text/html", name: "Campaign assets", previewable: true }
   ], { designResearchRequired: true }),
-  challenge: spec("challenge", "Challenge", "challenge", artifactBundle("challenge_bundle"), [
+  challenge: spec("challenge", "Challenge", "challenge", fileBundle("challenge_bundle"), [
     { kind: "markdown", path: "challenge-plan.md", mime_type: "text/markdown", name: "Challenge plan", previewable: true }
   ]),
-  character: spec("character", "Character pack", "brand_character", artifactBundle("character_bundle"), [
+  character: spec("character", "Character pack", "brand_character", fileBundle("character_bundle"), [
     { kind: "markdown", path: "character-pack.md", mime_type: "text/markdown", name: "Character pack", previewable: true }
   ], { designResearchRequired: true }),
-  custom: spec("custom", "Custom build", "artifact", artifactBundle("artifact_bundle"), [])
+  custom: spec("custom", "Custom build", "file", fileBundle("file_bundle"), [])
 };
 function normalizeBuildKind(value) {
   return (value ?? "").trim().toLowerCase().replace(/[\s-]+/g, "_").replace(/[^a-z0-9_]/g, "");
@@ -9677,14 +9753,14 @@ function resolveAgentBuildKind(value, fallback = "custom") {
 function getAgentBuildKindSpec(value) {
   return AGENT_BUILD_KIND_SPECS[resolveAgentBuildKind(value)];
 }
-function normalizeArtifactPath(path, outputRoot) {
+function normalizeFilePath(path, outputRoot) {
   return path.startsWith("/") ? path : `${outputRoot}/${path}`;
 }
-function createAgentBuildOutputContract(buildKind, options = {}) {
-  if (options.outputContract) return options.outputContract;
+function createAgentBuildExpectedOutputs(buildKind, options = {}) {
+  if (options.expectedOutputs) return options.expectedOutputs;
   const spec2 = getAgentBuildKindSpec(buildKind);
   const outputRoot = options.outputRoot ?? DEFAULT_AGENT_BUILD_OUTPUT_ROOT;
-  const artifacts = [
+  const files = [
     {
       path: `${outputRoot}/manifest.json`,
       kind: "json",
@@ -9692,10 +9768,10 @@ function createAgentBuildOutputContract(buildKind, options = {}) {
       name: "Manifest",
       downloadable: true
     },
-    ...(options.artifacts ?? spec2.artifacts).map((artifact) => ({
-      ...artifact,
-      path: normalizeArtifactPath(artifact.path, outputRoot),
-      downloadable: artifact.downloadable ?? true
+    ...(options.files ?? spec2.files).map((file) => ({
+      ...file,
+      path: normalizeFilePath(file.path, outputRoot),
+      downloadable: file.downloadable ?? true
     }))
   ];
   const contract = withoutUndefined({
@@ -9703,11 +9779,16 @@ function createAgentBuildOutputContract(buildKind, options = {}) {
     manifest: `${outputRoot}/manifest.json`,
     planner_documents_under: "/workspace/planner",
     inputs_under: DEFAULT_AGENT_BUILD_INPUT_ROOT,
-    artifact_type: options.artifactType ?? spec2.artifactType,
+    deliverable_type: options.deliverableType ?? spec2.deliverableType,
     required_files: [`${outputRoot}/manifest.json`],
-    artifacts,
+    files,
+    expected_outputs: {
+      messages: true,
+      files,
+      previews: spec2.previewPort !== void 0
+    },
     preview_port: spec2.previewPort,
-    include_downloadable_artifacts: true
+    include_downloads: true
   });
   return contract;
 }
@@ -9725,21 +9806,21 @@ function withoutUndefined(input) {
 function createAgentBuildExecutionPacket(params) {
   const buildKind = resolveAgentBuildKind(params.buildKind ?? params.runType);
   const spec2 = AGENT_BUILD_KIND_SPECS[buildKind];
-  const artifactType = params.artifactType ?? spec2.artifactType;
+  const deliverableType = params.deliverableType ?? spec2.deliverableType;
   const runtimeTemplate = params.runtimeTemplate ?? spec2.runtimeTemplate;
-  const outputOptions = { artifactType };
-  if (params.artifacts !== void 0) outputOptions.artifacts = params.artifacts;
-  if (params.outputContract !== void 0) {
-    outputOptions.outputContract = params.outputContract;
+  const outputOptions = { deliverableType };
+  if (params.files !== void 0) outputOptions.files = params.files;
+  if (params.expectedOutputs !== void 0) {
+    outputOptions.expectedOutputs = params.expectedOutputs;
   }
   if (params.outputRoot !== void 0) outputOptions.outputRoot = params.outputRoot;
-  const outputContract = createAgentBuildOutputContract(buildKind, outputOptions);
+  const expectedOutputs = createAgentBuildExpectedOutputs(buildKind, outputOptions);
   const inputRefs = params.inputRefs ?? [];
   const packet = {
     version: DEFAULT_AGENT_BUILD_PACKET_VERSION,
     run_type: buildKind,
     build_kind: buildKind,
-    artifact_type: artifactType,
+    deliverable_type: deliverableType,
     title: params.title,
     goal: params.goal,
     source_refs: params.sourceRefs ?? [],
@@ -9748,7 +9829,7 @@ function createAgentBuildExecutionPacket(params) {
     planner_documents: normalizePlannerDocuments(params.plannerDocuments),
     requested_outputs: params.requestedOutputs ?? spec2.requestedOutputs,
     quality_rules: params.qualityRules ?? [],
-    output_contract: outputContract,
+    expected_outputs: expectedOutputs,
     runtime_instructions: {
       agent: "claude",
       template: runtimeTemplate,
@@ -9764,10 +9845,10 @@ function createAgentBuildExecutionPacket(params) {
     metadata: {
       ...params.metadata ?? {},
       build_kind: buildKind,
-      artifact_type: artifactType,
+      deliverable_type: deliverableType,
       build_target: runtimeTemplate,
       runtime_template: runtimeTemplate,
-      output_contract: outputContract,
+      expected_outputs: expectedOutputs,
       input_refs: inputRefs,
       design_research_required: spec2.designResearchRequired,
       planner_document_kinds: spec2.plannerDocumentKinds
@@ -9784,23 +9865,24 @@ function createAgentBuildPrompt(packet) {
     "",
     `Materialize input_refs under ${DEFAULT_AGENT_BUILD_INPUT_ROOT}.`,
     "Use the execution packet, input bundle, planner documents, brand/context notes, and quality rules.",
-    `Write every deliverable under ${packet.output_contract.write_files_under}.`,
-    `Write a JSON manifest to ${packet.output_contract.manifest}.`,
+    `Write every deliverable under ${packet.expected_outputs.write_files_under}.`,
+    `Write a JSON manifest to ${packet.expected_outputs.manifest}.`,
     "Do not expose secrets. Do not publish externally unless the approval policy allows it."
   ].join("\n");
 }
-function createBuildAgentRunParams(params) {
+function createBuildRunParams(params) {
   const runtimeProfileId = params.agentRuntimeProfileId ?? params.runtimeProfileId;
   const packetParams = { ...params };
   if (runtimeProfileId !== void 0) packetParams.runtimeProfileId = runtimeProfileId;
   const packet = createAgentBuildExecutionPacket(packetParams);
   return withoutUndefined({
-    prompt: params.prompt ?? createAgentBuildPrompt(packet),
+    instruction: params.instruction ?? createAgentBuildPrompt(packet),
     targetKind: params.targetKind ?? (params.computerId ? "computer" : "sandbox"),
     targetId: params.targetId,
     sandboxId: params.sandboxId,
     computerId: params.computerId,
-    provider: params.provider ?? "claude",
+    runner: params.runner ?? "claude-code",
+    provider: params.provider,
     model: params.model,
     cwd: params.cwd ?? "/workspace",
     timeout: params.timeout ?? 1800,
@@ -9811,7 +9893,7 @@ function createBuildAgentRunParams(params) {
     externalUserId: params.externalUserId,
     externalProjectId: params.externalProjectId,
     executionPacket: packet,
-    outputContract: packet.output_contract,
+    expectedOutputs: packet.expected_outputs,
     approvalPolicy: params.approvalPolicy ?? {
       publish: "manual",
       external_write: "manual",
@@ -9820,12 +9902,13 @@ function createBuildAgentRunParams(params) {
     capabilityRequirements: params.capabilityRequirements ?? [
       "filesystem",
       "shell",
-      "artifact_downloads"
+      "files",
+      "downloads"
     ],
     metadata: {
       ...params.metadata ?? {},
       build_kind: packet.build_kind,
-      artifact_type: packet.artifact_type
+      deliverable_type: packet.deliverable_type
     }
   });
 }
@@ -9986,6 +10069,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, Templates, Tenant, TimeoutError, TokenRefreshFailedError, Usage, UserAuthorizationRequiredError, ValidationError, Volumes, Webhooks, WorkspaceInvites, WorkspaceMembers, createAgentBuildExecutionPacket, createAgentBuildOutputContract, createAgentBuildPrompt, createBuildAgentRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
+export { AGENT_BUILD_KIND_SPECS, Admin, 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, RunGroups, Runs, RuntimeCapabilitiesResource, RuntimeEnv, SANDBOX_TEMPLATE, Sandbox, 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, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBuildRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map