@agentsky/sky 2.2.1 → 2.3.0

package/dist/{chunk-TMLNYYYY.js → chunk-2KQLWHHC.js}

@@ -19030,12 +19030,17 @@ var REASONING_EFFORTS = {
   kimi_code: null,
   opencode: ["none", "minimal", "low", "medium", "high", "xhigh", "max"]
 };
-function isEffortSupported(agentType, effort) {
-  const allowed = REASONING_EFFORTS[agentType];
+function reasoningEffortsForModel(agentType, model) {
+  const normalized = model?.split("/").at(-1);
+  if (normalized === "gpt-6.1-sol" && (agentType === "codex" || agentType === "hermes")) return ["low", "medium", "high", "xhigh", "max"];
+  return REASONING_EFFORTS[agentType];
+}
+function isModelEffortSupported(agentType, model, effort) {
+  const allowed = reasoningEffortsForModel(agentType, model);
   return allowed !== null && allowed.includes(effort);
 }
 function reasoningEffortDocLine() {
-  return Object.entries(REASONING_EFFORTS).map(([type, values]) => values ? `${type}: ${values.join("/")}` : `${type}: not supported`).join("; ");
+  return Object.entries(REASONING_EFFORTS).map(([type, values]) => values ? `${type}: ${values.join("/")}` : `${type}: not supported`).join("; ") + "; codex/hermes + gpt-6.1-sol: low/medium/high/xhigh/max";
 }
 
 // ../../packages/spec/src/acp-catalog.ts
@@ -21055,9 +21060,12 @@ function systemPlacementError(events) {
   }
   return null;
 }
-var sendEventsSchema = external_exports.object({ events: external_exports.array(sessionEventSchema).min(1).max(MAX_EVENTS_PER_REQUEST) }).strict().superRefine((body, ctx) => {
+var sendEventsSchema = external_exports.object({ events: external_exports.array(sessionEventSchema).min(1).max(MAX_EVENTS_PER_REQUEST), requireIdle: external_exports.boolean().optional() }).strict().superRefine((body, ctx) => {
   const error61 = systemPlacementError(body.events);
   if (error61) ctx.addIssue({ code: "custom", message: error61, path: ["events"] });
+  if (body.requireIdle && (body.events[0]?.type !== "user.message" || body.events.filter((event) => event.type === "user.message").length !== 1 || body.events.some((event) => event.type === "user.interrupt"))) {
+    ctx.addIssue({ code: "custom", message: "requireIdle accepts one user.message and an optional system.message", path: ["events"] });
+  }
 });
 var podMessageIdSchema = external_exports.string().regex(/^[A-Za-z0-9._:-]{1,128}$/);
 var podTurnBodySchema = external_exports.object({
@@ -21121,6 +21129,10 @@ var usageReportSchema = external_exports.object({
   basis: external_exports.enum(["provider", "estimated"]).default("provider"),
   interrupted: external_exports.boolean().default(false),
   durationMs: external_exports.number().int().min(0).nullish(),
+  /** Supplier request start, set by the trusted model gateway. */
+  occurredAt: external_exports.iso.datetime({ offset: true }).nullish(),
+  /** Trusted product origin captured by the model gateway at call start. */
+  promotionScope: external_exports.enum(["ANY", "PLAYGROUND"]).optional(),
   // RFC-0071 gateway-sourced fields; absent on pod reports.
   /** Vendor-assigned response id — auditable against the vendor. */
   upstreamRequestId: external_exports.string().max(200).nullish(),
@@ -21132,6 +21144,13 @@ var usageReportSchema = external_exports.object({
   usageRaw: external_exports.unknown().nullish()
 });
 
+// ../../packages/spec/src/connection-support.ts
+var CHANNEL_IDS = ["slack", "telegram", "whatsapp", "imessage", "discord", "lark", "teams", "x", "email", "gchat", "line", "buzz"];
+var connectionSupportSchema = external_exports.object({
+  channels: external_exports.union([external_exports.literal("all"), external_exports.array(external_exports.enum(CHANNEL_IDS)).transform((ids) => [...new Set(ids)])]),
+  connectors: external_exports.enum(["all", "none"])
+}).strict();
+
 // ../../packages/spec/src/index.ts
 var NATIVE_AGENT_TYPES = [
   "hermes",
@@ -21146,7 +21165,7 @@ var NATIVE_AGENT_TYPES = [
 ];
 var GENERAL_PURPOSE_NATIVE_AGENT_TYPES = NATIVE_AGENT_TYPES.filter((type) => type !== "jev");
 var AGENT_TYPES = [...NATIVE_AGENT_TYPES, ...ACP_AGENT_TYPES];
-var CAPABILITY_IDS = [
+var LEGACY_CAPABILITY_IDS = [
   "embedding.openai",
   "embedding.voyage",
   "rerank.voyage",
@@ -21179,6 +21198,25 @@ var CAPABILITY_IDS = [
   "minimax.h3",
   "fish-audio.transcribe"
 ];
+var GATEWAY_CAPABILITY_IDS = [
+  "exa.answer",
+  "googlemap.geocode",
+  "googlemap.places",
+  "agentmail.list-inboxes",
+  "social-boost.catalog",
+  "tinyfish.search",
+  "tinyfish.profile-list",
+  "meta.transcribe",
+  "minimax.tts",
+  "elevenlabs.sound",
+  "zai.transcribe",
+  "openai.transcribe",
+  "fish-audio.tts",
+  "google.image",
+  "openai.image-2.5",
+  "wan.image"
+];
+var CAPABILITY_IDS = [...LEGACY_CAPABILITY_IDS, ...GATEWAY_CAPABILITY_IDS];
 var allowedLlms = {
   jev: ["typesafe/jev-1.13"],
   agoragentic_acp: ["harness-default"],
@@ -21225,6 +21263,9 @@ var allowedLlms = {
   hermes: [
     "deepseek-v4-pro",
     "deepseek-flash",
+    "gpt-6.1-sol",
+    "gpt-6-sol",
+    "gpt-6-luna",
     "gpt-5.6-sol",
     "gpt-5.6-terra",
     "gpt-5.6-luna",
@@ -21235,6 +21276,7 @@ var allowedLlms = {
     "kimi-k3",
     "kimi-k2.7-code",
     "grok-4.6",
+    "claude-opus-5-5",
     "claude-opus-5",
     "claude-fable-5-1",
     "claude-sonnet-5",
@@ -21245,6 +21287,7 @@ var allowedLlms = {
     "deepseek-v4-flash"
   ],
   claude_code: [
+    "claude-opus-5-5",
     "claude-opus-5",
     "claude-fable-5-1",
     "claude-sonnet-5",
@@ -21254,6 +21297,9 @@ var allowedLlms = {
     "claude-fable-5"
   ],
   codex: [
+    "gpt-6.1-sol",
+    "gpt-6-sol",
+    "gpt-6-luna",
     "gpt-5.6-sol",
     "gpt-5.6-terra",
     "gpt-5.6-luna",
@@ -21276,6 +21322,7 @@ var allowedLlms = {
     "kimi-k3",
     "kimi-k2.7-code",
     "grok-4.6",
+    "claude-opus-5-5",
     "claude-opus-5",
     "claude-fable-5-1",
     "claude-sonnet-5",
@@ -21297,6 +21344,7 @@ var allowedLlms = {
     "kimi-k3",
     "kimi-k2.7-code",
     "grok-4.6",
+    "claude-opus-5-5",
     "claude-opus-5",
     "claude-fable-5-1",
     "claude-sonnet-5",
@@ -21328,6 +21376,7 @@ var allowedLlms = {
     "glm-5.3",
     "glm-5.3-flash",
     "grok-4.6",
+    "claude-opus-5-5",
     "claude-opus-5",
     "claude-fable-5-1",
     "claude-sonnet-5",
@@ -21348,6 +21397,7 @@ var allowedLlms = {
     "kimi-k3",
     "kimi-k2.7-code",
     "grok-4.6",
+    "claude-opus-5-5",
     "claude-opus-5",
     "claude-fable-5-1",
     "claude-sonnet-5",
@@ -21381,6 +21431,9 @@ var SELECTABLE_LLMS = [
 function isCompatible(agentType, llm) {
   return allowedLlms[agentType].includes(llm);
 }
+function defaultLlm(agentType) {
+  return allowedLlms[agentType][0];
+}
 function modelSubscriptionProviderFor(agentType, llm) {
   if (agentType === "claude_code" && llm.startsWith("claude-")) return "anthropic";
   if (agentType === "codex" && llm.startsWith("gpt-")) return "openai";
@@ -21577,14 +21630,21 @@ export {
   external_exports,
   splitMcpServers,
   mcpServersFromKept,
+  userMessageEventSchema,
+  systemMessageEventSchema,
   messagePartSchema,
   REASONING_EFFORT_VALUES,
-  isEffortSupported,
+  isModelEffortSupported,
   reasoningEffortDocLine,
+  sessionResourcesParamSchema,
   AGENT_TYPES,
   supersededBy,
+  defaultLlm,
   modelSubscriptionProviderFor,
   capabilitiesSchema,
+  instructionFileSchema,
   skillRefSchema,
+  skillsArraySchema,
+  mcpServersSchema,
   customDataSchema
 };

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -4,15 +4,16 @@ import {
   REASONING_EFFORT_VALUES,
   capabilitiesSchema,
   customDataSchema,
+  defaultLlm,
   external_exports,
-  isEffortSupported,
+  isModelEffortSupported,
   mcpServersFromKept,
   modelSubscriptionProviderFor,
   reasoningEffortDocLine,
   skillRefSchema,
   splitMcpServers,
   supersededBy
-} from "./chunk-TMLNYYYY.js";
+} from "./chunk-2KQLWHHC.js";
 
 // src/index.ts
 import { existsSync as existsSync4, writeFileSync as writeFileSync4 } from "fs";
@@ -60,7 +61,7 @@ function currentUniverse() {
 }
 
 // src/version.ts
-var CLI_VERSION = "2.2.1";
+var CLI_VERSION = "2.3.0";
 var USER_AGENT = `sky-cli/${CLI_VERSION} (${process.platform}; node/${process.versions.node})`;
 
 // src/api.ts
@@ -108,6 +109,7 @@ async function api(method, path, body, opts = {}) {
     body: body !== void 0 ? JSON.stringify(body) : void 0
   });
   if (!res.ok) await parseError(res);
+  if (res.status === 204) return void 0;
   return await res.json();
 }
 async function postEvents(sessionId, events, idempotencyKey) {
@@ -162,7 +164,7 @@ async function resolveSessionRef(ref) {
   return agent2.defaultSessionId;
 }
 async function* streamEvents(sessionId, signal) {
-  const { parseSseStream } = await import("./src-NNPV5GRJ.js");
+  const { parseSseStream } = await import("./src-EGXYUSME.js");
   const res = await fetch(
     `${apiBase()}/sessions/${encodeURIComponent(sessionId)}/stream`,
     {
@@ -341,7 +343,7 @@ function readAgentFile(path) {
     throw new Error(`${path}: ${issue?.path.join(".") ?? ""} ${issue?.message ?? "invalid"}`);
   }
   const file = parsed.data;
-  if (file.reasoning_effort && file.type && !isEffortSupported(file.type, file.reasoning_effort)) {
+  if (file.reasoning_effort && file.type && !isModelEffortSupported(file.type, file.llm ?? defaultLlm(file.type), file.reasoning_effort)) {
     throw new Error(
       `${path}: reasoning_effort '${file.reasoning_effort}' is not available for ${file.type} \u2014 ${reasoningEffortDocLine()}`
     );
@@ -1147,7 +1149,7 @@ function renderResource(r) {
   const ref = r.checkout ? `@${r.checkout.type === "branch" ? r.checkout.name : r.checkout.sha}` : "";
   return `${r.id}  repo  ${r.mount_path}  ${r.url}${ref}`;
 }
-session.command("create <agent>").description("create a session (the pod is provisioned now)").option("--title <title>", "session title").option("--message <text>", "seed the session and start its first turn").option("--vcpus <n>", "machine vCPUs: 1, 2, 4 or 8 (default 2)").option("--memory <mb>", "machine memory in MB, 256MB steps (default 4096)").option("--file <path...>", "mount local files read-only in the working directory: path[:/mount] (uploaded first)").option("--repo <url...>", "clone GitHub repositories into the working directory: https://github.com/{owner}/{repo}[@branch|@sha]").option("--repo-token <token>", "token for the --repo clones; compiled into the sandbox's egress policy, never sent to it").action(
+session.command("create <agent>").description("create a session (starts provisioning by default)").option("--title <title>", "session title").option("--message <text>", "start the first turn immediately, provisioning even with --deferred").option("--deferred", "leave the session idle without a pod until its first turn").option("--vcpus <n>", "machine vCPUs: 1, 2, 4 or 8 (default 2)").option("--memory <mb>", "machine memory in MB, 256MB steps (default 4096)").option("--file <path...>", "mount local files read-only in the working directory: path[:/mount] (uploaded first)").option("--repo <url...>", "clone GitHub repositories into the working directory: https://github.com/{owner}/{repo}[@branch|@sha]").option("--repo-token <token>", "token for the --repo clones; compiled into the sandbox's egress policy, never sent to it").action(
   run(
     async (agentRef, opts) => {
       const resources = await resourceParams(opts);
@@ -1156,6 +1158,7 @@ session.command("create <agent>").description("create a session (the pod is prov
         ...opts.title ? { title: opts.title } : {},
         ...opts.vcpus !== void 0 ? { vcpus: Number(opts.vcpus) } : {},
         ...opts.memory !== void 0 ? { memoryMb: Number(opts.memory) } : {},
+        ...opts.deferred ? { provision: "deferred" } : {},
         ...resources.length ? { resources } : {},
         ...opts.message ? { initial_events: [{ type: "user.message", content: [{ type: "text", text: opts.message }] }] } : {}
       });
@@ -1277,6 +1280,43 @@ sessionResources.command("rotate <ref> <rid> <token>").description("replace a re
     console.log(`Rotated ${updated.id}`);
   })
 );
+var sessionPorts = session.command("ports").description("local servers in the session's pod, each exposed on an origin of its own");
+var portsPath = (id) => `/sessions/${encodeURIComponent(id)}/ports`;
+function renderPort(p) {
+  return `${String(p.port).padEnd(5)}  ${p.visibility.padEnd(7)}  ${p.url}`;
+}
+sessionPorts.command("list <ref>").description("the session's exposed ports, oldest first").action(
+  run(async (ref) => {
+    const id = await resolveSessionRef(ref);
+    const { ports } = await api("GET", portsPath(id));
+    if (!ports.length) {
+      console.log("No exposed ports. `sky session ports expose <session> <port>` exposes one.");
+      return;
+    }
+    for (const p of ports) console.log(renderPort(p));
+  })
+);
+sessionPorts.command("expose <ref> <port>").description("expose a port the agent's local server listens on; prints its address").option("--public", "anyone with the address may open it; without it the port is private (only entry links admit a browser), and an already public port is made private again").action(
+  run(async (ref, port, opts) => {
+    const id = await resolveSessionRef(ref);
+    const exposed = await api("PUT", `${portsPath(id)}/${encodeURIComponent(port)}`, { visibility: opts.public ? "public" : "private" });
+    console.log(renderPort(exposed));
+  })
+);
+sessionPorts.command("open <ref> <port>").description("print an entry link for an exposed port \u2014 single-use and good for a minute on a private port").action(
+  run(async (ref, port) => {
+    const id = await resolveSessionRef(ref);
+    const grant = await api("POST", `${portsPath(id)}/${encodeURIComponent(port)}/grants`, {});
+    console.log(grant.url);
+  })
+);
+sessionPorts.command("revoke <ref> <port>").description("stop exposing a port; its address answers 404 from then on").action(
+  run(async (ref, port) => {
+    const id = await resolveSessionRef(ref);
+    await api("DELETE", `${portsPath(id)}/${encodeURIComponent(port)}`);
+    console.log(`Revoked port ${port}`);
+  })
+);
 async function uploadAttachments(opts) {
   const files2 = [];
   for (const path of [...opts.image ?? [], ...opts.file ?? []]) {

package/dist/products.d.ts

@@ -0,0 +1,585 @@
+import { z } from 'zod';
+
+declare const agentAddonsSchema: z.ZodObject<{
+    vault_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    environment_id: z.ZodOptional<z.ZodString>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        file_id: z.ZodString;
+        mount_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"github_repository">;
+        url: z.ZodString;
+        authorization_token: z.ZodOptional<z.ZodString>;
+        checkout: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"branch">;
+            name: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"commit">;
+            sha: z.ZodString;
+        }, z.core.$strip>], "type">>>;
+        mount_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>], "type">>>;
+    instructions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"skill">;
+        skillId: z.ZodString;
+        version: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"github">;
+        url: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        tokenSecretRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>>;
+    mcp_servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodDefault<z.ZodLiteral<"url">>;
+        name: z.ZodString;
+        url: z.ZodString;
+        tools: z.ZodOptional<z.ZodObject<{
+            include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    capabilities: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodEnum<{
+        "embedding.openai": "embedding.openai";
+        "embedding.voyage": "embedding.voyage";
+        "rerank.voyage": "rerank.voyage";
+        "ocr.mistral": "ocr.mistral";
+        "exa.search": "exa.search";
+        "exa.contents": "exa.contents";
+        "tinyfish.fetch": "tinyfish.fetch";
+        "tinyfish.browser": "tinyfish.browser";
+        "dataforseo.serp": "dataforseo.serp";
+        "dataforseo.ai-keywords": "dataforseo.ai-keywords";
+        "dataforseo.llm-responses": "dataforseo.llm-responses";
+        "dataforseo.app-info": "dataforseo.app-info";
+        "dataforseo.app-search": "dataforseo.app-search";
+        "dataforseo.backlinks": "dataforseo.backlinks";
+        "dataforseo.business-reviews": "dataforseo.business-reviews";
+        "dataforseo.business-pinterest": "dataforseo.business-pinterest";
+        "dataforseo.content-analysis": "dataforseo.content-analysis";
+        "dataforseo.technologies": "dataforseo.technologies";
+        "dataforseo.keyword-data": "dataforseo.keyword-data";
+        "dataforseo.labs": "dataforseo.labs";
+        "dataforseo.amazon": "dataforseo.amazon";
+        "dataforseo.onpage": "dataforseo.onpage";
+        "gptimage.generate": "gptimage.generate";
+        "rembg.remove-background": "rembg.remove-background";
+        "seedance.generate": "seedance.generate";
+        "mm.i2v": "mm.i2v";
+        "wan.t2v": "wan.t2v";
+        "wan.i2v": "wan.i2v";
+        "happyhorse.t2v": "happyhorse.t2v";
+        "minimax.h3": "minimax.h3";
+        "fish-audio.transcribe": "fish-audio.transcribe";
+        "exa.answer": "exa.answer";
+        "googlemap.geocode": "googlemap.geocode";
+        "googlemap.places": "googlemap.places";
+        "agentmail.list-inboxes": "agentmail.list-inboxes";
+        "social-boost.catalog": "social-boost.catalog";
+        "tinyfish.search": "tinyfish.search";
+        "tinyfish.profile-list": "tinyfish.profile-list";
+        "meta.transcribe": "meta.transcribe";
+        "minimax.tts": "minimax.tts";
+        "elevenlabs.sound": "elevenlabs.sound";
+        "zai.transcribe": "zai.transcribe";
+        "openai.transcribe": "openai.transcribe";
+        "fish-audio.tts": "fish-audio.tts";
+        "google.image": "google.image";
+        "openai.image-2.5": "openai.image-2.5";
+        "wan.image": "wan.image";
+    }>, unknown>>>>;
+    model: z.ZodOptional<z.ZodString>;
+    reasoning_effort: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        none: "none";
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+        ultra: "ultra";
+    }>>>;
+    vcpus: z.ZodOptional<z.ZodNumber>;
+    memory_mb: z.ZodOptional<z.ZodNumber>;
+    model_billing: z.ZodOptional<z.ZodEnum<{
+        platform: "platform";
+        account: "account";
+    }>>;
+    session_budget: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"limit">;
+        max_list_cost: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodLiteral<"USD">;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+declare const createProductAgentSchema: z.ZodObject<{
+    product: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    instructions: z.ZodOptional<z.ZodString>;
+    addons: z.ZodOptional<z.ZodObject<{
+        vault_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        environment_id: z.ZodOptional<z.ZodString>;
+        resources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            file_id: z.ZodString;
+            mount_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"github_repository">;
+            url: z.ZodString;
+            authorization_token: z.ZodOptional<z.ZodString>;
+            checkout: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"branch">;
+                name: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"commit">;
+                sha: z.ZodString;
+            }, z.core.$strip>], "type">>>;
+            mount_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>], "type">>>;
+        instructions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            content: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"skill">;
+            skillId: z.ZodString;
+            version: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"github">;
+            url: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            tokenSecretRef: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>>;
+        mcp_servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodDefault<z.ZodLiteral<"url">>;
+            name: z.ZodString;
+            url: z.ZodString;
+            tools: z.ZodOptional<z.ZodObject<{
+                include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        capabilities: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodEnum<{
+            "embedding.openai": "embedding.openai";
+            "embedding.voyage": "embedding.voyage";
+            "rerank.voyage": "rerank.voyage";
+            "ocr.mistral": "ocr.mistral";
+            "exa.search": "exa.search";
+            "exa.contents": "exa.contents";
+            "tinyfish.fetch": "tinyfish.fetch";
+            "tinyfish.browser": "tinyfish.browser";
+            "dataforseo.serp": "dataforseo.serp";
+            "dataforseo.ai-keywords": "dataforseo.ai-keywords";
+            "dataforseo.llm-responses": "dataforseo.llm-responses";
+            "dataforseo.app-info": "dataforseo.app-info";
+            "dataforseo.app-search": "dataforseo.app-search";
+            "dataforseo.backlinks": "dataforseo.backlinks";
+            "dataforseo.business-reviews": "dataforseo.business-reviews";
+            "dataforseo.business-pinterest": "dataforseo.business-pinterest";
+            "dataforseo.content-analysis": "dataforseo.content-analysis";
+            "dataforseo.technologies": "dataforseo.technologies";
+            "dataforseo.keyword-data": "dataforseo.keyword-data";
+            "dataforseo.labs": "dataforseo.labs";
+            "dataforseo.amazon": "dataforseo.amazon";
+            "dataforseo.onpage": "dataforseo.onpage";
+            "gptimage.generate": "gptimage.generate";
+            "rembg.remove-background": "rembg.remove-background";
+            "seedance.generate": "seedance.generate";
+            "mm.i2v": "mm.i2v";
+            "wan.t2v": "wan.t2v";
+            "wan.i2v": "wan.i2v";
+            "happyhorse.t2v": "happyhorse.t2v";
+            "minimax.h3": "minimax.h3";
+            "fish-audio.transcribe": "fish-audio.transcribe";
+            "exa.answer": "exa.answer";
+            "googlemap.geocode": "googlemap.geocode";
+            "googlemap.places": "googlemap.places";
+            "agentmail.list-inboxes": "agentmail.list-inboxes";
+            "social-boost.catalog": "social-boost.catalog";
+            "tinyfish.search": "tinyfish.search";
+            "tinyfish.profile-list": "tinyfish.profile-list";
+            "meta.transcribe": "meta.transcribe";
+            "minimax.tts": "minimax.tts";
+            "elevenlabs.sound": "elevenlabs.sound";
+            "zai.transcribe": "zai.transcribe";
+            "openai.transcribe": "openai.transcribe";
+            "fish-audio.tts": "fish-audio.tts";
+            "google.image": "google.image";
+            "openai.image-2.5": "openai.image-2.5";
+            "wan.image": "wan.image";
+        }>, unknown>>>>;
+        model: z.ZodOptional<z.ZodString>;
+        reasoning_effort: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            none: "none";
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+            ultra: "ultra";
+        }>>>;
+        vcpus: z.ZodOptional<z.ZodNumber>;
+        memory_mb: z.ZodOptional<z.ZodNumber>;
+        model_billing: z.ZodOptional<z.ZodEnum<{
+            platform: "platform";
+            account: "account";
+        }>>;
+        session_budget: z.ZodOptional<z.ZodObject<{
+            type: z.ZodLiteral<"limit">;
+            max_list_cost: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodLiteral<"USD">;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+declare const prepareProductSessionSchema: z.ZodObject<{
+    product: z.ZodString;
+    addons: z.ZodOptional<z.ZodObject<{
+        vault_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        environment_id: z.ZodOptional<z.ZodString>;
+        resources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            file_id: z.ZodString;
+            mount_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"github_repository">;
+            url: z.ZodString;
+            authorization_token: z.ZodOptional<z.ZodString>;
+            checkout: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"branch">;
+                name: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"commit">;
+                sha: z.ZodString;
+            }, z.core.$strip>], "type">>>;
+            mount_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>], "type">>>;
+        instructions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            content: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"skill">;
+            skillId: z.ZodString;
+            version: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"github">;
+            url: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            tokenSecretRef: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>>;
+        mcp_servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodDefault<z.ZodLiteral<"url">>;
+            name: z.ZodString;
+            url: z.ZodString;
+            tools: z.ZodOptional<z.ZodObject<{
+                include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        capabilities: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodEnum<{
+            "embedding.openai": "embedding.openai";
+            "embedding.voyage": "embedding.voyage";
+            "rerank.voyage": "rerank.voyage";
+            "ocr.mistral": "ocr.mistral";
+            "exa.search": "exa.search";
+            "exa.contents": "exa.contents";
+            "tinyfish.fetch": "tinyfish.fetch";
+            "tinyfish.browser": "tinyfish.browser";
+            "dataforseo.serp": "dataforseo.serp";
+            "dataforseo.ai-keywords": "dataforseo.ai-keywords";
+            "dataforseo.llm-responses": "dataforseo.llm-responses";
+            "dataforseo.app-info": "dataforseo.app-info";
+            "dataforseo.app-search": "dataforseo.app-search";
+            "dataforseo.backlinks": "dataforseo.backlinks";
+            "dataforseo.business-reviews": "dataforseo.business-reviews";
+            "dataforseo.business-pinterest": "dataforseo.business-pinterest";
+            "dataforseo.content-analysis": "dataforseo.content-analysis";
+            "dataforseo.technologies": "dataforseo.technologies";
+            "dataforseo.keyword-data": "dataforseo.keyword-data";
+            "dataforseo.labs": "dataforseo.labs";
+            "dataforseo.amazon": "dataforseo.amazon";
+            "dataforseo.onpage": "dataforseo.onpage";
+            "gptimage.generate": "gptimage.generate";
+            "rembg.remove-background": "rembg.remove-background";
+            "seedance.generate": "seedance.generate";
+            "mm.i2v": "mm.i2v";
+            "wan.t2v": "wan.t2v";
+            "wan.i2v": "wan.i2v";
+            "happyhorse.t2v": "happyhorse.t2v";
+            "minimax.h3": "minimax.h3";
+            "fish-audio.transcribe": "fish-audio.transcribe";
+            "exa.answer": "exa.answer";
+            "googlemap.geocode": "googlemap.geocode";
+            "googlemap.places": "googlemap.places";
+            "agentmail.list-inboxes": "agentmail.list-inboxes";
+            "social-boost.catalog": "social-boost.catalog";
+            "tinyfish.search": "tinyfish.search";
+            "tinyfish.profile-list": "tinyfish.profile-list";
+            "meta.transcribe": "meta.transcribe";
+            "minimax.tts": "minimax.tts";
+            "elevenlabs.sound": "elevenlabs.sound";
+            "zai.transcribe": "zai.transcribe";
+            "openai.transcribe": "openai.transcribe";
+            "fish-audio.tts": "fish-audio.tts";
+            "google.image": "google.image";
+            "openai.image-2.5": "openai.image-2.5";
+            "wan.image": "wan.image";
+        }>, unknown>>>>;
+        model: z.ZodOptional<z.ZodString>;
+        reasoning_effort: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            none: "none";
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+            ultra: "ultra";
+        }>>>;
+        vcpus: z.ZodOptional<z.ZodNumber>;
+        memory_mb: z.ZodOptional<z.ZodNumber>;
+        model_billing: z.ZodOptional<z.ZodEnum<{
+            platform: "platform";
+            account: "account";
+        }>>;
+        session_budget: z.ZodOptional<z.ZodObject<{
+            type: z.ZodLiteral<"limit">;
+            max_list_cost: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodLiteral<"USD">;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>;
+    title: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+declare const createRunSchema: z.ZodObject<{
+    product: z.ZodString;
+    input: z.ZodUnknown & z.ZodType<{}, unknown, z.core.$ZodTypeInternals<{}, unknown>>;
+    addons: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    session_id: z.ZodOptional<z.ZodString>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+declare const runEventsSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"user.message">;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"base64">;
+                media_type: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                file_id: z.ZodString;
+            }, z.core.$strict>], "type">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"document">;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"base64">;
+                media_type: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                media_type: z.ZodDefault<z.ZodLiteral<"text/plain">>;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                file_id: z.ZodString;
+            }, z.core.$strict>], "type">;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"system.message">;
+        content: z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"user.interrupt">;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
+declare const publishProductSchema: z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type AgentAddons = z.infer<typeof agentAddonsSchema>;
+type CreateProductAgentInput = z.infer<typeof createProductAgentSchema>;
+type PrepareProductSessionInput = z.infer<typeof prepareProductSessionSchema>;
+type CreateRunInput = z.infer<typeof createRunSchema>;
+declare const publicRunSchema: z.ZodObject<{
+    id: z.ZodString;
+    product: z.ZodNullable<z.ZodString>;
+    session_id: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        queued: "queued";
+        running: "running";
+        waiting_input: "waiting_input";
+        stopping: "stopping";
+        completed: "completed";
+        interrupted: "interrupted";
+        failed: "failed";
+        blocked: "blocked";
+        reconciling: "reconciling";
+    }>;
+    output: z.ZodUnknown;
+    output_available: z.ZodOptional<z.ZodBoolean>;
+    usage: z.ZodUnknown;
+    billing: z.ZodUnknown;
+    error: z.ZodUnknown;
+    artifact: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        mediaType: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    source: z.ZodOptional<z.ZodObject<{
+        goal_id: z.ZodOptional<z.ZodString>;
+        iteration: z.ZodOptional<z.ZodNumber>;
+        routine_run_id: z.ZodOptional<z.ZodString>;
+        routine_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    created_at: z.ZodString;
+    completed_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type PublicRun = z.infer<typeof publicRunSchema>;
+
+declare const connectionSupportSchema: z.ZodObject<{
+    channels: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        line: "line";
+        email: "email";
+        slack: "slack";
+        telegram: "telegram";
+        whatsapp: "whatsapp";
+        imessage: "imessage";
+        discord: "discord";
+        lark: "lark";
+        teams: "teams";
+        x: "x";
+        gchat: "gchat";
+        buzz: "buzz";
+    }>>, z.ZodTransform<("line" | "email" | "slack" | "telegram" | "whatsapp" | "imessage" | "discord" | "lark" | "teams" | "x" | "gchat" | "buzz")[], ("line" | "email" | "slack" | "telegram" | "whatsapp" | "imessage" | "discord" | "lark" | "teams" | "x" | "gchat" | "buzz")[]>>]>;
+    connectors: z.ZodEnum<{
+        none: "none";
+        all: "all";
+    }>;
+}, z.core.$strict>;
+type ConnectionSupport = z.infer<typeof connectionSupportSchema>;
+
+type RunControlInput = z.infer<typeof runEventsSchema>;
+type PublishProductInput = z.infer<typeof publishProductSchema>;
+type ExecutionProjection = {
+    protocol: "legacy" | "runs";
+    generation: number;
+    product: string | null;
+    product_version: string | null;
+    active_run_id: string | null;
+    addons_revision: number;
+};
+type PreparedProductSession = {
+    id: string;
+    execution: ExecutionProjection;
+} & Record<string, unknown>;
+type ProductRequest = {
+    idempotencyKey: string;
+    signal?: AbortSignal;
+};
+type Product = {
+    id: string;
+    version: string | null;
+    kind: "agent" | "model" | "tool";
+    name: string;
+    agent_type?: string;
+    available: boolean;
+    customizable: boolean;
+    capabilities: {
+        session: boolean;
+        runs: boolean;
+        steering: boolean;
+        interrupt: boolean;
+        ordinary_session_preparation?: boolean;
+        runs_billing_modes?: string[];
+    };
+    pricing: unknown;
+    input_schema: object;
+    output_schema: object;
+    addons_schema: object;
+    native_operations?: object[];
+    connection_support?: ConnectionSupport;
+};
+type RunEvent = {
+    id: string;
+    run_id: string;
+    created_at: string;
+    type: string;
+    data: Record<string, unknown>;
+};
+type RunEventPage = {
+    events: RunEvent[];
+    cursor: string | null;
+};
+type RunObservation = {
+    cursor?: string;
+    signal?: AbortSignal;
+};
+type RunControlReceipt = {
+    run_id: string;
+    command_id: string;
+    status: string;
+};
+/** An API failure never implies that an admission or supplier execution was retried. */
+declare class ProductApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+/** Public product client. Persist the request and key before sending; replay them unchanged after an unknown result. */
+declare function createProductClient(options: {
+    token: string | (() => string | Promise<string>);
+    universe: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}): {
+    list(signal?: AbortSignal): Promise<Product[]>;
+    prepare(input: PrepareProductSessionInput, context: ProductRequest): Promise<PreparedProductSession>;
+    create(input: CreateProductAgentInput, context: ProductRequest): Promise<{
+        id: string;
+    } & Record<string, unknown>>;
+    publish(agentId: string, input: PublishProductInput, context: ProductRequest): Promise<{
+        product: string;
+        version: string;
+    }>;
+    delist(agentId: string, context: ProductRequest): Promise<{
+        product: string;
+        status: "delisted";
+    }>;
+    start(input: Omit<CreateRunInput, "stream">, context: ProductRequest): Promise<PublicRun>;
+    read(runId: string, signal?: AbortSignal): Promise<PublicRun>;
+    control(runId: string, input: RunControlInput, context: ProductRequest): Promise<RunControlReceipt>;
+    events(runId: string, context?: RunObservation): Promise<RunEventPage>;
+    observe(runId: string, context?: RunObservation): Promise<Response>;
+};
+
+export { type AgentAddons, type CreateProductAgentInput, type CreateRunInput, type ExecutionProjection, type PrepareProductSessionInput, type PreparedProductSession, type Product, ProductApiError, type ProductRequest, type PublicRun, type PublishProductInput, type RunControlInput, type RunControlReceipt, type RunEvent, type RunEventPage, type RunObservation, createProductClient };

package/dist/products.js

@@ -0,0 +1,207 @@
+import {
+  REASONING_EFFORT_VALUES,
+  capabilitiesSchema,
+  external_exports,
+  instructionFileSchema,
+  mcpServersSchema,
+  sessionResourcesParamSchema,
+  skillsArraySchema,
+  systemMessageEventSchema,
+  userMessageEventSchema
+} from "./chunk-2KQLWHHC.js";
+
+// ../../packages/spec/src/compatibility.ts
+var capabilityInputsSchema = capabilitiesSchema;
+
+// ../../packages/spec/src/products.ts
+var budgetSchema = external_exports.object({
+  type: external_exports.literal("limit"),
+  max_list_cost: external_exports.object({
+    amount: external_exports.string().min(1).max(15).describe('Whole US cents as an integer decimal string, e.g. "125" for $1.25'),
+    currency: external_exports.literal("USD")
+  })
+});
+var productRefSchema = external_exports.string().min(1).max(240);
+var agentAddonsSchema = external_exports.object({
+  vault_ids: external_exports.array(external_exports.string().min(1)).max(10).optional(),
+  environment_id: external_exports.string().min(1).optional(),
+  resources: sessionResourcesParamSchema.optional(),
+  instructions: external_exports.array(instructionFileSchema).max(20).optional(),
+  skills: skillsArraySchema.optional(),
+  mcp_servers: mcpServersSchema.optional(),
+  capabilities: capabilityInputsSchema.optional(),
+  model: external_exports.string().min(1).optional(),
+  reasoning_effort: external_exports.enum(REASONING_EFFORT_VALUES).nullable().optional(),
+  vcpus: external_exports.number().int().positive().optional(),
+  memory_mb: external_exports.number().int().positive().optional(),
+  model_billing: external_exports.enum(["platform", "account"]).optional(),
+  session_budget: budgetSchema.optional()
+}).strict();
+var modelAddonsSchema = external_exports.object({
+  max_output_tokens: external_exports.number().int().positive().optional(),
+  temperature: external_exports.number().finite().optional(),
+  top_p: external_exports.number().finite().optional(),
+  stop: external_exports.union([external_exports.string(), external_exports.array(external_exports.string())]).optional(),
+  response_format: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  tools: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())).optional(),
+  tool_choice: external_exports.union([external_exports.string(), external_exports.record(external_exports.string(), external_exports.unknown())]).optional()
+}).strict();
+var modelNativeEnvelopeSchema = external_exports.discriminatedUnion("wire", [
+  external_exports.object({ wire: external_exports.literal("openai"), path: external_exports.enum(["/v1/chat/completions", "/v1/responses", "/v1/embeddings"]), body: external_exports.record(external_exports.string(), external_exports.unknown()) }).strict(),
+  external_exports.object({ wire: external_exports.literal("anthropic"), path: external_exports.literal("/v1/messages"), body: external_exports.record(external_exports.string(), external_exports.unknown()) }).strict(),
+  external_exports.object({ wire: external_exports.literal("decisions"), path: external_exports.literal("/api/alpha/decisions"), body: external_exports.record(external_exports.string(), external_exports.unknown()) }).strict()
+]);
+var modelRunInputSchema = external_exports.union([external_exports.string().min(1), modelNativeEnvelopeSchema, external_exports.record(external_exports.string(), external_exports.unknown())]).superRefine((input, context) => {
+  if (typeof input === "object" && ["wire", "path", "body"].some((key) => key in input) && !modelNativeEnvelopeSchema.safeParse(input).success) {
+    context.addIssue({ code: "custom", message: "Native model envelopes require a registered wire, path and object body, with no additional fields" });
+  }
+});
+var createProductAgentSchema = external_exports.object({
+  product: productRefSchema,
+  name: external_exports.string().max(60).optional(),
+  instructions: external_exports.string().max(1e5).optional(),
+  addons: agentAddonsSchema.optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+}).strict();
+var prepareProductSessionSchema = external_exports.object({
+  product: productRefSchema,
+  addons: agentAddonsSchema.optional(),
+  title: external_exports.string().max(120).optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+}).strict();
+var createRunSchema = external_exports.object({
+  product: productRefSchema,
+  input: external_exports.unknown().refine((value) => value !== void 0 && value !== null, "input is required"),
+  addons: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  session_id: external_exports.string().min(1).optional(),
+  stream: external_exports.boolean().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+}).strict();
+var agentRunInputSchema = external_exports.union([
+  external_exports.string().min(1).max(5e5),
+  external_exports.object({ events: external_exports.array(external_exports.union([userMessageEventSchema, systemMessageEventSchema])).min(1).max(2).refine((events) => events[0]?.type === "user.message" && (events.length === 1 || events[1]?.type === "system.message"), "A Run starts with one user message and an optional trailing system message") }).strict()
+]);
+var runEventsSchema = external_exports.object({
+  events: external_exports.array(external_exports.union([
+    userMessageEventSchema,
+    systemMessageEventSchema,
+    external_exports.object({ type: external_exports.literal("user.interrupt") }).strict()
+  ])).min(1).max(2).refine(
+    (events) => events.length === 1 && events[0]?.type === "user.interrupt" || events[0]?.type === "user.message" && (events.length === 1 || events[1]?.type === "system.message"),
+    "Controls accept one interrupt or one user message with an optional trailing system message"
+  )
+}).strict();
+var publishProductSchema = external_exports.object({
+  slug: external_exports.string().regex(/^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/).max(180).optional(),
+  description: external_exports.string().max(2e3).optional()
+}).strict();
+var migrateSessionExecutionSchema = external_exports.object({
+  execution: external_exports.object({ product: productRefSchema, expected_generation: external_exports.number().int().min(0) }).strict()
+}).strict();
+var sessionAddonsPatchSchema = external_exports.object({
+  addons: external_exports.object({ skills: skillsArraySchema.optional(), capabilities: capabilityInputsSchema.optional() }).strict().refine((value) => value.skills !== void 0 || value.capabilities !== void 0, "Supply a skills or capabilities overlay"),
+  expected_addons_revision: external_exports.number().int().min(0),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+}).strict();
+var publicRunSchema = external_exports.object({
+  id: external_exports.string(),
+  product: external_exports.string().nullable(),
+  session_id: external_exports.string().nullable(),
+  status: external_exports.enum(["queued", "running", "waiting_input", "stopping", "completed", "interrupted", "failed", "blocked", "reconciling"]),
+  output: external_exports.unknown(),
+  output_available: external_exports.boolean().optional(),
+  usage: external_exports.unknown(),
+  billing: external_exports.unknown(),
+  error: external_exports.unknown(),
+  artifact: external_exports.object({ id: external_exports.string(), mediaType: external_exports.string(), url: external_exports.string().url() }).optional(),
+  source: external_exports.object({ goal_id: external_exports.string().optional(), iteration: external_exports.number().int().optional(), routine_run_id: external_exports.string().optional(), routine_id: external_exports.string().optional() }).optional(),
+  created_at: external_exports.string(),
+  completed_at: external_exports.string().nullable()
+});
+
+// src/products.ts
+var ProductApiError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "ProductApiError";
+  }
+  status;
+  code;
+};
+function createProductClient(options) {
+  const transport = options.fetch ?? fetch;
+  const base = (options.baseUrl ?? "https://api.agentsky.dev/v1").replace(/\/$/, "");
+  const pathId = (id) => encodeURIComponent(id);
+  async function request(method, path, body, requestOptions, stream = false) {
+    const serializedBody = body === void 0 ? void 0 : JSON.stringify(body);
+    const token = typeof options.token === "function" ? await options.token() : options.token;
+    const response = await transport(`${base}${path}`, {
+      method,
+      signal: requestOptions?.signal,
+      headers: {
+        authorization: `Bearer ${token}`,
+        "x-universe": options.universe,
+        ...body === void 0 ? {} : { "content-type": "application/json" },
+        ...stream ? { accept: "text/event-stream" } : {},
+        ...requestOptions?.idempotencyKey ? { "idempotency-key": requestOptions.idempotencyKey } : {}
+      },
+      ...serializedBody === void 0 ? {} : { body: serializedBody }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => null);
+      throw new ProductApiError(
+        response.status,
+        typeof error?.error?.code === "string" ? error.error.code : "http_error",
+        typeof error?.error?.message === "string" ? error.error.message : response.statusText
+      );
+    }
+    return response;
+  }
+  function admissionKey(value) {
+    if (typeof value?.idempotencyKey !== "string" || !/^[\x21-\x7e]{1,200}$/.test(value.idempotencyKey)) throw new Error("Provide a stable Idempotency-Key containing 1\u2013200 visible ASCII characters.");
+    return { idempotencyKey: value.idempotencyKey, signal: value.signal };
+  }
+  return {
+    async list(signal) {
+      return (await (await request("GET", "/products", void 0, { signal })).json()).products;
+    },
+    async prepare(input, context) {
+      const result = await (await request("POST", "/sessions", prepareProductSessionSchema.parse(input), admissionKey(context))).json();
+      return result.session;
+    },
+    async create(input, context) {
+      const result = await (await request("POST", "/agents", createProductAgentSchema.parse(input), admissionKey(context))).json();
+      return result.agent;
+    },
+    async publish(agentId, input, context) {
+      return (await request("POST", `/agents/${pathId(agentId)}/publish`, publishProductSchema.parse(input), admissionKey(context))).json();
+    },
+    async delist(agentId, context) {
+      return (await request("DELETE", `/agents/${pathId(agentId)}/publish`, void 0, admissionKey(context))).json();
+    },
+    async start(input, context) {
+      const response = await request("POST", "/runs", createRunSchema.parse({ ...input, stream: false }), admissionKey(context));
+      return (await response.json()).run;
+    },
+    async read(runId, signal) {
+      return (await (await request("GET", `/runs/${pathId(runId)}`, void 0, { signal })).json()).run;
+    },
+    async control(runId, input, context) {
+      return (await request("POST", `/runs/${pathId(runId)}/events`, runEventsSchema.parse(input), admissionKey(context))).json();
+    },
+    async events(runId, context = {}) {
+      const query = context.cursor ? `?cursor=${encodeURIComponent(context.cursor)}` : "";
+      return (await request("GET", `/runs/${pathId(runId)}/events${query}`, void 0, { signal: context.signal })).json();
+    },
+    async observe(runId, context = {}) {
+      const query = context.cursor ? `?cursor=${encodeURIComponent(context.cursor)}` : "";
+      return request("GET", `/runs/${pathId(runId)}/events${query}`, void 0, { signal: context.signal }, true);
+    }
+  };
+}
+export {
+  ProductApiError,
+  createProductClient
+};

package/dist/{src-NNPV5GRJ.js → src-EGXYUSME.js}

@@ -1,7 +1,7 @@
 import {
   external_exports,
   messagePartSchema
-} from "./chunk-TMLNYYYY.js";
+} from "./chunk-2KQLWHHC.js";
 
 // ../../packages/chat/src/stream.ts
 async function* parseSseStream(body) {
@@ -89,6 +89,7 @@ var internalEventSchema = external_exports.object({
   agentInstanceId: external_exports.string().min(1).optional(),
   message: external_exports.object({
     id: external_exports.string().optional(),
+    podId: external_exports.string().min(1).optional(),
     parts: external_exports.array(messagePartSchema).min(1)
   }).optional(),
   /** A pre-built lifecycle event from the web host (session.updated /
@@ -216,6 +217,7 @@ function textFromParts(parts) {
 function normalizeBaseUrl(baseUrl) {
   return baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
 }
+var PROMOTION_SCOPE_HEADER = "x-agentsky-promotion-scope";
 async function postSessionEvents(args) {
   const url = new URL(
     `/api/v1/sessions/${encodeURIComponent(args.sessionId)}/events`,
@@ -227,7 +229,9 @@ async function postSessionEvents(args) {
     headers: {
       authorization: `Bearer ${token}`,
       "content-type": "application/json",
-      ...args.idempotencyKey ? { "idempotency-key": args.idempotencyKey } : {}
+      ...args.idempotencyKey ? { "idempotency-key": args.idempotencyKey } : {},
+      ...args.routineRunId ? { "x-agentsky-routine-run": args.routineRunId } : {},
+      ...args.promotionScope ? { [PROMOTION_SCOPE_HEADER]: args.promotionScope } : {}
     },
     body,
     signal: AbortSignal.timeout(args.timeoutMs ?? 95e3)
@@ -261,6 +265,7 @@ async function readResult(response) {
   };
 }
 export {
+  PROMOTION_SCOPE_HEADER,
   classifyPodSendError,
   classifyPodSendStatus,
   getPodHealth,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentsky/sky",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "sky — the AgentSky developer CLI: launch and talk to long-lived agents from your terminal.",
   "license": "MIT",
   "type": "module",
@@ -15,13 +15,14 @@
   },
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsup src/index.ts --format esm --target node20 --clean",
+    "build": "tsup src/index.ts src/products.ts --format esm --target node20 --clean",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "commander": "^14.0.0",
-    "smol-toml": "^1.4.2"
+    "smol-toml": "^1.4.2",
+    "zod": "4.5.4"
   },
   "devDependencies": {
     "@agent/chat": "*",
@@ -30,14 +31,28 @@
     "tsup": "^8.5.0",
     "tsx": "^4.22.4",
     "typescript": "^5",
-    "vitest": "^3.0.0",
-    "zod": "^4.4.3"
+    "vitest": "^3.0.0"
   },
   "tsup": {
     "noExternal": [
       "@agent/chat",
       "@agent/spec",
       "zod"
-    ]
+    ],
+    "dts": {
+      "compilerOptions": {
+        "ignoreDeprecations": "6.0"
+      },
+      "resolve": [
+        "@agent/spec",
+        "@agent/spec/products"
+      ]
+    }
+  },
+  "exports": {
+    "./products": {
+      "types": "./dist/products.d.ts",
+      "import": "./dist/products.js"
+    }
   }
 }