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

package/dist/actions/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/schedule.ts"],"sourcesContent":["import type {\n  ActionResult,\n  Content,\n  HandlerCallback,\n  HandlerOptions,\n  IAgentRuntime,\n  Memory,\n  State,\n} from \"@elizaos/core\";\nimport { getCircadianInsightContract } from \"@elizaos/plugin-health\";\nimport { hasLifeOpsAccess } from \"../lifeops/access.js\";\nimport { resolveDefaultTimeZone } from \"../lifeops/defaults.js\";\nimport { toActionData } from \"../lifeops/google/format-helpers.js\";\nimport type { LifeOpsScheduleInspection } from \"../lifeops/schedule-insight.js\";\nimport { LifeOpsService } from \"../lifeops/service.js\";\n\ntype ScheduleSubaction = \"summary\" | \"inspect\";\n\ntype OwnerScheduleParameters = {\n  subaction?: ScheduleSubaction | string;\n  timezone?: string;\n};\n\nfunction messageText(message: Memory): string {\n  return (message.content.text ?? \"\").toString().toLowerCase();\n}\n\nfunction coerceSubaction(value: unknown, text: string): ScheduleSubaction {\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === \"inspect\") {\n      return \"inspect\";\n    }\n    if (normalized === \"summary\") {\n      return \"summary\";\n    }\n  }\n  return /\\b(?:why|explain|inspect|evidence|how do you know)\\b/i.test(text)\n    ? \"inspect\"\n    : \"summary\";\n}\n\nfunction formatScheduleSummary(inspection: LifeOpsScheduleInspection): string {\n  const { insight } = inspection;\n  const bedtimeRelative =\n    insight.relativeTime.minutesUntilBedtimeTarget !== null\n      ? `in ${insight.relativeTime.minutesUntilBedtimeTarget} minutes`\n      : insight.relativeTime.minutesSinceBedtimeTarget !== null\n        ? `${insight.relativeTime.minutesSinceBedtimeTarget} minutes ago`\n        : \"still calibrating\";\n  const isAsleepState =\n    insight.circadianState === \"sleeping\" ||\n    insight.circadianState === \"napping\";\n  const lines = [\n    `Circadian state: ${insight.circadianState} (${Math.round(insight.stateConfidence * 100)}% confidence)${\n      insight.uncertaintyReason ? ` — ${insight.uncertaintyReason}` : \"\"\n    }.`,\n    insight.relativeTime.minutesSinceWake !== null\n      ? `Relative time: woke ${insight.relativeTime.minutesSinceWake} minutes ago; bedtime target ${\n          insight.relativeTime.bedtimeTargetAt ?? \"unknown\"\n        } ${bedtimeRelative}.`\n      : insight.relativeTime.minutesUntilBedtimeTarget !== null\n        ? `Relative time: bedtime target ${\n            insight.relativeTime.bedtimeTargetAt ?? \"unknown\"\n          } in ${insight.relativeTime.minutesUntilBedtimeTarget} minutes.`\n        : insight.relativeTime.minutesSinceBedtimeTarget !== null\n          ? `Relative time: bedtime target ${\n              insight.relativeTime.bedtimeTargetAt ?? \"unknown\"\n            } was ${insight.relativeTime.minutesSinceBedtimeTarget} minutes ago.`\n          : \"Relative time: still calibrating wake and bedtime anchors.\",\n    isAsleepState\n      ? insight.currentSleepStartedAt\n        ? `Likely asleep since ${insight.currentSleepStartedAt} (${Math.round(insight.sleepConfidence * 100)}% confidence).`\n        : `Likely asleep now (${Math.round(insight.sleepConfidence * 100)}% confidence).`\n      : insight.lastSleepEndedAt\n        ? `Last inferred wake: ${insight.lastSleepEndedAt}${insight.lastSleepDurationMinutes ? ` after ${insight.lastSleepDurationMinutes} minutes asleep` : \"\"}.`\n        : `Sleep status: ${insight.sleepStatus}.`,\n  ];\n  if (insight.nextMealLabel && insight.nextMealWindowStartAt) {\n    lines.push(\n      `Next ${insight.nextMealLabel} window: ${insight.nextMealWindowStartAt} to ${insight.nextMealWindowEndAt ?? \"unknown\"} (${Math.round(insight.nextMealConfidence * 100)}% confidence).`,\n    );\n  } else if (insight.lastMealAt) {\n    lines.push(`Last inferred meal: ${insight.lastMealAt}.`);\n  } else {\n    lines.push(\"Meal pattern is still calibrating.\");\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction formatScheduleInspection(\n  inspection: LifeOpsScheduleInspection,\n): string {\n  const { counts, insight } = inspection;\n  const lines = [formatScheduleSummary(inspection)];\n  lines.push(\"\");\n  lines.push(\n    `Signals: ${counts.activitySignalCount} activity signals, ${counts.activityEventCount} app events, ${counts.screenTimeSessionCount} screen-time sessions, ${counts.mergedWindowCount} merged activity windows.`,\n  );\n  if (inspection.sleepEpisodes.length > 0) {\n    lines.push(\"Sleep episodes:\");\n    for (const episode of inspection.sleepEpisodes.slice(-3)) {\n      lines.push(\n        `- ${episode.source} ${episode.startAt} → ${episode.endAt ?? \"now\"} (${episode.durationMinutes}m, ${Math.round(episode.confidence * 100)}%)`,\n      );\n    }\n  }\n  if (inspection.mealCandidates.length > 0) {\n    lines.push(\"Meal candidates:\");\n    for (const meal of inspection.mealCandidates) {\n      lines.push(\n        `- ${meal.label} at ${meal.detectedAt} via ${meal.source} (${Math.round(meal.confidence * 100)}%)`,\n      );\n    }\n  } else if (insight.nextMealLabel) {\n    lines.push(\n      `No completed meal candidates yet. Current best guess is ${insight.nextMealLabel}.`,\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction scheduleInspectionActionData(\n  inspection: LifeOpsScheduleInspection,\n): Record<string, unknown> {\n  return {\n    insight: inspection.insight,\n    windows: inspection.windows,\n    sleepEpisodes: inspection.sleepEpisodes,\n    mealCandidates: inspection.mealCandidates,\n    counts: inspection.counts,\n  };\n}\n\n/**\n * Handler function for the passive schedule inference subactions\n * (`summary`, `inspect`).\n *\n * Called from `./owner-surfaces.ts` (OWNER_ROUTINES `schedule_summary` /\n * `schedule_inspect` verbs); no `SCHEDULE`-named action is registered.\n */\nexport async function runScheduleHandler(\n  runtime: IAgentRuntime,\n  message: Memory,\n  _state: State | undefined,\n  options: HandlerOptions | undefined,\n  callback?: HandlerCallback,\n): Promise<ActionResult> {\n  if (!(await hasLifeOpsAccess(runtime, message))) {\n    const text = \"Schedule inference is restricted to the owner.\";\n    await callback?.({ text });\n    return { text, success: false, data: { error: \"PERMISSION_DENIED\" } };\n  }\n\n  const params = ((options as HandlerOptions | undefined)?.parameters ??\n    {}) as OwnerScheduleParameters;\n  const subaction = coerceSubaction(params.subaction, messageText(message));\n  const timezone =\n    typeof params.timezone === \"string\" && params.timezone.trim().length > 0\n      ? params.timezone.trim()\n      : resolveDefaultTimeZone();\n\n  // Consult the CircadianInsightContract registered by plugin-health for\n  // high-level sleep / scheduling reads. The contract is the typed seam\n  // between this action and plugin-health's circadian domain; the detailed\n  // inspection view still goes through LifeOpsService.inspectSchedule because\n  // the inspection record is produced by app-lifeops's own scheduler tick.\n  const circadianContract = getCircadianInsightContract(runtime);\n  const sleepWindow = circadianContract\n    ? await circadianContract.getCurrentSleepWindow({ timezone })\n    : null;\n\n  const service = new LifeOpsService(runtime);\n  const inspection = await service.inspectSchedule({ timezone });\n  const text =\n    subaction === \"inspect\"\n      ? formatScheduleInspection(inspection)\n      : formatScheduleSummary(inspection);\n  const data = toActionData({\n    ...scheduleInspectionActionData(inspection),\n    ...(sleepWindow\n      ? { circadianContractView: sleepWindow }\n      : { circadianContractView: null }),\n  });\n  await callback?.({\n    text,\n    // ProviderDataRecord values are JSON-serializable and satisfy the Content\n    // index signature at runtime; the cast bridges the broader ProviderValue\n    // vs narrower ContentValue type gap.\n    data: data as Content[\"data\"],\n  });\n  return {\n    text,\n    success: true,\n    data,\n  };\n}\n"],"mappings":"AASA,SAAS,mCAAmC;AAC5C,SAAS,wBAAwB;AACjC,SAAS,8BAA8B;AACvC,SAAS,oBAAoB;AAE7B,SAAS,sBAAsB;AAS/B,SAAS,YAAY,SAAyB;AAC5C,UAAQ,QAAQ,QAAQ,QAAQ,IAAI,SAAS,EAAE,YAAY;AAC7D;AAEA,SAAS,gBAAgB,OAAgB,MAAiC;AACxE,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,aAAa,MAAM,KAAK,EAAE,YAAY;AAC5C,QAAI,eAAe,WAAW;AAC5B,aAAO;AAAA,IACT;AACA,QAAI,eAAe,WAAW;AAC5B,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,wDAAwD,KAAK,IAAI,IACpE,YACA;AACN;AAEA,SAAS,sBAAsB,YAA+C;AAC5E,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,kBACJ,QAAQ,aAAa,8BAA8B,OAC/C,MAAM,QAAQ,aAAa,yBAAyB,aACpD,QAAQ,aAAa,8BAA8B,OACjD,GAAG,QAAQ,aAAa,yBAAyB,iBACjD;AACR,QAAM,gBACJ,QAAQ,mBAAmB,cAC3B,QAAQ,mBAAmB;AAC7B,QAAM,QAAQ;AAAA,IACZ,oBAAoB,QAAQ,cAAc,KAAK,KAAK,MAAM,QAAQ,kBAAkB,GAAG,CAAC,gBACtF,QAAQ,oBAAoB,WAAM,QAAQ,iBAAiB,KAAK,EAClE;AAAA,IACA,QAAQ,aAAa,qBAAqB,OACtC,uBAAuB,QAAQ,aAAa,gBAAgB,gCAC1D,QAAQ,aAAa,mBAAmB,SAC1C,IAAI,eAAe,MACnB,QAAQ,aAAa,8BAA8B,OACjD,iCACE,QAAQ,aAAa,mBAAmB,SAC1C,OAAO,QAAQ,aAAa,yBAAyB,cACrD,QAAQ,aAAa,8BAA8B,OACjD,iCACE,QAAQ,aAAa,mBAAmB,SAC1C,QAAQ,QAAQ,aAAa,yBAAyB,kBACtD;AAAA,IACR,gBACI,QAAQ,wBACN,uBAAuB,QAAQ,qBAAqB,KAAK,KAAK,MAAM,QAAQ,kBAAkB,GAAG,CAAC,mBAClG,sBAAsB,KAAK,MAAM,QAAQ,kBAAkB,GAAG,CAAC,mBACjE,QAAQ,mBACN,uBAAuB,QAAQ,gBAAgB,GAAG,QAAQ,2BAA2B,UAAU,QAAQ,wBAAwB,oBAAoB,EAAE,MACrJ,iBAAiB,QAAQ,WAAW;AAAA,EAC5C;AACA,MAAI,QAAQ,iBAAiB,QAAQ,uBAAuB;AAC1D,UAAM;AAAA,MACJ,QAAQ,QAAQ,aAAa,YAAY,QAAQ,qBAAqB,OAAO,QAAQ,uBAAuB,SAAS,KAAK,KAAK,MAAM,QAAQ,qBAAqB,GAAG,CAAC;AAAA,IACxK;AAAA,EACF,WAAW,QAAQ,YAAY;AAC7B,UAAM,KAAK,uBAAuB,QAAQ,UAAU,GAAG;AAAA,EACzD,OAAO;AACL,UAAM,KAAK,oCAAoC;AAAA,EACjD;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,yBACP,YACQ;AACR,QAAM,EAAE,QAAQ,QAAQ,IAAI;AAC5B,QAAM,QAAQ,CAAC,sBAAsB,UAAU,CAAC;AAChD,QAAM,KAAK,EAAE;AACb,QAAM;AAAA,IACJ,YAAY,OAAO,mBAAmB,sBAAsB,OAAO,kBAAkB,gBAAgB,OAAO,sBAAsB,0BAA0B,OAAO,iBAAiB;AAAA,EACtL;AACA,MAAI,WAAW,cAAc,SAAS,GAAG;AACvC,UAAM,KAAK,iBAAiB;AAC5B,eAAW,WAAW,WAAW,cAAc,MAAM,EAAE,GAAG;AACxD,YAAM;AAAA,QACJ,KAAK,QAAQ,MAAM,IAAI,QAAQ,OAAO,WAAM,QAAQ,SAAS,KAAK,KAAK,QAAQ,eAAe,MAAM,KAAK,MAAM,QAAQ,aAAa,GAAG,CAAC;AAAA,MAC1I;AAAA,IACF;AAAA,EACF;AACA,MAAI,WAAW,eAAe,SAAS,GAAG;AACxC,UAAM,KAAK,kBAAkB;AAC7B,eAAW,QAAQ,WAAW,gBAAgB;AAC5C,YAAM;AAAA,QACJ,KAAK,KAAK,KAAK,OAAO,KAAK,UAAU,QAAQ,KAAK,MAAM,KAAK,KAAK,MAAM,KAAK,aAAa,GAAG,CAAC;AAAA,MAChG;AAAA,IACF;AAAA,EACF,WAAW,QAAQ,eAAe;AAChC,UAAM;AAAA,MACJ,2DAA2D,QAAQ,aAAa;AAAA,IAClF;AAAA,EACF;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,6BACP,YACyB;AACzB,SAAO;AAAA,IACL,SAAS,WAAW;AAAA,IACpB,SAAS,WAAW;AAAA,IACpB,eAAe,WAAW;AAAA,IAC1B,gBAAgB,WAAW;AAAA,IAC3B,QAAQ,WAAW;AAAA,EACrB;AACF;AASA,eAAsB,mBACpB,SACA,SACA,QACA,SACA,UACuB;AACvB,MAAI,CAAE,MAAM,iBAAiB,SAAS,OAAO,GAAI;AAC/C,UAAMA,QAAO;AACb,UAAM,WAAW,EAAE,MAAAA,MAAK,CAAC;AACzB,WAAO,EAAE,MAAAA,OAAM,SAAS,OAAO,MAAM,EAAE,OAAO,oBAAoB,EAAE;AAAA,EACtE;AAEA,QAAM,SAAW,SAAwC,cACvD,CAAC;AACH,QAAM,YAAY,gBAAgB,OAAO,WAAW,YAAY,OAAO,CAAC;AACxE,QAAM,WACJ,OAAO,OAAO,aAAa,YAAY,OAAO,SAAS,KAAK,EAAE,SAAS,IACnE,OAAO,SAAS,KAAK,IACrB,uBAAuB;AAO7B,QAAM,oBAAoB,4BAA4B,OAAO;AAC7D,QAAM,cAAc,oBAChB,MAAM,kBAAkB,sBAAsB,EAAE,SAAS,CAAC,IAC1D;AAEJ,QAAM,UAAU,IAAI,eAAe,OAAO;AAC1C,QAAM,aAAa,MAAM,QAAQ,gBAAgB,EAAE,SAAS,CAAC;AAC7D,QAAM,OACJ,cAAc,YACV,yBAAyB,UAAU,IACnC,sBAAsB,UAAU;AACtC,QAAM,OAAO,aAAa;AAAA,IACxB,GAAG,6BAA6B,UAAU;AAAA,IAC1C,GAAI,cACA,EAAE,uBAAuB,YAAY,IACrC,EAAE,uBAAuB,KAAK;AAAA,EACpC,CAAC;AACD,QAAM,WAAW;AAAA,IACf;AAAA;AAAA;AAAA;AAAA,IAIA;AAAA,EACF,CAAC;AACD,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EACF;AACF;","names":["text"]}

package/dist/actions/scheduled-task.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `SCHEDULED_TASKS` umbrella action.
+ *
+ * Wraps `ScheduledTaskRunner` — the LifeOps scheduled-item execution surface for
+ * `reminder | checkin | followup | approval | recap | watcher | output | custom`
+ * `ScheduledTask` records (frozen contract per `IMPLEMENTATION_PLAN.md` §1).
+ *
+ * Subactions:
+ *   - `list`      — read tasks (optional kind / status / subject filters)
+ *   - `get`       — fetch one task by id
+ *   - `create`    — schedule a new task (any `ScheduledTaskKind`)
+ *   - `update`    — edit a scheduled task (`ScheduledTaskRunner.apply edit`)
+ *   - `snooze`    — defer next fire (`apply snooze`); resets the ladder
+ *   - `skip`      — `apply skip`; pipeline.onSkip propagates
+ *   - `complete`  — `apply complete`; pipeline.onComplete propagates
+ *   - `acknowledge` — `apply acknowledge`, then completion-check evaluation
+ *   - `dismiss`   — `apply dismiss`; terminal, no propagation
+ *   - `cancel`    — alias for `dismiss` (planner-friendly verb)
+ *   - `reopen`    — `apply reopen`; reopen-window enforced by the runner
+ *   - `history`   — read state-log entries (rollups elided by default)
+ *
+ * The 7 transitional ENTITY follow-up subactions
+ * (`add_follow_up`, `complete_follow_up`, `follow_up_list`, `days_since`,
+ * `list_overdue_followups`, `mark_followup_done`, `set_followup_threshold`)
+ * collapse onto this surface and live here as similes for one release per
+ * `HARDCODING_AUDIT.md` §6 #6.
+ */
+import type { Action } from "@elizaos/core";
+export declare const scheduledTaskAction: Action & {
+    suppressPostActionContinuation?: boolean;
+};
+//# sourceMappingURL=scheduled-task.d.ts.map

package/dist/actions/scheduled-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task.d.ts","sourceRoot":"","sources":["../../src/actions/scheduled-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AA6iBvB,eAAO,MAAM,mBAAmB,EAAE,MAAM,GAAG;IACzC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CA+S1C,CAAC"}