@deepcitation/deepcitation-js 1.1.49 → 1.1.51

package/lib/client/index.d.ts

@@ -1,4 +1,4 @@
-import { C as Citation, V as Verification } from '../index-fvVBZYVK.js';
+import { C as Citation, V as Verification } from '../index-BHjI8Bh1.js';
 
 /**
  * Configuration options for the DeepCitation client
@@ -47,6 +47,30 @@ interface UploadFileOptions {
     /** Optional custom filename (uses File.name if not provided) */
     filename?: string;
 }
+/**
+ * Options for preparing a URL for citation verification.
+ * URLs and Office files take ~30s to process vs. <1s for images/PDFs.
+ */
+interface PrepareUrlOptions {
+    /** The URL to convert and prepare for citation verification */
+    url: string;
+    /** Optional custom attachment ID to use instead of auto-generated one */
+    attachmentId?: string;
+    /** Optional custom filename for the converted document */
+    filename?: string;
+    /**
+     * UNSAFE: Skip PDF conversion and extract text directly from HTML.
+     *
+     * This is much faster (<1s vs ~30s) but VULNERABLE to:
+     * - Hidden text (CSS display:none, tiny fonts, etc.)
+     * - Fine print that users can't see
+     * - Prompt injection attacks embedded in the page
+     *
+     * Only use this for trusted URLs where you control the content.
+     * Default: false (uses safe PDF conversion)
+     */
+    unsafeFastUrlOutput?: boolean;
+}
 /**
  * Response from verifying citations
  */
@@ -93,12 +117,6 @@ interface FileDataPart {
 interface PrepareFilesResult {
     /** Array of file references for verification (includes deepTextPromptPortion for each file) */
     fileDataParts: FileDataPart[];
-    /**
-     * Array of formatted text content for LLM prompts (with page markers and line IDs).
-     * @deprecated Use fileDataParts[].deepTextPromptPortion instead for single source of truth.
-     * This is kept for backwards compatibility but will be removed in a future version.
-     */
-    deepTextPromptPortion: string[];
 }
 /**
  * Input for verify method
@@ -111,10 +129,6 @@ interface VerifyInput {
     /** Output image format for verification screenshots */
     outputImageFormat?: "jpeg" | "png" | "avif";
 }
-/**
- * @deprecated Use VerifyInput instead. This alias is kept for backwards compatibility.
- */
-type verifyAll = VerifyInput;
 /**
  * Input for convertFile - convert URL or Office file to PDF
  */
@@ -271,6 +285,37 @@ declare class DeepCitation {
      * ```
      */
     prepareConvertedFile(options: PrepareConvertedFileOptions): Promise<UploadFileResponse>;
+    /**
+     * Prepare a URL for citation verification.
+     *
+     * This is a convenience method that handles URL conversion and text extraction
+     * in a single call. The API will convert the URL to PDF and extract text content
+     * for citation verification.
+     *
+     * Note: URLs and Office files take ~30s to process vs. <1s for images/PDFs.
+     *
+     * @param options - URL and optional settings
+     * @returns Upload response with attachmentId and extracted text for LLM prompts
+     *
+     * @example
+     * ```typescript
+     * // Prepare a URL for citation verification
+     * const { attachmentId, deepTextPromptPortion } = await deepcitation.prepareUrl({
+     *   url: "https://example.com/article"
+     * });
+     *
+     * // Use deepTextPromptPortion in your LLM prompt
+     * const { enhancedSystemPrompt, enhancedUserPrompt } = wrapCitationPrompt({
+     *   systemPrompt,
+     *   userPrompt: question,
+     *   deepTextPromptPortion,
+     * });
+     *
+     * // Verify citations
+     * const verified = await deepcitation.verifyAttachment(attachmentId, citations);
+     * ```
+     */
+    prepareUrl(options: PrepareUrlOptions): Promise<UploadFileResponse>;
     /**
      * Upload multiple files for citation verification and get structured content.
      * This is the recommended way to prepare files for LLM prompts.
@@ -293,7 +338,7 @@ declare class DeepCitation {
      * });
      *
      * // Use fileDataParts later for verification
-     * const result = await deepcitation.verifyAll({ llmOutput, fileDataParts });
+     * const result = await deepcitation.verify({ llmOutput, fileDataParts });
      * ```
      */
     prepareFiles(files: FileInput[]): Promise<PrepareFilesResult>;
@@ -355,4 +400,4 @@ declare class DeepCitation {
     }): Promise<VerifyCitationsResponse>;
 }
 
-export { type CitationInput, type ConvertFileInput, type ConvertFileResponse, DeepCitation, type DeepCitationConfig, type FileDataPart, type FileInput, type PrepareConvertedFileOptions, type PrepareFilesResult, type UploadFileOptions, type UploadFileResponse, type VerifyCitationsOptions, type VerifyCitationsResponse, type VerifyInput, type verifyAll };
+export { type CitationInput, type ConvertFileInput, type ConvertFileResponse, DeepCitation, type DeepCitationConfig, type FileDataPart, type FileInput, type PrepareConvertedFileOptions, type PrepareFilesResult, type PrepareUrlOptions, type UploadFileOptions, type UploadFileResponse, type VerifyCitationsOptions, type VerifyCitationsResponse, type VerifyInput };

package/lib/client/index.js

@@ -1 +1,2 @@
-export{a as DeepCitation}from'../chunk-3XSZLKJW.js';import'../chunk-PKXMJNRX.js';import'../chunk-O2XFH626.js';
+export{a as DeepCitation}from'../chunk-2HINOG74.js';import'../chunk-N7FTXSGM.js';import'../chunk-BDSA6VGC.js';import'../chunk-5XGN7UAV.js';//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/lib/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/lib/{index-fvVBZYVK.d.ts → index-BHjI8Bh1.d.cts}

@@ -10,23 +10,56 @@ interface ScreenBox extends IVertex {
     height: number;
 }
 
-type SearchStatus = "loading" | "pending" | "not_found" | "partial_text_found" | "found" | "found_key_span_only" | "found_phrase_missed_value" | "found_on_other_page" | "found_on_other_line" | "first_word_found" | "timestamp_wip" | "skipped";
-type SearchMethod = "exact_line_match" | "line_with_buffer" | "current_page" | "keyspan_fallback" | "adjacent_pages" | "expanded_window" | "regex_search" | "bm25_search" | "fuzzy_regex" | "first_word_fallback";
+type SearchStatus = "loading" | "pending" | "not_found" | "partial_text_found" | "found" | "found_anchor_text_only" | "found_phrase_missed_anchor_text" | "found_on_other_page" | "found_on_other_line" | "first_word_found" | "timestamp_wip" | "skipped";
+type SearchMethod = "exact_line_match" | "line_with_buffer" | "current_page" | "anchor_text_fallback" | "adjacent_pages" | "expanded_window" | "regex_search" | "first_word_fallback";
+/**
+ * Indicates which variation of the citation was matched.
+ * Trust decreases as we fall back from fullPhrase to anchorText to partial matches.
+ *
+ * HIGH TRUST (green indicator):
+ * - exact_full_phrase: Exact match on the full phrase
+ * - normalized_full_phrase: Full phrase matched with whitespace/case normalization
+ *
+ * MEDIUM TRUST (green indicator, shows context in popover):
+ * - exact_anchor_text: anchorText matched exactly, but fullPhrase was not found
+ * - normalized_anchor_text: anchorText matched with normalization
+ *
+ * LOW TRUST (amber indicator):
+ * - partial_full_phrase: Only part of fullPhrase matched (tables, columns, line breaks)
+ * - partial_anchor_text: Only part of anchorText matched
+ * - first_word_only: Only first word matched (lowest trust)
+ */
+type MatchedVariation = "exact_full_phrase" | "normalized_full_phrase" | "exact_anchor_text" | "normalized_anchor_text" | "partial_full_phrase" | "partial_anchor_text" | "first_word_only";
 interface SearchAttempt {
     method: SearchMethod;
     success: boolean;
-    searchPhrases: string[];
+    /** The primary phrase searched for */
+    searchPhrase: string;
+    /** Additional variations tried (e.g., ["$4.89", "4.89"]) */
+    searchVariations?: string[];
+    /** What searchPhrase contains: "full_phrase" or "anchor_text" */
+    searchPhraseType?: "full_phrase" | "anchor_text";
     pageSearched?: number;
-    matchedPhrases?: string[];
-    matchedVariation?: string;
-    phraseVariations?: string[];
-    matchQuality?: string;
-    isPartialMatch?: boolean;
-    matchScore?: number;
-    matchSnippet?: string;
-    notes?: string;
-    startTime?: number;
-    endTime?: number;
+    /** Line ID(s) searched within the page */
+    lineSearched?: number | number[];
+    /** Search scope: specific line, entire page, or whole document */
+    searchScope?: "line" | "page" | "document";
+    /** Where we expected to find the match */
+    expectedLocation?: {
+        page: number;
+        line?: number;
+    };
+    /** Where we actually found the match (if success: true) */
+    foundLocation?: {
+        page: number;
+        line?: number;
+    };
+    /** Which variation matched + trust level (only if success: true) */
+    matchedVariation?: MatchedVariation;
+    /** The actual text found in document (may exist even if success: false, for rejected matches) */
+    matchedText?: string;
+    /** e.g., "not found on expected page (2)" */
+    note?: string;
     durationMs?: number;
 }
 
@@ -56,12 +89,18 @@ interface Verification {
         endTime?: string;
     } | null;
     verifiedFullPhrase?: string | null;
-    verifiedKeySpan?: string | null;
+    verifiedAnchorText?: string | null;
     verifiedMatchSnippet?: string | null;
     hitIndexWithinPage?: number | null;
     phraseMatchDeepItem?: DeepTextItem;
-    keySpanMatchDeepItem?: DeepTextItem;
+    /** Multiple boxes for anchorText highlighting when the anchorText spans multiple PDF items/words */
+    anchorTextMatchDeepItems?: DeepTextItem[];
     verificationImageBase64?: string | null;
+    /** Dimensions of the verification image (for coordinate mapping) */
+    verificationImageDimensions?: {
+        width: number;
+        height: number;
+    } | null;
     verifiedAt?: Date;
     /** The URL that was verified (from Citation.url when type: "url") */
     verifiedUrl?: string | null;
@@ -138,7 +177,7 @@ type SourceType = "web" | "pdf" | "document" | "social" | "video" | "news" | "ac
  *
  * Common fields (used by both types):
  * - `fullPhrase`: The full context/excerpt containing the cited information
- * - `keySpan`: The specific key phrase being cited (must be substring of fullPhrase)
+ * - `anchorText`: The specific key phrase being cited (must be substring of fullPhrase)
  * - `citationNumber`: Citation number for display (e.g., [1], [2])
  *
  * @example Document citation
@@ -149,7 +188,7 @@ type SourceType = "web" | "pdf" | "document" | "social" | "video" | "news" | "ac
  *   pageNumber: 5,
  *   lineIds: [12, 13],
  *   fullPhrase: "Revenue increased by 15% in Q4.",
- *   keySpan: "increased by 15%",
+ *   anchorText: "increased by 15%",
  *   citationNumber: 1,
  * };
  * ```
@@ -162,7 +201,7 @@ type SourceType = "web" | "pdf" | "document" | "social" | "video" | "news" | "ac
  *   domain: "example.com",
  *   title: "Q4 Financial Report",
  *   fullPhrase: "The TGU transitions require control, not brute strength.",
- *   keySpan: "require control, not brute strength",
+ *   anchorText: "require control, not brute strength",
  *   citationNumber: 1,
  * };
  * ```
@@ -177,7 +216,7 @@ interface Citation {
     /** The full context/excerpt containing the cited information */
     fullPhrase?: string | null;
     /** The specific key phrase being cited (should be substring of fullPhrase) */
-    keySpan?: string | null;
+    anchorText?: string | null;
     /** Citation number for display (e.g., [1], [2], [3]) */
     citationNumber?: number;
     /** Reasoning for why this citation was included */
@@ -190,8 +229,8 @@ interface Citation {
     pageNumber?: number | null;
     /** Line IDs within the page */
     lineIds?: number[] | null;
-    /** Start page key for multi-page citations */
-    startPageKey?: string | null;
+    /** Start page ID for multi-page citations */
+    startPageId?: string | null;
     /** Selection box coordinates in the document */
     selection?: ScreenBox | null;
     /** The source URL */
@@ -259,4 +298,4 @@ interface SourceMeta {
     accessedAt?: Date | string;
 }
 
-export { BLANK_VERIFICATION as B, type Citation as C, DEFAULT_OUTPUT_IMAGE_FORMAT as D, type IVertex as I, NOT_FOUND_VERIFICATION_INDEX as N, type OutputImageFormat as O, PENDING_VERIFICATION_INDEX as P, type SourceType as S, type UrlAccessStatus as U, type Verification as V, type CitationStatus as a, type CitationType as b, type VerifyCitationRequest as c, type VerifyCitationResponse as d, type SourceMeta as e, type ContentMatchStatus as f, type SearchStatus as g, type SearchMethod as h, type SearchAttempt as i, type ScreenBox as j, type DeepTextItem as k };
+export { BLANK_VERIFICATION as B, type Citation as C, DEFAULT_OUTPUT_IMAGE_FORMAT as D, type IVertex as I, type MatchedVariation as M, NOT_FOUND_VERIFICATION_INDEX as N, type OutputImageFormat as O, PENDING_VERIFICATION_INDEX as P, type ScreenBox as S, type UrlAccessStatus as U, type Verification as V, type CitationStatus as a, type CitationType as b, type ContentMatchStatus as c, type DeepTextItem as d, type SearchAttempt as e, type SearchMethod as f, type SearchStatus as g, type SourceMeta as h, type SourceType as i, type VerifyCitationRequest as j, type VerifyCitationResponse as k };

package/lib/{index-fvVBZYVK.d.cts → index-BHjI8Bh1.d.ts}

@@ -10,23 +10,56 @@ interface ScreenBox extends IVertex {
     height: number;
 }
 
-type SearchStatus = "loading" | "pending" | "not_found" | "partial_text_found" | "found" | "found_key_span_only" | "found_phrase_missed_value" | "found_on_other_page" | "found_on_other_line" | "first_word_found" | "timestamp_wip" | "skipped";
-type SearchMethod = "exact_line_match" | "line_with_buffer" | "current_page" | "keyspan_fallback" | "adjacent_pages" | "expanded_window" | "regex_search" | "bm25_search" | "fuzzy_regex" | "first_word_fallback";
+type SearchStatus = "loading" | "pending" | "not_found" | "partial_text_found" | "found" | "found_anchor_text_only" | "found_phrase_missed_anchor_text" | "found_on_other_page" | "found_on_other_line" | "first_word_found" | "timestamp_wip" | "skipped";
+type SearchMethod = "exact_line_match" | "line_with_buffer" | "current_page" | "anchor_text_fallback" | "adjacent_pages" | "expanded_window" | "regex_search" | "first_word_fallback";
+/**
+ * Indicates which variation of the citation was matched.
+ * Trust decreases as we fall back from fullPhrase to anchorText to partial matches.
+ *
+ * HIGH TRUST (green indicator):
+ * - exact_full_phrase: Exact match on the full phrase
+ * - normalized_full_phrase: Full phrase matched with whitespace/case normalization
+ *
+ * MEDIUM TRUST (green indicator, shows context in popover):
+ * - exact_anchor_text: anchorText matched exactly, but fullPhrase was not found
+ * - normalized_anchor_text: anchorText matched with normalization
+ *
+ * LOW TRUST (amber indicator):
+ * - partial_full_phrase: Only part of fullPhrase matched (tables, columns, line breaks)
+ * - partial_anchor_text: Only part of anchorText matched
+ * - first_word_only: Only first word matched (lowest trust)
+ */
+type MatchedVariation = "exact_full_phrase" | "normalized_full_phrase" | "exact_anchor_text" | "normalized_anchor_text" | "partial_full_phrase" | "partial_anchor_text" | "first_word_only";
 interface SearchAttempt {
     method: SearchMethod;
     success: boolean;
-    searchPhrases: string[];
+    /** The primary phrase searched for */
+    searchPhrase: string;
+    /** Additional variations tried (e.g., ["$4.89", "4.89"]) */
+    searchVariations?: string[];
+    /** What searchPhrase contains: "full_phrase" or "anchor_text" */
+    searchPhraseType?: "full_phrase" | "anchor_text";
     pageSearched?: number;
-    matchedPhrases?: string[];
-    matchedVariation?: string;
-    phraseVariations?: string[];
-    matchQuality?: string;
-    isPartialMatch?: boolean;
-    matchScore?: number;
-    matchSnippet?: string;
-    notes?: string;
-    startTime?: number;
-    endTime?: number;
+    /** Line ID(s) searched within the page */
+    lineSearched?: number | number[];
+    /** Search scope: specific line, entire page, or whole document */
+    searchScope?: "line" | "page" | "document";
+    /** Where we expected to find the match */
+    expectedLocation?: {
+        page: number;
+        line?: number;
+    };
+    /** Where we actually found the match (if success: true) */
+    foundLocation?: {
+        page: number;
+        line?: number;
+    };
+    /** Which variation matched + trust level (only if success: true) */
+    matchedVariation?: MatchedVariation;
+    /** The actual text found in document (may exist even if success: false, for rejected matches) */
+    matchedText?: string;
+    /** e.g., "not found on expected page (2)" */
+    note?: string;
     durationMs?: number;
 }
 
@@ -56,12 +89,18 @@ interface Verification {
         endTime?: string;
     } | null;
     verifiedFullPhrase?: string | null;
-    verifiedKeySpan?: string | null;
+    verifiedAnchorText?: string | null;
     verifiedMatchSnippet?: string | null;
     hitIndexWithinPage?: number | null;
     phraseMatchDeepItem?: DeepTextItem;
-    keySpanMatchDeepItem?: DeepTextItem;
+    /** Multiple boxes for anchorText highlighting when the anchorText spans multiple PDF items/words */
+    anchorTextMatchDeepItems?: DeepTextItem[];
     verificationImageBase64?: string | null;
+    /** Dimensions of the verification image (for coordinate mapping) */
+    verificationImageDimensions?: {
+        width: number;
+        height: number;
+    } | null;
     verifiedAt?: Date;
     /** The URL that was verified (from Citation.url when type: "url") */
     verifiedUrl?: string | null;
@@ -138,7 +177,7 @@ type SourceType = "web" | "pdf" | "document" | "social" | "video" | "news" | "ac
  *
  * Common fields (used by both types):
  * - `fullPhrase`: The full context/excerpt containing the cited information
- * - `keySpan`: The specific key phrase being cited (must be substring of fullPhrase)
+ * - `anchorText`: The specific key phrase being cited (must be substring of fullPhrase)
  * - `citationNumber`: Citation number for display (e.g., [1], [2])
  *
  * @example Document citation
@@ -149,7 +188,7 @@ type SourceType = "web" | "pdf" | "document" | "social" | "video" | "news" | "ac
  *   pageNumber: 5,
  *   lineIds: [12, 13],
  *   fullPhrase: "Revenue increased by 15% in Q4.",
- *   keySpan: "increased by 15%",
+ *   anchorText: "increased by 15%",
  *   citationNumber: 1,
  * };
  * ```
@@ -162,7 +201,7 @@ type SourceType = "web" | "pdf" | "document" | "social" | "video" | "news" | "ac
  *   domain: "example.com",
  *   title: "Q4 Financial Report",
  *   fullPhrase: "The TGU transitions require control, not brute strength.",
- *   keySpan: "require control, not brute strength",
+ *   anchorText: "require control, not brute strength",
  *   citationNumber: 1,
  * };
  * ```
@@ -177,7 +216,7 @@ interface Citation {
     /** The full context/excerpt containing the cited information */
     fullPhrase?: string | null;
     /** The specific key phrase being cited (should be substring of fullPhrase) */
-    keySpan?: string | null;
+    anchorText?: string | null;
     /** Citation number for display (e.g., [1], [2], [3]) */
     citationNumber?: number;
     /** Reasoning for why this citation was included */
@@ -190,8 +229,8 @@ interface Citation {
     pageNumber?: number | null;
     /** Line IDs within the page */
     lineIds?: number[] | null;
-    /** Start page key for multi-page citations */
-    startPageKey?: string | null;
+    /** Start page ID for multi-page citations */
+    startPageId?: string | null;
     /** Selection box coordinates in the document */
     selection?: ScreenBox | null;
     /** The source URL */
@@ -259,4 +298,4 @@ interface SourceMeta {
     accessedAt?: Date | string;
 }
 
-export { BLANK_VERIFICATION as B, type Citation as C, DEFAULT_OUTPUT_IMAGE_FORMAT as D, type IVertex as I, NOT_FOUND_VERIFICATION_INDEX as N, type OutputImageFormat as O, PENDING_VERIFICATION_INDEX as P, type SourceType as S, type UrlAccessStatus as U, type Verification as V, type CitationStatus as a, type CitationType as b, type VerifyCitationRequest as c, type VerifyCitationResponse as d, type SourceMeta as e, type ContentMatchStatus as f, type SearchStatus as g, type SearchMethod as h, type SearchAttempt as i, type ScreenBox as j, type DeepTextItem as k };
+export { BLANK_VERIFICATION as B, type Citation as C, DEFAULT_OUTPUT_IMAGE_FORMAT as D, type IVertex as I, type MatchedVariation as M, NOT_FOUND_VERIFICATION_INDEX as N, type OutputImageFormat as O, PENDING_VERIFICATION_INDEX as P, type ScreenBox as S, type UrlAccessStatus as U, type Verification as V, type CitationStatus as a, type CitationType as b, type ContentMatchStatus as c, type DeepTextItem as d, type SearchAttempt as e, type SearchMethod as f, type SearchStatus as g, type SourceMeta as h, type SourceType as i, type VerifyCitationRequest as j, type VerifyCitationResponse as k };

package/lib/index.cjs

@@ -1 +1,2 @@
-'use strict';var chunkD2TKEF6D_cjs=require('./chunk-D2TKEF6D.cjs'),chunkDHVODVIA_cjs=require('./chunk-DHVODVIA.cjs'),chunkUUR2SQKU_cjs=require('./chunk-UUR2SQKU.cjs'),chunk2PRW5PVT_cjs=require('./chunk-2PRW5PVT.cjs');require('./chunk-F2MMVEVC.cjs');var z=t=>{if(!t)return  false;let e=t.trim();if(e.length<64)return  false;let a=e?.[0];for(let r=1;r<e.length;r++)if(e[r]!==a)return  false;return  true};function J(t){t=t.trim();let e=2,a=10,r=/[.?!](?=\s+|$)/g,n=[],c;for(;(c=r.exec(t))!==null;)n.push(c.index);if(n.length<2)return t;let I=n[n.length-1],f=n[n.length-2],o=t.substring(f+1,I+1),p=o.length;if(o.trim().slice(0,-1).length<a||p<=0||t.length<p*e)return t;let m=0,s=I+1;t.endsWith(o)&&(s=t.length);let T=-1;for(;;){let i=s-p;if(i<0)break;if(t.substring(i,s)===o)m++,T=i,s=i;else break}return m>=e?t.substring(0,T)+o:t}Object.defineProperty(exports,"DeepCitation",{enumerable:true,get:function(){return chunkD2TKEF6D_cjs.a}});Object.defineProperty(exports,"AV_CITATION_MARKDOWN_SYNTAX_PROMPT",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.b}});Object.defineProperty(exports,"CITATION_AV_BASED_JSON_OUTPUT_FORMAT",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.h}});Object.defineProperty(exports,"CITATION_AV_REMINDER",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.d}});Object.defineProperty(exports,"CITATION_JSON_OUTPUT_FORMAT",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.g}});Object.defineProperty(exports,"CITATION_MARKDOWN_SYNTAX_PROMPT",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.a}});Object.defineProperty(exports,"CITATION_REMINDER",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.c}});Object.defineProperty(exports,"compressPromptIds",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.i}});Object.defineProperty(exports,"decompressPromptIds",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.j}});Object.defineProperty(exports,"wrapCitationPrompt",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.f}});Object.defineProperty(exports,"wrapSystemCitationPrompt",{enumerable:true,get:function(){return chunkDHVODVIA_cjs.e}});Object.defineProperty(exports,"BLANK_VERIFICATION",{enumerable:true,get:function(){return chunkUUR2SQKU_cjs.d}});Object.defineProperty(exports,"DEFAULT_OUTPUT_IMAGE_FORMAT",{enumerable:true,get:function(){return chunkUUR2SQKU_cjs.a}});Object.defineProperty(exports,"NOT_FOUND_VERIFICATION_INDEX",{enumerable:true,get:function(){return chunkUUR2SQKU_cjs.b}});Object.defineProperty(exports,"PENDING_VERIFICATION_INDEX",{enumerable:true,get:function(){return chunkUUR2SQKU_cjs.c}});Object.defineProperty(exports,"CITATION_X_PADDING",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.k}});Object.defineProperty(exports,"CITATION_Y_PADDING",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.l}});Object.defineProperty(exports,"generateCitationInstanceId",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.f}});Object.defineProperty(exports,"generateCitationKey",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.d}});Object.defineProperty(exports,"generateVerificationKey",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.e}});Object.defineProperty(exports,"getAllCitationsFromLlmOutput",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.v}});Object.defineProperty(exports,"getCitationPageNumber",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.r}});Object.defineProperty(exports,"getCitationStatus",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.t}});Object.defineProperty(exports,"getVerificationTextIndicator",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.m}});Object.defineProperty(exports,"groupCitationsByAttachmentId",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.w}});Object.defineProperty(exports,"groupCitationsByAttachmentIdObject",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.x}});Object.defineProperty(exports,"normalizeCitations",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.s}});Object.defineProperty(exports,"parseCitation",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.u}});Object.defineProperty(exports,"removeCitations",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.o}});Object.defineProperty(exports,"removeLineIdMetadata",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.q}});Object.defineProperty(exports,"removePageNumberMetadata",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.p}});Object.defineProperty(exports,"replaceCitations",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.n}});Object.defineProperty(exports,"sha1Hash",{enumerable:true,get:function(){return chunk2PRW5PVT_cjs.a}});exports.cleanRepeatingLastSentence=J;exports.isGeminiGarbage=z;
+'use strict';var chunk7TORYXU4_cjs=require('./chunk-7TORYXU4.cjs'),chunkDS6SOU4L_cjs=require('./chunk-DS6SOU4L.cjs'),chunkHL3AXCDL_cjs=require('./chunk-HL3AXCDL.cjs'),chunk4UWAUWYL_cjs=require('./chunk-4UWAUWYL.cjs'),chunkWS4CQVDI_cjs=require('./chunk-WS4CQVDI.cjs');require('./chunk-BYLIBOAU.cjs');var rt=t=>{if(!t)return  false;let e=t.trim();if(e.length<64)return  false;let a=e?.[0];for(let n=1;n<e.length;n++)if(e[n]!==a)return  false;return  true};function nt(t){t=t.trim();let e=2,a=10,n=/[.?!](?=\s+|$)/g,r=[],I;for(;(I=n.exec(t))!==null;)r.push(I.index);if(r.length<2)return t;let c=r[r.length-1],C=r[r.length-2],i=t.substring(C+1,c+1),p=i.length;if(i.trim().slice(0,-1).length<a||p<=0||t.length<p*e)return t;let m=0,s=c+1;t.endsWith(i)&&(s=t.length);let T=-1;for(;;){let o=s-p;if(o<0)break;if(t.substring(o,s)===i)m++,T=o,s=o;else break}return m>=e?t.substring(0,T)+i:t}Object.defineProperty(exports,"DeepCitation",{enumerable:true,get:function(){return chunk7TORYXU4_cjs.a}});Object.defineProperty(exports,"compressPromptIds",{enumerable:true,get:function(){return chunkDS6SOU4L_cjs.a}});Object.defineProperty(exports,"decompressPromptIds",{enumerable:true,get:function(){return chunkDS6SOU4L_cjs.b}});Object.defineProperty(exports,"BLANK_VERIFICATION",{enumerable:true,get:function(){return chunkHL3AXCDL_cjs.d}});Object.defineProperty(exports,"DEFAULT_OUTPUT_IMAGE_FORMAT",{enumerable:true,get:function(){return chunkHL3AXCDL_cjs.a}});Object.defineProperty(exports,"NOT_FOUND_VERIFICATION_INDEX",{enumerable:true,get:function(){return chunkHL3AXCDL_cjs.b}});Object.defineProperty(exports,"PENDING_VERIFICATION_INDEX",{enumerable:true,get:function(){return chunkHL3AXCDL_cjs.c}});Object.defineProperty(exports,"CITATION_X_PADDING",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.k}});Object.defineProperty(exports,"CITATION_Y_PADDING",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.l}});Object.defineProperty(exports,"deferredCitationToCitation",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.t}});Object.defineProperty(exports,"extractVisibleText",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.w}});Object.defineProperty(exports,"generateCitationInstanceId",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.f}});Object.defineProperty(exports,"generateCitationKey",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.d}});Object.defineProperty(exports,"generateVerificationKey",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.e}});Object.defineProperty(exports,"getAllCitationsFromDeferredResponse",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.u}});Object.defineProperty(exports,"getAllCitationsFromLlmOutput",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.B}});Object.defineProperty(exports,"getCitationMarkerIds",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.y}});Object.defineProperty(exports,"getCitationPageNumber",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.q}});Object.defineProperty(exports,"getCitationStatus",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.z}});Object.defineProperty(exports,"getVerificationTextIndicator",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.m}});Object.defineProperty(exports,"groupCitationsByAttachmentId",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.C}});Object.defineProperty(exports,"groupCitationsByAttachmentIdObject",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.D}});Object.defineProperty(exports,"hasDeferredCitations",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.v}});Object.defineProperty(exports,"normalizeCitations",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.r}});Object.defineProperty(exports,"parseCitation",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.A}});Object.defineProperty(exports,"parseDeferredCitationResponse",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.s}});Object.defineProperty(exports,"removeLineIdMetadata",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.p}});Object.defineProperty(exports,"removePageNumberMetadata",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.o}});Object.defineProperty(exports,"replaceCitations",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.n}});Object.defineProperty(exports,"replaceDeferredMarkers",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.x}});Object.defineProperty(exports,"sha1Hash",{enumerable:true,get:function(){return chunk4UWAUWYL_cjs.a}});Object.defineProperty(exports,"AV_CITATION_PROMPT",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.d}});Object.defineProperty(exports,"CITATION_AV_JSON_OUTPUT_FORMAT",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.j}});Object.defineProperty(exports,"CITATION_AV_REMINDER",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.f}});Object.defineProperty(exports,"CITATION_DATA_END_DELIMITER",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.b}});Object.defineProperty(exports,"CITATION_DATA_START_DELIMITER",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.a}});Object.defineProperty(exports,"CITATION_JSON_OUTPUT_FORMAT",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.i}});Object.defineProperty(exports,"CITATION_PROMPT",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.c}});Object.defineProperty(exports,"CITATION_REMINDER",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.e}});Object.defineProperty(exports,"wrapCitationPrompt",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.h}});Object.defineProperty(exports,"wrapSystemCitationPrompt",{enumerable:true,get:function(){return chunkWS4CQVDI_cjs.g}});exports.cleanRepeatingLastSentence=nt;exports.isGeminiGarbage=rt;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parsing/parseWorkAround.ts"],"names":["isGeminiGarbage","content","trimmedContent","firstCharacter","i","cleanRepeatingLastSentence","text","MIN_REPETITIONS","MIN_SENTENCE_CONTENT_LENGTH","sentenceEndRegex","sentenceEndIndices","match","lastTerminatorIndex","secondLastTerminatorIndex","repeatingUnit","unitLength","repetitionsFound","currentCheckEndIndex","firstRepetitionStartIndex","checkStartIndex"],"mappings":"2SAEO,IAAMA,GAAmBC,CAAAA,EAAoB,CAClD,GAAI,CAACA,EAAS,OAAO,MAAA,CACrB,IAAMC,CAAAA,CAAiBD,EAAQ,IAAA,EAAK,CACpC,GAAIC,CAAAA,CAAe,MAAA,CAAS,GAAuC,OAAO,MAAA,CAE1E,IAAMC,CAAAA,CAAiBD,IAAiB,CAAC,CAAA,CAEzC,QAASE,CAAAA,CAAI,CAAA,CAAGA,EAAIF,CAAAA,CAAe,MAAA,CAAQE,CAAAA,EAAAA,CACzC,GAAIF,EAAeE,CAAC,CAAA,GAAMD,EAAgB,OAAO,MAAA,CAEnD,OAAO,KACT,EAGO,SAASE,EAAAA,CAA2BC,EAAsB,CAC/DA,CAAAA,CAAOA,CAAAA,CAAK,IAAA,GACZ,IAAMC,CAAAA,CAAkB,CAAA,CAClBC,CAAAA,CAA8B,GAE9BC,CAAAA,CAAmB,iBAAA,CACnBC,EAA+B,EAAC,CAClCC,EACJ,KAAA,CAAQA,CAAAA,CAAQF,CAAAA,CAAiB,IAAA,CAAKH,CAAI,CAAA,IAAO,IAAA,EAC/CI,EAAmB,IAAA,CAAKC,CAAAA,CAAM,KAAK,CAAA,CAGrC,GAAID,CAAAA,CAAmB,MAAA,CAAS,EAC9B,OAAOJ,CAAAA,CAGT,IAAMM,CAAAA,CAAsBF,CAAAA,CAAmBA,EAAmB,MAAA,CAAS,CAAC,CAAA,CACtEG,CAAAA,CAA4BH,EAAmBA,CAAAA,CAAmB,MAAA,CAAS,CAAC,CAAA,CAE5EI,EAAgBR,CAAAA,CAAK,SAAA,CAAUO,CAAAA,CAA4B,CAAA,CAAGD,EAAsB,CAAC,CAAA,CACrFG,EAAaD,CAAAA,CAAc,MAAA,CAUjC,GARwBA,CAAAA,CAAc,IAAA,EAAK,CAAE,KAAA,CAAM,EAAG,EAAE,CAAA,CACpC,OAASN,CAAAA,EAGzBO,CAAAA,EAAc,GAIdT,CAAAA,CAAK,MAAA,CAASS,CAAAA,CAAaR,CAAAA,CAC7B,OAAOD,CAAAA,CAGT,IAAIU,EAAmB,CAAA,CACnBC,CAAAA,CAAuBL,EAAsB,CAAA,CAC7CN,CAAAA,CAAK,QAAA,CAASQ,CAAa,IAC7BG,CAAAA,CAAuBX,CAAAA,CAAK,QAG9B,IAAIY,CAAAA,CAA4B,GAEhC,OAAa,CACX,IAAMC,CAAAA,CAAkBF,EAAuBF,CAAAA,CAE/C,GAAII,EAAkB,CAAA,CACpB,MAKF,GAFcb,CAAAA,CAAK,SAAA,CAAUa,CAAAA,CAAiBF,CAAoB,IAEpDH,CAAAA,CACZE,CAAAA,EAAAA,CACAE,EAA4BC,CAAAA,CAC5BF,CAAAA,CAAuBE,OAEvB,KAEJ,CAEA,OAAIH,CAAAA,EAAoBT,EACQD,CAAAA,CAAK,SAAA,CAAU,EAAGY,CAAyB,CAAA,CAClCJ,EAGhCR,CAEX","file":"index.cjs","sourcesContent":["//flash and flash lite get super confused if we ask for a MD table and infinite loop\nconst MIN_CONTENT_LENGTH_FOR_GEMINI_GARBAGE = 64;\nexport const isGeminiGarbage = (content: string) => {\n  if (!content) return false;\n  const trimmedContent = content.trim();\n  if (trimmedContent.length < MIN_CONTENT_LENGTH_FOR_GEMINI_GARBAGE) return false;\n\n  const firstCharacter = trimmedContent?.[0];\n\n  for (let i = 1; i < trimmedContent.length; i++) {\n    if (trimmedContent[i] !== firstCharacter) return false;\n  }\n  return true;\n};\n\n// helps clean up infinite rambling bug output from gemini\nexport function cleanRepeatingLastSentence(text: string): string {\n  text = text.trim();\n  const MIN_REPETITIONS = 2;\n  const MIN_SENTENCE_CONTENT_LENGTH = 10;\n\n  const sentenceEndRegex = /[.?!](?=\\s+|$)/g;\n  const sentenceEndIndices: number[] = [];\n  let match;\n  while ((match = sentenceEndRegex.exec(text)) !== null) {\n    sentenceEndIndices.push(match.index);\n  }\n\n  if (sentenceEndIndices.length < 2) {\n    return text;\n  }\n\n  const lastTerminatorIndex = sentenceEndIndices[sentenceEndIndices.length - 1];\n  const secondLastTerminatorIndex = sentenceEndIndices[sentenceEndIndices.length - 2];\n\n  const repeatingUnit = text.substring(secondLastTerminatorIndex + 1, lastTerminatorIndex + 1);\n  const unitLength = repeatingUnit.length;\n\n  const sentenceContent = repeatingUnit.trim().slice(0, -1);\n  if (sentenceContent.length < MIN_SENTENCE_CONTENT_LENGTH) {\n    return text;\n  }\n  if (unitLength <= 0) {\n    return text;\n  }\n\n  if (text.length < unitLength * MIN_REPETITIONS) {\n    return text;\n  }\n\n  let repetitionsFound = 0;\n  let currentCheckEndIndex = lastTerminatorIndex + 1;\n  if (text.endsWith(repeatingUnit)) {\n    currentCheckEndIndex = text.length;\n  }\n\n  let firstRepetitionStartIndex = -1;\n\n  while (true) {\n    const checkStartIndex = currentCheckEndIndex - unitLength;\n\n    if (checkStartIndex < 0) {\n      break;\n    }\n\n    const chunk = text.substring(checkStartIndex, currentCheckEndIndex);\n\n    if (chunk === repeatingUnit) {\n      repetitionsFound++;\n      firstRepetitionStartIndex = checkStartIndex;\n      currentCheckEndIndex = checkStartIndex;\n    } else {\n      break;\n    }\n  }\n\n  if (repetitionsFound >= MIN_REPETITIONS) {\n    const textBeforeRepetitions = text.substring(0, firstRepetitionStartIndex);\n    const result = textBeforeRepetitions + repeatingUnit;\n    return result;\n  } else {\n    return text;\n  }\n}\n"]}

package/lib/index.d.cts

@@ -1,8 +1,9 @@
-export { CitationInput, DeepCitation, DeepCitationConfig, FileDataPart, FileInput, PrepareFilesResult, UploadFileOptions, UploadFileResponse, VerifyCitationsOptions, VerifyCitationsResponse, verifyAll } from './client/index.cjs';
-import { C as Citation, V as Verification, a as CitationStatus } from './index-fvVBZYVK.cjs';
-export { B as BLANK_VERIFICATION, b as CitationType, f as ContentMatchStatus, D as DEFAULT_OUTPUT_IMAGE_FORMAT, k as DeepTextItem, I as IVertex, N as NOT_FOUND_VERIFICATION_INDEX, O as OutputImageFormat, P as PENDING_VERIFICATION_INDEX, j as ScreenBox, i as SearchAttempt, h as SearchMethod, g as SearchStatus, e as SourceMeta, S as SourceType, U as UrlAccessStatus, c as VerifyCitationRequest, d as VerifyCitationResponse } from './index-fvVBZYVK.cjs';
-export { C as CITATION_X_PADDING, c as CITATION_Y_PADDING, b as generateCitationInstanceId, g as generateCitationKey, a as generateVerificationKey } from './utils-q6anRKO_.cjs';
-export { AV_CITATION_MARKDOWN_SYNTAX_PROMPT, CITATION_AV_BASED_JSON_OUTPUT_FORMAT, CITATION_AV_REMINDER, CITATION_JSON_OUTPUT_FORMAT, CITATION_MARKDOWN_SYNTAX_PROMPT, CITATION_REMINDER, CompressedResult, WrapCitationPromptOptions, WrapCitationPromptResult, WrapSystemPromptOptions, compressPromptIds, decompressPromptIds, wrapCitationPrompt, wrapSystemCitationPrompt } from './prompts/index.cjs';
+export { CitationInput, DeepCitation, DeepCitationConfig, FileDataPart, FileInput, PrepareFilesResult, UploadFileOptions, UploadFileResponse, VerifyCitationsOptions, VerifyCitationsResponse } from './client/index.cjs';
+import { C as Citation, V as Verification, a as CitationStatus } from './index-BHjI8Bh1.cjs';
+export { B as BLANK_VERIFICATION, b as CitationType, c as ContentMatchStatus, D as DEFAULT_OUTPUT_IMAGE_FORMAT, d as DeepTextItem, I as IVertex, N as NOT_FOUND_VERIFICATION_INDEX, O as OutputImageFormat, P as PENDING_VERIFICATION_INDEX, S as ScreenBox, e as SearchAttempt, f as SearchMethod, g as SearchStatus, h as SourceMeta, i as SourceType, U as UrlAccessStatus, j as VerifyCitationRequest, k as VerifyCitationResponse } from './index-BHjI8Bh1.cjs';
+import { CitationData, ParsedCitationResponse } from './prompts/index.cjs';
+export { AV_CITATION_PROMPT, CITATION_AV_JSON_OUTPUT_FORMAT, CITATION_AV_REMINDER, CITATION_DATA_END_DELIMITER, CITATION_DATA_START_DELIMITER, CITATION_JSON_OUTPUT_FORMAT, CITATION_PROMPT, CITATION_REMINDER, CompressedResult, WrapCitationPromptOptions, WrapCitationPromptResult, WrapSystemPromptOptions, compressPromptIds, decompressPromptIds, wrapCitationPrompt, wrapSystemCitationPrompt } from './prompts/index.cjs';
+export { C as CITATION_X_PADDING, a as CITATION_Y_PADDING, g as generateCitationInstanceId, b as generateCitationKey, c as generateVerificationKey } from './utils-CCi9_JTv.cjs';
 
 /**
  * Calculates the verification status of a citation based on the found highlight and search state.
@@ -82,12 +83,136 @@ declare function groupCitationsByAttachmentIdObject(citations: Citation[] | {
     };
 };
 
+/**
+ * Citation Parser
+ *
+ * Implements the "Split & Parse" strategy for the deferred JSON citation pattern.
+ * This parser extracts citations from LLM responses that use [N] markers in text
+ * and include a JSON data block at the end.
+ *
+ * Algorithm:
+ * 1. Detection: Look for the start delimiter <<<CITATION_DATA>>>
+ * 2. Splitting: Separate visible content from the citation data block
+ * 3. Data Extraction: Extract the JSON string between delimiters
+ * 4. Sanitization: Parse with JSON.parse, with fallback repair for common issues
+ * 5. Hydration: Map the JSON objects to a usable format
+ */
+
+/**
+ * Parses a citation response from an LLM.
+ *
+ * This function:
+ * 1. Finds the <<<CITATION_DATA>>> delimiter in the response
+ * 2. Splits the response into visible text and citation data
+ * 3. Parses the JSON citation data
+ * 4. Returns a structured result with both
+ *
+ * @param llmResponse - The full LLM response text
+ * @returns ParsedCitationResponse with visible text and parsed citations
+ *
+ * @example
+ * ```typescript
+ * const response = `
+ *   The company grew 45% [1].
+ *
+ *   <<<CITATION_DATA>>>
+ *   [{"id": 1, "attachment_id": "abc", "full_phrase": "grew 45%", "anchor_text": "45%"}]
+ *   <<<END_CITATION_DATA>>>
+ * `;
+ *
+ * const parsed = parseDeferredCitationResponse(response);
+ * console.log(parsed.visibleText); // "The company grew 45% [1]."
+ * console.log(parsed.citations); // [{id: 1, attachment_id: "abc", ...}]
+ * ```
+ */
+declare function parseDeferredCitationResponse(llmResponse: string): ParsedCitationResponse;
+/**
+ * Converts a CitationData object to the standard Citation format.
+ *
+ * @param data - The citation data
+ * @param citationNumber - Optional override for citation number (defaults to data.id)
+ * @returns Standard Citation object
+ */
+declare function deferredCitationToCitation(data: CitationData, citationNumber?: number): Citation;
+/**
+ * Extracts all citations from a citation response and returns them
+ * in the standard dictionary format used by the verification API.
+ *
+ * This function parses the response, converts each citation to the standard
+ * Citation format, and generates deterministic keys for each.
+ *
+ * @param llmResponse - The full LLM response with citation block
+ * @returns Dictionary of parsed Citation objects keyed by citation key
+ *
+ * @example
+ * ```typescript
+ * const citations = getAllCitationsFromDeferredResponse(llmOutput);
+ * // Returns: { "abc123...": { attachmentId: "...", fullPhrase: "...", ... }, ... }
+ * ```
+ */
+declare function getAllCitationsFromDeferredResponse(llmResponse: string): {
+    [key: string]: Citation;
+};
+/**
+ * Checks if a response contains citation markers.
+ *
+ * @param response - The LLM response to check
+ * @returns True if the response contains the citation data delimiter
+ */
+declare function hasDeferredCitations(response: string): boolean;
+/**
+ * Extracts just the visible text from a response,
+ * removing the citation data block.
+ *
+ * @param llmResponse - The full LLM response
+ * @returns The visible text portion only
+ */
+declare function extractVisibleText(llmResponse: string): string;
+/**
+ * Replaces [N] citation markers in text with optional content.
+ *
+ * @param text - The text containing [N] markers
+ * @param options - Configuration for replacement
+ * @returns The text with markers replaced
+ *
+ * @example
+ * ```typescript
+ * const text = "Revenue grew 45% [1] in Q4 [2].";
+ *
+ * // Remove markers entirely
+ * replaceDeferredMarkers(text);
+ * // Returns: "Revenue grew 45% in Q4."
+ *
+ * // Replace with anchor texts
+ * replaceDeferredMarkers(text, {
+ *   citationMap: new Map([[1, { anchor_text: "45%" }], [2, { anchor_text: "Q4" }]]),
+ *   showAnchorText: true,
+ * });
+ * // Returns: "Revenue grew 45% 45% in Q4 Q4."
+ * ```
+ */
+declare function replaceDeferredMarkers(text: string, options?: {
+    /** Map of citation IDs to their data */
+    citationMap?: Map<number, CitationData>;
+    /** Whether to show the anchor text after the marker */
+    showAnchorText?: boolean;
+    /** Custom replacement function */
+    replacer?: (id: number, data?: CitationData) => string;
+}): string;
+/**
+ * Gets all citation marker IDs found in a text.
+ *
+ * @param text - The text to scan for [N] markers
+ * @returns Array of citation IDs in order of appearance
+ */
+declare function getCitationMarkerIds(text: string): number[];
+
 interface ReplaceCitationsOptions {
     /**
-     * If true, leaves the key_span text behind when removing citations.
+     * If true, leaves the anchor_text text behind when removing citations.
      * @default false
      */
-    leaveKeySpanBehind?: boolean;
+    leaveAnchorTextBehind?: boolean;
     /**
      * Map of citation keys to verification results.
      * Used to determine verification status for each citation.
@@ -120,12 +245,12 @@ declare const getVerificationTextIndicator: (verification: Verification | null |
  * // Remove all citations
  * const clean = replaceCitations(llmOutput);
  *
- * // Leave key_span text behind
- * const withKeySpans = replaceCitations(llmOutput, { leaveKeySpanBehind: true });
+ * // Leave anchor_text text behind
+ * const withAnchorTexts = replaceCitations(llmOutput, { leaveAnchorTextBehind: true });
  *
  * // Show verification status indicators
  * const withStatus = replaceCitations(llmOutput, {
- *   leaveKeySpanBehind: true,
+ *   leaveAnchorTextBehind: true,
  *   verifications: verificationMap,
  *   showVerificationStatus: true,
  * });
@@ -133,13 +258,9 @@ declare const getVerificationTextIndicator: (verification: Verification | null |
  * ```
  */
 declare const replaceCitations: (markdownWithCitations: string, options?: ReplaceCitationsOptions) => string;
-/**
- * @deprecated Use `replaceCitations` instead. This function is kept for backward compatibility.
- */
-declare const removeCitations: (markdownWithCitations: string, leaveKeySpanBehind?: boolean) => string;
 declare const removePageNumberMetadata: (pageText: string) => string;
 declare const removeLineIdMetadata: (pageText: string) => string;
-declare const getCitationPageNumber: (startPageKey?: string | null) => number | null;
+declare const getCitationPageNumber: (startPageId?: string | null) => number | null;
 declare const normalizeCitations: (response: string) => string;
 
 declare const isGeminiGarbage: (content: string) => boolean;
@@ -156,4 +277,4 @@ declare function cleanRepeatingLastSentence(text: string): string;
  */
 declare function sha1Hash(data: string | any): string;
 
-export { Citation, CitationStatus, type ReplaceCitationsOptions, Verification, cleanRepeatingLastSentence, getAllCitationsFromLlmOutput, getCitationPageNumber, getCitationStatus, getVerificationTextIndicator, groupCitationsByAttachmentId, groupCitationsByAttachmentIdObject, isGeminiGarbage, normalizeCitations, parseCitation, removeCitations, removeLineIdMetadata, removePageNumberMetadata, replaceCitations, sha1Hash };
+export { Citation, CitationData, CitationStatus, ParsedCitationResponse, type ReplaceCitationsOptions, Verification, cleanRepeatingLastSentence, deferredCitationToCitation, extractVisibleText, getAllCitationsFromDeferredResponse, getAllCitationsFromLlmOutput, getCitationMarkerIds, getCitationPageNumber, getCitationStatus, getVerificationTextIndicator, groupCitationsByAttachmentId, groupCitationsByAttachmentIdObject, hasDeferredCitations, isGeminiGarbage, normalizeCitations, parseCitation, parseDeferredCitationResponse, removeLineIdMetadata, removePageNumberMetadata, replaceCitations, replaceDeferredMarkers, sha1Hash };