@4djs/assistant 0.1.0 → 0.1.1

package/dist/index.js

@@ -164300,6 +164300,142 @@ var init_wardleyDiagram_YWT4CUSO = __esm(() => {
   };
 });
 
+// src/labels.ts
+var DEFAULT_ASSISTANT_LABELS = {
+  "common.cancel": "Cancel",
+  "common.save": "Save",
+  "common.saving": "Saving",
+  "common.dismiss": "Dismiss",
+  "common.loading": "Loading…",
+  "common.error": "Error",
+  "common.result": "Result",
+  "common.edit": "Edit",
+  "common.preview": "Preview",
+  "common.regenerate": "Regenerate",
+  "common.tryAgain": "Try again",
+  "header.title": "Assistant",
+  "message.assistantRole": "Assistant",
+  "message.thinking": "Assistant is thinking",
+  "composer.placeholder": "Ask the assistant…",
+  "composer.placeholderDisabled": "LLM not configured — chat is disabled",
+  "composer.messageAria": "Chat message",
+  "composer.send": "Send",
+  "composer.stop": "Stop",
+  "composer.hint": "Enter to send · Shift+Enter for new line",
+  "composer.llmSettings": "LLM settings",
+  "composer.generateSuggestions": "Generate suggestions",
+  "composer.clearConversation": "Clear conversation",
+  "commandMenu.ariaLabel": "Composer commands",
+  "commandMenu.header": "Commands",
+  "commands.clear.description": "Clear the current conversation",
+  "commands.clear.noArgsError": "The /clear command does not accept arguments.",
+  "commands.clear.waitForFinishError": "Wait for the assistant to finish before clearing.",
+  "commands.unknown": "Unknown command: /{name}",
+  "commands.failed": "Command failed",
+  "llmSetup.notConnected": "LLM not connected.",
+  "llmSetup.addProviderBeforeLink": "Add a cloud or local provider in",
+  "llmSetup.settingsLink": "LLM settings",
+  "llmSetup.connectTitle": "Connect an LLM",
+  "llmSetup.connectDescription": "OpenAI-compatible endpoint — cloud or local",
+  "llmSetup.configure": "Configure",
+  "llmSettings.title": "LLM settings",
+  "llmSettings.ariaLabel": "LLM settings",
+  "llmSettings.testConnection": "Test connection",
+  "llmSettings.resetAllSettings": "Reset all settings",
+  "llmSettings.close": "Close LLM settings",
+  "llmSettings.baseUrl": "Base URL",
+  "llmSettings.apiKey": "API key",
+  "llmSettings.model": "Model",
+  "llmSettings.advanced": "Advanced",
+  "llmSettings.modelList": "Model list",
+  "llmSettings.baseUrlPlaceholder": "https://api.openai.com/v1",
+  "llmSettings.apiKeyPlaceholder": "sk-…",
+  "llmSettings.apiKeyConfiguredPlaceholder": "Configured — leave blank to keep",
+  "llmSettings.modelPlaceholder": "gpt-4o-mini",
+  "llmSettings.modelListPlaceholder": "Optional — comma-separated",
+  "llmSettings.connected": "Connected · {model}",
+  "llmSettings.resetAll": "Reset all",
+  "llmSettings.failedToLoad": "Failed to load LLM settings",
+  "llmSettings.failedToSave": "Failed to save LLM settings",
+  "llmSettings.failedToReset": "Failed to reset LLM settings",
+  "systemPrompt.label": "System prompt",
+  "systemPrompt.defaultTag": "Default",
+  "systemPrompt.viewAria": "System prompt view",
+  "systemPrompt.resetAria": "Reset system prompt",
+  "systemPrompt.resetTitle": "Reset to default",
+  "systemPrompt.placeholder": "Optional — replaces app default",
+  "systemPrompt.editorAria": "System prompt editor",
+  "systemPrompt.previewAria": "System prompt preview",
+  "modelSelector.label": "Model",
+  "modelSelector.modelAria": "LLM model",
+  "modelSelector.loadingModels": "Loading models…",
+  "modelSelector.searchModels": "Search models…",
+  "modelSelector.suggestionsAria": "Model suggestions",
+  "modelSelector.custom": "Custom",
+  "suggestions.ariaLabel": "Suggested prompts",
+  "suggestions.title": "Suggestions",
+  "suggestions.generate": "Generate",
+  "suggestions.close": "Close suggestions",
+  "suggestions.loading": "Loading suggestions",
+  "suggestions.failedToLoad": "Failed to load suggestions",
+  "emptyState.eyebrow": "AI Assistant",
+  "emptyState.generateSuggestions": "Generate suggestions",
+  "emptyState.generateSuggestionsHint": "Tailored prompts based on your live catalog",
+  "emptyState.generating": "Generating suggestions",
+  "emptyState.suggestedForYou": "Suggested for you",
+  "emptyState.quickStarts": "Quick starts",
+  "emptyState.capabilities.catalog": "Catalog",
+  "emptyState.capabilities.query": "Query",
+  "emptyState.capabilities.mutate": "Mutate",
+  "activity.trace": "Trace",
+  "activity.live": "Live",
+  "activity.arguments": "Arguments",
+  "activity.running": "Running…",
+  "activity.steps.waitingConfirmation": "Waiting for confirmation…",
+  "activity.steps.waitingChoice": "Waiting for your choice…",
+  "activity.steps.suggestingReplies": "Suggesting replies…",
+  "activity.steps.running": "Running {name}…",
+  "activity.steps.failed": "{name} failed",
+  "activity.steps.confirmationAnswered": "Confirmation answered",
+  "activity.steps.choiceSubmitted": "Choice submitted",
+  "activity.steps.replySuggestionsShown": "Reply suggestions shown",
+  "activity.steps.ran": "Ran {name}",
+  "interactive.chooseOptions": "Choose options",
+  "interactive.chooseOne": "Choose one",
+  "interactive.choicesKeyboardHint": "1-9 · Enter · Esc",
+  "interactive.confirmationKeyboardHint": "Enter · Esc",
+  "interactive.confirm": "Confirm",
+  "interactive.confirmDeletion": "Confirm deletion",
+  "interactive.invalidArgs": "Invalid interactive tool arguments",
+  "replySuggestions.legend": "Suggested replies",
+  "replySuggestions.pickHint": "to pick · or type below",
+  "replySuggestions.badges.model": "Model",
+  "replySuggestions.badges.status": "Status",
+  "replySuggestions.badges.tools": "Tools",
+  "replySuggestions.badges.dataclass": "Dataclass",
+  "replySuggestions.badges.filter": "Filter",
+  "scroll.toBottom": "Scroll to bottom",
+  "errors.network.title": "Connection lost",
+  "errors.network.hintChat": "Check your network or LLM endpoint, then try again.",
+  "errors.network.hintSuggestions": "Check your connection and LLM settings.",
+  "errors.auth.title": "Authentication failed",
+  "errors.auth.hint": "Verify your API key or credentials in LLM settings.",
+  "errors.timeout.title": "Request timed out",
+  "errors.timeout.hint": "The model took too long to respond. Try again in a moment.",
+  "errors.rateLimit.title": "Rate limit reached",
+  "errors.rateLimit.hint": "Wait a few seconds before sending another request.",
+  "errors.unknown.titleChat": "Something went wrong",
+  "errors.unknown.titleSuggestions": "Couldn't load suggestions",
+  "errors.unknown.hintChat": "Try again, or review your LLM settings.",
+  "errors.unknown.hintSuggestions": "Try regenerating, or check your LLM configuration."
+};
+var ASSISTANT_LABEL_KEYS = Object.keys(DEFAULT_ASSISTANT_LABELS);
+function formatLabel(template, values) {
+  return template.replace(/\{(\w+)\}/g, (_, key) => String(values[key] ?? ""));
+}
+function resolveAssistantLabels(overrides) {
+  return { ...DEFAULT_ASSISTANT_LABELS, ...overrides };
+}
 // ../../node_modules/.bun/lucide-react@0.511.0+e14d3f224186685e/node_modules/lucide-react/dist/esm/createLucideIcon.js
 import { forwardRef as forwardRef2, createElement as createElement2 } from "react";
 
@@ -164734,42 +164870,46 @@ import {
 var CHAT_COMMANDS = [
   {
     name: "clear",
-    description: "Clear the current conversation",
     surfaces: ["assistant"],
-    run: async (args, deps) => {
+    description: (labels) => labels["commands.clear.description"],
+    run: async (args, deps, labels) => {
       if (args) {
-        throw new Error("The /clear command does not accept arguments.");
+        throw new Error(labels["commands.clear.noArgsError"]);
       }
       if (deps.streaming) {
-        throw new Error("Wait for the assistant to finish before clearing.");
+        throw new Error(labels["commands.clear.waitForFinishError"]);
       }
       deps.clearMessages();
       deps.setError(null);
     }
   }
 ];
-function getChatCommandSuggestions(surface) {
+function resolveLabels(labels) {
+  return labels ?? DEFAULT_ASSISTANT_LABELS;
+}
+function getChatCommandSuggestions(surface, labels) {
+  const resolved = resolveLabels(labels);
   return CHAT_COMMANDS.filter((command) => command.surfaces.includes(surface)).map(({ name, description }) => ({
     name,
-    description,
+    description: description(resolved),
     usage: `/${name}`
   }));
 }
 function isChatCommandInput(value) {
   return value.trimStart().startsWith("/");
 }
-function filterChatCommands(value, surface) {
+function filterChatCommands(value, surface, labels) {
   if (!isChatCommandInput(value)) {
     return [];
   }
   const query = value.trimStart().slice(1).toLowerCase();
-  const commands = getChatCommandSuggestions(surface);
+  const commands = getChatCommandSuggestions(surface, labels);
   if (!query) {
     return commands;
   }
   return commands.filter((command) => command.name.startsWith(query) || command.usage.toLowerCase().startsWith(`/${query}`));
 }
-function shouldShowChatCommandMenu(value, surface) {
+function shouldShowChatCommandMenu(value, surface, labels) {
   if (!isChatCommandInput(value) || value.includes(`
 `)) {
     return false;
@@ -164778,13 +164918,17 @@ function shouldShowChatCommandMenu(value, surface) {
   if (trimmed.includes(" ")) {
     return false;
   }
-  return filterChatCommands(value, surface).length > 0;
+  return filterChatCommands(value, surface, labels).length > 0;
 }
 function completionForChatCommand(command) {
   return `${command.usage} `;
 }
-function listChatCommands(surface) {
-  return CHAT_COMMANDS.filter((command) => !surface || command.surfaces.includes(surface)).map(({ name, description }) => ({ name, description }));
+function listChatCommands(surface, labels) {
+  const resolved = resolveLabels(labels);
+  return CHAT_COMMANDS.filter((command) => !surface || command.surfaces.includes(surface)).map(({ name, description }) => ({
+    name,
+    description: description(resolved)
+  }));
 }
 function parseChatCommand(input) {
   const trimmed = input.trim();
@@ -164802,22 +164946,23 @@ function parseChatCommand(input) {
   };
 }
 async function executeCommand(parsed, deps) {
+  const labels = resolveLabels(deps.labels);
   const command = CHAT_COMMANDS.find((entry) => entry.name === parsed.name);
   if (!command?.surfaces.includes("assistant")) {
     return {
       handled: true,
       clearInput: true,
-      error: `Unknown command: /${parsed.name}`
+      error: formatLabel(labels["commands.unknown"], { name: parsed.name })
     };
   }
   try {
-    await command.run(parsed.args, deps);
+    await command.run(parsed.args, deps, labels);
     return { handled: true, clearInput: true };
   } catch (error) {
     return {
       handled: true,
       clearInput: true,
-      error: error instanceof Error ? error.message : "Command failed"
+      error: error instanceof Error ? error.message : labels["commands.failed"]
     };
   }
 }
@@ -164895,15 +165040,6 @@ function buildLlmRequestHeaders(apiKey) {
   return headers;
 }
 
-// src/react/components/ModelSelector.tsx
-import {
-  useEffect as useEffect2,
-  useId,
-  useMemo as useMemo2,
-  useRef as useRef2,
-  useState
-} from "react";
-
 // src/react/context.tsx
 import {
   createContext,
@@ -164968,25 +165104,25 @@ function summarizeActivityResult(result) {
   }
   return result;
 }
-function chatActivityStepLabel(step) {
+function chatActivityStepLabel(step, labels = DEFAULT_ASSISTANT_LABELS) {
   if (step.status === "active") {
     if (step.name === "request_confirmation")
-      return "Waiting for confirmation…";
+      return labels["activity.steps.waitingConfirmation"];
     if (step.name === "request_choices")
-      return "Waiting for your choice…";
+      return labels["activity.steps.waitingChoice"];
     if (step.name === "suggest_replies")
-      return "Suggesting replies…";
-    return `Running ${step.name}…`;
+      return labels["activity.steps.suggestingReplies"];
+    return formatLabel(labels["activity.steps.running"], { name: step.name });
   }
   if (step.status === "error")
-    return `${step.name} failed`;
+    return formatLabel(labels["activity.steps.failed"], { name: step.name });
   if (step.name === "request_confirmation")
-    return "Confirmation answered";
+    return labels["activity.steps.confirmationAnswered"];
   if (step.name === "request_choices")
-    return "Choice submitted";
+    return labels["activity.steps.choiceSubmitted"];
   if (step.name === "suggest_replies")
-    return "Reply suggestions shown";
-  return `Ran ${step.name}`;
+    return labels["activity.steps.replySuggestionsShown"];
+  return formatLabel(labels["activity.steps.ran"], { name: step.name });
 }
 function formatJsonIfLarge(raw) {
   const trimmed = raw.trim();
@@ -166718,6 +166854,16 @@ function createAssistantStore(deps) {
 
 // src/react/context.tsx
 import { jsxDEV } from "react/jsx-dev-runtime";
+function resolveConfigLabels(config) {
+  const labels = resolveAssistantLabels(config.labels);
+  if (config.ui?.composerPlaceholder) {
+    labels["composer.placeholder"] = config.ui.composerPlaceholder;
+  }
+  if (config.header?.title) {
+    labels["header.title"] = config.header.title;
+  }
+  return labels;
+}
 var AssistantContext = createContext(null);
 function AssistantProvider({
   config,
@@ -166727,10 +166873,14 @@ function AssistantProvider({
   if (!storeRef.current) {
     storeRef.current = createAssistantStore(config);
   }
-  const value = useMemo(() => ({
-    store: storeRef.current,
-    config
-  }), [config]);
+  const value = useMemo(() => {
+    const labels = resolveConfigLabels(config);
+    return {
+      store: storeRef.current,
+      config,
+      labels
+    };
+  }, [config]);
   return /* @__PURE__ */ jsxDEV(AssistantContext.Provider, {
     value,
     children
@@ -166751,6 +166901,10 @@ function useAssistantActions() {
   const { store } = useAssistantContext();
   return store.getState();
 }
+function useAssistantLabels() {
+  const context = useContext(AssistantContext);
+  return context?.labels ?? DEFAULT_ASSISTANT_LABELS;
+}
 function AssistantBootstrap({ children }) {
   const { store, config } = useAssistantContext();
   const autoLoad = config.autoLoadLlmStatus !== false;
@@ -166763,6 +166917,13 @@ function AssistantBootstrap({ children }) {
 }
 
 // src/react/components/ModelSelector.tsx
+import {
+  useEffect as useEffect2,
+  useId,
+  useMemo as useMemo2,
+  useRef as useRef2,
+  useState
+} from "react";
 import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
 function filterModels(models, query) {
   const needle = query.trim().toLowerCase();
@@ -166775,6 +166936,7 @@ function ModelSelector({
   variant = "header",
   dropUp = false
 }) {
+  const labels = useAssistantLabels();
   const llmModels = useAssistant((s) => s.llmModels);
   const llmModelsLoading = useAssistant((s) => s.llmModelsLoading);
   const selectedModel = useAssistant((s) => s.selectedModel);
@@ -166887,7 +167049,7 @@ function ModelSelector({
       children: [
         variant === "header" ? /* @__PURE__ */ jsxDEV2("span", {
           className: "model-selector__label-text",
-          children: "Model"
+          children: labels["modelSelector.label"]
         }, undefined, false, undefined, this) : null,
         /* @__PURE__ */ jsxDEV2("div", {
           className: "model-selector__field",
@@ -166921,9 +167083,9 @@ function ModelSelector({
               "aria-controls": showList ? listboxId : undefined,
               "aria-autocomplete": "list",
               "aria-activedescendant": showList ? `${listboxId}-option-${activeIndex}` : undefined,
-              "aria-label": "LLM model",
+              "aria-label": labels["modelSelector.modelAria"],
               "aria-busy": llmModelsLoading,
-              placeholder: llmModelsLoading ? "Loading models…" : "Search models…",
+              placeholder: llmModelsLoading ? labels["modelSelector.loadingModels"] : labels["modelSelector.searchModels"],
               autoComplete: "off",
               spellCheck: false
             }, undefined, false, undefined, this),
@@ -166931,7 +167093,7 @@ function ModelSelector({
               id: listboxId,
               role: "listbox",
               className: `model-selector__list ${dropUp ? "model-selector__list--drop-up" : ""}`,
-              "aria-label": "Model suggestions",
+              "aria-label": labels["modelSelector.suggestionsAria"],
               children: suggestions.map((model, index) => {
                 const isCustom = model === query.trim() && !llmModels.some((entry) => entry.toLowerCase() === model.toLowerCase());
                 return /* @__PURE__ */ jsxDEV2("button", {
@@ -166950,7 +167112,7 @@ function ModelSelector({
                     }, undefined, false, undefined, this),
                     isCustom && /* @__PURE__ */ jsxDEV2("span", {
                       className: "model-selector__option-hint",
-                      children: "Custom"
+                      children: labels["modelSelector.custom"]
                     }, undefined, false, undefined, this)
                   ]
                 }, isCustom ? `custom:${model}` : model, true, undefined, this);
@@ -166976,17 +167138,18 @@ function ComposerCommandMenu({
   onSelect,
   className
 }) {
+  const labels = useAssistantLabels();
   if (commands.length === 0) {
     return null;
   }
   return /* @__PURE__ */ jsxDEV3("div", {
     className: cn("composer-command-menu", className),
     role: "listbox",
-    "aria-label": "Composer commands",
+    "aria-label": labels["commandMenu.ariaLabel"],
     children: [
       /* @__PURE__ */ jsxDEV3("div", {
         className: "composer-command-menu__header",
-        children: "Commands"
+        children: labels["commandMenu.header"]
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsxDEV3("ul", {
         className: "composer-command-menu__list",
@@ -167045,11 +167208,15 @@ function ChatComposer({
   llmEnabled,
   disabled,
   inputDisabled,
-  placeholder = "Ask the assistant…",
+  placeholder,
+  labels: labelsOverride,
   toolbar,
   commandMenu
 }) {
-  const commandHint = listChatCommands("assistant").map((command) => `/${command.name}`).join(" · ");
+  const contextLabels = useAssistantLabels();
+  const labels = labelsOverride ?? contextLabels;
+  const resolvedPlaceholder = placeholder ?? labels["composer.placeholder"];
+  const commandHint = listChatCommands("assistant", labels).map((command) => `/${command.name}`).join(" · ");
   const blockInput = inputDisabled ?? disabled ?? false;
   const showToolbar = toolbar?.showLlmSettings || toolbar?.showGenerateSuggestions || toolbar?.showClear || llmEnabled;
   const showLlmSettings = toolbar?.showLlmSettings === true;
@@ -167074,15 +167241,15 @@ function ChatComposer({
                 value: input,
                 onChange: (event) => onInputChange(event.target.value),
                 onKeyDown,
-                placeholder,
+                placeholder: resolvedPlaceholder,
                 rows: 2,
                 disabled: blockInput || streaming,
-                "aria-label": "Chat message"
+                "aria-label": labels["composer.messageAria"]
               }, undefined, false, undefined, this),
               streaming ? /* @__PURE__ */ jsxDEV4("button", {
                 type: "button",
                 className: "assistant-btn assistant-btn--secondary assistant-composer__stop",
-                "aria-label": "Stop",
+                "aria-label": labels["composer.stop"],
                 onClick: onStop,
                 children: /* @__PURE__ */ jsxDEV4(Square, {
                   size: 14,
@@ -167092,7 +167259,7 @@ function ChatComposer({
               }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV4("button", {
                 type: "button",
                 className: "assistant-btn assistant-btn--primary assistant-composer__send",
-                "aria-label": "Send",
+                "aria-label": labels["composer.send"],
                 disabled: blockInput || !input.trim(),
                 onClick: onSubmit,
                 children: /* @__PURE__ */ jsxDEV4(SendHorizontal, {
@@ -167118,8 +167285,8 @@ function ChatComposer({
                     className: "assistant-btn assistant-btn--ghost assistant-composer__tool",
                     onClick: toolbar?.onOpenLlmSettings,
                     disabled: streaming,
-                    "aria-label": "LLM settings",
-                    title: "LLM settings",
+                    "aria-label": labels["composer.llmSettings"],
+                    title: labels["composer.llmSettings"],
                     children: /* @__PURE__ */ jsxDEV4(Settings2, {
                       size: 16,
                       "aria-hidden": true
@@ -167130,8 +167297,8 @@ function ChatComposer({
                     className: "assistant-btn assistant-btn--ghost assistant-composer__tool",
                     onClick: toolbar?.onGenerateSuggestions,
                     disabled: blockInput || streaming || toolbar?.suggestionsLoading,
-                    "aria-label": "Generate suggestions",
-                    title: "Generate suggestions",
+                    "aria-label": labels["composer.generateSuggestions"],
+                    title: labels["composer.generateSuggestions"],
                     children: toolbar?.suggestionsLoading ? /* @__PURE__ */ jsxDEV4(LoaderCircle, {
                       size: 16,
                       className: "assistant-composer__tool-spinner",
@@ -167146,8 +167313,8 @@ function ChatComposer({
                     className: "assistant-btn assistant-btn--ghost assistant-composer__tool",
                     onClick: toolbar?.onClear,
                     disabled: streaming || toolbar?.clearDisabled,
-                    "aria-label": "Clear conversation",
-                    title: "Clear conversation",
+                    "aria-label": labels["composer.clearConversation"],
+                    title: labels["composer.clearConversation"],
                     children: /* @__PURE__ */ jsxDEV4(Trash2, {
                       size: 16,
                       "aria-hidden": true
@@ -167162,7 +167329,7 @@ function ChatComposer({
       /* @__PURE__ */ jsxDEV4("p", {
         className: "assistant-composer__hint",
         children: [
-          "Enter to send · Shift+Enter for new line",
+          labels["composer.hint"],
           commandHint ? /* @__PURE__ */ jsxDEV4(Fragment, {
             children: [
               " · ",
@@ -167210,45 +167377,45 @@ function stripKnownPrefix(message) {
   }
   return message.trim();
 }
-function parseAssistantError(raw, context = "chat") {
+function parseAssistantError(raw, context = "chat", labels = DEFAULT_ASSISTANT_LABELS) {
   const detail = stripKnownPrefix(raw);
   const lower = detail.toLowerCase();
   if (lower.includes("failed to fetch") || lower.includes("networkerror") || lower.includes("network error") || lower.includes("load failed") || lower.includes("connection refused") || lower.includes("econnrefused")) {
     return {
-      title: "Connection lost",
+      title: labels["errors.network.title"],
       detail,
-      hint: context === "chat" ? "Check your network or LLM endpoint, then try again." : "Check your connection and LLM settings.",
+      hint: context === "chat" ? labels["errors.network.hintChat"] : labels["errors.network.hintSuggestions"],
       kind: "network"
     };
   }
   if (lower.includes("unauthorized") || lower.includes("401") || lower.includes("invalid api key") || lower.includes("authentication") || lower.includes("permission denied")) {
     return {
-      title: "Authentication failed",
+      title: labels["errors.auth.title"],
       detail,
-      hint: "Verify your API key or credentials in LLM settings.",
+      hint: labels["errors.auth.hint"],
       kind: "auth"
     };
   }
   if (lower.includes("timeout") || lower.includes("timed out")) {
     return {
-      title: "Request timed out",
+      title: labels["errors.timeout.title"],
       detail,
-      hint: "The model took too long to respond. Try again in a moment.",
+      hint: labels["errors.timeout.hint"],
       kind: "timeout"
     };
   }
   if (lower.includes("rate limit") || lower.includes("429") || lower.includes("too many requests")) {
     return {
-      title: "Rate limit reached",
+      title: labels["errors.rateLimit.title"],
       detail,
-      hint: "Wait a few seconds before sending another request.",
+      hint: labels["errors.rateLimit.hint"],
       kind: "rate-limit"
     };
   }
   return {
-    title: context === "chat" ? "Something went wrong" : "Couldn't load suggestions",
+    title: context === "chat" ? labels["errors.unknown.titleChat"] : labels["errors.unknown.titleSuggestions"],
     detail,
-    hint: context === "chat" ? "Try again, or review your LLM settings." : "Try regenerating, or check your LLM configuration.",
+    hint: context === "chat" ? labels["errors.unknown.hintChat"] : labels["errors.unknown.hintSuggestions"],
     kind: "unknown"
   };
 }
@@ -167267,11 +167434,15 @@ function AssistantErrorCallout({
   context = "chat",
   variant = "embedded",
   onRetry,
-  retryLabel = "Try again",
-  retryLoading = false
+  retryLabel,
+  retryLoading = false,
+  labels: labelsOverride
 }) {
-  const parsed = parseAssistantError(error, context);
+  const contextLabels = useAssistantLabels();
+  const labels = labelsOverride ?? contextLabels;
+  const parsed = parseAssistantError(error, context, labels);
   const Icon2 = ERROR_ICONS[parsed.kind];
+  const resolvedRetryLabel = retryLabel ?? labels["common.tryAgain"];
   return /* @__PURE__ */ jsxDEV5("div", {
     className: `assistant-error-callout assistant-error-callout--${variant}`,
     role: "alert",
@@ -167313,7 +167484,7 @@ function AssistantErrorCallout({
             className: retryLoading ? "assistant-icon-spin" : undefined,
             "aria-hidden": true
           }, undefined, false, undefined, this),
-          retryLabel
+          resolvedRetryLabel
         ]
       }, undefined, true, undefined, this) : null
     ]
@@ -167358,6 +167529,7 @@ function SuggestedPromptsList({
   className,
   compact
 }) {
+  const labels = useAssistantLabels();
   if (loading) {
     return /* @__PURE__ */ jsxDEV6("div", {
       className: `assistant-empty-state__grid ${compact ? "assistant-empty-state__grid--compact" : ""} ${className ?? ""}`.trim(),
@@ -167367,7 +167539,7 @@ function SuggestedPromptsList({
       children: [
         /* @__PURE__ */ jsxDEV6("span", {
           className: "sr-only",
-          children: "Loading suggestions"
+          children: labels["suggestions.loading"]
         }, undefined, false, undefined, this),
         (compact ? ["a", "b", "c"] : ["a", "b", "c", "d", "e", "f"]).map((key, index) => /* @__PURE__ */ jsxDEV6(PromptSkeleton, {
           index,
@@ -167383,7 +167555,7 @@ function SuggestedPromptsList({
       variant: "panel",
       onRetry,
       retryLoading,
-      retryLabel: "Regenerate"
+      retryLabel: labels["common.regenerate"]
     }, undefined, false, undefined, this);
   }
   if (prompts.length === 0) {
@@ -167433,16 +167605,17 @@ function SuggestedPromptsList({
 
 // src/react/components/chat/ChatEmptyState.tsx
 import { jsxDEV as jsxDEV7, Fragment as Fragment2 } from "react/jsx-dev-runtime";
-var CAPABILITIES = [
-  { icon: Database, label: "Catalog" },
-  { icon: Search, label: "Query" },
-  { icon: Zap, label: "Mutate" }
-];
 function ChatEmptyState({
   config,
   suggestions,
   onSelect
 }) {
+  const labels = useAssistantLabels();
+  const capabilities = [
+    { icon: Database, label: labels["emptyState.capabilities.catalog"] },
+    { icon: Search, label: labels["emptyState.capabilities.query"] },
+    { icon: Zap, label: labels["emptyState.capabilities.mutate"] }
+  ];
   const { prompts, loading, error, useDynamic, refresh, hasFetched } = suggestions;
   function handleFetch() {
     refresh();
@@ -167465,7 +167638,7 @@ function ChatEmptyState({
             children: [
               /* @__PURE__ */ jsxDEV7("p", {
                 className: "assistant-empty-state__eyebrow",
-                children: "AI Assistant"
+                children: labels["emptyState.eyebrow"]
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV7("div", {
                 className: "assistant-empty-state__icon-ring",
@@ -167485,7 +167658,7 @@ function ChatEmptyState({
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV7("div", {
                 className: "assistant-empty-state__capabilities",
-                children: CAPABILITIES.map(({ icon: Icon2, label }) => /* @__PURE__ */ jsxDEV7("span", {
+                children: capabilities.map(({ icon: Icon2, label }) => /* @__PURE__ */ jsxDEV7("span", {
                   className: "assistant-empty-state__capability",
                   children: [
                     /* @__PURE__ */ jsxDEV7(Icon2, {
@@ -167515,11 +167688,11 @@ function ChatEmptyState({
                     children: [
                       /* @__PURE__ */ jsxDEV7("span", {
                         className: "assistant-empty-state__cta-label",
-                        children: "Generate suggestions"
+                        children: labels["emptyState.generateSuggestions"]
                       }, undefined, false, undefined, this),
                       /* @__PURE__ */ jsxDEV7("span", {
                         className: "assistant-empty-state__cta-hint",
-                        children: "Tailored prompts based on your live catalog"
+                        children: labels["emptyState.generateSuggestionsHint"]
                       }, undefined, false, undefined, this)
                     ]
                   }, undefined, true, undefined, this)
@@ -167545,7 +167718,7 @@ function ChatEmptyState({
                       className: "assistant-empty-state__section-spinner",
                       "aria-hidden": true
                     }, undefined, false, undefined, this),
-                    "Generating suggestions"
+                    labels["emptyState.generating"]
                   ]
                 }, undefined, true, undefined, this) : /* @__PURE__ */ jsxDEV7(Fragment2, {
                   children: [
@@ -167553,7 +167726,7 @@ function ChatEmptyState({
                       size: 14,
                       "aria-hidden": true
                     }, undefined, false, undefined, this),
-                    "Suggested for you"
+                    labels["emptyState.suggestedForYou"]
                   ]
                 }, undefined, true, undefined, this)
               }, undefined, false, undefined, this),
@@ -167566,7 +167739,7 @@ function ChatEmptyState({
                     size: 14,
                     "aria-hidden": true
                   }, undefined, false, undefined, this),
-                  "Regenerate"
+                  labels["common.regenerate"]
                 ]
               }, undefined, true, undefined, this) : null
             ]
@@ -167588,7 +167761,7 @@ function ChatEmptyState({
             className: "assistant-empty-state__section-header",
             children: /* @__PURE__ */ jsxDEV7("h4", {
               className: "assistant-empty-state__section-title",
-              children: "Quick starts"
+              children: labels["emptyState.quickStarts"]
             }, undefined, false, undefined, this)
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV7(SuggestedPromptsList, {
@@ -182750,6 +182923,7 @@ function ChoicesPrompt({
   disabled
 }) {
   const { submitInteractiveToolResult, cancelInteractiveToolResult } = useAssistantActions();
+  const labels = useAssistantLabels();
   const [selectedIds, setSelectedIds] = useState4([]);
   const selectionCount = selectedIds.length;
   const meetsMinimum = selectionCount >= args.minSelections;
@@ -182834,11 +183008,11 @@ function ChoicesPrompt({
     cancelInteractiveToolResult,
     submitInteractiveToolResult
   ]);
-  const title2 = args.allowMultiple ? "Choose options" : "Choose one";
+  const title2 = args.allowMultiple ? labels["interactive.chooseOptions"] : labels["interactive.chooseOne"];
   return /* @__PURE__ */ jsxDEV13(InteractivePromptShell, {
     icon: ListChecks,
     title: title2,
-    keyboardHint: disabled ? undefined : "1–9 · Enter · Esc",
+    keyboardHint: disabled ? undefined : labels["interactive.choicesKeyboardHint"],
     actions: args.allowMultiple ? /* @__PURE__ */ jsxDEV13(Fragment4, {
       children: [
         /* @__PURE__ */ jsxDEV13("button", {
@@ -182846,7 +183020,7 @@ function ChoicesPrompt({
           className: "btn btn-secondary btn-compact",
           disabled,
           onClick: () => cancelInteractiveToolResult(callId),
-          children: "Cancel"
+          children: labels["common.cancel"]
         }, undefined, false, undefined, this),
         /* @__PURE__ */ jsxDEV13("button", {
           type: "button",
@@ -182864,7 +183038,7 @@ function ChoicesPrompt({
       className: "btn btn-secondary btn-compact",
       disabled,
       onClick: () => cancelInteractiveToolResult(callId),
-      children: "Cancel"
+      children: labels["common.cancel"]
     }, undefined, false, undefined, this),
     children: [
       /* @__PURE__ */ jsxDEV13("p", {
@@ -182896,6 +183070,7 @@ function ConfirmationPrompt({
   disabled
 }) {
   const { submitInteractiveToolResult, cancelInteractiveToolResult } = useAssistantActions();
+  const labels = useAssistantLabels();
   const destructive = isDestructiveAction(args.action);
   function handleConfirm() {
     submitInteractiveToolResult(callId, { confirmed: true });
@@ -182926,9 +183101,9 @@ function ConfirmationPrompt({
   ]);
   return /* @__PURE__ */ jsxDEV14(InteractivePromptShell, {
     icon: destructive ? TriangleAlert : ShieldCheck,
-    title: destructive ? "Confirm deletion" : "Confirm",
+    title: destructive ? labels["interactive.confirmDeletion"] : labels["interactive.confirm"],
     tone: destructive ? "caution" : "default",
-    keyboardHint: disabled ? undefined : "Enter · Esc",
+    keyboardHint: disabled ? undefined : labels["interactive.confirmationKeyboardHint"],
     actions: /* @__PURE__ */ jsxDEV14(Fragment5, {
       children: [
         /* @__PURE__ */ jsxDEV14("button", {
@@ -182969,6 +183144,7 @@ function ChatInteractivePrompt({
   active
 }) {
   const chatLoading = useAssistant((state4) => state4.chatLoading);
+  const invalidArgsLabel = useAssistantLabels()["interactive.invalidArgs"];
   const disabled = !chatLoading;
   if (!active || !callId) {
     return null;
@@ -182991,7 +183167,7 @@ function ChatInteractivePrompt({
   } catch (error3) {
     return /* @__PURE__ */ jsxDEV15("p", {
       className: "text-[11px] text-[var(--text-danger)]",
-      children: error3 instanceof Error ? error3.message : "Invalid interactive tool arguments"
+      children: error3 instanceof Error ? error3.message : invalidArgsLabel
     }, undefined, false, undefined, this);
   }
   return null;
@@ -183005,7 +183181,7 @@ function ActivityJsonCode({ value: value2 }) {
 `).length;
   const needsScroll = lineCount > JSON_SCROLL_LINE_THRESHOLD;
   return /* @__PURE__ */ jsxDEV16("pre", {
-    className: "font-mono text-[11px] leading-snug wrap-break-word whitespace-pre-wrap",
+    className: "wrap-break-word whitespace-pre-wrap font-mono text-[11px] leading-snug",
     style: needsScroll ? { maxHeight: "8rem", overflowY: "auto" } : undefined,
     children: /* @__PURE__ */ jsxDEV16(HighlightedJsonCode, {
       code: value2,
@@ -183031,6 +183207,7 @@ function JsonBlock({ label, value: value2 }) {
   }, undefined, true, undefined, this);
 }
 function StepDetailsBody({ step: step3 }) {
+  const labels = useAssistantLabels();
   const isInteractive = step3.kind === "tool" && isInteractiveChatTool(step3.name);
   const isWaiting = isInteractive && step3.status === "active";
   if (isInteractive) {
@@ -183045,7 +183222,7 @@ function StepDetailsBody({ step: step3 }) {
           active: step3.status === "active"
         }, undefined, false, undefined, this),
         formattedResult2 && step3.status !== "active" ? /* @__PURE__ */ jsxDEV16(JsonBlock, {
-          label: step3.status === "error" ? "Error" : "Result",
+          label: step3.status === "error" ? labels["common.error"] : labels["common.result"],
           value: formattedResult2
         }, undefined, false, undefined, this) : null
       ]
@@ -183058,14 +183235,14 @@ function StepDetailsBody({ step: step3 }) {
     className: "space-y-2",
     children: [
       showArgs ? /* @__PURE__ */ jsxDEV16(JsonBlock, {
-        label: "Arguments",
+        label: labels["activity.arguments"],
         value: formattedArgs
       }, undefined, false, undefined, this) : null,
       step3.status === "active" && !isInteractiveChatTool(step3.name) ? /* @__PURE__ */ jsxDEV16("p", {
         className: "text-[11px] text-[var(--text-chat-tertiary)]",
-        children: "Running…"
+        children: labels["activity.running"]
       }, undefined, false, undefined, this) : formattedResult ? /* @__PURE__ */ jsxDEV16(JsonBlock, {
-        label: step3.status === "error" ? "Error" : "Result",
+        label: step3.status === "error" ? labels["common.error"] : labels["common.result"],
         value: formattedResult
       }, undefined, false, undefined, this) : null
     ]
@@ -183106,9 +183283,10 @@ function ActivityStepRow({
   onToggle,
   isLast
 }) {
+  const labels = useAssistantLabels();
   const isExpandable = stepHasDetails(step3) || step3.kind === "tool" || step3.status === "active";
   const isWaitingInteractive = step3.kind === "tool" && isInteractiveChatTool(step3.name) && step3.status === "active";
-  const label = chatActivityStepLabel(step3);
+  const label = chatActivityStepLabel(step3, labels);
   return /* @__PURE__ */ jsxDEV16("li", {
     className: isWaitingInteractive ? "assistant-activity-step assistant-activity-step--waiting" : "assistant-activity-step",
     children: [
@@ -183133,13 +183311,13 @@ function ActivityStepRow({
         children: [
           isExpandable ? /* @__PURE__ */ jsxDEV16("button", {
             type: "button",
-            className: `assistant-activity-step__header${step3.status === "active" ? " assistant-activity-step__header--active" : ""}`,
+            className: cn("assistant-activity-step__header", step3.status === "active" && "assistant-activity-step__header--active"),
             "aria-expanded": expanded,
             onClick: onToggle,
             children: [
               /* @__PURE__ */ jsxDEV16(ChevronRight, {
                 size: 14,
-                className: `assistant-activity-step__chevron${expanded ? " assistant-activity-step__chevron--open" : ""}`,
+                className: cn("assistant-activity-step__chevron", expanded && "assistant-activity-step__chevron--open"),
                 "aria-hidden": true
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV16("span", {
@@ -183168,7 +183346,7 @@ function ActivityStepRow({
             }, undefined, false, undefined, this)
           }, undefined, false, undefined, this),
           expanded && isExpandable ? /* @__PURE__ */ jsxDEV16("div", {
-            className: `assistant-activity-step__details${isWaitingInteractive ? " assistant-activity-step__details--interactive" : ""}`,
+            className: cn("assistant-activity-step__details", isWaitingInteractive && "assistant-activity-step__details--interactive"),
             children: /* @__PURE__ */ jsxDEV16(StepDetailsBody, {
               step: step3
             }, undefined, false, undefined, this)
@@ -183192,14 +183370,15 @@ function useActivityExpansion(steps) {
   return { expandedStepId, toggleStep };
 }
 function ChatActivity({ steps, streaming }) {
-  const [panelCollapsed, setPanelCollapsed] = useState5(false);
+  const labels = useAssistantLabels();
+  const [panelCollapsed, setPanelCollapsed] = useState5(true);
   const { expandedStepId, toggleStep } = useActivityExpansion(steps);
   const hasActiveStep = steps.some((step3) => step3.status === "active");
   useEffect7(() => {
-    if (streaming || hasActiveStep) {
+    if (hasActiveStep) {
       setPanelCollapsed(false);
     }
-  }, [streaming, hasActiveStep]);
+  }, [hasActiveStep]);
   if (steps.length === 0)
     return null;
   return /* @__PURE__ */ jsxDEV16("div", {
@@ -183218,12 +183397,12 @@ function ChatActivity({ steps, streaming }) {
             children: [
               /* @__PURE__ */ jsxDEV16(ChevronRight, {
                 size: 14,
-                className: `assistant-activity__toggle-chevron${panelCollapsed ? "" : " assistant-activity__toggle-chevron--open"}`,
+                className: cn("assistant-activity__toggle-chevron", !panelCollapsed && "assistant-activity__toggle-chevron--open"),
                 "aria-hidden": true
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV16("span", {
                 className: "assistant-activity__title",
-                children: "Trace"
+                children: labels["activity.trace"]
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV16("span", {
                 className: "assistant-activity__count",
@@ -183233,7 +183412,7 @@ function ChatActivity({ steps, streaming }) {
           }, undefined, true, undefined, this),
           hasActiveStep ? /* @__PURE__ */ jsxDEV16("span", {
             className: "assistant-activity__live",
-            children: "Live"
+            children: labels["activity.live"]
           }, undefined, false, undefined, this) : null
         ]
       }, undefined, true, undefined, this),
@@ -183331,18 +183510,18 @@ function splitToolValues(value2) {
 
 // src/react/components/chat/ChatReplySuggestions.tsx
 import { jsxDEV as jsxDEV17 } from "react/jsx-dev-runtime";
-function fieldBadgeLabel(label) {
+function fieldBadgeLabel(label, labels) {
   switch (label.toLowerCase()) {
     case "model":
-      return "Model";
+      return labels["replySuggestions.badges.model"];
     case "enabled":
-      return "Status";
+      return labels["replySuggestions.badges.status"];
     case "tools":
-      return "Tools";
+      return labels["replySuggestions.badges.tools"];
     case "dataclass":
-      return "Dataclass";
+      return labels["replySuggestions.badges.dataclass"];
     case "filter":
-      return "Filter";
+      return labels["replySuggestions.badges.filter"];
     default:
       return label;
   }
@@ -183351,6 +183530,7 @@ function StructuredSuggestionRow({
   suggestion,
   index: index2,
   disabled,
+  labels,
   onSelect
 }) {
   const toolsField = suggestion.fields.find((field) => field.label.toLowerCase() === "tools");
@@ -183386,7 +183566,7 @@ function StructuredSuggestionRow({
                 children: [
                   /* @__PURE__ */ jsxDEV17("span", {
                     className: "assistant-reply-badge__label",
-                    children: fieldBadgeLabel(field.label)
+                    children: fieldBadgeLabel(field.label, labels)
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV17("span", {
                     className: "assistant-reply-badge__value",
@@ -183457,6 +183637,7 @@ function ChatReplySuggestions({
   disabled,
   onSelect
 }) {
+  const labels = useAssistantLabels();
   const parsed = suggestions.suggestions.map((text11) => ({
     raw: text11,
     parsed: parseSuggestionText(text11)
@@ -183482,11 +183663,11 @@ function ChatReplySuggestions({
     return () => window.removeEventListener("keydown", onKeyDown);
   }, [disabled, onSelect, suggestions.suggestions]);
   return /* @__PURE__ */ jsxDEV17("fieldset", {
-    className: "assistant-reply-suggestions border-0 p-0 m-0 min-w-0",
+    className: "assistant-reply-suggestions m-0 min-w-0 border-0 p-0",
     children: [
       /* @__PURE__ */ jsxDEV17("legend", {
         className: "sr-only",
-        children: "Suggested replies"
+        children: labels["replySuggestions.legend"]
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsxDEV17("div", {
         className: "assistant-reply-suggestions__panel",
@@ -183499,6 +183680,7 @@ function ChatReplySuggestions({
                   suggestion: entry.parsed,
                   index: index2,
                   disabled,
+                  labels,
                   onSelect: () => onSelect(entry.raw)
                 }, entry.raw, false, undefined, this);
               }
@@ -183527,7 +183709,7 @@ function ChatReplySuggestions({
                 children: suggestions.suggestions.length
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV17("span", {
-                children: "to pick · or type below"
+                children: labels["replySuggestions.pickHint"]
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this)
@@ -183540,6 +183722,7 @@ function ChatReplySuggestions({
 // src/react/components/chat/LlmSetupPrompt.tsx
 import { jsxDEV as jsxDEV18 } from "react/jsx-dev-runtime";
 function LlmSetupPrompt({ variant, onConfigure }) {
+  const labels = useAssistantLabels();
   if (variant === "inline") {
     return /* @__PURE__ */ jsxDEV18("div", {
       className: "assistant-llm-setup assistant-llm-setup--inline",
@@ -183549,16 +183732,16 @@ function LlmSetupPrompt({ variant, onConfigure }) {
         children: [
           /* @__PURE__ */ jsxDEV18("span", {
             className: "assistant-llm-setup__label",
-            children: "LLM not connected."
+            children: labels["llmSetup.notConnected"]
           }, undefined, false, undefined, this),
           " ",
-          "Add a cloud or local provider in",
+          labels["llmSetup.addProviderBeforeLink"],
           " ",
           /* @__PURE__ */ jsxDEV18("button", {
             type: "button",
             className: "assistant-llm-setup__action",
             onClick: onConfigure,
-            children: "LLM settings"
+            children: labels["llmSetup.settingsLink"]
           }, undefined, false, undefined, this),
           "."
         ]
@@ -183583,14 +183766,14 @@ function LlmSetupPrompt({ variant, onConfigure }) {
           className: "assistant-llm-setup__copy",
           children: [
             /* @__PURE__ */ jsxDEV18("strong", {
-              children: "Connect an LLM"
+              children: labels["llmSetup.connectTitle"]
             }, undefined, false, undefined, this),
             /* @__PURE__ */ jsxDEV18("span", {
               className: "assistant-llm-setup__sep",
               "aria-hidden": true,
               children: "·"
             }, undefined, false, undefined, this),
-            "OpenAI-compatible endpoint — cloud or local"
+            labels["llmSetup.connectDescription"]
           ]
         }, undefined, true, undefined, this),
         /* @__PURE__ */ jsxDEV18("button", {
@@ -183603,7 +183786,7 @@ function LlmSetupPrompt({ variant, onConfigure }) {
               strokeWidth: 2,
               "aria-hidden": true
             }, undefined, false, undefined, this),
-            "Configure"
+            labels["llmSetup.configure"]
           ]
         }, undefined, true, undefined, this)
       ]
@@ -183614,6 +183797,7 @@ function LlmSetupPrompt({ variant, onConfigure }) {
 // src/react/components/chat/ChatMessage.tsx
 import { jsxDEV as jsxDEV19 } from "react/jsx-dev-runtime";
 function TypingIndicator() {
+  const labels = useAssistantLabels();
   return /* @__PURE__ */ jsxDEV19("output", {
     className: "assistant-typing",
     "aria-live": "polite",
@@ -183624,7 +183808,7 @@ function TypingIndicator() {
       }, index2, false, undefined, this)),
       /* @__PURE__ */ jsxDEV19("span", {
         className: "sr-only",
-        children: "Assistant is thinking"
+        children: labels["message.thinking"]
       }, undefined, false, undefined, this)
     ]
   }, undefined, true, undefined, this);
@@ -183636,6 +183820,7 @@ function ChatMessageView({
   onRetryError,
   retryErrorLoading
 }) {
+  const labels = useAssistantLabels();
   const isUser = message.role === "user";
   const streaming = Boolean(message.streaming);
   const activity = message.activity ?? [];
@@ -183705,13 +183890,13 @@ function ChatMessageView({
           }, undefined, false, undefined, this)
         }, undefined, false, undefined, this),
         showCard ? /* @__PURE__ */ jsxDEV19("div", {
-          className: `assistant-assistant-card${message.isError ? " assistant-assistant-card--error" : ""}`,
+          className: `assistant-assistant-card${message.isError ? "assistant-assistant-card--error" : ""}`,
           children: [
             /* @__PURE__ */ jsxDEV19("header", {
               className: "assistant-assistant-card__meta",
               children: /* @__PURE__ */ jsxDEV19("span", {
                 className: "assistant-role-label",
-                children: "Assistant"
+                children: labels["message.assistantRole"]
               }, undefined, false, undefined, this)
             }, undefined, false, undefined, this),
             message.isError ? /* @__PURE__ */ jsxDEV19("div", {
@@ -183771,6 +183956,7 @@ function ChatMessageScroll({
   children: children2,
   dependencyKey
 }) {
+  const scrollLabel = useAssistantLabels()["scroll.toBottom"];
   const scrollContainerRef = useRef4(null);
   const contentRef = useRef4(null);
   const stickToBottomRef = useRef4(true);
@@ -183837,7 +184023,7 @@ function ChatMessageScroll({
     children: [
       /* @__PURE__ */ jsxDEV20("div", {
         ref: scrollContainerRef,
-        className: "h-full overflow-x-hidden overflow-y-auto overscroll-contain bg-[var(--overlay-subtle)]",
+        className: "h-full overflow-y-auto overflow-x-hidden overscroll-contain bg-[var(--overlay-subtle)]",
         "aria-live": "polite",
         children: /* @__PURE__ */ jsxDEV20("div", {
           ref: contentRef,
@@ -183854,8 +184040,8 @@ function ChatMessageScroll({
       showScrollDown ? /* @__PURE__ */ jsxDEV20("button", {
         type: "button",
         className: "assistant-scroll-down",
-        "aria-label": "Scroll to bottom",
-        title: "Scroll to bottom",
+        "aria-label": scrollLabel,
+        title: scrollLabel,
         onClick: () => scrollToBottom("smooth"),
         children: /* @__PURE__ */ jsxDEV20(ArrowDown, {
           size: 16,
@@ -183937,6 +184123,7 @@ function SystemPromptField({
   onReset,
   disabled = false
 }) {
+  const labels = useAssistantLabels();
   const [mode, setMode] = useState7("preview");
   const usingDefault = !value2.trim() || value2.trim() === defaultPrompt.trim();
   const previewContent = usingDefault ? defaultPrompt : value2;
@@ -183953,26 +184140,26 @@ function SystemPromptField({
               children: [
                 /* @__PURE__ */ jsxDEV22("span", {
                   className: "assistant-system-prompt__label",
-                  children: "System prompt"
+                  children: labels["systemPrompt.label"]
                 }, undefined, false, undefined, this),
                 usingDefault ? /* @__PURE__ */ jsxDEV22("span", {
                   className: "assistant-system-prompt__tag",
-                  children: "Default"
+                  children: labels["systemPrompt.defaultTag"]
                 }, undefined, false, undefined, this) : null
               ]
             }, undefined, true, undefined, this),
             /* @__PURE__ */ jsxDEV22("div", {
               className: "assistant-system-prompt__modes",
               role: "tablist",
-              "aria-label": "System prompt view",
+              "aria-label": labels["systemPrompt.viewAria"],
               children: [
                 !usingDefault && onReset ? /* @__PURE__ */ jsxDEV22("button", {
                   type: "button",
                   className: "assistant-system-prompt__mode",
                   onClick: onReset,
                   disabled,
-                  "aria-label": "Reset system prompt",
-                  title: "Reset to default",
+                  "aria-label": labels["systemPrompt.resetAria"],
+                  title: labels["systemPrompt.resetTitle"],
                   children: /* @__PURE__ */ jsxDEV22(RotateCcw, {
                     size: 12,
                     "aria-hidden": true
@@ -183983,8 +184170,8 @@ function SystemPromptField({
                   className: `assistant-system-prompt__mode ${mode === "edit" ? "assistant-system-prompt__mode--active" : ""}`.trim(),
                   role: "tab",
                   "aria-selected": mode === "edit",
-                  "aria-label": "Edit",
-                  title: "Edit",
+                  "aria-label": labels["common.edit"],
+                  title: labels["common.edit"],
                   onClick: () => setMode("edit"),
                   children: /* @__PURE__ */ jsxDEV22(Pencil, {
                     size: 12,
@@ -183996,8 +184183,8 @@ function SystemPromptField({
                   className: `assistant-system-prompt__mode ${mode === "preview" ? "assistant-system-prompt__mode--active" : ""}`.trim(),
                   role: "tab",
                   "aria-selected": mode === "preview",
-                  "aria-label": "Preview",
-                  title: "Preview",
+                  "aria-label": labels["common.preview"],
+                  title: labels["common.preview"],
                   onClick: () => setMode("preview"),
                   children: /* @__PURE__ */ jsxDEV22(Eye, {
                     size: 12,
@@ -184014,14 +184201,14 @@ function SystemPromptField({
             className: "assistant-system-prompt__editor",
             value: value2,
             onChange,
-            placeholder: "Optional — replaces app default",
+            placeholder: labels["systemPrompt.placeholder"],
             disabled,
-            "aria-label": "System prompt editor"
+            "aria-label": labels["systemPrompt.editorAria"]
           }, undefined, false, undefined, this)
         }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV22("div", {
           className: "assistant-system-prompt__doc",
           role: "tabpanel",
-          "aria-label": "System prompt preview",
+          "aria-label": labels["systemPrompt.previewAria"],
           children: /* @__PURE__ */ jsxDEV22(MarkdownContent, {
             content: previewContent,
             className: "assistant-system-prompt__md"
@@ -184035,6 +184222,7 @@ function SystemPromptField({
 // src/react/components/chat/LlmSettingsStrip.tsx
 import { jsxDEV as jsxDEV23, Fragment as Fragment6 } from "react/jsx-dev-runtime";
 function LlmSettingsStrip({ open: open2, onClose }) {
+  const labels = useAssistantLabels();
   const {
     getLlmSettingsForm,
     saveLlmSettings,
@@ -184062,11 +184250,11 @@ function LlmSettingsStrip({ open: open2, onClose }) {
       setHasOverrides(await llmSettingsHasOverrides());
       setAdvancedOpen(false);
     } catch (loadError) {
-      setError(loadError instanceof Error ? loadError.message : "Failed to load LLM settings");
+      setError(loadError instanceof Error ? loadError.message : labels["llmSettings.failedToLoad"]);
     } finally {
       setLoading(false);
     }
-  }, [getLlmSettingsForm, llmSettingsHasOverrides]);
+  }, [getLlmSettingsForm, labels, llmSettingsHasOverrides]);
   useEffect10(() => {
     if (open2) {
       loadForm();
@@ -184088,7 +184276,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
     try {
       const result = await testLlmSettings(form);
       if (result.ok) {
-        setTestResult(`Connected · ${result.model}`);
+        setTestResult(formatLabel(labels["llmSettings.connected"], { model: result.model }));
       } else {
         setError(result.error);
       }
@@ -184105,7 +184293,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
       await saveLlmSettings(form);
       onClose();
     } catch (saveError) {
-      setError(saveError instanceof Error ? saveError.message : "Failed to save LLM settings");
+      setError(saveError instanceof Error ? saveError.message : labels["llmSettings.failedToSave"]);
     } finally {
       setSaving(false);
     }
@@ -184126,7 +184314,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
       }
       await loadForm();
     } catch (resetError) {
-      setError(resetError instanceof Error ? resetError.message : "Failed to reset LLM settings");
+      setError(resetError instanceof Error ? resetError.message : labels["llmSettings.failedToReset"]);
     } finally {
       setSaving(false);
     }
@@ -184137,7 +184325,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
   const statusTone = error3 ? "error" : testResult ? "success" : null;
   return /* @__PURE__ */ jsxDEV23("section", {
     className: "assistant-llm-settings-strip",
-    "aria-label": "LLM settings",
+    "aria-label": labels["llmSettings.ariaLabel"],
     children: [
       /* @__PURE__ */ jsxDEV23("div", {
         className: "assistant-llm-settings-strip__header",
@@ -184150,7 +184338,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 "aria-hidden": true
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV23("span", {
-                children: "LLM settings"
+                children: labels["llmSettings.title"]
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
@@ -184162,8 +184350,8 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 className: "assistant-btn assistant-btn--ghost assistant-llm-settings-strip__header-btn",
                 onClick: () => void handleTest(),
                 disabled: !form || saving || testing,
-                "aria-label": "Test connection",
-                title: "Test connection",
+                "aria-label": labels["llmSettings.testConnection"],
+                title: labels["llmSettings.testConnection"],
                 children: testing ? /* @__PURE__ */ jsxDEV23(LoaderCircle, {
                   size: 14,
                   className: "assistant-icon-spin",
@@ -184178,8 +184366,8 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 className: "assistant-btn assistant-btn--ghost assistant-llm-settings-strip__header-btn",
                 onClick: () => void handleReset(),
                 disabled: saving || testing,
-                "aria-label": "Reset all settings",
-                title: "Reset all settings",
+                "aria-label": labels["llmSettings.resetAllSettings"],
+                title: labels["llmSettings.resetAllSettings"],
                 children: /* @__PURE__ */ jsxDEV23(RotateCcw, {
                   size: 14,
                   "aria-hidden": true
@@ -184189,7 +184377,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 type: "button",
                 className: "assistant-btn assistant-btn--ghost assistant-llm-settings-strip__header-btn",
                 onClick: onClose,
-                "aria-label": "Close LLM settings",
+                "aria-label": labels["llmSettings.close"],
                 children: /* @__PURE__ */ jsxDEV23(X, {
                   size: 14,
                   "aria-hidden": true
@@ -184208,7 +184396,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
             className: "assistant-icon-spin",
             "aria-hidden": true
           }, undefined, false, undefined, this),
-          "Loading…"
+          labels["common.loading"]
         ]
       }, undefined, true, undefined, this) : form ? /* @__PURE__ */ jsxDEV23("form", {
         className: "assistant-llm-settings-strip__form",
@@ -184222,14 +184410,14 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 children: [
                   /* @__PURE__ */ jsxDEV23("span", {
                     className: "assistant-llm-settings-strip__label",
-                    children: "Base URL"
+                    children: labels["llmSettings.baseUrl"]
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV23("input", {
                     className: "assistant-input assistant-llm-settings-strip__input assistant-llm-settings-strip__input--mono",
                     type: "url",
                     value: form.baseUrl,
                     onChange: (event3) => updateField("baseUrl", event3.target.value),
-                    placeholder: "https://api.openai.com/v1",
+                    placeholder: labels["llmSettings.baseUrlPlaceholder"],
                     autoComplete: "off",
                     spellCheck: false
                   }, undefined, false, undefined, this)
@@ -184240,14 +184428,14 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 children: [
                   /* @__PURE__ */ jsxDEV23("span", {
                     className: "assistant-llm-settings-strip__label",
-                    children: "API key"
+                    children: labels["llmSettings.apiKey"]
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV23("input", {
                     className: "assistant-input assistant-llm-settings-strip__input",
                     type: "password",
                     value: form.apiKey,
                     onChange: (event3) => updateField("apiKey", event3.target.value),
-                    placeholder: form.hasStoredApiKey ? "Configured — leave blank to keep" : "sk-…",
+                    placeholder: form.hasStoredApiKey ? labels["llmSettings.apiKeyConfiguredPlaceholder"] : labels["llmSettings.apiKeyPlaceholder"],
                     autoComplete: "off",
                     spellCheck: false
                   }, undefined, false, undefined, this)
@@ -184258,14 +184446,14 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 children: [
                   /* @__PURE__ */ jsxDEV23("span", {
                     className: "assistant-llm-settings-strip__label",
-                    children: "Model"
+                    children: labels["llmSettings.model"]
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV23("input", {
                     className: "assistant-input assistant-llm-settings-strip__input",
                     type: "text",
                     value: form.model,
                     onChange: (event3) => updateField("model", event3.target.value),
-                    placeholder: "gpt-4o-mini",
+                    placeholder: labels["llmSettings.modelPlaceholder"],
                     autoComplete: "off",
                     spellCheck: false
                   }, undefined, false, undefined, this)
@@ -184283,7 +184471,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                     className: `assistant-llm-settings-strip__chevron ${advancedOpen ? "assistant-llm-settings-strip__chevron--open" : ""}`.trim(),
                     "aria-hidden": true
                   }, undefined, false, undefined, this),
-                  "Advanced"
+                  labels["llmSettings.advanced"]
                 ]
               }, undefined, true, undefined, this),
               advancedOpen ? /* @__PURE__ */ jsxDEV23("div", {
@@ -184295,14 +184483,14 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                     children: [
                       /* @__PURE__ */ jsxDEV23("span", {
                         className: "assistant-llm-settings-strip__label",
-                        children: "Model list"
+                        children: labels["llmSettings.modelList"]
                       }, undefined, false, undefined, this),
                       /* @__PURE__ */ jsxDEV23("input", {
                         className: "assistant-input assistant-llm-settings-strip__input",
                         type: "text",
                         value: form.modelsText,
                         onChange: (event3) => updateField("modelsText", event3.target.value),
-                        placeholder: "Optional — comma-separated",
+                        placeholder: labels["llmSettings.modelListPlaceholder"],
                         autoComplete: "off",
                         spellCheck: false
                       }, undefined, false, undefined, this)
@@ -184337,7 +184525,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                     size: 14,
                     "aria-hidden": true
                   }, undefined, false, undefined, this),
-                  "Reset all"
+                  labels["llmSettings.resetAll"]
                 ]
               }, undefined, true, undefined, this) : null,
               /* @__PURE__ */ jsxDEV23("button", {
@@ -184345,7 +184533,7 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                 className: "assistant-btn assistant-btn--ghost assistant-llm-settings-strip__footer-btn",
                 onClick: onClose,
                 disabled: saving,
-                children: "Cancel"
+                children: labels["common.cancel"]
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV23("button", {
                 type: "submit",
@@ -184358,9 +184546,9 @@ function LlmSettingsStrip({ open: open2, onClose }) {
                       className: "assistant-icon-spin",
                       "aria-hidden": true
                     }, undefined, false, undefined, this),
-                    "Saving"
+                    labels["common.saving"]
                   ]
-                }, undefined, true, undefined, this) : "Save"
+                }, undefined, true, undefined, this) : labels["common.save"]
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this)
@@ -184390,12 +184578,13 @@ function SuggestedPromptsStrip({
   onSelect,
   suggestions
 }) {
+  const labels = useAssistantLabels();
   if (!open2)
     return null;
   const { prompts, loading, error: error3, hasFetched } = suggestions;
   return /* @__PURE__ */ jsxDEV25("section", {
     className: "assistant-suggestions-strip",
-    "aria-label": "Suggested prompts",
+    "aria-label": labels["suggestions.ariaLabel"],
     children: [
       /* @__PURE__ */ jsxDEV25("div", {
         className: "assistant-suggestions-strip__header",
@@ -184408,7 +184597,7 @@ function SuggestedPromptsStrip({
                 "aria-hidden": true
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV25("span", {
-                children: "Suggestions"
+                children: labels["suggestions.title"]
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
@@ -184429,14 +184618,14 @@ function SuggestedPromptsStrip({
                     size: 14,
                     "aria-hidden": true
                   }, undefined, false, undefined, this),
-                  hasFetched ? "Regenerate" : "Generate"
+                  hasFetched ? labels["common.regenerate"] : labels["suggestions.generate"]
                 ]
               }, undefined, true, undefined, this),
               /* @__PURE__ */ jsxDEV25("button", {
                 type: "button",
                 className: "assistant-btn assistant-btn--ghost assistant-suggestions-strip__close",
                 onClick: onClose,
-                "aria-label": "Close suggestions",
+                "aria-label": labels["suggestions.close"],
                 children: /* @__PURE__ */ jsxDEV25(X, {
                   size: 14,
                   "aria-hidden": true
@@ -184469,10 +184658,11 @@ function useComposerCommands({
   onChange,
   surface,
   onExecute,
-  disabled = false
+  disabled = false,
+  labels
 }) {
-  const suggestions = useMemo6(() => filterChatCommands(value2, surface), [value2, surface]);
-  const menuOpen = !disabled && shouldShowChatCommandMenu(value2, surface);
+  const suggestions = useMemo6(() => filterChatCommands(value2, surface, labels), [value2, surface, labels]);
+  const menuOpen = !disabled && shouldShowChatCommandMenu(value2, surface, labels);
   const [selectedIndex, setSelectedIndex] = useState9(0);
   const handleInputChange = (next3) => {
     setSelectedIndex(0);
@@ -184576,7 +184766,8 @@ function useSuggestedPrompts(input) {
     enabled,
     dynamicSuggestedPrompts,
     listTools,
-    fetchSuggestedPrompts
+    fetchSuggestedPrompts,
+    failedToLoadLabel
   } = input;
   const useDynamic = dynamicSuggestedPrompts !== false && llmEnabled && enabled && Boolean(fetchSuggestedPrompts);
   const [prompts, setPrompts] = useState10(useDynamic ? [] : staticPrompts ?? []);
@@ -184618,7 +184809,7 @@ function useSuggestedPrompts(input) {
       }
       setHasFetched(true);
     } catch (loadError) {
-      setError(loadError instanceof Error ? loadError.message : "Failed to load suggestions");
+      setError(loadError instanceof Error ? loadError.message : failedToLoadLabel ?? "Failed to load suggestions");
       setPrompts(staticPrompts ?? []);
       setHasFetched(true);
     } finally {
@@ -184630,7 +184821,8 @@ function useSuggestedPrompts(input) {
     listTools,
     llmEnabled,
     model,
-    staticPrompts
+    staticPrompts,
+    failedToLoadLabel
   ]);
   return { prompts, loading, error: error3, useDynamic, refresh, hasFetched };
 }
@@ -184643,7 +184835,7 @@ function AssistantPanel({
   emptyState: emptyStateOverride,
   ui: uiOverride
 }) {
-  const { config: config5 } = useAssistantContext();
+  const { config: config5, labels } = useAssistantContext();
   const messages = useAssistant((s3) => s3.messages);
   const chatLoading = useAssistant((s3) => s3.chatLoading);
   const llmEnabled = useAssistant((s3) => s3.llmEnabled);
@@ -184678,7 +184870,8 @@ function AssistantPanel({
     enabled: true,
     dynamicSuggestedPrompts: emptyState?.dynamicSuggestedPrompts,
     listTools: config5.listTools,
-    fetchSuggestedPrompts: config5.fetchSuggestedPrompts
+    fetchSuggestedPrompts: config5.fetchSuggestedPrompts,
+    failedToLoadLabel: labels["suggestions.failedToLoad"]
   });
   const visibleMessages = useMemo7(() => messages.filter((message) => message.id !== "welcome" && (message.role === "user" || message.role === "assistant")), [messages]);
   const lastErrorMessageId = useMemo7(() => {
@@ -184711,7 +184904,8 @@ function AssistantPanel({
     const commandResult = await runAssistantChatCommand(text11, {
       clearMessages: handleClearChat,
       setError: setCommandError,
-      streaming
+      streaming,
+      labels
     });
     if (commandResult.handled) {
       if (commandResult.clearInput) {
@@ -184742,6 +184936,7 @@ function AssistantPanel({
     },
     surface: "assistant",
     disabled: streaming,
+    labels,
     onExecute: async (commandText) => {
       await handleSubmit(commandText);
     }
@@ -184801,7 +184996,7 @@ function AssistantPanel({
               children: [
                 /* @__PURE__ */ jsxDEV26("h2", {
                   className: "assistant-panel__title",
-                  children: header.title ?? "Assistant"
+                  children: header.title ?? labels["header.title"]
                 }, undefined, false, undefined, this),
                 header.subtitle ? /* @__PURE__ */ jsxDEV26("p", {
                   className: "assistant-panel__subtitle",
@@ -184862,7 +185057,7 @@ function AssistantPanel({
               /* @__PURE__ */ jsxDEV26("button", {
                 type: "button",
                 className: "assistant-command-error__dismiss",
-                "aria-label": "Dismiss",
+                "aria-label": labels["common.dismiss"],
                 onClick: () => setCommandError(null),
                 children: /* @__PURE__ */ jsxDEV26(X, {
                   size: 14,
@@ -184881,7 +185076,7 @@ function AssistantPanel({
             textareaRef,
             llmEnabled: llmEnabled && showModelSelector,
             inputDisabled: !llmEnabled,
-            placeholder: llmEnabled ? ui.composerPlaceholder : "LLM not configured — chat is disabled",
+            placeholder: llmEnabled ? ui.composerPlaceholder ?? labels["composer.placeholder"] : labels["composer.placeholderDisabled"],
             toolbar: {
               showLlmSettings,
               onOpenLlmSettings: openLlmSettings,
@@ -184927,13 +185122,17 @@ function AssistantRoot({
 }
 export {
   useComposerCommands,
+  useAssistantLabels,
   useAssistantContext,
   useAssistantActions,
   useAssistant,
+  resolveAssistantLabels,
+  formatLabel,
   ModelSelector,
   MermaidDiagram,
   MarkdownContent,
   LlmSettingsStrip,
+  DEFAULT_ASSISTANT_LABELS,
   ChatReplySuggestions,
   ChatMessageView,
   ChatMessageScroll,
@@ -184944,5 +185143,6 @@ export {
   AssistantRoot,
   AssistantProvider,
   AssistantBootstrap,
-  Assistant
+  Assistant,
+  ASSISTANT_LABEL_KEYS
 };