@jskit-ai/assistant-runtime 0.1.237 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,138 @@
+# Changelog
+
+## 0.2.0 - 2026-10-29
+
+- Translation ready: every user-visible text is a message key with its English in `locales/en.json`, so an app translates it by supplying translation files only. With no translations, texts and behaviour are unchanged. See the guide "Translating a JSKIT app".
+
+### New message keys (90)
+
+All keys in `locales/en.json` (exported as `./locales/en.json`) are new in this version.
+
+<details><summary>Key list</summary>
+
+- `jskit.assistant.runtime.authenticationRequired`
+- `jskit.assistant.runtime.workspace.selectionRequired`
+- `jskit.assistant.runtime.route.surfaceHeaderRequired`
+- `jskit.assistant.runtime.route.notFound`
+- `jskit.assistant.runtime.route.surfaceForbidden`
+- `jskit.assistant.runtime.route.assistantNotFound`
+- `jskit.assistant.runtime.connection.unavailable`
+- `jskit.assistant.runtime.connection.selectionNotAllowed`
+- `jskit.assistant.runtime.connection.applicationAi`
+- `jskit.assistant.runtime.connection.applicationDefault`
+- `jskit.assistant.runtime.provider.notConfigured`
+- `jskit.assistant.runtime.conversation.notFound`
+- `jskit.assistant.runtime.conversation.idInvalid`
+- `jskit.assistant.runtime.conversation.createFailed`
+- `jskit.assistant.runtime.conversation.assistantLabel`
+- `jskit.assistant.runtime.conversation.welcomeMessage`
+- `jskit.assistant.runtime.conversation.placeholder`
+- `jskit.assistant.runtime.conversation.startedAtUnknown`
+- `jskit.assistant.runtime.conversation.status.active`
+- `jskit.assistant.runtime.conversation.status.completed`
+- `jskit.assistant.runtime.conversation.status.failed`
+- `jskit.assistant.runtime.conversation.status.aborted`
+- `jskit.assistant.runtime.conversation.status.unknown`
+- `jskit.assistant.runtime.request.messageIdInvalid`
+- `jskit.assistant.runtime.request.inputRequired`
+- `jskit.assistant.runtime.request.messageIdConflict`
+- `jskit.assistant.runtime.request.unconfirmed`
+- `jskit.assistant.runtime.request.failed`
+- `jskit.assistant.runtime.request.cancelled`
+- `jskit.assistant.runtime.request.noOutput`
+- `jskit.assistant.runtime.request.notConfirmed`
+- `jskit.assistant.runtime.attachments.invalidIds`
+- `jskit.assistant.runtime.attachments.notConfigured`
+- `jskit.assistant.runtime.attachments.noLongerAccepted`
+- `jskit.assistant.runtime.attachments.clearFailed`
+- `jskit.assistant.runtime.subscription.idRequired`
+- `jskit.assistant.runtime.subscription.failed`
+- `jskit.assistant.runtime.history.refreshFailed`
+- `jskit.assistant.runtime.history.loadFailed`
+- `jskit.assistant.runtime.history.listFailed`
+- `jskit.assistant.runtime.history.conversationLoadFailed`
+- `jskit.assistant.runtime.accessDenied`
+- `jskit.assistant.runtime.delivery.waitingForStep`
+- `jskit.assistant.runtime.delivery.unconfirmedBeforeClose`
+- `jskit.assistant.runtime.delivery.stillUnknown`
+- `jskit.assistant.runtime.delivery.checkFailed`
+- `jskit.assistant.runtime.delivery.notConfirmed`
+- `jskit.assistant.runtime.goal.budgetsUnsupported`
+- `jskit.assistant.runtime.goal.changeFailed`
+- `jskit.assistant.runtime.goal.unavailable`
+- `jskit.assistant.runtime.goal.resumeMessage`
+- `jskit.assistant.runtime.goal.cancelMessage`
+- `jskit.assistant.runtime.composer.questionsPlaceholder`
+- `jskit.assistant.runtime.composer.choicesPlaceholder`
+- `jskit.assistant.runtime.composer.questionsHint`
+- `jskit.assistant.runtime.tool.progress`
+- `jskit.assistant.runtime.tool.status.pending`
+- `jskit.assistant.runtime.tool.status.done`
+- `jskit.assistant.runtime.tool.status.failed`
+- `jskit.assistant.runtime.tool.status.interrupted`
+- `jskit.assistant.runtime.surface.newConversation`
+- `jskit.assistant.runtime.surface.conversations`
+- `jskit.assistant.runtime.surface.activity`
+- `jskit.assistant.runtime.surface.toolActivity`
+- `jskit.assistant.runtime.surface.conversation`
+- `jskit.assistant.runtime.surface.responseCanceled`
+- `jskit.assistant.runtime.surface.startNewConversation`
+- `jskit.assistant.runtime.surface.refresh`
+- `jskit.assistant.runtime.surface.close`
+- `jskit.assistant.runtime.surface.loadingConversationsLabel`
+- `jskit.assistant.runtime.surface.loadingConversations`
+- `jskit.assistant.runtime.surface.savedConversations`
+- `jskit.assistant.runtime.surface.noSavedConversations`
+- `jskit.assistant.runtime.surface.untitledConversation`
+- `jskit.assistant.runtime.surface.loadOlderConversations`
+- `jskit.assistant.runtime.surface.messageCount`
+- `jskit.assistant.runtime.viewer.you`
+- `jskit.assistant.runtime.settings.title`
+- `jskit.assistant.runtime.settings.noPermission`
+- `jskit.assistant.runtime.settings.save`
+- `jskit.assistant.runtime.settings.systemPrompt`
+- `jskit.assistant.runtime.settings.subtitle`
+- `jskit.assistant.runtime.settings.subtitleWorkspace`
+- `jskit.assistant.runtime.settings.subtitleSurface`
+- `jskit.assistant.runtime.settings.notConfigured`
+- `jskit.assistant.runtime.settings.workspaceUnavailable`
+- `jskit.assistant.runtime.settings.selectWorkspace`
+- `jskit.assistant.runtime.settings.updateFailed`
+- `jskit.errors.assistant_history_inspection_required`
+- `jskit.errors.assistant_subscription_transport_failed`
+
+</details>
+
+### Codes (27)
+
+Error, field-error and message codes this package sends, with their English. Undotted codes kept their existing values and render from `jskit.errors.<code>`.
+
+| Code | English |
+| --- | --- |
+| `assistant.runtime.authenticationRequired` | Authentication required. |
+| `assistant.runtime.workspace.selectionRequired` | Workspace selection required. |
+| `assistant.runtime.route.surfaceHeaderRequired` | Assistant surface header x-jskit-surface is required. |
+| `assistant.runtime.route.notFound` | Assistant route not found. |
+| `assistant.runtime.route.surfaceForbidden` | Assistant route is not available on this surface. |
+| `assistant.runtime.route.assistantNotFound` | Assistant not found. |
+| `assistant.runtime.connection.unavailable` | This AI connection is not available in this assistant. |
+| `assistant.runtime.connection.selectionNotAllowed` | This assistant does not allow selecting an AI connection. |
+| `assistant.runtime.provider.notConfigured` | Assistant provider is not configured. |
+| `assistant.runtime.conversation.notFound` | Conversation not found. |
+| `assistant.runtime.conversation.idInvalid` | conversationId must be a valid record id. |
+| `assistant.runtime.conversation.createFailed` | Assistant failed to create conversation. |
+| `assistant.runtime.request.messageIdInvalid` | messageId is required and must be at most 128 characters. |
+| `assistant.runtime.request.inputRequired` | input is required. |
+| `assistant.runtime.request.messageIdConflict` | This message ID belongs to a different request. |
+| `assistant.runtime.request.unconfirmed` | This message was already submitted. Its completion is not confirmed; check conversation history before sending new work. |
+| `assistant.runtime.request.failed` | Assistant request failed. |
+| `assistant.runtime.request.cancelled` | Assistant request was cancelled. |
+| `assistant.runtime.request.noOutput` | Assistant returned no output. |
+| `assistant.runtime.attachments.invalidIds` | Invalid attachment identifiers. |
+| `assistant.runtime.attachments.notConfigured` | File attachments are not configured for this assistant. |
+| `assistant.runtime.subscription.idRequired` | A conversation subscription id is required. |
+| `assistant.runtime.subscription.failed` | Conversation subscription failed. |
+| `assistant.runtime.history.refreshFailed` | Older conversation history could not be refreshed. Reload chat to try again. |
+| `assistant.runtime.accessDenied` | Access denied. |
+| `assistant_history_inspection_required` | This conversation has ambiguous historical SQL rows. Inspect the reported rows offline before using the common runtime; no history was changed. |
+| `assistant_subscription_transport_failed` | Chat updates could not reconnect. Retrying automatically; Reload chat to try now. |

package/locales/en.json

@@ -0,0 +1,136 @@
+{
+  "jskit": {
+    "assistant": {
+      "runtime": {
+        "authenticationRequired": "Authentication required.",
+        "workspace": {
+          "selectionRequired": "Workspace selection required."
+        },
+        "route": {
+          "surfaceHeaderRequired": "Assistant surface header x-jskit-surface is required.",
+          "notFound": "Assistant route not found.",
+          "surfaceForbidden": "Assistant route is not available on this surface.",
+          "assistantNotFound": "Assistant not found."
+        },
+        "connection": {
+          "unavailable": "This AI connection is not available in this assistant.",
+          "selectionNotAllowed": "This assistant does not allow selecting an AI connection.",
+          "applicationAi": "Application AI",
+          "applicationDefault": "Application default"
+        },
+        "provider": {
+          "notConfigured": "Assistant provider is not configured."
+        },
+        "conversation": {
+          "notFound": "Conversation not found.",
+          "idInvalid": "conversationId must be a valid record id.",
+          "createFailed": "Assistant failed to create conversation.",
+          "assistantLabel": "Assistant",
+          "welcomeMessage": "What would you like to do?",
+          "placeholder": "Message the assistant…",
+          "startedAtUnknown": "unknown",
+          "status": {
+            "active": "active",
+            "completed": "completed",
+            "failed": "failed",
+            "aborted": "aborted",
+            "unknown": "unknown"
+          }
+        },
+        "request": {
+          "messageIdInvalid": "messageId is required and must be at most 128 characters.",
+          "inputRequired": "input is required.",
+          "messageIdConflict": "This message ID belongs to a different request.",
+          "unconfirmed": "This message was already submitted. Its completion is not confirmed; check conversation history before sending new work.",
+          "failed": "Assistant request failed.",
+          "cancelled": "Assistant request was cancelled.",
+          "noOutput": "Assistant returned no output.",
+          "notConfirmed": "Assistant did not confirm this message."
+        },
+        "attachments": {
+          "invalidIds": "Invalid attachment identifiers.",
+          "notConfigured": "File attachments are not configured for this assistant.",
+          "noLongerAccepted": "This conversation no longer accepts attachments.",
+          "clearFailed": "Accepted attachments could not be cleared from the composer."
+        },
+        "subscription": {
+          "idRequired": "A conversation subscription id is required.",
+          "failed": "Conversation subscription failed."
+        },
+        "history": {
+          "refreshFailed": "Older conversation history could not be refreshed. Reload chat to try again.",
+          "loadFailed": "Older conversation history could not be loaded.",
+          "listFailed": "Unable to load conversation history.",
+          "conversationLoadFailed": "Unable to load conversation."
+        },
+        "accessDenied": "Access denied.",
+        "delivery": {
+          "waitingForStep": "Waiting for the assistant to finish this step",
+          "unconfirmedBeforeClose": "Delivery was not confirmed before this page closed. Check the conversation before retrying.",
+          "stillUnknown": "Delivery is still unknown. Retry to check again.",
+          "checkFailed": "Delivery could not be checked.",
+          "notConfirmed": "Message delivery is not confirmed."
+        },
+        "goal": {
+          "budgetsUnsupported": "This conversation does not support goal token budgets.",
+          "changeFailed": "Could not change the goal.",
+          "unavailable": "Goal status is unavailable.",
+          "resumeMessage": "Resume the goal.",
+          "cancelMessage": "Cancel the goal."
+        },
+        "composer": {
+          "questionsPlaceholder": "Optional additional context…",
+          "choicesPlaceholder": "Choose an answer above, or type another answer…",
+          "questionsHint": "Answer the assistant, then send one combined reply."
+        },
+        "tool": {
+          "progress": "{name} — {status}",
+          "status": {
+            "pending": "pending",
+            "done": "done",
+            "failed": "failed",
+            "interrupted": "interrupted"
+          }
+        },
+        "surface": {
+          "newConversation": "New conversation",
+          "conversations": "Conversations",
+          "activity": "Activity",
+          "toolActivity": "Tool activity",
+          "conversation": "Conversation",
+          "responseCanceled": "Response canceled. A tool already running may still finish.",
+          "startNewConversation": "Start new conversation",
+          "refresh": "Refresh",
+          "close": "Close",
+          "loadingConversationsLabel": "Loading conversations",
+          "loadingConversations": "Loading conversations…",
+          "savedConversations": "Saved conversations",
+          "noSavedConversations": "No saved conversations",
+          "untitledConversation": "Untitled conversation",
+          "loadOlderConversations": "Load older conversations",
+          "messageCount": "{count} messages"
+        },
+        "viewer": {
+          "you": "You"
+        },
+        "settings": {
+          "title": "Assistant settings",
+          "noPermission": "You do not have permission to view assistant settings.",
+          "save": "Save assistant settings",
+          "systemPrompt": "System prompt",
+          "subtitle": "Configure assistant settings.",
+          "subtitleWorkspace": "Configure the prompt used on the {surface} surface for this workspace.",
+          "subtitleSurface": "Configure the prompt used on the {surface} surface.",
+          "notConfigured": "Assistant settings are not configured for this surface.",
+          "workspaceUnavailable": "Workspace support is not available for this assistant surface.",
+          "selectWorkspace": "Select a workspace to configure assistant settings.",
+          "updateFailed": "Unable to update assistant settings."
+        }
+      }
+    },
+    "errors": {
+      "assistant_history_inspection_required": "This conversation has ambiguous historical SQL rows. Inspect the reported rows offline before using the common runtime; no history was changed.",
+      "assistant_subscription_transport_failed": "Chat updates could not reconnect. Retrying automatically; Reload chat to try now."
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-runtime",
-  "version": "0.1.237",
+  "version": "0.2.0",
   "type": "module",
   "scripts": {
     "test": "node --test --test-concurrency=1"
@@ -9,22 +9,23 @@
     "./client": "./src/client/index.js",
     "./shared": "./src/shared/index.js",
     "./server/actionIds": "./src/server/actionIds.js",
-    "./server": "./src/server/index.js"
+    "./server": "./src/server/index.js",
+    "./locales/en.json": "./locales/en.json"
   },
   "dependencies": {
-    "@jskit-ai/assistant-core": "0.1.243",
+    "@jskit-ai/assistant-core": "0.2.0",
     "json-rest-schema": "^1.0.17"
   },
   "peerDependencies": {
-    "@jskit-ai/http-runtime": "0.1.245",
-    "@jskit-ai/http-web": "0.1.95",
-    "@jskit-ai/kernel": "0.1.247",
-    "@jskit-ai/realtime": "0.1.247",
-    "@jskit-ai/shell-web": "0.1.254",
+    "@jskit-ai/http-runtime": "0.2.0",
+    "@jskit-ai/http-web": "0.2.0",
+    "@jskit-ai/kernel": "0.2.0",
+    "@jskit-ai/realtime": "0.2.0",
+    "@jskit-ai/shell-web": "0.2.0",
     "@tanstack/vue-query": "^5.90.5",
     "vue": "^3.5.13",
     "vuetify": "^4.0.0",
-    "@jskit-ai/database-runtime": "0.1.247"
+    "@jskit-ai/database-runtime": "0.1.249"
   },
   "description": "Capability-based assistant runtime with per-surface chat, transcripts, settings, and action tools.",
   "jskit": {

package/src/client/components/AssistantConversationClientElement.vue

@@ -2,6 +2,7 @@
 import { computed, ref, toRef } from "vue";
 import { AssistantConversationElement } from "@jskit-ai/assistant-core/client/conversation";
 import { useAssistantConversation } from "../composables/useAssistantConversation.js";
+import { useJskitText } from "../i18n.js";
 
 const props = defineProps({
   conversationId: { type: String, required: true },
@@ -13,9 +14,10 @@ const props = defineProps({
   api: { type: Object, default: null },
   active: { type: Boolean, default: true },
   clearDraftOn: { type: String, default: undefined, validator: value => ["dispatch", "accepted"].includes(value) },
-  assistantLabel: { type: String, default: "Assistant" },
-  welcomeMessage: { type: String, default: "What would you like to do?" },
-  placeholder: { type: String, default: "Message the assistant…" },
+  // Unset texts follow the active language; an application's own text is shown as given.
+  assistantLabel: { type: String, default: undefined },
+  welcomeMessage: { type: String, default: undefined },
+  placeholder: { type: String, default: undefined },
   layout: { type: String, default: "compact", validator: value => ["page", "compact"].includes(value) },
   data: { type: Object, default: undefined },
   attachments: { type: Object, default: null },
@@ -26,6 +28,8 @@ const props = defineProps({
   avatarSize: { type: String, default: "compact", validator: (value) => ["hidden", "compact", "standard", "large"].includes(value) }
 });
 const emit = defineEmits(["update:avatarSize"]);
+const { t } = useJskitText();
+const assistantLabelText = computed(() => props.assistantLabel ?? t("jskit.assistant.runtime.conversation.assistantLabel"));
 const binding = useAssistantConversation({
   conversationId: toRef(props, "conversationId"), endpoint: toRef(props, "endpoint"),
   surfaceId: toRef(props, "surfaceId"), hostSurfaceId: toRef(props, "hostSurfaceId"),
@@ -34,8 +38,9 @@ const binding = useAssistantConversation({
   data: toRef(props, "data"),
   attachments: toRef(props, "attachments"), suggestions: toRef(props, "suggestions"), models: toRef(props, "models"),
   questions: toRef(props, "questions"), goal: toRef(props, "goal"),
-  presentation: computed(() => ({ assistantLabel: props.assistantLabel, welcomeMessage: props.welcomeMessage,
-    placeholder: props.placeholder, layout: props.layout }))
+  presentation: computed(() => ({ assistantLabel: assistantLabelText.value,
+    welcomeMessage: props.welcomeMessage ?? t("jskit.assistant.runtime.conversation.welcomeMessage"),
+    placeholder: props.placeholder ?? t("jskit.assistant.runtime.conversation.placeholder"), layout: props.layout }))
 });
 const conversation = ref(null);
 defineExpose({ focus: () => conversation.value?.focus(), runtime: binding.runtime });
@@ -43,7 +48,7 @@ defineExpose({ focus: () => conversation.value?.focus(), runtime: binding.runtim
 
 <template>
   <AssistantConversationElement
-    ref="conversation" :adapter="binding.adapter.value" :label="assistantLabel" :avatar-size="avatarSize"
+    ref="conversation" :adapter="binding.adapter.value" :label="assistantLabelText" :avatar-size="avatarSize"
     class="assistant-client-conversation" @update:avatar-size="emit('update:avatarSize', $event)"
   >
     <template v-for="name in Object.keys($slots).filter(name => name !== 'composer-feedback')" #[name]="scope">

package/src/client/components/AssistantSettingsClientElement.vue

@@ -1,16 +1,16 @@
 <template>
   <AssistantSettingsFormCard
     root-class="assistant-settings-client-element"
-    title="Assistant settings"
+    :title="t('jskit.assistant.runtime.settings.title')"
     :subtitle="subtitle"
-    no-permission-message="You do not have permission to view assistant settings."
-    save-label="Save assistant settings"
+    :no-permission-message="t('jskit.assistant.runtime.settings.noPermission')"
+    :save-label="t('jskit.assistant.runtime.settings.save')"
     :add-edit="addEdit"
     :show-form-skeleton="showFormSkeleton"
   >
     <v-textarea
       v-model="form.systemPrompt"
-      label="System prompt"
+      :label="t('jskit.assistant.runtime.settings.systemPrompt')"
       variant="outlined"
       density="comfortable"
       rows="8"
@@ -33,6 +33,7 @@ import { useShellWebErrorRuntime } from "@jskit-ai/shell-web/client/error";
 import { useSurfaceRouteContext } from "@jskit-ai/shell-web/client/navigation/useSurfaceRouteContext";
 import { resolveAssistantSurfaceConfig } from "../../shared/assistantSurfaces.js";
 import { useWorkspaceWebScopeSupport } from "../support/workspaceScopeSupport.js";
+import { useJskitText } from "../i18n.js";
 
 const props = defineProps({
   targetSurfaceId: {
@@ -49,6 +50,7 @@ const fieldErrors = reactive({
   systemPrompt: ""
 });
 
+const { fieldErrorMessages, serverMessage, t } = useJskitText();
 const errorRuntime = useShellWebErrorRuntime();
 const queryClient = useQueryClient();
 const appConfig = getClientAppConfig();
@@ -93,14 +95,15 @@ const settingsApi = createAssistantApi({
 
 const subtitle = computed(() => {
   if (!assistantSurface.value) {
-    return "Configure assistant settings.";
+    return t("jskit.assistant.runtime.settings.subtitle");
   }
 
+  const surface = assistantSurface.value.targetSurfaceId;
   if (assistantSurface.value.configScope === "workspace") {
-    return `Configure the prompt used on the ${assistantSurface.value.targetSurfaceId} surface for this workspace.`;
+    return t("jskit.assistant.runtime.settings.subtitleWorkspace", { surface });
   }
 
-  return `Configure the prompt used on the ${assistantSurface.value.targetSurfaceId} surface.`;
+  return t("jskit.assistant.runtime.settings.subtitleSurface", { surface });
 });
 
 function clearFieldErrors() {
@@ -151,18 +154,19 @@ const settingsMutation = useMutation({
 
 const loadError = computed(() => {
   if (!assistantSurface.value) {
-    return "Assistant settings are not configured for this surface.";
+    return t("jskit.assistant.runtime.settings.notConfigured");
   }
   if (hasScope.value) {
-    return normalizeText(settingsQuery.error.value?.message);
+    const failure = settingsQuery.error.value;
+    return failure?.message ? normalizeText(serverMessage(failure)) : "";
   }
 
   if (assistantSurface.value?.settingsSurfaceRequiresWorkspace) {
     if (workspaceScopeSupport.available !== true) {
-      return "Workspace support is not available for this assistant surface.";
+      return t("jskit.assistant.runtime.settings.workspaceUnavailable");
     }
 
-    return "Select a workspace to configure assistant settings.";
+    return t("jskit.assistant.runtime.settings.selectWorkspace");
   }
 
   return "";
@@ -179,17 +183,18 @@ async function submit() {
     }
   });
   if (!validation.ok) {
-    fieldErrors.systemPrompt = String(validation.fieldErrors.systemPrompt || "");
+    fieldErrors.systemPrompt = String(fieldErrorMessages(validation).systemPrompt || "");
     return;
   }
 
   try {
     await settingsMutation.mutateAsync(validation.value);
   } catch (error) {
-    const nextFieldErrors = normalizeObject(error?.details?.fieldErrors);
+    const nextFieldErrors = fieldErrorMessages({ fieldErrors: normalizeObject(error?.details?.fieldErrors),
+      fieldErrorCodes: error?.fieldErrorCodes || error?.details?.fieldErrorCodes });
     fieldErrors.systemPrompt = String(nextFieldErrors.systemPrompt || "");
     reportAssistantSettingsError(
-      normalizeText(error?.message) || "Unable to update assistant settings.",
+      (error?.message && normalizeText(serverMessage(error))) || t("jskit.assistant.runtime.settings.updateFailed"),
       "assistant.settings:save"
     );
   }

package/src/client/components/AssistantSurfaceClientElement.vue

@@ -2,14 +2,17 @@
 import { computed, onMounted, onScopeDispose, reactive, ref, toRef, watch, watchPostEffect } from "vue";
 import { AssistantConversationElement } from "@jskit-ai/assistant-core/client/conversation";
 import { useAssistantRuntime } from "../composables/useAssistantRuntime.js";
-import { mapAssistantConversationTurns } from "../support/assistantRuntimeState.js";
+import { mapAssistantConversationTurns, toolStatusText } from "../support/assistantRuntimeState.js";
+import { DEFAULT_CONVERSATION_TITLE } from "../../shared/assistantRuntimeConfig.js";
+import { useJskitText } from "../i18n.js";
 
 const props = defineProps({
   surfaceId: { type: String, required: true },
   layout: { type: String, default: "page", validator: (value) => ["page", "compact"].includes(value) },
-  assistantLabel: { type: String, default: "Assistant" },
-  welcomeMessage: { type: String, default: "What would you like to do?" },
-  placeholder: { type: String, default: "Message the assistant…" },
+  // Unset texts follow the active language; an application's own text is shown as given.
+  assistantLabel: { type: String, default: undefined },
+  welcomeMessage: { type: String, default: undefined },
+  placeholder: { type: String, default: undefined },
   showToolActivity: { type: Boolean, default: true },
   connections: { type: Array, default: () => [] },
   attachments: { type: Object, default: null },
@@ -19,6 +22,8 @@ const props = defineProps({
   configurationMode: { type: String, default: "editable", validator: value => ["hidden", "readonly", "editable"].includes(value) }
 });
 const integrationId = defineModel("integrationId", { type: String, default: "" });
+const { t } = useJskitText();
+const assistantLabelText = computed(() => props.assistantLabel ?? t("jskit.assistant.runtime.conversation.assistantLabel"));
 const draftIntegrationId = ref(integrationId.value);
 watch(integrationId, value => { draftIntegrationId.value = value; });
 const runtime = useAssistantRuntime({ surfaceId: toRef(props, "surfaceId"), integrationId });
@@ -49,9 +54,10 @@ const adapter = computed(() => ({
   goal: props.goal,
   activity: props.activity,
   models: props.connections.length && props.configurationMode !== "hidden" ? {
-    providerRows: [{ id: "application", label: "Application AI" }],
+    providerRows: [{ id: "application", label: t("jskit.assistant.runtime.connection.applicationAi") }],
     modelProviderId: "application", modelRows: props.connections, modelId: draftIntegrationId.value,
-    selectionSummary: props.connections.find(connection => connection.id === integrationId.value)?.label || "Application default",
+    selectionSummary: props.connections.find(connection => connection.id === integrationId.value)?.label ||
+      t("jskit.assistant.runtime.connection.applicationDefault"),
     changesDisabled: props.configurationMode !== "editable" || state.isStreaming,
     canSave: props.configurationMode === "editable" && !state.isStreaming && draftIntegrationId.value !== integrationId.value &&
       props.connections.some(connection => connection.id === draftIntegrationId.value),
@@ -63,8 +69,9 @@ const adapter = computed(() => ({
     scrollKey: `${state.scopeKey}:${state.activeConversationId || "new"}`,
     loading: state.isRestoringConversation,
     working: state.isStreaming && !runtime.delivery.state.sending,
-    assistantLabel: props.assistantLabel,
-    welcomeMessage: state.messages.length || state.isRestoringConversation ? "" : props.welcomeMessage
+    assistantLabel: assistantLabelText.value,
+    welcomeMessage: state.messages.length || state.isRestoringConversation ? ""
+      : props.welcomeMessage ?? t("jskit.assistant.runtime.conversation.welcomeMessage")
   },
   composer: {
     draft: state.input,
@@ -73,7 +80,7 @@ const adapter = computed(() => ({
     disabled: !state.hasRuntimeScope,
     canStop: state.isStreaming,
     stopPending: state.isCanceling,
-    placeholder: props.placeholder,
+    placeholder: props.placeholder ?? t("jskit.assistant.runtime.conversation.placeholder"),
     rows: 2,
     density: props.layout === "compact" ? "compact" : "default",
     submitOnEnter: true,
@@ -97,9 +104,18 @@ function submitMessage({ attachments = [], retryMessageId = "" }) {
   });
 }
 
+const CONVERSATION_STATUS_KEY = "jskit.assistant.runtime.conversation.status.";
+
+// The saved default title is stored in English; show it in the active language.
+function conversationTitle(entry, fallbackKey) {
+  if (entry?.title === DEFAULT_CONVERSATION_TITLE) return t("jskit.assistant.runtime.surface.newConversation");
+  return entry?.title || t(fallbackKey);
+}
+
 function conversationSubtitle(entry) {
-  return [runtime.meta.normalizeConversationStatus(entry.status), runtime.meta.formatConversationStartedAt(entry.startedAt),
-    `${Number(entry.messageCount || 0)} messages`].join(" · ");
+  return [t(CONVERSATION_STATUS_KEY + runtime.meta.normalizeConversationStatus(entry.status)),
+    runtime.meta.formatConversationStartedAt(entry.startedAt),
+    t("jskit.assistant.runtime.surface.messageCount", { count: Number(entry.messageCount || 0) })].join(" · ");
 }
 
 async function selectConversation(entry) {
@@ -116,25 +132,25 @@ defineExpose({ focus: () => conversation.value?.focus() });
 </script>
 
 <template>
-  <section ref="root" class="assistant-surface" :class="`assistant-surface--${layout}`" :aria-label="assistantLabel">
+  <section ref="root" class="assistant-surface" :class="`assistant-surface--${layout}`" :aria-label="assistantLabelText">
     <div class="assistant-surface__toolbar">
-      <span class="assistant-surface__title">{{ selectedConversation?.title || 'New conversation' }}</span>
-      <v-btn variant="text" @click="historyOpen = true">Conversations</v-btn>
+      <span class="assistant-surface__title">{{ conversationTitle(selectedConversation, "jskit.assistant.runtime.surface.newConversation") }}</span>
+      <v-btn variant="text" @click="historyOpen = true">{{ t("jskit.assistant.runtime.surface.conversations") }}</v-btn>
       <v-menu v-if="showToolActivity && state.pendingToolEvents.length" location="bottom end">
         <template #activator="{ props: menuProps }">
-          <v-btn v-bind="menuProps" variant="text">Activity</v-btn>
+          <v-btn v-bind="menuProps" variant="text">{{ t("jskit.assistant.runtime.surface.activity") }}</v-btn>
         </template>
-        <v-list aria-label="Tool activity" max-height="320" max-width="360" class="assistant-surface__activity">
-          <v-list-item v-for="event in state.pendingToolEvents" :key="event.id" :title="event.name" :subtitle="event.status" />
+        <v-list :aria-label="t('jskit.assistant.runtime.surface.toolActivity')" max-height="320" max-width="360" class="assistant-surface__activity">
+          <v-list-item v-for="event in state.pendingToolEvents" :key="event.id" :title="event.name" :subtitle="toolStatusText(event.status)" />
         </v-list>
       </v-menu>
     </div>
-    <AssistantConversationElement ref="conversation" :adapter="adapter" label="Conversation" class="assistant-surface__conversation">
+    <AssistantConversationElement ref="conversation" :adapter="adapter" :label="t('jskit.assistant.runtime.surface.conversation')" class="assistant-surface__conversation">
       <template v-if="$slots.activity" #activity="scope"><slot name="activity" v-bind="scope" /></template>
       <template v-if="$slots.attachments" #attachments="scope"><slot name="attachments" v-bind="scope" /></template>
       <template #message-actions="{ message }">
         <p v-if="message.status === 'failed' && message.error" class="assistant-surface__message-error" role="status">{{ message.error }}</p>
-        <p v-if="message.status === 'interrupted'" class="assistant-surface__notice" role="status">Response canceled. A tool already running may still finish.</p>
+        <p v-if="message.status === 'interrupted'" class="assistant-surface__notice" role="status">{{ t("jskit.assistant.runtime.surface.responseCanceled") }}</p>
       </template>
       <template #composer-feedback>
         <p v-if="state.error && !state.messages.some((message) => message.error === state.error)" class="assistant-surface__message-error" role="status">{{ state.error }}</p>
@@ -142,28 +158,35 @@ defineExpose({ focus: () => conversation.value?.focus() });
       <template #composer-tools><slot name="composer-tools" :runtime="runtime" /></template>
     </AssistantConversationElement>
 
-    <v-dialog v-model="historyOpen" max-width="640" scrollable aria-label="Conversations">
+    <v-dialog v-model="historyOpen" max-width="640" scrollable :aria-label="t('jskit.assistant.runtime.surface.conversations')">
       <v-card class="assistant-surface__history">
-        <v-card-title>Conversations</v-card-title>
+        <v-card-title>{{ t("jskit.assistant.runtime.surface.conversations") }}</v-card-title>
         <v-card-actions class="assistant-surface__history-actions">
-          <v-btn color="primary" :disabled="!state.canStartNewConversation" @click="startNewConversation">Start new conversation</v-btn>
-          <v-btn :disabled="state.conversationHistoryLoading" @click="runtime.actions.refreshConversationHistory">Refresh</v-btn>
-          <v-btn @click="historyOpen = false">Close</v-btn>
+          <v-btn color="primary" :disabled="!state.canStartNewConversation" @click="startNewConversation">
+            {{ t("jskit.assistant.runtime.surface.startNewConversation") }}
+          </v-btn>
+          <v-btn :disabled="state.conversationHistoryLoading" @click="runtime.actions.refreshConversationHistory">
+            {{ t("jskit.assistant.runtime.surface.refresh") }}
+          </v-btn>
+          <v-btn @click="historyOpen = false">{{ t("jskit.assistant.runtime.surface.close") }}</v-btn>
         </v-card-actions>
         <v-card-text>
           <p v-if="state.conversationHistoryError" role="alert">{{ state.conversationHistoryError }}</p>
-          <v-skeleton-loader v-if="state.conversationHistoryLoading && !state.conversationHistory.length" type="list-item-two-line@3" aria-label="Loading conversations" />
-          <v-list v-else aria-label="Saved conversations">
-            <v-list-item v-if="!state.conversationHistory.length" title="No saved conversations" />
+          <v-skeleton-loader
+            v-if="state.conversationHistoryLoading && !state.conversationHistory.length" type="list-item-two-line@3"
+            :aria-label="t('jskit.assistant.runtime.surface.loadingConversationsLabel')"
+          />
+          <v-list v-else :aria-label="t('jskit.assistant.runtime.surface.savedConversations')">
+            <v-list-item v-if="!state.conversationHistory.length" :title="t('jskit.assistant.runtime.surface.noSavedConversations')" />
             <v-list-item
               v-for="entry in state.conversationHistory" :key="entry.id"
               :active="String(entry.id) === state.activeConversationId"
-              :title="entry.title || 'Untitled conversation'" :subtitle="conversationSubtitle(entry)"
+              :title="conversationTitle(entry, 'jskit.assistant.runtime.surface.untitledConversation')" :subtitle="conversationSubtitle(entry)"
               :disabled="state.isStreaming || state.isRestoringConversation" @click="selectConversation(entry)"
             />
           </v-list>
           <v-btn v-if="state.conversationHistoryHasMore" :disabled="state.conversationHistoryLoadingMore" variant="text" @click="runtime.actions.loadMoreConversationHistory">
-            {{ state.conversationHistoryLoadingMore ? 'Loading conversations…' : 'Load older conversations' }}
+            {{ t(state.conversationHistoryLoadingMore ? "jskit.assistant.runtime.surface.loadingConversations" : "jskit.assistant.runtime.surface.loadOlderConversations") }}
           </v-btn>
         </v-card-text>
       </v-card>