@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/api/workbench-helpers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Workbench task/todo normalization helpers.
+ *
+ * Extracted from server.ts — used exclusively by workbench-routes.ts
+ * to transform elizaOS Task records into the WorkbenchTaskView / WorkbenchTodoView
+ * shapes consumed by the dashboard UI.
+ */
+import type { Task } from "@elizaos/core";
+export declare const WORKBENCH_TODO_TAG = "workbench-todo";
+export declare const WORKBENCH_TASK_TAG = "workbench-task";
+export interface WorkbenchTodoView {
+    id: string;
+    name: string;
+    description: string;
+    priority: number | null;
+    isUrgent: boolean;
+    isCompleted: boolean;
+    type: string;
+}
+export interface WorkbenchTaskView {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    isCompleted: boolean;
+    updatedAt?: number;
+}
+export declare function asObject(value: unknown): Record<string, unknown> | null;
+export declare function normalizeStringArray(value: unknown): string[];
+export declare function normalizeTimestamp(value: unknown): number | undefined;
+export declare function parseNullableNumber(value: unknown): number | null;
+export declare function readTaskMetadata(task: Task): Record<string, unknown>;
+export declare function normalizeTaskId(task: Task): string | null;
+export declare function readTaskCompleted(task: Task): boolean;
+export declare function isWorkbenchTodoTask(task: Task): boolean;
+export declare function toWorkbenchTodo(task: Task): WorkbenchTodoView | null;
+export declare function toWorkbenchTask(task: Task): WorkbenchTaskView | null;
+export declare function normalizeTags(value: unknown, required?: string[]): string[];
+//# sourceMappingURL=workbench-helpers.d.ts.map

package/packages/agent/src/api/workbench-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/api/workbench-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAO1C,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAMnD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGvE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAM7D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CASrD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CASvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,GAAG,IAAI,CA2BpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAqBpE;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,MAAM,EAAO,GACtB,MAAM,EAAE,CAMV"}

package/packages/agent/src/api/workbench-helpers.js

@@ -0,0 +1,137 @@
+/**
+ * Workbench task/todo normalization helpers.
+ *
+ * Extracted from server.ts — used exclusively by workbench-routes.ts
+ * to transform elizaOS Task records into the WorkbenchTaskView / WorkbenchTodoView
+ * shapes consumed by the dashboard UI.
+ */
+import { readTriggerConfig } from "../triggers/runtime.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const WORKBENCH_TODO_TAG = "workbench-todo";
+export const WORKBENCH_TASK_TAG = "workbench-task";
+export function asObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    return value;
+}
+export function normalizeStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+export function normalizeTimestamp(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (value instanceof Date)
+        return value.getTime();
+    if (typeof value === "string") {
+        const asNumber = Number(value);
+        if (Number.isFinite(asNumber))
+            return asNumber;
+        const parsed = Date.parse(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+export function parseNullableNumber(value) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return null;
+}
+export function readTaskMetadata(task) {
+    return asObject(task.metadata) ?? {};
+}
+export function normalizeTaskId(task) {
+    return typeof task.id === "string" && task.id.trim().length > 0
+        ? task.id
+        : null;
+}
+export function readTaskCompleted(task) {
+    const metadata = readTaskMetadata(task);
+    if (typeof metadata.isCompleted === "boolean")
+        return metadata.isCompleted;
+    const todoMeta = asObject(metadata.workbenchTodo) ?? asObject(metadata.todo) ?? null;
+    if (todoMeta && typeof todoMeta.isCompleted === "boolean") {
+        return todoMeta.isCompleted;
+    }
+    return false;
+}
+export function isWorkbenchTodoTask(task) {
+    if (readTriggerConfig(task))
+        return false;
+    const tags = new Set(normalizeStringArray(task.tags));
+    if (tags.has(WORKBENCH_TODO_TAG) || tags.has("todo"))
+        return true;
+    const metadata = readTaskMetadata(task);
+    return (asObject(metadata.workbenchTodo) !== null ||
+        asObject(metadata.todo) !== null);
+}
+export function toWorkbenchTodo(task) {
+    if (!isWorkbenchTodoTask(task))
+        return null;
+    const id = normalizeTaskId(task);
+    if (!id)
+        return null;
+    const metadata = readTaskMetadata(task);
+    const todoMeta = asObject(metadata.workbenchTodo) ?? asObject(metadata.todo) ?? {};
+    return {
+        id,
+        name: typeof task.name === "string" && task.name.trim().length > 0
+            ? task.name
+            : "Todo",
+        description: typeof todoMeta.description === "string"
+            ? todoMeta.description
+            : typeof task.description === "string"
+                ? task.description
+                : "",
+        priority: parseNullableNumber(todoMeta.priority),
+        isUrgent: todoMeta.isUrgent === true,
+        isCompleted: readTaskCompleted(task),
+        type: typeof todoMeta.type === "string" && todoMeta.type.trim().length > 0
+            ? todoMeta.type
+            : "task",
+    };
+}
+export function toWorkbenchTask(task) {
+    const tags = normalizeStringArray(task.tags);
+    if (!tags.includes(WORKBENCH_TASK_TAG))
+        return null;
+    if (readTriggerConfig(task) || isWorkbenchTodoTask(task))
+        return null;
+    const id = normalizeTaskId(task);
+    if (!id)
+        return null;
+    const metadata = readTaskMetadata(task);
+    const updatedAt = normalizeTimestamp(task.updatedAt) ??
+        normalizeTimestamp(metadata.updatedAt);
+    return {
+        id,
+        name: typeof task.name === "string" && task.name.trim().length > 0
+            ? task.name
+            : "Task",
+        description: typeof task.description === "string" ? task.description : "",
+        tags,
+        isCompleted: readTaskCompleted(task),
+        ...(updatedAt !== undefined ? { updatedAt } : {}),
+    };
+}
+export function normalizeTags(value, required = []) {
+    const next = new Set([
+        ...normalizeStringArray(value),
+        ...required.map((tag) => tag.trim()).filter((tag) => tag.length > 0),
+    ]);
+    return [...next];
+}

package/packages/agent/src/api/workbench-routes.d.ts

@@ -0,0 +1,43 @@
+import type http from "node:http";
+import type { AgentRuntime, Task, UUID } from "@elizaos/core";
+import type { ReadJsonBodyOptions } from "@elizaos/shared";
+import type { TriggerSummary } from "../triggers/types.ts";
+interface WorkbenchTodoView {
+    id: string;
+    name: string;
+    description: string;
+    priority: number | null;
+    isUrgent: boolean;
+    type: string;
+    isCompleted: boolean;
+    tags: string[];
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export declare const WORKBENCH_BOOTSTRAP_TODO_NAME = "Get the user's name and understand what they need help with";
+export interface WorkbenchRouteContext {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+    url: URL;
+    state: {
+        runtime: AgentRuntime | null;
+        adminEntityId: UUID | null;
+    };
+    json: (res: http.ServerResponse, data: unknown, status?: number) => void;
+    error: (res: http.ServerResponse, message: string, status?: number) => void;
+    readJsonBody: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
+    toWorkbenchTodo: (task: Task) => WorkbenchTodoView | null;
+    normalizeTags: (value: unknown, required?: string[]) => string[];
+    readTaskMetadata: (task: Task) => Record<string, unknown>;
+    readTaskCompleted: (task: Task) => boolean;
+    parseNullableNumber: (value: unknown) => number | null;
+    asObject: (value: unknown) => Record<string, unknown> | null;
+    decodePathComponent: (raw: string, res: http.ServerResponse, label: string) => string | null;
+    taskToTriggerSummary: (task: Task) => TriggerSummary | null;
+    listTriggerTasks: (runtime: AgentRuntime) => Promise<Task[]>;
+}
+export declare function handleWorkbenchRoutes(ctx: WorkbenchRouteContext): Promise<boolean>;
+export {};
+//# sourceMappingURL=workbench-routes.d.ts.map

package/packages/agent/src/api/workbench-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/workbench-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,eAAO,MAAM,6BAA6B,gEACqB,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE;QACL,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;QAC7B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,SAAS,MAAM,EAC7B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvB,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,iBAAiB,GAAG,IAAI,CAAC;IAC1D,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IACjE,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IAC3C,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IACvD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,mBAAmB,EAAE,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,KAAK,EAAE,MAAM,KACV,MAAM,GAAG,IAAI,CAAC;IACnB,oBAAoB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,cAAc,GAAG,IAAI,CAAC;IAC5D,gBAAgB,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;CAC9D;AAMD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CAkTlB"}

package/packages/agent/src/api/workbench-routes.js

@@ -0,0 +1,265 @@
+import { WORKBENCH_TODO_TAG } from "./workbench-helpers.js";
+export const WORKBENCH_BOOTSTRAP_TODO_NAME = "Get the user's name and understand what they need help with";
+// ---------------------------------------------------------------------------
+// Route handler
+// ---------------------------------------------------------------------------
+export async function handleWorkbenchRoutes(ctx) {
+    const { req, res, method, pathname, state, json, error, readJsonBody } = ctx;
+    // ── GET /api/workbench/overview ──────────────────────────────────────
+    // Workbench surfaces todos + triggers. Tasks were unified into workflows;
+    // workflow listings live at /api/automations now. The `tasks: []` field is
+    // kept in the response for backward compatibility with existing clients
+    // that still read it.
+    if (method === "GET" && pathname === "/api/workbench/overview") {
+        const triggers = [];
+        const todos = [];
+        const summary = {
+            totalTasks: 0,
+            completedTasks: 0,
+            totalTriggers: 0,
+            activeTriggers: 0,
+            totalTodos: 0,
+            completedTodos: 0,
+        };
+        let triggersAvailable = false;
+        let todosAvailable = false;
+        if (state.runtime) {
+            try {
+                const runtimeTasks = await state.runtime.getTasks({});
+                todosAvailable = true;
+                for (const task of runtimeTasks) {
+                    const todo = ctx.toWorkbenchTodo(task);
+                    if (todo)
+                        todos.push(todo);
+                }
+            }
+            catch {
+                todosAvailable = false;
+            }
+            try {
+                const triggerTasks = await ctx.listTriggerTasks(state.runtime);
+                triggersAvailable = true;
+                for (const task of triggerTasks) {
+                    const summaryItem = ctx.taskToTriggerSummary(task);
+                    if (summaryItem) {
+                        triggers.push(summaryItem);
+                    }
+                }
+            }
+            catch {
+                triggersAvailable = false;
+            }
+        }
+        if (todos.length > 1) {
+            const dedupedTodos = new Map();
+            for (const todo of todos) {
+                dedupedTodos.set(todo.id, todo);
+            }
+            todos.length = 0;
+            todos.push(...dedupedTodos.values());
+        }
+        todos.sort((a, b) => a.name.localeCompare(b.name));
+        triggers.sort((a, b) => (a.displayName ?? "").localeCompare(b.displayName ?? ""));
+        summary.totalTriggers = triggers.length;
+        summary.activeTriggers = triggers.filter((trigger) => trigger.enabled).length;
+        summary.totalTodos = todos.length;
+        summary.completedTodos = todos.filter((todo) => todo.isCompleted).length;
+        json(res, {
+            tasks: [],
+            triggers,
+            todos,
+            summary,
+            tasksAvailable: false,
+            triggersAvailable,
+            todosAvailable,
+        });
+        return true;
+    }
+    // ── GET /api/workbench/todos ─────────────────────────────────────────
+    if (method === "GET" && pathname === "/api/workbench/todos") {
+        if (!state.runtime) {
+            error(res, "Agent runtime is not available", 503);
+            return true;
+        }
+        const runtimeTasks = await state.runtime.getTasks({});
+        const todos = runtimeTasks
+            .map((task) => ctx.toWorkbenchTodo(task))
+            .filter((todo) => todo !== null)
+            .sort((a, b) => a.name.localeCompare(b.name));
+        json(res, { todos });
+        return true;
+    }
+    // ── POST /api/workbench/todos ────────────────────────────────────────
+    if (method === "POST" && pathname === "/api/workbench/todos") {
+        if (!state.runtime) {
+            error(res, "Agent runtime is not available", 503);
+            return true;
+        }
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        const name = typeof body.name === "string" ? body.name.trim() : "";
+        if (!name) {
+            error(res, "name is required", 400);
+            return true;
+        }
+        const description = typeof body.description === "string" ? body.description : "";
+        const isCompleted = body.isCompleted === true;
+        const priority = ctx.parseNullableNumber(body.priority);
+        const isUrgent = body.isUrgent === true;
+        const type = typeof body.type === "string" && body.type.trim().length > 0
+            ? body.type.trim()
+            : "task";
+        const metadata = {
+            isCompleted,
+            workbenchTodo: {
+                description,
+                priority,
+                isUrgent,
+                isCompleted,
+                type,
+            },
+        };
+        const taskId = await state.runtime.createTask({
+            name,
+            description,
+            tags: ctx.normalizeTags(body.tags, [WORKBENCH_TODO_TAG, "todo"]),
+            metadata,
+        });
+        const created = await state.runtime.getTask(taskId);
+        const todo = created ? ctx.toWorkbenchTodo(created) : null;
+        if (!todo) {
+            error(res, "Todo created but unavailable", 500);
+            return true;
+        }
+        json(res, { todo }, 201);
+        return true;
+    }
+    // ── POST /api/workbench/todos/:id/complete ──────────────────────────
+    const todoCompleteMatch = /^\/api\/workbench\/todos\/([^/]+)\/complete$/.exec(pathname);
+    if (method === "POST" && todoCompleteMatch) {
+        if (!state.runtime) {
+            error(res, "Agent runtime is not available", 503);
+            return true;
+        }
+        const decodedTodoId = ctx.decodePathComponent(todoCompleteMatch[1], res, "todo id");
+        if (!decodedTodoId)
+            return true;
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        const isCompleted = body.isCompleted === true;
+        const todoTask = await state.runtime.getTask(decodedTodoId);
+        if (!todoTask?.id || !ctx.toWorkbenchTodo(todoTask)) {
+            error(res, "Todo not found", 404);
+            return true;
+        }
+        const metadata = ctx.readTaskMetadata(todoTask);
+        const todoMeta = ctx.asObject(metadata.workbenchTodo) ?? ctx.asObject(metadata.todo) ?? {};
+        await state.runtime.updateTask(todoTask.id, {
+            metadata: {
+                ...metadata,
+                isCompleted,
+                workbenchTodo: {
+                    ...todoMeta,
+                    isCompleted,
+                },
+            },
+        });
+        json(res, { ok: true });
+        return true;
+    }
+    // ── GET/PUT/DELETE /api/workbench/todos/:id ──────────────────────────
+    const todoItemMatch = /^\/api\/workbench\/todos\/([^/]+)$/.exec(pathname);
+    if (todoItemMatch && ["GET", "PUT", "DELETE"].includes(method)) {
+        if (!state.runtime) {
+            error(res, "Agent runtime is not available", 503);
+            return true;
+        }
+        const decodedTodoId = ctx.decodePathComponent(todoItemMatch[1], res, "todo id");
+        if (!decodedTodoId)
+            return true;
+        if (method === "GET") {
+            const todoTask = await state.runtime.getTask(decodedTodoId);
+            const todoView = todoTask ? ctx.toWorkbenchTodo(todoTask) : null;
+            if (!todoTask?.id || !todoView) {
+                error(res, "Todo not found", 404);
+                return true;
+            }
+            json(res, { todo: todoView });
+            return true;
+        }
+        if (method === "DELETE") {
+            const todoTask = await state.runtime.getTask(decodedTodoId);
+            if (!todoTask?.id || !ctx.toWorkbenchTodo(todoTask)) {
+                error(res, "Todo not found", 404);
+                return true;
+            }
+            await state.runtime.deleteTask(todoTask.id);
+            json(res, { ok: true });
+            return true;
+        }
+        // PUT
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        const todoTask = await state.runtime.getTask(decodedTodoId);
+        const todoView = todoTask ? ctx.toWorkbenchTodo(todoTask) : null;
+        if (!todoTask?.id || !todoView) {
+            error(res, "Todo not found", 404);
+            return true;
+        }
+        const update = {};
+        if (typeof body.name === "string") {
+            const name = body.name.trim();
+            if (!name) {
+                error(res, "name cannot be empty", 400);
+                return true;
+            }
+            update.name = name;
+        }
+        if (typeof body.description === "string") {
+            update.description = body.description;
+        }
+        if (body.tags !== undefined) {
+            update.tags = ctx.normalizeTags(body.tags, [WORKBENCH_TODO_TAG, "todo"]);
+        }
+        const metadata = ctx.readTaskMetadata(todoTask);
+        const existingTodoMeta = ctx.asObject(metadata.workbenchTodo) ?? ctx.asObject(metadata.todo) ?? {};
+        const nextTodoMeta = {
+            ...existingTodoMeta,
+        };
+        if (typeof body.description === "string") {
+            nextTodoMeta.description = body.description;
+        }
+        if (body.priority !== undefined) {
+            nextTodoMeta.priority = ctx.parseNullableNumber(body.priority);
+        }
+        if (typeof body.isUrgent === "boolean") {
+            nextTodoMeta.isUrgent = body.isUrgent;
+        }
+        if (typeof body.type === "string" && body.type.trim().length > 0) {
+            nextTodoMeta.type = body.type.trim();
+        }
+        let isCompleted = ctx.readTaskCompleted(todoTask);
+        if (typeof body.isCompleted === "boolean") {
+            isCompleted = body.isCompleted;
+        }
+        nextTodoMeta.isCompleted = isCompleted;
+        update.metadata = {
+            ...metadata,
+            isCompleted,
+            workbenchTodo: nextTodoMeta,
+        };
+        await state.runtime.updateTask(todoTask.id, update);
+        const refreshed = await state.runtime.getTask(todoTask.id);
+        const refreshedTodo = refreshed ? ctx.toWorkbenchTodo(refreshed) : null;
+        if (!refreshedTodo) {
+            error(res, "Todo updated but unavailable", 500);
+            return true;
+        }
+        json(res, { todo: refreshedTodo });
+        return true;
+    }
+    return false;
+}

package/packages/agent/src/api/x-relay-routes.d.ts

@@ -0,0 +1,27 @@
+/**
+ * X relay route.
+ *
+ * Proxies local LifeOps X calls through Eliza Cloud so the desktop app can
+ * stay credential-light while Cloud handles billing and provider access.
+ *
+ * The relay is intentionally thin: auth + proxy + 402 preservation only.
+ */
+import type http from "node:http";
+import { type Service } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+import type { CloudProxyConfigLike } from "../types/config-like.ts";
+interface XRelayRuntime {
+    getService(serviceType: string): Service | null;
+    getSetting?: (key: string) => unknown;
+    character?: {
+        secrets?: Record<string, unknown>;
+    } | null;
+    cloud?: ElizaConfig["cloud"];
+}
+export interface XRelayRouteState {
+    config: CloudProxyConfigLike;
+    runtime?: XRelayRuntime | null;
+}
+export declare function handleXRelayRoute(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, state: XRelayRouteState): Promise<boolean>;
+export {};
+//# sourceMappingURL=x-relay-routes.d.ts.map

package/packages/agent/src/api/x-relay-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x-relay-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/x-relay-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,eAAe,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,UAAU,aAAa;IACrB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AA6FD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,OAAO,CAAC,CAqElB"}

package/packages/agent/src/api/x-relay-routes.js

@@ -0,0 +1,134 @@
+/**
+ * X relay route.
+ *
+ * Proxies local LifeOps X calls through Eliza Cloud so the desktop app can
+ * stay credential-light while Cloud handles billing and provider access.
+ *
+ * The relay is intentionally thin: auth + proxy + 402 preservation only.
+ */
+import { sendJsonError } from "@elizaos/core";
+import { normalizeCloudSiteUrl, resolveCloudApiKey, validateCloudBaseUrl, } from "@elizaos/plugin-elizacloud";
+import { sendJson } from "@elizaos/shared";
+const PROXY_TIMEOUT_MS = 30_000;
+const MAX_BODY_BYTES = 1_048_576;
+const X_RELAY_PATH_RE = /^\/api\/cloud\/x(\/.*)$/;
+function isCloudAuthApiKeyService(value) {
+    return (value !== null &&
+        typeof value.isAuthenticated ===
+            "function");
+}
+function normalizeCloudApiKey(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.toUpperCase() === "[REDACTED]") {
+        return null;
+    }
+    return trimmed;
+}
+function resolveProxyApiKey(state) {
+    const cloudAuth = state.runtime
+        ? state.runtime.getService("CLOUD_AUTH")
+        : null;
+    const runtimeApiKey = isCloudAuthApiKeyService(cloudAuth) && cloudAuth.isAuthenticated() === true
+        ? normalizeCloudApiKey(cloudAuth.getApiKey?.())
+        : null;
+    return runtimeApiKey ?? resolveCloudApiKey(state.config, state.runtime);
+}
+function buildAuthHeaders(config, apiKey) {
+    const headers = {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+    };
+    const serviceKey = config.cloud?.serviceKey?.trim();
+    if (serviceKey) {
+        headers["X-Service-Key"] = serviceKey;
+    }
+    return headers;
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on("data", (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new Error("Request body too large"));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => resolve(chunks.length > 0 ? Buffer.concat(chunks).toString("utf-8") : undefined));
+        req.on("error", reject);
+    });
+}
+async function readJsonResponse(response) {
+    return response.json().catch(async () => ({
+        success: response.ok,
+        error: await response.text().catch(() => "X relay request failed"),
+    }));
+}
+function buildUpstreamPath(pathname) {
+    const match = X_RELAY_PATH_RE.exec(pathname);
+    if (!match) {
+        throw new Error("Invalid X relay path");
+    }
+    return `/api/v1/x${match[1] ?? ""}`;
+}
+export async function handleXRelayRoute(req, res, pathname, method, state) {
+    if (!pathname.startsWith("/api/cloud/x/")) {
+        return false;
+    }
+    if (method !== "GET" && method !== "POST") {
+        sendJsonError(res, "Unsupported X relay method", 405);
+        return true;
+    }
+    const apiKey = resolveProxyApiKey(state);
+    if (!apiKey) {
+        sendJsonError(res, "Not connected to Eliza Cloud. Sign in to use X relays.", 401);
+        return true;
+    }
+    const baseUrl = normalizeCloudSiteUrl(state.config.cloud?.baseUrl);
+    const urlError = await validateCloudBaseUrl(baseUrl);
+    if (urlError) {
+        sendJsonError(res, urlError, 502);
+        return true;
+    }
+    let body;
+    if (method === "POST") {
+        try {
+            body = await readBody(req);
+        }
+        catch (error) {
+            sendJsonError(res, error instanceof Error ? error.message : "Failed to read body", 413);
+            return true;
+        }
+    }
+    const fullUrl = new URL(req.url ?? pathname, "http://localhost");
+    const upstreamUrl = `${baseUrl}${buildUpstreamPath(pathname)}${fullUrl.search}`;
+    const upstreamResponse = await fetch(upstreamUrl, {
+        method,
+        headers: buildAuthHeaders(state.config, apiKey),
+        body,
+        redirect: "manual",
+        signal: AbortSignal.timeout(PROXY_TIMEOUT_MS),
+    });
+    if (upstreamResponse.status === 402) {
+        const wwwAuth = upstreamResponse.headers.get("www-authenticate");
+        const contentType = upstreamResponse.headers.get("content-type");
+        const bodyText = await upstreamResponse.text().catch(() => "");
+        if (wwwAuth) {
+            res.setHeader("WWW-Authenticate", wwwAuth);
+        }
+        if (contentType) {
+            res.setHeader("Content-Type", contentType);
+        }
+        res.statusCode = 402;
+        res.end(bodyText);
+        return true;
+    }
+    const payload = await readJsonResponse(upstreamResponse);
+    sendJson(res, payload, upstreamResponse.status);
+    return true;
+}