@elizaos/plugin-todos 2.0.0-beta.1 → 2.0.3-beta.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/README.md

@@ -0,0 +1,69 @@
+# @elizaos/plugin-todos
+
+User-scoped persistent todo list for Eliza agents.
+
+## What it does
+
+Gives an Eliza agent a durable, queryable todo list keyed per user (`entityId`). The agent can create, update, complete, cancel, delete, and bulk-replace todos through a single `TODO` action, and the user's active todos are automatically injected into the planner's context on every turn.
+
+Data is stored in a Postgres table (`pgSchema("todos")`) via drizzle-orm; the plugin requires `@elizaos/plugin-sql` to supply the DB connection.
+
+## Capabilities
+
+### Action: `TODO`
+
+A single umbrella action that dispatches on the `action` (or `op`) parameter:
+
+| op | what it does |
+|---|---|
+| `create` | Add one todo (`content` required; `status` defaults to `pending`) |
+| `write` | Bulk-replace the user's entire list with the provided `todos` array |
+| `update` | Patch a todo by `id` (content, status, activeForm, parentTodoId) |
+| `complete` | Set status → `completed` by `id` |
+| `cancel` | Set status → `cancelled` by `id` |
+| `delete` | Remove a todo by `id` |
+| `list` | Return todos (pending + in-progress by default; pass `includeCompleted: true` for all) |
+| `clear` | Delete all todos for the current user/agent/room |
+
+Todos have an optional `activeForm` field (present-continuous string, e.g. "Adding tests") and support a `parentTodoId` for sub-tasks.
+
+### Provider: `CURRENT_TODOS`
+
+Injected at position `-5` on every planner turn (in the `tasks`, `todos`, and `automation` contexts). Shows pending and in-progress todos as a markdown checklist so the agent always knows what is outstanding.
+
+## Requirements
+
+- `@elizaos/plugin-sql` must be loaded before this plugin (provides `runtime.db`).
+- The agent entity must have at minimum the `ADMIN` role for the `TODO` action to fire.
+
+## Enabling the plugin
+
+Add `@elizaos/plugin-todos` to the agent's plugin list in your character configuration:
+
+```json
+{
+  "plugins": ["@elizaos/plugin-sql", "@elizaos/plugin-todos"]
+}
+```
+
+## Environment variables
+
+| Variable | Effect | Required |
+|---|---|---|
+| `ELIZA_PARENT_TRAJECTORY_STEP_ID` | Attached to new todos as `parentTrajectoryStepId` for trajectory linking | No |
+
+## Exported API
+
+```ts
+import {
+  todosPlugin,          // default Plugin export
+  todoAction,           // the TODO action
+  currentTodosProvider, // the CURRENT_TODOS provider
+  TodosService,         // the drizzle-backed service class
+  getTodosService,      // helper: runtime → TodosService (throws if missing)
+  todosSchema,          // drizzle pgSchema
+  todosTable,           // drizzle table
+} from "@elizaos/plugin-todos";
+```
+
+Key types: `Todo`, `TodoStatus`, `TodoActionName`, `CreateTodoInput`, `UpdateTodoInput`, `TodoFilter`, `TodoRow`, `TodoInsert`.

package/assets/hero.svg

@@ -0,0 +1,67 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" width="1024" height="1024" role="img" aria-label="Todos">
+  <defs>
+    <linearGradient id="bg-todos" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#282615"/>
+      <stop offset="1" stop-color="#18190b"/>
+    </linearGradient>
+    <radialGradient id="blobA-todos" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#dac32f" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#dac32f" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="blobB-todos" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#8fc328" stop-opacity="0.5"/>
+      <stop offset="1" stop-color="#8fc328" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="vig-todos" cx="0.5" cy="0.42" r="0.75">
+      <stop offset="0" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="0.72" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="1" stop-color="#000000" stop-opacity="0.5"/>
+    </radialGradient>
+    <linearGradient id="label-todos" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="1" stop-color="#000000" stop-opacity="0.55"/>
+    </linearGradient>
+    <filter id="soft-todos" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="46"/>
+    </filter>
+    <filter id="iglow-todos" x="-40%" y="-40%" width="180%" height="180%">
+      <feDropShadow dx="0" dy="0" stdDeviation="14" flood-color="#edd645" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+
+  <rect width="1024" height="1024" fill="url(#bg-todos)"/>
+
+  <g opacity="0.9">
+    <circle cx="232" cy="220" r="300" fill="url(#blobA-todos)" filter="url(#soft-todos)"/>
+    <circle cx="840" cy="800" r="340" fill="url(#blobB-todos)" filter="url(#soft-todos)"/>
+  </g>
+
+  <g stroke="#eae7d7" stroke-width="1.4" opacity="0.06">
+    <line x1="0" y1="256" x2="1024" y2="256"/>
+    <line x1="0" y1="512" x2="1024" y2="512"/>
+    <line x1="0" y1="768" x2="1024" y2="768"/>
+    <line x1="256" y1="0" x2="256" y2="1024"/>
+    <line x1="512" y1="0" x2="512" y2="1024"/>
+    <line x1="768" y1="0" x2="768" y2="1024"/>
+  </g>
+
+  <g opacity="0.5">
+    <path d="M120 470 A 400 400 0 0 1 904 470" fill="none" stroke="#edd645" stroke-width="3" opacity="0.35"/>
+  </g>
+
+  <g transform="translate(512 432)" filter="url(#iglow-todos)"
+     color="#eae7d7" stroke="#eae7d7" stroke-width="20"
+     stroke-linecap="round" stroke-linejoin="round" fill="none">
+    <rect x="-150" y="-150" width="300" height="300" rx="36"/>
+    <polyline points="-92,-6 -36,52 92,-78" fill="none"/>
+  </g>
+
+  <rect x="0" y="784" width="1024" height="240" fill="url(#label-todos)"/>
+  <text x="512" y="892" text-anchor="middle"
+        font-family="system-ui, -apple-system, Segoe UI, Roboto, sans-serif"
+        font-size="76" font-weight="600" letter-spacing="0.5"
+        fill="#eae7d7">Todos</text>
+  <rect x="460" y="924" width="104" height="6" rx="3" fill="#edd645"/>
+
+  <rect width="1024" height="1024" fill="url(#vig-todos)"/>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-todos",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.2",
   "description": "User-scoped persistent todos with CRUD. Single TODO umbrella action (op-based: write/create/update/complete/cancel/delete/list/clear) and a currentTodosProvider that surfaces the user's pending + in-progress todos to the planner each turn. Backed by drizzle pgSchema('todos').",
   "type": "module",
   "main": "dist/index.js",
@@ -15,11 +15,28 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
+    "assets",
     "dist"
   ],
   "keywords": [
@@ -33,23 +50,39 @@
   "author": "elizaOS",
   "license": "MIT",
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
-    "drizzle-orm": "^0.45.1"
+    "@elizaos/agent": "2.0.3-beta.2",
+    "@elizaos/app-core": "2.0.3-beta.2",
+    "@elizaos/core": "2.0.3-beta.2",
+    "@elizaos/shared": "2.0.3-beta.2",
+    "@elizaos/ui": "2.0.3-beta.2",
+    "drizzle-orm": "^0.45.1",
+    "lucide-react": "^1.0.0"
   },
   "peerDependencies": {
-    "@elizaos/plugin-sql": "2.0.0-beta.1"
+    "@elizaos/plugin-sql": "2.0.3-beta.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.5.1",
     "typescript": "^6.0.3",
+    "vite": "^8.0.0",
     "vitest": "^4.0.0"
   },
   "scripts": {
-    "build": "bun run build.ts",
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "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",
     "dev": "bun --hot build.ts",
     "clean": "rm -rf dist .turbo",
     "test": "vitest run",
-    "typecheck": "bunx tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
     "lint": "echo \"Lint skipped\"",
     "lint:check": "bun run lint",
     "check": "bun run typecheck && bun run test"
@@ -61,6 +94,12 @@
     "pluginType": "elizaos:plugin:1.0.0",
     "pluginParameters": {}
   },
+  "elizaos": {
+    "app": {
+      "displayName": "Todos",
+      "category": "productivity"
+    }
+  },
   "eliza": {
     "platforms": [
       "node"
@@ -69,5 +108,6 @@
     "platformDetails": {
       "node": "Default export (Node.js)"
     }
-  }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
 }

package/dist/actions/todo.d.ts

@@ -1,3 +0,0 @@
-import { type Action } from "@elizaos/core";
-export declare const todoAction: Action;
-//# sourceMappingURL=todo.d.ts.map

package/dist/actions/todo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../src/actions/todo.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAOZ,MAAM,eAAe,CAAC;AA2ZvB,eAAO,MAAM,UAAU,EAAE,MA6MxB,CAAC"}

package/dist/db/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./schema.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/db/schema.d.ts

@@ -1,249 +0,0 @@
-export declare const todosSchema: import("drizzle-orm/pg-core").PgSchema<"todos">;
-export declare const todosTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "todos";
-    schema: "todos";
-    columns: {
-        id: import("drizzle-orm/pg-core").PgColumn<{
-            name: "id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        agentId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "agent_id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        entityId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "entity_id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        roomId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "room_id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        worldId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "world_id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        content: import("drizzle-orm/pg-core").PgColumn<{
-            name: "content";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        activeForm: import("drizzle-orm/pg-core").PgColumn<{
-            name: "active_form";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        status: import("drizzle-orm/pg-core").PgColumn<{
-            name: "status";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        parentTodoId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "parent_todo_id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        parentTrajectoryStepId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "parent_trajectory_step_id";
-            tableName: "todos";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        metadata: import("drizzle-orm/pg-core").PgColumn<{
-            name: "metadata";
-            tableName: "todos";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        createdAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "todos";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "updated_at";
-            tableName: "todos";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        completedAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "completed_at";
-            tableName: "todos";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-export type TodoRow = typeof todosTable.$inferSelect;
-export type TodoInsert = typeof todosTable.$inferInsert;
-//# sourceMappingURL=schema.d.ts.map

package/dist/db/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW,iDAAoB,CAAC;AAE7C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCtB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC"}

package/dist/index.d.ts

@@ -1,9 +0,0 @@
-import type { Plugin } from "@elizaos/core";
-export declare const todosPlugin: Plugin;
-export default todosPlugin;
-export { todoAction } from "./actions/todo.js";
-export { currentTodosProvider } from "./providers/current-todos.js";
-export { type CreateTodoInput, type TodoFilter, type UpdateTodoInput, TodosService, getTodosService, } from "./service.js";
-export { type TodoRow, type TodoInsert, todosSchema, todosTable, } from "./db/schema.js";
-export * from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAO5C,eAAO,MAAM,WAAW,EAAE,MASzB,CAAC;AAEF,eAAe,WAAW,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,cAAc,YAAY,CAAC"}