@ibgib/web-gib 0.0.36 → 0.0.43

package/dist/identity/identity-types.d.mts

@@ -0,0 +1,214 @@
+/**
+ * @file identity-types.mts
+ * @description Type definitions for the four-tier ibgib identity hierarchy.
+ *
+ * ## Tier Overview
+ * ```
+ * META keystone           → universal identity handle (cross-app, cross-device)
+ * └─ LOCAL keystone       → device/browser-profile-scoped identity
+ *    └─ APP-LOCAL keystone → app-scoped identity (one per app per browser profile)
+ *       └─ SESSION keystone → session-scoped (existing sync protocol)
+ * ```
+ *
+ * @see docs/identity/PARADIGM.md
+ * @see docs/identity/KEYSTONES.md
+ */
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { KeystoneData_V1, KeystoneIbGib_V1 } from "@ibgib/core-gib/dist/keystone/keystone-types.mjs";
+/**
+ * Data shape for the META keystone tier.
+ *
+ * The META keystone is the user's universal identity — stable across all apps,
+ * devices, and time. Its `tjpGib` is the user's permanent identity handle.
+ *
+ * @see docs/identity/KEYSTONES.md#meta-keystone
+ * @see docs/identity/PARADIGM.md#meta-keystone
+ */
+export interface MetaKeystoneData extends KeystoneData_V1 {
+    /**
+     * List of LOCAL keystone `tjpGib` values currently trusted by this identity.
+     *
+     * This is the **trust register** — an app verifies a user by finding the
+     * LOCAL keystone's tjpGib in this list from the current META frame.
+     *
+     * Mutated by: add-device evolution (append), remove-device evolution (remove).
+     *
+     * @see docs/identity/PARADIGM.md#cross-app-identity
+     */
+    trustedLocalTjpGibs: IbGibAddr[];
+    /**
+     * For custodial keystones: the publicly-visible nonce used by the custodian
+     * to re-derive `MasterSecret_user = KDF(server_secret, custodialNonce)`.
+     *
+     * No secrecy requirement — security comes from `server_secret` alone.
+     * Stored here so the custodian needs no separate mapping table.
+     *
+     * Undefined for sovereign (user-held) keystones.
+     *
+     * @see docs/identity/PARADIGM.md#custodianship--the-oauth2-path
+     * @see docs/identity/FLOWS.md#flow-2-first-login--custodial-path-oauth2
+     */
+    custodialNonce?: string;
+}
+/**
+ * Data shape for the LOCAL keystone tier.
+ *
+ * Device/browser-profile-scoped identity. Evolves offline. Lives in IndexedDB.
+ * One per browser profile per user.
+ *
+ * @see docs/identity/KEYSTONES.md#local-keystone
+ */
+export interface LocalKeystoneData extends KeystoneData_V1 {
+    /**
+     * Map of registered APP-LOCAL keystones on this browser profile.
+     *
+     * Key: `appId`
+     * Value: the **first epoch** APP-LOCAL keystone `tjpGib` for that app.
+     *
+     * Subsequent epochs are authenticated transitively through the APP-LOCAL
+     * epoch chain — the LOCAL keystone does NOT need to evolve for epoch rotation.
+     *
+     * Mutated by: add-app evolution (set), remove-app evolution (delete).
+     *
+     * @see docs/identity/PARADIGM.md#epoch-rotation-handling-keystone-growth
+     */
+    registeredAppLocals: Record<string, IbGibAddr>;
+}
+/**
+ * Data shape for the APP-LOCAL keystone tier.
+ *
+ * App-scoped identity for a specific browser profile + app combination.
+ * Evolves offline. Lives in IndexedDB (client) and app server (synced).
+ * One per app per browser profile per user.
+ *
+ * @see docs/identity/KEYSTONES.md#app-local-keystone
+ */
+export interface AppLocalKeystoneData extends KeystoneData_V1 {
+    /** The app identifier this APP-LOCAL belongs to. */
+    appId: string;
+    /**
+     * The LOCAL keystone `tjpGib` this APP-LOCAL is derived from.
+     * Used by verifiers to link APP-LOCAL trust back to LOCAL → META.
+     */
+    localTjpGib: IbGibAddr;
+    /**
+     * The META keystone `tjpGib` for this identity.
+     * Stored for reference/display. The authoritative trust chain is
+     * always verified by replaying META → LOCAL → APP-LOCAL.
+     */
+    metaTjpGib: IbGibAddr;
+    /**
+     * For epoch-chained APP-LOCAL keystones: the ibgib address of the
+     * **final frame** of the previous epoch. Establishes the transitive
+     * trust chain from the first epoch.
+     *
+     * Undefined for the first epoch (no prior epoch).
+     *
+     * @see docs/identity/PARADIGM.md#epoch-rotation-handling-keystone-growth
+     */
+    prevEpochFinalFrameAddr?: IbGibAddr;
+}
+/**
+ * The browser-local identity context for a user on this browser profile.
+ * Stored in IndexedDB. Reconstructed from keystone chains if lost.
+ *
+ * @see docs/identity/FLOWS.md#flow-3-return-login--same-browser-profile
+ * @see docs/identity/PARTIES.md#party-app-client
+ */
+export interface LocalIdentityContext {
+    /** The user's universal identity handle. Used for cross-app identity. */
+    metaTjpGib: IbGibAddr;
+    /** URL of the identity service hosting the user's META keystone. */
+    identityServiceUrl: string;
+    /** This browser profile's LOCAL keystone `tjpGib`. */
+    localTjpGib: IbGibAddr;
+}
+/**
+ * Per-app identity context for a specific browser profile + app.
+ * Stored in IndexedDB by the app client.
+ *
+ * @see docs/identity/KEYSTONES.md#app-local-keystone
+ */
+export interface AppLocalIdentityContext {
+    /** The user's universal identity handle. */
+    metaTjpGib: IbGibAddr;
+    /** This browser profile's LOCAL keystone `tjpGib`. */
+    localTjpGib: IbGibAddr;
+    /**
+     * The **current** (possibly epoch-N) APP-LOCAL keystone `tjpGib`.
+     * Updated in-place after each epoch rotation.
+     */
+    appLocalTjpGib: IbGibAddr;
+    /** The app identifier. */
+    appId: string;
+}
+/**
+ * The shared identity space — a write-verifying history store.
+ *
+ * NOT an authority. Verifies chain continuity on writes. Serves raw chain
+ * data on reads. Any party can independently verify the chain it returns.
+ *
+ * Initial deployment: hosted on the app's server. Federated by design.
+ *
+ * @see docs/identity/PARADIGM.md#the-shared-identity-space
+ * @see docs/identity/PARTIES.md#party-identity-service
+ */
+export interface IIdentityService {
+    /**
+     * POST a genesis frame — accepted unconditionally if internally valid.
+     * Genesis is self-legitimizing: Alice's identity IS her genesis frame.
+     *
+     * @returns the `tjpGib` (ibgib address of the genesis frame)
+     * @throws if the frame is internally invalid (malformed structure)
+     */
+    postGenesis(frame: KeystoneIbGib_V1): Promise<{
+        tjpGib: IbGibAddr;
+    }>;
+    /**
+     * POST an evolution frame.
+     * Verifies chain continuity: revealed solutions must hash-match prior
+     * frame's commitments. Implements CAS: rejects if prior frame is stale.
+     *
+     * @throws `IdentityServiceStaleTipError` if prior frame is no longer tip
+     * @throws `IdentityServiceChainError` if hash pre-images are invalid
+     */
+    postEvolution(frame: KeystoneIbGib_V1): Promise<void>;
+    /**
+     * GET the full keystone chain from genesis to current tip.
+     *
+     * Does NOT change state. Safe to call without coordination.
+     */
+    getChain(tjpGib: IbGibAddr): Promise<KeystoneIbGib_V1[]>;
+    /**
+     * GET the current tip frame for a keystone.
+     *
+     * Does NOT change state.
+     */
+    getTip(tjpGib: IbGibAddr): Promise<KeystoneIbGib_V1>;
+}
+/**
+ * Inputs for deriving a tier-specific MasterSecret from a root passphrase.
+ *
+ * Each tier uses a different salt to ensure independent MasterSecrets
+ * even when the same passphrase is used for all tiers.
+ *
+ * @see docs/identity/KEYSTONES.md for per-tier salt conventions
+ * @see identity-helpers.mts for derivation functions
+ */
+export interface MasterSecretDerivationContext {
+    /** The root passphrase (sovereign path) or server secret (custodial path). */
+    passphrase: string;
+    /**
+     * Tier-specific salt (e.g., `IDENTITY_KDF_SALT_META`, `IDENTITY_KDF_SALT_LOCAL`).
+     * @see identity-constants.mts
+     */
+    salt: string;
+    /**
+     * Additional device-specific entropy for LOCAL and APP-LOCAL tiers.
+     * Generated once per browser profile and stored in IndexedDB.
+     */
+    deviceSalt?: string;
+    /** For APP-LOCAL tier: the app identifier, mixed into derivation. */
+    appId?: string;
+}
+//# sourceMappingURL=identity-types.d.mts.map

package/dist/identity/identity-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-types.d.mts","sourceRoot":"","sources":["../../src/identity/identity-types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAMrG;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACrD;;;;;;;;;OASG;IACH,mBAAmB,EAAE,SAAS,EAAE,CAAC;IAEjC;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACtD;;;;;;;;;;;;OAYG;IACH,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IACzD,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,SAAS,CAAC;IAEvB;;;;OAIG;IACH,UAAU,EAAE,SAAS,CAAC;IAEtB;;;;;;;;OAQG;IACH,uBAAuB,CAAC,EAAE,SAAS,CAAC;CACvC;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACjC,yEAAyE;IACzE,UAAU,EAAE,SAAS,CAAC;IAEtB,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAC;IAE3B,sDAAsD;IACtD,WAAW,EAAE,SAAS,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACpC,4CAA4C;IAC5C,UAAU,EAAE,SAAS,CAAC;IAEtB,sDAAsD;IACtD,WAAW,EAAE,SAAS,CAAC;IAEvB;;;OAGG;IACH,cAAc,EAAE,SAAS,CAAC;IAE1B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAErE;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEzD;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxD;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,6BAA6B;IAC1C,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/identity/identity-types.mjs

@@ -0,0 +1,17 @@
+/**
+ * @file identity-types.mts
+ * @description Type definitions for the four-tier ibgib identity hierarchy.
+ *
+ * ## Tier Overview
+ * ```
+ * META keystone           → universal identity handle (cross-app, cross-device)
+ * └─ LOCAL keystone       → device/browser-profile-scoped identity
+ *    └─ APP-LOCAL keystone → app-scoped identity (one per app per browser profile)
+ *       └─ SESSION keystone → session-scoped (existing sync protocol)
+ * ```
+ *
+ * @see docs/identity/PARADIGM.md
+ * @see docs/identity/KEYSTONES.md
+ */
+export {};
+//# sourceMappingURL=identity-types.mjs.map

package/dist/identity/identity-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-types.mjs","sourceRoot":"","sources":["../../src/identity/identity-types.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/ui/ui-helpers.d.mts

@@ -34,9 +34,40 @@ export declare function showFullscreenDialog(opts: {
     cancelButtonTitle?: string;
     isPassword?: boolean;
 }): Promise<string | undefined>;
+/**
+ * Gets {@link UIThemeInfo} if it exists in the db ({@link dbName}) and store
+ * ({@link storeName}) at the given {@link key}.
+ *
+ * Used with libs\web-gib\src\api\commands\ui\update-css-variables.mts
+ *
+ * @see {@link putUIInfoInStore}
+ * @see {@link UI_THEME_INFO_KEY}
+ * @see {@link putUIInfoInStore}
+ * @see {@link getGlobalDbName}
+ * @see {@link getGlobalStoreName}
+ */
 export declare function getExistingUIInfo({ dbName, storeName, key, }: {
     dbName: string;
     storeName: string;
     key?: string;
 }): Promise<UIThemeInfo | undefined>;
+/**
+ * Complementing {@link getExistingUIInfo}, this puts {@link newUIInfo} in the
+ * db ({@link dbName}) and into the store ({@link storeName}) at the given
+ * {@link key}.
+ *
+ * Used with libs\web-gib\src\api\commands\ui\update-css-variables.mts
+ *
+ * @see {@link getExistingUIInfo}
+ * @see {@link UI_THEME_INFO_KEY}
+ * @see {@link putUIInfoInStore}
+ * @see {@link getGlobalDbName}
+ * @see {@link getGlobalStoreName}
+ */
+export declare function putUIInfoInStore({ dbName, storeName, key, newUIInfo, }: {
+    dbName: string;
+    storeName: string;
+    key?: string;
+    newUIInfo: UIThemeInfo;
+}): Promise<void>;
 //# sourceMappingURL=ui-helpers.d.mts.map

package/dist/ui/ui-helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-helpers.d.mts","sourceRoot":"","sources":["../../src/ui/ui-helpers.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2I9B;AAED,wBAAsB,iBAAiB,CAAC,EACpC,MAAM,EACN,SAAS,EACT,GAAuB,GAC1B,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA6BnC"}
+{"version":3,"file":"ui-helpers.d.mts","sourceRoot":"","sources":["../../src/ui/ui-helpers.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2I9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,EACpC,MAAM,EACN,SAAS,EACT,GAAuB,GAC1B,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA6BnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,EACnC,MAAM,EACN,SAAS,EACT,GAAuB,EACvB,SAAS,GACZ,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,WAAW,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB"}

package/dist/ui/ui-helpers.mjs

@@ -1,6 +1,6 @@
 import { delay, extractErrorMsg, } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
 import { GLOBAL_LOG_A_LOT } from "../constants.mjs";
-import { storageGet } from "../storage/storage-helpers.web.mjs";
+import { storageGet, storagePut } from "../storage/storage-helpers.web.mjs";
 import { UI_THEME_INFO_KEY } from "./ui-constants.mjs";
 const logalot = GLOBAL_LOG_A_LOT;
 /**
@@ -159,6 +159,18 @@ export async function showFullscreenDialog(opts) {
         }
     }
 }
+/**
+ * Gets {@link UIThemeInfo} if it exists in the db ({@link dbName}) and store
+ * ({@link storeName}) at the given {@link key}.
+ *
+ * Used with libs\web-gib\src\api\commands\ui\update-css-variables.mts
+ *
+ * @see {@link putUIInfoInStore}
+ * @see {@link UI_THEME_INFO_KEY}
+ * @see {@link putUIInfoInStore}
+ * @see {@link getGlobalDbName}
+ * @see {@link getGlobalStoreName}
+ */
 export async function getExistingUIInfo({ dbName, storeName, key = UI_THEME_INFO_KEY, }) {
     const lc = `[${getExistingUIInfo.name}]`;
     try {
@@ -195,4 +207,41 @@ export async function getExistingUIInfo({ dbName, storeName, key = UI_THEME_INFO
         }
     }
 }
+/**
+ * Complementing {@link getExistingUIInfo}, this puts {@link newUIInfo} in the
+ * db ({@link dbName}) and into the store ({@link storeName}) at the given
+ * {@link key}.
+ *
+ * Used with libs\web-gib\src\api\commands\ui\update-css-variables.mts
+ *
+ * @see {@link getExistingUIInfo}
+ * @see {@link UI_THEME_INFO_KEY}
+ * @see {@link putUIInfoInStore}
+ * @see {@link getGlobalDbName}
+ * @see {@link getGlobalStoreName}
+ */
+export async function putUIInfoInStore({ dbName, storeName, key = UI_THEME_INFO_KEY, newUIInfo, }) {
+    const lc = `[${putUIInfoInStore.name}]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: 79c9ee707e426fd8c861c4ff4cf16826)`);
+        }
+        await storagePut({
+            dbName,
+            storeName,
+            key,
+            value: JSON.stringify(newUIInfo),
+        });
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+;
 //# sourceMappingURL=ui-helpers.mjs.map

package/dist/ui/ui-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ui-helpers.mjs","sourceRoot":"","sources":["../../src/ui/ui-helpers.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ui-helpers.mjs","sourceRoot":"","sources":["../../src/ui/ui-helpers.mts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/web-gib",
-  "version": "0.0.36",
+  "version": "0.0.43",
   "description": "Framework for creating agentic ibGib web apps. Contains plumbing for ibgib components, agentic framework (currently only Gemini implemented), web-based IndexedDB storage substrate, and more.",
   "funding": {
     "type": "individual",
@@ -11,31 +11,10 @@
     "web-gib-init-agents": "./tools/init-agents.js"
   },
   "scripts": {
-    "clean": "node ../../node_modules/@ibgib/helper-gib/tools/clean.js ./dist",
-    "generate:src:version": "node ./tools/generate-version-file.js",
-    "generate:agent:skills": "node ./tools/copy-agent-skills.js",
-    "prebuild": "npm run generate:src:version && npm run generate:agent:skills",
-    "build": "npm run clean && tsc -b tsconfig.json --force",
-    "build:test": "npm run clean && tsc -b tsconfig.test.json --force",
-    "build:test:noclean": "tsc -b tsconfig.test.json --force",
-    "test": "npm run test:both",
-    "test:both": "npm run build:test && npm run test:node:nobuild && npm run test:browser:nobuild",
-    "man:test:both": "use this if you want to test in both node and browser contexts",
-    "pretest:node": "npm run build:test",
-    "test:node": "node dist/respec-gib.node.mjs --inspect",
-    "man:test:node": "use this if you want to build+test in node",
-    "test:node:nobuild": "node dist/respec-gib.node.mjs --inspect",
-    "man:test:node:nobuild": "use this if you want to test in node but its already built",
-    "test:browser": "npm run build:test && echo \"not implemented yet\"",
-    "man:test:browser": "use this if you want to build+test only the browser context",
-    "test:browser:nobuild": "echo \"not implemented yet\"",
-    "man:test:browser:nobuild": "use this if you want to test only the browser context but its already built",
-    "test:browser:serve": "npm run build:test && echo \"not implemented yet\"",
-    "man:test:browser:serve": "use this if you want to build+test in the browser and don't want the browser to close when your done. (i.e. you're debugging)",
-    "test:browser:serve:nobuild": "\"not implemented yet\"",
-    "man:test:browser:serve:nobuild": "use this if you are troubleshooting existing dist output and don't want to overwrite those files. (and you're debugging in the browser)",
+    "//_orchestration": "~~ ORCHESTRATION (handled by @ibgib/build-gib) ~~",
+    "//_publish": "~~ PUBLISH ~~",
     "pack": "npm pack --pack-destination=\"./published\"",
-    "prepare:publish": "npm run clean && npm version patch && npm run build && npm run pack",
+    "prepare:publish": "npm version patch && node ../../build/dist/concrete-build/build-web-gib.mjs --prod && npm run pack",
     "man:prepare:publish": "use this to patch > build > pack for publishing to npm repo"
   },
   "type": "module",
@@ -49,7 +28,7 @@
   "license": "ISC",
   "dependencies": {
     "@google/genai": "^1.33.0",
-    "@ibgib/core-gib": "^0.1.54",
+    "@ibgib/core-gib": "^0.1.55",
     "@ibgib/encrypt-gib": "^0.2.37",
     "@ibgib/helper-gib": "^0.0.36",
     "@ibgib/ts-gib": "^0.5.32"

package/src/AUTO-GENERATED-version.mts

@@ -11,4 +11,4 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export const AUTO_GENERATED_VERSION = '0.0.36';
+export const AUTO_GENERATED_VERSION = '0.0.43';

package/src/api/commands/ui/ui-index.mts

@@ -1,6 +1,6 @@
 import { APIFunctionInfo } from "../../api-types.mjs";
-import { updateCSSVariablesFunctionInfo } from './update-css-variables.mjs';
+// import { updateCSSVariablesFunctionInfo } from './update-css-variables.mjs';
 
 export const UIAgentFunctionInfos: APIFunctionInfo<any>[] = [
-    updateCSSVariablesFunctionInfo,
+    // updateCSSVariablesFunctionInfo,
 ];

package/src/api/commands/ui/update-css-variables.mts

@@ -9,7 +9,7 @@ import { FUNCTION_CALL_EXAMPLES_HEADER } from "../../api-constants.mjs";
 import { UI_THEME_INFO_KEY, VALID_CSS_VARIABLES } from "../../../ui/ui-constants.mjs";
 import { storagePut } from "../../../storage/storage-helpers.web.mjs";
 import { UIThemeInfo } from "../../../ui/ui-types.mjs";
-import { getExistingUIInfo } from "../../../ui/ui-helpers.mjs";
+import { getExistingUIInfo, putUIInfoInStore } from "../../../ui/ui-helpers.mjs";
 import { getGlobalDbName, getGlobalStoreName } from "../../../helpers.web.mjs";
 
 const logalot = GLOBAL_LOG_A_LOT;
@@ -126,7 +126,7 @@ async function updateCSSVariablesImpl(opts: UpdateCSSVariablesOpts): Promise<voi
 
         // update the theme in the options
         const dbName = getGlobalDbName();
-        const storeName = await getGlobalStoreName();
+        const storeName = getGlobalStoreName();
         const existingUIInfo = await getExistingUIInfo({ dbName, storeName }) ?? { cssVariableOverrides: {}, };
         const newUIInfo: UIThemeInfo = {
             ...existingUIInfo,
@@ -136,11 +136,10 @@ async function updateCSSVariablesImpl(opts: UpdateCSSVariablesOpts): Promise<voi
             },
         };
 
-        await storagePut({
+        await putUIInfoInStore({
             dbName,
-            storeName: await getGlobalStoreName(),
-            key: UI_THEME_INFO_KEY,
-            value: JSON.stringify(newUIInfo),
+            storeName,
+            newUIInfo,
         });
     } catch (error) {
         console.error(`${lc} ${extractErrorMsg(error)}`);
@@ -152,36 +151,55 @@ async function updateCSSVariablesImpl(opts: UpdateCSSVariablesOpts): Promise<voi
 
 
 /**
- * API function info for the updateCSSVariables command.
+ * Factory function to get an API function info for the updateCSSVariables
+ * command. This enables an agent to update the {@link cssVariables} to create
+ * dynamic themes, which in turn enables users to use natural language to change
+ * the theme.
+ *
+ * initially this was just {@link VALID_CSS_VARIABLES}, but we have changed
+ * this to be a dynamic factory function driven by this {@link cssVariables}.
  */
-export const updateCSSVariablesFunctionInfo: APIFunctionInfo<typeof updateCSSVariablesViaCmd> = {
-    nameOrId: FUNCTION_NAME,
-    fnViaCmd: updateCSSVariablesViaCmd,
-    functionImpl: updateCSSVariablesImpl,
-    cmd: CMD_CATEGORY,
-    cmdModifiers: CMD_MODIFIERS,
-    schema: {
-        name: FUNCTION_NAME,
-        description: FUNCTION_DESCRIPTION,
-        parameters: {
-            type: 'object',
-            properties: {
-                ...COMMAND_BASE_SCHEMA_PROPERTIES,
-                cssVariables: {
-                    type: 'object',
-                    description: 'CSS variables to update when theming or otherwise changing these visual aspects of the web app per user preferences or the user directly asking for it. (atow there are no preferences saved or anything, so this is just user-driven if they ask for it.)',
-                    properties: Object.fromEntries(
-                        VALID_CSS_VARIABLES.map(varName => [
-                            varName,
-                            {
-                                type: 'string',
-                                description: `configurable css variable`,
-                            },
-                        ])
-                    ),
-                }
+export function getFunctionInfo_updateCSSVariablesFunctionInfo({
+    cssVariables,
+}: {
+    /**
+     * list of variables that the agent has access to change.
+     */
+    cssVariables: string[],
+}): APIFunctionInfo<typeof updateCSSVariablesViaCmd> {
+    return {
+        nameOrId: FUNCTION_NAME,
+        fnViaCmd: updateCSSVariablesViaCmd,
+        functionImpl: updateCSSVariablesImpl,
+        cmd: CMD_CATEGORY,
+        cmdModifiers: CMD_MODIFIERS,
+        schema: {
+            name: FUNCTION_NAME,
+            description: FUNCTION_DESCRIPTION,
+            parameters: {
+                type: 'object',
+                properties: {
+                    ...COMMAND_BASE_SCHEMA_PROPERTIES,
+                    cssVariables: {
+                        type: 'object',
+                        description: 'CSS variables to update when theming or otherwise changing these visual aspects of the web app per user preferences or the user directly asking for it. (atow there are no preferences saved or anything, so this is just user-driven if they ask for it.)',
+                        properties: Object.fromEntries(
+                            cssVariables.map(varName => [
+                                varName,
+                                {
+                                    type: 'string',
+                                    description: `configurable css variable`,
+                                },
+                            ])
+                        ),
+                    }
+                },
+                required: ['cssVariables'],
             },
-            required: ['cssVariables'],
         },
-    },
+    };
 };
+
+export const updateCSSVariablesFunctionInfo = getFunctionInfo_updateCSSVariablesFunctionInfo({
+    cssVariables: VALID_CSS_VARIABLES,
+});

package/src/app-bootstrap/types.mts

@@ -122,6 +122,26 @@ export interface IbGibIdentityContext {
     data?: Record<string, any>;
 }
 
+// ---------------------------------------------------------------------------
+// UI Shell
+// ---------------------------------------------------------------------------
+
+/**
+ * Minimal interface for an application's UI Shell.
+ *
+ * ## design notes
+ *
+ * This is intentionally minimal to avoid coupling the bootstrap engine to a
+ * specific UI design (header, panels, etc.).
+ */
+export interface IbGibAppShell {
+    /**
+     * Hook called by the bootstrap engine when the ibGib engine and metaspace
+     * are fully initialized and ready for interaction.
+     */
+    onEngineReady(): void;
+}
+
 // ---------------------------------------------------------------------------
 // GlobalThis layers
 // ---------------------------------------------------------------------------
@@ -163,6 +183,11 @@ export interface IbGibGlobalThis_Common extends IbGibGlobalThisInfo {
 export interface IbGibGlobalThis_IbGibApp extends IbGibGlobalThis_Common {
     /** Semver string generated at build time. */
     version?: string;
+    /** 
+     * The application's UI Shell service. 
+     * Initialized by the consumer and registered on the globalThis.
+     */
+    shell?: IbGibAppShell;
     /** Per-space RCLI pathing shim. */
     spaceShim: { [spaceId: string]: SpaceShimGlobalInfo };
     /** When true, verbose output is enabled for the session. */