@agent-native/core 0.123.0 → 0.123.1

package/corpus/templates/crm/server/lib/intelligence/keyword-detector.ts

@@ -0,0 +1,94 @@
+import {
+  type CallEvidenceExcerpt,
+  parseCallEvidenceExcerpts,
+} from "./evidence.js";
+
+export interface KeywordDetectorDefinition {
+  id: string;
+  name: string;
+  kind: "keyword";
+  keywords: string[];
+}
+
+export interface CrmSignalCandidate {
+  detectorId: string;
+  detectorName: string;
+  kind: "keyword" | "smart";
+  evidenceRef: string;
+  quote: string;
+  speaker?: string;
+  startSeconds: number;
+  endSeconds?: number;
+  confidence: number;
+}
+
+function escapeRegex(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function keywordPattern(keyword: string): RegExp | null {
+  const terms = keyword.trim().split(/\s+/).map(escapeRegex).filter(Boolean);
+  if (!terms.length) return null;
+  return new RegExp(`\\b${terms.join("\\s+")}\\b`, "gi");
+}
+
+function boundedQuote(text: string, start: number, end: number): string {
+  const radius = 120;
+  const quoteStart = Math.max(0, start - radius);
+  const quoteEnd = Math.min(text.length, end + radius);
+  return `${quoteStart > 0 ? "…" : ""}${text.slice(quoteStart, quoteEnd)}${
+    quoteEnd < text.length ? "…" : ""
+  }`.trim();
+}
+
+/** Runs deterministic detector matching on already-bounded Clips evidence excerpts. */
+export function runKeywordDetector(
+  detector: KeywordDetectorDefinition,
+  values: unknown,
+): CrmSignalCandidate[] {
+  const excerpts = parseCallEvidenceExcerpts(values);
+  if (!excerpts || !detector.id.trim() || !detector.name.trim()) return [];
+
+  const patterns = detector.keywords
+    .filter((keyword) => typeof keyword === "string" && keyword.trim())
+    .slice(0, 40)
+    .map(keywordPattern)
+    .filter((pattern): pattern is RegExp => pattern !== null);
+  const hits: CrmSignalCandidate[] = [];
+  const seen = new Set<string>();
+
+  for (const excerpt of excerpts) {
+    for (const pattern of patterns) {
+      pattern.lastIndex = 0;
+      let match: RegExpExecArray | null;
+      while ((match = pattern.exec(excerpt.quote)) !== null) {
+        const quote = boundedQuote(
+          excerpt.quote,
+          match.index,
+          match.index + match[0].length,
+        );
+        const key = `${excerpt.evidenceRef}:${excerpt.startSeconds}:${quote}`;
+        if (!seen.has(key)) {
+          seen.add(key);
+          hits.push({
+            detectorId: detector.id,
+            detectorName: detector.name,
+            kind: "keyword",
+            evidenceRef: excerpt.evidenceRef,
+            quote,
+            ...(excerpt.speaker ? { speaker: excerpt.speaker } : {}),
+            startSeconds: excerpt.startSeconds,
+            ...(excerpt.endSeconds !== undefined
+              ? { endSeconds: excerpt.endSeconds }
+              : {}),
+            confidence: 100,
+          });
+        }
+        if (match[0].length === 0) pattern.lastIndex += 1;
+      }
+    }
+  }
+  return hits;
+}
+
+export type { CallEvidenceExcerpt };

package/corpus/templates/crm/server/lib/intelligence/smart-detector.ts

@@ -0,0 +1,39 @@
+import {
+  formatEvidenceTimestamp,
+  parseCallEvidenceExcerpts,
+} from "./evidence.js";
+
+export interface SmartDetectorDefinition {
+  id: string;
+  name: string;
+  description?: string;
+  classifierPrompt: string;
+}
+
+/**
+ * Builds delegated-agent context only. The CRM never invokes a model directly;
+ * callers send this bounded prompt through the agent chat delegation path.
+ */
+export function buildSmartDetectorPrompt(
+  detector: SmartDetectorDefinition,
+  values: unknown,
+): string | null {
+  const excerpts = parseCallEvidenceExcerpts(values, 40);
+  if (
+    !excerpts ||
+    !detector.id.trim() ||
+    !detector.name.trim() ||
+    !detector.classifierPrompt.trim()
+  ) {
+    return null;
+  }
+  const evidenceBlock = excerpts
+    .map(
+      (excerpt) =>
+        `[${excerpt.evidenceRef} ${formatEvidenceTimestamp(excerpt.startSeconds)}${
+          excerpt.speaker ? ` ${excerpt.speaker}` : ""
+        }] ${excerpt.quote}`,
+    )
+    .join("\n");
+  return `Classify bounded CRM call-evidence excerpts for detector "${detector.name}".\n\nCriterion:\n${detector.classifierPrompt.trim()}\n\nEvidence excerpts:\n${evidenceBlock}\n\nReturn only JSON: [{"evidenceRef":"exact evidence reference","quote":"exact verbatim substring from that evidence","confidence":0-100}]. Include only matches. Do not infer facts or create quotes. Never return a transcript.`;
+}

package/corpus/templates/crm/server/lib/intelligence/summary.ts

@@ -0,0 +1,19 @@
+import {
+  formatEvidenceTimestamp,
+  parseCallEvidenceExcerpts,
+} from "./evidence.js";
+
+export function buildCallEvidenceSummaryPrompt(
+  callTitle: string,
+  values: unknown,
+): string | null {
+  const excerpts = parseCallEvidenceExcerpts(values, 40);
+  if (!excerpts || !callTitle.trim() || callTitle.length > 240) return null;
+  const evidence = excerpts
+    .map(
+      (excerpt) =>
+        `[${excerpt.evidenceRef} ${formatEvidenceTimestamp(excerpt.startSeconds)}] ${excerpt.quote}`,
+    )
+    .join("\n");
+  return `Summarize only the bounded Clips call evidence below for "${callTitle.trim()}". Do not infer facts not present in evidence.\n\nEvidence:\n${evidence}\n\nReturn only JSON: {"recap":"<=120 words","keyPoints":[{"text":"<=240 chars","evidenceRef":"exact ref","quoteSeconds":0}],"nextSteps":[{"text":"<=240 chars","evidenceRef":"exact ref","quoteSeconds":0,"owner":"optional <=120 chars"}]}. Every key point and next step must cite one supplied evidence reference and timestamp. Never return a transcript.`;
+}