@theokit/sdk 2.9.0 → 2.11.0

package/dist/internal/plugins/enabled-names.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/internal/plugins/enabled-names.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/models.cjs

@@ -66,6 +66,18 @@ var EXACT = /* @__PURE__ */ new Map([
       maxOutputTokens: 1e5
     }
   ],
+  [
+    // GPT-4.1 — 1M-context flagship; multimodal + structured output (RADAR #92.a).
+    "openai/gpt-4.1",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1047576,
+      maxOutputTokens: 32768
+    }
+  ],
   // Anthropic family
   [
     "anthropic/claude-opus-4",
@@ -143,6 +155,111 @@ var EXACT = /* @__PURE__ */ new Map([
       maxContextTokens: 2e5,
       maxOutputTokens: 4096
     }
+  ],
+  // Dot-form OpenRouter slugs theocode uses (RADAR #92.a). These are the same
+  // models as their dash-form siblings above; capability parity is intentional.
+  // Without these entries the dotted slugs fall through to the 4096 default
+  // (`anthropic/claude-3.5-sonnet` ≠ `anthropic/claude-3-5-sonnet`).
+  [
+    "anthropic/claude-opus-4.1",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 32e3
+    }
+  ],
+  [
+    "anthropic/claude-sonnet-4.5",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 16e3
+    }
+  ],
+  [
+    "anthropic/claude-3.5-sonnet",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 8192
+    }
+  ],
+  // Cheap OpenRouter slugs (RADAR #92.a) — previously fell to the 4096
+  // CONSERVATIVE default. toolUse on; vision/structuredOutput only for Gemini.
+  [
+    "qwen/qwen3-coder-30b-a3b-instruct",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 16e4,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "deepseek/deepseek-v4-flash",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1048576,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "deepseek/deepseek-v3.2",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 131072,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "z-ai/glm-4.7-flash",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 202752,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "google/gemini-2.5-flash-lite",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1048576,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "google/gemini-2.5-pro",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1048576,
+      maxOutputTokens: 8e3
+    }
   ]
 ]);
 var ROUTING_PREFIXES = ["openrouter/", "vertex/", "bedrock/"];

package/dist/models.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/internal/llm/model-capabilities.ts","../src/internal/llm/model-identifier.ts","../src/internal/llm/model-option.ts"],"names":[],"mappings":"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","file":"models.cjs","sourcesContent":["/**\n * T3.10c — Model capability registry (DR3 #17).\n *\n * Typed per-model flags that let the SDK gate features at the boundary\n * (before hitting the provider) instead of letting opaque 400s surface.\n *\n * Resolution algorithm:\n *   1. Strip routing prefixes (openrouter/, vertex/, bedrock/) AND the\n *      OpenRouter `:variant` suffix (:free/:nitro/…) to find the bare vendor id.\n *   2. Exact match in the `EXACT` catalog → return entry.\n *   3. Vendor inference (e.g., `claude-*` → `anthropic/claude-*`) → return entry.\n *   4. No match → conservative defaults (all false, minimum tokens).\n *\n * Module is internal, but `ModelCapabilities` + `resolveModelCapabilities` are\n * re-exported publicly via the `@theokit/sdk/models` subpath (see their @public tags).\n */\n\n/**\n * Per-model capability shape. Consumers use this to gate features at\n * the SDK boundary (before request construction, not after 400).\n *\n * @public\n */\nexport interface ModelCapabilities {\n  supportsVision: boolean;\n  supportsStructuredOutput: boolean;\n  supportsToolUse: boolean;\n  supportsCacheControl: boolean;\n  maxContextTokens: number;\n  maxOutputTokens: number;\n}\n\nconst CONSERVATIVE_DEFAULTS: ModelCapabilities = {\n  supportsVision: false,\n  supportsStructuredOutput: false,\n  supportsToolUse: false,\n  supportsCacheControl: false,\n  maxContextTokens: 4096,\n  maxOutputTokens: 4096,\n};\n\n/** Exact-match capability entries. Keys are `vendor/model` (no routing prefix). */\nconst EXACT: ReadonlyMap<string, ModelCapabilities> = new Map([\n  // OpenAI family\n  [\n    \"openai/gpt-4o\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4o-mini\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4-turbo\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"openai/o1\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  [\n    \"openai/o3\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  // Anthropic family\n  [\n    \"anthropic/claude-opus-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 32_000,\n    },\n  ],\n  [\n    \"anthropic/claude-sonnet-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 16_000,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet-latest\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-haiku-latest\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-haiku\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"anthropic/claude-3-opus\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n]);\n\n/** Routing prefixes to strip to find the underlying vendor model. */\nconst ROUTING_PREFIXES = [\"openrouter/\", \"vertex/\", \"bedrock/\"] as const;\n\n/**\n * Resolve per-model capability flags (vision/structured-output/tool-use/cache +\n * `maxContextTokens`/`maxOutputTokens`) for a model id. Pure, sync, offline (a\n * static catalog — no network). Strips routing prefixes (`openrouter/`/`vertex/`/\n * `bedrock/`) and OpenRouter `:variant` suffixes before lookup; unknown models get\n * conservative defaults. Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function resolveModelCapabilities(modelId: string): ModelCapabilities {\n  const bare = stripVariantSuffix(stripRoutingPrefix(modelId));\n  const exact = EXACT.get(bare);\n  if (exact !== undefined) return exact;\n  // Routing-prefixed models (vertex/claude-3-5-sonnet) strip to bare\n  // model name without vendor. Try inferring the vendor from the name.\n  const withVendor = inferVendorPrefix(bare);\n  if (withVendor !== bare) {\n    const vendored = EXACT.get(withVendor);\n    if (vendored !== undefined) return vendored;\n  }\n  return CONSERVATIVE_DEFAULTS;\n}\n\nfunction stripRoutingPrefix(modelId: string): string {\n  for (const prefix of ROUTING_PREFIXES) {\n    if (modelId.startsWith(prefix)) return modelId.slice(prefix.length);\n  }\n  return modelId;\n}\n\n/**\n * Strip an OpenRouter variant suffix (`:free`/`:nitro`/`:floor`/`:beta`/…) so the\n * catalog lookup hits the underlying model. Model slugs contain no `:` except the\n * variant separator, so cutting at the first `:` is safe.\n */\nfunction stripVariantSuffix(modelId: string): string {\n  const i = modelId.indexOf(\":\");\n  return i >= 0 ? modelId.slice(0, i) : modelId;\n}\n\n/** Infer vendor prefix from bare model name for routing-prefixed lookups. */\nfunction inferVendorPrefix(bare: string): string {\n  if (bare.startsWith(\"claude\")) return `anthropic/${bare}`;\n  if (bare.startsWith(\"gpt-\") || bare.startsWith(\"o1\") || bare.startsWith(\"o3\"))\n    return `openai/${bare}`;\n  if (bare.startsWith(\"gemini\")) return `google/${bare}`;\n  return bare;\n}\n","/**\n * Model identifier parsing (T1.2 follow-up, ADR D182 zero-config UX).\n *\n * SDK callers pass model strings like:\n *   - `\"ollama/llama3.2:3b\"`             → provider=\"ollama\", name=\"llama3.2:3b\"\n *   - `\"anthropic/claude-3-5-sonnet\"`    → provider=\"anthropic\", name=\"claude-3-5-sonnet\"\n *   - `\"openrouter/meta-llama/llama-3\"`  → provider=\"openrouter\", name=\"meta-llama/llama-3\"\n *   - `\"claude-sonnet-4-6\"`              → provider=undefined, name=\"claude-sonnet-4-6\"\n *\n * The first `/` separates the provider from the rest. Models with embedded\n * slashes (e.g. OpenRouter routing) keep the remainder intact. Tag suffixes\n * (`:latest`, `:3b`) are preserved as part of the name — Ollama expects them.\n *\n * **Returns `undefined` provider** when no `/` is present so callers can\n * fall back to env-var detection. Empty/whitespace components are treated\n * as no-prefix.\n *\n * Aligned with OpenClaw `extensions/ollama/src/discovery-shared.ts`\n * (`OLLAMA_PROVIDER_ID = \"ollama\"`) and Hermes `hermes_cli/providers.py`\n * (ALIASES table, `normalize_provider`).\n *\n * Public via `@theokit/sdk/models` (M5-8).\n *\n * @public\n */\n\nexport interface ParsedModelId {\n  /** Provider name extracted from the prefix (lowercase), or undefined. */\n  provider: string | undefined;\n  /** Model name to send to the provider — prefix stripped. */\n  name: string;\n}\n\n/** Provider aliases mirrored from Hermes `hermes_cli/providers.py` ALIASES. */\nconst PROVIDER_ALIASES: Readonly<Record<string, string>> = {\n  \"llama-cpp\": \"llamacpp\",\n  \"llama.cpp\": \"llamacpp\",\n  \"lm-studio\": \"lmstudio\",\n  lm_studio: \"lmstudio\",\n};\n\nexport function parseModelId(modelId: string | undefined): ParsedModelId {\n  if (modelId === undefined || modelId.length === 0) {\n    return { provider: undefined, name: \"\" };\n  }\n  const slash = modelId.indexOf(\"/\");\n  if (slash <= 0 || slash === modelId.length - 1) {\n    return { provider: undefined, name: modelId };\n  }\n  const rawProvider = modelId.slice(0, slash).trim().toLowerCase();\n  const name = modelId.slice(slash + 1).trim();\n  if (rawProvider.length === 0 || name.length === 0) {\n    return { provider: undefined, name: modelId };\n  }\n  const canonical = PROVIDER_ALIASES[rawProvider] ?? rawProvider;\n  return { provider: canonical, name };\n}\n","import { parseModelId } from \"./model-identifier.js\";\n\n/**\n * A UI-friendly model option — the shape a `<select>`/dropdown consumes.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport interface ModelOption {\n  /** The original model id (what you pass back to the SDK). */\n  value: string;\n  /** Best-effort human label (see {@link humanizeModelName}). */\n  label: string;\n  /** Provider from the slug prefix, or `undefined` when none. */\n  provider: string | undefined;\n}\n\n/** Tokens rendered upper-case rather than title-case. */\nconst ACRONYMS = new Set([\"gpt\", \"ai\", \"hd\", \"ui\", \"api\", \"sdk\", \"llm\", \"xl\"]);\n\nfunction prettyToken(token: string): string {\n  if (ACRONYMS.has(token.toLowerCase())) return token.toUpperCase();\n  return token.charAt(0).toUpperCase() + token.slice(1);\n}\n\n/**\n * Turn a model id into a best-effort human label: strip the routing/vendor\n * prefix to the core model segment, split on `-`/`_`/`.`/whitespace, title-case\n * each token (known acronyms upper-cased), and append an OpenRouter `:variant`\n * in parentheses. Deterministic, pure, dependency-free.\n *\n * Best-effort, NOT vendor-canonical: `\"anthropic/claude-3-5-sonnet\"` →\n * `\"Claude 3 5 Sonnet\"`. A UI wanting exact marketing names overrides per id.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function humanizeModelName(modelId: string): string {\n  const { name } = parseModelId(modelId);\n  if (name.length === 0) return \"\";\n  const colon = name.indexOf(\":\");\n  // Strip a trailing slash so a typo'd `gpt-4o/` keeps its name (not lost to an\n  // empty last segment).\n  const base = (colon >= 0 ? name.slice(0, colon) : name).replace(/\\/+$/, \"\");\n  const variant = colon >= 0 ? name.slice(colon + 1) : \"\";\n  const lastSlash = base.lastIndexOf(\"/\");\n  const core = lastSlash >= 0 ? base.slice(lastSlash + 1) : base;\n  const label = core\n    .split(/[-_.\\s]+/)\n    .filter((t) => t.length > 0)\n    .map(prettyToken)\n    .join(\" \");\n  if (label.length === 0) return variant; // no base label (e.g. \":free\") → bare variant\n  return variant.length > 0 ? `${label} (${variant})` : label;\n}\n\n/**\n * Build a {@link ModelOption} (`{ value, label, provider }`) for a model id —\n * a dropdown-ready entry composing {@link humanizeModelName} + `parseModelId`.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function toModelOption(modelId: string): ModelOption {\n  return {\n    value: modelId,\n    label: humanizeModelName(modelId),\n    provider: parseModelId(modelId).provider,\n  };\n}\n"]}
+{"version":3,"sources":["../src/internal/llm/model-capabilities.ts","../src/internal/llm/model-identifier.ts","../src/internal/llm/model-option.ts"],"names":[],"mappings":"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","file":"models.cjs","sourcesContent":["/**\n * T3.10c — Model capability registry (DR3 #17).\n *\n * Typed per-model flags that let the SDK gate features at the boundary\n * (before hitting the provider) instead of letting opaque 400s surface.\n *\n * Resolution algorithm:\n *   1. Strip routing prefixes (openrouter/, vertex/, bedrock/) AND the\n *      OpenRouter `:variant` suffix (:free/:nitro/…) to find the bare vendor id.\n *   2. Exact match in the `EXACT` catalog → return entry.\n *   3. Vendor inference (e.g., `claude-*` → `anthropic/claude-*`) → return entry.\n *   4. No match → conservative defaults (all false, minimum tokens).\n *\n * Module is internal, but `ModelCapabilities` + `resolveModelCapabilities` are\n * re-exported publicly via the `@theokit/sdk/models` subpath (see their @public tags).\n */\n\n/**\n * Per-model capability shape. Consumers use this to gate features at\n * the SDK boundary (before request construction, not after 400).\n *\n * @public\n */\nexport interface ModelCapabilities {\n  supportsVision: boolean;\n  supportsStructuredOutput: boolean;\n  supportsToolUse: boolean;\n  supportsCacheControl: boolean;\n  maxContextTokens: number;\n  maxOutputTokens: number;\n}\n\nconst CONSERVATIVE_DEFAULTS: ModelCapabilities = {\n  supportsVision: false,\n  supportsStructuredOutput: false,\n  supportsToolUse: false,\n  supportsCacheControl: false,\n  maxContextTokens: 4096,\n  maxOutputTokens: 4096,\n};\n\n/** Exact-match capability entries. Keys are `vendor/model` (no routing prefix). */\nconst EXACT: ReadonlyMap<string, ModelCapabilities> = new Map([\n  // OpenAI family\n  [\n    \"openai/gpt-4o\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4o-mini\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4-turbo\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"openai/o1\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  [\n    \"openai/o3\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  [\n    // GPT-4.1 — 1M-context flagship; multimodal + structured output (RADAR #92.a).\n    \"openai/gpt-4.1\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_047_576,\n      maxOutputTokens: 32_768,\n    },\n  ],\n  // Anthropic family\n  [\n    \"anthropic/claude-opus-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 32_000,\n    },\n  ],\n  [\n    \"anthropic/claude-sonnet-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 16_000,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet-latest\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-haiku-latest\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-haiku\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"anthropic/claude-3-opus\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  // Dot-form OpenRouter slugs theocode uses (RADAR #92.a). These are the same\n  // models as their dash-form siblings above; capability parity is intentional.\n  // Without these entries the dotted slugs fall through to the 4096 default\n  // (`anthropic/claude-3.5-sonnet` ≠ `anthropic/claude-3-5-sonnet`).\n  [\n    \"anthropic/claude-opus-4.1\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 32_000,\n    },\n  ],\n  [\n    \"anthropic/claude-sonnet-4.5\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 16_000,\n    },\n  ],\n  [\n    \"anthropic/claude-3.5-sonnet\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  // Cheap OpenRouter slugs (RADAR #92.a) — previously fell to the 4096\n  // CONSERVATIVE default. toolUse on; vision/structuredOutput only for Gemini.\n  [\n    \"qwen/qwen3-coder-30b-a3b-instruct\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 160_000,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"deepseek/deepseek-v4-flash\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_048_576,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"deepseek/deepseek-v3.2\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 131_072,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"z-ai/glm-4.7-flash\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 202_752,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"google/gemini-2.5-flash-lite\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_048_576,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"google/gemini-2.5-pro\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_048_576,\n      maxOutputTokens: 8000,\n    },\n  ],\n]);\n\n/** Routing prefixes to strip to find the underlying vendor model. */\nconst ROUTING_PREFIXES = [\"openrouter/\", \"vertex/\", \"bedrock/\"] as const;\n\n/**\n * Resolve per-model capability flags (vision/structured-output/tool-use/cache +\n * `maxContextTokens`/`maxOutputTokens`) for a model id. Pure, sync, offline (a\n * static catalog — no network). Strips routing prefixes (`openrouter/`/`vertex/`/\n * `bedrock/`) and OpenRouter `:variant` suffixes before lookup; unknown models get\n * conservative defaults. Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function resolveModelCapabilities(modelId: string): ModelCapabilities {\n  const bare = stripVariantSuffix(stripRoutingPrefix(modelId));\n  const exact = EXACT.get(bare);\n  if (exact !== undefined) return exact;\n  // Routing-prefixed models (vertex/claude-3-5-sonnet) strip to bare\n  // model name without vendor. Try inferring the vendor from the name.\n  const withVendor = inferVendorPrefix(bare);\n  if (withVendor !== bare) {\n    const vendored = EXACT.get(withVendor);\n    if (vendored !== undefined) return vendored;\n  }\n  return CONSERVATIVE_DEFAULTS;\n}\n\nfunction stripRoutingPrefix(modelId: string): string {\n  for (const prefix of ROUTING_PREFIXES) {\n    if (modelId.startsWith(prefix)) return modelId.slice(prefix.length);\n  }\n  return modelId;\n}\n\n/**\n * Strip an OpenRouter variant suffix (`:free`/`:nitro`/`:floor`/`:beta`/…) so the\n * catalog lookup hits the underlying model. Model slugs contain no `:` except the\n * variant separator, so cutting at the first `:` is safe.\n */\nfunction stripVariantSuffix(modelId: string): string {\n  const i = modelId.indexOf(\":\");\n  return i >= 0 ? modelId.slice(0, i) : modelId;\n}\n\n/** Infer vendor prefix from bare model name for routing-prefixed lookups. */\nfunction inferVendorPrefix(bare: string): string {\n  if (bare.startsWith(\"claude\")) return `anthropic/${bare}`;\n  if (bare.startsWith(\"gpt-\") || bare.startsWith(\"o1\") || bare.startsWith(\"o3\"))\n    return `openai/${bare}`;\n  if (bare.startsWith(\"gemini\")) return `google/${bare}`;\n  return bare;\n}\n","/**\n * Model identifier parsing (T1.2 follow-up, ADR D182 zero-config UX).\n *\n * SDK callers pass model strings like:\n *   - `\"ollama/llama3.2:3b\"`             → provider=\"ollama\", name=\"llama3.2:3b\"\n *   - `\"anthropic/claude-3-5-sonnet\"`    → provider=\"anthropic\", name=\"claude-3-5-sonnet\"\n *   - `\"openrouter/meta-llama/llama-3\"`  → provider=\"openrouter\", name=\"meta-llama/llama-3\"\n *   - `\"claude-sonnet-4-6\"`              → provider=undefined, name=\"claude-sonnet-4-6\"\n *\n * The first `/` separates the provider from the rest. Models with embedded\n * slashes (e.g. OpenRouter routing) keep the remainder intact. Tag suffixes\n * (`:latest`, `:3b`) are preserved as part of the name — Ollama expects them.\n *\n * **Returns `undefined` provider** when no `/` is present so callers can\n * fall back to env-var detection. Empty/whitespace components are treated\n * as no-prefix.\n *\n * Aligned with OpenClaw `extensions/ollama/src/discovery-shared.ts`\n * (`OLLAMA_PROVIDER_ID = \"ollama\"`) and Hermes `hermes_cli/providers.py`\n * (ALIASES table, `normalize_provider`).\n *\n * Public via `@theokit/sdk/models` (M5-8).\n *\n * @public\n */\n\nexport interface ParsedModelId {\n  /** Provider name extracted from the prefix (lowercase), or undefined. */\n  provider: string | undefined;\n  /** Model name to send to the provider — prefix stripped. */\n  name: string;\n}\n\n/** Provider aliases mirrored from Hermes `hermes_cli/providers.py` ALIASES. */\nconst PROVIDER_ALIASES: Readonly<Record<string, string>> = {\n  \"llama-cpp\": \"llamacpp\",\n  \"llama.cpp\": \"llamacpp\",\n  \"lm-studio\": \"lmstudio\",\n  lm_studio: \"lmstudio\",\n};\n\nexport function parseModelId(modelId: string | undefined): ParsedModelId {\n  if (modelId === undefined || modelId.length === 0) {\n    return { provider: undefined, name: \"\" };\n  }\n  const slash = modelId.indexOf(\"/\");\n  if (slash <= 0 || slash === modelId.length - 1) {\n    return { provider: undefined, name: modelId };\n  }\n  const rawProvider = modelId.slice(0, slash).trim().toLowerCase();\n  const name = modelId.slice(slash + 1).trim();\n  if (rawProvider.length === 0 || name.length === 0) {\n    return { provider: undefined, name: modelId };\n  }\n  const canonical = PROVIDER_ALIASES[rawProvider] ?? rawProvider;\n  return { provider: canonical, name };\n}\n","import { parseModelId } from \"./model-identifier.js\";\n\n/**\n * A UI-friendly model option — the shape a `<select>`/dropdown consumes.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport interface ModelOption {\n  /** The original model id (what you pass back to the SDK). */\n  value: string;\n  /** Best-effort human label (see {@link humanizeModelName}). */\n  label: string;\n  /** Provider from the slug prefix, or `undefined` when none. */\n  provider: string | undefined;\n}\n\n/** Tokens rendered upper-case rather than title-case. */\nconst ACRONYMS = new Set([\"gpt\", \"ai\", \"hd\", \"ui\", \"api\", \"sdk\", \"llm\", \"xl\"]);\n\nfunction prettyToken(token: string): string {\n  if (ACRONYMS.has(token.toLowerCase())) return token.toUpperCase();\n  return token.charAt(0).toUpperCase() + token.slice(1);\n}\n\n/**\n * Turn a model id into a best-effort human label: strip the routing/vendor\n * prefix to the core model segment, split on `-`/`_`/`.`/whitespace, title-case\n * each token (known acronyms upper-cased), and append an OpenRouter `:variant`\n * in parentheses. Deterministic, pure, dependency-free.\n *\n * Best-effort, NOT vendor-canonical: `\"anthropic/claude-3-5-sonnet\"` →\n * `\"Claude 3 5 Sonnet\"`. A UI wanting exact marketing names overrides per id.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function humanizeModelName(modelId: string): string {\n  const { name } = parseModelId(modelId);\n  if (name.length === 0) return \"\";\n  const colon = name.indexOf(\":\");\n  // Strip a trailing slash so a typo'd `gpt-4o/` keeps its name (not lost to an\n  // empty last segment).\n  const base = (colon >= 0 ? name.slice(0, colon) : name).replace(/\\/+$/, \"\");\n  const variant = colon >= 0 ? name.slice(colon + 1) : \"\";\n  const lastSlash = base.lastIndexOf(\"/\");\n  const core = lastSlash >= 0 ? base.slice(lastSlash + 1) : base;\n  const label = core\n    .split(/[-_.\\s]+/)\n    .filter((t) => t.length > 0)\n    .map(prettyToken)\n    .join(\" \");\n  if (label.length === 0) return variant; // no base label (e.g. \":free\") → bare variant\n  return variant.length > 0 ? `${label} (${variant})` : label;\n}\n\n/**\n * Build a {@link ModelOption} (`{ value, label, provider }`) for a model id —\n * a dropdown-ready entry composing {@link humanizeModelName} + `parseModelId`.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function toModelOption(modelId: string): ModelOption {\n  return {\n    value: modelId,\n    label: humanizeModelName(modelId),\n    provider: parseModelId(modelId).provider,\n  };\n}\n"]}

package/dist/models.js

@@ -64,6 +64,18 @@ var EXACT = /* @__PURE__ */ new Map([
       maxOutputTokens: 1e5
     }
   ],
+  [
+    // GPT-4.1 — 1M-context flagship; multimodal + structured output (RADAR #92.a).
+    "openai/gpt-4.1",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1047576,
+      maxOutputTokens: 32768
+    }
+  ],
   // Anthropic family
   [
     "anthropic/claude-opus-4",
@@ -141,6 +153,111 @@ var EXACT = /* @__PURE__ */ new Map([
       maxContextTokens: 2e5,
       maxOutputTokens: 4096
     }
+  ],
+  // Dot-form OpenRouter slugs theocode uses (RADAR #92.a). These are the same
+  // models as their dash-form siblings above; capability parity is intentional.
+  // Without these entries the dotted slugs fall through to the 4096 default
+  // (`anthropic/claude-3.5-sonnet` ≠ `anthropic/claude-3-5-sonnet`).
+  [
+    "anthropic/claude-opus-4.1",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 32e3
+    }
+  ],
+  [
+    "anthropic/claude-sonnet-4.5",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 16e3
+    }
+  ],
+  [
+    "anthropic/claude-3.5-sonnet",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 8192
+    }
+  ],
+  // Cheap OpenRouter slugs (RADAR #92.a) — previously fell to the 4096
+  // CONSERVATIVE default. toolUse on; vision/structuredOutput only for Gemini.
+  [
+    "qwen/qwen3-coder-30b-a3b-instruct",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 16e4,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "deepseek/deepseek-v4-flash",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1048576,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "deepseek/deepseek-v3.2",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 131072,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "z-ai/glm-4.7-flash",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 202752,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "google/gemini-2.5-flash-lite",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1048576,
+      maxOutputTokens: 8e3
+    }
+  ],
+  [
+    "google/gemini-2.5-pro",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 1048576,
+      maxOutputTokens: 8e3
+    }
   ]
 ]);
 var ROUTING_PREFIXES = ["openrouter/", "vertex/", "bedrock/"];

package/dist/models.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/internal/llm/model-capabilities.ts","../src/internal/llm/model-identifier.ts","../src/internal/llm/model-option.ts"],"names":[],"mappings":"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","file":"models.js","sourcesContent":["/**\n * T3.10c — Model capability registry (DR3 #17).\n *\n * Typed per-model flags that let the SDK gate features at the boundary\n * (before hitting the provider) instead of letting opaque 400s surface.\n *\n * Resolution algorithm:\n *   1. Strip routing prefixes (openrouter/, vertex/, bedrock/) AND the\n *      OpenRouter `:variant` suffix (:free/:nitro/…) to find the bare vendor id.\n *   2. Exact match in the `EXACT` catalog → return entry.\n *   3. Vendor inference (e.g., `claude-*` → `anthropic/claude-*`) → return entry.\n *   4. No match → conservative defaults (all false, minimum tokens).\n *\n * Module is internal, but `ModelCapabilities` + `resolveModelCapabilities` are\n * re-exported publicly via the `@theokit/sdk/models` subpath (see their @public tags).\n */\n\n/**\n * Per-model capability shape. Consumers use this to gate features at\n * the SDK boundary (before request construction, not after 400).\n *\n * @public\n */\nexport interface ModelCapabilities {\n  supportsVision: boolean;\n  supportsStructuredOutput: boolean;\n  supportsToolUse: boolean;\n  supportsCacheControl: boolean;\n  maxContextTokens: number;\n  maxOutputTokens: number;\n}\n\nconst CONSERVATIVE_DEFAULTS: ModelCapabilities = {\n  supportsVision: false,\n  supportsStructuredOutput: false,\n  supportsToolUse: false,\n  supportsCacheControl: false,\n  maxContextTokens: 4096,\n  maxOutputTokens: 4096,\n};\n\n/** Exact-match capability entries. Keys are `vendor/model` (no routing prefix). */\nconst EXACT: ReadonlyMap<string, ModelCapabilities> = new Map([\n  // OpenAI family\n  [\n    \"openai/gpt-4o\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4o-mini\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4-turbo\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"openai/o1\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  [\n    \"openai/o3\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  // Anthropic family\n  [\n    \"anthropic/claude-opus-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 32_000,\n    },\n  ],\n  [\n    \"anthropic/claude-sonnet-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 16_000,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet-latest\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-haiku-latest\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-haiku\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"anthropic/claude-3-opus\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n]);\n\n/** Routing prefixes to strip to find the underlying vendor model. */\nconst ROUTING_PREFIXES = [\"openrouter/\", \"vertex/\", \"bedrock/\"] as const;\n\n/**\n * Resolve per-model capability flags (vision/structured-output/tool-use/cache +\n * `maxContextTokens`/`maxOutputTokens`) for a model id. Pure, sync, offline (a\n * static catalog — no network). Strips routing prefixes (`openrouter/`/`vertex/`/\n * `bedrock/`) and OpenRouter `:variant` suffixes before lookup; unknown models get\n * conservative defaults. Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function resolveModelCapabilities(modelId: string): ModelCapabilities {\n  const bare = stripVariantSuffix(stripRoutingPrefix(modelId));\n  const exact = EXACT.get(bare);\n  if (exact !== undefined) return exact;\n  // Routing-prefixed models (vertex/claude-3-5-sonnet) strip to bare\n  // model name without vendor. Try inferring the vendor from the name.\n  const withVendor = inferVendorPrefix(bare);\n  if (withVendor !== bare) {\n    const vendored = EXACT.get(withVendor);\n    if (vendored !== undefined) return vendored;\n  }\n  return CONSERVATIVE_DEFAULTS;\n}\n\nfunction stripRoutingPrefix(modelId: string): string {\n  for (const prefix of ROUTING_PREFIXES) {\n    if (modelId.startsWith(prefix)) return modelId.slice(prefix.length);\n  }\n  return modelId;\n}\n\n/**\n * Strip an OpenRouter variant suffix (`:free`/`:nitro`/`:floor`/`:beta`/…) so the\n * catalog lookup hits the underlying model. Model slugs contain no `:` except the\n * variant separator, so cutting at the first `:` is safe.\n */\nfunction stripVariantSuffix(modelId: string): string {\n  const i = modelId.indexOf(\":\");\n  return i >= 0 ? modelId.slice(0, i) : modelId;\n}\n\n/** Infer vendor prefix from bare model name for routing-prefixed lookups. */\nfunction inferVendorPrefix(bare: string): string {\n  if (bare.startsWith(\"claude\")) return `anthropic/${bare}`;\n  if (bare.startsWith(\"gpt-\") || bare.startsWith(\"o1\") || bare.startsWith(\"o3\"))\n    return `openai/${bare}`;\n  if (bare.startsWith(\"gemini\")) return `google/${bare}`;\n  return bare;\n}\n","/**\n * Model identifier parsing (T1.2 follow-up, ADR D182 zero-config UX).\n *\n * SDK callers pass model strings like:\n *   - `\"ollama/llama3.2:3b\"`             → provider=\"ollama\", name=\"llama3.2:3b\"\n *   - `\"anthropic/claude-3-5-sonnet\"`    → provider=\"anthropic\", name=\"claude-3-5-sonnet\"\n *   - `\"openrouter/meta-llama/llama-3\"`  → provider=\"openrouter\", name=\"meta-llama/llama-3\"\n *   - `\"claude-sonnet-4-6\"`              → provider=undefined, name=\"claude-sonnet-4-6\"\n *\n * The first `/` separates the provider from the rest. Models with embedded\n * slashes (e.g. OpenRouter routing) keep the remainder intact. Tag suffixes\n * (`:latest`, `:3b`) are preserved as part of the name — Ollama expects them.\n *\n * **Returns `undefined` provider** when no `/` is present so callers can\n * fall back to env-var detection. Empty/whitespace components are treated\n * as no-prefix.\n *\n * Aligned with OpenClaw `extensions/ollama/src/discovery-shared.ts`\n * (`OLLAMA_PROVIDER_ID = \"ollama\"`) and Hermes `hermes_cli/providers.py`\n * (ALIASES table, `normalize_provider`).\n *\n * Public via `@theokit/sdk/models` (M5-8).\n *\n * @public\n */\n\nexport interface ParsedModelId {\n  /** Provider name extracted from the prefix (lowercase), or undefined. */\n  provider: string | undefined;\n  /** Model name to send to the provider — prefix stripped. */\n  name: string;\n}\n\n/** Provider aliases mirrored from Hermes `hermes_cli/providers.py` ALIASES. */\nconst PROVIDER_ALIASES: Readonly<Record<string, string>> = {\n  \"llama-cpp\": \"llamacpp\",\n  \"llama.cpp\": \"llamacpp\",\n  \"lm-studio\": \"lmstudio\",\n  lm_studio: \"lmstudio\",\n};\n\nexport function parseModelId(modelId: string | undefined): ParsedModelId {\n  if (modelId === undefined || modelId.length === 0) {\n    return { provider: undefined, name: \"\" };\n  }\n  const slash = modelId.indexOf(\"/\");\n  if (slash <= 0 || slash === modelId.length - 1) {\n    return { provider: undefined, name: modelId };\n  }\n  const rawProvider = modelId.slice(0, slash).trim().toLowerCase();\n  const name = modelId.slice(slash + 1).trim();\n  if (rawProvider.length === 0 || name.length === 0) {\n    return { provider: undefined, name: modelId };\n  }\n  const canonical = PROVIDER_ALIASES[rawProvider] ?? rawProvider;\n  return { provider: canonical, name };\n}\n","import { parseModelId } from \"./model-identifier.js\";\n\n/**\n * A UI-friendly model option — the shape a `<select>`/dropdown consumes.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport interface ModelOption {\n  /** The original model id (what you pass back to the SDK). */\n  value: string;\n  /** Best-effort human label (see {@link humanizeModelName}). */\n  label: string;\n  /** Provider from the slug prefix, or `undefined` when none. */\n  provider: string | undefined;\n}\n\n/** Tokens rendered upper-case rather than title-case. */\nconst ACRONYMS = new Set([\"gpt\", \"ai\", \"hd\", \"ui\", \"api\", \"sdk\", \"llm\", \"xl\"]);\n\nfunction prettyToken(token: string): string {\n  if (ACRONYMS.has(token.toLowerCase())) return token.toUpperCase();\n  return token.charAt(0).toUpperCase() + token.slice(1);\n}\n\n/**\n * Turn a model id into a best-effort human label: strip the routing/vendor\n * prefix to the core model segment, split on `-`/`_`/`.`/whitespace, title-case\n * each token (known acronyms upper-cased), and append an OpenRouter `:variant`\n * in parentheses. Deterministic, pure, dependency-free.\n *\n * Best-effort, NOT vendor-canonical: `\"anthropic/claude-3-5-sonnet\"` →\n * `\"Claude 3 5 Sonnet\"`. A UI wanting exact marketing names overrides per id.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function humanizeModelName(modelId: string): string {\n  const { name } = parseModelId(modelId);\n  if (name.length === 0) return \"\";\n  const colon = name.indexOf(\":\");\n  // Strip a trailing slash so a typo'd `gpt-4o/` keeps its name (not lost to an\n  // empty last segment).\n  const base = (colon >= 0 ? name.slice(0, colon) : name).replace(/\\/+$/, \"\");\n  const variant = colon >= 0 ? name.slice(colon + 1) : \"\";\n  const lastSlash = base.lastIndexOf(\"/\");\n  const core = lastSlash >= 0 ? base.slice(lastSlash + 1) : base;\n  const label = core\n    .split(/[-_.\\s]+/)\n    .filter((t) => t.length > 0)\n    .map(prettyToken)\n    .join(\" \");\n  if (label.length === 0) return variant; // no base label (e.g. \":free\") → bare variant\n  return variant.length > 0 ? `${label} (${variant})` : label;\n}\n\n/**\n * Build a {@link ModelOption} (`{ value, label, provider }`) for a model id —\n * a dropdown-ready entry composing {@link humanizeModelName} + `parseModelId`.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function toModelOption(modelId: string): ModelOption {\n  return {\n    value: modelId,\n    label: humanizeModelName(modelId),\n    provider: parseModelId(modelId).provider,\n  };\n}\n"]}
+{"version":3,"sources":["../src/internal/llm/model-capabilities.ts","../src/internal/llm/model-identifier.ts","../src/internal/llm/model-option.ts"],"names":[],"mappings":"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","file":"models.js","sourcesContent":["/**\n * T3.10c — Model capability registry (DR3 #17).\n *\n * Typed per-model flags that let the SDK gate features at the boundary\n * (before hitting the provider) instead of letting opaque 400s surface.\n *\n * Resolution algorithm:\n *   1. Strip routing prefixes (openrouter/, vertex/, bedrock/) AND the\n *      OpenRouter `:variant` suffix (:free/:nitro/…) to find the bare vendor id.\n *   2. Exact match in the `EXACT` catalog → return entry.\n *   3. Vendor inference (e.g., `claude-*` → `anthropic/claude-*`) → return entry.\n *   4. No match → conservative defaults (all false, minimum tokens).\n *\n * Module is internal, but `ModelCapabilities` + `resolveModelCapabilities` are\n * re-exported publicly via the `@theokit/sdk/models` subpath (see their @public tags).\n */\n\n/**\n * Per-model capability shape. Consumers use this to gate features at\n * the SDK boundary (before request construction, not after 400).\n *\n * @public\n */\nexport interface ModelCapabilities {\n  supportsVision: boolean;\n  supportsStructuredOutput: boolean;\n  supportsToolUse: boolean;\n  supportsCacheControl: boolean;\n  maxContextTokens: number;\n  maxOutputTokens: number;\n}\n\nconst CONSERVATIVE_DEFAULTS: ModelCapabilities = {\n  supportsVision: false,\n  supportsStructuredOutput: false,\n  supportsToolUse: false,\n  supportsCacheControl: false,\n  maxContextTokens: 4096,\n  maxOutputTokens: 4096,\n};\n\n/** Exact-match capability entries. Keys are `vendor/model` (no routing prefix). */\nconst EXACT: ReadonlyMap<string, ModelCapabilities> = new Map([\n  // OpenAI family\n  [\n    \"openai/gpt-4o\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4o-mini\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 16_384,\n    },\n  ],\n  [\n    \"openai/gpt-4-turbo\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 128_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"openai/o1\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  [\n    \"openai/o3\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 100_000,\n    },\n  ],\n  [\n    // GPT-4.1 — 1M-context flagship; multimodal + structured output (RADAR #92.a).\n    \"openai/gpt-4.1\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_047_576,\n      maxOutputTokens: 32_768,\n    },\n  ],\n  // Anthropic family\n  [\n    \"anthropic/claude-opus-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 32_000,\n    },\n  ],\n  [\n    \"anthropic/claude-sonnet-4\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 16_000,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-sonnet-latest\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-5-haiku-latest\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  [\n    \"anthropic/claude-3-haiku\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  [\n    \"anthropic/claude-3-opus\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 4096,\n    },\n  ],\n  // Dot-form OpenRouter slugs theocode uses (RADAR #92.a). These are the same\n  // models as their dash-form siblings above; capability parity is intentional.\n  // Without these entries the dotted slugs fall through to the 4096 default\n  // (`anthropic/claude-3.5-sonnet` ≠ `anthropic/claude-3-5-sonnet`).\n  [\n    \"anthropic/claude-opus-4.1\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 32_000,\n    },\n  ],\n  [\n    \"anthropic/claude-sonnet-4.5\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 16_000,\n    },\n  ],\n  [\n    \"anthropic/claude-3.5-sonnet\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: true,\n      maxContextTokens: 200_000,\n      maxOutputTokens: 8192,\n    },\n  ],\n  // Cheap OpenRouter slugs (RADAR #92.a) — previously fell to the 4096\n  // CONSERVATIVE default. toolUse on; vision/structuredOutput only for Gemini.\n  [\n    \"qwen/qwen3-coder-30b-a3b-instruct\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 160_000,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"deepseek/deepseek-v4-flash\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_048_576,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"deepseek/deepseek-v3.2\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 131_072,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"z-ai/glm-4.7-flash\",\n    {\n      supportsVision: false,\n      supportsStructuredOutput: false,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 202_752,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"google/gemini-2.5-flash-lite\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_048_576,\n      maxOutputTokens: 8000,\n    },\n  ],\n  [\n    \"google/gemini-2.5-pro\",\n    {\n      supportsVision: true,\n      supportsStructuredOutput: true,\n      supportsToolUse: true,\n      supportsCacheControl: false,\n      maxContextTokens: 1_048_576,\n      maxOutputTokens: 8000,\n    },\n  ],\n]);\n\n/** Routing prefixes to strip to find the underlying vendor model. */\nconst ROUTING_PREFIXES = [\"openrouter/\", \"vertex/\", \"bedrock/\"] as const;\n\n/**\n * Resolve per-model capability flags (vision/structured-output/tool-use/cache +\n * `maxContextTokens`/`maxOutputTokens`) for a model id. Pure, sync, offline (a\n * static catalog — no network). Strips routing prefixes (`openrouter/`/`vertex/`/\n * `bedrock/`) and OpenRouter `:variant` suffixes before lookup; unknown models get\n * conservative defaults. Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function resolveModelCapabilities(modelId: string): ModelCapabilities {\n  const bare = stripVariantSuffix(stripRoutingPrefix(modelId));\n  const exact = EXACT.get(bare);\n  if (exact !== undefined) return exact;\n  // Routing-prefixed models (vertex/claude-3-5-sonnet) strip to bare\n  // model name without vendor. Try inferring the vendor from the name.\n  const withVendor = inferVendorPrefix(bare);\n  if (withVendor !== bare) {\n    const vendored = EXACT.get(withVendor);\n    if (vendored !== undefined) return vendored;\n  }\n  return CONSERVATIVE_DEFAULTS;\n}\n\nfunction stripRoutingPrefix(modelId: string): string {\n  for (const prefix of ROUTING_PREFIXES) {\n    if (modelId.startsWith(prefix)) return modelId.slice(prefix.length);\n  }\n  return modelId;\n}\n\n/**\n * Strip an OpenRouter variant suffix (`:free`/`:nitro`/`:floor`/`:beta`/…) so the\n * catalog lookup hits the underlying model. Model slugs contain no `:` except the\n * variant separator, so cutting at the first `:` is safe.\n */\nfunction stripVariantSuffix(modelId: string): string {\n  const i = modelId.indexOf(\":\");\n  return i >= 0 ? modelId.slice(0, i) : modelId;\n}\n\n/** Infer vendor prefix from bare model name for routing-prefixed lookups. */\nfunction inferVendorPrefix(bare: string): string {\n  if (bare.startsWith(\"claude\")) return `anthropic/${bare}`;\n  if (bare.startsWith(\"gpt-\") || bare.startsWith(\"o1\") || bare.startsWith(\"o3\"))\n    return `openai/${bare}`;\n  if (bare.startsWith(\"gemini\")) return `google/${bare}`;\n  return bare;\n}\n","/**\n * Model identifier parsing (T1.2 follow-up, ADR D182 zero-config UX).\n *\n * SDK callers pass model strings like:\n *   - `\"ollama/llama3.2:3b\"`             → provider=\"ollama\", name=\"llama3.2:3b\"\n *   - `\"anthropic/claude-3-5-sonnet\"`    → provider=\"anthropic\", name=\"claude-3-5-sonnet\"\n *   - `\"openrouter/meta-llama/llama-3\"`  → provider=\"openrouter\", name=\"meta-llama/llama-3\"\n *   - `\"claude-sonnet-4-6\"`              → provider=undefined, name=\"claude-sonnet-4-6\"\n *\n * The first `/` separates the provider from the rest. Models with embedded\n * slashes (e.g. OpenRouter routing) keep the remainder intact. Tag suffixes\n * (`:latest`, `:3b`) are preserved as part of the name — Ollama expects them.\n *\n * **Returns `undefined` provider** when no `/` is present so callers can\n * fall back to env-var detection. Empty/whitespace components are treated\n * as no-prefix.\n *\n * Aligned with OpenClaw `extensions/ollama/src/discovery-shared.ts`\n * (`OLLAMA_PROVIDER_ID = \"ollama\"`) and Hermes `hermes_cli/providers.py`\n * (ALIASES table, `normalize_provider`).\n *\n * Public via `@theokit/sdk/models` (M5-8).\n *\n * @public\n */\n\nexport interface ParsedModelId {\n  /** Provider name extracted from the prefix (lowercase), or undefined. */\n  provider: string | undefined;\n  /** Model name to send to the provider — prefix stripped. */\n  name: string;\n}\n\n/** Provider aliases mirrored from Hermes `hermes_cli/providers.py` ALIASES. */\nconst PROVIDER_ALIASES: Readonly<Record<string, string>> = {\n  \"llama-cpp\": \"llamacpp\",\n  \"llama.cpp\": \"llamacpp\",\n  \"lm-studio\": \"lmstudio\",\n  lm_studio: \"lmstudio\",\n};\n\nexport function parseModelId(modelId: string | undefined): ParsedModelId {\n  if (modelId === undefined || modelId.length === 0) {\n    return { provider: undefined, name: \"\" };\n  }\n  const slash = modelId.indexOf(\"/\");\n  if (slash <= 0 || slash === modelId.length - 1) {\n    return { provider: undefined, name: modelId };\n  }\n  const rawProvider = modelId.slice(0, slash).trim().toLowerCase();\n  const name = modelId.slice(slash + 1).trim();\n  if (rawProvider.length === 0 || name.length === 0) {\n    return { provider: undefined, name: modelId };\n  }\n  const canonical = PROVIDER_ALIASES[rawProvider] ?? rawProvider;\n  return { provider: canonical, name };\n}\n","import { parseModelId } from \"./model-identifier.js\";\n\n/**\n * A UI-friendly model option — the shape a `<select>`/dropdown consumes.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport interface ModelOption {\n  /** The original model id (what you pass back to the SDK). */\n  value: string;\n  /** Best-effort human label (see {@link humanizeModelName}). */\n  label: string;\n  /** Provider from the slug prefix, or `undefined` when none. */\n  provider: string | undefined;\n}\n\n/** Tokens rendered upper-case rather than title-case. */\nconst ACRONYMS = new Set([\"gpt\", \"ai\", \"hd\", \"ui\", \"api\", \"sdk\", \"llm\", \"xl\"]);\n\nfunction prettyToken(token: string): string {\n  if (ACRONYMS.has(token.toLowerCase())) return token.toUpperCase();\n  return token.charAt(0).toUpperCase() + token.slice(1);\n}\n\n/**\n * Turn a model id into a best-effort human label: strip the routing/vendor\n * prefix to the core model segment, split on `-`/`_`/`.`/whitespace, title-case\n * each token (known acronyms upper-cased), and append an OpenRouter `:variant`\n * in parentheses. Deterministic, pure, dependency-free.\n *\n * Best-effort, NOT vendor-canonical: `\"anthropic/claude-3-5-sonnet\"` →\n * `\"Claude 3 5 Sonnet\"`. A UI wanting exact marketing names overrides per id.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function humanizeModelName(modelId: string): string {\n  const { name } = parseModelId(modelId);\n  if (name.length === 0) return \"\";\n  const colon = name.indexOf(\":\");\n  // Strip a trailing slash so a typo'd `gpt-4o/` keeps its name (not lost to an\n  // empty last segment).\n  const base = (colon >= 0 ? name.slice(0, colon) : name).replace(/\\/+$/, \"\");\n  const variant = colon >= 0 ? name.slice(colon + 1) : \"\";\n  const lastSlash = base.lastIndexOf(\"/\");\n  const core = lastSlash >= 0 ? base.slice(lastSlash + 1) : base;\n  const label = core\n    .split(/[-_.\\s]+/)\n    .filter((t) => t.length > 0)\n    .map(prettyToken)\n    .join(\" \");\n  if (label.length === 0) return variant; // no base label (e.g. \":free\") → bare variant\n  return variant.length > 0 ? `${label} (${variant})` : label;\n}\n\n/**\n * Build a {@link ModelOption} (`{ value, label, provider }`) for a model id —\n * a dropdown-ready entry composing {@link humanizeModelName} + `parseModelId`.\n *\n * Public via `@theokit/sdk/models`.\n *\n * @public\n */\nexport function toModelOption(modelId: string): ModelOption {\n  return {\n    value: modelId,\n    label: humanizeModelName(modelId),\n    provider: parseModelId(modelId).provider,\n  };\n}\n"]}

package/dist/types/agent.d.ts

@@ -3,6 +3,7 @@ import type { McpServerConfig } from "./mcp.js";
 import type { PluginsSettings, ProviderRoutingSettings, SDKProvidersManager } from "./providers.js";
 import type { Run, SDKUserMessage, SendOptions } from "./run.js";
 export type { CustomTool, ModelParameterValue, ModelSelection } from "./agent-prims.js";
+import type { Plugin } from "../internal/plugins/types.js";
 import type { CustomTool, ModelSelection } from "./agent-prims.js";
 /**
  * Which on-disk settings layers a local agent loads.
@@ -306,8 +307,19 @@ export interface AgentOptions {
     context?: ContextSettings;
     /** Provider routing configuration. See `agent.providers`. */
     providers?: ProviderRoutingSettings;
-    /** Plugins to enable. Plugin sources must also be active via `local.settingSources`. */
-    plugins?: PluginsSettings;
+    /**
+     * Plugins for this agent, in one of two forms:
+     *
+     * - **Named-enable settings** — `{ enabled: ["name", ...] }`. Selects which
+     *   file-discovered plugin providers (under `.theokit/plugins/`) are active.
+     *   Plugin sources must also be active via `local.settingSources`.
+     * - **Code `Plugin` objects** — an array of `Plugin` instances, e.g.
+     *   `plugins: [Handoff.asPlugin({ ... })]`. These are registered directly by
+     *   the runtime (`extractCodePlugins`); no `settingSources` entry is needed.
+     *
+     * The two forms are mutually exclusive — pass one or the other.
+     */
+    plugins?: PluginsSettings | readonly Plugin[];
     /** Skills configuration. See `agent.skills`. */
     skills?: SkillsSettings;
     /** Memory configuration. Persists durable facts; auto-recalled on send. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.9.0",
+  "version": "2.11.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",