@ggui-ai/project-config 0.2.0-alpha.3 → 0.3.0-rc.0

package/README.md

@@ -31,8 +31,8 @@ import { parseGguiJson, safeParseGguiJson } from "@ggui-ai/project-config";
 const manifest = parseGguiJson(JSON.parse(rawText)); // throws on invalid input
 
 const result = safeParseGguiJson(JSON.parse(rawText));
-if (result.ok) {
-  // result.value is a validated GguiJsonV1
+if (result.success) {
+  // result.data is a validated GguiJsonV1
 }
 ```
 

package/dist/schema.d.ts

@@ -3,8 +3,8 @@
  *
  * When a developer runs `ggui serve`, the OSS server reads this file
  * to discover everything it needs: app identity, protocol version,
- * blueprint manifests, primitive packages, theme tokens, declared
- * adapter intent. The schema is framework-neutral — it describes
+ * blueprint manifests, primitive packages, theme tokens, MCP tool
+ * mounts. The schema is framework-neutral — it describes
  * *the ggui app*, never the internal orchestration of any specific
  * agent runtime. LLM choice, system prompt, framework-specific tool
  * inventory belong in each framework's own config, not here.
@@ -163,9 +163,9 @@ declare const StorageSchema: z.ZodObject<{
     }, z.core.$strict>], "driver">>;
 }, z.core.$strict>;
 /**
- * Public type alias for one storage surface's config (renders or
- * vectors). Callers instantiating adapters from a parsed manifest
- * pattern-match on `driver`.
+ * Public type alias for one storage surface's config (renders,
+ * vectors, or threads). Callers instantiating adapters from a
+ * parsed manifest pattern-match on `driver`.
  */
 export type StorageSurfaceConfig = z.infer<typeof StorageSurfaceSchema>;
 /** Public type alias for the full storage block. */
@@ -206,6 +206,23 @@ declare const GenerationSchema: z.ZodObject<{
         provider: "openrouter";
         model: (string & {}) | "anthropic/claude-haiku-4.5" | "anthropic/claude-sonnet-4.6" | "anthropic/claude-opus-4.7" | "openai/gpt-5.5" | "openai/gpt-5.5-pro" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano" | "google/gemini-3.5-flash" | "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";
     }, string>>;
+    /**
+     * Which API key UI generation runs against.
+     *
+     * - `'own'` — your own configured provider key (e.g. an env var
+     *   or secrets manager entry you supply); the server uses whatever
+     *   key the configured `generation.model` provider resolves.
+     * - `'managed'` — your hosting provider supplies the key; you do
+     *   not need to configure a provider key yourself.
+     *
+     * Absent (the default) means the server resolves the key from the
+     * environment via the standard provider-key lookup chain. Self-host
+     * deployments always use `'own'`.
+     */
+    keySource: z.ZodOptional<z.ZodEnum<{
+        own: "own";
+        managed: "managed";
+    }>>;
 }, z.core.$strict>;
 /**
  * Public type alias for the parsed generation block. `model` is the
@@ -229,10 +246,12 @@ export type ThemeConfig = z.infer<typeof ThemeConfigSchema>;
  *
  * **Required fields:** `schema`, `protocol`, `app`.
  * **Optional fields with defaults:** `blueprints`, `primitives`,
- * `adapters`. A zero-config `ggui.json` is just the three required
+ * `mcpMounts`. A zero-config `ggui.json` is just the three required
  * fields — the OSS server boots with defaults for everything else.
- * **Optional without default:** `theme` (absent = shipped default
- * tokens), `agent` (absent = `ggui serve` runs MCP-only).
+ * **Optional without default:** `operator`, `theme` (absent =
+ * shipped default tokens), `agent` (absent = `ggui serve` runs
+ * MCP-only), `storage` (absent = in-memory), `generation`,
+ * `registry`.
  *
  * **Strict root:** unknown top-level keys are rejected.
  */
@@ -286,7 +305,6 @@ export declare const GguiJsonV1: z.ZodObject<{
                     "screen-wake-lock": "screen-wake-lock";
                 }>>;
                 gotchas: z.ZodOptional<z.ZodString>;
-                required: z.ZodOptional<z.ZodBoolean>;
                 hook: z.ZodString;
             }, z.core.$strict>, z.ZodObject<{
                 description: z.ZodString;
@@ -311,7 +329,6 @@ export declare const GguiJsonV1: z.ZodObject<{
                     "screen-wake-lock": "screen-wake-lock";
                 }>>;
                 gotchas: z.ZodOptional<z.ZodString>;
-                required: z.ZodOptional<z.ZodBoolean>;
                 component: z.ZodString;
             }, z.core.$strict>]>>;
             version: z.ZodString;
@@ -337,11 +354,11 @@ export declare const GguiJsonV1: z.ZodObject<{
          * declared in some registered wrapper's `requires`. Operators who
          * declare a key without a value can use the empty string (the
          * Mapbox SDK will surface "Invalid token" on first request rather
-         * than a missing-key error from the push gate).
+         * than a missing-key error from the render gate).
          *
          * Omitting this field is equivalent to `{}` — wrappers without
          * `requires` work unchanged; wrappers that declare `requires` will
-         * fail at push-gate validation if their required keys are missing.
+         * fail at render-gate validation if their required keys are missing.
          */
         publicEnv: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
         /**
@@ -352,13 +369,13 @@ export declare const GguiJsonV1: z.ZodObject<{
          * Honored by hosts as a PRESENTATION preference — `'fullscreen'`
          * says "render as a main view"; `'inline'` says "stack vertically in
          * the chat log"; `'pip'` says "render as picture-in-picture overlay".
-         * The wire mechanism is identical regardless of mode (every push
+         * The wire mechanism is identical regardless of mode (every render
          * stamps its own `_meta.ui.resourceUri` and every iframe goes
          * through the same runtime mount path); display mode controls ONLY
          * how the host arranges the iframes it mounts. Agents can override
-         * per push via `ggui_render.input.displayMode`.
+         * per render via `ggui_render.input.displayMode`.
          *
-         * Absent ⇒ no per-push hint stamped (host falls back to its own
+         * Absent ⇒ no per-render hint stamped (host falls back to its own
          * default, typically `'inline'`).
          */
         defaultDisplayMode: z.ZodOptional<z.ZodEnum<{
@@ -522,6 +539,23 @@ export declare const GguiJsonV1: z.ZodObject<{
             provider: "openrouter";
             model: (string & {}) | "anthropic/claude-haiku-4.5" | "anthropic/claude-sonnet-4.6" | "anthropic/claude-opus-4.7" | "openai/gpt-5.5" | "openai/gpt-5.5-pro" | "openai/gpt-5.4-mini" | "openai/gpt-5.4-nano" | "google/gemini-3.5-flash" | "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";
         }, string>>;
+        /**
+         * Which API key UI generation runs against.
+         *
+         * - `'own'` — your own configured provider key (e.g. an env var
+         *   or secrets manager entry you supply); the server uses whatever
+         *   key the configured `generation.model` provider resolves.
+         * - `'managed'` — your hosting provider supplies the key; you do
+         *   not need to configure a provider key yourself.
+         *
+         * Absent (the default) means the server resolves the key from the
+         * environment via the standard provider-key lookup chain. Self-host
+         * deployments always use `'own'`.
+         */
+        keySource: z.ZodOptional<z.ZodEnum<{
+            own: "own";
+            managed: "managed";
+        }>>;
     }, z.core.$strict>>;
     /**
      * Default plugin-registry URL for this app.

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;IAClB;sDACkD;;IAElD;8CAC0C;;IAI1C;;uDAEmD;;IAEnD;;;8CAG0C;;kBAI1C,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;;;;IAZxB;;oDAEgD;;8BAahD,CAAC;AAEH,QAAA,MAAM,aAAa;IACjB;qCACiC;;;;;QAnBjC;;wDAEgD;;;IAmBhD;gDAC4C;;;;;QAtB5C;;wDAEgD;;;IAsBhD;;;;;;sCAMkC;;;;;QA9BlC;;wDAEgD;;;kBA8BhD,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;IACpB;;;;OAIG;;;;;;;;;;;;;;;;;kBAoBH,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;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU;IACrB;uEACmE;;IAOnE,iDAAiD;;IAKjD,oBAAoB;;;;QAtbpB;;;;;;;;;;;;;;;WAeG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAIH;;;;;;;;;;;;;;;;;WAiBG;;QAEH;;;;;;;;;;;;;;;;WAgBG;;;;;;;IAqYH;;;kDAG8C;;QA/W9C;0DACkD;;QAElD;kDAC0C;;QAI1C;;2DAEmD;;QAEnD;;;kDAG0C;;;IAqW1C,+DAA+D;;QAhV/D;sDAC8C;;;IAoV9C;qEACiE;;;;;IAQjE;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;;;;;;;;IAKH;0DACsD;;QAhUtD;;;;;kDAK0C;;;IAgU1C;;;;gCAI4B;;QA5K5B;yCACiC;;;;;YAnBjC;;4DAEgD;;;QAmBhD;oDAC4C;;;;;YAtB5C;;4DAEgD;;;QAsBhD;;;;;;0CAMkC;;;;;YA9BlC;;4DAEgD;;;;IAiMhD;;;;;;;;;;OAUG;;QAlJH;;;;WAIG;;;;;;;;;;;;;;;;;;IAmJH;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;;IAQH;;;;;;;;;;;;;;;;;;;;;;;;6EAwByE;;kBASzE,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":"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"}

package/dist/schema.js

@@ -3,8 +3,8 @@
  *
  * When a developer runs `ggui serve`, the OSS server reads this file
  * to discover everything it needs: app identity, protocol version,
- * blueprint manifests, primitive packages, theme tokens, declared
- * adapter intent. The schema is framework-neutral — it describes
+ * blueprint manifests, primitive packages, theme tokens, MCP tool
+ * mounts. The schema is framework-neutral — it describes
  * *the ggui app*, never the internal orchestration of any specific
  * agent runtime. LLM choice, system prompt, framework-specific tool
  * inventory belong in each framework's own config, not here.
@@ -115,11 +115,11 @@ const AppSchema = z.strictObject({
      * declared in some registered wrapper's `requires`. Operators who
      * declare a key without a value can use the empty string (the
      * Mapbox SDK will surface "Invalid token" on first request rather
-     * than a missing-key error from the push gate).
+     * than a missing-key error from the render gate).
      *
      * Omitting this field is equivalent to `{}` — wrappers without
      * `requires` work unchanged; wrappers that declare `requires` will
-     * fail at push-gate validation if their required keys are missing.
+     * fail at render-gate validation if their required keys are missing.
      */
     publicEnv: appPublicEnvSchema.optional(),
     /**
@@ -130,13 +130,13 @@ const AppSchema = z.strictObject({
      * Honored by hosts as a PRESENTATION preference — `'fullscreen'`
      * says "render as a main view"; `'inline'` says "stack vertically in
      * the chat log"; `'pip'` says "render as picture-in-picture overlay".
-     * The wire mechanism is identical regardless of mode (every push
+     * The wire mechanism is identical regardless of mode (every render
      * stamps its own `_meta.ui.resourceUri` and every iframe goes
      * through the same runtime mount path); display mode controls ONLY
      * how the host arranges the iframes it mounts. Agents can override
-     * per push via `ggui_render.input.displayMode`.
+     * per render via `ggui_render.input.displayMode`.
      *
-     * Absent ⇒ no per-push hint stamped (host falls back to its own
+     * Absent ⇒ no per-render hint stamped (host falls back to its own
      * default, typically `'inline'`).
      */
     defaultDisplayMode: z.enum(['inline', 'fullscreen', 'pip']).optional(),
@@ -447,6 +447,23 @@ const GenerationSchema = z.strictObject({
         }
         return parsed;
     }),
+    /**
+     * Which API key UI generation runs against.
+     *
+     * - `'own'` — your own configured provider key (e.g. an env var
+     *   or secrets manager entry you supply); the server uses whatever
+     *   key the configured `generation.model` provider resolves.
+     * - `'managed'` — your hosting provider supplies the key; you do
+     *   not need to configure a provider key yourself.
+     *
+     * Absent (the default) means the server resolves the key from the
+     * environment via the standard provider-key lookup chain. Self-host
+     * deployments always use `'own'`.
+     */
+    keySource: z
+        .enum(['own', 'managed'])
+        .optional()
+        .describe("Which API key UI generation runs against: 'own' = your own configured provider key; 'managed' = your hosting provider supplies the key. Self-host deployments always use 'own'."),
 });
 /**
  * The authoritative v1 schema. `z.infer<typeof GguiJsonV1>` yields
@@ -455,10 +472,12 @@ const GenerationSchema = z.strictObject({
  *
  * **Required fields:** `schema`, `protocol`, `app`.
  * **Optional fields with defaults:** `blueprints`, `primitives`,
- * `adapters`. A zero-config `ggui.json` is just the three required
+ * `mcpMounts`. A zero-config `ggui.json` is just the three required
  * fields — the OSS server boots with defaults for everything else.
- * **Optional without default:** `theme` (absent = shipped default
- * tokens), `agent` (absent = `ggui serve` runs MCP-only).
+ * **Optional without default:** `operator`, `theme` (absent =
+ * shipped default tokens), `agent` (absent = `ggui serve` runs
+ * MCP-only), `storage` (absent = in-memory), `generation`,
+ * `registry`.
  *
  * **Strict root:** unknown top-level keys are rejected.
  */
@@ -513,7 +532,7 @@ export const GguiJsonV1 = z.strictObject({
      * default). Present means the operator has opted in per surface
      * — no surface silently creates a file on disk. See
      * {@link StorageConfig}. */
-    storage: StorageSchema.optional().describe('Per-surface storage adapter declarations. Absent = every persistence surface (renders, threads, vectors, kv) stays in-memory (zero-config OSS default). Present = opt-in per surface; no surface silently creates a file on disk.'),
+    storage: StorageSchema.optional().describe('Per-surface storage adapter declarations. Absent = every persistence surface (renders, threads, vectors) stays in-memory (zero-config OSS default). Present = opt-in per surface; no surface silently creates a file on disk.'),
     /**
      * Explicit UI-generation LLM route. Absent + a boot-time provider
      * key resolves → `ggui serve` hard-fails with an actionable error

package/dist/theme-loader.d.ts

@@ -14,8 +14,8 @@ import { type ThemeDocument } from './theme.js';
  *     `--ggui-*` CSS through `parseTheme`; every group required).
  *   - `file` → `ThemeDocument` (the strict-Zod schema for the open
  *     `ggui.json#theme` file format — same `color`/`font`/`spacing`/
- *     `shape`/`motion`/`canvas`/`accessibility`/`zIndex` vocabulary
- *     as `DtcgTheme`, but `motion`/`canvas`/`accessibility`/`zIndex`
+ *     `shape`/`motion`/`accessibility`/`zIndex` vocabulary
+ *     as `DtcgTheme`, but `motion`/`accessibility`/`zIndex`
  *     are optional so external tools that emit only a subset still
  *     parse).
  *

package/dist/theme-loader.js

@@ -18,7 +18,7 @@
  *
  * The loader pre-renders the `:root { --ggui-*: value; }` CSS block
  * via `@ggui-ai/design/themes`: `parseTheme(id, DtcgTheme)` for the
- * preset / default paths (full DTCG with canvas + motion tokens) and
+ * preset / default paths (full DTCG with motion tokens) and
  * `generateCssVariables(ThemeDocument)` for the file path (the
  * duck-typed walker accepts the plain DTCG document without requiring
  * the strict {@link DtcgTheme} shape). Downstream consumers (console,

package/dist/theme.d.ts

@@ -9,7 +9,7 @@
  * **Shape parity with the internal `DtcgTheme`.** This v1 schema is
  * deliberately the same shape as `@ggui-ai/design`'s canonical
  * {@link DtcgTheme} — `color`/`font`/`spacing`/`shape`/`motion`/
- * `canvas`/`accessibility`/`zIndex` — so an authored `theme.json`
+ * `accessibility`/`zIndex` — so an authored `theme.json`
  * uses the same vocabulary the curated registry themes (light/dark/
  * premium-*) use. Previously this schema was Tailwind-style flat
  * (`typography`/`radius`/`shadow` at root); the v1 schema now mirrors
@@ -18,7 +18,7 @@
  * **External-tool compatibility.** External tooling (Figma Tokens,
  * Style Dictionary, Tokens Studio) commonly emits only a subset of
  * the canonical shape. Only the original required groups (`color`,
- * `font`, `spacing`, `shape`) stay required; `motion`, `canvas`,
+ * `font`, `spacing`, `shape`) stay required; `motion`,
  * `accessibility`, `zIndex`, and the new DTCG metadata fields
  * (`$name`, `$description`, `$metadata`) are all OPTIONAL so tools
  * that only emit colors + dimensions still parse cleanly.
@@ -58,8 +58,7 @@
  *   1. Additive only within `schema: '1'`. New optional fields must
  *      default to no-op behaviour so older tooling ignores them.
  *   2. Framework-neutral + host-neutral. No vendor names in enum
- *      values, no build-pipeline fields. (`canvas` IS hosting-
- *      vendor vocabulary; it is opt-in via the optional field.)
+ *      values, no build-pipeline fields.
  *   3. Root and per-group objects are strict — unknown keys fail
  *      parse. Same discipline as `ggui.json`, `ggui.ui.json`, and
  *      `ggui.primitives.json`.
@@ -71,7 +70,7 @@
  * shadow / duration / cubicBezier / transition / number). Each
  * variant validates its `$value` shape. `$description` is accepted
  * everywhere as a free-form docstring. Token leaves under newer
- * groups (`canvas`, `accessibility`, `zIndex`) accept a slightly
+ * groups (`accessibility`, `zIndex`) accept a slightly
  * wider token vocabulary because external tools sometimes encode
  * scalar/array values with permissive `$type` strings (`string`,
  * `array`, …); the schema accepts those without enumerating every
@@ -83,7 +82,7 @@ import { z } from 'zod';
  * `spacing`, `shape`) map 1:1 to `@ggui-ai/design`'s
  * `generateCssVariables` walker targets — anything less would mean
  * a partial CSS output worse than falling back to the shipped
- * default. Optional groups (`motion`, `canvas`, `accessibility`,
+ * default. Optional groups (`motion`, `accessibility`,
  * `zIndex`) are the well-known DTCG additives; present → emitted,
  * absent → the design system's built-in fallbacks apply.
  *
@@ -212,30 +211,6 @@ export declare const ThemeDocumentV1: z.ZodObject<{
             $description: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Canvas configuration for the GenerativeCanvas background.
-     *  Optional — external tools won't emit this. */
-    canvas: z.ZodOptional<z.ZodObject<{
-        mode: z.ZodObject<{
-            $type: z.ZodString;
-            $value: z.ZodUnknown;
-            $description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>;
-        speed: z.ZodObject<{
-            $type: z.ZodString;
-            $value: z.ZodUnknown;
-            $description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>;
-        colors: z.ZodObject<{
-            $type: z.ZodString;
-            $value: z.ZodUnknown;
-            $description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>;
-        background: z.ZodObject<{
-            $type: z.ZodString;
-            $value: z.ZodUnknown;
-            $description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>;
-    }, z.core.$strict>>;
     /** Accessibility tokens (focus ring, reduced motion, high contrast).
      *  Optional. */
     accessibility: z.ZodOptional<z.ZodObject<{

package/dist/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2PxB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe;IAC1B;kEAC8D;;IAG9D,qEAAqE;;IAGrE;6BACyB;;IAGzB;4CACwC;;IAGxC;8CAC0C;;;;;;IAG1C,0DAA0D;;;;;;;;;;IAG1D,+BAA+B;;;;;;IAG/B,2EAA2E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG3E,oDAAoD;;;;;;;;;;;;;;;;;;;IAGpD;mEAC+D;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG/D;qDACiD;;;;;;;;;;;;;;;;;;;;;;;IAGjD;oBACgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGhB,+BAA+B;;;;;;kBAE/B,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,eAAe,CAAC,SAAS,CAAC,CAE9C"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4OxB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe;IAC1B;kEAC8D;;IAG9D,qEAAqE;;IAGrE;6BACyB;;IAGzB;4CACwC;;IAGxC;8CAC0C;;;;;;IAG1C,0DAA0D;;;;;;;;;;IAG1D,+BAA+B;;;;;;IAG/B,2EAA2E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG3E,oDAAoD;;;;;;;;;;;;;;;;;;;IAGpD;mEAC+D;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG/D;oBACgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGhB,+BAA+B;;;;;;kBAE/B,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,eAAe,CAAC,SAAS,CAAC,CAE9C"}

package/dist/theme.js

@@ -9,7 +9,7 @@
  * **Shape parity with the internal `DtcgTheme`.** This v1 schema is
  * deliberately the same shape as `@ggui-ai/design`'s canonical
  * {@link DtcgTheme} — `color`/`font`/`spacing`/`shape`/`motion`/
- * `canvas`/`accessibility`/`zIndex` — so an authored `theme.json`
+ * `accessibility`/`zIndex` — so an authored `theme.json`
  * uses the same vocabulary the curated registry themes (light/dark/
  * premium-*) use. Previously this schema was Tailwind-style flat
  * (`typography`/`radius`/`shadow` at root); the v1 schema now mirrors
@@ -18,7 +18,7 @@
  * **External-tool compatibility.** External tooling (Figma Tokens,
  * Style Dictionary, Tokens Studio) commonly emits only a subset of
  * the canonical shape. Only the original required groups (`color`,
- * `font`, `spacing`, `shape`) stay required; `motion`, `canvas`,
+ * `font`, `spacing`, `shape`) stay required; `motion`,
  * `accessibility`, `zIndex`, and the new DTCG metadata fields
  * (`$name`, `$description`, `$metadata`) are all OPTIONAL so tools
  * that only emit colors + dimensions still parse cleanly.
@@ -58,8 +58,7 @@
  *   1. Additive only within `schema: '1'`. New optional fields must
  *      default to no-op behaviour so older tooling ignores them.
  *   2. Framework-neutral + host-neutral. No vendor names in enum
- *      values, no build-pipeline fields. (`canvas` IS hosting-
- *      vendor vocabulary; it is opt-in via the optional field.)
+ *      values, no build-pipeline fields.
  *   3. Root and per-group objects are strict — unknown keys fail
  *      parse. Same discipline as `ggui.json`, `ggui.ui.json`, and
  *      `ggui.primitives.json`.
@@ -71,7 +70,7 @@
  * shadow / duration / cubicBezier / transition / number). Each
  * variant validates its `$value` shape. `$description` is accepted
  * everywhere as a free-form docstring. Token leaves under newer
- * groups (`canvas`, `accessibility`, `zIndex`) accept a slightly
+ * groups (`accessibility`, `zIndex`) accept a slightly
  * wider token vocabulary because external tools sometimes encode
  * scalar/array values with permissive `$type` strings (`string`,
  * `array`, …); the schema accepts those without enumerating every
@@ -168,11 +167,10 @@ const LineHeightToken = z.union([
     }),
 ]);
 /**
- * Permissive token leaf for the newer optional groups (`canvas`,
- * `motion.keyframes`, `zIndex`). DTCG hasn't standardised every
+ * Permissive token leaf for the newer optional groups
+ * (`motion.keyframes`, `zIndex`). DTCG hasn't standardised every
  * `$type` value the curated registry themes carry — for example
- * canvas mode uses `$type: 'string'`, canvas colors uses
- * `$type: 'array'`, easing uses `$type: 'cubicBezier'`. Rather than
+ * easing uses `$type: 'cubicBezier'`. Rather than
  * enumerate every spelling, this leaf accepts any `$type` string and
  * any JSON-serializable `$value`. Strict per-leaf shape stays in
  * force for the original token types via the leaves above.
@@ -248,19 +246,6 @@ const MotionGroup = z.strictObject({
     transition: z.record(z.string(), TransitionToken),
     keyframes: z.record(z.string(), PermissiveToken).optional(),
 });
-/**
- * Canvas group — GenerativeCanvas background configuration.
- * Optional at the document root (external tools won't emit this).
- * Token leaves use `PermissiveToken` because the canonical shape
- * mixes `$type: 'string'` (mode), `$type: 'number'` (speed),
- * `$type: 'array'` (colors), `$type: 'color'` (background).
- */
-const CanvasGroup = z.strictObject({
-    mode: PermissiveToken,
-    speed: PermissiveToken,
-    colors: PermissiveToken,
-    background: PermissiveToken,
-});
 const AccessibilityGroup = z.strictObject({
     focusRing: z
         .strictObject({
@@ -300,7 +285,7 @@ const MetadataGroup = z.strictObject({
  * `spacing`, `shape`) map 1:1 to `@ggui-ai/design`'s
  * `generateCssVariables` walker targets — anything less would mean
  * a partial CSS output worse than falling back to the shipped
- * default. Optional groups (`motion`, `canvas`, `accessibility`,
+ * default. Optional groups (`motion`, `accessibility`,
  * `zIndex`) are the well-known DTCG additives; present → emitted,
  * absent → the design system's built-in fallbacks apply.
  *
@@ -340,9 +325,6 @@ export const ThemeDocumentV1 = z.strictObject({
     /** Motion tokens — `duration` + `transition` (required sub-records),
      *  `easing` + `keyframes` (optional sub-records). Optional. */
     motion: MotionGroup.optional(),
-    /** Canvas configuration for the GenerativeCanvas background.
-     *  Optional — external tools won't emit this. */
-    canvas: CanvasGroup.optional(),
     /** Accessibility tokens (focus ring, reduced motion, high contrast).
      *  Optional. */
     accessibility: AccessibilityGroup.optional(),

package/dist/ui-manifest.d.ts

@@ -47,7 +47,7 @@ export declare const UiManifestV1: z.ZodObject<{
     name: z.ZodString;
     /** One-line description of what this UI does. */
     description: z.ZodOptional<z.ZodString>;
-    /** Data contract: props, actions, streams, wired tools, client tools. */
+    /** Data contract: propsSpec, actionSpec, streamSpec, contextSpec, agentCapabilities/clientCapabilities. */
     contract: z.ZodCustom<DataContract, DataContract>;
     /** Category for browsing/filtering (e.g., "dashboard", "form", "data-viz"). */
     category: z.ZodOptional<z.ZodString>;

package/dist/ui-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-manifest.d.ts","sourceRoot":"","sources":["../src/ui-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA4BtD;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,+DAA+D;;IAG/D,kEAAkE;;IAGlE,iDAAiD;;IAGjD,yEAAyE;;IAGzE,+EAA+E;;IAG/E,+DAA+D;;IAK/D,iFAAiF;;IAGjF,2EAA2E;;IAK3E,4EAA4E;;IAG5E;6DACyD;;IAGzD,6EAA6E;;IAG7E,+EAA+E;;kBAE/E,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,YAAY,CAAC,SAAS,CAAC,CAE3C"}
+{"version":3,"file":"ui-manifest.d.ts","sourceRoot":"","sources":["../src/ui-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA4BtD;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,+DAA+D;;IAG/D,kEAAkE;;IAGlE,iDAAiD;;IAGjD,2GAA2G;;IAG3G,+EAA+E;;IAG/E,+DAA+D;;IAK/D,iFAAiF;;IAGjF,2EAA2E;;IAK3E,4EAA4E;;IAG5E;6DACyD;;IAGzD,6EAA6E;;IAG7E,+EAA+E;;kBAE/E,CAAC;AAEH,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,GACX,UAAU,CAAC,OAAO,YAAY,CAAC,SAAS,CAAC,CAE3C"}

package/dist/ui-manifest.js

@@ -69,7 +69,7 @@ export const UiManifestV1 = z.strictObject({
     name: z.string().min(1).max(120),
     /** One-line description of what this UI does. */
     description: z.string().max(500).optional(),
-    /** Data contract: props, actions, streams, wired tools, client tools. */
+    /** Data contract: propsSpec, actionSpec, streamSpec, contextSpec, agentCapabilities/clientCapabilities. */
     contract: z.custom((v) => typeof v === 'object' && v !== null),
     /** Category for browsing/filtering (e.g., "dashboard", "form", "data-viz"). */
     category: z.string().max(60).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/project-config",
-  "version": "0.2.0-alpha.3",
+  "version": "0.3.0-rc.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.2.0-alpha.3",
-    "@ggui-ai/protocol": "0.2.0-alpha.3"
+    "@ggui-ai/design": "0.3.0-rc.0",
+    "@ggui-ai/protocol": "0.3.0-rc.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",