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

package/dist/followup/actions/listOverdueFollowups.js

@@ -0,0 +1,90 @@
+import {
+  computeOverdueFollowups,
+  FOLLOWUP_DEFAULT_THRESHOLD_DAYS
+} from "../followup-tracker.js";
+function coercePositiveNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed) && parsed > 0) return parsed;
+  }
+  return null;
+}
+const listOverdueFollowupsAction = {
+  name: "LIST_OVERDUE_FOLLOWUPS",
+  similes: [
+    "OVERDUE_FOLLOWUPS",
+    "WHO_TO_FOLLOW_UP",
+    "WHO_HAVEN_T_I_TALKED_TO",
+    "LIST_FOLLOWUPS",
+    "FOLLOWUP_LIST",
+    // PRD action-catalog alias.
+    // See packages/docs/action-prd-map.md.
+    "FOLLOWUP_LIST_OVERDUE"
+  ],
+  description: "List contacts whose last-contacted-at timestamp exceeds their follow-up threshold. Use this for overdue or pending follow-up list queries, not for scheduling a new reminder. Returns an empty list when the RelationshipsService is not available.",
+  contexts: ["contacts", "tasks", "calendar", "messaging"],
+  roleGate: { minRole: "OWNER" },
+  validate: async () => true,
+  handler: async (runtime, _message, _state, options) => {
+    const params = options?.parameters ?? {};
+    const thresholdDays = coercePositiveNumber(params.thresholdDays) ?? FOLLOWUP_DEFAULT_THRESHOLD_DAYS;
+    const limit = coercePositiveNumber(params.limit);
+    const digest = await computeOverdueFollowups(
+      runtime,
+      Date.now(),
+      thresholdDays
+    );
+    const overdue = limit ? digest.overdue.slice(0, Math.floor(limit)) : digest.overdue;
+    if (overdue.length === 0) {
+      return {
+        success: true,
+        text: "No overdue follow-ups.",
+        data: { digest }
+      };
+    }
+    const lines = overdue.map(
+      (entry) => `${entry.displayName}: last contacted ${entry.lastContactedAt} (+${entry.daysOverdue}d over ${entry.thresholdDays}d threshold)`
+    );
+    return {
+      success: true,
+      text: lines.join("\n"),
+      data: { digest: { ...digest, overdue } }
+    };
+  },
+  parameters: [
+    {
+      name: "thresholdDays",
+      description: "Override the default overdue threshold in days for this query.",
+      required: false,
+      schema: { type: "number" }
+    },
+    {
+      name: "limit",
+      description: "Maximum number of overdue contacts to return.",
+      required: false,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      {
+        name: "{{name1}}",
+        content: { text: "Who should I follow up with?" }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Carol Patel: last contacted ... (+30d over 30d threshold)",
+          action: "LIST_OVERDUE_FOLLOWUPS"
+        }
+      }
+    ]
+  ]
+};
+export {
+  listOverdueFollowupsAction
+};
+//# sourceMappingURL=listOverdueFollowups.js.map

package/dist/followup/actions/listOverdueFollowups.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/followup/actions/listOverdueFollowups.ts"],"sourcesContent":["import type { Action, ActionExample, IAgentRuntime } from \"@elizaos/core\";\nimport {\n  computeOverdueFollowups,\n  FOLLOWUP_DEFAULT_THRESHOLD_DAYS,\n} from \"../followup-tracker.js\";\n\ninterface ListOverdueFollowupsParams {\n  thresholdDays?: unknown;\n  limit?: unknown;\n}\n\nfunction coercePositiveNumber(value: unknown): number | null {\n  if (typeof value === \"number\" && Number.isFinite(value) && value > 0) {\n    return value;\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed) && parsed > 0) return parsed;\n  }\n  return null;\n}\n\nexport const listOverdueFollowupsAction: Action = {\n  name: \"LIST_OVERDUE_FOLLOWUPS\",\n  similes: [\n    \"OVERDUE_FOLLOWUPS\",\n    \"WHO_TO_FOLLOW_UP\",\n    \"WHO_HAVEN_T_I_TALKED_TO\",\n    \"LIST_FOLLOWUPS\",\n    \"FOLLOWUP_LIST\",\n    // PRD action-catalog alias.\n    // See packages/docs/action-prd-map.md.\n    \"FOLLOWUP_LIST_OVERDUE\",\n  ],\n  description:\n    \"List contacts whose last-contacted-at timestamp exceeds their follow-up threshold. \" +\n    \"Use this for overdue or pending follow-up list queries, not for scheduling a new reminder. \" +\n    \"Returns an empty list when the RelationshipsService is not available.\",\n  contexts: [\"contacts\", \"tasks\", \"calendar\", \"messaging\"],\n  roleGate: { minRole: \"OWNER\" },\n  validate: async () => true,\n  handler: async (runtime: IAgentRuntime, _message, _state, options) => {\n    const params = (options?.parameters ?? {}) as ListOverdueFollowupsParams;\n    const thresholdDays =\n      coercePositiveNumber(params.thresholdDays) ??\n      FOLLOWUP_DEFAULT_THRESHOLD_DAYS;\n    const limit = coercePositiveNumber(params.limit);\n    const digest = await computeOverdueFollowups(\n      runtime,\n      Date.now(),\n      thresholdDays,\n    );\n    const overdue = limit\n      ? digest.overdue.slice(0, Math.floor(limit))\n      : digest.overdue;\n    if (overdue.length === 0) {\n      return {\n        success: true,\n        text: \"No overdue follow-ups.\",\n        data: { digest },\n      };\n    }\n    const lines = overdue.map(\n      (entry) =>\n        `${entry.displayName}: last contacted ${entry.lastContactedAt} (+${entry.daysOverdue}d over ${entry.thresholdDays}d threshold)`,\n    );\n    return {\n      success: true,\n      text: lines.join(\"\\n\"),\n      data: { digest: { ...digest, overdue } },\n    };\n  },\n  parameters: [\n    {\n      name: \"thresholdDays\",\n      description:\n        \"Override the default overdue threshold in days for this query.\",\n      required: false,\n      schema: { type: \"number\" as const },\n    },\n    {\n      name: \"limit\",\n      description: \"Maximum number of overdue contacts to return.\",\n      required: false,\n      schema: { type: \"number\" as const },\n    },\n  ],\n  examples: [\n    [\n      {\n        name: \"{{name1}}\",\n        content: { text: \"Who should I follow up with?\" },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Carol Patel: last contacted ... (+30d over 30d threshold)\",\n          action: \"LIST_OVERDUE_FOLLOWUPS\",\n        },\n      },\n    ],\n  ] as ActionExample[][],\n};\n"],"mappings":"AACA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAOP,SAAS,qBAAqB,OAA+B;AAC3D,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,QAAQ,GAAG;AACpE,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,GAAG;AACxD,UAAM,SAAS,OAAO,KAAK;AAC3B,QAAI,OAAO,SAAS,MAAM,KAAK,SAAS,EAAG,QAAO;AAAA,EACpD;AACA,SAAO;AACT;AAEO,MAAM,6BAAqC;AAAA,EAChD,MAAM;AAAA,EACN,SAAS;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA,IAGA;AAAA,EACF;AAAA,EACA,aACE;AAAA,EAGF,UAAU,CAAC,YAAY,SAAS,YAAY,WAAW;AAAA,EACvD,UAAU,EAAE,SAAS,QAAQ;AAAA,EAC7B,UAAU,YAAY;AAAA,EACtB,SAAS,OAAO,SAAwB,UAAU,QAAQ,YAAY;AACpE,UAAM,SAAU,SAAS,cAAc,CAAC;AACxC,UAAM,gBACJ,qBAAqB,OAAO,aAAa,KACzC;AACF,UAAM,QAAQ,qBAAqB,OAAO,KAAK;AAC/C,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA,KAAK,IAAI;AAAA,MACT;AAAA,IACF;AACA,UAAM,UAAU,QACZ,OAAO,QAAQ,MAAM,GAAG,KAAK,MAAM,KAAK,CAAC,IACzC,OAAO;AACX,QAAI,QAAQ,WAAW,GAAG;AACxB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM,EAAE,OAAO;AAAA,MACjB;AAAA,IACF;AACA,UAAM,QAAQ,QAAQ;AAAA,MACpB,CAAC,UACC,GAAG,MAAM,WAAW,oBAAoB,MAAM,eAAe,MAAM,MAAM,WAAW,UAAU,MAAM,aAAa;AAAA,IACrH;AACA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,MAAM,MAAM,KAAK,IAAI;AAAA,MACrB,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,QAAQ,EAAE;AAAA,IACzC;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV;AAAA,MACE,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,MACV,QAAQ,EAAE,MAAM,SAAkB;AAAA,IACpC;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,QAAQ,EAAE,MAAM,SAAkB;AAAA,IACpC;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR;AAAA,MACE;AAAA,QACE,MAAM;AAAA,QACN,SAAS,EAAE,MAAM,+BAA+B;AAAA,MAClD;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,SAAS;AAAA,UACP,MAAM;AAAA,UACN,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"markFollowupDone.d.ts","sourceRoot":"","sources":["../../../src/followup/actions/markFollowupDone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAKP,MAAM,eAAe,CAAC;AAiDvB,eAAO,MAAM,sBAAsB,EAAE,MAoKpC,CAAC"}

package/dist/followup/actions/markFollowupDone.js

@@ -0,0 +1,171 @@
+import { asUUID, logger } from "@elizaos/core";
+import {
+  getRelationshipsServiceLike
+} from "../followup-tracker.js";
+async function resolveDisplayName(runtime, contact) {
+  const explicit = contact.customFields.displayName;
+  if (typeof explicit === "string" && explicit.trim().length > 0) {
+    return explicit.trim();
+  }
+  const entity = await runtime.getEntityById(contact.entityId);
+  return entity?.names?.[0] ?? String(contact.entityId);
+}
+async function findByName(runtime, service, rawName) {
+  const needle = rawName.trim().toLowerCase();
+  if (needle.length === 0) return [];
+  const contacts = await service.searchContacts({});
+  const matches = [];
+  for (const contact of contacts) {
+    const displayName = await resolveDisplayName(runtime, contact);
+    if (displayName.toLowerCase().includes(needle)) {
+      matches.push({ contact, displayName });
+    }
+  }
+  return matches;
+}
+const markFollowupDoneAction = {
+  name: "MARK_FOLLOWUP_DONE",
+  similes: [
+    "FOLLOWED_UP",
+    "FOLLOWUP_DONE",
+    "CONTACTED",
+    "MARK_CONTACTED",
+    "RECORD_INTERACTION"
+  ],
+  description: "Mark a contact as already followed-up-with (updates lastContactedAt to now). Use this only when the interaction already happened, not for upcoming reminders. Requires either an explicit contactId (UUID) or an unambiguous contactName. Ambiguous names return a clarifying response without modifying any contact.",
+  contexts: ["contacts", "tasks", "calendar", "messaging"],
+  roleGate: { minRole: "OWNER" },
+  validate: async () => true,
+  handler: async (runtime, _message, _state, options) => {
+    const params = options?.parameters ?? {};
+    const contactId = typeof params.contactId === "string" && params.contactId.length > 0 ? params.contactId : null;
+    const contactName = typeof params.contactName === "string" ? params.contactName : "";
+    const note = typeof params.note === "string" ? params.note : void 0;
+    const service = getRelationshipsServiceLike(runtime);
+    if (!service) {
+      return {
+        success: false,
+        text: "Cannot mark follow-up: RelationshipsService is not available."
+      };
+    }
+    let resolvedContact = null;
+    let resolvedDisplayName = "";
+    if (contactId) {
+      let typedId;
+      try {
+        typedId = asUUID(contactId);
+      } catch {
+        return {
+          success: false,
+          text: `Invalid contactId: ${contactId}. Must be a UUID.`
+        };
+      }
+      resolvedContact = await service.getContact(typedId);
+      if (!resolvedContact) {
+        return {
+          success: false,
+          text: `No contact found with id ${contactId}.`
+        };
+      }
+      resolvedDisplayName = await resolveDisplayName(runtime, resolvedContact);
+    } else if (contactName.trim().length > 0) {
+      const matches = await findByName(runtime, service, contactName);
+      if (matches.length === 0) {
+        return {
+          success: false,
+          text: `No contact found matching "${contactName}".`
+        };
+      }
+      if (matches.length > 1) {
+        const candidateNames = matches.map((m) => `${m.displayName} (${m.contact.entityId})`).join(", ");
+        return {
+          success: false,
+          text: `Ambiguous contact name "${contactName}" \u2014 matches ${matches.length} contacts: ${candidateNames}. Please specify contactId.`,
+          data: {
+            ambiguous: true,
+            candidates: matches.map((m) => ({
+              entityId: String(m.contact.entityId),
+              displayName: m.displayName
+            }))
+          }
+        };
+      }
+      const match = matches[0];
+      if (!match) {
+        return {
+          success: false,
+          text: `No contact found matching "${contactName}".`
+        };
+      }
+      resolvedContact = match.contact;
+      resolvedDisplayName = match.displayName;
+    } else {
+      return {
+        success: false,
+        text: "MARK_FOLLOWUP_DONE requires either contactId or contactName."
+      };
+    }
+    const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+    const nextFields = {
+      ...resolvedContact.customFields,
+      lastContactedAt: nowIso
+    };
+    if (note) {
+      nextFields.lastFollowupNote = note;
+    }
+    await service.updateContact(resolvedContact.entityId, {
+      customFields: nextFields
+    });
+    logger.info(
+      `[MARK_FOLLOWUP_DONE] Marked ${resolvedDisplayName} (${resolvedContact.entityId}) as contacted at ${nowIso}`
+    );
+    return {
+      success: true,
+      text: `Marked ${resolvedDisplayName} as followed up at ${nowIso}.`,
+      data: {
+        entityId: String(resolvedContact.entityId),
+        displayName: resolvedDisplayName,
+        lastContactedAt: nowIso
+      }
+    };
+  },
+  parameters: [
+    {
+      name: "contactId",
+      description: "UUID of the contact. Preferred when known \u2014 eliminates name ambiguity.",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "contactName",
+      description: "Human-readable contact name. Must be unambiguous across stored contacts.",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "note",
+      description: "Optional note about the interaction.",
+      required: false,
+      schema: { type: "string" }
+    }
+  ],
+  examples: [
+    [
+      {
+        name: "{{name1}}",
+        content: { text: "I just talked to Alice, mark it done" }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Marked Alice Chen as followed up at ...",
+          action: "MARK_FOLLOWUP_DONE"
+        }
+      }
+    ]
+  ]
+};
+export {
+  markFollowupDoneAction
+};
+//# sourceMappingURL=markFollowupDone.js.map

package/dist/followup/actions/markFollowupDone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/followup/actions/markFollowupDone.ts"],"sourcesContent":["import type {\n  Action,\n  ActionExample,\n  HandlerOptions,\n  IAgentRuntime,\n  UUID,\n} from \"@elizaos/core\";\nimport { asUUID, logger } from \"@elizaos/core\";\nimport {\n  type ContactInfo,\n  getRelationshipsServiceLike,\n  type RelationshipsServiceLike,\n} from \"../followup-tracker.js\";\n\ninterface MarkFollowupDoneParams {\n  contactId?: unknown;\n  contactName?: unknown;\n  note?: unknown;\n}\n\ninterface ContactMatch {\n  contact: ContactInfo;\n  displayName: string;\n}\n\nasync function resolveDisplayName(\n  runtime: IAgentRuntime,\n  contact: ContactInfo,\n): Promise<string> {\n  const explicit = contact.customFields.displayName;\n  if (typeof explicit === \"string\" && explicit.trim().length > 0) {\n    return explicit.trim();\n  }\n  const entity = await runtime.getEntityById(contact.entityId);\n  return entity?.names?.[0] ?? String(contact.entityId);\n}\n\nasync function findByName(\n  runtime: IAgentRuntime,\n  service: RelationshipsServiceLike,\n  rawName: string,\n): Promise<ContactMatch[]> {\n  const needle = rawName.trim().toLowerCase();\n  if (needle.length === 0) return [];\n  const contacts = await service.searchContacts({});\n  const matches: ContactMatch[] = [];\n  for (const contact of contacts) {\n    const displayName = await resolveDisplayName(runtime, contact);\n    if (displayName.toLowerCase().includes(needle)) {\n      matches.push({ contact, displayName });\n    }\n  }\n  return matches;\n}\n\nexport const markFollowupDoneAction: Action = {\n  name: \"MARK_FOLLOWUP_DONE\",\n  similes: [\n    \"FOLLOWED_UP\",\n    \"FOLLOWUP_DONE\",\n    \"CONTACTED\",\n    \"MARK_CONTACTED\",\n    \"RECORD_INTERACTION\",\n  ],\n  description:\n    \"Mark a contact as already followed-up-with (updates lastContactedAt to now). \" +\n    \"Use this only when the interaction already happened, not for upcoming reminders. \" +\n    \"Requires either an explicit contactId (UUID) or an unambiguous contactName. \" +\n    \"Ambiguous names return a clarifying response without modifying any contact.\",\n  contexts: [\"contacts\", \"tasks\", \"calendar\", \"messaging\"],\n  roleGate: { minRole: \"OWNER\" },\n  validate: async () => true,\n  handler: async (\n    runtime: IAgentRuntime,\n    _message,\n    _state,\n    options?: HandlerOptions,\n  ) => {\n    const params = (options?.parameters ?? {}) as MarkFollowupDoneParams;\n    const contactId =\n      typeof params.contactId === \"string\" && params.contactId.length > 0\n        ? params.contactId\n        : null;\n    const contactName =\n      typeof params.contactName === \"string\" ? params.contactName : \"\";\n    const note = typeof params.note === \"string\" ? params.note : undefined;\n\n    const service = getRelationshipsServiceLike(runtime);\n    if (!service) {\n      return {\n        success: false,\n        text: \"Cannot mark follow-up: RelationshipsService is not available.\",\n      };\n    }\n\n    let resolvedContact: ContactInfo | null = null;\n    let resolvedDisplayName = \"\";\n\n    if (contactId) {\n      let typedId: UUID;\n      try {\n        typedId = asUUID(contactId);\n      } catch {\n        return {\n          success: false,\n          text: `Invalid contactId: ${contactId}. Must be a UUID.`,\n        };\n      }\n      resolvedContact = await service.getContact(typedId);\n      if (!resolvedContact) {\n        return {\n          success: false,\n          text: `No contact found with id ${contactId}.`,\n        };\n      }\n      resolvedDisplayName = await resolveDisplayName(runtime, resolvedContact);\n    } else if (contactName.trim().length > 0) {\n      const matches = await findByName(runtime, service, contactName);\n      if (matches.length === 0) {\n        return {\n          success: false,\n          text: `No contact found matching \"${contactName}\".`,\n        };\n      }\n      if (matches.length > 1) {\n        const candidateNames = matches\n          .map((m) => `${m.displayName} (${m.contact.entityId})`)\n          .join(\", \");\n        return {\n          success: false,\n          text: `Ambiguous contact name \"${contactName}\" — matches ${matches.length} contacts: ${candidateNames}. Please specify contactId.`,\n          data: {\n            ambiguous: true,\n            candidates: matches.map((m) => ({\n              entityId: String(m.contact.entityId),\n              displayName: m.displayName,\n            })),\n          },\n        };\n      }\n      const match = matches[0];\n      if (!match) {\n        return {\n          success: false,\n          text: `No contact found matching \"${contactName}\".`,\n        };\n      }\n      resolvedContact = match.contact;\n      resolvedDisplayName = match.displayName;\n    } else {\n      return {\n        success: false,\n        text: \"MARK_FOLLOWUP_DONE requires either contactId or contactName.\",\n      };\n    }\n\n    const nowIso = new Date().toISOString();\n    const nextFields: Record<string, string> = {\n      ...(resolvedContact.customFields as Record<string, string>),\n      lastContactedAt: nowIso,\n    };\n    if (note) {\n      nextFields.lastFollowupNote = note;\n    }\n    await service.updateContact(resolvedContact.entityId, {\n      customFields: nextFields,\n    });\n\n    logger.info(\n      `[MARK_FOLLOWUP_DONE] Marked ${resolvedDisplayName} (${resolvedContact.entityId}) as contacted at ${nowIso}`,\n    );\n\n    return {\n      success: true,\n      text: `Marked ${resolvedDisplayName} as followed up at ${nowIso}.`,\n      data: {\n        entityId: String(resolvedContact.entityId),\n        displayName: resolvedDisplayName,\n        lastContactedAt: nowIso,\n      },\n    };\n  },\n  parameters: [\n    {\n      name: \"contactId\",\n      description:\n        \"UUID of the contact. Preferred when known — eliminates name ambiguity.\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"contactName\",\n      description:\n        \"Human-readable contact name. Must be unambiguous across stored contacts.\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"note\",\n      description: \"Optional note about the interaction.\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n  ],\n  examples: [\n    [\n      {\n        name: \"{{name1}}\",\n        content: { text: \"I just talked to Alice, mark it done\" },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Marked Alice Chen as followed up at ...\",\n          action: \"MARK_FOLLOWUP_DONE\",\n        },\n      },\n    ],\n  ] as ActionExample[][],\n};\n"],"mappings":"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","names":[]}

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

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

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

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

package/dist/followup/actions/setFollowupThreshold.js

@@ -0,0 +1,171 @@
+import { asUUID, logger } from "@elizaos/core";
+import {
+  getRelationshipsServiceLike
+} from "../followup-tracker.js";
+async function resolveDisplayName(runtime, contact) {
+  const explicit = contact.customFields.displayName;
+  if (typeof explicit === "string" && explicit.trim().length > 0) {
+    return explicit.trim();
+  }
+  const entity = await runtime.getEntityById(contact.entityId);
+  return entity?.names?.[0] ?? String(contact.entityId);
+}
+const setFollowupThresholdAction = {
+  name: "SET_FOLLOWUP_THRESHOLD",
+  similes: [
+    "FOLLOWUP_RULE",
+    "CHANGE_FOLLOWUP_INTERVAL",
+    "SET_CONTACT_FREQUENCY_DAYS",
+    // PRD action-catalog alias.
+    // See packages/docs/action-prd-map.md.
+    "FOLLOWUP_CREATE_RULE"
+  ],
+  description: "Set a recurring follow-up cadence threshold (in days) for a specific contact. Use this for durable rules like 'every 14 days', not one-off reminders like 'next week'. Requires a positive integer threshold and either contactId or an unambiguous contactName.",
+  contexts: ["contacts", "tasks", "calendar", "settings"],
+  roleGate: { minRole: "OWNER" },
+  validate: async () => true,
+  handler: async (runtime, _message, _state, options) => {
+    const params = options?.parameters ?? {};
+    const contactId = typeof params.contactId === "string" && params.contactId.length > 0 ? params.contactId : null;
+    const contactName = typeof params.contactName === "string" ? params.contactName : "";
+    const rawThreshold = params.thresholdDays;
+    const thresholdDays = typeof rawThreshold === "number" ? rawThreshold : typeof rawThreshold === "string" ? Number(rawThreshold) : Number.NaN;
+    if (!Number.isFinite(thresholdDays) || thresholdDays <= 0) {
+      return {
+        success: false,
+        text: "SET_FOLLOWUP_THRESHOLD requires a positive integer thresholdDays."
+      };
+    }
+    const thresholdInt = Math.floor(thresholdDays);
+    const service = getRelationshipsServiceLike(runtime);
+    if (!service) {
+      return {
+        success: false,
+        text: "Cannot set follow-up threshold: RelationshipsService is not available."
+      };
+    }
+    let resolvedContact = null;
+    let resolvedDisplayName = "";
+    if (contactId) {
+      let typedId;
+      try {
+        typedId = asUUID(contactId);
+      } catch {
+        return {
+          success: false,
+          text: `Invalid contactId: ${contactId}. Must be a UUID.`
+        };
+      }
+      resolvedContact = await service.getContact(typedId);
+      if (!resolvedContact) {
+        return {
+          success: false,
+          text: `No contact found with id ${contactId}.`
+        };
+      }
+      resolvedDisplayName = await resolveDisplayName(runtime, resolvedContact);
+    } else if (contactName.trim().length > 0) {
+      const needle = contactName.trim().toLowerCase();
+      const contacts = await service.searchContacts({});
+      const matches = [];
+      for (const contact of contacts) {
+        const displayName = await resolveDisplayName(runtime, contact);
+        if (displayName.toLowerCase().includes(needle)) {
+          matches.push({ contact, displayName });
+        }
+      }
+      if (matches.length === 0) {
+        return {
+          success: false,
+          text: `No contact found matching "${contactName}".`
+        };
+      }
+      if (matches.length > 1) {
+        const candidateNames = matches.map((m) => `${m.displayName} (${m.contact.entityId})`).join(", ");
+        return {
+          success: false,
+          text: `Ambiguous contact name "${contactName}" \u2014 matches ${matches.length} contacts: ${candidateNames}. Please specify contactId.`,
+          data: {
+            ambiguous: true,
+            candidates: matches.map((m) => ({
+              entityId: String(m.contact.entityId),
+              displayName: m.displayName
+            }))
+          }
+        };
+      }
+      const match = matches[0];
+      if (!match) {
+        return {
+          success: false,
+          text: `No contact found matching "${contactName}".`
+        };
+      }
+      resolvedContact = match.contact;
+      resolvedDisplayName = match.displayName;
+    } else {
+      return {
+        success: false,
+        text: "SET_FOLLOWUP_THRESHOLD requires either contactId or contactName."
+      };
+    }
+    const nextFields = {
+      ...resolvedContact.customFields,
+      followupThresholdDays: thresholdInt
+    };
+    await service.updateContact(resolvedContact.entityId, {
+      customFields: nextFields
+    });
+    logger.info(
+      `[SET_FOLLOWUP_THRESHOLD] Set ${resolvedDisplayName} (${resolvedContact.entityId}) threshold to ${thresholdInt} days`
+    );
+    return {
+      success: true,
+      text: `Set follow-up threshold for ${resolvedDisplayName} to ${thresholdInt} days.`,
+      data: {
+        entityId: String(resolvedContact.entityId),
+        displayName: resolvedDisplayName,
+        thresholdDays: thresholdInt
+      }
+    };
+  },
+  parameters: [
+    {
+      name: "contactId",
+      description: "UUID of the contact. Preferred when known.",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "contactName",
+      description: "Human-readable contact name. Must be unambiguous across stored contacts.",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "thresholdDays",
+      description: "Number of days after last contact before this contact is considered overdue.",
+      required: true,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      {
+        name: "{{name1}}",
+        content: { text: "Remind me to follow up with Dana every 14 days" }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Set follow-up threshold for Dana Park to 14 days.",
+          action: "SET_FOLLOWUP_THRESHOLD"
+        }
+      }
+    ]
+  ]
+};
+export {
+  setFollowupThresholdAction
+};
+//# sourceMappingURL=setFollowupThreshold.js.map

package/dist/followup/actions/setFollowupThreshold.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/followup/actions/setFollowupThreshold.ts"],"sourcesContent":["import type {\n  Action,\n  ActionExample,\n  HandlerOptions,\n  IAgentRuntime,\n  UUID,\n} from \"@elizaos/core\";\nimport { asUUID, logger } from \"@elizaos/core\";\nimport {\n  type ContactInfo,\n  getRelationshipsServiceLike,\n} from \"../followup-tracker.js\";\n\ninterface SetFollowupThresholdParams {\n  contactId?: unknown;\n  contactName?: unknown;\n  thresholdDays?: unknown;\n}\n\nasync function resolveDisplayName(\n  runtime: IAgentRuntime,\n  contact: ContactInfo,\n): Promise<string> {\n  const explicit = contact.customFields.displayName;\n  if (typeof explicit === \"string\" && explicit.trim().length > 0) {\n    return explicit.trim();\n  }\n  const entity = await runtime.getEntityById(contact.entityId);\n  return entity?.names?.[0] ?? String(contact.entityId);\n}\n\nexport const setFollowupThresholdAction: Action = {\n  name: \"SET_FOLLOWUP_THRESHOLD\",\n  similes: [\n    \"FOLLOWUP_RULE\",\n    \"CHANGE_FOLLOWUP_INTERVAL\",\n    \"SET_CONTACT_FREQUENCY_DAYS\",\n    // PRD action-catalog alias.\n    // See packages/docs/action-prd-map.md.\n    \"FOLLOWUP_CREATE_RULE\",\n  ],\n  description:\n    \"Set a recurring follow-up cadence threshold (in days) for a specific contact. \" +\n    \"Use this for durable rules like 'every 14 days', not one-off reminders like 'next week'. \" +\n    \"Requires a positive integer threshold and either contactId or an unambiguous contactName.\",\n  contexts: [\"contacts\", \"tasks\", \"calendar\", \"settings\"],\n  roleGate: { minRole: \"OWNER\" },\n  validate: async () => true,\n  handler: async (\n    runtime: IAgentRuntime,\n    _message,\n    _state,\n    options?: HandlerOptions,\n  ) => {\n    const params = (options?.parameters ?? {}) as SetFollowupThresholdParams;\n    const contactId =\n      typeof params.contactId === \"string\" && params.contactId.length > 0\n        ? params.contactId\n        : null;\n    const contactName =\n      typeof params.contactName === \"string\" ? params.contactName : \"\";\n    const rawThreshold = params.thresholdDays;\n    const thresholdDays =\n      typeof rawThreshold === \"number\"\n        ? rawThreshold\n        : typeof rawThreshold === \"string\"\n          ? Number(rawThreshold)\n          : Number.NaN;\n\n    if (!Number.isFinite(thresholdDays) || thresholdDays <= 0) {\n      return {\n        success: false,\n        text: \"SET_FOLLOWUP_THRESHOLD requires a positive integer thresholdDays.\",\n      };\n    }\n    const thresholdInt = Math.floor(thresholdDays);\n\n    const service = getRelationshipsServiceLike(runtime);\n    if (!service) {\n      return {\n        success: false,\n        text: \"Cannot set follow-up threshold: RelationshipsService is not available.\",\n      };\n    }\n\n    let resolvedContact: ContactInfo | null = null;\n    let resolvedDisplayName = \"\";\n\n    if (contactId) {\n      let typedId: UUID;\n      try {\n        typedId = asUUID(contactId);\n      } catch {\n        return {\n          success: false,\n          text: `Invalid contactId: ${contactId}. Must be a UUID.`,\n        };\n      }\n      resolvedContact = await service.getContact(typedId);\n      if (!resolvedContact) {\n        return {\n          success: false,\n          text: `No contact found with id ${contactId}.`,\n        };\n      }\n      resolvedDisplayName = await resolveDisplayName(runtime, resolvedContact);\n    } else if (contactName.trim().length > 0) {\n      const needle = contactName.trim().toLowerCase();\n      const contacts = await service.searchContacts({});\n      const matches: Array<{ contact: ContactInfo; displayName: string }> = [];\n      for (const contact of contacts) {\n        const displayName = await resolveDisplayName(runtime, contact);\n        if (displayName.toLowerCase().includes(needle)) {\n          matches.push({ contact, displayName });\n        }\n      }\n      if (matches.length === 0) {\n        return {\n          success: false,\n          text: `No contact found matching \"${contactName}\".`,\n        };\n      }\n      if (matches.length > 1) {\n        const candidateNames = matches\n          .map((m) => `${m.displayName} (${m.contact.entityId})`)\n          .join(\", \");\n        return {\n          success: false,\n          text: `Ambiguous contact name \"${contactName}\" — matches ${matches.length} contacts: ${candidateNames}. Please specify contactId.`,\n          data: {\n            ambiguous: true,\n            candidates: matches.map((m) => ({\n              entityId: String(m.contact.entityId),\n              displayName: m.displayName,\n            })),\n          },\n        };\n      }\n      const match = matches[0];\n      if (!match) {\n        return {\n          success: false,\n          text: `No contact found matching \"${contactName}\".`,\n        };\n      }\n      resolvedContact = match.contact;\n      resolvedDisplayName = match.displayName;\n    } else {\n      return {\n        success: false,\n        text: \"SET_FOLLOWUP_THRESHOLD requires either contactId or contactName.\",\n      };\n    }\n\n    const nextFields: Record<string, string | number> = {\n      ...(resolvedContact.customFields as Record<string, string | number>),\n      followupThresholdDays: thresholdInt,\n    };\n    await service.updateContact(resolvedContact.entityId, {\n      customFields: nextFields,\n    });\n\n    logger.info(\n      `[SET_FOLLOWUP_THRESHOLD] Set ${resolvedDisplayName} (${resolvedContact.entityId}) threshold to ${thresholdInt} days`,\n    );\n\n    return {\n      success: true,\n      text: `Set follow-up threshold for ${resolvedDisplayName} to ${thresholdInt} days.`,\n      data: {\n        entityId: String(resolvedContact.entityId),\n        displayName: resolvedDisplayName,\n        thresholdDays: thresholdInt,\n      },\n    };\n  },\n  parameters: [\n    {\n      name: \"contactId\",\n      description: \"UUID of the contact. Preferred when known.\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"contactName\",\n      description:\n        \"Human-readable contact name. Must be unambiguous across stored contacts.\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"thresholdDays\",\n      description:\n        \"Number of days after last contact before this contact is considered overdue.\",\n      required: true,\n      schema: { type: \"number\" as const },\n    },\n  ],\n  examples: [\n    [\n      {\n        name: \"{{name1}}\",\n        content: { text: \"Remind me to follow up with Dana every 14 days\" },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Set follow-up threshold for Dana Park to 14 days.\",\n          action: \"SET_FOLLOWUP_THRESHOLD\",\n        },\n      },\n    ],\n  ] as ActionExample[][],\n};\n"],"mappings":"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","names":[]}

package/dist/followup/followup-tracker.d.ts

@@ -0,0 +1,83 @@
+import type { IAgentRuntime, JsonValue, UUID } from "@elizaos/core";
+/**
+ * Periodically scans known contacts managed by the RelationshipsService and
+ * identifies contacts whose `lastContactedAt` has exceeded the configured
+ * threshold. Overdue entries are written as a single consolidated memory per
+ * tick (`followup_overdue_digest`) so the morning check-in + the
+ * `LIST_OVERDUE_FOLLOWUPS` action can pull from a canonical location.
+ *
+ * If `RelationshipsService` is not registered on the runtime, the tracker logs
+ * once at info level and returns an empty digest.
+ */
+/**
+ * Structural view of the RelationshipsService shape we depend on. Kept local
+ * so this module doesn't force a compile-time dependency on the core service
+ * type, and so it degrades gracefully when the service isn't registered.
+ */
+export interface ContactInfo {
+    entityId: UUID;
+    categories: string[];
+    tags: string[];
+    customFields: Record<string, JsonValue>;
+}
+export interface RelationshipsServiceLike {
+    searchContacts(criteria: Record<string, unknown>): Promise<ContactInfo[]>;
+    getContact(entityId: UUID): Promise<ContactInfo | null>;
+    updateContact(entityId: UUID, updates: {
+        customFields?: Record<string, JsonValue>;
+    }): Promise<ContactInfo | null>;
+}
+export declare const FOLLOWUP_TRACKER_TASK_NAME: "FOLLOWUP_TRACKER_RECONCILE";
+export declare const FOLLOWUP_TRACKER_TASK_TAGS: readonly ["queue", "repeat", "relationships", "followup-tracker"];
+export declare const FOLLOWUP_TRACKER_INTERVAL_MS: number;
+export declare const FOLLOWUP_DEFAULT_THRESHOLD_DAYS = 30;
+export declare const FOLLOWUP_MEMORY_TABLE: "reminders";
+export interface OverdueFollowup {
+    entityId: UUID;
+    displayName: string;
+    lastContactedAt: string;
+    daysOverdue: number;
+    thresholdDays: number;
+}
+export interface OverdueDigest {
+    generatedAt: string;
+    thresholdDefaultDays: number;
+    overdue: OverdueFollowup[];
+}
+export declare function getRelationshipsServiceLike(runtime: IAgentRuntime): RelationshipsServiceLike | null;
+/**
+ * One tick of the tracker. Pure async fn — safe to call from tests.
+ */
+export declare function computeOverdueFollowups(runtime: IAgentRuntime, now?: number, defaultThresholdDays?: number): Promise<OverdueDigest>;
+/**
+ * Persist the digest as a memory so morning check-in + actions can retrieve
+ * it. One memory per tick; callers querying the most recent
+ * `followup_overdue_digest` memory in the followup room get the latest view.
+ */
+export declare function writeOverdueDigestMemory(runtime: IAgentRuntime, digest: OverdueDigest): Promise<UUID>;
+/**
+ * One reconciler tick. Compute + persist. Returns the digest for testability.
+ */
+export declare function reconcileFollowupsOnce(runtime: IAgentRuntime, now?: number, defaultThresholdDays?: number): Promise<OverdueDigest>;
+export declare function executeFollowupTrackerTick(runtime: IAgentRuntime, options?: Record<string, unknown>): Promise<{
+    nextInterval: number;
+    digest: OverdueDigest;
+}>;
+export declare function ensureFollowupTrackerTask(runtime: IAgentRuntime): Promise<UUID>;
+/**
+ * Register the tracker as a periodic task worker. Mirrors the
+ * BlockRuleReconciler pattern so it integrates with the agent scheduler.
+ */
+export declare function registerFollowupTrackerWorker(runtime: IAgentRuntime): void;
+/**
+ * Resolve the room used to store follow-up tracker memories. Exposed for
+ * callers (e.g. LIST_OVERDUE_FOLLOWUPS action or morning check-in) that need
+ * to query the digest.
+ */
+export declare function getFollowupTrackerRoomId(runtime: IAgentRuntime): UUID;
+/**
+ * Test-only: reset the one-time degraded-mode log so unit tests can observe
+ * the log path repeatedly.
+ */
+export declare function __resetFollowupTrackerForTests(): void;
+//# sourceMappingURL=followup-tracker.d.ts.map

package/dist/followup/followup-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup-tracker.d.ts","sourceRoot":"","sources":["../../src/followup/followup-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EAIT,IAAI,EACL,MAAM,eAAe,CAAC;AAevB;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,UAAU,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,CACX,QAAQ,EAAE,IAAI,EACd,OAAO,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAE,GACpD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAChC;AAcD,eAAO,MAAM,0BAA0B,EAAG,4BAAqC,CAAC;AAChF,eAAO,MAAM,0BAA0B,mEAK7B,CAAC;AACX,eAAO,MAAM,4BAA4B,QAAiB,CAAC;AAC3D,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,qBAAqB,EAAG,WAAoB,CAAC;AAuC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,aAAa,GACrB,wBAAwB,GAAG,IAAI,CAIjC;AA+CD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE,MAAmB,EACxB,oBAAoB,GAAE,MAAwC,GAC7D,OAAO,CAAC,aAAa,CAAC,CA6CxB;AAUD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE,MAAmB,EACxB,oBAAoB,GAAE,MAAwC,GAC7D,OAAO,CAAC,aAAa,CAAC,CAwCxB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAgB1D;AAMD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAwB1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAErE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}