@ibgib/web-gib 0.0.42 → 0.0.44

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.42",
+  "version": "0.0.44",
   "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",
@@ -28,10 +28,10 @@
   "license": "ISC",
   "dependencies": {
     "@google/genai": "^1.33.0",
-    "@ibgib/core-gib": "*",
-    "@ibgib/encrypt-gib": "*",
-    "@ibgib/helper-gib": "*",
-    "@ibgib/ts-gib": "*"
+    "@ibgib/core-gib": "^0.1.58",
+    "@ibgib/encrypt-gib": "^0.2.37",
+    "@ibgib/helper-gib": "^0.0.36",
+    "@ibgib/ts-gib": "^0.5.32"
   },
   "engines": {
     "node": ">=19.0.0"

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.42';
+export const AUTO_GENERATED_VERSION = '0.0.44';

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/identity/identity-constants.mts

@@ -0,0 +1,107 @@
+/**
+ * @file identity-constants.mts
+ * @description Constants for the ibgib identity layer: pool IDs, verbs, KDF salts,
+ * IndexedDB store names, and default pool configuration presets.
+ *
+ * @see docs/identity/KEYSTONES.md
+ * @see docs/identity/TODO.md#02-identity-constants--verbs
+ */
+
+// ===========================================================================
+// IDENTITY VERBS
+// These extend the base KeystoneVerb set with identity-tier-specific actions.
+// Used as values in KeystoneClaim.verb and KeystonePoolConfig.allowedVerbs.
+// ===========================================================================
+
+/** Evolve META: add a LOCAL keystone to the trusted list. */
+export const IDENTITY_VERB_ADD_DEVICE = 'identity-add-device';
+/** Evolve META: remove a LOCAL keystone from the trusted list. */
+export const IDENTITY_VERB_REMOVE_DEVICE = 'identity-remove-device';
+/** Evolve META: transfer custodianship (custodial → sovereign). */
+export const IDENTITY_VERB_CUSTODY_TRANSFER = 'identity-custody-transfer';
+
+/** Evolve LOCAL: register a new APP-LOCAL keystone. */
+export const IDENTITY_VERB_ADD_APP = 'identity-add-app';
+/** Evolve LOCAL: deregister an APP-LOCAL keystone. */
+export const IDENTITY_VERB_REMOVE_APP = 'identity-remove-app';
+
+/** Evolve APP-LOCAL: establish a SESSION keystone genesis. */
+export const IDENTITY_VERB_ESTABLISH_SESSION = 'identity-establish-session';
+/** Evolve APP-LOCAL: authorize an app-level action. */
+export const IDENTITY_VERB_AUTHORIZE = 'identity-authorize';
+/**
+ * Evolve APP-LOCAL (final frame of old epoch): transition to a new epoch keystone.
+ * Uses `consume` replenish strategy — self-contained, no parent evolution needed.
+ * @see docs/identity/PARADIGM.md#epoch-rotation-handling-keystone-growth
+ */
+export const IDENTITY_VERB_EPOCH_TRANSITION = 'identity-epoch-transition';
+
+// ===========================================================================
+// POOL IDs
+// Conventional pool identifiers for each identity tier's pools.
+// ===========================================================================
+
+/** META keystone: structural changes (add/remove device). */
+export const IDENTITY_POOL_ID_ADD_DEVICE = 'identity-add-device';
+/** META keystone: structural changes (remove device). Separate pool allows tighter policy. */
+export const IDENTITY_POOL_ID_REMOVE_DEVICE = 'identity-remove-device';
+/** META keystone: custody transfer (consume strategy — limited uses). */
+export const IDENTITY_POOL_ID_CUSTODY_TRANSFER = 'identity-custody-transfer';
+
+/** LOCAL keystone: register/deregister app-local keystones. */
+export const IDENTITY_POOL_ID_ADD_APP = 'identity-add-app';
+/** LOCAL keystone: deregister app-local keystones. */
+export const IDENTITY_POOL_ID_REMOVE_APP = 'identity-remove-app';
+
+/** APP-LOCAL keystone: establish session keystones. */
+export const IDENTITY_POOL_ID_APP_SESSION = 'identity-app-session';
+/** APP-LOCAL keystone: general app-level authorization. */
+export const IDENTITY_POOL_ID_APP_AUTHORIZE = 'identity-app-authorize';
+/**
+ * APP-LOCAL keystone: epoch transition pool.
+ * Strategy: consume — self-authenticates epoch rotation without parent evolution.
+ */
+export const IDENTITY_POOL_ID_APP_EPOCH = 'identity-app-epoch';
+
+// ===========================================================================
+// KDF SALTS
+// Used to derive tier-specific MasterSecrets from a root passphrase.
+// Different salt per tier ensures independent secrets even with same passphrase.
+// ===========================================================================
+
+export const IDENTITY_KDF_SALT_META = 'ibgib-identity-meta-v1';
+export const IDENTITY_KDF_SALT_LOCAL = 'ibgib-identity-local-v1';
+/**
+ * APP-LOCAL salt base. Full derivation:
+ * `KDF(MasterSecret_local, IDENTITY_KDF_SALT_APP_LOCAL + appId + deviceSalt)`
+ */
+export const IDENTITY_KDF_SALT_APP_LOCAL = 'ibgib-identity-app-local-v1';
+export const IDENTITY_KDF_SALT_SESSION = 'ibgib-identity-session-v1';
+
+// ===========================================================================
+// INDEXEDDB STORE NAMES
+// ===========================================================================
+
+/** Stores `LocalIdentityContext` — one record per browser profile. */
+export const IDENTITY_IDB_STORE_LOCAL_CONTEXT = 'identity-local-context';
+/** Stores `AppLocalIdentityContext` — one record per appId per browser profile. */
+export const IDENTITY_IDB_STORE_APP_LOCAL_CONTEXT = 'identity-app-local-context';
+/** Cached META keystone chain — periodically refreshed from identity service. */
+export const IDENTITY_IDB_STORE_META_CACHE = 'identity-meta-cache';
+/** LOCAL keystone frames — genesis through current tip. */
+export const IDENTITY_IDB_STORE_LOCAL_CHAIN = 'identity-local-chain';
+/** APP-LOCAL keystone frames — current epoch genesis through tip. */
+export const IDENTITY_IDB_STORE_APP_LOCAL_CHAIN = 'identity-app-local-chain';
+
+// ===========================================================================
+// STALENESS POLICY DEFAULTS (milliseconds)
+// App-level policy: how old can a cached META chain be before re-fetch?
+// @see docs/identity/PARADIGM.md#staleness-policy
+// ===========================================================================
+
+/** Default max age for cached META chain for routine verification. */
+export const IDENTITY_META_CACHE_TTL_NORMAL_MS = 60 * 60 * 1000; // 1 hour
+/** For session establishment: always fetch fresh. */
+export const IDENTITY_META_CACHE_TTL_SESSION_MS = 0;
+/** For offline operation: no TTL (accept whatever is cached). */
+export const IDENTITY_META_CACHE_TTL_OFFLINE_MS = Infinity;

package/src/identity/identity-types.mts

@@ -0,0 +1,250 @@
+/**
+ * @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";
+
+// ===========================================================================
+// KEYSTONE DATA EXTENSIONS — one per tier
+// ===========================================================================
+
+/**
+ * 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;
+}
+
+// ===========================================================================
+// BROWSER LOCAL CONTEXT (IndexedDB)
+// ===========================================================================
+
+/**
+ * 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;
+}
+
+// ===========================================================================
+// IDENTITY SERVICE (Shared Space) INTERFACE
+// ===========================================================================
+
+/**
+ * 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>;
+}
+
+// ===========================================================================
+// MASTERSECRET DERIVATION
+// ===========================================================================
+
+/**
+ * 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;
+}