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

package/dist/actions/lib/extract-life-operation.js

@@ -0,0 +1,318 @@
+import {
+  ModelType,
+  parseJsonModelRecord,
+  runExtractorPipeline,
+  runWithTrajectoryContext
+} from "@elizaos/core";
+import { getRecentMessagesData } from "@elizaos/shared";
+import { resolveContextWindow } from "../../lifeops/defaults.js";
+const LIFE_OPERATION_VALUES = [
+  "create",
+  "update",
+  "delete",
+  "complete",
+  "skip",
+  "snooze",
+  "review",
+  // Owner policy verbs — write reminder intensity / escalation rules on
+  // OwnerFactStore.
+  "policy_set_reminder",
+  "policy_configure_escalation",
+  "query_calendar_today",
+  "query_calendar_next",
+  "query_email",
+  "query_overview"
+];
+function messageText(message) {
+  const text = message.content.text;
+  return typeof text === "string" ? text.trim() : "";
+}
+function splitStateTextCandidates(value) {
+  return value.split(/\n+/).map(
+    (line) => line.replace(
+      /^[a-zA-Z\u00C0-\u024F\u0400-\u04FF\u3000-\u9FFF]{1,20}\s*:\s*/,
+      ""
+    ).trim()
+  ).filter((line) => line.length > 0);
+}
+function stateTextCandidates(state) {
+  if (!state || typeof state !== "object") {
+    return [];
+  }
+  const stateRecord = state;
+  const values = stateRecord.values && typeof stateRecord.values === "object" ? stateRecord.values : void 0;
+  const candidates = [];
+  const pushText = (value) => {
+    if (typeof value === "string" && value.trim().length > 0) {
+      candidates.push(...splitStateTextCandidates(value));
+    }
+  };
+  pushText(values?.recentMessages);
+  pushText(stateRecord.text);
+  for (const item of getRecentMessagesData(state)) {
+    const content = item.content;
+    if (!content || typeof content !== "object") {
+      continue;
+    }
+    pushText(content.text);
+  }
+  return [...new Set(candidates)];
+}
+function normalizeOperation(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.trim().toLowerCase();
+  return LIFE_OPERATION_VALUES.includes(normalized) ? normalized : null;
+}
+function normalizeConfidence(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return Math.max(0, Math.min(1, value));
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) {
+      return Math.max(0, Math.min(1, parsed));
+    }
+  }
+  return null;
+}
+function normalizeShouldAct(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true") {
+      return true;
+    }
+    if (normalized === "false") {
+      return false;
+    }
+  }
+  return null;
+}
+const VALID_MISSING_FIELDS = /* @__PURE__ */ new Set([
+  "title",
+  "schedule",
+  "target",
+  "goal",
+  "details"
+]);
+function normalizeMissingFields(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  const missing = [];
+  for (const item of value) {
+    if (typeof item !== "string") {
+      continue;
+    }
+    const normalized = item.trim().toLowerCase();
+    if (VALID_MISSING_FIELDS.has(normalized) && !missing.includes(normalized)) {
+      missing.push(normalized);
+    }
+  }
+  return missing;
+}
+const REPLY_ONLY_OPERATION_PLAN = {
+  operation: null,
+  confidence: 0,
+  missing: [],
+  shouldAct: false
+};
+function promptText(value) {
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : "(empty)";
+}
+function normalizeOperationPlan(parsed) {
+  const operation = normalizeOperation(parsed.operation);
+  const missing = normalizeMissingFields(parsed.missing);
+  const shouldAct = normalizeShouldAct(parsed.shouldAct) ?? (operation ? missing.length === 0 : null);
+  if (shouldAct === null) {
+    return null;
+  }
+  if (shouldAct && operation === null) {
+    return null;
+  }
+  return {
+    operation,
+    confidence: normalizeConfidence(parsed.confidence) ?? 0,
+    missing,
+    shouldAct
+  };
+}
+function buildRepairPrompt(args) {
+  return [
+    "Your last reply for the LifeOps operation planner was invalid.",
+    "Return ONLY a JSON object with exactly these fields:",
+    "  operation: one of the allowed operations, or null when this should be reply-only/no-op",
+    "  confidence: number from 0 to 1",
+    "  shouldAct: boolean",
+    "  missing: list of missing fields from title, schedule, target, goal, phone_number, reminder_intensity, details",
+    "",
+    "Do not add prose, markdown, code fences, or any other format.",
+    "",
+    `Allowed operations: ${LIFE_OPERATION_VALUES.join(", ")}, or null`,
+    `Current request: ${promptText(args.currentMessage)}`,
+    `Resolved intent: ${promptText(args.intent)}`,
+    "Recent conversation:",
+    promptText(args.recentConversation.join("\n")),
+    "Previous invalid output:",
+    promptText(args.rawResponse)
+  ].join("\n");
+}
+function normalizeCoreLifeOperation(value) {
+  switch (value) {
+    case "create":
+    case "complete":
+    case "snooze":
+    case "query_overview":
+      return value;
+    default:
+      return null;
+  }
+}
+function normalizeCoreLifeOperationPlan(parsed) {
+  const operation = normalizeCoreLifeOperation(parsed.operation);
+  const missing = normalizeMissingFields(parsed.missing);
+  const shouldAct = normalizeShouldAct(parsed.shouldAct) ?? (operation ? missing.length === 0 : null);
+  if (shouldAct === null) {
+    return null;
+  }
+  if (shouldAct && operation === null) {
+    return null;
+  }
+  return {
+    operation,
+    confidence: normalizeConfidence(parsed.confidence) ?? 0,
+    missing,
+    shouldAct
+  };
+}
+async function recoverCoreLifeOperationWithLlm(args) {
+  const prompt = [
+    "Recover the core LifeOps intent for this request.",
+    "The user may speak in any language.",
+    "Choose the closest operation from: create, complete, snooze, query_overview, or null.",
+    "create is for creating a reminder, alarm, routine, recurring task, or goal.",
+    "complete is for saying the user already did something.",
+    "snooze is for deferring or postponing something to later.",
+    "query_overview is for asking what is still left, active, or remaining today.",
+    "Use null only when the request is casual chat or not a core LifeOps action.",
+    "",
+    "Return ONLY a JSON object with exactly these fields:",
+    "  operation: create, complete, snooze, query_overview, or null",
+    "  confidence: number from 0 to 1",
+    "  shouldAct: boolean",
+    "  missing: list of missing fields from title, schedule, target, goal, details",
+    "",
+    'Example: {"operation":"create","confidence":0.95,"shouldAct":true,"missing":[]}',
+    "",
+    `Current request: ${promptText(args.currentMessage)}`,
+    `Resolved intent: ${promptText(args.intent)}`,
+    "Recent conversation:",
+    promptText(args.recentConversation.join("\n"))
+  ].join("\n");
+  try {
+    const result = await runWithTrajectoryContext(
+      { purpose: "lifeops-extract-life-operation" },
+      () => args.runtime.useModel(ModelType.TEXT_LARGE, {
+        prompt
+      })
+    );
+    const rawResponse = typeof result === "string" ? result : "";
+    const parsed = parseJsonModelRecord(rawResponse);
+    return parsed ? normalizeCoreLifeOperationPlan(parsed) : null;
+  } catch (error) {
+    args.runtime.logger.warn(
+      {
+        src: "action:life",
+        error: error instanceof Error ? error.message : String(error)
+      },
+      "Core LifeOps recovery model call failed"
+    );
+    return null;
+  }
+}
+async function extractLifeOperationWithLlm(args) {
+  const { runtime, message, state, intent } = args;
+  const recentConversation = stateTextCandidates(state).slice(
+    -resolveContextWindow()
+  );
+  const currentMessage = messageText(message);
+  const prompt = [
+    "Plan the LifeOps response for the current user request.",
+    "The user may speak in any language.",
+    "Use the current request plus recent conversation context.",
+    "Short follow-ups can continue an earlier alarm or reminder request when that context appears in the recent conversation.",
+    "You are allowed to decide that the assistant should reply naturally without acting yet.",
+    "Set shouldAct=false when the user is chatting, acknowledging, brainstorming, or asking for help in a way that is too vague to safely create, update, complete, or query anything yet.",
+    "When the user clearly wants a LifeOps action but key information is missing, set operation to the closest operation, shouldAct=false, and list the blocking pieces in missing.",
+    "Only set shouldAct=true when the assistant should execute, preview, update, or query right now.",
+    "Requests with concrete routine content and interpretable cadence are actionable even when some fields are implied.",
+    "Treat requests like weekdays after lunch, during the day, every morning, tomorrow at 9, set an alarm for 7 am, and remind me about my Invisalign as specific enough to act on now.",
+    "A goal horizon like this year, this month, by June, or before my trip does not create a routine cadence by itself.",
+    "Use create with a goal-flavored intent for aspirations with a target or horizon unless the user explicitly asks for reminders, recurrence, or a routine schedule.",
+    "",
+    "Return a JSON object with exactly these fields:",
+    "  operation: one of the allowed operations below, or null when this should be reply-only/no-op",
+    "  confidence: number from 0 to 1",
+    "  shouldAct: boolean",
+    "  missing: list of missing fields from title, schedule, target, goal, details",
+    "",
+    "Operations and when to use each:",
+    "  create \u2014 create a new habit, routine, task, one-off alarm, reminder, or aspirational goal (e.g. 'remind me to brush my teeth every night', 'set an alarm for 7am', 'I want to run a marathon')",
+    "  update \u2014 edit, rename, reschedule, or modify an existing task/habit/routine/goal (e.g. 'change my workout to 6am', 'update my marathon goal to June')",
+    "  delete \u2014 delete, remove, cancel, or stop tracking a task/habit/routine/goal (e.g. 'stop tracking my meditation', 'delete my marathon goal')",
+    "  complete \u2014 mark an item as done (e.g. 'I brushed my teeth', 'done with workout', 'I did it')",
+    "  skip \u2014 skip an item for today (e.g. 'skip brushing', 'not today', 'pass on workout')",
+    "  snooze \u2014 postpone or defer an item (e.g. 'snooze', 'remind me later', 'push it back')",
+    "  review \u2014 check progress on a goal or ask for a weekly goal review (e.g. 'how am I doing on my marathon goal', 'review my progress')",
+    "  query_calendar_today \u2014 today's/tomorrow's/this week's schedule (e.g. 'what's on my calendar today')",
+    "  query_calendar_next \u2014 next upcoming event (e.g. 'what's my next meeting')",
+    "  query_email \u2014 inbox/email status (e.g. 'any new emails', 'who emailed me')",
+    `  query_overview \u2014 broad status summary or remaining LifeOps items (e.g. 'what's active', 'show me everything', 'overview', "what's still left for today", 'what do i still need to do today')`,
+    "",
+    'Example complete: {"operation":"complete","confidence":0.95,"shouldAct":true,"missing":[]}',
+    'Example clarify: {"operation":"create","confidence":0.82,"shouldAct":false,"missing":["title","schedule"]}',
+    "",
+    "Return ONLY valid JSON. No prose. No markdown. No code fences. No <think>.",
+    "",
+    `Allowed operations: ${LIFE_OPERATION_VALUES.join(", ")}, or null`,
+    `Current request: ${promptText(currentMessage)}`,
+    `Resolved intent: ${promptText(intent)}`,
+    "Recent conversation:",
+    promptText(recentConversation.join("\n"))
+  ].join("\n");
+  const parseResponse = (rawResponse) => {
+    const parsed = parseJsonModelRecord(rawResponse);
+    return parsed ? normalizeOperationPlan(parsed) : null;
+  };
+  const { parsed: pipelinePlan } = await runExtractorPipeline({
+    runtime,
+    prompt,
+    parser: parseResponse,
+    buildRepairPrompt: (rawFirstPass) => buildRepairPrompt({
+      currentMessage,
+      intent,
+      rawResponse: rawFirstPass,
+      recentConversation
+    })
+  });
+  if (pipelinePlan && pipelinePlan.operation !== null) {
+    return pipelinePlan;
+  }
+  const recoveredPlan = await recoverCoreLifeOperationWithLlm({
+    runtime,
+    currentMessage,
+    intent,
+    recentConversation
+  });
+  return recoveredPlan ?? pipelinePlan ?? REPLY_ONLY_OPERATION_PLAN;
+}
+export {
+  LIFE_OPERATION_VALUES,
+  extractLifeOperationWithLlm
+};
+//# sourceMappingURL=extract-life-operation.js.map

package/dist/actions/lib/extract-life-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/lib/extract-life-operation.ts"],"sourcesContent":["import type { IAgentRuntime, Memory, State } from \"@elizaos/core\";\nimport {\n  ModelType,\n  parseJsonModelRecord,\n  runExtractorPipeline,\n  runWithTrajectoryContext,\n} from \"@elizaos/core\";\nimport { getRecentMessagesData } from \"@elizaos/shared\";\nimport { resolveContextWindow } from \"../../lifeops/defaults.js\";\n\nexport const LIFE_OPERATION_VALUES = [\n  \"create\",\n  \"update\",\n  \"delete\",\n  \"complete\",\n  \"skip\",\n  \"snooze\",\n  \"review\",\n  // Owner policy verbs — write reminder intensity / escalation rules on\n  // OwnerFactStore.\n  \"policy_set_reminder\",\n  \"policy_configure_escalation\",\n  \"query_calendar_today\",\n  \"query_calendar_next\",\n  \"query_email\",\n  \"query_overview\",\n] as const;\n\nexport type ExtractedLifeOperation = (typeof LIFE_OPERATION_VALUES)[number];\nexport type ExtractedLifeMissingField =\n  | \"title\"\n  | \"schedule\"\n  | \"target\"\n  | \"goal\"\n  | \"details\";\n\ntype ExtractedLifeOperationPlan = {\n  operation: ExtractedLifeOperation | null;\n  confidence: number;\n  missing: ExtractedLifeMissingField[];\n  shouldAct: boolean;\n};\n\ntype CoreLifeOperation =\n  | \"create\"\n  | \"complete\"\n  | \"snooze\"\n  | \"query_overview\"\n  | null;\n\nfunction messageText(message: Memory): string {\n  const text = message.content.text;\n  return typeof text === \"string\" ? text.trim() : \"\";\n}\n\nfunction splitStateTextCandidates(value: string): string[] {\n  return value\n    .split(/\\n+/)\n    .map((line) =>\n      line\n        .replace(\n          /^[a-zA-Z\\u00C0-\\u024F\\u0400-\\u04FF\\u3000-\\u9FFF]{1,20}\\s*:\\s*/,\n          \"\",\n        )\n        .trim(),\n    )\n    .filter((line) => line.length > 0);\n}\n\nfunction stateTextCandidates(state: State | undefined): string[] {\n  if (!state || typeof state !== \"object\") {\n    return [];\n  }\n\n  const stateRecord = state as Record<string, unknown>;\n  const values =\n    stateRecord.values && typeof stateRecord.values === \"object\"\n      ? (stateRecord.values as Record<string, unknown>)\n      : undefined;\n\n  const candidates: string[] = [];\n  const pushText = (value: unknown) => {\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      candidates.push(...splitStateTextCandidates(value));\n    }\n  };\n\n  pushText(values?.recentMessages);\n  pushText(stateRecord.text);\n\n  for (const item of getRecentMessagesData(state)) {\n    const content = item.content;\n    if (!content || typeof content !== \"object\") {\n      continue;\n    }\n    pushText(content.text);\n  }\n\n  return [...new Set(candidates)];\n}\n\nfunction normalizeOperation(value: unknown): ExtractedLifeOperation | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n\n  const normalized = value.trim().toLowerCase();\n  return LIFE_OPERATION_VALUES.includes(normalized as ExtractedLifeOperation)\n    ? (normalized as ExtractedLifeOperation)\n    : null;\n}\n\nfunction normalizeConfidence(value: unknown): number | null {\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    return Math.max(0, Math.min(1, value));\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) {\n      return Math.max(0, Math.min(1, parsed));\n    }\n  }\n  return null;\n}\n\nfunction normalizeShouldAct(value: unknown): boolean | null {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === \"true\") {\n      return true;\n    }\n    if (normalized === \"false\") {\n      return false;\n    }\n  }\n  return null;\n}\n\nconst VALID_MISSING_FIELDS = new Set<ExtractedLifeMissingField>([\n  \"title\",\n  \"schedule\",\n  \"target\",\n  \"goal\",\n  \"details\",\n]);\n\nfunction normalizeMissingFields(value: unknown): ExtractedLifeMissingField[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  const missing: ExtractedLifeMissingField[] = [];\n  for (const item of value) {\n    if (typeof item !== \"string\") {\n      continue;\n    }\n    const normalized = item.trim().toLowerCase() as ExtractedLifeMissingField;\n    if (VALID_MISSING_FIELDS.has(normalized) && !missing.includes(normalized)) {\n      missing.push(normalized);\n    }\n  }\n  return missing;\n}\n\nconst REPLY_ONLY_OPERATION_PLAN: ExtractedLifeOperationPlan = {\n  operation: null,\n  confidence: 0,\n  missing: [],\n  shouldAct: false,\n};\n\nfunction promptText(value: string): string {\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : \"(empty)\";\n}\n\nfunction normalizeOperationPlan(\n  parsed: Record<string, unknown>,\n): ExtractedLifeOperationPlan | null {\n  const operation = normalizeOperation(parsed.operation);\n  const missing = normalizeMissingFields(parsed.missing);\n  const shouldAct =\n    normalizeShouldAct(parsed.shouldAct) ??\n    (operation ? missing.length === 0 : null);\n  if (shouldAct === null) {\n    return null;\n  }\n\n  // Acting without a concrete operation is invalid; keep the plan reply-only.\n  if (shouldAct && operation === null) {\n    return null;\n  }\n\n  return {\n    operation,\n    confidence: normalizeConfidence(parsed.confidence) ?? 0,\n    missing,\n    shouldAct,\n  };\n}\n\nfunction buildRepairPrompt(args: {\n  currentMessage: string;\n  intent: string;\n  rawResponse: string;\n  recentConversation: string[];\n}): string {\n  return [\n    \"Your last reply for the LifeOps operation planner was invalid.\",\n    \"Return ONLY a JSON object with exactly these fields:\",\n    \"  operation: one of the allowed operations, or null when this should be reply-only/no-op\",\n    \"  confidence: number from 0 to 1\",\n    \"  shouldAct: boolean\",\n    \"  missing: list of missing fields from title, schedule, target, goal, phone_number, reminder_intensity, details\",\n    \"\",\n    \"Do not add prose, markdown, code fences, or any other format.\",\n    \"\",\n    `Allowed operations: ${LIFE_OPERATION_VALUES.join(\", \")}, or null`,\n    `Current request: ${promptText(args.currentMessage)}`,\n    `Resolved intent: ${promptText(args.intent)}`,\n    \"Recent conversation:\",\n    promptText(args.recentConversation.join(\"\\n\")),\n    \"Previous invalid output:\",\n    promptText(args.rawResponse),\n  ].join(\"\\n\");\n}\n\nfunction normalizeCoreLifeOperation(value: unknown): CoreLifeOperation {\n  switch (value) {\n    case \"create\":\n    case \"complete\":\n    case \"snooze\":\n    case \"query_overview\":\n      return value;\n    default:\n      return null;\n  }\n}\n\nfunction normalizeCoreLifeOperationPlan(\n  parsed: Record<string, unknown>,\n): ExtractedLifeOperationPlan | null {\n  const operation = normalizeCoreLifeOperation(parsed.operation);\n  const missing = normalizeMissingFields(parsed.missing);\n  const shouldAct =\n    normalizeShouldAct(parsed.shouldAct) ??\n    (operation ? missing.length === 0 : null);\n  if (shouldAct === null) {\n    return null;\n  }\n\n  if (shouldAct && operation === null) {\n    return null;\n  }\n\n  return {\n    operation,\n    confidence: normalizeConfidence(parsed.confidence) ?? 0,\n    missing,\n    shouldAct,\n  };\n}\n\nasync function recoverCoreLifeOperationWithLlm(args: {\n  runtime: IAgentRuntime;\n  currentMessage: string;\n  intent: string;\n  recentConversation: string[];\n}): Promise<ExtractedLifeOperationPlan | null> {\n  const prompt = [\n    \"Recover the core LifeOps intent for this request.\",\n    \"The user may speak in any language.\",\n    \"Choose the closest operation from: create, complete, snooze, query_overview, or null.\",\n    \"create is for creating a reminder, alarm, routine, recurring task, or goal.\",\n    \"complete is for saying the user already did something.\",\n    \"snooze is for deferring or postponing something to later.\",\n    \"query_overview is for asking what is still left, active, or remaining today.\",\n    \"Use null only when the request is casual chat or not a core LifeOps action.\",\n    \"\",\n    \"Return ONLY a JSON object with exactly these fields:\",\n    \"  operation: create, complete, snooze, query_overview, or null\",\n    \"  confidence: number from 0 to 1\",\n    \"  shouldAct: boolean\",\n    \"  missing: list of missing fields from title, schedule, target, goal, details\",\n    \"\",\n    'Example: {\"operation\":\"create\",\"confidence\":0.95,\"shouldAct\":true,\"missing\":[]}',\n    \"\",\n    `Current request: ${promptText(args.currentMessage)}`,\n    `Resolved intent: ${promptText(args.intent)}`,\n    \"Recent conversation:\",\n    promptText(args.recentConversation.join(\"\\n\")),\n  ].join(\"\\n\");\n\n  try {\n    const result = await runWithTrajectoryContext(\n      { purpose: \"lifeops-extract-life-operation\" },\n      () =>\n        args.runtime.useModel(ModelType.TEXT_LARGE, {\n          prompt,\n        }),\n    );\n    const rawResponse = typeof result === \"string\" ? result : \"\";\n    const parsed = parseJsonModelRecord<Record<string, unknown>>(rawResponse);\n    return parsed ? normalizeCoreLifeOperationPlan(parsed) : null;\n  } catch (error) {\n    args.runtime.logger.warn(\n      {\n        src: \"action:life\",\n        error: error instanceof Error ? error.message : String(error),\n      },\n      \"Core LifeOps recovery model call failed\",\n    );\n    return null;\n  }\n}\n\nexport async function extractLifeOperationWithLlm(args: {\n  runtime: IAgentRuntime;\n  message: Memory;\n  state: State | undefined;\n  intent: string;\n}): Promise<ExtractedLifeOperationPlan> {\n  const { runtime, message, state, intent } = args;\n  const recentConversation = stateTextCandidates(state).slice(\n    -resolveContextWindow(),\n  );\n  const currentMessage = messageText(message);\n  const prompt = [\n    \"Plan the LifeOps response for the current user request.\",\n    \"The user may speak in any language.\",\n    \"Use the current request plus recent conversation context.\",\n    \"Short follow-ups can continue an earlier alarm or reminder request when that context appears in the recent conversation.\",\n    \"You are allowed to decide that the assistant should reply naturally without acting yet.\",\n    \"Set shouldAct=false when the user is chatting, acknowledging, brainstorming, or asking for help in a way that is too vague to safely create, update, complete, or query anything yet.\",\n    \"When the user clearly wants a LifeOps action but key information is missing, set operation to the closest operation, shouldAct=false, and list the blocking pieces in missing.\",\n    \"Only set shouldAct=true when the assistant should execute, preview, update, or query right now.\",\n    \"Requests with concrete routine content and interpretable cadence are actionable even when some fields are implied.\",\n    \"Treat requests like weekdays after lunch, during the day, every morning, tomorrow at 9, set an alarm for 7 am, and remind me about my Invisalign as specific enough to act on now.\",\n    \"A goal horizon like this year, this month, by June, or before my trip does not create a routine cadence by itself.\",\n    \"Use create with a goal-flavored intent for aspirations with a target or horizon unless the user explicitly asks for reminders, recurrence, or a routine schedule.\",\n    \"\",\n    \"Return a JSON object with exactly these fields:\",\n    \"  operation: one of the allowed operations below, or null when this should be reply-only/no-op\",\n    \"  confidence: number from 0 to 1\",\n    \"  shouldAct: boolean\",\n    \"  missing: list of missing fields from title, schedule, target, goal, details\",\n    \"\",\n    \"Operations and when to use each:\",\n    \"  create — create a new habit, routine, task, one-off alarm, reminder, or aspirational goal (e.g. 'remind me to brush my teeth every night', 'set an alarm for 7am', 'I want to run a marathon')\",\n    \"  update — edit, rename, reschedule, or modify an existing task/habit/routine/goal (e.g. 'change my workout to 6am', 'update my marathon goal to June')\",\n    \"  delete — delete, remove, cancel, or stop tracking a task/habit/routine/goal (e.g. 'stop tracking my meditation', 'delete my marathon goal')\",\n    \"  complete — mark an item as done (e.g. 'I brushed my teeth', 'done with workout', 'I did it')\",\n    \"  skip — skip an item for today (e.g. 'skip brushing', 'not today', 'pass on workout')\",\n    \"  snooze — postpone or defer an item (e.g. 'snooze', 'remind me later', 'push it back')\",\n    \"  review — check progress on a goal or ask for a weekly goal review (e.g. 'how am I doing on my marathon goal', 'review my progress')\",\n    \"  query_calendar_today — today's/tomorrow's/this week's schedule (e.g. 'what's on my calendar today')\",\n    \"  query_calendar_next — next upcoming event (e.g. 'what's my next meeting')\",\n    \"  query_email — inbox/email status (e.g. 'any new emails', 'who emailed me')\",\n    \"  query_overview — broad status summary or remaining LifeOps items (e.g. 'what's active', 'show me everything', 'overview', \\\"what's still left for today\\\", 'what do i still need to do today')\",\n    \"\",\n    'Example complete: {\"operation\":\"complete\",\"confidence\":0.95,\"shouldAct\":true,\"missing\":[]}',\n    'Example clarify: {\"operation\":\"create\",\"confidence\":0.82,\"shouldAct\":false,\"missing\":[\"title\",\"schedule\"]}',\n    \"\",\n    \"Return ONLY valid JSON. No prose. No markdown. No code fences. No <think>.\",\n    \"\",\n    `Allowed operations: ${LIFE_OPERATION_VALUES.join(\", \")}, or null`,\n    `Current request: ${promptText(currentMessage)}`,\n    `Resolved intent: ${promptText(intent)}`,\n    \"Recent conversation:\",\n    promptText(recentConversation.join(\"\\n\")),\n  ].join(\"\\n\");\n\n  const parseResponse = (rawResponse: string) => {\n    const parsed = parseJsonModelRecord<Record<string, unknown>>(rawResponse);\n    return parsed ? normalizeOperationPlan(parsed) : null;\n  };\n\n  const { parsed: pipelinePlan } = await runExtractorPipeline({\n    runtime,\n    prompt,\n    parser: parseResponse,\n    buildRepairPrompt: (rawFirstPass) =>\n      buildRepairPrompt({\n        currentMessage,\n        intent,\n        rawResponse: rawFirstPass,\n        recentConversation,\n      }),\n  });\n\n  if (pipelinePlan && pipelinePlan.operation !== null) {\n    return pipelinePlan;\n  }\n\n  const recoveredPlan = await recoverCoreLifeOperationWithLlm({\n    runtime,\n    currentMessage,\n    intent,\n    recentConversation,\n  });\n  return recoveredPlan ?? pipelinePlan ?? REPLY_ONLY_OPERATION_PLAN;\n}\n"],"mappings":"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","names":[]}

package/dist/actions/lib/extract-task-plan.d.ts

@@ -0,0 +1,78 @@
+/**
+ * LLM planning and structured extraction for LifeOps task creation.
+ *
+ * Performs a second LLM call (TEXT_LARGE) after operation classification
+ * to decide whether the current create_definition request should:
+ * 1. create or preview a LifeOps item now, or
+ * 2. reply/clarify without creating anything yet.
+ *
+ * When creation is appropriate, the same response also extracts structured
+ * fields — title, cadence, priority, time-of-day, etc. — from natural
+ * language so life.ts can stay on an LLM-driven extraction path.
+ */
+import type { IAgentRuntime, Memory, State } from "@elizaos/core";
+export interface ExtractedTaskParams {
+    requestKind: "alarm" | "reminder" | null;
+    title: string | null;
+    description: string | null;
+    cadenceKind: "once" | "daily" | "weekly" | "times_per_day" | "interval" | null;
+    windows: string[] | null;
+    weekdays: number[] | null;
+    timeOfDay: string | null;
+    timeZone: string | null;
+    everyMinutes: number | null;
+    timesPerDay: number | null;
+    priority: number | null;
+    durationMinutes: number | null;
+}
+export interface ExtractedTaskCreatePlan extends ExtractedTaskParams {
+    mode: "create" | "respond";
+    response: string | null;
+}
+declare function buildExtractionPrompt(intent: string, recentConversation: string): string;
+/**
+ * Call the LLM to plan whether a create_definition request should create
+ * a task draft now or reply first, while also extracting structured
+ * task parameters for the create path.
+ */
+export declare function extractTaskCreatePlanWithLlm(args: {
+    runtime: IAgentRuntime;
+    intent: string;
+    state: State | undefined;
+    message?: Memory;
+}): Promise<ExtractedTaskCreatePlan>;
+export declare function extractTaskParamsWithLlm(args: {
+    runtime: IAgentRuntime;
+    intent: string;
+    state: State | undefined;
+    message?: Memory;
+}): Promise<ExtractedTaskParams>;
+export interface ExtractedReminderIntensityPlan {
+    intensity: "minimal" | "normal" | "persistent" | "high_priority_only" | "unknown";
+}
+/**
+ * Ask a small text model to classify the user's intent into a reminder
+ * intensity value. Returns an explicit "unknown" result when the model is
+ * unavailable or the response is invalid so callers do not need regex
+ * fallbacks.
+ */
+export declare function extractReminderIntensityWithLlm(args: {
+    runtime: IAgentRuntime;
+    intent: string;
+}): Promise<ExtractedReminderIntensityPlan>;
+export interface ExtractedUnlockMode {
+    mode: "fixed_duration" | "until_manual_lock" | "until_callback";
+    callbackKey?: string;
+    durationMinutes?: number;
+}
+/**
+ * Ask a small text model to determine the website unlock mode from the
+ * user's intent.  Returns null when the model is unavailable, throws, or
+ * returns an invalid value — callers should fall back to regex.
+ */
+export declare function extractUnlockModeWithLlm(args: {
+    runtime: IAgentRuntime;
+    intent: string;
+}): Promise<ExtractedUnlockMode | null>;
+export { buildExtractionPrompt };
+//# sourceMappingURL=extract-task-plan.d.ts.map

package/dist/actions/lib/extract-task-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-task-plan.d.ts","sourceRoot":"","sources":["../../../src/actions/lib/extract-task-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAiBlE,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EACP,MAAM,GACN,OAAO,GACP,QAAQ,GACR,eAAe,GACf,UAAU,GACV,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA8CD,iBAAS,qBAAqB,CAC5B,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,GACzB,MAAM,CA2CR;AAuKD;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAwCnC;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAI/B;AAaD,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EACL,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,oBAAoB,GACpB,SAAS,CAAC;CACf;AA4CD;;;;;GAKG;AACH,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,8BAA8B,CAAC,CA4B1C;AAWD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA2CtC;AAGD,OAAO,EAAE,qBAAqB,EAAE,CAAC"}