@4djs/assistant 0.1.0 → 0.1.2

package/README.md

@@ -10,7 +10,7 @@ npm install @4djs/assistant
 bun add @4djs/assistant
 ```
 
-Peer dependencies: `react` and `react-dom` (^19).
+Peer dependencies: `react` and `react-dom` (^18 or ^19). React is not bundled — your app supplies it.
 
 Import styles once in your app entry (required for the UI):
 
@@ -64,12 +64,45 @@ When no LLM is configured, chat input is disabled and the UI prompts users to op
 
 ### Required store hooks
 
+Provide **`toolRegistry`** (recommended) or both **`listTools`** and **`invokeTool`**:
+
 | Option | Description |
 | --- | --- |
 | `welcomeMessage(ctx)` | Returns the initial assistant message. Called again when LLM status or model changes. |
+| `toolRegistry` | `AssistantToolRegistry` from `createAssistantToolRegistry()` — register, deactivate, and invoke tools in one place. |
 | `listTools()` | Returns OpenAI-style tool definitions (`name`, `description`, `inputSchema`). |
 | `invokeTool(name, args)` | Executes a tool and returns `{ content, isError?, structuredContent? }`. |
 
+### Tool registry (`@4djs/assistant/core` and `@4djs/assistant/tools`)
+
+```ts
+import {
+  connectExternalTools,
+  createAssistantToolRegistry,
+} from "@4djs/assistant/tools";
+import { registerDatastoreTools } from "@4djs/assistant/tools";
+
+const registry = createAssistantToolRegistry();
+registerDatastoreTools(registry, myDatastoreAdapter);
+
+// Extend at runtime
+registry.register({
+  definition: { name: "my_tool", description: "…", inputSchema: { type: "object", properties: {} } },
+  invoke: async (args) => ({ content: [{ type: "text", text: "ok" }] }),
+});
+
+registry.deactivate("my_tool"); // hide from LLM without unregistering
+registry.activate("my_tool");
+
+// Bridge @4d/tools or any external registry
+connectExternalTools(registry, externalRegistry);
+
+const config: AssistantConfig = {
+  toolRegistry: registry,
+  // …
+};
+```
+
 ### Optional store hooks
 
 | Option | Description |
@@ -79,6 +112,7 @@ When no LLM is configured, chat input is disabled and the UI prompts users to op
 | `onToolInvoked` | Side-effect hook after each tool completes (e.g. refresh app state). |
 | `fetchSuggestedPrompts` | Async hook to generate contextual starter prompts via LLM. |
 | `autoLoadLlmStatus` | Fetch LLM config on mount (default: `true`). |
+| `labels` | Partial UI copy overrides for translation or branding (see below). |
 
 ### UI options
 
@@ -110,6 +144,106 @@ When no LLM is configured, chat input is disabled and the UI prompts users to op
 
 Per-instance overrides are supported via `Assistant` / `AssistantRoot` props: `header`, `emptyState`, `ui`.
 
+### Labels and i18n
+
+All built-in UI strings (buttons, placeholders, error titles, trace labels, aria text, etc.) live in a flat dictionary keyed by dot notation, e.g. `composer.placeholder`, `commands.clear.description`, `errors.network.title`.
+
+Pass partial overrides on `AssistantConfig.labels`. Only the keys you set are replaced; everything else keeps the English default:
+
+```ts
+import {
+  AssistantRoot,
+  DEFAULT_ASSISTANT_LABELS,
+  type AssistantConfig,
+} from "@4djs/assistant";
+
+const config: AssistantConfig = {
+  // …store hooks
+  labels: {
+    "header.title": "Assistant",
+    "composer.placeholder": "Posez une question…",
+    "composer.placeholderDisabled":
+      "LLM non configuré — le chat est désactivé",
+    "common.save": "Enregistrer",
+    "common.cancel": "Annuler",
+    "llmSettings.title": "Paramètres LLM",
+    "errors.network.title": "Connexion perdue",
+    "commands.clear.description": "Effacer la conversation",
+  },
+};
+```
+
+For a full locale file, spread it in:
+
+```ts
+import { frLabels } from "./locales/fr";
+
+labels: { ...frLabels, "header.title": "Mon assistant" },
+```
+
+Some keys support placeholders — use `{name}` or `{model}` in the string; the package substitutes them at runtime:
+
+```ts
+labels: {
+  "activity.steps.running": "Exécution de {name}…",
+  "llmSettings.connected": "Connecté · {model}",
+  "commands.unknown": "Commande inconnue : /{name}",
+},
+```
+
+Use `formatLabel` from `@4djs/assistant` (or `@4djs/assistant/core`) if you need the same substitution in host code.
+
+#### Key groups
+
+| Prefix | Examples |
+| --- | --- |
+| `common.*` | `save`, `cancel`, `loading`, `tryAgain` |
+| `composer.*` | `placeholder`, `send`, `stop`, `hint` |
+| `llmSettings.*` | Form labels, placeholders, `connected` |
+| `llmSetup.*` | “Connect an LLM” banner copy |
+| `suggestions.*` / `emptyState.*` | Prompt strips and welcome CTA |
+| `activity.*` | Trace panel and tool step labels |
+| `interactive.*` | Confirmation / choice prompts |
+| `errors.*` | Parsed error titles and hints |
+| `commands.*` | `/clear` description and errors |
+
+The full list of keys is `ASSISTANT_LABEL_KEYS`, or inspect `DEFAULT_ASSISTANT_LABELS`.
+
+#### Legacy shortcuts
+
+These older options still work and are merged into labels automatically:
+
+- `header.title` → `labels["header.title"]`
+- `ui.composerPlaceholder` → `labels["composer.placeholder"]`
+
+Prefer `labels` for new work so all copy stays in one place.
+
+#### Custom components
+
+Inside `AssistantProvider`, read the resolved dictionary with `useAssistantLabels()`:
+
+```tsx
+import { useAssistantLabels } from "@4djs/assistant";
+
+function MyPanel() {
+  const labels = useAssistantLabels();
+  return <p>{labels["common.loading"]}</p>;
+}
+```
+
+Outside the provider, components fall back to `DEFAULT_ASSISTANT_LABELS`.
+
+Headless helpers (also exported from `@4djs/assistant/core`):
+
+| Export | Use |
+| --- | --- |
+| `DEFAULT_ASSISTANT_LABELS` | English defaults |
+| `ASSISTANT_LABEL_KEYS` | All valid keys |
+| `resolveAssistantLabels(overrides?)` | Merge overrides onto defaults |
+| `formatLabel(template, values)` | Replace `{placeholders}` |
+
+**Not covered by `labels`:** `welcomeMessage` content, `emptyState.title` / `description`, and static or dynamic `suggestedPrompts` (`label`, `hint`, `prompt`) — those remain app-defined on `AssistantConfig`.
+
 ## LLM provider
 
 The assistant calls an **OpenAI-compatible** chat completions API directly from the browser (or your host runtime). No proxy `/api/chat` routes are required.
@@ -284,8 +418,8 @@ Useful for server routes, tests, or a fully custom UI.
 
 | Import | Contents |
 | --- | --- |
-| `@4djs/assistant` | React components, hooks, types |
-| `@4djs/assistant/core` | Store, LLM client, commands, interactive tools |
+| `@4djs/assistant` | React components, hooks, types, labels |
+| `@4djs/assistant/core` | Store, LLM client, commands, interactive tools, labels |
 | `@4djs/assistant/styles.css` | Component styles |
 
 The published package ships compiled JavaScript and TypeScript declarations from `dist/`. Source is not included in the tarball.
@@ -298,6 +432,7 @@ The published package ships compiled JavaScript and TypeScript declarations from
 - Model selector with searchable dropdown
 - In-app LLM settings (cloud or local OpenAI-compatible endpoints)
 - Persistent chat history and model preference (`localStorage`)
+- Configurable UI labels for translation and branding
 - Welcome screen with static or LLM-generated starter prompts
 - Composer footer toolbar: model selector, generate suggestions, clear chat
 - Structured error states with retry actions

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

@@ -1,3 +1,4 @@
+import type { AssistantLabels } from "../labels.js";
 export type ChatActivityStatus = "active" | "done" | "error";
 export interface ChatActivityStep {
     id: string;
@@ -10,7 +11,7 @@ export interface ChatActivityStep {
     error?: string;
 }
 export declare function summarizeActivityResult(result: unknown): unknown;
-export declare function chatActivityStepLabel(step: ChatActivityStep): string;
+export declare function chatActivityStepLabel(step: ChatActivityStep, labels?: AssistantLabels): string;
 export declare function formatJsonIfLarge(raw: string): string;
 export declare function formatActivityJson(raw?: string): string | null;
 export declare function formatActivityJsonValue(value: unknown): string | null;

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

@@ -1 +1 @@
-{"version":3,"file":"chat-activity.d.ts","sourceRoot":"","sources":["../../src/core/chat-activity.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAYhE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAapE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAarD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAuB3D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAI9D"}
+{"version":3,"file":"chat-activity.d.ts","sourceRoot":"","sources":["../../src/core/chat-activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAYhE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,eAA0C,GACjD,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAarD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAuB3D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAI9D"}

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

@@ -1,3 +1,4 @@
+import type { AssistantLabels } from "../labels.js";
 export type ChatCommandSurface = "assistant";
 export type ChatCommandRunResult = {
     handled: boolean;
@@ -8,18 +9,19 @@ export type AssistantCommandDeps = {
     clearMessages: () => void;
     setError: (error: string | null) => void;
     streaming: boolean;
+    labels?: AssistantLabels;
 };
 export type ChatCommandSuggestion = {
     name: string;
     description: string;
     usage: string;
 };
-export declare function getChatCommandSuggestions(surface: ChatCommandSurface): ChatCommandSuggestion[];
+export declare function getChatCommandSuggestions(surface: ChatCommandSurface, labels?: AssistantLabels): ChatCommandSuggestion[];
 export declare function isChatCommandInput(value: string): boolean;
-export declare function filterChatCommands(value: string, surface: ChatCommandSurface): ChatCommandSuggestion[];
-export declare function shouldShowChatCommandMenu(value: string, surface: ChatCommandSurface): boolean;
+export declare function filterChatCommands(value: string, surface: ChatCommandSurface, labels?: AssistantLabels): ChatCommandSuggestion[];
+export declare function shouldShowChatCommandMenu(value: string, surface: ChatCommandSurface, labels?: AssistantLabels): boolean;
 export declare function completionForChatCommand(command: ChatCommandSuggestion): string;
-export declare function listChatCommands(surface?: ChatCommandSurface): Array<{
+export declare function listChatCommands(surface?: ChatCommandSurface, labels?: AssistantLabels): Array<{
     name: string;
     description: string;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"chat-commands.d.ts","sourceRoot":"","sources":["../../src/core/chat-commands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAyBF,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,kBAAkB,GACzB,qBAAqB,EAAE,CAQzB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,GACzB,qBAAqB,EAAE,CAiBzB;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAWT;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,qBAAqB,GAC5B,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC,CAID;AAED,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBvC;AA2BD,wBAAsB,uBAAuB,CAC5C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}
+{"version":3,"file":"chat-commands.d.ts","sourceRoot":"","sources":["../../src/core/chat-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AA+BF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAMF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,eAAe,GACvB,qBAAqB,EAAE,CASzB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,eAAe,GACvB,qBAAqB,EAAE,CAiBzB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAWT;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,qBAAqB,GAC7B,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,eAAe,GACvB,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAQD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBvC;AA4BD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}

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

@@ -1 +1 @@
-{"version":3,"file":"chat-history.d.ts","sourceRoot":"","sources":["../../src/core/chat-history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAK5E,MAAM,WAAW,kBAAkB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,gBAAgB,CAAC;CACnE;AAyDD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB;qBAI7C,gBAAgB,EAAE,GAAG,IAAI;wBAapB,gBAAgB,EAAE;;uBAYnB,uBAAuB,KAAG,gBAAgB,EAAE;EAYtE;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"chat-history.d.ts","sourceRoot":"","sources":["../../src/core/chat-history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAK5E,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,gBAAgB,CAAC;CACpE;AAyDD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB;qBAI5C,gBAAgB,EAAE,GAAG,IAAI;wBAapB,gBAAgB,EAAE;;uBAYnB,uBAAuB,KAAG,gBAAgB,EAAE;EAYvE;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/core/chat-reply-suggestions-parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-reply-suggestions-parse.d.ts","sourceRoot":"","sources":["../../src/core/chat-reply-suggestions-parse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACzB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IACA,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACX,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAcpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAoClE;AA4CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvD"}
+{"version":3,"file":"chat-reply-suggestions-parse.d.ts","sourceRoot":"","sources":["../../src/core/chat-reply-suggestions-parse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAcrC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAoClE;AA4CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvD"}

package/dist/core/create-assistant-store.d.ts

@@ -28,6 +28,7 @@ export interface AssistantState {
     submitInteractiveToolResult: (callId: string, result: unknown) => void;
     cancelInteractiveToolResult: (callId: string) => void;
 }
+export declare function resolveAssistantStoreDependencies(deps: AssistantStoreDependencies): Required<Pick<AssistantStoreDependencies, "listTools" | "invokeTool">> & AssistantStoreDependencies;
 export declare function createAssistantStore(deps: AssistantStoreDependencies): import("zustand").UseBoundStore<import("zustand").StoreApi<AssistantState>>;
 export type AssistantStore = ReturnType<typeof createAssistantStore>;
 //# sourceMappingURL=create-assistant-store.d.ts.map

package/dist/core/create-assistant-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-assistant-store.d.ts","sourceRoot":"","sources":["../../src/core/create-assistant-store.ts"],"names":[],"mappings":"AAyBA,OAAO,EAMN,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAS1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAEX,gBAAgB,EAChB,0BAA0B,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kBAAkB,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxD,eAAe,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,eAAe,EAAE,CAChB,MAAM,EAAE,qBAAqB,KACzB,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,uBAAuB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,2BAA2B,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,2BAA2B,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AA8HD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,0BAA0B,+EAsbpE;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"create-assistant-store.d.ts","sourceRoot":"","sources":["../../src/core/create-assistant-store.ts"],"names":[],"mappings":"AAyBA,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAS3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAEV,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kBAAkB,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxD,eAAe,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,eAAe,EAAE,CACf,MAAM,EAAE,qBAAqB,KAC1B,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,uBAAuB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,2BAA2B,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,2BAA2B,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AA8HD,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,0BAA0B,GAC/B,QAAQ,CACT,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,YAAY,CAAC,CAC7D,GACC,0BAA0B,CAiB3B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,0BAA0B,+EAubpE;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/core/fetch-suggested-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-suggested-prompts.d.ts","sourceRoot":"","sources":["../../src/core/fetch-suggested-prompts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACH;AAED,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,OAAO,GACX,wBAAwB,CAAC,SAAS,CAAC,CAwCrC"}
+{"version":3,"file":"fetch-suggested-prompts.d.ts","sourceRoot":"","sources":["../../src/core/fetch-suggested-prompts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,GACZ,wBAAwB,CAAC,SAAS,CAAC,CAwCrC"}

package/dist/core/index.d.ts

@@ -1,12 +1,16 @@
+export type { AssistantLabelKey, AssistantLabelOverrides, AssistantLabels, } from "../labels.js";
+export { ASSISTANT_LABEL_KEYS, DEFAULT_ASSISTANT_LABELS, formatLabel, resolveAssistantLabels, } from "../labels.js";
 export type { ChatActivityStep } from "./chat-activity.js";
 export { chatActivityStepLabel, formatJsonIfLarge, summarizeActivityResult, } from "./chat-activity.js";
 export type { AssistantCommandDeps, ChatCommandRunResult, ChatCommandSuggestion, ChatCommandSurface, } from "./chat-commands.js";
-export { filterChatCommands, getChatCommandSuggestions, isChatCommandInput, listChatCommands, parseChatCommand, runAssistantChatCommand, shouldShowChatCommandMenu, } from "./chat-commands.js";
+export { completionForChatCommand, filterChatCommands, getChatCommandSuggestions, isChatCommandInput, listChatCommands, parseChatCommand, runAssistantChatCommand, shouldShowChatCommandMenu, } from "./chat-commands.js";
 export { createChatHistoryHelpers } from "./chat-history.js";
-export { type AssistantState, createAssistantStore, } from "./create-assistant-store.js";
+export { highlightCode, normalizeCodeLineEndings } from "./code-highlight.js";
+export { type AssistantState, type AssistantStore, createAssistantStore, resolveAssistantStoreDependencies, } from "./create-assistant-store.js";
 export { parseSuggestedPromptsResponse, type SuggestedPromptsResponse, } from "./fetch-suggested-prompts.js";
 export { CHOICES_TOOL, type ChoiceOption, type ChoicesToolArgs, CONFIRMATION_TOOL, type ConfirmationToolArgs, type ReplySuggestions, rejectAllInteractiveToolWaiters, resolveInteractiveToolResult, SUGGEST_REPLIES_TOOL, } from "./interactive-tools/index.js";
 export type { AgentStepResult, LlmChatStatus, StreamHandlers, ToolHandlers, } from "./llm-chat.js";
+export { buildSystemPromptWithTools } from "./system-prompt.js";
 export { buildLlmHistory, ChatAbortedError, fetchLlmStatus, LlmNotConfiguredError, LlmUpstreamError, requestLlmCompletion, runLlmAgent, sanitizeLlmMessages, } from "./llm-chat.js";
 export { buildCompletionsUrl, buildLlmRequestHeaders, buildModelsUrl, DEFAULT_LLM_BASE_URL, DEFAULT_LLM_MODEL, getFallbackModels, isLlmConfigured, isLlmUnavailableMessage, isLocalLlmBaseUrl, LLM_UNAVAILABLE_MESSAGE, } from "./llm-config.js";
 export { clearProviderModelCache, fetchProviderModels, } from "./llm-models.js";
@@ -15,5 +19,9 @@ export type { LlmSettingsFormState, LlmSettingsFormValues, StoredLlmUserSettings
 export { assistantToStored, buildDefaultLlmSettings, createDefaultStoredSettings, createLlmSettingsFormState, createLlmSettingsFormStateFromStored, createLlmSettingsStorage, DEFAULT_LLM_SETTINGS_STORAGE_KEY, formatModelsText, isLlmSettingsFormDirty, mergeLlmSettings, migrateLegacyModelStorage, normalizeStoredSettings, normalizeStoredSystemPrompt, parseModelsText, peekStoredModel, persistStoredModelSelection, resolveSelectedModel, storedSettingsHaveOverrides, storedToAssistant, toStoredSettings, } from "./llm-settings-storage.js";
 export type { ClientToolDefinition, LlmChatMessage, OpenAiToolCall, } from "./llm-types.js";
 export { childrenToText } from "./markdown-utils.js";
+export { prepareMarkdown } from "./prepare-markdown.js";
+export { fromLlmToolName, toLlmToolName } from "./tool-names.js";
+export type { AssistantToolHandler, AssistantToolRegistry, ExternalToolSource, } from "./tool-registry.js";
+export { connectExternalTools, createAssistantToolRegistry, resolveAssistantToolHooks, toolResultErr, toolResultOk, } from "./tool-registry.js";
 export type { AssistantLlmConfig, AssistantLlmSettings, AssistantMessage, AssistantStorageKeys, AssistantStoreDependencies, AssistantSuggestedPrompt, AssistantToolContent, AssistantToolDefinition, AssistantToolResult, AssistantWelcomeContext, JsonSchema, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACN,KAAK,cAAc,EACnB,oBAAoB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,6BAA6B,EAC7B,KAAK,wBAAwB,GAC7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,+BAA+B,EAC/B,4BAA4B,EAC5B,oBAAoB,GACpB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,uBAAuB,EACvB,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,oCAAoC,EACpC,wBAAwB,EACxB,gCAAgC,EAChC,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,oBAAoB,EACpB,cAAc,EACd,cAAc,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,GACV,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}