@automatelab/citation-intelligence 0.6.0 → 0.8.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.
Files changed (75) hide show
  1. package/README.md +43 -8
  2. package/dist/adapters/anthropic.d.ts.map +1 -1
  3. package/dist/adapters/anthropic.js +4 -2
  4. package/dist/adapters/anthropic.js.map +1 -1
  5. package/dist/adapters/bing.js +1 -1
  6. package/dist/adapters/bing.js.map +1 -1
  7. package/dist/adapters/brave.js +1 -1
  8. package/dist/adapters/brave.js.map +1 -1
  9. package/dist/adapters/gemini.d.ts.map +1 -1
  10. package/dist/adapters/gemini.js +5 -1
  11. package/dist/adapters/gemini.js.map +1 -1
  12. package/dist/adapters/openai.d.ts.map +1 -1
  13. package/dist/adapters/openai.js +3 -1
  14. package/dist/adapters/openai.js.map +1 -1
  15. package/dist/adapters/perplexity.d.ts +2 -1
  16. package/dist/adapters/perplexity.d.ts.map +1 -1
  17. package/dist/adapters/perplexity.js +5 -2
  18. package/dist/adapters/perplexity.js.map +1 -1
  19. package/dist/index.js +201 -2
  20. package/dist/index.js.map +1 -1
  21. package/dist/output-schemas.d.ts +926 -0
  22. package/dist/output-schemas.d.ts.map +1 -0
  23. package/dist/output-schemas.js +512 -0
  24. package/dist/output-schemas.js.map +1 -0
  25. package/dist/tools/am-i-cited.d.ts +73 -10
  26. package/dist/tools/am-i-cited.d.ts.map +1 -1
  27. package/dist/tools/am-i-cited.js +115 -15
  28. package/dist/tools/am-i-cited.js.map +1 -1
  29. package/dist/tools/answer-box-position.d.ts +4 -4
  30. package/dist/tools/answer-box-position.js +2 -2
  31. package/dist/tools/answer-box-position.js.map +1 -1
  32. package/dist/tools/canonical-competitor-set.d.ts +4 -4
  33. package/dist/tools/canonical-competitor-set.js +6 -7
  34. package/dist/tools/canonical-competitor-set.js.map +1 -1
  35. package/dist/tools/check-citations.d.ts +11 -5
  36. package/dist/tools/check-citations.d.ts.map +1 -1
  37. package/dist/tools/check-citations.js +29 -10
  38. package/dist/tools/check-citations.js.map +1 -1
  39. package/dist/tools/citation-evidence.d.ts +4 -4
  40. package/dist/tools/citation-evidence.js +2 -2
  41. package/dist/tools/citation-evidence.js.map +1 -1
  42. package/dist/tools/citation-freshness-score.d.ts +4 -4
  43. package/dist/tools/citation-freshness-score.js +1 -1
  44. package/dist/tools/citation-freshness-score.js.map +1 -1
  45. package/dist/tools/citation-provenance.d.ts +6 -4
  46. package/dist/tools/citation-provenance.d.ts.map +1 -1
  47. package/dist/tools/citation-provenance.js +17 -8
  48. package/dist/tools/citation-provenance.js.map +1 -1
  49. package/dist/tools/cited-for-diff.d.ts +5 -5
  50. package/dist/tools/cited-for-diff.js +1 -1
  51. package/dist/tools/cited-for-diff.js.map +1 -1
  52. package/dist/tools/cited-for.d.ts +5 -5
  53. package/dist/tools/cited-for.js +1 -1
  54. package/dist/tools/cited-for.js.map +1 -1
  55. package/dist/tools/compete-for-query.d.ts +4 -4
  56. package/dist/tools/compete-for-query.js +1 -1
  57. package/dist/tools/compete-for-query.js.map +1 -1
  58. package/dist/tools/gsc-citation-gap.d.ts +5 -5
  59. package/dist/tools/gsc-citation-gap.d.ts.map +1 -1
  60. package/dist/tools/gsc-citation-gap.js +7 -2
  61. package/dist/tools/gsc-citation-gap.js.map +1 -1
  62. package/dist/tools/run-panel.d.ts +5 -5
  63. package/dist/tools/run-panel.d.ts.map +1 -1
  64. package/dist/tools/run-panel.js +13 -4
  65. package/dist/tools/run-panel.js.map +1 -1
  66. package/dist/tools/structured-data-repair.d.ts +30 -0
  67. package/dist/tools/structured-data-repair.d.ts.map +1 -0
  68. package/dist/tools/structured-data-repair.js +297 -0
  69. package/dist/tools/structured-data-repair.js.map +1 -0
  70. package/dist/types.d.ts +10 -1
  71. package/dist/types.d.ts.map +1 -1
  72. package/dist/types.js +24 -1
  73. package/dist/types.js.map +1 -1
  74. package/package.json +61 -58
  75. package/smithery.yaml +50 -0
@@ -0,0 +1,926 @@
1
+ import { z } from "zod";
2
+ export declare const checkCitationsOutputShape: {
3
+ readonly query: z.ZodString;
4
+ readonly engine: z.ZodString;
5
+ readonly surface: z.ZodString;
6
+ readonly interpretation_note: z.ZodString;
7
+ readonly fetched_at: z.ZodString;
8
+ readonly citations: z.ZodArray<z.ZodObject<{
9
+ url: z.ZodString;
10
+ rank: z.ZodNumber;
11
+ title: z.ZodOptional<z.ZodString>;
12
+ snippet: z.ZodOptional<z.ZodString>;
13
+ }, "strip", z.ZodTypeAny, {
14
+ url: string;
15
+ rank: number;
16
+ title?: string | undefined;
17
+ snippet?: string | undefined;
18
+ }, {
19
+ url: string;
20
+ rank: number;
21
+ title?: string | undefined;
22
+ snippet?: string | undefined;
23
+ }>, "many">;
24
+ readonly raw_answer: z.ZodNullable<z.ZodString>;
25
+ readonly cached: z.ZodBoolean;
26
+ };
27
+ export declare const amICitedOutputShape: {
28
+ readonly domain: z.ZodString;
29
+ readonly mode: z.ZodEnum<["single_engine", "multi_engine"]>;
30
+ readonly fetched_at: z.ZodString;
31
+ readonly engine: z.ZodOptional<z.ZodString>;
32
+ readonly surface: z.ZodOptional<z.ZodString>;
33
+ readonly results: z.ZodOptional<z.ZodArray<z.ZodObject<{
34
+ query: z.ZodString;
35
+ cited: z.ZodBoolean;
36
+ rank: z.ZodOptional<z.ZodNumber>;
37
+ matching_urls: z.ZodArray<z.ZodString, "many">;
38
+ }, "strip", z.ZodTypeAny, {
39
+ query: string;
40
+ cited: boolean;
41
+ matching_urls: string[];
42
+ rank?: number | undefined;
43
+ }, {
44
+ query: string;
45
+ cited: boolean;
46
+ matching_urls: string[];
47
+ rank?: number | undefined;
48
+ }>, "many">>;
49
+ readonly summary: z.ZodOptional<z.ZodObject<{
50
+ queries_total: z.ZodNumber;
51
+ queries_cited: z.ZodNumber;
52
+ citation_rate: z.ZodNumber;
53
+ average_rank: z.ZodOptional<z.ZodNumber>;
54
+ }, "strip", z.ZodTypeAny, {
55
+ queries_total: number;
56
+ queries_cited: number;
57
+ citation_rate: number;
58
+ average_rank?: number | undefined;
59
+ }, {
60
+ queries_total: number;
61
+ queries_cited: number;
62
+ citation_rate: number;
63
+ average_rank?: number | undefined;
64
+ }>>;
65
+ readonly engines: z.ZodOptional<z.ZodArray<z.ZodObject<{
66
+ engine: z.ZodString;
67
+ surface: z.ZodOptional<z.ZodString>;
68
+ ok: z.ZodBoolean;
69
+ queries_cited: z.ZodOptional<z.ZodNumber>;
70
+ citation_rate: z.ZodOptional<z.ZodNumber>;
71
+ }, "strip", z.ZodTypeAny, {
72
+ engine: string;
73
+ ok: boolean;
74
+ queries_cited?: number | undefined;
75
+ citation_rate?: number | undefined;
76
+ surface?: string | undefined;
77
+ }, {
78
+ engine: string;
79
+ ok: boolean;
80
+ queries_cited?: number | undefined;
81
+ citation_rate?: number | undefined;
82
+ surface?: string | undefined;
83
+ }>, "many">>;
84
+ readonly per_engine: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
85
+ readonly consensus: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
86
+ };
87
+ export declare const aiOverviewOutputShape: {
88
+ readonly query: z.ZodString;
89
+ readonly fetched_at: z.ZodString;
90
+ readonly ai_overview_present: z.ZodBoolean;
91
+ readonly ai_overview_text: z.ZodNullable<z.ZodString>;
92
+ readonly sources: z.ZodArray<z.ZodObject<{
93
+ url: z.ZodString;
94
+ title: z.ZodOptional<z.ZodString>;
95
+ }, "strip", z.ZodTypeAny, {
96
+ url: string;
97
+ title?: string | undefined;
98
+ }, {
99
+ url: string;
100
+ title?: string | undefined;
101
+ }>, "many">;
102
+ readonly cached: z.ZodBoolean;
103
+ };
104
+ export declare const citedForOutputShape: {
105
+ readonly domain: z.ZodString;
106
+ readonly since: z.ZodOptional<z.ZodString>;
107
+ readonly engine_filter: z.ZodOptional<z.ZodString>;
108
+ readonly results: z.ZodArray<z.ZodObject<{
109
+ query: z.ZodString;
110
+ engine: z.ZodString;
111
+ rank: z.ZodNumber;
112
+ url: z.ZodString;
113
+ fetched_at: z.ZodString;
114
+ }, "strip", z.ZodTypeAny, {
115
+ query: string;
116
+ url: string;
117
+ engine: string;
118
+ fetched_at: string;
119
+ rank: number;
120
+ }, {
121
+ query: string;
122
+ url: string;
123
+ engine: string;
124
+ fetched_at: string;
125
+ rank: number;
126
+ }>, "many">;
127
+ readonly total: z.ZodNumber;
128
+ readonly source: z.ZodLiteral<"local_cache">;
129
+ };
130
+ export declare const predictCitationOutputShape: {
131
+ readonly url: z.ZodString;
132
+ readonly fetched_at: z.ZodString;
133
+ readonly score: z.ZodNumber;
134
+ readonly grade: z.ZodString;
135
+ readonly signals: z.ZodRecord<z.ZodString, z.ZodUnknown>;
136
+ readonly fixes: z.ZodArray<z.ZodObject<{
137
+ signal: z.ZodString;
138
+ suggestion: z.ZodString;
139
+ }, "strip", z.ZodTypeAny, {
140
+ signal: string;
141
+ suggestion: string;
142
+ }, {
143
+ signal: string;
144
+ suggestion: string;
145
+ }>, "many">;
146
+ };
147
+ export declare const trackQueriesOutputShape: {
148
+ readonly saved: z.ZodOptional<z.ZodBoolean>;
149
+ readonly panel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
150
+ readonly panels: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
151
+ readonly error: z.ZodOptional<z.ZodString>;
152
+ };
153
+ export declare const runPanelOutputShape: {
154
+ readonly saved_to: z.ZodString;
155
+ readonly snapshot: z.ZodObject<{
156
+ panel: z.ZodString;
157
+ domain: z.ZodString;
158
+ engine: z.ZodString;
159
+ taken_at: z.ZodString;
160
+ per_query: z.ZodArray<z.ZodObject<{
161
+ query: z.ZodString;
162
+ cited: z.ZodBoolean;
163
+ rank: z.ZodOptional<z.ZodNumber>;
164
+ matching_urls: z.ZodArray<z.ZodString, "many">;
165
+ }, "strip", z.ZodTypeAny, {
166
+ query: string;
167
+ cited: boolean;
168
+ matching_urls: string[];
169
+ rank?: number | undefined;
170
+ }, {
171
+ query: string;
172
+ cited: boolean;
173
+ matching_urls: string[];
174
+ rank?: number | undefined;
175
+ }>, "many">;
176
+ summary: z.ZodObject<{
177
+ queries_total: z.ZodNumber;
178
+ queries_cited: z.ZodNumber;
179
+ citation_rate: z.ZodNumber;
180
+ average_rank: z.ZodOptional<z.ZodNumber>;
181
+ }, "strip", z.ZodTypeAny, {
182
+ queries_total: number;
183
+ queries_cited: number;
184
+ citation_rate: number;
185
+ average_rank?: number | undefined;
186
+ }, {
187
+ queries_total: number;
188
+ queries_cited: number;
189
+ citation_rate: number;
190
+ average_rank?: number | undefined;
191
+ }>;
192
+ }, "strip", z.ZodTypeAny, {
193
+ engine: string;
194
+ domain: string;
195
+ panel: string;
196
+ taken_at: string;
197
+ per_query: {
198
+ query: string;
199
+ cited: boolean;
200
+ matching_urls: string[];
201
+ rank?: number | undefined;
202
+ }[];
203
+ summary: {
204
+ queries_total: number;
205
+ queries_cited: number;
206
+ citation_rate: number;
207
+ average_rank?: number | undefined;
208
+ };
209
+ }, {
210
+ engine: string;
211
+ domain: string;
212
+ panel: string;
213
+ taken_at: string;
214
+ per_query: {
215
+ query: string;
216
+ cited: boolean;
217
+ matching_urls: string[];
218
+ rank?: number | undefined;
219
+ }[];
220
+ summary: {
221
+ queries_total: number;
222
+ queries_cited: number;
223
+ citation_rate: number;
224
+ average_rank?: number | undefined;
225
+ };
226
+ }>;
227
+ };
228
+ export declare const citationTrendOutputShape: {
229
+ readonly panel: z.ZodString;
230
+ readonly domain: z.ZodOptional<z.ZodString>;
231
+ readonly snapshots: z.ZodNumber;
232
+ readonly first_taken_at: z.ZodOptional<z.ZodString>;
233
+ readonly last_taken_at: z.ZodOptional<z.ZodString>;
234
+ readonly series: z.ZodArray<z.ZodObject<{
235
+ taken_at: z.ZodString;
236
+ engine: z.ZodString;
237
+ queries_total: z.ZodNumber;
238
+ queries_cited: z.ZodNumber;
239
+ citation_rate: z.ZodNumber;
240
+ }, "strip", z.ZodTypeAny, {
241
+ engine: string;
242
+ queries_total: number;
243
+ queries_cited: number;
244
+ citation_rate: number;
245
+ taken_at: string;
246
+ }, {
247
+ engine: string;
248
+ queries_total: number;
249
+ queries_cited: number;
250
+ citation_rate: number;
251
+ taken_at: string;
252
+ }>, "many">;
253
+ readonly query_deltas: z.ZodArray<z.ZodObject<{
254
+ query: z.ZodString;
255
+ change: z.ZodEnum<["gained", "lost", "unchanged"]>;
256
+ first: z.ZodBoolean;
257
+ last: z.ZodBoolean;
258
+ }, "strip", z.ZodTypeAny, {
259
+ query: string;
260
+ change: "gained" | "lost" | "unchanged";
261
+ first: boolean;
262
+ last: boolean;
263
+ }, {
264
+ query: string;
265
+ change: "gained" | "lost" | "unchanged";
266
+ first: boolean;
267
+ last: boolean;
268
+ }>, "many">;
269
+ };
270
+ export declare const compareDomainsOutputShape: {
271
+ readonly fetched_at: z.ZodString;
272
+ readonly rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
273
+ readonly diverging_signals: z.ZodArray<z.ZodObject<{
274
+ signal: z.ZodString;
275
+ per_url: z.ZodArray<z.ZodObject<{
276
+ url: z.ZodString;
277
+ value: z.ZodBoolean;
278
+ }, "strip", z.ZodTypeAny, {
279
+ url: string;
280
+ value: boolean;
281
+ }, {
282
+ url: string;
283
+ value: boolean;
284
+ }>, "many">;
285
+ }, "strip", z.ZodTypeAny, {
286
+ signal: string;
287
+ per_url: {
288
+ url: string;
289
+ value: boolean;
290
+ }[];
291
+ }, {
292
+ signal: string;
293
+ per_url: {
294
+ url: string;
295
+ value: boolean;
296
+ }[];
297
+ }>, "many">;
298
+ };
299
+ export declare const wikipediaMentionsOutputShape: {
300
+ readonly domain: z.ZodString;
301
+ readonly lang: z.ZodString;
302
+ readonly fetched_at: z.ZodString;
303
+ readonly total: z.ZodNumber;
304
+ readonly mentions: z.ZodArray<z.ZodObject<{
305
+ article_title: z.ZodOptional<z.ZodString>;
306
+ article_url: z.ZodOptional<z.ZodString>;
307
+ cited_url: z.ZodOptional<z.ZodString>;
308
+ }, "strip", z.ZodTypeAny, {
309
+ article_title?: string | undefined;
310
+ article_url?: string | undefined;
311
+ cited_url?: string | undefined;
312
+ }, {
313
+ article_title?: string | undefined;
314
+ article_url?: string | undefined;
315
+ cited_url?: string | undefined;
316
+ }>, "many">;
317
+ };
318
+ export declare const auditSitemapOutputShape: {
319
+ readonly sitemap_url: z.ZodString;
320
+ readonly fetched_at: z.ZodString;
321
+ readonly total_urls: z.ZodNumber;
322
+ readonly audited: z.ZodNumber;
323
+ readonly average_score: z.ZodNumber;
324
+ readonly worst_first: z.ZodArray<z.ZodObject<{
325
+ url: z.ZodString;
326
+ score: z.ZodNumber;
327
+ grade: z.ZodString;
328
+ signals: z.ZodRecord<z.ZodString, z.ZodUnknown>;
329
+ top_fix: z.ZodOptional<z.ZodString>;
330
+ }, "strip", z.ZodTypeAny, {
331
+ url: string;
332
+ score: number;
333
+ grade: string;
334
+ signals: Record<string, unknown>;
335
+ top_fix?: string | undefined;
336
+ }, {
337
+ url: string;
338
+ score: number;
339
+ grade: string;
340
+ signals: Record<string, unknown>;
341
+ top_fix?: string | undefined;
342
+ }>, "many">;
343
+ readonly errors: z.ZodArray<z.ZodObject<{
344
+ url: z.ZodString;
345
+ error: z.ZodString;
346
+ }, "strip", z.ZodTypeAny, {
347
+ error: string;
348
+ url: string;
349
+ }, {
350
+ error: string;
351
+ url: string;
352
+ }>, "many">;
353
+ };
354
+ export declare const competeForQueryOutputShape: {
355
+ readonly query: z.ZodString;
356
+ readonly engine: z.ZodString;
357
+ readonly fetched_at: z.ZodString;
358
+ readonly your_url: z.ZodString;
359
+ readonly your_score: z.ZodNullable<z.ZodNumber>;
360
+ readonly your_in_citations: z.ZodBoolean;
361
+ readonly competitors: z.ZodArray<z.ZodString, "many">;
362
+ readonly average_competitor_score: z.ZodNullable<z.ZodNumber>;
363
+ readonly score_gap: z.ZodNullable<z.ZodNumber>;
364
+ readonly comparison: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
365
+ };
366
+ export declare const citationFreshnessScoreOutputShape: {
367
+ readonly query: z.ZodString;
368
+ readonly engine: z.ZodString;
369
+ readonly fetched_at: z.ZodString;
370
+ readonly recency_score: z.ZodNumber;
371
+ readonly average_days_old: z.ZodNullable<z.ZodNumber>;
372
+ readonly buckets: z.ZodObject<{
373
+ fresh: z.ZodNumber;
374
+ current: z.ZodNumber;
375
+ stale: z.ZodNumber;
376
+ ancient: z.ZodNumber;
377
+ unknown: z.ZodNumber;
378
+ }, "strip", z.ZodTypeAny, {
379
+ unknown: number;
380
+ fresh: number;
381
+ current: number;
382
+ stale: number;
383
+ ancient: number;
384
+ }, {
385
+ unknown: number;
386
+ fresh: number;
387
+ current: number;
388
+ stale: number;
389
+ ancient: number;
390
+ }>;
391
+ readonly per_url: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
392
+ readonly note: z.ZodOptional<z.ZodString>;
393
+ };
394
+ export declare const citedForDiffOutputShape: {
395
+ readonly domain: z.ZodString;
396
+ readonly engine_filter: z.ZodOptional<z.ZodString>;
397
+ readonly baseline_until: z.ZodString;
398
+ readonly current_since: z.ZodString;
399
+ readonly fetched_at: z.ZodString;
400
+ readonly counts: z.ZodObject<{
401
+ baseline_unique_queries: z.ZodNumber;
402
+ current_unique_queries: z.ZodNumber;
403
+ gained: z.ZodNumber;
404
+ lost: z.ZodNumber;
405
+ unchanged: z.ZodNumber;
406
+ }, "strip", z.ZodTypeAny, {
407
+ gained: number;
408
+ lost: number;
409
+ unchanged: number;
410
+ baseline_unique_queries: number;
411
+ current_unique_queries: number;
412
+ }, {
413
+ gained: number;
414
+ lost: number;
415
+ unchanged: number;
416
+ baseline_unique_queries: number;
417
+ current_unique_queries: number;
418
+ }>;
419
+ readonly gained: z.ZodArray<z.ZodObject<{
420
+ query: z.ZodString;
421
+ engine: z.ZodString;
422
+ rank: z.ZodNumber;
423
+ fetched_at: z.ZodString;
424
+ url: z.ZodString;
425
+ }, "strip", z.ZodTypeAny, {
426
+ query: string;
427
+ url: string;
428
+ engine: string;
429
+ fetched_at: string;
430
+ rank: number;
431
+ }, {
432
+ query: string;
433
+ url: string;
434
+ engine: string;
435
+ fetched_at: string;
436
+ rank: number;
437
+ }>, "many">;
438
+ readonly lost: z.ZodArray<z.ZodObject<{
439
+ query: z.ZodString;
440
+ engine: z.ZodString;
441
+ fetched_at: z.ZodString;
442
+ url: z.ZodString;
443
+ }, "strip", z.ZodTypeAny, {
444
+ query: string;
445
+ url: string;
446
+ engine: string;
447
+ fetched_at: string;
448
+ }, {
449
+ query: string;
450
+ url: string;
451
+ engine: string;
452
+ fetched_at: string;
453
+ }>, "many">;
454
+ readonly unchanged_queries: z.ZodArray<z.ZodString, "many">;
455
+ readonly source: z.ZodLiteral<"local_cache">;
456
+ };
457
+ export declare const gscCitationGapOutputShape: {
458
+ readonly domain: z.ZodString;
459
+ readonly site_url: z.ZodString;
460
+ readonly range: z.ZodObject<{
461
+ start: z.ZodString;
462
+ end: z.ZodString;
463
+ }, "strip", z.ZodTypeAny, {
464
+ start: string;
465
+ end: string;
466
+ }, {
467
+ start: string;
468
+ end: string;
469
+ }>;
470
+ readonly engine: z.ZodOptional<z.ZodString>;
471
+ readonly rows: z.ZodArray<z.ZodObject<{
472
+ query: z.ZodString;
473
+ gsc: z.ZodObject<{
474
+ impressions: z.ZodNumber;
475
+ clicks: z.ZodNumber;
476
+ position: z.ZodOptional<z.ZodNumber>;
477
+ ctr: z.ZodOptional<z.ZodNumber>;
478
+ }, "strip", z.ZodTypeAny, {
479
+ impressions: number;
480
+ clicks: number;
481
+ position?: number | undefined;
482
+ ctr?: number | undefined;
483
+ }, {
484
+ impressions: number;
485
+ clicks: number;
486
+ position?: number | undefined;
487
+ ctr?: number | undefined;
488
+ }>;
489
+ ai_cited: z.ZodBoolean;
490
+ ai_rank: z.ZodOptional<z.ZodNumber>;
491
+ }, "strip", z.ZodTypeAny, {
492
+ query: string;
493
+ gsc: {
494
+ impressions: number;
495
+ clicks: number;
496
+ position?: number | undefined;
497
+ ctr?: number | undefined;
498
+ };
499
+ ai_cited: boolean;
500
+ ai_rank?: number | undefined;
501
+ }, {
502
+ query: string;
503
+ gsc: {
504
+ impressions: number;
505
+ clicks: number;
506
+ position?: number | undefined;
507
+ ctr?: number | undefined;
508
+ };
509
+ ai_cited: boolean;
510
+ ai_rank?: number | undefined;
511
+ }>, "many">;
512
+ readonly closest_wins: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
513
+ };
514
+ export declare const schemaAuditOutputShape: {
515
+ readonly url: z.ZodString;
516
+ readonly fetched_at: z.ZodString;
517
+ readonly json_ld_blocks: z.ZodNumber;
518
+ readonly json_ld_parse_errors: z.ZodNumber;
519
+ readonly schema_types_present: z.ZodArray<z.ZodString, "many">;
520
+ readonly microdata_types_present: z.ZodArray<z.ZodString, "many">;
521
+ readonly issues: z.ZodArray<z.ZodObject<{
522
+ type: z.ZodString;
523
+ path: z.ZodString;
524
+ severity: z.ZodEnum<["error", "warning"]>;
525
+ message: z.ZodString;
526
+ }, "strip", z.ZodTypeAny, {
527
+ path: string;
528
+ message: string;
529
+ type: string;
530
+ severity: "error" | "warning";
531
+ }, {
532
+ path: string;
533
+ message: string;
534
+ type: string;
535
+ severity: "error" | "warning";
536
+ }>, "many">;
537
+ readonly summary: z.ZodObject<{
538
+ blocks: z.ZodNumber;
539
+ typed_nodes: z.ZodNumber;
540
+ errors: z.ZodNumber;
541
+ warnings: z.ZodNumber;
542
+ valid: z.ZodBoolean;
543
+ }, "strip", z.ZodTypeAny, {
544
+ valid: boolean;
545
+ blocks: number;
546
+ typed_nodes: number;
547
+ errors: number;
548
+ warnings: number;
549
+ }, {
550
+ valid: boolean;
551
+ blocks: number;
552
+ typed_nodes: number;
553
+ errors: number;
554
+ warnings: number;
555
+ }>;
556
+ readonly note: z.ZodOptional<z.ZodString>;
557
+ };
558
+ export declare const llmsTxtGeneratorOutputShape: {
559
+ readonly sitemap_url: z.ZodString;
560
+ readonly fetched_at: z.ZodString;
561
+ readonly total_urls_in_sitemap: z.ZodNumber;
562
+ readonly urls_included: z.ZodNumber;
563
+ readonly titles_fetched: z.ZodNumber;
564
+ readonly sections: z.ZodNumber;
565
+ readonly content: z.ZodString;
566
+ readonly note: z.ZodOptional<z.ZodString>;
567
+ };
568
+ export declare const answerBoxPositionOutputShape: {
569
+ readonly query: z.ZodString;
570
+ readonly engine: z.ZodString;
571
+ readonly fetched_at: z.ZodString;
572
+ readonly answer_chars: z.ZodNumber;
573
+ readonly citations_total: z.ZodNumber;
574
+ readonly positions: z.ZodArray<z.ZodObject<{
575
+ url: z.ZodString;
576
+ rank: z.ZodNumber;
577
+ title: z.ZodNullable<z.ZodOptional<z.ZodString>>;
578
+ first_mention_char: z.ZodNullable<z.ZodNumber>;
579
+ position: z.ZodEnum<["early", "middle", "late", "unknown"]>;
580
+ }, "strip", z.ZodTypeAny, {
581
+ url: string;
582
+ position: "unknown" | "early" | "middle" | "late";
583
+ rank: number;
584
+ first_mention_char: number | null;
585
+ title?: string | null | undefined;
586
+ }, {
587
+ url: string;
588
+ position: "unknown" | "early" | "middle" | "late";
589
+ rank: number;
590
+ first_mention_char: number | null;
591
+ title?: string | null | undefined;
592
+ }>, "many">;
593
+ readonly buckets: z.ZodObject<{
594
+ early: z.ZodNumber;
595
+ middle: z.ZodNumber;
596
+ late: z.ZodNumber;
597
+ unknown: z.ZodNumber;
598
+ }, "strip", z.ZodTypeAny, {
599
+ unknown: number;
600
+ early: number;
601
+ middle: number;
602
+ late: number;
603
+ }, {
604
+ unknown: number;
605
+ early: number;
606
+ middle: number;
607
+ late: number;
608
+ }>;
609
+ readonly note: z.ZodOptional<z.ZodString>;
610
+ };
611
+ export declare const citationProvenanceOutputShape: {
612
+ readonly query: z.ZodString;
613
+ readonly fetched_at: z.ZodString;
614
+ readonly engines: z.ZodArray<z.ZodObject<{
615
+ engine: z.ZodString;
616
+ surface: z.ZodOptional<z.ZodString>;
617
+ interpretation_note: z.ZodOptional<z.ZodString>;
618
+ ok: z.ZodBoolean;
619
+ citations: z.ZodNumber;
620
+ error: z.ZodOptional<z.ZodString>;
621
+ }, "strip", z.ZodTypeAny, {
622
+ engine: string;
623
+ citations: number;
624
+ ok: boolean;
625
+ error?: string | undefined;
626
+ surface?: string | undefined;
627
+ interpretation_note?: string | undefined;
628
+ }, {
629
+ engine: string;
630
+ citations: number;
631
+ ok: boolean;
632
+ error?: string | undefined;
633
+ surface?: string | undefined;
634
+ interpretation_note?: string | undefined;
635
+ }>, "many">;
636
+ readonly engines_queried: z.ZodNumber;
637
+ readonly engines_succeeded: z.ZodNumber;
638
+ readonly per_url: z.ZodArray<z.ZodObject<{
639
+ url: z.ZodString;
640
+ cited_by: z.ZodArray<z.ZodString, "many">;
641
+ engine_count: z.ZodNumber;
642
+ }, "strip", z.ZodTypeAny, {
643
+ url: string;
644
+ cited_by: string[];
645
+ engine_count: number;
646
+ }, {
647
+ url: string;
648
+ cited_by: string[];
649
+ engine_count: number;
650
+ }>, "many">;
651
+ readonly consensus_urls: z.ZodArray<z.ZodString, "many">;
652
+ readonly summary: z.ZodObject<{
653
+ total_unique_urls: z.ZodNumber;
654
+ consensus_count: z.ZodNumber;
655
+ median_engines_per_url: z.ZodNumber;
656
+ }, "strip", z.ZodTypeAny, {
657
+ total_unique_urls: number;
658
+ consensus_count: number;
659
+ median_engines_per_url: number;
660
+ }, {
661
+ total_unique_urls: number;
662
+ consensus_count: number;
663
+ median_engines_per_url: number;
664
+ }>;
665
+ readonly note: z.ZodOptional<z.ZodString>;
666
+ };
667
+ export declare const citationEvidenceOutputShape: {
668
+ readonly query: z.ZodString;
669
+ readonly engine: z.ZodString;
670
+ readonly fetched_at: z.ZodString;
671
+ readonly raw_answer_chars: z.ZodNumber;
672
+ readonly has_raw_answer: z.ZodBoolean;
673
+ readonly citations_total: z.ZodNumber;
674
+ readonly evidence_found: z.ZodNumber;
675
+ readonly evidence: z.ZodArray<z.ZodObject<{
676
+ url: z.ZodString;
677
+ rank: z.ZodNumber;
678
+ title: z.ZodNullable<z.ZodOptional<z.ZodString>>;
679
+ found: z.ZodBoolean;
680
+ snippet: z.ZodNullable<z.ZodString>;
681
+ nearby_quote: z.ZodNullable<z.ZodString>;
682
+ mention_char: z.ZodNullable<z.ZodNumber>;
683
+ matched: z.ZodOptional<z.ZodString>;
684
+ }, "strip", z.ZodTypeAny, {
685
+ url: string;
686
+ rank: number;
687
+ snippet: string | null;
688
+ found: boolean;
689
+ nearby_quote: string | null;
690
+ mention_char: number | null;
691
+ title?: string | null | undefined;
692
+ matched?: string | undefined;
693
+ }, {
694
+ url: string;
695
+ rank: number;
696
+ snippet: string | null;
697
+ found: boolean;
698
+ nearby_quote: string | null;
699
+ mention_char: number | null;
700
+ title?: string | null | undefined;
701
+ matched?: string | undefined;
702
+ }>, "many">;
703
+ readonly note: z.ZodOptional<z.ZodString>;
704
+ };
705
+ export declare const crawlerAccessAuditOutputShape: {
706
+ readonly url: z.ZodString;
707
+ readonly robots_url: z.ZodString;
708
+ readonly robots_status: z.ZodNullable<z.ZodNumber>;
709
+ readonly robots_present: z.ZodBoolean;
710
+ readonly robots_error: z.ZodNullable<z.ZodString>;
711
+ readonly fetched_at: z.ZodString;
712
+ readonly bots: z.ZodArray<z.ZodObject<{
713
+ name: z.ZodString;
714
+ ua_token: z.ZodString;
715
+ operator: z.ZodString;
716
+ purpose: z.ZodString;
717
+ robots_allowed: z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"unknown">]>;
718
+ robots_rule: z.ZodNullable<z.ZodString>;
719
+ fetch_status: z.ZodNullable<z.ZodNumber>;
720
+ fetch_ok: z.ZodNullable<z.ZodBoolean>;
721
+ fetch_error: z.ZodNullable<z.ZodString>;
722
+ verdict: z.ZodEnum<["allowed", "blocked", "robots_only_allowed", "robots_only_blocked", "unknown"]>;
723
+ }, "strip", z.ZodTypeAny, {
724
+ fetch_error: string | null;
725
+ name: string;
726
+ verdict: "unknown" | "allowed" | "blocked" | "robots_only_allowed" | "robots_only_blocked";
727
+ ua_token: string;
728
+ operator: string;
729
+ purpose: string;
730
+ robots_allowed: boolean | "unknown";
731
+ robots_rule: string | null;
732
+ fetch_status: number | null;
733
+ fetch_ok: boolean | null;
734
+ }, {
735
+ fetch_error: string | null;
736
+ name: string;
737
+ verdict: "unknown" | "allowed" | "blocked" | "robots_only_allowed" | "robots_only_blocked";
738
+ ua_token: string;
739
+ operator: string;
740
+ purpose: string;
741
+ robots_allowed: boolean | "unknown";
742
+ robots_rule: string | null;
743
+ fetch_status: number | null;
744
+ fetch_ok: boolean | null;
745
+ }>, "many">;
746
+ readonly summary: z.ZodObject<{
747
+ total: z.ZodNumber;
748
+ allowed: z.ZodNumber;
749
+ blocked: z.ZodNumber;
750
+ unknown: z.ZodNumber;
751
+ }, "strip", z.ZodTypeAny, {
752
+ unknown: number;
753
+ allowed: number;
754
+ blocked: number;
755
+ total: number;
756
+ }, {
757
+ unknown: number;
758
+ allowed: number;
759
+ blocked: number;
760
+ total: number;
761
+ }>;
762
+ readonly note: z.ZodOptional<z.ZodString>;
763
+ };
764
+ export declare const sitemapCitationMapOutputShape: {
765
+ readonly sitemap_url: z.ZodString;
766
+ readonly domain: z.ZodString;
767
+ readonly since: z.ZodOptional<z.ZodString>;
768
+ readonly fetched_at: z.ZodString;
769
+ readonly total_urls: z.ZodNumber;
770
+ readonly mapped: z.ZodNumber;
771
+ readonly unmapped: z.ZodNumber;
772
+ readonly coverage_pct: z.ZodNumber;
773
+ readonly citations_in_cache: z.ZodNumber;
774
+ readonly mapped_urls: z.ZodArray<z.ZodObject<{
775
+ url: z.ZodString;
776
+ citation_count: z.ZodNumber;
777
+ unique_queries: z.ZodNumber;
778
+ engines: z.ZodArray<z.ZodString, "many">;
779
+ last_seen: z.ZodString;
780
+ sample_queries: z.ZodArray<z.ZodString, "many">;
781
+ }, "strip", z.ZodTypeAny, {
782
+ url: string;
783
+ engines: string[];
784
+ last_seen: string;
785
+ unique_queries: number;
786
+ citation_count: number;
787
+ sample_queries: string[];
788
+ }, {
789
+ url: string;
790
+ engines: string[];
791
+ last_seen: string;
792
+ unique_queries: number;
793
+ citation_count: number;
794
+ sample_queries: string[];
795
+ }>, "many">;
796
+ readonly unmapped_urls: z.ZodArray<z.ZodObject<{
797
+ url: z.ZodString;
798
+ }, "strip", z.ZodTypeAny, {
799
+ url: string;
800
+ }, {
801
+ url: string;
802
+ }>, "many">;
803
+ readonly note: z.ZodOptional<z.ZodString>;
804
+ };
805
+ export declare const canonicalCompetitorSetOutputShape: {
806
+ readonly query: z.ZodString;
807
+ readonly fetched_at: z.ZodString;
808
+ readonly engines: z.ZodArray<z.ZodObject<{
809
+ engine: z.ZodString;
810
+ ok: z.ZodBoolean;
811
+ citations: z.ZodNumber;
812
+ error: z.ZodOptional<z.ZodString>;
813
+ }, "strip", z.ZodTypeAny, {
814
+ engine: string;
815
+ citations: number;
816
+ ok: boolean;
817
+ error?: string | undefined;
818
+ }, {
819
+ engine: string;
820
+ citations: number;
821
+ ok: boolean;
822
+ error?: string | undefined;
823
+ }>, "many">;
824
+ readonly engines_queried: z.ZodNumber;
825
+ readonly engines_succeeded: z.ZodNumber;
826
+ readonly excluded_domains: z.ZodArray<z.ZodString, "many">;
827
+ readonly total_unique_domains: z.ZodNumber;
828
+ readonly top_n: z.ZodNumber;
829
+ readonly domains: z.ZodArray<z.ZodObject<{
830
+ domain: z.ZodString;
831
+ total_citations: z.ZodNumber;
832
+ engine_count: z.ZodNumber;
833
+ best_rank: z.ZodNumber;
834
+ by_engine: z.ZodArray<z.ZodObject<{
835
+ engine: z.ZodString;
836
+ citations: z.ZodNumber;
837
+ best_rank: z.ZodNumber;
838
+ sample_urls: z.ZodArray<z.ZodString, "many">;
839
+ }, "strip", z.ZodTypeAny, {
840
+ engine: string;
841
+ citations: number;
842
+ best_rank: number;
843
+ sample_urls: string[];
844
+ }, {
845
+ engine: string;
846
+ citations: number;
847
+ best_rank: number;
848
+ sample_urls: string[];
849
+ }>, "many">;
850
+ top_urls: z.ZodArray<z.ZodObject<{
851
+ url: z.ZodString;
852
+ count: z.ZodNumber;
853
+ }, "strip", z.ZodTypeAny, {
854
+ url: string;
855
+ count: number;
856
+ }, {
857
+ url: string;
858
+ count: number;
859
+ }>, "many">;
860
+ }, "strip", z.ZodTypeAny, {
861
+ domain: string;
862
+ total_citations: number;
863
+ best_rank: number;
864
+ by_engine: {
865
+ engine: string;
866
+ citations: number;
867
+ best_rank: number;
868
+ sample_urls: string[];
869
+ }[];
870
+ engine_count: number;
871
+ top_urls: {
872
+ url: string;
873
+ count: number;
874
+ }[];
875
+ }, {
876
+ domain: string;
877
+ total_citations: number;
878
+ best_rank: number;
879
+ by_engine: {
880
+ engine: string;
881
+ citations: number;
882
+ best_rank: number;
883
+ sample_urls: string[];
884
+ }[];
885
+ engine_count: number;
886
+ top_urls: {
887
+ url: string;
888
+ count: number;
889
+ }[];
890
+ }>, "many">;
891
+ readonly note: z.ZodOptional<z.ZodString>;
892
+ };
893
+ export declare const structuredDataRepairOutputShape: {
894
+ readonly url: z.ZodString;
895
+ readonly fetched_at: z.ZodString;
896
+ readonly schema_types_present: z.ZodArray<z.ZodString, "many">;
897
+ readonly signals_detected: z.ZodRecord<z.ZodString, z.ZodString>;
898
+ readonly suggestions: z.ZodArray<z.ZodObject<{
899
+ type: z.ZodString;
900
+ signal: z.ZodString;
901
+ ready_to_paste: z.ZodString;
902
+ }, "strip", z.ZodTypeAny, {
903
+ signal: string;
904
+ type: string;
905
+ ready_to_paste: string;
906
+ }, {
907
+ signal: string;
908
+ type: string;
909
+ ready_to_paste: string;
910
+ }>, "many">;
911
+ readonly summary: z.ZodObject<{
912
+ types_present: z.ZodNumber;
913
+ signals_detected: z.ZodNumber;
914
+ suggestions_count: z.ZodNumber;
915
+ }, "strip", z.ZodTypeAny, {
916
+ types_present: number;
917
+ signals_detected: number;
918
+ suggestions_count: number;
919
+ }, {
920
+ types_present: number;
921
+ signals_detected: number;
922
+ suggestions_count: number;
923
+ }>;
924
+ readonly note: z.ZodOptional<z.ZodString>;
925
+ };
926
+ //# sourceMappingURL=output-schemas.d.ts.map