@theokit/sdk 2.2.0 → 2.4.0

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts"],"names":[],"mappings":";AAmBO,SAAS,cAAc,GAAA,EAAyB;AACrD,EAAA,IAAI,GAAA,CAAI,SAAS,WAAA,EAAa;AAC5B,IAAA,OAAO,EAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAI,OAAA,CAAQ,OAAA,CAChB,MAAA,CAAO,CAAC,UAA4D,KAAA,CAAM,IAAA,KAAS,MAAM,CAAA,CACzF,IAAI,CAAC,KAAA,KAAU,MAAM,IAAI,CAAA,CACzB,KAAK,EAAE,CAAA;AACZ;AASO,SAAS,gBAAgB,GAAA,EAAiC;AAC/D,EAAA,IAAI,GAAA,CAAI,SAAS,WAAA,EAAa;AAC5B,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAO,GAAA,CAAI,QAAQ,OAAA,CAAQ,MAAA,CAAO,CAAC,KAAA,KAAiC,KAAA,CAAM,SAAS,UAAU,CAAA;AAC/F;AAQO,SAAS,cAAc,IAAA,EAAqD;AACjF,EAAA,OAAO,IAAA,EAAM,SAAA;AACf","file":"messages.js","sourcesContent":["/**\n * Pure readers over the `SDKMessage` stream (M1-5).\n *\n * Promotes the proven first-party hand-roll (`../theocode/server/lib/sdk-mappers.ts`)\n * onto the SDK's own types so consumers stop re-implementing a wire-event mapper.\n * Every reader is pure: no I/O, no mutation of its input, deterministic.\n *\n * Public from the `@theokit/sdk/messages` sub-path. See `docs.md → Message readers`.\n */\n\nimport type { SDKMessage, ToolUseBlock } from \"./types/messages.js\";\nimport type { CostBreakdown } from \"./types/usage.js\";\n\n/**\n * Concatenate the text of an assistant message's `TextBlock`s.\n *\n * Returns `\"\"` for any non-assistant message (or an assistant with no text\n * blocks). `tool_use` blocks are ignored — only `text` blocks contribute.\n */\nexport function assistantText(msg: SDKMessage): string {\n  if (msg.type !== \"assistant\") {\n    return \"\";\n  }\n  return msg.message.content\n    .filter((block): block is Extract<typeof block, { type: \"text\" }> => block.type === \"text\")\n    .map((block) => block.text)\n    .join(\"\");\n}\n\n/**\n * Extract the `ToolUseBlock`s from an assistant message's content.\n *\n * Returns `[]` for any non-assistant message. This reads the assistant\n * message's content blocks — NOT the separate `SDKToolUseMessage`\n * (`type:\"tool_call\"`) lifecycle event, which is a different stream (ADR D2).\n */\nexport function extractToolUses(msg: SDKMessage): ToolUseBlock[] {\n  if (msg.type !== \"assistant\") {\n    return [];\n  }\n  return msg.message.content.filter((block): block is ToolUseBlock => block.type === \"tool_use\");\n}\n\n/**\n * Read the cost amount from a `CostBreakdown`, preserving the honesty contract\n * (repo ADR `D377-cost-status-closed-enum.md`): `amountUsd` is `number | undefined`\n * where `undefined` means \"cost unknown\" — distinct from a real `$0` (e.g. a\n * subscription-included route). NEVER coerced to 0.\n */\nexport function costAmountUsd(cost: CostBreakdown | undefined): number | undefined {\n  return cost?.amountUsd;\n}\n"]}

package/dist/models.cjs

@@ -0,0 +1,233 @@
+'use strict';
+
+// src/internal/llm/model-capabilities.ts
+var CONSERVATIVE_DEFAULTS = {
+  supportsVision: false,
+  supportsStructuredOutput: false,
+  supportsToolUse: false,
+  supportsCacheControl: false,
+  maxContextTokens: 4096,
+  maxOutputTokens: 4096
+};
+var EXACT = /* @__PURE__ */ new Map([
+  // OpenAI family
+  [
+    "openai/gpt-4o",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 128e3,
+      maxOutputTokens: 16384
+    }
+  ],
+  [
+    "openai/gpt-4o-mini",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 128e3,
+      maxOutputTokens: 16384
+    }
+  ],
+  [
+    "openai/gpt-4-turbo",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 128e3,
+      maxOutputTokens: 4096
+    }
+  ],
+  [
+    "openai/o1",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 1e5
+    }
+  ],
+  [
+    "openai/o3",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 1e5
+    }
+  ],
+  // Anthropic family
+  [
+    "anthropic/claude-opus-4",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 32e3
+    }
+  ],
+  [
+    "anthropic/claude-sonnet-4",
+    {
+      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
+    }
+  ],
+  [
+    "anthropic/claude-3-5-sonnet-latest",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 8192
+    }
+  ],
+  [
+    "anthropic/claude-3-5-haiku-latest",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 8192
+    }
+  ],
+  [
+    "anthropic/claude-3-haiku",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 4096
+    }
+  ],
+  [
+    "anthropic/claude-3-opus",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 4096
+    }
+  ]
+]);
+var ROUTING_PREFIXES = ["openrouter/", "vertex/", "bedrock/"];
+function resolveModelCapabilities(modelId) {
+  const bare = stripVariantSuffix(stripRoutingPrefix(modelId));
+  const exact = EXACT.get(bare);
+  if (exact !== void 0) return exact;
+  const withVendor = inferVendorPrefix(bare);
+  if (withVendor !== bare) {
+    const vendored = EXACT.get(withVendor);
+    if (vendored !== void 0) return vendored;
+  }
+  return CONSERVATIVE_DEFAULTS;
+}
+function stripRoutingPrefix(modelId) {
+  for (const prefix of ROUTING_PREFIXES) {
+    if (modelId.startsWith(prefix)) return modelId.slice(prefix.length);
+  }
+  return modelId;
+}
+function stripVariantSuffix(modelId) {
+  const i = modelId.indexOf(":");
+  return i >= 0 ? modelId.slice(0, i) : modelId;
+}
+function inferVendorPrefix(bare) {
+  if (bare.startsWith("claude")) return `anthropic/${bare}`;
+  if (bare.startsWith("gpt-") || bare.startsWith("o1") || bare.startsWith("o3"))
+    return `openai/${bare}`;
+  if (bare.startsWith("gemini")) return `google/${bare}`;
+  return bare;
+}
+
+// src/internal/llm/model-identifier.ts
+var PROVIDER_ALIASES = {
+  "llama-cpp": "llamacpp",
+  "llama.cpp": "llamacpp",
+  "lm-studio": "lmstudio",
+  lm_studio: "lmstudio"
+};
+function parseModelId(modelId) {
+  if (modelId === void 0 || modelId.length === 0) {
+    return { provider: void 0, name: "" };
+  }
+  const slash = modelId.indexOf("/");
+  if (slash <= 0 || slash === modelId.length - 1) {
+    return { provider: void 0, name: modelId };
+  }
+  const rawProvider = modelId.slice(0, slash).trim().toLowerCase();
+  const name = modelId.slice(slash + 1).trim();
+  if (rawProvider.length === 0 || name.length === 0) {
+    return { provider: void 0, name: modelId };
+  }
+  const canonical = PROVIDER_ALIASES[rawProvider] ?? rawProvider;
+  return { provider: canonical, name };
+}
+
+// src/internal/llm/model-option.ts
+var ACRONYMS = /* @__PURE__ */ new Set(["gpt", "ai", "hd", "ui", "api", "sdk", "llm", "xl"]);
+function prettyToken(token) {
+  if (ACRONYMS.has(token.toLowerCase())) return token.toUpperCase();
+  return token.charAt(0).toUpperCase() + token.slice(1);
+}
+function humanizeModelName(modelId) {
+  const { name } = parseModelId(modelId);
+  if (name.length === 0) return "";
+  const colon = name.indexOf(":");
+  const base = (colon >= 0 ? name.slice(0, colon) : name).replace(/\/+$/, "");
+  const variant = colon >= 0 ? name.slice(colon + 1) : "";
+  const lastSlash = base.lastIndexOf("/");
+  const core = lastSlash >= 0 ? base.slice(lastSlash + 1) : base;
+  const label = core.split(/[-_.\s]+/).filter((t) => t.length > 0).map(prettyToken).join(" ");
+  if (label.length === 0) return variant;
+  return variant.length > 0 ? `${label} (${variant})` : label;
+}
+function toModelOption(modelId) {
+  return {
+    value: modelId,
+    label: humanizeModelName(modelId),
+    provider: parseModelId(modelId).provider
+  };
+}
+
+exports.humanizeModelName = humanizeModelName;
+exports.parseModelId = parseModelId;
+exports.resolveModelCapabilities = resolveModelCapabilities;
+exports.toModelOption = toModelOption;
+//# sourceMappingURL=models.cjs.map
+//# sourceMappingURL=models.cjs.map

package/dist/models.cjs.map

@@ -0,0 +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"]}

package/dist/models.d.cts

@@ -0,0 +1,16 @@
+/**
+ * `@theokit/sdk/models` — per-model capability catalog.
+ *
+ * `resolveModelCapabilities(modelId)` returns a model's capability flags +
+ * `maxContextTokens`/`maxOutputTokens` from a static, OFFLINE catalog (pure,
+ * sync, no network). It strips routing prefixes (`openrouter/`/`vertex/`/
+ * `bedrock/`) and OpenRouter `:variant` suffixes before lookup; unknown models
+ * get conservative defaults. The `maxContextTokens` value feeds the pre-call
+ * `shouldCompact` helper on `@theokit/sdk/compaction`.
+ *
+ * Also exposes model-id parsing + UI label helpers (M5-8): `parseModelId`,
+ * `humanizeModelName`, `toModelOption`.
+ */
+export { type ModelCapabilities, resolveModelCapabilities, } from "./internal/llm/model-capabilities.js";
+export { type ParsedModelId, parseModelId } from "./internal/llm/model-identifier.js";
+export { humanizeModelName, type ModelOption, toModelOption, } from "./internal/llm/model-option.js";

package/dist/models.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@theokit/sdk/models` — per-model capability catalog.
+ *
+ * `resolveModelCapabilities(modelId)` returns a model's capability flags +
+ * `maxContextTokens`/`maxOutputTokens` from a static, OFFLINE catalog (pure,
+ * sync, no network). It strips routing prefixes (`openrouter/`/`vertex/`/
+ * `bedrock/`) and OpenRouter `:variant` suffixes before lookup; unknown models
+ * get conservative defaults. The `maxContextTokens` value feeds the pre-call
+ * `shouldCompact` helper on `@theokit/sdk/compaction`.
+ *
+ * Also exposes model-id parsing + UI label helpers (M5-8): `parseModelId`,
+ * `humanizeModelName`, `toModelOption`.
+ */
+export { type ModelCapabilities, resolveModelCapabilities, } from "./internal/llm/model-capabilities.js";
+export { type ParsedModelId, parseModelId } from "./internal/llm/model-identifier.js";
+export { humanizeModelName, type ModelOption, toModelOption, } from "./internal/llm/model-option.js";

package/dist/models.js

@@ -0,0 +1,228 @@
+// src/internal/llm/model-capabilities.ts
+var CONSERVATIVE_DEFAULTS = {
+  supportsVision: false,
+  supportsStructuredOutput: false,
+  supportsToolUse: false,
+  supportsCacheControl: false,
+  maxContextTokens: 4096,
+  maxOutputTokens: 4096
+};
+var EXACT = /* @__PURE__ */ new Map([
+  // OpenAI family
+  [
+    "openai/gpt-4o",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 128e3,
+      maxOutputTokens: 16384
+    }
+  ],
+  [
+    "openai/gpt-4o-mini",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 128e3,
+      maxOutputTokens: 16384
+    }
+  ],
+  [
+    "openai/gpt-4-turbo",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 128e3,
+      maxOutputTokens: 4096
+    }
+  ],
+  [
+    "openai/o1",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 1e5
+    }
+  ],
+  [
+    "openai/o3",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsToolUse: true,
+      supportsCacheControl: false,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 1e5
+    }
+  ],
+  // Anthropic family
+  [
+    "anthropic/claude-opus-4",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 32e3
+    }
+  ],
+  [
+    "anthropic/claude-sonnet-4",
+    {
+      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
+    }
+  ],
+  [
+    "anthropic/claude-3-5-sonnet-latest",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 8192
+    }
+  ],
+  [
+    "anthropic/claude-3-5-haiku-latest",
+    {
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 8192
+    }
+  ],
+  [
+    "anthropic/claude-3-haiku",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 4096
+    }
+  ],
+  [
+    "anthropic/claude-3-opus",
+    {
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsToolUse: true,
+      supportsCacheControl: true,
+      maxContextTokens: 2e5,
+      maxOutputTokens: 4096
+    }
+  ]
+]);
+var ROUTING_PREFIXES = ["openrouter/", "vertex/", "bedrock/"];
+function resolveModelCapabilities(modelId) {
+  const bare = stripVariantSuffix(stripRoutingPrefix(modelId));
+  const exact = EXACT.get(bare);
+  if (exact !== void 0) return exact;
+  const withVendor = inferVendorPrefix(bare);
+  if (withVendor !== bare) {
+    const vendored = EXACT.get(withVendor);
+    if (vendored !== void 0) return vendored;
+  }
+  return CONSERVATIVE_DEFAULTS;
+}
+function stripRoutingPrefix(modelId) {
+  for (const prefix of ROUTING_PREFIXES) {
+    if (modelId.startsWith(prefix)) return modelId.slice(prefix.length);
+  }
+  return modelId;
+}
+function stripVariantSuffix(modelId) {
+  const i = modelId.indexOf(":");
+  return i >= 0 ? modelId.slice(0, i) : modelId;
+}
+function inferVendorPrefix(bare) {
+  if (bare.startsWith("claude")) return `anthropic/${bare}`;
+  if (bare.startsWith("gpt-") || bare.startsWith("o1") || bare.startsWith("o3"))
+    return `openai/${bare}`;
+  if (bare.startsWith("gemini")) return `google/${bare}`;
+  return bare;
+}
+
+// src/internal/llm/model-identifier.ts
+var PROVIDER_ALIASES = {
+  "llama-cpp": "llamacpp",
+  "llama.cpp": "llamacpp",
+  "lm-studio": "lmstudio",
+  lm_studio: "lmstudio"
+};
+function parseModelId(modelId) {
+  if (modelId === void 0 || modelId.length === 0) {
+    return { provider: void 0, name: "" };
+  }
+  const slash = modelId.indexOf("/");
+  if (slash <= 0 || slash === modelId.length - 1) {
+    return { provider: void 0, name: modelId };
+  }
+  const rawProvider = modelId.slice(0, slash).trim().toLowerCase();
+  const name = modelId.slice(slash + 1).trim();
+  if (rawProvider.length === 0 || name.length === 0) {
+    return { provider: void 0, name: modelId };
+  }
+  const canonical = PROVIDER_ALIASES[rawProvider] ?? rawProvider;
+  return { provider: canonical, name };
+}
+
+// src/internal/llm/model-option.ts
+var ACRONYMS = /* @__PURE__ */ new Set(["gpt", "ai", "hd", "ui", "api", "sdk", "llm", "xl"]);
+function prettyToken(token) {
+  if (ACRONYMS.has(token.toLowerCase())) return token.toUpperCase();
+  return token.charAt(0).toUpperCase() + token.slice(1);
+}
+function humanizeModelName(modelId) {
+  const { name } = parseModelId(modelId);
+  if (name.length === 0) return "";
+  const colon = name.indexOf(":");
+  const base = (colon >= 0 ? name.slice(0, colon) : name).replace(/\/+$/, "");
+  const variant = colon >= 0 ? name.slice(colon + 1) : "";
+  const lastSlash = base.lastIndexOf("/");
+  const core = lastSlash >= 0 ? base.slice(lastSlash + 1) : base;
+  const label = core.split(/[-_.\s]+/).filter((t) => t.length > 0).map(prettyToken).join(" ");
+  if (label.length === 0) return variant;
+  return variant.length > 0 ? `${label} (${variant})` : label;
+}
+function toModelOption(modelId) {
+  return {
+    value: modelId,
+    label: humanizeModelName(modelId),
+    provider: parseModelId(modelId).provider
+  };
+}
+
+export { humanizeModelName, parseModelId, resolveModelCapabilities, toModelOption };
+//# sourceMappingURL=models.js.map
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +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"]}