@aexhq/sdk 0.18.1 → 0.19.0

package/README.md

@@ -63,7 +63,7 @@ const aex = new AgentExecutor({
   // baseUrl defaults to https://api.aex.dev - set it for local or staging planes.
 });
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   system: "You are a concise automation agent.",
   prompt: "Write a short answer about agent-first SDK design.",
@@ -94,7 +94,7 @@ function summarise(topic: string) {
   };
 }
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   ...summarise("agent-first SDK design"),
   secrets: { apiKey: process.env.ANTHROPIC_API_KEY! }
 });

package/dist/_contracts/models.d.ts

@@ -1,20 +1,82 @@
 import type { RunProvider } from "./submission.js";
 /**
- * Closed set of model ids accepted by the public run-submission schema.
+ * Source of truth for the closed model set: each canonical model id maps to the
+ * upstream providers that can serve it and the **provider-native** model string
+ * each one expects.
  *
- * The provider-proxy still sends the model id through to the selected upstream
- * provider, but callers cannot submit arbitrary strings. Additions belong here
- * first so SDK types, CLI validation, docs examples, and platform parsing move
- * together.
+ * `Models.*` / `RUN_MODELS` are aex's own **canonical, provider-neutral**
+ * identifiers — they are NOT the strings sent to a provider. The platform
+ * translates a `(canonical model, provider)` pair to the native id via
+ * {@link resolveProviderModelId} when it builds the run's session manifest. The
+ * same canonical model can therefore be served by more than one provider (e.g.
+ * `gpt-4o-mini` via `openai` *or* `openrouter`), with a different native string
+ * per provider.
+ *
+ * Ordering matters: the **first** provider listed for a model is its default
+ * (see {@link providerForModel}) — list the native vendor before `openrouter`.
+ * Additions belong here first so SDK types, CLI validation, docs examples, and
+ * platform parsing all move together.
+ */
+export declare const MODEL_PROVIDER_IDS: {
+    readonly "claude-haiku-4-5": {
+        readonly anthropic: "claude-haiku-4-5";
+    };
+    readonly "claude-3-5-haiku-latest": {
+        readonly anthropic: "claude-3-5-haiku-latest";
+    };
+    readonly "claude-3-5-sonnet-latest": {
+        readonly anthropic: "claude-3-5-sonnet-latest";
+    };
+    readonly "deepseek-v4-flash": {
+        readonly deepseek: "deepseek-v4-flash";
+    };
+    readonly "deepseek-v4-pro": {
+        readonly deepseek: "deepseek-v4-pro";
+    };
+    readonly "deepseek-chat": {
+        readonly deepseek: "deepseek-chat";
+    };
+    readonly "deepseek-reasoner": {
+        readonly deepseek: "deepseek-reasoner";
+    };
+    readonly "gpt-4.1": {
+        readonly openai: "gpt-4.1";
+    };
+    readonly "gpt-4o-mini": {
+        readonly openai: "gpt-4o-mini";
+        readonly openrouter: "openai/gpt-4o-mini";
+    };
+    readonly "gpt-4o": {
+        readonly openrouter: "openai/gpt-4o";
+    };
+    readonly "gemini-2.0-flash": {
+        readonly gemini: "gemini-2.0-flash";
+        readonly openrouter: "google/gemini-2.0-flash-001";
+    };
+    readonly "gemini-2.5-flash": {
+        readonly gemini: "gemini-2.5-flash";
+    };
+    readonly "mistral-large-latest": {
+        readonly mistral: "mistral-large-latest";
+    };
+    readonly "mistral-small-latest": {
+        readonly mistral: "mistral-small-latest";
+    };
+};
+/**
+ * Closed set of canonical model ids accepted by the public run-submission
+ * schema. Derived from {@link MODEL_PROVIDER_IDS} so the two never drift.
  */
-export declare const RUN_MODELS: readonly ["claude-haiku-4-5", "claude-3-5-haiku-latest", "claude-3-5-sonnet-latest", "deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner", "gpt-4.1", "gpt-4o-mini", "gemini-2.0-flash", "gemini-2.5-flash", "mistral-large-latest", "mistral-small-latest", "openai/gpt-4o-mini", "openai/gpt-4o", "google/gemini-2.0-flash-001"];
-export type RunModel = (typeof RUN_MODELS)[number];
+export type RunModel = keyof typeof MODEL_PROVIDER_IDS;
+export declare const RUN_MODELS: readonly RunModel[];
 /**
  * Symbol-style accessors for the closed model set. Prefer these over raw
  * strings so an invalid token is a compile error, not a runtime 400 — e.g.
- * `Models.CLAUDE_HAIKU_4_5`. The upstream provider is a pure function of the
- * model ({@link providerForModel}), so picking a model fully determines
- * routing; callers never pass `provider` separately.
+ * `Models.CLAUDE_HAIKU_4_5`. These are aex's **canonical** ids, not the native
+ * strings sent upstream; the platform translates them per provider (see
+ * {@link MODEL_PROVIDER_IDS} / {@link resolveProviderModelId}). When a model is
+ * served by more than one provider, pair it with an explicit {@link Providers}
+ * value; otherwise the single (default) provider is used.
  */
 export declare const Models: {
     /** Claude Haiku 4.5 — Anthropic. */
@@ -42,9 +104,11 @@ export declare const Models: {
     readonly DEEPSEEK_REASONER: "deepseek-reasoner";
     /** GPT-4.1 — OpenAI. */
     readonly GPT_4_1: "gpt-4.1";
-    /** GPT-4o mini — OpenAI. */
+    /** GPT-4o mini — OpenAI, or via OpenRouter (`provider: Providers.OPENROUTER`). */
     readonly GPT_4O_MINI: "gpt-4o-mini";
-    /** Gemini 2.0 Flash — Gemini. */
+    /** GPT-4o — via OpenRouter (`provider: Providers.OPENROUTER`). */
+    readonly GPT_4O: "gpt-4o";
+    /** Gemini 2.0 Flash — Gemini, or via OpenRouter (`provider: Providers.OPENROUTER`). */
     readonly GEMINI_2_0_FLASH: "gemini-2.0-flash";
     /** Gemini 2.5 Flash — Gemini. */
     readonly GEMINI_2_5_FLASH: "gemini-2.5-flash";
@@ -52,12 +116,6 @@ export declare const Models: {
     readonly MISTRAL_LARGE_LATEST: "mistral-large-latest";
     /** Mistral Small (latest) — Mistral. */
     readonly MISTRAL_SMALL_LATEST: "mistral-small-latest";
-    /** GPT-4o mini via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-    readonly OPENROUTER_GPT_4O_MINI: "openai/gpt-4o-mini";
-    /** GPT-4o via OpenRouter (provider-prefixed) — stronger, tool-obedient. */
-    readonly OPENROUTER_GPT_4O: "openai/gpt-4o";
-    /** Gemini 2.0 Flash via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-    readonly OPENROUTER_GEMINI_2_0_FLASH: "google/gemini-2.0-flash-001";
 };
 /**
  * Back-compat alias for {@link Models}. Existing imports of `RunModels`
@@ -89,9 +147,11 @@ export declare const RunModels: {
     readonly DEEPSEEK_REASONER: "deepseek-reasoner";
     /** GPT-4.1 — OpenAI. */
     readonly GPT_4_1: "gpt-4.1";
-    /** GPT-4o mini — OpenAI. */
+    /** GPT-4o mini — OpenAI, or via OpenRouter (`provider: Providers.OPENROUTER`). */
     readonly GPT_4O_MINI: "gpt-4o-mini";
-    /** Gemini 2.0 Flash — Gemini. */
+    /** GPT-4o — via OpenRouter (`provider: Providers.OPENROUTER`). */
+    readonly GPT_4O: "gpt-4o";
+    /** Gemini 2.0 Flash — Gemini, or via OpenRouter (`provider: Providers.OPENROUTER`). */
     readonly GEMINI_2_0_FLASH: "gemini-2.0-flash";
     /** Gemini 2.5 Flash — Gemini. */
     readonly GEMINI_2_5_FLASH: "gemini-2.5-flash";
@@ -99,28 +159,31 @@ export declare const RunModels: {
     readonly MISTRAL_LARGE_LATEST: "mistral-large-latest";
     /** Mistral Small (latest) — Mistral. */
     readonly MISTRAL_SMALL_LATEST: "mistral-small-latest";
-    /** GPT-4o mini via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-    readonly OPENROUTER_GPT_4O_MINI: "openai/gpt-4o-mini";
-    /** GPT-4o via OpenRouter (provider-prefixed) — stronger, tool-obedient. */
-    readonly OPENROUTER_GPT_4O: "openai/gpt-4o";
-    /** Gemini 2.0 Flash via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-    readonly OPENROUTER_GEMINI_2_0_FLASH: "google/gemini-2.0-flash-001";
-};
-export declare const RUN_MODELS_BY_PROVIDER: {
-    readonly anthropic: readonly ["claude-haiku-4-5", "claude-3-5-haiku-latest", "claude-3-5-sonnet-latest"];
-    readonly deepseek: readonly ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
-    readonly openai: readonly ["gpt-4.1", "gpt-4o-mini"];
-    readonly gemini: readonly ["gemini-2.0-flash", "gemini-2.5-flash"];
-    readonly mistral: readonly ["mistral-large-latest", "mistral-small-latest"];
-    readonly openrouter: readonly ["openai/gpt-4o-mini", "openai/gpt-4o", "google/gemini-2.0-flash-001"];
 };
 /**
- * Resolve the upstream provider for a model id. Returns `undefined` when the
- * input is not a known {@link RunModel} (so the SDK can fall back to the
- * default and let the server reject the model). Total over the closed model
- * set, so any `RunModel` resolves.
+ * Provider → canonical models that provider can serve. Derived from
+ * {@link MODEL_PROVIDER_IDS}; every provider currently serves at least one
+ * model, so all {@link RunProvider} keys are present.
+ */
+export declare const RUN_MODELS_BY_PROVIDER: Readonly<Record<RunProvider, readonly RunModel[]>>;
+/**
+ * All upstream providers that can serve a model id, in declaration order.
+ * Returns `[]` for an unknown model.
+ */
+export declare function providersForModel(model: string): readonly RunProvider[];
+/**
+ * The default upstream provider for a model id — the first provider declared
+ * for it in {@link MODEL_PROVIDER_IDS}. Returns `undefined` when the input is
+ * not a known {@link RunModel} (so the SDK can fall back to the default and let
+ * the server reject the model).
  */
 export declare function providerForModel(model: string): RunProvider | undefined;
+/**
+ * Translate a canonical model id + provider into the provider-native model
+ * string the upstream API expects (e.g. `("gpt-4o-mini", "openrouter")` →
+ * `"openai/gpt-4o-mini"`). Throws when the provider does not serve the model.
+ */
+export declare function resolveProviderModelId(model: string, provider: RunProvider): string;
 export declare function isRunModel(input: unknown): input is RunModel;
 export declare function parseRunModel(input: unknown, field?: string): RunModel;
 export declare function assertRunModelMatchesProvider(provider: RunProvider, model: RunModel, field?: string): void;

package/dist/_contracts/models.js

@@ -1,35 +1,46 @@
 /**
- * Closed set of model ids accepted by the public run-submission schema.
+ * Source of truth for the closed model set: each canonical model id maps to the
+ * upstream providers that can serve it and the **provider-native** model string
+ * each one expects.
  *
- * The provider-proxy still sends the model id through to the selected upstream
- * provider, but callers cannot submit arbitrary strings. Additions belong here
- * first so SDK types, CLI validation, docs examples, and platform parsing move
- * together.
+ * `Models.*` / `RUN_MODELS` are aex's own **canonical, provider-neutral**
+ * identifiers — they are NOT the strings sent to a provider. The platform
+ * translates a `(canonical model, provider)` pair to the native id via
+ * {@link resolveProviderModelId} when it builds the run's session manifest. The
+ * same canonical model can therefore be served by more than one provider (e.g.
+ * `gpt-4o-mini` via `openai` *or* `openrouter`), with a different native string
+ * per provider.
+ *
+ * Ordering matters: the **first** provider listed for a model is its default
+ * (see {@link providerForModel}) — list the native vendor before `openrouter`.
+ * Additions belong here first so SDK types, CLI validation, docs examples, and
+ * platform parsing all move together.
  */
-export const RUN_MODELS = [
-    "claude-haiku-4-5",
-    "claude-3-5-haiku-latest",
-    "claude-3-5-sonnet-latest",
-    "deepseek-v4-flash",
-    "deepseek-v4-pro",
-    "deepseek-chat",
-    "deepseek-reasoner",
-    "gpt-4.1",
-    "gpt-4o-mini",
-    "gemini-2.0-flash",
-    "gemini-2.5-flash",
-    "mistral-large-latest",
-    "mistral-small-latest",
-    "openai/gpt-4o-mini",
-    "openai/gpt-4o",
-    "google/gemini-2.0-flash-001"
-];
+export const MODEL_PROVIDER_IDS = {
+    "claude-haiku-4-5": { anthropic: "claude-haiku-4-5" },
+    "claude-3-5-haiku-latest": { anthropic: "claude-3-5-haiku-latest" },
+    "claude-3-5-sonnet-latest": { anthropic: "claude-3-5-sonnet-latest" },
+    "deepseek-v4-flash": { deepseek: "deepseek-v4-flash" },
+    "deepseek-v4-pro": { deepseek: "deepseek-v4-pro" },
+    "deepseek-chat": { deepseek: "deepseek-chat" },
+    "deepseek-reasoner": { deepseek: "deepseek-reasoner" },
+    "gpt-4.1": { openai: "gpt-4.1" },
+    "gpt-4o-mini": { openai: "gpt-4o-mini", openrouter: "openai/gpt-4o-mini" },
+    "gpt-4o": { openrouter: "openai/gpt-4o" },
+    "gemini-2.0-flash": { gemini: "gemini-2.0-flash", openrouter: "google/gemini-2.0-flash-001" },
+    "gemini-2.5-flash": { gemini: "gemini-2.5-flash" },
+    "mistral-large-latest": { mistral: "mistral-large-latest" },
+    "mistral-small-latest": { mistral: "mistral-small-latest" }
+};
+export const RUN_MODELS = Object.keys(MODEL_PROVIDER_IDS);
 /**
  * Symbol-style accessors for the closed model set. Prefer these over raw
  * strings so an invalid token is a compile error, not a runtime 400 — e.g.
- * `Models.CLAUDE_HAIKU_4_5`. The upstream provider is a pure function of the
- * model ({@link providerForModel}), so picking a model fully determines
- * routing; callers never pass `provider` separately.
+ * `Models.CLAUDE_HAIKU_4_5`. These are aex's **canonical** ids, not the native
+ * strings sent upstream; the platform translates them per provider (see
+ * {@link MODEL_PROVIDER_IDS} / {@link resolveProviderModelId}). When a model is
+ * served by more than one provider, pair it with an explicit {@link Providers}
+ * value; otherwise the single (default) provider is used.
  */
 export const Models = {
     /** Claude Haiku 4.5 — Anthropic. */
@@ -57,71 +68,78 @@ export const Models = {
     DEEPSEEK_REASONER: "deepseek-reasoner",
     /** GPT-4.1 — OpenAI. */
     GPT_4_1: "gpt-4.1",
-    /** GPT-4o mini — OpenAI. */
+    /** GPT-4o mini — OpenAI, or via OpenRouter (`provider: Providers.OPENROUTER`). */
     GPT_4O_MINI: "gpt-4o-mini",
-    /** Gemini 2.0 Flash — Gemini. */
+    /** GPT-4o — via OpenRouter (`provider: Providers.OPENROUTER`). */
+    GPT_4O: "gpt-4o",
+    /** Gemini 2.0 Flash — Gemini, or via OpenRouter (`provider: Providers.OPENROUTER`). */
     GEMINI_2_0_FLASH: "gemini-2.0-flash",
     /** Gemini 2.5 Flash — Gemini. */
     GEMINI_2_5_FLASH: "gemini-2.5-flash",
     /** Mistral Large (latest) — Mistral. */
     MISTRAL_LARGE_LATEST: "mistral-large-latest",
     /** Mistral Small (latest) — Mistral. */
-    MISTRAL_SMALL_LATEST: "mistral-small-latest",
-    /** GPT-4o mini via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-    OPENROUTER_GPT_4O_MINI: "openai/gpt-4o-mini",
-    /** GPT-4o via OpenRouter (provider-prefixed) — stronger, tool-obedient. */
-    OPENROUTER_GPT_4O: "openai/gpt-4o",
-    /** Gemini 2.0 Flash via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-    OPENROUTER_GEMINI_2_0_FLASH: "google/gemini-2.0-flash-001"
+    MISTRAL_SMALL_LATEST: "mistral-small-latest"
 };
 /**
  * Back-compat alias for {@link Models}. Existing imports of `RunModels`
  * keep working; new code should prefer `Models`.
  */
 export const RunModels = Models;
-export const RUN_MODELS_BY_PROVIDER = {
-    anthropic: [
-        Models.CLAUDE_HAIKU_4_5,
-        Models.CLAUDE_3_5_HAIKU_LATEST,
-        Models.CLAUDE_3_5_SONNET_LATEST
-    ],
-    deepseek: [
-        Models.DEEPSEEK_V4_FLASH,
-        Models.DEEPSEEK_V4_PRO,
-        Models.DEEPSEEK_CHAT,
-        Models.DEEPSEEK_REASONER
-    ],
-    openai: [Models.GPT_4_1, Models.GPT_4O_MINI],
-    gemini: [Models.GEMINI_2_0_FLASH, Models.GEMINI_2_5_FLASH],
-    mistral: [Models.MISTRAL_LARGE_LATEST, Models.MISTRAL_SMALL_LATEST],
-    openrouter: [
-        Models.OPENROUTER_GPT_4O_MINI,
-        Models.OPENROUTER_GPT_4O,
-        Models.OPENROUTER_GEMINI_2_0_FLASH
-    ]
-};
 /**
- * Reverse index: every model id → its single upstream provider. Derived from
- * {@link RUN_MODELS_BY_PROVIDER} so the two never drift; each model appears
- * under exactly one provider.
+ * Per-model provider lists, in declaration order. Derived from
+ * {@link MODEL_PROVIDER_IDS} so the two never drift.
+ */
+const PROVIDERS_BY_MODEL = (() => {
+    const map = {};
+    for (const [model, providers] of Object.entries(MODEL_PROVIDER_IDS)) {
+        map[model] = Object.keys(providers);
+    }
+    return map;
+})();
+/**
+ * Provider → canonical models that provider can serve. Derived from
+ * {@link MODEL_PROVIDER_IDS}; every provider currently serves at least one
+ * model, so all {@link RunProvider} keys are present.
  */
-const PROVIDER_BY_MODEL = (() => {
+export const RUN_MODELS_BY_PROVIDER = (() => {
     const map = {};
-    for (const [provider, models] of Object.entries(RUN_MODELS_BY_PROVIDER)) {
-        for (const model of models) {
-            map[model] = provider;
+    for (const [model, providers] of Object.entries(MODEL_PROVIDER_IDS)) {
+        for (const provider of Object.keys(providers)) {
+            (map[provider] ??= []).push(model);
         }
     }
     return map;
 })();
 /**
- * Resolve the upstream provider for a model id. Returns `undefined` when the
- * input is not a known {@link RunModel} (so the SDK can fall back to the
- * default and let the server reject the model). Total over the closed model
- * set, so any `RunModel` resolves.
+ * All upstream providers that can serve a model id, in declaration order.
+ * Returns `[]` for an unknown model.
+ */
+export function providersForModel(model) {
+    return PROVIDERS_BY_MODEL[model] ?? [];
+}
+/**
+ * The default upstream provider for a model id — the first provider declared
+ * for it in {@link MODEL_PROVIDER_IDS}. Returns `undefined` when the input is
+ * not a known {@link RunModel} (so the SDK can fall back to the default and let
+ * the server reject the model).
  */
 export function providerForModel(model) {
-    return PROVIDER_BY_MODEL[model];
+    return providersForModel(model)[0];
+}
+/**
+ * Translate a canonical model id + provider into the provider-native model
+ * string the upstream API expects (e.g. `("gpt-4o-mini", "openrouter")` →
+ * `"openai/gpt-4o-mini"`). Throws when the provider does not serve the model.
+ */
+export function resolveProviderModelId(model, provider) {
+    const entry = MODEL_PROVIDER_IDS[model];
+    const native = entry?.[provider];
+    if (native === undefined) {
+        throw new Error(`resolveProviderModelId: model ${JSON.stringify(model)} is not available for provider ${JSON.stringify(provider)}; ` +
+            `available: ${providersForModel(model).join(", ") || "(none)"}`);
+    }
+    return native;
 }
 export function isRunModel(input) {
     return typeof input === "string" && RUN_MODELS.includes(input);
@@ -133,9 +151,10 @@ export function parseRunModel(input, field = "submission.model") {
     return input;
 }
 export function assertRunModelMatchesProvider(provider, model, field = "submission.model") {
-    if (!RUN_MODELS_BY_PROVIDER[provider].includes(model)) {
+    const providers = providersForModel(model);
+    if (!providers.includes(provider)) {
         throw new Error(`${field} ${JSON.stringify(model)} is not supported for provider ${provider}; ` +
-            `expected one of: ${RUN_MODELS_BY_PROVIDER[provider].join(", ")}`);
+            `expected one of: ${providers.join(", ")}`);
     }
 }
 //# sourceMappingURL=models.js.map

package/dist/_contracts/run-config.d.ts

@@ -251,7 +251,7 @@ export declare function rejectStdioMcpShape(record: Record<string, unknown>): vo
 /**
  * Plain JSON accepted by `aex run --config <path>`. This is not a
  * platform object; it is only the non-secret run parameters that the CLI folds
- * into the normal `submitRun` request.
+ * into the normal `submit` request.
  */
 export interface RunRequestConfig {
     readonly model: RunModel;

package/dist/_contracts/submission.d.ts

@@ -466,7 +466,7 @@ export declare class RuntimeValidationError extends Error {
 }
 /**
  * Walk the parsed submission and collect features that the active managed
- * runtime cannot serve. Provider-hosted skill refs (`Skill.provider(...)`) are
+ * runtime cannot serve. Provider-hosted skill refs (`kind:"provider"`) are
  * rejected now that new submissions only dispatch through managed runs.
  */
 export declare function collectManagedUnsupportedFeatures(req: PlatformRunSubmissionRequest): string[];

package/dist/_contracts/submission.js

@@ -1478,15 +1478,15 @@ export class RuntimeValidationError extends Error {
 }
 /**
  * Walk the parsed submission and collect features that the active managed
- * runtime cannot serve. Provider-hosted skill refs (`Skill.provider(...)`) are
+ * runtime cannot serve. Provider-hosted skill refs (`kind:"provider"`) are
  * rejected now that new submissions only dispatch through managed runs.
  */
 export function collectManagedUnsupportedFeatures(req) {
     const features = [];
     for (const skill of req.submission.skills) {
         if (skill.kind === "provider") {
-            const versionSuffix = skill.version ? `, "${skill.version}"` : "";
-            features.push(`Skill.provider("${skill.vendor}", "${skill.skillId}"${versionSuffix})`);
+            const versionSuffix = skill.version ? `@${skill.version}` : "";
+            features.push(`provider skill "${skill.vendor}/${skill.skillId}${versionSuffix}" (kind:"provider")`);
         }
     }
     return features;

package/dist/agents-md.d.ts

@@ -5,9 +5,9 @@ import type { AgentsMdRef } from "./_contracts/index.js";
  * behaviour).
  *
  *   const rules = await AgentsMd.fromContent("# Be helpful", { name: "rules" });
- *   await client.submitRun({ agentsMd: [rules], ... });
+ *   await client.submit({ agentsMd: [rules], ... });
  *
- * `client.submitRun` materializes the bytes to the hosted asset store before
+ * `client.submit` materializes the bytes to the hosted asset store before
  * the run lands. Asset deduplication handles repeated uploads automatically.
  */
 export declare class AgentsMd {
@@ -30,7 +30,7 @@ export declare class AgentsMd {
     }): Promise<AgentsMd>;
     /**
      * Internal: yield the draft's zipped bytes + metadata so
-     * `client.submitRun` can upload it as an asset.
+     * `client.submit` can upload it as an asset.
      */
     _takeDraftBundle(): {
         name: string;

package/dist/agents-md.js

@@ -7,9 +7,9 @@ import { strToU8, zipSync } from "fflate";
  * behaviour).
  *
  *   const rules = await AgentsMd.fromContent("# Be helpful", { name: "rules" });
- *   await client.submitRun({ agentsMd: [rules], ... });
+ *   await client.submit({ agentsMd: [rules], ... });
  *
- * `client.submitRun` materializes the bytes to the hosted asset store before
+ * `client.submit` materializes the bytes to the hosted asset store before
  * the run lands. Asset deduplication handles repeated uploads automatically.
  */
 export class AgentsMd {
@@ -53,12 +53,12 @@ export class AgentsMd {
     }
     /**
      * Internal: yield the draft's zipped bytes + metadata so
-     * `client.submitRun` can upload it as an asset.
+     * `client.submit` can upload it as an asset.
      */
     _takeDraftBundle() {
         if (this.#consumed) {
-            throw new Error("AgentsMd: cannot reuse a consumed AgentsMd in submitRun. Build a fresh one " +
-                "via AgentsMd.fromContent(...) / AgentsMd.fromPath(...) per submitRun call.");
+            throw new Error("AgentsMd: cannot reuse a consumed AgentsMd in submit. Build a fresh one " +
+                "via AgentsMd.fromContent(...) / AgentsMd.fromPath(...) per submit call.");
         }
         if (this.#ref.kind !== "draft" || !this.#zipBytes) {
             return undefined;
@@ -73,7 +73,7 @@ export class AgentsMd {
     toJSON() {
         if (this.#ref.kind === "draft") {
             throw new Error("AgentsMd: draft AgentsMd cannot be JSON-serialised — it only becomes a wire " +
-                "ref when client.submitRun uploads the bytes as an asset.");
+                "ref when client.submit uploads the bytes as an asset.");
         }
         return this.#ref;
     }

package/dist/agents-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"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"}

package/dist/cli.mjs

@@ -130,93 +130,35 @@ var PROVIDER_PUBLIC_SUPPORT = {
 };
 
 // ../contracts/dist/models.js
-var RUN_MODELS = [
-  "claude-haiku-4-5",
-  "claude-3-5-haiku-latest",
-  "claude-3-5-sonnet-latest",
-  "deepseek-v4-flash",
-  "deepseek-v4-pro",
-  "deepseek-chat",
-  "deepseek-reasoner",
-  "gpt-4.1",
-  "gpt-4o-mini",
-  "gemini-2.0-flash",
-  "gemini-2.5-flash",
-  "mistral-large-latest",
-  "mistral-small-latest",
-  "openai/gpt-4o-mini",
-  "openai/gpt-4o",
-  "google/gemini-2.0-flash-001"
-];
-var Models = {
-  /** Claude Haiku 4.5 — Anthropic. */
-  CLAUDE_HAIKU_4_5: "claude-haiku-4-5",
-  /** Claude 3.5 Haiku (latest) — Anthropic. */
-  CLAUDE_3_5_HAIKU_LATEST: "claude-3-5-haiku-latest",
-  /** Claude 3.5 Sonnet (latest) — Anthropic. */
-  CLAUDE_3_5_SONNET_LATEST: "claude-3-5-sonnet-latest",
-  /** DeepSeek V4 Flash — DeepSeek (non-thinking, fast). */
-  DEEPSEEK_V4_FLASH: "deepseek-v4-flash",
-  /** DeepSeek V4 Pro — DeepSeek (reasoning-heavy). */
-  DEEPSEEK_V4_PRO: "deepseek-v4-pro",
-  /**
-   * @deprecated Legacy alias DeepSeek routes to `deepseek-v4-flash` (non-thinking).
-   * DeepSeek removes this name on 2026-07-24 15:59 UTC — migrate to
-   * {@link Models.DEEPSEEK_V4_FLASH}.
-   */
-  DEEPSEEK_CHAT: "deepseek-chat",
-  /**
-   * @deprecated Legacy alias DeepSeek routes to `deepseek-v4-flash` (thinking).
-   * DeepSeek removes this name on 2026-07-24 15:59 UTC — migrate to
-   * {@link Models.DEEPSEEK_V4_FLASH} (or {@link Models.DEEPSEEK_V4_PRO} for
-   * heavier reasoning).
-   */
-  DEEPSEEK_REASONER: "deepseek-reasoner",
-  /** GPT-4.1 — OpenAI. */
-  GPT_4_1: "gpt-4.1",
-  /** GPT-4o mini — OpenAI. */
-  GPT_4O_MINI: "gpt-4o-mini",
-  /** Gemini 2.0 Flash — Gemini. */
-  GEMINI_2_0_FLASH: "gemini-2.0-flash",
-  /** Gemini 2.5 Flash — Gemini. */
-  GEMINI_2_5_FLASH: "gemini-2.5-flash",
-  /** Mistral Large (latest) — Mistral. */
-  MISTRAL_LARGE_LATEST: "mistral-large-latest",
-  /** Mistral Small (latest) — Mistral. */
-  MISTRAL_SMALL_LATEST: "mistral-small-latest",
-  /** GPT-4o mini via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-  OPENROUTER_GPT_4O_MINI: "openai/gpt-4o-mini",
-  /** GPT-4o via OpenRouter (provider-prefixed) — stronger, tool-obedient. */
-  OPENROUTER_GPT_4O: "openai/gpt-4o",
-  /** Gemini 2.0 Flash via OpenRouter (provider-prefixed) — cheap, tool-obedient. */
-  OPENROUTER_GEMINI_2_0_FLASH: "google/gemini-2.0-flash-001"
+var MODEL_PROVIDER_IDS = {
+  "claude-haiku-4-5": { anthropic: "claude-haiku-4-5" },
+  "claude-3-5-haiku-latest": { anthropic: "claude-3-5-haiku-latest" },
+  "claude-3-5-sonnet-latest": { anthropic: "claude-3-5-sonnet-latest" },
+  "deepseek-v4-flash": { deepseek: "deepseek-v4-flash" },
+  "deepseek-v4-pro": { deepseek: "deepseek-v4-pro" },
+  "deepseek-chat": { deepseek: "deepseek-chat" },
+  "deepseek-reasoner": { deepseek: "deepseek-reasoner" },
+  "gpt-4.1": { openai: "gpt-4.1" },
+  "gpt-4o-mini": { openai: "gpt-4o-mini", openrouter: "openai/gpt-4o-mini" },
+  "gpt-4o": { openrouter: "openai/gpt-4o" },
+  "gemini-2.0-flash": { gemini: "gemini-2.0-flash", openrouter: "google/gemini-2.0-flash-001" },
+  "gemini-2.5-flash": { gemini: "gemini-2.5-flash" },
+  "mistral-large-latest": { mistral: "mistral-large-latest" },
+  "mistral-small-latest": { mistral: "mistral-small-latest" }
 };
-var RUN_MODELS_BY_PROVIDER = {
-  anthropic: [
-    Models.CLAUDE_HAIKU_4_5,
-    Models.CLAUDE_3_5_HAIKU_LATEST,
-    Models.CLAUDE_3_5_SONNET_LATEST
-  ],
-  deepseek: [
-    Models.DEEPSEEK_V4_FLASH,
-    Models.DEEPSEEK_V4_PRO,
-    Models.DEEPSEEK_CHAT,
-    Models.DEEPSEEK_REASONER
-  ],
-  openai: [Models.GPT_4_1, Models.GPT_4O_MINI],
-  gemini: [Models.GEMINI_2_0_FLASH, Models.GEMINI_2_5_FLASH],
-  mistral: [Models.MISTRAL_LARGE_LATEST, Models.MISTRAL_SMALL_LATEST],
-  openrouter: [
-    Models.OPENROUTER_GPT_4O_MINI,
-    Models.OPENROUTER_GPT_4O,
-    Models.OPENROUTER_GEMINI_2_0_FLASH
-  ]
-};
-var PROVIDER_BY_MODEL = (() => {
+var RUN_MODELS = Object.keys(MODEL_PROVIDER_IDS);
+var PROVIDERS_BY_MODEL = (() => {
+  const map = {};
+  for (const [model, providers] of Object.entries(MODEL_PROVIDER_IDS)) {
+    map[model] = Object.keys(providers);
+  }
+  return map;
+})();
+var RUN_MODELS_BY_PROVIDER = (() => {
   const map = {};
-  for (const [provider, models] of Object.entries(RUN_MODELS_BY_PROVIDER)) {
-    for (const model of models) {
-      map[model] = provider;
+  for (const [model, providers] of Object.entries(MODEL_PROVIDER_IDS)) {
+    for (const provider of Object.keys(providers)) {
+      (map[provider] ??= []).push(model);
     }
   }
   return map;