@elizaos/plugin-todos 2.0.0-beta.1

package/dist/providers/current-todos.d.ts

@@ -0,0 +1,11 @@
+import { type Provider } from "@elizaos/core";
+/**
+ * Surface the user's current todo list to the planner each turn.
+ * Mirrors how Claude Code keeps the TodoWrite list in the model's context.
+ * Returns empty text when the user has no active todos.
+ *
+ * Scoping: by `entityId` (user) — todos persist across rooms for the same user.
+ * Pending + in_progress are always shown; completed/cancelled are excluded.
+ */
+export declare const currentTodosProvider: Provider;
+//# sourceMappingURL=current-todos.d.ts.map

package/dist/providers/current-todos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-todos.d.ts","sourceRoot":"","sources":["../../src/providers/current-todos.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EAGd,MAAM,eAAe,CAAC;AAsBvB;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,QA+BlC,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,70 @@
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import { type Todo, type TodoStatus } from "./types.js";
+export interface TodoFilter {
+    entityId: string;
+    agentId?: string;
+    roomId?: string | null;
+    status?: TodoStatus | TodoStatus[];
+    includeCompleted?: boolean;
+    limit?: number;
+}
+export interface CreateTodoInput {
+    entityId: string;
+    agentId: string;
+    roomId?: string | null;
+    worldId?: string | null;
+    content: string;
+    activeForm?: string;
+    status?: TodoStatus;
+    parentTodoId?: string | null;
+    parentTrajectoryStepId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateTodoInput {
+    content?: string;
+    activeForm?: string;
+    status?: TodoStatus;
+    parentTodoId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export declare class TodosService extends Service {
+    static readonly serviceType = "todos";
+    capabilityDescription: string;
+    private getDb;
+    static start(runtime: IAgentRuntime): Promise<TodosService>;
+    stop(): Promise<void>;
+    create(input: CreateTodoInput): Promise<Todo>;
+    get(id: string): Promise<Todo | null>;
+    list(filter: TodoFilter): Promise<Todo[]>;
+    update(id: string, patch: UpdateTodoInput): Promise<Todo | null>;
+    delete(id: string): Promise<boolean>;
+    /**
+     * Bulk-replace the user's todo list for a given (entityId, roomId) scope.
+     * Mirrors Claude Code's TodoWrite contract: the caller passes the full
+     * desired list, and the store reconciles. Existing rows are matched by id;
+     * absent rows are deleted; new rows are inserted.
+     */
+    writeList(args: {
+        entityId: string;
+        agentId: string;
+        roomId: string | null;
+        worldId: string | null;
+        parentTrajectoryStepId: string | null;
+        todos: Array<{
+            id?: string;
+            content: string;
+            status: TodoStatus;
+            activeForm?: string;
+        }>;
+    }): Promise<{
+        before: Todo[];
+        after: Todo[];
+    }>;
+    clear(filter: {
+        entityId: string;
+        agentId?: string;
+        roomId?: string | null;
+    }): Promise<number>;
+}
+export declare function getTodosService(runtime: IAgentRuntime): TodosService;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+export declare const TODOS_LOG_PREFIX = "[Todos]";
+export declare const TODOS_SERVICE_TYPE = "todos";
+export declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
+export type TodoStatus = (typeof TODO_STATUSES)[number];
+export declare const TODO_OPS: readonly ["write", "create", "update", "complete", "cancel", "delete", "list", "clear"];
+export type TodoOp = (typeof TODO_OPS)[number];
+export interface Todo {
+    id: string;
+    entityId: string;
+    agentId: string;
+    roomId: string | null;
+    worldId: string | null;
+    content: string;
+    activeForm: string;
+    status: TodoStatus;
+    parentTodoId: string | null;
+    parentTrajectoryStepId: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt: Date | null;
+}
+export interface TodoInput {
+    id?: string;
+    content: string;
+    status: TodoStatus;
+    activeForm?: string;
+    parentTodoId?: string | null;
+}
+export declare const TODOS_CONTEXTS: readonly ["tasks", "todos", "automation"];
+export type TodosContext = (typeof TODOS_CONTEXTS)[number];
+export declare const TODO_FAILURE_TEXT_PREFIX = "[Todos]";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,eAAO,MAAM,aAAa,+DAKhB,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,QAAQ,yFASX,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,2CAA4C,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,wBAAwB,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@elizaos/plugin-todos",
+  "version": "2.0.0-beta.1",
+  "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",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaos/eliza.git"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "eliza",
+    "plugin",
+    "todos",
+    "todo",
+    "tasks",
+    "agent"
+  ],
+  "author": "elizaOS",
+  "license": "MIT",
+  "dependencies": {
+    "@elizaos/core": "2.0.0-beta.1",
+    "drizzle-orm": "^0.45.1"
+  },
+  "peerDependencies": {
+    "@elizaos/plugin-sql": "2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "bun run build.ts",
+    "dev": "bun --hot build.ts",
+    "clean": "rm -rf dist .turbo",
+    "test": "vitest run",
+    "typecheck": "bunx tsc --noEmit -p tsconfig.json",
+    "lint": "echo \"Lint skipped\"",
+    "lint:check": "bun run lint",
+    "check": "bun run typecheck && bun run test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {}
+  },
+  "eliza": {
+    "platforms": [
+      "node"
+    ],
+    "runtime": "node",
+    "platformDetails": {
+      "node": "Default export (Node.js)"
+    }
+  }
+}