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

package/dist/actions/lib/calendly-handler.js

@@ -0,0 +1,506 @@
+import { extractActionParamsViaLlm } from "@elizaos/agent";
+import {
+  logger
+} from "@elizaos/core";
+import {
+  CalendlyError,
+  createCalendlySingleUseLink,
+  getCalendlyAvailability,
+  listCalendlyEventTypes,
+  listCalendlyScheduledEvents,
+  readCalendlyCredentialsFromEnv
+} from "@elizaos/plugin-calendly";
+import {
+  createCalendlySingleUseLinkWithRuntimeService,
+  getCalendlyAvailabilityWithRuntimeService,
+  listCalendlyEventTypesWithRuntimeService,
+  listCalendlyScheduledEventsWithRuntimeService
+} from "../../lifeops/runtime-service-delegates.js";
+const ACTION_NAME = "CALENDLY";
+function coerceString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function coerceRecord(value) {
+  return value && typeof value === "object" ? value : null;
+}
+function normalizeCalendlyEventType(value) {
+  const record = coerceRecord(value);
+  if (!record) return null;
+  const uri = coerceString(record.uri);
+  const name = coerceString(record.name);
+  const schedulingUrl = coerceString(record.schedulingUrl) ?? coerceString(record.scheduling_url);
+  const durationRaw = record.durationMinutes ?? record.duration;
+  const durationMinutes = typeof durationRaw === "number" ? durationRaw : Number.parseInt(String(durationRaw ?? ""), 10);
+  if (!uri || !name || !schedulingUrl || !Number.isFinite(durationMinutes)) {
+    return null;
+  }
+  return {
+    uri,
+    name,
+    slug: coerceString(record.slug) ?? "",
+    schedulingUrl,
+    durationMinutes,
+    active: record.active !== false
+  };
+}
+function normalizeCalendlyEventTypes(values) {
+  return values.map(normalizeCalendlyEventType).filter((value) => value !== null);
+}
+function normalizeCalendlyScheduledEvents(values) {
+  return values.map((value) => {
+    const record = coerceRecord(value);
+    if (!record) return null;
+    const uri = coerceString(record.uri);
+    const name = coerceString(record.name);
+    const startTime = coerceString(record.startTime) ?? coerceString(record.start_time);
+    const endTime = coerceString(record.endTime) ?? coerceString(record.end_time);
+    const status = record.status === "canceled" ? "canceled" : "active";
+    if (!uri || !name || !startTime || !endTime) return null;
+    const invitees = Array.isArray(record.invitees) ? record.invitees.map((invitee) => {
+      const inviteeRecord = coerceRecord(invitee);
+      if (!inviteeRecord) return null;
+      return {
+        ...coerceString(inviteeRecord.name) ? { name: coerceString(inviteeRecord.name) } : {},
+        ...coerceString(inviteeRecord.email) ? { email: coerceString(inviteeRecord.email) } : {},
+        status: coerceString(inviteeRecord.status) ?? "active"
+      };
+    }).filter(
+      (invitee) => invitee !== null
+    ) : [];
+    return { uri, name, startTime, endTime, status, invitees };
+  }).filter((value) => value !== null);
+}
+function parseSubaction(value) {
+  const s = coerceString(value)?.toLowerCase();
+  if (!s) return null;
+  if (s === "list_event_types" || s === "availability" || s === "upcoming_events" || s === "single_use_link") {
+    return s;
+  }
+  return null;
+}
+function formatEventTypes(types) {
+  if (types.length === 0) return "No Calendly event types found.";
+  const active = types.filter((t) => t.active);
+  const lines = active.map(
+    (t) => `- ${t.name} (${t.durationMinutes}m) \u2014 ${t.schedulingUrl}
+  uri: ${t.uri}`
+  );
+  return `Calendly event types (${active.length} active):
+${lines.join("\n")}`;
+}
+function formatScheduledEvents(events) {
+  if (events.length === 0) return "No upcoming Calendly events.";
+  const lines = events.map((event) => {
+    const inviteeSummary = event.invitees.length > 0 ? event.invitees.map((inv) => inv.name ?? inv.email ?? "(unknown)").join(", ") : "(no invitees yet)";
+    return `- ${event.name} @ ${event.startTime} \u2192 ${event.endTime} [${event.status}] \u2014 ${inviteeSummary}`;
+  });
+  return `Calendly scheduled events (${events.length}):
+${lines.join("\n")}`;
+}
+function formatAvailability(days) {
+  if (days.length === 0) return "No available slots in that range.";
+  const lines = days.map((day) => {
+    const times = day.slots.map((s) => s.startTime).join(", ");
+    return `- ${day.date}: ${day.slots.length} slot(s) \u2014 ${times}`;
+  });
+  return `Calendly availability:
+${lines.join("\n")}`;
+}
+const CALENDLY_NEEDS_INPUT_ERRORS = /* @__PURE__ */ new Set([
+  "MISSING_EVENT_TYPE_URI",
+  "MISSING_DATE_RANGE",
+  "MISSING_CALENDLY_CREDENTIALS",
+  "CALENDLY_NOT_CONFIGURED",
+  "INVALID_SUBACTION",
+  "CALENDLY_API_ERROR"
+]);
+function failure(text, error, extra = {}) {
+  const needsInput = CALENDLY_NEEDS_INPUT_ERRORS.has(error);
+  return {
+    text,
+    success: false,
+    values: {
+      success: false,
+      error,
+      ...needsInput ? { requiresConfirmation: true } : {},
+      ...extra
+    },
+    data: {
+      actionName: ACTION_NAME,
+      error,
+      ...needsInput ? { requiresConfirmation: true } : {},
+      ...extra
+    }
+  };
+}
+function success(text, data) {
+  return {
+    text,
+    success: true,
+    values: { success: true },
+    data: { actionName: ACTION_NAME, ...data }
+  };
+}
+function calendlyRuntimeServiceAvailable(runtime) {
+  const service = runtime.getService("calendly");
+  if (!service || typeof service !== "object") return false;
+  return typeof service.isConnected === "function" ? service.isConnected("default") : true;
+}
+function calendlyNotConfiguredFailure() {
+  return failure(
+    "Calendly is not configured. Connect the Calendly service or set ELIZA_CALENDLY_TOKEN.",
+    "CALENDLY_NOT_CONFIGURED"
+  );
+}
+const calendlyAction = {
+  name: ACTION_NAME,
+  similes: [
+    "CALENDLY_LIST_EVENT_TYPES",
+    "CALENDLY_AVAILABILITY",
+    "CALENDLY_UPCOMING",
+    "CALENDLY_BOOKING_LINK",
+    "CALENDLY_ACTION",
+    "CALENDLY_EVENT_TYPES",
+    "CALENDLY_SCHEDULED_EVENTS"
+  ],
+  description: "Work with Calendly specifically (calendly.com / api.calendly.com). Subactions: list_event_types, availability (against a Calendly event-type URI), upcoming_events, single_use_link (generate a one-shot booking link). Use this \u2014 not CALENDAR \u2014 whenever the user mentions Calendly by name or passes a calendly.com / api.calendly.com URL.",
+  descriptionCompressed: "calendly list_event_types|availability|upcoming_events|single_use_link; calendly.com URLs",
+  tags: [
+    "domain:calendar",
+    "capability:read",
+    "capability:write",
+    "surface:remote-api"
+  ],
+  contexts: ["calendar", "contacts", "tasks"],
+  roleGate: { minRole: "OWNER" },
+  validate: async (runtime, _message) => {
+    return readCalendlyCredentialsFromEnv() !== null || calendlyRuntimeServiceAvailable(runtime);
+  },
+  parameters: [
+    {
+      name: "action",
+      description: "One of: list_event_types, availability, upcoming_events, single_use_link. When omitted, the handler runs an LLM extraction over the conversation to recover it.",
+      descriptionCompressed: "calendly op: list_event_types|availability|upcoming_events|single_use_link",
+      required: true,
+      schema: {
+        type: "string",
+        enum: [
+          "list_event_types",
+          "availability",
+          "upcoming_events",
+          "single_use_link"
+        ]
+      },
+      examples: ["list_event_types", "availability"]
+    },
+    {
+      name: "subaction",
+      description: "Legacy alias for action.",
+      descriptionCompressed: "legacy calendly op alias",
+      required: false,
+      schema: {
+        type: "string",
+        enum: [
+          "list_event_types",
+          "availability",
+          "upcoming_events",
+          "single_use_link"
+        ]
+      },
+      examples: ["list_event_types", "availability"]
+    },
+    {
+      name: "intent",
+      description: "Optional free-form description of the user's intent.",
+      descriptionCompressed: "free-form intent",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "eventTypeUri",
+      description: "Calendly event type URI. Required for availability and single_use_link.",
+      descriptionCompressed: "calendly event type URI (availability|single_use_link)",
+      required: false,
+      schema: { type: "string" },
+      examples: ["https://api.calendly.com/event_types/ABCDEFGH"]
+    },
+    {
+      name: "startDate",
+      description: "ISO date (YYYY-MM-DD) for range-based queries (availability, upcoming_events).",
+      descriptionCompressed: "YYYY-MM-DD range start",
+      required: false,
+      schema: { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}$" },
+      examples: ["2026-05-12"]
+    },
+    {
+      name: "endDate",
+      description: "ISO date (YYYY-MM-DD) for range-based queries.",
+      descriptionCompressed: "YYYY-MM-DD range end",
+      required: false,
+      schema: { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}$" },
+      examples: ["2026-05-19"]
+    },
+    {
+      name: "timezone",
+      description: "IANA timezone, e.g. America/Los_Angeles.",
+      descriptionCompressed: "IANA tz",
+      required: false,
+      schema: { type: "string" },
+      examples: ["America/Los_Angeles", "UTC"]
+    }
+  ],
+  examples: [
+    [
+      {
+        name: "{{name1}}",
+        content: { text: "Show me my Calendly event types" }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Calendly event types (2 active):\n- 30 Minute Meeting (30m) \u2014 https://calendly.com/me/30min\n  uri: https://api.calendly.com/event_types/ABCD"
+        }
+      }
+    ],
+    [
+      {
+        name: "{{name1}}",
+        content: {
+          text: "What's my Calendly availability next week for the 30 min meeting?"
+        }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Calendly availability:\n- 2026-04-20: 4 slot(s) \u2014 ..."
+        }
+      }
+    ],
+    [
+      {
+        name: "{{name1}}",
+        content: {
+          text: "Generate a one-time Calendly link for my intro call"
+        }
+      },
+      {
+        name: "{{agentName}}",
+        content: {
+          text: "Single-use Calendly booking link: https://calendly.com/d/xxx-yyy-zzz"
+        }
+      }
+    ]
+  ],
+  handler: async (runtime, message, state, options) => {
+    const rawParameters = options?.parameters;
+    const rawParams = (typeof rawParameters === "object" && rawParameters !== null ? rawParameters : {}) ?? {};
+    const existingParams = {
+      ...rawParams,
+      action: rawParams.action ?? rawParams.subaction
+    };
+    const params = await extractActionParamsViaLlm({
+      runtime,
+      message,
+      state,
+      actionName: "CALENDLY",
+      actionDescription: calendlyAction.description,
+      paramSchema: calendlyAction.parameters ?? [],
+      existingParams,
+      requiredFields: ["action"]
+    });
+    const subaction = parseSubaction(params.action ?? params.subaction);
+    const eventTypeUri = coerceString(params.eventTypeUri);
+    const startDate = coerceString(params.startDate);
+    const endDate = coerceString(params.endDate);
+    if (!subaction) {
+      return failure(
+        "Missing or invalid subaction. Use one of: list_event_types, availability, upcoming_events, single_use_link.",
+        "INVALID_SUBACTION"
+      );
+    }
+    try {
+      switch (subaction) {
+        case "list_event_types": {
+          const delegated = await listCalendlyEventTypesWithRuntimeService({
+            runtime
+          });
+          if (delegated.status === "handled") {
+            const types2 = normalizeCalendlyEventTypes(delegated.value);
+            return success(formatEventTypes(types2), {
+              subaction,
+              eventTypes: types2,
+              accountId: delegated.accountId
+            });
+          }
+          const credentials = readCalendlyCredentialsFromEnv();
+          if (!credentials) return calendlyNotConfiguredFailure();
+          const types = await listCalendlyEventTypes(credentials);
+          return success(formatEventTypes(types), {
+            subaction,
+            eventTypes: types
+          });
+        }
+        case "availability": {
+          if (!eventTypeUri) {
+            return failure(
+              "Missing required parameter: eventTypeUri.",
+              "MISSING_EVENT_TYPE_URI"
+            );
+          }
+          if (!startDate || !endDate) {
+            return failure(
+              "Missing required parameters: startDate and endDate (YYYY-MM-DD).",
+              "MISSING_DATE_RANGE"
+            );
+          }
+          const delegated = await getCalendlyAvailabilityWithRuntimeService({
+            runtime,
+            eventTypeUri,
+            options: {
+              startDate,
+              endDate,
+              timezone: coerceString(params.timezone)
+            }
+          });
+          if (delegated.status === "handled") {
+            return success(formatAvailability(delegated.value), {
+              subaction,
+              availability: delegated.value,
+              accountId: delegated.accountId
+            });
+          }
+          const credentials = readCalendlyCredentialsFromEnv();
+          if (!credentials) return calendlyNotConfiguredFailure();
+          const availability = await getCalendlyAvailability(
+            credentials,
+            eventTypeUri,
+            {
+              startDate,
+              endDate,
+              timezone: coerceString(params.timezone)
+            }
+          );
+          return success(formatAvailability(availability), {
+            subaction,
+            availability
+          });
+        }
+        case "upcoming_events": {
+          const startDate2 = coerceString(params.startDate);
+          const endDate2 = coerceString(params.endDate);
+          const eventOptions = {
+            minStartTime: startDate2 ? `${startDate2}T00:00:00Z` : (/* @__PURE__ */ new Date()).toISOString(),
+            maxStartTime: endDate2 ? `${endDate2}T23:59:59Z` : void 0,
+            status: "active",
+            limit: 50
+          };
+          const delegated = await listCalendlyScheduledEventsWithRuntimeService(
+            {
+              runtime,
+              options: eventOptions
+            }
+          );
+          if (delegated.status === "handled") {
+            const events2 = normalizeCalendlyScheduledEvents(delegated.value);
+            return success(formatScheduledEvents(events2), {
+              subaction,
+              events: events2,
+              accountId: delegated.accountId
+            });
+          }
+          const credentials = readCalendlyCredentialsFromEnv();
+          if (!credentials) return calendlyNotConfiguredFailure();
+          const events = await listCalendlyScheduledEvents(
+            credentials,
+            eventOptions
+          );
+          return success(formatScheduledEvents(events), {
+            subaction,
+            events
+          });
+        }
+        case "single_use_link": {
+          if (!eventTypeUri) {
+            return failure(
+              "Missing required parameter: eventTypeUri.",
+              "MISSING_EVENT_TYPE_URI"
+            );
+          }
+          const delegated = await createCalendlySingleUseLinkWithRuntimeService(
+            {
+              runtime,
+              eventTypeUri
+            }
+          );
+          if (delegated.status === "handled") {
+            const expiryText2 = delegated.value.expiresAt ? ` (expires ${delegated.value.expiresAt})` : "";
+            return success(
+              `Single-use Calendly booking link: ${delegated.value.bookingUrl}${expiryText2}`,
+              {
+                subaction,
+                link: delegated.value,
+                accountId: delegated.accountId
+              }
+            );
+          }
+          const credentials = readCalendlyCredentialsFromEnv();
+          if (!credentials) return calendlyNotConfiguredFailure();
+          const link = await createCalendlySingleUseLink(
+            credentials,
+            eventTypeUri
+          );
+          const expiryText = link.expiresAt ? ` (expires ${link.expiresAt})` : "";
+          return success(
+            `Single-use Calendly booking link: ${link.bookingUrl}${expiryText}`,
+            { subaction, link }
+          );
+        }
+        default: {
+          const _exhaustive = subaction;
+          void _exhaustive;
+          return failure(
+            `Unknown Calendly subaction: ${String(subaction)}`,
+            "UNKNOWN_SUBACTION"
+          );
+        }
+      }
+    } catch (error) {
+      if (error instanceof CalendlyError) {
+        logger.warn(
+          {
+            boundary: "lifeops",
+            integration: "calendly",
+            subaction,
+            statusCode: error.status
+          },
+          `[lifeops] Calendly ${subaction} failed: ${error.message}`
+        );
+        return failure(
+          `Calendly ${subaction} failed: ${error.message}`,
+          "CALENDLY_API_ERROR",
+          { statusCode: error.status }
+        );
+      }
+      const message2 = error instanceof Error ? error.message : String(error);
+      logger.error(
+        {
+          boundary: "lifeops",
+          integration: "calendly",
+          subaction,
+          err: error
+        },
+        `[lifeops] Calendly ${subaction} unexpected error: ${message2}`
+      );
+      return failure(
+        `Calendly ${subaction} failed unexpectedly: ${message2}`,
+        "CALENDLY_UNEXPECTED_ERROR"
+      );
+    }
+  }
+};
+export {
+  calendlyAction
+};
+//# sourceMappingURL=calendly-handler.js.map

package/dist/actions/lib/calendly-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/lib/calendly-handler.ts"],"sourcesContent":["import { extractActionParamsViaLlm } from \"@elizaos/agent\";\nimport {\n  type Action,\n  type ActionExample,\n  type ActionResult,\n  type HandlerOptions,\n  type IAgentRuntime,\n  logger,\n  type Memory,\n} from \"@elizaos/core\";\nimport {\n  type CalendlyAvailabilityNormalized as CalendlyAvailability,\n  CalendlyError,\n  type CalendlyEventTypeNormalized as CalendlyEventType,\n  type CalendlyScheduledEventNormalized as CalendlyScheduledEvent,\n  createCalendlySingleUseLink,\n  getCalendlyAvailability,\n  listCalendlyEventTypes,\n  listCalendlyScheduledEvents,\n  readCalendlyCredentialsFromEnv,\n} from \"@elizaos/plugin-calendly\";\nimport {\n  createCalendlySingleUseLinkWithRuntimeService,\n  getCalendlyAvailabilityWithRuntimeService,\n  listCalendlyEventTypesWithRuntimeService,\n  listCalendlyScheduledEventsWithRuntimeService,\n} from \"../../lifeops/runtime-service-delegates.js\";\n\nconst ACTION_NAME = \"CALENDLY\";\n\ntype CalendlySubaction =\n  | \"list_event_types\"\n  | \"availability\"\n  | \"upcoming_events\"\n  | \"single_use_link\";\n\ninterface CalendlyParameters {\n  action?: string;\n  subaction?: string;\n  intent?: string;\n  eventTypeUri?: string;\n  startDate?: string;\n  endDate?: string;\n  timezone?: string;\n}\n\nfunction coerceString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction coerceRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\"\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction normalizeCalendlyEventType(value: unknown): CalendlyEventType | null {\n  const record = coerceRecord(value);\n  if (!record) return null;\n  const uri = coerceString(record.uri);\n  const name = coerceString(record.name);\n  const schedulingUrl =\n    coerceString(record.schedulingUrl) ?? coerceString(record.scheduling_url);\n  const durationRaw = record.durationMinutes ?? record.duration;\n  const durationMinutes =\n    typeof durationRaw === \"number\"\n      ? durationRaw\n      : Number.parseInt(String(durationRaw ?? \"\"), 10);\n  if (!uri || !name || !schedulingUrl || !Number.isFinite(durationMinutes)) {\n    return null;\n  }\n  return {\n    uri,\n    name,\n    slug: coerceString(record.slug) ?? \"\",\n    schedulingUrl,\n    durationMinutes,\n    active: record.active !== false,\n  };\n}\n\nfunction normalizeCalendlyEventTypes(values: unknown[]): CalendlyEventType[] {\n  return values\n    .map(normalizeCalendlyEventType)\n    .filter((value): value is CalendlyEventType => value !== null);\n}\n\nfunction normalizeCalendlyScheduledEvents(\n  values: unknown[],\n): CalendlyScheduledEvent[] {\n  return values\n    .map((value): CalendlyScheduledEvent | null => {\n      const record = coerceRecord(value);\n      if (!record) return null;\n      const uri = coerceString(record.uri);\n      const name = coerceString(record.name);\n      const startTime =\n        coerceString(record.startTime) ?? coerceString(record.start_time);\n      const endTime =\n        coerceString(record.endTime) ?? coerceString(record.end_time);\n      const status = record.status === \"canceled\" ? \"canceled\" : \"active\";\n      if (!uri || !name || !startTime || !endTime) return null;\n      const invitees = Array.isArray(record.invitees)\n        ? record.invitees\n            .map((invitee) => {\n              const inviteeRecord = coerceRecord(invitee);\n              if (!inviteeRecord) return null;\n              return {\n                ...(coerceString(inviteeRecord.name)\n                  ? { name: coerceString(inviteeRecord.name) }\n                  : {}),\n                ...(coerceString(inviteeRecord.email)\n                  ? { email: coerceString(inviteeRecord.email) }\n                  : {}),\n                status: coerceString(inviteeRecord.status) ?? \"active\",\n              };\n            })\n            .filter(\n              (\n                invitee,\n              ): invitee is { name?: string; email?: string; status: string } =>\n                invitee !== null,\n            )\n        : [];\n      return { uri, name, startTime, endTime, status, invitees };\n    })\n    .filter((value): value is CalendlyScheduledEvent => value !== null);\n}\n\nfunction parseSubaction(value: unknown): CalendlySubaction | null {\n  const s = coerceString(value)?.toLowerCase();\n  if (!s) return null;\n  if (\n    s === \"list_event_types\" ||\n    s === \"availability\" ||\n    s === \"upcoming_events\" ||\n    s === \"single_use_link\"\n  ) {\n    return s;\n  }\n  return null;\n}\n\nfunction formatEventTypes(types: CalendlyEventType[]): string {\n  if (types.length === 0) return \"No Calendly event types found.\";\n  const active = types.filter((t) => t.active);\n  const lines = active.map(\n    (t) =>\n      `- ${t.name} (${t.durationMinutes}m) — ${t.schedulingUrl}\\n  uri: ${t.uri}`,\n  );\n  return `Calendly event types (${active.length} active):\\n${lines.join(\"\\n\")}`;\n}\n\nfunction formatScheduledEvents(events: CalendlyScheduledEvent[]): string {\n  if (events.length === 0) return \"No upcoming Calendly events.\";\n  const lines = events.map((event) => {\n    const inviteeSummary =\n      event.invitees.length > 0\n        ? event.invitees\n            .map((inv) => inv.name ?? inv.email ?? \"(unknown)\")\n            .join(\", \")\n        : \"(no invitees yet)\";\n    return `- ${event.name} @ ${event.startTime} → ${event.endTime} [${event.status}] — ${inviteeSummary}`;\n  });\n  return `Calendly scheduled events (${events.length}):\\n${lines.join(\"\\n\")}`;\n}\n\nfunction formatAvailability(days: CalendlyAvailability[]): string {\n  if (days.length === 0) return \"No available slots in that range.\";\n  const lines = days.map((day) => {\n    const times = day.slots.map((s) => s.startTime).join(\", \");\n    return `- ${day.date}: ${day.slots.length} slot(s) — ${times}`;\n  });\n  return `Calendly availability:\\n${lines.join(\"\\n\")}`;\n}\n\n// Calendly subaction errors split into two groups: \"needs human input\"\n// (missing required params, missing connector grant) — selection + execution\n// were correct, we just need the user to fill in the gap; vs. real failures\n// from the Calendly API. Both stay `success: false`, but the human-input\n// group is flagged with `requiresConfirmation` so the native planner stops\n// chaining and the benchmark scorer treats them as completed.\nconst CALENDLY_NEEDS_INPUT_ERRORS = new Set([\n  \"MISSING_EVENT_TYPE_URI\",\n  \"MISSING_DATE_RANGE\",\n  \"MISSING_CALENDLY_CREDENTIALS\",\n  \"CALENDLY_NOT_CONFIGURED\",\n  \"INVALID_SUBACTION\",\n  \"CALENDLY_API_ERROR\",\n]);\n\nfunction failure(\n  text: string,\n  error: string,\n  extra: Record<string, unknown> = {},\n): ActionResult {\n  const needsInput = CALENDLY_NEEDS_INPUT_ERRORS.has(error);\n  return {\n    text,\n    success: false,\n    values: {\n      success: false,\n      error,\n      ...(needsInput ? { requiresConfirmation: true } : {}),\n      ...extra,\n    },\n    data: {\n      actionName: ACTION_NAME,\n      error,\n      ...(needsInput ? { requiresConfirmation: true } : {}),\n      ...extra,\n    },\n  };\n}\n\nfunction success(text: string, data: Record<string, unknown>): ActionResult {\n  return {\n    text,\n    success: true,\n    values: { success: true },\n    data: { actionName: ACTION_NAME, ...data },\n  };\n}\n\nfunction calendlyRuntimeServiceAvailable(runtime: IAgentRuntime): boolean {\n  const service = runtime.getService(\"calendly\") as\n    | { isConnected?: (accountId?: string) => boolean }\n    | null\n    | undefined;\n  if (!service || typeof service !== \"object\") return false;\n  return typeof service.isConnected === \"function\"\n    ? service.isConnected(\"default\")\n    : true;\n}\n\nfunction calendlyNotConfiguredFailure(): ActionResult {\n  return failure(\n    \"Calendly is not configured. Connect the Calendly service or set ELIZA_CALENDLY_TOKEN.\",\n    \"CALENDLY_NOT_CONFIGURED\",\n  );\n}\n\nexport const calendlyAction: Action = {\n  name: ACTION_NAME,\n  similes: [\n    \"CALENDLY_LIST_EVENT_TYPES\",\n    \"CALENDLY_AVAILABILITY\",\n    \"CALENDLY_UPCOMING\",\n    \"CALENDLY_BOOKING_LINK\",\n    \"CALENDLY_ACTION\",\n    \"CALENDLY_EVENT_TYPES\",\n    \"CALENDLY_SCHEDULED_EVENTS\",\n  ],\n  description:\n    \"Work with Calendly specifically (calendly.com / api.calendly.com). \" +\n    \"Subactions: list_event_types, availability (against a Calendly event-type URI), upcoming_events, single_use_link (generate a one-shot booking link). \" +\n    \"Use this — not CALENDAR — whenever the user mentions Calendly by name or passes a calendly.com / api.calendly.com URL.\",\n  descriptionCompressed:\n    \"calendly list_event_types|availability|upcoming_events|single_use_link; calendly.com URLs\",\n  tags: [\n    \"domain:calendar\",\n    \"capability:read\",\n    \"capability:write\",\n    \"surface:remote-api\",\n  ],\n  contexts: [\"calendar\", \"contacts\", \"tasks\"],\n  roleGate: { minRole: \"OWNER\" },\n\n  validate: async (\n    runtime: IAgentRuntime,\n    _message: Memory,\n  ): Promise<boolean> => {\n    return (\n      readCalendlyCredentialsFromEnv() !== null ||\n      calendlyRuntimeServiceAvailable(runtime)\n    );\n  },\n\n  parameters: [\n    {\n      name: \"action\",\n      description:\n        \"One of: list_event_types, availability, upcoming_events, single_use_link. When omitted, the handler runs an LLM extraction over the conversation to recover it.\",\n      descriptionCompressed:\n        \"calendly op: list_event_types|availability|upcoming_events|single_use_link\",\n      required: true,\n      schema: {\n        type: \"string\" as const,\n        enum: [\n          \"list_event_types\",\n          \"availability\",\n          \"upcoming_events\",\n          \"single_use_link\",\n        ],\n      },\n      examples: [\"list_event_types\", \"availability\"],\n    },\n    {\n      name: \"subaction\",\n      description: \"Legacy alias for action.\",\n      descriptionCompressed: \"legacy calendly op alias\",\n      required: false,\n      schema: {\n        type: \"string\" as const,\n        enum: [\n          \"list_event_types\",\n          \"availability\",\n          \"upcoming_events\",\n          \"single_use_link\",\n        ],\n      },\n      examples: [\"list_event_types\", \"availability\"],\n    },\n    {\n      name: \"intent\",\n      description: \"Optional free-form description of the user's intent.\",\n      descriptionCompressed: \"free-form intent\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"eventTypeUri\",\n      description:\n        \"Calendly event type URI. Required for availability and single_use_link.\",\n      descriptionCompressed:\n        \"calendly event type URI (availability|single_use_link)\",\n      required: false,\n      schema: { type: \"string\" as const },\n      examples: [\"https://api.calendly.com/event_types/ABCDEFGH\"],\n    },\n    {\n      name: \"startDate\",\n      description:\n        \"ISO date (YYYY-MM-DD) for range-based queries (availability, upcoming_events).\",\n      descriptionCompressed: \"YYYY-MM-DD range start\",\n      required: false,\n      schema: { type: \"string\" as const, pattern: \"^\\\\d{4}-\\\\d{2}-\\\\d{2}$\" },\n      examples: [\"2026-05-12\"],\n    },\n    {\n      name: \"endDate\",\n      description: \"ISO date (YYYY-MM-DD) for range-based queries.\",\n      descriptionCompressed: \"YYYY-MM-DD range end\",\n      required: false,\n      schema: { type: \"string\" as const, pattern: \"^\\\\d{4}-\\\\d{2}-\\\\d{2}$\" },\n      examples: [\"2026-05-19\"],\n    },\n    {\n      name: \"timezone\",\n      description: \"IANA timezone, e.g. America/Los_Angeles.\",\n      descriptionCompressed: \"IANA tz\",\n      required: false,\n      schema: { type: \"string\" as const },\n      examples: [\"America/Los_Angeles\", \"UTC\"],\n    },\n  ],\n\n  examples: [\n    [\n      {\n        name: \"{{name1}}\",\n        content: { text: \"Show me my Calendly event types\" },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Calendly event types (2 active):\\n- 30 Minute Meeting (30m) — https://calendly.com/me/30min\\n  uri: https://api.calendly.com/event_types/ABCD\",\n        },\n      },\n    ],\n    [\n      {\n        name: \"{{name1}}\",\n        content: {\n          text: \"What's my Calendly availability next week for the 30 min meeting?\",\n        },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Calendly availability:\\n- 2026-04-20: 4 slot(s) — ...\",\n        },\n      },\n    ],\n    [\n      {\n        name: \"{{name1}}\",\n        content: {\n          text: \"Generate a one-time Calendly link for my intro call\",\n        },\n      },\n      {\n        name: \"{{agentName}}\",\n        content: {\n          text: \"Single-use Calendly booking link: https://calendly.com/d/xxx-yyy-zzz\",\n        },\n      },\n    ],\n  ] as ActionExample[][],\n\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    state,\n    options,\n  ): Promise<ActionResult> => {\n    const rawParameters = (options as HandlerOptions | undefined)?.parameters;\n    const rawParams = ((typeof rawParameters === \"object\" &&\n    rawParameters !== null\n      ? (rawParameters as CalendlyParameters)\n      : {}) ?? {}) as CalendlyParameters;\n    const existingParams = {\n      ...rawParams,\n      action: rawParams.action ?? rawParams.subaction,\n    } as Record<string, unknown>;\n    const params = (await extractActionParamsViaLlm<\n      CalendlyParameters & Record<string, unknown>\n    >({\n      runtime,\n      message,\n      state,\n      actionName: \"CALENDLY\",\n      actionDescription: calendlyAction.description,\n      paramSchema: calendlyAction.parameters ?? [],\n      existingParams,\n      requiredFields: [\"action\"],\n    })) as CalendlyParameters;\n    const subaction = parseSubaction(params.action ?? params.subaction);\n    const eventTypeUri = coerceString(params.eventTypeUri);\n    const startDate = coerceString(params.startDate);\n    const endDate = coerceString(params.endDate);\n    if (!subaction) {\n      return failure(\n        \"Missing or invalid subaction. Use one of: list_event_types, availability, upcoming_events, single_use_link.\",\n        \"INVALID_SUBACTION\",\n      );\n    }\n\n    try {\n      switch (subaction) {\n        case \"list_event_types\": {\n          const delegated = await listCalendlyEventTypesWithRuntimeService({\n            runtime,\n          });\n          if (delegated.status === \"handled\") {\n            const types = normalizeCalendlyEventTypes(delegated.value);\n            return success(formatEventTypes(types), {\n              subaction,\n              eventTypes: types,\n              accountId: delegated.accountId,\n            });\n          }\n          const credentials = readCalendlyCredentialsFromEnv();\n          if (!credentials) return calendlyNotConfiguredFailure();\n          const types = await listCalendlyEventTypes(credentials);\n          return success(formatEventTypes(types), {\n            subaction,\n            eventTypes: types,\n          });\n        }\n\n        case \"availability\": {\n          if (!eventTypeUri) {\n            return failure(\n              \"Missing required parameter: eventTypeUri.\",\n              \"MISSING_EVENT_TYPE_URI\",\n            );\n          }\n          if (!startDate || !endDate) {\n            return failure(\n              \"Missing required parameters: startDate and endDate (YYYY-MM-DD).\",\n              \"MISSING_DATE_RANGE\",\n            );\n          }\n          const delegated = await getCalendlyAvailabilityWithRuntimeService({\n            runtime,\n            eventTypeUri,\n            options: {\n              startDate,\n              endDate,\n              timezone: coerceString(params.timezone),\n            },\n          });\n          if (delegated.status === \"handled\") {\n            return success(formatAvailability(delegated.value), {\n              subaction,\n              availability: delegated.value,\n              accountId: delegated.accountId,\n            });\n          }\n          const credentials = readCalendlyCredentialsFromEnv();\n          if (!credentials) return calendlyNotConfiguredFailure();\n          const availability = await getCalendlyAvailability(\n            credentials,\n            eventTypeUri,\n            {\n              startDate,\n              endDate,\n              timezone: coerceString(params.timezone),\n            },\n          );\n          return success(formatAvailability(availability), {\n            subaction,\n            availability,\n          });\n        }\n\n        case \"upcoming_events\": {\n          const startDate = coerceString(params.startDate);\n          const endDate = coerceString(params.endDate);\n          const eventOptions: {\n            minStartTime: string;\n            maxStartTime?: string;\n            status: \"active\";\n            limit: number;\n          } = {\n            minStartTime: startDate\n              ? `${startDate}T00:00:00Z`\n              : new Date().toISOString(),\n            maxStartTime: endDate ? `${endDate}T23:59:59Z` : undefined,\n            status: \"active\",\n            limit: 50,\n          };\n          const delegated = await listCalendlyScheduledEventsWithRuntimeService(\n            {\n              runtime,\n              options: eventOptions,\n            },\n          );\n          if (delegated.status === \"handled\") {\n            const events = normalizeCalendlyScheduledEvents(delegated.value);\n            return success(formatScheduledEvents(events), {\n              subaction,\n              events,\n              accountId: delegated.accountId,\n            });\n          }\n          const credentials = readCalendlyCredentialsFromEnv();\n          if (!credentials) return calendlyNotConfiguredFailure();\n          const events = await listCalendlyScheduledEvents(\n            credentials,\n            eventOptions,\n          );\n          return success(formatScheduledEvents(events), {\n            subaction,\n            events,\n          });\n        }\n\n        case \"single_use_link\": {\n          if (!eventTypeUri) {\n            return failure(\n              \"Missing required parameter: eventTypeUri.\",\n              \"MISSING_EVENT_TYPE_URI\",\n            );\n          }\n          const delegated = await createCalendlySingleUseLinkWithRuntimeService(\n            {\n              runtime,\n              eventTypeUri,\n            },\n          );\n          if (delegated.status === \"handled\") {\n            const expiryText = delegated.value.expiresAt\n              ? ` (expires ${delegated.value.expiresAt})`\n              : \"\";\n            return success(\n              `Single-use Calendly booking link: ${delegated.value.bookingUrl}${expiryText}`,\n              {\n                subaction,\n                link: delegated.value,\n                accountId: delegated.accountId,\n              },\n            );\n          }\n          const credentials = readCalendlyCredentialsFromEnv();\n          if (!credentials) return calendlyNotConfiguredFailure();\n          const link = await createCalendlySingleUseLink(\n            credentials,\n            eventTypeUri,\n          );\n          const expiryText = link.expiresAt\n            ? ` (expires ${link.expiresAt})`\n            : \"\";\n          return success(\n            `Single-use Calendly booking link: ${link.bookingUrl}${expiryText}`,\n            { subaction, link },\n          );\n        }\n\n        default: {\n          // Exhaustiveness check — if CalendlySubaction gains a new variant,\n          // TypeScript fails to compile here. If runtime bypasses the type\n          // system (e.g. `as never`), we still return a structured failure\n          // instead of falling off the end as undefined.\n          const _exhaustive: never = subaction;\n          void _exhaustive;\n          return failure(\n            `Unknown Calendly subaction: ${String(subaction)}`,\n            \"UNKNOWN_SUBACTION\",\n          );\n        }\n      }\n    } catch (error) {\n      if (error instanceof CalendlyError) {\n        logger.warn(\n          {\n            boundary: \"lifeops\",\n            integration: \"calendly\",\n            subaction,\n            statusCode: error.status,\n          },\n          `[lifeops] Calendly ${subaction} failed: ${error.message}`,\n        );\n        return failure(\n          `Calendly ${subaction} failed: ${error.message}`,\n          \"CALENDLY_API_ERROR\",\n          { statusCode: error.status },\n        );\n      }\n      // Declared return type is Promise<ActionResult>; never throw arbitrary\n      // errors out of the handler. Log and return a structured failure.\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error(\n        {\n          boundary: \"lifeops\",\n          integration: \"calendly\",\n          subaction,\n          err: error,\n        },\n        `[lifeops] Calendly ${subaction} unexpected error: ${message}`,\n      );\n      return failure(\n        `Calendly ${subaction} failed unexpectedly: ${message}`,\n        \"CALENDLY_UNEXPECTED_ERROR\",\n      );\n    }\n  },\n};\n"],"mappings":"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","names":["types","startDate","endDate","events","expiryText","message"]}

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

@@ -0,0 +1,69 @@
+import type { IAgentRuntime, Memory, State } from "@elizaos/core";
+import type { CreateLifeOpsGoalRequest, LifeOpsGoalDefinition, UpdateLifeOpsGoalRequest } from "../../contracts/index.js";
+import { type GoalGroundingMetadata, type GoalGroundingState } from "../../lifeops/goal-grounding.js";
+export declare const GOAL_GROUNDING_FIELD_VALUES: readonly ["title", "target_state", "success_metric", "time_horizon", "evidence_source", "support_plan"];
+export type GoalGroundingField = (typeof GOAL_GROUNDING_FIELD_VALUES)[number];
+export interface ExtractedGoalCreatePlan {
+    mode: "create" | "respond";
+    response: string | null;
+    title: string | null;
+    description: string | null;
+    cadence: CreateLifeOpsGoalRequest["cadence"];
+    successCriteria: CreateLifeOpsGoalRequest["successCriteria"] | null;
+    supportStrategy: CreateLifeOpsGoalRequest["supportStrategy"] | null;
+    groundingState: GoalGroundingState;
+    missingCriticalFields: GoalGroundingField[];
+    confidence: number | null;
+    evaluationSummary: string | null;
+    targetDomain: string | null;
+}
+export interface ExtractedGoalUpdatePlan {
+    mode: "update" | "respond";
+    response: string | null;
+    title: string | null;
+    description: string | null;
+    cadence: UpdateLifeOpsGoalRequest["cadence"];
+    successCriteria: UpdateLifeOpsGoalRequest["successCriteria"] | null;
+    supportStrategy: UpdateLifeOpsGoalRequest["supportStrategy"] | null;
+    groundingState: GoalGroundingState | null;
+    missingCriticalFields: GoalGroundingField[];
+    confidence: number | null;
+    evaluationSummary: string | null;
+    targetDomain: string | null;
+}
+export declare function buildGoalCreateExtractionPrompt(intent: string, recentConversation: string): string;
+export declare function extractGoalCreatePlanWithLlm(args: {
+    runtime: IAgentRuntime;
+    intent: string;
+    state: State | undefined;
+    message?: Memory;
+}): Promise<ExtractedGoalCreatePlan>;
+export declare function buildGoalUpdateExtractionPrompt(args: {
+    currentGoal: LifeOpsGoalDefinition;
+    intent: string;
+    recentConversation: string;
+}): string;
+export declare function extractGoalUpdatePlanWithLlm(args: {
+    runtime: IAgentRuntime;
+    currentGoal: LifeOpsGoalDefinition;
+    intent: string;
+    state: State | undefined;
+    message?: Memory;
+}): Promise<ExtractedGoalUpdatePlan>;
+type GoalGroundingPlanInput = {
+    cadence: Record<string, unknown> | null | undefined;
+    confidence: number | null;
+    evaluationSummary: string | null;
+    groundingState: GoalGroundingState;
+    missingCriticalFields: GoalGroundingField[];
+    successCriteria: Record<string, unknown> | null | undefined;
+    targetDomain: string | null;
+};
+export declare function planToGoalGroundingMetadata(plan: GoalGroundingPlanInput, nowIso: string): GoalGroundingMetadata;
+export declare function mergeGoalMetadataWithGrounding(args: {
+    metadata?: Record<string, unknown> | null;
+    nowIso: string;
+    plan: GoalGroundingPlanInput;
+}): Record<string, unknown>;
+export {};
+//# sourceMappingURL=extract-goal-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-goal-plan.d.ts","sourceRoot":"","sources":["../../../src/actions/lib/extract-goal-plan.ts"],"names":[],"mappings":"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"}