@elizaos/agent 2.0.0-beta.2 → 2.0.3-beta.3

package/config/paths.js

@@ -0,0 +1,61 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getElizaNamespace, readEnv, resolveOAuthDir, resolveStateDir, resolveUserPath, } from "@elizaos/core";
+const CONFIG_PATH_CANONICAL_KEY = "ELIZA_CONFIG_PATH";
+function readEnvOverride(env) {
+    return readEnv(CONFIG_PATH_CANONICAL_KEY, { env });
+}
+export { getElizaNamespace, resolveOAuthDir, resolveStateDir, resolveUserPath };
+/**
+ * Ordered list of on-disk config filenames to look for under the state dir,
+ * given the active namespace. The first existing file wins; if none exist,
+ * callers fall back to the first entry (the file to create/write).
+ */
+function configFilenameCandidates(namespace) {
+    const candidates = [`${namespace}.json`];
+    if (namespace !== "eliza")
+        candidates.push("eliza.json");
+    return candidates;
+}
+export function resolveConfigPath(env = process.env, stateDirPath = resolveStateDir(env)) {
+    const override = readEnvOverride(env);
+    if (override) {
+        return resolveUserPath(override);
+    }
+    const namespace = getElizaNamespace(env);
+    const candidates = configFilenameCandidates(namespace).map((name) => path.join(stateDirPath, name));
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    // Nothing on disk yet → the primary (canonical) path is the one to create.
+    return candidates[0] ?? path.join(stateDirPath, `${namespace}.json`);
+}
+export function resolveDefaultConfigCandidates(env = process.env) {
+    const explicit = readEnvOverride(env);
+    if (explicit) {
+        return [resolveUserPath(explicit)];
+    }
+    const namespace = getElizaNamespace(env);
+    const stateDirPath = resolveStateDir(env);
+    return configFilenameCandidates(namespace).map((name) => path.join(stateDirPath, name));
+}
+const OAUTH_FILENAME = "oauth.json";
+/**
+ * Directory for per-provider model cache files.
+ * Each provider gets its own file: `<state-dir>/models/<providerId>.json`
+ */
+export function resolveModelsCacheDir(env = process.env, stateDirPath = resolveStateDir(env)) {
+    return path.join(stateDirPath, "models");
+}
+export function resolveOAuthPath(env = process.env, stateDirPath = resolveStateDir(env)) {
+    return path.join(resolveOAuthDir(env, stateDirPath), OAUTH_FILENAME);
+}
+const STEWARD_CREDENTIALS_FILENAME = "steward-credentials.json";
+/**
+ * Canonical path to the persisted Steward credentials file.
+ * Honors the canonical state-dir resolver.
+ */
+export function resolveStewardCredentialsPath(env = process.env, stateDirPath = resolveStateDir(env)) {
+    return path.join(stateDirPath, STEWARD_CREDENTIALS_FILENAME);
+}

package/config/plugin-auto-enable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-auto-enable.d.ts","sourceRoot":"","sources":["../../src/config/plugin-auto-enable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/config/plugin-widgets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Server-side plugin widget declarations.
+ *
+ * Two sources merge here:
+ *   1. The plugin's own `widgets` field on its `Plugin` instance (canonical).
+ *   2. The static `PLUGIN_WIDGET_MAP` below, kept as an empty compatibility
+ *      fallback for older callers.
+ */
+import type { Plugin, PluginWidgetDeclaration } from "@elizaos/core";
+export type PluginWidgetDeclarationServer = PluginWidgetDeclaration;
+/**
+ * Static map of plugin widget declarations.
+ * Key: plugin ID. Value: array of widget declarations.
+ */
+export declare const PLUGIN_WIDGET_MAP: Record<string, PluginWidgetDeclaration[]>;
+/**
+ * Resolve widget declarations for a plugin by id, merging:
+ *   - the plugin instance's own `widgets` field (when a runtime plugin list is
+ *     supplied and a match is found), and
+ *   - the static `PLUGIN_WIDGET_MAP` fallback.
+ *
+ * Declarations from the plugin instance take precedence; static-map entries
+ * with the same `(pluginId, id)` key are dropped.
+ */
+export declare function getPluginWidgets(pluginId: string, runtimePlugins?: ReadonlyArray<Plugin>): PluginWidgetDeclaration[];
+//# sourceMappingURL=plugin-widgets.d.ts.map

package/config/plugin-widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-widgets.d.ts","sourceRoot":"","sources":["../../src/config/plugin-widgets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAErE,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAM,CAAC;AAc/E;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GACrC,uBAAuB,EAAE,CA2B3B"}

package/config/plugin-widgets.js

@@ -0,0 +1,60 @@
+/**
+ * Server-side plugin widget declarations.
+ *
+ * Two sources merge here:
+ *   1. The plugin's own `widgets` field on its `Plugin` instance (canonical).
+ *   2. The static `PLUGIN_WIDGET_MAP` below, kept as an empty compatibility
+ *      fallback for older callers.
+ */
+/**
+ * Static map of plugin widget declarations.
+ * Key: plugin ID. Value: array of widget declarations.
+ */
+export const PLUGIN_WIDGET_MAP = {};
+/** Strip common scope/prefix to compare a Plugin.name against a PluginEntry.id. */
+function normalizePluginIdentity(value) {
+    let v = value.trim();
+    if (v.startsWith("@")) {
+        const slash = v.indexOf("/");
+        if (slash > 0)
+            v = v.slice(slash + 1);
+    }
+    if (v.startsWith("plugin-"))
+        v = v.slice("plugin-".length);
+    if (v.startsWith("app-"))
+        v = v.slice("app-".length);
+    return v;
+}
+/**
+ * Resolve widget declarations for a plugin by id, merging:
+ *   - the plugin instance's own `widgets` field (when a runtime plugin list is
+ *     supplied and a match is found), and
+ *   - the static `PLUGIN_WIDGET_MAP` fallback.
+ *
+ * Declarations from the plugin instance take precedence; static-map entries
+ * with the same `(pluginId, id)` key are dropped.
+ */
+export function getPluginWidgets(pluginId, runtimePlugins) {
+    const fromInstance = [];
+    if (runtimePlugins && runtimePlugins.length > 0) {
+        const normalizedId = normalizePluginIdentity(pluginId);
+        const match = runtimePlugins.find((p) => normalizePluginIdentity(p.name) === normalizedId);
+        if (match?.widgets && match.widgets.length > 0) {
+            fromInstance.push(...match.widgets);
+        }
+    }
+    const fallback = PLUGIN_WIDGET_MAP[pluginId] ?? [];
+    if (fromInstance.length === 0) {
+        return [...fallback];
+    }
+    const seen = new Set(fromInstance.map((w) => `${w.pluginId}::${w.id}`));
+    const merged = [...fromInstance];
+    for (const decl of fallback) {
+        const key = `${decl.pluginId}::${decl.id}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            merged.push(decl);
+        }
+    }
+    return merged;
+}

package/config/schema.d.ts

@@ -0,0 +1,87 @@
+/** Known connector IDs for config schema generation. Keep in sync with runtime/plugin maps. */
+export declare const CONNECTOR_IDS: readonly ["bluebubbles", "telegram", "telegramAccount", "discord", "discordLocal", "slack", "twitter", "whatsapp", "signal", "imessage", "farcaster", "lens", "msteams", "feishu", "matrix", "nostr", "blooio", "twitch", "mattermost", "googlechat"];
+import { ElizaSchema } from "./zod-schema.js";
+export type ShowIfCondition = {
+    field: string;
+    op: "eq" | "neq" | "in" | "truthy" | "falsy";
+    value?: unknown;
+};
+export type ConfigUiHint = {
+    label?: string;
+    help?: string;
+    group?: string;
+    order?: number;
+    advanced?: boolean;
+    sensitive?: boolean;
+    placeholder?: string;
+    itemTemplate?: unknown;
+    /** Explicit field type override (must match a catalog field name). */
+    type?: string;
+    /** Icon name for the field label. */
+    icon?: string;
+    /** Whether the field is read-only. */
+    readonly?: boolean;
+    /** Hide this field from the UI entirely. */
+    hidden?: boolean;
+    /** Layout width hint. */
+    width?: "full" | "half" | "third";
+    /** Regex pattern for string validation. */
+    pattern?: string;
+    /** Error message when pattern doesn't match. */
+    patternError?: string;
+    /** Legacy conditional visibility. */
+    showIf?: ShowIfCondition;
+    /** Enhanced options for select/radio/multiselect fields. */
+    options?: Array<{
+        value: string;
+        label: string;
+        description?: string;
+        icon?: string;
+        disabled?: boolean;
+    }>;
+    /** Minimum value (for number fields). */
+    min?: number;
+    /** Maximum value (for number fields). */
+    max?: number;
+    /** Step increment (for number fields). */
+    step?: number;
+    /** Display unit label (e.g., "ms", "tokens", "%"). */
+    unit?: string;
+    /** Schema for array item fields. */
+    itemSchema?: ConfigUiHint;
+    /** Minimum items (for array fields). */
+    minItems?: number;
+    /** Maximum items (for array fields). */
+    maxItems?: number;
+    /** Plugin-provided custom React component name. */
+    component?: string;
+};
+export type ConfigUiHints = Record<string, ConfigUiHint>;
+export type ConfigSchema = ReturnType<typeof ElizaSchema.toJSONSchema>;
+type JsonSchemaNode = Record<string, unknown>;
+export type ConfigSchemaResponse = {
+    schema: ConfigSchema;
+    uiHints: ConfigUiHints;
+    version: string;
+    generatedAt: string;
+};
+export type PluginUiMetadata = {
+    id: string;
+    name?: string;
+    description?: string;
+    configUiHints?: Record<string, Pick<ConfigUiHint, "label" | "help" | "advanced" | "sensitive" | "placeholder" | "type" | "icon" | "readonly" | "hidden" | "width" | "pattern" | "patternError" | "showIf" | "options" | "min" | "max" | "step" | "unit">>;
+    configSchema?: JsonSchemaNode;
+};
+export type ConnectorUiMetadata = {
+    id: string;
+    label?: string;
+    description?: string;
+    configSchema?: JsonSchemaNode;
+    configUiHints?: Record<string, ConfigUiHint>;
+};
+export declare function buildConfigSchema(params?: {
+    plugins?: PluginUiMetadata[];
+    connectors?: ConnectorUiMetadata[];
+}): ConfigSchemaResponse;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/config/schema.d.ts.map

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