@elizaos/plugin-trajectory-logger 2.0.0-alpha.8 → 2.0.11-beta.7

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/README.md

@@ -0,0 +1,69 @@
+# @elizaos/plugin-trajectory-logger
+
+A developer plugin for elizaOS that provides a realtime trajectory inspector, showing the agent's active and last-completed turns broken down by phase: **HANDLE → PLAN → ACTION → EVALUATE**.
+
+## What it does
+
+When installed, the plugin adds an overlay view to the elizaOS UI. The view polls the trajectory API every 700 ms and displays two side-by-side strips:
+
+- **Current turn** — the in-flight trajectory, with the active phase pulsing.
+- **Last turn** — the most recently completed trajectory.
+
+Clicking any phase chip expands a drilldown showing LLM calls, provider accesses, tool events, or evaluator results depending on the phase.
+
+A **TUI variant** is also registered for terminal environments, supporting the `list-trajectories`, `open-latest`, `filter-phase`, and `refresh` capabilities.
+
+## Phases
+
+| Phase | What it covers |
+|---|---|
+| HANDLE | `should_respond` and `compose_state` LLM calls; provider context accesses |
+| PLAN | Reasoning, response, and action LLM calls |
+| ACTION | Tool/action execution events (call, result, error, duration) |
+| EVALUATE | Evaluator LLM calls and evaluation events with decisions |
+
+## Requirements
+
+- **`@elizaos/plugin-training`** must be loaded alongside this plugin. It serves the `/api/trajectories` and `/api/trajectories/:id` routes that this inspector reads from. Without it, the view shows a fetch error.
+
+## Installation
+
+Add the plugin to your agent character file:
+
+```json
+{
+  "plugins": ["@elizaos/plugin-trajectory-logger"]
+}
+```
+
+Or register it programmatically:
+
+```ts
+import trajectoryLoggerPlugin from "@elizaos/plugin-trajectory-logger";
+
+const agent = new AgentRuntime({
+  plugins: [trajectoryLoggerPlugin],
+  // ...
+});
+```
+
+## Configuration
+
+No environment variables or settings are required. The plugin reads data from the running elizaOS API server.
+
+## Exported API
+
+The package entry (`@elizaos/plugin-trajectory-logger`) re-exports, in addition to the default plugin:
+
+- `summarizePhases(detail, options)` — maps a `TrajectoryDetail` into `PhaseSummary[]` with status and summary text per phase.
+- `PHASES` — readonly array `["HANDLE", "PLAN", "ACTION", "EVALUATE"]` (typed `readonly PhaseName[]`).
+- `TrajectoryLoggerView` — the React overlay component.
+- `registerTrajectoryLoggerApp()` — registers the overlay app in the `@elizaos/ui` overlay registry (called automatically on plugin load via `register.ts`).
+- `trajectoryLoggerApp` / `TRAJECTORY_LOGGER_APP_NAME` — the `OverlayApp` definition and its name.
+- Types: `TrajectoryDetail`, `TrajectoryListItem`, `PhaseName`, `PhaseStatus`, `PhaseSummary`.
+
+The typed fetch helpers (`fetchTrajectoryList`, `fetchTrajectoryDetail`, `purgeTrajectory`, `fetchTrajectoryExport`) live in `src/api-client.ts` and are reachable via the `@elizaos/plugin-trajectory-logger/api-client` subpath, not the main entry. `fetchTrajectoryExport` returns the `/export` archive as a `Blob`.
+
+## Privacy
+
+Trajectory logging is controlled by the elizaOS runtime (see `ELIZA_DISABLE_TRAJECTORY_LOGGING=1` to disable). This plugin only reads and displays existing trajectory data — it does not write or enable logging on its own.

package/package.json

@@ -1,89 +1,76 @@
 {
   "name": "@elizaos/plugin-trajectory-logger",
-  "description": "Trajectory logging plugin for ElizaOS - capture agent interaction trajectories for RL training",
-  "version": "2.0.0-alpha.8",
+  "version": "2.0.11-beta.7",
   "type": "module",
-  "main": "dist/node/index.node.js",
-  "module": "dist/node/index.node.js",
-  "types": "dist/index.d.ts",
-  "packageType": "plugin",
-  "platform": "node",
-  "license": "MIT",
-  "author": "elizaOS",
-  "keywords": [
-    "plugin",
-    "elizaos",
-    "trajectory",
-    "rl",
-    "training",
-    "logging"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/elizaos/elizaos"
-  },
-  "homepage": "https://elizaos.ai",
+  "description": "Realtime trajectory inspector overlay app — surfaces the last completed and the in-flight trajectory with HANDLE / PLAN / ACTION / EVALUATE phase drilldowns.",
+  "main": "./dist/index.js",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
-      "node": {
-        "types": "./dist/index.d.ts",
-        "import": "./dist/node/index.node.js",
-        "default": "./dist/node/index.node.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "eliza-source": {
+        "types": "./src/plugin.ts",
+        "import": "./src/plugin.ts",
+        "default": "./src/plugin.ts"
       },
       "bun": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/node/index.node.js"
+        "types": "./src/plugin.ts",
+        "import": "./src/plugin.ts",
+        "default": "./src/plugin.ts"
       },
-      "default": "./dist/node/index.node.js"
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "sideEffects": false,
+  "scripts": {
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
+    "lint": "bunx @biomejs/biome check src",
+    "test": "bunx vitest run --config ./vitest.config.ts",
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "rm -rf dist",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json"
+  },
   "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
-    "uuid": "^13.0.0"
+    "@elizaos/app-core": "2.0.11-beta.7",
+    "@elizaos/core": "2.0.11-beta.7",
+    "@elizaos/ui": "2.0.11-beta.7",
+    "lucide-react": "^1.0.0"
   },
-  "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
-    "@types/bun": "^1.3.5",
-    "@types/node": "^25.0.3",
-    "@types/uuid": "^11.0.0",
-    "typescript": "^5.9.3"
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   },
-  "scripts": {
-    "dev": "bun --hot build.ts",
-    "clean": "rm -rf dist .turbo node_modules tsconfig.tsbuildinfo",
-    "format": "bunx @biomejs/biome format --write .",
-    "format:check": "bunx @biomejs/biome format .",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run tests/",
-    "test:unit": "vitest run tests/",
-    "test:watch": "vitest",
-    "lint": "bunx @biomejs/biome check --write --unsafe .",
-    "lint:check": "bunx @biomejs/biome check .",
-    "build": "bun run build.ts",
-    "build:ts": "bun run build.ts"
+  "elizaos": {
+    "app": {
+      "displayName": "Trajectory Logger",
+      "category": "developer",
+      "heroImage": "assets/hero.png"
+    }
   },
   "publishConfig": {
     "access": "public"
   },
-  "agentConfig": {
-    "pluginType": "elizaos:plugin:1.0.0",
-    "pluginParameters": {},
-    "description": "Collects complete agent interaction trajectories for RL training."
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "vite": "^8.0.0"
   },
-  "milady": {
-    "platforms": [
-      "node"
-    ],
-    "runtime": "node",
-    "platformDetails": {
-      "node": "Node.js only (platform: node)"
-    }
-  }
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }