@skillrecordings/cli 0.1.0 → 0.2.0

package/dist/pipeline-IAVVAKTU.js

@@ -0,0 +1,120 @@
+import {
+  BASE_DRAFT_PROMPT,
+  addDecisionComment,
+  addSupportComment,
+  applyMultipleTags,
+  applyTag,
+  archiveConversation,
+  buildCategoryPrompt,
+  classify,
+  classifyThread,
+  computeMessageSignals,
+  computeThreadSignals,
+  createArchiveStep,
+  createCommentStep,
+  createTagStep,
+  draft,
+  extractEmail,
+  extractSignals,
+  fastClassify,
+  fastClassifyThread,
+  formatApprovalComment,
+  formatAuditComment,
+  formatContextForPrompt,
+  formatDecisionComment,
+  formatEscalationComment,
+  formatIssues,
+  formatMinimalComment,
+  formatSupportComment,
+  gather,
+  getPromptForCategory,
+  getRoutingRules,
+  getTagsForCategory,
+  getThreadRoutingRules,
+  hasIssueType,
+  isThreadResolved,
+  llmClassifyThread,
+  recordEscalationConfirmed,
+  recordRoutingOutcome,
+  recordShouldHaveEscalated,
+  recordUnnecessaryEscalation,
+  route,
+  routeThread,
+  routeThreadWithMemory,
+  routeWithMemory,
+  runPipeline,
+  runThreadPipeline,
+  shouldArchive,
+  shouldEscalate,
+  shouldRespond,
+  shouldSilence,
+  shouldSupportTeammate,
+  storeDraftCorrection,
+  storeDraftSuccess,
+  validate,
+  validateSync
+} from "./chunk-3E3GYSZR.js";
+import "./chunk-KEV3QKXP.js";
+import "./chunk-HK3PEWFD.js";
+import "./chunk-WYKL32C3.js";
+import "./chunk-MLNDSBZ4.js";
+import "./chunk-H3D6VCME.js";
+import "./chunk-MG37YDAK.js";
+import "./chunk-WFANXVQG.js";
+export {
+  BASE_DRAFT_PROMPT,
+  addDecisionComment,
+  addSupportComment,
+  applyMultipleTags,
+  applyTag,
+  archiveConversation,
+  buildCategoryPrompt,
+  classify,
+  classifyThread,
+  computeMessageSignals,
+  computeThreadSignals,
+  createArchiveStep,
+  createCommentStep,
+  createTagStep,
+  draft,
+  extractEmail,
+  extractSignals,
+  fastClassify,
+  fastClassifyThread,
+  formatApprovalComment,
+  formatAuditComment,
+  formatContextForPrompt,
+  formatDecisionComment,
+  formatEscalationComment,
+  formatIssues,
+  formatMinimalComment,
+  formatSupportComment,
+  gather,
+  getPromptForCategory,
+  getRoutingRules,
+  getTagsForCategory,
+  getThreadRoutingRules,
+  hasIssueType,
+  isThreadResolved,
+  llmClassifyThread,
+  recordEscalationConfirmed,
+  recordRoutingOutcome,
+  recordShouldHaveEscalated,
+  recordUnnecessaryEscalation,
+  route,
+  routeThread,
+  routeThreadWithMemory,
+  routeWithMemory,
+  runPipeline,
+  runThreadPipeline,
+  shouldArchive,
+  shouldEscalate,
+  shouldRespond,
+  shouldSilence,
+  shouldSupportTeammate,
+  storeDraftCorrection,
+  storeDraftSuccess,
+  validate,
+  validateSync
+};
+//# sourceMappingURL=pipeline-IAVVAKTU.js.map

package/dist/pipeline-IAVVAKTU.js.map

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

package/dist/query-NTP5NVXN.js

@@ -0,0 +1,25 @@
+import {
+  citeMemories,
+  formatMemoriesCompact,
+  formatMemoriesForPrompt,
+  formatMemoriesForValidation,
+  queryCorrectedMemories,
+  queryMemoriesForSituation,
+  queryMemoriesForStage,
+  recordCitationOutcome
+} from "./chunk-HK3PEWFD.js";
+import "./chunk-WYKL32C3.js";
+import "./chunk-MLNDSBZ4.js";
+import "./chunk-MG37YDAK.js";
+import "./chunk-WFANXVQG.js";
+export {
+  citeMemories,
+  formatMemoriesCompact,
+  formatMemoriesForPrompt,
+  formatMemoriesForValidation,
+  queryCorrectedMemories,
+  queryMemoriesForSituation,
+  queryMemoriesForStage,
+  recordCitationOutcome
+};
+//# sourceMappingURL=query-NTP5NVXN.js.map

package/dist/query-NTP5NVXN.js.map

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

package/dist/routing-BAEPFB7V.js

@@ -0,0 +1,390 @@
+import {
+  classifyMessage
+} from "./chunk-ZNF7XD2S.js";
+import "./chunk-H3D6VCME.js";
+import "./chunk-MG37YDAK.js";
+import {
+  init_esm_shims
+} from "./chunk-WFANXVQG.js";
+
+// ../core/src/evals/routing.ts
+init_esm_shims();
+
+// ../core/src/router/cache.ts
+init_esm_shims();
+var RouterCache = class {
+  decisionCache = /* @__PURE__ */ new Map();
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Retrieves a cached routing decision for a message.
+   *
+   * @param messageId - Unique message identifier (format: "conv-id:msg-id")
+   * @returns Cached decision if found and not expired, null otherwise
+   */
+  getDecision(messageId) {
+    const entry = this.decisionCache.get(messageId);
+    if (!entry) {
+      return null;
+    }
+    if (this.isExpired(entry)) {
+      this.decisionCache.delete(messageId);
+      return null;
+    }
+    return entry.decision;
+  }
+  /**
+   * Caches a routing decision for a message.
+   *
+   * @param messageId - Unique message identifier
+   * @param decision - RouterDecision to cache
+   */
+  setDecision(messageId, decision) {
+    this.decisionCache.set(messageId, {
+      decision,
+      timestamp: Date.now()
+    });
+  }
+  /**
+   * Invalidates all cached decisions for a conversation.
+   * Triggered on new inbound messages to ensure fresh routing.
+   *
+   * @param conversationId - Conversation identifier
+   */
+  invalidateConversation(conversationId) {
+    const prefix = `${conversationId}:`;
+    for (const messageId of this.decisionCache.keys()) {
+      if (messageId.startsWith(prefix)) {
+        this.decisionCache.delete(messageId);
+      }
+    }
+  }
+  isExpired(entry) {
+    const age = Date.now() - entry.timestamp;
+    return age >= this.config.decisionTtlMs;
+  }
+};
+
+// ../core/src/router/message-router.ts
+init_esm_shims();
+
+// ../core/src/router/canned.ts
+init_esm_shims();
+
+// ../core/src/router/rules.ts
+init_esm_shims();
+function matchRules(message, sender, rules) {
+  if (rules.length === 0) {
+    return null;
+  }
+  const sortedRules = [...rules].sort((a, b) => a.priority - b.priority);
+  for (const rule of sortedRules) {
+    const matches = matchRule(rule, message, sender);
+    if (matches) {
+      return {
+        ruleId: rule.id,
+        action: rule.action,
+        response: rule.response,
+        cannedResponseId: rule.cannedResponseId
+      };
+    }
+  }
+  return null;
+}
+function matchRule(rule, message, sender) {
+  switch (rule.type) {
+    case "regex":
+      return matchRegex(rule.pattern, message);
+    case "keyword":
+      return matchKeyword(rule.pattern, message);
+    case "sender_domain":
+      return matchSenderDomain(rule.pattern, sender);
+    case "sender_pattern":
+      return matchSenderPattern(rule.pattern, sender);
+    default:
+      return false;
+  }
+}
+function matchRegex(pattern, message) {
+  try {
+    const regex = new RegExp(pattern, "i");
+    return regex.test(message);
+  } catch {
+    return false;
+  }
+}
+function matchKeyword(pattern, message) {
+  const lowerMessage = message.toLowerCase();
+  const lowerPattern = pattern.toLowerCase();
+  if (lowerPattern.includes("|")) {
+    const keywords = lowerPattern.split("|").map((k) => k.trim());
+    return keywords.some((keyword) => lowerMessage.includes(keyword));
+  }
+  return lowerMessage.includes(lowerPattern);
+}
+function matchSenderDomain(pattern, sender) {
+  const emailMatch = sender.match(/@(.+)$/);
+  if (!emailMatch || !emailMatch[1]) {
+    return false;
+  }
+  const senderDomain = emailMatch[1].toLowerCase();
+  const lowerPattern = pattern.toLowerCase();
+  if (lowerPattern.startsWith("*.")) {
+    const baseDomain = lowerPattern.slice(2);
+    return senderDomain.endsWith(baseDomain);
+  }
+  return senderDomain === lowerPattern;
+}
+function matchSenderPattern(pattern, sender) {
+  const lowerSender = sender.toLowerCase();
+  const lowerPattern = pattern.toLowerCase();
+  const regexPattern = lowerPattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  try {
+    const regex = new RegExp(`^${regexPattern}$`, "i");
+    return regex.test(lowerSender);
+  } catch {
+    return false;
+  }
+}
+
+// ../core/src/router/message-router.ts
+async function routeMessage(message, context) {
+  const cacheKey = `${context.conversationId}:${context.messageId}`;
+  const cached = context.cache.getDecision(cacheKey);
+  if (cached) {
+    return cached;
+  }
+  let decision;
+  const ruleMatch = matchRules(message, context.sender, context.rules);
+  if (ruleMatch) {
+    if (ruleMatch.action === "route_to_canned" && ruleMatch.cannedResponseId) {
+      decision = {
+        route: "canned",
+        reason: `Rule ${ruleMatch.ruleId} matched, routing to canned response ${ruleMatch.cannedResponseId}`,
+        confidence: 1,
+        category: "rule-based",
+        ruleId: ruleMatch.ruleId,
+        cannedResponseId: ruleMatch.cannedResponseId
+      };
+    } else {
+      decision = {
+        route: "rule",
+        reason: `Matched rule ${ruleMatch.ruleId} with action ${ruleMatch.action}`,
+        confidence: 1,
+        category: "rule-based",
+        ruleId: ruleMatch.ruleId
+      };
+    }
+    context.cache.setDecision(cacheKey, decision);
+    return decision;
+  }
+  if (context.cannedResponses && context.cannedResponses.length > 0) {
+    const cannedMatch = matchCannedResponse2(message, context.cannedResponses);
+    if (cannedMatch) {
+      decision = {
+        route: "canned",
+        reason: `Matched canned response pattern: ${cannedMatch.pattern}`,
+        confidence: 0.9,
+        // High confidence for pattern match, but not rule-level certainty
+        category: "canned",
+        cannedResponseId: cannedMatch.id
+      };
+      context.cache.setDecision(cacheKey, decision);
+      return decision;
+    }
+  }
+  const classifierResult = await classifyMessage(message, {
+    recentMessages: context.recentMessages
+  });
+  if (classifierResult.confidence < 0.7) {
+    decision = {
+      route: "agent",
+      reason: `Classifier confidence too low (${classifierResult.confidence}): ${classifierResult.reasoning}`,
+      confidence: classifierResult.confidence,
+      category: classifierResult.category
+    };
+  } else {
+    decision = {
+      route: "classifier",
+      reason: classifierResult.reasoning,
+      confidence: classifierResult.confidence,
+      category: classifierResult.category
+    };
+  }
+  context.cache.setDecision(cacheKey, decision);
+  return decision;
+}
+function matchCannedResponse2(message, cannedResponses) {
+  const lowerMessage = message.toLowerCase();
+  for (const canned of cannedResponses) {
+    const lowerPattern = canned.pattern.toLowerCase();
+    if (lowerPattern.includes("|")) {
+      const keywords = lowerPattern.split("|").map((k) => k.trim());
+      if (keywords.some((keyword) => lowerMessage.includes(keyword))) {
+        return canned;
+      }
+    } else if (lowerMessage.includes(lowerPattern)) {
+      return canned;
+    }
+  }
+  return null;
+}
+
+// ../core/src/evals/routing.ts
+var DEFAULT_GATES = {
+  minPrecision: 0.92,
+  minRecall: 0.95,
+  maxFpRate: 0.03,
+  maxFnRate: 0.02
+};
+async function evalRouting(dataset, gates) {
+  const mergedGates = { ...DEFAULT_GATES, ...gates };
+  let tp = 0;
+  let fp = 0;
+  let fn = 0;
+  let tn = 0;
+  const categoryStats = /* @__PURE__ */ new Map();
+  const latencies = [];
+  let totalTokens = 0;
+  const cache = new RouterCache({
+    decisionTtlMs: 3e5,
+    contextTtlMs: 3e5
+  });
+  for (const datapoint of dataset) {
+    const startTime = Date.now();
+    const decision = await routeMessage(datapoint.message, {
+      conversationId: `eval-${Math.random()}`,
+      messageId: `eval-msg-${Math.random()}`,
+      sender: "[EMAIL]",
+      rules: [],
+      cache
+    });
+    const latency2 = Date.now() - startTime;
+    latencies.push(latency2);
+    totalTokens += Math.ceil(datapoint.message.length / 4);
+    if (!categoryStats.has(datapoint.expectedCategory)) {
+      categoryStats.set(datapoint.expectedCategory, {
+        tp: 0,
+        fp: 0,
+        fn: 0,
+        tn: 0
+      });
+    }
+    const catStats = categoryStats.get(datapoint.expectedCategory);
+    const outcome = classifyOutcome(decision, datapoint);
+    if (outcome === "tp") {
+      tp++;
+      catStats.tp++;
+    } else if (outcome === "fp") {
+      fp++;
+      catStats.fp++;
+    } else if (outcome === "fn") {
+      fn++;
+      catStats.fn++;
+    } else {
+      tn++;
+      catStats.tn++;
+    }
+  }
+  const precision = tp + fp > 0 ? tp / (tp + fp) : 0;
+  const recall = tp + fn > 0 ? tp / (tp + fn) : 0;
+  const fpRate = fp + tn > 0 ? fp / (fp + tn) : 0;
+  const fnRate = fn + tp > 0 ? fn / (fn + tp) : 0;
+  const byCategory = {};
+  for (const [category, stats] of categoryStats.entries()) {
+    const catPrecision = stats.tp + stats.fp > 0 ? stats.tp / (stats.tp + stats.fp) : 0;
+    const catRecall = stats.tp + stats.fn > 0 ? stats.tp / (stats.tp + stats.fn) : 0;
+    const catF1 = catPrecision + catRecall > 0 ? 2 * catPrecision * catRecall / (catPrecision + catRecall) : 0;
+    byCategory[category] = {
+      tp: stats.tp,
+      fp: stats.fp,
+      fn: stats.fn,
+      tn: stats.tn,
+      precision: catPrecision,
+      recall: catRecall,
+      f1: catF1,
+      count: stats.tp + stats.fp + stats.fn + stats.tn
+    };
+  }
+  const sortedLatencies = latencies.sort((a, b) => a - b);
+  const p50 = percentile(sortedLatencies, 50);
+  const p95 = percentile(sortedLatencies, 95);
+  const p99 = percentile(sortedLatencies, 99);
+  const estimatedUsd = totalTokens / 1e6 * 0.25;
+  const cost = {
+    tokens: totalTokens,
+    estimatedUsd
+  };
+  const latency = {
+    p50,
+    p95,
+    p99
+  };
+  let passed = true;
+  if (precision < mergedGates.minPrecision) {
+    passed = false;
+    throw new Error(
+      `Precision ${precision.toFixed(4)} below threshold ${mergedGates.minPrecision}`
+    );
+  }
+  if (recall < mergedGates.minRecall) {
+    passed = false;
+    throw new Error(
+      `Recall ${recall.toFixed(4)} below threshold ${mergedGates.minRecall}`
+    );
+  }
+  if (fpRate > mergedGates.maxFpRate) {
+    passed = false;
+    throw new Error(
+      `False positive rate ${fpRate.toFixed(4)} above threshold ${mergedGates.maxFpRate}`
+    );
+  }
+  if (fnRate > mergedGates.maxFnRate) {
+    passed = false;
+    throw new Error(
+      `False negative rate ${fnRate.toFixed(4)} above threshold ${mergedGates.maxFnRate}`
+    );
+  }
+  return {
+    precision,
+    recall,
+    fpRate,
+    fnRate,
+    byCategory,
+    cost,
+    latency,
+    passed
+  };
+}
+function classifyOutcome(decision, expected) {
+  const routeMatch = decision.route === expected.expectedRoute;
+  const categoryMatch = decision.category === expected.expectedCategory;
+  const isAutoResponse = ["rule", "canned", "classifier"].includes(
+    decision.route
+  );
+  const shouldAutoRespond = ["rule", "canned", "classifier"].includes(
+    expected.expectedRoute
+  );
+  if (routeMatch && categoryMatch) {
+    return "tp";
+  } else if (isAutoResponse && !shouldAutoRespond) {
+    return "fp";
+  } else if (!isAutoResponse && shouldAutoRespond) {
+    return "fn";
+  } else if (!isAutoResponse && !shouldAutoRespond) {
+    return "tn";
+  } else {
+    return "fp";
+  }
+}
+function percentile(sortedValues, p) {
+  if (sortedValues.length === 0) return 0;
+  const index = Math.ceil(p / 100 * sortedValues.length) - 1;
+  return sortedValues[Math.max(0, index)] ?? 0;
+}
+export {
+  evalRouting
+};
+//# sourceMappingURL=routing-BAEPFB7V.js.map

package/dist/routing-BAEPFB7V.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../core/src/evals/routing.ts","../../core/src/router/cache.ts","../../core/src/router/message-router.ts","../../core/src/router/canned.ts","../../core/src/router/rules.ts"],"sourcesContent":["import { RouterCache } from '../router/cache'\nimport { routeMessage } from '../router/message-router'\nimport type { RouteType } from '../router/types'\nimport type {\n  CategoryMetrics,\n  CostMetrics,\n  EvalDatapoint,\n  EvalGates,\n  EvalReport,\n  LatencyMetrics,\n} from './types'\n\nexport type {\n  EvalDatapoint,\n  EvalGates,\n  EvalReport,\n  CategoryMetrics,\n} from './types'\n\n/**\n * Default regression gates from Phase 8 spec.\n */\nconst DEFAULT_GATES: Required<EvalGates> = {\n  minPrecision: 0.92,\n  minRecall: 0.95,\n  maxFpRate: 0.03,\n  maxFnRate: 0.02,\n}\n\n/**\n * Evaluate routing performance against a labeled dataset.\n *\n * @param dataset - Array of labeled evaluation datapoints\n * @param gates - Optional regression gates (uses defaults from Phase 8 spec)\n * @returns EvalReport with metrics and gate status\n * @throws Error if any gate threshold is violated\n *\n * @example\n * ```typescript\n * const dataset = [\n *   { message: 'I want a refund', expectedCategory: 'refund', expectedRoute: 'rule' }\n * ]\n * const report = await evalRouting(dataset)\n * console.log(`Precision: ${report.precision}, Recall: ${report.recall}`)\n * ```\n */\nexport async function evalRouting(\n  dataset: EvalDatapoint[],\n  gates?: EvalGates\n): Promise<EvalReport> {\n  const mergedGates = { ...DEFAULT_GATES, ...gates }\n\n  // Track metrics\n  let tp = 0\n  let fp = 0\n  let fn = 0\n  let tn = 0\n  const categoryStats = new Map<\n    string,\n    { tp: number; fp: number; fn: number; tn: number }\n  >()\n  const latencies: number[] = []\n  let totalTokens = 0\n\n  // Create a mock cache and context for routing\n  const cache = new RouterCache({\n    decisionTtlMs: 300000,\n    contextTtlMs: 300000,\n  })\n\n  for (const datapoint of dataset) {\n    const startTime = Date.now()\n\n    // Route the message\n    const decision = await routeMessage(datapoint.message, {\n      conversationId: `eval-${Math.random()}`,\n      messageId: `eval-msg-${Math.random()}`,\n      sender: '[EMAIL]',\n      rules: [],\n      cache,\n    })\n\n    const latency = Date.now() - startTime\n    latencies.push(latency)\n\n    // Estimate tokens (rough approximation: 1 token per 4 chars)\n    totalTokens += Math.ceil(datapoint.message.length / 4)\n\n    // Initialize category stats if needed\n    if (!categoryStats.has(datapoint.expectedCategory)) {\n      categoryStats.set(datapoint.expectedCategory, {\n        tp: 0,\n        fp: 0,\n        fn: 0,\n        tn: 0,\n      })\n    }\n    const catStats = categoryStats.get(datapoint.expectedCategory)!\n\n    // Classify outcome\n    const outcome = classifyOutcome(decision, datapoint)\n\n    // Update counters\n    if (outcome === 'tp') {\n      tp++\n      catStats.tp++\n    } else if (outcome === 'fp') {\n      fp++\n      catStats.fp++\n    } else if (outcome === 'fn') {\n      fn++\n      catStats.fn++\n    } else {\n      tn++\n      catStats.tn++\n    }\n  }\n\n  // Calculate overall metrics\n  const precision = tp + fp > 0 ? tp / (tp + fp) : 0\n  const recall = tp + fn > 0 ? tp / (tp + fn) : 0\n  const fpRate = fp + tn > 0 ? fp / (fp + tn) : 0\n  const fnRate = fn + tp > 0 ? fn / (fn + tp) : 0\n\n  // Calculate per-category breakdown\n  const byCategory: Record<string, CategoryMetrics> = {}\n  for (const [category, stats] of categoryStats.entries()) {\n    const catPrecision =\n      stats.tp + stats.fp > 0 ? stats.tp / (stats.tp + stats.fp) : 0\n    const catRecall =\n      stats.tp + stats.fn > 0 ? stats.tp / (stats.tp + stats.fn) : 0\n    const catF1 =\n      catPrecision + catRecall > 0\n        ? (2 * catPrecision * catRecall) / (catPrecision + catRecall)\n        : 0\n\n    byCategory[category] = {\n      tp: stats.tp,\n      fp: stats.fp,\n      fn: stats.fn,\n      tn: stats.tn,\n      precision: catPrecision,\n      recall: catRecall,\n      f1: catF1,\n      count: stats.tp + stats.fp + stats.fn + stats.tn,\n    }\n  }\n\n  // Calculate latency percentiles\n  const sortedLatencies = latencies.sort((a, b) => a - b)\n  const p50 = percentile(sortedLatencies, 50)\n  const p95 = percentile(sortedLatencies, 95)\n  const p99 = percentile(sortedLatencies, 99)\n\n  // Estimate cost (rough approximation: $0.25 per 1M tokens for Haiku)\n  const estimatedUsd = (totalTokens / 1_000_000) * 0.25\n\n  const cost: CostMetrics = {\n    tokens: totalTokens,\n    estimatedUsd,\n  }\n\n  const latency: LatencyMetrics = {\n    p50,\n    p95,\n    p99,\n  }\n\n  // Check gates\n  let passed = true\n  if (precision < mergedGates.minPrecision) {\n    passed = false\n    throw new Error(\n      `Precision ${precision.toFixed(4)} below threshold ${mergedGates.minPrecision}`\n    )\n  }\n  if (recall < mergedGates.minRecall) {\n    passed = false\n    throw new Error(\n      `Recall ${recall.toFixed(4)} below threshold ${mergedGates.minRecall}`\n    )\n  }\n  if (fpRate > mergedGates.maxFpRate) {\n    passed = false\n    throw new Error(\n      `False positive rate ${fpRate.toFixed(4)} above threshold ${mergedGates.maxFpRate}`\n    )\n  }\n  if (fnRate > mergedGates.maxFnRate) {\n    passed = false\n    throw new Error(\n      `False negative rate ${fnRate.toFixed(4)} above threshold ${mergedGates.maxFnRate}`\n    )\n  }\n\n  return {\n    precision,\n    recall,\n    fpRate,\n    fnRate,\n    byCategory,\n    cost,\n    latency,\n    passed,\n  }\n}\n\n/**\n * Classify routing decision outcome for metrics.\n */\nfunction classifyOutcome(\n  decision: { route: RouteType; category: string },\n  expected: { expectedRoute: RouteType; expectedCategory: string }\n): 'tp' | 'fp' | 'fn' | 'tn' {\n  const routeMatch = decision.route === expected.expectedRoute\n  const categoryMatch = decision.category === expected.expectedCategory\n\n  const isAutoResponse = ['rule', 'canned', 'classifier'].includes(\n    decision.route\n  )\n  const shouldAutoRespond = ['rule', 'canned', 'classifier'].includes(\n    expected.expectedRoute\n  )\n\n  if (routeMatch && categoryMatch) {\n    return 'tp' // Perfect match\n  } else if (isAutoResponse && !shouldAutoRespond) {\n    return 'fp' // Auto-responded when shouldn't have\n  } else if (!isAutoResponse && shouldAutoRespond) {\n    return 'fn' // Didn't respond when should have\n  } else if (!isAutoResponse && !shouldAutoRespond) {\n    return 'tn' // Correctly no response\n  } else {\n    return 'fp' // Route mismatch but both are auto-response types\n  }\n}\n\n/**\n * Calculate percentile from sorted array.\n */\nfunction percentile(sortedValues: number[], p: number): number {\n  if (sortedValues.length === 0) return 0\n  const index = Math.ceil((p / 100) * sortedValues.length) - 1\n  return sortedValues[Math.max(0, index)] ?? 0\n}\n","import type { RouterDecision } from './types'\n\n/**\n * Configuration for RouterCache TTL policies.\n */\nexport interface CacheConfig {\n  /** Time-to-live for routing decisions (default: 1 hour) */\n  decisionTtlMs: number\n  /** Time-to-live for conversation context (default: 24 hours) */\n  contextTtlMs: number\n}\n\ninterface CacheEntry {\n  decision: RouterDecision\n  timestamp: number\n}\n\n/**\n * In-memory cache for routing decisions with TTL-based expiration.\n *\n * Provides:\n * - Per-message decision caching (1hr TTL)\n * - Per-conversation context caching (24hr TTL)\n * - Idempotency for duplicate Front webhook events\n * - Automatic invalidation on new messages\n *\n * @example\n * ```typescript\n * const cache = new RouterCache({\n *   decisionTtlMs: 60 * 60 * 1000,    // 1 hour\n *   contextTtlMs: 24 * 60 * 60 * 1000 // 24 hours\n * })\n *\n * // Cache a decision\n * cache.setDecision('msg-123', decision)\n *\n * // Retrieve cached decision (null if expired or not found)\n * const cached = cache.getDecision('msg-123')\n *\n * // Invalidate all decisions for a conversation\n * cache.invalidateConversation('conv-abc')\n * ```\n */\nexport class RouterCache {\n  private readonly decisionCache: Map<string, CacheEntry> = new Map()\n  private readonly config: CacheConfig\n\n  constructor(config: CacheConfig) {\n    this.config = config\n  }\n\n  /**\n   * Retrieves a cached routing decision for a message.\n   *\n   * @param messageId - Unique message identifier (format: \"conv-id:msg-id\")\n   * @returns Cached decision if found and not expired, null otherwise\n   */\n  getDecision(messageId: string): RouterDecision | null {\n    const entry = this.decisionCache.get(messageId)\n\n    if (!entry) {\n      return null\n    }\n\n    if (this.isExpired(entry)) {\n      this.decisionCache.delete(messageId)\n      return null\n    }\n\n    return entry.decision\n  }\n\n  /**\n   * Caches a routing decision for a message.\n   *\n   * @param messageId - Unique message identifier\n   * @param decision - RouterDecision to cache\n   */\n  setDecision(messageId: string, decision: RouterDecision): void {\n    this.decisionCache.set(messageId, {\n      decision,\n      timestamp: Date.now(),\n    })\n  }\n\n  /**\n   * Invalidates all cached decisions for a conversation.\n   * Triggered on new inbound messages to ensure fresh routing.\n   *\n   * @param conversationId - Conversation identifier\n   */\n  invalidateConversation(conversationId: string): void {\n    const prefix = `${conversationId}:`\n\n    for (const messageId of this.decisionCache.keys()) {\n      if (messageId.startsWith(prefix)) {\n        this.decisionCache.delete(messageId)\n      }\n    }\n  }\n\n  private isExpired(entry: CacheEntry): boolean {\n    const age = Date.now() - entry.timestamp\n    return age >= this.config.decisionTtlMs\n  }\n}\n","import type { RouterCache } from './cache'\nimport { matchCannedResponse as matchCannedResponseVector } from './canned'\nimport { classifyMessage } from './classifier'\nimport { matchRules } from './rules'\nimport type { RouterDecision, Rule } from './types'\n\nexport type { RouterDecision, Rule }\nexport { matchCannedResponse, interpolateTemplate } from './canned'\n\n/**\n * Canned response definition for pattern-based template matching.\n */\nexport interface CannedResponse {\n  id: string\n  pattern: string\n  response: string\n}\n\n/**\n * Context required for routing decisions.\n */\nexport interface RoutingContext {\n  conversationId: string\n  messageId: string\n  sender: string\n  rules: Rule[]\n  cache: RouterCache\n  cannedResponses?: CannedResponse[]\n  recentMessages?: string[]\n}\n\n/**\n * Route incoming message through the decision pipeline.\n *\n * Pipeline order (with early exit):\n * 1. Cache check\n * 2. Rule matching\n * 3. Canned response matching\n * 4. Classifier\n * 5. Agent fallback (if classifier confidence < 0.7)\n *\n * @param message - Incoming message content\n * @param context - Routing context with rules, cache, sender info\n * @returns RouterDecision with route type, confidence, and metadata\n *\n * @example\n * ```typescript\n * const decision = await routeMessage('I want a refund', {\n *   conversationId: 'conv-123',\n *   messageId: 'msg-456',\n *   sender: '[EMAIL]',\n *   rules: [{ id: 'refund', priority: 1, type: 'keyword', pattern: 'refund', action: 'escalate' }],\n *   cache: new RouterCache({ decisionTtlMs: [PHONE], contextTtlMs: [PHONE] })\n * })\n * // => { route: 'rule', ruleId: 'refund', confidence: 1.0, ... }\n * ```\n */\nexport async function routeMessage(\n  message: string,\n  context: RoutingContext\n): Promise<RouterDecision> {\n  const cacheKey = `${context.conversationId}:${context.messageId}`\n\n  // 1. Check cache first\n  const cached = context.cache.getDecision(cacheKey)\n  if (cached) {\n    return cached\n  }\n\n  let decision: RouterDecision\n\n  // 2. Check rules\n  const ruleMatch = matchRules(message, context.sender, context.rules)\n  if (ruleMatch) {\n    if (ruleMatch.action === 'route_to_canned' && ruleMatch.cannedResponseId) {\n      decision = {\n        route: 'canned',\n        reason: `Rule ${ruleMatch.ruleId} matched, routing to canned response ${ruleMatch.cannedResponseId}`,\n        confidence: 1.0,\n        category: 'rule-based',\n        ruleId: ruleMatch.ruleId,\n        cannedResponseId: ruleMatch.cannedResponseId,\n      }\n    } else {\n      decision = {\n        route: 'rule',\n        reason: `Matched rule ${ruleMatch.ruleId} with action ${ruleMatch.action}`,\n        confidence: 1.0,\n        category: 'rule-based',\n        ruleId: ruleMatch.ruleId,\n      }\n    }\n    context.cache.setDecision(cacheKey, decision)\n    return decision\n  }\n\n  // 3. Check canned responses\n  if (context.cannedResponses && context.cannedResponses.length > 0) {\n    const cannedMatch = matchCannedResponse(message, context.cannedResponses)\n    if (cannedMatch) {\n      decision = {\n        route: 'canned',\n        reason: `Matched canned response pattern: ${cannedMatch.pattern}`,\n        confidence: 0.9, // High confidence for pattern match, but not rule-level certainty\n        category: 'canned',\n        cannedResponseId: cannedMatch.id,\n      }\n      context.cache.setDecision(cacheKey, decision)\n      return decision\n    }\n  }\n\n  // 4. Use classifier\n  const classifierResult = await classifyMessage(message, {\n    recentMessages: context.recentMessages,\n  })\n\n  // 5. Fallback to agent if classifier confidence is low\n  if (classifierResult.confidence < 0.7) {\n    decision = {\n      route: 'agent',\n      reason: `Classifier confidence too low (${classifierResult.confidence}): ${classifierResult.reasoning}`,\n      confidence: classifierResult.confidence,\n      category: classifierResult.category,\n    }\n  } else {\n    decision = {\n      route: 'classifier',\n      reason: classifierResult.reasoning,\n      confidence: classifierResult.confidence,\n      category: classifierResult.category,\n    }\n  }\n\n  context.cache.setDecision(cacheKey, decision)\n  return decision\n}\n\n/**\n * Match message against canned response patterns.\n * Uses simple case-insensitive keyword matching.\n */\nfunction matchCannedResponse(\n  message: string,\n  cannedResponses: CannedResponse[]\n): CannedResponse | null {\n  const lowerMessage = message.toLowerCase()\n\n  for (const canned of cannedResponses) {\n    const lowerPattern = canned.pattern.toLowerCase()\n\n    // Support pipe-separated OR patterns like rules\n    if (lowerPattern.includes('|')) {\n      const keywords = lowerPattern.split('|').map((k) => k.trim())\n      if (keywords.some((keyword) => lowerMessage.includes(keyword))) {\n        return canned\n      }\n    } else if (lowerMessage.includes(lowerPattern)) {\n      return canned\n    }\n  }\n\n  return null\n}\n","import { queryVectors } from '../vector/client'\n\n/**\n * Result of matching against canned responses\n */\nexport interface CannedMatch {\n  /** Whether a match was found above threshold */\n  matched: boolean\n  /** The matched response text (if matched) */\n  response?: string\n  /** ID of the matched template (if matched) */\n  templateId?: string\n  /** Similarity score from vector search (if matched) */\n  similarity?: number\n}\n\n/**\n * Match a message against canned responses using vector similarity.\n *\n * Searches the vector store for type='response' documents filtered by appId.\n * Returns a match if the top result exceeds the similarity threshold.\n *\n * @param message - The message to match against canned responses\n * @param appId - App ID to filter responses\n * @param threshold - Minimum similarity score (default: 0.92)\n * @returns CannedMatch with match status and response if found\n *\n * @example\n * ```ts\n * const match = await matchCannedResponse(\n *   'I want a refund please',\n *   'totaltypescript',\n *   0.92\n * )\n *\n * if (match.matched) {\n *   console.log(match.response) // Canned response text\n *   console.log(match.templateId) // resp-refund-standard\n *   console.log(match.similarity) // 0.95\n * }\n * ```\n */\nexport async function matchCannedResponse(\n  message: string,\n  appId: string,\n  threshold: number = 0.92\n): Promise<CannedMatch> {\n  // Query vector store for type='response' docs filtered by appId\n  const results = await queryVectors({\n    data: message,\n    topK: 1,\n    includeMetadata: true,\n    includeData: true,\n    filter: `appId = \"${appId}\" AND type = \"response\"`,\n  })\n\n  // No results or no data in result\n  if (results.length === 0 || !results[0]?.data) {\n    return { matched: false }\n  }\n\n  const topResult = results[0]\n  const score = topResult.score\n\n  // Check if score meets threshold\n  if (score < threshold) {\n    return { matched: false }\n  }\n\n  return {\n    matched: true,\n    response: topResult.data,\n    templateId: topResult.id,\n    similarity: score,\n  }\n}\n\n/**\n * Interpolate variables in a canned response template.\n *\n * Replaces {{variable_name}} placeholders with provided values.\n * Preserves template syntax for missing variables.\n *\n * @param template - Template string with {{variable}} placeholders\n * @param variables - Object mapping variable names to values\n * @returns Interpolated string\n *\n * @example\n * ```ts\n * const template = 'Hi {{customer_name}}, your {{product_name}} is ready.'\n * const result = interpolateTemplate(template, {\n *   customer_name: 'Alice',\n *   product_name: 'Total TypeScript'\n * })\n * // => 'Hi Alice, your Total TypeScript is ready.'\n * ```\n */\nexport function interpolateTemplate(\n  template: string,\n  variables: Record<string, string>\n): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (match, varName) => {\n    return variables[varName] ?? match\n  })\n}\n","import type { Rule, RuleMatch } from './types'\n\nexport type { Rule, RuleMatch }\n\n/**\n * Match incoming message and sender against rules.\n *\n * Rules are evaluated in priority order (lower number = higher priority).\n * Returns the first matching rule or null if no rules match.\n *\n * Supports three rule types:\n * - `regex`: Match message content using regular expressions (case insensitive)\n * - `keyword`: Match message content using keywords or keyword lists (case insensitive)\n * - `sender_domain`: Match sender email domain (supports wildcards like *.example.com)\n *\n * @param message - The message content to match against\n * @param sender - The sender email address\n * @param rules - Array of rules to evaluate\n * @returns Matching rule with action details, or null if no match\n *\n * @example\n * ```typescript\n * const rules: Rule[] = [\n *   {\n *     id: 'refund-escalation',\n *     priority: 1,\n *     type: 'keyword',\n *     pattern: 'refund|cancel',\n *     action: 'escalate'\n *   }\n * ]\n *\n * const match = matchRules('I want a refund', '[EMAIL]', rules)\n * // => { ruleId: 'refund-escalation', action: 'escalate', ... }\n * ```\n */\nexport function matchRules(\n  message: string,\n  sender: string,\n  rules: Rule[]\n): RuleMatch | null {\n  if (rules.length === 0) {\n    return null\n  }\n\n  // Sort by priority (lower number = higher priority)\n  const sortedRules = [...rules].sort((a, b) => a.priority - b.priority)\n\n  for (const rule of sortedRules) {\n    const matches = matchRule(rule, message, sender)\n    if (matches) {\n      return {\n        ruleId: rule.id,\n        action: rule.action,\n        response: rule.response,\n        cannedResponseId: rule.cannedResponseId,\n      }\n    }\n  }\n\n  return null\n}\n\n/**\n * Check if a single rule matches the message/sender.\n */\nfunction matchRule(rule: Rule, message: string, sender: string): boolean {\n  switch (rule.type) {\n    case 'regex':\n      return matchRegex(rule.pattern, message)\n    case 'keyword':\n      return matchKeyword(rule.pattern, message)\n    case 'sender_domain':\n      return matchSenderDomain(rule.pattern, sender)\n    case 'sender_pattern':\n      return matchSenderPattern(rule.pattern, sender)\n    default:\n      return false\n  }\n}\n\n/**\n * Match regex pattern against message (case insensitive).\n */\nfunction matchRegex(pattern: string, message: string): boolean {\n  try {\n    const regex = new RegExp(pattern, 'i')\n    return regex.test(message)\n  } catch {\n    // Invalid regex - don't match\n    return false\n  }\n}\n\n/**\n * Match keyword(s) against message (case insensitive).\n * Pattern can contain multiple keywords separated by | (OR).\n */\nfunction matchKeyword(pattern: string, message: string): boolean {\n  const lowerMessage = message.toLowerCase()\n  const lowerPattern = pattern.toLowerCase()\n\n  // If pattern contains |, it's an OR operation\n  if (lowerPattern.includes('|')) {\n    const keywords = lowerPattern.split('|').map((k) => k.trim())\n    return keywords.some((keyword) => lowerMessage.includes(keyword))\n  }\n\n  return lowerMessage.includes(lowerPattern)\n}\n\n/**\n * Match sender domain pattern.\n * Supports exact domain matching and wildcard subdomain (*.example.com).\n */\nfunction matchSenderDomain(pattern: string, sender: string): boolean {\n  // Extract domain from email address\n  const emailMatch = sender.match(/@(.+)$/)\n  if (!emailMatch || !emailMatch[1]) {\n    return false\n  }\n\n  const senderDomain = emailMatch[1].toLowerCase()\n  const lowerPattern = pattern.toLowerCase()\n\n  // Wildcard subdomain matching (*.example.com)\n  if (lowerPattern.startsWith('*.')) {\n    const baseDomain = lowerPattern.slice(2)\n    return senderDomain.endsWith(baseDomain)\n  }\n\n  // Exact domain matching\n  return senderDomain === lowerPattern\n}\n\n/**\n * Match sender email against a pattern (case insensitive).\n * Supports wildcards: * matches any characters.\n * Example: \"mailer-daemon@*\" matches \"[EMAIL]\"\n */\nfunction matchSenderPattern(pattern: string, sender: string): boolean {\n  const lowerSender = sender.toLowerCase()\n  const lowerPattern = pattern.toLowerCase()\n\n  // Convert wildcard pattern to regex\n  // Escape regex special chars except *, then replace * with .*\n  const regexPattern = lowerPattern\n    .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n    .replace(/\\*/g, '.*')\n\n  try {\n    const regex = new RegExp(`^${regexPattern}$`, 'i')\n    return regex.test(lowerSender)\n  } catch {\n    return false\n  }\n}\n"],"mappings":"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","names":["matchCannedResponse","latency"]}

package/dist/stripe-lookup-charge-EPRUMZDL.js

@@ -0,0 +1,56 @@
+import {
+  stripe_esm_node_default
+} from "./chunk-SKHBM3XP.js";
+import {
+  createTool
+} from "./chunk-F4EM72IH.js";
+import {
+  init_esm_shims
+} from "./chunk-WFANXVQG.js";
+
+// ../core/src/tools/stripe-lookup-charge.ts
+init_esm_shims();
+import { z } from "zod";
+var lookupCharge = createTool({
+  name: "lookup_charge",
+  description: "Lookup a specific charge by ID from Stripe Connect. Read-only - provides context for support conversations. Returns charge details including amount, status, and refund information.",
+  parameters: z.object({
+    /**
+     * Stripe charge ID to lookup (format: ch_...)
+     */
+    chargeId: z.string().min(1, "Charge ID required").regex(/^ch_/, "Charge ID must start with ch_")
+  }),
+  execute: async ({ chargeId }, context) => {
+    if (!context.appConfig.stripeAccountId) {
+      throw new Error(
+        `Stripe account not connected for app: ${context.appConfig.id}`
+      );
+    }
+    const stripe = new stripe_esm_node_default(process.env.STRIPE_SECRET_KEY, {
+      apiVersion: "2025-02-24.acacia"
+    });
+    try {
+      const charge = await stripe.charges.retrieve(chargeId, {
+        stripeAccount: context.appConfig.stripeAccountId
+      });
+      const chargeDetails = {
+        id: charge.id,
+        amount: charge.amount,
+        currency: charge.currency,
+        status: charge.status,
+        refunded: charge.refunded,
+        customer: typeof charge.customer === "string" ? charge.customer : null,
+        description: charge.description,
+        created: charge.created
+      };
+      return chargeDetails;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to lookup charge: ${message}`);
+    }
+  }
+});
+export {
+  lookupCharge
+};
+//# sourceMappingURL=stripe-lookup-charge-EPRUMZDL.js.map

package/dist/stripe-lookup-charge-EPRUMZDL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../core/src/tools/stripe-lookup-charge.ts"],"sourcesContent":["import Stripe from 'stripe'\nimport { z } from 'zod'\nimport { createTool } from './create-tool'\n\n/**\n * Formatted charge information.\n */\nexport interface ChargeDetails {\n  /**\n   * Stripe charge ID\n   */\n  id: string\n  /**\n   * Amount in cents\n   */\n  amount: number\n  /**\n   * Currency code (e.g., 'usd')\n   */\n  currency: string\n  /**\n   * Charge status\n   */\n  status: string\n  /**\n   * Whether the charge has been refunded\n   */\n  refunded: boolean\n  /**\n   * Stripe customer ID\n   */\n  customer: string | null\n  /**\n   * Charge description\n   */\n  description: string | null\n  /**\n   * Unix timestamp of charge creation\n   */\n  created: number\n}\n\n/**\n * Lookup a specific charge by ID via Stripe Connect.\n *\n * IMPORTANT: This is a QUERY-ONLY tool. It does NOT execute financial actions.\n * We use Stripe Connect to query charge data from the app's connected account.\n *\n * Architecture: Platform queries for context → Apps execute actions\n *\n * Use cases:\n * - Agent needs charge details for support conversation\n * - Verifying charge status\n * - Checking refund status for a specific charge\n *\n * @example\n * ```typescript\n * const charge = await lookupCharge.execute(\n *   { chargeId: 'ch_abc123' },\n *   context\n * )\n * ```\n */\nexport const lookupCharge = createTool({\n  name: 'lookup_charge',\n  description:\n    'Lookup a specific charge by ID from Stripe Connect. Read-only - provides context for support conversations. Returns charge details including amount, status, and refund information.',\n  parameters: z.object({\n    /**\n     * Stripe charge ID to lookup (format: ch_...)\n     */\n    chargeId: z\n      .string()\n      .min(1, 'Charge ID required')\n      .regex(/^ch_/, 'Charge ID must start with ch_'),\n  }),\n\n  execute: async ({ chargeId }, context) => {\n    // Verify Stripe account is connected\n    if (!context.appConfig.stripeAccountId) {\n      throw new Error(\n        `Stripe account not connected for app: ${context.appConfig.id}`\n      )\n    }\n\n    // Initialize Stripe client\n    const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {\n      apiVersion: '2025-02-24.acacia',\n    })\n\n    try {\n      // Query charge from connected account\n      // Using stripeAccount header to query the connected app's Stripe account\n      const charge = await stripe.charges.retrieve(chargeId, {\n        stripeAccount: context.appConfig.stripeAccountId,\n      })\n\n      // Format charge for agent context\n      const chargeDetails: ChargeDetails = {\n        id: charge.id,\n        amount: charge.amount,\n        currency: charge.currency,\n        status: charge.status,\n        refunded: charge.refunded,\n        customer: typeof charge.customer === 'string' ? charge.customer : null,\n        description: charge.description,\n        created: charge.created,\n      }\n\n      return chargeDetails\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error'\n      throw new Error(`Failed to lookup charge: ${message}`)\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;AAAA;AACA,SAAS,SAAS;AA8DX,IAAM,eAAe,WAAW;AAAA,EACrC,MAAM;AAAA,EACN,aACE;AAAA,EACF,YAAY,EAAE,OAAO;AAAA;AAAA;AAAA;AAAA,IAInB,UAAU,EACP,OAAO,EACP,IAAI,GAAG,oBAAoB,EAC3B,MAAM,QAAQ,+BAA+B;AAAA,EAClD,CAAC;AAAA,EAED,SAAS,OAAO,EAAE,SAAS,GAAG,YAAY;AAExC,QAAI,CAAC,QAAQ,UAAU,iBAAiB;AACtC,YAAM,IAAI;AAAA,QACR,yCAAyC,QAAQ,UAAU,EAAE;AAAA,MAC/D;AAAA,IACF;AAGA,UAAM,SAAS,IAAI,wBAAO,QAAQ,IAAI,mBAAoB;AAAA,MACxD,YAAY;AAAA,IACd,CAAC;AAED,QAAI;AAGF,YAAM,SAAS,MAAM,OAAO,QAAQ,SAAS,UAAU;AAAA,QACrD,eAAe,QAAQ,UAAU;AAAA,MACnC,CAAC;AAGD,YAAM,gBAA+B;AAAA,QACnC,IAAI,OAAO;AAAA,QACX,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,QACjB,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,QACjB,UAAU,OAAO,OAAO,aAAa,WAAW,OAAO,WAAW;AAAA,QAClE,aAAa,OAAO;AAAA,QACpB,SAAS,OAAO;AAAA,MAClB;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,YAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,IACvD;AAAA,EACF;AACF,CAAC;","names":[]}