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

package/dist/actions/autofill.js

@@ -0,0 +1,370 @@
+import {
+  logger,
+  requireConfirmation,
+  resolveActionArgs
+} from "@elizaos/core";
+import {
+  DEFAULT_AUTOFILL_WHITELIST,
+  extractRegistrableDomain,
+  isUrlWhitelisted,
+  normalizeAutofillDomain
+} from "../lifeops/autofill-whitelist.js";
+import { requireFeatureEnabled } from "../lifeops/feature-flags.js";
+import { FeatureNotEnabledError } from "../lifeops/feature-flags.types.js";
+const ACTION_NAME = "AUTOFILL";
+const FIELD_PURPOSES = [
+  "email",
+  "password",
+  "name",
+  "phone",
+  "custom"
+];
+const WHITELIST_CACHE_KEY = "eliza:lifeops-autofill-whitelist";
+const DEVICE_BUS_URL_ENV = "ELIZA_DEVICE_BUS_URL";
+const DEVICE_BUS_TOKEN_ENV = "ELIZA_DEVICE_BUS_TOKEN";
+const SUBACTIONS = {
+  fill: {
+    description: "Request a one-field autofill via the browser extension password manager. Refused on non-whitelisted domains.",
+    descriptionCompressed: "autofill one field(field,domain) extension+password-manager allowlist-gated",
+    required: ["field", "domain"],
+    optional: ["url"]
+  },
+  whitelist_add: {
+    description: "Add a domain to the autofill allowlist. Requires confirmed:true.",
+    descriptionCompressed: "add domain autofill allowlist confirmed-true",
+    required: ["domain", "confirmed"]
+  },
+  whitelist_list: {
+    description: "List the effective autofill allowlist (defaults plus user-added entries).",
+    descriptionCompressed: "list autofill allowlist defaults+user",
+    required: []
+  }
+};
+function hasRuntimeCache(runtime) {
+  if (!runtime || typeof runtime !== "object") return false;
+  const r = runtime;
+  return typeof r.getCache === "function" && typeof r.setCache === "function";
+}
+async function loadUserDomains(runtime) {
+  if (!hasRuntimeCache(runtime)) return [];
+  const cached = await runtime.getCache(WHITELIST_CACHE_KEY);
+  if (!Array.isArray(cached)) return [];
+  return cached.filter((v) => typeof v === "string");
+}
+async function saveUserDomains(runtime, domains) {
+  if (!hasRuntimeCache(runtime)) {
+    throw new Error("AUTOFILL_WHITELIST_CACHE_UNAVAILABLE");
+  }
+  await runtime.setCache(WHITELIST_CACHE_KEY, domains);
+}
+async function effectiveWhitelist(runtime) {
+  const user = await loadUserDomains(runtime);
+  const merged = /* @__PURE__ */ new Set();
+  for (const d of DEFAULT_AUTOFILL_WHITELIST) {
+    const n = normalizeAutofillDomain(d);
+    if (n) merged.add(n);
+  }
+  for (const d of user) {
+    const n = normalizeAutofillDomain(d);
+    if (n) merged.add(n);
+  }
+  return [...merged].sort();
+}
+function readDeviceBusConfig(runtime) {
+  const readString = (key) => {
+    const env = process.env[key]?.trim();
+    if (env) return env;
+    const setting = runtime?.getSetting?.(key);
+    return typeof setting === "string" && setting.trim().length > 0 ? setting.trim() : null;
+  };
+  const url = readString(DEVICE_BUS_URL_ENV);
+  if (!url) return null;
+  return { url, token: readString(DEVICE_BUS_TOKEN_ENV) };
+}
+const AUTOFILL_NEEDS_INPUT_ERRORS = /* @__PURE__ */ new Set([
+  "MISSING_TAB_URL",
+  "INVALID_TAB_URL",
+  "MISSING_DOMAIN",
+  "INVALID_DOMAIN",
+  "INVALID_FIELD_PURPOSE",
+  "CONFIRMATION_REQUIRED",
+  "PERSISTENCE_UNAVAILABLE",
+  "FEATURE_NOT_ENABLED",
+  "FEATURE_DISABLED"
+]);
+function failure(error, extra) {
+  const needsInput = AUTOFILL_NEEDS_INPUT_ERRORS.has(error);
+  return {
+    text: "",
+    success: false,
+    values: {
+      success: false,
+      error,
+      ...needsInput ? { requiresConfirmation: true } : {}
+    },
+    data: {
+      actionName: ACTION_NAME,
+      error,
+      ...needsInput ? { requiresConfirmation: true } : {},
+      ...extra
+    }
+  };
+}
+function asFieldPurpose(value) {
+  if (typeof value !== "string") return null;
+  const lower = value.trim().toLowerCase();
+  return FIELD_PURPOSES.includes(lower) ? lower : null;
+}
+async function dispatchToExtension(runtime, payload) {
+  const config = readDeviceBusConfig(runtime);
+  if (!config) {
+    logger.warn(
+      { action: ACTION_NAME },
+      `[${ACTION_NAME}] device bus not configured; extension cannot be reached from agent`
+    );
+    return { dispatched: false, via: "none" };
+  }
+  const endpoint = `${config.url.replace(/\/$/, "")}/api/v1/device-bus/intents`;
+  const response = await fetch(endpoint, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      ...config.token ? { Authorization: `Bearer ${config.token}` } : {}
+    },
+    body: JSON.stringify({
+      kind: "autofill.requestFill",
+      payload
+    }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    return {
+      dispatched: false,
+      via: "device-bus",
+      detail: text.slice(0, 500)
+    };
+  }
+  return { dispatched: true, via: "device-bus" };
+}
+async function handleFill(runtime, params) {
+  try {
+    await requireFeatureEnabled(runtime, "browser.automation");
+  } catch (error) {
+    if (error instanceof FeatureNotEnabledError) {
+      return failure(error.code, {
+        featureKey: error.featureKey,
+        message: error.message
+      });
+    }
+    throw error;
+  }
+  const fieldPurpose = asFieldPurpose(params.field);
+  if (!fieldPurpose) {
+    return failure("INVALID_FIELD_PURPOSE", { allowed: [...FIELD_PURPOSES] });
+  }
+  const tabUrl = (params.url ?? params.domain ?? "").toString().trim();
+  if (!tabUrl) return failure("MISSING_TAB_URL");
+  const whitelist = await effectiveWhitelist(runtime);
+  const check = isUrlWhitelisted(tabUrl, whitelist);
+  if (!check.registrableDomain) {
+    return failure("INVALID_TAB_URL");
+  }
+  if (!check.allowed) {
+    logger.warn(
+      {
+        action: ACTION_NAME,
+        registrableDomain: check.registrableDomain,
+        fieldPurpose
+      },
+      `[${ACTION_NAME}] refused non-whitelisted domain ${check.registrableDomain}`
+    );
+    return {
+      text: `Autofill refused: ${check.registrableDomain} is not in your autofill whitelist. Add it explicitly with the whitelist_add subaction if you trust this site.`,
+      success: false,
+      values: {
+        success: false,
+        reason: "not-whitelisted",
+        requiresConfirmation: true,
+        registrableDomain: check.registrableDomain
+      },
+      data: {
+        actionName: ACTION_NAME,
+        reason: "not-whitelisted",
+        requiresConfirmation: true,
+        registrableDomain: check.registrableDomain,
+        fieldPurpose
+      }
+    };
+  }
+  const dispatch = await dispatchToExtension(runtime, {
+    tabUrl,
+    fieldPurpose,
+    fieldSelector: null,
+    customKey: null
+  });
+  if (!dispatch.dispatched) {
+    return {
+      text: "",
+      success: false,
+      values: {
+        success: false,
+        reason: "extension-unreachable",
+        requiresConfirmation: true,
+        via: dispatch.via
+      },
+      data: {
+        actionName: ACTION_NAME,
+        reason: "extension-unreachable",
+        requiresConfirmation: true,
+        via: dispatch.via,
+        ...dispatch.detail ? { detail: dispatch.detail } : {}
+      }
+    };
+  }
+  logger.info(
+    {
+      action: ACTION_NAME,
+      registrableDomain: check.registrableDomain,
+      fieldPurpose
+    },
+    `[${ACTION_NAME}] dispatched autofill request for ${check.registrableDomain}`
+  );
+  return {
+    text: `Requested ${fieldPurpose} autofill on ${check.registrableDomain} via the browser extension.`,
+    success: true,
+    values: {
+      success: true,
+      registrableDomain: check.registrableDomain,
+      matched: check.matched,
+      fieldPurpose
+    },
+    data: {
+      actionName: ACTION_NAME,
+      registrableDomain: check.registrableDomain,
+      matched: check.matched,
+      fieldPurpose
+    }
+  };
+}
+async function handleWhitelistAdd(runtime, message, params) {
+  const rawDomain = (params.domain ?? "").toString().trim();
+  if (!rawDomain) {
+    return failure("MISSING_DOMAIN");
+  }
+  const normalized = extractRegistrableDomain(rawDomain);
+  if (!normalized) {
+    return failure("INVALID_DOMAIN", { input: rawDomain });
+  }
+  const prompt = `Add ${normalized} to the autofill whitelist?`;
+  const decision = await requireConfirmation({
+    runtime,
+    message,
+    actionName: "AUTOFILL_WHITELIST_ADD",
+    pendingKey: `whitelist:${normalized}`,
+    prompt
+  });
+  if (decision.status !== "confirmed") {
+    return failure(
+      decision.status === "pending" ? "CONFIRMATION_REQUIRED" : "CANCELLED",
+      { domain: normalized, awaitingUserInput: decision.status === "pending" }
+    );
+  }
+  const existing = await loadUserDomains(runtime);
+  const existingNormalized = existing.map((e) => normalizeAutofillDomain(e)).filter((v) => v !== null);
+  const alreadyShipped = DEFAULT_AUTOFILL_WHITELIST.includes(normalized);
+  const alreadyUser = existingNormalized.includes(normalized);
+  if (alreadyShipped || alreadyUser) {
+    return {
+      text: `Domain ${normalized} already whitelisted.`,
+      success: true,
+      values: { success: true, domain: normalized, added: false },
+      data: {
+        actionName: ACTION_NAME,
+        domain: normalized,
+        added: false,
+        source: alreadyShipped ? "default" : "user"
+      }
+    };
+  }
+  const next = [...existingNormalized, normalized];
+  try {
+    await saveUserDomains(runtime, next);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    logger.warn(
+      { action: ACTION_NAME, domain: normalized, detail },
+      `[${ACTION_NAME}] failed to persist ${normalized}: ${detail}`
+    );
+    return failure("PERSISTENCE_UNAVAILABLE", { domain: normalized, detail });
+  }
+  logger.info(
+    { action: ACTION_NAME, domain: normalized },
+    `[${ACTION_NAME}] added ${normalized} to user whitelist`
+  );
+  return {
+    text: `Added ${normalized} to the autofill whitelist.`,
+    success: true,
+    values: { success: true, domain: normalized, added: true },
+    data: {
+      actionName: ACTION_NAME,
+      domain: normalized,
+      added: true
+    }
+  };
+}
+async function handleWhitelistList(runtime) {
+  const user = await loadUserDomains(runtime);
+  const effective = await effectiveWhitelist(runtime);
+  return {
+    text: `Autofill whitelist (${effective.length} entries): ${effective.join(", ")}`,
+    success: true,
+    values: {
+      success: true,
+      count: effective.length
+    },
+    data: {
+      actionName: ACTION_NAME,
+      defaults: [...DEFAULT_AUTOFILL_WHITELIST],
+      userAdded: [...user],
+      effective: [...effective]
+    }
+  };
+}
+async function runAutofillHandler(runtime, message, state, options) {
+  const resolved = await resolveActionArgs({
+    runtime,
+    message,
+    state,
+    options,
+    actionName: ACTION_NAME,
+    subactions: SUBACTIONS
+  });
+  if (!resolved.ok) {
+    return {
+      success: false,
+      text: resolved.clarification,
+      data: { actionName: ACTION_NAME, missing: resolved.missing }
+    };
+  }
+  const { subaction, params } = resolved;
+  switch (subaction) {
+    case "fill":
+      return handleFill(runtime, params);
+    case "whitelist_add":
+      return handleWhitelistAdd(runtime, message, params);
+    case "whitelist_list":
+      return handleWhitelistList(runtime);
+  }
+}
+const __internal = {
+  effectiveWhitelist,
+  loadUserDomains,
+  saveUserDomains,
+  WHITELIST_CACHE_KEY
+};
+export {
+  __internal,
+  runAutofillHandler
+};
+//# sourceMappingURL=autofill.js.map

package/dist/actions/autofill.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/autofill.ts"],"sourcesContent":["import {\n  type ActionResult,\n  type HandlerOptions,\n  type IAgentRuntime,\n  logger,\n  type Memory,\n  requireConfirmation,\n  resolveActionArgs,\n  type State,\n  type SubactionsMap,\n} from \"@elizaos/core\";\nimport {\n  DEFAULT_AUTOFILL_WHITELIST,\n  extractRegistrableDomain,\n  isUrlWhitelisted,\n  normalizeAutofillDomain,\n} from \"../lifeops/autofill-whitelist.js\";\nimport { requireFeatureEnabled } from \"../lifeops/feature-flags.js\";\nimport { FeatureNotEnabledError } from \"../lifeops/feature-flags.types.js\";\n\nconst ACTION_NAME = \"AUTOFILL\";\n\nconst FIELD_PURPOSES = [\n  \"email\",\n  \"password\",\n  \"name\",\n  \"phone\",\n  \"custom\",\n] as const;\ntype FieldPurpose = (typeof FIELD_PURPOSES)[number];\n\nconst WHITELIST_CACHE_KEY = \"eliza:lifeops-autofill-whitelist\";\nconst DEVICE_BUS_URL_ENV = \"ELIZA_DEVICE_BUS_URL\";\nconst DEVICE_BUS_TOKEN_ENV = \"ELIZA_DEVICE_BUS_TOKEN\";\n\ntype AutofillSubaction = \"fill\" | \"whitelist_add\" | \"whitelist_list\";\n\ninterface AutofillParams {\n  field?: string;\n  domain?: string;\n  url?: string;\n  confirmed?: boolean;\n}\n\nconst SUBACTIONS: SubactionsMap<AutofillSubaction> = {\n  fill: {\n    description:\n      \"Request a one-field autofill via the browser extension password manager. Refused on non-whitelisted domains.\",\n    descriptionCompressed:\n      \"autofill one field(field,domain) extension+password-manager allowlist-gated\",\n    required: [\"field\", \"domain\"],\n    optional: [\"url\"],\n  },\n  whitelist_add: {\n    description:\n      \"Add a domain to the autofill allowlist. Requires confirmed:true.\",\n    descriptionCompressed: \"add domain autofill allowlist confirmed-true\",\n    required: [\"domain\", \"confirmed\"],\n  },\n  whitelist_list: {\n    description:\n      \"List the effective autofill allowlist (defaults plus user-added entries).\",\n    descriptionCompressed: \"list autofill allowlist defaults+user\",\n    required: [],\n  },\n};\n\ninterface RuntimeCacheLike {\n  getCache<T>(key: string): Promise<T | null | undefined>;\n  setCache<T>(key: string, value: T): Promise<boolean | undefined>;\n}\n\nfunction hasRuntimeCache(runtime: unknown): runtime is RuntimeCacheLike {\n  if (!runtime || typeof runtime !== \"object\") return false;\n  const r = runtime as Partial<RuntimeCacheLike>;\n  return typeof r.getCache === \"function\" && typeof r.setCache === \"function\";\n}\n\nasync function loadUserDomains(runtime: unknown): Promise<readonly string[]> {\n  if (!hasRuntimeCache(runtime)) return [];\n  const cached = await runtime.getCache<readonly string[]>(WHITELIST_CACHE_KEY);\n  if (!Array.isArray(cached)) return [];\n  return cached.filter((v): v is string => typeof v === \"string\");\n}\n\nasync function saveUserDomains(\n  runtime: unknown,\n  domains: readonly string[],\n): Promise<void> {\n  if (!hasRuntimeCache(runtime)) {\n    throw new Error(\"AUTOFILL_WHITELIST_CACHE_UNAVAILABLE\");\n  }\n  await runtime.setCache(WHITELIST_CACHE_KEY, domains);\n}\n\nasync function effectiveWhitelist(\n  runtime: unknown,\n): Promise<readonly string[]> {\n  const user = await loadUserDomains(runtime);\n  const merged = new Set<string>();\n  for (const d of DEFAULT_AUTOFILL_WHITELIST) {\n    const n = normalizeAutofillDomain(d);\n    if (n) merged.add(n);\n  }\n  for (const d of user) {\n    const n = normalizeAutofillDomain(d);\n    if (n) merged.add(n);\n  }\n  return [...merged].sort();\n}\n\nfunction readDeviceBusConfig(\n  runtime: { getSetting?: (key: string) => unknown } | undefined,\n): { url: string; token: string | null } | null {\n  const readString = (key: string): string | null => {\n    const env = process.env[key]?.trim();\n    if (env) return env;\n    const setting = runtime?.getSetting?.(key);\n    return typeof setting === \"string\" && setting.trim().length > 0\n      ? setting.trim()\n      : null;\n  };\n  const url = readString(DEVICE_BUS_URL_ENV);\n  if (!url) return null;\n  return { url, token: readString(DEVICE_BUS_TOKEN_ENV) };\n}\n\nconst AUTOFILL_NEEDS_INPUT_ERRORS = new Set([\n  \"MISSING_TAB_URL\",\n  \"INVALID_TAB_URL\",\n  \"MISSING_DOMAIN\",\n  \"INVALID_DOMAIN\",\n  \"INVALID_FIELD_PURPOSE\",\n  \"CONFIRMATION_REQUIRED\",\n  \"PERSISTENCE_UNAVAILABLE\",\n  \"FEATURE_NOT_ENABLED\",\n  \"FEATURE_DISABLED\",\n]);\n\nfunction failure(error: string, extra?: Record<string, unknown>): ActionResult {\n  const needsInput = AUTOFILL_NEEDS_INPUT_ERRORS.has(error);\n  return {\n    text: \"\",\n    success: false,\n    values: {\n      success: false,\n      error,\n      ...(needsInput ? { requiresConfirmation: true } : {}),\n    },\n    data: {\n      actionName: ACTION_NAME,\n      error,\n      ...(needsInput ? { requiresConfirmation: true } : {}),\n      ...extra,\n    },\n  };\n}\n\nfunction asFieldPurpose(value: unknown): FieldPurpose | null {\n  if (typeof value !== \"string\") return null;\n  const lower = value.trim().toLowerCase();\n  return (FIELD_PURPOSES as readonly string[]).includes(lower)\n    ? (lower as FieldPurpose)\n    : null;\n}\n\nasync function dispatchToExtension(\n  runtime: IAgentRuntime,\n  payload: {\n    readonly tabUrl: string;\n    readonly fieldPurpose: FieldPurpose;\n    readonly fieldSelector: string | null;\n    readonly customKey: string | null;\n  },\n): Promise<{\n  readonly dispatched: boolean;\n  readonly via: \"device-bus\" | \"none\";\n  readonly detail?: string;\n}> {\n  const config = readDeviceBusConfig(runtime);\n  if (!config) {\n    logger.warn(\n      { action: ACTION_NAME },\n      `[${ACTION_NAME}] device bus not configured; extension cannot be reached from agent`,\n    );\n    return { dispatched: false, via: \"none\" };\n  }\n  const endpoint = `${config.url.replace(/\\/$/, \"\")}/api/v1/device-bus/intents`;\n  const response = await fetch(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n    },\n    body: JSON.stringify({\n      kind: \"autofill.requestFill\",\n      payload,\n    }),\n    signal: AbortSignal.timeout(10_000),\n  });\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    return {\n      dispatched: false,\n      via: \"device-bus\",\n      detail: text.slice(0, 500),\n    };\n  }\n  return { dispatched: true, via: \"device-bus\" };\n}\n\nasync function handleFill(\n  runtime: IAgentRuntime,\n  params: AutofillParams,\n): Promise<ActionResult> {\n  try {\n    await requireFeatureEnabled(runtime, \"browser.automation\");\n  } catch (error) {\n    if (error instanceof FeatureNotEnabledError) {\n      return failure(error.code, {\n        featureKey: error.featureKey,\n        message: error.message,\n      });\n    }\n    throw error;\n  }\n\n  const fieldPurpose = asFieldPurpose(params.field);\n  if (!fieldPurpose) {\n    return failure(\"INVALID_FIELD_PURPOSE\", { allowed: [...FIELD_PURPOSES] });\n  }\n\n  const tabUrl = (params.url ?? params.domain ?? \"\").toString().trim();\n  if (!tabUrl) return failure(\"MISSING_TAB_URL\");\n\n  const whitelist = await effectiveWhitelist(runtime);\n  const check = isUrlWhitelisted(tabUrl, whitelist);\n  if (!check.registrableDomain) {\n    return failure(\"INVALID_TAB_URL\");\n  }\n  if (!check.allowed) {\n    logger.warn(\n      {\n        action: ACTION_NAME,\n        registrableDomain: check.registrableDomain,\n        fieldPurpose,\n      },\n      `[${ACTION_NAME}] refused non-whitelisted domain ${check.registrableDomain}`,\n    );\n    return {\n      text: `Autofill refused: ${check.registrableDomain} is not in your autofill whitelist. Add it explicitly with the whitelist_add subaction if you trust this site.`,\n      success: false,\n      values: {\n        success: false,\n        reason: \"not-whitelisted\",\n        requiresConfirmation: true,\n        registrableDomain: check.registrableDomain,\n      },\n      data: {\n        actionName: ACTION_NAME,\n        reason: \"not-whitelisted\",\n        requiresConfirmation: true,\n        registrableDomain: check.registrableDomain,\n        fieldPurpose,\n      },\n    };\n  }\n\n  const dispatch = await dispatchToExtension(runtime, {\n    tabUrl,\n    fieldPurpose,\n    fieldSelector: null,\n    customKey: null,\n  });\n  if (!dispatch.dispatched) {\n    return {\n      text: \"\",\n      success: false,\n      values: {\n        success: false,\n        reason: \"extension-unreachable\",\n        requiresConfirmation: true,\n        via: dispatch.via,\n      },\n      data: {\n        actionName: ACTION_NAME,\n        reason: \"extension-unreachable\",\n        requiresConfirmation: true,\n        via: dispatch.via,\n        ...(dispatch.detail ? { detail: dispatch.detail } : {}),\n      },\n    };\n  }\n\n  logger.info(\n    {\n      action: ACTION_NAME,\n      registrableDomain: check.registrableDomain,\n      fieldPurpose,\n    },\n    `[${ACTION_NAME}] dispatched autofill request for ${check.registrableDomain}`,\n  );\n  return {\n    text: `Requested ${fieldPurpose} autofill on ${check.registrableDomain} via the browser extension.`,\n    success: true,\n    values: {\n      success: true,\n      registrableDomain: check.registrableDomain,\n      matched: check.matched,\n      fieldPurpose,\n    },\n    data: {\n      actionName: ACTION_NAME,\n      registrableDomain: check.registrableDomain,\n      matched: check.matched,\n      fieldPurpose,\n    },\n  };\n}\n\nasync function handleWhitelistAdd(\n  runtime: IAgentRuntime,\n  message: Memory,\n  params: AutofillParams,\n): Promise<ActionResult> {\n  const rawDomain = (params.domain ?? \"\").toString().trim();\n  if (!rawDomain) {\n    return failure(\"MISSING_DOMAIN\");\n  }\n  const normalized = extractRegistrableDomain(rawDomain);\n  if (!normalized) {\n    return failure(\"INVALID_DOMAIN\", { input: rawDomain });\n  }\n  const prompt = `Add ${normalized} to the autofill whitelist?`;\n  const decision = await requireConfirmation({\n    runtime,\n    message,\n    actionName: \"AUTOFILL_WHITELIST_ADD\",\n    pendingKey: `whitelist:${normalized}`,\n    prompt,\n  });\n  if (decision.status !== \"confirmed\") {\n    return failure(\n      decision.status === \"pending\" ? \"CONFIRMATION_REQUIRED\" : \"CANCELLED\",\n      { domain: normalized, awaitingUserInput: decision.status === \"pending\" },\n    );\n  }\n  const existing = await loadUserDomains(runtime);\n  const existingNormalized = existing\n    .map((e) => normalizeAutofillDomain(e))\n    .filter((v): v is string => v !== null);\n  const alreadyShipped = DEFAULT_AUTOFILL_WHITELIST.includes(normalized);\n  const alreadyUser = existingNormalized.includes(normalized);\n  if (alreadyShipped || alreadyUser) {\n    return {\n      text: `Domain ${normalized} already whitelisted.`,\n      success: true,\n      values: { success: true, domain: normalized, added: false },\n      data: {\n        actionName: ACTION_NAME,\n        domain: normalized,\n        added: false,\n        source: alreadyShipped ? \"default\" : \"user\",\n      },\n    };\n  }\n  const next = [...existingNormalized, normalized];\n  try {\n    await saveUserDomains(runtime, next);\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    logger.warn(\n      { action: ACTION_NAME, domain: normalized, detail },\n      `[${ACTION_NAME}] failed to persist ${normalized}: ${detail}`,\n    );\n    return failure(\"PERSISTENCE_UNAVAILABLE\", { domain: normalized, detail });\n  }\n  logger.info(\n    { action: ACTION_NAME, domain: normalized },\n    `[${ACTION_NAME}] added ${normalized} to user whitelist`,\n  );\n  return {\n    text: `Added ${normalized} to the autofill whitelist.`,\n    success: true,\n    values: { success: true, domain: normalized, added: true },\n    data: {\n      actionName: ACTION_NAME,\n      domain: normalized,\n      added: true,\n    },\n  };\n}\n\nasync function handleWhitelistList(\n  runtime: IAgentRuntime,\n): Promise<ActionResult> {\n  const user = await loadUserDomains(runtime);\n  const effective = await effectiveWhitelist(runtime);\n  return {\n    text: `Autofill whitelist (${effective.length} entries): ${effective.join(\", \")}`,\n    success: true,\n    values: {\n      success: true,\n      count: effective.length,\n    },\n    data: {\n      actionName: ACTION_NAME,\n      defaults: [...DEFAULT_AUTOFILL_WHITELIST],\n      userAdded: [...user],\n      effective: [...effective],\n    },\n  };\n}\n\n/**\n * Handler function backing the CREDENTIALS umbrella's autofill subactions\n * (`fill`, `whitelist_add`, `whitelist_list`).\n *\n * Called from `./credentials.ts`; no Action object is registered for this\n * handler directly.\n */\nexport async function runAutofillHandler(\n  runtime: IAgentRuntime,\n  message: Memory,\n  state: State | undefined,\n  options: HandlerOptions | undefined,\n): Promise<ActionResult> {\n  const resolved = await resolveActionArgs<AutofillSubaction, AutofillParams>({\n    runtime,\n    message,\n    state,\n    options,\n    actionName: ACTION_NAME,\n    subactions: SUBACTIONS,\n  });\n  if (!resolved.ok) {\n    return {\n      success: false,\n      text: resolved.clarification,\n      data: { actionName: ACTION_NAME, missing: resolved.missing },\n    };\n  }\n\n  const { subaction, params } = resolved;\n  switch (subaction) {\n    case \"fill\":\n      return handleFill(runtime, params);\n    case \"whitelist_add\":\n      return handleWhitelistAdd(runtime, message, params);\n    case \"whitelist_list\":\n      return handleWhitelistList(runtime);\n  }\n}\n\nexport const __internal = {\n  effectiveWhitelist,\n  loadUserDomains,\n  saveUserDomains,\n  WHITELIST_CACHE_KEY,\n};\n"],"mappings":"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","names":[]}

package/dist/actions/block.d.ts

@@ -0,0 +1,30 @@
+/**
+ * BLOCK umbrella — folds phone-app blocking and desktop website blocking into
+ * a single umbrella keyed by `target: "app" | "website"`. Each target
+ * dispatches into its own backend handler.
+ *
+ * Actions (union of both surfaces):
+ *   block | unblock | status | request_permission | release | list_active
+ *
+ * Target/action support matrix:
+ *   app:     block, unblock, status
+ *   website: block, unblock, status, request_permission, release, list_active
+ *
+ * Calls with an `(app, <unsupported>)` pair raise `BlockTargetUnsupportedError`
+ * — there is no app-side equivalent for hosts-file rule lifecycle, so silently
+ * ignoring the verb would hide a real planner bug.
+ */
+import type { Action } from "@elizaos/core";
+type BlockTarget = "app" | "website";
+type BlockSubaction = "block" | "unblock" | "status" | "request_permission" | "release" | "list_active";
+export declare class BlockTargetUnsupportedError extends Error {
+    readonly target: BlockTarget;
+    readonly subaction: string;
+    readonly supportedSubactions: readonly BlockSubaction[];
+    constructor(target: BlockTarget, subaction: string);
+}
+export declare const blockAction: Action & {
+    suppressPostActionContinuation?: boolean;
+};
+export {};
+//# sourceMappingURL=block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/actions/block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,MAAM,EAQP,MAAM,eAAe,CAAC;AASvB,KAAK,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAErC,KAAK,cAAc,GACf,OAAO,GACP,SAAS,GACT,QAAQ,GACR,oBAAoB,GACpB,SAAS,GACT,aAAa,CAAC;AA4BlB,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,cAAc,EAAE,CAAC;gBAC5C,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;CAUnD;AAyLD,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IACjC,8BAA8B,CAAC,EAAE,OAAO,CAAC;CA+K1C,CAAC"}