@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/runtime/embedding-presets.d.ts

@@ -0,0 +1,19 @@
+export type EmbeddingTier = "fallback" | "standard" | "performance";
+export interface EmbeddingPreset {
+    tier: EmbeddingTier;
+    label: string;
+    description: string;
+    model: string;
+    modelRepo: string;
+    dimensions: number;
+    gpuLayers: "auto" | 0;
+    contextSize: number;
+    downloadSizeMB: number;
+}
+/** All available presets, indexed by tier. */
+export declare const EMBEDDING_PRESETS: Record<EmbeddingTier, EmbeddingPreset>;
+/** Detect the best embedding tier for the current hardware. */
+export declare function detectEmbeddingTier(): EmbeddingTier;
+/** Get the preset for the current hardware. */
+export declare function detectEmbeddingPreset(): EmbeddingPreset;
+//# sourceMappingURL=embedding-presets.d.ts.map

package/packages/agent/src/runtime/embedding-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-presets.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/embedding-presets.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,CAqCpE,CAAC;AAIF,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAED,+CAA+C;AAC/C,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/packages/agent/src/runtime/embedding-presets.js

@@ -0,0 +1,53 @@
+import os from "node:os";
+/** All available presets, indexed by tier. */
+export const EMBEDDING_PRESETS = {
+    fallback: {
+        tier: "fallback",
+        label: "Efficient (CPU)",
+        description: "768-dim, 74MB download — best for Intel Macs and low-RAM machines",
+        model: "nomic-embed-text-v1.5.Q4_K_S.gguf",
+        modelRepo: "nomic-ai/nomic-embed-text-v1.5-GGUF",
+        dimensions: 768,
+        gpuLayers: 0,
+        contextSize: 8192,
+        downloadSizeMB: 74,
+    },
+    standard: {
+        tier: "standard",
+        label: "Balanced (Metal GPU)",
+        description: "768-dim, 95MB download — great quality with Metal acceleration",
+        model: "nomic-embed-text-v1.5.Q5_K_M.gguf",
+        modelRepo: "nomic-ai/nomic-embed-text-v1.5-GGUF",
+        dimensions: 768,
+        gpuLayers: "auto",
+        contextSize: 8192,
+        downloadSizeMB: 95,
+    },
+    performance: {
+        tier: "performance",
+        label: "Maximum (7B model)",
+        description: "4096-dim, 4.2GB download — SOTA retrieval quality, 32K context",
+        model: "ggml-e5-mistral-7b-instruct-q4_k_m.gguf",
+        modelRepo: "dranger003/e5-mistral-7b-instruct-GGUF",
+        dimensions: 4096,
+        gpuLayers: "auto",
+        contextSize: 32768,
+        downloadSizeMB: 4200,
+    },
+};
+const BYTES_PER_GB = 1024 ** 3;
+/** Detect the best embedding tier for the current hardware. */
+export function detectEmbeddingTier() {
+    const totalRamGB = Math.round(os.totalmem() / BYTES_PER_GB);
+    const isMac = process.platform === "darwin";
+    const isAppleSilicon = isMac && process.arch === "arm64";
+    if (!isAppleSilicon || totalRamGB <= 8)
+        return "fallback";
+    if (totalRamGB >= 128)
+        return "performance";
+    return "standard";
+}
+/** Get the preset for the current hardware. */
+export function detectEmbeddingPreset() {
+    return EMBEDDING_PRESETS[detectEmbeddingTier()];
+}

package/packages/agent/src/runtime/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./eliza";
+export * from "./eliza-plugin";
+export * from "./embedding-presets";
+export * from "./onboarding-names";
+export * from "./release-plugin-policy";
+export * from "./restart";
+export * from "./trajectory-persistence";
+export * from "./version";
+//# sourceMappingURL=index.d.ts.map

package/packages/agent/src/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC"}

package/packages/agent/src/runtime/index.js

@@ -0,0 +1,8 @@
+export * from "./eliza";
+export * from "./eliza-plugin";
+export * from "./embedding-presets";
+export * from "./onboarding-names";
+export * from "./release-plugin-policy";
+export * from "./restart";
+export * from "./trajectory-persistence";
+export * from "./version";

package/packages/agent/src/runtime/onboarding-names.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared pool of Japanese agent names for onboarding.
+ *
+ * Used by both the CLI first-run flow (eliza.ts) and the
+ * web UI API server (api/server.ts).
+ */
+/** Pool of Japanese names to randomly sample from during onboarding. */
+export declare const AGENT_NAME_POOL: readonly string[];
+/** Pick `count` unique random names from the pool using Fisher-Yates shuffle. */
+export declare function pickRandomNames(count: number): string[];
+//# sourceMappingURL=onboarding-names.d.ts.map

package/packages/agent/src/runtime/onboarding-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-names.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/onboarding-names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAwD5C,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvD"}

package/packages/agent/src/runtime/onboarding-names.js

@@ -0,0 +1,74 @@
+/**
+ * Shared pool of Japanese agent names for onboarding.
+ *
+ * Used by both the CLI first-run flow (eliza.ts) and the
+ * web UI API server (api/server.ts).
+ */
+/** Pool of Japanese names to randomly sample from during onboarding. */
+export const AGENT_NAME_POOL = [
+    "Reimu",
+    "Sakuya",
+    "Yukari",
+    "Marisa",
+    "Youmu",
+    "Koakuma",
+    "Reisen",
+    "Yuyuko",
+    "Aya",
+    "Ran",
+    "Sanae",
+    "Suika",
+    "Koishi",
+    "Nue",
+    "Chen",
+    "Mokou",
+    "Satori",
+    "Remilia",
+    "Suwako",
+    "Momiji",
+    "Tenshi",
+    "Kaguya",
+    "Komachi",
+    "Nitori",
+    "Charlotte",
+    "Kasen",
+    "Mima",
+    "Yuuka",
+    "Kogasa",
+    "Rin",
+    "Tewi",
+    "Eirin",
+    "Hina",
+    "Kagerou",
+    "Sumireko",
+    "Kokoro",
+    "Mamizou",
+    "Rinnosuke",
+    "Yumemi",
+    "Akyuu",
+    "Kanako",
+    "Hatsune",
+    "Shinki",
+    "Shion",
+    "Daiyousei",
+    "Iku",
+    "Miya",
+    "Mai",
+    "Meira",
+    "Murasa",
+    "Usagi",
+    "Rei",
+    "Yumi",
+    "Miku",
+    "Kira",
+];
+/** Pick `count` unique random names from the pool using Fisher-Yates shuffle. */
+export function pickRandomNames(count) {
+    const clamped = Math.max(0, Math.min(count, AGENT_NAME_POOL.length));
+    const pool = [...AGENT_NAME_POOL];
+    for (let i = pool.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [pool[i], pool[j]] = [pool[j], pool[i]];
+    }
+    return pool.slice(0, clamped);
+}

package/packages/agent/src/runtime/release-plugin-policy.d.ts

@@ -0,0 +1,20 @@
+export type RegistryPluginInstallSurface = "runtime" | "app";
+export type RegistryPluginReleaseAvailability = "bundled" | "post-release";
+export interface RegistryPluginReleaseCompatibility {
+    releaseAvailability: RegistryPluginReleaseAvailability;
+    installSurface: RegistryPluginInstallSurface;
+    postReleaseInstallable: boolean;
+    requiresDesktopRuntime: boolean;
+    requiresLocalRuntime: boolean;
+    note?: string;
+}
+export declare const BASELINE_BUNDLED_RUNTIME_PACKAGES: readonly string[];
+export declare function derivePluginIdFromPackageName(packageName: string): string;
+export declare function getBundledRuntimePackages(availableDependencies: Iterable<string>): string[];
+export declare function getBundledRuntimePluginIds(availableDependencies: Iterable<string>): string[];
+export declare function classifyRegistryPluginRelease(params: {
+    packageName: string;
+    bundledPluginIds: ReadonlySet<string>;
+    kind?: string;
+}): RegistryPluginReleaseCompatibility;
+//# sourceMappingURL=release-plugin-policy.d.ts.map

package/packages/agent/src/runtime/release-plugin-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-plugin-policy.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/release-plugin-policy.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,KAAK,CAAC;AAC7D,MAAM,MAAM,iCAAiC,GAAG,SAAS,GAAG,cAAc,CAAC;AAE3E,MAAM,WAAW,kCAAkC;IACjD,mBAAmB,EAAE,iCAAiC,CAAC;IACvD,cAAc,EAAE,4BAA4B,CAAC;IAC7C,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,iCAAiC,EAAE,SAAS,MAAM,EAI9D,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED,wBAAgB,yBAAyB,CACvC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACtC,MAAM,EAAE,CAKV;AAED,wBAAgB,0BAA0B,CACxC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACtC,MAAM,EAAE,CAKV;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,kCAAkC,CA2CrC"}

package/packages/agent/src/runtime/release-plugin-policy.js

@@ -0,0 +1,87 @@
+import { CORE_PLUGINS } from "./core-plugins";
+const BASELINE_RUNTIME_SUPPORT_PACKAGES = [
+    "@elizaos/core",
+    "@elizaos/prompts",
+    "@elizaos/tui",
+];
+const BASELINE_PROVIDER_PLUGINS = [
+    "@elizaos/plugin-elizacloud",
+    "@elizaos/plugin-openai",
+    "@elizaos/plugin-anthropic",
+    "@elizaos/plugin-ollama",
+];
+const DESKTOP_RUNTIME_ONLY_PLUGINS = new Set([
+    "@elizaos/plugin-browser",
+    "@elizaos/plugin-computeruse",
+    "@elizaos/plugin-retake",
+]);
+const LOCAL_RUNTIME_ONLY_PLUGINS = new Set([
+    "@elizaos/plugin-browser",
+    "@elizaos/plugin-computeruse",
+    "@elizaos/plugin-retake",
+]);
+export const BASELINE_BUNDLED_RUNTIME_PACKAGES = [
+    ...BASELINE_RUNTIME_SUPPORT_PACKAGES,
+    ...CORE_PLUGINS,
+    ...BASELINE_PROVIDER_PLUGINS,
+];
+export function derivePluginIdFromPackageName(packageName) {
+    return packageName
+        .replace(/^@[^/]+\/plugin-/, "")
+        .replace(/^@[^/]+\//, "")
+        .replace(/^plugin-/, "");
+}
+export function getBundledRuntimePackages(availableDependencies) {
+    const available = new Set(availableDependencies);
+    return BASELINE_BUNDLED_RUNTIME_PACKAGES.filter((packageName) => available.has(packageName)).sort();
+}
+export function getBundledRuntimePluginIds(availableDependencies) {
+    return getBundledRuntimePackages(availableDependencies)
+        .map(derivePluginIdFromPackageName)
+        .filter((pluginId) => pluginId.length > 0)
+        .sort();
+}
+export function classifyRegistryPluginRelease(params) {
+    const { packageName, bundledPluginIds, kind } = params;
+    if (kind === "app") {
+        return {
+            releaseAvailability: "post-release",
+            installSurface: "app",
+            postReleaseInstallable: false,
+            requiresDesktopRuntime: false,
+            requiresLocalRuntime: false,
+            note: "Launchable apps are installed through the app catalog, not the runtime plugin installer.",
+        };
+    }
+    const pluginId = derivePluginIdFromPackageName(packageName);
+    const bundled = bundledPluginIds.has(pluginId);
+    const requiresDesktopRuntime = DESKTOP_RUNTIME_ONLY_PLUGINS.has(packageName);
+    const requiresLocalRuntime = LOCAL_RUNTIME_ONLY_PLUGINS.has(packageName);
+    let note;
+    if (bundled) {
+        note = "Included in the baseline Eliza runtime bundle.";
+    }
+    else if (requiresDesktopRuntime && requiresLocalRuntime) {
+        note =
+            "Excluded from the baseline release. Install on a local desktop runtime after release.";
+    }
+    else if (requiresDesktopRuntime) {
+        note =
+            "Excluded from the baseline release. Install on desktop targets after release.";
+    }
+    else if (requiresLocalRuntime) {
+        note =
+            "Excluded from the baseline release. Install on a local runtime after release.";
+    }
+    else {
+        note = "Excluded from the baseline release and installable after release.";
+    }
+    return {
+        releaseAvailability: bundled ? "bundled" : "post-release",
+        installSurface: "runtime",
+        postReleaseInstallable: !bundled,
+        requiresDesktopRuntime,
+        requiresLocalRuntime,
+        note,
+    };
+}

package/packages/agent/src/runtime/restart.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Restart infrastructure for Eliza.
+ *
+ * Provides a pluggable restart handler so the restart action (and the
+ * `/api/agent/restart` endpoint) work in every host environment:
+ *
+ *   - **CLI** (default): exits with {@link RESTART_EXIT_CODE} (75). The runner
+ *     script (`scripts/run-node.mjs`) catches this, rebuilds if source files
+ *     changed, and relaunches.
+ *   - **Dev-server / API**: the host registers a handler via
+ *     {@link setRestartHandler} that stops the current runtime, creates a new
+ *     one, and hot-swaps references.
+ *   - **Desktop app**: the host registers a handler that calls
+ *     `AgentManager.restart()`.
+ *
+ * @module restart
+ */
+/**
+ * Special exit code that tells the CLI runner to restart the process.
+ * Must stay in sync with `RESTART_EXIT_CODE` in `scripts/run-node.mjs`.
+ */
+export declare const RESTART_EXIT_CODE = 75;
+/**
+ * A function invoked when a restart is requested.
+ *
+ * Return a Promise if the restart involves async work (stopping the runtime,
+ * creating a new one, etc.). The restart action waits for this to settle
+ * before confirming to the user.
+ */
+export type RestartHandler = (reason?: string) => void | Promise<void>;
+/**
+ * Replace the active restart handler.
+ *
+ * Call this at startup in non-CLI environments (dev-server, desktop shell) to
+ * provide an in-process restart strategy.
+ */
+export declare function setRestartHandler(handler: RestartHandler): void;
+/**
+ * Trigger a restart.  Delegates to whatever handler is currently registered.
+ *
+ * Safe to call from the restart action, the API endpoint, or any other code
+ * that needs to bounce the agent.
+ */
+export declare function requestRestart(reason?: string): void | Promise<void>;
+//# sourceMappingURL=restart.d.ts.map

package/packages/agent/src/runtime/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/restart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAOvE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE"}

package/packages/agent/src/runtime/restart.js

@@ -0,0 +1,45 @@
+/**
+ * Restart infrastructure for Eliza.
+ *
+ * Provides a pluggable restart handler so the restart action (and the
+ * `/api/agent/restart` endpoint) work in every host environment:
+ *
+ *   - **CLI** (default): exits with {@link RESTART_EXIT_CODE} (75). The runner
+ *     script (`scripts/run-node.mjs`) catches this, rebuilds if source files
+ *     changed, and relaunches.
+ *   - **Dev-server / API**: the host registers a handler via
+ *     {@link setRestartHandler} that stops the current runtime, creates a new
+ *     one, and hot-swaps references.
+ *   - **Desktop app**: the host registers a handler that calls
+ *     `AgentManager.restart()`.
+ *
+ * @module restart
+ */
+import process from "node:process";
+/**
+ * Special exit code that tells the CLI runner to restart the process.
+ * Must stay in sync with `RESTART_EXIT_CODE` in `scripts/run-node.mjs`.
+ */
+export const RESTART_EXIT_CODE = 75;
+// Default handler: exit the process so the CLI runner can relaunch.
+let _handler = () => {
+    process.exit(RESTART_EXIT_CODE);
+};
+/**
+ * Replace the active restart handler.
+ *
+ * Call this at startup in non-CLI environments (dev-server, desktop shell) to
+ * provide an in-process restart strategy.
+ */
+export function setRestartHandler(handler) {
+    _handler = handler;
+}
+/**
+ * Trigger a restart.  Delegates to whatever handler is currently registered.
+ *
+ * Safe to call from the restart action, the API endpoint, or any other code
+ * that needs to bounce the agent.
+ */
+export function requestRestart(reason) {
+    return _handler(reason);
+}

package/packages/agent/src/runtime/trajectory-persistence.d.ts

@@ -0,0 +1,214 @@
+import { type IAgentRuntime, Service } from "@elizaos/core";
+type TrajectoryStatus = "active" | "completed" | "error" | "timeout";
+interface TrajectoryListOptions {
+    limit?: number;
+    offset?: number;
+    source?: string;
+    status?: TrajectoryStatus;
+    startDate?: string;
+    endDate?: string;
+    search?: string;
+    scenarioId?: string;
+    batchId?: string;
+    isTrainingData?: boolean;
+}
+interface TrajectoryListItem {
+    id: string;
+    agentId: string;
+    source: string;
+    status: TrajectoryStatus;
+    startTime: number;
+    endTime: number | null;
+    durationMs: number | null;
+    stepCount: number;
+    llmCallCount: number;
+    providerAccessCount: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+}
+interface TrajectoryListResult {
+    trajectories: TrajectoryListItem[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+interface TrajectoryStep {
+    stepId?: string;
+    timestamp: number;
+    llmCalls?: Array<{
+        callId?: string;
+        timestamp?: number;
+        model?: string;
+        systemPrompt?: string;
+        userPrompt?: string;
+        response?: string;
+        temperature?: number;
+        maxTokens?: number;
+        purpose?: string;
+        actionType?: string;
+        latencyMs?: number;
+        promptTokens?: number;
+        completionTokens?: number;
+    }>;
+    providerAccesses?: Array<{
+        providerId?: string;
+        providerName?: string;
+        purpose?: string;
+        data?: Record<string, unknown>;
+        query?: Record<string, unknown>;
+        timestamp?: number;
+    }>;
+}
+interface Trajectory {
+    trajectoryId: string;
+    agentId: string;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    steps?: TrajectoryStep[];
+    metrics?: {
+        finalStatus?: string;
+    };
+    metadata?: Record<string, unknown>;
+    stepsJson?: string;
+}
+type TrajectoryExportFormat = "json" | "csv" | "art";
+interface TrajectoryExportOptions {
+    format: TrajectoryExportFormat;
+    includePrompts?: boolean;
+    trajectoryIds?: string[];
+    startDate?: string;
+    endDate?: string;
+    scenarioId?: string;
+    batchId?: string;
+}
+interface TrajectoryExportResult {
+    filename: string;
+    data: string | Uint8Array;
+    mimeType: string;
+}
+type StartStepOptions = {
+    runtime: IAgentRuntime;
+    stepId: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+};
+type CompleteStepOptions = {
+    runtime: IAgentRuntime;
+    stepId: string;
+    status?: TrajectoryStatus;
+    source?: string;
+    metadata?: Record<string, unknown>;
+};
+/** @internal Exported for testing. */
+export declare function shouldRunObservationExtraction(runtime: IAgentRuntime): boolean;
+/** @internal Exported for testing. */
+export declare function truncateField(value: string, limit?: number): string;
+/** @internal Exported for testing. */
+export declare function truncateRecord(obj: Record<string, unknown>, limit?: number): Record<string, unknown>;
+/** @internal Exported for testing. */
+export declare function extractInsightsFromResponse(response: string, purpose: string): string[];
+interface BufferedExchange {
+    userPrompt: string;
+    response: string;
+    trajectoryId: string;
+    timestamp: number;
+}
+/** @internal Exported for testing. */
+export declare function pushChatExchange(runtime: IAgentRuntime, exchange: BufferedExchange): void;
+/** @internal Exported for testing. */
+export declare function flushObservationBuffer(runtime: IAgentRuntime): Promise<string[]>;
+/** @internal Exported for testing. */
+export declare function extractRows(result: unknown): unknown[];
+/** @internal Exported for testing. */
+export declare function computeBySource(runtime: IAgentRuntime): Promise<Record<string, number>>;
+/**
+ * Read orchestrator trajectory context from the runtime, if set.
+ * The coding agent orchestrator plugin sets `__orchestratorTrajectoryCtx` on
+ * the runtime around `useModel()` calls so we can tag them here.
+ */
+/** @internal Exported for testing. */
+export declare function readOrchestratorTrajectoryContext(runtime: unknown): {
+    source: "orchestrator";
+    decisionType: string;
+    sessionId?: string;
+    taskLabel?: string;
+    repo?: string;
+    workdir?: string;
+    originalTask?: string;
+} | undefined;
+export declare function installDatabaseTrajectoryLogger(runtime: IAgentRuntime): Promise<void>;
+export declare function startTrajectoryStepInDatabase({ runtime, stepId, source, metadata, }: StartStepOptions): Promise<boolean>;
+export declare function completeTrajectoryStepInDatabase({ runtime, stepId, status, source, metadata, }: CompleteStepOptions): Promise<boolean>;
+export declare function loadPersistedTrajectoryRows(runtime: IAgentRuntime, maxRows?: number): Promise<Record<string, unknown>[] | null>;
+export declare function deletePersistedTrajectoryRows(runtime: IAgentRuntime, trajectoryIds: string[]): Promise<number | null>;
+export declare function clearPersistedTrajectoryRows(runtime: IAgentRuntime): Promise<number | null>;
+/**
+ * Archive and then delete trajectories older than `maxAgeDays`.
+ * Summary rows (without steps_json) are copied to `trajectory_archive`
+ * before the heavy raw data is removed. Returns the number of rows
+ * pruned, or null if the DB is unavailable.
+ */
+export declare function pruneOldTrajectories(runtime: IAgentRuntime, maxAgeDays?: number): Promise<number | null>;
+/**
+ * Wait for all pending trajectory writes to complete.
+ * Useful for tests to ensure writes are flushed before assertions.
+ */
+export declare function flushTrajectoryWrites(runtime: IAgentRuntime): Promise<void>;
+/**
+ * Database-backed trajectory logger service that implements the full API
+ * expected by trajectory-routes.ts. This service reads from and writes to
+ * the database for trajectory persistence.
+ */
+export declare class DatabaseTrajectoryLogger extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private enabled;
+    /**
+     * Static start method required by @elizaos/core runtime.
+     */
+    static start(runtime: IAgentRuntime): Promise<Service>;
+    initialize(): Promise<void>;
+    stop(): Promise<void>;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    /**
+     * Start a new trajectory for tracking LLM interactions.
+     * Supports both legacy (stepId, {agentId}) and new (agentId, options) signatures.
+     */
+    startTrajectory(stepIdOrAgentId: string, options?: {
+        agentId?: string;
+        roomId?: string;
+        entityId?: string;
+        source?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<string>;
+    /**
+     * Start a new step within an existing trajectory.
+     */
+    startStep(_trajectoryId: string): string;
+    /**
+     * End a trajectory and mark it with the given status.
+     */
+    endTrajectory(stepIdOrTrajectoryId: string, status?: TrajectoryStatus): Promise<void>;
+    logLlmCall(params: Record<string, unknown>): void;
+    logProviderAccess(params: Record<string, unknown>): void;
+    getLlmCallLogs(): readonly unknown[];
+    getProviderAccessLogs(): readonly unknown[];
+    listTrajectories(options: TrajectoryListOptions): Promise<TrajectoryListResult>;
+    getTrajectoryDetail(trajectoryId: string): Promise<Trajectory | null>;
+    getStats(): Promise<unknown>;
+    deleteTrajectories(trajectoryIds: string[]): Promise<number>;
+    clearAllTrajectories(): Promise<number>;
+    exportTrajectories(options: TrajectoryExportOptions): Promise<TrajectoryExportResult>;
+}
+/**
+ * Create and register a database-backed trajectory logger service on the runtime.
+ * This replaces any existing trajectory_logger service with one that persists to the database.
+ */
+export declare function createDatabaseTrajectoryLogger(runtime: IAgentRuntime): DatabaseTrajectoryLogger;
+export declare function shouldEnableTrajectoryLoggingByDefault(): boolean;
+export {};
+//# sourceMappingURL=trajectory-persistence.d.ts.map

package/packages/agent/src/runtime/trajectory-persistence.d.ts.map

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