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

package/dist/actions/book-travel.js

@@ -0,0 +1,467 @@
+import {
+  recentConversationTexts as collectRecentConversationTexts,
+  ModelType,
+  parseJsonModelRecord,
+  runWithTrajectoryContext
+} from "@elizaos/core";
+import {
+  PaymentRequiredError
+} from "@elizaos/plugin-elizacloud/cloud/x402-payment-handler";
+import { INTERNAL_URL } from "../lifeops/access.js";
+import { createApprovalQueue } from "../lifeops/approval-queue.js";
+import { requireFeatureEnabled } from "../lifeops/feature-flags.js";
+import { FeatureNotEnabledError } from "../lifeops/feature-flags.types.js";
+import { LifeOpsService } from "../lifeops/service.js";
+function trimToNull(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizePassenger(value) {
+  const givenName = trimToNull(value.givenName);
+  const familyName = trimToNull(value.familyName);
+  const bornOn = trimToNull(value.bornOn);
+  if (!givenName || !familyName || !bornOn) {
+    return null;
+  }
+  return {
+    offerPassengerId: trimToNull(value.offerPassengerId),
+    givenName,
+    familyName,
+    bornOn,
+    email: trimToNull(value.email),
+    phoneNumber: trimToNull(value.phoneNumber),
+    title: trimToNull(value.title),
+    gender: trimToNull(value.gender)
+  };
+}
+function normalizePassengers(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.map(
+    (passenger) => passenger && typeof passenger === "object" ? normalizePassenger(passenger) : null
+  ).filter(
+    (passenger) => passenger !== null
+  );
+}
+function formatBookTravelPromptValue(value) {
+  if (value === null || value === void 0) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return "none";
+    }
+    return value.map(
+      (entry, index) => `item ${index + 1}: ${formatBookTravelPromptValue(entry)}`
+    ).join("\n");
+  }
+  if (typeof value === "object") {
+    const entries = Object.entries(value);
+    if (entries.length === 0) {
+      return "none";
+    }
+    return entries.map(([key, entry]) => `${key}: ${formatBookTravelPromptValue(entry)}`).join("\n");
+  }
+  return String(value);
+}
+function normalizeCalendarSync(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const record = value;
+  return {
+    enabled: record.enabled !== false,
+    calendarId: trimToNull(record.calendarId),
+    title: trimToNull(record.title),
+    description: trimToNull(record.description),
+    location: trimToNull(record.location),
+    timeZone: trimToNull(record.timeZone)
+  };
+}
+function mergePlans(params, extracted) {
+  const normalizedPassengers = normalizePassengers(params.passengers);
+  const extractedPassengers = normalizePassengers(extracted.passengers);
+  const passengers = normalizedPassengers.length > 0 ? normalizedPassengers : extractedPassengers;
+  return {
+    offerId: trimToNull(params.offerId) ?? extracted.offerId,
+    origin: trimToNull(params.origin) ?? extracted.origin,
+    destination: trimToNull(params.destination) ?? extracted.destination,
+    departureDate: trimToNull(params.departureDate) ?? extracted.departureDate,
+    returnDate: trimToNull(params.returnDate) ?? extracted.returnDate,
+    passengerCount: typeof params.passengerCount === "number" && params.passengerCount > 0 ? Math.floor(params.passengerCount) : extracted.passengerCount,
+    passengers,
+    calendarSync: normalizeCalendarSync(params.calendarSync) ?? normalizeCalendarSync(extracted.calendarSync) ?? {
+      enabled: true,
+      calendarId: "primary",
+      title: null,
+      description: null,
+      location: null,
+      timeZone: null
+    }
+  };
+}
+function getParams(options) {
+  return options?.parameters ?? {};
+}
+function messageText(message) {
+  return typeof message.content.text === "string" ? message.content.text : "";
+}
+async function extractBookTravelPlanWithLlm(args) {
+  if (typeof args.runtime.useModel !== "function") {
+    return {
+      offerId: null,
+      origin: null,
+      destination: null,
+      departureDate: null,
+      returnDate: null,
+      passengerCount: null,
+      passengers: [],
+      calendarSync: null
+    };
+  }
+  const recentConversation = (await collectRecentConversationTexts({
+    runtime: args.runtime,
+    message: args.message,
+    state: args.state,
+    limit: 6
+  })).join("\n");
+  const prompt = [
+    "Extract structured booking data for PERSONAL_ASSISTANT action=book_travel.",
+    "Return JSON only as a single object with exactly these keys:",
+    "offerId: string or null",
+    "origin: IATA airport code or null",
+    "destination: IATA airport code or null",
+    "departureDate: YYYY-MM-DD or null",
+    "returnDate: YYYY-MM-DD or null",
+    "passengerCount: number or null",
+    "passengers: passenger records if known; each record may include offerPassengerId, givenName, familyName, bornOn, email, phoneNumber, title, gender",
+    "calendarSync: calendar sync object if known; may include enabled, calendarId, title, description, location, timeZone",
+    'Example: {"offerId":null,"origin":"SFO","destination":"JFK","departureDate":"2026-06-01","returnDate":null,"passengerCount":1,"passengers":[],"calendarSync":null}',
+    "",
+    "Rules:",
+    "- Do not invent airports, dates, or passenger birthdays.",
+    "- Use offerId when the conversation already references a chosen offer.",
+    "- Use null for missing values.",
+    "- Passenger birthdays must stay in YYYY-MM-DD format when present.",
+    "",
+    `User message:
+${messageText(args.message)}`,
+    "",
+    `Current parameters:
+${formatBookTravelPromptValue(args.params)}`,
+    "",
+    `Recent conversation:
+${recentConversation}`
+  ].join("\n");
+  let parsed = null;
+  try {
+    const raw = await runWithTrajectoryContext(
+      { purpose: "lifeops-book-travel" },
+      () => args.runtime.useModel(ModelType.TEXT_SMALL, { prompt })
+    );
+    const rawText = typeof raw === "string" ? raw : "";
+    parsed = parseJsonModelRecord(rawText);
+  } catch {
+    parsed = null;
+  }
+  return {
+    offerId: trimToNull(parsed?.offerId),
+    origin: trimToNull(parsed?.origin),
+    destination: trimToNull(parsed?.destination),
+    departureDate: trimToNull(parsed?.departureDate),
+    returnDate: trimToNull(parsed?.returnDate),
+    passengerCount: typeof parsed?.passengerCount === "number" && Number.isFinite(parsed.passengerCount) ? Math.max(1, Math.floor(parsed.passengerCount)) : null,
+    passengers: Array.isArray(parsed?.passengers) ? parsed.passengers : [],
+    calendarSync: parsed?.calendarSync && typeof parsed.calendarSync === "object" ? parsed.calendarSync : null
+  };
+}
+function listMissingPassengerFields(passengers) {
+  if (passengers.length > 0) {
+    return [];
+  }
+  return [
+    "passenger given name",
+    "passenger family name",
+    "passenger date of birth"
+  ];
+}
+function buildMissingInfoText(missing) {
+  return `I can queue the booking once I have ${missing.join(", ")}.`;
+}
+function buildApprovalText(request) {
+  const payload = request.payload.action === "book_travel" ? request.payload : null;
+  const route = payload?.summary?.trim() || "this itinerary";
+  const total = typeof payload?.totalCents === "number" && payload.totalCents > 0 ? `${(payload.totalCents / 100).toFixed(2)} ${payload.currency}` : payload?.currency ?? "the quoted total";
+  const orderType = payload?.orderType === "hold" ? "hold then pay" : payload?.orderType === "instant" ? "book immediately" : "book";
+  return `Queued travel approval for ${route}. Once you approve, I will ${orderType}, complete payment, and sync the itinerary to your calendar. Current quote: ${total}.`;
+}
+async function runBookTravelHandler(runtime, message, state, options, callback) {
+  try {
+    await requireFeatureEnabled(runtime, "travel.book_flight");
+  } catch (error) {
+    if (error instanceof FeatureNotEnabledError) {
+      const text2 = error.message;
+      if (callback) {
+        await callback({ text: text2 });
+      }
+      return {
+        text: text2,
+        success: false,
+        values: {
+          success: false,
+          error: error.code,
+          featureKey: error.featureKey,
+          requiresConfirmation: true
+        },
+        data: {
+          actionName: "PERSONAL_ASSISTANT",
+          action: "book_travel",
+          error: error.code,
+          featureKey: error.featureKey,
+          requiresConfirmation: true
+        }
+      };
+    }
+    throw error;
+  }
+  const params = getParams(options);
+  const extracted = await extractBookTravelPlanWithLlm({
+    runtime,
+    message,
+    state,
+    params
+  });
+  const merged = mergePlans(params, extracted);
+  const missing = [];
+  if (!merged.offerId) {
+    if (!merged.origin) {
+      missing.push("origin airport");
+    }
+    if (!merged.destination) {
+      missing.push("destination airport");
+    }
+    if (!merged.departureDate) {
+      missing.push("departure date");
+    }
+  }
+  missing.push(...listMissingPassengerFields(merged.passengers));
+  if (missing.length > 0) {
+    const text2 = buildMissingInfoText(missing);
+    if (callback) {
+      await callback({ text: text2 });
+    }
+    return {
+      text: text2,
+      success: false,
+      values: {
+        success: false,
+        error: "MISSING_BOOKING_DETAILS",
+        requiresConfirmation: true,
+        missing
+      },
+      data: {
+        actionName: "PERSONAL_ASSISTANT",
+        action: "book_travel",
+        error: "MISSING_BOOKING_DETAILS",
+        requiresConfirmation: true,
+        missing
+      }
+    };
+  }
+  const service = new LifeOpsService(runtime);
+  let search = null;
+  if (!merged.offerId) {
+    const { origin, destination, departureDate } = merged;
+    if (!origin || !destination || !departureDate) {
+      throw new Error(
+        "PERSONAL_ASSISTANT action=book_travel validated fields are unexpectedly missing"
+      );
+    }
+    search = {
+      origin,
+      destination,
+      departureDate,
+      returnDate: merged.returnDate ?? void 0,
+      passengers: merged.passengerCount ?? merged.passengers.length
+    };
+  }
+  let prepared;
+  try {
+    prepared = await service.prepareFlightBooking({
+      offerId: merged.offerId,
+      search,
+      passengers: merged.passengers,
+      calendarSync: merged.calendarSync
+    });
+  } catch (err) {
+    if (!(err instanceof PaymentRequiredError) || err.requirements.length === 0) {
+      throw err;
+    }
+    const paymentRequired = err.requirements[0];
+    const queue2 = createApprovalQueue(runtime, { agentId: runtime.agentId });
+    const subjectUserId2 = typeof message.entityId === "string" ? message.entityId : String(runtime.agentId);
+    const request2 = await queue2.enqueue({
+      requestedBy: "PERSONAL_ASSISTANT",
+      subjectUserId: subjectUserId2,
+      action: "book_travel",
+      payload: {
+        action: "book_travel",
+        kind: "flight",
+        provider: "duffel",
+        itineraryRef: merged.offerId ?? "pending-quote",
+        totalCents: 0,
+        currency: "USD",
+        offerId: merged.offerId,
+        summary: merged.offerId ? `Booking for offer ${merged.offerId}` : `${merged.origin ?? "?"} \u2192 ${merged.destination ?? "?"}`,
+        cost: null,
+        paymentRequired: {
+          amount: paymentRequired.amount,
+          asset: paymentRequired.asset,
+          network: paymentRequired.network,
+          payTo: paymentRequired.payTo,
+          scheme: paymentRequired.scheme,
+          expiresAt: paymentRequired.expiresAt,
+          description: paymentRequired.description
+        }
+      },
+      channel: "internal",
+      reason: `Top up ${paymentRequired.amount} ${paymentRequired.asset} on ${paymentRequired.network} to book travel`,
+      expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1e3)
+    });
+    const text2 = `Eliza Cloud needs a top-up before I can quote this trip: ${paymentRequired.amount} ${paymentRequired.asset} on ${paymentRequired.network}. I queued it for approval so you can review and pay together.`;
+    if (callback) {
+      await callback({ text: text2 });
+    }
+    return {
+      text: text2,
+      success: false,
+      values: {
+        success: false,
+        error: err.code,
+        requestId: request2.id,
+        requiresConfirmation: true
+      },
+      data: {
+        actionName: "PERSONAL_ASSISTANT",
+        action: "book_travel",
+        error: err.code,
+        requestId: request2.id,
+        requiresConfirmation: true,
+        paymentRequired: {
+          asset: paymentRequired.asset,
+          network: paymentRequired.network,
+          amount: paymentRequired.amount
+        }
+      }
+    };
+  }
+  const queue = createApprovalQueue(runtime, { agentId: runtime.agentId });
+  const subjectUserId = typeof message.entityId === "string" ? message.entityId : String(runtime.agentId);
+  const request = await queue.enqueue({
+    requestedBy: "PERSONAL_ASSISTANT",
+    subjectUserId,
+    action: "book_travel",
+    payload: {
+      action: "book_travel",
+      ...prepared.payload
+    },
+    channel: "internal",
+    reason: `Book ${prepared.payload.summary ?? "travel itinerary"} after explicit approval`,
+    expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1e3)
+  });
+  const text = buildApprovalText(request);
+  if (callback) {
+    await callback({ text });
+  }
+  return {
+    text,
+    success: true,
+    values: {
+      success: true,
+      requestId: request.id,
+      state: request.state,
+      offerId: prepared.offer.id
+    },
+    data: {
+      actionName: "PERSONAL_ASSISTANT",
+      action: "book_travel",
+      requestId: request.id,
+      state: request.state,
+      offerId: prepared.offer.id,
+      totalAmount: prepared.offer.totalAmount,
+      totalCurrency: prepared.offer.totalCurrency,
+      orderType: prepared.orderType
+    }
+  };
+}
+async function executeApprovedBookTravel(args) {
+  if (args.request.payload.action !== "book_travel") {
+    throw new Error("executeApprovedBookTravel received a non-travel request");
+  }
+  const payload = args.request.payload;
+  if (payload.kind !== "flight") {
+    throw new Error(`Unsupported travel kind: ${payload.kind}`);
+  }
+  if (!payload.offerId && !payload.search) {
+    throw new Error("Approved travel booking is missing offer/search context");
+  }
+  const passengers = Array.isArray(payload.passengers) ? payload.passengers : [];
+  if (passengers.length === 0) {
+    throw new Error("Approved travel booking is missing passenger details");
+  }
+  await args.queue.markExecuting(args.request.id);
+  const service = new LifeOpsService(args.runtime);
+  const booked = await service.bookFlightItinerary(INTERNAL_URL, {
+    offerId: payload.offerId ?? null,
+    search: payload.search ?? null,
+    passengers,
+    calendarSync: payload.calendarSync ?? null
+  });
+  const done = await args.queue.markDone(args.request.id);
+  const route = payload.summary?.trim() || `${booked.offer.id}`;
+  const bookingReference = booked.order.bookingReference ? ` Booking reference: ${booked.order.bookingReference}.` : "";
+  const paymentText = booked.payment ? ` Payment ${booked.payment.id} captured for ${booked.payment.amount} ${booked.payment.currency}.` : "";
+  const calendarText = booked.calendarEvent ? ` Synced to calendar as "${booked.calendarEvent.title}".` : "";
+  const text = `Booked ${route}.${bookingReference}${paymentText}${calendarText}`.trim();
+  if (args.callback) {
+    await args.callback({ text });
+  }
+  return {
+    text,
+    success: true,
+    values: {
+      success: true,
+      requestId: done.id,
+      bookingReference: booked.order.bookingReference,
+      orderId: booked.order.id,
+      paymentId: booked.payment?.id ?? null,
+      calendarEventId: booked.calendarEvent?.id ?? null
+    },
+    data: {
+      actionName: "PERSONAL_ASSISTANT",
+      action: "book_travel",
+      requestId: done.id,
+      state: done.state,
+      bookingReference: booked.order.bookingReference,
+      orderId: booked.order.id,
+      paymentId: booked.payment?.id ?? null,
+      calendarEventId: booked.calendarEvent?.id ?? null,
+      offerId: booked.offer.id
+    }
+  };
+}
+export {
+  executeApprovedBookTravel,
+  runBookTravelHandler
+};
+//# sourceMappingURL=book-travel.js.map

package/dist/actions/book-travel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/book-travel.ts"],"sourcesContent":["import type {\n  ActionResult,\n  HandlerCallback,\n  HandlerOptions,\n  IAgentRuntime,\n  Memory,\n  State,\n} from \"@elizaos/core\";\nimport {\n  recentConversationTexts as collectRecentConversationTexts,\n  ModelType,\n  parseJsonModelRecord,\n  runWithTrajectoryContext,\n} from \"@elizaos/core\";\nimport {\n  PaymentRequiredError,\n  type X402PaymentRequirement,\n} from \"@elizaos/plugin-elizacloud/cloud/x402-payment-handler\";\nimport { INTERNAL_URL } from \"../lifeops/access.js\";\nimport { createApprovalQueue } from \"../lifeops/approval-queue.js\";\nimport type {\n  ApprovalQueue,\n  ApprovalRequest,\n} from \"../lifeops/approval-queue.types.js\";\nimport { requireFeatureEnabled } from \"../lifeops/feature-flags.js\";\nimport { FeatureNotEnabledError } from \"../lifeops/feature-flags.types.js\";\nimport { LifeOpsService } from \"../lifeops/service.js\";\nimport type {\n  TravelBookingPassenger,\n  TravelCalendarSyncPlan,\n} from \"../lifeops/travel-booking.types.js\";\n\ntype BookTravelPassengerInput = {\n  offerPassengerId?: string | null;\n  givenName?: string | null;\n  familyName?: string | null;\n  bornOn?: string | null;\n  email?: string | null;\n  phoneNumber?: string | null;\n  title?: string | null;\n  gender?: string | null;\n};\n\ntype BookTravelParameters = {\n  offerId?: string;\n  origin?: string;\n  destination?: string;\n  departureDate?: string;\n  returnDate?: string;\n  passengers?: BookTravelPassengerInput[];\n  passengerCount?: number;\n  calendarSync?: Partial<TravelCalendarSyncPlan> | null;\n};\n\ntype ExtractedBookTravelPlan = {\n  offerId: string | null;\n  origin: string | null;\n  destination: string | null;\n  departureDate: string | null;\n  returnDate: string | null;\n  passengerCount: number | null;\n  passengers: BookTravelPassengerInput[];\n  calendarSync: Partial<TravelCalendarSyncPlan> | null;\n};\n\nfunction trimToNull(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction normalizePassenger(\n  value: BookTravelPassengerInput,\n): TravelBookingPassenger | null {\n  const givenName = trimToNull(value.givenName);\n  const familyName = trimToNull(value.familyName);\n  const bornOn = trimToNull(value.bornOn);\n  if (!givenName || !familyName || !bornOn) {\n    return null;\n  }\n  return {\n    offerPassengerId: trimToNull(value.offerPassengerId),\n    givenName,\n    familyName,\n    bornOn,\n    email: trimToNull(value.email),\n    phoneNumber: trimToNull(value.phoneNumber),\n    title: trimToNull(value.title),\n    gender: trimToNull(value.gender),\n  };\n}\n\nfunction normalizePassengers(value: unknown): TravelBookingPassenger[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .map((passenger) =>\n      passenger && typeof passenger === \"object\"\n        ? normalizePassenger(passenger as BookTravelPassengerInput)\n        : null,\n    )\n    .filter(\n      (passenger): passenger is TravelBookingPassenger => passenger !== null,\n    );\n}\n\nfunction formatBookTravelPromptValue(value: unknown): string {\n  if (value === null || value === undefined) {\n    return \"null\";\n  }\n  if (typeof value === \"string\") {\n    return value;\n  }\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (Array.isArray(value)) {\n    if (value.length === 0) {\n      return \"none\";\n    }\n    return value\n      .map(\n        (entry, index) =>\n          `item ${index + 1}: ${formatBookTravelPromptValue(entry)}`,\n      )\n      .join(\"\\n\");\n  }\n  if (typeof value === \"object\") {\n    const entries = Object.entries(value as Record<string, unknown>);\n    if (entries.length === 0) {\n      return \"none\";\n    }\n    return entries\n      .map(([key, entry]) => `${key}: ${formatBookTravelPromptValue(entry)}`)\n      .join(\"\\n\");\n  }\n  return String(value);\n}\n\nfunction normalizeCalendarSync(value: unknown): TravelCalendarSyncPlan | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return null;\n  }\n  const record = value as Record<string, unknown>;\n  return {\n    enabled: record.enabled !== false,\n    calendarId: trimToNull(record.calendarId),\n    title: trimToNull(record.title),\n    description: trimToNull(record.description),\n    location: trimToNull(record.location),\n    timeZone: trimToNull(record.timeZone),\n  };\n}\n\nfunction mergePlans(\n  params: BookTravelParameters,\n  extracted: ExtractedBookTravelPlan,\n): {\n  offerId: string | null;\n  origin: string | null;\n  destination: string | null;\n  departureDate: string | null;\n  returnDate: string | null;\n  passengerCount: number | null;\n  passengers: TravelBookingPassenger[];\n  calendarSync: TravelCalendarSyncPlan | null;\n} {\n  const normalizedPassengers = normalizePassengers(params.passengers);\n  const extractedPassengers = normalizePassengers(extracted.passengers);\n  const passengers =\n    normalizedPassengers.length > 0\n      ? normalizedPassengers\n      : extractedPassengers;\n  return {\n    offerId: trimToNull(params.offerId) ?? extracted.offerId,\n    origin: trimToNull(params.origin) ?? extracted.origin,\n    destination: trimToNull(params.destination) ?? extracted.destination,\n    departureDate: trimToNull(params.departureDate) ?? extracted.departureDate,\n    returnDate: trimToNull(params.returnDate) ?? extracted.returnDate,\n    passengerCount:\n      typeof params.passengerCount === \"number\" && params.passengerCount > 0\n        ? Math.floor(params.passengerCount)\n        : extracted.passengerCount,\n    passengers,\n    calendarSync: normalizeCalendarSync(params.calendarSync) ??\n      normalizeCalendarSync(extracted.calendarSync) ?? {\n        enabled: true,\n        calendarId: \"primary\",\n        title: null,\n        description: null,\n        location: null,\n        timeZone: null,\n      },\n  };\n}\n\nfunction getParams(options: HandlerOptions | undefined): BookTravelParameters {\n  return ((options?.parameters as BookTravelParameters | undefined) ??\n    {}) as BookTravelParameters;\n}\n\nfunction messageText(message: Memory): string {\n  return typeof message.content.text === \"string\" ? message.content.text : \"\";\n}\n\nasync function extractBookTravelPlanWithLlm(args: {\n  runtime: IAgentRuntime;\n  message: Memory;\n  state: State | undefined;\n  params: BookTravelParameters;\n}): Promise<ExtractedBookTravelPlan> {\n  if (typeof args.runtime.useModel !== \"function\") {\n    return {\n      offerId: null,\n      origin: null,\n      destination: null,\n      departureDate: null,\n      returnDate: null,\n      passengerCount: null,\n      passengers: [],\n      calendarSync: null,\n    };\n  }\n\n  const recentConversation = (\n    await collectRecentConversationTexts({\n      runtime: args.runtime,\n      message: args.message,\n      state: args.state,\n      limit: 6,\n    })\n  ).join(\"\\n\");\n\n  const prompt = [\n    \"Extract structured booking data for PERSONAL_ASSISTANT action=book_travel.\",\n    \"Return JSON only as a single object with exactly these keys:\",\n    \"offerId: string or null\",\n    \"origin: IATA airport code or null\",\n    \"destination: IATA airport code or null\",\n    \"departureDate: YYYY-MM-DD or null\",\n    \"returnDate: YYYY-MM-DD or null\",\n    \"passengerCount: number or null\",\n    \"passengers: passenger records if known; each record may include offerPassengerId, givenName, familyName, bornOn, email, phoneNumber, title, gender\",\n    \"calendarSync: calendar sync object if known; may include enabled, calendarId, title, description, location, timeZone\",\n    'Example: {\"offerId\":null,\"origin\":\"SFO\",\"destination\":\"JFK\",\"departureDate\":\"2026-06-01\",\"returnDate\":null,\"passengerCount\":1,\"passengers\":[],\"calendarSync\":null}',\n    \"\",\n    \"Rules:\",\n    \"- Do not invent airports, dates, or passenger birthdays.\",\n    \"- Use offerId when the conversation already references a chosen offer.\",\n    \"- Use null for missing values.\",\n    \"- Passenger birthdays must stay in YYYY-MM-DD format when present.\",\n    \"\",\n    `User message:\\n${messageText(args.message)}`,\n    \"\",\n    `Current parameters:\\n${formatBookTravelPromptValue(args.params)}`,\n    \"\",\n    `Recent conversation:\\n${recentConversation}`,\n  ].join(\"\\n\");\n\n  let parsed: Record<string, unknown> | null = null;\n  try {\n    const raw = await runWithTrajectoryContext(\n      { purpose: \"lifeops-book-travel\" },\n      () => args.runtime.useModel(ModelType.TEXT_SMALL, { prompt }),\n    );\n    const rawText = typeof raw === \"string\" ? raw : \"\";\n    parsed = parseJsonModelRecord<Record<string, unknown>>(rawText);\n  } catch {\n    parsed = null;\n  }\n\n  return {\n    offerId: trimToNull(parsed?.offerId),\n    origin: trimToNull(parsed?.origin),\n    destination: trimToNull(parsed?.destination),\n    departureDate: trimToNull(parsed?.departureDate),\n    returnDate: trimToNull(parsed?.returnDate),\n    passengerCount:\n      typeof parsed?.passengerCount === \"number\" &&\n      Number.isFinite(parsed.passengerCount)\n        ? Math.max(1, Math.floor(parsed.passengerCount))\n        : null,\n    passengers: Array.isArray(parsed?.passengers)\n      ? (parsed.passengers as BookTravelPassengerInput[])\n      : [],\n    calendarSync:\n      parsed?.calendarSync && typeof parsed.calendarSync === \"object\"\n        ? (parsed.calendarSync as Partial<TravelCalendarSyncPlan>)\n        : null,\n  };\n}\n\nfunction listMissingPassengerFields(\n  passengers: TravelBookingPassenger[],\n): string[] {\n  if (passengers.length > 0) {\n    return [];\n  }\n  return [\n    \"passenger given name\",\n    \"passenger family name\",\n    \"passenger date of birth\",\n  ];\n}\n\nfunction buildMissingInfoText(missing: string[]): string {\n  return `I can queue the booking once I have ${missing.join(\", \")}.`;\n}\n\nfunction buildApprovalText(request: ApprovalRequest): string {\n  const payload =\n    request.payload.action === \"book_travel\" ? request.payload : null;\n  const route = payload?.summary?.trim() || \"this itinerary\";\n  const total =\n    typeof payload?.totalCents === \"number\" && payload.totalCents > 0\n      ? `${(payload.totalCents / 100).toFixed(2)} ${payload.currency}`\n      : (payload?.currency ?? \"the quoted total\");\n  const orderType =\n    payload?.orderType === \"hold\"\n      ? \"hold then pay\"\n      : payload?.orderType === \"instant\"\n        ? \"book immediately\"\n        : \"book\";\n  return `Queued travel approval for ${route}. Once you approve, I will ${orderType}, complete payment, and sync the itinerary to your calendar. Current quote: ${total}.`;\n}\n\n// Internal travel-booking handler. The travel surface is delegated to from the\n// registered PERSONAL_ASSISTANT umbrella in owner-surfaces.ts; this module no\n// longer publishes a planner-visible Action. Approval execution still lives\n// here as `executeApprovedBookTravel` and is invoked by RESOLVE_REQUEST.\nexport async function runBookTravelHandler(\n  runtime: IAgentRuntime,\n  message: Memory,\n  state: State | undefined,\n  options: unknown,\n  callback?: HandlerCallback,\n): Promise<ActionResult> {\n  try {\n    await requireFeatureEnabled(runtime, \"travel.book_flight\");\n  } catch (error) {\n    if (error instanceof FeatureNotEnabledError) {\n      const text = error.message;\n      if (callback) {\n        await callback({ text });\n      }\n      // FEATURE_NOT_ENABLED is a \"needs setup / confirmation\" terminal\n      // state — the action correctly identified what to do; the owner\n      // just needs to enable the feature (e.g. sign in to Eliza Cloud).\n      return {\n        text,\n        success: false,\n        values: {\n          success: false,\n          error: error.code,\n          featureKey: error.featureKey,\n          requiresConfirmation: true,\n        },\n        data: {\n          actionName: \"PERSONAL_ASSISTANT\",\n          action: \"book_travel\",\n          error: error.code,\n          featureKey: error.featureKey,\n          requiresConfirmation: true,\n        },\n      };\n    }\n    throw error;\n  }\n\n  const params = getParams(options as HandlerOptions | undefined);\n  const extracted = await extractBookTravelPlanWithLlm({\n    runtime,\n    message,\n    state,\n    params,\n  });\n  const merged = mergePlans(params, extracted);\n\n  const missing: string[] = [];\n  if (!merged.offerId) {\n    if (!merged.origin) {\n      missing.push(\"origin airport\");\n    }\n    if (!merged.destination) {\n      missing.push(\"destination airport\");\n    }\n    if (!merged.departureDate) {\n      missing.push(\"departure date\");\n    }\n  }\n  missing.push(...listMissingPassengerFields(merged.passengers));\n  if (missing.length > 0) {\n    const text = buildMissingInfoText(missing);\n    if (callback) {\n      await callback({ text });\n    }\n    // Selection + execution were correct: the user asked to book travel,\n    // the action ran, and we now need the user to fill in missing trip\n    // details. Mark as awaiting-confirmation so the native planner stops\n    // chaining and the benchmark scorer treats this as completed.\n    return {\n      text,\n      success: false,\n      values: {\n        success: false,\n        error: \"MISSING_BOOKING_DETAILS\",\n        requiresConfirmation: true,\n        missing,\n      },\n      data: {\n        actionName: \"PERSONAL_ASSISTANT\",\n        action: \"book_travel\",\n        error: \"MISSING_BOOKING_DETAILS\",\n        requiresConfirmation: true,\n        missing,\n      },\n    };\n  }\n\n  const service = new LifeOpsService(runtime);\n  let search: {\n    origin: string;\n    destination: string;\n    departureDate: string;\n    returnDate?: string;\n    passengers: number;\n  } | null = null;\n  if (!merged.offerId) {\n    const { origin, destination, departureDate } = merged;\n    if (!origin || !destination || !departureDate) {\n      throw new Error(\n        \"PERSONAL_ASSISTANT action=book_travel validated fields are unexpectedly missing\",\n      );\n    }\n    search = {\n      origin,\n      destination,\n      departureDate,\n      returnDate: merged.returnDate ?? undefined,\n      passengers: merged.passengerCount ?? merged.passengers.length,\n    };\n  }\n\n  let prepared: Awaited<ReturnType<typeof service.prepareFlightBooking>>;\n  try {\n    prepared = await service.prepareFlightBooking({\n      offerId: merged.offerId,\n      search,\n      passengers: merged.passengers,\n      calendarSync: merged.calendarSync,\n    });\n  } catch (err) {\n    if (\n      !(err instanceof PaymentRequiredError) ||\n      err.requirements.length === 0\n    ) {\n      throw err;\n    }\n    // Surface the x402 payment-required signal as part of the approval\n    // entry rather than a hard failure: the user sees the booking\n    // intent and the top-up prompt together and can approve once they\n    // have credit. We bail out here because we don't have a quoted\n    // offer yet — the next book_travel invocation after top-up will\n    // re-quote.\n    const paymentRequired: X402PaymentRequirement = err.requirements[0];\n    const queue = createApprovalQueue(runtime, { agentId: runtime.agentId });\n    const subjectUserId =\n      typeof message.entityId === \"string\"\n        ? message.entityId\n        : String(runtime.agentId);\n    const request = await queue.enqueue({\n      requestedBy: \"PERSONAL_ASSISTANT\",\n      subjectUserId,\n      action: \"book_travel\",\n      payload: {\n        action: \"book_travel\",\n        kind: \"flight\",\n        provider: \"duffel\",\n        itineraryRef: merged.offerId ?? \"pending-quote\",\n        totalCents: 0,\n        currency: \"USD\",\n        offerId: merged.offerId,\n        summary: merged.offerId\n          ? `Booking for offer ${merged.offerId}`\n          : `${merged.origin ?? \"?\"} → ${merged.destination ?? \"?\"}`,\n        cost: null,\n        paymentRequired: {\n          amount: paymentRequired.amount,\n          asset: paymentRequired.asset,\n          network: paymentRequired.network,\n          payTo: paymentRequired.payTo,\n          scheme: paymentRequired.scheme,\n          expiresAt: paymentRequired.expiresAt,\n          description: paymentRequired.description,\n        },\n      },\n      channel: \"internal\",\n      reason: `Top up ${paymentRequired.amount} ${paymentRequired.asset} on ${paymentRequired.network} to book travel`,\n      expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000),\n    });\n    const text = `Eliza Cloud needs a top-up before I can quote this trip: ${paymentRequired.amount} ${paymentRequired.asset} on ${paymentRequired.network}. I queued it for approval so you can review and pay together.`;\n    if (callback) {\n      await callback({ text });\n    }\n    return {\n      text,\n      success: false,\n      values: {\n        success: false,\n        error: err.code,\n        requestId: request.id,\n        requiresConfirmation: true,\n      },\n      data: {\n        actionName: \"PERSONAL_ASSISTANT\",\n        action: \"book_travel\",\n        error: err.code,\n        requestId: request.id,\n        requiresConfirmation: true,\n        paymentRequired: {\n          asset: paymentRequired.asset,\n          network: paymentRequired.network,\n          amount: paymentRequired.amount,\n        },\n      },\n    };\n  }\n\n  const queue = createApprovalQueue(runtime, { agentId: runtime.agentId });\n  const subjectUserId =\n    typeof message.entityId === \"string\"\n      ? message.entityId\n      : String(runtime.agentId);\n  const request = await queue.enqueue({\n    requestedBy: \"PERSONAL_ASSISTANT\",\n    subjectUserId,\n    action: \"book_travel\",\n    payload: {\n      action: \"book_travel\",\n      ...prepared.payload,\n    },\n    channel: \"internal\",\n    reason: `Book ${prepared.payload.summary ?? \"travel itinerary\"} after explicit approval`,\n    expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000),\n  });\n\n  const text = buildApprovalText(request);\n  if (callback) {\n    await callback({ text });\n  }\n\n  return {\n    text,\n    success: true,\n    values: {\n      success: true,\n      requestId: request.id,\n      state: request.state,\n      offerId: prepared.offer.id,\n    },\n    data: {\n      actionName: \"PERSONAL_ASSISTANT\",\n      action: \"book_travel\",\n      requestId: request.id,\n      state: request.state,\n      offerId: prepared.offer.id,\n      totalAmount: prepared.offer.totalAmount,\n      totalCurrency: prepared.offer.totalCurrency,\n      orderType: prepared.orderType,\n    },\n  };\n}\n\n// Callback invoked by the approval queue once an owner approves a queued\n// book_travel request. The resolve-request action dispatches here after\n// a request transitions from pending -> approved.\nexport async function executeApprovedBookTravel(args: {\n  runtime: IAgentRuntime;\n  queue: ApprovalQueue;\n  request: ApprovalRequest;\n  callback?: HandlerCallback;\n}): Promise<ActionResult> {\n  if (args.request.payload.action !== \"book_travel\") {\n    throw new Error(\"executeApprovedBookTravel received a non-travel request\");\n  }\n  const payload = args.request.payload;\n  if (payload.kind !== \"flight\") {\n    throw new Error(`Unsupported travel kind: ${payload.kind}`);\n  }\n  if (!payload.offerId && !payload.search) {\n    throw new Error(\"Approved travel booking is missing offer/search context\");\n  }\n  const passengers = Array.isArray(payload.passengers)\n    ? payload.passengers\n    : [];\n  if (passengers.length === 0) {\n    throw new Error(\"Approved travel booking is missing passenger details\");\n  }\n\n  await args.queue.markExecuting(args.request.id);\n  const service = new LifeOpsService(args.runtime);\n  const booked = await service.bookFlightItinerary(INTERNAL_URL, {\n    offerId: payload.offerId ?? null,\n    search: payload.search ?? null,\n    passengers,\n    calendarSync: payload.calendarSync ?? null,\n  });\n  const done = await args.queue.markDone(args.request.id);\n\n  const route = payload.summary?.trim() || `${booked.offer.id}`;\n  const bookingReference = booked.order.bookingReference\n    ? ` Booking reference: ${booked.order.bookingReference}.`\n    : \"\";\n  const paymentText = booked.payment\n    ? ` Payment ${booked.payment.id} captured for ${booked.payment.amount} ${booked.payment.currency}.`\n    : \"\";\n  const calendarText = booked.calendarEvent\n    ? ` Synced to calendar as \"${booked.calendarEvent.title}\".`\n    : \"\";\n  const text =\n    `Booked ${route}.${bookingReference}${paymentText}${calendarText}`.trim();\n\n  if (args.callback) {\n    await args.callback({ text });\n  }\n\n  return {\n    text,\n    success: true,\n    values: {\n      success: true,\n      requestId: done.id,\n      bookingReference: booked.order.bookingReference,\n      orderId: booked.order.id,\n      paymentId: booked.payment?.id ?? null,\n      calendarEventId: booked.calendarEvent?.id ?? null,\n    },\n    data: {\n      actionName: \"PERSONAL_ASSISTANT\",\n      action: \"book_travel\",\n      requestId: done.id,\n      state: done.state,\n      bookingReference: booked.order.bookingReference,\n      orderId: booked.order.id,\n      paymentId: booked.payment?.id ?? null,\n      calendarEventId: booked.calendarEvent?.id ?? null,\n      offerId: booked.offer.id,\n    },\n  };\n}\n"],"mappings":"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","names":["text","queue","subjectUserId","request"]}

package/dist/actions/brief.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `BRIEF` umbrella action — Daily Operations / morning-evening-weekly synthesis.
+ *
+ * Subactions:
+ *   - `compose_morning`  — `period: today` by default
+ *   - `compose_evening`  — `period: today` by default
+ *   - `compose_weekly`   — `period: this_week` by default
+ *
+ * Pulls from each domain (calendar feed, inbox triage, life-domain due items,
+ * money recurring charges) per the `include` arg, then runs a single LLM
+ * compose pass to render a narrative over the structured `LifeOpsBriefing`
+ * shape. Briefings are kept in-memory.
+ *
+ * Owner-only — `hasLifeOpsAccess` (which delegates to `hasOwnerAccess`).
+ */
+import type { Action, IAgentRuntime } from "@elizaos/core";
+import type { LifeOpsBriefingCalendarItem, LifeOpsBriefingInboxItem, LifeOpsBriefingKind, LifeOpsBriefingLifeItem, LifeOpsBriefingMoneyItem, LifeOpsBriefingPeriod, LifeOpsBriefingSections } from "../types/briefing.js";
+export { BRIEF_NARRATIVE_INSTRUCTIONS, MEETING_PREP_INSTRUCTIONS, } from "../lifeops/optimized-prompt-instructions.js";
+type BriefOptimizationTask = "morning_brief" | "meeting_prep";
+/**
+ * Composer hooks — overridable for tests. Defaults compose from LifeOps'
+ * structural services: calendar feed, MESSAGE triage, overview reminders, and
+ * recurring payments. Unavailable sources degrade to empty arrays.
+ */
+export interface BriefComposers {
+    loadCalendar: (args: {
+        runtime: IAgentRuntime;
+        period: LifeOpsBriefingPeriod;
+    }) => Promise<readonly LifeOpsBriefingCalendarItem[]>;
+    loadInbox: (args: {
+        runtime: IAgentRuntime;
+        period: LifeOpsBriefingPeriod;
+    }) => Promise<readonly LifeOpsBriefingInboxItem[]>;
+    loadLife: (args: {
+        runtime: IAgentRuntime;
+        period: LifeOpsBriefingPeriod;
+    }) => Promise<readonly LifeOpsBriefingLifeItem[]>;
+    loadMoney: (args: {
+        runtime: IAgentRuntime;
+        period: LifeOpsBriefingPeriod;
+    }) => Promise<readonly LifeOpsBriefingMoneyItem[]>;
+}
+/**
+ * Override the briefing composers. Service-backed loaders can be injected
+ * here at plugin init. Test-only callers reset between cases with
+ * `__resetBriefComposersForTests`.
+ */
+export declare function setBriefComposers(next: Partial<BriefComposers>): void;
+export declare function __resetBriefComposersForTests(): void;
+export declare function buildNarrativePrompt(args: {
+    kind: LifeOpsBriefingKind;
+    period: LifeOpsBriefingPeriod;
+    sections: LifeOpsBriefingSections;
+    runtime?: IAgentRuntime;
+    optimizationTask?: BriefOptimizationTask;
+}): string;
+export declare const briefAction: Action & {
+    suppressPostActionContinuation?: boolean;
+};
+//# sourceMappingURL=brief.d.ts.map

package/dist/actions/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../src/actions/brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,MAAM,EAKN,aAAa,EAGd,MAAM,eAAe,CAAC;AAcvB,OAAO,KAAK,EAEV,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,6CAA6C,CAAC;AAWrD,KAAK,qBAAqB,GAAG,eAAe,GAAG,cAAc,CAAC;AAsR9D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,aAAa,CAAC;QACvB,MAAM,EAAE,qBAAqB,CAAC;KAC/B,KAAK,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAAC;IACtD,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,aAAa,CAAC;QACvB,MAAM,EAAE,qBAAqB,CAAC;KAC/B,KAAK,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,IAAI,EAAE;QACf,OAAO,EAAE,aAAa,CAAC;QACvB,MAAM,EAAE,qBAAqB,CAAC;KAC/B,KAAK,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,aAAa,CAAC;QACvB,MAAM,EAAE,qBAAqB,CAAC;KAC/B,KAAK,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC,CAAC;CACpD;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAErE;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAgGD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C,GAAG,MAAM,CAiCT;AAyHD,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IACjC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAiH1C,CAAC"}