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

package/dist/lifeops/background-planner.d.ts

@@ -0,0 +1,140 @@
+/**
+ * WS5 — Background-job pipeline parity (PRD lines 418-433).
+ *
+ * Single shared LLM planner entry-point for every LifeOps background job.
+ * Mirrors the chat planner pattern used in `actions/inbox.ts` (`resolveSubactionPlan`)
+ * and `actions/life.ts`: structured JSON model output, no English keyword
+ * routing, no regex, multilingual-safe.
+ *
+ * Every job calls `planJob({...})` to get a typed `{action, payload,
+ * requiresApproval, reason}` decision. Sensitive actions
+ * (requiresApproval=true) are then enqueued via the WS6 approval queue
+ * (`approval-queue.types.ts`) instead of being executed directly.
+ *
+ * --------------------------------------------------------------------------
+ * Background-job inventory (search results for brief|followup|reminder|
+ * escalation|digest|watchdog|nudge|sweep|cron|schedule under
+ * `eliza/plugins/plugin-personal-assistant/src/lifeops/` and adjacent job dirs).
+ *
+ * Real registered task workers (runtime.registerTaskWorker callsites):
+ *
+ *   1. LIFEOPS_SCHEDULER
+ *      - file: lifeops/runtime.ts (registerLifeOpsTaskWorker)
+ *      - exec: executeLifeOpsSchedulerTask -> service.processScheduledWork
+ *      - downstream:
+ *          a. service-mixin-reminders.ts processReminders         (PRD: meeting reminder ladder, draft aging sweeper)
+ *          b. service-mixin-workflows.ts runDueWorkflows          (PRD: travel conflict detector, event asset sweeper)
+ *          c. service-mixin-reminders.ts syncWebsiteAccessState   (enforcement window sweep)
+ *
+ *   2. PROACTIVE_AGENT
+ *      - file: activity-profile/proactive-worker.ts (registerProactiveTaskWorker)
+ *      - exec: executeProactiveTask
+ *      - downstream:
+ *          a. planGm                                              (PRD: daily brief builder — morning)
+ *          b. planGn                                              (PRD: evening closeout)
+ *          c. planNudges                                          (PRD: meeting reminder ladder)
+ *          d. planDowntimeNudges                                  (PRD: pending-decision nudger / decision nudger)
+ *          e. planGoalCheckIns                                    (PRD: relationship/goal overdue detector)
+ *          f. planSeedingOffer                                    (onboarding seed)
+ *          g. classifyCalendarEventsForProactivePlanning           (already LLM-routed)
+ *
+ *   3. FOLLOWUP_TRACKER_RECONCILE
+ *      - file: followup/followup-tracker.ts (registerFollowupTrackerWorker)
+ *      - exec: reconcileFollowupsOnce -> computeOverdueFollowups
+ *      - downstream: writeOverdueDigestMemory                     (PRD: follow-up watchdog, relationship-overdue-detector)
+ *
+ *   4. WEBSITE_BLOCKER_UNBLOCK_TASK_NAME
+ *      - file: website-blocker/service.ts                          (out of EA scope; kept for completeness)
+ *
+ *   5. BLOCK_RULE_RECONCILE_TASK_NAME
+ *      - file: website-blocker/chat-integration/block-rule-reconciler.ts
+ *
+ * Other background entry points / sweeps that flow through the workers above:
+ *
+ *   - Activity profile rebuilds: activity-profile/service.ts       (driven by PROACTIVE_AGENT)
+ *   - Reminder enforcement windows: lifeops/enforcement-windows.ts (driven by reminders mixin)
+ *
+ * Mapping to PRD §"Background Jobs And Cron Handlers" (lines 418-433):
+ *
+ *   PRD job                                  | Job key (this module)
+ *   -----------------------------------------+--------------------------------
+ *   Inbox ingest per connector               | inbox_ingest          (event-driven)
+ *   Daily brief builder                      | daily_brief           (proactive_gm)
+ *   Evening closeout                         | evening_closeout      (proactive_gn)
+ *   Follow-up watchdog                       | followup_watchdog     (followup_tracker)
+ *   Decision nudger                          | decision_nudger       (proactive downtime)
+ *   Meeting reminder ladder                  | meeting_reminder      (proactive nudges + reminders)
+ *   Travel conflict detector                 | travel_conflict       (workflows)
+ *   Event asset sweeper                      | event_asset_sweep     (workflows)
+ *   Draft aging sweeper                      | draft_aging_sweep     (reminders)
+ *   Remote stuck-agent escalator             | remote_stuck_escalate (browser/computer-use)
+ *   Pending-decision nudger                  | pending_decision      (proactive downtime)
+ *   Missed-commitment repair                 | missed_commitment     (followup_tracker)
+ *   Unsent-draft resurfacer                  | unsent_draft          (reminders)
+ *   Relationship-overdue detector            | relationship_overdue  (followup_tracker)
+ *   Deadline escalator                       | deadline_escalate     (reminders)
+ *   Travel-ops rechecker                     | travel_ops            (workflows)
+ *
+ * --------------------------------------------------------------------------
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ApprovalAction, ApprovalChannel, ApprovalPayload } from "./approval-queue.types.js";
+/** Background-job kinds the planner knows about. Keep in sync with the
+ *  inventory comment above. Adding a new kind requires updating the
+ *  contract test (`background-job-parity.contract.test.ts`). */
+export type BackgroundJobKind = "inbox_ingest" | "daily_brief" | "evening_closeout" | "followup_watchdog" | "decision_nudger" | "meeting_reminder" | "travel_conflict" | "event_asset_sweep" | "draft_aging_sweep" | "remote_stuck_escalate" | "pending_decision" | "missed_commitment" | "unsent_draft" | "relationship_overdue" | "deadline_escalate" | "travel_ops";
+/**
+ * Result of `planJob`. `action` is null when the planner decided no action is
+ * warranted right now (e.g. the GM window already fired). Callers MUST
+ * inspect `requiresApproval` and route through the WS6 approval queue when
+ * true — they MUST NOT execute sensitive actions directly.
+ */
+export interface TypedJobPlan {
+    /** Closed-enum action selected by the planner, or null for noop. */
+    readonly action: ApprovalAction | null;
+    /** Action-specific payload. Null when `action` is null. */
+    readonly payload: ApprovalPayload | null;
+    /** When true, the caller MUST enqueue this in the approval queue
+     *  (WS6) instead of executing directly. */
+    readonly requiresApproval: boolean;
+    /** Channel through which the action will be carried out. */
+    readonly channel: ApprovalChannel;
+    /** Human-readable justification from the planner. Always non-empty. */
+    readonly reason: string;
+}
+/**
+ * Context passed into the planner by a background job. Jobs assemble this
+ * from their own runtime context (overdue digest, fired-actions log, etc.)
+ * and let the LLM decide what to do.
+ */
+export interface BackgroundJobContext {
+    readonly jobKind: BackgroundJobKind;
+    readonly subjectUserId: string;
+    /** Free-form structured snapshot of the job state (occurrences, calendar
+     *  events, overdue contacts, ...). The planner reads this verbatim. */
+    readonly snapshot: Readonly<Record<string, unknown>>;
+    /** Channels enabled for this owner. Limits the planner's choices. */
+    readonly availableChannels: ReadonlyArray<ApprovalChannel>;
+    /** Reason the job ran — cron tick, event-driven trigger, etc. */
+    readonly trigger: string;
+}
+/**
+ * Error raised when the planner is unavailable or returned unparsable
+ * output. We surface this loudly — the caller MUST decide whether to skip
+ * this tick or escalate. We never silently fall back to a default action.
+ */
+export declare class BackgroundPlannerError extends Error {
+    readonly jobKind: BackgroundJobKind;
+    readonly cause?: unknown;
+    constructor(jobKind: BackgroundJobKind, message: string, cause?: unknown);
+}
+/**
+ * Plan a background-job action via the same LLM pipeline used by chat
+ * actions. Returns a typed plan; throws `BackgroundPlannerError` on hard
+ * planner failure (model unavailable, unparsable output). Callers MUST
+ * route sensitive actions through the WS6 approval queue.
+ */
+export declare function planJob(runtime: IAgentRuntime, jobContext: BackgroundJobContext): Promise<TypedJobPlan>;
+/** Test-only helper: list all PRD job kinds the planner knows about. */
+export declare const KNOWN_JOB_KINDS: ReadonlyArray<BackgroundJobKind>;
+//# sourceMappingURL=background-planner.d.ts.map

package/dist/lifeops/background-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-planner.d.ts","sourceRoot":"","sources":["../../src/lifeops/background-planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAOnC;;gEAEgE;AAChE,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,uBAAuB,GACvB,kBAAkB,GAClB,mBAAmB,GACnB,cAAc,GACd,sBAAsB,GACtB,mBAAmB,GACnB,YAAY,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC;+CAC2C;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;2EACuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,qEAAqE;IACrE,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC3D,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAyCD;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,OAAO,EAAE,iBAAiB,CAAC;IAC3C,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAMzE;AAyTD;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAoFvB;AAED,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,iBAAiB,CAiB5D,CAAC"}

package/dist/lifeops/background-planner.js

@@ -0,0 +1,359 @@
+import {
+  logger,
+  ModelType,
+  parseJsonModelRecord,
+  runWithTrajectoryContext
+} from "@elizaos/core";
+const SENSITIVE_ACTIONS = /* @__PURE__ */ new Set([
+  "send_message",
+  "send_email",
+  "schedule_event",
+  "modify_event",
+  "cancel_event",
+  "book_travel",
+  "make_call",
+  "execute_workflow",
+  "spend_money"
+]);
+const ALL_ACTIONS = [
+  "send_message",
+  "send_email",
+  "schedule_event",
+  "modify_event",
+  "cancel_event",
+  "book_travel",
+  "make_call",
+  "execute_workflow",
+  "spend_money",
+  "noop"
+];
+const ALL_CHANNELS = [
+  "telegram",
+  "discord",
+  "slack",
+  "imessage",
+  "sms",
+  "x_dm",
+  "email",
+  "google_calendar",
+  "browser",
+  "phone",
+  "internal"
+];
+class BackgroundPlannerError extends Error {
+  jobKind;
+  cause;
+  constructor(jobKind, message, cause) {
+    super(`[BackgroundPlanner:${jobKind}] ${message}`);
+    this.name = "BackgroundPlannerError";
+    this.jobKind = jobKind;
+    this.cause = cause;
+  }
+}
+function isApprovalAction(value) {
+  return typeof value === "string" && SENSITIVE_ACTIONS.has(value);
+}
+function isApprovalChannel(value) {
+  return typeof value === "string" && ALL_CHANNELS.includes(value);
+}
+function formatPromptValue(value, depth = 0) {
+  const indent = "  ".repeat(depth);
+  const childIndent = "  ".repeat(depth + 1);
+  if (value === null) return "null";
+  if (value === void 0) return "";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) return "(none)";
+    return value.map((entry) => `${childIndent}- ${formatPromptValue(entry, depth + 1)}`).join("\n");
+  }
+  if (typeof value === "object") {
+    const entries = Object.entries(value);
+    if (entries.length === 0) return "(empty)";
+    return entries.map(([key, entry]) => {
+      const formatted = formatPromptValue(entry, depth + 1);
+      return formatted.includes("\n") ? `${indent}${key}:
+${formatted}` : `${indent}${key}: ${formatted}`;
+    }).join("\n");
+  }
+  return String(value);
+}
+function buildPrompt(jobContext) {
+  return [
+    `Plan the BACKGROUND JOB action for job kind: ${jobContext.jobKind}.`,
+    "You are routing a background tick for an executive assistant.",
+    "Decide whether the assistant should take an action right now, and if so",
+    "which action and through which channel. The assistant MUST NOT execute",
+    "sensitive actions directly \u2014 anything that contacts a person, modifies a",
+    "calendar, books travel, makes a call, runs a workflow, or spends money",
+    "returns requiresApproval=true so the user can confirm.",
+    "",
+    "Return ONLY a JSON object with exactly these top-level fields:",
+    `action: one of ${ALL_ACTIONS.join(", ")}`,
+    `channel: one of ${ALL_CHANNELS.join(", ")}`,
+    "requiresApproval: boolean",
+    "reason: short justification",
+    "payload: action-specific object, or null when action=noop",
+    "",
+    'Example noop: {"action":"noop","channel":"internal","requiresApproval":false,"reason":"Nothing is overdue on this tick.","payload":null}',
+    "",
+    'Example email: {"action":"send_email","channel":"email","requiresApproval":true,"reason":"The contact is overdue and email is the enabled channel.","payload":{"to":["person@example.com"],"subject":"Follow-up","body":"Short draft for user approval."}}',
+    "",
+    "Rules:",
+    "- Choose action=noop when no action is warranted this tick (e.g. nothing overdue).",
+    "- requiresApproval=true for any action that touches a person or external system.",
+    "- requiresApproval=false ONLY when action=noop or the action is purely internal (logging, internal workflow with no side effects).",
+    "- The reason must explain WHY this tick warrants the chosen action, in any language.",
+    "",
+    `Job trigger: ${jobContext.trigger}`,
+    `Subject user: ${jobContext.subjectUserId}`,
+    "Available channels:",
+    formatPromptValue(jobContext.availableChannels),
+    "Snapshot:",
+    formatPromptValue(jobContext.snapshot)
+  ].join("\n");
+}
+function emptyPayloadFor(_action) {
+  return null;
+}
+function stringOrNull(record, key) {
+  const value = record[key];
+  return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function coerceTravelSearch(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value;
+  const origin = stringOrNull(record, "origin");
+  const destination = stringOrNull(record, "destination");
+  const departureDate = stringOrNull(record, "departureDate");
+  if (!origin || !destination || !departureDate) return null;
+  const passengers = typeof record.passengers === "number" && Number.isFinite(record.passengers) ? Math.max(1, Math.floor(record.passengers)) : void 0;
+  return {
+    origin,
+    destination,
+    departureDate,
+    returnDate: stringOrNull(record, "returnDate") ?? void 0,
+    passengers
+  };
+}
+function coerceTravelPassengers(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) return [];
+    const record = entry;
+    const givenName = stringOrNull(record, "givenName");
+    const familyName = stringOrNull(record, "familyName");
+    const bornOn = stringOrNull(record, "bornOn");
+    if (!givenName || !familyName || !bornOn) return [];
+    return [
+      {
+        offerPassengerId: stringOrNull(record, "offerPassengerId"),
+        givenName,
+        familyName,
+        bornOn,
+        email: stringOrNull(record, "email"),
+        phoneNumber: stringOrNull(record, "phoneNumber"),
+        title: stringOrNull(record, "title"),
+        gender: stringOrNull(record, "gender")
+      }
+    ];
+  });
+}
+function coerceTravelCalendarSync(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value;
+  return {
+    enabled: record.enabled === true,
+    calendarId: stringOrNull(record, "calendarId"),
+    title: stringOrNull(record, "title"),
+    description: stringOrNull(record, "description"),
+    location: stringOrNull(record, "location"),
+    timeZone: stringOrNull(record, "timeZone")
+  };
+}
+function coercePayload(action, rawPayload) {
+  if (!rawPayload || typeof rawPayload !== "object" || Array.isArray(rawPayload)) {
+    return emptyPayloadFor(action);
+  }
+  const record = rawPayload;
+  switch (action) {
+    case "send_message": {
+      const recipient = typeof record.recipient === "string" ? record.recipient : null;
+      const body = typeof record.body === "string" ? record.body : null;
+      if (!recipient || !body) return null;
+      return {
+        action,
+        recipient,
+        body,
+        replyToMessageId: typeof record.replyToMessageId === "string" ? record.replyToMessageId : null
+      };
+    }
+    case "send_email": {
+      const subject = typeof record.subject === "string" ? record.subject : null;
+      const body = typeof record.body === "string" ? record.body : null;
+      const to = Array.isArray(record.to) ? record.to.filter((v) => typeof v === "string") : [];
+      if (!subject || !body || to.length === 0) return null;
+      return {
+        action,
+        to,
+        cc: Array.isArray(record.cc) ? record.cc.filter((v) => typeof v === "string") : [],
+        bcc: Array.isArray(record.bcc) ? record.bcc.filter((v) => typeof v === "string") : [],
+        subject,
+        body,
+        threadId: typeof record.threadId === "string" ? record.threadId : null
+      };
+    }
+    case "execute_workflow": {
+      const workflowId = typeof record.workflowId === "string" ? record.workflowId : null;
+      if (!workflowId) return null;
+      const inputRaw = record.input;
+      const input = {};
+      if (inputRaw && typeof inputRaw === "object" && !Array.isArray(inputRaw)) {
+        for (const [k, v] of Object.entries(
+          inputRaw
+        )) {
+          if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+            input[k] = v;
+          }
+        }
+      }
+      return { action, workflowId, input };
+    }
+    case "book_travel": {
+      const provider = typeof record.provider === "string" ? record.provider : null;
+      const itineraryRef = typeof record.itineraryRef === "string" ? record.itineraryRef : null;
+      const totalCents = typeof record.totalCents === "number" && Number.isFinite(record.totalCents) ? Math.round(record.totalCents) : null;
+      const currency = typeof record.currency === "string" ? record.currency : null;
+      const kind = record.kind === "flight" || record.kind === "hotel" || record.kind === "ground" ? record.kind : null;
+      const search = coerceTravelSearch(record.search);
+      const passengers = coerceTravelPassengers(record.passengers);
+      const calendarSync = coerceTravelCalendarSync(record.calendarSync);
+      if (!provider || !itineraryRef || totalCents === null || !currency || !kind) {
+        return null;
+      }
+      return {
+        action,
+        kind,
+        provider,
+        itineraryRef,
+        totalCents,
+        currency,
+        offerId: typeof record.offerId === "string" ? record.offerId : null,
+        offerRequestId: typeof record.offerRequestId === "string" ? record.offerRequestId : null,
+        orderType: record.orderType === "hold" || record.orderType === "instant" ? record.orderType : null,
+        search,
+        passengers,
+        calendarSync,
+        summary: typeof record.summary === "string" ? record.summary : null
+      };
+    }
+    default:
+      return null;
+  }
+}
+function parsePlannerOutput(raw) {
+  return parseJsonModelRecord(raw);
+}
+function coerceBoolean(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["true", "yes", "1"].includes(normalized)) return true;
+    if (["false", "no", "0"].includes(normalized)) return false;
+  }
+  return null;
+}
+async function planJob(runtime, jobContext) {
+  if (typeof runtime.useModel !== "function") {
+    throw new BackgroundPlannerError(
+      jobContext.jobKind,
+      "runtime.useModel is unavailable; background job cannot run"
+    );
+  }
+  const prompt = buildPrompt(jobContext);
+  let result;
+  try {
+    result = await runWithTrajectoryContext(
+      { purpose: "lifeops-background-planner" },
+      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt })
+    );
+  } catch (error) {
+    throw new BackgroundPlannerError(
+      jobContext.jobKind,
+      `model call failed: ${error instanceof Error ? error.message : String(error)}`,
+      error
+    );
+  }
+  const raw = typeof result === "string" ? result : "";
+  const parsed = parsePlannerOutput(raw);
+  if (!parsed) {
+    throw new BackgroundPlannerError(
+      jobContext.jobKind,
+      `planner returned unparsable output: ${raw.slice(0, 200)}`
+    );
+  }
+  const rawAction = parsed.action;
+  const rawChannel = parsed.channel;
+  const reason = typeof parsed.reason === "string" && parsed.reason.trim().length > 0 ? parsed.reason.trim() : null;
+  if (!reason) {
+    throw new BackgroundPlannerError(
+      jobContext.jobKind,
+      "planner output missing required `reason` field"
+    );
+  }
+  const channel = isApprovalChannel(rawChannel) ? rawChannel : "internal";
+  if (rawAction === "noop" || rawAction === null || rawAction === void 0) {
+    logger.debug(`[BackgroundPlanner:${jobContext.jobKind}] noop \u2014 ${reason}`);
+    return {
+      action: null,
+      payload: null,
+      requiresApproval: false,
+      channel,
+      reason
+    };
+  }
+  if (!isApprovalAction(rawAction)) {
+    throw new BackgroundPlannerError(
+      jobContext.jobKind,
+      `planner returned unknown action: ${String(rawAction)}`
+    );
+  }
+  const payload = coercePayload(rawAction, parsed.payload);
+  const parsedRequiresApproval = coerceBoolean(parsed.requiresApproval);
+  const requiresApproval = parsedRequiresApproval === false ? false : SENSITIVE_ACTIONS.has(rawAction);
+  logger.info(
+    `[BackgroundPlanner:${jobContext.jobKind}] action=${rawAction} channel=${channel} requiresApproval=${requiresApproval} \u2014 ${reason}`
+  );
+  return {
+    action: rawAction,
+    payload,
+    requiresApproval,
+    channel,
+    reason
+  };
+}
+const KNOWN_JOB_KINDS = [
+  "inbox_ingest",
+  "daily_brief",
+  "evening_closeout",
+  "followup_watchdog",
+  "decision_nudger",
+  "meeting_reminder",
+  "travel_conflict",
+  "event_asset_sweep",
+  "draft_aging_sweep",
+  "remote_stuck_escalate",
+  "pending_decision",
+  "missed_commitment",
+  "unsent_draft",
+  "relationship_overdue",
+  "deadline_escalate",
+  "travel_ops"
+];
+export {
+  BackgroundPlannerError,
+  KNOWN_JOB_KINDS,
+  planJob
+};
+//# sourceMappingURL=background-planner.js.map

package/dist/lifeops/background-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/background-planner.ts"],"sourcesContent":["/**\n * WS5 — Background-job pipeline parity (PRD lines 418-433).\n *\n * Single shared LLM planner entry-point for every LifeOps background job.\n * Mirrors the chat planner pattern used in `actions/inbox.ts` (`resolveSubactionPlan`)\n * and `actions/life.ts`: structured JSON model output, no English keyword\n * routing, no regex, multilingual-safe.\n *\n * Every job calls `planJob({...})` to get a typed `{action, payload,\n * requiresApproval, reason}` decision. Sensitive actions\n * (requiresApproval=true) are then enqueued via the WS6 approval queue\n * (`approval-queue.types.ts`) instead of being executed directly.\n *\n * --------------------------------------------------------------------------\n * Background-job inventory (search results for brief|followup|reminder|\n * escalation|digest|watchdog|nudge|sweep|cron|schedule under\n * `eliza/plugins/plugin-personal-assistant/src/lifeops/` and adjacent job dirs).\n *\n * Real registered task workers (runtime.registerTaskWorker callsites):\n *\n *   1. LIFEOPS_SCHEDULER\n *      - file: lifeops/runtime.ts (registerLifeOpsTaskWorker)\n *      - exec: executeLifeOpsSchedulerTask -> service.processScheduledWork\n *      - downstream:\n *          a. service-mixin-reminders.ts processReminders         (PRD: meeting reminder ladder, draft aging sweeper)\n *          b. service-mixin-workflows.ts runDueWorkflows          (PRD: travel conflict detector, event asset sweeper)\n *          c. service-mixin-reminders.ts syncWebsiteAccessState   (enforcement window sweep)\n *\n *   2. PROACTIVE_AGENT\n *      - file: activity-profile/proactive-worker.ts (registerProactiveTaskWorker)\n *      - exec: executeProactiveTask\n *      - downstream:\n *          a. planGm                                              (PRD: daily brief builder — morning)\n *          b. planGn                                              (PRD: evening closeout)\n *          c. planNudges                                          (PRD: meeting reminder ladder)\n *          d. planDowntimeNudges                                  (PRD: pending-decision nudger / decision nudger)\n *          e. planGoalCheckIns                                    (PRD: relationship/goal overdue detector)\n *          f. planSeedingOffer                                    (onboarding seed)\n *          g. classifyCalendarEventsForProactivePlanning           (already LLM-routed)\n *\n *   3. FOLLOWUP_TRACKER_RECONCILE\n *      - file: followup/followup-tracker.ts (registerFollowupTrackerWorker)\n *      - exec: reconcileFollowupsOnce -> computeOverdueFollowups\n *      - downstream: writeOverdueDigestMemory                     (PRD: follow-up watchdog, relationship-overdue-detector)\n *\n *   4. WEBSITE_BLOCKER_UNBLOCK_TASK_NAME\n *      - file: website-blocker/service.ts                          (out of EA scope; kept for completeness)\n *\n *   5. BLOCK_RULE_RECONCILE_TASK_NAME\n *      - file: website-blocker/chat-integration/block-rule-reconciler.ts\n *\n * Other background entry points / sweeps that flow through the workers above:\n *\n *   - Activity profile rebuilds: activity-profile/service.ts       (driven by PROACTIVE_AGENT)\n *   - Reminder enforcement windows: lifeops/enforcement-windows.ts (driven by reminders mixin)\n *\n * Mapping to PRD §\"Background Jobs And Cron Handlers\" (lines 418-433):\n *\n *   PRD job                                  | Job key (this module)\n *   -----------------------------------------+--------------------------------\n *   Inbox ingest per connector               | inbox_ingest          (event-driven)\n *   Daily brief builder                      | daily_brief           (proactive_gm)\n *   Evening closeout                         | evening_closeout      (proactive_gn)\n *   Follow-up watchdog                       | followup_watchdog     (followup_tracker)\n *   Decision nudger                          | decision_nudger       (proactive downtime)\n *   Meeting reminder ladder                  | meeting_reminder      (proactive nudges + reminders)\n *   Travel conflict detector                 | travel_conflict       (workflows)\n *   Event asset sweeper                      | event_asset_sweep     (workflows)\n *   Draft aging sweeper                      | draft_aging_sweep     (reminders)\n *   Remote stuck-agent escalator             | remote_stuck_escalate (browser/computer-use)\n *   Pending-decision nudger                  | pending_decision      (proactive downtime)\n *   Missed-commitment repair                 | missed_commitment     (followup_tracker)\n *   Unsent-draft resurfacer                  | unsent_draft          (reminders)\n *   Relationship-overdue detector            | relationship_overdue  (followup_tracker)\n *   Deadline escalator                       | deadline_escalate     (reminders)\n *   Travel-ops rechecker                     | travel_ops            (workflows)\n *\n * --------------------------------------------------------------------------\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  logger,\n  ModelType,\n  parseJsonModelRecord,\n  runWithTrajectoryContext,\n} from \"@elizaos/core\";\nimport type {\n  ApprovalAction,\n  ApprovalChannel,\n  ApprovalPayload,\n} from \"./approval-queue.types.js\";\nimport type { TravelBookingPayloadFields } from \"./travel-booking.types.js\";\n\n// ---------------------------------------------------------------------------\n// Job kinds — closed enum aligned to PRD §\"Background Jobs And Cron Handlers\"\n// ---------------------------------------------------------------------------\n\n/** Background-job kinds the planner knows about. Keep in sync with the\n *  inventory comment above. Adding a new kind requires updating the\n *  contract test (`background-job-parity.contract.test.ts`). */\nexport type BackgroundJobKind =\n  | \"inbox_ingest\"\n  | \"daily_brief\"\n  | \"evening_closeout\"\n  | \"followup_watchdog\"\n  | \"decision_nudger\"\n  | \"meeting_reminder\"\n  | \"travel_conflict\"\n  | \"event_asset_sweep\"\n  | \"draft_aging_sweep\"\n  | \"remote_stuck_escalate\"\n  | \"pending_decision\"\n  | \"missed_commitment\"\n  | \"unsent_draft\"\n  | \"relationship_overdue\"\n  | \"deadline_escalate\"\n  | \"travel_ops\";\n\n/**\n * Result of `planJob`. `action` is null when the planner decided no action is\n * warranted right now (e.g. the GM window already fired). Callers MUST\n * inspect `requiresApproval` and route through the WS6 approval queue when\n * true — they MUST NOT execute sensitive actions directly.\n */\nexport interface TypedJobPlan {\n  /** Closed-enum action selected by the planner, or null for noop. */\n  readonly action: ApprovalAction | null;\n  /** Action-specific payload. Null when `action` is null. */\n  readonly payload: ApprovalPayload | null;\n  /** When true, the caller MUST enqueue this in the approval queue\n   *  (WS6) instead of executing directly. */\n  readonly requiresApproval: boolean;\n  /** Channel through which the action will be carried out. */\n  readonly channel: ApprovalChannel;\n  /** Human-readable justification from the planner. Always non-empty. */\n  readonly reason: string;\n}\n\n/**\n * Context passed into the planner by a background job. Jobs assemble this\n * from their own runtime context (overdue digest, fired-actions log, etc.)\n * and let the LLM decide what to do.\n */\nexport interface BackgroundJobContext {\n  readonly jobKind: BackgroundJobKind;\n  readonly subjectUserId: string;\n  /** Free-form structured snapshot of the job state (occurrences, calendar\n   *  events, overdue contacts, ...). The planner reads this verbatim. */\n  readonly snapshot: Readonly<Record<string, unknown>>;\n  /** Channels enabled for this owner. Limits the planner's choices. */\n  readonly availableChannels: ReadonlyArray<ApprovalChannel>;\n  /** Reason the job ran — cron tick, event-driven trigger, etc. */\n  readonly trigger: string;\n}\n\nconst SENSITIVE_ACTIONS: ReadonlySet<ApprovalAction> = new Set<ApprovalAction>([\n  \"send_message\",\n  \"send_email\",\n  \"schedule_event\",\n  \"modify_event\",\n  \"cancel_event\",\n  \"book_travel\",\n  \"make_call\",\n  \"execute_workflow\",\n  \"spend_money\",\n]);\n\nconst ALL_ACTIONS: ReadonlyArray<ApprovalAction | \"noop\"> = [\n  \"send_message\",\n  \"send_email\",\n  \"schedule_event\",\n  \"modify_event\",\n  \"cancel_event\",\n  \"book_travel\",\n  \"make_call\",\n  \"execute_workflow\",\n  \"spend_money\",\n  \"noop\",\n];\n\nconst ALL_CHANNELS: ReadonlyArray<ApprovalChannel> = [\n  \"telegram\",\n  \"discord\",\n  \"slack\",\n  \"imessage\",\n  \"sms\",\n  \"x_dm\",\n  \"email\",\n  \"google_calendar\",\n  \"browser\",\n  \"phone\",\n  \"internal\",\n];\n\n/**\n * Error raised when the planner is unavailable or returned unparsable\n * output. We surface this loudly — the caller MUST decide whether to skip\n * this tick or escalate. We never silently fall back to a default action.\n */\nexport class BackgroundPlannerError extends Error {\n  public readonly jobKind: BackgroundJobKind;\n  public readonly cause?: unknown;\n\n  constructor(jobKind: BackgroundJobKind, message: string, cause?: unknown) {\n    super(`[BackgroundPlanner:${jobKind}] ${message}`);\n    this.name = \"BackgroundPlannerError\";\n    this.jobKind = jobKind;\n    this.cause = cause;\n  }\n}\n\nfunction isApprovalAction(value: unknown): value is ApprovalAction {\n  return (\n    typeof value === \"string\" && SENSITIVE_ACTIONS.has(value as ApprovalAction)\n  );\n}\n\nfunction isApprovalChannel(value: unknown): value is ApprovalChannel {\n  return (\n    typeof value === \"string\" &&\n    (ALL_CHANNELS as ReadonlyArray<string>).includes(value)\n  );\n}\n\nfunction formatPromptValue(value: unknown, depth = 0): string {\n  const indent = \"  \".repeat(depth);\n  const childIndent = \"  \".repeat(depth + 1);\n  if (value === null) return \"null\";\n  if (value === undefined) return \"\";\n  if (\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return String(value);\n  }\n  if (Array.isArray(value)) {\n    if (value.length === 0) return \"(none)\";\n    return value\n      .map((entry) => `${childIndent}- ${formatPromptValue(entry, depth + 1)}`)\n      .join(\"\\n\");\n  }\n  if (typeof value === \"object\") {\n    const entries = Object.entries(value as Record<string, unknown>);\n    if (entries.length === 0) return \"(empty)\";\n    return entries\n      .map(([key, entry]) => {\n        const formatted = formatPromptValue(entry, depth + 1);\n        return formatted.includes(\"\\n\")\n          ? `${indent}${key}:\\n${formatted}`\n          : `${indent}${key}: ${formatted}`;\n      })\n      .join(\"\\n\");\n  }\n  return String(value);\n}\n\nfunction buildPrompt(jobContext: BackgroundJobContext): string {\n  return [\n    `Plan the BACKGROUND JOB action for job kind: ${jobContext.jobKind}.`,\n    \"You are routing a background tick for an executive assistant.\",\n    \"Decide whether the assistant should take an action right now, and if so\",\n    \"which action and through which channel. The assistant MUST NOT execute\",\n    \"sensitive actions directly — anything that contacts a person, modifies a\",\n    \"calendar, books travel, makes a call, runs a workflow, or spends money\",\n    \"returns requiresApproval=true so the user can confirm.\",\n    \"\",\n    \"Return ONLY a JSON object with exactly these top-level fields:\",\n    `action: one of ${ALL_ACTIONS.join(\", \")}`,\n    `channel: one of ${ALL_CHANNELS.join(\", \")}`,\n    \"requiresApproval: boolean\",\n    \"reason: short justification\",\n    \"payload: action-specific object, or null when action=noop\",\n    \"\",\n    'Example noop: {\"action\":\"noop\",\"channel\":\"internal\",\"requiresApproval\":false,\"reason\":\"Nothing is overdue on this tick.\",\"payload\":null}',\n    \"\",\n    'Example email: {\"action\":\"send_email\",\"channel\":\"email\",\"requiresApproval\":true,\"reason\":\"The contact is overdue and email is the enabled channel.\",\"payload\":{\"to\":[\"person@example.com\"],\"subject\":\"Follow-up\",\"body\":\"Short draft for user approval.\"}}',\n    \"\",\n    \"Rules:\",\n    \"- Choose action=noop when no action is warranted this tick (e.g. nothing overdue).\",\n    \"- requiresApproval=true for any action that touches a person or external system.\",\n    \"- requiresApproval=false ONLY when action=noop or the action is purely internal (logging, internal workflow with no side effects).\",\n    \"- The reason must explain WHY this tick warrants the chosen action, in any language.\",\n    \"\",\n    `Job trigger: ${jobContext.trigger}`,\n    `Subject user: ${jobContext.subjectUserId}`,\n    \"Available channels:\",\n    formatPromptValue(jobContext.availableChannels),\n    \"Snapshot:\",\n    formatPromptValue(jobContext.snapshot),\n  ].join(\"\\n\");\n}\n\nfunction emptyPayloadFor(_action: ApprovalAction): ApprovalPayload | null {\n  // Sensitive payloads are required to be fully formed — we do not invent\n  // recipients or amounts. If the planner returned a sensitive action with\n  // no usable payload, the caller will see payload=null and skip the tick.\n  return null;\n}\n\nfunction stringOrNull(\n  record: Record<string, unknown>,\n  key: string,\n): string | null {\n  const value = record[key];\n  return typeof value === \"string\" && value.trim().length > 0 ? value : null;\n}\n\nfunction coerceTravelSearch(\n  value: unknown,\n): TravelBookingPayloadFields[\"search\"] {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  const record = value as Record<string, unknown>;\n  const origin = stringOrNull(record, \"origin\");\n  const destination = stringOrNull(record, \"destination\");\n  const departureDate = stringOrNull(record, \"departureDate\");\n  if (!origin || !destination || !departureDate) return null;\n  const passengers =\n    typeof record.passengers === \"number\" && Number.isFinite(record.passengers)\n      ? Math.max(1, Math.floor(record.passengers))\n      : undefined;\n  return {\n    origin,\n    destination,\n    departureDate,\n    returnDate: stringOrNull(record, \"returnDate\") ?? undefined,\n    passengers,\n  };\n}\n\nfunction coerceTravelPassengers(\n  value: unknown,\n): TravelBookingPayloadFields[\"passengers\"] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) return [];\n    const record = entry as Record<string, unknown>;\n    const givenName = stringOrNull(record, \"givenName\");\n    const familyName = stringOrNull(record, \"familyName\");\n    const bornOn = stringOrNull(record, \"bornOn\");\n    if (!givenName || !familyName || !bornOn) return [];\n    return [\n      {\n        offerPassengerId: stringOrNull(record, \"offerPassengerId\"),\n        givenName,\n        familyName,\n        bornOn,\n        email: stringOrNull(record, \"email\"),\n        phoneNumber: stringOrNull(record, \"phoneNumber\"),\n        title: stringOrNull(record, \"title\"),\n        gender: stringOrNull(record, \"gender\"),\n      },\n    ];\n  });\n}\n\nfunction coerceTravelCalendarSync(\n  value: unknown,\n): TravelBookingPayloadFields[\"calendarSync\"] {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  const record = value as Record<string, unknown>;\n  return {\n    enabled: record.enabled === true,\n    calendarId: stringOrNull(record, \"calendarId\"),\n    title: stringOrNull(record, \"title\"),\n    description: stringOrNull(record, \"description\"),\n    location: stringOrNull(record, \"location\"),\n    timeZone: stringOrNull(record, \"timeZone\"),\n  };\n}\n\nfunction coercePayload(\n  action: ApprovalAction,\n  rawPayload: unknown,\n): ApprovalPayload | null {\n  if (\n    !rawPayload ||\n    typeof rawPayload !== \"object\" ||\n    Array.isArray(rawPayload)\n  ) {\n    return emptyPayloadFor(action);\n  }\n  const record = rawPayload as Record<string, unknown>;\n\n  switch (action) {\n    case \"send_message\": {\n      const recipient =\n        typeof record.recipient === \"string\" ? record.recipient : null;\n      const body = typeof record.body === \"string\" ? record.body : null;\n      if (!recipient || !body) return null;\n      return {\n        action,\n        recipient,\n        body,\n        replyToMessageId:\n          typeof record.replyToMessageId === \"string\"\n            ? record.replyToMessageId\n            : null,\n      };\n    }\n    case \"send_email\": {\n      const subject =\n        typeof record.subject === \"string\" ? record.subject : null;\n      const body = typeof record.body === \"string\" ? record.body : null;\n      const to = Array.isArray(record.to)\n        ? record.to.filter((v): v is string => typeof v === \"string\")\n        : [];\n      if (!subject || !body || to.length === 0) return null;\n      return {\n        action,\n        to,\n        cc: Array.isArray(record.cc)\n          ? record.cc.filter((v): v is string => typeof v === \"string\")\n          : [],\n        bcc: Array.isArray(record.bcc)\n          ? record.bcc.filter((v): v is string => typeof v === \"string\")\n          : [],\n        subject,\n        body,\n        threadId: typeof record.threadId === \"string\" ? record.threadId : null,\n      };\n    }\n    case \"execute_workflow\": {\n      const workflowId =\n        typeof record.workflowId === \"string\" ? record.workflowId : null;\n      if (!workflowId) return null;\n      const inputRaw = record.input;\n      const input: Record<string, string | number | boolean> = {};\n      if (\n        inputRaw &&\n        typeof inputRaw === \"object\" &&\n        !Array.isArray(inputRaw)\n      ) {\n        for (const [k, v] of Object.entries(\n          inputRaw as Record<string, unknown>,\n        )) {\n          if (\n            typeof v === \"string\" ||\n            typeof v === \"number\" ||\n            typeof v === \"boolean\"\n          ) {\n            input[k] = v;\n          }\n        }\n      }\n      return { action, workflowId, input };\n    }\n    case \"book_travel\": {\n      const provider =\n        typeof record.provider === \"string\" ? record.provider : null;\n      const itineraryRef =\n        typeof record.itineraryRef === \"string\" ? record.itineraryRef : null;\n      const totalCents =\n        typeof record.totalCents === \"number\" &&\n        Number.isFinite(record.totalCents)\n          ? Math.round(record.totalCents)\n          : null;\n      const currency =\n        typeof record.currency === \"string\" ? record.currency : null;\n      const kind =\n        record.kind === \"flight\" ||\n        record.kind === \"hotel\" ||\n        record.kind === \"ground\"\n          ? record.kind\n          : null;\n      const search = coerceTravelSearch(record.search);\n      const passengers = coerceTravelPassengers(record.passengers);\n      const calendarSync = coerceTravelCalendarSync(record.calendarSync);\n      if (\n        !provider ||\n        !itineraryRef ||\n        totalCents === null ||\n        !currency ||\n        !kind\n      ) {\n        return null;\n      }\n      return {\n        action,\n        kind,\n        provider,\n        itineraryRef,\n        totalCents,\n        currency,\n        offerId: typeof record.offerId === \"string\" ? record.offerId : null,\n        offerRequestId:\n          typeof record.offerRequestId === \"string\"\n            ? record.offerRequestId\n            : null,\n        orderType:\n          record.orderType === \"hold\" || record.orderType === \"instant\"\n            ? record.orderType\n            : null,\n        search,\n        passengers,\n        calendarSync,\n        summary: typeof record.summary === \"string\" ? record.summary : null,\n      };\n    }\n    default:\n      // For schedule/modify/cancel/book/call/spend the upstream caller has\n      // no structured payload extraction. We surface null so the\n      // caller can either request approval with a synthesized message or\n      // skip this tick. We never fabricate recipients or amounts.\n      return null;\n  }\n}\n\nfunction parsePlannerOutput(raw: string): Record<string, unknown> | null {\n  return parseJsonModelRecord<Record<string, unknown>>(raw);\n}\n\nfunction coerceBoolean(value: unknown): boolean | null {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if ([\"true\", \"yes\", \"1\"].includes(normalized)) return true;\n    if ([\"false\", \"no\", \"0\"].includes(normalized)) return false;\n  }\n  return null;\n}\n\n/**\n * Plan a background-job action via the same LLM pipeline used by chat\n * actions. Returns a typed plan; throws `BackgroundPlannerError` on hard\n * planner failure (model unavailable, unparsable output). Callers MUST\n * route sensitive actions through the WS6 approval queue.\n */\nexport async function planJob(\n  runtime: IAgentRuntime,\n  jobContext: BackgroundJobContext,\n): Promise<TypedJobPlan> {\n  if (typeof runtime.useModel !== \"function\") {\n    throw new BackgroundPlannerError(\n      jobContext.jobKind,\n      \"runtime.useModel is unavailable; background job cannot run\",\n    );\n  }\n\n  const prompt = buildPrompt(jobContext);\n  let result: unknown;\n  try {\n    result = await runWithTrajectoryContext(\n      { purpose: \"lifeops-background-planner\" },\n      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt }),\n    );\n  } catch (error) {\n    throw new BackgroundPlannerError(\n      jobContext.jobKind,\n      `model call failed: ${error instanceof Error ? error.message : String(error)}`,\n      error,\n    );\n  }\n  const raw = typeof result === \"string\" ? result : \"\";\n  const parsed = parsePlannerOutput(raw);\n\n  if (!parsed) {\n    throw new BackgroundPlannerError(\n      jobContext.jobKind,\n      `planner returned unparsable output: ${raw.slice(0, 200)}`,\n    );\n  }\n\n  const rawAction = parsed.action;\n  const rawChannel = parsed.channel;\n  const reason =\n    typeof parsed.reason === \"string\" && parsed.reason.trim().length > 0\n      ? parsed.reason.trim()\n      : null;\n\n  if (!reason) {\n    throw new BackgroundPlannerError(\n      jobContext.jobKind,\n      \"planner output missing required `reason` field\",\n    );\n  }\n\n  const channel: ApprovalChannel = isApprovalChannel(rawChannel)\n    ? rawChannel\n    : \"internal\";\n\n  if (rawAction === \"noop\" || rawAction === null || rawAction === undefined) {\n    logger.debug(`[BackgroundPlanner:${jobContext.jobKind}] noop — ${reason}`);\n    return {\n      action: null,\n      payload: null,\n      requiresApproval: false,\n      channel,\n      reason,\n    };\n  }\n\n  if (!isApprovalAction(rawAction)) {\n    throw new BackgroundPlannerError(\n      jobContext.jobKind,\n      `planner returned unknown action: ${String(rawAction)}`,\n    );\n  }\n\n  const payload = coercePayload(rawAction, parsed.payload);\n  const parsedRequiresApproval = coerceBoolean(parsed.requiresApproval);\n  const requiresApproval =\n    parsedRequiresApproval === false ? false : SENSITIVE_ACTIONS.has(rawAction);\n\n  logger.info(\n    `[BackgroundPlanner:${jobContext.jobKind}] action=${rawAction} channel=${channel} requiresApproval=${requiresApproval} — ${reason}`,\n  );\n\n  return {\n    action: rawAction,\n    payload,\n    requiresApproval,\n    channel,\n    reason,\n  };\n}\n\n/** Test-only helper: list all PRD job kinds the planner knows about. */\nexport const KNOWN_JOB_KINDS: ReadonlyArray<BackgroundJobKind> = [\n  \"inbox_ingest\",\n  \"daily_brief\",\n  \"evening_closeout\",\n  \"followup_watchdog\",\n  \"decision_nudger\",\n  \"meeting_reminder\",\n  \"travel_conflict\",\n  \"event_asset_sweep\",\n  \"draft_aging_sweep\",\n  \"remote_stuck_escalate\",\n  \"pending_decision\",\n  \"missed_commitment\",\n  \"unsent_draft\",\n  \"relationship_overdue\",\n  \"deadline_escalate\",\n  \"travel_ops\",\n];\n"],"mappings":"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","names":[]}

package/dist/lifeops/bill-extraction.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pull a structured bill ({ merchant, amount, currency, dueDate, confidence })
+ * out of an email previously classified as "bill".
+ *
+ *   1. Regex pass first — covers the typical "Your $X is due on Y" /
+ *      "USD 123.45" / sender-display-name patterns most receipts use.
+ *   2. LLM fallback when the regex pass lacks an amount or merchant. Uses the
+ *      same configurable model setting and cache as the email-classifier.
+ *
+ * Returns null when the merged confidence is below 0.5 — Money should not
+ * accumulate junk rows pretending to be bills.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { EmailLikeMessage } from "./email-classifier.js";
+export interface BillExtraction {
+    merchant: string;
+    amount: number;
+    currency: string;
+    dueDate: string | null;
+    confidence: number;
+    signals: string[];
+}
+export interface ExtractBillOptions {
+    modelOverride?: string | null;
+}
+/** Extract the first plausible amount + currency in the text. */
+export declare function extractAmountFromText(text: string): {
+    amount: number;
+    currency: string;
+} | null;
+/**
+ * Extract the first plausible due date from text. Returns ISO YYYY-MM-DD.
+ * Recognized shapes:
+ *   - "due (on)? 4/15/2026" / "due 04/15"
+ *   - "due (by|on)? Apr 15" / "by April 15, 2026"
+ *   - "payment due Apr 15"
+ */
+export declare function extractDueDateFromText(text: string, now?: Date): string | null;
+/** Heuristic merchant: prefer the "From" display name; strip quotes/email. */
+export declare function extractMerchantFromMessage(message: EmailLikeMessage): string | null;
+/** Pure-regex extraction. Returns null when amount can't be found. */
+export declare function extractBillByRules(message: EmailLikeMessage, now?: Date): BillExtraction | null;
+export declare function extractBill(runtime: IAgentRuntime, message: EmailLikeMessage, opts?: ExtractBillOptions): Promise<BillExtraction | null>;
+/** Test hook: clear in-memory cache. */
+export declare function _resetBillExtractionCache(): void;
+//# sourceMappingURL=bill-extraction.d.ts.map

package/dist/lifeops/bill-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-extraction.d.ts","sourceRoot":"","sources":["../../src/lifeops/bill-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAsGD,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAoCP;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,IAAiB,GACrB,MAAM,GAAG,IAAI,CAwBf;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,GACxB,MAAM,GAAG,IAAI,CAmBf;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,GAAG,GAAE,IAAiB,GACrB,cAAc,GAAG,IAAI,CAqBvB;AA8HD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyDhC;AAED,wCAAwC;AACxC,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}