@automatelab/citation-intelligence 0.5.1 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +74 -8
- package/dist/adapters/anthropic.d.ts.map +1 -1
- package/dist/adapters/anthropic.js +4 -2
- package/dist/adapters/anthropic.js.map +1 -1
- package/dist/adapters/bing.js +1 -1
- package/dist/adapters/bing.js.map +1 -1
- package/dist/adapters/brave.js +1 -1
- package/dist/adapters/brave.js.map +1 -1
- package/dist/adapters/gemini.d.ts.map +1 -1
- package/dist/adapters/gemini.js +5 -1
- package/dist/adapters/gemini.js.map +1 -1
- package/dist/adapters/google-ai-mode.d.ts +6 -0
- package/dist/adapters/google-ai-mode.d.ts.map +1 -0
- package/dist/adapters/google-ai-mode.js +48 -0
- package/dist/adapters/google-ai-mode.js.map +1 -0
- package/dist/adapters/openai.d.ts.map +1 -1
- package/dist/adapters/openai.js +3 -1
- package/dist/adapters/openai.js.map +1 -1
- package/dist/adapters/perplexity.d.ts +2 -1
- package/dist/adapters/perplexity.d.ts.map +1 -1
- package/dist/adapters/perplexity.js +5 -2
- package/dist/adapters/perplexity.js.map +1 -1
- package/dist/index.js +50 -2
- package/dist/index.js.map +1 -1
- package/dist/prompts.d.ts +3 -0
- package/dist/prompts.d.ts.map +1 -0
- package/dist/prompts.js +137 -0
- package/dist/prompts.js.map +1 -0
- package/dist/resources.d.ts +3 -0
- package/dist/resources.d.ts.map +1 -0
- package/dist/resources.js +242 -0
- package/dist/resources.js.map +1 -0
- package/dist/tools/am-i-cited.d.ts +73 -10
- package/dist/tools/am-i-cited.d.ts.map +1 -1
- package/dist/tools/am-i-cited.js +115 -15
- package/dist/tools/am-i-cited.js.map +1 -1
- package/dist/tools/answer-box-position.d.ts +4 -4
- package/dist/tools/answer-box-position.js +2 -2
- package/dist/tools/answer-box-position.js.map +1 -1
- package/dist/tools/canonical-competitor-set.d.ts +73 -0
- package/dist/tools/canonical-competitor-set.d.ts.map +1 -0
- package/dist/tools/canonical-competitor-set.js +208 -0
- package/dist/tools/canonical-competitor-set.js.map +1 -0
- package/dist/tools/check-citations.d.ts +11 -5
- package/dist/tools/check-citations.d.ts.map +1 -1
- package/dist/tools/check-citations.js +41 -8
- package/dist/tools/check-citations.js.map +1 -1
- package/dist/tools/citation-evidence.d.ts +54 -0
- package/dist/tools/citation-evidence.d.ts.map +1 -0
- package/dist/tools/citation-evidence.js +148 -0
- package/dist/tools/citation-evidence.js.map +1 -0
- package/dist/tools/citation-freshness-score.d.ts +4 -4
- package/dist/tools/citation-freshness-score.js +1 -1
- package/dist/tools/citation-freshness-score.js.map +1 -1
- package/dist/tools/citation-provenance.d.ts +6 -4
- package/dist/tools/citation-provenance.d.ts.map +1 -1
- package/dist/tools/citation-provenance.js +17 -8
- package/dist/tools/citation-provenance.js.map +1 -1
- package/dist/tools/cited-for-diff.d.ts +5 -5
- package/dist/tools/cited-for-diff.js +1 -1
- package/dist/tools/cited-for-diff.js.map +1 -1
- package/dist/tools/cited-for.d.ts +5 -5
- package/dist/tools/cited-for.js +1 -1
- package/dist/tools/cited-for.js.map +1 -1
- package/dist/tools/compete-for-query.d.ts +4 -4
- package/dist/tools/compete-for-query.js +1 -1
- package/dist/tools/compete-for-query.js.map +1 -1
- package/dist/tools/crawler-access-audit.d.ts +49 -0
- package/dist/tools/crawler-access-audit.d.ts.map +1 -0
- package/dist/tools/crawler-access-audit.js +256 -0
- package/dist/tools/crawler-access-audit.js.map +1 -0
- package/dist/tools/gsc-citation-gap.d.ts +5 -5
- package/dist/tools/gsc-citation-gap.d.ts.map +1 -1
- package/dist/tools/gsc-citation-gap.js +7 -2
- package/dist/tools/gsc-citation-gap.js.map +1 -1
- package/dist/tools/run-panel.d.ts +5 -5
- package/dist/tools/run-panel.d.ts.map +1 -1
- package/dist/tools/run-panel.js +13 -4
- package/dist/tools/run-panel.js.map +1 -1
- package/dist/tools/sitemap-citation-map.d.ts +77 -0
- package/dist/tools/sitemap-citation-map.d.ts.map +1 -0
- package/dist/tools/sitemap-citation-map.js +149 -0
- package/dist/tools/sitemap-citation-map.js.map +1 -0
- package/dist/tools/structured-data-repair.d.ts +30 -0
- package/dist/tools/structured-data-repair.d.ts.map +1 -0
- package/dist/tools/structured-data-repair.js +297 -0
- package/dist/tools/structured-data-repair.js.map +1 -0
- package/dist/types.d.ts +11 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +24 -1
- package/dist/types.js.map +1 -1
- package/package.json +59 -57
- package/smithery.yaml +50 -0
|
@@ -5,15 +5,31 @@ import { claudeSearch } from "../adapters/anthropic.js";
|
|
|
5
5
|
import { openaiSearch } from "../adapters/openai.js";
|
|
6
6
|
import { geminiSearch } from "../adapters/gemini.js";
|
|
7
7
|
import { braveSearch } from "../adapters/brave.js";
|
|
8
|
+
import { googleAiModeSearch } from "../adapters/google-ai-mode.js";
|
|
8
9
|
import { envKey } from "../lib/config.js";
|
|
9
10
|
import { getCitations, putCitations } from "../lib/cache.js";
|
|
10
11
|
import { ToolFetchError } from "../lib/fetch.js";
|
|
12
|
+
import { ENGINE_SURFACE, ENGINE_INTERPRETATION_NOTE } from "../types.js";
|
|
11
13
|
export const checkCitationsInputSchema = {
|
|
12
14
|
query: z.string().min(1).describe("The search query to test (what would a user ask an AI?)"),
|
|
13
15
|
engine: z
|
|
14
|
-
.enum([
|
|
16
|
+
.enum([
|
|
17
|
+
"perplexity",
|
|
18
|
+
"claude",
|
|
19
|
+
"openai",
|
|
20
|
+
"gemini",
|
|
21
|
+
"bing_serp",
|
|
22
|
+
"brave_serp",
|
|
23
|
+
"brave",
|
|
24
|
+
"google_ai_mode",
|
|
25
|
+
"auto",
|
|
26
|
+
])
|
|
15
27
|
.default("auto")
|
|
16
|
-
.describe("
|
|
28
|
+
.describe("Engine to query.\n" +
|
|
29
|
+
"• perplexity / google_ai_mode — consumer_scrape: closest to real product behavior.\n" +
|
|
30
|
+
"• claude / openai / gemini — api_proxy: API-tier call, may differ from consumer product.\n" +
|
|
31
|
+
"• bing_serp / brave_serp — web_rank: traditional SERP rank, NOT LLM citation.\n" +
|
|
32
|
+
"'auto' prefers SerpAPI (google_ai_mode) → Perplexity → LLM adapters → web_rank."),
|
|
17
33
|
max_results: z
|
|
18
34
|
.number()
|
|
19
35
|
.int()
|
|
@@ -21,9 +37,16 @@ export const checkCitationsInputSchema = {
|
|
|
21
37
|
.max(50)
|
|
22
38
|
.default(10)
|
|
23
39
|
.describe("Maximum citations to return."),
|
|
40
|
+
perplexity_model: z
|
|
41
|
+
.string()
|
|
42
|
+
.optional()
|
|
43
|
+
.describe("Perplexity model override (e.g. 'sonar', 'sonar-pro', 'sonar-reasoning'). Only used when engine='perplexity'. Defaults to 'sonar-pro'."),
|
|
24
44
|
};
|
|
25
45
|
const inputSchema = z.object(checkCitationsInputSchema);
|
|
46
|
+
/** auto-pick prefers consumer_scrape surfaces first, then api_proxy, then web_rank */
|
|
26
47
|
function pickAutoEngine() {
|
|
48
|
+
if (envKey("SERPAPI_KEY"))
|
|
49
|
+
return "google_ai_mode";
|
|
27
50
|
if (envKey("PERPLEXITY_API_KEY"))
|
|
28
51
|
return "perplexity";
|
|
29
52
|
if (envKey("ANTHROPIC_API_KEY"))
|
|
@@ -33,25 +56,28 @@ function pickAutoEngine() {
|
|
|
33
56
|
if (envKey("GEMINI_API_KEY"))
|
|
34
57
|
return "gemini";
|
|
35
58
|
if (envKey("BRAVE_API_KEY"))
|
|
36
|
-
return "
|
|
59
|
+
return "brave_serp";
|
|
37
60
|
if (envKey("BING_API_KEY"))
|
|
38
|
-
return "
|
|
61
|
+
return "bing_serp";
|
|
39
62
|
return null;
|
|
40
63
|
}
|
|
41
|
-
async function runEngine(engine, query, maxResults) {
|
|
64
|
+
async function runEngine(engine, query, maxResults, perplexityModel) {
|
|
42
65
|
switch (engine) {
|
|
43
66
|
case "perplexity":
|
|
44
|
-
return perplexitySearch(query, maxResults);
|
|
67
|
+
return perplexitySearch(query, maxResults, perplexityModel);
|
|
45
68
|
case "claude":
|
|
46
69
|
return claudeSearch(query, maxResults);
|
|
47
70
|
case "openai":
|
|
48
71
|
return openaiSearch(query, maxResults);
|
|
49
72
|
case "gemini":
|
|
50
73
|
return geminiSearch(query, maxResults);
|
|
51
|
-
case "
|
|
74
|
+
case "bing_serp":
|
|
52
75
|
return bingSearch(query, maxResults);
|
|
76
|
+
case "brave_serp":
|
|
53
77
|
case "brave":
|
|
54
78
|
return braveSearch(query, maxResults);
|
|
79
|
+
case "google_ai_mode":
|
|
80
|
+
return googleAiModeSearch(query, maxResults);
|
|
55
81
|
case "auto":
|
|
56
82
|
throw new Error("auto engine should be resolved before runEngine");
|
|
57
83
|
}
|
|
@@ -73,18 +99,23 @@ export async function checkCitations(input) {
|
|
|
73
99
|
else {
|
|
74
100
|
engine = requested;
|
|
75
101
|
}
|
|
102
|
+
const engineKey = engine;
|
|
103
|
+
const surface = ENGINE_SURFACE[engineKey];
|
|
104
|
+
const interpretation_note = ENGINE_INTERPRETATION_NOTE[engineKey];
|
|
76
105
|
const cached = await getCitations(parsed.query, engine);
|
|
77
106
|
if (cached) {
|
|
78
107
|
return {
|
|
79
108
|
query: parsed.query,
|
|
80
109
|
engine,
|
|
110
|
+
surface,
|
|
111
|
+
interpretation_note,
|
|
81
112
|
fetched_at: cached.fetched_at,
|
|
82
113
|
citations: cached.citations.slice(0, parsed.max_results),
|
|
83
114
|
raw_answer: cached.raw_answer,
|
|
84
115
|
cached: true,
|
|
85
116
|
};
|
|
86
117
|
}
|
|
87
|
-
const result = await runEngine(engine, parsed.query, parsed.max_results);
|
|
118
|
+
const result = await runEngine(engine, parsed.query, parsed.max_results, parsed.perplexity_model);
|
|
88
119
|
const fetched_at = new Date().toISOString();
|
|
89
120
|
await putCitations({
|
|
90
121
|
type: "citation_check",
|
|
@@ -97,6 +128,8 @@ export async function checkCitations(input) {
|
|
|
97
128
|
return {
|
|
98
129
|
query: parsed.query,
|
|
99
130
|
engine,
|
|
131
|
+
surface,
|
|
132
|
+
interpretation_note,
|
|
100
133
|
fetched_at,
|
|
101
134
|
citations: result.citations,
|
|
102
135
|
raw_answer: result.raw_answer,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"check-citations.js","sourceRoot":"","sources":["../../src/tools/check-citations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"check-citations.js","sourceRoot":"","sources":["../../src/tools/check-citations.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const citationEvidenceInputSchema: {
|
|
3
|
+
query: z.ZodString;
|
|
4
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
5
|
+
max_results: z.ZodDefault<z.ZodNumber>;
|
|
6
|
+
context_chars: z.ZodDefault<z.ZodNumber>;
|
|
7
|
+
};
|
|
8
|
+
declare const inputSchema: z.ZodObject<{
|
|
9
|
+
query: z.ZodString;
|
|
10
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
11
|
+
max_results: z.ZodDefault<z.ZodNumber>;
|
|
12
|
+
context_chars: z.ZodDefault<z.ZodNumber>;
|
|
13
|
+
}, "strip", z.ZodTypeAny, {
|
|
14
|
+
query: string;
|
|
15
|
+
engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
|
|
16
|
+
max_results: number;
|
|
17
|
+
context_chars: number;
|
|
18
|
+
}, {
|
|
19
|
+
query: string;
|
|
20
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto" | undefined;
|
|
21
|
+
max_results?: number | undefined;
|
|
22
|
+
context_chars?: number | undefined;
|
|
23
|
+
}>;
|
|
24
|
+
export declare function citationEvidence(input: z.infer<typeof inputSchema>): Promise<{
|
|
25
|
+
query: string;
|
|
26
|
+
engine: import("../types.js").Engine;
|
|
27
|
+
fetched_at: string;
|
|
28
|
+
raw_answer_chars: number;
|
|
29
|
+
has_raw_answer: boolean;
|
|
30
|
+
citations_total: number;
|
|
31
|
+
evidence_found: number;
|
|
32
|
+
evidence: ({
|
|
33
|
+
url: string;
|
|
34
|
+
rank: number;
|
|
35
|
+
title: string | undefined;
|
|
36
|
+
found: boolean;
|
|
37
|
+
snippet: string | null;
|
|
38
|
+
nearby_quote: null;
|
|
39
|
+
mention_char: null;
|
|
40
|
+
matched?: undefined;
|
|
41
|
+
} | {
|
|
42
|
+
url: string;
|
|
43
|
+
rank: number;
|
|
44
|
+
title: string | undefined;
|
|
45
|
+
found: boolean;
|
|
46
|
+
snippet: string;
|
|
47
|
+
nearby_quote: string | null;
|
|
48
|
+
mention_char: number;
|
|
49
|
+
matched: string;
|
|
50
|
+
})[];
|
|
51
|
+
note: string;
|
|
52
|
+
}>;
|
|
53
|
+
export {};
|
|
54
|
+
//# sourceMappingURL=citation-evidence.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"citation-evidence.d.ts","sourceRoot":"","sources":["../../src/tools/citation-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,2BAA2B;;;;;CA2BvC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAAwC,CAAC;AAkF1D,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDxE"}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { checkCitations } from "./check-citations.js";
|
|
3
|
+
import { log } from "../lib/log.js";
|
|
4
|
+
export const citationEvidenceInputSchema = {
|
|
5
|
+
query: z
|
|
6
|
+
.string()
|
|
7
|
+
.min(1)
|
|
8
|
+
.describe("Search query whose AI answer to extract citation evidence from."),
|
|
9
|
+
engine: z
|
|
10
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"])
|
|
11
|
+
.default("auto")
|
|
12
|
+
.describe("AI engine to query. web_rank engines (bing_serp, brave_serp) lack raw_answer and return no evidence."),
|
|
13
|
+
max_results: z
|
|
14
|
+
.number()
|
|
15
|
+
.int()
|
|
16
|
+
.min(1)
|
|
17
|
+
.max(20)
|
|
18
|
+
.default(10)
|
|
19
|
+
.describe("Max citations to extract evidence for."),
|
|
20
|
+
context_chars: z
|
|
21
|
+
.number()
|
|
22
|
+
.int()
|
|
23
|
+
.min(40)
|
|
24
|
+
.max(800)
|
|
25
|
+
.default(240)
|
|
26
|
+
.describe("Half-width of the snippet window around each citation mention (chars). Total snippet is up to 2x this."),
|
|
27
|
+
};
|
|
28
|
+
const inputSchema = z.object(citationEvidenceInputSchema);
|
|
29
|
+
function candidateMentions(url) {
|
|
30
|
+
const set = new Set();
|
|
31
|
+
set.add(url);
|
|
32
|
+
set.add(url.replace(/^https?:\/\//, ""));
|
|
33
|
+
set.add(url.replace(/^https?:\/\/(www\.)?/, ""));
|
|
34
|
+
try {
|
|
35
|
+
const u = new URL(url);
|
|
36
|
+
set.add(u.hostname);
|
|
37
|
+
set.add(u.hostname.replace(/^www\./, ""));
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
// ignore
|
|
41
|
+
}
|
|
42
|
+
return [...set].filter(Boolean);
|
|
43
|
+
}
|
|
44
|
+
function findFirstMention(url, text) {
|
|
45
|
+
if (!text)
|
|
46
|
+
return null;
|
|
47
|
+
let best = null;
|
|
48
|
+
for (const c of candidateMentions(url)) {
|
|
49
|
+
const idx = text.indexOf(c);
|
|
50
|
+
if (idx !== -1 && (!best || idx < best.index))
|
|
51
|
+
best = { index: idx, matched: c };
|
|
52
|
+
}
|
|
53
|
+
return best;
|
|
54
|
+
}
|
|
55
|
+
function extractWindow(text, centerStart, centerLen, halfWidth) {
|
|
56
|
+
const start = Math.max(0, centerStart - halfWidth);
|
|
57
|
+
const end = Math.min(text.length, centerStart + centerLen + halfWidth);
|
|
58
|
+
let snippet = text.slice(start, end);
|
|
59
|
+
if (start > 0)
|
|
60
|
+
snippet = `…${snippet}`;
|
|
61
|
+
if (end < text.length)
|
|
62
|
+
snippet = `${snippet}…`;
|
|
63
|
+
return { snippet, window_start: start, window_end: end };
|
|
64
|
+
}
|
|
65
|
+
// Try to extract a quoted span if one wraps the URL mention. Falls back to
|
|
66
|
+
// sentence containing the mention. Otherwise empty.
|
|
67
|
+
function nearestQuotedOrSentence(text, mentionIdx) {
|
|
68
|
+
if (!text || mentionIdx < 0)
|
|
69
|
+
return undefined;
|
|
70
|
+
const QUOTE_CHARS = ['"', "“", "”", "「", "」"];
|
|
71
|
+
// search backward and forward for nearest matching quote pair
|
|
72
|
+
for (const q of QUOTE_CHARS) {
|
|
73
|
+
const left = text.lastIndexOf(q, mentionIdx);
|
|
74
|
+
if (left === -1)
|
|
75
|
+
continue;
|
|
76
|
+
const right = text.indexOf(q, mentionIdx);
|
|
77
|
+
if (right === -1 || right - left > 800)
|
|
78
|
+
continue;
|
|
79
|
+
const inner = text.slice(left + 1, right).trim();
|
|
80
|
+
if (inner.length >= 8)
|
|
81
|
+
return inner;
|
|
82
|
+
}
|
|
83
|
+
// fallback: containing sentence
|
|
84
|
+
const sentStart = Math.max(text.lastIndexOf(".", mentionIdx), text.lastIndexOf("!", mentionIdx), text.lastIndexOf("?", mentionIdx), text.lastIndexOf("\n", mentionIdx));
|
|
85
|
+
const sentEnd = (() => {
|
|
86
|
+
const candidates = [
|
|
87
|
+
text.indexOf(".", mentionIdx),
|
|
88
|
+
text.indexOf("!", mentionIdx),
|
|
89
|
+
text.indexOf("?", mentionIdx),
|
|
90
|
+
text.indexOf("\n", mentionIdx),
|
|
91
|
+
].filter((i) => i !== -1);
|
|
92
|
+
return candidates.length > 0 ? Math.min(...candidates) : text.length;
|
|
93
|
+
})();
|
|
94
|
+
const sent = text.slice(sentStart + 1, sentEnd + 1).trim();
|
|
95
|
+
if (sent.length >= 12 && sent.length <= 600)
|
|
96
|
+
return sent;
|
|
97
|
+
return undefined;
|
|
98
|
+
}
|
|
99
|
+
export async function citationEvidence(input) {
|
|
100
|
+
const parsed = inputSchema.parse(input);
|
|
101
|
+
log.debug("citation_evidence start", { query: parsed.query });
|
|
102
|
+
const res = await checkCitations({
|
|
103
|
+
query: parsed.query,
|
|
104
|
+
engine: parsed.engine,
|
|
105
|
+
max_results: parsed.max_results,
|
|
106
|
+
});
|
|
107
|
+
const raw = res.raw_answer ?? "";
|
|
108
|
+
const has_raw = raw.length > 0;
|
|
109
|
+
const evidence = res.citations.map((c) => {
|
|
110
|
+
const mention = has_raw ? findFirstMention(c.url, raw) : null;
|
|
111
|
+
if (!mention) {
|
|
112
|
+
return {
|
|
113
|
+
url: c.url,
|
|
114
|
+
rank: c.rank,
|
|
115
|
+
title: c.title,
|
|
116
|
+
found: false,
|
|
117
|
+
snippet: c.snippet ?? null,
|
|
118
|
+
nearby_quote: null,
|
|
119
|
+
mention_char: null,
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
const { snippet } = extractWindow(raw, mention.index, mention.matched.length, parsed.context_chars);
|
|
123
|
+
return {
|
|
124
|
+
url: c.url,
|
|
125
|
+
rank: c.rank,
|
|
126
|
+
title: c.title,
|
|
127
|
+
found: true,
|
|
128
|
+
snippet,
|
|
129
|
+
nearby_quote: nearestQuotedOrSentence(raw, mention.index) ?? null,
|
|
130
|
+
mention_char: mention.index,
|
|
131
|
+
matched: mention.matched,
|
|
132
|
+
};
|
|
133
|
+
});
|
|
134
|
+
return {
|
|
135
|
+
query: parsed.query,
|
|
136
|
+
engine: res.engine,
|
|
137
|
+
fetched_at: new Date().toISOString(),
|
|
138
|
+
raw_answer_chars: raw.length,
|
|
139
|
+
has_raw_answer: has_raw,
|
|
140
|
+
citations_total: res.citations.length,
|
|
141
|
+
evidence_found: evidence.filter((e) => e.found).length,
|
|
142
|
+
evidence,
|
|
143
|
+
note: has_raw
|
|
144
|
+
? "snippet is a window around the first mention of the URL/hostname in the engine's raw_answer. nearby_quote tries to extract a quoted span or containing sentence."
|
|
145
|
+
: "engine returned no raw_answer (Bing/Brave style listings, or empty answer). evidence is limited to whatever per-citation snippet the adapter parsed.",
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
//# sourceMappingURL=citation-evidence.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"citation-evidence.js","sourceRoot":"","sources":["../../src/tools/citation-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;SACvG,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CACP,sGAAsG,CACvG;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,wCAAwC,CAAC;IACrD,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CACP,wGAAwG,CACzG;CACJ,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAE1D,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACb,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACpB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CACvB,GAAW,EACX,IAAY;IAEZ,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,GAA8C,IAAI,CAAC;IAC3D,KAAK,MAAM,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CACpB,IAAY,EACZ,WAAmB,EACnB,SAAiB,EACjB,SAAiB;IAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IACvC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,GAAG,OAAO,GAAG,CAAC;IAC/C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AAC3D,CAAC;AAED,2EAA2E;AAC3E,oDAAoD;AACpD,SAAS,uBAAuB,CAC9B,IAAY,EACZ,UAAkB;IAElB,IAAI,CAAC,IAAI,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,IAAI,KAAK,CAAC,CAAC;YAAE,SAAS;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,GAAG,GAAG;YAAE,SAAS;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IACD,gCAAgC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,EACjC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,EACjC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,EACjC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CACnC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;QACpB,MAAM,UAAU,GAAG;YACjB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;SAC/B,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACvE,CAAC,CAAC,EAAE,CAAC;IACL,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAkC;IACvE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAE9D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;gBAC1B,YAAY,EAAE,IAAI;gBAClB,YAAY,EAAE,IAAI;aACnB,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAC/B,GAAG,EACH,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,OAAO,CAAC,MAAM,EACtB,MAAM,CAAC,aAAa,CACrB,CAAC;QACF,OAAO;YACL,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,IAAI;YACX,OAAO;YACP,YAAY,EAAE,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI;YACjE,YAAY,EAAE,OAAO,CAAC,KAAK;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,gBAAgB,EAAE,GAAG,CAAC,MAAM;QAC5B,cAAc,EAAE,OAAO;QACvB,eAAe,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM;QACrC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM;QACtD,QAAQ;QACR,IAAI,EAAE,OAAO;YACX,CAAC,CAAC,kKAAkK;YACpK,CAAC,CAAC,sJAAsJ;KAC3J,CAAC;AACJ,CAAC"}
|
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
export declare const citationFreshnessScoreInputSchema: {
|
|
3
3
|
query: z.ZodString;
|
|
4
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
4
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
5
5
|
max_results: z.ZodDefault<z.ZodNumber>;
|
|
6
6
|
};
|
|
7
7
|
declare const inputSchema: z.ZodObject<{
|
|
8
8
|
query: z.ZodString;
|
|
9
|
-
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
9
|
+
engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
|
|
10
10
|
max_results: z.ZodDefault<z.ZodNumber>;
|
|
11
11
|
}, "strip", z.ZodTypeAny, {
|
|
12
12
|
query: string;
|
|
13
|
-
engine: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
13
|
+
engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
|
|
14
14
|
max_results: number;
|
|
15
15
|
}, {
|
|
16
16
|
query: string;
|
|
17
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
17
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto" | undefined;
|
|
18
18
|
max_results?: number | undefined;
|
|
19
19
|
}>;
|
|
20
20
|
export declare function citationFreshnessScore(input: z.infer<typeof inputSchema>): Promise<{
|
|
@@ -5,7 +5,7 @@ import { log } from "../lib/log.js";
|
|
|
5
5
|
export const citationFreshnessScoreInputSchema = {
|
|
6
6
|
query: z.string().min(1).describe("Search query whose cited URLs to score for freshness."),
|
|
7
7
|
engine: z
|
|
8
|
-
.enum(["perplexity", "claude", "openai", "gemini", "
|
|
8
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"])
|
|
9
9
|
.default("auto")
|
|
10
10
|
.describe("AI engine to query for the citation set."),
|
|
11
11
|
max_results: z
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"citation-freshness-score.js","sourceRoot":"","sources":["../../src/tools/citation-freshness-score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IAC1F,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"citation-freshness-score.js","sourceRoot":"","sources":["../../src/tools/citation-freshness-score.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,21 +2,21 @@ import { z } from "zod";
|
|
|
2
2
|
import type { Engine } from "../types.js";
|
|
3
3
|
export declare const citationProvenanceInputSchema: {
|
|
4
4
|
query: z.ZodString;
|
|
5
|
-
engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
5
|
+
engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "google_ai_mode", "bing_serp", "brave_serp"]>, "many">>;
|
|
6
6
|
max_results: z.ZodDefault<z.ZodNumber>;
|
|
7
7
|
};
|
|
8
8
|
declare const inputSchema: z.ZodObject<{
|
|
9
9
|
query: z.ZodString;
|
|
10
|
-
engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
10
|
+
engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "google_ai_mode", "bing_serp", "brave_serp"]>, "many">>;
|
|
11
11
|
max_results: z.ZodDefault<z.ZodNumber>;
|
|
12
12
|
}, "strip", z.ZodTypeAny, {
|
|
13
13
|
query: string;
|
|
14
14
|
max_results: number;
|
|
15
|
-
engines?: ("perplexity" | "claude" | "openai" | "gemini" | "
|
|
15
|
+
engines?: ("perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode")[] | undefined;
|
|
16
16
|
}, {
|
|
17
17
|
query: string;
|
|
18
18
|
max_results?: number | undefined;
|
|
19
|
-
engines?: ("perplexity" | "claude" | "openai" | "gemini" | "
|
|
19
|
+
engines?: ("perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode")[] | undefined;
|
|
20
20
|
}>;
|
|
21
21
|
export declare function citationProvenance(input: z.infer<typeof inputSchema>): Promise<{
|
|
22
22
|
query: string;
|
|
@@ -34,6 +34,8 @@ export declare function citationProvenance(input: z.infer<typeof inputSchema>):
|
|
|
34
34
|
fetched_at: string;
|
|
35
35
|
engines: {
|
|
36
36
|
engine: Engine;
|
|
37
|
+
surface: import("../types.js").Surface;
|
|
38
|
+
interpretation_note: string;
|
|
37
39
|
ok: boolean;
|
|
38
40
|
citations: number;
|
|
39
41
|
error: string | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"citation-provenance.d.ts","sourceRoot":"","sources":["../../src/tools/citation-provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"citation-provenance.d.ts","sourceRoot":"","sources":["../../src/tools/citation-provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,eAAO,MAAM,6BAA6B;;;;CAmBzC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAA0C,CAAC;AAa5D,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoF1E"}
|
|
@@ -2,14 +2,17 @@ import { z } from "zod";
|
|
|
2
2
|
import { envKey } from "../lib/config.js";
|
|
3
3
|
import { checkCitations } from "./check-citations.js";
|
|
4
4
|
import { log } from "../lib/log.js";
|
|
5
|
+
import { ENGINE_SURFACE, ENGINE_INTERPRETATION_NOTE } from "../types.js";
|
|
5
6
|
export const citationProvenanceInputSchema = {
|
|
6
7
|
query: z.string().min(1).describe("Search query to fan out across multiple engines."),
|
|
7
8
|
engines: z
|
|
8
|
-
.array(z.enum(["perplexity", "claude", "openai", "gemini", "
|
|
9
|
+
.array(z.enum(["perplexity", "claude", "openai", "gemini", "google_ai_mode", "bing_serp", "brave_serp"]))
|
|
9
10
|
.min(1)
|
|
10
|
-
.max(
|
|
11
|
+
.max(7)
|
|
11
12
|
.optional()
|
|
12
|
-
.describe("Engines to query. If omitted, uses all engines with a configured API key
|
|
13
|
+
.describe("Engines to query. If omitted, uses all LLM engines with a configured API key " +
|
|
14
|
+
"(perplexity, claude, openai, gemini, google_ai_mode). " +
|
|
15
|
+
"Include bing_serp/brave_serp only when you explicitly want web_rank comparison."),
|
|
13
16
|
max_results: z
|
|
14
17
|
.number()
|
|
15
18
|
.int()
|
|
@@ -19,8 +22,11 @@ export const citationProvenanceInputSchema = {
|
|
|
19
22
|
.describe("Max citations per engine."),
|
|
20
23
|
};
|
|
21
24
|
const inputSchema = z.object(citationProvenanceInputSchema);
|
|
25
|
+
/** Returns only LLM engines by default (no web_rank) — consistent with citation provenance intent */
|
|
22
26
|
function availableEngines() {
|
|
23
27
|
const list = [];
|
|
28
|
+
if (envKey("SERPAPI_KEY"))
|
|
29
|
+
list.push("google_ai_mode");
|
|
24
30
|
if (envKey("PERPLEXITY_API_KEY"))
|
|
25
31
|
list.push("perplexity");
|
|
26
32
|
if (envKey("ANTHROPIC_API_KEY"))
|
|
@@ -29,10 +35,6 @@ function availableEngines() {
|
|
|
29
35
|
list.push("openai");
|
|
30
36
|
if (envKey("GEMINI_API_KEY"))
|
|
31
37
|
list.push("gemini");
|
|
32
|
-
if (envKey("BRAVE_API_KEY"))
|
|
33
|
-
list.push("brave");
|
|
34
|
-
if (envKey("BING_API_KEY"))
|
|
35
|
-
list.push("bing");
|
|
36
38
|
return list;
|
|
37
39
|
}
|
|
38
40
|
export async function citationProvenance(input) {
|
|
@@ -83,7 +85,14 @@ export async function citationProvenance(input) {
|
|
|
83
85
|
return {
|
|
84
86
|
query: parsed.query,
|
|
85
87
|
fetched_at: new Date().toISOString(),
|
|
86
|
-
engines: runs.map((r) => ({
|
|
88
|
+
engines: runs.map((r) => ({
|
|
89
|
+
engine: r.engine,
|
|
90
|
+
surface: ENGINE_SURFACE[r.engine],
|
|
91
|
+
interpretation_note: ENGINE_INTERPRETATION_NOTE[r.engine],
|
|
92
|
+
ok: r.ok,
|
|
93
|
+
citations: r.urls.length,
|
|
94
|
+
error: r.error,
|
|
95
|
+
})),
|
|
87
96
|
engines_queried: runs.length,
|
|
88
97
|
engines_succeeded: okRuns.length,
|
|
89
98
|
per_url: perUrl,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"citation-provenance.js","sourceRoot":"","sources":["../../src/tools/citation-provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"citation-provenance.js","sourceRoot":"","sources":["../../src/tools/citation-provenance.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,27 +3,27 @@ export declare const citedForDiffInputSchema: {
|
|
|
3
3
|
domain: z.ZodString;
|
|
4
4
|
baseline_until: z.ZodString;
|
|
5
5
|
current_since: z.ZodOptional<z.ZodString>;
|
|
6
|
-
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
6
|
+
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode"]>>;
|
|
7
7
|
};
|
|
8
8
|
declare const inputSchema: z.ZodObject<{
|
|
9
9
|
domain: z.ZodString;
|
|
10
10
|
baseline_until: z.ZodString;
|
|
11
11
|
current_since: z.ZodOptional<z.ZodString>;
|
|
12
|
-
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "
|
|
12
|
+
engine: z.ZodOptional<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode"]>>;
|
|
13
13
|
}, "strip", z.ZodTypeAny, {
|
|
14
14
|
domain: string;
|
|
15
15
|
baseline_until: string;
|
|
16
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
16
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | undefined;
|
|
17
17
|
current_since?: string | undefined;
|
|
18
18
|
}, {
|
|
19
19
|
domain: string;
|
|
20
20
|
baseline_until: string;
|
|
21
|
-
engine?: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
21
|
+
engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | undefined;
|
|
22
22
|
current_since?: string | undefined;
|
|
23
23
|
}>;
|
|
24
24
|
export declare function citedForDiff(input: z.infer<typeof inputSchema>): Promise<{
|
|
25
25
|
domain: string;
|
|
26
|
-
engine_filter: "perplexity" | "claude" | "openai" | "gemini" | "
|
|
26
|
+
engine_filter: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | undefined;
|
|
27
27
|
baseline_until: string;
|
|
28
28
|
current_since: string;
|
|
29
29
|
fetched_at: string;
|
|
@@ -11,7 +11,7 @@ export const citedForDiffInputSchema = {
|
|
|
11
11
|
.optional()
|
|
12
12
|
.describe("ISO date floor for the 'current' window. Defaults to baseline_until."),
|
|
13
13
|
engine: z
|
|
14
|
-
.enum(["perplexity", "claude", "openai", "gemini", "
|
|
14
|
+
.enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode"])
|
|
15
15
|
.optional()
|
|
16
16
|
.describe("Filter by engine. Omit to include all."),
|
|
17
17
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cited-for-diff.js","sourceRoot":"","sources":["../../src/tools/cited-for-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC9E,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,CAAC,sGAAsG,CAAC;IACnH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"cited-for-diff.js","sourceRoot":"","sources":["../../src/tools/cited-for-diff.ts"],"names":[],"mappings":"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"}
|