@ggui-ai/cli 0.22.0 → 0.23.0

package/dist/api-client.d.ts

@@ -91,10 +91,12 @@ export interface PatchAppConfigResponse {
 export declare function patchAppConfig(appId: string, patch: {
     gadgets?: GadgetDescriptor[];
     publicEnv?: Record<string, string>;
+    /** `null` clears the app's stored generation route. */
     generation?: {
         model: string;
         keySource: 'own' | 'managed';
-    };
-    theme?: AppTheme;
+    } | null;
+    /** `null` clears the app's stored theme. */
+    theme?: AppTheme | null;
 }): Promise<PatchAppConfigResponse>;
 //# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/config-push.d.ts

@@ -14,24 +14,38 @@ export declare function readPublicEnvFromGguiJson(gguiJson: unknown): Record<str
  * re-validates via `parseAnyLlmRoute` server-side; the CLI just forwards.
  *
  * Returns `{ model, keySource }` when `generation.model` is present.
+ * Returns `null` for an explicit `"generation": null` — the deploy clears
+ * the app's stored generation route (`generation: null` on the wire).
  * Returns `undefined` when the generation block is absent or has no model —
- * the deploy then leaves the app's generation untouched (an explicit
- * `generation: null` on the wire is the only clear; `ggui.json` has no null
- * form for the block, so this reader never emits one).
+ * the deploy then leaves the app's generation untouched.
  * Throws when the generation block is structurally invalid.
  */
 export declare function readGenerationFromGguiJson(gguiJson: unknown): {
     model: string;
     keySource: 'own' | 'managed';
-} | undefined;
+} | null | undefined;
+/** What `ggui.json#theme` resolves to for a deploy. */
+export interface ThemeRead {
+    /** The projection the PATCH ships. */
+    readonly theme: AppTheme;
+    /**
+     * The families the document's `typography.faces` declare, deduped in
+     * declaration order. The hosted path does not deliver them yet
+     * (ggui#990): the deploy names them so the fallback is visible, not
+     * silent.
+     */
+    readonly declaredFaceFamilies: readonly string[];
+}
 /**
  * Resolve the developer's local `ggui.json#theme` into a concrete,
  * injection-safe {@link AppTheme} ready to PATCH to the cloud.
  *
- * Returns `undefined` when no `theme` field is declared (deploy leaves the
- * app's theme untouched — an explicit `theme: null` on the wire is the only
- * clear, on every door; `ggui.json` has no null form for `theme`, so this
- * reader never emits one).
+ * Returns `undefined` when no `theme` field is declared: the deploy leaves
+ * the app's theme untouched.
+ *
+ * Returns `null` for an explicit `"theme": null`: the deploy clears the
+ * app's stored theme (`theme: null` on the wire). A clear needs nothing else
+ * from the file, so the manifest is not parsed.
  *
  * When a theme IS declared we parse the FULL manifest (via `parseGguiJson`)
  * — `loadTheme` requires the typed `GguiJsonV1` shape and resolves relative
@@ -44,19 +58,7 @@ export declare function readGenerationFromGguiJson(gguiJson: unknown): {
  *     backend enforces, so a deploy fails loud LOCALLY rather than with a
  *     confusing 422.
  */
-/** What `ggui.json#theme` resolves to for a deploy. */
-export interface ThemeRead {
-    /** The projection the PATCH ships. */
-    readonly theme: AppTheme;
-    /**
-     * The families the document's `typography.faces` declare, deduped in
-     * declaration order. The hosted path does not deliver them yet
-     * (ggui#990): the deploy names them so the fallback is visible, not
-     * silent.
-     */
-    readonly declaredFaceFamilies: readonly string[];
-}
-export declare function readThemeFromGguiJson(projectRoot: string, gguiJson: unknown): Promise<ThemeRead | undefined>;
+export declare function readThemeFromGguiJson(projectRoot: string, gguiJson: unknown): Promise<ThemeRead | null | undefined>;
 /**
  * Assert that none of the gadget bundle references point at a loopback host.
  *

package/dist/config-push.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-push.d.ts","sourceRoot":"","sources":["../src/config-push.ts"],"names":[],"mappings":"AAUA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAmB3B;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAkB7D;AAGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CA0DhC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAiB9E;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAqGjB"}
+{"version":3,"file":"config-push.d.ts","sourceRoot":"","sources":["../src/config-push.ts"],"names":[],"mappings":"AAUA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAmB3B;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAoBpE;AAGD,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,CA2DvC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAiB9E;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAgHjB"}

package/dist/config-push.js

@@ -52,10 +52,10 @@ export function readPublicEnvFromGguiJson(gguiJson) {
  * re-validates via `parseAnyLlmRoute` server-side; the CLI just forwards.
  *
  * Returns `{ model, keySource }` when `generation.model` is present.
+ * Returns `null` for an explicit `"generation": null` — the deploy clears
+ * the app's stored generation route (`generation: null` on the wire).
  * Returns `undefined` when the generation block is absent or has no model —
- * the deploy then leaves the app's generation untouched (an explicit
- * `generation: null` on the wire is the only clear; `ggui.json` has no null
- * form for the block, so this reader never emits one).
+ * the deploy then leaves the app's generation untouched.
  * Throws when the generation block is structurally invalid.
  */
 export function readGenerationFromGguiJson(gguiJson) {
@@ -65,25 +65,52 @@ export function readGenerationFromGguiJson(gguiJson) {
             model: z.string().min(1).optional(),
             keySource: z.enum(['own', 'managed']).optional(),
         })
+            .nullable()
             .optional(),
     });
     const result = schema.safeParse(gguiJson);
     if (!result.success) {
         throw new Error(`ggui.json: generation is invalid — ${result.error.issues[0]?.message ?? 'malformed generation block'}`);
     }
+    if (result.data.generation === null)
+        return null;
     const model = result.data.generation?.model;
     if (!model)
         return undefined;
     return { model, keySource: result.data.generation?.keySource ?? 'managed' };
 }
+/**
+ * Resolve the developer's local `ggui.json#theme` into a concrete,
+ * injection-safe {@link AppTheme} ready to PATCH to the cloud.
+ *
+ * Returns `undefined` when no `theme` field is declared: the deploy leaves
+ * the app's theme untouched.
+ *
+ * Returns `null` for an explicit `"theme": null`: the deploy clears the
+ * app's stored theme (`theme: null` on the wire). A clear needs nothing else
+ * from the file, so the manifest is not parsed.
+ *
+ * When a theme IS declared we parse the FULL manifest (via `parseGguiJson`)
+ * — `loadTheme` requires the typed `GguiJsonV1` shape and resolves relative
+ * `theme.file` paths against `projectRoot`, so a partial slice will not do.
+ *
+ * Throws with a clear, local message when:
+ *   - the manifest is structurally invalid (so deploy fails before the wire);
+ *   - the theme cannot be loaded (e.g. an unregistered preset id);
+ *   - the resolved overlay fails `appThemeSchema` — the SAME validator the
+ *     backend enforces, so a deploy fails loud LOCALLY rather than with a
+ *     confusing 422.
+ */
 export async function readThemeFromGguiJson(projectRoot, gguiJson) {
     // Cheap pre-check on the raw value: no `theme` field → nothing to push,
-    // and we avoid forcing a full-manifest parse on theme-less deploys.
+    // `null` → a clear; either way no full-manifest parse.
     const presence = z
         .object({ theme: z.unknown().optional() })
         .safeParse(gguiJson);
     if (!presence.success || presence.data.theme === undefined)
         return undefined;
+    if (presence.data.theme === null)
+        return null;
     // A theme is declared — `loadTheme` needs the fully-typed manifest.
     let manifest;
     try {
@@ -184,6 +211,7 @@ export async function runConfigPushStep(appId, startDir = process.cwd()) {
         return 1;
     }
     let publicEnv;
+    // `null` = the deploy's explicit clear; `undefined` = leave it untouched.
     let generation;
     let theme;
     const gadgetsRead = readGadgetsFromGguiJson(readResult.value);
@@ -210,8 +238,8 @@ export async function runConfigPushStep(appId, startDir = process.cwd()) {
         // `loadTheme` resolves relative `theme.file` paths against the directory
         // containing ggui.json — the same root convention `storage.*.path` uses.
         const read = await readThemeFromGguiJson(dirname(gguiJsonPath), readResult.value);
-        theme = read?.theme;
-        if (read !== undefined && read.declaredFaceFamilies.length > 0) {
+        theme = read === null ? null : read?.theme;
+        if (read != null && read.declaredFaceFamilies.length > 0) {
             // ggui#990/#1093: the PATCH now CARRIES the faces (`AppTheme.fonts`)
             // and a server on this release inlines them in the shell it serves.
             // A deployment still running an older release cannot — so the deploy
@@ -248,8 +276,16 @@ export async function runConfigPushStep(appId, startDir = process.cwd()) {
     const envLine = Object.keys(publicEnv).length > 0
         ? ` + ${Object.keys(publicEnv).length} publicEnv key(s)`
         : '';
-    const generationLine = generation !== undefined ? ` + model ${generation.model}` : '';
-    const themeLine = theme !== undefined ? ` + theme ${theme.name ?? theme.mode}` : '';
+    const generationLine = generation === null
+        ? ' + generation cleared'
+        : generation !== undefined
+            ? ` + model ${generation.model}`
+            : '';
+    const themeLine = theme === null
+        ? ' + theme cleared'
+        : theme !== undefined
+            ? ` + theme ${theme.name ?? theme.mode}`
+            : '';
     process.stdout.write(`  ${gadgetLine}${envLine}${generationLine}${themeLine}\n`);
     return 0;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/cli",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "The `ggui` CLI — run the ggui protocol locally: dev server, self-hosted MCP server, and gadget / blueprint authoring. End-to-end OSS and self-hosted workflows; no account required.",
   "keywords": [
     "ggui",
@@ -37,22 +37,22 @@
     "@noble/hashes": "^1.6.0",
     "esbuild": "^0.28.2",
     "zod": "^4.3.6",
-    "@ggui-ai/agent-runtime": "0.22.0",
-    "@ggui-ai/design": "0.22.0",
-    "@ggui-ai/dev-stack": "0.22.0",
-    "@ggui-ai/artifact-manifest": "0.22.0",
-    "@ggui-ai/gadget-signing": "0.22.0",
-    "@ggui-ai/embedding-local": "0.22.0",
-    "@ggui-ai/mcp-server-core": "0.22.0",
-    "@ggui-ai/mcp-server": "0.22.0",
-    "@ggui-ai/mcp-server-handlers": "0.22.0",
-    "@ggui-ai/preview-a2ui": "0.22.0",
-    "@ggui-ai/project-config": "0.22.0",
-    "@ggui-ai/protocol": "0.22.0",
-    "@ggui-ai/registry-core": "0.22.0",
-    "@ggui-ai/iframe-runtime": "0.22.0",
-    "@ggui-ai/ui-gen": "0.22.0",
-    "@ggui-ai/ui-registry": "0.22.0"
+    "@ggui-ai/agent-runtime": "0.23.0",
+    "@ggui-ai/artifact-manifest": "0.23.0",
+    "@ggui-ai/design": "0.23.0",
+    "@ggui-ai/dev-stack": "0.23.0",
+    "@ggui-ai/gadget-signing": "0.23.0",
+    "@ggui-ai/embedding-local": "0.23.0",
+    "@ggui-ai/mcp-server": "0.23.0",
+    "@ggui-ai/mcp-server-handlers": "0.23.0",
+    "@ggui-ai/preview-a2ui": "0.23.0",
+    "@ggui-ai/project-config": "0.23.0",
+    "@ggui-ai/protocol": "0.23.0",
+    "@ggui-ai/iframe-runtime": "0.23.0",
+    "@ggui-ai/ui-gen": "0.23.0",
+    "@ggui-ai/mcp-server-core": "0.23.0",
+    "@ggui-ai/registry-core": "0.23.0",
+    "@ggui-ai/ui-registry": "0.23.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",