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

package/dist/lifeops/connectors/contract.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Connector contract.
+ *
+ * Capability strings are namespaced (e.g. `"google.calendar.read"`,
+ * `"telegram.send"`, `"apple_health.read"`) so multiple connectors can advertise
+ * overlapping capabilities and the runtime can resolve dispatchers without
+ * pattern-matching on `kind`.
+ */
+export type ConnectorMode = "local" | "cloud";
+export interface ConnectorStatus {
+    state: "ok" | "degraded" | "disconnected";
+    message?: string;
+    observedAt: string;
+}
+import type { DispatchResult } from "@elizaos/plugin-scheduling";
+export type { DispatchResult };
+/**
+ * OAuth surface a connector contribution may advertise. URL provided by the
+ * connector contribution; the dispatcher does not hardcode. Audit C top-3
+ * (rigidity-hunt-audit.md §3) — externalising these URLs lets adding a
+ * fifth health provider register a contribution instead of editing
+ * dispatcher switches.
+ */
+export interface ConnectorOAuthConfig {
+    readonly authorizeUrl: string;
+    readonly tokenUrl: string;
+    readonly revokeUrl?: string | null;
+    readonly scopes?: readonly string[];
+}
+export interface ConnectorContribution {
+    /**
+     * Stable connector key — `"google"`, `"telegram"`, `"discord"`,
+     * `"apple_health"`, etc. Used as the registry lookup key.
+     */
+    kind: string;
+    /**
+     * Namespaced capability strings the connector advertises.
+     *
+     * Examples: `"google.calendar.read"`, `"google.gmail.draft.create"`,
+     * `"telegram.send"`, `"apple_health.read"`, `"strava.read"`.
+     */
+    capabilities: string[];
+    modes: ConnectorMode[];
+    describe: {
+        label: string;
+    };
+    /**
+     * Optional OAuth config — URL provided by the connector contribution; the
+     * dispatcher does not hardcode. Health-bridge connectors (Strava, Fitbit,
+     * Withings, Oura) populate this so the OAuth driver iterates the registry.
+     */
+    oauth?: ConnectorOAuthConfig;
+    /**
+     * Optional API base URL for authenticated requests — URL provided by the
+     * connector contribution; the dispatcher does not hardcode.
+     */
+    apiBaseUrl?: string;
+    start(): Promise<void>;
+    disconnect(): Promise<void>;
+    verify(): Promise<boolean>;
+    status(): Promise<ConnectorStatus>;
+    /**
+     * Optional outbound dispatch verb. The payload shape is connector-specific;
+     * the registry does not validate it. Connectors that contribute send-capable
+     * channels should also surface a {@link import("../channels/contract.js").ChannelContribution}.
+     */
+    send?(payload: unknown): Promise<DispatchResult>;
+    /**
+     * Optional read verb. The query and return shape are connector-specific.
+     */
+    read?(query: unknown): Promise<unknown>;
+    /**
+     * When `true`, the runtime gates this connector's outbound `send` calls
+     * through the owner-send-policy (e.g. Gmail draft → owner approval).
+     */
+    requiresApproval?: boolean;
+}
+export interface ConnectorRegistryFilter {
+    capability?: string;
+    mode?: ConnectorMode;
+}
+export interface ConnectorRegistry {
+    register(c: ConnectorContribution): void;
+    list(filter?: ConnectorRegistryFilter): ConnectorContribution[];
+    get(kind: string): ConnectorContribution | null;
+    byCapability(capability: string): ConnectorContribution[];
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/lifeops/connectors/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,GAAG,UAAU,GAAG,cAAc,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,KAAK,EAAE,aAAa,EAAE,CAAC;IAEvB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjD;;OAEG;IACH,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,qBAAqB,EAAE,CAAC;IAChE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;CAC3D"}

package/dist/lifeops/connectors/contract.js

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

package/dist/lifeops/connectors/contract.js.map

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

package/dist/lifeops/connectors/default-pack.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Default connector pack.
+ *
+ * Registers the LifeOps connector contributions with the `ConnectorRegistry`.
+ * `plugin-health` registers its own health connectors directly; this pack
+ * does not touch them.
+ *
+ * Channels (in_app, push, imessage, telegram, …) are registered separately
+ * by `../channels/default-pack.ts`.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ConnectorContribution, ConnectorRegistry } from "./contract.js";
+export type ConnectorContributionFactory = (runtime: IAgentRuntime) => ConnectorContribution;
+/**
+ * Connector contributions ordered by usage frequency for deterministic
+ * registration logs. plugin-health registers
+ * apple_health/google_fit/strava/fitbit/withings/oura on its own; they
+ * are not part of this pack.
+ */
+export declare const DEFAULT_CONNECTOR_CONTRIBUTIONS: ReadonlyArray<ConnectorContributionFactory>;
+/**
+ * Empty default — populating against a synthetic runtime would require
+ * constructing `LifeOpsService` without a real runtime. Callers that want a
+ * concrete list should call {@link registerDefaultConnectorPack}.
+ */
+export declare const DEFAULT_CONNECTOR_PACK: readonly ConnectorContribution[];
+/**
+ * Register every connector in the default pack against the supplied registry.
+ *
+ * Each contribution is constructed lazily via its factory so the wrapper
+ * captures the runtime reference. Re-registering the same `kind` is a
+ * programming error and surfaces as a thrown `Error` from the registry.
+ */
+export declare function registerDefaultConnectorPack(registry: ConnectorRegistry, runtime?: IAgentRuntime): void;
+//# sourceMappingURL=default-pack.d.ts.map

package/dist/lifeops/connectors/default-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-pack.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/default-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAW9E,MAAM,MAAM,4BAA4B,GAAG,CACzC,OAAO,EAAE,aAAa,KACnB,qBAAqB,CAAC;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,4BAA4B,CAYrF,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,qBAAqB,EAAO,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CASN"}

package/dist/lifeops/connectors/default-pack.js

@@ -0,0 +1,37 @@
+import { createCalendlyConnectorContribution } from "./calendly.js";
+import { createDiscordConnectorContribution } from "./discord.js";
+import { createDuffelConnectorContribution } from "./duffel.js";
+import { createGoogleConnectorContribution } from "./google.js";
+import { createIMessageConnectorContribution } from "./imessage.js";
+import { createSignalConnectorContribution } from "./signal.js";
+import { createTelegramConnectorContribution } from "./telegram.js";
+import { createTwilioConnectorContribution } from "./twilio.js";
+import { createWhatsAppConnectorContribution } from "./whatsapp.js";
+import { createXConnectorContribution } from "./x.js";
+const DEFAULT_CONNECTOR_CONTRIBUTIONS = [
+  createGoogleConnectorContribution,
+  createTelegramConnectorContribution,
+  createDiscordConnectorContribution,
+  createSignalConnectorContribution,
+  createWhatsAppConnectorContribution,
+  createIMessageConnectorContribution,
+  createXConnectorContribution,
+  createTwilioConnectorContribution,
+  createCalendlyConnectorContribution,
+  createDuffelConnectorContribution
+];
+const DEFAULT_CONNECTOR_PACK = [];
+function registerDefaultConnectorPack(registry, runtime) {
+  if (!runtime) {
+    return;
+  }
+  for (const factory of DEFAULT_CONNECTOR_CONTRIBUTIONS) {
+    registry.register(factory(runtime));
+  }
+}
+export {
+  DEFAULT_CONNECTOR_CONTRIBUTIONS,
+  DEFAULT_CONNECTOR_PACK,
+  registerDefaultConnectorPack
+};
+//# sourceMappingURL=default-pack.js.map

package/dist/lifeops/connectors/default-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/connectors/default-pack.ts"],"sourcesContent":["/**\n * Default connector pack.\n *\n * Registers the LifeOps connector contributions with the `ConnectorRegistry`.\n * `plugin-health` registers its own health connectors directly; this pack\n * does not touch them.\n *\n * Channels (in_app, push, imessage, telegram, …) are registered separately\n * by `../channels/default-pack.ts`.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport { createCalendlyConnectorContribution } from \"./calendly.js\";\nimport type { ConnectorContribution, ConnectorRegistry } from \"./contract.js\";\nimport { createDiscordConnectorContribution } from \"./discord.js\";\nimport { createDuffelConnectorContribution } from \"./duffel.js\";\nimport { createGoogleConnectorContribution } from \"./google.js\";\nimport { createIMessageConnectorContribution } from \"./imessage.js\";\nimport { createSignalConnectorContribution } from \"./signal.js\";\nimport { createTelegramConnectorContribution } from \"./telegram.js\";\nimport { createTwilioConnectorContribution } from \"./twilio.js\";\nimport { createWhatsAppConnectorContribution } from \"./whatsapp.js\";\nimport { createXConnectorContribution } from \"./x.js\";\n\nexport type ConnectorContributionFactory = (\n  runtime: IAgentRuntime,\n) => ConnectorContribution;\n\n/**\n * Connector contributions ordered by usage frequency for deterministic\n * registration logs. plugin-health registers\n * apple_health/google_fit/strava/fitbit/withings/oura on its own; they\n * are not part of this pack.\n */\nexport const DEFAULT_CONNECTOR_CONTRIBUTIONS: ReadonlyArray<ConnectorContributionFactory> =\n  [\n    createGoogleConnectorContribution,\n    createTelegramConnectorContribution,\n    createDiscordConnectorContribution,\n    createSignalConnectorContribution,\n    createWhatsAppConnectorContribution,\n    createIMessageConnectorContribution,\n    createXConnectorContribution,\n    createTwilioConnectorContribution,\n    createCalendlyConnectorContribution,\n    createDuffelConnectorContribution,\n  ];\n\n/**\n * Empty default — populating against a synthetic runtime would require\n * constructing `LifeOpsService` without a real runtime. Callers that want a\n * concrete list should call {@link registerDefaultConnectorPack}.\n */\nexport const DEFAULT_CONNECTOR_PACK: readonly ConnectorContribution[] = [];\n\n/**\n * Register every connector in the default pack against the supplied registry.\n *\n * Each contribution is constructed lazily via its factory so the wrapper\n * captures the runtime reference. Re-registering the same `kind` is a\n * programming error and surfaces as a thrown `Error` from the registry.\n */\nexport function registerDefaultConnectorPack(\n  registry: ConnectorRegistry,\n  runtime?: IAgentRuntime,\n): void {\n  if (!runtime) {\n    // Some callsites pass only the registry; preserve that path so the\n    // plugin doesn't fail-fast before the rest of the boot sequence runs.\n    return;\n  }\n  for (const factory of DEFAULT_CONNECTOR_CONTRIBUTIONS) {\n    registry.register(factory(runtime));\n  }\n}\n"],"mappings":"AAYA,SAAS,2CAA2C;AAEpD,SAAS,0CAA0C;AACnD,SAAS,yCAAyC;AAClD,SAAS,yCAAyC;AAClD,SAAS,2CAA2C;AACpD,SAAS,yCAAyC;AAClD,SAAS,2CAA2C;AACpD,SAAS,yCAAyC;AAClD,SAAS,2CAA2C;AACpD,SAAS,oCAAoC;AAYtC,MAAM,kCACX;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOK,MAAM,yBAA2D,CAAC;AASlE,SAAS,6BACd,UACA,SACM;AACN,MAAI,CAAC,SAAS;AAGZ;AAAA,EACF;AACA,aAAW,WAAW,iCAAiC;AACrD,aAAS,SAAS,QAAQ,OAAO,CAAC;AAAA,EACpC;AACF;","names":[]}

package/dist/lifeops/connectors/discord.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Discord connector contribution. Wraps the LifeOps Discord mixin
+ * (`service-mixin-discord.ts`).
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ConnectorContribution } from "./contract.js";
+export declare function createDiscordConnectorContribution(runtime: IAgentRuntime): ConnectorContribution;
+//# sourceMappingURL=discord.d.ts.map

package/dist/lifeops/connectors/discord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/discord.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,eAAe,CAAC;AAEvB,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,aAAa,GACrB,qBAAqB,CAuCvB"}

package/dist/lifeops/connectors/discord.js

@@ -0,0 +1,53 @@
+import { LifeOpsService } from "../service.js";
+import {
+  errorToDispatchResult,
+  isConnectorSendPayload,
+  legacyStatusToConnectorStatus,
+  rejectInvalidPayload
+} from "./_helpers.js";
+function createDiscordConnectorContribution(runtime) {
+  const service = new LifeOpsService(runtime);
+  return {
+    kind: "discord",
+    capabilities: ["discord.read", "discord.send"],
+    modes: ["local"],
+    describe: { label: "Discord" },
+    async start() {
+    },
+    async disconnect() {
+    },
+    async verify() {
+      const status = await service.getDiscordConnectorStatus("owner");
+      return Boolean(status.connected);
+    },
+    async status() {
+      try {
+        const status = await service.getDiscordConnectorStatus("owner");
+        return legacyStatusToConnectorStatus(status);
+      } catch (error) {
+        return {
+          state: "disconnected",
+          message: error instanceof Error ? error.message : String(error),
+          observedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+    },
+    async send(payload) {
+      if (!isConnectorSendPayload(payload)) return rejectInvalidPayload();
+      try {
+        const result = await service.sendDiscordMessage({
+          side: "owner",
+          channelId: payload.target,
+          text: payload.message
+        });
+        return { ok: true, messageId: result.channelId };
+      } catch (error) {
+        return errorToDispatchResult(error);
+      }
+    }
+  };
+}
+export {
+  createDiscordConnectorContribution
+};
+//# sourceMappingURL=discord.js.map

package/dist/lifeops/connectors/discord.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/connectors/discord.ts"],"sourcesContent":["/**\n * Discord connector contribution. Wraps the LifeOps Discord mixin\n * (`service-mixin-discord.ts`).\n */\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport { LifeOpsService } from \"../service.js\";\nimport {\n  errorToDispatchResult,\n  isConnectorSendPayload,\n  legacyStatusToConnectorStatus,\n  rejectInvalidPayload,\n} from \"./_helpers.js\";\nimport type {\n  ConnectorContribution,\n  ConnectorStatus,\n  DispatchResult,\n} from \"./contract.js\";\n\nexport function createDiscordConnectorContribution(\n  runtime: IAgentRuntime,\n): ConnectorContribution {\n  const service = new LifeOpsService(runtime);\n  return {\n    kind: \"discord\",\n    capabilities: [\"discord.read\", \"discord.send\"],\n    modes: [\"local\"],\n    describe: { label: \"Discord\" },\n    async start() {},\n    async disconnect() {},\n    async verify(): Promise<boolean> {\n      const status = await service.getDiscordConnectorStatus(\"owner\");\n      return Boolean(status.connected);\n    },\n    async status(): Promise<ConnectorStatus> {\n      try {\n        const status = await service.getDiscordConnectorStatus(\"owner\");\n        return legacyStatusToConnectorStatus(status);\n      } catch (error) {\n        return {\n          state: \"disconnected\",\n          message: error instanceof Error ? error.message : String(error),\n          observedAt: new Date().toISOString(),\n        };\n      }\n    },\n    async send(payload: unknown): Promise<DispatchResult> {\n      if (!isConnectorSendPayload(payload)) return rejectInvalidPayload();\n      try {\n        const result = await service.sendDiscordMessage({\n          side: \"owner\",\n          channelId: payload.target,\n          text: payload.message,\n        });\n        return { ok: true, messageId: result.channelId };\n      } catch (error) {\n        return errorToDispatchResult(error);\n      }\n    },\n  };\n}\n"],"mappings":"AAKA,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOA,SAAS,mCACd,SACuB;AACvB,QAAM,UAAU,IAAI,eAAe,OAAO;AAC1C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc,CAAC,gBAAgB,cAAc;AAAA,IAC7C,OAAO,CAAC,OAAO;AAAA,IACf,UAAU,EAAE,OAAO,UAAU;AAAA,IAC7B,MAAM,QAAQ;AAAA,IAAC;AAAA,IACf,MAAM,aAAa;AAAA,IAAC;AAAA,IACpB,MAAM,SAA2B;AAC/B,YAAM,SAAS,MAAM,QAAQ,0BAA0B,OAAO;AAC9D,aAAO,QAAQ,OAAO,SAAS;AAAA,IACjC;AAAA,IACA,MAAM,SAAmC;AACvC,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,0BAA0B,OAAO;AAC9D,eAAO,8BAA8B,MAAM;AAAA,MAC7C,SAAS,OAAO;AACd,eAAO;AAAA,UACL,OAAO;AAAA,UACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC9D,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,QACrC;AAAA,MACF;AAAA,IACF;AAAA,IACA,MAAM,KAAK,SAA2C;AACpD,UAAI,CAAC,uBAAuB,OAAO,EAAG,QAAO,qBAAqB;AAClE,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,mBAAmB;AAAA,UAC9C,MAAM;AAAA,UACN,WAAW,QAAQ;AAAA,UACnB,MAAM,QAAQ;AAAA,QAChB,CAAC;AACD,eAAO,EAAE,IAAI,MAAM,WAAW,OAAO,UAAU;AAAA,MACjD,SAAS,OAAO;AACd,eAAO,sBAAsB,KAAK;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/lifeops/connectors/dispatch-policy.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Runner-side dispatch fallback policy.
+ *
+ * Pure function. The runner calls {@link decideDispatchPolicy} with each
+ * `DispatchResult` from a connector or channel `send` and applies the returned
+ * decision against the active `ScheduledTask` escalation ladder.
+ *
+ * Decision matrix:
+ * - `ok: true`                           → `complete`
+ * - `userActionable: true` failure       → `surface_degraded` (advance ladder)
+ *                                          and surface via the
+ *                                          connector-degradation provider.
+ * - `retryAfterMinutes` set              → `retry` (do NOT advance ladder).
+ * - other failure                        → `advance` (mark current step failed,
+ *                                          advance to next step).
+ * - last step failed                     → `fail` (state.status = "failed",
+ *                                          pipeline.onFail fires).
+ */
+import type { DispatchResult } from "./contract.js";
+/**
+ * Decision the runner should apply after a single dispatch attempt.
+ *
+ * - `complete` — dispatch succeeded; the step is done. The runner records
+ *   `messageId` on the task state log if present.
+ * - `retry` — reschedule the same step after `retryAfterMinutes`. The ladder
+ *   index is NOT advanced. Surface as `retrying` in the state log.
+ * - `advance` — the current step is permanently failed. Advance the ladder to
+ *   the next step. If no further step exists the runner emits `fail`.
+ * - `surface_degraded` — same as `advance`, plus the failure should be
+ *   surfaced through the connector-degradation provider (which gates
+ *   visibility in subsequent providers; the runner consumes the flag).
+ * - `fail` — terminal: every step has failed (or the only step failed without
+ *   a retry hint). Runner sets `state.status = "failed"` and fires
+ *   `pipeline.onFail`.
+ */
+export type DispatchPolicyDecision = {
+    kind: "complete";
+    messageId?: string;
+} | {
+    kind: "retry";
+    retryAfterMinutes: number;
+    reason: DispatchFailureReason;
+} | {
+    kind: "advance";
+    reason: DispatchFailureReason;
+    message?: string;
+} | {
+    kind: "surface_degraded";
+    reason: DispatchFailureReason;
+    message?: string;
+} | {
+    kind: "fail";
+    reason: DispatchFailureReason;
+    message?: string;
+};
+export type DispatchFailureReason = "disconnected" | "rate_limited" | "auth_expired" | "unknown_recipient" | "transport_error";
+export interface DispatchPolicyContext {
+    /**
+     * Zero-based index of the current escalation step that produced this result.
+     */
+    currentStepIndex: number;
+    /**
+     * Total number of steps in the active ladder. When
+     * `currentStepIndex >= totalSteps - 1` the runner has no further step to
+     * advance to and a failure becomes terminal.
+     */
+    totalSteps: number;
+    /**
+     * Default backoff applied when a connector reports `rate_limited` without
+     * setting `retryAfterMinutes`. Defaults to 5 minutes.
+     */
+    defaultRetryAfterMinutes?: number;
+}
+export declare function decideDispatchPolicy(result: DispatchResult, context: DispatchPolicyContext): DispatchPolicyDecision;
+//# sourceMappingURL=dispatch-policy.d.ts.map

package/dist/lifeops/connectors/dispatch-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-policy.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/dispatch-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IACE,IAAI,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,qBAAqB,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,cAAc,GACd,cAAc,GACd,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAUD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,GAC7B,sBAAsB,CA4CxB"}

package/dist/lifeops/connectors/dispatch-policy.js

@@ -0,0 +1,35 @@
+const DEFAULT_RETRY_AFTER_MINUTES = 5;
+function decideDispatchPolicy(result, context) {
+  if (result.ok === true) {
+    return { kind: "complete", messageId: result.messageId };
+  }
+  const failure = result;
+  const reason = failure.reason;
+  const message = failure.message;
+  const isLastStep = context.currentStepIndex >= context.totalSteps - 1;
+  if (typeof failure.retryAfterMinutes === "number" && failure.retryAfterMinutes > 0) {
+    return {
+      kind: "retry",
+      retryAfterMinutes: failure.retryAfterMinutes,
+      reason
+    };
+  }
+  if (reason === "rate_limited") {
+    return {
+      kind: "retry",
+      retryAfterMinutes: context.defaultRetryAfterMinutes ?? DEFAULT_RETRY_AFTER_MINUTES,
+      reason
+    };
+  }
+  if (isLastStep) {
+    return { kind: "fail", reason, message };
+  }
+  if (failure.userActionable) {
+    return { kind: "surface_degraded", reason, message };
+  }
+  return { kind: "advance", reason, message };
+}
+export {
+  decideDispatchPolicy
+};
+//# sourceMappingURL=dispatch-policy.js.map

package/dist/lifeops/connectors/dispatch-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/connectors/dispatch-policy.ts"],"sourcesContent":["/**\n * Runner-side dispatch fallback policy.\n *\n * Pure function. The runner calls {@link decideDispatchPolicy} with each\n * `DispatchResult` from a connector or channel `send` and applies the returned\n * decision against the active `ScheduledTask` escalation ladder.\n *\n * Decision matrix:\n * - `ok: true`                           → `complete`\n * - `userActionable: true` failure       → `surface_degraded` (advance ladder)\n *                                          and surface via the\n *                                          connector-degradation provider.\n * - `retryAfterMinutes` set              → `retry` (do NOT advance ladder).\n * - other failure                        → `advance` (mark current step failed,\n *                                          advance to next step).\n * - last step failed                     → `fail` (state.status = \"failed\",\n *                                          pipeline.onFail fires).\n */\n\nimport type { DispatchResult } from \"./contract.js\";\n\n/**\n * Decision the runner should apply after a single dispatch attempt.\n *\n * - `complete` — dispatch succeeded; the step is done. The runner records\n *   `messageId` on the task state log if present.\n * - `retry` — reschedule the same step after `retryAfterMinutes`. The ladder\n *   index is NOT advanced. Surface as `retrying` in the state log.\n * - `advance` — the current step is permanently failed. Advance the ladder to\n *   the next step. If no further step exists the runner emits `fail`.\n * - `surface_degraded` — same as `advance`, plus the failure should be\n *   surfaced through the connector-degradation provider (which gates\n *   visibility in subsequent providers; the runner consumes the flag).\n * - `fail` — terminal: every step has failed (or the only step failed without\n *   a retry hint). Runner sets `state.status = \"failed\"` and fires\n *   `pipeline.onFail`.\n */\nexport type DispatchPolicyDecision =\n  | { kind: \"complete\"; messageId?: string }\n  | {\n      kind: \"retry\";\n      retryAfterMinutes: number;\n      reason: DispatchFailureReason;\n    }\n  | {\n      kind: \"advance\";\n      reason: DispatchFailureReason;\n      message?: string;\n    }\n  | {\n      kind: \"surface_degraded\";\n      reason: DispatchFailureReason;\n      message?: string;\n    }\n  | {\n      kind: \"fail\";\n      reason: DispatchFailureReason;\n      message?: string;\n    };\n\nexport type DispatchFailureReason =\n  | \"disconnected\"\n  | \"rate_limited\"\n  | \"auth_expired\"\n  | \"unknown_recipient\"\n  | \"transport_error\";\n\nexport interface DispatchPolicyContext {\n  /**\n   * Zero-based index of the current escalation step that produced this result.\n   */\n  currentStepIndex: number;\n\n  /**\n   * Total number of steps in the active ladder. When\n   * `currentStepIndex >= totalSteps - 1` the runner has no further step to\n   * advance to and a failure becomes terminal.\n   */\n  totalSteps: number;\n\n  /**\n   * Default backoff applied when a connector reports `rate_limited` without\n   * setting `retryAfterMinutes`. Defaults to 5 minutes.\n   */\n  defaultRetryAfterMinutes?: number;\n}\n\nconst DEFAULT_RETRY_AFTER_MINUTES = 5;\n\n/**\n * Map a {@link DispatchResult} from a connector or channel `send` into the\n * policy decision the runner should apply.\n */\ntype DispatchFailure = Extract<DispatchResult, { ok: false }>;\n\nexport function decideDispatchPolicy(\n  result: DispatchResult,\n  context: DispatchPolicyContext,\n): DispatchPolicyDecision {\n  if (result.ok === true) {\n    return { kind: \"complete\", messageId: result.messageId };\n  }\n\n  const failure: DispatchFailure = result;\n  const reason = failure.reason;\n  const message = failure.message;\n  const isLastStep = context.currentStepIndex >= context.totalSteps - 1;\n\n  // Retry-with-backoff dominates: rate-limited or any failure that explicitly\n  // sets retryAfterMinutes is treated as a transient failure on the same step.\n  if (\n    typeof failure.retryAfterMinutes === \"number\" &&\n    failure.retryAfterMinutes > 0\n  ) {\n    return {\n      kind: \"retry\",\n      retryAfterMinutes: failure.retryAfterMinutes,\n      reason,\n    };\n  }\n  if (reason === \"rate_limited\") {\n    return {\n      kind: \"retry\",\n      retryAfterMinutes:\n        context.defaultRetryAfterMinutes ?? DEFAULT_RETRY_AFTER_MINUTES,\n      reason,\n    };\n  }\n\n  // Permanent failure on the last available step → terminal.\n  if (isLastStep) {\n    return { kind: \"fail\", reason, message };\n  }\n\n  // User-actionable failure (e.g. auth_expired) — advance, but flag for the\n  // connector-degradation provider so the user is told what to fix.\n  if (failure.userActionable) {\n    return { kind: \"surface_degraded\", reason, message };\n  }\n\n  // Generic permanent failure on a non-final step → advance to next step.\n  return { kind: \"advance\", reason, message };\n}\n"],"mappings":"AAuFA,MAAM,8BAA8B;AAQ7B,SAAS,qBACd,QACA,SACwB;AACxB,MAAI,OAAO,OAAO,MAAM;AACtB,WAAO,EAAE,MAAM,YAAY,WAAW,OAAO,UAAU;AAAA,EACzD;AAEA,QAAM,UAA2B;AACjC,QAAM,SAAS,QAAQ;AACvB,QAAM,UAAU,QAAQ;AACxB,QAAM,aAAa,QAAQ,oBAAoB,QAAQ,aAAa;AAIpE,MACE,OAAO,QAAQ,sBAAsB,YACrC,QAAQ,oBAAoB,GAC5B;AACA,WAAO;AAAA,MACL,MAAM;AAAA,MACN,mBAAmB,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AACA,MAAI,WAAW,gBAAgB;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,mBACE,QAAQ,4BAA4B;AAAA,MACtC;AAAA,IACF;AAAA,EACF;AAGA,MAAI,YAAY;AACd,WAAO,EAAE,MAAM,QAAQ,QAAQ,QAAQ;AAAA,EACzC;AAIA,MAAI,QAAQ,gBAAgB;AAC1B,WAAO,EAAE,MAAM,oBAAoB,QAAQ,QAAQ;AAAA,EACrD;AAGA,SAAO,EAAE,MAAM,WAAW,QAAQ,QAAQ;AAC5C;","names":[]}

package/dist/lifeops/connectors/duffel.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Duffel (travel) connector contribution.
+ *
+ * Wraps the Duffel travel client from `@elizaos/plugin-elizacloud`.
+ * Duffel is a travel-booking provider; like Calendly it has no outbound
+ * `send`. Read verbs return flight offers + order state.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ConnectorContribution } from "./contract.js";
+export declare function createDuffelConnectorContribution(_runtime: IAgentRuntime): ConnectorContribution;
+//# sourceMappingURL=duffel.d.ts.map

package/dist/lifeops/connectors/duffel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duffel.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/duffel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,eAAe,CAAC;AAEvB,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,aAAa,GACtB,qBAAqB,CAkEvB"}

package/dist/lifeops/connectors/duffel.js

@@ -0,0 +1,74 @@
+import {
+  DuffelConfigError,
+  readDuffelConfigFromEnv,
+  searchFlights
+} from "@elizaos/plugin-elizacloud/cloud/duffel-client";
+function createDuffelConnectorContribution(_runtime) {
+  return {
+    kind: "duffel",
+    capabilities: [
+      "duffel.flights.search",
+      "duffel.offers.read",
+      "duffel.orders.read",
+      "duffel.orders.create"
+    ],
+    modes: ["cloud", "local"],
+    describe: { label: "Duffel (Travel)" },
+    async start() {
+    },
+    async disconnect() {
+    },
+    async verify() {
+      try {
+        readDuffelConfigFromEnv();
+        return true;
+      } catch (error) {
+        if (error instanceof DuffelConfigError) return false;
+        throw error;
+      }
+    },
+    async status() {
+      const observedAt = (/* @__PURE__ */ new Date()).toISOString();
+      try {
+        const config = readDuffelConfigFromEnv();
+        return {
+          state: "ok",
+          message: `mode=${config.mode}`,
+          observedAt
+        };
+      } catch (error) {
+        return {
+          state: "disconnected",
+          message: error instanceof Error ? error.message : String(error),
+          observedAt
+        };
+      }
+    },
+    // Duffel has no outbound `send` — the typed refusal lets the runner's
+    // dispatch policy surface the misuse rather than silently no-op'ing.
+    async send() {
+      return {
+        ok: false,
+        reason: "transport_error",
+        userActionable: false,
+        message: "Duffel does not support outbound send. Use the search/order verbs to book travel."
+      };
+    },
+    async read(query) {
+      const params = query ?? {};
+      if (!params.origin || !params.destination || !params.departureDate) {
+        throw new Error(
+          "duffel.read requires { origin, destination, departureDate, passengers, cabinClass }"
+        );
+      }
+      return searchFlights(
+        params,
+        readDuffelConfigFromEnv()
+      );
+    }
+  };
+}
+export {
+  createDuffelConnectorContribution
+};
+//# sourceMappingURL=duffel.js.map

package/dist/lifeops/connectors/duffel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/connectors/duffel.ts"],"sourcesContent":["/**\n * Duffel (travel) connector contribution.\n *\n * Wraps the Duffel travel client from `@elizaos/plugin-elizacloud`.\n * Duffel is a travel-booking provider; like Calendly it has no outbound\n * `send`. Read verbs return flight offers + order state.\n */\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  DuffelConfigError,\n  readDuffelConfigFromEnv,\n  type SearchFlightsRequest,\n  searchFlights,\n} from \"@elizaos/plugin-elizacloud/cloud/duffel-client\";\nimport type {\n  ConnectorContribution,\n  ConnectorStatus,\n  DispatchResult,\n} from \"./contract.js\";\n\nexport function createDuffelConnectorContribution(\n  _runtime: IAgentRuntime,\n): ConnectorContribution {\n  return {\n    kind: \"duffel\",\n    capabilities: [\n      \"duffel.flights.search\",\n      \"duffel.offers.read\",\n      \"duffel.orders.read\",\n      \"duffel.orders.create\",\n    ],\n    modes: [\"cloud\", \"local\"],\n    describe: { label: \"Duffel (Travel)\" },\n    async start() {},\n    async disconnect() {\n      // Duffel mode is configured via env vars; LifeOps doesn't manage the\n      // credential lifecycle.\n    },\n    async verify(): Promise<boolean> {\n      try {\n        readDuffelConfigFromEnv();\n        return true;\n      } catch (error) {\n        if (error instanceof DuffelConfigError) return false;\n        throw error;\n      }\n    },\n    async status(): Promise<ConnectorStatus> {\n      const observedAt = new Date().toISOString();\n      try {\n        const config = readDuffelConfigFromEnv();\n        return {\n          state: \"ok\",\n          message: `mode=${config.mode}`,\n          observedAt,\n        };\n      } catch (error) {\n        return {\n          state: \"disconnected\",\n          message: error instanceof Error ? error.message : String(error),\n          observedAt,\n        };\n      }\n    },\n    // Duffel has no outbound `send` — the typed refusal lets the runner's\n    // dispatch policy surface the misuse rather than silently no-op'ing.\n    async send(): Promise<DispatchResult> {\n      return {\n        ok: false,\n        reason: \"transport_error\",\n        userActionable: false,\n        message:\n          \"Duffel does not support outbound send. Use the search/order verbs to book travel.\",\n      };\n    },\n    async read(query: unknown) {\n      const params = (query ?? {}) as Partial<SearchFlightsRequest>;\n      if (!params.origin || !params.destination || !params.departureDate) {\n        throw new Error(\n          \"duffel.read requires { origin, destination, departureDate, passengers, cabinClass }\",\n        );\n      }\n      return searchFlights(\n        params as SearchFlightsRequest,\n        readDuffelConfigFromEnv(),\n      );\n    },\n  };\n}\n"],"mappings":"AAQA;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAOA,SAAS,kCACd,UACuB;AACvB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,OAAO,CAAC,SAAS,OAAO;AAAA,IACxB,UAAU,EAAE,OAAO,kBAAkB;AAAA,IACrC,MAAM,QAAQ;AAAA,IAAC;AAAA,IACf,MAAM,aAAa;AAAA,IAGnB;AAAA,IACA,MAAM,SAA2B;AAC/B,UAAI;AACF,gCAAwB;AACxB,eAAO;AAAA,MACT,SAAS,OAAO;AACd,YAAI,iBAAiB,kBAAmB,QAAO;AAC/C,cAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,MAAM,SAAmC;AACvC,YAAM,cAAa,oBAAI,KAAK,GAAE,YAAY;AAC1C,UAAI;AACF,cAAM,SAAS,wBAAwB;AACvC,eAAO;AAAA,UACL,OAAO;AAAA,UACP,SAAS,QAAQ,OAAO,IAAI;AAAA,UAC5B;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,eAAO;AAAA,UACL,OAAO;AAAA,UACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC9D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA;AAAA;AAAA,IAGA,MAAM,OAAgC;AACpC,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,QAAQ;AAAA,QACR,gBAAgB;AAAA,QAChB,SACE;AAAA,MACJ;AAAA,IACF;AAAA,IACA,MAAM,KAAK,OAAgB;AACzB,YAAM,SAAU,SAAS,CAAC;AAC1B,UAAI,CAAC,OAAO,UAAU,CAAC,OAAO,eAAe,CAAC,OAAO,eAAe;AAClE,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,QACL;AAAA,QACA,wBAAwB;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/lifeops/connectors/google.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Google connector contribution.
+ *
+ * Wraps {@link import("../service-mixin-google.js").LifeOpsGoogleService}
+ * (Gmail + Calendar + Drive grants). Gmail's outbound `send` is gated by
+ * `requiresApproval: true`; the runtime's owner-send-policy enqueues the
+ * approval ScheduledTask before this connector ever sees the dispatch.
+ *
+ * Capabilities are namespaced — the entries here mirror
+ * `LIFEOPS_GOOGLE_CAPABILITIES` from `@elizaos/shared`.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ConnectorContribution } from "./contract.js";
+export interface GoogleSendPayload {
+    /** Comma-separated or array of recipients. */
+    target: string;
+    /** Plain-text body. */
+    message: string;
+    /** Optional structured metadata (subject, htmlBody, threadId, …). */
+    metadata?: {
+        subject?: string;
+        side?: "owner" | "agent";
+        htmlBody?: string;
+    };
+}
+export declare function createGoogleConnectorContribution(runtime: IAgentRuntime): ConnectorContribution;
+//# sourceMappingURL=google.d.ts.map

package/dist/lifeops/connectors/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,aAAa,GACrB,qBAAqB,CAyEvB"}

package/dist/lifeops/connectors/google.js

@@ -0,0 +1,80 @@
+import { INTERNAL_URL } from "../access.js";
+import { LifeOpsService } from "../service.js";
+import {
+  errorToDispatchResult,
+  isConnectorSendPayload,
+  legacyStatusToConnectorStatus,
+  rejectInvalidPayload
+} from "./_helpers.js";
+function createGoogleConnectorContribution(runtime) {
+  const service = new LifeOpsService(runtime);
+  return {
+    kind: "google",
+    capabilities: [
+      "google.basic_identity",
+      "google.calendar.read",
+      "google.calendar.write",
+      "google.gmail.triage",
+      "google.gmail.send",
+      "google.gmail.manage"
+    ],
+    modes: ["local"],
+    describe: { label: "Google (Gmail + Calendar)" },
+    // Gmail outbound goes through the owner-send-policy approval queue.
+    // `requiresApproval` is the registry-driven flag for this gate.
+    requiresApproval: true,
+    async start() {
+    },
+    async disconnect() {
+      await service.disconnectGoogleConnector(
+        { side: "owner", mode: "local" },
+        INTERNAL_URL
+      );
+    },
+    async verify() {
+      const status = await service.getGoogleConnectorStatus(INTERNAL_URL);
+      return Boolean(status.connected);
+    },
+    async status() {
+      try {
+        const status = await service.getGoogleConnectorStatus(INTERNAL_URL);
+        return legacyStatusToConnectorStatus(status);
+      } catch (error) {
+        return {
+          state: "disconnected",
+          message: error instanceof Error ? error.message : String(error),
+          observedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+    },
+    async send(payload) {
+      if (!isConnectorSendPayload(payload)) return rejectInvalidPayload();
+      const meta = payload.metadata ?? {};
+      try {
+        const result = await service.sendGmailMessage(INTERNAL_URL, {
+          mode: "local",
+          side: meta.side ?? "owner",
+          to: payload.target.split(",").map((t) => t.trim()).filter(Boolean),
+          subject: meta.subject ?? "(no subject)",
+          bodyText: payload.message,
+          confirmSend: true
+        });
+        if (result.ok) {
+          return { ok: true };
+        }
+        return {
+          ok: false,
+          reason: "transport_error",
+          userActionable: false,
+          message: "Gmail send returned a non-ok response."
+        };
+      } catch (error) {
+        return errorToDispatchResult(error);
+      }
+    }
+  };
+}
+export {
+  createGoogleConnectorContribution
+};
+//# sourceMappingURL=google.js.map

package/dist/lifeops/connectors/google.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/connectors/google.ts"],"sourcesContent":["/**\n * Google connector contribution.\n *\n * Wraps {@link import(\"../service-mixin-google.js\").LifeOpsGoogleService}\n * (Gmail + Calendar + Drive grants). Gmail's outbound `send` is gated by\n * `requiresApproval: true`; the runtime's owner-send-policy enqueues the\n * approval ScheduledTask before this connector ever sees the dispatch.\n *\n * Capabilities are namespaced — the entries here mirror\n * `LIFEOPS_GOOGLE_CAPABILITIES` from `@elizaos/shared`.\n */\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport { INTERNAL_URL } from \"../access.js\";\nimport { LifeOpsService } from \"../service.js\";\nimport {\n  errorToDispatchResult,\n  isConnectorSendPayload,\n  legacyStatusToConnectorStatus,\n  rejectInvalidPayload,\n} from \"./_helpers.js\";\nimport type {\n  ConnectorContribution,\n  ConnectorStatus,\n  DispatchResult,\n} from \"./contract.js\";\n\nexport interface GoogleSendPayload {\n  /** Comma-separated or array of recipients. */\n  target: string;\n  /** Plain-text body. */\n  message: string;\n  /** Optional structured metadata (subject, htmlBody, threadId, …). */\n  metadata?: {\n    subject?: string;\n    side?: \"owner\" | \"agent\";\n    htmlBody?: string;\n  };\n}\n\nexport function createGoogleConnectorContribution(\n  runtime: IAgentRuntime,\n): ConnectorContribution {\n  const service = new LifeOpsService(runtime);\n  return {\n    kind: \"google\",\n    capabilities: [\n      \"google.basic_identity\",\n      \"google.calendar.read\",\n      \"google.calendar.write\",\n      \"google.gmail.triage\",\n      \"google.gmail.send\",\n      \"google.gmail.manage\",\n    ],\n    modes: [\"local\"],\n    describe: { label: \"Google (Gmail + Calendar)\" },\n    // Gmail outbound goes through the owner-send-policy approval queue.\n    // `requiresApproval` is the registry-driven flag for this gate.\n    requiresApproval: true,\n    async start() {\n      // No-op: connect is initiated through the dashboard OAuth UI; the\n      // ConnectorContribution.start hook is reserved for connectors that\n      // need eager session restoration.\n    },\n    async disconnect() {\n      await service.disconnectGoogleConnector(\n        { side: \"owner\", mode: \"local\" },\n        INTERNAL_URL,\n      );\n    },\n    async verify(): Promise<boolean> {\n      const status = await service.getGoogleConnectorStatus(INTERNAL_URL);\n      return Boolean(status.connected);\n    },\n    async status(): Promise<ConnectorStatus> {\n      try {\n        const status = await service.getGoogleConnectorStatus(INTERNAL_URL);\n        return legacyStatusToConnectorStatus(status);\n      } catch (error) {\n        return {\n          state: \"disconnected\",\n          message: error instanceof Error ? error.message : String(error),\n          observedAt: new Date().toISOString(),\n        };\n      }\n    },\n    async send(payload: unknown): Promise<DispatchResult> {\n      if (!isConnectorSendPayload(payload)) return rejectInvalidPayload();\n      const meta = (payload as GoogleSendPayload).metadata ?? {};\n      try {\n        const result = await service.sendGmailMessage(INTERNAL_URL, {\n          mode: \"local\",\n          side: meta.side ?? \"owner\",\n          to: payload.target\n            .split(\",\")\n            .map((t) => t.trim())\n            .filter(Boolean),\n          subject: meta.subject ?? \"(no subject)\",\n          bodyText: payload.message,\n          confirmSend: true,\n        });\n        if (result.ok) {\n          return { ok: true };\n        }\n        return {\n          ok: false,\n          reason: \"transport_error\",\n          userActionable: false,\n          message: \"Gmail send returned a non-ok response.\",\n        };\n      } catch (error) {\n        return errorToDispatchResult(error);\n      }\n    },\n  };\n}\n"],"mappings":"AAYA,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAoBA,SAAS,kCACd,SACuB;AACvB,QAAM,UAAU,IAAI,eAAe,OAAO;AAC1C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,OAAO,CAAC,OAAO;AAAA,IACf,UAAU,EAAE,OAAO,4BAA4B;AAAA;AAAA;AAAA,IAG/C,kBAAkB;AAAA,IAClB,MAAM,QAAQ;AAAA,IAId;AAAA,IACA,MAAM,aAAa;AACjB,YAAM,QAAQ;AAAA,QACZ,EAAE,MAAM,SAAS,MAAM,QAAQ;AAAA,QAC/B;AAAA,MACF;AAAA,IACF;AAAA,IACA,MAAM,SAA2B;AAC/B,YAAM,SAAS,MAAM,QAAQ,yBAAyB,YAAY;AAClE,aAAO,QAAQ,OAAO,SAAS;AAAA,IACjC;AAAA,IACA,MAAM,SAAmC;AACvC,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,yBAAyB,YAAY;AAClE,eAAO,8BAA8B,MAAM;AAAA,MAC7C,SAAS,OAAO;AACd,eAAO;AAAA,UACL,OAAO;AAAA,UACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC9D,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,QACrC;AAAA,MACF;AAAA,IACF;AAAA,IACA,MAAM,KAAK,SAA2C;AACpD,UAAI,CAAC,uBAAuB,OAAO,EAAG,QAAO,qBAAqB;AAClE,YAAM,OAAQ,QAA8B,YAAY,CAAC;AACzD,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,iBAAiB,cAAc;AAAA,UAC1D,MAAM;AAAA,UACN,MAAM,KAAK,QAAQ;AAAA,UACnB,IAAI,QAAQ,OACT,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AAAA,UACjB,SAAS,KAAK,WAAW;AAAA,UACzB,UAAU,QAAQ;AAAA,UAClB,aAAa;AAAA,QACf,CAAC;AACD,YAAI,OAAO,IAAI;AACb,iBAAO,EAAE,IAAI,KAAK;AAAA,QACpB;AACA,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,QAAQ;AAAA,UACR,gBAAgB;AAAA,UAChB,SAAS;AAAA,QACX;AAAA,MACF,SAAS,OAAO;AACd,eAAO,sBAAsB,KAAK;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/lifeops/connectors/imessage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * iMessage connector contribution.
+ *
+ * Wraps the LifeOps iMessage mixin (`service-mixin-imessage.ts`). Local-only;
+ * the iMessage runtime service is provided by `@elizaos/plugin-imessage` /
+ * `plugin-bluebubbles` on macOS.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ConnectorContribution } from "./contract.js";
+export declare function createIMessageConnectorContribution(runtime: IAgentRuntime): ConnectorContribution;
+//# sourceMappingURL=imessage.d.ts.map

package/dist/lifeops/connectors/imessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage.d.ts","sourceRoot":"","sources":["../../../src/lifeops/connectors/imessage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,eAAe,CAAC;AAEvB,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,aAAa,GACrB,qBAAqB,CA4CvB"}