@ggui-ai/protocol 0.5.0-rc.1 → 0.6.0

package/dist/gadgets/stdlib-gadgets.d.ts

@@ -12,7 +12,7 @@ export declare const STDLIB_GADGETS_PACKAGE = "@ggui-ai/gadgets";
  * in `@ggui-ai/gadgets` asserts the two stay in sync, so a release-time
  * bump to the runtime package without updating this constant fails CI.
  */
-export declare const STDLIB_GADGETS_VERSION = "0.5.0-rc.1";
+export declare const STDLIB_GADGETS_VERSION = "0.6.0";
 /**
  * v1 catalog of stdlib gadget descriptors. Every entry's
  * `package` defaults to {@link STDLIB_GADGETS_PACKAGE}; the

package/dist/gadgets/stdlib-gadgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdlib-gadgets.d.ts","sourceRoot":"","sources":["../../src/gadgets/stdlib-gadgets.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,QAAQ,CAAC,gBAAgB,CAAC,EAkH/D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAUnD,CAAC"}
+{"version":3,"file":"stdlib-gadgets.d.ts","sourceRoot":"","sources":["../../src/gadgets/stdlib-gadgets.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,QAAQ,CAAC,gBAAgB,CAAC,EAkH/D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAUnD,CAAC"}

package/dist/gadgets/stdlib-gadgets.js

@@ -39,7 +39,7 @@ export const STDLIB_GADGETS_PACKAGE = '@ggui-ai/gadgets';
  * in `@ggui-ai/gadgets` asserts the two stay in sync, so a release-time
  * bump to the runtime package without updating this constant fails CI.
  */
-export const STDLIB_GADGETS_VERSION = '0.5.0-rc.1';
+export const STDLIB_GADGETS_VERSION = '0.6.0';
 /**
  * v1 catalog of stdlib gadget descriptors. Every entry's
  * `package` defaults to {@link STDLIB_GADGETS_PACKAGE}; the

package/dist/types/llm-route.d.ts

@@ -175,8 +175,8 @@ export declare function isValidLlmRoute(provider: string, model: string): boolea
  *     → `'anthropic:claude-haiku-4-5-20251001'`
  *   `{provider: 'bedrock', model: 'us.anthropic.claude-haiku-4-5-20251001-v1:0'}`
  *     → `'bedrock:us.anthropic.claude-haiku-4-5-20251001-v1:0'`
- *   `{provider: 'openrouter', model: 'anthropic/claude-3-5-sonnet'}`
- *     → `'openrouter:anthropic/claude-3-5-sonnet'`
+ *   `{provider: 'openrouter', model: 'anthropic/claude-haiku-4.5'}`
+ *     → `'openrouter:anthropic/claude-haiku-4.5'`
  */
 export declare function serializeLlmRoute(route: LlmRoute): string;
 /**
@@ -200,8 +200,8 @@ export declare function parseLlmRoute(serialized: string): LlmRoute | null;
  *   - `gemini/gemini-3.5-flash`    → `{google, gemini-3.5-flash}`
  *   - `openai/gpt-5.5-...`         → `{openai, gpt-5.5-...}`
  *   - `bedrock/us.anthropic...`    → `{bedrock, us.anthropic...}`
- *   - `openrouter/anthropic/claude-3-5-sonnet`
- *     → `{openrouter, anthropic/claude-3-5-sonnet}`
+ *   - `openrouter/anthropic/claude-haiku-4.5`
+ *     → `{openrouter, anthropic/claude-haiku-4.5}`
  *
  * Used at wire boundaries (ggui.json parser, CLI flag, env var) so
  * existing operator configs keep working without a forced migration.

package/dist/types/llm-route.js

@@ -262,7 +262,7 @@ export function isValidLlmRoute(provider, model) {
 /**
  * Canonical wire format separator. `:` chosen over `/` because
  * `/` collides with OpenRouter's own `<author>/<model>` form
- * (`openrouter/anthropic/claude-3-5-sonnet` has TWO slashes; ambiguous
+ * (`openrouter/anthropic/claude-haiku-4.5` has TWO slashes; ambiguous
  * to split). Bedrock's model string also contains `.` and `:` — `:`
  * is fine as the OUTER separator because the inner `:` is always
  * preceded by a `.` or alphanumerics; the FIRST `:` in the serialized
@@ -279,8 +279,8 @@ const CANONICAL_SEPARATOR = ':';
  *     → `'anthropic:claude-haiku-4-5-20251001'`
  *   `{provider: 'bedrock', model: 'us.anthropic.claude-haiku-4-5-20251001-v1:0'}`
  *     → `'bedrock:us.anthropic.claude-haiku-4-5-20251001-v1:0'`
- *   `{provider: 'openrouter', model: 'anthropic/claude-3-5-sonnet'}`
- *     → `'openrouter:anthropic/claude-3-5-sonnet'`
+ *   `{provider: 'openrouter', model: 'anthropic/claude-haiku-4.5'}`
+ *     → `'openrouter:anthropic/claude-haiku-4.5'`
  */
 export function serializeLlmRoute(route) {
     return `${route.provider}${CANONICAL_SEPARATOR}${route.model}`;
@@ -358,8 +358,8 @@ const LITELLM_TO_WIRE = {
  *   - `gemini/gemini-3.5-flash`    → `{google, gemini-3.5-flash}`
  *   - `openai/gpt-5.5-...`         → `{openai, gpt-5.5-...}`
  *   - `bedrock/us.anthropic...`    → `{bedrock, us.anthropic...}`
- *   - `openrouter/anthropic/claude-3-5-sonnet`
- *     → `{openrouter, anthropic/claude-3-5-sonnet}`
+ *   - `openrouter/anthropic/claude-haiku-4.5`
+ *     → `{openrouter, anthropic/claude-haiku-4.5}`
  *
  * Used at wire boundaries (ggui.json parser, CLI flag, env var) so
  * existing operator configs keep working without a forced migration.

package/dist/types/llm.d.ts

@@ -25,14 +25,27 @@
  * `LLMProvider` (capital)) were deleted in the slice #43 close-out —
  * routing went through `parseAnyLlmRoute` + typed dispatch.
  *
- * Pricing last verified: March 2026
+ * Pricing last verified: 2026-08-04 (all three providers re-checked
+ * against the vendored LiteLLM snapshot + vendor announcements).
  * Sources:
  *   https://docs.anthropic.com/en/docs/about-claude/pricing
  *   https://developers.openai.com/api/docs/pricing/
  *   https://ai.google.dev/gemini-api/docs/pricing
+ *
+ * KEEPING THIS HONEST: `costs` here is what the benchmark harness and
+ * every cost read price against, and until 2026-07-31 nothing compared
+ * it to anything — the vendored-snapshot test only asserted a row
+ * EXISTS, and `scripts/check-litellm-pricing-drift.ts` compares the
+ * snapshot against upstream, never the registry. That gap let this
+ * table sit four months stale while production routed to models it did
+ * not even list. The pod's `pricing-tables.test.ts` now asserts every
+ * entry's `costs` match the vendored rate (with an explicit, dated
+ * PENDING_UPSTREAM allowlist for prices we learn before LiteLLM does).
+ * Add a model here and you MUST re-vendor the snapshot in the same
+ * slice.
  */
 import type { LlmProvider } from "./llm-route.js";
-export type ModelId = "anthropic/claude-haiku-4-5" | "anthropic/claude-sonnet-4-6" | "anthropic/claude-opus-4-6" | "gemini/gemini-3.5-flash" | "gemini/gemini-3.1-flash-lite" | "gemini/gemini-3-flash-preview" | "gemini/gemini-3.1-pro-preview" | "openai/gpt-5.3-codex" | "openai/gpt-5.4" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano";
+export type ModelId = "anthropic/claude-fable-5" | "anthropic/claude-opus-5" | "anthropic/claude-sonnet-5" | "anthropic/claude-haiku-4-5" | "anthropic/claude-opus-4-7" | "anthropic/claude-sonnet-4-6" | "anthropic/claude-opus-4-6" | "gemini/gemini-3.6-flash" | "gemini/gemini-3.5-flash" | "gemini/gemini-3.5-flash-lite" | "gemini/gemini-3.1-flash-lite" | "gemini/gemini-3-flash-preview" | "gemini/gemini-3.1-pro-preview" | "openai/gpt-5.6-sol" | "openai/gpt-5.6-terra" | "openai/gpt-5.6-luna" | "openai/gpt-5.3-codex" | "openai/gpt-5.4" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano";
 export type ModelTier = "fast" | "balanced" | "premium";
 export interface ModelConfig {
     id: ModelId;

package/dist/types/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/types/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,MAAM,MAAM,OAAO,GAEf,4BAA4B,GAC5B,6BAA6B,GAC7B,2BAA2B,GAE3B,yBAAyB,GACzB,8BAA8B,GAC9B,+BAA+B,GAC/B,+BAA+B,GAE/B,sBAAsB,GACtB,gBAAgB,GAChB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB;;;;WAIG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB;;;;WAIG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAMD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CAgI9C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAsC,CAAC"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/types/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,MAAM,MAAM,OAAO,GAEf,0BAA0B,GAC1B,yBAAyB,GACzB,2BAA2B,GAC3B,4BAA4B,GAC5B,2BAA2B,GAC3B,6BAA6B,GAC7B,2BAA2B,GAE3B,yBAAyB,GACzB,yBAAyB,GACzB,8BAA8B,GAC9B,8BAA8B,GAC9B,+BAA+B,GAC/B,+BAA+B,GAE/B,oBAAoB,GACpB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,gBAAgB,GAChB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB;;;;WAIG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB;;;;WAIG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAMD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CAuP9C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAsC,CAAC"}

package/dist/types/llm.js

@@ -25,17 +25,76 @@
  * `LLMProvider` (capital)) were deleted in the slice #43 close-out —
  * routing went through `parseAnyLlmRoute` + typed dispatch.
  *
- * Pricing last verified: March 2026
+ * Pricing last verified: 2026-08-04 (all three providers re-checked
+ * against the vendored LiteLLM snapshot + vendor announcements).
  * Sources:
  *   https://docs.anthropic.com/en/docs/about-claude/pricing
  *   https://developers.openai.com/api/docs/pricing/
  *   https://ai.google.dev/gemini-api/docs/pricing
+ *
+ * KEEPING THIS HONEST: `costs` here is what the benchmark harness and
+ * every cost read price against, and until 2026-07-31 nothing compared
+ * it to anything — the vendored-snapshot test only asserted a row
+ * EXISTS, and `scripts/check-litellm-pricing-drift.ts` compares the
+ * snapshot against upstream, never the registry. That gap let this
+ * table sit four months stale while production routed to models it did
+ * not even list. The pod's `pricing-tables.test.ts` now asserts every
+ * entry's `costs` match the vendored rate (with an explicit, dated
+ * PENDING_UPSTREAM allowlist for prices we learn before LiteLLM does).
+ * Add a model here and you MUST re-vendor the snapshot in the same
+ * slice.
  */
 // =============================================================================
 // Model Registry — verified pricing March 2026
 // =============================================================================
 export const MODEL_REGISTRY = {
     // ── Anthropic Claude ──────────────────────────────────────────────
+    "anthropic/claude-fable-5": {
+        id: "anthropic/claude-fable-5",
+        provider: "anthropic",
+        displayName: "Claude Fable 5",
+        tier: "premium",
+        costs: {
+            inputPer1M: 10.0,
+            outputPer1M: 50.0,
+            cacheWritePer1M: 12.5,
+            cacheReadPer1M: 1.0,
+        },
+        maxTokens: 1000000,
+        supportsTools: true,
+    },
+    "anthropic/claude-opus-5": {
+        id: "anthropic/claude-opus-5",
+        provider: "anthropic",
+        displayName: "Claude Opus 5",
+        tier: "premium",
+        costs: {
+            inputPer1M: 5.0,
+            outputPer1M: 25.0,
+            cacheWritePer1M: 6.25,
+            cacheReadPer1M: 0.5,
+        },
+        maxTokens: 1000000,
+        supportsTools: true,
+    },
+    // NOTE(pricing): $2/$10 is Anthropic's INTRODUCTORY rate, in effect
+    // through 2026-08-31; it reverts to $3/$15 on 2026-09-01. Re-check
+    // this entry then — the vendored LiteLLM snapshot carries the intro
+    // rate too, so the drift guard will not flag the reversion for us.
+    "anthropic/claude-sonnet-5": {
+        id: "anthropic/claude-sonnet-5",
+        provider: "anthropic",
+        displayName: "Claude Sonnet 5",
+        tier: "balanced",
+        costs: {
+            inputPer1M: 2.0,
+            outputPer1M: 10.0,
+            cacheWritePer1M: 2.5,
+            cacheReadPer1M: 0.2,
+        },
+        maxTokens: 1000000,
+        supportsTools: true,
+    },
     // Default generation model (ui-gen's default engine; see
     // DEFAULT_MODEL below). Hosted pools default here too.
     "anthropic/claude-haiku-4-5": {
@@ -66,6 +125,20 @@ export const MODEL_REGISTRY = {
         maxTokens: 200000,
         supportsTools: true,
     },
+    "anthropic/claude-opus-4-7": {
+        id: "anthropic/claude-opus-4-7",
+        provider: "anthropic",
+        displayName: "Claude Opus 4.7",
+        tier: "premium",
+        costs: {
+            inputPer1M: 5.0,
+            outputPer1M: 25.0,
+            cacheWritePer1M: 6.25,
+            cacheReadPer1M: 0.5,
+        },
+        maxTokens: 1000000,
+        supportsTools: true,
+    },
     "anthropic/claude-opus-4-6": {
         id: "anthropic/claude-opus-4-6",
         provider: "anthropic",
@@ -85,6 +158,16 @@ export const MODEL_REGISTRY = {
     // (https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json);
     // host-side consumers may apply a more authoritative price table
     // if they ship one.
+    "gemini/gemini-3.6-flash": {
+        id: "gemini/gemini-3.6-flash",
+        provider: "google",
+        displayName: "Gemini 3.6 Flash",
+        tier: "fast",
+        costs: { inputPer1M: 1.5, outputPer1M: 7.5, cacheReadPer1M: 0.15 },
+        maxTokens: 1048576,
+        supportsTools: true,
+        supportsCaching: true,
+    },
     "gemini/gemini-3.5-flash": {
         id: "gemini/gemini-3.5-flash",
         provider: "google",
@@ -95,6 +178,17 @@ export const MODEL_REGISTRY = {
         supportsTools: true,
         supportsCaching: true,
     },
+    // Google-lane generation default (`evaluator.ts`, `generation-probe.ts`).
+    "gemini/gemini-3.5-flash-lite": {
+        id: "gemini/gemini-3.5-flash-lite",
+        provider: "google",
+        displayName: "Gemini 3.5 Flash Lite",
+        tier: "fast",
+        costs: { inputPer1M: 0.3, outputPer1M: 2.5, cacheReadPer1M: 0.03 },
+        maxTokens: 1048576,
+        supportsTools: true,
+        supportsCaching: true,
+    },
     // Google-lane reference model (cost-per-token floor).
     "gemini/gemini-3.1-flash-lite": {
         id: "gemini/gemini-3.1-flash-lite",
@@ -124,6 +218,44 @@ export const MODEL_REGISTRY = {
         supportsTools: true,
     },
     // ── OpenAI ────────────────────────────────────────────────────────
+    // GPT-5.6 family (2026-07). OpenAI cut Luna 80% and Terra 20% on
+    // 2026-07-30; Sol was left unchanged. The 2026-08-04 re-vendor
+    // confirmed upstream LiteLLM has ingested both cuts, so these costs
+    // now agree with the vendored snapshot (no PENDING_UPSTREAM
+    // exemption needed).
+    "openai/gpt-5.6-sol": {
+        id: "openai/gpt-5.6-sol",
+        provider: "openai",
+        displayName: "GPT-5.6 Sol",
+        tier: "premium",
+        costs: {
+            inputPer1M: 5.0,
+            outputPer1M: 30.0,
+            cacheWritePer1M: 6.25,
+            cacheReadPer1M: 0.5,
+        },
+        maxTokens: 1050000,
+        supportsTools: true,
+    },
+    "openai/gpt-5.6-terra": {
+        id: "openai/gpt-5.6-terra",
+        provider: "openai",
+        displayName: "GPT-5.6 Terra",
+        tier: "balanced",
+        costs: { inputPer1M: 2.0, outputPer1M: 12.0, cacheReadPer1M: 0.2 },
+        maxTokens: 1050000,
+        supportsTools: true,
+    },
+    // OpenAI-lane generation default (`evaluator.ts`, `generation-probe.ts`).
+    "openai/gpt-5.6-luna": {
+        id: "openai/gpt-5.6-luna",
+        provider: "openai",
+        displayName: "GPT-5.6 Luna",
+        tier: "fast",
+        costs: { inputPer1M: 0.2, outputPer1M: 1.2, cacheReadPer1M: 0.02 },
+        maxTokens: 1050000,
+        supportsTools: true,
+    },
     "openai/gpt-5.3-codex": {
         id: "openai/gpt-5.3-codex",
         provider: "openai",

package/dist/validation/contract-validator.js

@@ -563,7 +563,7 @@ export function validateContractStructure(contract) {
     }
     // Schema-compat invariants: action.schema ⊆ tool.inputSchema and
     // channel.schema ⊇ tool.outputSchema, validated against the
-    // contract's OWN agentTools catalog. Distinct scope from the
+    // contract's OWN agentCapabilities.tools catalog. Distinct scope from the
     // server-level F4 check (which compares against the live tool
     // registry's zod schemas).
     for (const violation of checkSchemaCompat(contract)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/protocol",
-  "version": "0.5.0-rc.1",
+  "version": "0.6.0",
   "description": "ggui protocol types — events, renders, WebSocket, MCP, LLM models",
   "license": "Apache-2.0",
   "keywords": [