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

package/dist/default-packs/morning-brief.js

@@ -0,0 +1,69 @@
+import {
+  buildCheckinSummaryPrompt,
+  CheckinService
+} from "../lifeops/checkin/checkin-service.js";
+import {
+  compileTaskDefinition
+} from "./task-definitions.js";
+const MORNING_BRIEF_PACK_KEY = "morning-brief";
+const MORNING_BRIEF_RECORD_IDS = {
+  brief: "default-pack:morning-brief:assembler"
+};
+const morningBriefDefinition = {
+  definitionKind: "recap",
+  promptInstructions: "Assemble the owner's morning brief from LifeOps source data: overdue todos, today's meetings, yesterday's wins, tracked habits, inbox/calendar/contacts/promises. Rank for genuinely interesting, important, reply-needed, or schedule-changing items. Keep it concise. No invented facts; if a source is unavailable, say so in one clause. Use the existing morning-checkin assembler \u2014 do not regenerate the briefing structure.",
+  contextRequest: {
+    includeOwnerFacts: ["preferredName", "morningWindow", "timezone"]
+  },
+  trigger: {
+    kind: "relative_to_anchor",
+    anchorKey: "wake.confirmed",
+    offsetMinutes: 0
+  },
+  priority: "medium",
+  respectsGlobalPause: true,
+  source: "default_pack",
+  createdBy: MORNING_BRIEF_PACK_KEY,
+  ownerVisible: true,
+  idempotencyKey: MORNING_BRIEF_RECORD_IDS.brief,
+  metadata: {
+    packKey: MORNING_BRIEF_PACK_KEY,
+    recordKey: "morning-brief",
+    // Parity contract: assembly delegates to CheckinService.runMorningCheckin.
+    delegatesAssemblyTo: "lifeops:checkin:morning"
+  }
+};
+const morningBriefRecord = compileTaskDefinition(morningBriefDefinition);
+const morningBriefPack = {
+  key: MORNING_BRIEF_PACK_KEY,
+  label: "Morning brief",
+  description: "Assembled morning briefing on wake \u2014 overdue todos, meetings, wins, inbox, calendar, contacts, promises. Delegates assembly to the scheduled briefing service, so a fresh user gets the same content the planner would.",
+  defaultEnabled: true,
+  requiredCapabilities: [],
+  records: [morningBriefRecord],
+  uiHints: {
+    summaryOnDayOne: "One assembled briefing in the morning \u2014 same content as the existing `/morning check-in`.",
+    expectedFireCountPerDay: 1
+  }
+};
+async function assembleMorningBrief(runtime, options = {}) {
+  const service = new CheckinService(runtime, { sources: options.sources });
+  const report = await service.runMorningCheckin({
+    timezone: options.timezone,
+    now: options.now
+  });
+  const { summaryText: _summary, ...reportWithoutSummary } = report;
+  const promptText = buildCheckinSummaryPrompt(reportWithoutSummary);
+  return { promptText, report };
+}
+function buildMorningBriefPromptFromReport(report) {
+  return buildCheckinSummaryPrompt(report);
+}
+export {
+  MORNING_BRIEF_PACK_KEY,
+  MORNING_BRIEF_RECORD_IDS,
+  assembleMorningBrief,
+  buildMorningBriefPromptFromReport,
+  morningBriefPack
+};
+//# sourceMappingURL=morning-brief.js.map

package/dist/default-packs/morning-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/default-packs/morning-brief.ts"],"sourcesContent":["/**\n * Default pack: `morning-brief`.\n *\n * One assembler `ScheduledTask` triggered on `wake.confirmed`. Delegates the\n * assembly to the existing `CheckinService.runMorningCheckin` (per GAP §2.8 —\n * `lifeops/checkin/*` becomes the assembly logic invoked by the daily-check-in\n * `ScheduledTask`'s prompt).\n *\n * **Parity contract:** the message body produced from this pack must match\n * the `CheckinService.runMorningCheckin().summaryText` for the same inputs.\n * `test/default-pack-morning-brief.parity.test.ts` asserts this.\n *\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  buildCheckinSummaryPrompt,\n  CheckinService,\n  type CheckinSourceService,\n} from \"../lifeops/checkin/checkin-service.js\";\nimport type { CheckinKind, CheckinReport } from \"../lifeops/checkin/types.js\";\nimport type { DefaultPack } from \"./registry-types.js\";\nimport {\n  compileTaskDefinition,\n  type RecapTaskDefinition,\n} from \"./task-definitions.js\";\n\nexport const MORNING_BRIEF_PACK_KEY = \"morning-brief\";\n\nexport const MORNING_BRIEF_RECORD_IDS = {\n  brief: \"default-pack:morning-brief:assembler\",\n} as const;\n\nconst morningBriefDefinition: RecapTaskDefinition = {\n  definitionKind: \"recap\",\n  promptInstructions:\n    \"Assemble the owner's morning brief from LifeOps source data: overdue todos, today's meetings, yesterday's wins, tracked habits, inbox/calendar/contacts/promises. Rank for genuinely interesting, important, reply-needed, or schedule-changing items. Keep it concise. No invented facts; if a source is unavailable, say so in one clause. Use the existing morning-checkin assembler — do not regenerate the briefing structure.\",\n  contextRequest: {\n    includeOwnerFacts: [\"preferredName\", \"morningWindow\", \"timezone\"],\n  },\n  trigger: {\n    kind: \"relative_to_anchor\",\n    anchorKey: \"wake.confirmed\",\n    offsetMinutes: 0,\n  },\n  priority: \"medium\",\n  respectsGlobalPause: true,\n  source: \"default_pack\",\n  createdBy: MORNING_BRIEF_PACK_KEY,\n  ownerVisible: true,\n  idempotencyKey: MORNING_BRIEF_RECORD_IDS.brief,\n  metadata: {\n    packKey: MORNING_BRIEF_PACK_KEY,\n    recordKey: \"morning-brief\",\n    // Parity contract: assembly delegates to CheckinService.runMorningCheckin.\n    delegatesAssemblyTo: \"lifeops:checkin:morning\",\n  },\n};\n\nconst morningBriefRecord = compileTaskDefinition(morningBriefDefinition);\n\nexport const morningBriefPack: DefaultPack = {\n  key: MORNING_BRIEF_PACK_KEY,\n  label: \"Morning brief\",\n  description:\n    \"Assembled morning briefing on wake — overdue todos, meetings, wins, inbox, calendar, contacts, promises. Delegates assembly to the scheduled briefing service, so a fresh user gets the same content the planner would.\",\n  defaultEnabled: true,\n  requiredCapabilities: [],\n  records: [morningBriefRecord],\n  uiHints: {\n    summaryOnDayOne:\n      \"One assembled briefing in the morning — same content as the existing `/morning check-in`.\",\n    expectedFireCountPerDay: 1,\n  },\n};\n\n/**\n * Assembly helper used by the runner when this pack's `ScheduledTask` fires.\n * Returned shape is `{ promptText, report }` so the caller can decide whether\n * to render the prompt (anchor-unavailable scenario) or use `summaryText`\n * directly.\n *\n * The scheduled briefing assembler is shared with the interactive morning\n * briefing workflow; this is the parity contract.\n */\nexport async function assembleMorningBrief(\n  runtime: IAgentRuntime,\n  options: {\n    timezone?: string;\n    now?: Date;\n    sources?: CheckinSourceService;\n  } = {},\n): Promise<{\n  promptText: string;\n  report: CheckinReport;\n}> {\n  const service = new CheckinService(runtime, { sources: options.sources });\n  const report = await service.runMorningCheckin({\n    timezone: options.timezone,\n    now: options.now,\n  });\n  // Re-build the prompt text for parity assertion. CheckinService also\n  // produces this internally inside `runCheckin`, but it isn't exposed; for\n  // the parity test we recompute from the persisted report shape.\n  const { summaryText: _summary, ...reportWithoutSummary } = report;\n  const promptText = buildCheckinSummaryPrompt(reportWithoutSummary);\n  return { promptText, report };\n}\n\n/** Exposed for tests: the prompt-builder produces deterministic text from a report. */\nexport function buildMorningBriefPromptFromReport(\n  report: Omit<CheckinReport, \"summaryText\"> & {\n    kind: Extract<CheckinKind, \"morning\">;\n  },\n): string {\n  return buildCheckinSummaryPrompt(report);\n}\n"],"mappings":"AAeA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAGP;AAAA,EACE;AAAA,OAEK;AAEA,MAAM,yBAAyB;AAE/B,MAAM,2BAA2B;AAAA,EACtC,OAAO;AACT;AAEA,MAAM,yBAA8C;AAAA,EAClD,gBAAgB;AAAA,EAChB,oBACE;AAAA,EACF,gBAAgB;AAAA,IACd,mBAAmB,CAAC,iBAAiB,iBAAiB,UAAU;AAAA,EAClE;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,WAAW;AAAA,IACX,eAAe;AAAA,EACjB;AAAA,EACA,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,cAAc;AAAA,EACd,gBAAgB,yBAAyB;AAAA,EACzC,UAAU;AAAA,IACR,SAAS;AAAA,IACT,WAAW;AAAA;AAAA,IAEX,qBAAqB;AAAA,EACvB;AACF;AAEA,MAAM,qBAAqB,sBAAsB,sBAAsB;AAEhE,MAAM,mBAAgC;AAAA,EAC3C,KAAK;AAAA,EACL,OAAO;AAAA,EACP,aACE;AAAA,EACF,gBAAgB;AAAA,EAChB,sBAAsB,CAAC;AAAA,EACvB,SAAS,CAAC,kBAAkB;AAAA,EAC5B,SAAS;AAAA,IACP,iBACE;AAAA,IACF,yBAAyB;AAAA,EAC3B;AACF;AAWA,eAAsB,qBACpB,SACA,UAII,CAAC,GAIJ;AACD,QAAM,UAAU,IAAI,eAAe,SAAS,EAAE,SAAS,QAAQ,QAAQ,CAAC;AACxE,QAAM,SAAS,MAAM,QAAQ,kBAAkB;AAAA,IAC7C,UAAU,QAAQ;AAAA,IAClB,KAAK,QAAQ;AAAA,EACf,CAAC;AAID,QAAM,EAAE,aAAa,UAAU,GAAG,qBAAqB,IAAI;AAC3D,QAAM,aAAa,0BAA0B,oBAAoB;AACjE,SAAO,EAAE,YAAY,OAAO;AAC9B;AAGO,SAAS,kCACd,QAGQ;AACR,SAAO,0BAA0B,MAAM;AACzC;","names":[]}

package/dist/default-packs/quiet-user-watcher.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Default pack: `quiet-user-watcher`.
+ *
+ * One daily watcher `ScheduledTask` (kind = "watcher") that consults
+ * `RecentTaskStatesProvider.summarize` and surfaces:
+ *   - "you've been quiet for N days" when no recent owner replies
+ *   - "you missed yesterday's check-in" when the previous-day check-in
+ *     terminal-stated `expired` or `skipped` without a follow-up reply.
+ *
+ * Threshold: 3 days quiet. The watcher emits its observations for the
+ * morning-brief pack to fold in; it does **not** send a separate
+ * notification (that's what the consolidation policy on `wake.confirmed` is
+ * for — see `consolidation-policies.ts`).
+ */
+import type { RecentTaskStatesProvider, RecentTaskStatesSummary } from "./contract-types.js";
+import type { DefaultPack } from "./registry-types.js";
+export declare const QUIET_USER_WATCHER_PACK_KEY = "quiet-user-watcher";
+export declare const QUIET_USER_WATCHER_RECORD_IDS: {
+    readonly watcher: "default-pack:quiet-user-watcher:daily";
+};
+/**
+ * Default threshold for "been quiet" — 3 calendar days with no owner reply
+ * across any tracked check-in / followup. Configurable per-task via
+ * `metadata.quietThresholdDays`.
+ */
+export declare const QUIET_THRESHOLD_DAYS = 3;
+export declare const quietUserWatcherPack: DefaultPack;
+export interface QuietUserWatcherObservation {
+    kind: "quiet_for_days" | "missed_yesterday_checkin";
+    days?: number;
+    detail: string;
+}
+/**
+ * Pure helper: turn a `RecentTaskStatesSummary` into observations the
+ * morning-brief should fold in. Pure because the watcher task itself is
+ * what the runner schedules; this helper just shapes the output.
+ */
+export declare function deriveQuietObservations(summary: RecentTaskStatesSummary, options?: {
+    thresholdDays?: number;
+}): QuietUserWatcherObservation[];
+/**
+ * Convenience wrapper for the runtime: ask the provider for a summary, then
+ * derive observations.
+ */
+export declare function runQuietUserWatcher(provider: RecentTaskStatesProvider, options?: {
+    thresholdDays?: number;
+    lookbackDays?: number;
+}): Promise<QuietUserWatcherObservation[]>;
+//# sourceMappingURL=quiet-user-watcher.d.ts.map

package/dist/default-packs/quiet-user-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-user-watcher.d.ts","sourceRoot":"","sources":["../../src/default-packs/quiet-user-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAEhE,eAAO,MAAM,6BAA6B;;CAEhC,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAkCtC,eAAO,MAAM,oBAAoB,EAAE,WAalC,CAAC;AAIF,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,gBAAgB,GAAG,0BAA0B,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,2BAA2B,EAAE,CAuC/B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAQxC"}

package/dist/default-packs/quiet-user-watcher.js

@@ -0,0 +1,92 @@
+import {
+  compileTaskDefinition
+} from "./task-definitions.js";
+const QUIET_USER_WATCHER_PACK_KEY = "quiet-user-watcher";
+const QUIET_USER_WATCHER_RECORD_IDS = {
+  watcher: "default-pack:quiet-user-watcher:daily"
+};
+const QUIET_THRESHOLD_DAYS = 3;
+const watcherDefinition = {
+  definitionKind: "watcher",
+  promptInstructions: "Consult RecentTaskStatesProvider.summarize for owner activity over the last week. If the owner has been quiet for the configured threshold, surface a quiet-user observation. If yesterday's check-in expired without reply, surface a missed-check-in observation. Emit observations for the morning-brief consolidation; do not send a separate notification.",
+  contextRequest: {
+    includeOwnerFacts: ["preferredName", "timezone"],
+    includeRecentTaskStates: { lookbackHours: 24 * 7 }
+  },
+  // Daily fire on the morning anchor so the morning-brief consolidation can
+  // pick up the observation in the same wake.confirmed batch.
+  trigger: {
+    kind: "relative_to_anchor",
+    anchorKey: "wake.confirmed",
+    offsetMinutes: 0
+  },
+  priority: "low",
+  respectsGlobalPause: true,
+  source: "default_pack",
+  createdBy: QUIET_USER_WATCHER_PACK_KEY,
+  // Watcher tasks emit observations; their output is consumed by the
+  // morning-brief consolidation, not surfaced to the owner directly.
+  ownerVisible: false,
+  idempotencyKey: QUIET_USER_WATCHER_RECORD_IDS.watcher,
+  metadata: {
+    packKey: QUIET_USER_WATCHER_PACK_KEY,
+    recordKey: "quiet-user-watcher",
+    quietThresholdDays: QUIET_THRESHOLD_DAYS
+  }
+};
+const watcherRecord = compileTaskDefinition(watcherDefinition);
+const quietUserWatcherPack = {
+  key: QUIET_USER_WATCHER_PACK_KEY,
+  label: "Quiet-user watcher",
+  description: "Daily watcher that flags long silences and missed check-ins. Default threshold is 3 days quiet, configurable per-task via metadata.quietThresholdDays. Surfaces observations into the morning brief instead of sending its own notification.",
+  defaultEnabled: true,
+  requiredCapabilities: [],
+  records: [watcherRecord],
+  uiHints: {
+    summaryOnDayOne: "Daily silent watcher; only surfaces text when you've been quiet 3+ days or skipped yesterday's check-in.",
+    expectedFireCountPerDay: 0
+  }
+};
+function deriveQuietObservations(summary, options = {}) {
+  const threshold = options.thresholdDays ?? QUIET_THRESHOLD_DAYS;
+  const observations = [];
+  for (const streak of summary.streaks) {
+    const counts = (streak.kind === "checkin" || streak.kind === "followup") && (streak.outcome === "expired" || streak.outcome === "skipped") ? streak.consecutive : 0;
+    if (counts >= threshold) {
+      observations.push({
+        kind: "quiet_for_days",
+        days: counts,
+        detail: `${counts} consecutive ${streak.kind}s without reply`
+      });
+      break;
+    }
+  }
+  for (const streak of summary.streaks) {
+    if (streak.kind === "checkin" && streak.outcome === "expired" && streak.consecutive >= 1) {
+      observations.push({
+        kind: "missed_yesterday_checkin",
+        detail: "yesterday's check-in expired without reply"
+      });
+      break;
+    }
+  }
+  return observations;
+}
+async function runQuietUserWatcher(provider, options = {}) {
+  const summary = await provider.summarize({
+    kinds: ["checkin", "followup"],
+    lookbackDays: options.lookbackDays ?? 7
+  });
+  return deriveQuietObservations(summary, {
+    thresholdDays: options.thresholdDays
+  });
+}
+export {
+  QUIET_THRESHOLD_DAYS,
+  QUIET_USER_WATCHER_PACK_KEY,
+  QUIET_USER_WATCHER_RECORD_IDS,
+  deriveQuietObservations,
+  quietUserWatcherPack,
+  runQuietUserWatcher
+};
+//# sourceMappingURL=quiet-user-watcher.js.map

package/dist/default-packs/quiet-user-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/default-packs/quiet-user-watcher.ts"],"sourcesContent":["/**\n * Default pack: `quiet-user-watcher`.\n *\n * One daily watcher `ScheduledTask` (kind = \"watcher\") that consults\n * `RecentTaskStatesProvider.summarize` and surfaces:\n *   - \"you've been quiet for N days\" when no recent owner replies\n *   - \"you missed yesterday's check-in\" when the previous-day check-in\n *     terminal-stated `expired` or `skipped` without a follow-up reply.\n *\n * Threshold: 3 days quiet. The watcher emits its observations for the\n * morning-brief pack to fold in; it does **not** send a separate\n * notification (that's what the consolidation policy on `wake.confirmed` is\n * for — see `consolidation-policies.ts`).\n */\n\nimport type {\n  RecentTaskStatesProvider,\n  RecentTaskStatesSummary,\n} from \"./contract-types.js\";\nimport type { DefaultPack } from \"./registry-types.js\";\nimport {\n  compileTaskDefinition,\n  type WatcherTaskDefinition,\n} from \"./task-definitions.js\";\n\nexport const QUIET_USER_WATCHER_PACK_KEY = \"quiet-user-watcher\";\n\nexport const QUIET_USER_WATCHER_RECORD_IDS = {\n  watcher: \"default-pack:quiet-user-watcher:daily\",\n} as const;\n\n/**\n * Default threshold for \"been quiet\" — 3 calendar days with no owner reply\n * across any tracked check-in / followup. Configurable per-task via\n * `metadata.quietThresholdDays`.\n */\nexport const QUIET_THRESHOLD_DAYS = 3;\n\nconst watcherDefinition: WatcherTaskDefinition = {\n  definitionKind: \"watcher\",\n  promptInstructions:\n    \"Consult RecentTaskStatesProvider.summarize for owner activity over the last week. If the owner has been quiet for the configured threshold, surface a quiet-user observation. If yesterday's check-in expired without reply, surface a missed-check-in observation. Emit observations for the morning-brief consolidation; do not send a separate notification.\",\n  contextRequest: {\n    includeOwnerFacts: [\"preferredName\", \"timezone\"],\n    includeRecentTaskStates: { lookbackHours: 24 * 7 },\n  },\n  // Daily fire on the morning anchor so the morning-brief consolidation can\n  // pick up the observation in the same wake.confirmed batch.\n  trigger: {\n    kind: \"relative_to_anchor\",\n    anchorKey: \"wake.confirmed\",\n    offsetMinutes: 0,\n  },\n  priority: \"low\",\n  respectsGlobalPause: true,\n  source: \"default_pack\",\n  createdBy: QUIET_USER_WATCHER_PACK_KEY,\n  // Watcher tasks emit observations; their output is consumed by the\n  // morning-brief consolidation, not surfaced to the owner directly.\n  ownerVisible: false,\n  idempotencyKey: QUIET_USER_WATCHER_RECORD_IDS.watcher,\n  metadata: {\n    packKey: QUIET_USER_WATCHER_PACK_KEY,\n    recordKey: \"quiet-user-watcher\",\n    quietThresholdDays: QUIET_THRESHOLD_DAYS,\n  },\n};\n\nconst watcherRecord = compileTaskDefinition(watcherDefinition);\n\nexport const quietUserWatcherPack: DefaultPack = {\n  key: QUIET_USER_WATCHER_PACK_KEY,\n  label: \"Quiet-user watcher\",\n  description:\n    \"Daily watcher that flags long silences and missed check-ins. Default threshold is 3 days quiet, configurable per-task via metadata.quietThresholdDays. Surfaces observations into the morning brief instead of sending its own notification.\",\n  defaultEnabled: true,\n  requiredCapabilities: [],\n  records: [watcherRecord],\n  uiHints: {\n    summaryOnDayOne:\n      \"Daily silent watcher; only surfaces text when you've been quiet 3+ days or skipped yesterday's check-in.\",\n    expectedFireCountPerDay: 0,\n  },\n};\n\n// -- helpers used by the watcher when it actually runs --\n\nexport interface QuietUserWatcherObservation {\n  kind: \"quiet_for_days\" | \"missed_yesterday_checkin\";\n  days?: number;\n  detail: string;\n}\n\n/**\n * Pure helper: turn a `RecentTaskStatesSummary` into observations the\n * morning-brief should fold in. Pure because the watcher task itself is\n * what the runner schedules; this helper just shapes the output.\n */\nexport function deriveQuietObservations(\n  summary: RecentTaskStatesSummary,\n  options: { thresholdDays?: number } = {},\n): QuietUserWatcherObservation[] {\n  const threshold = options.thresholdDays ?? QUIET_THRESHOLD_DAYS;\n  const observations: QuietUserWatcherObservation[] = [];\n\n  // Streak shape: a series of consecutive checkins that ended in `expired`\n  // (or `skipped`) means the owner hasn't been replying. We treat any\n  // expired/skipped streak >= threshold as \"quiet\".\n  for (const streak of summary.streaks) {\n    const counts =\n      (streak.kind === \"checkin\" || streak.kind === \"followup\") &&\n      (streak.outcome === \"expired\" || streak.outcome === \"skipped\")\n        ? streak.consecutive\n        : 0;\n    if (counts >= threshold) {\n      observations.push({\n        kind: \"quiet_for_days\",\n        days: counts,\n        detail: `${counts} consecutive ${streak.kind}s without reply`,\n      });\n      break;\n    }\n  }\n\n  // Missed-yesterday-checkin: a one-step streak of `expired` checkin counts.\n  for (const streak of summary.streaks) {\n    if (\n      streak.kind === \"checkin\" &&\n      streak.outcome === \"expired\" &&\n      streak.consecutive >= 1\n    ) {\n      observations.push({\n        kind: \"missed_yesterday_checkin\",\n        detail: \"yesterday's check-in expired without reply\",\n      });\n      break;\n    }\n  }\n\n  return observations;\n}\n\n/**\n * Convenience wrapper for the runtime: ask the provider for a summary, then\n * derive observations.\n */\nexport async function runQuietUserWatcher(\n  provider: RecentTaskStatesProvider,\n  options: { thresholdDays?: number; lookbackDays?: number } = {},\n): Promise<QuietUserWatcherObservation[]> {\n  const summary = await provider.summarize({\n    kinds: [\"checkin\", \"followup\"],\n    lookbackDays: options.lookbackDays ?? 7,\n  });\n  return deriveQuietObservations(summary, {\n    thresholdDays: options.thresholdDays,\n  });\n}\n"],"mappings":"AAoBA;AAAA,EACE;AAAA,OAEK;AAEA,MAAM,8BAA8B;AAEpC,MAAM,gCAAgC;AAAA,EAC3C,SAAS;AACX;AAOO,MAAM,uBAAuB;AAEpC,MAAM,oBAA2C;AAAA,EAC/C,gBAAgB;AAAA,EAChB,oBACE;AAAA,EACF,gBAAgB;AAAA,IACd,mBAAmB,CAAC,iBAAiB,UAAU;AAAA,IAC/C,yBAAyB,EAAE,eAAe,KAAK,EAAE;AAAA,EACnD;AAAA;AAAA;AAAA,EAGA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,WAAW;AAAA,IACX,eAAe;AAAA,EACjB;AAAA,EACA,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,QAAQ;AAAA,EACR,WAAW;AAAA;AAAA;AAAA,EAGX,cAAc;AAAA,EACd,gBAAgB,8BAA8B;AAAA,EAC9C,UAAU;AAAA,IACR,SAAS;AAAA,IACT,WAAW;AAAA,IACX,oBAAoB;AAAA,EACtB;AACF;AAEA,MAAM,gBAAgB,sBAAsB,iBAAiB;AAEtD,MAAM,uBAAoC;AAAA,EAC/C,KAAK;AAAA,EACL,OAAO;AAAA,EACP,aACE;AAAA,EACF,gBAAgB;AAAA,EAChB,sBAAsB,CAAC;AAAA,EACvB,SAAS,CAAC,aAAa;AAAA,EACvB,SAAS;AAAA,IACP,iBACE;AAAA,IACF,yBAAyB;AAAA,EAC3B;AACF;AAeO,SAAS,wBACd,SACA,UAAsC,CAAC,GACR;AAC/B,QAAM,YAAY,QAAQ,iBAAiB;AAC3C,QAAM,eAA8C,CAAC;AAKrD,aAAW,UAAU,QAAQ,SAAS;AACpC,UAAM,UACH,OAAO,SAAS,aAAa,OAAO,SAAS,gBAC7C,OAAO,YAAY,aAAa,OAAO,YAAY,aAChD,OAAO,cACP;AACN,QAAI,UAAU,WAAW;AACvB,mBAAa,KAAK;AAAA,QAChB,MAAM;AAAA,QACN,MAAM;AAAA,QACN,QAAQ,GAAG,MAAM,gBAAgB,OAAO,IAAI;AAAA,MAC9C,CAAC;AACD;AAAA,IACF;AAAA,EACF;AAGA,aAAW,UAAU,QAAQ,SAAS;AACpC,QACE,OAAO,SAAS,aAChB,OAAO,YAAY,aACnB,OAAO,eAAe,GACtB;AACA,mBAAa,KAAK;AAAA,QAChB,MAAM;AAAA,QACN,QAAQ;AAAA,MACV,CAAC;AACD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAMA,eAAsB,oBACpB,UACA,UAA6D,CAAC,GACtB;AACxC,QAAM,UAAU,MAAM,SAAS,UAAU;AAAA,IACvC,OAAO,CAAC,WAAW,UAAU;AAAA,IAC7B,cAAc,QAAQ,gBAAgB;AAAA,EACxC,CAAC;AACD,SAAO,wBAAwB,SAAS;AAAA,IACtC,eAAe,QAAQ;AAAA,EACzB,CAAC;AACH;","names":[]}

package/dist/default-packs/registry-types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Default-pack registration shapes.
+ *
+ * `DefaultPack` is the envelope type for a curated set of compiled
+ * `ScheduledTask` records, consolidation policies, and escalation ladders
+ * shipped with the agent.
+ * `DefaultPackRegistry` is the runtime registration surface.
+ */
+import type { AnchorConsolidationPolicy, DefaultEscalationLadderKey, EscalationLadder, ScheduledTaskSeed } from "./contract-types.js";
+/**
+ * A "default pack" is a curated set of compiled `ScheduledTask` records — and
+ * any registry contributions (consolidation policies, escalation ladders) —
+ * that ships with the agent. Pack authors should define typed task definitions
+ * and compile them into this persisted primitive at registration time.
+ *
+ * `defaultEnabled = true` means the records auto-seed when first-run runs the
+ * defaults path; `false` means the pack is **offered** at first-run customize
+ * but not seeded automatically (this is how the 8 habit-starters ship).
+ */
+export interface DefaultPack {
+    /** Stable namespaced key, e.g. `daily-rhythm`, `habit-starters`. */
+    key: string;
+    /** Short human label (used in first-run "pick a pack" UI). */
+    label: string;
+    /** One-paragraph rationale; surfaces in pack-detail UI and curation doc. */
+    description: string;
+    /**
+     * If `true`, first-run defaults path seeds these records automatically.
+     * If `false`, the pack is offered at customize time only.
+     */
+    defaultEnabled: boolean;
+    /** Capability gate; pack is offered only if registry has all of these. */
+    requiredCapabilities: string[];
+    /** ScheduledTask seeds (no `taskId`, no `state`). */
+    records: ScheduledTaskSeed[];
+    /** Anchor consolidation policies the pack contributes. */
+    consolidationPolicies?: AnchorConsolidationPolicy[];
+    /** Named escalation ladders the pack contributes. */
+    escalationLadders?: Partial<Record<DefaultEscalationLadderKey, EscalationLadder>>;
+    /** Optional metadata surface for first-run UI. */
+    uiHints?: {
+        summaryOnDayOne: string;
+        expectedFireCountPerDay: number;
+    };
+}
+export interface DefaultPackRegistry {
+    register(pack: DefaultPack): void;
+    list(): DefaultPack[];
+    get(key: string): DefaultPack | null;
+}
+//# sourceMappingURL=registry-types.d.ts.map

package/dist/default-packs/registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-types.d.ts","sourceRoot":"","sources":["../../src/default-packs/registry-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,qDAAqD;IACrD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACpD,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CACzB,MAAM,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CACrD,CAAC;IACF,kDAAkD;IAClD,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,IAAI,IAAI,WAAW,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CACtC"}

package/dist/default-packs/registry-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=registry-types.js.map

package/dist/default-packs/registry-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/default-packs/task-definitions.d.ts

@@ -0,0 +1,88 @@
+import type { ScheduledTask, ScheduledTaskContextRequest, ScheduledTaskSeed, ScheduledTaskSubjectKind, ScheduledTaskTrigger } from "./contract-types.js";
+type ScheduledTaskSeedBase = Omit<ScheduledTaskSeed, "kind">;
+export type CompiledTaskDefinition = ScheduledTaskSeed;
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: string[];
+};
+interface TaskDefinitionBase {
+    promptInstructions: string;
+    contextRequest?: ScheduledTaskContextRequest;
+    trigger: ScheduledTaskTrigger;
+    priority: ScheduledTask["priority"];
+    shouldFire?: ScheduledTaskSeedBase["shouldFire"];
+    escalation?: ScheduledTaskSeedBase["escalation"];
+    pipeline?: ScheduledTaskSeedBase["pipeline"];
+    idempotencyKey?: string;
+    respectsGlobalPause: boolean;
+    source: ScheduledTask["source"];
+    createdBy: string;
+    ownerVisible: boolean;
+    metadata?: Record<string, unknown>;
+}
+type CompletionCheck<K extends string> = {
+    kind: K;
+    params?: ScheduledTaskSeed["completionCheck"] extends infer Check ? Check extends {
+        params?: infer Params;
+    } ? Params : never : never;
+    followupAfterMinutes?: number;
+};
+type OutputDefinition = NonNullable<ScheduledTaskSeed["output"]> & {
+    target: string;
+};
+export interface ReminderTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "reminder";
+    completionCheck?: CompletionCheck<"user_acknowledged" | "user_replied_within">;
+    output?: ScheduledTaskSeedBase["output"];
+}
+export interface CheckInTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "checkin";
+    completionCheck: CompletionCheck<"user_replied_within" | "user_acknowledged">;
+    output?: ScheduledTaskSeedBase["output"];
+}
+export interface FollowUpTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "followup";
+    completionCheck?: CompletionCheck<"subject_updated" | "user_replied_within" | "user_acknowledged">;
+    subject?: {
+        kind: Extract<ScheduledTaskSubjectKind, "entity" | "relationship" | "thread">;
+        id: string;
+    };
+    output?: ScheduledTaskSeedBase["output"];
+}
+export interface WatcherTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "watcher";
+    shouldFire?: NonNullable<ScheduledTaskSeedBase["shouldFire"]>;
+    output?: ScheduledTaskSeedBase["output"];
+}
+export interface RecapTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "recap";
+    completionCheck?: CompletionCheck<"user_acknowledged" | "user_replied_within">;
+    output?: ScheduledTaskSeedBase["output"];
+}
+export interface ApprovalTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "approval";
+    completionCheck: CompletionCheck<"approval_resolved" | "user_replied_within">;
+    subject: {
+        kind: Extract<ScheduledTaskSubjectKind, "entity" | "relationship" | "thread" | "document" | "calendar_event">;
+        id: string;
+    };
+    output: OutputDefinition;
+}
+export interface OutputTaskDefinition extends TaskDefinitionBase {
+    definitionKind: "output";
+    output: OutputDefinition;
+    completionCheck?: CompletionCheck<"delivered" | "user_acknowledged">;
+}
+export type TaskDefinition = ReminderTaskDefinition | CheckInTaskDefinition | FollowUpTaskDefinition | WatcherTaskDefinition | RecapTaskDefinition | ApprovalTaskDefinition | OutputTaskDefinition;
+export interface TaskCompiler<T extends TaskDefinition> {
+    validate(definition: T): ValidationResult;
+    compile(definition: T): ScheduledTaskSeed;
+}
+export declare const defaultTaskCompiler: TaskCompiler<TaskDefinition>;
+export declare function validateTaskDefinition(definition: TaskDefinition): ValidationResult;
+export declare function compileTaskDefinition(definition: TaskDefinition): ScheduledTaskSeed;
+export declare function compileTaskDefinitions(definitions: ReadonlyArray<TaskDefinition>): ScheduledTaskSeed[];
+export {};
+//# sourceMappingURL=task-definitions.d.ts.map

package/dist/default-packs/task-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-definitions.d.ts","sourceRoot":"","sources":["../../src/default-packs/task-definitions.ts"],"names":[],"mappings":"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"}

package/dist/default-packs/task-definitions.js

@@ -0,0 +1,87 @@
+const allowedCompletionChecks = {
+  reminder: /* @__PURE__ */ new Set(["user_acknowledged", "user_replied_within"]),
+  checkin: /* @__PURE__ */ new Set(["user_replied_within", "user_acknowledged"]),
+  followup: /* @__PURE__ */ new Set([
+    "subject_updated",
+    "user_replied_within",
+    "user_acknowledged"
+  ]),
+  watcher: /* @__PURE__ */ new Set([]),
+  recap: /* @__PURE__ */ new Set(["user_acknowledged", "user_replied_within"]),
+  approval: /* @__PURE__ */ new Set(["approval_resolved", "user_replied_within"]),
+  output: /* @__PURE__ */ new Set(["delivered", "user_acknowledged"])
+};
+const defaultTaskCompiler = {
+  validate: validateTaskDefinition,
+  compile: compileTaskDefinition
+};
+function validateTaskDefinition(definition) {
+  const errors = [];
+  if (!definition.trigger) {
+    errors.push(`${definition.definitionKind} task is missing trigger.`);
+  }
+  const triggerNeedsGate = definition.trigger.kind === "event" || definition.trigger.kind === "interval";
+  if (triggerNeedsGate && !definition.shouldFire) {
+    errors.push(
+      `${definition.definitionKind} task with ${definition.trigger.kind} trigger must declare shouldFire gates.`
+    );
+  }
+  if (definition.definitionKind === "watcher" && definition.ownerVisible) {
+    errors.push("watcher task definitions must not be owner-visible.");
+  }
+  if ((definition.definitionKind === "approval" || definition.definitionKind === "output") && !definition.output) {
+    errors.push(
+      `${definition.definitionKind} task definitions require output.`
+    );
+  }
+  if (definition.output?.destination === "channel" && !definition.output.target) {
+    errors.push(
+      "channel output requires output.target connector/channel metadata."
+    );
+  }
+  if (definition.definitionKind === "approval" && (!definition.subject.kind || !definition.subject.id)) {
+    errors.push("approval task definitions require a typed subject.");
+  }
+  const completionKind = "completionCheck" in definition ? definition.completionCheck?.kind : void 0;
+  if (completionKind) {
+    const allowed = allowedCompletionChecks[definition.definitionKind];
+    if (!allowed.has(completionKind)) {
+      errors.push(
+        `${definition.definitionKind} task cannot use completionCheck.kind="${completionKind}".`
+      );
+    }
+  } else if (definition.definitionKind === "checkin" || definition.definitionKind === "approval") {
+    errors.push(
+      `${definition.definitionKind} task definitions require completionCheck.`
+    );
+  }
+  if (definition.definitionKind === "followup" && definition.completionCheck?.kind === "subject_updated" && !definition.subject) {
+    errors.push(
+      "followup task definitions using subject_updated require subject."
+    );
+  }
+  return errors.length === 0 ? { ok: true } : { ok: false, errors };
+}
+function compileTaskDefinition(definition) {
+  const validation = validateTaskDefinition(definition);
+  if (!validation.ok) {
+    throw new Error(
+      `Invalid ${definition.definitionKind} task definition: ${validation.errors.join(" ")}`
+    );
+  }
+  const { definitionKind, ...seed } = definition;
+  return {
+    ...seed,
+    kind: definitionKind
+  };
+}
+function compileTaskDefinitions(definitions) {
+  return definitions.map((definition) => compileTaskDefinition(definition));
+}
+export {
+  compileTaskDefinition,
+  compileTaskDefinitions,
+  defaultTaskCompiler,
+  validateTaskDefinition
+};
+//# sourceMappingURL=task-definitions.js.map

package/dist/default-packs/task-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/default-packs/task-definitions.ts"],"sourcesContent":["import type {\n  ScheduledTask,\n  ScheduledTaskContextRequest,\n  ScheduledTaskSeed,\n  ScheduledTaskSubjectKind,\n  ScheduledTaskTrigger,\n} from \"./contract-types.js\";\n\ntype ScheduledTaskSeedBase = Omit<ScheduledTaskSeed, \"kind\">;\n\nexport type CompiledTaskDefinition = ScheduledTaskSeed;\n\nexport type ValidationResult = { ok: true } | { ok: false; errors: string[] };\n\ninterface TaskDefinitionBase {\n  promptInstructions: string;\n  contextRequest?: ScheduledTaskContextRequest;\n  trigger: ScheduledTaskTrigger;\n  priority: ScheduledTask[\"priority\"];\n  shouldFire?: ScheduledTaskSeedBase[\"shouldFire\"];\n  escalation?: ScheduledTaskSeedBase[\"escalation\"];\n  pipeline?: ScheduledTaskSeedBase[\"pipeline\"];\n  idempotencyKey?: string;\n  respectsGlobalPause: boolean;\n  source: ScheduledTask[\"source\"];\n  createdBy: string;\n  ownerVisible: boolean;\n  metadata?: Record<string, unknown>;\n}\n\ntype CompletionCheck<K extends string> = {\n  kind: K;\n  params?: ScheduledTaskSeed[\"completionCheck\"] extends infer Check\n    ? Check extends { params?: infer Params }\n      ? Params\n      : never\n    : never;\n  followupAfterMinutes?: number;\n};\n\ntype OutputDefinition = NonNullable<ScheduledTaskSeed[\"output\"]> & {\n  target: string;\n};\n\nexport interface ReminderTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"reminder\";\n  completionCheck?: CompletionCheck<\n    \"user_acknowledged\" | \"user_replied_within\"\n  >;\n  output?: ScheduledTaskSeedBase[\"output\"];\n}\n\nexport interface CheckInTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"checkin\";\n  completionCheck: CompletionCheck<\"user_replied_within\" | \"user_acknowledged\">;\n  output?: ScheduledTaskSeedBase[\"output\"];\n}\n\nexport interface FollowUpTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"followup\";\n  completionCheck?: CompletionCheck<\n    \"subject_updated\" | \"user_replied_within\" | \"user_acknowledged\"\n  >;\n  subject?: {\n    kind: Extract<\n      ScheduledTaskSubjectKind,\n      \"entity\" | \"relationship\" | \"thread\"\n    >;\n    id: string;\n  };\n  output?: ScheduledTaskSeedBase[\"output\"];\n}\n\nexport interface WatcherTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"watcher\";\n  shouldFire?: NonNullable<ScheduledTaskSeedBase[\"shouldFire\"]>;\n  output?: ScheduledTaskSeedBase[\"output\"];\n}\n\nexport interface RecapTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"recap\";\n  completionCheck?: CompletionCheck<\n    \"user_acknowledged\" | \"user_replied_within\"\n  >;\n  output?: ScheduledTaskSeedBase[\"output\"];\n}\n\nexport interface ApprovalTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"approval\";\n  completionCheck: CompletionCheck<\"approval_resolved\" | \"user_replied_within\">;\n  subject: {\n    kind: Extract<\n      ScheduledTaskSubjectKind,\n      \"entity\" | \"relationship\" | \"thread\" | \"document\" | \"calendar_event\"\n    >;\n    id: string;\n  };\n  output: OutputDefinition;\n}\n\nexport interface OutputTaskDefinition extends TaskDefinitionBase {\n  definitionKind: \"output\";\n  output: OutputDefinition;\n  completionCheck?: CompletionCheck<\"delivered\" | \"user_acknowledged\">;\n}\n\nexport type TaskDefinition =\n  | ReminderTaskDefinition\n  | CheckInTaskDefinition\n  | FollowUpTaskDefinition\n  | WatcherTaskDefinition\n  | RecapTaskDefinition\n  | ApprovalTaskDefinition\n  | OutputTaskDefinition;\n\nexport interface TaskCompiler<T extends TaskDefinition> {\n  validate(definition: T): ValidationResult;\n  compile(definition: T): ScheduledTaskSeed;\n}\n\nconst allowedCompletionChecks: Record<\n  TaskDefinition[\"definitionKind\"],\n  Set<string>\n> = {\n  reminder: new Set([\"user_acknowledged\", \"user_replied_within\"]),\n  checkin: new Set([\"user_replied_within\", \"user_acknowledged\"]),\n  followup: new Set([\n    \"subject_updated\",\n    \"user_replied_within\",\n    \"user_acknowledged\",\n  ]),\n  watcher: new Set([]),\n  recap: new Set([\"user_acknowledged\", \"user_replied_within\"]),\n  approval: new Set([\"approval_resolved\", \"user_replied_within\"]),\n  output: new Set([\"delivered\", \"user_acknowledged\"]),\n};\n\nexport const defaultTaskCompiler: TaskCompiler<TaskDefinition> = {\n  validate: validateTaskDefinition,\n  compile: compileTaskDefinition,\n};\n\nexport function validateTaskDefinition(\n  definition: TaskDefinition,\n): ValidationResult {\n  const errors: string[] = [];\n\n  if (!definition.trigger) {\n    errors.push(`${definition.definitionKind} task is missing trigger.`);\n  }\n\n  const triggerNeedsGate =\n    definition.trigger.kind === \"event\" ||\n    definition.trigger.kind === \"interval\";\n  if (triggerNeedsGate && !definition.shouldFire) {\n    errors.push(\n      `${definition.definitionKind} task with ${definition.trigger.kind} trigger must declare shouldFire gates.`,\n    );\n  }\n\n  if (definition.definitionKind === \"watcher\" && definition.ownerVisible) {\n    errors.push(\"watcher task definitions must not be owner-visible.\");\n  }\n\n  if (\n    (definition.definitionKind === \"approval\" ||\n      definition.definitionKind === \"output\") &&\n    !definition.output\n  ) {\n    errors.push(\n      `${definition.definitionKind} task definitions require output.`,\n    );\n  }\n\n  if (\n    definition.output?.destination === \"channel\" &&\n    !definition.output.target\n  ) {\n    errors.push(\n      \"channel output requires output.target connector/channel metadata.\",\n    );\n  }\n\n  if (\n    definition.definitionKind === \"approval\" &&\n    (!definition.subject.kind || !definition.subject.id)\n  ) {\n    errors.push(\"approval task definitions require a typed subject.\");\n  }\n\n  const completionKind =\n    \"completionCheck\" in definition\n      ? definition.completionCheck?.kind\n      : undefined;\n  if (completionKind) {\n    const allowed = allowedCompletionChecks[definition.definitionKind];\n    if (!allowed.has(completionKind)) {\n      errors.push(\n        `${definition.definitionKind} task cannot use completionCheck.kind=\"${completionKind}\".`,\n      );\n    }\n  } else if (\n    definition.definitionKind === \"checkin\" ||\n    definition.definitionKind === \"approval\"\n  ) {\n    errors.push(\n      `${definition.definitionKind} task definitions require completionCheck.`,\n    );\n  }\n\n  if (\n    definition.definitionKind === \"followup\" &&\n    definition.completionCheck?.kind === \"subject_updated\" &&\n    !definition.subject\n  ) {\n    errors.push(\n      \"followup task definitions using subject_updated require subject.\",\n    );\n  }\n\n  return errors.length === 0 ? { ok: true } : { ok: false, errors };\n}\n\nexport function compileTaskDefinition(\n  definition: TaskDefinition,\n): ScheduledTaskSeed {\n  const validation = validateTaskDefinition(definition);\n  if (!validation.ok) {\n    throw new Error(\n      `Invalid ${definition.definitionKind} task definition: ${validation.errors.join(\" \")}`,\n    );\n  }\n\n  const { definitionKind, ...seed } = definition;\n  return {\n    ...seed,\n    kind: definitionKind,\n  };\n}\n\nexport function compileTaskDefinitions(\n  definitions: ReadonlyArray<TaskDefinition>,\n): ScheduledTaskSeed[] {\n  return definitions.map((definition) => compileTaskDefinition(definition));\n}\n"],"mappings":"AAwHA,MAAM,0BAGF;AAAA,EACF,UAAU,oBAAI,IAAI,CAAC,qBAAqB,qBAAqB,CAAC;AAAA,EAC9D,SAAS,oBAAI,IAAI,CAAC,uBAAuB,mBAAmB,CAAC;AAAA,EAC7D,UAAU,oBAAI,IAAI;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,SAAS,oBAAI,IAAI,CAAC,CAAC;AAAA,EACnB,OAAO,oBAAI,IAAI,CAAC,qBAAqB,qBAAqB,CAAC;AAAA,EAC3D,UAAU,oBAAI,IAAI,CAAC,qBAAqB,qBAAqB,CAAC;AAAA,EAC9D,QAAQ,oBAAI,IAAI,CAAC,aAAa,mBAAmB,CAAC;AACpD;AAEO,MAAM,sBAAoD;AAAA,EAC/D,UAAU;AAAA,EACV,SAAS;AACX;AAEO,SAAS,uBACd,YACkB;AAClB,QAAM,SAAmB,CAAC;AAE1B,MAAI,CAAC,WAAW,SAAS;AACvB,WAAO,KAAK,GAAG,WAAW,cAAc,2BAA2B;AAAA,EACrE;AAEA,QAAM,mBACJ,WAAW,QAAQ,SAAS,WAC5B,WAAW,QAAQ,SAAS;AAC9B,MAAI,oBAAoB,CAAC,WAAW,YAAY;AAC9C,WAAO;AAAA,MACL,GAAG,WAAW,cAAc,cAAc,WAAW,QAAQ,IAAI;AAAA,IACnE;AAAA,EACF;AAEA,MAAI,WAAW,mBAAmB,aAAa,WAAW,cAAc;AACtE,WAAO,KAAK,qDAAqD;AAAA,EACnE;AAEA,OACG,WAAW,mBAAmB,cAC7B,WAAW,mBAAmB,aAChC,CAAC,WAAW,QACZ;AACA,WAAO;AAAA,MACL,GAAG,WAAW,cAAc;AAAA,IAC9B;AAAA,EACF;AAEA,MACE,WAAW,QAAQ,gBAAgB,aACnC,CAAC,WAAW,OAAO,QACnB;AACA,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAEA,MACE,WAAW,mBAAmB,eAC7B,CAAC,WAAW,QAAQ,QAAQ,CAAC,WAAW,QAAQ,KACjD;AACA,WAAO,KAAK,oDAAoD;AAAA,EAClE;AAEA,QAAM,iBACJ,qBAAqB,aACjB,WAAW,iBAAiB,OAC5B;AACN,MAAI,gBAAgB;AAClB,UAAM,UAAU,wBAAwB,WAAW,cAAc;AACjE,QAAI,CAAC,QAAQ,IAAI,cAAc,GAAG;AAChC,aAAO;AAAA,QACL,GAAG,WAAW,cAAc,0CAA0C,cAAc;AAAA,MACtF;AAAA,IACF;AAAA,EACF,WACE,WAAW,mBAAmB,aAC9B,WAAW,mBAAmB,YAC9B;AACA,WAAO;AAAA,MACL,GAAG,WAAW,cAAc;AAAA,IAC9B;AAAA,EACF;AAEA,MACE,WAAW,mBAAmB,cAC9B,WAAW,iBAAiB,SAAS,qBACrC,CAAC,WAAW,SACZ;AACA,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAEA,SAAO,OAAO,WAAW,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,OAAO,OAAO;AAClE;AAEO,SAAS,sBACd,YACmB;AACnB,QAAM,aAAa,uBAAuB,UAAU;AACpD,MAAI,CAAC,WAAW,IAAI;AAClB,UAAM,IAAI;AAAA,MACR,WAAW,WAAW,cAAc,qBAAqB,WAAW,OAAO,KAAK,GAAG,CAAC;AAAA,IACtF;AAAA,EACF;AAEA,QAAM,EAAE,gBAAgB,GAAG,KAAK,IAAI;AACpC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM;AAAA,EACR;AACF;AAEO,SAAS,uBACd,aACqB;AACrB,SAAO,YAAY,IAAI,CAAC,eAAe,sBAAsB,UAAU,CAAC;AAC1E;","names":[]}

package/dist/events/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * LifeOps-specific window events.
+ *
+ * Dispatched on `window` for cross-frame visibility and local diagnostics.
+ */
+import type { LifeOpsConnectorMode, LifeOpsConnectorSide } from "@elizaos/shared";
+export declare const LIFEOPS_GOOGLE_CONNECTOR_REFRESH_EVENT: "eliza:lifeops-google-connector-refresh";
+export declare const LIFEOPS_GITHUB_CALLBACK_EVENT: "eliza:lifeops-github-callback";
+export declare const LIFEOPS_ACTIVITY_SIGNALS_STATUS_EVENT: "eliza:lifeops-activity-signals-status";
+export interface LifeOpsGoogleConnectorRefreshDetail {
+    origin?: string;
+    side?: LifeOpsConnectorSide;
+    mode?: LifeOpsConnectorMode;
+    source?: "callback" | "connect" | "disconnect" | "mode_change" | "refresh" | "focus" | "visibility" | "resume";
+}
+export interface LifeOpsGithubCallbackDetail {
+    target: "owner" | "agent";
+    status: "connected" | "error";
+    connectionId?: string | null;
+    agentId?: string | null;
+    githubUsername?: string | null;
+    bindingMode?: "cloud-managed" | "shared-owner" | null;
+    message?: string | null;
+    restarted?: boolean;
+}
+export interface LifeOpsActivitySignalsStatusDetail {
+    status: "capture_error" | "snapshot_unavailable" | "background_refresh_unavailable";
+    message?: string;
+    reason?: string;
+}
+export declare function dispatchLifeOpsGoogleConnectorRefresh(detail?: LifeOpsGoogleConnectorRefreshDetail): void;
+export declare function dispatchLifeOpsGithubCallback(detail: LifeOpsGithubCallbackDetail): void;
+export declare function dispatchLifeOpsActivitySignalsStatus(detail: LifeOpsActivitySignalsStatusDetail): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,sCAAsC,EACjD,wCAAiD,CAAC;AAEpD,eAAO,MAAM,6BAA6B,EACxC,+BAAwC,CAAC;AAE3C,eAAO,MAAM,qCAAqC,EAChD,uCAAgD,CAAC;AAEnD,MAAM,WAAW,mCAAmC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,MAAM,CAAC,EACH,UAAU,GACV,SAAS,GACT,YAAY,GACZ,aAAa,GACb,SAAS,GACT,OAAO,GACP,YAAY,GACZ,QAAQ,CAAC;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EACF,eAAe,GACf,sBAAsB,GACtB,gCAAgC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,CAAC,EAAE,mCAAmC,GAC3C,IAAI,CAKN;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,2BAA2B,GAClC,IAAI,CAKN;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,kCAAkC,GACzC,IAAI,CAKN"}

package/dist/events/index.js

@@ -0,0 +1,30 @@
+const LIFEOPS_GOOGLE_CONNECTOR_REFRESH_EVENT = "eliza:lifeops-google-connector-refresh";
+const LIFEOPS_GITHUB_CALLBACK_EVENT = "eliza:lifeops-github-callback";
+const LIFEOPS_ACTIVITY_SIGNALS_STATUS_EVENT = "eliza:lifeops-activity-signals-status";
+function dispatchLifeOpsGoogleConnectorRefresh(detail) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(
+    new CustomEvent(LIFEOPS_GOOGLE_CONNECTOR_REFRESH_EVENT, { detail })
+  );
+}
+function dispatchLifeOpsGithubCallback(detail) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(
+    new CustomEvent(LIFEOPS_GITHUB_CALLBACK_EVENT, { detail })
+  );
+}
+function dispatchLifeOpsActivitySignalsStatus(detail) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(
+    new CustomEvent(LIFEOPS_ACTIVITY_SIGNALS_STATUS_EVENT, { detail })
+  );
+}
+export {
+  LIFEOPS_ACTIVITY_SIGNALS_STATUS_EVENT,
+  LIFEOPS_GITHUB_CALLBACK_EVENT,
+  LIFEOPS_GOOGLE_CONNECTOR_REFRESH_EVENT,
+  dispatchLifeOpsActivitySignalsStatus,
+  dispatchLifeOpsGithubCallback,
+  dispatchLifeOpsGoogleConnectorRefresh
+};
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/events/index.ts"],"sourcesContent":["/**\n * LifeOps-specific window events.\n *\n * Dispatched on `window` for cross-frame visibility and local diagnostics.\n */\n\nimport type {\n  LifeOpsConnectorMode,\n  LifeOpsConnectorSide,\n} from \"@elizaos/shared\";\n\nexport const LIFEOPS_GOOGLE_CONNECTOR_REFRESH_EVENT =\n  \"eliza:lifeops-google-connector-refresh\" as const;\n\nexport const LIFEOPS_GITHUB_CALLBACK_EVENT =\n  \"eliza:lifeops-github-callback\" as const;\n\nexport const LIFEOPS_ACTIVITY_SIGNALS_STATUS_EVENT =\n  \"eliza:lifeops-activity-signals-status\" as const;\n\nexport interface LifeOpsGoogleConnectorRefreshDetail {\n  origin?: string;\n  side?: LifeOpsConnectorSide;\n  mode?: LifeOpsConnectorMode;\n  source?:\n    | \"callback\"\n    | \"connect\"\n    | \"disconnect\"\n    | \"mode_change\"\n    | \"refresh\"\n    | \"focus\"\n    | \"visibility\"\n    | \"resume\";\n}\n\nexport interface LifeOpsGithubCallbackDetail {\n  target: \"owner\" | \"agent\";\n  status: \"connected\" | \"error\";\n  connectionId?: string | null;\n  agentId?: string | null;\n  githubUsername?: string | null;\n  bindingMode?: \"cloud-managed\" | \"shared-owner\" | null;\n  message?: string | null;\n  restarted?: boolean;\n}\n\nexport interface LifeOpsActivitySignalsStatusDetail {\n  status:\n    | \"capture_error\"\n    | \"snapshot_unavailable\"\n    | \"background_refresh_unavailable\";\n  message?: string;\n  reason?: string;\n}\n\nexport function dispatchLifeOpsGoogleConnectorRefresh(\n  detail?: LifeOpsGoogleConnectorRefreshDetail,\n): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(\n    new CustomEvent(LIFEOPS_GOOGLE_CONNECTOR_REFRESH_EVENT, { detail }),\n  );\n}\n\nexport function dispatchLifeOpsGithubCallback(\n  detail: LifeOpsGithubCallbackDetail,\n): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(\n    new CustomEvent(LIFEOPS_GITHUB_CALLBACK_EVENT, { detail }),\n  );\n}\n\nexport function dispatchLifeOpsActivitySignalsStatus(\n  detail: LifeOpsActivitySignalsStatusDetail,\n): void {\n  if (typeof window === \"undefined\") return;\n  window.dispatchEvent(\n    new CustomEvent(LIFEOPS_ACTIVITY_SIGNALS_STATUS_EVENT, { detail }),\n  );\n}\n"],"mappings":"AAWO,MAAM,yCACX;AAEK,MAAM,gCACX;AAEK,MAAM,wCACX;AAqCK,SAAS,sCACd,QACM;AACN,MAAI,OAAO,WAAW,YAAa;AACnC,SAAO;AAAA,IACL,IAAI,YAAY,wCAAwC,EAAE,OAAO,CAAC;AAAA,EACpE;AACF;AAEO,SAAS,8BACd,QACM;AACN,MAAI,OAAO,WAAW,YAAa;AACnC,SAAO;AAAA,IACL,IAAI,YAAY,+BAA+B,EAAE,OAAO,CAAC;AAAA,EAC3D;AACF;AAEO,SAAS,qCACd,QACM;AACN,MAAI,OAAO,WAAW,YAAa;AACnC,SAAO;AAAA,IACL,IAAI,YAAY,uCAAuC,EAAE,OAAO,CAAC;AAAA,EACnE;AACF;","names":[]}

package/dist/followup/actions/listOverdueFollowups.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "@elizaos/core";
+export declare const listOverdueFollowupsAction: Action;
+//# sourceMappingURL=listOverdueFollowups.d.ts.map

package/dist/followup/actions/listOverdueFollowups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listOverdueFollowups.d.ts","sourceRoot":"","sources":["../../../src/followup/actions/listOverdueFollowups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,eAAe,CAAC;AAsB1E,eAAO,MAAM,0BAA0B,EAAE,MAgFxC,CAAC"}