@elizaos/app-core 2.0.0-alpha.73 → 2.0.0-alpha.75

package/state/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./AppContext";
+export * from "./parsers";
+export * from "./persistence";
+export * from "./types";
+export * from "./useApp";
+export * from "./vrm";
+//# sourceMappingURL=index.d.ts.map

package/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}

package/state/internal.d.ts

@@ -0,0 +1,7 @@
+export { deriveOnboardingResumeConnection, deriveOnboardingResumeFields, hasPartialOnboardingConnectionConfig, inferOnboardingResumeStep, } from "./onboarding-resume";
+export { asApiLikeError, computeStreamingDelta, formatSearchBullet, formatStartupErrorDetail, mergeStreamingText, normalizeCustomActionName, normalizeStreamComparisonText, parseAgentStartupDiagnostics, parseAgentStatusEvent, parseConversationMessageEvent, parseCustomActionParams, parseProactiveMessageEvent, parseSlashCommandInput, parseStreamEventEnvelopeEvent, shouldApplyFinalStreamText, } from "./parsers";
+export { applyUiTheme, clearPersistedConnectionMode, clearPersistedOnboardingStep, loadActiveConversationId, loadAvatarIndex, loadChatAvatarVisible, loadChatMode, loadChatVoiceMuted, loadCompanionMessageCutoffTs, loadLastNativeTab, loadPersistedConnectionMode, loadPersistedOnboardingStep, type PersistedConnectionMode, loadUiLanguage, loadUiShellMode, loadUiTheme, normalizeUiShellMode, normalizeUiTheme, saveActiveConversationId, saveAvatarIndex, saveChatAvatarVisible, saveChatMode, saveChatVoiceMuted, saveCompanionMessageCutoffTs, saveLastNativeTab, saveOnboardingStep, savePersistedConnectionMode, saveUiLanguage, saveUiShellMode, saveUiTheme, type UiTheme, } from "./persistence";
+export { type ActionNotice, AGENT_READY_TIMEOUT_MS, AGENT_STATES, AGENT_TRANSFER_MIN_PASSWORD_LENGTH, type AppActions, type AppContextValue, type AppState, type ChatTurnUsage, type GamePostMessageAuthPayload, LIFECYCLE_MESSAGES, type LifecycleAction, type LoadConversationMessagesResult, ONBOARDING_PERMISSION_LABELS, type OnboardingMode, type OnboardingNextOptions, type OnboardingStep, type ShellView, type SlashCommandInput, type StartupErrorReason, type StartupErrorState, type StartupPhase, type UiShellMode, } from "./types";
+export { AppContext, useApp } from "./useApp";
+export { getCompanionBackgroundUrl, getVrmBackgroundUrl, getVrmPreviewUrl, getVrmTitle, getVrmUrl, isOfficialVrmIndex, normalizeAvatarIndex, VRM_COUNT, } from "./vrm";
+//# sourceMappingURL=internal.d.ts.map

package/state/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/state/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,oCAAoC,EACpC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,4BAA4B,EAC5B,4BAA4B,EAC5B,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,cAAc,EACd,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,OAAO,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,YAAY,EACjB,sBAAsB,EACtB,YAAY,EACZ,kCAAkC,EAClC,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,8BAA8B,EACnC,4BAA4B,EAC5B,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,MAAM,OAAO,CAAC"}

package/state/internal.js

@@ -0,0 +1,6 @@
+export { deriveOnboardingResumeConnection, deriveOnboardingResumeFields, hasPartialOnboardingConnectionConfig, inferOnboardingResumeStep, } from "./onboarding-resume";
+export { asApiLikeError, computeStreamingDelta, formatSearchBullet, formatStartupErrorDetail, mergeStreamingText, normalizeCustomActionName, normalizeStreamComparisonText, parseAgentStartupDiagnostics, parseAgentStatusEvent, parseConversationMessageEvent, parseCustomActionParams, parseProactiveMessageEvent, parseSlashCommandInput, parseStreamEventEnvelopeEvent, shouldApplyFinalStreamText, } from "./parsers";
+export { applyUiTheme, clearPersistedConnectionMode, clearPersistedOnboardingStep, loadActiveConversationId, loadAvatarIndex, loadChatAvatarVisible, loadChatMode, loadChatVoiceMuted, loadCompanionMessageCutoffTs, loadLastNativeTab, loadPersistedConnectionMode, loadPersistedOnboardingStep, loadUiLanguage, loadUiShellMode, loadUiTheme, normalizeUiShellMode, normalizeUiTheme, saveActiveConversationId, saveAvatarIndex, saveChatAvatarVisible, saveChatMode, saveChatVoiceMuted, saveCompanionMessageCutoffTs, saveLastNativeTab, saveOnboardingStep, savePersistedConnectionMode, saveUiLanguage, saveUiShellMode, saveUiTheme, } from "./persistence";
+export { AGENT_READY_TIMEOUT_MS, AGENT_STATES, AGENT_TRANSFER_MIN_PASSWORD_LENGTH, LIFECYCLE_MESSAGES, ONBOARDING_PERMISSION_LABELS, } from "./types";
+export { AppContext, useApp } from "./useApp";
+export { getCompanionBackgroundUrl, getVrmBackgroundUrl, getVrmPreviewUrl, getVrmTitle, getVrmUrl, isOfficialVrmIndex, normalizeAvatarIndex, VRM_COUNT, } from "./vrm";

package/state/onboarding-resume.d.ts

@@ -0,0 +1,11 @@
+import { type OnboardingConnection } from "@elizaos/autonomous/contracts/onboarding";
+import type { BuildOnboardingConnectionArgs } from "../onboarding-config";
+import type { OnboardingStep } from "./types";
+export declare function hasPartialOnboardingConnectionConfig(config: Record<string, unknown> | null | undefined): boolean;
+export declare function inferOnboardingResumeStep(args: {
+    config?: Record<string, unknown> | null;
+    persistedStep?: OnboardingStep | null;
+}): OnboardingStep;
+export declare function deriveOnboardingResumeConnection(config: Record<string, unknown> | null | undefined): OnboardingConnection | null;
+export declare function deriveOnboardingResumeFields(connection: OnboardingConnection | null | undefined): Partial<BuildOnboardingConnectionArgs>;
+//# sourceMappingURL=onboarding-resume.d.ts.map

package/state/onboarding-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-resume.d.ts","sourceRoot":"","sources":["../../src/state/onboarding-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqG9C,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAcT;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC,GAAG,cAAc,CAQjB;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,oBAAoB,GAAG,IAAI,CA4D7B;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAClD,OAAO,CAAC,6BAA6B,CAAC,CAyDxC"}

package/state/onboarding-resume.js

@@ -0,0 +1,189 @@
+import { normalizeOnboardingProviderId, ONBOARDING_PROVIDER_CATALOG, } from "@elizaos/autonomous/contracts/onboarding";
+const REDACTED_SECRET = "[REDACTED]";
+function asRecord(value) {
+    return value && typeof value === "object"
+        ? value
+        : null;
+}
+function hasConfigValue(value) {
+    return typeof value === "string" ? value.trim().length > 0 : value === true;
+}
+function readString(source, key) {
+    const value = source?.[key];
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function readNonRedactedString(source, key) {
+    const value = readString(source, key);
+    return value === REDACTED_SECRET ? null : value;
+}
+function readEnvString(config, key) {
+    const env = asRecord(config?.env);
+    const vars = asRecord(env?.vars);
+    return readString(vars, key) ?? readString(env, key);
+}
+function readEnvSecret(config, key) {
+    const value = readEnvString(config, key);
+    return value === REDACTED_SECRET ? null : value;
+}
+function readPrimaryModel(config) {
+    const agents = asRecord(config?.agents);
+    const defaults = asRecord(agents?.defaults);
+    const model = asRecord(defaults?.model);
+    return readString(model, "primary");
+}
+function isPiAiEnabled(config) {
+    const value = readEnvString(config, "ELIZA_USE_PI_AI");
+    if (!value) {
+        return false;
+    }
+    return value !== "0" && value.toLowerCase() !== "false";
+}
+function resolveConfiguredLocalProvider(config) {
+    const agents = asRecord(config?.agents);
+    const defaults = asRecord(agents?.defaults);
+    const storedSubscriptionProvider = normalizeOnboardingProviderId(readString(defaults, "subscriptionProvider"));
+    if (storedSubscriptionProvider &&
+        storedSubscriptionProvider !== "elizacloud") {
+        return storedSubscriptionProvider;
+    }
+    if (isPiAiEnabled(config)) {
+        return "pi-ai";
+    }
+    for (const provider of ONBOARDING_PROVIDER_CATALOG) {
+        if (provider.id === "elizacloud" || !provider.envKey) {
+            continue;
+        }
+        if (readEnvString(config, provider.envKey)) {
+            return provider.id;
+        }
+    }
+    return null;
+}
+export function hasPartialOnboardingConnectionConfig(config) {
+    const cloud = asRecord(config?.cloud);
+    if (!cloud) {
+        return false;
+    }
+    return [
+        cloud.enabled,
+        cloud.apiKey,
+        cloud.provider,
+        cloud.inferenceMode,
+        cloud.remoteApiBase,
+        cloud.remoteAccessToken,
+    ].some(hasConfigValue);
+}
+export function inferOnboardingResumeStep(args) {
+    if (args.persistedStep) {
+        return args.persistedStep;
+    }
+    return hasPartialOnboardingConnectionConfig(args.config)
+        ? "senses"
+        : "identity";
+}
+export function deriveOnboardingResumeConnection(config) {
+    const cloud = asRecord(config?.cloud);
+    const models = asRecord(config?.models);
+    const remoteApiBase = readString(cloud, "remoteApiBase");
+    const remoteAccessToken = readNonRedactedString(cloud, "remoteAccessToken");
+    const localProvider = resolveConfiguredLocalProvider(config);
+    const primaryModel = readPrimaryModel(config) ?? undefined;
+    const localProviderOption = ONBOARDING_PROVIDER_CATALOG.find((provider) => provider.id === localProvider);
+    const localApiKey = localProviderOption?.envKey != null
+        ? (readEnvSecret(config, localProviderOption.envKey) ?? undefined)
+        : undefined;
+    if (remoteApiBase || remoteAccessToken) {
+        return {
+            kind: "remote-provider",
+            remoteApiBase: remoteApiBase ?? "",
+            remoteAccessToken: remoteAccessToken ?? undefined,
+            provider: localProvider ?? undefined,
+            apiKey: localApiKey,
+            primaryModel,
+        };
+    }
+    const cloudProvider = normalizeOnboardingProviderId(readString(cloud, "provider"));
+    const cloudApiKey = readNonRedactedString(cloud, "apiKey") ?? undefined;
+    const smallModel = readString(models, "small") ?? undefined;
+    const largeModel = readString(models, "large") ?? undefined;
+    if (cloud?.enabled === true ||
+        cloudProvider === "elizacloud" ||
+        readString(cloud, "inferenceMode") === "cloud" ||
+        cloudApiKey ||
+        smallModel ||
+        largeModel) {
+        return {
+            kind: "cloud-managed",
+            cloudProvider: "elizacloud",
+            apiKey: cloudApiKey,
+            smallModel,
+            largeModel,
+        };
+    }
+    if (!localProvider) {
+        return null;
+    }
+    return {
+        kind: "local-provider",
+        provider: localProvider,
+        apiKey: localApiKey,
+        primaryModel,
+    };
+}
+export function deriveOnboardingResumeFields(connection) {
+    if (!connection) {
+        return {};
+    }
+    switch (connection.kind) {
+        case "cloud-managed":
+            return {
+                onboardingRunMode: "cloud",
+                onboardingCloudProvider: "elizacloud",
+                onboardingApiKey: connection.apiKey ?? "",
+                onboardingSmallModel: connection.smallModel ?? "",
+                onboardingLargeModel: connection.largeModel ?? "",
+                onboardingRemoteConnected: false,
+                onboardingRemoteApiBase: "",
+                onboardingRemoteToken: "",
+                onboardingProvider: "",
+                onboardingPrimaryModel: "",
+                onboardingOpenRouterModel: "",
+            };
+        case "local-provider":
+            return {
+                onboardingRunMode: "local",
+                onboardingCloudProvider: "",
+                onboardingProvider: connection.provider,
+                onboardingApiKey: connection.apiKey ?? "",
+                onboardingPrimaryModel: connection.provider === "openrouter"
+                    ? ""
+                    : (connection.primaryModel ?? ""),
+                onboardingOpenRouterModel: connection.provider === "openrouter"
+                    ? (connection.primaryModel ?? "")
+                    : "",
+                onboardingRemoteConnected: false,
+                onboardingRemoteApiBase: "",
+                onboardingRemoteToken: "",
+            };
+        case "remote-provider":
+            return {
+                onboardingRunMode: "cloud",
+                onboardingCloudProvider: "remote",
+                onboardingProvider: connection.provider ?? "",
+                onboardingApiKey: connection.apiKey ?? "",
+                onboardingPrimaryModel: connection.provider === "openrouter"
+                    ? ""
+                    : (connection.primaryModel ?? ""),
+                onboardingOpenRouterModel: connection.provider === "openrouter"
+                    ? (connection.primaryModel ?? "")
+                    : "",
+                onboardingRemoteConnected: true,
+                onboardingRemoteApiBase: connection.remoteApiBase,
+                onboardingRemoteToken: connection.remoteAccessToken ?? "",
+            };
+    }
+}

package/state/parsers.d.ts

@@ -0,0 +1,26 @@
+import type { AgentStartupDiagnostics, AgentStatus, ConversationMessage, CustomActionDef, StreamEventEnvelope } from "../api/client";
+import { mergeStreamingText } from "../utils/streaming-text";
+import { type ApiLikeError, type SlashCommandInput } from "./types";
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function parseAgentStatusEvent(data: Record<string, unknown>): AgentStatus | null;
+export declare function parseAgentStartupDiagnostics(value: unknown): AgentStartupDiagnostics | undefined;
+export declare function parseStreamEventEnvelopeEvent(data: Record<string, unknown>): StreamEventEnvelope | null;
+export declare function parseConversationMessageEvent(value: unknown): ConversationMessage | null;
+export declare function parseProactiveMessageEvent(data: Record<string, unknown>): {
+    conversationId: string;
+    message: ConversationMessage;
+} | null;
+export { mergeStreamingText };
+export declare function computeStreamingDelta(existing: string, incoming: string): string;
+export declare function normalizeStreamComparisonText(text: string): string;
+export declare function shouldApplyFinalStreamText(streamed: string, finalText: string): boolean;
+export declare function parseSlashCommandInput(text: string): SlashCommandInput | null;
+export declare function normalizeCustomActionName(value: string): string;
+export declare function parseCustomActionParams(action: CustomActionDef, argsRaw: string): {
+    params: Record<string, string>;
+    missingRequired: string[];
+};
+export declare function formatSearchBullet(label: string, items: string[]): string;
+export declare function asApiLikeError(err: unknown): ApiLikeError | null;
+export declare function formatStartupErrorDetail(err: unknown): string | undefined;
+//# sourceMappingURL=parsers.d.ts.map

package/state/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/state/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,WAAW,GAAG,IAAI,CAuBpB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,uBAAuB,GAAG,SAAS,CAcrC;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,mBAAmB,GAAG,IAAI,CA+B5B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,mBAAmB,GAAG,IAAI,CAwB5B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CAMjE;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAQT;AAoBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAY7E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CA2DA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAGzE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAiBhE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAazE"}

package/state/parsers.js

@@ -0,0 +1,255 @@
+import { computeStreamingDelta as computeStreamingDeltaInternal, mergeStreamingText, } from "../utils/streaming-text";
+import { AGENT_STATES, } from "./types";
+export function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function parseAgentStatusEvent(data) {
+    const state = data.state;
+    const agentName = data.agentName;
+    if (typeof state !== "string" ||
+        !AGENT_STATES.has(state)) {
+        return null;
+    }
+    if (typeof agentName !== "string")
+        return null;
+    const model = typeof data.model === "string" ? data.model : undefined;
+    const startedAt = typeof data.startedAt === "number" ? data.startedAt : undefined;
+    const uptime = typeof data.uptime === "number" ? data.uptime : undefined;
+    const startup = parseAgentStartupDiagnostics(data.startup);
+    return {
+        state: state,
+        agentName,
+        model,
+        startedAt,
+        uptime,
+        startup,
+    };
+}
+export function parseAgentStartupDiagnostics(value) {
+    if (!isRecord(value))
+        return undefined;
+    const phase = value.phase;
+    const attempt = value.attempt;
+    if (typeof phase !== "string" || typeof attempt !== "number") {
+        return undefined;
+    }
+    const startup = { phase, attempt };
+    if (typeof value.lastError === "string")
+        startup.lastError = value.lastError;
+    if (typeof value.lastErrorAt === "number")
+        startup.lastErrorAt = value.lastErrorAt;
+    if (typeof value.nextRetryAt === "number")
+        startup.nextRetryAt = value.nextRetryAt;
+    return startup;
+}
+export function parseStreamEventEnvelopeEvent(data) {
+    const type = data.type;
+    const eventId = data.eventId;
+    const ts = data.ts;
+    const payload = data.payload;
+    if ((type !== "agent_event" &&
+        type !== "heartbeat_event" &&
+        type !== "training_event") ||
+        typeof eventId !== "string" ||
+        typeof ts !== "number" ||
+        !isRecord(payload)) {
+        return null;
+    }
+    const envelope = {
+        type,
+        version: 1,
+        eventId,
+        ts,
+        payload,
+    };
+    if (typeof data.runId === "string")
+        envelope.runId = data.runId;
+    if (typeof data.seq === "number")
+        envelope.seq = data.seq;
+    if (typeof data.stream === "string")
+        envelope.stream = data.stream;
+    if (typeof data.sessionKey === "string")
+        envelope.sessionKey = data.sessionKey;
+    if (typeof data.agentId === "string")
+        envelope.agentId = data.agentId;
+    if (typeof data.roomId === "string")
+        envelope.roomId = data.roomId;
+    return envelope;
+}
+export function parseConversationMessageEvent(value) {
+    if (!isRecord(value))
+        return null;
+    const id = value.id;
+    const role = value.role;
+    const text = value.text;
+    const timestamp = value.timestamp;
+    const source = value.source;
+    const from = value.from;
+    if (typeof id !== "string" ||
+        (role !== "user" && role !== "assistant") ||
+        typeof text !== "string" ||
+        typeof timestamp !== "number") {
+        return null;
+    }
+    const parsed = { id, role, text, timestamp };
+    if (typeof source === "string" && source.length > 0) {
+        parsed.source = source;
+    }
+    if (typeof from === "string" && from.length > 0) {
+        parsed.from = from;
+    }
+    return parsed;
+}
+export function parseProactiveMessageEvent(data) {
+    const conversationId = data.conversationId;
+    if (typeof conversationId !== "string")
+        return null;
+    const message = parseConversationMessageEvent(data.message);
+    if (!message)
+        return null;
+    return { conversationId, message };
+}
+export { mergeStreamingText };
+export function computeStreamingDelta(existing, incoming) {
+    return computeStreamingDeltaInternal(existing, incoming);
+}
+export function normalizeStreamComparisonText(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+export function shouldApplyFinalStreamText(streamed, finalText) {
+    if (!finalText.trim())
+        return false;
+    if (!streamed)
+        return true;
+    if (streamed === finalText)
+        return false;
+    return (normalizeStreamComparisonText(streamed) !==
+        normalizeStreamComparisonText(finalText));
+}
+// Function previously local to chat-commands but used here
+function normalizeSlashCommandName(name) {
+    if (!name.startsWith("/"))
+        name = `/${name}`;
+    return name.trim().toLowerCase();
+}
+// A simple utility to split command arguments, equivalent to chat-commands splitCommandArgs
+function splitCommandArgs(text) {
+    const parts = [];
+    const regex = /[^\s"']+|"([^"]*)"|'([^']*)'/g;
+    let match = regex.exec(text);
+    while (match !== null) {
+        parts.push(match[1] || match[2] || match[0]);
+        match = regex.exec(text);
+    }
+    return parts;
+}
+export function parseSlashCommandInput(text) {
+    if (!text.startsWith("/"))
+        return null;
+    const body = text.slice(1).trim();
+    if (!body)
+        return null;
+    const firstSpace = body.search(/\s/);
+    if (firstSpace === -1) {
+        return { name: normalizeSlashCommandName(body), argsRaw: "" };
+    }
+    return {
+        name: normalizeSlashCommandName(body.slice(0, firstSpace)),
+        argsRaw: body.slice(firstSpace + 1).trim(),
+    };
+}
+export function normalizeCustomActionName(value) {
+    return value
+        .trim()
+        .replace(/[\s-]+/g, "_")
+        .toUpperCase();
+}
+export function parseCustomActionParams(action, argsRaw) {
+    const tokens = splitCommandArgs(argsRaw);
+    const named = new Map();
+    const positional = [];
+    for (const token of tokens) {
+        const eq = token.indexOf("=");
+        if (eq > 0) {
+            const key = token.slice(0, eq).trim().toLowerCase();
+            const value = token.slice(eq + 1).trim();
+            if (key) {
+                named.set(key, value);
+                continue;
+            }
+        }
+        positional.push(token);
+    }
+    const params = {};
+    const defs = Array.isArray(action.parameters) ? action.parameters : [];
+    const defsByLower = new Map(defs.map((def) => [def.name.trim().toLowerCase(), def.name]));
+    for (const [key, value] of named) {
+        const canonical = defsByLower.get(key);
+        if (canonical) {
+            params[canonical] = value;
+        }
+        else {
+            params[key] = value;
+        }
+    }
+    for (const def of defs) {
+        if (params[def.name] == null && positional.length > 0) {
+            params[def.name] = positional.shift();
+        }
+    }
+    if (positional.length > 0) {
+        const sink = defs.find((def) => ["input", "text", "query", "message", "prompt"].includes(def.name.toLowerCase()));
+        if (sink) {
+            const existing = params[sink.name];
+            params[sink.name] = existing
+                ? `${existing} ${positional.join(" ")}`
+                : positional.join(" ");
+        }
+    }
+    const missingRequired = defs
+        .filter((def) => def.required)
+        .map((def) => def.name)
+        .filter((name) => !(params[name] ?? "").trim());
+    return { params, missingRequired };
+}
+export function formatSearchBullet(label, items) {
+    if (items.length === 0)
+        return `${label}: none`;
+    return `${label}:\n${items.map((item) => `- ${item}`).join("\n")}`;
+}
+export function asApiLikeError(err) {
+    if (!isRecord(err))
+        return null;
+    const kind = err.kind;
+    const status = err.status;
+    const path = err.path;
+    const message = err.message;
+    const hasApiShape = typeof kind === "string" ||
+        typeof status === "number" ||
+        typeof path === "string";
+    if (!hasApiShape)
+        return null;
+    return {
+        kind: typeof kind === "string" ? kind : undefined,
+        status: typeof status === "number" ? status : undefined,
+        path: typeof path === "string" ? path : undefined,
+        message: typeof message === "string" ? message : undefined,
+    };
+}
+export function formatStartupErrorDetail(err) {
+    const apiErr = asApiLikeError(err);
+    if (apiErr) {
+        const parts = [];
+        if (apiErr.path)
+            parts.push(apiErr.path);
+        if (typeof apiErr.status === "number")
+            parts.push(`HTTP ${apiErr.status}`);
+        if (apiErr.message)
+            parts.push(apiErr.message);
+        return parts.filter(Boolean).join(" - ");
+    }
+    if (err instanceof Error && err.message.trim()) {
+        return err.message.trim();
+    }
+    return undefined;
+}

package/state/persistence.d.ts

@@ -0,0 +1,59 @@
+import type { ConversationMode } from "../api/client";
+import { type UiLanguage } from "../i18n";
+import type { Tab } from "../navigation";
+import type { OnboardingStep } from "./types";
+import type { UiShellMode, UiTheme } from "./ui-preferences";
+export type { UiTheme } from "./ui-preferences";
+declare function normalizeUiTheme(value: unknown): UiTheme;
+export { normalizeUiTheme };
+export declare function loadUiTheme(): UiTheme;
+export declare function saveUiTheme(theme: UiTheme): void;
+/**
+ * Apply the theme to the document root.
+ * Sets both `data-theme` attribute and `.dark` class so both CSS selectors
+ * in base.css (`[data-theme="dark"]` and `.dark`) are satisfied.
+ */
+export declare function applyUiTheme(theme: UiTheme): void;
+export declare function loadPersistedOnboardingStep(): OnboardingStep | null;
+export declare function saveOnboardingStep(step: OnboardingStep): void;
+export declare function clearPersistedOnboardingStep(): void;
+export declare function loadUiLanguage(): UiLanguage;
+export declare function saveUiLanguage(language: UiLanguage): void;
+declare function normalizeUiShellMode(mode: unknown): UiShellMode;
+export { normalizeUiShellMode };
+export declare function loadUiShellMode(): UiShellMode;
+export declare function saveUiShellMode(mode: UiShellMode): void;
+export declare function loadLastNativeTab(): Tab;
+export declare function saveLastNativeTab(tab: Tab): void;
+export declare function loadAvatarIndex(): number;
+export declare function saveAvatarIndex(index: number): void;
+export declare function loadChatAvatarVisible(): boolean;
+export declare function loadChatVoiceMuted(): boolean;
+export declare function saveChatAvatarVisible(value: boolean): void;
+export declare function saveChatVoiceMuted(value: boolean): void;
+export declare function loadChatMode(): ConversationMode;
+export declare function saveChatMode(value: ConversationMode): void;
+export declare function loadActiveConversationId(): string | null;
+export declare function saveActiveConversationId(value: string | null): void;
+export declare function loadCompanionMessageCutoffTs(): number;
+export declare function saveCompanionMessageCutoffTs(value: number): void;
+/**
+ * Persisted connection state so the app knows how to connect on restart
+ * without waiting for a backend that may not exist yet.
+ */
+export interface PersistedConnectionMode {
+    /** "local" = embedded agent, "cloud" = eliza cloud sandbox, "remote" = custom URL */
+    runMode: "local" | "cloud" | "remote";
+    /** For cloud: the eliza cloud API base URL */
+    cloudApiBase?: string;
+    /** For cloud: the auth token */
+    cloudAuthToken?: string;
+    /** For remote: the remote API base URL */
+    remoteApiBase?: string;
+    /** For remote: the access token/connection key */
+    remoteAccessToken?: string;
+}
+export declare function loadPersistedConnectionMode(): PersistedConnectionMode | null;
+export declare function savePersistedConnectionMode(mode: PersistedConnectionMode): void;
+export declare function clearPersistedConnectionMode(): void;
+//# sourceMappingURL=persistence.d.ts.map

package/state/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/state/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAK7D,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,iBAAS,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,wBAAgB,WAAW,IAAI,OAAO,CAMrC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAMhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBjD;AAoBD,wBAAgB,2BAA2B,IAAI,cAAc,GAAG,IAAI,CAQnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAM7D;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAMnD;AAED,wBAAgB,cAAc,IAAI,UAAU,CAO3C;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAMzD;AAED,iBAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAExD;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,wBAAgB,eAAe,IAAI,WAAW,CAQ7C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAMvD;AA4BD,wBAAgB,iBAAiB,IAAI,GAAG,CAQvC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAShD;AAKD,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMnD;AAMD,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAO5C;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM1D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAMvD;AAOD,wBAAgB,YAAY,IAAI,gBAAgB,CAO/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAM1D;AAED,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAOxD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAUnE;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAQrD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAShE;AAID;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,wBAAgB,2BAA2B,IAAI,uBAAuB,GAAG,IAAI,CAkB5E;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,uBAAuB,GAC5B,IAAI,CAMN;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAMnD"}