@elizaos/plugin-personal-assistant 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/actions/password-manager.js

@@ -0,0 +1,195 @@
+import { extractActionParamsViaLlm } from "@elizaos/agent";
+import {
+  logger,
+  requireConfirmation
+} from "@elizaos/core";
+import {
+  injectCredentialToClipboard,
+  listPasswordItems,
+  searchPasswordItems
+} from "@elizaos/plugin-browser/password-manager-bridge";
+const ACTION_NAME = "PASSWORD_MANAGER";
+const PARAM_SCHEMA = [
+  {
+    name: "subaction",
+    description: "One of: search, list, inject_username, inject_password.",
+    schema: { type: "string" }
+  },
+  {
+    name: "intent",
+    description: "Natural-language description of the lookup intent.",
+    schema: { type: "string" }
+  },
+  {
+    name: "query",
+    description: "Search string matched against item title, URL, username, and tags.",
+    schema: { type: "string" }
+  },
+  {
+    name: "itemId",
+    description: "Password manager item id (required for inject_* subactions).",
+    schema: { type: "string" }
+  },
+  {
+    name: "field",
+    description: "Which field to inject when using a generic inject subaction. Ignored when subaction explicitly names the field.",
+    schema: { type: "string" }
+  },
+  {
+    name: "confirmed",
+    description: "Must be explicitly true to copy a credential to the clipboard.",
+    schema: { type: "boolean" }
+  },
+  {
+    name: "limit",
+    description: "Optional item limit for the `list` subaction (default 20).",
+    schema: { type: "number" }
+  }
+];
+const ACTION_DESCRIPTION = "Look up or copy credentials from your password manager (1Password CLI or ProtonPass). Subactions: search, list, inject_username, inject_password. Credentials are NEVER displayed in chat \u2014 injection only copies to the OS clipboard briefly.";
+function readConfig(runtime) {
+  const account = process.env.ELIZA_1PASSWORD_ACCOUNT?.trim() || (() => {
+    const setting = runtime?.getSetting?.("ELIZA_1PASSWORD_ACCOUNT");
+    return typeof setting === "string" ? setting.trim() : "";
+  })();
+  const config = {};
+  if (account) config.onePasswordAccount = account;
+  return config;
+}
+function describeItems(items) {
+  if (items.length === 0) return "No matching items.";
+  return items.map((item, index) => {
+    const parts = [`${index + 1}. ${item.title} (id: ${item.id})`];
+    if (item.url) parts.push(`url: ${item.url}`);
+    if (item.username) parts.push(`username: ${item.username}`);
+    return parts.join(" \u2014 ");
+  }).join("\n");
+}
+function failure(error, extra) {
+  const userMessages = {
+    PERMISSION_DENIED: "Password manager is owner-only; you don't have access here.",
+    MISSING_QUERY: "Which login should I look up? Tell me the service (e.g. GitHub, AWS).",
+    MISSING_ITEM_ID: "I need the password manager item id to copy a field.",
+    CONFIRMATION_REQUIRED: "Copying a credential needs explicit confirmation. Re-issue with confirmed: true.",
+    UNKNOWN_SUBACTION: "Say 'list my saved logins', 'find my <service> login', or 'copy <service> password to clipboard'."
+  };
+  return {
+    text: userMessages[error] ?? error,
+    success: false,
+    values: { success: false, error },
+    data: { actionName: ACTION_NAME, error, ...extra }
+  };
+}
+async function runPasswordManagerHandler(runtime, message, state, options) {
+  try {
+    const rawParameters = options?.parameters;
+    const rawParams = (typeof rawParameters === "object" && rawParameters !== null ? rawParameters : {}) ?? {};
+    const params = await extractActionParamsViaLlm({
+      runtime,
+      message,
+      state,
+      actionName: ACTION_NAME,
+      actionDescription: ACTION_DESCRIPTION,
+      paramSchema: PARAM_SCHEMA,
+      existingParams: rawParams,
+      requiredFields: ["subaction"]
+    });
+    const subaction = (params.subaction ?? "").toString().trim().toLowerCase();
+    const config = readConfig(runtime);
+    if (subaction === "search") {
+      const query = (params.query ?? params.intent ?? "").toString().trim();
+      if (!query) return failure("MISSING_QUERY");
+      const items = await searchPasswordItems(query, config);
+      const text = `Saved login items only \u2014 passwords remain hidden.
+${describeItems(items)}`;
+      return {
+        text,
+        success: true,
+        values: { success: true, count: items.length },
+        data: {
+          actionName: ACTION_NAME,
+          subaction: "search",
+          query,
+          items
+        }
+      };
+    }
+    if (subaction === "list") {
+      const limit = typeof params.limit === "number" && params.limit > 0 ? Math.floor(params.limit) : 20;
+      const items = await listPasswordItems({ limit }, config);
+      return {
+        text: `Saved login items only \u2014 passwords remain hidden.
+${describeItems(items)}`,
+        success: true,
+        values: { success: true, count: items.length },
+        data: {
+          actionName: ACTION_NAME,
+          subaction: "list",
+          items
+        }
+      };
+    }
+    if (subaction === "inject_username" || subaction === "inject_password") {
+      const field = subaction === "inject_username" ? "username" : "password";
+      const itemId = (params.itemId ?? "").toString().trim();
+      if (!itemId) return failure("MISSING_ITEM_ID");
+      const prompt = `Copy ${field} for item '${itemId}' to the clipboard?`;
+      const decision = await requireConfirmation({
+        runtime,
+        message,
+        actionName: ACTION_NAME,
+        pendingKey: `inject:${itemId}:${field}`,
+        prompt
+      });
+      if (decision.status !== "confirmed") {
+        return failure(
+          decision.status === "pending" ? "CONFIRMATION_REQUIRED" : "CANCELLED",
+          {
+            itemId,
+            field,
+            awaitingUserInput: decision.status === "pending"
+          }
+        );
+      }
+      const result = await injectCredentialToClipboard(itemId, field, config);
+      logger.info(
+        {
+          action: ACTION_NAME,
+          subaction,
+          itemId,
+          field,
+          fixtureMode: result.fixtureMode === true
+        },
+        `[${ACTION_NAME}] Copied ${field} for item ${itemId} to clipboard`
+      );
+      const fixtureSuffix = result.fixtureMode ? " [fixture backend: no actual clipboard write \u2014 test/benchmark mode]" : "";
+      return {
+        text: `Copied ${field} for item '${itemId}' to clipboard (clears in ${result.expiresInSeconds}s).${fixtureSuffix}`,
+        success: true,
+        values: {
+          success: true,
+          field,
+          expiresInSeconds: result.expiresInSeconds,
+          fixtureMode: result.fixtureMode === true
+        },
+        data: {
+          actionName: ACTION_NAME,
+          subaction,
+          itemId,
+          field,
+          expiresInSeconds: result.expiresInSeconds,
+          fixtureMode: result.fixtureMode === true
+        }
+      };
+    }
+    return failure("UNKNOWN_SUBACTION", { subaction });
+  } catch (error) {
+    const message2 = error instanceof Error ? error.message : "Unknown password manager failure.";
+    logger.warn({ error }, `[${ACTION_NAME}] handler failed`);
+    return failure("PASSWORD_MANAGER_FAILED", { error: message2 });
+  }
+}
+export {
+  runPasswordManagerHandler
+};
+//# sourceMappingURL=password-manager.js.map

package/dist/actions/password-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/password-manager.ts"],"sourcesContent":["import { extractActionParamsViaLlm } from \"@elizaos/agent\";\nimport {\n  type ActionResult,\n  type HandlerOptions,\n  type IAgentRuntime,\n  logger,\n  type Memory,\n  requireConfirmation,\n  type State,\n} from \"@elizaos/core\";\nimport {\n  injectCredentialToClipboard,\n  listPasswordItems,\n  type PasswordManagerBridgeConfig,\n  type PasswordManagerItem,\n  searchPasswordItems,\n} from \"@elizaos/plugin-browser/password-manager-bridge\";\n\n/**\n * Password manager handler.\n *\n * Owner-only. Subactions:\n *   - search: match items by query string.\n *   - list: return a bounded number of items.\n *   - inject_username / inject_password: copy a field to the OS clipboard.\n *\n * Plaintext credentials NEVER appear in chat or in ActionResult payloads.\n */\n\ntype PasswordManagerSubaction =\n  | \"search\"\n  | \"list\"\n  | \"inject_username\"\n  | \"inject_password\";\n\ntype PasswordManagerParameters = {\n  subaction?: PasswordManagerSubaction | string;\n  intent?: string;\n  query?: string;\n  itemId?: string;\n  field?: \"username\" | \"password\";\n  confirmed?: boolean;\n  limit?: number;\n};\n\nconst ACTION_NAME = \"PASSWORD_MANAGER\";\n\nconst PARAM_SCHEMA = [\n  {\n    name: \"subaction\",\n    description: \"One of: search, list, inject_username, inject_password.\",\n    schema: { type: \"string\" as const },\n  },\n  {\n    name: \"intent\",\n    description: \"Natural-language description of the lookup intent.\",\n    schema: { type: \"string\" as const },\n  },\n  {\n    name: \"query\",\n    description:\n      \"Search string matched against item title, URL, username, and tags.\",\n    schema: { type: \"string\" as const },\n  },\n  {\n    name: \"itemId\",\n    description: \"Password manager item id (required for inject_* subactions).\",\n    schema: { type: \"string\" as const },\n  },\n  {\n    name: \"field\",\n    description:\n      \"Which field to inject when using a generic inject subaction. Ignored when subaction explicitly names the field.\",\n    schema: { type: \"string\" as const },\n  },\n  {\n    name: \"confirmed\",\n    description:\n      \"Must be explicitly true to copy a credential to the clipboard.\",\n    schema: { type: \"boolean\" as const },\n  },\n  {\n    name: \"limit\",\n    description: \"Optional item limit for the `list` subaction (default 20).\",\n    schema: { type: \"number\" as const },\n  },\n];\n\nconst ACTION_DESCRIPTION =\n  \"Look up or copy credentials from your password manager (1Password CLI or ProtonPass). \" +\n  \"Subactions: search, list, inject_username, inject_password. Credentials are NEVER displayed in chat — injection only copies to the OS clipboard briefly.\";\n\nfunction readConfig(\n  runtime: { getSetting?: (key: string) => unknown } | undefined,\n): PasswordManagerBridgeConfig {\n  const account =\n    process.env.ELIZA_1PASSWORD_ACCOUNT?.trim() ||\n    (() => {\n      const setting = runtime?.getSetting?.(\"ELIZA_1PASSWORD_ACCOUNT\");\n      return typeof setting === \"string\" ? setting.trim() : \"\";\n    })();\n  const config: PasswordManagerBridgeConfig = {};\n  if (account) config.onePasswordAccount = account;\n  return config;\n}\n\nfunction describeItems(items: PasswordManagerItem[]): string {\n  if (items.length === 0) return \"No matching items.\";\n  return items\n    .map((item, index) => {\n      const parts = [`${index + 1}. ${item.title} (id: ${item.id})`];\n      if (item.url) parts.push(`url: ${item.url}`);\n      if (item.username) parts.push(`username: ${item.username}`);\n      return parts.join(\" — \");\n    })\n    .join(\"\\n\");\n}\n\nfunction failure(error: string, extra?: Record<string, unknown>): ActionResult {\n  const userMessages: Record<string, string> = {\n    PERMISSION_DENIED:\n      \"Password manager is owner-only; you don't have access here.\",\n    MISSING_QUERY:\n      \"Which login should I look up? Tell me the service (e.g. GitHub, AWS).\",\n    MISSING_ITEM_ID: \"I need the password manager item id to copy a field.\",\n    CONFIRMATION_REQUIRED:\n      \"Copying a credential needs explicit confirmation. Re-issue with confirmed: true.\",\n    UNKNOWN_SUBACTION:\n      \"Say 'list my saved logins', 'find my <service> login', or 'copy <service> password to clipboard'.\",\n  };\n  return {\n    text: userMessages[error] ?? error,\n    success: false,\n    values: { success: false, error },\n    data: { actionName: ACTION_NAME, error, ...extra },\n  };\n}\n\n/**\n * Handler function backing the CREDENTIALS umbrella's password-manager\n * subactions (`search`, `list`, `inject_username`, `inject_password`).\n *\n * Called from `./credentials.ts`; no Action object is registered for this\n * handler directly.\n */\nexport async function runPasswordManagerHandler(\n  runtime: IAgentRuntime,\n  message: Memory,\n  state: State | undefined,\n  options: HandlerOptions | undefined,\n): Promise<ActionResult> {\n  try {\n    const rawParameters = options?.parameters;\n    const rawParams = ((typeof rawParameters === \"object\" &&\n    rawParameters !== null\n      ? (rawParameters as PasswordManagerParameters)\n      : {}) ?? {}) as PasswordManagerParameters;\n    const params = (await extractActionParamsViaLlm<PasswordManagerParameters>({\n      runtime,\n      message,\n      state,\n      actionName: ACTION_NAME,\n      actionDescription: ACTION_DESCRIPTION,\n      paramSchema: PARAM_SCHEMA,\n      existingParams: rawParams,\n      requiredFields: [\"subaction\"],\n    })) as PasswordManagerParameters;\n\n    const subaction = (params.subaction ?? \"\").toString().trim().toLowerCase();\n    const config = readConfig(runtime);\n\n    if (subaction === \"search\") {\n      const query = (params.query ?? params.intent ?? \"\").toString().trim();\n      if (!query) return failure(\"MISSING_QUERY\");\n      const items = await searchPasswordItems(query, config);\n      const text = `Saved login items only — passwords remain hidden.\\n${describeItems(items)}`;\n      return {\n        text,\n        success: true,\n        values: { success: true, count: items.length },\n        data: {\n          actionName: ACTION_NAME,\n          subaction: \"search\",\n          query,\n          items,\n        },\n      };\n    }\n\n    if (subaction === \"list\") {\n      const limit =\n        typeof params.limit === \"number\" && params.limit > 0\n          ? Math.floor(params.limit)\n          : 20;\n      const items = await listPasswordItems({ limit }, config);\n      return {\n        text: `Saved login items only — passwords remain hidden.\\n${describeItems(items)}`,\n        success: true,\n        values: { success: true, count: items.length },\n        data: {\n          actionName: ACTION_NAME,\n          subaction: \"list\",\n          items,\n        },\n      };\n    }\n\n    if (subaction === \"inject_username\" || subaction === \"inject_password\") {\n      const field: \"username\" | \"password\" =\n        subaction === \"inject_username\" ? \"username\" : \"password\";\n      const itemId = (params.itemId ?? \"\").toString().trim();\n      if (!itemId) return failure(\"MISSING_ITEM_ID\");\n      const prompt = `Copy ${field} for item '${itemId}' to the clipboard?`;\n      const decision = await requireConfirmation({\n        runtime,\n        message,\n        actionName: ACTION_NAME,\n        pendingKey: `inject:${itemId}:${field}`,\n        prompt,\n      });\n      if (decision.status !== \"confirmed\") {\n        return failure(\n          decision.status === \"pending\" ? \"CONFIRMATION_REQUIRED\" : \"CANCELLED\",\n          {\n            itemId,\n            field,\n            awaitingUserInput: decision.status === \"pending\",\n          },\n        );\n      }\n      const result = await injectCredentialToClipboard(itemId, field, config);\n      logger.info(\n        {\n          action: ACTION_NAME,\n          subaction,\n          itemId,\n          field,\n          fixtureMode: result.fixtureMode === true,\n        },\n        `[${ACTION_NAME}] Copied ${field} for item ${itemId} to clipboard`,\n      );\n      const fixtureSuffix = result.fixtureMode\n        ? \" [fixture backend: no actual clipboard write — test/benchmark mode]\"\n        : \"\";\n      return {\n        text: `Copied ${field} for item '${itemId}' to clipboard (clears in ${result.expiresInSeconds}s).${fixtureSuffix}`,\n        success: true,\n        values: {\n          success: true,\n          field,\n          expiresInSeconds: result.expiresInSeconds,\n          fixtureMode: result.fixtureMode === true,\n        },\n        data: {\n          actionName: ACTION_NAME,\n          subaction,\n          itemId,\n          field,\n          expiresInSeconds: result.expiresInSeconds,\n          fixtureMode: result.fixtureMode === true,\n        },\n      };\n    }\n\n    return failure(\"UNKNOWN_SUBACTION\", { subaction });\n  } catch (error) {\n    const message =\n      error instanceof Error\n        ? error.message\n        : \"Unknown password manager failure.\";\n    logger.warn({ error }, `[${ACTION_NAME}] handler failed`);\n    return failure(\"PASSWORD_MANAGER_FAILED\", { error: message });\n  }\n}\n"],"mappings":"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","names":["message"]}

package/dist/actions/payments.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OWNER_FINANCES payment-source / spending handler.
+ *
+ * The implementation moved to `@elizaos/plugin-finances` along with the finance
+ * back-end. This module re-exports `runPaymentsHandler` so existing importers
+ * (the `money.ts` umbrella dispatcher + integration tests) keep resolving it
+ * from here. The handler constructs a `FinancesService` internally.
+ */
+export { runPaymentsHandler } from "@elizaos/plugin-finances/actions/finances";
+//# sourceMappingURL=payments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/actions/payments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/actions/payments.js

@@ -0,0 +1,5 @@
+import { runPaymentsHandler } from "@elizaos/plugin-finances/actions/finances";
+export {
+  runPaymentsHandler
+};
+//# sourceMappingURL=payments.js.map

package/dist/actions/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/payments.ts"],"sourcesContent":["/**\n * OWNER_FINANCES payment-source / spending handler.\n *\n * The implementation moved to `@elizaos/plugin-finances` along with the finance\n * back-end. This module re-exports `runPaymentsHandler` so existing importers\n * (the `money.ts` umbrella dispatcher + integration tests) keep resolving it\n * from here. The handler constructs a `FinancesService` internally.\n */\n\nexport { runPaymentsHandler } from \"@elizaos/plugin-finances/actions/finances\";\n"],"mappings":"AASA,SAAS,0BAA0B;","names":[]}

package/dist/actions/prioritize.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `PRIORITIZE` umbrella action — LLM-ranked importance × urgency.
+ *
+ * Subactions:
+ *   - `rank_todos`     — todo items in the owner's life domain
+ *   - `rank_threads`   — open inbox / messaging threads
+ *   - `rank_decisions` — pending approval queue decisions
+ *
+ * Loads items via the relevant loader hook, then calls
+ * `runtime.useModel(ModelType.TEXT_LARGE)` once with a structured prompt that
+ * asks for a JSON ranking by urgency × importance, with a short reasoning
+ * string per item.
+ *
+ * Owner-only.
+ */
+import type { Action, IAgentRuntime } from "@elizaos/core";
+export interface PrioritizeRankableItem {
+    readonly id: string;
+    readonly title: string;
+    readonly summary?: string;
+    readonly dueAt?: string | null;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface PrioritizeRankedItem extends PrioritizeRankableItem {
+    readonly rank: number;
+    readonly score: number;
+    readonly reasoning: string;
+}
+/**
+ * Per-subject loader hooks. Default loaders return empty lists so tests can
+ * inject per-subject inputs without standing up the full service graph.
+ */
+export interface PrioritizeLoaders {
+    loadTodos: (args: {
+        runtime: IAgentRuntime;
+    }) => Promise<readonly PrioritizeRankableItem[]>;
+    loadThreads: (args: {
+        runtime: IAgentRuntime;
+    }) => Promise<readonly PrioritizeRankableItem[]>;
+    loadDecisions: (args: {
+        runtime: IAgentRuntime;
+    }) => Promise<readonly PrioritizeRankableItem[]>;
+}
+export declare function setPrioritizeLoaders(next: Partial<PrioritizeLoaders>): void;
+export declare function __resetPrioritizeLoadersForTests(): void;
+export declare const prioritizeAction: Action & {
+    suppressPostActionContinuation?: boolean;
+};
+//# sourceMappingURL=prioritize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prioritize.d.ts","sourceRoot":"","sources":["../../src/actions/prioritize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,MAAM,EAKN,aAAa,EAEd,MAAM,eAAe,CAAC;AAwCvB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;IACjD,aAAa,EAAE,CAAC,IAAI,EAAE;QACpB,OAAO,EAAE,aAAa,CAAC;KACxB,KAAK,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;CAClD;AAUD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE3E;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AA6KD,eAAO,MAAM,gBAAgB,EAAE,MAAM,GAAG;IACtC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CA2K1C,CAAC"}

package/dist/actions/prioritize.js

@@ -0,0 +1,313 @@
+import { logger, ModelType, runWithTrajectoryContext } from "@elizaos/core";
+import { hasLifeOpsAccess } from "../lifeops/access.js";
+const ACTION_NAME = "PRIORITIZE";
+const SUBACTIONS = ["rank_todos", "rank_threads", "rank_decisions"];
+const SIMILE_NAMES = [
+  "PRIORITIZE",
+  "RANK_TODAY",
+  "WHAT_MATTERS_MOST",
+  "PRIORITIZE_TODAY"
+];
+const SUBJECT_TO_SUBACTION = {
+  todos: "rank_todos",
+  threads: "rank_threads",
+  decisions: "rank_decisions"
+};
+const SUBACTION_TO_SUBJECT = {
+  rank_todos: "todos",
+  rank_threads: "threads",
+  rank_decisions: "decisions"
+};
+const defaultLoaders = {
+  loadTodos: async () => [],
+  loadThreads: async () => [],
+  loadDecisions: async () => []
+};
+let activeLoaders = defaultLoaders;
+function setPrioritizeLoaders(next) {
+  activeLoaders = { ...activeLoaders, ...next };
+}
+function __resetPrioritizeLoadersForTests() {
+  activeLoaders = defaultLoaders;
+}
+function getParams(options) {
+  const raw = options?.parameters;
+  if (raw && typeof raw === "object") {
+    return raw;
+  }
+  return {};
+}
+function normalizeSubaction(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return null;
+  const lower = trimmed.toLowerCase();
+  return SUBACTIONS.includes(lower) ? lower : null;
+}
+function normalizeSubject(value) {
+  if (typeof value !== "string") return null;
+  const lower = value.trim().toLowerCase();
+  if (lower === "todos" || lower === "threads" || lower === "decisions") {
+    return lower;
+  }
+  return null;
+}
+function resolveSubaction(params) {
+  return normalizeSubaction(params.subaction) ?? normalizeSubaction(params.action) ?? normalizeSubaction(params.op) ?? (() => {
+    const subject = normalizeSubject(params.subject);
+    return subject ? SUBJECT_TO_SUBACTION[subject] : null;
+  })();
+}
+async function loadItemsForSubaction(subaction, runtime) {
+  switch (subaction) {
+    case "rank_todos":
+      return activeLoaders.loadTodos({ runtime });
+    case "rank_threads":
+      return activeLoaders.loadThreads({ runtime });
+    case "rank_decisions":
+      return activeLoaders.loadDecisions({ runtime });
+  }
+}
+function buildRankingPrompt(args) {
+  const data = JSON.stringify(args.items, null, 2);
+  const criteriaLine = args.criteria ? `
+Additional criteria from the owner: ${args.criteria}
+` : "";
+  return `You are ranking the owner's open ${args.subject} by urgency multiplied by importance.
+
+Return strict JSON only:
+{
+  "ranked": [
+    { "id": "<item id>", "score": <0..1 number>, "reasoning": "<short why>" },
+    ...
+  ]
+}
+
+- Include AT MOST ${args.topN} items.
+- Score 1.0 means drop-everything-now; 0.0 means could wait indefinitely.
+- Sort by descending score.
+- Use only the ids that appear in the input data.
+- Keep reasoning under 20 words.${criteriaLine}
+
+Items:
+${data}`;
+}
+function parseRanking(raw) {
+  if (typeof raw !== "string") return [];
+  const trimmed = raw.trim();
+  const start = trimmed.indexOf("{");
+  const end = trimmed.lastIndexOf("}");
+  if (start === -1 || end === -1 || end <= start) return [];
+  const slice = trimmed.slice(start, end + 1);
+  const parsed = (() => {
+    try {
+      return JSON.parse(slice);
+    } catch {
+      return null;
+    }
+  })();
+  if (!parsed || typeof parsed !== "object") return [];
+  const rankedRaw = parsed.ranked;
+  if (!Array.isArray(rankedRaw)) return [];
+  const entries = [];
+  for (const entry of rankedRaw) {
+    if (!entry || typeof entry !== "object") continue;
+    const obj = entry;
+    const id = typeof obj.id === "string" ? obj.id : null;
+    const score = typeof obj.score === "number" ? obj.score : null;
+    const reasoning = typeof obj.reasoning === "string" ? obj.reasoning : "";
+    if (!id || score === null) continue;
+    entries.push({ id, score, reasoning });
+  }
+  return entries;
+}
+function applyRanking(items, ranking, topN) {
+  const itemMap = new Map(items.map((item) => [item.id, item]));
+  const sorted = [...ranking].sort((a, b) => b.score - a.score);
+  const ranked = [];
+  for (const entry of sorted) {
+    const source = itemMap.get(entry.id);
+    if (!source) continue;
+    ranked.push({
+      ...source,
+      rank: ranked.length + 1,
+      score: entry.score,
+      reasoning: entry.reasoning
+    });
+    if (ranked.length >= topN) break;
+  }
+  return ranked;
+}
+const examples = [
+  [
+    { name: "{{name1}}", content: { text: "What should I focus on today?" } },
+    {
+      name: "{{agentName}}",
+      content: {
+        text: "Ranked your top todos by urgency \xD7 importance.",
+        action: ACTION_NAME
+      }
+    }
+  ],
+  [
+    {
+      name: "{{name1}}",
+      content: { text: "Which threads need my attention first?" }
+    },
+    {
+      name: "{{agentName}}",
+      content: {
+        text: "Ranked your open threads by priority.",
+        action: ACTION_NAME
+      }
+    }
+  ]
+];
+const prioritizeAction = {
+  name: ACTION_NAME,
+  similes: SIMILE_NAMES.slice(),
+  tags: [
+    "domain:focus",
+    "capability:read",
+    "capability:rank",
+    "surface:internal"
+  ],
+  description: "Rank owner open todos, message threads, pending decisions by urgency \xD7 importance. LLM pass. Subactions: rank_todos, rank_threads, rank_decisions.",
+  descriptionCompressed: "prioritize: rank_todos|rank_threads|rank_decisions; topN ranking by urgency \xD7 importance",
+  routingHint: 'prioritization ("focus on", "rank today", "which thread first", "what matters most") -> PRIORITIZE; do not use plain list -> OWNER_TODOS.list / MESSAGE.list_inbox',
+  contexts: ["focus", "tasks", "inbox", "approvals"],
+  roleGate: { minRole: "OWNER" },
+  suppressPostActionContinuation: true,
+  validate: async (runtime, message) => hasLifeOpsAccess(runtime, message),
+  parameters: [
+    {
+      name: "action",
+      description: "Prioritize op: rank_todos | rank_threads | rank_decisions.",
+      schema: { type: "string", enum: [...SUBACTIONS] }
+    },
+    {
+      name: "subject",
+      description: "Alt selector: todos | threads | decisions. Maps to subaction.",
+      schema: {
+        type: "string",
+        enum: ["todos", "threads", "decisions"]
+      }
+    },
+    {
+      name: "topN",
+      description: "Top item count. Default 5.",
+      schema: { type: "number" }
+    },
+    {
+      name: "criteria",
+      description: "Owner weighting criteria.",
+      schema: { type: "string" }
+    }
+  ],
+  examples,
+  handler: async (runtime, message, _state, options, callback) => {
+    if (!await hasLifeOpsAccess(runtime, message)) {
+      const text2 = "Prioritization is restricted to the owner.";
+      await callback?.({ text: text2 });
+      return { text: text2, success: false, data: { error: "PERMISSION_DENIED" } };
+    }
+    const params = getParams(options);
+    const subaction = resolveSubaction(params);
+    if (!subaction) {
+      return {
+        success: false,
+        text: "Tell me what to rank: rank_todos, rank_threads, or rank_decisions.",
+        data: { error: "MISSING_SUBACTION" }
+      };
+    }
+    const subject = SUBACTION_TO_SUBJECT[subaction];
+    const topN = typeof params.topN === "number" && params.topN > 0 ? Math.floor(params.topN) : 5;
+    const items = await loadItemsForSubaction(subaction, runtime);
+    if (items.length === 0) {
+      const text2 = `No open ${subject} to rank.`;
+      logger.info(`[PRIORITIZE] ${subaction} empty topN=${topN}`);
+      await callback?.({ text: text2, source: "action", action: ACTION_NAME });
+      return {
+        success: true,
+        text: text2,
+        data: {
+          subaction,
+          subject,
+          ranked: []
+        }
+      };
+    }
+    if (typeof runtime.useModel !== "function") {
+      logger.warn(
+        `[PRIORITIZE] ${subaction} runtime.useModel unavailable, returning natural order`
+      );
+      const fallbackRanked = items.slice(0, topN).map((item, index) => ({
+        ...item,
+        rank: index + 1,
+        score: 0,
+        reasoning: "model unavailable; preserved input order"
+      }));
+      const text2 = `Ranked ${fallbackRanked.length} ${subject} (model unavailable, used input order).`;
+      await callback?.({ text: text2, source: "action", action: ACTION_NAME });
+      return {
+        success: true,
+        text: text2,
+        data: {
+          subaction,
+          subject,
+          ranked: fallbackRanked,
+          warning: "MODEL_UNAVAILABLE"
+        }
+      };
+    }
+    const prompt = buildRankingPrompt({
+      subject,
+      items,
+      topN,
+      criteria: params.criteria
+    });
+    let raw;
+    try {
+      raw = await runWithTrajectoryContext(
+        { purpose: "lifeops-prioritize" },
+        () => runtime.useModel(ModelType.TEXT_LARGE, { prompt })
+      );
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      logger.error(`[PRIORITIZE] ${subaction} model call failed: ${detail}`);
+      return {
+        success: false,
+        text: `I couldn't rank your ${subject} \u2014 the language model call failed.`,
+        data: {
+          subaction,
+          subject,
+          error: "MODEL_CALL_FAILED",
+          detail
+        }
+      };
+    }
+    const parsed = parseRanking(raw);
+    const ranked = applyRanking(items, parsed, topN);
+    logger.info(
+      `[PRIORITIZE] ${subaction} ranked=${ranked.length} items=${items.length} topN=${topN}`
+    );
+    const text = ranked.length === 0 ? `Ranked 0 ${subject} \u2014 model produced no valid entries.` : `Ranked top ${ranked.length} ${subject} by urgency \xD7 importance.`;
+    await callback?.({ text, source: "action", action: ACTION_NAME });
+    return {
+      success: true,
+      text,
+      data: {
+        subaction,
+        subject,
+        ranked,
+        ...ranked.length === 0 ? { warning: "EMPTY_RANKING" } : {}
+      }
+    };
+  }
+};
+export {
+  __resetPrioritizeLoadersForTests,
+  prioritizeAction,
+  setPrioritizeLoaders
+};
+//# sourceMappingURL=prioritize.js.map

package/dist/actions/prioritize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/prioritize.ts"],"sourcesContent":["/**\n * `PRIORITIZE` umbrella action — LLM-ranked importance × urgency.\n *\n * Subactions:\n *   - `rank_todos`     — todo items in the owner's life domain\n *   - `rank_threads`   — open inbox / messaging threads\n *   - `rank_decisions` — pending approval queue decisions\n *\n * Loads items via the relevant loader hook, then calls\n * `runtime.useModel(ModelType.TEXT_LARGE)` once with a structured prompt that\n * asks for a JSON ranking by urgency × importance, with a short reasoning\n * string per item.\n *\n * Owner-only.\n */\n\nimport type {\n  Action,\n  ActionExample,\n  ActionResult,\n  HandlerCallback,\n  HandlerOptions,\n  IAgentRuntime,\n  Memory,\n} from \"@elizaos/core\";\nimport { logger, ModelType, runWithTrajectoryContext } from \"@elizaos/core\";\nimport { hasLifeOpsAccess } from \"../lifeops/access.js\";\n\nconst ACTION_NAME = \"PRIORITIZE\";\n\nconst SUBACTIONS = [\"rank_todos\", \"rank_threads\", \"rank_decisions\"] as const;\n\ntype Subaction = (typeof SUBACTIONS)[number];\n\nconst SIMILE_NAMES: readonly string[] = [\n  \"PRIORITIZE\",\n  \"RANK_TODAY\",\n  \"WHAT_MATTERS_MOST\",\n  \"PRIORITIZE_TODAY\",\n];\n\ntype Subject = \"todos\" | \"threads\" | \"decisions\";\n\nconst SUBJECT_TO_SUBACTION: Readonly<Record<Subject, Subaction>> = {\n  todos: \"rank_todos\",\n  threads: \"rank_threads\",\n  decisions: \"rank_decisions\",\n};\n\nconst SUBACTION_TO_SUBJECT: Readonly<Record<Subaction, Subject>> = {\n  rank_todos: \"todos\",\n  rank_threads: \"threads\",\n  rank_decisions: \"decisions\",\n};\n\ninterface PrioritizeActionParameters {\n  subaction?: Subaction | string;\n  action?: Subaction | string;\n  op?: Subaction | string;\n  subject?: Subject | string;\n  topN?: number;\n  criteria?: string;\n}\n\nexport interface PrioritizeRankableItem {\n  readonly id: string;\n  readonly title: string;\n  readonly summary?: string;\n  readonly dueAt?: string | null;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport interface PrioritizeRankedItem extends PrioritizeRankableItem {\n  readonly rank: number;\n  readonly score: number;\n  readonly reasoning: string;\n}\n\n/**\n * Per-subject loader hooks. Default loaders return empty lists so tests can\n * inject per-subject inputs without standing up the full service graph.\n */\nexport interface PrioritizeLoaders {\n  loadTodos: (args: {\n    runtime: IAgentRuntime;\n  }) => Promise<readonly PrioritizeRankableItem[]>;\n  loadThreads: (args: {\n    runtime: IAgentRuntime;\n  }) => Promise<readonly PrioritizeRankableItem[]>;\n  loadDecisions: (args: {\n    runtime: IAgentRuntime;\n  }) => Promise<readonly PrioritizeRankableItem[]>;\n}\n\nconst defaultLoaders: PrioritizeLoaders = {\n  loadTodos: async () => [],\n  loadThreads: async () => [],\n  loadDecisions: async () => [],\n};\n\nlet activeLoaders: PrioritizeLoaders = defaultLoaders;\n\nexport function setPrioritizeLoaders(next: Partial<PrioritizeLoaders>): void {\n  activeLoaders = { ...activeLoaders, ...next };\n}\n\nexport function __resetPrioritizeLoadersForTests(): void {\n  activeLoaders = defaultLoaders;\n}\n\nfunction getParams(\n  options: HandlerOptions | undefined,\n): PrioritizeActionParameters {\n  const raw = (options as HandlerOptions | undefined)?.parameters;\n  if (raw && typeof raw === \"object\") {\n    return raw as PrioritizeActionParameters;\n  }\n  return {};\n}\n\nfunction normalizeSubaction(value: unknown): Subaction | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return null;\n  const lower = trimmed.toLowerCase();\n  return (SUBACTIONS as readonly string[]).includes(lower)\n    ? (lower as Subaction)\n    : null;\n}\n\nfunction normalizeSubject(value: unknown): Subject | null {\n  if (typeof value !== \"string\") return null;\n  const lower = value.trim().toLowerCase();\n  if (lower === \"todos\" || lower === \"threads\" || lower === \"decisions\") {\n    return lower;\n  }\n  return null;\n}\n\nfunction resolveSubaction(\n  params: PrioritizeActionParameters,\n): Subaction | null {\n  return (\n    normalizeSubaction(params.subaction) ??\n    normalizeSubaction(params.action) ??\n    normalizeSubaction(params.op) ??\n    (() => {\n      const subject = normalizeSubject(params.subject);\n      return subject ? SUBJECT_TO_SUBACTION[subject] : null;\n    })()\n  );\n}\n\nasync function loadItemsForSubaction(\n  subaction: Subaction,\n  runtime: IAgentRuntime,\n): Promise<readonly PrioritizeRankableItem[]> {\n  switch (subaction) {\n    case \"rank_todos\":\n      return activeLoaders.loadTodos({ runtime });\n    case \"rank_threads\":\n      return activeLoaders.loadThreads({ runtime });\n    case \"rank_decisions\":\n      return activeLoaders.loadDecisions({ runtime });\n  }\n}\n\nfunction buildRankingPrompt(args: {\n  subject: Subject;\n  items: readonly PrioritizeRankableItem[];\n  topN: number;\n  criteria?: string;\n}): string {\n  const data = JSON.stringify(args.items, null, 2);\n  const criteriaLine = args.criteria\n    ? `\\nAdditional criteria from the owner: ${args.criteria}\\n`\n    : \"\";\n  return `You are ranking the owner's open ${args.subject} by urgency multiplied by importance.\n\nReturn strict JSON only:\n{\n  \"ranked\": [\n    { \"id\": \"<item id>\", \"score\": <0..1 number>, \"reasoning\": \"<short why>\" },\n    ...\n  ]\n}\n\n- Include AT MOST ${args.topN} items.\n- Score 1.0 means drop-everything-now; 0.0 means could wait indefinitely.\n- Sort by descending score.\n- Use only the ids that appear in the input data.\n- Keep reasoning under 20 words.${criteriaLine}\n\nItems:\n${data}`;\n}\n\ninterface RawRankingEntry {\n  readonly id: string;\n  readonly score: number;\n  readonly reasoning: string;\n}\n\nfunction parseRanking(raw: unknown): readonly RawRankingEntry[] {\n  if (typeof raw !== \"string\") return [];\n  const trimmed = raw.trim();\n  const start = trimmed.indexOf(\"{\");\n  const end = trimmed.lastIndexOf(\"}\");\n  if (start === -1 || end === -1 || end <= start) return [];\n  const slice = trimmed.slice(start, end + 1);\n  const parsed: unknown = (() => {\n    try {\n      return JSON.parse(slice);\n    } catch {\n      return null;\n    }\n  })();\n  if (!parsed || typeof parsed !== \"object\") return [];\n  const rankedRaw = (parsed as { ranked?: unknown }).ranked;\n  if (!Array.isArray(rankedRaw)) return [];\n  const entries: RawRankingEntry[] = [];\n  for (const entry of rankedRaw) {\n    if (!entry || typeof entry !== \"object\") continue;\n    const obj = entry as Record<string, unknown>;\n    const id = typeof obj.id === \"string\" ? obj.id : null;\n    const score = typeof obj.score === \"number\" ? obj.score : null;\n    const reasoning = typeof obj.reasoning === \"string\" ? obj.reasoning : \"\";\n    if (!id || score === null) continue;\n    entries.push({ id, score, reasoning });\n  }\n  return entries;\n}\n\nfunction applyRanking(\n  items: readonly PrioritizeRankableItem[],\n  ranking: readonly RawRankingEntry[],\n  topN: number,\n): readonly PrioritizeRankedItem[] {\n  const itemMap = new Map(items.map((item) => [item.id, item]));\n  const sorted = [...ranking].sort((a, b) => b.score - a.score);\n  const ranked: PrioritizeRankedItem[] = [];\n  for (const entry of sorted) {\n    const source = itemMap.get(entry.id);\n    if (!source) continue;\n    ranked.push({\n      ...source,\n      rank: ranked.length + 1,\n      score: entry.score,\n      reasoning: entry.reasoning,\n    });\n    if (ranked.length >= topN) break;\n  }\n  return ranked;\n}\n\nconst examples: ActionExample[][] = [\n  [\n    { name: \"{{name1}}\", content: { text: \"What should I focus on today?\" } },\n    {\n      name: \"{{agentName}}\",\n      content: {\n        text: \"Ranked your top todos by urgency × importance.\",\n        action: ACTION_NAME,\n      },\n    },\n  ],\n  [\n    {\n      name: \"{{name1}}\",\n      content: { text: \"Which threads need my attention first?\" },\n    },\n    {\n      name: \"{{agentName}}\",\n      content: {\n        text: \"Ranked your open threads by priority.\",\n        action: ACTION_NAME,\n      },\n    },\n  ],\n];\n\nexport const prioritizeAction: Action & {\n  suppressPostActionContinuation?: boolean;\n} = {\n  name: ACTION_NAME,\n  similes: SIMILE_NAMES.slice(),\n  tags: [\n    \"domain:focus\",\n    \"capability:read\",\n    \"capability:rank\",\n    \"surface:internal\",\n  ],\n  description:\n    \"Rank owner open todos, message threads, pending decisions by urgency × importance. LLM pass. Subactions: rank_todos, rank_threads, rank_decisions.\",\n  descriptionCompressed:\n    \"prioritize: rank_todos|rank_threads|rank_decisions; topN ranking by urgency × importance\",\n  routingHint:\n    'prioritization (\"focus on\", \"rank today\", \"which thread first\", \"what matters most\") -> PRIORITIZE; do not use plain list -> OWNER_TODOS.list / MESSAGE.list_inbox',\n  contexts: [\"focus\", \"tasks\", \"inbox\", \"approvals\"],\n  roleGate: { minRole: \"OWNER\" },\n  suppressPostActionContinuation: true,\n  validate: async (runtime, message) => hasLifeOpsAccess(runtime, message),\n  parameters: [\n    {\n      name: \"action\",\n      description: \"Prioritize op: rank_todos | rank_threads | rank_decisions.\",\n      schema: { type: \"string\" as const, enum: [...SUBACTIONS] },\n    },\n    {\n      name: \"subject\",\n      description:\n        \"Alt selector: todos | threads | decisions. Maps to subaction.\",\n      schema: {\n        type: \"string\" as const,\n        enum: [\"todos\", \"threads\", \"decisions\"],\n      },\n    },\n    {\n      name: \"topN\",\n      description: \"Top item count. Default 5.\",\n      schema: { type: \"number\" as const },\n    },\n    {\n      name: \"criteria\",\n      description: \"Owner weighting criteria.\",\n      schema: { type: \"string\" as const },\n    },\n  ],\n  examples,\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    _state,\n    options,\n    callback: HandlerCallback | undefined,\n  ): Promise<ActionResult> => {\n    if (!(await hasLifeOpsAccess(runtime, message))) {\n      const text = \"Prioritization is restricted to the owner.\";\n      await callback?.({ text });\n      return { text, success: false, data: { error: \"PERMISSION_DENIED\" } };\n    }\n\n    const params = getParams(options);\n    const subaction = resolveSubaction(params);\n    if (!subaction) {\n      return {\n        success: false,\n        text: \"Tell me what to rank: rank_todos, rank_threads, or rank_decisions.\",\n        data: { error: \"MISSING_SUBACTION\" },\n      };\n    }\n\n    const subject = SUBACTION_TO_SUBJECT[subaction];\n    const topN =\n      typeof params.topN === \"number\" && params.topN > 0\n        ? Math.floor(params.topN)\n        : 5;\n\n    const items = await loadItemsForSubaction(subaction, runtime);\n    if (items.length === 0) {\n      const text = `No open ${subject} to rank.`;\n      logger.info(`[PRIORITIZE] ${subaction} empty topN=${topN}`);\n      await callback?.({ text, source: \"action\", action: ACTION_NAME });\n      return {\n        success: true,\n        text,\n        data: {\n          subaction,\n          subject,\n          ranked: [] as readonly PrioritizeRankedItem[],\n        },\n      };\n    }\n\n    if (typeof runtime.useModel !== \"function\") {\n      logger.warn(\n        `[PRIORITIZE] ${subaction} runtime.useModel unavailable, returning natural order`,\n      );\n      const fallbackRanked = items\n        .slice(0, topN)\n        .map<PrioritizeRankedItem>((item, index) => ({\n          ...item,\n          rank: index + 1,\n          score: 0,\n          reasoning: \"model unavailable; preserved input order\",\n        }));\n      const text = `Ranked ${fallbackRanked.length} ${subject} (model unavailable, used input order).`;\n      await callback?.({ text, source: \"action\", action: ACTION_NAME });\n      return {\n        success: true,\n        text,\n        data: {\n          subaction,\n          subject,\n          ranked: fallbackRanked,\n          warning: \"MODEL_UNAVAILABLE\",\n        },\n      };\n    }\n\n    const prompt = buildRankingPrompt({\n      subject,\n      items,\n      topN,\n      criteria: params.criteria,\n    });\n\n    let raw: unknown;\n    try {\n      raw = await runWithTrajectoryContext(\n        { purpose: \"lifeops-prioritize\" },\n        () => runtime.useModel(ModelType.TEXT_LARGE, { prompt }),\n      );\n    } catch (error) {\n      const detail = error instanceof Error ? error.message : String(error);\n      logger.error(`[PRIORITIZE] ${subaction} model call failed: ${detail}`);\n      return {\n        success: false,\n        text: `I couldn't rank your ${subject} — the language model call failed.`,\n        data: {\n          subaction,\n          subject,\n          error: \"MODEL_CALL_FAILED\",\n          detail,\n        },\n      };\n    }\n\n    const parsed = parseRanking(raw);\n    const ranked = applyRanking(items, parsed, topN);\n\n    logger.info(\n      `[PRIORITIZE] ${subaction} ranked=${ranked.length} items=${items.length} topN=${topN}`,\n    );\n\n    const text =\n      ranked.length === 0\n        ? `Ranked 0 ${subject} — model produced no valid entries.`\n        : `Ranked top ${ranked.length} ${subject} by urgency × importance.`;\n\n    await callback?.({ text, source: \"action\", action: ACTION_NAME });\n\n    return {\n      success: true,\n      text,\n      data: {\n        subaction,\n        subject,\n        ranked,\n        ...(ranked.length === 0 ? { warning: \"EMPTY_RANKING\" } : {}),\n      },\n    };\n  },\n};\n"],"mappings":"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","names":["text"]}