@elizaos/plugin-inbox 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/inbox/migration.js

@@ -0,0 +1,114 @@
+import { logger, Service } from "@elizaos/core";
+const INBOX_MIGRATION_LOG_PREFIX = "[Inbox]";
+const INBOX_MIGRATION_SERVICE_TYPE = "inbox_migration";
+const SOURCE_SCHEMA = "app_lifeops";
+const TARGET_SCHEMA = "app_inbox";
+const MIGRATED_INBOX_TABLES = [
+  "life_inbox_triage_entries",
+  "life_inbox_triage_examples",
+  "life_email_unsubscribes"
+];
+function quoteIdent(name) {
+  return `"${name.replace(/"/g, '""')}"`;
+}
+async function sourceTableExists(exec, table) {
+  const rows = await exec(
+    `SELECT to_regclass('${SOURCE_SCHEMA}.${table}') IS NOT NULL AS present`
+  );
+  return rows[0]?.present === true || rows[0]?.present === "true";
+}
+async function targetTableIsEmpty(exec, table) {
+  const rows = await exec(
+    `SELECT NOT EXISTS (SELECT 1 FROM ${TARGET_SCHEMA}.${quoteIdent(table)}) AS empty`
+  );
+  return rows[0]?.empty === true || rows[0]?.empty === "true";
+}
+async function migrateInboxTable(exec, table) {
+  if (!await sourceTableExists(exec, table)) {
+    return { table, outcome: "source-missing" };
+  }
+  if (!await targetTableIsEmpty(exec, table)) {
+    return { table, outcome: "target-non-empty" };
+  }
+  const target = `${TARGET_SCHEMA}.${quoteIdent(table)}`;
+  const source = `${SOURCE_SCHEMA}.${quoteIdent(table)}`;
+  await exec(
+    `INSERT INTO ${target}
+       SELECT s.* FROM ${source} AS s
+       WHERE NOT EXISTS (
+         SELECT 1 FROM ${target} AS t WHERE t.id = s.id
+       )`
+  );
+  return { table, outcome: "copied" };
+}
+async function migrateInboxTables(exec) {
+  await exec(`CREATE SCHEMA IF NOT EXISTS ${TARGET_SCHEMA}`);
+  const results = [];
+  for (const table of MIGRATED_INBOX_TABLES) {
+    results.push(await migrateInboxTable(exec, table));
+  }
+  return results;
+}
+function getRuntimeDb(runtime) {
+  const db = runtime.db;
+  if (!db || typeof db.execute !== "function") {
+    throw new Error(
+      `${INBOX_MIGRATION_LOG_PREFIX} runtime.db is unavailable \u2014 @elizaos/plugin-sql must be loaded before @elizaos/plugin-inbox.`
+    );
+  }
+  return db;
+}
+function extractRows(result) {
+  if (Array.isArray(result)) {
+    return result.filter(
+      (row) => typeof row === "object" && row !== null && !Array.isArray(row)
+    );
+  }
+  if (result && typeof result === "object" && "rows" in result) {
+    const rows = result.rows;
+    if (Array.isArray(rows)) {
+      return rows.filter(
+        (row) => typeof row === "object" && row !== null && !Array.isArray(row)
+      );
+    }
+  }
+  return [];
+}
+class InboxMigrationService extends Service {
+  static serviceType = INBOX_MIGRATION_SERVICE_TYPE;
+  capabilityDescription = "Non-destructive one-time copy of inbox-triage rows from app_lifeops into app_inbox during the plugin-inbox carve-out.";
+  static async start(runtime) {
+    const service = new InboxMigrationService(runtime);
+    await service.run();
+    return service;
+  }
+  async run() {
+    const db = getRuntimeDb(this.runtime);
+    const { sql } = await import("drizzle-orm");
+    const exec = async (statement) => extractRows(await db.execute(sql.raw(statement)));
+    const results = await migrateInboxTables(exec);
+    const copied = results.filter((r) => r.outcome === "copied");
+    if (copied.length > 0) {
+      logger.info(
+        { tables: copied.map((r) => r.table) },
+        `${INBOX_MIGRATION_LOG_PREFIX} copied ${copied.length} inbox table(s) from ${SOURCE_SCHEMA} to ${TARGET_SCHEMA}`
+      );
+    } else {
+      logger.debug(
+        { results },
+        `${INBOX_MIGRATION_LOG_PREFIX} no inbox tables required copying (already migrated or fresh install)`
+      );
+    }
+  }
+  async stop() {
+  }
+}
+export {
+  INBOX_MIGRATION_LOG_PREFIX,
+  INBOX_MIGRATION_SERVICE_TYPE,
+  InboxMigrationService,
+  MIGRATED_INBOX_TABLES,
+  migrateInboxTable,
+  migrateInboxTables
+};
+//# sourceMappingURL=migration.js.map

package/dist/inbox/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/inbox/migration.ts"],"sourcesContent":["/**\n * Non-destructive data migration for the inbox-triage tables carved out of\n * @elizaos/plugin-personal-assistant.\n *\n * The three tables (`life_inbox_triage_entries`, `life_inbox_triage_examples`,\n * `life_email_unsubscribes`) used to live in the `app_lifeops` PostgreSQL\n * schema, created by plugin-personal-assistant. They now live in `app_inbox`,\n * created by this plugin's drizzle schema. Existing installs still hold the\n * owner's triage rows in `app_lifeops`, so on first boot we copy them across —\n * once, idempotently, and WITHOUT ever touching the source.\n *\n * Guards (per table, independently):\n *   1. Skip if the source table does not exist (fresh install / already dropped).\n *   2. Skip if the target table is non-empty (migration already ran, or the\n *      plugin owns live data).\n *   3. Otherwise copy every source row that is not already present in the target\n *      (a doubly-safe NOT EXISTS guard on the primary key).\n *\n * The source table is NEVER dropped or altered. The source and target share the\n * exact column shape (PA's `app_lifeops` drizzle def and this plugin's\n * `app_inbox` def are column-identical), so the `SELECT s.*` copy is safe.\n */\n\nimport { type IAgentRuntime, logger, Service } from \"@elizaos/core\";\n\nexport const INBOX_MIGRATION_LOG_PREFIX = \"[Inbox]\";\nexport const INBOX_MIGRATION_SERVICE_TYPE = \"inbox_migration\";\n\nconst SOURCE_SCHEMA = \"app_lifeops\";\nconst TARGET_SCHEMA = \"app_inbox\";\n\nexport const MIGRATED_INBOX_TABLES = [\n  \"life_inbox_triage_entries\",\n  \"life_inbox_triage_examples\",\n  \"life_email_unsubscribes\",\n] as const;\n\nexport type MigratedInboxTable = (typeof MIGRATED_INBOX_TABLES)[number];\n\nexport type SqlExecutor = (\n  sql: string,\n) => Promise<Array<Record<string, unknown>>>;\n\nexport interface TableMigrationResult {\n  table: MigratedInboxTable;\n  outcome: \"copied\" | \"source-missing\" | \"target-non-empty\";\n}\n\nfunction quoteIdent(name: string): string {\n  return `\"${name.replace(/\"/g, '\"\"')}\"`;\n}\n\nasync function sourceTableExists(\n  exec: SqlExecutor,\n  table: MigratedInboxTable,\n): Promise<boolean> {\n  const rows = await exec(\n    `SELECT to_regclass('${SOURCE_SCHEMA}.${table}') IS NOT NULL AS present`,\n  );\n  return rows[0]?.present === true || rows[0]?.present === \"true\";\n}\n\nasync function targetTableIsEmpty(\n  exec: SqlExecutor,\n  table: MigratedInboxTable,\n): Promise<boolean> {\n  const rows = await exec(\n    `SELECT NOT EXISTS (SELECT 1 FROM ${TARGET_SCHEMA}.${quoteIdent(table)}) AS empty`,\n  );\n  return rows[0]?.empty === true || rows[0]?.empty === \"true\";\n}\n\nexport async function migrateInboxTable(\n  exec: SqlExecutor,\n  table: MigratedInboxTable,\n): Promise<TableMigrationResult> {\n  if (!(await sourceTableExists(exec, table))) {\n    return { table, outcome: \"source-missing\" };\n  }\n  if (!(await targetTableIsEmpty(exec, table))) {\n    return { table, outcome: \"target-non-empty\" };\n  }\n\n  const target = `${TARGET_SCHEMA}.${quoteIdent(table)}`;\n  const source = `${SOURCE_SCHEMA}.${quoteIdent(table)}`;\n  await exec(\n    `INSERT INTO ${target}\n       SELECT s.* FROM ${source} AS s\n       WHERE NOT EXISTS (\n         SELECT 1 FROM ${target} AS t WHERE t.id = s.id\n       )`,\n  );\n  return { table, outcome: \"copied\" };\n}\n\nexport async function migrateInboxTables(\n  exec: SqlExecutor,\n): Promise<TableMigrationResult[]> {\n  await exec(`CREATE SCHEMA IF NOT EXISTS ${TARGET_SCHEMA}`);\n  const results: TableMigrationResult[] = [];\n  for (const table of MIGRATED_INBOX_TABLES) {\n    results.push(await migrateInboxTable(exec, table));\n  }\n  return results;\n}\n\ntype RuntimeDb = {\n  execute: (query: unknown) => Promise<unknown>;\n};\n\nfunction getRuntimeDb(runtime: IAgentRuntime): RuntimeDb {\n  const db = runtime.db as RuntimeDb | undefined;\n  if (!db || typeof db.execute !== \"function\") {\n    throw new Error(\n      `${INBOX_MIGRATION_LOG_PREFIX} runtime.db is unavailable — @elizaos/plugin-sql must be loaded before @elizaos/plugin-inbox.`,\n    );\n  }\n  return db;\n}\n\nfunction extractRows(result: unknown): Array<Record<string, unknown>> {\n  if (Array.isArray(result)) {\n    return result.filter(\n      (row): row is Record<string, unknown> =>\n        typeof row === \"object\" && row !== null && !Array.isArray(row),\n    );\n  }\n  if (result && typeof result === \"object\" && \"rows\" in result) {\n    const rows = (result as { rows: unknown }).rows;\n    if (Array.isArray(rows)) {\n      return rows.filter(\n        (row): row is Record<string, unknown> =>\n          typeof row === \"object\" && row !== null && !Array.isArray(row),\n      );\n    }\n  }\n  return [];\n}\n\n/**\n * Service whose `start()` performs the one-time, guarded, non-destructive copy\n * of the owner's inbox-triage rows from `app_lifeops` into `app_inbox`.\n */\nexport class InboxMigrationService extends Service {\n  static override readonly serviceType = INBOX_MIGRATION_SERVICE_TYPE;\n\n  override capabilityDescription =\n    \"Non-destructive one-time copy of inbox-triage rows from app_lifeops into app_inbox during the plugin-inbox carve-out.\";\n\n  static async start(runtime: IAgentRuntime): Promise<InboxMigrationService> {\n    const service = new InboxMigrationService(runtime);\n    await service.run();\n    return service;\n  }\n\n  private async run(): Promise<void> {\n    const db = getRuntimeDb(this.runtime);\n    const { sql } = await import(\"drizzle-orm\");\n    const exec: SqlExecutor = async (statement) =>\n      extractRows(await db.execute(sql.raw(statement)));\n\n    const results = await migrateInboxTables(exec);\n    const copied = results.filter((r) => r.outcome === \"copied\");\n    if (copied.length > 0) {\n      logger.info(\n        { tables: copied.map((r) => r.table) },\n        `${INBOX_MIGRATION_LOG_PREFIX} copied ${copied.length} inbox table(s) from ${SOURCE_SCHEMA} to ${TARGET_SCHEMA}`,\n      );\n    } else {\n      logger.debug(\n        { results },\n        `${INBOX_MIGRATION_LOG_PREFIX} no inbox tables required copying (already migrated or fresh install)`,\n      );\n    }\n  }\n\n  override async stop(): Promise<void> {}\n}\n"],"mappings":"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","names":[]}

package/dist/inbox/reflection.d.ts

@@ -0,0 +1,40 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Before sending a drafted response, run a reflection LLM call to verify
+ * the owner actually confirmed the send. This catches ambiguous messages
+ * like "sure" (which could be a response to something else) or "wait"
+ * that might be misinterpreted as confirmation.
+ *
+ * Returns true if the reflection confirms the owner intended to send.
+ */
+export declare function reflectOnSendConfirmation(runtime: IAgentRuntime, opts: {
+    /** The owner's most recent message. */
+    userMessage: string;
+    /** The drafted response text that would be sent. */
+    draftText: string;
+    /** Where it would be sent. */
+    channelName: string;
+    /** Who it would be sent to. */
+    recipientName: string;
+}): Promise<{
+    confirmed: boolean;
+    reasoning: string;
+}>;
+/**
+ * Before auto-sending a reply without explicit owner confirmation, run a
+ * reflection check to verify the response is appropriate and safe.
+ */
+export declare function reflectOnAutoReply(runtime: IAgentRuntime, opts: {
+    /** The original inbound message. */
+    inboundText: string;
+    /** The proposed auto-reply. */
+    replyText: string;
+    /** Source channel. */
+    source: string;
+    /** Sender name. */
+    senderName: string;
+}): Promise<{
+    approved: boolean;
+    reasoning: string;
+}>;
+//# sourceMappingURL=reflection.d.ts.map

package/dist/inbox/reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.d.ts","sourceRoot":"","sources":["../../src/inbox/reflection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAsCnD;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE;IACJ,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqDpD;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE;IACJ,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA6DnD"}

package/dist/inbox/reflection.js

@@ -0,0 +1,142 @@
+import {
+  logger,
+  ModelType,
+  parseJsonModelRecord,
+  runWithTrajectoryContext
+} from "@elizaos/core";
+function parseReflectionObject(raw) {
+  const parsedJson = parseJsonModelRecord(raw);
+  if (parsedJson && typeof parsedJson === "object") {
+    return parsedJson;
+  }
+  return null;
+}
+function promptLine(value) {
+  const normalized = value.replace(/\s+/g, " ").trim();
+  return normalized.length > 0 ? normalized : "(empty)";
+}
+function readBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  return typeof value === "string" && value.trim().toLowerCase() === "true";
+}
+function readReasoning(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : "No reasoning provided";
+}
+async function reflectOnSendConfirmation(runtime, opts) {
+  const prompt = [
+    "Safety check for an inbox response system. Determine",
+    "whether the user has clearly confirmed they want to send a drafted message.",
+    "",
+    "Pending draft:",
+    `draftText: ${promptLine(opts.draftText)}`,
+    `recipientName: ${promptLine(opts.recipientName)}`,
+    `channelName: ${promptLine(opts.channelName)}`,
+    "",
+    "Owner message:",
+    `userMessage: ${promptLine(opts.userMessage)}`,
+    "",
+    "Determine if the user CLEARLY confirmed they want this message sent.",
+    "Confirmation signals: 'yes', 'send it', 'go ahead', 'looks good, send it', 'confirm'",
+    "Rejection signals: 'no', 'wait', 'hold on', 'change it', 'actually...', 'not now'",
+    "Ambiguous (treat as NOT confirmed): single words that could mean anything, unrelated responses",
+    "",
+    'Return JSON only, for example {"confirmed":true,"reasoning":"brief explanation"}.'
+  ].join("\n");
+  try {
+    const result = await runWithTrajectoryContext(
+      { purpose: "lifeops-inbox-reflect-autoreply" },
+      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt })
+    );
+    const raw = typeof result === "string" ? result : "";
+    const parsed = parseReflectionObject(raw);
+    if (parsed) {
+      return {
+        confirmed: readBoolean(parsed.confirmed),
+        reasoning: readReasoning(parsed.reasoning)
+      };
+    }
+    return {
+      confirmed: false,
+      reasoning: `Could not parse reflection: ${raw.slice(0, 100)}`
+    };
+  } catch (error) {
+    logger.warn(
+      {
+        src: "inbox-reflection",
+        error: error instanceof Error ? error.message : String(error)
+      },
+      "[InboxReflection] send confirmation reflection failed"
+    );
+    return {
+      confirmed: false,
+      reasoning: "Reflection check failed; defaulting to not confirmed for safety"
+    };
+  }
+}
+async function reflectOnAutoReply(runtime, opts) {
+  const prompt = [
+    "Safety check for an auto-reply system. The system wants to automatically",
+    "send a reply WITHOUT explicit owner confirmation. Determine if this",
+    "auto-reply is appropriate and safe to send.",
+    "",
+    "Inbound message:",
+    `senderName: ${promptLine(opts.senderName)}`,
+    `source: ${promptLine(opts.source)}`,
+    `inboundText: ${promptLine(opts.inboundText)}`,
+    "",
+    "Proposed reply:",
+    `replyText: ${promptLine(opts.replyText)}`,
+    "",
+    "Approve the auto-reply ONLY if ALL of these are true:",
+    "1. The reply is factually neutral and unlikely to cause harm",
+    "2. The reply doesn't make promises, commitments, or share sensitive info",
+    "3. The reply is appropriate for the tone and context of the conversation",
+    "4. The reply doesn't reveal private information about the owner",
+    "5. The message is routine (acknowledgement, simple greeting, basic info)",
+    "",
+    "Reject if ANY of these are true:",
+    "- The reply contains opinions, decisions, or commitments",
+    "- The conversation topic is sensitive (financial, legal, personal)",
+    "- The reply could be embarrassing or inappropriate",
+    "- The sender seems upset or the conversation is heated",
+    "",
+    'Return JSON only, for example {"approved":true,"reasoning":"brief explanation"}.'
+  ].join("\n");
+  try {
+    const result = await runWithTrajectoryContext(
+      { purpose: "lifeops-inbox-reflect-send" },
+      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt })
+    );
+    const raw = typeof result === "string" ? result : "";
+    const parsed = parseReflectionObject(raw);
+    if (parsed) {
+      return {
+        approved: readBoolean(parsed.approved),
+        reasoning: readReasoning(parsed.reasoning)
+      };
+    }
+    return {
+      approved: false,
+      reasoning: `Could not parse reflection: ${raw.slice(0, 100)}`
+    };
+  } catch (error) {
+    logger.warn(
+      {
+        src: "inbox-reflection",
+        error: error instanceof Error ? error.message : String(error)
+      },
+      "[InboxReflection] auto-reply reflection failed"
+    );
+    return {
+      approved: false,
+      reasoning: "Reflection check failed; blocking auto-reply for safety"
+    };
+  }
+}
+export {
+  reflectOnAutoReply,
+  reflectOnSendConfirmation
+};
+//# sourceMappingURL=reflection.js.map

package/dist/inbox/reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/inbox/reflection.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  logger,\n  ModelType,\n  parseJsonModelRecord,\n  runWithTrajectoryContext,\n} from \"@elizaos/core\";\n\nfunction parseReflectionObject(raw: string): Record<string, unknown> | null {\n  const parsedJson = parseJsonModelRecord<Record<string, unknown>>(raw);\n  if (parsedJson && typeof parsedJson === \"object\") {\n    return parsedJson;\n  }\n  return null;\n}\n\nfunction promptLine(value: string): string {\n  const normalized = value.replace(/\\s+/g, \" \").trim();\n  return normalized.length > 0 ? normalized : \"(empty)\";\n}\n\nfunction readBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  return typeof value === \"string\" && value.trim().toLowerCase() === \"true\";\n}\n\nfunction readReasoning(value: unknown): string {\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value.trim()\n    : \"No reasoning provided\";\n}\n\n// ---------------------------------------------------------------------------\n// Send confirmation reflection\n// ---------------------------------------------------------------------------\n\n/**\n * Before sending a drafted response, run a reflection LLM call to verify\n * the owner actually confirmed the send. This catches ambiguous messages\n * like \"sure\" (which could be a response to something else) or \"wait\"\n * that might be misinterpreted as confirmation.\n *\n * Returns true if the reflection confirms the owner intended to send.\n */\nexport async function reflectOnSendConfirmation(\n  runtime: IAgentRuntime,\n  opts: {\n    /** The owner's most recent message. */\n    userMessage: string;\n    /** The drafted response text that would be sent. */\n    draftText: string;\n    /** Where it would be sent. */\n    channelName: string;\n    /** Who it would be sent to. */\n    recipientName: string;\n  },\n): Promise<{ confirmed: boolean; reasoning: string }> {\n  const prompt = [\n    \"Safety check for an inbox response system. Determine\",\n    \"whether the user has clearly confirmed they want to send a drafted message.\",\n    \"\",\n    \"Pending draft:\",\n    `draftText: ${promptLine(opts.draftText)}`,\n    `recipientName: ${promptLine(opts.recipientName)}`,\n    `channelName: ${promptLine(opts.channelName)}`,\n    \"\",\n    \"Owner message:\",\n    `userMessage: ${promptLine(opts.userMessage)}`,\n    \"\",\n    \"Determine if the user CLEARLY confirmed they want this message sent.\",\n    \"Confirmation signals: 'yes', 'send it', 'go ahead', 'looks good, send it', 'confirm'\",\n    \"Rejection signals: 'no', 'wait', 'hold on', 'change it', 'actually...', 'not now'\",\n    \"Ambiguous (treat as NOT confirmed): single words that could mean anything, unrelated responses\",\n    \"\",\n    'Return JSON only, for example {\"confirmed\":true,\"reasoning\":\"brief explanation\"}.',\n  ].join(\"\\n\");\n\n  try {\n    const result = await runWithTrajectoryContext(\n      { purpose: \"lifeops-inbox-reflect-autoreply\" },\n      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt }),\n    );\n    const raw = typeof result === \"string\" ? result : \"\";\n    const parsed = parseReflectionObject(raw);\n    if (parsed) {\n      return {\n        confirmed: readBoolean(parsed.confirmed),\n        reasoning: readReasoning(parsed.reasoning),\n      };\n    }\n    return {\n      confirmed: false,\n      reasoning: `Could not parse reflection: ${raw.slice(0, 100)}`,\n    };\n  } catch (error) {\n    logger.warn(\n      {\n        src: \"inbox-reflection\",\n        error: error instanceof Error ? error.message : String(error),\n      },\n      \"[InboxReflection] send confirmation reflection failed\",\n    );\n    // On error, default to NOT confirmed (safer)\n    return {\n      confirmed: false,\n      reasoning:\n        \"Reflection check failed; defaulting to not confirmed for safety\",\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Auto-reply safety reflection\n// ---------------------------------------------------------------------------\n\n/**\n * Before auto-sending a reply without explicit owner confirmation, run a\n * reflection check to verify the response is appropriate and safe.\n */\nexport async function reflectOnAutoReply(\n  runtime: IAgentRuntime,\n  opts: {\n    /** The original inbound message. */\n    inboundText: string;\n    /** The proposed auto-reply. */\n    replyText: string;\n    /** Source channel. */\n    source: string;\n    /** Sender name. */\n    senderName: string;\n  },\n): Promise<{ approved: boolean; reasoning: string }> {\n  const prompt = [\n    \"Safety check for an auto-reply system. The system wants to automatically\",\n    \"send a reply WITHOUT explicit owner confirmation. Determine if this\",\n    \"auto-reply is appropriate and safe to send.\",\n    \"\",\n    \"Inbound message:\",\n    `senderName: ${promptLine(opts.senderName)}`,\n    `source: ${promptLine(opts.source)}`,\n    `inboundText: ${promptLine(opts.inboundText)}`,\n    \"\",\n    \"Proposed reply:\",\n    `replyText: ${promptLine(opts.replyText)}`,\n    \"\",\n    \"Approve the auto-reply ONLY if ALL of these are true:\",\n    \"1. The reply is factually neutral and unlikely to cause harm\",\n    \"2. The reply doesn't make promises, commitments, or share sensitive info\",\n    \"3. The reply is appropriate for the tone and context of the conversation\",\n    \"4. The reply doesn't reveal private information about the owner\",\n    \"5. The message is routine (acknowledgement, simple greeting, basic info)\",\n    \"\",\n    \"Reject if ANY of these are true:\",\n    \"- The reply contains opinions, decisions, or commitments\",\n    \"- The conversation topic is sensitive (financial, legal, personal)\",\n    \"- The reply could be embarrassing or inappropriate\",\n    \"- The sender seems upset or the conversation is heated\",\n    \"\",\n    'Return JSON only, for example {\"approved\":true,\"reasoning\":\"brief explanation\"}.',\n  ].join(\"\\n\");\n\n  try {\n    const result = await runWithTrajectoryContext(\n      { purpose: \"lifeops-inbox-reflect-send\" },\n      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt }),\n    );\n    const raw = typeof result === \"string\" ? result : \"\";\n    const parsed = parseReflectionObject(raw);\n    if (parsed) {\n      return {\n        approved: readBoolean(parsed.approved),\n        reasoning: readReasoning(parsed.reasoning),\n      };\n    }\n\n    return {\n      approved: false,\n      reasoning: `Could not parse reflection: ${raw.slice(0, 100)}`,\n    };\n  } catch (error) {\n    logger.warn(\n      {\n        src: \"inbox-reflection\",\n        error: error instanceof Error ? error.message : String(error),\n      },\n      \"[InboxReflection] auto-reply reflection failed\",\n    );\n    return {\n      approved: false,\n      reasoning: \"Reflection check failed; blocking auto-reply for safety\",\n    };\n  }\n}\n"],"mappings":"AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,sBAAsB,KAA6C;AAC1E,QAAM,aAAa,qBAA8C,GAAG;AACpE,MAAI,cAAc,OAAO,eAAe,UAAU;AAChD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,WAAW,OAAuB;AACzC,QAAM,aAAa,MAAM,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACnD,SAAO,WAAW,SAAS,IAAI,aAAa;AAC9C;AAEA,SAAS,YAAY,OAAyB;AAC5C,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AACA,SAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,YAAY,MAAM;AACrE;AAEA,SAAS,cAAc,OAAwB;AAC7C,SAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,IACtD,MAAM,KAAK,IACX;AACN;AAcA,eAAsB,0BACpB,SACA,MAUoD;AACpD,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc,WAAW,KAAK,SAAS,CAAC;AAAA,IACxC,kBAAkB,WAAW,KAAK,aAAa,CAAC;AAAA,IAChD,gBAAgB,WAAW,KAAK,WAAW,CAAC;AAAA,IAC5C;AAAA,IACA;AAAA,IACA,gBAAgB,WAAW,KAAK,WAAW,CAAC;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AAEX,MAAI;AACF,UAAM,SAAS,MAAM;AAAA,MACnB,EAAE,SAAS,kCAAkC;AAAA,MAC7C,MAAM,QAAQ,SAAS,UAAU,YAAY,EAAE,OAAO,CAAC;AAAA,IACzD;AACA,UAAM,MAAM,OAAO,WAAW,WAAW,SAAS;AAClD,UAAM,SAAS,sBAAsB,GAAG;AACxC,QAAI,QAAQ;AACV,aAAO;AAAA,QACL,WAAW,YAAY,OAAO,SAAS;AAAA,QACvC,WAAW,cAAc,OAAO,SAAS;AAAA,MAC3C;AAAA,IACF;AACA,WAAO;AAAA,MACL,WAAW;AAAA,MACX,WAAW,+BAA+B,IAAI,MAAM,GAAG,GAAG,CAAC;AAAA,IAC7D;AAAA,EACF,SAAS,OAAO;AACd,WAAO;AAAA,MACL;AAAA,QACE,KAAK;AAAA,QACL,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,MACX,WACE;AAAA,IACJ;AAAA,EACF;AACF;AAUA,eAAsB,mBACpB,SACA,MAUmD;AACnD,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe,WAAW,KAAK,UAAU,CAAC;AAAA,IAC1C,WAAW,WAAW,KAAK,MAAM,CAAC;AAAA,IAClC,gBAAgB,WAAW,KAAK,WAAW,CAAC;AAAA,IAC5C;AAAA,IACA;AAAA,IACA,cAAc,WAAW,KAAK,SAAS,CAAC;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AAEX,MAAI;AACF,UAAM,SAAS,MAAM;AAAA,MACnB,EAAE,SAAS,6BAA6B;AAAA,MACxC,MAAM,QAAQ,SAAS,UAAU,YAAY,EAAE,OAAO,CAAC;AAAA,IACzD;AACA,UAAM,MAAM,OAAO,WAAW,WAAW,SAAS;AAClD,UAAM,SAAS,sBAAsB,GAAG;AACxC,QAAI,QAAQ;AACV,aAAO;AAAA,QACL,UAAU,YAAY,OAAO,QAAQ;AAAA,QACrC,WAAW,cAAc,OAAO,SAAS;AAAA,MAC3C;AAAA,IACF;AAEA,WAAO;AAAA,MACL,UAAU;AAAA,MACV,WAAW,+BAA+B,IAAI,MAAM,GAAG,GAAG,CAAC;AAAA,IAC7D;AAAA,EACF,SAAS,OAAO;AACd,WAAO;AAAA,MACL;AAAA,QACE,KAAK;AAAA,QACL,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D;AAAA,MACA;AAAA,IACF;AACA,WAAO;AAAA,MACL,UAAU;AAAA,MACV,WAAW;AAAA,IACb;AAAA,EACF;AACF;","names":[]}

package/dist/inbox/repository.d.ts

@@ -0,0 +1,58 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { OwnerAction, TriageClassification, TriageEntry, TriageExample, TriageUrgency } from "./types.js";
+export declare class InboxRepository {
+    private runtime;
+    constructor(runtime: IAgentRuntime);
+    private get agentId();
+    storeTriage(opts: {
+        source: string;
+        sourceRoomId?: string;
+        sourceEntityId?: string;
+        sourceMessageId?: string;
+        channelName: string;
+        channelType: string;
+        deepLink?: string;
+        classification: TriageClassification;
+        urgency: TriageUrgency;
+        confidence: number;
+        snippet: string;
+        senderName?: string;
+        threadContext?: string[];
+        triageReasoning?: string;
+        suggestedResponse?: string;
+    }): Promise<TriageEntry>;
+    getUnresolved(opts?: {
+        limit?: number;
+    }): Promise<TriageEntry[]>;
+    getUnresolvedForSender(opts: {
+        sourceEntityId?: string | null;
+        senderName?: string | null;
+        excludeSource?: string | null;
+        limit?: number;
+    }): Promise<TriageEntry[]>;
+    getByClassification(classification: TriageClassification, opts?: {
+        limit?: number;
+        unresolvedOnly?: boolean;
+    }): Promise<TriageEntry[]>;
+    getById(id: string): Promise<TriageEntry | null>;
+    getBySourceMessageId(sourceMessageId: string): Promise<TriageEntry | null>;
+    getBySourceMessageIds(sourceMessageIds: string[]): Promise<Set<string>>;
+    markResolved(id: string, opts?: {
+        draftResponse?: string;
+        autoReplied?: boolean;
+    }): Promise<void>;
+    getRecentForDigest(sinceIso: string): Promise<TriageEntry[]>;
+    getRecentAutoReplies(limit?: number): Promise<TriageEntry[]>;
+    countAutoRepliesSince(sinceIso: string): Promise<number>;
+    cleanupOlderThan(olderThanIso: string): Promise<number>;
+    storeExample(opts: {
+        source: string;
+        snippet: string;
+        classification: TriageClassification;
+        ownerAction: OwnerAction;
+        ownerClassification?: TriageClassification;
+        contextJson?: Record<string, unknown>;
+    }): Promise<TriageExample>;
+    getExamples(limit?: number): Promise<TriageExample[]>;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/inbox/repository.d.ts.map

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