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

package/dist/lifeops/approval-queue.types.d.ts

@@ -0,0 +1,172 @@
+import type { TravelBookingPayloadFields } from "./travel-booking.types.js";
+export type ApprovalRequestState = "pending" | "approved" | "executing" | "done" | "rejected" | "expired";
+export type ApprovalAction = "send_message" | "send_email" | "schedule_event" | "modify_event" | "cancel_event" | "book_travel" | "make_call" | "sign_document" | "execute_workflow" | "spend_money";
+export type ApprovalChannel = "telegram" | "discord" | "slack" | "imessage" | "sms" | "x_dm" | "email" | "google_calendar" | "browser" | "phone" | "internal";
+export type ApprovalPayload = {
+    action: "send_message";
+    recipient: string;
+    body: string;
+    replyToMessageId: string | null;
+} | {
+    action: "send_email";
+    to: ReadonlyArray<string>;
+    cc: ReadonlyArray<string>;
+    bcc: ReadonlyArray<string>;
+    subject: string;
+    body: string;
+    threadId: string | null;
+    replyToMessageId?: string | null;
+} | {
+    action: "schedule_event";
+    calendarId: string;
+    title: string;
+    startsAtMs: number;
+    endsAtMs: number;
+    attendees: ReadonlyArray<string>;
+    location: string | null;
+    description: string | null;
+} | {
+    action: "modify_event";
+    calendarId: string;
+    eventId: string;
+    patch: {
+        title: string | null;
+        startsAtMs: number | null;
+        endsAtMs: number | null;
+        attendees: ReadonlyArray<string> | null;
+        location: string | null;
+        description: string | null;
+    };
+} | {
+    action: "cancel_event";
+    calendarId: string;
+    eventId: string;
+    notifyAttendees: boolean;
+} | {
+    action: "book_travel";
+    kind: TravelBookingPayloadFields["kind"];
+    provider: string;
+    itineraryRef: string;
+    totalCents: number;
+    currency: string;
+    offerId?: string | null;
+    offerRequestId?: string | null;
+    orderType?: "hold" | "instant" | null;
+    search?: TravelBookingPayloadFields["search"];
+    passengers?: TravelBookingPayloadFields["passengers"];
+    calendarSync?: TravelBookingPayloadFields["calendarSync"];
+    summary?: string | null;
+    /** Server-side cost breakdown surfaced to the user alongside any
+     *  payment-required prompt. Mirrors `DuffelCallCost`; held as a
+     *  loose record here so the approval-queue type doesn't have to
+     *  depend on the travel-adapter package. */
+    cost?: {
+        readonly totalUsd: number;
+        readonly creatorMarkupUsd: number;
+        readonly platformFeeUsd: number;
+        readonly markupPercent: number | null;
+    } | null;
+    /** Set when an x402 PaymentRequiredError fired before the booking
+     *  could be quoted. The user sees both the booking intent and the
+     *  top-up prompt in a single approval entry. */
+    paymentRequired?: {
+        readonly amount: string;
+        readonly asset: string;
+        readonly network: string;
+        readonly payTo: string;
+        readonly scheme: string;
+        readonly expiresAt: string | null;
+        readonly description: string | null;
+    } | null;
+} | {
+    action: "make_call";
+    to: string;
+    script: string;
+    maxDurationSeconds: number;
+} | {
+    action: "sign_document";
+    documentId: string;
+    documentName: string;
+    signatureUrl: string;
+    deadline: string;
+} | {
+    action: "execute_workflow";
+    workflowId: string;
+    input: Readonly<Record<string, string | number | boolean>>;
+} | {
+    action: "spend_money";
+    vendor: string;
+    amountCents: number;
+    currency: string;
+    memo: string;
+};
+/** Persisted approval request. */
+export interface ApprovalRequest {
+    readonly id: string;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    readonly state: ApprovalRequestState;
+    readonly requestedBy: string;
+    readonly subjectUserId: string;
+    readonly action: ApprovalAction;
+    readonly payload: ApprovalPayload;
+    readonly channel: ApprovalChannel;
+    readonly reason: string;
+    readonly expiresAt: Date;
+    readonly resolvedAt: Date | null;
+    readonly resolvedBy: string | null;
+    readonly resolutionReason: string | null;
+}
+/** Input to `enqueue` — server fills in id, timestamps, and initial state. */
+export interface ApprovalEnqueueInput {
+    readonly requestedBy: string;
+    readonly subjectUserId: string;
+    readonly action: ApprovalAction;
+    readonly payload: ApprovalPayload;
+    readonly channel: ApprovalChannel;
+    readonly reason: string;
+    readonly expiresAt: Date;
+}
+/** Filter for `list`. All fields combine with AND. */
+export interface ApprovalListFilter {
+    readonly subjectUserId: string | null;
+    readonly state: ApprovalRequestState | null;
+    readonly action: ApprovalAction | null;
+    readonly limit: number;
+}
+/** Resolution input for `approve` / `reject`. */
+export interface ApprovalResolution {
+    readonly resolvedBy: string;
+    readonly resolutionReason: string;
+}
+/** Thrown when a state transition is invalid. */
+export declare class ApprovalStateTransitionError extends Error {
+    readonly requestId: string;
+    readonly from: ApprovalRequestState;
+    readonly to: ApprovalRequestState;
+    constructor(requestId: string, from: ApprovalRequestState, to: ApprovalRequestState);
+}
+/** Thrown when an operation references an unknown request id. */
+export declare class ApprovalNotFoundError extends Error {
+    readonly requestId: string;
+    constructor(requestId: string);
+}
+/**
+ * Queue interface. Implementations must:
+ *  - Reject invalid state transitions by throwing `ApprovalStateTransitionError`.
+ *  - Reject unknown ids by throwing `ApprovalNotFoundError`.
+ *  - Use the structured logger only (no `console.*`).
+ *  - Treat `purgeExpired` as idempotent.
+ */
+export interface ApprovalQueue {
+    enqueue(input: ApprovalEnqueueInput): Promise<ApprovalRequest>;
+    list(filter: ApprovalListFilter): Promise<ReadonlyArray<ApprovalRequest>>;
+    byId(id: string): Promise<ApprovalRequest | null>;
+    approve(id: string, resolution: ApprovalResolution): Promise<ApprovalRequest>;
+    reject(id: string, resolution: ApprovalResolution): Promise<ApprovalRequest>;
+    markExecuting(id: string): Promise<ApprovalRequest>;
+    markDone(id: string): Promise<ApprovalRequest>;
+    markExpired(id: string): Promise<ApprovalRequest>;
+    purgeExpired(now: Date): Promise<ReadonlyArray<string>>;
+}
+//# sourceMappingURL=approval-queue.types.d.ts.map

package/dist/lifeops/approval-queue.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-queue.types.d.ts","sourceRoot":"","sources":["../../src/lifeops/approval-queue.types.ts"],"names":[],"mappings":"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"}

package/dist/lifeops/approval-queue.types.js

@@ -0,0 +1,27 @@
+class ApprovalStateTransitionError extends Error {
+  requestId;
+  from;
+  to;
+  constructor(requestId, from, to) {
+    super(
+      `[ApprovalQueue] invalid transition for request ${requestId}: ${from} -> ${to}`
+    );
+    this.name = "ApprovalStateTransitionError";
+    this.requestId = requestId;
+    this.from = from;
+    this.to = to;
+  }
+}
+class ApprovalNotFoundError extends Error {
+  requestId;
+  constructor(requestId) {
+    super(`[ApprovalQueue] request not found: ${requestId}`);
+    this.name = "ApprovalNotFoundError";
+    this.requestId = requestId;
+  }
+}
+export {
+  ApprovalNotFoundError,
+  ApprovalStateTransitionError
+};
+//# sourceMappingURL=approval-queue.types.js.map

package/dist/lifeops/approval-queue.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/approval-queue.types.ts"],"sourcesContent":["import type { TravelBookingPayloadFields } from \"./travel-booking.types.js\";\n\nexport type ApprovalRequestState =\n  | \"pending\"\n  | \"approved\"\n  | \"executing\"\n  | \"done\"\n  | \"rejected\"\n  | \"expired\";\n\nexport type ApprovalAction =\n  | \"send_message\"\n  | \"send_email\"\n  | \"schedule_event\"\n  | \"modify_event\"\n  | \"cancel_event\"\n  | \"book_travel\"\n  | \"make_call\"\n  | \"sign_document\"\n  | \"execute_workflow\"\n  | \"spend_money\";\n\nexport type ApprovalChannel =\n  | \"telegram\"\n  | \"discord\"\n  | \"slack\"\n  | \"imessage\"\n  | \"sms\"\n  | \"x_dm\"\n  | \"email\"\n  | \"google_calendar\"\n  | \"browser\"\n  | \"phone\"\n  | \"internal\";\n\nexport type ApprovalPayload =\n  | {\n      action: \"send_message\";\n      recipient: string;\n      body: string;\n      replyToMessageId: string | null;\n    }\n  | {\n      action: \"send_email\";\n      to: ReadonlyArray<string>;\n      cc: ReadonlyArray<string>;\n      bcc: ReadonlyArray<string>;\n      subject: string;\n      body: string;\n      threadId: string | null;\n      replyToMessageId?: string | null;\n    }\n  | {\n      action: \"schedule_event\";\n      calendarId: string;\n      title: string;\n      startsAtMs: number;\n      endsAtMs: number;\n      attendees: ReadonlyArray<string>;\n      location: string | null;\n      description: string | null;\n    }\n  | {\n      action: \"modify_event\";\n      calendarId: string;\n      eventId: string;\n      patch: {\n        title: string | null;\n        startsAtMs: number | null;\n        endsAtMs: number | null;\n        attendees: ReadonlyArray<string> | null;\n        location: string | null;\n        description: string | null;\n      };\n    }\n  | {\n      action: \"cancel_event\";\n      calendarId: string;\n      eventId: string;\n      notifyAttendees: boolean;\n    }\n  | {\n      action: \"book_travel\";\n      kind: TravelBookingPayloadFields[\"kind\"];\n      provider: string;\n      itineraryRef: string;\n      totalCents: number;\n      currency: string;\n      offerId?: string | null;\n      offerRequestId?: string | null;\n      orderType?: \"hold\" | \"instant\" | null;\n      search?: TravelBookingPayloadFields[\"search\"];\n      passengers?: TravelBookingPayloadFields[\"passengers\"];\n      calendarSync?: TravelBookingPayloadFields[\"calendarSync\"];\n      summary?: string | null;\n      /** Server-side cost breakdown surfaced to the user alongside any\n       *  payment-required prompt. Mirrors `DuffelCallCost`; held as a\n       *  loose record here so the approval-queue type doesn't have to\n       *  depend on the travel-adapter package. */\n      cost?: {\n        readonly totalUsd: number;\n        readonly creatorMarkupUsd: number;\n        readonly platformFeeUsd: number;\n        readonly markupPercent: number | null;\n      } | null;\n      /** Set when an x402 PaymentRequiredError fired before the booking\n       *  could be quoted. The user sees both the booking intent and the\n       *  top-up prompt in a single approval entry. */\n      paymentRequired?: {\n        readonly amount: string;\n        readonly asset: string;\n        readonly network: string;\n        readonly payTo: string;\n        readonly scheme: string;\n        readonly expiresAt: string | null;\n        readonly description: string | null;\n      } | null;\n    }\n  | {\n      action: \"make_call\";\n      to: string;\n      script: string;\n      maxDurationSeconds: number;\n    }\n  | {\n      action: \"sign_document\";\n      documentId: string;\n      documentName: string;\n      signatureUrl: string;\n      deadline: string;\n    }\n  | {\n      action: \"execute_workflow\";\n      workflowId: string;\n      input: Readonly<Record<string, string | number | boolean>>;\n    }\n  | {\n      action: \"spend_money\";\n      vendor: string;\n      amountCents: number;\n      currency: string;\n      memo: string;\n    };\n\n/** Persisted approval request. */\nexport interface ApprovalRequest {\n  readonly id: string;\n  readonly createdAt: Date;\n  readonly updatedAt: Date;\n  readonly state: ApprovalRequestState;\n  readonly requestedBy: string;\n  readonly subjectUserId: string;\n  readonly action: ApprovalAction;\n  readonly payload: ApprovalPayload;\n  readonly channel: ApprovalChannel;\n  readonly reason: string;\n  readonly expiresAt: Date;\n  readonly resolvedAt: Date | null;\n  readonly resolvedBy: string | null;\n  readonly resolutionReason: string | null;\n}\n\n/** Input to `enqueue` — server fills in id, timestamps, and initial state. */\nexport interface ApprovalEnqueueInput {\n  readonly requestedBy: string;\n  readonly subjectUserId: string;\n  readonly action: ApprovalAction;\n  readonly payload: ApprovalPayload;\n  readonly channel: ApprovalChannel;\n  readonly reason: string;\n  readonly expiresAt: Date;\n}\n\n/** Filter for `list`. All fields combine with AND. */\nexport interface ApprovalListFilter {\n  readonly subjectUserId: string | null;\n  readonly state: ApprovalRequestState | null;\n  readonly action: ApprovalAction | null;\n  readonly limit: number;\n}\n\n/** Resolution input for `approve` / `reject`. */\nexport interface ApprovalResolution {\n  readonly resolvedBy: string;\n  readonly resolutionReason: string;\n}\n\n/** Thrown when a state transition is invalid. */\nexport class ApprovalStateTransitionError extends Error {\n  public readonly requestId: string;\n  public readonly from: ApprovalRequestState;\n  public readonly to: ApprovalRequestState;\n\n  constructor(\n    requestId: string,\n    from: ApprovalRequestState,\n    to: ApprovalRequestState,\n  ) {\n    super(\n      `[ApprovalQueue] invalid transition for request ${requestId}: ${from} -> ${to}`,\n    );\n    this.name = \"ApprovalStateTransitionError\";\n    this.requestId = requestId;\n    this.from = from;\n    this.to = to;\n  }\n}\n\n/** Thrown when an operation references an unknown request id. */\nexport class ApprovalNotFoundError extends Error {\n  public readonly requestId: string;\n\n  constructor(requestId: string) {\n    super(`[ApprovalQueue] request not found: ${requestId}`);\n    this.name = \"ApprovalNotFoundError\";\n    this.requestId = requestId;\n  }\n}\n\n/**\n * Queue interface. Implementations must:\n *  - Reject invalid state transitions by throwing `ApprovalStateTransitionError`.\n *  - Reject unknown ids by throwing `ApprovalNotFoundError`.\n *  - Use the structured logger only (no `console.*`).\n *  - Treat `purgeExpired` as idempotent.\n */\nexport interface ApprovalQueue {\n  enqueue(input: ApprovalEnqueueInput): Promise<ApprovalRequest>;\n  list(filter: ApprovalListFilter): Promise<ReadonlyArray<ApprovalRequest>>;\n  byId(id: string): Promise<ApprovalRequest | null>;\n  approve(id: string, resolution: ApprovalResolution): Promise<ApprovalRequest>;\n  reject(id: string, resolution: ApprovalResolution): Promise<ApprovalRequest>;\n  markExecuting(id: string): Promise<ApprovalRequest>;\n  markDone(id: string): Promise<ApprovalRequest>;\n  markExpired(id: string): Promise<ApprovalRequest>;\n  purgeExpired(now: Date): Promise<ReadonlyArray<string>>;\n}\n"],"mappings":"AA4LO,MAAM,qCAAqC,MAAM;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YACE,WACA,MACA,IACA;AACA;AAAA,MACE,kDAAkD,SAAS,KAAK,IAAI,OAAO,EAAE;AAAA,IAC/E;AACA,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,SAAK,OAAO;AACZ,SAAK,KAAK;AAAA,EACZ;AACF;AAGO,MAAM,8BAA8B,MAAM;AAAA,EAC/B;AAAA,EAEhB,YAAY,WAAmB;AAC7B,UAAM,sCAAsC,SAAS,EAAE;AACvD,SAAK,OAAO;AACZ,SAAK,YAAY;AAAA,EACnB;AACF;","names":[]}

package/dist/lifeops/autofill-whitelist.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agent-side autofill refusal list. This is the first gate before a request is
+ * sent to the browser companion, so unsafe domains are rejected even if the
+ * companion is unreachable.
+ *
+ * The default brand domains live in
+ * `src/default-packs/autofill-whitelist-pack.ts`. This module re-exports them
+ * as `DEFAULT_AUTOFILL_WHITELIST` so callers don't need to know about the pack
+ * — adding a default domain is a literal-edit in the pack file.
+ */
+export declare const DEFAULT_AUTOFILL_WHITELIST: readonly string[];
+export declare function extractRegistrableDomain(input: string): string | null;
+export declare function normalizeAutofillDomain(input: string): string | null;
+export interface WhitelistCheckResult {
+    readonly allowed: boolean;
+    readonly registrableDomain: string | null;
+    readonly matched: string | null;
+}
+export declare function isUrlWhitelisted(url: string, domains: readonly string[]): WhitelistCheckResult;
+//# sourceMappingURL=autofill-whitelist.d.ts.map

package/dist/lifeops/autofill-whitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofill-whitelist.d.ts","sourceRoot":"","sources":["../../src/lifeops/autofill-whitelist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EACzB,CAAC;AAEhC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBrE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,oBAAoB,CAuBtB"}

package/dist/lifeops/autofill-whitelist.js

@@ -0,0 +1,59 @@
+import { getDefaultAutofillWhitelist } from "../default-packs/autofill-whitelist-pack.js";
+const DEFAULT_AUTOFILL_WHITELIST = getDefaultAutofillWhitelist();
+function extractRegistrableDomain(input) {
+  if (typeof input !== "string") return null;
+  const trimmed = input.trim();
+  if (trimmed.length === 0) return null;
+  let host;
+  if (/^[a-z]+:\/\//i.test(trimmed)) {
+    try {
+      host = new URL(trimmed).hostname;
+    } catch {
+      return null;
+    }
+  } else {
+    host = trimmed.replace(/^\/+/, "").split("/")[0] ?? "";
+  }
+  host = host.toLowerCase().replace(/\.$/, "");
+  if (host.length === 0) return null;
+  if (host === "localhost") return null;
+  if (/^\d+\.\d+\.\d+\.\d+$/.test(host)) return null;
+  if (host.startsWith("[") && host.endsWith("]")) return null;
+  const labels = host.split(".").filter((l) => l.length > 0);
+  if (labels.length < 2) return null;
+  return labels.slice(-2).join(".");
+}
+function normalizeAutofillDomain(input) {
+  return extractRegistrableDomain(input);
+}
+function isUrlWhitelisted(url, domains) {
+  const registrable = extractRegistrableDomain(url);
+  if (registrable === null) {
+    return { allowed: false, registrableDomain: null, matched: null };
+  }
+  let host = registrable;
+  if (/^[a-z]+:\/\//i.test(url)) {
+    try {
+      host = new URL(url).hostname.toLowerCase().replace(/\.$/, "");
+    } catch {
+      return { allowed: false, registrableDomain: null, matched: null };
+    }
+  } else {
+    host = url.trim().toLowerCase().split("/")[0] ?? registrable;
+  }
+  for (const raw of domains) {
+    const entry = normalizeAutofillDomain(raw);
+    if (!entry) continue;
+    if (host === entry || host.endsWith(`.${entry}`)) {
+      return { allowed: true, registrableDomain: registrable, matched: entry };
+    }
+  }
+  return { allowed: false, registrableDomain: registrable, matched: null };
+}
+export {
+  DEFAULT_AUTOFILL_WHITELIST,
+  extractRegistrableDomain,
+  isUrlWhitelisted,
+  normalizeAutofillDomain
+};
+//# sourceMappingURL=autofill-whitelist.js.map

package/dist/lifeops/autofill-whitelist.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/autofill-whitelist.ts"],"sourcesContent":["/**\n * Agent-side autofill refusal list. This is the first gate before a request is\n * sent to the browser companion, so unsafe domains are rejected even if the\n * companion is unreachable.\n *\n * The default brand domains live in\n * `src/default-packs/autofill-whitelist-pack.ts`. This module re-exports them\n * as `DEFAULT_AUTOFILL_WHITELIST` so callers don't need to know about the pack\n * — adding a default domain is a literal-edit in the pack file.\n */\n\nimport { getDefaultAutofillWhitelist } from \"../default-packs/autofill-whitelist-pack.js\";\n\nexport const DEFAULT_AUTOFILL_WHITELIST: readonly string[] =\n  getDefaultAutofillWhitelist();\n\nexport function extractRegistrableDomain(input: string): string | null {\n  if (typeof input !== \"string\") return null;\n  const trimmed = input.trim();\n  if (trimmed.length === 0) return null;\n  let host: string;\n  if (/^[a-z]+:\\/\\//i.test(trimmed)) {\n    try {\n      host = new URL(trimmed).hostname;\n    } catch {\n      return null;\n    }\n  } else {\n    host = trimmed.replace(/^\\/+/, \"\").split(\"/\")[0] ?? \"\";\n  }\n  host = host.toLowerCase().replace(/\\.$/, \"\");\n  if (host.length === 0) return null;\n  if (host === \"localhost\") return null;\n  if (/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(host)) return null;\n  if (host.startsWith(\"[\") && host.endsWith(\"]\")) return null;\n  const labels = host.split(\".\").filter((l) => l.length > 0);\n  if (labels.length < 2) return null;\n  return labels.slice(-2).join(\".\");\n}\n\nexport function normalizeAutofillDomain(input: string): string | null {\n  return extractRegistrableDomain(input);\n}\n\nexport interface WhitelistCheckResult {\n  readonly allowed: boolean;\n  readonly registrableDomain: string | null;\n  readonly matched: string | null;\n}\n\nexport function isUrlWhitelisted(\n  url: string,\n  domains: readonly string[],\n): WhitelistCheckResult {\n  const registrable = extractRegistrableDomain(url);\n  if (registrable === null) {\n    return { allowed: false, registrableDomain: null, matched: null };\n  }\n  let host: string = registrable;\n  if (/^[a-z]+:\\/\\//i.test(url)) {\n    try {\n      host = new URL(url).hostname.toLowerCase().replace(/\\.$/, \"\");\n    } catch {\n      return { allowed: false, registrableDomain: null, matched: null };\n    }\n  } else {\n    host = url.trim().toLowerCase().split(\"/\")[0] ?? registrable;\n  }\n  for (const raw of domains) {\n    const entry = normalizeAutofillDomain(raw);\n    if (!entry) continue;\n    if (host === entry || host.endsWith(`.${entry}`)) {\n      return { allowed: true, registrableDomain: registrable, matched: entry };\n    }\n  }\n  return { allowed: false, registrableDomain: registrable, matched: null };\n}\n"],"mappings":"AAWA,SAAS,mCAAmC;AAErC,MAAM,6BACX,4BAA4B;AAEvB,SAAS,yBAAyB,OAA8B;AACrE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAI;AACJ,MAAI,gBAAgB,KAAK,OAAO,GAAG;AACjC,QAAI;AACF,aAAO,IAAI,IAAI,OAAO,EAAE;AAAA,IAC1B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,OAAO;AACL,WAAO,QAAQ,QAAQ,QAAQ,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK;AAAA,EACtD;AACA,SAAO,KAAK,YAAY,EAAE,QAAQ,OAAO,EAAE;AAC3C,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,uBAAuB,KAAK,IAAI,EAAG,QAAO;AAC9C,MAAI,KAAK,WAAW,GAAG,KAAK,KAAK,SAAS,GAAG,EAAG,QAAO;AACvD,QAAM,SAAS,KAAK,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;AACzD,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,SAAO,OAAO,MAAM,EAAE,EAAE,KAAK,GAAG;AAClC;AAEO,SAAS,wBAAwB,OAA8B;AACpE,SAAO,yBAAyB,KAAK;AACvC;AAQO,SAAS,iBACd,KACA,SACsB;AACtB,QAAM,cAAc,yBAAyB,GAAG;AAChD,MAAI,gBAAgB,MAAM;AACxB,WAAO,EAAE,SAAS,OAAO,mBAAmB,MAAM,SAAS,KAAK;AAAA,EAClE;AACA,MAAI,OAAe;AACnB,MAAI,gBAAgB,KAAK,GAAG,GAAG;AAC7B,QAAI;AACF,aAAO,IAAI,IAAI,GAAG,EAAE,SAAS,YAAY,EAAE,QAAQ,OAAO,EAAE;AAAA,IAC9D,QAAQ;AACN,aAAO,EAAE,SAAS,OAAO,mBAAmB,MAAM,SAAS,KAAK;AAAA,IAClE;AAAA,EACF,OAAO;AACL,WAAO,IAAI,KAAK,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK;AAAA,EACnD;AACA,aAAW,OAAO,SAAS;AACzB,UAAM,QAAQ,wBAAwB,GAAG;AACzC,QAAI,CAAC,MAAO;AACZ,QAAI,SAAS,SAAS,KAAK,SAAS,IAAI,KAAK,EAAE,GAAG;AAChD,aAAO,EAAE,SAAS,MAAM,mBAAmB,aAAa,SAAS,MAAM;AAAA,IACzE;AAAA,EACF;AACA,SAAO,EAAE,SAAS,OAAO,mBAAmB,aAAa,SAAS,KAAK;AACzE;","names":[]}

package/dist/lifeops/background-planner-dispatch.d.ts

@@ -0,0 +1,60 @@
+/**
+ * WS5 — glue between {@link planJob} and the WS6 approval queue.
+ *
+ * Every background job calls {@link planJob} and passes the result here.
+ * Sensitive actions (`requiresApproval === true` with a usable payload)
+ * are enqueued via the queue exposed by the runtime as service
+ * "APPROVAL_QUEUE". Non-sensitive actions and noops are recorded for
+ * observability and returned.
+ *
+ * No side-effects other than enqueue + logger. No try/catch swallow: a
+ * missing queue is a typed error that surfaces to the caller.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ApprovalRequest } from "./approval-queue.types.js";
+import type { BackgroundJobContext, TypedJobPlan } from "./background-planner.js";
+export declare const APPROVAL_QUEUE_SERVICE_NAME: "APPROVAL_QUEUE";
+/** Default expiry window for queued background-job approvals: 24 hours. */
+export declare const DEFAULT_BACKGROUND_APPROVAL_EXPIRY_MS: number;
+/**
+ * Raised when a sensitive plan cannot be enqueued because the WS6 queue is
+ * not registered on the runtime. We surface this loudly so the bug cannot
+ * hide as a silent skip.
+ */
+export declare class ApprovalQueueUnavailableError extends Error {
+    readonly jobKind: string;
+    constructor(jobKind: string);
+}
+/**
+ * Result returned from {@link enqueueIfSensitive} so callers and tests can
+ * introspect what the planner decided for this tick.
+ */
+export interface PlannerDispatchResult {
+    readonly jobKind: string;
+    readonly plan: TypedJobPlan;
+    /** Non-null when a request was enqueued. */
+    readonly approvalRequest: ApprovalRequest | null;
+    /** True when the plan was a noop or purely internal (no enqueue). */
+    readonly skipped: boolean;
+    /** When skipped=true, the reason. */
+    readonly skipReason: string | null;
+}
+/**
+ * If the plan is sensitive AND has a usable payload, enqueue it in the WS6
+ * approval queue. Otherwise, return a skipped result. Always records the
+ * decision to the runtime-scoped observability log via
+ * {@link recordPlannerDispatch} so the contract test can introspect.
+ */
+export declare function enqueueIfSensitive(runtime: IAgentRuntime, jobContext: BackgroundJobContext, plan: TypedJobPlan, now?: Date): Promise<PlannerDispatchResult>;
+/**
+ * Record a planner dispatch decision on the runtime object so the contract
+ * test can inspect every invocation without racing against the real
+ * approval queue or LLM. Bounded to DISPATCH_LOG_MAX_ENTRIES to prevent the
+ * log from growing unbounded on long-lived runtimes.
+ */
+export declare function recordPlannerDispatch(runtime: IAgentRuntime, result: PlannerDispatchResult): void;
+/** Test-only: read the in-memory dispatch log for a runtime. */
+export declare function readPlannerDispatchLog(runtime: IAgentRuntime): ReadonlyArray<PlannerDispatchResult>;
+/** Test-only: clear the dispatch log between runs. */
+export declare function resetPlannerDispatchLog(runtime: IAgentRuntime): void;
+//# sourceMappingURL=background-planner-dispatch.d.ts.map

package/dist/lifeops/background-planner-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-planner-dispatch.d.ts","sourceRoot":"","sources":["../../src/lifeops/background-planner-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACb,MAAM,yBAAyB,CAAC;AAEjC,eAAO,MAAM,2BAA2B,EAAG,gBAAyB,CAAC;AAErE,2EAA2E;AAC3E,eAAO,MAAM,qCAAqC,QAAsB,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,SAAgB,OAAO,EAAE,MAAM,CAAC;gBACpB,OAAO,EAAE,MAAM;CAO5B;AAYD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACjD,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,oBAAoB,EAChC,IAAI,EAAE,YAAY,EAClB,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAoEhC;AAaD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAQN;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,GACrB,aAAa,CAAC,qBAAqB,CAAC,CAGtC;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAGpE"}

package/dist/lifeops/background-planner-dispatch.js

@@ -0,0 +1,113 @@
+import { logger } from "@elizaos/core";
+const APPROVAL_QUEUE_SERVICE_NAME = "APPROVAL_QUEUE";
+const DEFAULT_BACKGROUND_APPROVAL_EXPIRY_MS = 24 * 60 * 60 * 1e3;
+class ApprovalQueueUnavailableError extends Error {
+  jobKind;
+  constructor(jobKind) {
+    super(
+      `[BackgroundPlanner:${jobKind}] approval queue service '${APPROVAL_QUEUE_SERVICE_NAME}' is not registered`
+    );
+    this.name = "ApprovalQueueUnavailableError";
+    this.jobKind = jobKind;
+  }
+}
+function getApprovalQueue(runtime) {
+  const service = runtime.getService(APPROVAL_QUEUE_SERVICE_NAME);
+  if (!service) return null;
+  if (typeof service !== "object") return null;
+  const candidate = service;
+  return typeof candidate.enqueue === "function" ? candidate : null;
+}
+async function enqueueIfSensitive(runtime, jobContext, plan, now = /* @__PURE__ */ new Date()) {
+  if (plan.action === null) {
+    const result2 = {
+      jobKind: jobContext.jobKind,
+      plan,
+      approvalRequest: null,
+      skipped: true,
+      skipReason: "planner returned noop"
+    };
+    recordPlannerDispatch(runtime, result2);
+    return result2;
+  }
+  if (!plan.requiresApproval) {
+    const result2 = {
+      jobKind: jobContext.jobKind,
+      plan,
+      approvalRequest: null,
+      skipped: true,
+      skipReason: "planner marked requiresApproval=false"
+    };
+    recordPlannerDispatch(runtime, result2);
+    return result2;
+  }
+  if (plan.payload === null) {
+    const result2 = {
+      jobKind: jobContext.jobKind,
+      plan,
+      approvalRequest: null,
+      skipped: true,
+      skipReason: "planner produced sensitive action without usable payload"
+    };
+    recordPlannerDispatch(runtime, result2);
+    logger.warn(
+      `[BackgroundPlanner:${jobContext.jobKind}] sensitive action ${plan.action} skipped \u2014 no payload`
+    );
+    return result2;
+  }
+  const queue = getApprovalQueue(runtime);
+  if (!queue) {
+    throw new ApprovalQueueUnavailableError(jobContext.jobKind);
+  }
+  const input = {
+    requestedBy: `background-job:${jobContext.jobKind}`,
+    subjectUserId: jobContext.subjectUserId,
+    action: plan.action,
+    payload: plan.payload,
+    channel: plan.channel,
+    reason: plan.reason,
+    expiresAt: new Date(now.getTime() + DEFAULT_BACKGROUND_APPROVAL_EXPIRY_MS)
+  };
+  const approvalRequest = await queue.enqueue(input);
+  const result = {
+    jobKind: jobContext.jobKind,
+    plan,
+    approvalRequest,
+    skipped: false,
+    skipReason: null
+  };
+  recordPlannerDispatch(runtime, result);
+  logger.info(
+    `[BackgroundPlanner:${jobContext.jobKind}] enqueued approval ${approvalRequest.id} (${plan.action} on ${plan.channel})`
+  );
+  return result;
+}
+const DISPATCH_LOG_KEY = /* @__PURE__ */ Symbol.for("eliza.lifeops.background-planner.log");
+const DISPATCH_LOG_MAX_ENTRIES = 200;
+function recordPlannerDispatch(runtime, result) {
+  const holder = runtime;
+  const log = holder[DISPATCH_LOG_KEY] ?? [];
+  log.push(result);
+  if (log.length > DISPATCH_LOG_MAX_ENTRIES) {
+    log.splice(0, log.length - DISPATCH_LOG_MAX_ENTRIES);
+  }
+  holder[DISPATCH_LOG_KEY] = log;
+}
+function readPlannerDispatchLog(runtime) {
+  const holder = runtime;
+  return holder[DISPATCH_LOG_KEY] ?? [];
+}
+function resetPlannerDispatchLog(runtime) {
+  const holder = runtime;
+  holder[DISPATCH_LOG_KEY] = [];
+}
+export {
+  APPROVAL_QUEUE_SERVICE_NAME,
+  ApprovalQueueUnavailableError,
+  DEFAULT_BACKGROUND_APPROVAL_EXPIRY_MS,
+  enqueueIfSensitive,
+  readPlannerDispatchLog,
+  recordPlannerDispatch,
+  resetPlannerDispatchLog
+};
+//# sourceMappingURL=background-planner-dispatch.js.map

package/dist/lifeops/background-planner-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/background-planner-dispatch.ts"],"sourcesContent":["/**\n * WS5 — glue between {@link planJob} and the WS6 approval queue.\n *\n * Every background job calls {@link planJob} and passes the result here.\n * Sensitive actions (`requiresApproval === true` with a usable payload)\n * are enqueued via the queue exposed by the runtime as service\n * \"APPROVAL_QUEUE\". Non-sensitive actions and noops are recorded for\n * observability and returned.\n *\n * No side-effects other than enqueue + logger. No try/catch swallow: a\n * missing queue is a typed error that surfaces to the caller.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport type {\n  ApprovalEnqueueInput,\n  ApprovalQueue,\n  ApprovalRequest,\n} from \"./approval-queue.types.js\";\nimport type {\n  BackgroundJobContext,\n  TypedJobPlan,\n} from \"./background-planner.js\";\n\nexport const APPROVAL_QUEUE_SERVICE_NAME = \"APPROVAL_QUEUE\" as const;\n\n/** Default expiry window for queued background-job approvals: 24 hours. */\nexport const DEFAULT_BACKGROUND_APPROVAL_EXPIRY_MS = 24 * 60 * 60 * 1000;\n\n/**\n * Raised when a sensitive plan cannot be enqueued because the WS6 queue is\n * not registered on the runtime. We surface this loudly so the bug cannot\n * hide as a silent skip.\n */\nexport class ApprovalQueueUnavailableError extends Error {\n  public readonly jobKind: string;\n  constructor(jobKind: string) {\n    super(\n      `[BackgroundPlanner:${jobKind}] approval queue service '${APPROVAL_QUEUE_SERVICE_NAME}' is not registered`,\n    );\n    this.name = \"ApprovalQueueUnavailableError\";\n    this.jobKind = jobKind;\n  }\n}\n\nfunction getApprovalQueue(runtime: IAgentRuntime): ApprovalQueue | null {\n  const service = runtime.getService(APPROVAL_QUEUE_SERVICE_NAME);\n  if (!service) return null;\n  if (typeof service !== \"object\") return null;\n  const candidate = service as Partial<ApprovalQueue>;\n  return typeof candidate.enqueue === \"function\"\n    ? (candidate as ApprovalQueue)\n    : null;\n}\n\n/**\n * Result returned from {@link enqueueIfSensitive} so callers and tests can\n * introspect what the planner decided for this tick.\n */\nexport interface PlannerDispatchResult {\n  readonly jobKind: string;\n  readonly plan: TypedJobPlan;\n  /** Non-null when a request was enqueued. */\n  readonly approvalRequest: ApprovalRequest | null;\n  /** True when the plan was a noop or purely internal (no enqueue). */\n  readonly skipped: boolean;\n  /** When skipped=true, the reason. */\n  readonly skipReason: string | null;\n}\n\n/**\n * If the plan is sensitive AND has a usable payload, enqueue it in the WS6\n * approval queue. Otherwise, return a skipped result. Always records the\n * decision to the runtime-scoped observability log via\n * {@link recordPlannerDispatch} so the contract test can introspect.\n */\nexport async function enqueueIfSensitive(\n  runtime: IAgentRuntime,\n  jobContext: BackgroundJobContext,\n  plan: TypedJobPlan,\n  now: Date = new Date(),\n): Promise<PlannerDispatchResult> {\n  if (plan.action === null) {\n    const result: PlannerDispatchResult = {\n      jobKind: jobContext.jobKind,\n      plan,\n      approvalRequest: null,\n      skipped: true,\n      skipReason: \"planner returned noop\",\n    };\n    recordPlannerDispatch(runtime, result);\n    return result;\n  }\n\n  if (!plan.requiresApproval) {\n    const result: PlannerDispatchResult = {\n      jobKind: jobContext.jobKind,\n      plan,\n      approvalRequest: null,\n      skipped: true,\n      skipReason: \"planner marked requiresApproval=false\",\n    };\n    recordPlannerDispatch(runtime, result);\n    return result;\n  }\n\n  if (plan.payload === null) {\n    const result: PlannerDispatchResult = {\n      jobKind: jobContext.jobKind,\n      plan,\n      approvalRequest: null,\n      skipped: true,\n      skipReason: \"planner produced sensitive action without usable payload\",\n    };\n    recordPlannerDispatch(runtime, result);\n    logger.warn(\n      `[BackgroundPlanner:${jobContext.jobKind}] sensitive action ${plan.action} skipped — no payload`,\n    );\n    return result;\n  }\n\n  const queue = getApprovalQueue(runtime);\n  if (!queue) {\n    throw new ApprovalQueueUnavailableError(jobContext.jobKind);\n  }\n\n  const input: ApprovalEnqueueInput = {\n    requestedBy: `background-job:${jobContext.jobKind}`,\n    subjectUserId: jobContext.subjectUserId,\n    action: plan.action,\n    payload: plan.payload,\n    channel: plan.channel,\n    reason: plan.reason,\n    expiresAt: new Date(now.getTime() + DEFAULT_BACKGROUND_APPROVAL_EXPIRY_MS),\n  };\n\n  const approvalRequest = await queue.enqueue(input);\n  const result: PlannerDispatchResult = {\n    jobKind: jobContext.jobKind,\n    plan,\n    approvalRequest,\n    skipped: false,\n    skipReason: null,\n  };\n  recordPlannerDispatch(runtime, result);\n  logger.info(\n    `[BackgroundPlanner:${jobContext.jobKind}] enqueued approval ${approvalRequest.id} (${plan.action} on ${plan.channel})`,\n  );\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Test observability\n// ---------------------------------------------------------------------------\n\nconst DISPATCH_LOG_KEY = Symbol.for(\"eliza.lifeops.background-planner.log\");\nconst DISPATCH_LOG_MAX_ENTRIES = 200;\n\ninterface DispatchLogHolder extends IAgentRuntime {\n  [DISPATCH_LOG_KEY]?: PlannerDispatchResult[];\n}\n\n/**\n * Record a planner dispatch decision on the runtime object so the contract\n * test can inspect every invocation without racing against the real\n * approval queue or LLM. Bounded to DISPATCH_LOG_MAX_ENTRIES to prevent the\n * log from growing unbounded on long-lived runtimes.\n */\nexport function recordPlannerDispatch(\n  runtime: IAgentRuntime,\n  result: PlannerDispatchResult,\n): void {\n  const holder = runtime as DispatchLogHolder;\n  const log = holder[DISPATCH_LOG_KEY] ?? [];\n  log.push(result);\n  if (log.length > DISPATCH_LOG_MAX_ENTRIES) {\n    log.splice(0, log.length - DISPATCH_LOG_MAX_ENTRIES);\n  }\n  holder[DISPATCH_LOG_KEY] = log;\n}\n\n/** Test-only: read the in-memory dispatch log for a runtime. */\nexport function readPlannerDispatchLog(\n  runtime: IAgentRuntime,\n): ReadonlyArray<PlannerDispatchResult> {\n  const holder = runtime as DispatchLogHolder;\n  return holder[DISPATCH_LOG_KEY] ?? [];\n}\n\n/** Test-only: clear the dispatch log between runs. */\nexport function resetPlannerDispatchLog(runtime: IAgentRuntime): void {\n  const holder = runtime as DispatchLogHolder;\n  holder[DISPATCH_LOG_KEY] = [];\n}\n"],"mappings":"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","names":["result"]}