@automatelab/citation-intelligence 0.4.0 → 0.5.1

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.
Files changed (51) hide show
  1. package/dist/adapters/brave.d.ts +3 -0
  2. package/dist/adapters/brave.d.ts.map +1 -0
  3. package/dist/adapters/brave.js +36 -0
  4. package/dist/adapters/brave.js.map +1 -0
  5. package/dist/adapters/openai.d.ts.map +1 -1
  6. package/dist/adapters/openai.js +4 -1
  7. package/dist/adapters/openai.js.map +1 -1
  8. package/dist/index.js +26 -2
  9. package/dist/index.js.map +1 -1
  10. package/dist/lib/fetch.d.ts +9 -0
  11. package/dist/lib/fetch.d.ts.map +1 -1
  12. package/dist/lib/fetch.js +143 -56
  13. package/dist/lib/fetch.js.map +1 -1
  14. package/dist/tools/am-i-cited.d.ts +4 -4
  15. package/dist/tools/am-i-cited.js +1 -1
  16. package/dist/tools/am-i-cited.js.map +1 -1
  17. package/dist/tools/answer-box-position.d.ts +43 -0
  18. package/dist/tools/answer-box-position.d.ts.map +1 -0
  19. package/dist/tools/answer-box-position.js +94 -0
  20. package/dist/tools/answer-box-position.js.map +1 -0
  21. package/dist/tools/check-citations.d.ts +4 -4
  22. package/dist/tools/check-citations.d.ts.map +1 -1
  23. package/dist/tools/check-citations.js +6 -1
  24. package/dist/tools/check-citations.js.map +1 -1
  25. package/dist/tools/citation-freshness-score.d.ts +5 -5
  26. package/dist/tools/citation-freshness-score.js +1 -1
  27. package/dist/tools/citation-freshness-score.js.map +1 -1
  28. package/dist/tools/citation-provenance.d.ts +58 -0
  29. package/dist/tools/citation-provenance.d.ts.map +1 -0
  30. package/dist/tools/citation-provenance.js +101 -0
  31. package/dist/tools/citation-provenance.js.map +1 -0
  32. package/dist/tools/compete-for-query.d.ts +4 -4
  33. package/dist/tools/compete-for-query.js +1 -1
  34. package/dist/tools/compete-for-query.js.map +1 -1
  35. package/dist/tools/gsc-citation-gap.d.ts +4 -4
  36. package/dist/tools/gsc-citation-gap.js +1 -1
  37. package/dist/tools/gsc-citation-gap.js.map +1 -1
  38. package/dist/tools/llms-txt-generator.d.ts +39 -0
  39. package/dist/tools/llms-txt-generator.d.ts.map +1 -0
  40. package/dist/tools/llms-txt-generator.js +141 -0
  41. package/dist/tools/llms-txt-generator.js.map +1 -0
  42. package/dist/tools/run-panel.d.ts +5 -5
  43. package/dist/tools/run-panel.js +1 -1
  44. package/dist/tools/run-panel.js.map +1 -1
  45. package/dist/tools/schema-audit.d.ts +36 -0
  46. package/dist/tools/schema-audit.d.ts.map +1 -0
  47. package/dist/tools/schema-audit.js +161 -0
  48. package/dist/tools/schema-audit.js.map +1 -0
  49. package/dist/types.d.ts +1 -1
  50. package/dist/types.d.ts.map +1 -1
  51. package/package.json +1 -1
@@ -0,0 +1,141 @@
1
+ import { z } from "zod";
2
+ import * as cheerio from "cheerio";
3
+ import { fetchText } from "../lib/fetch.js";
4
+ export const llmsTxtGeneratorInputSchema = {
5
+ sitemap_url: z
6
+ .string()
7
+ .url()
8
+ .describe("URL of sitemap.xml (or sitemap index). Nested sitemaps are followed."),
9
+ site_title: z
10
+ .string()
11
+ .min(1)
12
+ .describe("Site title - top H1 in the generated llms.txt file."),
13
+ site_description: z
14
+ .string()
15
+ .optional()
16
+ .describe("One-paragraph site description placed under the H1. Optional but strongly recommended."),
17
+ limit: z
18
+ .number()
19
+ .int()
20
+ .min(1)
21
+ .max(500)
22
+ .default(100)
23
+ .describe("Max URLs to include. Truncated after sitemap parse, before title fetch."),
24
+ fetch_titles: z
25
+ .boolean()
26
+ .default(false)
27
+ .describe("If true, fetch each URL to extract <title> for richer links. Slower (one HEAD-ish GET per URL). Default false uses the URL path as the link text."),
28
+ };
29
+ const inputSchema = z.object(llmsTxtGeneratorInputSchema);
30
+ async function parseSitemap(url, depth = 0) {
31
+ if (depth > 2)
32
+ return [];
33
+ const { text } = await fetchText(url, { timeoutMs: 15_000 });
34
+ const $ = cheerio.load(text, { xmlMode: true });
35
+ const childSitemaps = $("sitemap > loc")
36
+ .toArray()
37
+ .map((el) => $(el).text().trim())
38
+ .filter(Boolean);
39
+ if (childSitemaps.length > 0) {
40
+ const nested = await Promise.all(childSitemaps.map((s) => parseSitemap(s, depth + 1)));
41
+ return nested.flat();
42
+ }
43
+ return $("url > loc")
44
+ .toArray()
45
+ .map((el) => $(el).text().trim())
46
+ .filter(Boolean);
47
+ }
48
+ function pathLabel(url) {
49
+ try {
50
+ const u = new URL(url);
51
+ const seg = u.pathname.replace(/\/$/, "").split("/").filter(Boolean).pop() ?? u.hostname;
52
+ return seg.replace(/[-_]/g, " ").replace(/\.[a-z0-9]+$/i, "");
53
+ }
54
+ catch {
55
+ return url;
56
+ }
57
+ }
58
+ async function fetchTitle(url) {
59
+ try {
60
+ const { text, status } = await fetchText(url, { timeoutMs: 10_000 });
61
+ if (status >= 400)
62
+ return undefined;
63
+ const $ = cheerio.load(text);
64
+ const t = $("title").first().text().trim();
65
+ return t || undefined;
66
+ }
67
+ catch {
68
+ return undefined;
69
+ }
70
+ }
71
+ function groupBySection(urls) {
72
+ const groups = new Map();
73
+ for (const url of urls) {
74
+ let section = "Pages";
75
+ try {
76
+ const u = new URL(url);
77
+ const parts = u.pathname.split("/").filter(Boolean);
78
+ if (parts.length === 0)
79
+ section = "Home";
80
+ else
81
+ section = parts[0].replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
82
+ }
83
+ catch {
84
+ // ignore
85
+ }
86
+ if (!groups.has(section))
87
+ groups.set(section, []);
88
+ groups.get(section).push(url);
89
+ }
90
+ return groups;
91
+ }
92
+ export async function llmsTxtGenerator(input) {
93
+ const parsed = inputSchema.parse(input);
94
+ const allUrls = await parseSitemap(parsed.sitemap_url);
95
+ const urls = allUrls.slice(0, parsed.limit);
96
+ const titleMap = new Map();
97
+ if (parsed.fetch_titles) {
98
+ await Promise.all(urls.map(async (url) => {
99
+ const t = await fetchTitle(url);
100
+ if (t)
101
+ titleMap.set(url, t);
102
+ }));
103
+ }
104
+ const lines = [];
105
+ lines.push(`# ${parsed.site_title}`);
106
+ lines.push("");
107
+ if (parsed.site_description) {
108
+ lines.push(`> ${parsed.site_description}`);
109
+ lines.push("");
110
+ }
111
+ const groups = groupBySection(urls);
112
+ // Stable order: Home first, then alphabetical.
113
+ const sectionNames = [...groups.keys()].sort((a, b) => {
114
+ if (a === "Home")
115
+ return -1;
116
+ if (b === "Home")
117
+ return 1;
118
+ return a.localeCompare(b);
119
+ });
120
+ for (const section of sectionNames) {
121
+ lines.push(`## ${section}`);
122
+ lines.push("");
123
+ for (const url of groups.get(section)) {
124
+ const label = titleMap.get(url) ?? pathLabel(url);
125
+ lines.push(`- [${label}](${url})`);
126
+ }
127
+ lines.push("");
128
+ }
129
+ const content = lines.join("\n").trimEnd() + "\n";
130
+ return {
131
+ sitemap_url: parsed.sitemap_url,
132
+ fetched_at: new Date().toISOString(),
133
+ total_urls_in_sitemap: allUrls.length,
134
+ urls_included: urls.length,
135
+ titles_fetched: titleMap.size,
136
+ sections: sectionNames.length,
137
+ content,
138
+ note: "Markdown follows the llms.txt spec (https://llmstxt.org). Save as /llms.txt at site root. Re-run after content changes.",
139
+ };
140
+ }
141
+ //# sourceMappingURL=llms-txt-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"llms-txt-generator.js","sourceRoot":"","sources":["../../src/tools/llms-txt-generator.ts"],"names":[],"mappings":"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"}
@@ -2,19 +2,19 @@ import { z } from "zod";
2
2
  export declare const runPanelInputSchema: {
3
3
  name: z.ZodString;
4
4
  domain: z.ZodOptional<z.ZodString>;
5
- engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "auto"]>>;
5
+ engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
6
6
  };
7
7
  declare const inputSchema: z.ZodObject<{
8
8
  name: z.ZodString;
9
9
  domain: z.ZodOptional<z.ZodString>;
10
- engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "auto"]>>;
10
+ engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
11
11
  }, "strip", z.ZodTypeAny, {
12
- engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
12
+ engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
13
13
  name: string;
14
14
  domain?: string | undefined;
15
15
  }, {
16
16
  name: string;
17
- engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto" | undefined;
17
+ engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto" | undefined;
18
18
  domain?: string | undefined;
19
19
  }>;
20
20
  export declare function runPanel(input: z.infer<typeof inputSchema>): Promise<{
@@ -26,7 +26,7 @@ export declare function runPanel(input: z.infer<typeof inputSchema>): Promise<{
26
26
  snapshot: {
27
27
  panel: string;
28
28
  domain: string;
29
- engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
29
+ engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
30
30
  taken_at: string;
31
31
  per_query: {
32
32
  query: string;
@@ -11,7 +11,7 @@ export const runPanelInputSchema = {
11
11
  .optional()
12
12
  .describe("Override the panel's default domain for this run."),
13
13
  engine: z
14
- .enum(["perplexity", "claude", "openai", "gemini", "bing", "auto"])
14
+ .enum(["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"])
15
15
  .default("auto")
16
16
  .describe("AI engine to query."),
17
17
  };
@@ -1 +1 @@
1
- {"version":3,"file":"run-panel.js","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"run-panel.js","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import { z } from "zod";
2
+ export declare const schemaAuditInputSchema: {
3
+ url: z.ZodString;
4
+ };
5
+ declare const inputSchema: z.ZodObject<{
6
+ url: z.ZodString;
7
+ }, "strip", z.ZodTypeAny, {
8
+ url: string;
9
+ }, {
10
+ url: string;
11
+ }>;
12
+ type NodeIssue = {
13
+ type: string;
14
+ path: string;
15
+ severity: "error" | "warning";
16
+ message: string;
17
+ };
18
+ export declare function schemaAudit(input: z.infer<typeof inputSchema>): Promise<{
19
+ url: string;
20
+ fetched_at: string;
21
+ json_ld_blocks: number;
22
+ json_ld_parse_errors: number;
23
+ schema_types_present: string[];
24
+ microdata_types_present: string[];
25
+ issues: NodeIssue[];
26
+ summary: {
27
+ blocks: number;
28
+ typed_nodes: number;
29
+ errors: number;
30
+ warnings: number;
31
+ valid: boolean;
32
+ };
33
+ note: string;
34
+ }>;
35
+ export {};
36
+ //# sourceMappingURL=schema-audit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-audit.d.ts","sourceRoot":"","sources":["../../src/tools/schema-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,sBAAsB;;CAElC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;EAAmC,CAAC;AAwBrD,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAoEF,wBAAsB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;GAyEnE"}
@@ -0,0 +1,161 @@
1
+ import { z } from "zod";
2
+ import * as cheerio from "cheerio";
3
+ import { fetchText, ToolFetchError } from "../lib/fetch.js";
4
+ export const schemaAuditInputSchema = {
5
+ url: z.string().url().describe("URL whose JSON-LD and microdata to validate against schema.org expected fields."),
6
+ };
7
+ const inputSchema = z.object(schemaAuditInputSchema);
8
+ // Required-field map per @type. Keys are the absolutely-needed properties for
9
+ // AI search engines to treat the markup as well-formed. Lists are conservative
10
+ // (Google rich-results minimums) - we flag missing required, not just recommended.
11
+ const REQUIRED_FIELDS = {
12
+ Article: ["headline", "author", "datePublished"],
13
+ BlogPosting: ["headline", "author", "datePublished"],
14
+ NewsArticle: ["headline", "author", "datePublished"],
15
+ TechArticle: ["headline", "author", "datePublished"],
16
+ FAQPage: ["mainEntity"],
17
+ Question: ["name", "acceptedAnswer"],
18
+ HowTo: ["name", "step"],
19
+ Product: ["name"],
20
+ Recipe: ["name", "recipeIngredient", "recipeInstructions"],
21
+ BreadcrumbList: ["itemListElement"],
22
+ Organization: ["name"],
23
+ Person: ["name"],
24
+ WebPage: ["name"],
25
+ WebSite: ["name"],
26
+ VideoObject: ["name", "thumbnailUrl", "uploadDate"],
27
+ ImageObject: ["contentUrl"],
28
+ };
29
+ function walkJsonLd(node, path, out) {
30
+ if (Array.isArray(node)) {
31
+ node.forEach((n, i) => walkJsonLd(n, `${path}[${i}]`, out));
32
+ return;
33
+ }
34
+ if (!node || typeof node !== "object")
35
+ return;
36
+ const obj = node;
37
+ const t = obj["@type"];
38
+ const types = Array.isArray(t) ? t.filter((x) => typeof x === "string") : typeof t === "string" ? [t] : [];
39
+ for (const type of types)
40
+ out.push({ type, path, obj });
41
+ for (const [k, v] of Object.entries(obj)) {
42
+ if (k === "@type" || k === "@context")
43
+ continue;
44
+ walkJsonLd(v, path ? `${path}.${k}` : k, out);
45
+ }
46
+ }
47
+ function validateNode(type, obj, path) {
48
+ const required = REQUIRED_FIELDS[type];
49
+ if (!required)
50
+ return [];
51
+ const issues = [];
52
+ for (const field of required) {
53
+ const v = obj[field];
54
+ const missing = v === undefined ||
55
+ v === null ||
56
+ (typeof v === "string" && v.trim() === "") ||
57
+ (Array.isArray(v) && v.length === 0);
58
+ if (missing) {
59
+ issues.push({
60
+ type,
61
+ path,
62
+ severity: "error",
63
+ message: `${type} is missing required field '${field}'.`,
64
+ });
65
+ }
66
+ }
67
+ // Light per-type extra checks.
68
+ if (type === "FAQPage") {
69
+ const me = obj.mainEntity;
70
+ if (Array.isArray(me) && me.length === 0) {
71
+ issues.push({
72
+ type,
73
+ path,
74
+ severity: "error",
75
+ message: "FAQPage.mainEntity is empty - add at least one Question.",
76
+ });
77
+ }
78
+ }
79
+ if (type === "HowTo") {
80
+ const step = obj.step;
81
+ if (Array.isArray(step) && step.length === 0) {
82
+ issues.push({
83
+ type,
84
+ path,
85
+ severity: "error",
86
+ message: "HowTo.step is empty - add at least one step.",
87
+ });
88
+ }
89
+ }
90
+ return issues;
91
+ }
92
+ export async function schemaAudit(input) {
93
+ const parsed = inputSchema.parse(input);
94
+ const { text, status } = await fetchText(parsed.url, { timeoutMs: 15_000 });
95
+ if (status >= 400) {
96
+ throw new ToolFetchError({
97
+ type: "fetch_error",
98
+ url: parsed.url,
99
+ status,
100
+ message: `URL returned HTTP ${status} - cannot audit schema on a non-existent page.`,
101
+ });
102
+ }
103
+ const $ = cheerio.load(text);
104
+ const jsonLdBlocks = [];
105
+ const nodes = [];
106
+ $('script[type="application/ld+json"]').each((i, el) => {
107
+ const raw = $(el).text();
108
+ try {
109
+ const json = JSON.parse(raw);
110
+ jsonLdBlocks.push({ raw: raw.slice(0, 200) });
111
+ walkJsonLd(json, `block[${i}]`, nodes);
112
+ }
113
+ catch (err) {
114
+ const msg = err instanceof Error ? err.message : String(err);
115
+ jsonLdBlocks.push({ raw: raw.slice(0, 200), parseError: msg });
116
+ }
117
+ });
118
+ const microdataTypes = [];
119
+ $("[itemtype]").each((_, el) => {
120
+ const t = $(el).attr("itemtype");
121
+ if (!t)
122
+ return;
123
+ const last = t.split("/").pop();
124
+ if (last)
125
+ microdataTypes.push(last);
126
+ });
127
+ const allIssues = [];
128
+ for (const { type, path, obj } of nodes) {
129
+ allIssues.push(...validateNode(type, obj, path));
130
+ }
131
+ for (const block of jsonLdBlocks) {
132
+ if (block.parseError) {
133
+ allIssues.push({
134
+ type: "(json-ld)",
135
+ path: "block",
136
+ severity: "error",
137
+ message: `Malformed JSON-LD: ${block.parseError}`,
138
+ });
139
+ }
140
+ }
141
+ const presentTypes = [...new Set(nodes.map((n) => n.type))];
142
+ const knownTypeIssues = allIssues.filter((i) => i.severity === "error").length;
143
+ return {
144
+ url: parsed.url,
145
+ fetched_at: new Date().toISOString(),
146
+ json_ld_blocks: jsonLdBlocks.length,
147
+ json_ld_parse_errors: jsonLdBlocks.filter((b) => b.parseError).length,
148
+ schema_types_present: presentTypes,
149
+ microdata_types_present: [...new Set(microdataTypes)],
150
+ issues: allIssues,
151
+ summary: {
152
+ blocks: jsonLdBlocks.length,
153
+ typed_nodes: nodes.length,
154
+ errors: knownTypeIssues,
155
+ warnings: allIssues.filter((i) => i.severity === "warning").length,
156
+ valid: knownTypeIssues === 0 && nodes.length > 0,
157
+ },
158
+ note: "Validates required fields per @type using Google rich-results minimums. Unknown @types are skipped (no false positives). 'valid: false' means at least one typed node is missing a required field; 'valid: true' with typed_nodes=0 cannot occur.",
159
+ };
160
+ }
161
+ //# sourceMappingURL=schema-audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-audit.js","sourceRoot":"","sources":["../../src/tools/schema-audit.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export type Engine = "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
1
+ export type Engine = "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
2
2
  export type Citation = {
3
3
  url: string;
4
4
  title?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GACd,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GACd,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@automatelab/citation-intelligence",
3
- "version": "0.4.0",
3
+ "version": "0.5.1",
4
4
  "mcpName": "io.github.AutomateLab-tech/citation-intelligence",
5
5
  "description": "What LLMs cite, for agents. MCP server: check what Perplexity, Claude, ChatGPT, Gemini, Bing, and Google AI Overviews cite for any query. Self-hosted, BYO API key.",
6
6
  "license": "MIT",