@4djs/assistant 0.0.0 → 0.1.0

package/dist/core/interactive-tools/choices.d.ts

@@ -0,0 +1,22 @@
+import type { ClientToolDefinition } from "../llm-types.js";
+export declare const REQUEST_CHOICES_TOOL = "request_choices";
+export type ChoiceOption = {
+    id: string;
+    label: string;
+    description?: string;
+};
+export type ChoicesToolArgs = {
+    message: string;
+    options: ChoiceOption[];
+    allowMultiple: boolean;
+    minSelections: number;
+    maxSelections?: number;
+    submitLabel: string;
+};
+export type ChoicesToolResult = {
+    selected: string[];
+    cancelled?: boolean;
+};
+export declare const CHOICES_TOOL: ClientToolDefinition;
+export declare function parseChoicesArgs(args: Record<string, unknown>): ChoicesToolArgs;
+//# sourceMappingURL=choices.d.ts.map

package/dist/core/interactive-tools/choices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choices.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/choices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,oBAuD1B,CAAC;AAEF,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,eAAe,CAuEjB"}

package/dist/core/interactive-tools/confirmation.d.ts

@@ -0,0 +1,15 @@
+import type { ClientToolDefinition } from "../llm-types.js";
+export declare const REQUEST_CONFIRMATION_TOOL = "request_confirmation";
+export type ConfirmationToolArgs = {
+    message: string;
+    action?: string;
+    confirmLabel: string;
+    cancelLabel: string;
+};
+export type ConfirmationToolResult = {
+    confirmed: boolean;
+    cancelled?: boolean;
+};
+export declare const CONFIRMATION_TOOL: ClientToolDefinition;
+export declare function parseConfirmationArgs(args: Record<string, unknown>): ConfirmationToolArgs;
+//# sourceMappingURL=confirmation.d.ts.map

package/dist/core/interactive-tools/confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/confirmation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBA4B/B,CAAC;AAEF,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,oBAAoB,CActB"}

package/dist/core/interactive-tools/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const INTERACTIVE_CHAT_TOOL_NAMES: Set<string>;
+export declare const POST_RESPONSE_CHAT_TOOL_NAMES: Set<string>;
+export declare function isInteractiveChatTool(name: string): boolean;
+export declare function isPostResponseChatTool(name: string): boolean;
+export declare function isChatUiTool(name: string): boolean;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/interactive-tools/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,2BAA2B,aAGtC,CAAC;AAEH,eAAO,MAAM,6BAA6B,aAAkC,CAAC;AAE7E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/core/interactive-tools/execute.d.ts

@@ -0,0 +1,11 @@
+import type { ClientToolDefinition } from "../llm-types.js";
+import { type ReplySuggestions } from "./suggestions.js";
+export type ChatInteractiveToolResult = {
+    content: string;
+    postResponse?: ReplySuggestions;
+    isError?: boolean;
+};
+export declare function getChatInteractiveTools(): ClientToolDefinition[];
+export declare function executeChatInteractiveTool(name: string, args: Record<string, unknown>, callId: string, signal?: AbortSignal): Promise<ChatInteractiveToolResult>;
+export declare function shouldTerminateTurnAfterTool(name: string): boolean;
+//# sourceMappingURL=execute.d.ts.map

package/dist/core/interactive-tools/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAc5D,OAAO,EAEN,KAAK,gBAAgB,EAGrB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAgB,uBAAuB,IAAI,oBAAoB,EAAE,CAEhE;AAED,wBAAsB,0BAA0B,CAC/C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,yBAAyB,CAAC,CA4BpC;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE"}

package/dist/core/interactive-tools/index.d.ts

@@ -0,0 +1,7 @@
+export { CHOICES_TOOL, type ChoiceOption, type ChoicesToolArgs, type ChoicesToolResult, parseChoicesArgs, REQUEST_CHOICES_TOOL, } from "./choices.js";
+export { CONFIRMATION_TOOL, type ConfirmationToolArgs, type ConfirmationToolResult, parseConfirmationArgs, REQUEST_CONFIRMATION_TOOL, } from "./confirmation.js";
+export { INTERACTIVE_CHAT_TOOL_NAMES, isChatUiTool, isInteractiveChatTool, isPostResponseChatTool, POST_RESPONSE_CHAT_TOOL_NAMES, } from "./constants.js";
+export { type ChatInteractiveToolResult, executeChatInteractiveTool, getChatInteractiveTools, shouldTerminateTurnAfterTool, } from "./execute.js";
+export { isValidReplySuggestions, parseSuggestRepliesArgs, type ReplySuggestions, SUGGEST_REPLIES_TOOL, SUGGEST_REPLIES_TOOL_DEFINITION, type SuggestRepliesToolResult, } from "./suggestions.js";
+export { rejectAllInteractiveToolWaiters, resolveInteractiveToolResult, waitForInteractiveToolResult, } from "./waiters.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/interactive-tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,yBAAyB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,2BAA2B,EAC3B,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,KAAK,yBAAyB,EAC9B,0BAA0B,EAC1B,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,+BAA+B,EAC/B,KAAK,wBAAwB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,+BAA+B,EAC/B,4BAA4B,EAC5B,4BAA4B,GAC5B,MAAM,cAAc,CAAC"}

package/dist/core/interactive-tools/suggestions.d.ts

@@ -0,0 +1,13 @@
+import type { ClientToolDefinition } from "../llm-types.js";
+export declare const SUGGEST_REPLIES_TOOL = "suggest_replies";
+export type ReplySuggestions = {
+    question: string;
+    suggestions: string[];
+};
+export type SuggestRepliesToolResult = {
+    displayed: true;
+};
+export declare const SUGGEST_REPLIES_TOOL_DEFINITION: ClientToolDefinition;
+export declare function parseSuggestRepliesArgs(args: Record<string, unknown>): ReplySuggestions;
+export declare function isValidReplySuggestions(value: unknown): value is ReplySuggestions;
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/core/interactive-tools/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,oBAyB7C,CAAC;AAEF,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,gBAAgB,CAyBlB;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,gBAAgB,CAe3B"}

package/dist/core/interactive-tools/waiters.d.ts

@@ -0,0 +1,4 @@
+export declare function waitForInteractiveToolResult<T>(callId: string, signal?: AbortSignal): Promise<T>;
+export declare function resolveInteractiveToolResult(callId: string, value: unknown): boolean;
+export declare function rejectAllInteractiveToolWaiters(error: Error): void;
+//# sourceMappingURL=waiters.d.ts.map

package/dist/core/interactive-tools/waiters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiters.d.ts","sourceRoot":"","sources":["../../../src/core/interactive-tools/waiters.ts"],"names":[],"mappings":"AAOA,wBAAgB,4BAA4B,CAAC,CAAC,EAC7C,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACZ,OAAO,CAOT;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAKlE"}

package/dist/core/llm-chat.d.ts

@@ -0,0 +1,96 @@
+import type { ReplySuggestions } from "./interactive-tools/index.js";
+import type { ClientToolDefinition, LlmChatMessage, OpenAiToolCall } from "./llm-types.js";
+import type { AssistantToolDefinition, AssistantToolResult } from "./types.js";
+export declare class LlmNotConfiguredError extends Error {
+    readonly code = "LLM_DISABLED";
+    constructor(message?: string);
+}
+export declare class LlmUpstreamError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status: number, code?: string);
+}
+export interface LlmChatStatus {
+    enabled: boolean;
+    model: string | null;
+    models: string[];
+}
+export declare class ChatAbortedError extends Error {
+    constructor();
+}
+export interface StreamHandlers {
+    turnId: string;
+    onUpdate: (content: string) => void;
+}
+export interface ToolHandlers {
+    onStart: (step: {
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+        callId: string;
+    }) => void;
+    onFinish: (stepId: string, update: {
+        status: "done" | "error";
+        result?: unknown;
+        error?: string;
+    }) => void;
+}
+export interface AgentStepResult {
+    assistantMessages: Array<{
+        id?: string;
+        content: string;
+        toolCall?: {
+            name: string;
+            args: Record<string, unknown>;
+        };
+        isError?: boolean;
+        streaming?: boolean;
+    }>;
+    apiMessages: LlmChatMessage[];
+    lastToolResult?: AssistantToolResult;
+}
+export declare function fetchLlmStatus(): Promise<LlmChatStatus>;
+export declare function requestLlmCompletion(input: {
+    messages: LlmChatMessage[];
+    tools?: ClientToolDefinition[];
+    model?: string;
+    systemPrompt?: string;
+    responseFormat?: {
+        type: "json_object";
+    };
+    stream?: StreamHandlers;
+    signal?: AbortSignal;
+}): Promise<{
+    content: string | null;
+    toolCalls: OpenAiToolCall[];
+    model: string;
+}>;
+export declare function runLlmAgent(input: {
+    userMessage: string;
+    history: LlmChatMessage[];
+    tools: AssistantToolDefinition[];
+    model?: string;
+    signal?: AbortSignal;
+    stream?: StreamHandlers;
+    toolHandlers?: ToolHandlers;
+    invokeTool: (name: string, args: Record<string, unknown>) => Promise<AssistantToolResult>;
+    onPostResponseTool?: (suggestions: ReplySuggestions) => void;
+}): Promise<AgentStepResult>;
+/** Drop tool messages that are not preceded by a matching assistant tool_calls entry. */
+export declare function sanitizeLlmMessages(messages: LlmChatMessage[]): LlmChatMessage[];
+export declare function buildLlmHistory(messages: Array<{
+    role: string;
+    content: string;
+    replySuggestions?: ReplySuggestions;
+    activity?: Array<{
+        name: string;
+        args: Record<string, unknown>;
+        error?: string;
+        result?: unknown;
+    }>;
+    toolCall?: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+}>): LlmChatMessage[];
+//# sourceMappingURL=llm-chat.d.ts.map

package/dist/core/llm-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-chat.d.ts","sourceRoot":"","sources":["../../src/core/llm-chat.ts"],"names":[],"mappings":"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"}

package/dist/core/llm-config.d.ts

@@ -0,0 +1,24 @@
+export declare const DEFAULT_LLM_BASE_URL = "https://api.openai.com/v1";
+export declare const DEFAULT_LLM_MODEL = "gpt-4o-mini";
+export declare const DEFAULT_ASSISTANT_SYSTEM_PROMPT = "You are a helpful assistant with access to tools. Use tools when they help answer the user.";
+export interface ResolvedLlmSettings {
+    enabled: boolean;
+    baseUrl: string;
+    apiKey: string | null;
+    model: string;
+    models?: string[];
+    systemPrompt?: string;
+}
+export declare function getFallbackModels(defaultModel: string): string[];
+export declare function resolveRequestModel(requested: string | undefined, config: Pick<ResolvedLlmSettings, "model">): string;
+export declare function buildCompletionsUrl(baseUrl: string): string;
+export declare function buildModelsUrl(baseUrl: string): string;
+export declare function isLocalLlmBaseUrl(baseUrl: string): boolean;
+export declare function isLlmConfigured(settings: Pick<ResolvedLlmSettings, "enabled" | "baseUrl" | "apiKey" | "model">): boolean;
+export declare const LLM_UNAVAILABLE_MESSAGE = "Chat requires an LLM. Open LLM settings to add your provider base URL, model, and API key (optional for local servers).";
+export declare function isLlmUnavailableMessage(message: {
+    content: string;
+    llmSetupRequired?: boolean;
+}): boolean;
+export declare function buildLlmRequestHeaders(apiKey: string | null | undefined): Record<string, string>;
+//# sourceMappingURL=llm-config.d.ts.map

package/dist/core/llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-config.d.ts","sourceRoot":"","sources":["../../src/core/llm-config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,+BAA+B,gGACkD,CAAC;AAW/F,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE;AAED,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GACxC,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAc1D;AAED,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,IAAI,CACb,mBAAmB,EACnB,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAC1C,GACC,OAAO,CAKT;AAED,eAAO,MAAM,uBAAuB,4HACsF,CAAC;AAE3H,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAKV;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB"}

package/dist/core/llm-models.d.ts

@@ -0,0 +1,14 @@
+import { type ResolvedLlmSettings } from "./llm-config.js";
+interface ProviderModelEntry {
+    id?: string;
+}
+interface ProviderModelsResponse {
+    data?: ProviderModelEntry[];
+}
+export declare function fetchProviderModels(config: Pick<ResolvedLlmSettings, "baseUrl" | "apiKey" | "model">): Promise<string[]>;
+export declare function normalizeProviderModels(body: ProviderModelsResponse, defaultModel: string): string[];
+export declare function isChatModel(modelId: string): boolean;
+export declare function mergeModels(defaultModel: string, models: string[]): string[];
+export declare function clearProviderModelCache(): void;
+export {};
+//# sourceMappingURL=llm-models.d.ts.map

package/dist/core/llm-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-models.d.ts","sourceRoot":"","sources":["../../src/core/llm-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,KAAK,mBAAmB,EACxB,MAAM,iBAAiB,CAAC;AAkBzB,UAAU,kBAAkB;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,sBAAsB;IAC/B,IAAI,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5B;AAKD,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,GAC/D,OAAO,CAAC,MAAM,EAAE,CAAC,CAgCnB;AAED,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,YAAY,EAAE,MAAM,GAClB,MAAM,EAAE,CAOV;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI5E;AAED,wBAAgB,uBAAuB,SAEtC"}

package/dist/core/llm-provider.d.ts

@@ -0,0 +1,13 @@
+import { type ResolvedLlmSettings } from "./llm-config.js";
+import type { AssistantLlmConfig } from "./types.js";
+export declare function configureAssistantLlm(config: AssistantLlmConfig): void;
+export declare function resolveAssistantLlmSettings(): Promise<ResolvedLlmSettings>;
+export declare function resetAssistantLlm(): void;
+export declare function testLlmConnection(settings: Pick<ResolvedLlmSettings, "baseUrl" | "apiKey" | "model">): Promise<{
+    ok: true;
+    model: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/core/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../src/core/llm-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAMN,KAAK,mBAAmB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,YAAY,CAAC;AAsB3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,QAQ/D;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAGhF;AAED,wBAAgB,iBAAiB,SAEhC;AAED,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,GACjE,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA+CrE"}

package/dist/core/llm-settings-storage.d.ts

@@ -0,0 +1,47 @@
+import type { AssistantLlmSettings } from "./types.js";
+export declare const DEFAULT_LLM_SETTINGS_STORAGE_KEY = "assistant-llm-settings";
+/** Full LLM configuration persisted in localStorage */
+export interface StoredLlmUserSettings {
+    baseUrl: string;
+    apiKey: string | null;
+    model: string;
+    models: string[];
+    systemPrompt: string;
+}
+export interface LlmSettingsFormValues {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    modelsText: string;
+    systemPrompt: string;
+}
+export type LlmSettingsFormState = LlmSettingsFormValues & {
+    hasStoredApiKey: boolean;
+    defaultSystemPrompt: string;
+};
+export declare function buildDefaultLlmSettings(): AssistantLlmSettings;
+export declare function assistantToStored(settings: AssistantLlmSettings): StoredLlmUserSettings;
+export declare function storedToAssistant(stored: StoredLlmUserSettings): AssistantLlmSettings;
+/** Normalize legacy/partial stored payloads against env defaults */
+export declare function normalizeStoredSettings(raw: unknown, base: AssistantLlmSettings): StoredLlmUserSettings | null;
+export declare function normalizeStoredSystemPrompt(storedPrompt: string, base: AssistantLlmSettings): string;
+export declare function createDefaultStoredSettings(base: AssistantLlmSettings): StoredLlmUserSettings;
+export declare function storedSettingsHaveOverrides(stored: StoredLlmUserSettings, base: AssistantLlmSettings): boolean;
+export declare function mergeLlmSettings(base: AssistantLlmSettings, stored: StoredLlmUserSettings | null): AssistantLlmSettings;
+export declare function isLlmSettingsFormDirty(current: LlmSettingsFormValues, saved: LlmSettingsFormValues): boolean;
+export declare function resolveSelectedModel(storedModel: string, defaultModel: string, availableModels: string[]): string;
+export declare function peekStoredModel(storageKey: string): string | null;
+export declare function persistStoredModelSelection(storageKey: string, model: string): void;
+export declare function migrateLegacyModelStorage(llmSettingsKey: string, legacyModelKey: string | undefined, base: AssistantLlmSettings): void;
+export declare function parseModelsText(text: string): string[];
+export declare function formatModelsText(models: string[] | undefined): string;
+export declare function createLlmSettingsStorage(storageKey: string): {
+    load(base: AssistantLlmSettings): StoredLlmUserSettings | null;
+    save(settings: StoredLlmUserSettings): void;
+    clear(): void;
+    hasStored(): boolean;
+};
+export declare function toStoredSettings(values: LlmSettingsFormValues, existingApiKey: string | null): StoredLlmUserSettings;
+export declare function createLlmSettingsFormState(settings: AssistantLlmSettings, hasStoredApiKey: boolean, defaultSystemPrompt?: string): LlmSettingsFormState;
+export declare function createLlmSettingsFormStateFromStored(stored: StoredLlmUserSettings, defaultSystemPrompt?: string): LlmSettingsFormState;
+//# sourceMappingURL=llm-settings-storage.d.ts.map

package/dist/core/llm-settings-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-settings-storage.d.ts","sourceRoot":"","sources":["../../src/core/llm-settings-storage.ts"],"names":[],"mappings":"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"}

package/dist/core/llm-sse.d.ts

@@ -0,0 +1,13 @@
+import type { OpenAiToolCall } from "./llm-types.js";
+export interface ParsedStreamChunk {
+    contentDelta: string;
+    content: string;
+    toolCalls: OpenAiToolCall[];
+    model: string | null;
+    done: boolean;
+}
+export declare function createStreamParser(): {
+    ingestLine: (line: string) => ParsedStreamChunk | null;
+};
+export declare function readSseStream(body: ReadableStream<Uint8Array>, onChunk: (chunk: ParsedStreamChunk) => void, signal?: AbortSignal): Promise<ParsedStreamChunk>;
+//# sourceMappingURL=llm-sse.d.ts.map

package/dist/core/llm-sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-sse.d.ts","sourceRoot":"","sources":["../../src/core/llm-sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQrD,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACd;AAED,wBAAgB,kBAAkB;uBAiBP,MAAM,KAAG,iBAAiB,GAAG,IAAI;EAuE3D;AAED,wBAAsB,aAAa,CAClC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,EAC3C,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAuD5B"}

package/dist/core/llm-types.d.ts

@@ -0,0 +1,49 @@
+import type { JsonSchema } from "./types.js";
+export interface OpenAiToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LlmChatMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content?: string | null;
+    tool_call_id?: string;
+    tool_calls?: OpenAiToolCall[];
+}
+export interface ClientToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+export interface ChatCompletionRequest {
+    messages: LlmChatMessage[];
+    tools?: ClientToolDefinition[];
+    stream?: boolean;
+    model?: string;
+    systemPrompt?: string;
+    responseFormat?: {
+        type: "json_object";
+    };
+}
+export interface ChatCompletionResult {
+    message: {
+        role: "assistant";
+        content: string | null;
+        tool_calls?: OpenAiToolCall[];
+    };
+    model: string;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+}
+export interface LlmStatusResponse {
+    enabled: boolean;
+    model: string | null;
+    models: string[];
+}
+//# sourceMappingURL=llm-types.d.ts.map

package/dist/core/llm-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-types.d.ts","sourceRoot":"","sources":["../../src/core/llm-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC;CACF;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE;QACR,IAAI,EAAE,WAAW,CAAC;QAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;KAC9B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACF;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/core/markdown-utils.d.ts

@@ -0,0 +1,3 @@
+import { type ReactNode } from "react";
+export declare function childrenToText(children: ReactNode): string;
+//# sourceMappingURL=markdown-utils.d.ts.map

package/dist/core/markdown-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-utils.d.ts","sourceRoot":"","sources":["../../src/core/markdown-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,CAQ1D"}

package/dist/core/prepare-markdown.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalize LaTeX for remark-math + KaTeX.
+ * - `\[...\]` → `$$...$$` (display)
+ * - `\(...\)` → `$...$` (inline)
+ */
+export declare function prepareMarkdown(message: string): string;
+//# sourceMappingURL=prepare-markdown.d.ts.map

package/dist/core/prepare-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-markdown.d.ts","sourceRoot":"","sources":["../../src/core/prepare-markdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/core/types.d.ts

@@ -0,0 +1,74 @@
+import type { ChatActivityStep } from "./chat-activity.js";
+import type { ReplySuggestions } from "./interactive-tools/index.js";
+export type JsonSchema = Record<string, unknown>;
+export interface AssistantToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+export interface AssistantToolContent {
+    type: string;
+    text?: string;
+}
+export interface AssistantToolResult {
+    isError?: boolean;
+    content: AssistantToolContent[];
+    structuredContent?: unknown;
+}
+export interface AssistantMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    activity?: ChatActivityStep[];
+    toolCall?: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    replySuggestions?: ReplySuggestions;
+    isError?: boolean;
+    llmSetupRequired?: boolean;
+    streaming?: boolean;
+    timestamp: number;
+}
+export interface AssistantSuggestedPrompt {
+    id: string;
+    label: string;
+    description?: string;
+    prompt: string;
+    /** Icon name for dynamic prompts (e.g. "database", "search") */
+    icon?: string;
+}
+export interface AssistantLlmSettings {
+    enabled: boolean;
+    baseUrl: string;
+    apiKey: string | null;
+    model: string;
+    /** Optional static model list; fetched from the provider when omitted */
+    models?: string[];
+    /** Default system prompt prepended to each completion request */
+    systemPrompt?: string;
+}
+export type AssistantLlmConfig = AssistantLlmSettings | (() => AssistantLlmSettings | Promise<AssistantLlmSettings>);
+export interface AssistantStorageKeys {
+    history?: string;
+    /** @deprecated Legacy model key migrated into llmSettings on load */
+    model?: string;
+    llmSettings?: string;
+}
+export interface AssistantWelcomeContext {
+    llmEnabled: boolean;
+    model: string | null;
+}
+export interface AssistantStoreDependencies {
+    llm?: AssistantLlmConfig;
+    storageKeys?: AssistantStorageKeys;
+    welcomeMessage: (ctx: AssistantWelcomeContext) => AssistantMessage;
+    listTools: () => Promise<AssistantToolDefinition[]>;
+    invokeTool: (name: string, args: Record<string, unknown>) => Promise<AssistantToolResult>;
+    onToolInvoked?: (result: AssistantToolResult) => void;
+    fallbackHandler?: (input: {
+        message: string;
+        tools: AssistantToolDefinition[];
+    }) => Promise<AssistantMessage | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}