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

package/dist/inbox/triage-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/inbox/triage-classifier.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  logger,\n  ModelType,\n  parseJsonModelRecord,\n  resolveOptimizedPromptForRuntime,\n  runWithTrajectoryContext,\n} from \"@elizaos/core\";\nimport type {\n  InboundMessage,\n  InboxTriageConfig,\n  TriageClassification,\n  TriageExample,\n  TriageResult,\n} from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// LLM-based classification\n// ---------------------------------------------------------------------------\n\nexport class InboxTriageClassificationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"InboxTriageClassificationError\";\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction formatPromptScalar(value: unknown, maxLength = 600): string {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n  return String(value).replace(/\\s+/g, \" \").trim().slice(0, maxLength);\n}\n\n/**\n * Classify a batch of messages using the LLM. Returns one TriageResult per\n * input message, in the same order.\n */\nexport async function classifyMessages(\n  runtime: IAgentRuntime,\n  messages: InboundMessage[],\n  opts: {\n    config?: InboxTriageConfig;\n    examples?: TriageExample[];\n    ownerContext?: string;\n  },\n): Promise<TriageResult[]> {\n  if (messages.length === 0) return [];\n\n  const results: TriageResult[] = [];\n\n  // Process in batches of 10 to avoid prompt length issues\n  const batchSize = 10;\n  for (let i = 0; i < messages.length; i += batchSize) {\n    const batch = messages.slice(i, i + batchSize);\n    const batchResults = await classifyBatch(runtime, batch, opts);\n    results.push(...batchResults);\n  }\n\n  return results;\n}\n\nasync function classifyBatch(\n  runtime: IAgentRuntime,\n  messages: InboundMessage[],\n  opts: {\n    config?: InboxTriageConfig;\n    examples?: TriageExample[];\n    ownerContext?: string;\n  },\n): Promise<TriageResult[]> {\n  const prompt = buildTriagePrompt(messages, { ...opts, runtime });\n\n  let rawResponse = \"\";\n  try {\n    const result = await runWithTrajectoryContext(\n      { purpose: \"inbox_triage\" },\n      () => runtime.useModel(ModelType.TEXT_SMALL, { prompt }),\n    );\n    rawResponse = typeof result === \"string\" ? result : \"\";\n  } catch (error) {\n    logger.warn(\n      {\n        src: \"inbox-classifier\",\n        error: error instanceof Error ? error.message : String(error),\n      },\n      \"[InboxTriageClassifier] LLM classification failed\",\n    );\n    throw new InboxTriageClassificationError(\n      \"Inbox classification model call failed.\",\n    );\n  }\n\n  return parseTriageResults(rawResponse, messages.length);\n}\n\n/**\n * Static classification instructions for the inbox-triage task. Exposed as the\n * optimizable baseline so {@link resolveOptimizedPromptForRuntime} can swap in a\n * GEPA-optimized `inbox_triage` artifact when one is registered (#8795). The\n * dynamic owner context / examples / messages are scaffolded around it below.\n */\nexport const INBOX_TRIAGE_INSTRUCTIONS = [\n  \"Classify each message into one of these categories:\",\n  \"\",\n  \"- ignore: spam, irrelevant, automated notifications, bot messages, or general chat that needs no attention\",\n  \"- info: informational updates the owner might want to see but doesn't need to act on\",\n  \"- notify: important information the owner should see, but no response is needed\",\n  \"- needs_reply: someone is asking a question or expects a response from the owner\",\n  \"- urgent: time-sensitive, critical, or from a priority contact — needs immediate attention\",\n  \"\",\n  \"For each message, also provide:\",\n  \"- urgency: low / medium / high\",\n  \"- confidence: 0.0 to 1.0 (how sure you are about this classification)\",\n  \"- reasoning: brief explanation\",\n  \"- suggestedResponse: (optional) a brief draft response if classification is needs_reply or urgent\",\n].join(\"\\n\");\n\nexport function buildTriagePrompt(\n  messages: InboundMessage[],\n  opts: {\n    config?: InboxTriageConfig;\n    examples?: TriageExample[];\n    ownerContext?: string;\n    runtime?: IAgentRuntime;\n  },\n): string {\n  const sections: string[] = [];\n\n  const instructions = opts.runtime\n    ? resolveOptimizedPromptForRuntime(\n        opts.runtime,\n        \"inbox_triage\",\n        INBOX_TRIAGE_INSTRUCTIONS,\n      )\n    : INBOX_TRIAGE_INSTRUCTIONS;\n  sections.push(instructions);\n\n  // Owner context\n  if (opts.ownerContext) {\n    sections.push(\"\", \"Owner context:\", opts.ownerContext);\n  }\n\n  // Priority senders/channels\n  const config = opts.config;\n  if (config?.prioritySenders?.length) {\n    sections.push(\"\", \"Priority senders (treat as higher urgency):\");\n    for (const [index, sender] of config.prioritySenders.entries()) {\n      sections.push(`prioritySenders[${index}]: ${formatPromptScalar(sender)}`);\n    }\n  }\n  if (config?.priorityChannels?.length) {\n    sections.push(\"\", \"Priority channels:\");\n    for (const [index, channel] of config.priorityChannels.entries()) {\n      sections.push(\n        `priorityChannels[${index}]: ${formatPromptScalar(channel)}`,\n      );\n    }\n  }\n\n  // Few-shot examples\n  if (opts.examples && opts.examples.length > 0) {\n    sections.push(\"\", \"Examples from past triage decisions:\");\n    for (const [index, ex] of opts.examples.slice(0, 5).entries()) {\n      sections.push(\n        `examples[${index}]:`,\n        `  source: ${formatPromptScalar(ex.source, 120)}`,\n        `  snippet: ${formatPromptScalar(ex.snippet, 160)}`,\n        `  classification: ${ex.classification}`,\n        `  ownerClassification: ${ex.ownerClassification ?? \"\"}`,\n      );\n    }\n  }\n\n  // Messages to classify\n  sections.push(\"\", \"Messages to classify:\", \"\");\n  for (const [index, msg] of messages.entries()) {\n    const gmailHints: string[] = [];\n    if (msg.gmailIsImportant) gmailHints.push(\"Gmail-marked-important\");\n    if (msg.gmailLikelyReplyNeeded)\n      gmailHints.push(\"Gmail-likely-reply-needed\");\n\n    sections.push(\n      `messages[${index}]:`,\n      `  source: ${formatPromptScalar(msg.source, 120)}`,\n      `  channelName: ${formatPromptScalar(msg.channelName, 160)}`,\n      `  channelType: ${msg.channelType}`,\n      `  senderName: ${formatPromptScalar(msg.senderName, 160)}`,\n    );\n    for (const [hintIndex, hint] of gmailHints.entries()) {\n      sections.push(`  hints[${hintIndex}]: ${hint}`);\n    }\n    sections.push(`  text: ${formatPromptScalar(msg.text, 500)}`);\n    if (msg.threadMessages && msg.threadMessages.length > 0) {\n      for (const [threadIndex, threadMessage] of msg.threadMessages\n        .slice(-5)\n        .entries()) {\n        sections.push(\n          `  threadMessages[${threadIndex}]: ${formatPromptScalar(threadMessage, 240)}`,\n        );\n      }\n    }\n    sections.push(\"\");\n  }\n\n  sections.push(\n    \"Return JSON only as a single object with one results array entry per message in the same order.\",\n    \"Use this exact shape:\",\n    '{\"results\":[{\"classification\":\"ignore|info|notify|needs_reply|urgent\",\"urgency\":\"low|medium|high\",\"confidence\":0.0,\"reasoning\":\"brief explanation\",\"suggestedResponse\":null}]}',\n    // The `a|b|c` placeholders above list the allowed values — they are NOT\n    // literal output. Smaller/local models otherwise echo the pipe string\n    // (\"urgent|ignore\"), which fails strict validation. Be explicit.\n    'For \"classification\" output exactly one of: ignore, info, notify, needs_reply, urgent.',\n    'For \"urgency\" output exactly one of: low, medium, high.',\n    'Choose a single value per field — never output the \"|\" character or more than one option.',\n    \"suggestedResponse may be a brief draft response when useful, otherwise null.\",\n    \"\",\n    \"No prose, markdown, code fences, or <think>.\",\n  );\n\n  return sections.join(\"\\n\");\n}\n\n// Legacy JSON fallback: strip a surrounding markdown code fence from older\n// model output, e.g. ```json\\n[...]\\n``` or ```\\n[...]\\n```.\nconst TRIAGE_CODE_FENCE_PATTERN =\n  /^\\s*```(?:json|json5)?\\s*\\r?\\n?([\\s\\S]*?)\\r?\\n?```\\s*$/i;\n\n// Parse a legacy JSON array returned by older classifier prompts. We tolerate\n// code fences and leading <think> blocks, but we do NOT regex-slice an array\n// out of arbitrary prose because that silently accepts malformed output.\nfunction parseTriageJsonArray(raw: string): unknown[] {\n  let candidate = raw.trim();\n  if (candidate.length === 0) {\n    throw new InboxTriageClassificationError(\n      \"Inbox classification returned an empty response.\",\n    );\n  }\n  // Strip a leading <think>...</think> block (some reasoning models emit one).\n  const thinkEnd = candidate.indexOf(\"</think>\");\n  if (candidate.startsWith(\"<think>\") && thinkEnd !== -1) {\n    candidate = candidate.slice(thinkEnd + \"</think>\".length).trim();\n  }\n  const fenced = candidate.match(TRIAGE_CODE_FENCE_PATTERN);\n  if (fenced) {\n    candidate = (fenced[1] ?? \"\").trim();\n  }\n  if (!candidate.startsWith(\"[\")) {\n    throw new InboxTriageClassificationError(\n      \"Inbox classification did not return a JSON array.\",\n    );\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(candidate) as unknown;\n  } catch (error) {\n    logger.warn(\n      { src: \"inbox-classifier\", error: String(error) },\n      \"[InboxTriageClassifier] failed to parse LLM classification JSON\",\n    );\n    throw new InboxTriageClassificationError(\n      \"Inbox classification JSON parsing failed.\",\n    );\n  }\n  if (!Array.isArray(parsed)) {\n    throw new InboxTriageClassificationError(\n      \"Inbox classification did not return a JSON array.\",\n    );\n  }\n  return parsed;\n}\n\nfunction asStructuredArray(value: unknown): unknown[] | null {\n  return Array.isArray(value) ? value : null;\n}\n\nfunction parseTriageJsonObjectArray(raw: string): unknown[] | null {\n  const parsed = parseJsonModelRecord<Record<string, unknown>>(raw);\n  if (!parsed) {\n    return null;\n  }\n\n  const directArray =\n    asStructuredArray(parsed.results) ??\n    asStructuredArray(parsed.messages) ??\n    asStructuredArray(parsed.items) ??\n    asStructuredArray(parsed.classifications);\n  if (directArray) {\n    return directArray;\n  }\n\n  const classifications = asStructuredArray(parsed.classification);\n  if (!classifications) {\n    return null;\n  }\n\n  const urgencies = asStructuredArray(parsed.urgency) ?? [];\n  const confidences = asStructuredArray(parsed.confidence) ?? [];\n  const reasonings = asStructuredArray(parsed.reasoning) ?? [];\n  const suggestedResponses =\n    asStructuredArray(parsed.suggestedResponse) ??\n    asStructuredArray(parsed.suggested_response) ??\n    [];\n\n  return classifications.map((classification, index) => ({\n    classification,\n    urgency: urgencies[index],\n    confidence: confidences[index],\n    reasoning: reasonings[index],\n    suggestedResponse: suggestedResponses[index],\n  }));\n}\n\nfunction parseTriageStructuredArray(raw: string): unknown[] {\n  const jsonParsed = parseTriageJsonObjectArray(raw);\n  if (jsonParsed) {\n    return jsonParsed;\n  }\n  return parseTriageJsonArray(raw);\n}\n\nfunction normalizeOptionalString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  if (!trimmed || trimmed.toLowerCase() === \"null\") {\n    return undefined;\n  }\n  return trimmed;\n}\n\nfunction parseTriageResults(\n  raw: string,\n  expectedCount: number,\n): TriageResult[] {\n  const parsed = parseTriageStructuredArray(raw);\n\n  const results: TriageResult[] = [];\n  for (let i = 0; i < expectedCount; i++) {\n    const item = parsed[i];\n    if (!isRecord(item)) {\n      throw new InboxTriageClassificationError(\n        \"Inbox classification omitted one or more messages.\",\n      );\n    }\n    const classification = validClassification(item.classification);\n    const urgency = validUrgency(item.urgency);\n    const confidence = validConfidence(item.confidence);\n    if (!classification || !urgency || confidence === null) {\n      throw new InboxTriageClassificationError(\n        \"Inbox classification returned invalid structured fields.\",\n      );\n    }\n    results.push({\n      classification,\n      urgency,\n      confidence,\n      reasoning: normalizeOptionalString(item.reasoning) ?? \"\",\n      suggestedResponse: normalizeOptionalString(\n        item.suggestedResponse ?? item.suggested_response,\n      ),\n    });\n  }\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// Validation helpers\n// ---------------------------------------------------------------------------\n\nconst VALID_CLASSIFICATIONS = new Set<TriageClassification>([\n  \"ignore\",\n  \"info\",\n  \"notify\",\n  \"needs_reply\",\n  \"urgent\",\n]);\n\nconst VALID_URGENCIES = new Set([\"low\", \"medium\", \"high\"]);\n\nfunction validClassification(v: unknown): TriageClassification | null {\n  if (typeof v === \"string\") {\n    const normalized = v.trim().toLowerCase();\n    if (VALID_CLASSIFICATIONS.has(normalized as TriageClassification)) {\n      return normalized as TriageClassification;\n    }\n  }\n  return null;\n}\n\nfunction validUrgency(v: unknown): \"low\" | \"medium\" | \"high\" | null {\n  if (typeof v === \"string\") {\n    const normalized = v.trim().toLowerCase();\n    if (VALID_URGENCIES.has(normalized)) {\n      return normalized as \"low\" | \"medium\" | \"high\";\n    }\n  }\n  return null;\n}\n\nfunction validConfidence(v: unknown): number | null {\n  const numeric =\n    typeof v === \"string\" && v.trim().length > 0 ? Number(v.trim()) : v;\n  if (\n    typeof numeric === \"number\" &&\n    Number.isFinite(numeric) &&\n    numeric >= 0 &&\n    numeric <= 1\n  ) {\n    return numeric;\n  }\n  return null;\n}\n"],"mappings":"AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAaA,MAAM,uCAAuC,MAAM;AAAA,EACxD,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,QAAQ,KAAK,KAAK,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,mBAAmB,OAAgB,YAAY,KAAa;AACnE,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO;AAAA,EACT;AACA,SAAO,OAAO,KAAK,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;AACrE;AAMA,eAAsB,iBACpB,SACA,UACA,MAKyB;AACzB,MAAI,SAAS,WAAW,EAAG,QAAO,CAAC;AAEnC,QAAM,UAA0B,CAAC;AAGjC,QAAM,YAAY;AAClB,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK,WAAW;AACnD,UAAM,QAAQ,SAAS,MAAM,GAAG,IAAI,SAAS;AAC7C,UAAM,eAAe,MAAM,cAAc,SAAS,OAAO,IAAI;AAC7D,YAAQ,KAAK,GAAG,YAAY;AAAA,EAC9B;AAEA,SAAO;AACT;AAEA,eAAe,cACb,SACA,UACA,MAKyB;AACzB,QAAM,SAAS,kBAAkB,UAAU,EAAE,GAAG,MAAM,QAAQ,CAAC;AAE/D,MAAI,cAAc;AAClB,MAAI;AACF,UAAM,SAAS,MAAM;AAAA,MACnB,EAAE,SAAS,eAAe;AAAA,MAC1B,MAAM,QAAQ,SAAS,UAAU,YAAY,EAAE,OAAO,CAAC;AAAA,IACzD;AACA,kBAAc,OAAO,WAAW,WAAW,SAAS;AAAA,EACtD,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,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO,mBAAmB,aAAa,SAAS,MAAM;AACxD;AAQO,MAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEJ,SAAS,kBACd,UACA,MAMQ;AACR,QAAM,WAAqB,CAAC;AAE5B,QAAM,eAAe,KAAK,UACtB;AAAA,IACE,KAAK;AAAA,IACL;AAAA,IACA;AAAA,EACF,IACA;AACJ,WAAS,KAAK,YAAY;AAG1B,MAAI,KAAK,cAAc;AACrB,aAAS,KAAK,IAAI,kBAAkB,KAAK,YAAY;AAAA,EACvD;AAGA,QAAM,SAAS,KAAK;AACpB,MAAI,QAAQ,iBAAiB,QAAQ;AACnC,aAAS,KAAK,IAAI,6CAA6C;AAC/D,eAAW,CAAC,OAAO,MAAM,KAAK,OAAO,gBAAgB,QAAQ,GAAG;AAC9D,eAAS,KAAK,mBAAmB,KAAK,MAAM,mBAAmB,MAAM,CAAC,EAAE;AAAA,IAC1E;AAAA,EACF;AACA,MAAI,QAAQ,kBAAkB,QAAQ;AACpC,aAAS,KAAK,IAAI,oBAAoB;AACtC,eAAW,CAAC,OAAO,OAAO,KAAK,OAAO,iBAAiB,QAAQ,GAAG;AAChE,eAAS;AAAA,QACP,oBAAoB,KAAK,MAAM,mBAAmB,OAAO,CAAC;AAAA,MAC5D;AAAA,IACF;AAAA,EACF;AAGA,MAAI,KAAK,YAAY,KAAK,SAAS,SAAS,GAAG;AAC7C,aAAS,KAAK,IAAI,sCAAsC;AACxD,eAAW,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,MAAM,GAAG,CAAC,EAAE,QAAQ,GAAG;AAC7D,eAAS;AAAA,QACP,YAAY,KAAK;AAAA,QACjB,aAAa,mBAAmB,GAAG,QAAQ,GAAG,CAAC;AAAA,QAC/C,cAAc,mBAAmB,GAAG,SAAS,GAAG,CAAC;AAAA,QACjD,qBAAqB,GAAG,cAAc;AAAA,QACtC,0BAA0B,GAAG,uBAAuB,EAAE;AAAA,MACxD;AAAA,IACF;AAAA,EACF;AAGA,WAAS,KAAK,IAAI,yBAAyB,EAAE;AAC7C,aAAW,CAAC,OAAO,GAAG,KAAK,SAAS,QAAQ,GAAG;AAC7C,UAAM,aAAuB,CAAC;AAC9B,QAAI,IAAI,iBAAkB,YAAW,KAAK,wBAAwB;AAClE,QAAI,IAAI;AACN,iBAAW,KAAK,2BAA2B;AAE7C,aAAS;AAAA,MACP,YAAY,KAAK;AAAA,MACjB,aAAa,mBAAmB,IAAI,QAAQ,GAAG,CAAC;AAAA,MAChD,kBAAkB,mBAAmB,IAAI,aAAa,GAAG,CAAC;AAAA,MAC1D,kBAAkB,IAAI,WAAW;AAAA,MACjC,iBAAiB,mBAAmB,IAAI,YAAY,GAAG,CAAC;AAAA,IAC1D;AACA,eAAW,CAAC,WAAW,IAAI,KAAK,WAAW,QAAQ,GAAG;AACpD,eAAS,KAAK,WAAW,SAAS,MAAM,IAAI,EAAE;AAAA,IAChD;AACA,aAAS,KAAK,WAAW,mBAAmB,IAAI,MAAM,GAAG,CAAC,EAAE;AAC5D,QAAI,IAAI,kBAAkB,IAAI,eAAe,SAAS,GAAG;AACvD,iBAAW,CAAC,aAAa,aAAa,KAAK,IAAI,eAC5C,MAAM,EAAE,EACR,QAAQ,GAAG;AACZ,iBAAS;AAAA,UACP,oBAAoB,WAAW,MAAM,mBAAmB,eAAe,GAAG,CAAC;AAAA,QAC7E;AAAA,MACF;AAAA,IACF;AACA,aAAS,KAAK,EAAE;AAAA,EAClB;AAEA,WAAS;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA;AAAA,IAIA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,SAAO,SAAS,KAAK,IAAI;AAC3B;AAIA,MAAM,4BACJ;AAKF,SAAS,qBAAqB,KAAwB;AACpD,MAAI,YAAY,IAAI,KAAK;AACzB,MAAI,UAAU,WAAW,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAAW,UAAU,QAAQ,UAAU;AAC7C,MAAI,UAAU,WAAW,SAAS,KAAK,aAAa,IAAI;AACtD,gBAAY,UAAU,MAAM,WAAW,WAAW,MAAM,EAAE,KAAK;AAAA,EACjE;AACA,QAAM,SAAS,UAAU,MAAM,yBAAyB;AACxD,MAAI,QAAQ;AACV,iBAAa,OAAO,CAAC,KAAK,IAAI,KAAK;AAAA,EACrC;AACA,MAAI,CAAC,UAAU,WAAW,GAAG,GAAG;AAC9B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,SAAS;AAAA,EAC/B,SAAS,OAAO;AACd,WAAO;AAAA,MACL,EAAE,KAAK,oBAAoB,OAAO,OAAO,KAAK,EAAE;AAAA,MAChD;AAAA,IACF;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,kBAAkB,OAAkC;AAC3D,SAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ;AACxC;AAEA,SAAS,2BAA2B,KAA+B;AACjE,QAAM,SAAS,qBAA8C,GAAG;AAChE,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,EACT;AAEA,QAAM,cACJ,kBAAkB,OAAO,OAAO,KAChC,kBAAkB,OAAO,QAAQ,KACjC,kBAAkB,OAAO,KAAK,KAC9B,kBAAkB,OAAO,eAAe;AAC1C,MAAI,aAAa;AACf,WAAO;AAAA,EACT;AAEA,QAAM,kBAAkB,kBAAkB,OAAO,cAAc;AAC/D,MAAI,CAAC,iBAAiB;AACpB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,kBAAkB,OAAO,OAAO,KAAK,CAAC;AACxD,QAAM,cAAc,kBAAkB,OAAO,UAAU,KAAK,CAAC;AAC7D,QAAM,aAAa,kBAAkB,OAAO,SAAS,KAAK,CAAC;AAC3D,QAAM,qBACJ,kBAAkB,OAAO,iBAAiB,KAC1C,kBAAkB,OAAO,kBAAkB,KAC3C,CAAC;AAEH,SAAO,gBAAgB,IAAI,CAAC,gBAAgB,WAAW;AAAA,IACrD;AAAA,IACA,SAAS,UAAU,KAAK;AAAA,IACxB,YAAY,YAAY,KAAK;AAAA,IAC7B,WAAW,WAAW,KAAK;AAAA,IAC3B,mBAAmB,mBAAmB,KAAK;AAAA,EAC7C,EAAE;AACJ;AAEA,SAAS,2BAA2B,KAAwB;AAC1D,QAAM,aAAa,2BAA2B,GAAG;AACjD,MAAI,YAAY;AACd,WAAO;AAAA,EACT;AACA,SAAO,qBAAqB,GAAG;AACjC;AAEA,SAAS,wBAAwB,OAAoC;AACnE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,CAAC,WAAW,QAAQ,YAAY,MAAM,QAAQ;AAChD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,mBACP,KACA,eACgB;AAChB,QAAM,SAAS,2BAA2B,GAAG;AAE7C,QAAM,UAA0B,CAAC;AACjC,WAAS,IAAI,GAAG,IAAI,eAAe,KAAK;AACtC,UAAM,OAAO,OAAO,CAAC;AACrB,QAAI,CAAC,SAAS,IAAI,GAAG;AACnB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,UAAM,iBAAiB,oBAAoB,KAAK,cAAc;AAC9D,UAAM,UAAU,aAAa,KAAK,OAAO;AACzC,UAAM,aAAa,gBAAgB,KAAK,UAAU;AAClD,QAAI,CAAC,kBAAkB,CAAC,WAAW,eAAe,MAAM;AACtD,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,YAAQ,KAAK;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,wBAAwB,KAAK,SAAS,KAAK;AAAA,MACtD,mBAAmB;AAAA,QACjB,KAAK,qBAAqB,KAAK;AAAA,MACjC;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAMA,MAAM,wBAAwB,oBAAI,IAA0B;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,MAAM,kBAAkB,oBAAI,IAAI,CAAC,OAAO,UAAU,MAAM,CAAC;AAEzD,SAAS,oBAAoB,GAAyC;AACpE,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,aAAa,EAAE,KAAK,EAAE,YAAY;AACxC,QAAI,sBAAsB,IAAI,UAAkC,GAAG;AACjE,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,aAAa,GAA8C;AAClE,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,aAAa,EAAE,KAAK,EAAE,YAAY;AACxC,QAAI,gBAAgB,IAAI,UAAU,GAAG;AACnC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,gBAAgB,GAA2B;AAClD,QAAM,UACJ,OAAO,MAAM,YAAY,EAAE,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,KAAK,CAAC,IAAI;AACpE,MACE,OAAO,YAAY,YACnB,OAAO,SAAS,OAAO,KACvB,WAAW,KACX,WAAW,GACX;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

package/dist/inbox/types.d.ts

@@ -0,0 +1,124 @@
+import type { UUID } from "@elizaos/core";
+export type TriageClassification = "ignore" | "info" | "notify" | "needs_reply" | "urgent";
+export type TriageUrgency = "low" | "medium" | "high";
+export type OwnerAction = "confirmed" | "reclassified" | "edited_draft" | "ignored";
+export interface InboundMessage {
+    /** Memory UUID (chat) or Gmail message ID (email). */
+    id: string;
+    /** Connector source tag: "discord", "telegram", "gmail", etc. */
+    source: string;
+    /** elizaOS room UUID (chat channels only). */
+    roomId?: string;
+    /** Sender entity UUID. */
+    entityId?: string;
+    /** X DM conversation id when the source is x_dm. */
+    xConversationId?: string;
+    /** X user id to use for direct replies when the source is x_dm. */
+    xParticipantId?: string;
+    /** Human-readable sender name. */
+    senderName: string;
+    /** Sender email when the source provides one. */
+    senderEmail?: string;
+    /** Human-readable channel/conversation name. */
+    channelName: string;
+    /** Whether this is a DM or a group chat. */
+    channelType: "dm" | "group";
+    /** Full message text. */
+    text: string;
+    /** Short preview of the message. */
+    snippet: string;
+    /** Message timestamp (epoch ms). */
+    timestamp: number;
+    /** Platform deep link URL (if available). */
+    deepLink?: string;
+    /** Recent messages in the same thread (for context). */
+    threadMessages?: string[];
+    gmailMessageId?: string;
+    gmailIsImportant?: boolean;
+    gmailLikelyReplyNeeded?: boolean;
+    /** Stable per-conversation key. For chat: roomId. For Gmail: thread id. */
+    threadId?: string;
+    /** Identifies which Google grant the message came from when multiple Gmail accounts exist. */
+    gmailAccountId?: string;
+    /** Display label for the Gmail account (e.g., `work@example.com`). */
+    gmailAccountEmail?: string;
+    /** Local phone/iMessage identity that handled the message, when known. */
+    phoneAccountId?: string;
+    /** Human-readable label for the local phone identity. */
+    phoneAccountLabel?: string;
+    /** Local phone number that handled the message, when known. */
+    phoneNumber?: string;
+    /** ISO timestamp of when the user last viewed this thread. */
+    lastSeenAt?: string;
+    /** ISO timestamp if the user has replied since this message arrived. */
+    repliedAt?: string;
+    /** 0–100 score; higher = more important. */
+    priorityScore?: number;
+    /**
+     * DM, small/medium group chat, or public channel/broadcast.
+     * Mirrors the existing `channelType` field but with broader coverage; downstream
+     * code will migrate from `channelType` to `chatType` over time.
+     */
+    chatType?: "dm" | "group" | "channel";
+    /** For groups, number of participants. */
+    participantCount?: number;
+}
+export interface TriageEntry {
+    id: string;
+    agentId: string;
+    source: string;
+    sourceRoomId: string | null;
+    sourceEntityId: string | null;
+    sourceMessageId: string | null;
+    channelName: string;
+    channelType: string;
+    deepLink: string | null;
+    classification: TriageClassification;
+    urgency: TriageUrgency;
+    confidence: number;
+    snippet: string;
+    senderName: string | null;
+    threadContext: string[] | null;
+    triageReasoning: string | null;
+    suggestedResponse: string | null;
+    draftResponse: string | null;
+    autoReplied: boolean;
+    resolved: boolean;
+    resolvedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TriageExample {
+    id: string;
+    agentId: string;
+    source: string;
+    snippet: string;
+    classification: TriageClassification;
+    ownerAction: OwnerAction;
+    ownerClassification: TriageClassification | null;
+    contextJson: Record<string, unknown>;
+    createdAt: string;
+}
+export interface TriageResult {
+    classification: TriageClassification;
+    urgency: TriageUrgency;
+    confidence: number;
+    reasoning: string;
+    suggestedResponse?: string;
+}
+export interface DeferredInboxDraft {
+    triageEntryId: string;
+    source: string;
+    targetRoomId?: UUID;
+    targetEntityId?: UUID;
+    gmailMessageId?: string;
+    xConversationId?: string;
+    xParticipantId?: string;
+    approvalRequestId?: string;
+    draftText: string;
+    deepLink: string | null;
+    channelName: string;
+    senderName: string;
+}
+export type { InboxAutoReplyConfig, InboxTriageConfig, InboxTriageRules, } from "@elizaos/shared";
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/inbox/types.js

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

package/dist/inbox/types.js.map

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

package/dist/inbox/unsubscribe-repository.d.ts

@@ -0,0 +1,14 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { EmailUnsubscribeRecord } from "./email-unsubscribe-types.js";
+export declare class InboxUnsubscribeRepository {
+    private readonly runtime;
+    constructor(runtime: IAgentRuntime);
+    private get agentId();
+    createEmailUnsubscribe(record: EmailUnsubscribeRecord): Promise<void>;
+    listEmailUnsubscribes(args?: {
+        limit?: number;
+    }): Promise<EmailUnsubscribeRecord[]>;
+    getEmailUnsubscribe(id: string): Promise<EmailUnsubscribeRecord | null>;
+    findEmailUnsubscribeBySender(senderEmail: string): Promise<EmailUnsubscribeRecord | null>;
+}
+//# sourceMappingURL=unsubscribe-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe-repository.d.ts","sourceRoot":"","sources":["../../src/inbox/unsubscribe-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAanD,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,8BAA8B,CAAC;AAsCtC,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD,OAAO,KAAK,OAAO,GAElB;IAEK,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE,qBAAqB,CACzB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAa9B,mBAAmB,CACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAanC,4BAA4B,CAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;CAa1C"}

package/dist/inbox/unsubscribe-repository.js

@@ -0,0 +1,112 @@
+import {
+  executeRawSql,
+  parseJsonRecord,
+  sqlBoolean,
+  sqlInteger,
+  sqlJson,
+  sqlQuote,
+  sqlText,
+  toBoolean,
+  toNumber,
+  toText
+} from "../db/sql.js";
+function parseEmailUnsubscribe(row) {
+  return {
+    id: toText(row.id),
+    agentId: toText(row.agent_id),
+    senderEmail: toText(row.sender_email),
+    senderDisplay: toText(row.sender_display),
+    senderDomain: row.sender_domain ? toText(row.sender_domain) : null,
+    listId: row.list_id ? toText(row.list_id) : null,
+    method: toText(row.method, "manual_only"),
+    status: toText(row.status, "failed"),
+    httpStatusCode: row.http_status_code === null || row.http_status_code === void 0 ? null : toNumber(row.http_status_code, 0),
+    httpFinalUrl: row.http_final_url ? toText(row.http_final_url) : null,
+    filterCreated: toBoolean(row.filter_created),
+    filterId: row.filter_id ? toText(row.filter_id) : null,
+    threadsTrashed: toNumber(row.threads_trashed, 0),
+    errorMessage: row.error_message ? toText(row.error_message) : null,
+    metadata: parseJsonRecord(row.metadata_json),
+    createdAt: toText(row.created_at),
+    updatedAt: toText(row.updated_at)
+  };
+}
+class InboxUnsubscribeRepository {
+  constructor(runtime) {
+    this.runtime = runtime;
+  }
+  runtime;
+  get agentId() {
+    return this.runtime.agentId;
+  }
+  async createEmailUnsubscribe(record) {
+    await executeRawSql(
+      this.runtime,
+      `INSERT INTO app_inbox.life_email_unsubscribes (
+        id, agent_id, sender_email, sender_display, sender_domain, list_id,
+        method, status, http_status_code, http_final_url, filter_created,
+        filter_id, threads_trashed, error_message, metadata_json,
+        created_at, updated_at
+      ) VALUES (
+        ${sqlQuote(record.id)},
+        ${sqlQuote(record.agentId)},
+        ${sqlQuote(record.senderEmail)},
+        ${sqlQuote(record.senderDisplay)},
+        ${sqlText(record.senderDomain)},
+        ${sqlText(record.listId)},
+        ${sqlQuote(record.method)},
+        ${sqlQuote(record.status)},
+        ${record.httpStatusCode === null ? "NULL" : sqlInteger(record.httpStatusCode)},
+        ${sqlText(record.httpFinalUrl)},
+        ${sqlBoolean(record.filterCreated)},
+        ${sqlText(record.filterId)},
+        ${sqlInteger(record.threadsTrashed)},
+        ${sqlText(record.errorMessage)},
+        ${sqlJson(record.metadata)},
+        ${sqlQuote(record.createdAt)},
+        ${sqlQuote(record.updatedAt)}
+      )`
+    );
+  }
+  async listEmailUnsubscribes(args = {}) {
+    const limit = Math.max(1, Math.min(500, Math.trunc(args.limit ?? 100)));
+    const rows = await executeRawSql(
+      this.runtime,
+      `SELECT *
+         FROM app_inbox.life_email_unsubscribes
+        WHERE agent_id = ${sqlQuote(this.agentId)}
+        ORDER BY created_at DESC
+        LIMIT ${limit}`
+    );
+    return rows.map(parseEmailUnsubscribe);
+  }
+  async getEmailUnsubscribe(id) {
+    const rows = await executeRawSql(
+      this.runtime,
+      `SELECT *
+         FROM app_inbox.life_email_unsubscribes
+        WHERE agent_id = ${sqlQuote(this.agentId)}
+          AND id = ${sqlQuote(id)}
+        LIMIT 1`
+    );
+    const row = rows[0];
+    return row ? parseEmailUnsubscribe(row) : null;
+  }
+  async findEmailUnsubscribeBySender(senderEmail) {
+    const rows = await executeRawSql(
+      this.runtime,
+      `SELECT *
+         FROM app_inbox.life_email_unsubscribes
+        WHERE agent_id = ${sqlQuote(this.agentId)}
+          AND sender_email = ${sqlQuote(senderEmail.trim().toLowerCase())}
+        ORDER BY created_at DESC
+        LIMIT 1`
+    );
+    const row = rows[0];
+    return row ? parseEmailUnsubscribe(row) : null;
+  }
+}
+export {
+  InboxUnsubscribeRepository
+};
+//# sourceMappingURL=unsubscribe-repository.js.map

package/dist/inbox/unsubscribe-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/inbox/unsubscribe-repository.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  executeRawSql,\n  parseJsonRecord,\n  sqlBoolean,\n  sqlInteger,\n  sqlJson,\n  sqlQuote,\n  sqlText,\n  toBoolean,\n  toNumber,\n  toText,\n} from \"../db/sql.js\";\nimport type {\n  EmailUnsubscribeMethod,\n  EmailUnsubscribeRecord,\n  EmailUnsubscribeStatus,\n} from \"./email-unsubscribe-types.js\";\n\n/**\n * Raw-SQL repository for the email-unsubscribe history.\n *\n * Reads/writes `app_inbox.life_email_unsubscribes`, the table PA still\n * registers + migrates (no data migration — the table name is preserved). Same\n * pattern as {@link InboxRepository}: a thin raw-SQL wrapper over the runtime DB\n * handle so this plugin carries no `@elizaos/plugin-personal-assistant`\n * dependency.\n */\nfunction parseEmailUnsubscribe(\n  row: Record<string, unknown>,\n): EmailUnsubscribeRecord {\n  return {\n    id: toText(row.id),\n    agentId: toText(row.agent_id),\n    senderEmail: toText(row.sender_email),\n    senderDisplay: toText(row.sender_display),\n    senderDomain: row.sender_domain ? toText(row.sender_domain) : null,\n    listId: row.list_id ? toText(row.list_id) : null,\n    method: toText(row.method, \"manual_only\") as EmailUnsubscribeMethod,\n    status: toText(row.status, \"failed\") as EmailUnsubscribeStatus,\n    httpStatusCode:\n      row.http_status_code === null || row.http_status_code === undefined\n        ? null\n        : toNumber(row.http_status_code, 0),\n    httpFinalUrl: row.http_final_url ? toText(row.http_final_url) : null,\n    filterCreated: toBoolean(row.filter_created),\n    filterId: row.filter_id ? toText(row.filter_id) : null,\n    threadsTrashed: toNumber(row.threads_trashed, 0),\n    errorMessage: row.error_message ? toText(row.error_message) : null,\n    metadata: parseJsonRecord(row.metadata_json),\n    createdAt: toText(row.created_at),\n    updatedAt: toText(row.updated_at),\n  };\n}\n\nexport class InboxUnsubscribeRepository {\n  constructor(private readonly runtime: IAgentRuntime) {}\n\n  private get agentId(): string {\n    return this.runtime.agentId;\n  }\n\n  async createEmailUnsubscribe(record: EmailUnsubscribeRecord): Promise<void> {\n    await executeRawSql(\n      this.runtime,\n      `INSERT INTO app_inbox.life_email_unsubscribes (\n        id, agent_id, sender_email, sender_display, sender_domain, list_id,\n        method, status, http_status_code, http_final_url, filter_created,\n        filter_id, threads_trashed, error_message, metadata_json,\n        created_at, updated_at\n      ) VALUES (\n        ${sqlQuote(record.id)},\n        ${sqlQuote(record.agentId)},\n        ${sqlQuote(record.senderEmail)},\n        ${sqlQuote(record.senderDisplay)},\n        ${sqlText(record.senderDomain)},\n        ${sqlText(record.listId)},\n        ${sqlQuote(record.method)},\n        ${sqlQuote(record.status)},\n        ${record.httpStatusCode === null ? \"NULL\" : sqlInteger(record.httpStatusCode)},\n        ${sqlText(record.httpFinalUrl)},\n        ${sqlBoolean(record.filterCreated)},\n        ${sqlText(record.filterId)},\n        ${sqlInteger(record.threadsTrashed)},\n        ${sqlText(record.errorMessage)},\n        ${sqlJson(record.metadata)},\n        ${sqlQuote(record.createdAt)},\n        ${sqlQuote(record.updatedAt)}\n      )`,\n    );\n  }\n\n  async listEmailUnsubscribes(\n    args: { limit?: number } = {},\n  ): Promise<EmailUnsubscribeRecord[]> {\n    const limit = Math.max(1, Math.min(500, Math.trunc(args.limit ?? 100)));\n    const rows = await executeRawSql(\n      this.runtime,\n      `SELECT *\n         FROM app_inbox.life_email_unsubscribes\n        WHERE agent_id = ${sqlQuote(this.agentId)}\n        ORDER BY created_at DESC\n        LIMIT ${limit}`,\n    );\n    return rows.map(parseEmailUnsubscribe);\n  }\n\n  async getEmailUnsubscribe(\n    id: string,\n  ): Promise<EmailUnsubscribeRecord | null> {\n    const rows = await executeRawSql(\n      this.runtime,\n      `SELECT *\n         FROM app_inbox.life_email_unsubscribes\n        WHERE agent_id = ${sqlQuote(this.agentId)}\n          AND id = ${sqlQuote(id)}\n        LIMIT 1`,\n    );\n    const row = rows[0];\n    return row ? parseEmailUnsubscribe(row) : null;\n  }\n\n  async findEmailUnsubscribeBySender(\n    senderEmail: string,\n  ): Promise<EmailUnsubscribeRecord | null> {\n    const rows = await executeRawSql(\n      this.runtime,\n      `SELECT *\n         FROM app_inbox.life_email_unsubscribes\n        WHERE agent_id = ${sqlQuote(this.agentId)}\n          AND sender_email = ${sqlQuote(senderEmail.trim().toLowerCase())}\n        ORDER BY created_at DESC\n        LIMIT 1`,\n    );\n    const row = rows[0];\n    return row ? parseEmailUnsubscribe(row) : null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/inbox/unsubscribe-service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * InboxUnsubscribeService — the email-unsubscribe back-end.
+ *
+ * Standalone successor to PA's `service-mixin-email-unsubscribe.ts` (a
+ * `this.`-bound `LifeOpsService` mixin). It scans Gmail for promotional senders,
+ * performs the List-Unsubscribe flow (HTTP one-click / GET / mailto), optionally
+ * creates a block filter and trashes existing threads, and records the outcome.
+ *
+ * Dependencies are resolved through seams so this plugin carries no
+ * `@elizaos/plugin-personal-assistant` dependency:
+ *   - Gmail access via {@link createInboxGmailGateway} (the `@elizaos/plugin-google`
+ *     runtime service).
+ *   - Persistence via {@link InboxUnsubscribeRepository} (raw SQL over the
+ *     `app_inbox.life_email_unsubscribes` table PA registers).
+ *
+ * Authorization: `unsubscribeEmailSender` requires `userAuthorization === true`.
+ * The two-phase confirmation gate (`requireConfirmation`) lives in the PA route
+ * layer that owns the HTTP surface; this service trusts the pre-confirmed flag.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { EmailSubscriptionScanResult, EmailUnsubscribeRecord, EmailUnsubscribeRequest, EmailUnsubscribeResult, EmailUnsubscribeScanRequest } from "./email-unsubscribe-types.js";
+import { type InboxGmailGateway } from "./google-gmail-seam.js";
+import { InboxUnsubscribeRepository } from "./unsubscribe-repository.js";
+export interface InboxUnsubscribeServiceDeps {
+    /** Override the Gmail gateway (tests inject a mock; default resolves plugin-google). */
+    gmail?: InboxGmailGateway;
+    /** Override the persistence repository (tests inject a fake or PGlite-backed one). */
+    repository?: InboxUnsubscribeRepository;
+}
+export declare class InboxUnsubscribeService {
+    private readonly runtime;
+    private readonly gmail;
+    private readonly repository;
+    constructor(runtime: IAgentRuntime, deps?: InboxUnsubscribeServiceDeps);
+    private get agentId();
+    scanEmailSubscriptions(request?: EmailUnsubscribeScanRequest): Promise<EmailSubscriptionScanResult>;
+    unsubscribeEmailSender(request: EmailUnsubscribeRequest): Promise<EmailUnsubscribeResult>;
+    listEmailUnsubscribes(limit?: number): Promise<EmailUnsubscribeRecord[]>;
+    summarizeEmailUnsubscribeScan(result: EmailSubscriptionScanResult): string;
+}
+//# sourceMappingURL=unsubscribe-service.d.ts.map

package/dist/inbox/unsubscribe-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe-service.d.ts","sourceRoot":"","sources":["../../src/inbox/unsubscribe-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,OAAO,KAAK,EACV,2BAA2B,EAG3B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAE5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAqIzE,MAAM,WAAW,2BAA2B;IAC1C,wFAAwF;IACxF,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,sFAAsF;IACtF,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED,qBAAa,uBAAuB;IAKhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;gBAGrC,OAAO,EAAE,aAAa,EACvC,IAAI,GAAE,2BAAgC;IAQxC,OAAO,KAAK,OAAO,GAElB;IAEK,sBAAsB,CAC1B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,2BAA2B,CAAC;IAyFjC,sBAAsB,CAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC;IA6J5B,qBAAqB,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAM3E,6BAA6B,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM;CAY3E"}