@elizaos/shared 2.0.0-alpha.537 → 2.0.0-beta.1

package/dist/config/boot-config-store.js

@@ -0,0 +1,121 @@
+/**
+ * Store-only boot config entry, safe for Bun/Node API paths.
+ *
+ * UI packages may augment the shape with component implementations, but the
+ * shared runtime only needs a process-global config object and a few common
+ * fields used by API clients and asset helpers.
+ */
+export const DEFAULT_BOOT_CONFIG = {
+    branding: {},
+    cloudApiBase: "https://www.elizacloud.ai",
+};
+const BOOT_CONFIG_STORE_KEY = Symbol.for("elizaos.app.boot-config");
+const BOOT_CONFIG_WINDOW_KEY = "__ELIZAOS_APP_BOOT_CONFIG__";
+function getGlobalSlot() {
+    return globalThis;
+}
+function getBootConfigStore() {
+    const globalObject = getGlobalSlot();
+    const mirroredWindowConfig = globalObject[BOOT_CONFIG_WINDOW_KEY];
+    if (mirroredWindowConfig) {
+        const mirroredStore = { current: mirroredWindowConfig };
+        globalObject[BOOT_CONFIG_STORE_KEY] = mirroredStore;
+        return mirroredStore;
+    }
+    const existing = globalObject[BOOT_CONFIG_STORE_KEY];
+    if (existing &&
+        typeof existing === "object" &&
+        "current" in existing) {
+        return existing;
+    }
+    const store = { current: DEFAULT_BOOT_CONFIG };
+    globalObject[BOOT_CONFIG_STORE_KEY] = store;
+    globalObject[BOOT_CONFIG_WINDOW_KEY] = store.current;
+    return store;
+}
+export function setBootConfig(config) {
+    const store = getBootConfigStore();
+    store.current = config;
+    getGlobalSlot()[BOOT_CONFIG_WINDOW_KEY] = config;
+}
+export function getBootConfig() {
+    return getBootConfigStore().current;
+}
+const mirroredBrandKeys = new Set();
+const mirroredElizaKeys = new Set();
+const getProcessEnv = () => {
+    try {
+        const p = globalThis.process;
+        return p?.env ?? null;
+    }
+    catch {
+        return null;
+    }
+};
+/** Sync brand env vars → Eliza equivalents. Server-side only. */
+export function syncBrandEnvToEliza(aliases) {
+    const env = getProcessEnv();
+    if (!env)
+        return;
+    for (const [brandKey, elizaKey] of aliases) {
+        const value = env[brandKey];
+        if (typeof value === "string") {
+            env[elizaKey] = value;
+            mirroredElizaKeys.add(elizaKey);
+        }
+        else if (mirroredElizaKeys.has(elizaKey)) {
+            delete env[elizaKey];
+            mirroredElizaKeys.delete(elizaKey);
+        }
+    }
+}
+/** Sync Eliza env vars → brand equivalents. Server-side only. */
+export function syncElizaEnvToBrand(aliases) {
+    const env = getProcessEnv();
+    if (!env)
+        return;
+    for (const [brandKey, elizaKey] of aliases) {
+        const value = env[elizaKey];
+        if (typeof value === "string") {
+            env[brandKey] = value;
+            mirroredBrandKeys.add(brandKey);
+        }
+        else if (mirroredBrandKeys.has(brandKey)) {
+            delete env[brandKey];
+            mirroredBrandKeys.delete(brandKey);
+        }
+    }
+}
+function resolveAssets(catalog) {
+    return catalog.assets.map((asset) => ({
+        ...asset,
+        compressedVrmPath: `vrms/${asset.slug}.vrm.gz`,
+        rawVrmPath: `vrms/${asset.slug}.vrm`,
+        previewPath: `vrms/previews/${asset.slug}.png`,
+        backgroundPath: `vrms/backgrounds/${asset.slug}.png`,
+        sourceVrmFilename: `${asset.sourceName}.vrm`,
+    }));
+}
+export function resolveCharacterCatalog(catalog) {
+    const assets = resolveAssets(catalog);
+    const assetById = new Map(assets.map((asset) => [asset.id, asset]));
+    const defaultAsset = assets[0] ?? null;
+    const injectedCharacters = catalog.injectedCharacters.map((character) => {
+        const avatarAsset = assetById.get(character.avatarAssetId) ?? defaultAsset;
+        if (!avatarAsset) {
+            throw new Error(`Missing avatar asset ${character.avatarAssetId} for ${character.name}.`);
+        }
+        return { ...character, avatarAsset };
+    });
+    const byCatchphrase = new Map(injectedCharacters.map((character) => [character.catchphrase, character]));
+    return {
+        assets,
+        assetCount: assets.length,
+        defaultAsset,
+        injectedCharacters,
+        injectedCharacterCount: injectedCharacters.length,
+        getAsset: (id) => assetById.get(id) ?? defaultAsset,
+        getInjectedCharacter: (catchphrase) => byCatchphrase.get(catchphrase) ?? null,
+    };
+}
+//# sourceMappingURL=boot-config-store.js.map

package/dist/config/boot-config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-config-store.js","sourceRoot":"","sources":["../../src/config/boot-config-store.ts"],"names":[],"mappings":"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"}

package/dist/config/boot-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Store-only entry — safe for Bun/Node API paths without loading `react`.
+ * For `useBootConfig` / `AppBootContext`, import `./boot-config-react`.
+ */
+export * from "./boot-config-store.js";
+//# sourceMappingURL=boot-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boot-config.d.ts","sourceRoot":"","sources":["../../src/config/boot-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/config/boot-config.js

@@ -0,0 +1,6 @@
+/**
+ * Store-only entry — safe for Bun/Node API paths without loading `react`.
+ * For `useBootConfig` / `AppBootContext`, import `./boot-config-react`.
+ */
+export * from "./boot-config-store.js";
+//# sourceMappingURL=boot-config.js.map

package/dist/config/boot-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-config.js","sourceRoot":"","sources":["../../src/config/boot-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}

package/dist/config/branding-react.d.ts

@@ -0,0 +1,4 @@
+import type { BrandingConfig } from "./branding.ts";
+export declare const BrandingContext: import("react").Context<BrandingConfig>;
+export declare function useBranding(): BrandingConfig;
+//# sourceMappingURL=branding-react.d.ts.map

package/dist/config/branding-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding-react.d.ts","sourceRoot":"","sources":["../../src/config/branding-react.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,eAAO,MAAM,eAAe,yCAAkD,CAAC;AAE/E,wBAAgB,WAAW,IAAI,cAAc,CAE5C"}

package/dist/config/branding-react.js

@@ -0,0 +1,12 @@
+/**
+ * React-bound branding context. Split from `branding.ts` so that node-side
+ * consumers (bench server, agent boot) can import the type-only and helper
+ * exports from `@elizaos/shared` without pulling React into the runtime.
+ */
+import { createContext, useContext } from "react";
+import { DEFAULT_BRANDING } from "./branding.js";
+export const BrandingContext = createContext(DEFAULT_BRANDING);
+export function useBranding() {
+    return useContext(BrandingContext);
+}
+//# sourceMappingURL=branding-react.js.map

package/dist/config/branding-react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding-react.js","sourceRoot":"","sources":["../../src/config/branding-react.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAiB,gBAAgB,CAAC,CAAC;AAE/E,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,eAAe,CAAC,CAAC;AACrC,CAAC"}

package/dist/config/branding.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Custom provider that apps can inject into the onboarding flow.
+ * Uses `string` for id/family so apps aren't restricted to the built-in union.
+ */
+export interface CustomProviderOption {
+    id: string;
+    name: string;
+    envKey: string | null;
+    pluginName: string;
+    keyPrefix: string | null;
+    description: string;
+    family: string;
+    authMode: "api-key" | "cloud" | "credentials" | "local" | "subscription";
+    group: "cloud" | "local" | "subscription";
+    order: number;
+    recommended?: boolean;
+    /** Dark-mode logo path (e.g. "/logos/my-provider.png") */
+    logoDark?: string;
+    /** Light-mode logo path */
+    logoLight?: string;
+}
+export interface BrandingConfig {
+    /** Product name shown in UI ("Eliza" | "the app") */
+    appName: string;
+    /** GitHub org ("elizaos" | "elizaos") */
+    orgName: string;
+    /** GitHub repo name ("eliza" | "eliza") */
+    repoName: string;
+    /** Documentation site URL */
+    docsUrl: string;
+    /** App origin URL */
+    appUrl: string;
+    /** GitHub bug report URL */
+    bugReportUrl: string;
+    /** Twitter hashtag ("#ElizaAgent" | "#AppAgent") */
+    hashtag: string;
+    /** Agent file extension (".eliza-agent" | ".eliza-agent") */
+    fileExtension: string;
+    /** npm package scope ("elizaos" | "elizaos") */
+    packageScope: string;
+    /** Custom providers injected by the app into the onboarding flow */
+    customProviders?: CustomProviderOption[];
+    /** When true, the app requires Eliza Cloud — local backend mode is disabled. */
+    cloudOnly?: boolean;
+}
+/** Default for i18n copy that uses `{{appName}}` (e.g. "Where should {{appName}} run?"). */
+export declare const DEFAULT_APP_DISPLAY_NAME = "Eliza";
+export declare const DEFAULT_BRANDING: BrandingConfig;
+/** Pass to `t(key, appNameInterpolationVars(branding))` when the string contains `{{appName}}`. */
+export declare function appNameInterpolationVars(branding: BrandingConfig): {
+    appName: string;
+};
+//# sourceMappingURL=branding.d.ts.map

package/dist/config/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/config/branding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,OAAO,GAAG,cAAc,CAAC;IACzE,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,cAAc,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD,eAAO,MAAM,gBAAgB,EAAE,cAW9B,CAAC;AAOF,mGAAmG;AACnG,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB,CAGA"}

package/dist/config/branding.js

@@ -0,0 +1,23 @@
+/** Default for i18n copy that uses `{{appName}}` (e.g. "Where should {{appName}} run?"). */
+export const DEFAULT_APP_DISPLAY_NAME = "Eliza";
+export const DEFAULT_BRANDING = {
+    appName: DEFAULT_APP_DISPLAY_NAME,
+    orgName: "elizaos",
+    repoName: "eliza",
+    docsUrl: "https://docs.elizaos.ai",
+    appUrl: "https://app.elizaos.ai",
+    bugReportUrl: "https://github.com/elizaos/eliza/issues/new?template=bug_report.yml",
+    hashtag: "#ElizaAgent",
+    fileExtension: ".eliza-agent",
+    packageScope: "elizaos",
+};
+// React-bound BrandingContext + useBranding live in
+// `./branding-react.tsx` so `@elizaos/shared` can be imported from
+// node-side benchmark / agent code without dragging React into the
+// runtime closure (the bench server fails to boot otherwise).
+/** Pass to `t(key, appNameInterpolationVars(branding))` when the string contains `{{appName}}`. */
+export function appNameInterpolationVars(branding) {
+    const name = branding.appName?.trim();
+    return { appName: name || DEFAULT_APP_DISPLAY_NAME };
+}
+//# sourceMappingURL=branding.js.map

package/dist/config/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/config/branding.ts"],"names":[],"mappings":"AA+CA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAEhD,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,OAAO,EAAE,wBAAwB;IACjC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,yBAAyB;IAClC,MAAM,EAAE,wBAAwB;IAChC,YAAY,EACV,qEAAqE;IACvE,OAAO,EAAE,aAAa;IACtB,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF,oDAAoD;AACpD,mEAAmE;AACnE,mEAAmE;AACnE,8DAA8D;AAE9D,mGAAmG;AACnG,MAAM,UAAU,wBAAwB,CAAC,QAAwB;IAG/D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,wBAAwB,EAAE,CAAC;AACvD,CAAC"}

package/dist/config/cloud-only.d.ts

@@ -0,0 +1,6 @@
+export declare function shouldUseCloudOnlyBranding(options: {
+    isDev: boolean;
+    injectedApiBase?: string | null;
+    isNativePlatform?: boolean;
+}): boolean;
+//# sourceMappingURL=cloud-only.d.ts.map

package/dist/config/cloud-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-only.d.ts","sourceRoot":"","sources":["../../src/config/cloud-only.ts"],"names":[],"mappings":"AAAA,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,OAAO,CAcV"}

package/dist/config/cloud-only.js

@@ -0,0 +1,16 @@
+export function shouldUseCloudOnlyBranding(options) {
+    if (options.isDev)
+        return false;
+    // Mobile (iOS/Android) is always cloud-only — no local runtime available.
+    // Users must connect to ElizaCloud or a remote instance.
+    if (options.isNativePlatform)
+        return true;
+    // Desktop shells inject an explicit backend before React boots. When that
+    // happens, the renderer should follow the host backend's capabilities rather
+    // than hard-coding the production web cloud-only preset.
+    const injectedApiBase = options.injectedApiBase?.trim();
+    if (injectedApiBase)
+        return false;
+    return true;
+}
+//# sourceMappingURL=cloud-only.js.map

package/dist/config/cloud-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-only.js","sourceRoot":"","sources":["../../src/config/cloud-only.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,0BAA0B,CAAC,OAI1C;IACC,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEhC,0EAA0E;IAC1E,yDAAyD;IACzD,IAAI,OAAO,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAE1C,0EAA0E;IAC1E,6EAA6E;IAC7E,yDAAyD;IACzD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,eAAe;QAAE,OAAO,KAAK,CAAC;IAElC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config/config-catalog.d.ts

@@ -0,0 +1,371 @@
+/**
+ * Plugin config catalog & registry — reverse-engineered from vercel-labs/json-render.
+ *
+ * json-render pattern:
+ *   defineCatalog(schema, { components, actions, functions })  →  type-safe catalog
+ *   defineRegistry(catalog, { components, actions })           →  maps catalog → renderers/handlers
+ *   <Renderer spec={} registry={} />                           →  traverses spec, renders
+ *
+ * Our adaptation for plugin config forms:
+ *   defineCatalog({ fields, actions?, functions? })   →  field + action + validation catalog
+ *   defineRegistry(catalog, renderers, actionHandlers?) →  maps types → render/handler functions
+ *   <ConfigRenderer>                                   →  reads JSON Schema + uiHints, renders form
+ *
+ * New in Phase 2 (json-render feature parity):
+ *   - Actions: catalog actions with Zod params + registry handlers
+ *   - Rich visibility: LogicExpression (and/or/not/eq/neq/gt/gte/lt/lte)
+ *   - Validation checks: declarative checks (required/email/minLength/pattern/...)
+ *   - Data binding: DynamicValue with path resolution (getByPath/setByPath)
+ *   - Prompt generation: catalog.prompt() for AI system prompts
+ *
+ * @module config-catalog
+ */
+import type { ReactNode } from "react";
+import z from "zod";
+import type { ConfigUiHint, DynamicValue, LogicExpression, ValidationCheck, ValidationConfig, VisibilityCondition } from "../types/index.js";
+export interface JsonSchemaProperty {
+    type?: string | string[];
+    enum?: unknown[];
+    const?: unknown;
+    default?: unknown;
+    description?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    properties?: Record<string, JsonSchemaProperty>;
+    items?: JsonSchemaProperty;
+    required?: string[];
+    oneOf?: JsonSchemaProperty[];
+    anyOf?: JsonSchemaProperty[];
+    additionalProperties?: boolean | JsonSchemaProperty;
+}
+export interface JsonSchemaObject extends JsonSchemaProperty {
+    type: "object";
+    properties: Record<string, JsonSchemaProperty>;
+}
+/**
+ * Get a value from a nested object by slash-delimited path (JSON Pointer).
+ *
+ * @example
+ * getByPath({ a: { b: 42 } }, "a/b") // → 42
+ * getByPath({ items: [1, 2] }, "items/0") // → 1
+ */
+export declare function getByPath(obj: unknown, path: string): unknown;
+/**
+ * Set a value in a nested object by slash-delimited path.
+ */
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Resolve a DynamicValue — if it's a {path} reference, look up in state.
+ */
+export declare function resolveDynamic<T>(value: DynamicValue<T>, state: Record<string, unknown>): T | undefined;
+/**
+ * Search for a field value by name — ported from json-render's dashboard example.
+ *
+ * Resolution order:
+ * 1. Direct params lookup
+ * 2. Params with path format (JSON Pointer)
+ * 3. State walk through common form prefixes (form, newItem, create, edit, root)
+ */
+export declare function findFormValue(fieldName: string, params?: Record<string, unknown>, state?: Record<string, unknown>): unknown;
+/**
+ * Interpolate `{{path}}` references in a template string using context values.
+ *
+ * Useful for action onSuccess/onError messages that reference state values.
+ *
+ * @example
+ * interpolateString("Created {{/form/name}} successfully", { form: { name: "Foo" } })
+ * // → "Created Foo successfully"
+ */
+export declare function interpolateString(template: string, context: Record<string, unknown>): string;
+/**
+ * Evaluate a LogicExpression against a state model.
+ */
+export declare function evaluateLogicExpression(expr: LogicExpression, state: Record<string, unknown>): boolean;
+/**
+ * Evaluate a full VisibilityCondition.
+ */
+export declare function evaluateVisibility(condition: VisibilityCondition | undefined, state: Record<string, unknown>): boolean;
+export declare const visibility: {
+    always: true;
+    never: false;
+    when: (path: string) => VisibilityCondition;
+    and: (...conditions: LogicExpression[]) => LogicExpression;
+    or: (...conditions: LogicExpression[]) => LogicExpression;
+    not: (condition: LogicExpression) => LogicExpression;
+    eq: (left: DynamicValue, right: DynamicValue) => LogicExpression;
+    neq: (left: DynamicValue, right: DynamicValue) => LogicExpression;
+    gt: (left: DynamicValue<number>, right: DynamicValue<number>) => LogicExpression;
+    gte: (left: DynamicValue<number>, right: DynamicValue<number>) => LogicExpression;
+    lt: (left: DynamicValue<number>, right: DynamicValue<number>) => LogicExpression;
+    lte: (left: DynamicValue<number>, right: DynamicValue<number>) => LogicExpression;
+};
+export type ValidationFunction = (value: unknown, args?: Record<string, unknown>) => boolean;
+export declare const builtInValidators: Record<string, ValidationFunction>;
+/**
+ * Run validation checks for a field value.
+ */
+export declare function runValidation(config: ValidationConfig, value: unknown, state: Record<string, unknown>, customFunctions?: Record<string, ValidationFunction>): {
+    valid: boolean;
+    errors: string[];
+};
+export declare const check: {
+    required: (message?: string) => ValidationCheck;
+    email: (message?: string) => ValidationCheck;
+    minLength: (min: number, message?: string) => ValidationCheck;
+    maxLength: (max: number, message?: string) => ValidationCheck;
+    pattern: (pattern: string, message?: string) => ValidationCheck;
+    min: (min: number, message?: string) => ValidationCheck;
+    max: (max: number, message?: string) => ValidationCheck;
+    url: (message?: string) => ValidationCheck;
+    matches: (otherPath: string, message?: string) => ValidationCheck;
+};
+export interface ActionDefinition<TParams = Record<string, unknown>> {
+    /** Zod schema for params validation. */
+    params?: z.ZodType<TParams>;
+    /** Description for AI and documentation. */
+    description?: string;
+}
+export type ActionHandler<TParams = Record<string, unknown>, TResult = unknown> = (params: TParams, state: Record<string, unknown>) => Promise<TResult> | TResult;
+export interface FieldDefinition<TValidator extends z.ZodType = z.ZodType> {
+    /** Zod schema for validating field values. */
+    validator: TValidator;
+    /** Human-readable description (used for documentation / AI prompts). */
+    description: string;
+}
+export interface FieldCatalog<TFields extends Record<string, FieldDefinition> = Record<string, FieldDefinition>, TActions extends Record<string, ActionDefinition> = Record<string, ActionDefinition>> {
+    readonly fields: TFields;
+    readonly fieldNames: string[];
+    readonly actions: TActions;
+    readonly actionNames: string[];
+    readonly functions: Record<string, ValidationFunction>;
+    /** Check if a field type is registered. */
+    hasField(type: string): boolean;
+    /** Check if an action is registered. */
+    hasAction(name: string): boolean;
+    /** Validate a value against a field type's Zod schema. */
+    validate(type: string, value: unknown): z.ZodSafeParseResult<unknown>;
+    /** Resolve a JSON Schema property + optional UI hint to a field type name. */
+    resolveType(property: JsonSchemaProperty, hint?: ConfigUiHint): string;
+    /** Generate an AI system prompt describing the catalog's capabilities. */
+    prompt(): string;
+}
+/**
+ * Catalog configuration.
+ */
+export interface CatalogConfig<TFields extends Record<string, FieldDefinition> = Record<string, FieldDefinition>, TActions extends Record<string, ActionDefinition> = Record<string, ActionDefinition>> {
+    /** Field type definitions. */
+    fields: TFields;
+    /** Action definitions. */
+    actions?: TActions;
+    /** Custom validation functions. */
+    functions?: Record<string, ValidationFunction>;
+}
+/**
+ * Create a type-safe field catalog.
+ *
+ * Equivalent to json-render's `defineCatalog(schema, config)`.
+ * Supports fields, actions, custom validation functions, and prompt generation.
+ */
+export declare function defineCatalog<TFields extends Record<string, FieldDefinition>, TActions extends Record<string, ActionDefinition> = Record<string, ActionDefinition>>(fieldsOrConfig: TFields | CatalogConfig<TFields, TActions>): FieldCatalog<TFields, TActions>;
+/**
+ * Props passed to every field renderer function.
+ *
+ * Plugin authors implementing custom renderers receive this interface
+ * as the single argument to their render function.
+ *
+ * @example
+ * ```tsx
+ * const MyCustomField: FieldRenderer = (props: FieldRenderProps) => (
+ *   <input
+ *     value={String(props.value ?? "")}
+ *     onChange={(e) => props.onChange(e.target.value)}
+ *     placeholder={props.hint.placeholder}
+ *     disabled={props.readonly}
+ *   />
+ * );
+ * ```
+ */
+export interface FieldRenderProps {
+    /** Config key identifier (e.g., "OPENAI_API_KEY"). */
+    key: string;
+    /** Current field value, may be any JSON-compatible type. */
+    value: unknown;
+    /** JSON Schema property definition for this field. */
+    schema: JsonSchemaProperty;
+    /** UI rendering hints from the plugin manifest. */
+    hint: ConfigUiHint;
+    /** Resolved field type name from the catalog (e.g., "text", "select"). */
+    fieldType: string;
+    /** Callback to update the field value. */
+    onChange: (value: unknown) => void;
+    /** Whether the field currently has a configured value. */
+    isSet: boolean;
+    /** Whether the field is required by the schema. */
+    required: boolean;
+    /** Validation error messages for this field. */
+    errors?: string[];
+    /** Whether the field should be non-editable. */
+    readonly?: boolean;
+    /** For sensitive fields — async callback to fetch the real value from the server. */
+    onReveal?: () => Promise<string | null>;
+    /** Dispatch a named action with optional parameters. */
+    onAction?: (action: string, params?: Record<string, unknown>) => Promise<unknown>;
+}
+/** A render function that returns a React node for a given field type. */
+export type FieldRenderer = (props: FieldRenderProps) => ReactNode;
+export interface FieldRegistry<TFields extends Record<string, FieldDefinition> = Record<string, FieldDefinition>, TActions extends Record<string, ActionDefinition> = Record<string, ActionDefinition>> {
+    readonly catalog: FieldCatalog<TFields, TActions>;
+    readonly renderers: Record<string, FieldRenderer>;
+    readonly actionHandlers: Record<string, ActionHandler>;
+    /** Look up the renderer for a field type. Returns undefined if not registered. */
+    resolve(type: string): FieldRenderer | undefined;
+    /** Like resolve(), but falls back to the "text" renderer. */
+    resolveOrFallback(type: string): FieldRenderer;
+    /** Look up the handler for an action. */
+    resolveAction(name: string): ActionHandler | undefined;
+}
+/**
+ * Create a field registry that maps catalog field types to render functions.
+ *
+ * Equivalent to json-render's `defineRegistry(catalog, { components, actions })`.
+ */
+export declare function defineRegistry<TFields extends Record<string, FieldDefinition>, TActions extends Record<string, ActionDefinition> = Record<string, ActionDefinition>>(catalog: FieldCatalog<TFields, TActions>, renderers: Partial<Record<keyof TFields & string, FieldRenderer>>, actionHandlers?: Partial<Record<keyof TActions & string, ActionHandler>>): FieldRegistry<TFields, TActions>;
+/**
+ * The standard field catalog with 23 basic field types + built-in actions.
+ */
+export declare const defaultCatalog: FieldCatalog<{
+    text: {
+        validator: z.ZodString;
+        description: string;
+    };
+    password: {
+        validator: z.ZodString;
+        description: string;
+    };
+    number: {
+        validator: z.ZodCoercedNumber<unknown>;
+        description: string;
+    };
+    boolean: {
+        validator: z.ZodCoercedBoolean<unknown>;
+        description: string;
+    };
+    url: {
+        validator: z.ZodString;
+        description: string;
+    };
+    select: {
+        validator: z.ZodString;
+        description: string;
+    };
+    textarea: {
+        validator: z.ZodString;
+        description: string;
+    };
+    email: {
+        validator: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+        description: string;
+    };
+    color: {
+        validator: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+        description: string;
+    };
+    radio: {
+        validator: z.ZodString;
+        description: string;
+    };
+    multiselect: {
+        validator: z.ZodUnion<[z.ZodArray<z.ZodString>, z.ZodString]>;
+        description: string;
+    };
+    date: {
+        validator: z.ZodString;
+        description: string;
+    };
+    json: {
+        validator: z.ZodString;
+        description: string;
+    };
+    code: {
+        validator: z.ZodString;
+        description: string;
+    };
+    array: {
+        validator: z.ZodArray<z.ZodUnknown>;
+        description: string;
+    };
+    keyvalue: {
+        validator: z.ZodRecord<z.ZodString, z.ZodString>;
+        description: string;
+    };
+    datetime: {
+        validator: z.ZodString;
+        description: string;
+    };
+    file: {
+        validator: z.ZodString;
+        description: string;
+    };
+    custom: {
+        validator: z.ZodUnknown;
+        description: string;
+    };
+    markdown: {
+        validator: z.ZodString;
+        description: string;
+    };
+    "checkbox-group": {
+        validator: z.ZodUnion<[z.ZodArray<z.ZodString>, z.ZodString]>;
+        description: string;
+    };
+    group: {
+        validator: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString]>;
+        description: string;
+    };
+    table: {
+        validator: z.ZodUnion<[z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>, z.ZodString]>;
+        description: string;
+    };
+}, {
+    save: {
+        params: z.ZodObject<{}, z.core.$strip>;
+        description: string;
+    };
+    reset: {
+        params: z.ZodObject<{}, z.core.$strip>;
+        description: string;
+    };
+    testConnection: {
+        params: z.ZodObject<{
+            key: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        description: string;
+    };
+}>;
+export interface ResolvedField {
+    key: string;
+    schema: JsonSchemaProperty;
+    hint: ConfigUiHint;
+    fieldType: string;
+    required: boolean;
+    group: string;
+    order: number;
+    advanced: boolean;
+    hidden: boolean;
+    width: "full" | "half" | "third";
+    visible?: VisibilityCondition;
+    validation?: ValidationConfig;
+    readonly: boolean;
+}
+/**
+ * Walk a JSON Schema object's properties and resolve each to a field descriptor.
+ *
+ * This is the equivalent of json-render's spec traversal — it turns a declarative
+ * schema into an ordered list of renderable field descriptors.
+ */
+export declare function resolveFields(schema: JsonSchemaObject | JsonSchemaProperty, hints: Record<string, ConfigUiHint>, catalog: FieldCatalog): ResolvedField[];
+//# sourceMappingURL=config-catalog.d.ts.map