@elizaos/plugin-todos 2.0.3-beta.5 → 2.0.3-beta.7

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

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

package/dist/db/schema.js

@@ -0,0 +1,45 @@
+import { sql } from "drizzle-orm";
+import {
+  index,
+  jsonb,
+  pgSchema,
+  text,
+  timestamp,
+  uuid
+} from "drizzle-orm/pg-core";
+const todosSchema = pgSchema("todos");
+const todosTable = todosSchema.table(
+  "todos",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    agentId: uuid("agent_id").notNull(),
+    entityId: uuid("entity_id").notNull(),
+    roomId: uuid("room_id"),
+    worldId: uuid("world_id"),
+    content: text("content").notNull(),
+    activeForm: text("active_form").notNull(),
+    status: text("status").notNull(),
+    parentTodoId: uuid("parent_todo_id"),
+    parentTrajectoryStepId: text("parent_trajectory_step_id"),
+    metadata: jsonb("metadata").default("{}").notNull(),
+    createdAt: timestamp("created_at").default(sql`now()`).notNull(),
+    updatedAt: timestamp("updated_at").default(sql`now()`).notNull(),
+    completedAt: timestamp("completed_at")
+  },
+  (table) => ({
+    entityStatusIdx: index("idx_todos_entity_status").on(
+      table.entityId,
+      table.status
+    ),
+    agentEntityIdx: index("idx_todos_agent_entity").on(
+      table.agentId,
+      table.entityId
+    ),
+    roomIdx: index("idx_todos_room").on(table.roomId)
+  })
+);
+export {
+  todosSchema,
+  todosTable
+};
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/schema.ts"],"sourcesContent":["import { sql } from \"drizzle-orm\";\nimport {\n  index,\n  jsonb,\n  pgSchema,\n  text,\n  timestamp,\n  uuid,\n} from \"drizzle-orm/pg-core\";\n\nexport const todosSchema = pgSchema(\"todos\");\n\nexport const todosTable = todosSchema.table(\n  \"todos\",\n  {\n    id: uuid(\"id\").primaryKey().defaultRandom(),\n    agentId: uuid(\"agent_id\").notNull(),\n    entityId: uuid(\"entity_id\").notNull(),\n    roomId: uuid(\"room_id\"),\n    worldId: uuid(\"world_id\"),\n    content: text(\"content\").notNull(),\n    activeForm: text(\"active_form\").notNull(),\n    status: text(\"status\").notNull(),\n    parentTodoId: uuid(\"parent_todo_id\"),\n    parentTrajectoryStepId: text(\"parent_trajectory_step_id\"),\n    metadata: jsonb(\"metadata\").default(\"{}\").notNull(),\n    createdAt: timestamp(\"created_at\").default(sql`now()`).notNull(),\n    updatedAt: timestamp(\"updated_at\").default(sql`now()`).notNull(),\n    completedAt: timestamp(\"completed_at\"),\n  },\n  (table) => ({\n    entityStatusIdx: index(\"idx_todos_entity_status\").on(\n      table.entityId,\n      table.status,\n    ),\n    agentEntityIdx: index(\"idx_todos_agent_entity\").on(\n      table.agentId,\n      table.entityId,\n    ),\n    roomIdx: index(\"idx_todos_room\").on(table.roomId),\n  }),\n);\n\nexport type TodoRow = typeof todosTable.$inferSelect;\nexport type TodoInsert = typeof todosTable.$inferInsert;\n"],"mappings":"AAAA,SAAS,WAAW;AACpB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,cAAc,SAAS,OAAO;AAEpC,MAAM,aAAa,YAAY;AAAA,EACpC;AAAA,EACA;AAAA,IACE,IAAI,KAAK,IAAI,EAAE,WAAW,EAAE,cAAc;AAAA,IAC1C,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA,IAClC,UAAU,KAAK,WAAW,EAAE,QAAQ;AAAA,IACpC,QAAQ,KAAK,SAAS;AAAA,IACtB,SAAS,KAAK,UAAU;AAAA,IACxB,SAAS,KAAK,SAAS,EAAE,QAAQ;AAAA,IACjC,YAAY,KAAK,aAAa,EAAE,QAAQ;AAAA,IACxC,QAAQ,KAAK,QAAQ,EAAE,QAAQ;AAAA,IAC/B,cAAc,KAAK,gBAAgB;AAAA,IACnC,wBAAwB,KAAK,2BAA2B;AAAA,IACxD,UAAU,MAAM,UAAU,EAAE,QAAQ,IAAI,EAAE,QAAQ;AAAA,IAClD,WAAW,UAAU,YAAY,EAAE,QAAQ,UAAU,EAAE,QAAQ;AAAA,IAC/D,WAAW,UAAU,YAAY,EAAE,QAAQ,UAAU,EAAE,QAAQ;AAAA,IAC/D,aAAa,UAAU,cAAc;AAAA,EACvC;AAAA,EACA,CAAC,WAAW;AAAA,IACV,iBAAiB,MAAM,yBAAyB,EAAE;AAAA,MAChD,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,gBAAgB,MAAM,wBAAwB,EAAE;AAAA,MAC9C,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,SAAS,MAAM,gBAAgB,EAAE,GAAG,MAAM,MAAM;AAAA,EAClD;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin } from "@elizaos/core";
+export declare const todosPlugin: Plugin;
+export default todosPlugin;
+export { todoAction } from "./actions/todo.js";
+export { type TodoInsert, type TodoRow, todosSchema, todosTable, } from "./db/schema.js";
+export { currentTodosProvider } from "./providers/current-todos.js";
+export { type CreateTodoInput, getTodosService, type TodoFilter, TodosService, type UpdateTodoInput, } from "./service.js";
+export * from "./types.js";
+export { TodosView } from "./components/todos/TodosView.js";
+export { type LaneId, type TodoCard, type TodosSnapshot, TodosSpatialView, type TodosViewState, } from "./components/todos/TodosSpatialView.js";
+export { registerTodosTerminalView, setTodosTerminalSnapshot, } from "./register-terminal-view.js";
+import "./register.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"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,MA4BzB,CAAC;AAEF,eAAe,WAAW,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EACL,KAAK,eAAe,EACpB,eAAe,EACf,KAAK,UAAU,EACf,YAAY,EACZ,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EACL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,68 @@
+import { todoAction } from "./actions/todo.js";
+import * as dbSchema from "./db/index.js";
+import { currentTodosProvider } from "./providers/current-todos.js";
+import { TodosService } from "./service.js";
+const todosPlugin = {
+  name: "todos",
+  description: "User-scoped persistent todos with CRUD. Single `TODO` umbrella action with action-based dispatch (write/create/update/complete/cancel/delete/list/clear). The currentTodosProvider surfaces the user's pending + in-progress todos to the planner each turn. Backed by a drizzle pgSchema('todos') table; requires @elizaos/plugin-sql.",
+  dependencies: ["@elizaos/plugin-sql"],
+  actions: [todoAction],
+  providers: [currentTodosProvider],
+  services: [TodosService],
+  schema: dbSchema,
+  views: [
+    {
+      id: "todos",
+      label: "Todos",
+      description: "Three-lane todo board: Today / Upcoming / Someday",
+      icon: "ListChecks",
+      path: "/todos",
+      modalities: ["gui", "xr", "tui"],
+      bundlePath: "dist/views/bundle.js",
+      componentExport: "TodosView",
+      tags: ["todos", "tasks", "productivity"],
+      visibleInManager: true,
+      desktopTabEnabled: true
+    }
+  ],
+  async dispose(runtime) {
+    const svc = runtime.getService(TodosService.serviceType);
+    await svc?.stop();
+  }
+};
+var index_default = todosPlugin;
+import { todoAction as todoAction2 } from "./actions/todo.js";
+import {
+  todosSchema,
+  todosTable
+} from "./db/schema.js";
+import { currentTodosProvider as currentTodosProvider2 } from "./providers/current-todos.js";
+import {
+  getTodosService,
+  TodosService as TodosService2
+} from "./service.js";
+export * from "./types.js";
+import { TodosView } from "./components/todos/TodosView.js";
+import {
+  TodosSpatialView
+} from "./components/todos/TodosSpatialView.js";
+import {
+  registerTodosTerminalView,
+  setTodosTerminalSnapshot
+} from "./register-terminal-view.js";
+import "./register.js";
+export {
+  TodosService2 as TodosService,
+  TodosSpatialView,
+  TodosView,
+  currentTodosProvider2 as currentTodosProvider,
+  index_default as default,
+  getTodosService,
+  registerTodosTerminalView,
+  setTodosTerminalSnapshot,
+  todoAction2 as todoAction,
+  todosPlugin,
+  todosSchema,
+  todosTable
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Plugin } from \"@elizaos/core\";\n\nimport { todoAction } from \"./actions/todo.js\";\nimport * as dbSchema from \"./db/index.js\";\nimport { currentTodosProvider } from \"./providers/current-todos.js\";\nimport { TodosService } from \"./service.js\";\n\nexport const todosPlugin: Plugin = {\n  name: \"todos\",\n  description:\n    \"User-scoped persistent todos with CRUD. Single `TODO` umbrella action with action-based dispatch (write/create/update/complete/cancel/delete/list/clear). The currentTodosProvider surfaces the user's pending + in-progress todos to the planner each turn. Backed by a drizzle pgSchema('todos') table; requires @elizaos/plugin-sql.\",\n  dependencies: [\"@elizaos/plugin-sql\"],\n  actions: [todoAction],\n  providers: [currentTodosProvider],\n  services: [TodosService],\n  schema: dbSchema,\n  views: [\n    {\n      id: \"todos\",\n      label: \"Todos\",\n      description: \"Three-lane todo board: Today / Upcoming / Someday\",\n      icon: \"ListChecks\",\n      path: \"/todos\",\n      modalities: [\"gui\", \"xr\", \"tui\"],\n      bundlePath: \"dist/views/bundle.js\",\n      componentExport: \"TodosView\",\n      tags: [\"todos\", \"tasks\", \"productivity\"],\n      visibleInManager: true,\n      desktopTabEnabled: true,\n    },\n  ],\n  async dispose(runtime) {\n    const svc = runtime.getService<TodosService>(TodosService.serviceType);\n    await svc?.stop();\n  },\n};\n\nexport default todosPlugin;\n\nexport { todoAction } from \"./actions/todo.js\";\nexport {\n  type TodoInsert,\n  type TodoRow,\n  todosSchema,\n  todosTable,\n} from \"./db/schema.js\";\nexport { currentTodosProvider } from \"./providers/current-todos.js\";\nexport {\n  type CreateTodoInput,\n  getTodosService,\n  type TodoFilter,\n  TodosService,\n  type UpdateTodoInput,\n} from \"./service.js\";\nexport * from \"./types.js\";\n\nexport { TodosView } from \"./components/todos/TodosView.js\";\nexport {\n  type LaneId,\n  type TodoCard,\n  type TodosSnapshot,\n  TodosSpatialView,\n  type TodosViewState,\n} from \"./components/todos/TodosSpatialView.js\";\nexport {\n  registerTodosTerminalView,\n  setTodosTerminalSnapshot,\n} from \"./register-terminal-view.js\";\n\n// Side-effect: in a terminal host (Node agent, no DOM) this registers the todos\n// terminal view. DOM-guarded so the terminal engine stays out of browser bundles.\nimport \"./register.js\";\n"],"mappings":"AAEA,SAAS,kBAAkB;AAC3B,YAAY,cAAc;AAC1B,SAAS,4BAA4B;AACrC,SAAS,oBAAoB;AAEtB,MAAM,cAAsB;AAAA,EACjC,MAAM;AAAA,EACN,aACE;AAAA,EACF,cAAc,CAAC,qBAAqB;AAAA,EACpC,SAAS,CAAC,UAAU;AAAA,EACpB,WAAW,CAAC,oBAAoB;AAAA,EAChC,UAAU,CAAC,YAAY;AAAA,EACvB,QAAQ;AAAA,EACR,OAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aAAa;AAAA,MACb,MAAM;AAAA,MACN,MAAM;AAAA,MACN,YAAY,CAAC,OAAO,MAAM,KAAK;AAAA,MAC/B,YAAY;AAAA,MACZ,iBAAiB;AAAA,MACjB,MAAM,CAAC,SAAS,SAAS,cAAc;AAAA,MACvC,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,IACrB;AAAA,EACF;AAAA,EACA,MAAM,QAAQ,SAAS;AACrB,UAAM,MAAM,QAAQ,WAAyB,aAAa,WAAW;AACrE,UAAM,KAAK,KAAK;AAAA,EAClB;AACF;AAEA,IAAO,gBAAQ;AAEf,SAAS,cAAAA,mBAAkB;AAC3B;AAAA,EAGE;AAAA,EACA;AAAA,OACK;AACP,SAAS,wBAAAC,6BAA4B;AACrC;AAAA,EAEE;AAAA,EAEA,gBAAAC;AAAA,OAEK;AACP,cAAc;AAEd,SAAS,iBAAiB;AAC1B;AAAA,EAIE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAIP,OAAO;","names":["todoAction","currentTodosProvider","TodosService"]}

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,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAkBvB;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,QA+BlC,CAAC"}

package/dist/providers/current-todos.js

@@ -0,0 +1,45 @@
+import { TODOS_CONTEXTS, TODOS_SERVICE_TYPE } from "../types.js";
+function checkboxFor(status) {
+  switch (status) {
+    case "completed":
+      return "[x]";
+    case "in_progress":
+      return "[\u2192]";
+    case "cancelled":
+      return "[-]";
+    default:
+      return "[ ]";
+  }
+}
+const currentTodosProvider = {
+  name: "CURRENT_TODOS",
+  description: "The user's current pending and in-progress todos.",
+  position: -5,
+  contexts: [...TODOS_CONTEXTS],
+  contextGate: { anyOf: [...TODOS_CONTEXTS] },
+  get: async (runtime, message, _state) => {
+    const entityId = message.entityId;
+    if (!entityId) return { text: "", data: { todos: [] } };
+    const service = runtime.getService(TODOS_SERVICE_TYPE);
+    if (!service) return { text: "", data: { todos: [] } };
+    const todos = await service.list({
+      entityId: String(entityId),
+      agentId: String(runtime.agentId),
+      includeCompleted: false
+    });
+    if (todos.length === 0) return { text: "", data: { todos: [] } };
+    const lines = [
+      "# Current todos",
+      "",
+      ...todos.map((t) => `- ${checkboxFor(t.status)} ${t.content}`)
+    ];
+    return {
+      text: lines.join("\n"),
+      data: { todos }
+    };
+  }
+};
+export {
+  currentTodosProvider
+};
+//# sourceMappingURL=current-todos.js.map

package/dist/providers/current-todos.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/current-todos.ts"],"sourcesContent":["import type {\n  IAgentRuntime,\n  Memory,\n  Provider,\n  ProviderResult,\n  State,\n} from \"@elizaos/core\";\n\nimport type { TodosService } from \"../service.js\";\nimport { TODOS_CONTEXTS, TODOS_SERVICE_TYPE, type Todo } from \"../types.js\";\n\nfunction checkboxFor(status: Todo[\"status\"]): string {\n  switch (status) {\n    case \"completed\":\n      return \"[x]\";\n    case \"in_progress\":\n      return \"[→]\";\n    case \"cancelled\":\n      return \"[-]\";\n    default:\n      return \"[ ]\";\n  }\n}\n\n/**\n * Surface the user's current todo list to the planner each turn.\n * Mirrors how Claude Code keeps the TodoWrite list in the model's context.\n * Returns empty text when the user has no active todos.\n *\n * Scoping: by `entityId` (user) — todos persist across rooms for the same user.\n * Pending + in_progress are always shown; completed/cancelled are excluded.\n */\nexport const currentTodosProvider: Provider = {\n  name: \"CURRENT_TODOS\",\n  description: \"The user's current pending and in-progress todos.\",\n  position: -5,\n  contexts: [...TODOS_CONTEXTS],\n  contextGate: { anyOf: [...TODOS_CONTEXTS] },\n  get: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state?: State,\n  ): Promise<ProviderResult> => {\n    const entityId = message.entityId;\n    if (!entityId) return { text: \"\", data: { todos: [] } };\n    const service = runtime.getService<TodosService>(TODOS_SERVICE_TYPE);\n    if (!service) return { text: \"\", data: { todos: [] } };\n    const todos = await service.list({\n      entityId: String(entityId),\n      agentId: String(runtime.agentId),\n      includeCompleted: false,\n    });\n    if (todos.length === 0) return { text: \"\", data: { todos: [] } };\n    const lines = [\n      \"# Current todos\",\n      \"\",\n      ...todos.map((t) => `- ${checkboxFor(t.status)} ${t.content}`),\n    ];\n    return {\n      text: lines.join(\"\\n\"),\n      data: { todos },\n    };\n  },\n};\n"],"mappings":"AASA,SAAS,gBAAgB,0BAAqC;AAE9D,SAAS,YAAY,QAAgC;AACnD,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAUO,MAAM,uBAAiC;AAAA,EAC5C,MAAM;AAAA,EACN,aAAa;AAAA,EACb,UAAU;AAAA,EACV,UAAU,CAAC,GAAG,cAAc;AAAA,EAC5B,aAAa,EAAE,OAAO,CAAC,GAAG,cAAc,EAAE;AAAA,EAC1C,KAAK,OACH,SACA,SACA,WAC4B;AAC5B,UAAM,WAAW,QAAQ;AACzB,QAAI,CAAC,SAAU,QAAO,EAAE,MAAM,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE;AACtD,UAAM,UAAU,QAAQ,WAAyB,kBAAkB;AACnE,QAAI,CAAC,QAAS,QAAO,EAAE,MAAM,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE;AACrD,UAAM,QAAQ,MAAM,QAAQ,KAAK;AAAA,MAC/B,UAAU,OAAO,QAAQ;AAAA,MACzB,SAAS,OAAO,QAAQ,OAAO;AAAA,MAC/B,kBAAkB;AAAA,IACpB,CAAC;AACD,QAAI,MAAM,WAAW,EAAG,QAAO,EAAE,MAAM,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE;AAC/D,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA;AAAA,MACA,GAAG,MAAM,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE;AAAA,IAC/D;AACA,WAAO;AAAA,MACL,MAAM,MAAM,KAAK,IAAI;AAAA,MACrB,MAAM,EAAE,MAAM;AAAA,IAChB;AAAA,EACF;AACF;","names":[]}

package/dist/register-terminal-view.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Register the todos view for terminal rendering.
+ *
+ * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal
+ * registry. This makes the todos `tui` modality render for real in the terminal
+ * (the unified {@link TodosSpatialView}) rather than only navigating a GUI
+ * shell. A module-level snapshot lets a host push live board data; absent a
+ * push it defaults to the loading state.
+ */
+import { type TodosSnapshot } from "./components/todos/TodosSpatialView.tsx";
+/** Update the snapshot the registered terminal view renders from. */
+export declare function setTodosTerminalSnapshot(next: TodosSnapshot): void;
+/** Register the todos terminal view; returns an unregister function. */
+export declare function registerTodosTerminalView(): () => void;
+//# sourceMappingURL=register-terminal-view.d.ts.map

package/dist/register-terminal-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-terminal-view.d.ts","sourceRoot":"","sources":["../src/register-terminal-view.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,yCAAyC,CAAC;AASjD,qEAAqE;AACrE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAElE;AAED,wEAAwE;AACxE,wBAAgB,yBAAyB,IAAI,MAAM,IAAI,CAItD"}

package/dist/register-terminal-view.js

@@ -0,0 +1,26 @@
+import { registerSpatialTerminalView } from "@elizaos/ui/spatial/tui";
+import { createElement } from "react";
+import {
+  EMPTY_LANES,
+  TodosSpatialView
+} from "./components/todos/TodosSpatialView.js";
+const EMPTY = {
+  state: "loading",
+  lanes: EMPTY_LANES,
+  overdue: 0
+};
+let current = EMPTY;
+function setTodosTerminalSnapshot(next) {
+  current = next;
+}
+function registerTodosTerminalView() {
+  return registerSpatialTerminalView(
+    "todos",
+    () => createElement(TodosSpatialView, { snapshot: current })
+  );
+}
+export {
+  registerTodosTerminalView,
+  setTodosTerminalSnapshot
+};
+//# sourceMappingURL=register-terminal-view.js.map

package/dist/register-terminal-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register-terminal-view.tsx"],"sourcesContent":["/**\n * Register the todos view for terminal rendering.\n *\n * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal\n * registry. This makes the todos `tui` modality render for real in the terminal\n * (the unified {@link TodosSpatialView}) rather than only navigating a GUI\n * shell. A module-level snapshot lets a host push live board data; absent a\n * push it defaults to the loading state.\n */\n\nimport { registerSpatialTerminalView } from \"@elizaos/ui/spatial/tui\";\nimport { createElement } from \"react\";\nimport {\n  EMPTY_LANES,\n  type TodosSnapshot,\n  TodosSpatialView,\n} from \"./components/todos/TodosSpatialView.js\";\n\nconst EMPTY: TodosSnapshot = {\n  state: \"loading\",\n  lanes: EMPTY_LANES,\n  overdue: 0,\n};\nlet current: TodosSnapshot = EMPTY;\n\n/** Update the snapshot the registered terminal view renders from. */\nexport function setTodosTerminalSnapshot(next: TodosSnapshot): void {\n  current = next;\n}\n\n/** Register the todos terminal view; returns an unregister function. */\nexport function registerTodosTerminalView(): () => void {\n  return registerSpatialTerminalView(\"todos\", () =>\n    createElement(TodosSpatialView, { snapshot: current }),\n  );\n}\n"],"mappings":"AAUA,SAAS,mCAAmC;AAC5C,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AAEP,MAAM,QAAuB;AAAA,EAC3B,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AACX;AACA,IAAI,UAAyB;AAGtB,SAAS,yBAAyB,MAA2B;AAClE,YAAU;AACZ;AAGO,SAAS,4BAAwC;AACtD,SAAO;AAAA,IAA4B;AAAA,IAAS,MAC1C,cAAc,kBAAkB,EAAE,UAAU,QAAQ,CAAC;AAAA,EACvD;AACF;","names":[]}

package/dist/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Side-effect entry point — registers the Todos view for terminal rendering.
+ *
+ * In a terminal host (the Node agent, no DOM), register the todos view so it
+ * renders inline in the terminal. Lazy + DOM-guarded so the terminal engine
+ * stays out of browser/mobile bundles. Web, iOS, desktop, and Android leave
+ * this a no-op (a DOM is present), so the same import is safe everywhere.
+ */
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/register.js

@@ -0,0 +1,5 @@
+if (typeof window === "undefined") {
+  void import("./register-terminal-view.js").then((m) => m.registerTodosTerminalView()).catch(() => {
+  });
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts"],"sourcesContent":["/**\n * Side-effect entry point — registers the Todos view for terminal rendering.\n *\n * In a terminal host (the Node agent, no DOM), register the todos view so it\n * renders inline in the terminal. Lazy + DOM-guarded so the terminal engine\n * stays out of browser/mobile bundles. Web, iOS, desktop, and Android leave\n * this a no-op (a DOM is present), so the same import is safe everywhere.\n */\n\nif (typeof window === \"undefined\") {\n  void import(\"./register-terminal-view.js\")\n    .then((m) => m.registerTodosTerminalView())\n    .catch(() => {\n      // Terminal rendering is best-effort; never block plugin load.\n    });\n}\n"],"mappings":"AASA,IAAI,OAAO,WAAW,aAAa;AACjC,OAAK,OAAO,6BAA6B,EACtC,KAAK,CAAC,MAAM,EAAE,0BAA0B,CAAC,EACzC,MAAM,MAAM;AAAA,EAEb,CAAC;AACL;","names":[]}

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/service.js

@@ -0,0 +1,189 @@
+import { logger, Service } from "@elizaos/core";
+import { and, desc, eq, inArray } from "drizzle-orm";
+import { todosTable } from "./db/schema.js";
+import {
+  TODOS_LOG_PREFIX,
+  TODOS_SERVICE_TYPE
+} from "./types.js";
+function rowToTodo(row) {
+  const metadata = row.metadata && typeof row.metadata === "object" && !Array.isArray(row.metadata) ? row.metadata : {};
+  return {
+    id: row.id,
+    entityId: row.entityId,
+    agentId: row.agentId,
+    roomId: row.roomId ?? null,
+    worldId: row.worldId ?? null,
+    content: row.content,
+    activeForm: row.activeForm,
+    status: row.status,
+    parentTodoId: row.parentTodoId ?? null,
+    parentTrajectoryStepId: row.parentTrajectoryStepId ?? null,
+    metadata,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt,
+    completedAt: row.completedAt ?? null
+  };
+}
+class TodosService extends Service {
+  static serviceType = TODOS_SERVICE_TYPE;
+  capabilityDescription = "User-scoped todo CRUD. Persistent (drizzle/postgres), keyed by (agentId, entityId).";
+  getDb() {
+    const db = this.runtime.db;
+    if (!db) {
+      throw new Error(
+        `${TODOS_LOG_PREFIX} runtime.db is not available \u2014 @elizaos/plugin-sql must be installed and initialized.`
+      );
+    }
+    return db;
+  }
+  static async start(runtime) {
+    logger.info(`${TODOS_LOG_PREFIX} starting TodosService`);
+    return new TodosService(runtime);
+  }
+  async stop() {
+    logger.info(`${TODOS_LOG_PREFIX} stopping TodosService`);
+  }
+  async create(input) {
+    const db = this.getDb();
+    const [row] = await db.insert(todosTable).values({
+      agentId: input.agentId,
+      entityId: input.entityId,
+      roomId: input.roomId ?? null,
+      worldId: input.worldId ?? null,
+      content: input.content,
+      activeForm: input.activeForm ?? input.content,
+      status: input.status ?? "pending",
+      parentTodoId: input.parentTodoId ?? null,
+      parentTrajectoryStepId: input.parentTrajectoryStepId ?? null,
+      metadata: input.metadata ?? {}
+    }).returning();
+    if (!row) throw new Error(`${TODOS_LOG_PREFIX} insert returned no row`);
+    return rowToTodo(row);
+  }
+  async get(id) {
+    const db = this.getDb();
+    const [row] = await db.select().from(todosTable).where(eq(todosTable.id, id)).limit(1);
+    return row ? rowToTodo(row) : null;
+  }
+  async list(filter) {
+    const db = this.getDb();
+    const conditions = [eq(todosTable.entityId, filter.entityId)];
+    if (filter.agentId) {
+      conditions.push(eq(todosTable.agentId, filter.agentId));
+    }
+    if (filter.roomId !== void 0 && filter.roomId !== null) {
+      conditions.push(eq(todosTable.roomId, filter.roomId));
+    }
+    if (filter.status) {
+      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+      conditions.push(inArray(todosTable.status, statuses));
+    } else if (filter.includeCompleted === false) {
+      conditions.push(
+        inArray(todosTable.status, ["pending", "in_progress"])
+      );
+    }
+    const query = db.select().from(todosTable).where(and(...conditions)).orderBy(desc(todosTable.updatedAt));
+    const rows = filter.limit ? await query.limit(filter.limit) : await query;
+    return rows.map(rowToTodo);
+  }
+  async update(id, patch) {
+    const db = this.getDb();
+    const set = { updatedAt: /* @__PURE__ */ new Date() };
+    if (patch.content !== void 0) set.content = patch.content;
+    if (patch.activeForm !== void 0) set.activeForm = patch.activeForm;
+    if (patch.status !== void 0) {
+      set.status = patch.status;
+      set.completedAt = patch.status === "completed" ? /* @__PURE__ */ new Date() : null;
+    }
+    if (patch.parentTodoId !== void 0) set.parentTodoId = patch.parentTodoId;
+    if (patch.metadata !== void 0) set.metadata = patch.metadata;
+    const [row] = await db.update(todosTable).set(set).where(eq(todosTable.id, id)).returning();
+    return row ? rowToTodo(row) : null;
+  }
+  async delete(id) {
+    const db = this.getDb();
+    const rows = await db.delete(todosTable).where(eq(todosTable.id, id)).returning({ id: todosTable.id });
+    return rows.length > 0;
+  }
+  /**
+   * 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.
+   */
+  async writeList(args) {
+    const db = this.getDb();
+    const filter = {
+      entityId: args.entityId,
+      agentId: args.agentId
+    };
+    if (args.roomId !== null) {
+      filter.roomId = args.roomId;
+    }
+    const before = await this.list(filter);
+    const beforeById = new Map(before.map((t) => [t.id, t]));
+    const keepIds = /* @__PURE__ */ new Set();
+    const after = [];
+    for (const item of args.todos) {
+      const existing = item.id ? beforeById.get(item.id) : void 0;
+      if (existing) {
+        keepIds.add(existing.id);
+        const needsUpdate = existing.content !== item.content || existing.status !== item.status || existing.activeForm !== (item.activeForm ?? item.content);
+        if (needsUpdate) {
+          const updated = await this.update(existing.id, {
+            content: item.content,
+            activeForm: item.activeForm ?? item.content,
+            status: item.status
+          });
+          if (updated) after.push(updated);
+        } else {
+          after.push(existing);
+        }
+      } else {
+        const created = await this.create({
+          entityId: args.entityId,
+          agentId: args.agentId,
+          roomId: args.roomId,
+          worldId: args.worldId,
+          content: item.content,
+          activeForm: item.activeForm ?? item.content,
+          status: item.status,
+          parentTrajectoryStepId: args.parentTrajectoryStepId
+        });
+        keepIds.add(created.id);
+        after.push(created);
+      }
+    }
+    const toDelete = before.filter((t) => !keepIds.has(t.id)).map((t) => t.id);
+    if (toDelete.length > 0) {
+      await db.delete(todosTable).where(inArray(todosTable.id, toDelete));
+    }
+    return { before, after };
+  }
+  async clear(filter) {
+    const db = this.getDb();
+    const conditions = [eq(todosTable.entityId, filter.entityId)];
+    if (filter.agentId) {
+      conditions.push(eq(todosTable.agentId, filter.agentId));
+    }
+    if (filter.roomId) {
+      conditions.push(eq(todosTable.roomId, filter.roomId));
+    }
+    const rows = await db.delete(todosTable).where(and(...conditions)).returning({ id: todosTable.id });
+    return rows.length;
+  }
+}
+function getTodosService(runtime) {
+  const service = runtime.getService(TODOS_SERVICE_TYPE);
+  if (!service) {
+    throw new Error(
+      `${TODOS_LOG_PREFIX} TodosService is not registered \u2014 ensure @elizaos/plugin-todos is enabled.`
+    );
+  }
+  return service;
+}
+export {
+  TodosService,
+  getTodosService
+};
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service.ts"],"sourcesContent":["import { type IAgentRuntime, logger, Service, type UUID } from \"@elizaos/core\";\nimport { and, desc, eq, inArray } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\n\nimport { type TodoRow, todosTable } from \"./db/schema.js\";\nimport {\n  TODOS_LOG_PREFIX,\n  TODOS_SERVICE_TYPE,\n  type Todo,\n  type TodoStatus,\n} from \"./types.js\";\n\nexport interface TodoFilter {\n  entityId: string;\n  agentId?: string;\n  roomId?: string | null;\n  status?: TodoStatus | TodoStatus[];\n  includeCompleted?: boolean;\n  limit?: number;\n}\n\nexport interface CreateTodoInput {\n  entityId: string;\n  agentId: string;\n  roomId?: string | null;\n  worldId?: string | null;\n  content: string;\n  activeForm?: string;\n  status?: TodoStatus;\n  parentTodoId?: string | null;\n  parentTrajectoryStepId?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface UpdateTodoInput {\n  content?: string;\n  activeForm?: string;\n  status?: TodoStatus;\n  parentTodoId?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nfunction rowToTodo(row: TodoRow): Todo {\n  const metadata =\n    row.metadata &&\n    typeof row.metadata === \"object\" &&\n    !Array.isArray(row.metadata)\n      ? (row.metadata as Record<string, unknown>)\n      : {};\n  return {\n    id: row.id,\n    entityId: row.entityId,\n    agentId: row.agentId,\n    roomId: row.roomId ?? null,\n    worldId: row.worldId ?? null,\n    content: row.content,\n    activeForm: row.activeForm,\n    status: row.status as TodoStatus,\n    parentTodoId: row.parentTodoId ?? null,\n    parentTrajectoryStepId: row.parentTrajectoryStepId ?? null,\n    metadata,\n    createdAt: row.createdAt,\n    updatedAt: row.updatedAt,\n    completedAt: row.completedAt ?? null,\n  };\n}\n\nexport class TodosService extends Service {\n  static override readonly serviceType = TODOS_SERVICE_TYPE;\n\n  override capabilityDescription =\n    \"User-scoped todo CRUD. Persistent (drizzle/postgres), keyed by (agentId, entityId).\";\n\n  private getDb(): NodePgDatabase {\n    const db = this.runtime.db as NodePgDatabase | undefined;\n    if (!db) {\n      throw new Error(\n        `${TODOS_LOG_PREFIX} runtime.db is not available — @elizaos/plugin-sql must be installed and initialized.`,\n      );\n    }\n    return db;\n  }\n\n  static async start(runtime: IAgentRuntime): Promise<TodosService> {\n    logger.info(`${TODOS_LOG_PREFIX} starting TodosService`);\n    return new TodosService(runtime);\n  }\n\n  override async stop(): Promise<void> {\n    logger.info(`${TODOS_LOG_PREFIX} stopping TodosService`);\n  }\n\n  async create(input: CreateTodoInput): Promise<Todo> {\n    const db = this.getDb();\n    const [row] = await db\n      .insert(todosTable)\n      .values({\n        agentId: input.agentId as UUID,\n        entityId: input.entityId as UUID,\n        roomId: (input.roomId ?? null) as UUID | null,\n        worldId: (input.worldId ?? null) as UUID | null,\n        content: input.content,\n        activeForm: input.activeForm ?? input.content,\n        status: input.status ?? \"pending\",\n        parentTodoId: (input.parentTodoId ?? null) as UUID | null,\n        parentTrajectoryStepId: input.parentTrajectoryStepId ?? null,\n        metadata: input.metadata ?? {},\n      })\n      .returning();\n    if (!row) throw new Error(`${TODOS_LOG_PREFIX} insert returned no row`);\n    return rowToTodo(row);\n  }\n\n  async get(id: string): Promise<Todo | null> {\n    const db = this.getDb();\n    const [row] = await db\n      .select()\n      .from(todosTable)\n      .where(eq(todosTable.id, id as UUID))\n      .limit(1);\n    return row ? rowToTodo(row) : null;\n  }\n\n  async list(filter: TodoFilter): Promise<Todo[]> {\n    const db = this.getDb();\n    const conditions = [eq(todosTable.entityId, filter.entityId as UUID)];\n    if (filter.agentId) {\n      conditions.push(eq(todosTable.agentId, filter.agentId as UUID));\n    }\n    if (filter.roomId !== undefined && filter.roomId !== null) {\n      conditions.push(eq(todosTable.roomId, filter.roomId as UUID));\n    }\n    if (filter.status) {\n      const statuses = Array.isArray(filter.status)\n        ? filter.status\n        : [filter.status];\n      conditions.push(inArray(todosTable.status, statuses));\n    } else if (filter.includeCompleted === false) {\n      conditions.push(\n        inArray(todosTable.status, [\"pending\", \"in_progress\"] as TodoStatus[]),\n      );\n    }\n    const query = db\n      .select()\n      .from(todosTable)\n      .where(and(...conditions))\n      .orderBy(desc(todosTable.updatedAt));\n    const rows = filter.limit ? await query.limit(filter.limit) : await query;\n    return rows.map(rowToTodo);\n  }\n\n  async update(id: string, patch: UpdateTodoInput): Promise<Todo | null> {\n    const db = this.getDb();\n    const set: Record<string, unknown> = { updatedAt: new Date() };\n    if (patch.content !== undefined) set.content = patch.content;\n    if (patch.activeForm !== undefined) set.activeForm = patch.activeForm;\n    if (patch.status !== undefined) {\n      set.status = patch.status;\n      set.completedAt = patch.status === \"completed\" ? new Date() : null;\n    }\n    if (patch.parentTodoId !== undefined) set.parentTodoId = patch.parentTodoId;\n    if (patch.metadata !== undefined) set.metadata = patch.metadata;\n    const [row] = await db\n      .update(todosTable)\n      .set(set)\n      .where(eq(todosTable.id, id as UUID))\n      .returning();\n    return row ? rowToTodo(row) : null;\n  }\n\n  async delete(id: string): Promise<boolean> {\n    const db = this.getDb();\n    const rows = await db\n      .delete(todosTable)\n      .where(eq(todosTable.id, id as UUID))\n      .returning({ id: todosTable.id });\n    return rows.length > 0;\n  }\n\n  /**\n   * Bulk-replace the user's todo list for a given (entityId, roomId) scope.\n   * Mirrors Claude Code's TodoWrite contract: the caller passes the full\n   * desired list, and the store reconciles. Existing rows are matched by id;\n   * absent rows are deleted; new rows are inserted.\n   */\n  async writeList(args: {\n    entityId: string;\n    agentId: string;\n    roomId: string | null;\n    worldId: string | null;\n    parentTrajectoryStepId: string | null;\n    todos: Array<{\n      id?: string;\n      content: string;\n      status: TodoStatus;\n      activeForm?: string;\n    }>;\n  }): Promise<{ before: Todo[]; after: Todo[] }> {\n    const db = this.getDb();\n    const filter: TodoFilter = {\n      entityId: args.entityId,\n      agentId: args.agentId,\n    };\n    if (args.roomId !== null) {\n      filter.roomId = args.roomId;\n    }\n    const before = await this.list(filter);\n    const beforeById = new Map(before.map((t) => [t.id, t]));\n\n    const keepIds = new Set<string>();\n    const after: Todo[] = [];\n    for (const item of args.todos) {\n      const existing = item.id ? beforeById.get(item.id) : undefined;\n      if (existing) {\n        keepIds.add(existing.id);\n        const needsUpdate =\n          existing.content !== item.content ||\n          existing.status !== item.status ||\n          existing.activeForm !== (item.activeForm ?? item.content);\n        if (needsUpdate) {\n          const updated = await this.update(existing.id, {\n            content: item.content,\n            activeForm: item.activeForm ?? item.content,\n            status: item.status,\n          });\n          if (updated) after.push(updated);\n        } else {\n          after.push(existing);\n        }\n      } else {\n        const created = await this.create({\n          entityId: args.entityId,\n          agentId: args.agentId,\n          roomId: args.roomId,\n          worldId: args.worldId,\n          content: item.content,\n          activeForm: item.activeForm ?? item.content,\n          status: item.status,\n          parentTrajectoryStepId: args.parentTrajectoryStepId,\n        });\n        keepIds.add(created.id);\n        after.push(created);\n      }\n    }\n\n    const toDelete = before\n      .filter((t) => !keepIds.has(t.id))\n      .map((t) => t.id as UUID);\n    if (toDelete.length > 0) {\n      await db.delete(todosTable).where(inArray(todosTable.id, toDelete));\n    }\n\n    return { before, after };\n  }\n\n  async clear(filter: {\n    entityId: string;\n    agentId?: string;\n    roomId?: string | null;\n  }): Promise<number> {\n    const db = this.getDb();\n    const conditions = [eq(todosTable.entityId, filter.entityId as UUID)];\n    if (filter.agentId) {\n      conditions.push(eq(todosTable.agentId, filter.agentId as UUID));\n    }\n    if (filter.roomId) {\n      conditions.push(eq(todosTable.roomId, filter.roomId as UUID));\n    }\n    const rows = await db\n      .delete(todosTable)\n      .where(and(...conditions))\n      .returning({ id: todosTable.id });\n    return rows.length;\n  }\n}\n\nexport function getTodosService(runtime: IAgentRuntime): TodosService {\n  const service = runtime.getService<TodosService>(TODOS_SERVICE_TYPE);\n  if (!service) {\n    throw new Error(\n      `${TODOS_LOG_PREFIX} TodosService is not registered — ensure @elizaos/plugin-todos is enabled.`,\n    );\n  }\n  return service;\n}\n"],"mappings":"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","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+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_ACTIONS: readonly ["write", "create", "update", "complete", "cancel", "delete", "list", "clear"];
+export type TodoActionName = (typeof TODO_ACTIONS)[number];
+export declare const TODO_OPS: readonly ["write", "create", "update", "complete", "cancel", "delete", "list", "clear"];
+export type TodoOp = TodoActionName;
+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,YAAY,yFASf,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3D,eAAO,MAAM,QAAQ,yFAAe,CAAC;AACrC,MAAM,MAAM,MAAM,GAAG,cAAc,CAAC;AAEpC,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"}