@xom11/whiteboard 0.25.0 → 0.27.0

package/dist/graph-2d.mjs

@@ -1,15 +1,16 @@
 "use client";
-export { graph2dStamp } from './chunk-ESVPQWHX.mjs';
-import './chunk-CJBLJUWG.mjs';
+export { graph2dStamp } from './chunk-4ETJ4CDY.mjs';
+import './chunk-CXHNVYMD.mjs';
 import './chunk-O4WIZFRQ.mjs';
-import './chunk-M42TGYT6.mjs';
-import './chunk-I24QOHPU.mjs';
-import './chunk-AYSFWUPK.mjs';
+import './chunk-BNBOIDO5.mjs';
+import './chunk-HLAOGXEK.mjs';
+import './chunk-SZDAS7LK.mjs';
 import './chunk-ICR4CVOE.mjs';
-import './chunk-REIJZDVZ.mjs';
+import './chunk-D5LWSN2Y.mjs';
 import './chunk-IHUFOV7L.mjs';
 import './chunk-73Q7ADVL.mjs';
 import './chunk-B4NJJZFR.mjs';
 import './chunk-5UTGXHLJ.mjs';
+import './chunk-J5LGTIGS.mjs';
 //# sourceMappingURL=graph-2d.mjs.map
 //# sourceMappingURL=graph-2d.mjs.map

package/dist/handleExtractProblem-C-U5KluK.d.mts

@@ -0,0 +1,158 @@
+interface ProviderTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /** Anthropic prompt caching — local provider để 0. */
+    cacheReadTokens?: number;
+    /** Anthropic prompt caching — local provider để 0. */
+    cacheCreationTokens?: number;
+}
+interface ProviderRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    /**
+     * JSON Schema mà provider phải honor để constrain output. Anthropic → wrap
+     * thành tool input_schema. Ollama → pass thẳng vào `format` (v0.5+).
+     */
+    schema: Record<string, unknown>;
+    /** Provider-specific model id (vd "gemma3:4b", "claude-opus-4-7"). */
+    model: string;
+    /** Token cap cho response. */
+    maxTokens: number;
+    signal?: AbortSignal;
+    /**
+     * Optional callback nhận text chunk khi provider stream incremental output.
+     * Provider không stream được (Anthropic tool_use, Claude CLI) → không gọi.
+     * Caller dùng để cập nhật UI progress (token count).
+     */
+    onToken?: (chunk: string) => void;
+}
+type ProviderOutput = {
+    kind: 'json';
+    data: unknown;
+    usage?: ProviderTokenUsage;
+} | {
+    kind: 'error';
+    message: string;
+    status?: number;
+};
+interface AIProvider {
+    /** Tên định danh ("anthropic", "ollama", ...). */
+    readonly name: string;
+    /** Default model id khi caller không truyền. */
+    readonly defaultModel: string;
+    call(req: ProviderRequest): Promise<ProviderOutput>;
+    /**
+     * Optional vision capability. Provider không impl → caller check undefined
+     * trước khi gọi (façade trả error code='unsupported').
+     */
+    extractText?(req: VisionRequest): Promise<ProviderOutput>;
+}
+interface ImagePart {
+    /** Whitelist 3 format browser decode native được. */
+    mediaType: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** Base64 không bao gồm "data:image/...;base64," prefix. */
+    base64: string;
+}
+interface VisionRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    /** JSON Schema constraint output. */
+    schema: Record<string, unknown>;
+    /** v1 luôn length 1; array để forward-compat multi-image. */
+    images: ImagePart[];
+    /** Optional override; nếu omit, provider tự chọn vision-capable default. */
+    model?: string;
+    maxTokens: number;
+    signal?: AbortSignal;
+}
+
+interface SelectProviderOptions {
+    /** Provider instance dùng trực tiếp (override mọi env). */
+    provider?: AIProvider;
+    /** Anthropic API key. Khi truyền → auto chọn AnthropicProvider. */
+    apiKey?: string;
+    /** Anthropic prompt-caching, default true (chỉ áp dụng provider Anthropic). */
+    enableCaching?: boolean;
+    /** Ollama endpoint override. */
+    ollamaBaseUrl?: string;
+    /** Ollama model override (vd "gemma3:1b"). */
+    ollamaDefaultModel?: string;
+    /** Claude CLI binary path override (default 'claude'). */
+    claudeCliBin?: string;
+    /** Claude CLI default model override. */
+    claudeCliDefaultModel?: string;
+    /** Claude CLI max budget USD per call override. */
+    claudeCliMaxBudgetUsd?: number;
+    /** Claude Agent SDK OAuth token (subscription path). Fallback env CLAUDE_CODE_OAUTH_TOKEN. */
+    claudeAgentSdkOauthToken?: string;
+    /** Claude Agent SDK default model. */
+    claudeAgentSdkDefaultModel?: string;
+    /** Test env: env vars getter (default process.env). */
+    env?: Record<string, string | undefined>;
+}
+declare function selectProvider(opts?: SelectProviderOptions): AIProvider;
+
+type VisionEngine = 'tesseract' | 'llm';
+interface ExtractProblemOptions extends SelectProviderOptions {
+    /** OCR engine. Default 'tesseract' (client-side, không cần network). */
+    engine?: VisionEngine;
+    /** Tesseract language (chỉ áp dụng khi engine='tesseract'). Default 'vie+eng'. */
+    tesseractLang?: string;
+    /** Override model OCR cho LLM path. Priority cao hơn env. */
+    visionModel?: string;
+    /** Max tokens cho LLM response. Default 1024. */
+    maxTokens?: number;
+    /** Env getter override (cho test). */
+    env?: Record<string, string | undefined>;
+    signal?: AbortSignal;
+}
+interface ExtractProblemSuccess {
+    ok: true;
+    text: string;
+    confidence: 'high' | 'low';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface ExtractProblemFailure {
+    ok: false;
+    reason: 'not-math' | 'unreadable' | 'empty' | 'unsupported';
+    message: string;
+}
+type ExtractProblemOutcome = ExtractProblemSuccess | ExtractProblemFailure;
+/** Pick vision model theo priority: opts → env → provider.defaultModel. */
+declare function pickVisionModel(providerDefault: string, opts: {
+    visionModel?: string;
+}, env: Record<string, string | undefined>): string;
+declare function extractProblemFromImage(image: ImagePart, opts?: ExtractProblemOptions): Promise<ExtractProblemOutcome>;
+
+interface HandleExtractProblemOptions extends ExtractProblemOptions {
+}
+type ExtractUiResult = {
+    kind: 'success';
+    text: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+} | {
+    kind: 'low-confidence';
+    text: string;
+    warning: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+} | {
+    kind: 'refused';
+    reason: 'not-math';
+    message: string;
+} | {
+    kind: 'error';
+    code: 'network' | 'unsupported' | 'unexpected' | 'empty';
+    message: string;
+};
+declare function handleExtractProblem(image: ImagePart, opts?: HandleExtractProblemOptions): Promise<ExtractUiResult>;
+
+export { type AIProvider as A, type ExtractUiResult as E, type HandleExtractProblemOptions as H, type ImagePart as I, type ProviderRequest as P, type SelectProviderOptions as S, type VisionRequest as V, type ProviderOutput as a, type ExtractProblemFailure as b, type ExtractProblemOptions as c, type ExtractProblemOutcome as d, type ExtractProblemSuccess as e, type ProviderTokenUsage as f, extractProblemFromImage as g, handleExtractProblem as h, pickVisionModel as p, selectProvider as s };

package/dist/handleExtractProblem-C-U5KluK.d.ts

@@ -0,0 +1,158 @@
+interface ProviderTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /** Anthropic prompt caching — local provider để 0. */
+    cacheReadTokens?: number;
+    /** Anthropic prompt caching — local provider để 0. */
+    cacheCreationTokens?: number;
+}
+interface ProviderRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    /**
+     * JSON Schema mà provider phải honor để constrain output. Anthropic → wrap
+     * thành tool input_schema. Ollama → pass thẳng vào `format` (v0.5+).
+     */
+    schema: Record<string, unknown>;
+    /** Provider-specific model id (vd "gemma3:4b", "claude-opus-4-7"). */
+    model: string;
+    /** Token cap cho response. */
+    maxTokens: number;
+    signal?: AbortSignal;
+    /**
+     * Optional callback nhận text chunk khi provider stream incremental output.
+     * Provider không stream được (Anthropic tool_use, Claude CLI) → không gọi.
+     * Caller dùng để cập nhật UI progress (token count).
+     */
+    onToken?: (chunk: string) => void;
+}
+type ProviderOutput = {
+    kind: 'json';
+    data: unknown;
+    usage?: ProviderTokenUsage;
+} | {
+    kind: 'error';
+    message: string;
+    status?: number;
+};
+interface AIProvider {
+    /** Tên định danh ("anthropic", "ollama", ...). */
+    readonly name: string;
+    /** Default model id khi caller không truyền. */
+    readonly defaultModel: string;
+    call(req: ProviderRequest): Promise<ProviderOutput>;
+    /**
+     * Optional vision capability. Provider không impl → caller check undefined
+     * trước khi gọi (façade trả error code='unsupported').
+     */
+    extractText?(req: VisionRequest): Promise<ProviderOutput>;
+}
+interface ImagePart {
+    /** Whitelist 3 format browser decode native được. */
+    mediaType: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** Base64 không bao gồm "data:image/...;base64," prefix. */
+    base64: string;
+}
+interface VisionRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    /** JSON Schema constraint output. */
+    schema: Record<string, unknown>;
+    /** v1 luôn length 1; array để forward-compat multi-image. */
+    images: ImagePart[];
+    /** Optional override; nếu omit, provider tự chọn vision-capable default. */
+    model?: string;
+    maxTokens: number;
+    signal?: AbortSignal;
+}
+
+interface SelectProviderOptions {
+    /** Provider instance dùng trực tiếp (override mọi env). */
+    provider?: AIProvider;
+    /** Anthropic API key. Khi truyền → auto chọn AnthropicProvider. */
+    apiKey?: string;
+    /** Anthropic prompt-caching, default true (chỉ áp dụng provider Anthropic). */
+    enableCaching?: boolean;
+    /** Ollama endpoint override. */
+    ollamaBaseUrl?: string;
+    /** Ollama model override (vd "gemma3:1b"). */
+    ollamaDefaultModel?: string;
+    /** Claude CLI binary path override (default 'claude'). */
+    claudeCliBin?: string;
+    /** Claude CLI default model override. */
+    claudeCliDefaultModel?: string;
+    /** Claude CLI max budget USD per call override. */
+    claudeCliMaxBudgetUsd?: number;
+    /** Claude Agent SDK OAuth token (subscription path). Fallback env CLAUDE_CODE_OAUTH_TOKEN. */
+    claudeAgentSdkOauthToken?: string;
+    /** Claude Agent SDK default model. */
+    claudeAgentSdkDefaultModel?: string;
+    /** Test env: env vars getter (default process.env). */
+    env?: Record<string, string | undefined>;
+}
+declare function selectProvider(opts?: SelectProviderOptions): AIProvider;
+
+type VisionEngine = 'tesseract' | 'llm';
+interface ExtractProblemOptions extends SelectProviderOptions {
+    /** OCR engine. Default 'tesseract' (client-side, không cần network). */
+    engine?: VisionEngine;
+    /** Tesseract language (chỉ áp dụng khi engine='tesseract'). Default 'vie+eng'. */
+    tesseractLang?: string;
+    /** Override model OCR cho LLM path. Priority cao hơn env. */
+    visionModel?: string;
+    /** Max tokens cho LLM response. Default 1024. */
+    maxTokens?: number;
+    /** Env getter override (cho test). */
+    env?: Record<string, string | undefined>;
+    signal?: AbortSignal;
+}
+interface ExtractProblemSuccess {
+    ok: true;
+    text: string;
+    confidence: 'high' | 'low';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface ExtractProblemFailure {
+    ok: false;
+    reason: 'not-math' | 'unreadable' | 'empty' | 'unsupported';
+    message: string;
+}
+type ExtractProblemOutcome = ExtractProblemSuccess | ExtractProblemFailure;
+/** Pick vision model theo priority: opts → env → provider.defaultModel. */
+declare function pickVisionModel(providerDefault: string, opts: {
+    visionModel?: string;
+}, env: Record<string, string | undefined>): string;
+declare function extractProblemFromImage(image: ImagePart, opts?: ExtractProblemOptions): Promise<ExtractProblemOutcome>;
+
+interface HandleExtractProblemOptions extends ExtractProblemOptions {
+}
+type ExtractUiResult = {
+    kind: 'success';
+    text: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+} | {
+    kind: 'low-confidence';
+    text: string;
+    warning: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+} | {
+    kind: 'refused';
+    reason: 'not-math';
+    message: string;
+} | {
+    kind: 'error';
+    code: 'network' | 'unsupported' | 'unexpected' | 'empty';
+    message: string;
+};
+declare function handleExtractProblem(image: ImagePart, opts?: HandleExtractProblemOptions): Promise<ExtractUiResult>;
+
+export { type AIProvider as A, type ExtractUiResult as E, type HandleExtractProblemOptions as H, type ImagePart as I, type ProviderRequest as P, type SelectProviderOptions as S, type VisionRequest as V, type ProviderOutput as a, type ExtractProblemFailure as b, type ExtractProblemOptions as c, type ExtractProblemOutcome as d, type ExtractProblemSuccess as e, type ProviderTokenUsage as f, extractProblemFromImage as g, handleExtractProblem as h, pickVisionModel as p, selectProvider as s };