@elizaos/plugin-trajectory-logger 2.0.0-alpha.1 → 2.0.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/TrajectoryLoggerService.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Trajectory Logger Service
+ *
+ * In-memory collector for agent interaction trajectories.
+ *
+ * This implementation is intentionally storage-agnostic so it can be used in any elizaOS
+ * environment (Node, Bun, tests). If you want persistence, export trajectories and store them
+ * via your preferred database or file pipeline.
+ */
+import type { ActionAttempt, EnvironmentState, JsonValue, LLMCall, ProviderAccess, RewardComponents, Trajectory } from "./types";
+export declare class TrajectoryLoggerService {
+    private activeTrajectories;
+    private activeStepIds;
+    startTrajectory(agentId: string, options?: {
+        scenarioId?: string;
+        episodeId?: string;
+        batchId?: string;
+        groupIndex?: number;
+        metadata?: Record<string, JsonValue>;
+    }): string;
+    startStep(trajectoryId: string, envState: EnvironmentState): string;
+    logLLMCall(stepId: string, llmCall: Omit<LLMCall, "callId" | "timestamp">): void;
+    logProviderAccess(stepId: string, access: Omit<ProviderAccess, "providerId" | "timestamp">): void;
+    logLLMCallByTrajectoryId(trajectoryId: string, llmCall: Omit<LLMCall, "callId" | "timestamp">): void;
+    logProviderAccessByTrajectoryId(trajectoryId: string, access: Omit<ProviderAccess, "providerId" | "timestamp">): void;
+    getCurrentStepId(trajectoryId: string): string | null;
+    completeStep(trajectoryId: string, stepId: string, action: Omit<ActionAttempt, "attemptId" | "timestamp">, rewardInfo?: {
+        reward?: number;
+        components?: Partial<RewardComponents>;
+    }): void;
+    completeCurrentStep(trajectoryId: string, action: Omit<ActionAttempt, "attemptId" | "timestamp">, rewardInfo?: {
+        reward?: number;
+        components?: Partial<RewardComponents>;
+    }): void;
+    endTrajectory(trajectoryId: string, status: "completed" | "terminated" | "error" | "timeout", finalMetrics?: Record<string, JsonValue>): Promise<void>;
+    getActiveTrajectory(trajectoryId: string): Trajectory | null;
+    private findTrajectoryByStepId;
+}
+//# sourceMappingURL=TrajectoryLoggerService.d.ts.map

package/dist/TrajectoryLoggerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryLoggerService.d.ts","sourceRoot":"","sources":["../TrajectoryLoggerService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,UAAU,EAEX,MAAM,SAAS,CAAC;AAEjB,qBAAa,uBAAuB;IAClC,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,aAAa,CAAkC;IAEvD,eAAe,CACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;KACjC,GACL,MAAM;IA8BT,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAiCnE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,CAAC,GAAG,IAAI;IAsBhF,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,WAAW,CAAC,GACvD,IAAI;IAsBP,wBAAwB,CACtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,CAAC,GAC7C,IAAI;IASP,+BAA+B,CAC7B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,WAAW,CAAC,GACvD,IAAI;IASP,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrD,YAAY,CACV,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,EACtD,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;KAAE,GACvE,IAAI;IAkCP,mBAAmB,CACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,EACtD,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;KAAE,GACvE,IAAI;IASD,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,EACxD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC;IAsBhB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAI5D,OAAO,CAAC,sBAAsB;CAQ/B"}

package/dist/action-interceptor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Action-Level Instrumentation
+ *
+ * Wraps actions and providers with trajectory logging.
+ */
+import type { Action, IAgentRuntime, Plugin, Provider } from "@elizaos/core";
+import type { TrajectoryLoggerService } from "./TrajectoryLoggerService";
+import type { JsonValue } from "./types";
+interface TrajectoryContext {
+    trajectoryId: string;
+    logger: TrajectoryLoggerService;
+}
+export declare function setTrajectoryContext(runtime: IAgentRuntime, trajectoryId: string, trajectoryLogger: TrajectoryLoggerService): void;
+export declare function getTrajectoryContext(runtime: IAgentRuntime): TrajectoryContext | null;
+export declare function clearTrajectoryContext(runtime: IAgentRuntime): void;
+export declare function wrapActionWithLogging(action: Action, _trajectoryLogger: TrajectoryLoggerService): Action;
+export declare function wrapPluginActions(plugin: Plugin, trajectoryLogger: TrajectoryLoggerService): Plugin;
+export declare function logLLMCallFromAction(actionContext: Record<string, JsonValue | undefined>, trajectoryLogger: TrajectoryLoggerService, trajectoryId: string): void;
+export declare function logProviderFromAction(actionContext: Record<string, JsonValue | undefined>, trajectoryLogger: TrajectoryLoggerService, trajectoryId: string): void;
+export declare function wrapProviderWithLogging(provider: Provider, _trajectoryLogger: TrajectoryLoggerService): Provider;
+export declare function wrapPluginProviders(plugin: Plugin, trajectoryLogger: TrajectoryLoggerService): Plugin;
+export {};
+//# sourceMappingURL=action-interceptor.d.ts.map

package/dist/action-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-interceptor.d.ts","sourceRoot":"","sources":["../action-interceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,MAAM,EAIN,aAAa,EAEb,MAAM,EACN,QAAQ,EAGT,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAID,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,uBAAuB,GACxC,IAAI,CAEN;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,GAAG,IAAI,CAErF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEnE;AAID,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,uBAAuB,GACzC,MAAM,CA+FR;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,uBAAuB,GACxC,MAAM,CASR;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,EACpD,gBAAgB,EAAE,uBAAuB,EACzC,YAAY,EAAE,MAAM,GACnB,IAAI,CAuBN;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,EACpD,gBAAgB,EAAE,uBAAuB,EACzC,YAAY,EAAE,MAAM,GACnB,IAAI,CAaN;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,uBAAuB,GACzC,QAAQ,CA0CV;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,uBAAuB,GACxC,MAAM,CAWR"}

package/dist/art-format.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ART Format Conversion
+ *
+ * Converts our rich trajectory format to ART-compatible format.
+ *
+ * Key insight from ART examples:
+ * - Trajectories are MESSAGE ARRAYS (system/user/assistant)
+ * - Metadata is separate (for judge context)
+ * - Single reward per trajectory
+ * - Grouping by scenario for GRPO
+ */
+import type { ARTTrajectory, ChatMessage, Trajectory, TrajectoryGroup } from "./types";
+/**
+ * Convert rich trajectory to ART message format.
+ */
+export declare function toARTMessages(trajectory: Trajectory): ChatMessage[];
+export declare function toARTTrajectory(trajectory: Trajectory): ARTTrajectory;
+export declare function groupTrajectories(trajectories: Trajectory[]): TrajectoryGroup[];
+export declare function extractSharedPrefix(trajectories: Trajectory[]): ChatMessage[];
+export declare function removeSharedPrefix(messages: ChatMessage[], sharedPrefix: ChatMessage[]): ChatMessage[];
+export declare function prepareForRULER(group: TrajectoryGroup): {
+    sharedPrefix: ChatMessage[];
+    suffixes: ChatMessage[][];
+    metadata: ARTTrajectory["metadata"][];
+};
+export declare function toARTJSONL(trajectory: Trajectory): string;
+export declare function validateARTCompatibility(trajectory: Trajectory): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+//# sourceMappingURL=art-format.d.ts.map

package/dist/art-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"art-format.d.ts","sourceRoot":"","sources":["../art-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAEX,UAAU,EACV,eAAe,EAEhB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,EAAE,CAqBnE;AA0DD,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,CAwBrE;AAkDD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAkB/E;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAyB7E;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,WAAW,EAAE,GAC1B,WAAW,EAAE,CAEf;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG;IACvD,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;CACvC,CASA;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAqCA"}

package/dist/build.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../build.ts"],"names":[],"mappings":""}

package/dist/export.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Trajectory Export Utilities
+ *
+ * The original implementation targeted a Babylon-specific database + HuggingFace upload pipeline.
+ * In elizaOS core, this module is storage-agnostic and focuses on preparing files for downstream
+ * training (JSONL / grouped JSON).
+ */
+import type { Trajectory } from "./types";
+export interface ExportOptions {
+    datasetName: string;
+    huggingFaceToken?: string;
+    startDate?: Date;
+    endDate?: Date;
+    agentIds?: string[];
+    scenarioIds?: string[];
+    minReward?: number;
+    maxReward?: number;
+    includeJudged?: boolean;
+    maxTrajectories?: number;
+    format?: "jsonl" | "parquet" | "arrow";
+    splitRatio?: {
+        train: number;
+        validation: number;
+        test: number;
+    };
+    trajectories?: Trajectory[];
+    outputPath?: string;
+    outputDir?: string;
+}
+export interface ExportResult {
+    success: boolean;
+    trajectoriesExported: number;
+    datasetUrl?: string;
+    error?: string;
+}
+export declare function exportToHuggingFace(options: ExportOptions): Promise<ExportResult>;
+export declare function exportGroupedByScenario(options: ExportOptions): Promise<ExportResult>;
+export declare function exportForOpenPipeART(options: ExportOptions): Promise<ExportResult>;
+export declare function exportGroupedForGRPO(options: ExportOptions): Promise<ExportResult>;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAE3D,MAAM,WAAW,aAAa;IAE5B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAGjE,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAG5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAKvF;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAa3F;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAQxF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAQxF"}

package/dist/game-rewards.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Game-Knowledge Rewards
+ *
+ * Compute rewards using perfect game information for RL training.
+ *
+ * @remarks These helpers are intentionally lightweight; environments can provide richer
+ * reward computation by writing into `trajectory.totalReward` and `step.reward`.
+ */
+import type { JsonValue, Trajectory, TrajectoryStep } from "./types";
+export declare function computeTrajectoryReward(trajectory: Trajectory): number;
+export declare function computeStepReward(step: TrajectoryStep): number;
+export declare function buildGameStateFromDB(_trajectoryId: string): Promise<Record<string, JsonValue>>;
+export declare function recomputeTrajectoryRewards(_trajectoryIds: string[]): Promise<void>;
+//# sourceMappingURL=game-rewards.d.ts.map

package/dist/game-rewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-rewards.d.ts","sourceRoot":"","sources":["../game-rewards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAEpC;AAED,wBAAsB,0BAA0B,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF"}

package/dist/generated/specs/specs.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Auto-generated canonical action/provider/evaluator docs for plugin-trajectory-logger.
+ * DO NOT EDIT - Generated from prompts/specs/**.
+ */
+export type ActionDoc = {
+    name: string;
+    description: string;
+    similes?: readonly string[];
+    parameters?: readonly unknown[];
+    examples?: readonly (readonly unknown[])[];
+};
+export type ProviderDoc = {
+    name: string;
+    description: string;
+    position?: number;
+    dynamic?: boolean;
+};
+export type EvaluatorDoc = {
+    name: string;
+    description: string;
+    similes?: readonly string[];
+    alwaysRun?: boolean;
+    examples?: readonly unknown[];
+};
+export declare const coreActionsSpec: {
+    readonly version: "1.0.0";
+    readonly actions: readonly [];
+};
+export declare const allActionsSpec: {
+    readonly version: "1.0.0";
+    readonly actions: readonly [];
+};
+export declare const coreProvidersSpec: {
+    readonly version: "1.0.0";
+    readonly providers: readonly [];
+};
+export declare const allProvidersSpec: {
+    readonly version: "1.0.0";
+    readonly providers: readonly [];
+};
+export declare const coreEvaluatorsSpec: {
+    readonly version: "1.0.0";
+    readonly evaluators: readonly [];
+};
+export declare const allEvaluatorsSpec: {
+    readonly version: "1.0.0";
+    readonly evaluators: readonly [];
+};
+export declare const coreActionDocs: readonly ActionDoc[];
+export declare const allActionDocs: readonly ActionDoc[];
+export declare const coreProviderDocs: readonly ProviderDoc[];
+export declare const allProviderDocs: readonly ProviderDoc[];
+export declare const coreEvaluatorDocs: readonly EvaluatorDoc[];
+export declare const allEvaluatorDocs: readonly EvaluatorDoc[];
+//# sourceMappingURL=specs.d.ts.map

package/dist/generated/specs/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../generated/specs/specs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AACX,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AACX,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AACX,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AACX,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EAA4B,CAAC;AAC5E,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAA2B,CAAC;AAC1E,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAAgC,CAAC;AACpF,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAA+B,CAAC;AAClF,eAAO,MAAM,iBAAiB,EAAE,SAAS,YAAY,EAAkC,CAAC;AACxF,eAAO,MAAM,gBAAgB,EAAE,SAAS,YAAY,EAAiC,CAAC"}

package/dist/index.browser.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@elizaos/core";
+export declare const trajectoryLoggerPlugin: Plugin;
+export default trajectoryLoggerPlugin;
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAK3D,eAAO,MAAM,sBAAsB,EAAE,MAQpC,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from "@elizaos/core";
+/**
+ * Trajectory Logger Plugin
+ *
+ * Collects complete agent interaction trajectories for RL training.
+ * Records LLM calls, provider access, actions, environment state, and computes rewards.
+ *
+ * @remarks TrajectoryLoggerService is exported but not registered as a service
+ * since it doesn't implement the core Service interface. Use the exported helpers directly.
+ */
+export declare const trajectoryLoggerPlugin: Plugin;
+export default trajectoryLoggerPlugin;
+export * from "./action-interceptor";
+export * from "./art-format";
+export * from "./export";
+export * from "./game-rewards";
+export * from "./integration";
+export * from "./reward-service";
+export { TrajectoryLoggerService } from "./TrajectoryLoggerService";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAMpC,CAAC;AAEF,eAAe,sBAAsB,CAAC;AAMtC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,cAAc,CAAC;AAI7B,cAAc,UAAU,CAAC;AAKzB,cAAc,gBAAgB,CAAC;AAI/B,cAAc,eAAe,CAAC;AAI9B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,cAAc,SAAS,CAAC"}

package/dist/integration.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Manual Instrumentation Helpers
+ *
+ * Advanced manual control for trajectory logging.
+ */
+import type { TrajectoryLoggerService } from "./TrajectoryLoggerService";
+import type { JsonValue } from "./types";
+export interface TrajectoryMetadata {
+    [key: string]: JsonValue;
+}
+export type FinalMetrics = Record<string, JsonValue> & {
+    totalReward?: number;
+    stepCount?: number;
+    successRate?: number;
+};
+export interface ProviderAccessData {
+    [key: string]: JsonValue;
+}
+export type WrappedFunctionArgs = JsonValue[];
+export declare function startAutonomousTick(trajectoryLogger: TrajectoryLoggerService, context: {
+    agentId: string;
+    scenarioId?: string;
+    episodeId?: string;
+    batchId?: string;
+    metadata?: TrajectoryMetadata;
+}): string;
+export declare function endAutonomousTick(trajectoryLogger: TrajectoryLoggerService, trajectoryId: string, status?: "completed" | "terminated" | "error" | "timeout", finalMetrics?: FinalMetrics): Promise<void>;
+export declare function loggedLLMCall(trajectoryLogger: TrajectoryLoggerService, trajectoryId: string, options: {
+    model: string;
+    modelVersion?: string;
+    systemPrompt: string;
+    userPrompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    purpose?: "action" | "reasoning" | "evaluation" | "response" | "other";
+    actionType?: string;
+}, llmCallFn: () => Promise<{
+    text: string;
+    reasoning?: string;
+    tokens?: {
+        prompt?: number;
+        completion?: number;
+    };
+    latencyMs?: number;
+}>): Promise<string>;
+export declare function logProviderAccess(trajectoryLogger: TrajectoryLoggerService, trajectoryId: string, access: {
+    providerName: string;
+    data: ProviderAccessData;
+    purpose: string;
+    query?: ProviderAccessData;
+}): void;
+type AsyncFunction<TArgs extends JsonValue[], TResult extends JsonValue> = (...args: TArgs) => Promise<TResult>;
+export declare function withTrajectoryLogging<TArgs extends JsonValue[], TResult extends JsonValue>(fn: AsyncFunction<TArgs, TResult>, trajectoryLogger: TrajectoryLoggerService, trajectoryId: string, context?: {
+    actionType?: string;
+    purpose?: string;
+}): AsyncFunction<TArgs, TResult>;
+export {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

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