@easyoref/agent 1.21.1

package/dist/nodes/clarify.js

@@ -0,0 +1,124 @@
+/**
+ * Clarify Node — optional ReAct tool calling for low-confidence enrichment.
+ */
+import * as logger from "@easyoref/monitoring";
+import { ClarifyOutputSchema, config, pushSessionPost, } from "@easyoref/shared";
+import { ChatOpenRouter } from "@langchain/openrouter";
+import { createAgent, toolStrategy } from "langchain";
+import { clarifyTools } from "../tools/index.js";
+const clarifyModel = new ChatOpenRouter({
+    apiKey: config.agent.apiKey,
+    model: config.agent.filterModel,
+    temperature: 0,
+    maxTokens: 600,
+});
+const clarifyAgent = createAgent({
+    model: clarifyModel,
+    tools: clarifyTools,
+    responseFormat: toolStrategy(ClarifyOutputSchema),
+    systemPrompt: `
+  You are the clarification agent for EasyOref — an Israeli missile alert enrichment system.
+
+  The voting pipeline analyzed Telegram channel posts and produced a result with
+  low confidence or contradictions. You have access to 4 tools:
+
+    1. read_telegram_sources — fetch last N posts from a Telegram news channel
+    2. alert_history — get recent alert history from Pikud HaOref.
+    3. resolve_area — check if a location mentioned in news is relevant to user's areas.
+    4. betterstack_log — query recent EasyOref logs from Better Stack.
+
+  CRITICAL — TIME VALIDATION:
+  You receive the alert time (Israel timezone). Channel posts may be about PREVIOUS
+  attacks or ongoing military operations (not THIS specific alert). When in doubt:
+  - Use alert_history to verify if an alert really occurred at the claimed time/area.
+  - If a post discusses events from hours ago, it is STALE — ignore it.
+
+  You decide whether tools would help:
+  - If contradictions can be resolved with existing data → respond immediately, no tools.
+  - If an authoritative source (IDF, N12) could settle a disagreement → fetch 1-4 posts.
+  - If you need to verify whether an alert occurred → check alert_history.
+
+  Always respect an output format.
+  `,
+});
+const describeContradictions = (extractions, voted) => {
+    const issues = [];
+    if (voted.countryorigins && voted.countryorigins.length > 1) {
+        const names = voted.countryorigins.map((c) => c.name).join(", ");
+        issues.push(`Multiple origin countries reported: ${names}`);
+    }
+    if (voted.rocket_count_min &&
+        voted.rocket_count_max &&
+        voted.rocket_count_max - voted.rocket_count_min > 3) {
+        issues.push(`Wide rocket count range: ${voted.rocket_count_min}–${voted.rocket_count_max}`);
+    }
+    if ((voted.intercepted_confidence ?? 0) < 0.5 &&
+        voted.intercepted !== undefined) {
+        issues.push(`Intercepted count (${voted.intercepted}) has low confidence: ${(voted.intercepted_confidence ?? 0).toFixed(2)}`);
+    }
+    issues.push(`Overall confidence: ${voted.confidence}`);
+    issues.push(`Sources count: ${voted.sources_count}`);
+    return issues.join("\n");
+};
+export const clarifyNode = async (state) => {
+    if (!state.votedResult) {
+        logger.info("Agent: clarify skipped — no voted result", {
+            alertId: state.alertId,
+        });
+        return { clarifyAttempted: true };
+    }
+    logger.info("Agent: clarify triggered", {
+        alertId: state.alertId,
+        confidence: state.votedResult.confidence,
+    });
+    try {
+        const contradictions = describeContradictions(state.extractions, state.votedResult);
+        const alertTimeIL = new Date(state.alertTs).toLocaleTimeString("he-IL", {
+            hour: "2-digit",
+            minute: "2-digit",
+            timeZone: "Asia/Jerusalem",
+        });
+        const userPrompt = `Alert region: ${state.alertAreas.join(", ")}\n` +
+            `Alert type: ${state.alertType}\n` +
+            `Alert time: ${alertTimeIL} (Israel)\n` +
+            `Message ID: ${state.messageId}\n\n` +
+            `Current voted result:\n` +
+            JSON.stringify(state.votedResult, undefined, 2) +
+            `\n\nContradictions & issues:\n${contradictions}\n\n` +
+            `Existing extractions (${state.extractions.filter((e) => e.valid).length} valid):\n` +
+            state.extractions
+                .filter((e) => e.valid)
+                .map((e) => `  [${e.channel}] country=${e.countryorigin}, rockets=${e.rocket_count}, ` +
+                `intercepted=${e.intercepted}, hits=${e.hitsconfirmed}, conf=${e.confidence}`)
+                .join("\n") +
+            `\n\nDecide: would fetching more data from authoritative channels resolve these issues?`;
+        const result = await clarifyAgent.invoke({ messages: [userPrompt] });
+        const output = result.structuredResponse;
+        const newPosts = [];
+        if (output?.newPosts) {
+            for (const p of output.newPosts) {
+                const post = {
+                    channel: p.channel,
+                    text: p.text,
+                    ts: p.ts,
+                    messageUrl: p.messageUrl,
+                };
+                newPosts.push(post);
+                await pushSessionPost(post);
+            }
+        }
+        return {
+            extractions: [...state.extractions, ...(output?.newExtractions ?? [])],
+            votedResult: undefined,
+            clarifyAttempted: true,
+        };
+    }
+    catch (err) {
+        logger.error("Agent: clarify failed", {
+            alertId: state.alertId,
+            error: String(err),
+        });
+        return { clarifyAttempted: true };
+    }
+};
+//# sourceMappingURL=clarify.js.map

package/dist/nodes/clarify.js.map

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

package/dist/nodes/edit-node.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Message building and Telegram editing.
+ *
+ * Builds enriched message text from voted consensus + carry-forward data.
+ * Uses inline [[1]](url) citations. No superscripts. No footer sources.
+ */
+import type { AlertType, CitedSource, EnrichmentData, InlineCite, VotedResult } from "@easyoref/shared";
+/** EN country name → Russian */
+export declare const COUNTRY_RU: Record<string, string>;
+/** Format inline citations: [[1]](url), [[2]](url) */
+export declare function inlineCites(indices: number[], citedSources: CitedSource[]): string;
+/** Get InlineCite[] from citation indices */
+export declare function extractCites(indices: number[], citedSources: CitedSource[]): InlineCite[];
+/** Format inline citations from InlineCite[] (carry-forward data) */
+export declare function inlineCitesFromData(cites: InlineCite[]): string;
+/**
+ * Build a global URL→index map across ALL enrichment fields.
+ * Deduplicates by URL so the same source gets the same [N] everywhere.
+ */
+export declare function buildGlobalCiteMap(enrichment: EnrichmentData): Map<string, number>;
+/** Format inline citations using global numbering */
+export declare function renderCitesGlobal(cites: InlineCite[], globalMap: Map<string, number>): string;
+export declare const SKIP = 0.6;
+export declare const UNCERTAIN = 0.75;
+export declare const CERTAIN = 0.95;
+/** Strip custom-emoji monitoring line from message text */
+export declare const MONITORING_RE: RegExp;
+export declare function stripMonitoring(text: string): string;
+export declare function appendMonitoring(text: string, label: string): string;
+/**
+ * Build enrichment data from current vote + previous enrichment (carry-forward).
+ * Returns updated EnrichmentData for Redis persistence.
+ */
+export declare function buildEnrichmentFromVote(result: VotedResult, prev: EnrichmentData, alertType: AlertType, alertTs: number): EnrichmentData;
+/**
+ * Build the enriched message text from current message + enrichment data.
+ * Uses inline [[1]](url) citations.
+ */
+export declare function buildEnrichedMessage(currentText: string, alertType: AlertType, alertTs: number, enrichment: EnrichmentData, monitoringLabel?: string): string;
+/**
+ * Insert a line before </blockquote> (or legacy time line as fallback).
+ */
+export declare function insertBeforeBlockEnd(text: string, line: string): string;
+/** @deprecated Use insertBeforeBlockEnd */
+export declare const insertBeforeTimeLine: typeof insertBeforeBlockEnd;
+export interface TelegramTargetMessage {
+    chatId: string;
+    messageId: number;
+    isCaption: boolean;
+}
+export interface EditMessageInput {
+    alertId: string;
+    alertTs: number;
+    alertType: AlertType;
+    chatId: string;
+    messageId: number;
+    isCaption: boolean;
+    telegramMessages?: TelegramTargetMessage[];
+    currentText: string;
+    votedResult: VotedResult | undefined;
+    previousEnrichment: EnrichmentData;
+    monitoringLabel?: string;
+}
+/**
+ * Edit the Telegram message with enriched data.
+ */
+export declare const editTelegramMessage: (input: EditMessageInput) => Promise<void>;
+export declare const editMessage: (input: EditMessageInput) => Promise<void>;
+import type { AgentStateType } from "../graph.js";
+export declare const editNode: (state: AgentStateType) => Promise<Partial<AgentStateType>>;
+//# sourceMappingURL=edit-node.d.ts.map

package/dist/nodes/edit-node.d.ts.map

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