@ggui-ai/project-config 0.13.0 → 0.14.0

package/README.md

@@ -57,7 +57,9 @@ if (path) {
 }
 ```
 
-`protocol` MUST match `PROTOCOL_VERSION` exported by `@ggui-ai/protocol` in the version installed.
+**Contract:** `protocol` MUST be a member of `CLIENT_SUPPORTED_VERSIONS` exported by the installed `@ggui-ai/protocol` — membership, not equality with the current stamp. The loader (`loadGguiJson` / `safeLoadGguiJson` on the `./node` subpath) checks exactly that predicate — the wire's own — and refuses a non-member with `UPGRADE_REQUIRED` (`GguiJsonProtocolUnsupportedError`, carrying `declared` / `supported` / `current`). Pass `{ versionPolicy: 'advisory', onDiagnostic }` to load anyway and receive the same finding as a diagnostic; there is no third posture. The schema itself validates the field as pattern-only so an old declaration stays readable.
+
+**House rule for files shipped as a starting point** (this repo's `samples/`): declare the CURRENT stamp, `PROTOCOL_VERSION` — pinned by the samples test. Today the supported set has one member, so the two rules coincide; when it grows, a supported-but-stale declaration still loads and only the samples pin insists on currency.
 
 Optional blocks: `storage` (renders / vectors / threads via `memory` or `sqlite`), `theme`, `primitives`, `blueprints`, `mcpMounts`, and `operator`. See the exported Zod schema for the full, authoritative shape.
 

package/dist/node.d.ts

@@ -1,3 +1,4 @@
+import { UPGRADE_REQUIRED } from '@ggui-ai/protocol';
 import { GguiJsonV1 } from './schema.js';
 /** How many parent directories `findGguiJson` will walk by default. */
 export declare const DEFAULT_FIND_MAX_DEPTH = 8;
@@ -23,16 +24,70 @@ export declare class GguiJsonLoadError extends Error {
         cause?: unknown;
     });
 }
+/**
+ * How the loader treats a `protocol` declaration that is not in
+ * `CLIENT_SUPPORTED_VERSIONS` — the handshake's own knob: the same two
+ * postures and the same default (`reject`). A refusal, or a diagnostic
+ * that lets the load proceed. There is no third posture.
+ */
+export type GguiJsonVersionPolicy = 'advisory' | 'reject';
+/**
+ * The loader's protocol finding. Under `reject` it rides the thrown
+ * {@link GguiJsonProtocolUnsupportedError}; under `advisory` it reaches
+ * {@link LoadGguiJsonOptions.onDiagnostic} and the load continues.
+ */
+export interface GguiJsonProtocolDiagnostic {
+    readonly kind: 'protocol-unsupported';
+    /** The canonical wire code — the loader's outcome IS the handshake's. */
+    readonly code: typeof UPGRADE_REQUIRED;
+    /** The `protocol` the file declares. */
+    readonly declared: string;
+    /** The set this installation speaks (`CLIENT_SUPPORTED_VERSIONS`). */
+    readonly supported: readonly string[];
+    /** The current stamp (`PROTOCOL_VERSION`) — what a fresh declaration writes. */
+    readonly current: string;
+    readonly path: string;
+    readonly message: string;
+}
+export interface LoadGguiJsonOptions {
+    /** @default 'reject' */
+    readonly versionPolicy?: GguiJsonVersionPolicy;
+    /** Receives the diagnostic under `'advisory'`; under `'reject'` the same facts ride the error. */
+    readonly onDiagnostic?: (diagnostic: GguiJsonProtocolDiagnostic) => void;
+}
+/**
+ * The loader's version refusal: the file declares a `protocol` outside
+ * `CLIENT_SUPPORTED_VERSIONS`, so nothing built on this installation
+ * can speak to it. `.code` is the canonical `UPGRADE_REQUIRED` —
+ * symmetric with the handshake's error frame — and `declared` /
+ * `supported` / `current` carry what an author needs to fix the file.
+ *
+ * A subclass of {@link GguiJsonLoadError}, so every existing catch site
+ * (and {@link safeLoadGguiJson}) handles it unchanged.
+ */
+export declare class GguiJsonProtocolUnsupportedError extends GguiJsonLoadError {
+    readonly code: typeof UPGRADE_REQUIRED;
+    readonly declared: string;
+    readonly supported: readonly string[];
+    readonly current: string;
+    constructor(diagnostic: GguiJsonProtocolDiagnostic);
+}
 /**
  * Read `ggui.json` at `path`, parse JSON, validate against the v1
- * schema. Returns the fully-defaulted document.
+ * schema, and check the declared `protocol` against what this
+ * installation speaks. Returns the fully-defaulted document.
  *
  * Throws {@link GguiJsonLoadError} if:
  *   - the file does not exist,
  *   - the file is not valid JSON,
- *   - the document fails schema validation (cause set to `ZodError`).
+ *   - the document fails schema validation (cause set to `ZodError`),
+ *   - the declared `protocol` is not in `CLIENT_SUPPORTED_VERSIONS` and
+ *     `options.versionPolicy` is `'reject'` (the default) — as the
+ *     {@link GguiJsonProtocolUnsupportedError} subclass, carrying
+ *     `UPGRADE_REQUIRED`. Under `'advisory'` that state loads and
+ *     reaches `options.onDiagnostic` instead.
  */
-export declare function loadGguiJson(path: string): GguiJsonV1;
+export declare function loadGguiJson(path: string, options?: LoadGguiJsonOptions): GguiJsonV1;
 /**
  * Result of {@link safeLoadGguiJson} — mirrors `z.safeParse` so
  * consumers can branch without try/catch.
@@ -47,9 +102,11 @@ export type SafeLoadResult = {
 /**
  * Non-throwing variant of {@link loadGguiJson}. Returns a
  * discriminated result. Use this in CLI surfaces that render issue
- * lists directly.
+ * lists directly. Same `options` and the same protocol default: an
+ * unsupported declaration comes back as `{ success: false, error }`
+ * with the {@link GguiJsonProtocolUnsupportedError}.
  */
-export declare function safeLoadGguiJson(path: string): SafeLoadResult;
+export declare function safeLoadGguiJson(path: string, options?: LoadGguiJsonOptions): SafeLoadResult;
 /**
  * Serialize and write a `ggui.json` document to `path`. The input is
  * re-validated against the v1 schema before writing so a caller

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,UAAU,EAEX,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,MAAsB,EAChC,QAAQ,GAAE,MAA+B,GACxC,MAAM,GAAG,IAAI,CAUf;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAoCrD;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAS7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAGhE;AAMD,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EACL,kBAAkB,EAClB,kCAAkC,EAClC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EACL,iBAAiB,EACjB,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/node.js

@@ -19,6 +19,7 @@
  */
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
+import { CLIENT_SUPPORTED_VERSIONS, PROTOCOL_VERSION, UPGRADE_REQUIRED, } from '@ggui-ai/protocol';
 import { GGUI_JSON_FILENAME, parseGguiJson, } from './schema.js';
 /** How many parent directories `findGguiJson` will walk by default. */
 export const DEFAULT_FIND_MAX_DEPTH = 8;
@@ -58,16 +59,76 @@ export class GguiJsonLoadError extends Error {
         this.path = path;
     }
 }
+/**
+ * The loader's version refusal: the file declares a `protocol` outside
+ * `CLIENT_SUPPORTED_VERSIONS`, so nothing built on this installation
+ * can speak to it. `.code` is the canonical `UPGRADE_REQUIRED` —
+ * symmetric with the handshake's error frame — and `declared` /
+ * `supported` / `current` carry what an author needs to fix the file.
+ *
+ * A subclass of {@link GguiJsonLoadError}, so every existing catch site
+ * (and {@link safeLoadGguiJson}) handles it unchanged.
+ */
+export class GguiJsonProtocolUnsupportedError extends GguiJsonLoadError {
+    code = UPGRADE_REQUIRED;
+    declared;
+    supported;
+    current;
+    constructor(diagnostic) {
+        super(diagnostic.message, diagnostic.path);
+        this.name = 'GguiJsonProtocolUnsupportedError';
+        this.declared = diagnostic.declared;
+        this.supported = diagnostic.supported;
+        this.current = diagnostic.current;
+    }
+}
+/**
+ * Membership, not currency, is the contract: the declaration must be
+ * IN the supported set — the wire's own predicate, one predicate for
+ * the file and the handshake. Never `=== PROTOCOL_VERSION`: the day the
+ * set has two members an exact-stamp check would refuse a declaration
+ * the wire accepts.
+ *
+ * In-set-but-not-current ("stale") is diagnostic-only by ruling and
+ * never a refusal. It is unreachable while the set is a singleton; add
+ * that diagnostic, with its test, when a second member lands.
+ */
+function checkProtocolMembership(doc, path, options) {
+    if (CLIENT_SUPPORTED_VERSIONS.includes(doc.protocol))
+        return;
+    const diagnostic = {
+        kind: 'protocol-unsupported',
+        code: UPGRADE_REQUIRED,
+        declared: doc.protocol,
+        supported: CLIENT_SUPPORTED_VERSIONS,
+        current: PROTOCOL_VERSION,
+        path,
+        message: `ggui.json at ${path} declares protocol '${doc.protocol}', which this ` +
+            `installation does not speak (supported: [${CLIENT_SUPPORTED_VERSIONS.join(', ')}]). ` +
+            `Set "protocol" to '${PROTOCOL_VERSION}' (the current version), or install the ` +
+            `@ggui-ai/* packages that speak '${doc.protocol}'.`,
+    };
+    if ((options.versionPolicy ?? 'reject') === 'reject') {
+        throw new GguiJsonProtocolUnsupportedError(diagnostic);
+    }
+    options.onDiagnostic?.(diagnostic);
+}
 /**
  * Read `ggui.json` at `path`, parse JSON, validate against the v1
- * schema. Returns the fully-defaulted document.
+ * schema, and check the declared `protocol` against what this
+ * installation speaks. Returns the fully-defaulted document.
  *
  * Throws {@link GguiJsonLoadError} if:
  *   - the file does not exist,
  *   - the file is not valid JSON,
- *   - the document fails schema validation (cause set to `ZodError`).
+ *   - the document fails schema validation (cause set to `ZodError`),
+ *   - the declared `protocol` is not in `CLIENT_SUPPORTED_VERSIONS` and
+ *     `options.versionPolicy` is `'reject'` (the default) — as the
+ *     {@link GguiJsonProtocolUnsupportedError} subclass, carrying
+ *     `UPGRADE_REQUIRED`. Under `'advisory'` that state loads and
+ *     reaches `options.onDiagnostic` instead.
  */
-export function loadGguiJson(path) {
+export function loadGguiJson(path, options = {}) {
     if (!existsSync(path)) {
         throw new GguiJsonLoadError(`ggui.json not found at ${path}`, path);
     }
@@ -85,21 +146,28 @@ export function loadGguiJson(path) {
     catch (cause) {
         throw new GguiJsonLoadError(`ggui.json at ${path} is not valid JSON`, path, { cause });
     }
+    let doc;
     try {
-        return parseGguiJson(decoded);
+        doc = parseGguiJson(decoded);
     }
     catch (cause) {
         throw new GguiJsonLoadError(`ggui.json at ${path} failed schema validation`, path, { cause });
     }
+    // Outside the schema `try`: a version refusal is its own outcome,
+    // never re-wrapped as a schema failure.
+    checkProtocolMembership(doc, path, options);
+    return doc;
 }
 /**
  * Non-throwing variant of {@link loadGguiJson}. Returns a
  * discriminated result. Use this in CLI surfaces that render issue
- * lists directly.
+ * lists directly. Same `options` and the same protocol default: an
+ * unsupported declaration comes back as `{ success: false, error }`
+ * with the {@link GguiJsonProtocolUnsupportedError}.
  */
-export function safeLoadGguiJson(path) {
+export function safeLoadGguiJson(path, options = {}) {
     try {
-        return { success: true, data: loadGguiJson(path) };
+        return { success: true, data: loadGguiJson(path, options) };
     }
     catch (error) {
         if (error instanceof GguiJsonLoadError) {

package/dist/schema.d.ts

@@ -153,7 +153,7 @@ export type StorageConfig = z.infer<typeof StorageSchema>;
 declare const GenerationSchema: z.ZodObject<{
     model: z.ZodPipe<z.ZodString, z.ZodTransform<{
         provider: "anthropic";
-        model: "claude-fable-5" | "claude-opus-5" | "claude-sonnet-5" | "claude-haiku-4-5-20251001" | "claude-opus-4-8" | "claude-sonnet-4-6" | "claude-opus-4-7" | "claude-opus-4-6";
+        model: "claude-fable-5-1" | "claude-fable-5" | "claude-opus-5" | "claude-sonnet-5" | "claude-haiku-4-5-20251001" | "claude-opus-4-8" | "claude-sonnet-4-6" | "claude-opus-4-7" | "claude-opus-4-6";
     } | {
         provider: "openai";
         model: "gpt-5.6" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.5-2026-04-23" | "gpt-5.5-pro" | "gpt-5.5-pro-2026-04-23" | "gpt-5.4" | "gpt-5.4-2026-03-05" | "gpt-5.4-mini" | "gpt-5.4-mini-2026-03-17" | "gpt-5.4-nano" | "gpt-5.4-nano-2026-03-17" | "gpt-5.3-codex";
@@ -162,7 +162,7 @@ declare const GenerationSchema: z.ZodObject<{
         model: "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-flash-latest" | "gemini-3.1-flash-lite" | "gemini-3.1-pro-preview" | "gemini-3.1-flash-lite-preview" | "gemini-3-flash-preview";
     } | {
         provider: "bedrock";
-        model: (string & {}) | "anthropic.claude-fable-5" | "anthropic.claude-opus-5" | "anthropic.claude-sonnet-5" | "anthropic.claude-opus-4-8" | "us.anthropic.claude-haiku-4-5-20251001-v1:0" | "eu.anthropic.claude-haiku-4-5-20251001-v1:0" | "apac.anthropic.claude-haiku-4-5-20251001-v1:0" | "global.anthropic.claude-haiku-4-5-20251001-v1:0" | "us.anthropic.claude-sonnet-4-6" | "eu.anthropic.claude-sonnet-4-6" | "apac.anthropic.claude-sonnet-4-6" | "us.anthropic.claude-opus-4-7" | "eu.anthropic.claude-opus-4-7" | "apac.anthropic.claude-opus-4-7" | "global.anthropic.claude-opus-4-7" | "us.anthropic.claude-opus-4-6-v1";
+        model: (string & {}) | "anthropic.claude-fable-5-1" | "anthropic.claude-fable-5" | "anthropic.claude-opus-5" | "anthropic.claude-sonnet-5" | "anthropic.claude-opus-4-8" | "us.anthropic.claude-haiku-4-5-20251001-v1:0" | "eu.anthropic.claude-haiku-4-5-20251001-v1:0" | "apac.anthropic.claude-haiku-4-5-20251001-v1:0" | "global.anthropic.claude-haiku-4-5-20251001-v1:0" | "us.anthropic.claude-sonnet-4-6" | "eu.anthropic.claude-sonnet-4-6" | "apac.anthropic.claude-sonnet-4-6" | "us.anthropic.claude-opus-4-7" | "eu.anthropic.claude-opus-4-7" | "apac.anthropic.claude-opus-4-7" | "global.anthropic.claude-opus-4-7" | "us.anthropic.claude-opus-4-6-v1";
     } | {
         provider: "openrouter";
         model: (string & {}) | "anthropic/claude-fable-5" | "anthropic/claude-opus-5" | "anthropic/claude-sonnet-5" | "anthropic/claude-haiku-4.5" | "anthropic/claude-sonnet-4.6" | "anthropic/claude-opus-4.7" | "openai/gpt-5.6-sol" | "openai/gpt-5.6-terra" | "openai/gpt-5.6-luna" | "openai/gpt-5.5" | "openai/gpt-5.5-pro" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano" | "google/gemini-3.6-flash" | "google/gemini-3.5-flash" | "google/gemini-3.5-flash-lite" | "google/gemini-3.1-pro-preview" | "google/gemini-3.1-flash-lite" | "x-ai/grok-4.3" | "meta-llama/llama-4-maverick" | "meta-llama/llama-3.3-70b-instruct" | "deepseek/deepseek-v4-pro" | "deepseek/deepseek-r1-0528" | "qwen/qwen3.7-max" | "qwen/qwen3-coder" | "mistralai/mistral-large-2512" | "openai/gpt-oss-120b";
@@ -330,7 +330,7 @@ export declare const GguiJsonV1: z.ZodObject<{
     generation: z.ZodOptional<z.ZodObject<{
         model: z.ZodPipe<z.ZodString, z.ZodTransform<{
             provider: "anthropic";
-            model: "claude-fable-5" | "claude-opus-5" | "claude-sonnet-5" | "claude-haiku-4-5-20251001" | "claude-opus-4-8" | "claude-sonnet-4-6" | "claude-opus-4-7" | "claude-opus-4-6";
+            model: "claude-fable-5-1" | "claude-fable-5" | "claude-opus-5" | "claude-sonnet-5" | "claude-haiku-4-5-20251001" | "claude-opus-4-8" | "claude-sonnet-4-6" | "claude-opus-4-7" | "claude-opus-4-6";
         } | {
             provider: "openai";
             model: "gpt-5.6" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.5" | "gpt-5.5-2026-04-23" | "gpt-5.5-pro" | "gpt-5.5-pro-2026-04-23" | "gpt-5.4" | "gpt-5.4-2026-03-05" | "gpt-5.4-mini" | "gpt-5.4-mini-2026-03-17" | "gpt-5.4-nano" | "gpt-5.4-nano-2026-03-17" | "gpt-5.3-codex";
@@ -339,7 +339,7 @@ export declare const GguiJsonV1: z.ZodObject<{
             model: "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-flash-latest" | "gemini-3.1-flash-lite" | "gemini-3.1-pro-preview" | "gemini-3.1-flash-lite-preview" | "gemini-3-flash-preview";
         } | {
             provider: "bedrock";
-            model: (string & {}) | "anthropic.claude-fable-5" | "anthropic.claude-opus-5" | "anthropic.claude-sonnet-5" | "anthropic.claude-opus-4-8" | "us.anthropic.claude-haiku-4-5-20251001-v1:0" | "eu.anthropic.claude-haiku-4-5-20251001-v1:0" | "apac.anthropic.claude-haiku-4-5-20251001-v1:0" | "global.anthropic.claude-haiku-4-5-20251001-v1:0" | "us.anthropic.claude-sonnet-4-6" | "eu.anthropic.claude-sonnet-4-6" | "apac.anthropic.claude-sonnet-4-6" | "us.anthropic.claude-opus-4-7" | "eu.anthropic.claude-opus-4-7" | "apac.anthropic.claude-opus-4-7" | "global.anthropic.claude-opus-4-7" | "us.anthropic.claude-opus-4-6-v1";
+            model: (string & {}) | "anthropic.claude-fable-5-1" | "anthropic.claude-fable-5" | "anthropic.claude-opus-5" | "anthropic.claude-sonnet-5" | "anthropic.claude-opus-4-8" | "us.anthropic.claude-haiku-4-5-20251001-v1:0" | "eu.anthropic.claude-haiku-4-5-20251001-v1:0" | "apac.anthropic.claude-haiku-4-5-20251001-v1:0" | "global.anthropic.claude-haiku-4-5-20251001-v1:0" | "us.anthropic.claude-sonnet-4-6" | "eu.anthropic.claude-sonnet-4-6" | "apac.anthropic.claude-sonnet-4-6" | "us.anthropic.claude-opus-4-7" | "eu.anthropic.claude-opus-4-7" | "apac.anthropic.claude-opus-4-7" | "global.anthropic.claude-opus-4-7" | "us.anthropic.claude-opus-4-6-v1";
         } | {
             provider: "openrouter";
             model: (string & {}) | "anthropic/claude-fable-5" | "anthropic/claude-opus-5" | "anthropic/claude-sonnet-5" | "anthropic/claude-haiku-4.5" | "anthropic/claude-sonnet-4.6" | "anthropic/claude-opus-4.7" | "openai/gpt-5.6-sol" | "openai/gpt-5.6-terra" | "openai/gpt-5.6-luna" | "openai/gpt-5.5" | "openai/gpt-5.5-pro" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano" | "google/gemini-3.6-flash" | "google/gemini-3.5-flash" | "google/gemini-3.5-flash-lite" | "google/gemini-3.1-pro-preview" | "google/gemini-3.1-flash-lite" | "x-ai/grok-4.3" | "meta-llama/llama-4-maverick" | "meta-llama/llama-3.3-70b-instruct" | "deepseek/deepseek-v4-pro" | "deepseek/deepseek-r1-0528" | "qwen/qwen3.7-max" | "qwen/qwen3-coder" | "mistralai/mistral-large-2512" | "openai/gpt-oss-120b";

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmHxB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,QAAA,MAAM,cAAc;;;;;kBAoBlB,CAAC;AAEH,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AA+H5D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;oBAI5B,CAAC;AAqEH;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB;;;;;8BAGxB,CAAC;AAEH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;kBAejB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;kBA6CpB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiKrB,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,CAEzC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwHxB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,QAAA,MAAM,cAAc;;;;;kBAoBlB,CAAC;AAEH,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AA+H5D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;oBAI5B,CAAC;AAqEH;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB;;;;;8BAGxB,CAAC;AAEH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;kBAejB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;kBA6CpB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiKrB,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,CAEzC"}

package/dist/schema.js

@@ -66,10 +66,15 @@ const SlugSchema = z
  * The wire contract version this app speaks — distinct from the
  * `schema` field which versions the file format itself.
  *
- * Future tightening: could import a known-versions list from
- * `@ggui-ai/protocol` and validate membership. Deliberately left as
- * pattern-only for v1 to avoid the cross-package dep until a real
- * consumer benefits from the tighter check.
+ * Pattern-only HERE by design, and stays so: `ggui.json` is a
+ * declaration layer, and a parser that rejected a well-formed old
+ * declaration would make the file unreadable exactly when the reader
+ * must say "upgrade" — unparseable is not unsupported. Membership
+ * against `CLIENT_SUPPORTED_VERSIONS` is the LOADER's check
+ * (`loadGguiJson` in `./node.ts`), which refuses non-members with the
+ * wire's own `UPGRADE_REQUIRED` under the handshake's `versionPolicy`
+ * knob. Shipped samples additionally pin the CURRENT stamp as a house
+ * rule (`samples-protocol.conformance.test.ts`).
  */
 const ProtocolVersionSchema = z
     .string()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/project-config",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Schema and loader for `ggui.json` — the portable app/agent manifest for the ggui protocol. Vendor-neutral. Consumed by the `ggui` CLI and any host that reconstitutes an agent from the manifest.",
   "keywords": [
     "ggui",
@@ -33,8 +33,8 @@
   "dependencies": {
     "tinyglobby": "^0.2.16",
     "zod": "^4.3.6",
-    "@ggui-ai/design": "0.13.0",
-    "@ggui-ai/protocol": "0.13.0"
+    "@ggui-ai/design": "0.14.0",
+    "@ggui-ai/protocol": "0.14.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -54,7 +54,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "author": "ggui contributors <hello@ggui.ai>",
   "scripts": {