@kedataindo/docflow-core 0.0.32 → 0.0.33

package/dist/index.d.cts

@@ -4,6 +4,8 @@ import { IndexeddbPersistence } from 'y-indexeddb';
 import { WebrtcProvider } from 'y-webrtc';
 import { WebsocketProvider } from 'y-websocket';
 import * as Y from 'yjs';
+import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDraftFn } from './index-BsIFJXPk.cjs';
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, h as AIProvider, i as AIProviderFactory, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, o as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from './index-BsIFJXPk.cjs';
 import { PaginationPlusOptions } from 'tiptap-pagination-plus';
 export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
 import { PluginKey } from '@tiptap/pm/state';
@@ -109,204 +111,6 @@ interface CollaborationSetup {
 declare function createCollaboration(options: CollaborationOptions): CollaborationSetup;
 declare function collaborationExtensions(options: CollaborationOptions | CollaborationSetup): AnyExtension[];
 
-/**
- * Injectable ports — the narrow interfaces through which the library reaches
- * host-provided backend capabilities (storage, persistence, …). The library
- * declares them; the host app implements them. See docs/LIBRARY_CONTRACT.md.
- */
-interface ImageUploadResult {
-    /** Resolved URL/href the host stored the file at. */
-    src: string;
-    alt?: string;
-    title?: string;
-}
-/**
- * Host-supplied image upload handler. Called with the file picked by the user;
- * resolves to the stored location to insert into the document. Reject to abort
- * the insert (the failure is logged, nothing is inserted).
- */
-type ImageUploadHandler = (file: File) => Promise<ImageUploadResult>;
-/** CSL-JSON name (see https://citeproc-js.readthedocs.io/csl-json/). */
-interface CslName {
-    family?: string;
-    given?: string;
-    literal?: string;
-}
-/** CSL-JSON date. */
-interface CslDate {
-    'date-parts'?: number[][];
-    raw?: string;
-    literal?: string;
-}
-/**
- * A CSL-JSON item — the structured source metadata citeproc-js consumes.
- * Nodes store only `{ sourceId, locator }`; all rendered text is derived from
- * this data by the citation engine (never persisted in the document).
- */
-interface CslItemData {
-    id: string;
-    type: string;
-    title?: string;
-    author?: CslName[];
-    editor?: CslName[];
-    issued?: CslDate;
-    'container-title'?: string;
-    publisher?: string;
-    'publisher-place'?: string;
-    page?: string;
-    volume?: string;
-    issue?: string;
-    DOI?: string;
-    URL?: string;
-    ISBN?: string;
-    abstract?: string;
-    [k: string]: unknown;
-}
-/**
- * Host-supplied citation port. The library never fetches sources itself — the
- * host owns the reference library and injects CSL-JSON through this port,
- * mirroring the `onImageUpload` injection pattern.
- */
-interface CitationPort {
-    /** CSL-JSON provider — a snapshot array or a getter for live data. */
-    sources: CslItemData[] | (() => CslItemData[]);
-    /** Active CSL style id (e.g. 'chicago-notes-bibliography'). */
-    style?: string;
-    /**
-     * Called when the user inserts a citation: the host opens its source
-     * picker and resolves with the chosen source id (null = cancelled).
-     */
-    onSourceRequest?: () => Promise<string | null>;
-    /**
-     * Called when the set of cited source ids changes, so the host can update
-     * its embedded per-document source snapshot.
-     */
-    onSourcesChange?: (ids: string[]) => void;
-    /**
-     * Optional importer (Phase 6C-2): resolve a DOI/URL into a new persisted
-     * source via the host's backend (CrossRef lookup). Returns the created
-     * (or deduplicated) source, null on failure.
-     */
-    onImportDoi?: (doi: string) => Promise<CslItemData | null>;
-    /**
-     * Optional importer (Phase 6C-3): parse + persist a BibTeX/RIS document
-     * via the host's backend. Returns the imported sources and how many
-     * entries failed.
-     */
-    onImportBibliography?: (payload: {
-        format: 'bibtex' | 'ris';
-        text: string;
-    }) => Promise<{
-        imported: CslItemData[];
-        failed: number;
-    }>;
-}
-
-/**
- * The library's only knowledge of LLMs (pluggable AI provider — issue #119).
- *
- * `AIProvider` is a thin transport: one prompt in, a stream of events out.
- * The library imports only this type — never an implementation. Hosts plug in
- * `openaiCompatibleProvider` (the default we ship) or their own class wrapping
- * an agent SDK, a proxy, or an in-process model. Agent orchestration, tool
- * calling, RAG, and multi-turn memory live behind the host's endpoint, not in
- * the library. See docs/plans/PLUGGABLE_AI_PROVIDER.md §4.1.
- */
-type StreamEvent = {
-    type: 'delta';
-    text: string;
-} | {
-    type: 'done';
-    stopReason?: string;
-} | {
-    type: 'error';
-    error: Error;
-};
-interface AICompleteRequest {
-    system?: string;
-    prompt: string;
-    signal?: AbortSignal;
-}
-interface AIProvider {
-    complete(req: AICompleteRequest): AsyncIterable<StreamEvent>;
-}
-
-/**
- * Shared AI action types (Phase 7; pluggable AI provider — issue #119).
- *
- * The library (aiPlugin) is provider-agnostic: it never names a URL or holds a
- * key. The host injects `aiStream` / `aiDraft` via `EditorOptions` — either a
- * hand-written function or `toAIStreamFn(openaiCompatibleProvider({...}))`
- * (see ./provider.ts, ./openaiCompatibleProvider.ts).
- */
-
-/**
- * Factory shape for hosts that hand the library a provider object rather than
- * a plain function (plan §4.2). `toAIStreamFn` adapts an `AIProvider` to the
- * `AIStreamFn` port, so both shapes are accepted at the boundary.
- */
-type AIProviderFactory = (config: {
-    signal?: AbortSignal;
-}) => AIProvider;
-type AIAction = 'rewrite' | 'summarize' | 'grammar' | 'tone' | 'translate' | 'expand' | 'shorten' | 'generate' | 'chat' | 'draft';
-interface AIActionRequest {
-    action: AIAction;
-    /** Selected text (7B). */
-    selection?: string;
-    /** Bounded surrounding text — never the whole document. */
-    context?: {
-        before: string;
-        after: string;
-    };
-    /** User instruction (/ai prompt, chat message, tone target, target language). */
-    prompt?: string;
-    /** For doc-aware chat / RAG scoping. */
-    documentId?: string;
-    options?: Record<string, unknown>;
-}
-/**
- * The app implements this and injects it; the library never knows the URL.
- * Yields streamed text chunks in order; stops at end of stream, throws on error.
- */
-type AIStreamFn = (req: AIActionRequest, signal: AbortSignal) => AsyncIterable<string>;
-/** One entry in the citation table carried by the SSE `done` event (§3.4). */
-interface AIDraftCitation {
-    /** 1-based index matching a `[n]` marker in the streamed text. */
-    ref: number;
-    /** `Source._id` string — the library maps markers through this table. */
-    sourceId: string;
-    /** "first author family + year" tag, e.g. "Doe (2024)". */
-    label: string;
-}
-/**
- * Events yielded by `aiDraft` (§3.5). The `done` event carries the citation
- * table; the `error` event does NOT (the bug-hunter carry-forward — the client
- * treats BOTH `done` and `error` as terminal; Insert is enabled only on `done`).
- */
-type AIDraftEvent = {
-    type: 'delta';
-    text: string;
-} | {
-    type: 'done';
-    citations: AIDraftCitation[];
-} | {
-    type: 'error';
-    message: string;
-};
-/**
- * The app implements this and injects it; the library never knows the URL.
- * Mirrors `AIStreamFn` but yields richer `AIDraftEvent`s (carries the citation
- * table on the terminal `done` event). Injected exactly like `aiStream`.
- */
-type AIDraftFn = (req: {
-    prompt: string;
-    context?: {
-        before: string;
-        after: string;
-    };
-    k?: number;
-}, signal: AbortSignal) => AsyncIterable<AIDraftEvent>;
-
 /**
  * Lightweight client-side performance monitor (debug overlay).
  *
@@ -566,118 +370,4 @@ declare class SubdocumentProvider {
     destroy(): void;
 }
 
-declare function toAIStreamFn(provider: AIProvider): AIStreamFn;
-
-/**
- * Per-action prompt assembly (pluggable AI provider — issue #119).
- *
- * Ported from the Phase 7 server proxy (`apps/server/src/ai/context.ts`) so
- * the browser can call the LLM directly: the selection + BOUNDED surrounding
- * text is sent — never the whole document (cost + privacy). Untrusted document
- * text stays in the user prompt; instructions live in the system prompt
- * (prompt-injection hygiene).
- */
-
-/** Max characters of surrounding context sent on each side of the selection. */
-declare const CONTEXT_CHAR_CAP = 1500;
-/** Last `CONTEXT_CHAR_CAP` chars of the preceding text (nearest context wins). */
-declare function trimContextBefore(text: string): string;
-/** First `CONTEXT_CHAR_CAP` chars of the following text. */
-declare function trimContextAfter(text: string): string;
-/**
- * Assemble the per-action system prompt + user prompt from a bounded request.
- * `draft` is rejected: RAG-cited drafting goes through the `aiDraft` port,
- * which owns its grounded-prompt assembly (Phase 7E).
- */
-declare function buildAIPrompt(req: AIActionRequest): {
-    system: string;
-    prompt: string;
-};
-
-/**
- * Where the AI provider's config (base URL + credentials + model) lives —
- * the host decides (pluggable AI provider — issue #119, plan §4.4).
- *
- * The URL and the key are a pair and travel together. The library ships three
- * reference implementations; hosts may write their own (e.g. keyed per-tenant
- * in their own backend). No URL is hardcoded anywhere — `httpKeyStorage`
- * receives its endpoints from the host, keeping the library backend-agnostic
- * (docs/LIBRARY_CONTRACT.md rule 3).
- */
-type Auth = {
-    type: 'bearer';
-    apiKey: string;
-} | {
-    type: 'header';
-    name: string;
-    value: string;
-} | {
-    type: 'none';
-};
-interface AIConfig {
-    baseUrl: string;
-    auth: Auth;
-    model: string;
-    /**
-     * Who may receive this config in their browser (issue #126).
-     * - `shared` (default): any authenticated user gets it via GET and calls
-     *   the LLM browser-direct — the #119 model.
-     * - `admin-only`: only tenant admins get it; everyone else must complete
-     *   through the server's `/api/ai/complete` proxy so the key never leaves
-     *   the server.
-     */
-    visibility?: 'shared' | 'admin-only';
-}
-interface KeyStorage {
-    get(): Promise<AIConfig | null>;
-    set(value: AIConfig): Promise<void>;
-    clear(): Promise<void>;
-}
-/** In-memory storage — for tests and SSR (no persistence). */
-declare function memoryKeyStorage(initial?: AIConfig | null): KeyStorage;
-declare const LOCAL_STORAGE_KEY = "docflow:ai-config";
-/**
- * Browser `localStorage` persistence — for embedded apps that want the config
- * kept client-side. Note: this stores AI *credentials*, not document data, so
- * it is the host's deliberate choice, not a library persistence leak.
- */
-declare function localStorageKeyStorage(key?: string, storage?: Storage): KeyStorage;
-interface HttpKeyStorageUrls {
-    /** GET → 200 with the AIConfig JSON body, or 404 when unset. */
-    getUrl: string;
-    /** POST with the AIConfig JSON body. */
-    setUrl: string;
-    /** DELETE to clear. */
-    deleteUrl: string;
-    /** Optional fetch override (tests, custom credentials mode). Defaults to global fetch. */
-    fetchImpl?: typeof fetch;
-}
-/**
- * Server-backed storage — for our SaaS web app (`/api/ai/config`) and any
- * embedded app that wants credentials kept on its own backend. Endpoints are
- * host-supplied; the library never names a path.
- */
-declare function httpKeyStorage(urls: HttpKeyStorageUrls): KeyStorage;
-
-/**
- * Default `AIProvider` implementation (pluggable AI provider — issue #119,
- * plan §4.3): OpenAI-shaped `POST {baseUrl}/chat/completions` with SSE
- * streaming. Covers OpenAI, Azure-style gateways, Ollama, vLLM, and most
- * OpenAI-compatible proxies.
- *
- * Cancellation-safe: closing the async iterator early (e.g. the user accepts
- * or cancels mid-stream) aborts the in-flight `fetch`; an aborted `req.signal`
- * ends the stream silently rather than yielding an error event.
- */
-
-interface OpenAICompatibleConfig {
-    /** Base URL of the OpenAI-compatible endpoint, e.g. `https://api.openai.com/v1`. */
-    baseUrl: string;
-    auth: Auth;
-    model: string;
-    /** Prepended to every call's system prompt so hosts don't repeat it. */
-    systemPrompt?: string;
-}
-declare function openaiCompatibleProvider(config: OpenAICompatibleConfig): AIProvider;
-
-export { type AIAction, type AIActionRequest, type AICompleteRequest, type AIConfig, type AIDraftCitation, type AIDraftEvent, type AIDraftFn, type AIProvider, type AIProviderFactory, type AIStreamFn, type Auth, type AwarenessState, BlockAttributesExtension, CONTEXT_CHAR_CAP, type CitationPort, type CollaborationOptions, type CollaborationSetup, type CslDate, type CslItemData, type CslName, type DocsEditor, type DocsEditorPlugin, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontSizeExtension, type HttpKeyStorageUrls, type ImageUploadHandler, type ImageUploadResult, type KeyStorage, LOCAL_STORAGE_KEY, type MonitorMetric, type OpenAICompatibleConfig, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type StreamEvent, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, buildAIPrompt, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, findMatches, getSearchState, httpKeyStorage, localStorageKeyStorage, memoryKeyStorage, openaiCompatibleProvider, replaceAll, replaceCurrent, resolveAction, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery, toAIStreamFn, trimContextAfter, trimContextBefore };
+export { AIDraftFn, AIStreamFn, type AwarenessState, BlockAttributesExtension, CitationPort, type CollaborationOptions, type CollaborationSetup, type DocsEditor, type DocsEditorPlugin, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontSizeExtension, ImageUploadHandler, type MonitorMetric, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, findMatches, getSearchState, replaceAll, replaceCurrent, resolveAction, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery };

package/dist/index.d.ts

@@ -4,6 +4,8 @@ import { IndexeddbPersistence } from 'y-indexeddb';
 import { WebrtcProvider } from 'y-webrtc';
 import { WebsocketProvider } from 'y-websocket';
 import * as Y from 'yjs';
+import { I as ImageUploadHandler, C as CitationPort, A as AIStreamFn, a as AIDraftFn } from './index-BsIFJXPk.js';
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, h as AIProvider, i as AIProviderFactory, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, o as ImageUploadResult, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from './index-BsIFJXPk.js';
 import { PaginationPlusOptions } from 'tiptap-pagination-plus';
 export { PAGE_SIZES, PageSize, PaginationPlus, PaginationPlusOptions } from 'tiptap-pagination-plus';
 import { PluginKey } from '@tiptap/pm/state';
@@ -109,204 +111,6 @@ interface CollaborationSetup {
 declare function createCollaboration(options: CollaborationOptions): CollaborationSetup;
 declare function collaborationExtensions(options: CollaborationOptions | CollaborationSetup): AnyExtension[];
 
-/**
- * Injectable ports — the narrow interfaces through which the library reaches
- * host-provided backend capabilities (storage, persistence, …). The library
- * declares them; the host app implements them. See docs/LIBRARY_CONTRACT.md.
- */
-interface ImageUploadResult {
-    /** Resolved URL/href the host stored the file at. */
-    src: string;
-    alt?: string;
-    title?: string;
-}
-/**
- * Host-supplied image upload handler. Called with the file picked by the user;
- * resolves to the stored location to insert into the document. Reject to abort
- * the insert (the failure is logged, nothing is inserted).
- */
-type ImageUploadHandler = (file: File) => Promise<ImageUploadResult>;
-/** CSL-JSON name (see https://citeproc-js.readthedocs.io/csl-json/). */
-interface CslName {
-    family?: string;
-    given?: string;
-    literal?: string;
-}
-/** CSL-JSON date. */
-interface CslDate {
-    'date-parts'?: number[][];
-    raw?: string;
-    literal?: string;
-}
-/**
- * A CSL-JSON item — the structured source metadata citeproc-js consumes.
- * Nodes store only `{ sourceId, locator }`; all rendered text is derived from
- * this data by the citation engine (never persisted in the document).
- */
-interface CslItemData {
-    id: string;
-    type: string;
-    title?: string;
-    author?: CslName[];
-    editor?: CslName[];
-    issued?: CslDate;
-    'container-title'?: string;
-    publisher?: string;
-    'publisher-place'?: string;
-    page?: string;
-    volume?: string;
-    issue?: string;
-    DOI?: string;
-    URL?: string;
-    ISBN?: string;
-    abstract?: string;
-    [k: string]: unknown;
-}
-/**
- * Host-supplied citation port. The library never fetches sources itself — the
- * host owns the reference library and injects CSL-JSON through this port,
- * mirroring the `onImageUpload` injection pattern.
- */
-interface CitationPort {
-    /** CSL-JSON provider — a snapshot array or a getter for live data. */
-    sources: CslItemData[] | (() => CslItemData[]);
-    /** Active CSL style id (e.g. 'chicago-notes-bibliography'). */
-    style?: string;
-    /**
-     * Called when the user inserts a citation: the host opens its source
-     * picker and resolves with the chosen source id (null = cancelled).
-     */
-    onSourceRequest?: () => Promise<string | null>;
-    /**
-     * Called when the set of cited source ids changes, so the host can update
-     * its embedded per-document source snapshot.
-     */
-    onSourcesChange?: (ids: string[]) => void;
-    /**
-     * Optional importer (Phase 6C-2): resolve a DOI/URL into a new persisted
-     * source via the host's backend (CrossRef lookup). Returns the created
-     * (or deduplicated) source, null on failure.
-     */
-    onImportDoi?: (doi: string) => Promise<CslItemData | null>;
-    /**
-     * Optional importer (Phase 6C-3): parse + persist a BibTeX/RIS document
-     * via the host's backend. Returns the imported sources and how many
-     * entries failed.
-     */
-    onImportBibliography?: (payload: {
-        format: 'bibtex' | 'ris';
-        text: string;
-    }) => Promise<{
-        imported: CslItemData[];
-        failed: number;
-    }>;
-}
-
-/**
- * The library's only knowledge of LLMs (pluggable AI provider — issue #119).
- *
- * `AIProvider` is a thin transport: one prompt in, a stream of events out.
- * The library imports only this type — never an implementation. Hosts plug in
- * `openaiCompatibleProvider` (the default we ship) or their own class wrapping
- * an agent SDK, a proxy, or an in-process model. Agent orchestration, tool
- * calling, RAG, and multi-turn memory live behind the host's endpoint, not in
- * the library. See docs/plans/PLUGGABLE_AI_PROVIDER.md §4.1.
- */
-type StreamEvent = {
-    type: 'delta';
-    text: string;
-} | {
-    type: 'done';
-    stopReason?: string;
-} | {
-    type: 'error';
-    error: Error;
-};
-interface AICompleteRequest {
-    system?: string;
-    prompt: string;
-    signal?: AbortSignal;
-}
-interface AIProvider {
-    complete(req: AICompleteRequest): AsyncIterable<StreamEvent>;
-}
-
-/**
- * Shared AI action types (Phase 7; pluggable AI provider — issue #119).
- *
- * The library (aiPlugin) is provider-agnostic: it never names a URL or holds a
- * key. The host injects `aiStream` / `aiDraft` via `EditorOptions` — either a
- * hand-written function or `toAIStreamFn(openaiCompatibleProvider({...}))`
- * (see ./provider.ts, ./openaiCompatibleProvider.ts).
- */
-
-/**
- * Factory shape for hosts that hand the library a provider object rather than
- * a plain function (plan §4.2). `toAIStreamFn` adapts an `AIProvider` to the
- * `AIStreamFn` port, so both shapes are accepted at the boundary.
- */
-type AIProviderFactory = (config: {
-    signal?: AbortSignal;
-}) => AIProvider;
-type AIAction = 'rewrite' | 'summarize' | 'grammar' | 'tone' | 'translate' | 'expand' | 'shorten' | 'generate' | 'chat' | 'draft';
-interface AIActionRequest {
-    action: AIAction;
-    /** Selected text (7B). */
-    selection?: string;
-    /** Bounded surrounding text — never the whole document. */
-    context?: {
-        before: string;
-        after: string;
-    };
-    /** User instruction (/ai prompt, chat message, tone target, target language). */
-    prompt?: string;
-    /** For doc-aware chat / RAG scoping. */
-    documentId?: string;
-    options?: Record<string, unknown>;
-}
-/**
- * The app implements this and injects it; the library never knows the URL.
- * Yields streamed text chunks in order; stops at end of stream, throws on error.
- */
-type AIStreamFn = (req: AIActionRequest, signal: AbortSignal) => AsyncIterable<string>;
-/** One entry in the citation table carried by the SSE `done` event (§3.4). */
-interface AIDraftCitation {
-    /** 1-based index matching a `[n]` marker in the streamed text. */
-    ref: number;
-    /** `Source._id` string — the library maps markers through this table. */
-    sourceId: string;
-    /** "first author family + year" tag, e.g. "Doe (2024)". */
-    label: string;
-}
-/**
- * Events yielded by `aiDraft` (§3.5). The `done` event carries the citation
- * table; the `error` event does NOT (the bug-hunter carry-forward — the client
- * treats BOTH `done` and `error` as terminal; Insert is enabled only on `done`).
- */
-type AIDraftEvent = {
-    type: 'delta';
-    text: string;
-} | {
-    type: 'done';
-    citations: AIDraftCitation[];
-} | {
-    type: 'error';
-    message: string;
-};
-/**
- * The app implements this and injects it; the library never knows the URL.
- * Mirrors `AIStreamFn` but yields richer `AIDraftEvent`s (carries the citation
- * table on the terminal `done` event). Injected exactly like `aiStream`.
- */
-type AIDraftFn = (req: {
-    prompt: string;
-    context?: {
-        before: string;
-        after: string;
-    };
-    k?: number;
-}, signal: AbortSignal) => AsyncIterable<AIDraftEvent>;
-
 /**
  * Lightweight client-side performance monitor (debug overlay).
  *
@@ -566,118 +370,4 @@ declare class SubdocumentProvider {
     destroy(): void;
 }
 
-declare function toAIStreamFn(provider: AIProvider): AIStreamFn;
-
-/**
- * Per-action prompt assembly (pluggable AI provider — issue #119).
- *
- * Ported from the Phase 7 server proxy (`apps/server/src/ai/context.ts`) so
- * the browser can call the LLM directly: the selection + BOUNDED surrounding
- * text is sent — never the whole document (cost + privacy). Untrusted document
- * text stays in the user prompt; instructions live in the system prompt
- * (prompt-injection hygiene).
- */
-
-/** Max characters of surrounding context sent on each side of the selection. */
-declare const CONTEXT_CHAR_CAP = 1500;
-/** Last `CONTEXT_CHAR_CAP` chars of the preceding text (nearest context wins). */
-declare function trimContextBefore(text: string): string;
-/** First `CONTEXT_CHAR_CAP` chars of the following text. */
-declare function trimContextAfter(text: string): string;
-/**
- * Assemble the per-action system prompt + user prompt from a bounded request.
- * `draft` is rejected: RAG-cited drafting goes through the `aiDraft` port,
- * which owns its grounded-prompt assembly (Phase 7E).
- */
-declare function buildAIPrompt(req: AIActionRequest): {
-    system: string;
-    prompt: string;
-};
-
-/**
- * Where the AI provider's config (base URL + credentials + model) lives —
- * the host decides (pluggable AI provider — issue #119, plan §4.4).
- *
- * The URL and the key are a pair and travel together. The library ships three
- * reference implementations; hosts may write their own (e.g. keyed per-tenant
- * in their own backend). No URL is hardcoded anywhere — `httpKeyStorage`
- * receives its endpoints from the host, keeping the library backend-agnostic
- * (docs/LIBRARY_CONTRACT.md rule 3).
- */
-type Auth = {
-    type: 'bearer';
-    apiKey: string;
-} | {
-    type: 'header';
-    name: string;
-    value: string;
-} | {
-    type: 'none';
-};
-interface AIConfig {
-    baseUrl: string;
-    auth: Auth;
-    model: string;
-    /**
-     * Who may receive this config in their browser (issue #126).
-     * - `shared` (default): any authenticated user gets it via GET and calls
-     *   the LLM browser-direct — the #119 model.
-     * - `admin-only`: only tenant admins get it; everyone else must complete
-     *   through the server's `/api/ai/complete` proxy so the key never leaves
-     *   the server.
-     */
-    visibility?: 'shared' | 'admin-only';
-}
-interface KeyStorage {
-    get(): Promise<AIConfig | null>;
-    set(value: AIConfig): Promise<void>;
-    clear(): Promise<void>;
-}
-/** In-memory storage — for tests and SSR (no persistence). */
-declare function memoryKeyStorage(initial?: AIConfig | null): KeyStorage;
-declare const LOCAL_STORAGE_KEY = "docflow:ai-config";
-/**
- * Browser `localStorage` persistence — for embedded apps that want the config
- * kept client-side. Note: this stores AI *credentials*, not document data, so
- * it is the host's deliberate choice, not a library persistence leak.
- */
-declare function localStorageKeyStorage(key?: string, storage?: Storage): KeyStorage;
-interface HttpKeyStorageUrls {
-    /** GET → 200 with the AIConfig JSON body, or 404 when unset. */
-    getUrl: string;
-    /** POST with the AIConfig JSON body. */
-    setUrl: string;
-    /** DELETE to clear. */
-    deleteUrl: string;
-    /** Optional fetch override (tests, custom credentials mode). Defaults to global fetch. */
-    fetchImpl?: typeof fetch;
-}
-/**
- * Server-backed storage — for our SaaS web app (`/api/ai/config`) and any
- * embedded app that wants credentials kept on its own backend. Endpoints are
- * host-supplied; the library never names a path.
- */
-declare function httpKeyStorage(urls: HttpKeyStorageUrls): KeyStorage;
-
-/**
- * Default `AIProvider` implementation (pluggable AI provider — issue #119,
- * plan §4.3): OpenAI-shaped `POST {baseUrl}/chat/completions` with SSE
- * streaming. Covers OpenAI, Azure-style gateways, Ollama, vLLM, and most
- * OpenAI-compatible proxies.
- *
- * Cancellation-safe: closing the async iterator early (e.g. the user accepts
- * or cancels mid-stream) aborts the in-flight `fetch`; an aborted `req.signal`
- * ends the stream silently rather than yielding an error event.
- */
-
-interface OpenAICompatibleConfig {
-    /** Base URL of the OpenAI-compatible endpoint, e.g. `https://api.openai.com/v1`. */
-    baseUrl: string;
-    auth: Auth;
-    model: string;
-    /** Prepended to every call's system prompt so hosts don't repeat it. */
-    systemPrompt?: string;
-}
-declare function openaiCompatibleProvider(config: OpenAICompatibleConfig): AIProvider;
-
-export { type AIAction, type AIActionRequest, type AICompleteRequest, type AIConfig, type AIDraftCitation, type AIDraftEvent, type AIDraftFn, type AIProvider, type AIProviderFactory, type AIStreamFn, type Auth, type AwarenessState, BlockAttributesExtension, CONTEXT_CHAR_CAP, type CitationPort, type CollaborationOptions, type CollaborationSetup, type CslDate, type CslItemData, type CslName, type DocsEditor, type DocsEditorPlugin, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontSizeExtension, type HttpKeyStorageUrls, type ImageUploadHandler, type ImageUploadResult, type KeyStorage, LOCAL_STORAGE_KEY, type MonitorMetric, type OpenAICompatibleConfig, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type StreamEvent, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, buildAIPrompt, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, findMatches, getSearchState, httpKeyStorage, localStorageKeyStorage, memoryKeyStorage, openaiCompatibleProvider, replaceAll, replaceCurrent, resolveAction, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery, toAIStreamFn, trimContextAfter, trimContextBefore };
+export { AIDraftFn, AIStreamFn, type AwarenessState, BlockAttributesExtension, CitationPort, type CollaborationOptions, type CollaborationSetup, type DocsEditor, type DocsEditorPlugin, EditorContextExtension, type EditorContextOptions, type EditorOptions, FontSizeExtension, ImageUploadHandler, type MonitorMetric, PerformanceMonitor, type PerformanceMonitorOptions, SearchAndReplaceExtension, type SearchMatch, type SearchState, type SlashCommand, type SubdocState, SubdocumentProvider, type SubdocumentProviderOptions, type ToolbarItem, clearSearch, collaborationExtensions, collectExtensions, createActionMap, createCollaboration, createEditor, createPerformanceMonitor, definePlugin, findMatches, getSearchState, replaceAll, replaceCurrent, resolveAction, sanitizePastedHTML, searchAndReplaceKey, searchNext, searchPrev, setSearchQuery };