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

package/dist/lifeops/google-scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-scopes.d.ts","sourceRoot":"","sources":["../../src/lifeops/google-scopes.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,oBAAoB,yCAA0C,CAAC;AAC5E,eAAO,MAAM,0BAA0B,sDACc,CAAC;AACtD,eAAO,MAAM,2BAA2B,oDACW,CAAC;AACpD,eAAO,MAAM,2BAA2B,mDACU,CAAC;AACnD,eAAO,MAAM,uBAAuB,mDACc,CAAC;AACnD,eAAO,MAAM,uBAAuB,+CACU,CAAC;AAC/C,eAAO,MAAM,yBAAyB,iDACU,CAAC;AACjD,eAAO,MAAM,iCAAiC,yDACU,CAAC;AAgBzD,eAAO,MAAM,qCAAqC,EAAE,uBAAuB,EACzC,CAAC;AAEnC,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,EACpC,mBAAmB,GAAE,SAAS,uBAAuB,EAA0C,GAC9F,uBAAuB,EAAE,CA0B3B;AAED,wBAAgB,uBAAuB,CACrC,GAAG,eAAe,EAAE,KAAK,CAAC,SAAS,uBAAuB,EAAE,GAAG,SAAS,CAAC,GACxE,uBAAuB,EAAE,CAgB3B;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,SAAS,uBAAuB,EAAE,GAC/C,MAAM,EAAE,CAWV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,uBAAuB,EAAE,CAqC3B"}

package/dist/lifeops/google-scopes.js

@@ -0,0 +1,118 @@
+import {
+  LIFEOPS_GOOGLE_CAPABILITIES
+} from "../contracts/index.js";
+const GOOGLE_OPENID_SCOPES = ["openid", "email", "profile"];
+const GOOGLE_CALENDAR_READ_SCOPE = "https://www.googleapis.com/auth/calendar.readonly";
+const GOOGLE_CALENDAR_WRITE_SCOPE = "https://www.googleapis.com/auth/calendar.events";
+const GOOGLE_GMAIL_METADATA_SCOPE = "https://www.googleapis.com/auth/gmail.metadata";
+const GOOGLE_GMAIL_READ_SCOPE = "https://www.googleapis.com/auth/gmail.readonly";
+const GOOGLE_GMAIL_SEND_SCOPE = "https://www.googleapis.com/auth/gmail.send";
+const GOOGLE_GMAIL_MODIFY_SCOPE = "https://www.googleapis.com/auth/gmail.modify";
+const GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE = "https://www.googleapis.com/auth/gmail.settings.basic";
+const GOOGLE_CAPABILITY_SCOPE_MAP = {
+  "google.basic_identity": [...GOOGLE_OPENID_SCOPES],
+  "google.calendar.read": [GOOGLE_CALENDAR_READ_SCOPE],
+  "google.calendar.write": [GOOGLE_CALENDAR_WRITE_SCOPE],
+  // Reading message bodies requires gmail.readonly rather than gmail.metadata.
+  "google.gmail.triage": [GOOGLE_GMAIL_READ_SCOPE],
+  "google.gmail.send": [GOOGLE_GMAIL_SEND_SCOPE],
+  // Managing labels, filters, and archive/trash flows (auto-unsubscribe).
+  "google.gmail.manage": [
+    GOOGLE_GMAIL_MODIFY_SCOPE,
+    GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE
+  ]
+};
+const DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES = [...LIFEOPS_GOOGLE_CAPABILITIES];
+function normalizeGoogleCapabilities(value, defaultCapabilities = DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES) {
+  const allowed = new Set(LIFEOPS_GOOGLE_CAPABILITIES);
+  const normalized = [];
+  const seen = /* @__PURE__ */ new Set();
+  const source = value ? Array.from(value) : [...defaultCapabilities];
+  for (const candidate of source) {
+    if (typeof candidate !== "string") {
+      continue;
+    }
+    if (!allowed.has(candidate)) {
+      continue;
+    }
+    const capability = candidate;
+    if (seen.has(capability)) {
+      continue;
+    }
+    seen.add(capability);
+    normalized.push(capability);
+  }
+  if (!seen.has("google.basic_identity")) {
+    normalized.unshift("google.basic_identity");
+  }
+  return normalized;
+}
+function unionGoogleCapabilities(...capabilityLists) {
+  const merged = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const list of capabilityLists) {
+    if (!list) {
+      continue;
+    }
+    for (const capability of normalizeGoogleCapabilities(list)) {
+      if (seen.has(capability)) continue;
+      seen.add(capability);
+      merged.push(capability);
+    }
+  }
+  return merged.length > 0 ? merged : [...DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES];
+}
+function googleCapabilitiesToScopes(capabilities) {
+  const scopes = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const capability of normalizeGoogleCapabilities(capabilities)) {
+    for (const scope of GOOGLE_CAPABILITY_SCOPE_MAP[capability]) {
+      if (seen.has(scope)) continue;
+      seen.add(scope);
+      scopes.push(scope);
+    }
+  }
+  return scopes;
+}
+function googleScopesToCapabilities(scopes) {
+  const granted = new Set(scopes.map((scope) => scope.trim()).filter(Boolean));
+  const capabilities = [];
+  const hasIdentity = GOOGLE_OPENID_SCOPES.some((scope) => granted.has(scope));
+  if (hasIdentity) {
+    capabilities.push("google.basic_identity");
+  }
+  const hasCalendarRead = granted.has(GOOGLE_CALENDAR_READ_SCOPE) || granted.has(GOOGLE_CALENDAR_WRITE_SCOPE);
+  if (hasCalendarRead) {
+    capabilities.push("google.calendar.read");
+  }
+  if (granted.has(GOOGLE_CALENDAR_WRITE_SCOPE)) {
+    capabilities.push("google.calendar.write");
+  }
+  const hasGmailTriage = granted.has(GOOGLE_GMAIL_METADATA_SCOPE) || granted.has(GOOGLE_GMAIL_READ_SCOPE);
+  if (hasGmailTriage) {
+    capabilities.push("google.gmail.triage");
+  }
+  if (granted.has(GOOGLE_GMAIL_SEND_SCOPE)) {
+    capabilities.push("google.gmail.send");
+  }
+  if (granted.has(GOOGLE_GMAIL_MODIFY_SCOPE) && granted.has(GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE)) {
+    capabilities.push("google.gmail.manage");
+  }
+  return capabilities;
+}
+export {
+  DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES,
+  GOOGLE_CALENDAR_READ_SCOPE,
+  GOOGLE_CALENDAR_WRITE_SCOPE,
+  GOOGLE_GMAIL_METADATA_SCOPE,
+  GOOGLE_GMAIL_MODIFY_SCOPE,
+  GOOGLE_GMAIL_READ_SCOPE,
+  GOOGLE_GMAIL_SEND_SCOPE,
+  GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE,
+  GOOGLE_OPENID_SCOPES,
+  googleCapabilitiesToScopes,
+  googleScopesToCapabilities,
+  normalizeGoogleCapabilities,
+  unionGoogleCapabilities
+};
+//# sourceMappingURL=google-scopes.js.map

package/dist/lifeops/google-scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/google-scopes.ts"],"sourcesContent":["import {\n  LIFEOPS_GOOGLE_CAPABILITIES,\n  type LifeOpsGoogleCapability,\n} from \"../contracts/index.js\";\n\nexport const GOOGLE_OPENID_SCOPES = [\"openid\", \"email\", \"profile\"] as const;\nexport const GOOGLE_CALENDAR_READ_SCOPE =\n  \"https://www.googleapis.com/auth/calendar.readonly\";\nexport const GOOGLE_CALENDAR_WRITE_SCOPE =\n  \"https://www.googleapis.com/auth/calendar.events\";\nexport const GOOGLE_GMAIL_METADATA_SCOPE =\n  \"https://www.googleapis.com/auth/gmail.metadata\";\nexport const GOOGLE_GMAIL_READ_SCOPE =\n  \"https://www.googleapis.com/auth/gmail.readonly\";\nexport const GOOGLE_GMAIL_SEND_SCOPE =\n  \"https://www.googleapis.com/auth/gmail.send\";\nexport const GOOGLE_GMAIL_MODIFY_SCOPE =\n  \"https://www.googleapis.com/auth/gmail.modify\";\nexport const GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE =\n  \"https://www.googleapis.com/auth/gmail.settings.basic\";\n\nconst GOOGLE_CAPABILITY_SCOPE_MAP: Record<LifeOpsGoogleCapability, string[]> = {\n  \"google.basic_identity\": [...GOOGLE_OPENID_SCOPES],\n  \"google.calendar.read\": [GOOGLE_CALENDAR_READ_SCOPE],\n  \"google.calendar.write\": [GOOGLE_CALENDAR_WRITE_SCOPE],\n  // Reading message bodies requires gmail.readonly rather than gmail.metadata.\n  \"google.gmail.triage\": [GOOGLE_GMAIL_READ_SCOPE],\n  \"google.gmail.send\": [GOOGLE_GMAIL_SEND_SCOPE],\n  // Managing labels, filters, and archive/trash flows (auto-unsubscribe).\n  \"google.gmail.manage\": [\n    GOOGLE_GMAIL_MODIFY_SCOPE,\n    GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE,\n  ],\n};\n\nexport const DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES: LifeOpsGoogleCapability[] =\n  [...LIFEOPS_GOOGLE_CAPABILITIES];\n\nexport function normalizeGoogleCapabilities(\n  value: Iterable<unknown> | undefined,\n  defaultCapabilities: readonly LifeOpsGoogleCapability[] = DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES,\n): LifeOpsGoogleCapability[] {\n  const allowed = new Set<LifeOpsGoogleCapability>(LIFEOPS_GOOGLE_CAPABILITIES);\n  const normalized: LifeOpsGoogleCapability[] = [];\n  const seen = new Set<LifeOpsGoogleCapability>();\n  const source = value ? Array.from(value) : [...defaultCapabilities];\n\n  for (const candidate of source) {\n    if (typeof candidate !== \"string\") {\n      continue;\n    }\n    if (!allowed.has(candidate as LifeOpsGoogleCapability)) {\n      continue;\n    }\n    const capability = candidate as LifeOpsGoogleCapability;\n    if (seen.has(capability)) {\n      continue;\n    }\n    seen.add(capability);\n    normalized.push(capability);\n  }\n\n  if (!seen.has(\"google.basic_identity\")) {\n    normalized.unshift(\"google.basic_identity\");\n  }\n\n  return normalized;\n}\n\nexport function unionGoogleCapabilities(\n  ...capabilityLists: Array<readonly LifeOpsGoogleCapability[] | undefined>\n): LifeOpsGoogleCapability[] {\n  const merged: LifeOpsGoogleCapability[] = [];\n  const seen = new Set<LifeOpsGoogleCapability>();\n  for (const list of capabilityLists) {\n    if (!list) {\n      continue;\n    }\n    for (const capability of normalizeGoogleCapabilities(list)) {\n      if (seen.has(capability)) continue;\n      seen.add(capability);\n      merged.push(capability);\n    }\n  }\n  return merged.length > 0\n    ? merged\n    : [...DEFAULT_GOOGLE_CONNECTOR_CAPABILITIES];\n}\n\nexport function googleCapabilitiesToScopes(\n  capabilities: readonly LifeOpsGoogleCapability[],\n): string[] {\n  const scopes: string[] = [];\n  const seen = new Set<string>();\n  for (const capability of normalizeGoogleCapabilities(capabilities)) {\n    for (const scope of GOOGLE_CAPABILITY_SCOPE_MAP[capability]) {\n      if (seen.has(scope)) continue;\n      seen.add(scope);\n      scopes.push(scope);\n    }\n  }\n  return scopes;\n}\n\nexport function googleScopesToCapabilities(\n  scopes: readonly string[],\n): LifeOpsGoogleCapability[] {\n  const granted = new Set(scopes.map((scope) => scope.trim()).filter(Boolean));\n  const capabilities: LifeOpsGoogleCapability[] = [];\n\n  const hasIdentity = GOOGLE_OPENID_SCOPES.some((scope) => granted.has(scope));\n  if (hasIdentity) {\n    capabilities.push(\"google.basic_identity\");\n  }\n\n  const hasCalendarRead =\n    granted.has(GOOGLE_CALENDAR_READ_SCOPE) ||\n    granted.has(GOOGLE_CALENDAR_WRITE_SCOPE);\n  if (hasCalendarRead) {\n    capabilities.push(\"google.calendar.read\");\n  }\n\n  if (granted.has(GOOGLE_CALENDAR_WRITE_SCOPE)) {\n    capabilities.push(\"google.calendar.write\");\n  }\n\n  const hasGmailTriage =\n    granted.has(GOOGLE_GMAIL_METADATA_SCOPE) ||\n    granted.has(GOOGLE_GMAIL_READ_SCOPE);\n  if (hasGmailTriage) {\n    capabilities.push(\"google.gmail.triage\");\n  }\n\n  if (granted.has(GOOGLE_GMAIL_SEND_SCOPE)) {\n    capabilities.push(\"google.gmail.send\");\n  }\n  if (\n    granted.has(GOOGLE_GMAIL_MODIFY_SCOPE) &&\n    granted.has(GOOGLE_GMAIL_SETTINGS_BASIC_SCOPE)\n  ) {\n    capabilities.push(\"google.gmail.manage\");\n  }\n  return capabilities;\n}\n"],"mappings":"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","names":[]}

package/dist/lifeops/handoff/store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `HandoffStore` — per-room handoff state.
+ *
+ * Promoted to a first-class `@elizaos/agent` runtime service in LifeOps Slice 3
+ * (`HandoffService`, serviceType `eliza_handoff`). The store implementation, its
+ * types, and the pure resume-evaluation helpers (`evaluateResume`,
+ * `describeResumeCondition`) now live inward in `@elizaos/agent`; this module
+ * re-exports them and adds {@link resolveHandoffStore}, which prefers the
+ * registered runtime service (first-wins dedup) and falls back to constructing
+ * the cache-backed store directly when the service is absent.
+ *
+ * Backing storage: runtime cache, keyed per-room (unchanged).
+ */
+import { type HandoffStore } from "@elizaos/agent";
+import type { IAgentRuntime } from "@elizaos/core";
+export { createHandoffStore, describeResumeCondition, evaluateResume, type HandoffEnterOpts, type HandoffStatus, type HandoffStore, type ResumeCondition, type ResumeEvaluation, type ResumeEvaluationInput, } from "@elizaos/agent";
+/**
+ * Resolve the handoff store: the registered runtime service when present, else a
+ * directly-constructed cache-backed store. Both read/write the same per-room
+ * cache keys, so the fallback is behaviorally identical.
+ */
+export declare function resolveHandoffStore(runtime: IAgentRuntime): HandoffStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/lifeops/handoff/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lifeops/handoff/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAGxE"}

package/dist/lifeops/handoff/store.js

@@ -0,0 +1,20 @@
+import {
+  createHandoffStore,
+  resolveHandoffService
+} from "@elizaos/agent";
+import {
+  createHandoffStore as createHandoffStore2,
+  describeResumeCondition,
+  evaluateResume
+} from "@elizaos/agent";
+function resolveHandoffStore(runtime) {
+  const service = resolveHandoffService(runtime);
+  return service ? service.getStore() : createHandoffStore(runtime);
+}
+export {
+  createHandoffStore2 as createHandoffStore,
+  describeResumeCondition,
+  evaluateResume,
+  resolveHandoffStore
+};
+//# sourceMappingURL=store.js.map

package/dist/lifeops/handoff/store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/handoff/store.ts"],"sourcesContent":["/**\n * `HandoffStore` — per-room handoff state.\n *\n * Promoted to a first-class `@elizaos/agent` runtime service in LifeOps Slice 3\n * (`HandoffService`, serviceType `eliza_handoff`). The store implementation, its\n * types, and the pure resume-evaluation helpers (`evaluateResume`,\n * `describeResumeCondition`) now live inward in `@elizaos/agent`; this module\n * re-exports them and adds {@link resolveHandoffStore}, which prefers the\n * registered runtime service (first-wins dedup) and falls back to constructing\n * the cache-backed store directly when the service is absent.\n *\n * Backing storage: runtime cache, keyed per-room (unchanged).\n */\n\nimport {\n  createHandoffStore,\n  type HandoffStore,\n  resolveHandoffService,\n} from \"@elizaos/agent\";\nimport type { IAgentRuntime } from \"@elizaos/core\";\n\nexport {\n  createHandoffStore,\n  describeResumeCondition,\n  evaluateResume,\n  type HandoffEnterOpts,\n  type HandoffStatus,\n  type HandoffStore,\n  type ResumeCondition,\n  type ResumeEvaluation,\n  type ResumeEvaluationInput,\n} from \"@elizaos/agent\";\n\n/**\n * Resolve the handoff store: the registered runtime service when present, else a\n * directly-constructed cache-backed store. Both read/write the same per-room\n * cache keys, so the fallback is behaviorally identical.\n */\nexport function resolveHandoffStore(runtime: IAgentRuntime): HandoffStore {\n  const service = resolveHandoffService(runtime);\n  return service ? service.getStore() : createHandoffStore(runtime);\n}\n"],"mappings":"AAcA;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AAGP;AAAA,EACE,sBAAAA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AAOA,SAAS,oBAAoB,SAAsC;AACxE,QAAM,UAAU,sBAAsB,OAAO;AAC7C,SAAO,UAAU,QAAQ,SAAS,IAAI,mBAAmB,OAAO;AAClE;","names":["createHandoffStore"]}

package/dist/lifeops/i18n/localized-examples-provider.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Async provider the planner runs once per turn to obtain a
+ * locale-bound `LocalizedActionExampleResolver`. It reads the canonical
+ * locale from `OwnerFactStore`, falls back to the lightweight heuristic
+ * on the most-recent message (`detectLocaleFromText`), and finally to
+ * the default locale (`"en"`). When the resolved locale is the source
+ * language (`en`), this provider returns `null` so `buildActionCatalog`
+ * skips the resolver path entirely.
+ *
+ * Wiring: registered in `plugin.ts` after `OwnerFactStore` and the
+ * `MultilingualPromptRegistry` are available on the runtime.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type LocalizedExamplesProvider } from "@elizaos/core";
+export declare function createOwnerLocaleExamplesProvider(runtime: IAgentRuntime): LocalizedExamplesProvider;
+//# sourceMappingURL=localized-examples-provider.d.ts.map

package/dist/lifeops/i18n/localized-examples-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-examples-provider.d.ts","sourceRoot":"","sources":["../../../src/lifeops/i18n/localized-examples-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,eAAe,CAAC;AAQvB,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,aAAa,GACrB,yBAAyB,CAsB3B"}

package/dist/lifeops/i18n/localized-examples-provider.js

@@ -0,0 +1,33 @@
+import {
+  resolveOwnerLocale
+} from "@elizaos/core";
+import { getOwnerFactStore } from "../owner/fact-store.js";
+import { createLocalizedExamplesResolver } from "./localized-examples-resolver.js";
+import {
+  getMultilingualPromptRegistry,
+  PROMPT_REGISTRY_DEFAULT_LOCALE
+} from "./prompt-registry.js";
+function createOwnerLocaleExamplesProvider(runtime) {
+  return async ({ recentMessage }) => {
+    const registry = getMultilingualPromptRegistry(runtime);
+    if (!registry) {
+      return null;
+    }
+    const store = getOwnerFactStore(runtime);
+    const ownerLocale = store ? (await store.read()).locale?.value ?? null : null;
+    const locale = resolveOwnerLocale({
+      ownerLocale,
+      recentMessage,
+      defaultLocale: PROMPT_REGISTRY_DEFAULT_LOCALE
+    });
+    if (locale === PROMPT_REGISTRY_DEFAULT_LOCALE) {
+      return null;
+    }
+    const resolver = createLocalizedExamplesResolver({ registry, locale });
+    return resolver;
+  };
+}
+export {
+  createOwnerLocaleExamplesProvider
+};
+//# sourceMappingURL=localized-examples-provider.js.map

package/dist/lifeops/i18n/localized-examples-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/i18n/localized-examples-provider.ts"],"sourcesContent":["/**\n * Async provider the planner runs once per turn to obtain a\n * locale-bound `LocalizedActionExampleResolver`. It reads the canonical\n * locale from `OwnerFactStore`, falls back to the lightweight heuristic\n * on the most-recent message (`detectLocaleFromText`), and finally to\n * the default locale (`\"en\"`). When the resolved locale is the source\n * language (`en`), this provider returns `null` so `buildActionCatalog`\n * skips the resolver path entirely.\n *\n * Wiring: registered in `plugin.ts` after `OwnerFactStore` and the\n * `MultilingualPromptRegistry` are available on the runtime.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  type LocalizedActionExampleResolver,\n  type LocalizedExamplesProvider,\n  resolveOwnerLocale,\n} from \"@elizaos/core\";\nimport { getOwnerFactStore } from \"../owner/fact-store.js\";\nimport { createLocalizedExamplesResolver } from \"./localized-examples-resolver.js\";\nimport {\n  getMultilingualPromptRegistry,\n  PROMPT_REGISTRY_DEFAULT_LOCALE,\n} from \"./prompt-registry.js\";\n\nexport function createOwnerLocaleExamplesProvider(\n  runtime: IAgentRuntime,\n): LocalizedExamplesProvider {\n  return async ({ recentMessage }) => {\n    const registry = getMultilingualPromptRegistry(runtime);\n    if (!registry) {\n      return null;\n    }\n    const store = getOwnerFactStore(runtime);\n    const ownerLocale = store\n      ? ((await store.read()).locale?.value ?? null)\n      : null;\n    const locale = resolveOwnerLocale({\n      ownerLocale,\n      recentMessage,\n      defaultLocale: PROMPT_REGISTRY_DEFAULT_LOCALE,\n    });\n    if (locale === PROMPT_REGISTRY_DEFAULT_LOCALE) {\n      return null;\n    }\n    const resolver: LocalizedActionExampleResolver =\n      createLocalizedExamplesResolver({ registry, locale });\n    return resolver;\n  };\n}\n"],"mappings":"AAcA;AAAA,EAGE;AAAA,OACK;AACP,SAAS,yBAAyB;AAClC,SAAS,uCAAuC;AAChD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEA,SAAS,kCACd,SAC2B;AAC3B,SAAO,OAAO,EAAE,cAAc,MAAM;AAClC,UAAM,WAAW,8BAA8B,OAAO;AACtD,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,IACT;AACA,UAAM,QAAQ,kBAAkB,OAAO;AACvC,UAAM,cAAc,SACd,MAAM,MAAM,KAAK,GAAG,QAAQ,SAAS,OACvC;AACJ,UAAM,SAAS,mBAAmB;AAAA,MAChC;AAAA,MACA;AAAA,MACA,eAAe;AAAA,IACjB,CAAC;AACD,QAAI,WAAW,gCAAgC;AAC7C,aAAO;AAAA,IACT;AACA,UAAM,WACJ,gCAAgC,EAAE,UAAU,OAAO,CAAC;AACtD,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/lifeops/i18n/localized-examples-resolver.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Resolver factory binding a {@link MultilingualPromptRegistry} to a single
+ * locale. Returns a `LocalizedActionExampleResolver` that the planner's
+ * `buildActionCatalog` consumes to swap English `ActionExample` pairs for
+ * the locale-specific variants registered by the default pack.
+ *
+ * Cycle-avoidance: this factory lives in app-lifeops because the registry
+ * key shape (`<actionName>.example.<index>`) is part of the registry's
+ * contract — keeping it consumer-side means core never imports plugin
+ * symbols. The runtime hook at `getLocalizedExamplesProvider` (defined in
+ * core) is the single seam between the two.
+ */
+import type { LocalizedActionExampleResolver } from "@elizaos/core";
+import type { MultilingualPromptRegistry } from "./prompt-registry.js";
+export interface LocalizedExamplesResolverOptions {
+    registry: MultilingualPromptRegistry;
+    /**
+     * Locale tag to look up. When the tag is one our registry doesn't carry,
+     * the resolver returns `null` for every lookup (English fall-through is
+     * applied by `buildActionCatalog`'s caller — partial coverage is fine).
+     */
+    locale: string;
+}
+/**
+ * Build a resolver that maps `(actionName, exampleIndex)` to the
+ * `[user, agent]` pair registered under `<actionName>.example.<index>` for
+ * `locale`. When the locale is unsupported by the registry the resolver is
+ * a no-op (returns `null` every call), which keeps the catalog on its
+ * English source.
+ */
+export declare function createLocalizedExamplesResolver(opts: LocalizedExamplesResolverOptions): LocalizedActionExampleResolver;
+//# sourceMappingURL=localized-examples-resolver.d.ts.map

package/dist/lifeops/i18n/localized-examples-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localized-examples-resolver.d.ts","sourceRoot":"","sources":["../../../src/lifeops/i18n/localized-examples-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,sBAAsB,CAAC;AAa9B,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,0BAA0B,CAAC;IACrC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,gCAAgC,GACrC,8BAA8B,CAehC"}

package/dist/lifeops/i18n/localized-examples-resolver.js

@@ -0,0 +1,28 @@
+const SUPPORTED_REGISTRY_LOCALES = /* @__PURE__ */ new Set([
+  "en",
+  "es",
+  "fr",
+  "ja"
+]);
+function isSupportedRegistryLocale(value) {
+  return SUPPORTED_REGISTRY_LOCALES.has(value);
+}
+function createLocalizedExamplesResolver(opts) {
+  if (!isSupportedRegistryLocale(opts.locale)) {
+    return () => null;
+  }
+  const locale = opts.locale;
+  const registry = opts.registry;
+  return ({ actionName, exampleIndex }) => {
+    const exampleKey = `${actionName}.example.${exampleIndex}`;
+    const pair = registry.getPair(exampleKey, locale);
+    if (!pair) {
+      return null;
+    }
+    return pair;
+  };
+}
+export {
+  createLocalizedExamplesResolver
+};
+//# sourceMappingURL=localized-examples-resolver.js.map

package/dist/lifeops/i18n/localized-examples-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/i18n/localized-examples-resolver.ts"],"sourcesContent":["/**\n * Resolver factory binding a {@link MultilingualPromptRegistry} to a single\n * locale. Returns a `LocalizedActionExampleResolver` that the planner's\n * `buildActionCatalog` consumes to swap English `ActionExample` pairs for\n * the locale-specific variants registered by the default pack.\n *\n * Cycle-avoidance: this factory lives in app-lifeops because the registry\n * key shape (`<actionName>.example.<index>`) is part of the registry's\n * contract — keeping it consumer-side means core never imports plugin\n * symbols. The runtime hook at `getLocalizedExamplesProvider` (defined in\n * core) is the single seam between the two.\n */\n\nimport type { LocalizedActionExampleResolver } from \"@elizaos/core\";\nimport type {\n  MultilingualPromptRegistry,\n  PromptLocale,\n} from \"./prompt-registry.js\";\n\nconst SUPPORTED_REGISTRY_LOCALES: ReadonlySet<PromptLocale> = new Set([\n  \"en\",\n  \"es\",\n  \"fr\",\n  \"ja\",\n]);\n\nfunction isSupportedRegistryLocale(value: string): value is PromptLocale {\n  return SUPPORTED_REGISTRY_LOCALES.has(value as PromptLocale);\n}\n\nexport interface LocalizedExamplesResolverOptions {\n  registry: MultilingualPromptRegistry;\n  /**\n   * Locale tag to look up. When the tag is one our registry doesn't carry,\n   * the resolver returns `null` for every lookup (English fall-through is\n   * applied by `buildActionCatalog`'s caller — partial coverage is fine).\n   */\n  locale: string;\n}\n\n/**\n * Build a resolver that maps `(actionName, exampleIndex)` to the\n * `[user, agent]` pair registered under `<actionName>.example.<index>` for\n * `locale`. When the locale is unsupported by the registry the resolver is\n * a no-op (returns `null` every call), which keeps the catalog on its\n * English source.\n */\nexport function createLocalizedExamplesResolver(\n  opts: LocalizedExamplesResolverOptions,\n): LocalizedActionExampleResolver {\n  if (!isSupportedRegistryLocale(opts.locale)) {\n    return () => null;\n  }\n  const locale = opts.locale;\n  const registry = opts.registry;\n\n  return ({ actionName, exampleIndex }) => {\n    const exampleKey = `${actionName}.example.${exampleIndex}`;\n    const pair = registry.getPair(exampleKey, locale);\n    if (!pair) {\n      return null;\n    }\n    return pair;\n  };\n}\n"],"mappings":"AAmBA,MAAM,6BAAwD,oBAAI,IAAI;AAAA,EACpE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,0BAA0B,OAAsC;AACvE,SAAO,2BAA2B,IAAI,KAAqB;AAC7D;AAmBO,SAAS,gCACd,MACgC;AAChC,MAAI,CAAC,0BAA0B,KAAK,MAAM,GAAG;AAC3C,WAAO,MAAM;AAAA,EACf;AACA,QAAM,SAAS,KAAK;AACpB,QAAM,WAAW,KAAK;AAEtB,SAAO,CAAC,EAAE,YAAY,aAAa,MAAM;AACvC,UAAM,aAAa,GAAG,UAAU,YAAY,YAAY;AACxD,UAAM,OAAO,SAAS,QAAQ,YAAY,MAAM;AAChD,QAAI,CAAC,MAAM;AACT,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/lifeops/i18n/prompt-registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * `MultilingualPromptRegistry` — registry for localized `ActionExample`
+ * pairs and short prompt fragments referenced by `exampleKey`.
+ *
+ * Background (per `IMPLEMENTATION_PLAN.md` §5.5 and `GAP_ASSESSMENT.md`
+ * §3.7): action examples and routing hints live as registered translation
+ * tables, not as `ActionExample` literals embedded in source. The user's
+ * locale is read from `OwnerFactStore.locale`; the planner can ask the
+ * registry for a localized example when surfacing the prompt to the LLM.
+ *
+ * The registry's only persistent state is in-memory; the default pack is
+ * loaded by `registerDefaultPromptPack`. The registry is registered onto
+ * the runtime so other actions / providers can resolve example pairs by
+ * key without owning the table themselves.
+ */
+import type { ActionExample, IAgentRuntime } from "@elizaos/core";
+export type PromptLocale = "en" | "es" | "fr" | "ja" | "ko" | "pt" | "tl" | "vi" | "zh-CN";
+export interface PromptExampleEntry {
+    /** Stable key referenced by actions, e.g. `"OWNER_ROUTINES.example.0"`. */
+    exampleKey: string;
+    /** Locale this entry covers. */
+    locale: PromptLocale;
+    /** Speaker turn for the user side. Use the standard `{{name1}}` template. */
+    user: ActionExample;
+    /** Speaker turn for the agent reply. Use the standard `{{agentName}}` template. */
+    agent: ActionExample;
+}
+export interface PromptRegistryFilter {
+    exampleKey?: string;
+    locale?: PromptLocale;
+}
+export interface MultilingualPromptRegistry {
+    register(entry: PromptExampleEntry): void;
+    /** Returns the full pair (`[user, agent]`) or null if unregistered. */
+    getPair(exampleKey: string, locale: PromptLocale): readonly [ActionExample, ActionExample] | null;
+    /** Returns the matching entry or null. */
+    get(exampleKey: string, locale: PromptLocale): PromptExampleEntry | null;
+    /** Lists every entry, optionally filtered. */
+    list(filter?: PromptRegistryFilter): PromptExampleEntry[];
+    keys(): string[];
+}
+export declare function createMultilingualPromptRegistry(): MultilingualPromptRegistry;
+export declare function registerMultilingualPromptRegistry(runtime: IAgentRuntime, registry: MultilingualPromptRegistry): void;
+export declare function getMultilingualPromptRegistry(runtime: IAgentRuntime): MultilingualPromptRegistry | null;
+export declare function registerDefaultPromptPack(registry: MultilingualPromptRegistry): void;
+/**
+ * Convenience for actions: build an `[user, agent]` pair list from a
+ * (key, locale) tuple set. Throws when an entry is missing — actions
+ * declare exactly which examples they need, so a missing one indicates a
+ * registration error and should fail fast at module-init time.
+ */
+export declare function resolveActionExamplePairs(registry: MultilingualPromptRegistry, references: ReadonlyArray<{
+    exampleKey: string;
+    locale: PromptLocale;
+}>): ActionExample[][];
+export declare const PROMPT_REGISTRY_DEFAULT_LOCALE: PromptLocale;
+export declare function getDefaultPromptRegistry(): MultilingualPromptRegistry;
+/**
+ * Resolve a single localized example pair from the default registry.
+ * Throws when the key isn't registered (intentional — fail fast at
+ * module-init).
+ */
+export declare function getDefaultPromptExamplePair(exampleKey: string, locale: PromptLocale): readonly [ActionExample, ActionExample];
+//# sourceMappingURL=prompt-registry.d.ts.map

package/dist/lifeops/i18n/prompt-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-registry.d.ts","sourceRoot":"","sources":["../../../src/lifeops/i18n/prompt-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,MAAM,YAAY,GACpB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,OAAO,CAAC;AAgBZ,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,6EAA6E;IAC7E,IAAI,EAAE,aAAa,CAAC;IACpB,mFAAmF;IACnF,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,uEAAuE;IACvE,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;IAClD,0CAA0C;IAC1C,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACzE,8CAA8C;IAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAAC;IAC1D,IAAI,IAAI,MAAM,EAAE,CAAC;CAClB;AAyED,wBAAgB,gCAAgC,IAAI,0BAA0B,CAE7E;AAYD,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAEN;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,GACrB,0BAA0B,GAAG,IAAI,CAEnC;AAgKD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,0BAA0B,GACnC,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,0BAA0B,EACpC,UAAU,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,GACtE,aAAa,EAAE,EAAE,CAUnB;AAED,eAAO,MAAM,8BAA8B,EAAE,YAA6B,CAAC;AAe3E,wBAAgB,wBAAwB,IAAI,0BAA0B,CAOrE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC,CAQzC"}