@arbidocs/react 0.4.9 → 0.4.10

package/dist/index.d.cts

@@ -12,6 +12,7 @@ import { ab as EntityIconComponent } from './index-4WLy-KDK.cjs';
 export { A as AgentBadge, a as AiMarkdown, b as Avatar, c as AvatarFallback, d as AvatarImage, B as BASE_COLORS, e as Badge, f as BadgeProps, g as Button, h as ButtonProps, C as Card, i as CardContent, j as CardDescription, k as CardFooter, l as CardHeader, m as CardProps, n as CardTitle, o as Checkbox, p as Collapsible, q as CollapsibleContent, r as CollapsibleTrigger, s as Command, t as CommandDialog, u as CommandEmpty, v as CommandGroup, w as CommandInput, x as CommandItem, y as CommandList, z as CommandSeparator, D as CommandShortcut, E as Dialog, F as DialogClose, G as DialogContent, H as DialogDescription, I as DialogFooter, J as DialogHeader, K as DialogOverlay, L as DialogPortal, M as DialogPresentation, N as DialogTitle, O as DialogTrigger, P as DictateContextValue, Q as DictateProvider, R as DocumentCard, S as DocumentCardProps, T as DocumentEntity, U as DocumentEntityProps, V as DocumentLike, W as DropdownMenu, X as DropdownMenuCheckboxItem, Y as DropdownMenuContent, Z as DropdownMenuGroup, _ as DropdownMenuItem, $ as DropdownMenuLabel, a0 as DropdownMenuPortal, a1 as DropdownMenuRadioGroup, a2 as DropdownMenuRadioItem, a3 as DropdownMenuSeparator, a4 as DropdownMenuShortcut, a5 as DropdownMenuSub, a6 as DropdownMenuSubContent, a7 as DropdownMenuSubTrigger, a8 as DropdownMenuTrigger, a9 as ENTITY_MAPPINGS, aa as EntityIcon, ac as EntityPill, ad as EntityRegistryOverride, ae as EntityType, af as HoverCard, ag as HoverCardContent, ah as HoverCardTrigger, ai as IconToggle, aj as IconToggleProps, ak as Input, al as InputProps, am as Label, an as MarkMenu, ao as MarkMenuItem, ap as MarkMenuProps, aq as MarkdownRenderer, ar as MarkdownRendererProps, as as MarkdownStreamingContext, at as NEUTRAL_GRAY, au as PLACEHOLDER_COLOR, av as PassageCard, aw as PassageCardProps, ax as Popover, ay as PopoverAnchor, az as PopoverContent, aA as PopoverTrigger, aB as PresenceDisplayStatus, aC as PresenceLabel, aD as Progress, aE as ProjectEntity, aF as ProjectEntityProps, aG as ProjectRelation, aH as RadioGroup, aI as RadioGroupItem, aJ as Rag, aK as RagDot, aL as RelevanceDot, aM as ScrollArea, aN as ScrollBar, aO as Select, aP as SelectContent, aQ as SelectGroup, aR as SelectItem, aS as SelectLabel, aT as SelectScrollDownButton, aU as SelectScrollUpButton, aV as SelectSeparator, aW as SelectTrigger, aX as SelectValue, aY as Separator, aZ as Slider, a_ as StatusBadgeComponent, a$ as StatusBadgeProps, b0 as StatusPill, b1 as StatusPillProps, b2 as StatusVariant, b3 as Switch, b4 as TAG_TYPE_ICONS, b5 as TAG_TYPE_LABELS, b6 as Table, b7 as TableBody, b8 as TableCaption, b9 as TableCell, ba as TableFooter, bb as TableHead, bc as TableHeader, bd as TableRow, be as Tabs, bf as TabsContent, bg as TabsList, bh as TabsTrigger, bi as TagEntity, bj as TagEntityProps, bk as TagLike, bl as Textarea, bm as TextareaProps, bn as Toggle, bo as ToggleGroup, bp as ToggleGroupItem, bq as Tooltip, br as TooltipContent, bs as TooltipProvider, bt as TooltipTrigger, bu as UserEntity, bv as UserEntityProps, bw as UserMenu, bx as UserMenuItem, by as UserMenuProps, bz as UserMenuStatus, bA as VISIBILITY_ICONS, bB as VisibilityIcon, bC as badgeVariants, bD as buttonVariants, bE as cardVariants, bF as closeOpenEmphasis, bG as cn, bH as configureEntityRegistry, bI as configureRagLabels, bJ as configureStatusRegistry, bK as getDocIcon, bL as getEntityColor, bM as getEntityColorStyles, bN as getEntityIcon, bO as getEntityLabel, bP as getStatusVariant, bQ as getTagTypeIcon, bR as getTagTypeLabel, bS as getWorkspaceColor, bT as markdownBaseComponents, bU as normalizeCitationMarkup, bV as splitMarkdownBlocks, bW as toggleVariants, bX as trimOpenCitation } from './index-4WLy-KDK.cjs';
 import { LucideIcon } from 'lucide-react';
 import { Components } from 'react-markdown';
+export { c as cleanDraftMarkdown, p as promoteBoldTitle, r as repairParsedTitle, s as stripAgentPreamble, u as unescapeMarkdown, a as unwrapCitationLinks } from './stored-markdown-DMwFzWhc.cjs';
 export { A as AppNotification, D as DEFAULT_NOTIFY_TONE, N as NotificationBell, a as NotificationBellProps, b as NotificationBellTriggerState, c as NotifyOptions, d as NotifyVariant, T as Toaster, n as notify, s as seedNotifications, e as selectUnread, u as useNotify } from './index-CcbVSNSP.cjs';
 import { ColDef } from 'ag-grid-community';
 export { ToasterProps, toast } from 'sonner';

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { ab as EntityIconComponent } from './index-4WLy-KDK.js';
 export { A as AgentBadge, a as AiMarkdown, b as Avatar, c as AvatarFallback, d as AvatarImage, B as BASE_COLORS, e as Badge, f as BadgeProps, g as Button, h as ButtonProps, C as Card, i as CardContent, j as CardDescription, k as CardFooter, l as CardHeader, m as CardProps, n as CardTitle, o as Checkbox, p as Collapsible, q as CollapsibleContent, r as CollapsibleTrigger, s as Command, t as CommandDialog, u as CommandEmpty, v as CommandGroup, w as CommandInput, x as CommandItem, y as CommandList, z as CommandSeparator, D as CommandShortcut, E as Dialog, F as DialogClose, G as DialogContent, H as DialogDescription, I as DialogFooter, J as DialogHeader, K as DialogOverlay, L as DialogPortal, M as DialogPresentation, N as DialogTitle, O as DialogTrigger, P as DictateContextValue, Q as DictateProvider, R as DocumentCard, S as DocumentCardProps, T as DocumentEntity, U as DocumentEntityProps, V as DocumentLike, W as DropdownMenu, X as DropdownMenuCheckboxItem, Y as DropdownMenuContent, Z as DropdownMenuGroup, _ as DropdownMenuItem, $ as DropdownMenuLabel, a0 as DropdownMenuPortal, a1 as DropdownMenuRadioGroup, a2 as DropdownMenuRadioItem, a3 as DropdownMenuSeparator, a4 as DropdownMenuShortcut, a5 as DropdownMenuSub, a6 as DropdownMenuSubContent, a7 as DropdownMenuSubTrigger, a8 as DropdownMenuTrigger, a9 as ENTITY_MAPPINGS, aa as EntityIcon, ac as EntityPill, ad as EntityRegistryOverride, ae as EntityType, af as HoverCard, ag as HoverCardContent, ah as HoverCardTrigger, ai as IconToggle, aj as IconToggleProps, ak as Input, al as InputProps, am as Label, an as MarkMenu, ao as MarkMenuItem, ap as MarkMenuProps, aq as MarkdownRenderer, ar as MarkdownRendererProps, as as MarkdownStreamingContext, at as NEUTRAL_GRAY, au as PLACEHOLDER_COLOR, av as PassageCard, aw as PassageCardProps, ax as Popover, ay as PopoverAnchor, az as PopoverContent, aA as PopoverTrigger, aB as PresenceDisplayStatus, aC as PresenceLabel, aD as Progress, aE as ProjectEntity, aF as ProjectEntityProps, aG as ProjectRelation, aH as RadioGroup, aI as RadioGroupItem, aJ as Rag, aK as RagDot, aL as RelevanceDot, aM as ScrollArea, aN as ScrollBar, aO as Select, aP as SelectContent, aQ as SelectGroup, aR as SelectItem, aS as SelectLabel, aT as SelectScrollDownButton, aU as SelectScrollUpButton, aV as SelectSeparator, aW as SelectTrigger, aX as SelectValue, aY as Separator, aZ as Slider, a_ as StatusBadgeComponent, a$ as StatusBadgeProps, b0 as StatusPill, b1 as StatusPillProps, b2 as StatusVariant, b3 as Switch, b4 as TAG_TYPE_ICONS, b5 as TAG_TYPE_LABELS, b6 as Table, b7 as TableBody, b8 as TableCaption, b9 as TableCell, ba as TableFooter, bb as TableHead, bc as TableHeader, bd as TableRow, be as Tabs, bf as TabsContent, bg as TabsList, bh as TabsTrigger, bi as TagEntity, bj as TagEntityProps, bk as TagLike, bl as Textarea, bm as TextareaProps, bn as Toggle, bo as ToggleGroup, bp as ToggleGroupItem, bq as Tooltip, br as TooltipContent, bs as TooltipProvider, bt as TooltipTrigger, bu as UserEntity, bv as UserEntityProps, bw as UserMenu, bx as UserMenuItem, by as UserMenuProps, bz as UserMenuStatus, bA as VISIBILITY_ICONS, bB as VisibilityIcon, bC as badgeVariants, bD as buttonVariants, bE as cardVariants, bF as closeOpenEmphasis, bG as cn, bH as configureEntityRegistry, bI as configureRagLabels, bJ as configureStatusRegistry, bK as getDocIcon, bL as getEntityColor, bM as getEntityColorStyles, bN as getEntityIcon, bO as getEntityLabel, bP as getStatusVariant, bQ as getTagTypeIcon, bR as getTagTypeLabel, bS as getWorkspaceColor, bT as markdownBaseComponents, bU as normalizeCitationMarkup, bV as splitMarkdownBlocks, bW as toggleVariants, bX as trimOpenCitation } from './index-4WLy-KDK.js';
 import { LucideIcon } from 'lucide-react';
 import { Components } from 'react-markdown';
+export { c as cleanDraftMarkdown, p as promoteBoldTitle, r as repairParsedTitle, s as stripAgentPreamble, u as unescapeMarkdown, a as unwrapCitationLinks } from './stored-markdown-DMwFzWhc.js';
 export { A as AppNotification, D as DEFAULT_NOTIFY_TONE, N as NotificationBell, a as NotificationBellProps, b as NotificationBellTriggerState, c as NotifyOptions, d as NotifyVariant, T as Toaster, n as notify, s as seedNotifications, e as selectUnread, u as useNotify } from './index-CcbVSNSP.js';
 import { ColDef } from 'ag-grid-community';
 export { ToasterProps, toast } from 'sonner';

package/dist/index.js

@@ -1,18 +1,18 @@
-import { useDocuments, useConversations, useAssistantQuery, useConversationThreads, arbiQueryKeys, useWorkspaces, useParsedDocument, useTags, useActivity, useThumbnails } from './chunk-R5SR7R6W.js';
-export { DEFAULT_USD_PER_CREDIT, arbiQueryKeys, creditsToUsd, formatCredits, isUsageMetered, useActivity, useAgents, useAssistantQuery, useConfigs, useConversationThreads, useConversations, useDeleteAgents, useDocuments, useFacts, useHealth, useParsedDocument, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useSessions, useTags, useTasks, useThumbnails, useUserUsageToday, useWorkspaces } from './chunk-R5SR7R6W.js';
-import { MarkMenu, AiMarkdown, Card, Button, Badge, TagEntity, Input, FILE_TYPE_COLORS, getEntityIcon, UserEntity, getEntityColorStyles, AgentBadge, Textarea, Label, Slider, Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter, DocumentEntity, DocumentCard, useAudioRecorder, MicWaveformIndicator, IconToggle, classifyMediaError, formatElapsed, PassageCard } from './chunk-RTULVZOS.js';
-export { AgentBadge, AiMarkdown, ArbiBotHeadIcon, AudIcon, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DictateProvider, DocumentCard, DocumentEntity, ENTITY_MAPPINGS, EmlIcon, EntityIcon, EntityPill, FILE_TYPE_COLORS, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, ImgIcon, InlineMicButton, Input, Label, MarkMenu, MicRecordingOverlay, MicWaveformIndicator, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, PdfIcon, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceLabel, Progress, ProjectEntity, RadioGroup, RadioGroupItem, RagDot, RelevanceDot, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusPill, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, UserMenu, VISIBILITY_ICONS, VidIcon, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, configureEntityRegistry, configureRagLabels, configureStatusRegistry, formatElapsed, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, toggleVariants, useAudioRecorder } from './chunk-RTULVZOS.js';
-import { normalizeCitationMarkup, MarkdownRenderer } from './chunk-TGGQGFS3.js';
-export { MarkdownRenderer, MarkdownStreamingContext, closeOpenEmphasis, markdownBaseComponents, normalizeCitationMarkup, splitMarkdownBlocks, trimOpenCitation } from './chunk-TGGQGFS3.js';
 import { formatRelativeTime } from './chunk-FSMIN5VX.js';
 export { DEFAULT_NOTIFY_TONE, NotificationBell, Toaster, formatRelativeTime, notify, seedNotifications, selectUnread, toast, useNotify } from './chunk-FSMIN5VX.js';
+import { useDocuments, useConversations, useAssistantQuery, useConversationThreads, arbiQueryKeys, useWorkspaces, useParsedDocument, useTags, useActivity, useThumbnails } from './chunk-UV5ZEUNV.js';
+export { DEFAULT_USD_PER_CREDIT, arbiQueryKeys, cleanDraftMarkdown, creditsToUsd, formatCredits, isUsageMetered, promoteBoldTitle, repairParsedTitle, stripAgentPreamble, unescapeMarkdown, unwrapCitationLinks, useActivity, useAgents, useAssistantQuery, useConfigs, useConversationThreads, useConversations, useDeleteAgents, useDocuments, useFacts, useHealth, useParsedDocument, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useSessions, useTags, useTasks, useThumbnails, useUserUsageToday, useWorkspaces } from './chunk-UV5ZEUNV.js';
+import { AudioViewer, ImageViewer, VideoViewer } from './chunk-HDCRPPBW.js';
+import { useArbi } from './chunk-J4MX2W4H.js';
+export { ArbiProvider, useArbi } from './chunk-J4MX2W4H.js';
+import { MarkMenu, AiMarkdown, Card, Button, Badge, TagEntity, Input, FILE_TYPE_COLORS, getEntityIcon, UserEntity, getEntityColorStyles, AgentBadge, Textarea, Label, Slider, Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter, DocumentEntity, DocumentCard, useAudioRecorder, MicWaveformIndicator, IconToggle, classifyMediaError, formatElapsed, PassageCard } from './chunk-NVMQLJI4.js';
+export { AgentBadge, AiMarkdown, ArbiBotHeadIcon, AudIcon, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DictateProvider, DocumentCard, DocumentEntity, ENTITY_MAPPINGS, EmlIcon, EntityIcon, EntityPill, FILE_TYPE_COLORS, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, ImgIcon, InlineMicButton, Input, Label, MarkMenu, MicRecordingOverlay, MicWaveformIndicator, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, PdfIcon, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceLabel, Progress, ProjectEntity, RadioGroup, RadioGroupItem, RagDot, RelevanceDot, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusPill, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, UserMenu, VISIBILITY_ICONS, VidIcon, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, configureEntityRegistry, configureRagLabels, configureStatusRegistry, formatElapsed, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, toggleVariants, useAudioRecorder } from './chunk-NVMQLJI4.js';
 import { ScrollArea, DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator } from './chunk-N5SVBDLC.js';
 export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ScrollArea, ScrollBar } from './chunk-N5SVBDLC.js';
+import { normalizeCitationMarkup, MarkdownRenderer } from './chunk-TGGQGFS3.js';
+export { MarkdownRenderer, MarkdownStreamingContext, closeOpenEmphasis, markdownBaseComponents, normalizeCitationMarkup, splitMarkdownBlocks, trimOpenCitation } from './chunk-TGGQGFS3.js';
 import { cn } from './chunk-SN5YV6FF.js';
 export { cn } from './chunk-SN5YV6FF.js';
-import { AudioViewer, ImageViewer, VideoViewer } from './chunk-HDCRPPBW.js';
-import { useArbi } from './chunk-J4MX2W4H.js';
-export { ArbiProvider, useArbi } from './chunk-J4MX2W4H.js';
 import React, { memo, useState, createContext, useMemo, useCallback, useEffect, useRef, useLayoutEffect, useContext, useId, Fragment as Fragment$1 } from 'react';
 import { resolveCitations, summarizeCitations, connectWithReconnect } from '@arbidocs/sdk/browser';
 export { Arbi, ArbiError } from '@arbidocs/sdk/browser';

package/dist/stored-markdown-DMwFzWhc.d.cts

@@ -0,0 +1,75 @@
+/**
+ * Helpers for markdown that is STORED (an agent's draft saved as an artifact, then read back from
+ * the backend's parse). Pure and SDK-free; they sit next to `normalizeCitationMarkup`, which they
+ * build on.
+ *
+ * Two directions:
+ *
+ *  - Going in (`cleanDraftMarkdown` = `unwrapCitationLinks` + `stripAgentPreamble` +
+ *    `promoteBoldTitle`): a streamed draft carries citation links, `(*Source: ...*)` notes and
+ *    sometimes narration before the document. A stored letter should hold only the letter.
+ *  - Coming out (`unescapeMarkdown`): the backend's parse of a stored `.md` returns the text with
+ *    markdown punctuation backslash-escaped (`**Fees.**` comes back as `\*\*Fees\.\*\*`).
+ */
+/**
+ * Undo the backend's escaping of a markdown artifact: `\*\*Scope\.\*\*` becomes `**Scope.**`.
+ *
+ * THE RULE. Apply this ONLY to text of an artifact that was stored from markdown (an agent draft
+ * or an edited version, always uploaded as `.md`): for those the parser escapes every markdown
+ * punctuation character, including the backslash itself, so removing one level of escaping is the
+ * exact inverse (an author's literal `\*` is stored as `\\\*` and comes back as `\*`). Do not
+ * apply it to a PDF or Word parse, where a backslash is just a character.
+ *
+ * Details:
+ *  - Only a backslash followed by markdown punctuation (``\ ` * _ { } [ ] ( ) # + - . ! | > ~ <``)
+ *    is removed; `\n`, `C:\temp` and a trailing backslash are left alone.
+ *  - Pairs are read left to right, so `\\*` is an escaped backslash followed by a bare `*`.
+ *  - Fenced code blocks are never touched (the parser does not escape inside them).
+ *  - Inline code spans: the parser DOES escape `*` and `_` there (`` `a*b` `` comes back as
+ *    `` `a\*b` ``), so only `\*` and `\_` are undone inside a span; any other backslash in code
+ *    (`` `re\.x` ``) is a literal and stays.
+ */
+declare function unescapeMarkdown(text: string): string;
+/**
+ * The parser also mangles the TITLE of a stored markdown document (seen on a real backend): the
+ * first heading comes back doubled (`## # Title`) or alone inside a code fence
+ * (a fence, `# Title`, a fence). Both are repaired, on the first non-blank line only, so a code
+ * block or heading later in the text is never touched. Like `unescapeMarkdown`, apply it only to
+ * artifacts stored from markdown.
+ */
+declare function repairParsedTitle(text: string): string;
+/**
+ * Text for storage from text that carries citations: `normalizeCitationMarkup` first (it hoists
+ * list, heading and bold tokens out of the link so unwrapping cannot orphan half of a `**` pair),
+ * then `[text](#cite-N)` becomes `text`, `(*Source: ...*)` notes are dropped, and a bold or
+ * heading marker that lost its partner is repaired. Fenced code is left alone.
+ */
+declare function unwrapCitationLinks(text: string): string;
+/**
+ * Cut what an agent wrote BEFORE the document, when it is narration.
+ *
+ * HEURISTIC (conservative, so a document is never trimmed by mistake). The document is taken to
+ * start at the first `#` heading, or, when there is none, at the first whole-line bold title within
+ * the first 15 lines. The text before it is removed only when ALL of these hold:
+ *  1. it is short (at most 1200 characters);
+ *  2. it is plain prose: no list, table, quote, code or heading;
+ *  3. it reads like the agent talking: first person ("I'll draft ..."), "Here is ...", "Per the
+ *     instructions", "Based on the ..." and the like.
+ * A document that opens with a dateline, an address or any text that does not trip rule 3 is kept
+ * whole. A horizontal rule left at the end of the cut text is dropped with it.
+ */
+declare function stripAgentPreamble(text: string): string;
+/**
+ * Make the document's title a real heading: a first line that is a bold title (`**Letter**`, even
+ * with stray inner `**`) becomes `# Letter`. A document that already opens with a heading is left
+ * alone.
+ */
+declare function promoteBoldTitle(text: string): string;
+/**
+ * Everything a streamed draft needs before it is stored as the artifact's first version:
+ * `unwrapCitationLinks`, `stripAgentPreamble`, `promoteBoldTitle`, clean headings, collapsed blank
+ * runs, trimmed.
+ */
+declare function cleanDraftMarkdown(raw: string): string;
+
+export { unwrapCitationLinks as a, cleanDraftMarkdown as c, promoteBoldTitle as p, repairParsedTitle as r, stripAgentPreamble as s, unescapeMarkdown as u };

package/dist/stored-markdown-DMwFzWhc.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Helpers for markdown that is STORED (an agent's draft saved as an artifact, then read back from
+ * the backend's parse). Pure and SDK-free; they sit next to `normalizeCitationMarkup`, which they
+ * build on.
+ *
+ * Two directions:
+ *
+ *  - Going in (`cleanDraftMarkdown` = `unwrapCitationLinks` + `stripAgentPreamble` +
+ *    `promoteBoldTitle`): a streamed draft carries citation links, `(*Source: ...*)` notes and
+ *    sometimes narration before the document. A stored letter should hold only the letter.
+ *  - Coming out (`unescapeMarkdown`): the backend's parse of a stored `.md` returns the text with
+ *    markdown punctuation backslash-escaped (`**Fees.**` comes back as `\*\*Fees\.\*\*`).
+ */
+/**
+ * Undo the backend's escaping of a markdown artifact: `\*\*Scope\.\*\*` becomes `**Scope.**`.
+ *
+ * THE RULE. Apply this ONLY to text of an artifact that was stored from markdown (an agent draft
+ * or an edited version, always uploaded as `.md`): for those the parser escapes every markdown
+ * punctuation character, including the backslash itself, so removing one level of escaping is the
+ * exact inverse (an author's literal `\*` is stored as `\\\*` and comes back as `\*`). Do not
+ * apply it to a PDF or Word parse, where a backslash is just a character.
+ *
+ * Details:
+ *  - Only a backslash followed by markdown punctuation (``\ ` * _ { } [ ] ( ) # + - . ! | > ~ <``)
+ *    is removed; `\n`, `C:\temp` and a trailing backslash are left alone.
+ *  - Pairs are read left to right, so `\\*` is an escaped backslash followed by a bare `*`.
+ *  - Fenced code blocks are never touched (the parser does not escape inside them).
+ *  - Inline code spans: the parser DOES escape `*` and `_` there (`` `a*b` `` comes back as
+ *    `` `a\*b` ``), so only `\*` and `\_` are undone inside a span; any other backslash in code
+ *    (`` `re\.x` ``) is a literal and stays.
+ */
+declare function unescapeMarkdown(text: string): string;
+/**
+ * The parser also mangles the TITLE of a stored markdown document (seen on a real backend): the
+ * first heading comes back doubled (`## # Title`) or alone inside a code fence
+ * (a fence, `# Title`, a fence). Both are repaired, on the first non-blank line only, so a code
+ * block or heading later in the text is never touched. Like `unescapeMarkdown`, apply it only to
+ * artifacts stored from markdown.
+ */
+declare function repairParsedTitle(text: string): string;
+/**
+ * Text for storage from text that carries citations: `normalizeCitationMarkup` first (it hoists
+ * list, heading and bold tokens out of the link so unwrapping cannot orphan half of a `**` pair),
+ * then `[text](#cite-N)` becomes `text`, `(*Source: ...*)` notes are dropped, and a bold or
+ * heading marker that lost its partner is repaired. Fenced code is left alone.
+ */
+declare function unwrapCitationLinks(text: string): string;
+/**
+ * Cut what an agent wrote BEFORE the document, when it is narration.
+ *
+ * HEURISTIC (conservative, so a document is never trimmed by mistake). The document is taken to
+ * start at the first `#` heading, or, when there is none, at the first whole-line bold title within
+ * the first 15 lines. The text before it is removed only when ALL of these hold:
+ *  1. it is short (at most 1200 characters);
+ *  2. it is plain prose: no list, table, quote, code or heading;
+ *  3. it reads like the agent talking: first person ("I'll draft ..."), "Here is ...", "Per the
+ *     instructions", "Based on the ..." and the like.
+ * A document that opens with a dateline, an address or any text that does not trip rule 3 is kept
+ * whole. A horizontal rule left at the end of the cut text is dropped with it.
+ */
+declare function stripAgentPreamble(text: string): string;
+/**
+ * Make the document's title a real heading: a first line that is a bold title (`**Letter**`, even
+ * with stray inner `**`) becomes `# Letter`. A document that already opens with a heading is left
+ * alone.
+ */
+declare function promoteBoldTitle(text: string): string;
+/**
+ * Everything a streamed draft needs before it is stored as the artifact's first version:
+ * `unwrapCitationLinks`, `stripAgentPreamble`, `promoteBoldTitle`, clean headings, collapsed blank
+ * runs, trimmed.
+ */
+declare function cleanDraftMarkdown(raw: string): string;
+
+export { unwrapCitationLinks as a, cleanDraftMarkdown as c, promoteBoldTitle as p, repairParsedTitle as r, stripAgentPreamble as s, unescapeMarkdown as u };