@deepseek-harness-tui/dsh-tui 0.14.1 → 0.16.0

package/lib/types/backends/shared/channel-slug.d.ts

@@ -0,0 +1,4 @@
+/** The id of a channel profile name: lowercase ASCII, runs of other
+ *  characters collapsed to `-`, edges trimmed. */
+export declare function channelProfileSlug(name: string): string;
+//# sourceMappingURL=channel-slug.d.ts.map

package/lib/types/backends/shared/channel-slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-slug.d.ts","sourceRoot":"","sources":["../../../../src/backends/shared/channel-slug.ts"],"names":[],"mappings":"AAiBA;kDACkD;AAClD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/lib/types/backends/shared/channel-slug.js

@@ -0,0 +1,25 @@
+/**
+ * The stable id of a channel profile name, for backends (D15).
+ *
+ * Backends keep their own channel store and must not reach into
+ * `src/channel/` (B-3's boundary rule), while the `/channel` wizard keeps
+ * using `src/channel/channel-slug.ts`. The two implementations MUST stay
+ * byte-identical: the id is a *persistent* join key (the profile file's row
+ * and the token ref derived from it), so a drift would make the wizard and a
+ * backend disagree about which channel a row is.
+ * `scripts/verify-claude-channels.ts` pins that equality over a name vector.
+ *
+ * A name with no ASCII letter or digit (智谱, 硅基流动) gets
+ * `channel-<first 8 hex of its sha256>` instead, so two such names never
+ * share one id.
+ */
+import { createHash } from 'node:crypto';
+/** The id of a channel profile name: lowercase ASCII, runs of other
+ *  characters collapsed to `-`, edges trimmed. */
+export function channelProfileSlug(name) {
+    const trimmed = name.trim();
+    const slug = trimmed.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    if (slug !== '')
+        return slug;
+    return `channel-${createHash('sha256').update(trimmed.normalize('NFC')).digest('hex').slice(0, 8)}`;
+}

package/lib/types/backends/shared/channel-tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-tokens.d.ts","sourceRoot":"","sources":["../../../../src/backends/shared/channel-tokens.ts"],"names":[],"mappings":"AAmCA;mDACmD;AACnD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACrC;mEAC+D;IAC/D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,4CAA4C;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC/B;AAID;kCACkC;AAClC,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAqB,EAAE,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAsB,GAAG,iBAAiB,CAuFpI;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,iBAAiB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CASjJ;AAED,oFAAoF;AACpF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAA;AACnD,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,0BAAoB,CAAA;AACxD,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,4BAAsB,CAAA"}
+{"version":3,"file":"channel-tokens.d.ts","sourceRoot":"","sources":["../../../../src/backends/shared/channel-tokens.ts"],"names":[],"mappings":"AAsCA;mDACmD;AACnD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACrC;mEAC+D;IAC/D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,4CAA4C;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC/B;AAID;kCACkC;AAClC,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAqB,EAAE,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAsB,GAAG,iBAAiB,CA6FpI;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,iBAAiB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CASjJ;AAED,oFAAoF;AACpF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAA;AACnD,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,0BAAoB,CAAA;AACxD,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,4BAAsB,CAAA"}

package/lib/types/backends/shared/channel-tokens.js

@@ -8,6 +8,9 @@
  *
  * This module is a direct, host-side file view of that store (a non-DSH
  * backend has no cordis context to resolve `ctx.get('credentials')` from).
+ * Reads consult the active home's store and then the default `~/.dsh` store
+ * (`credentialStoreFiles`), so a `DSH_HOME` override does not orphan a key the
+ * user stored at the documented location; writes always target the active home.
  * The store is edited through a YAML document parser (`yaml`): the top-level
  * `refs` mapping is found in block or flow style, quoted keys included;
  * foreign fields, comments and multiline scalars keep their meaning, and a
@@ -30,7 +33,7 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { isMap, parseDocument } from 'yaml';
-import { dshHomeDir } from '../../utils/credentials.js';
+import { credentialStoreFiles, dshHomeDir } from '../../utils/credentials.js';
 import { writeFileAtomic } from './atomic-file.js';
 /** The credential ref of one channel id (the deriveKeyRef convention:
  *  uppercase, runs of non-alphanumerics → `_`). */
@@ -43,13 +46,17 @@ const FILE = '.credentials.yaml';
  * `~/.dsh/.credentials.yaml`). */
 export function fileChannelTokens(home = dshHomeDir(), debug = () => undefined) {
     const path = join(home, FILE);
-    /** Parse the store into a YAML document; undefined for a file that
+    // Writes stay in the active home; reads also consult the default `~/.dsh`
+    // store so a key stored at the documented location survives a DSH_HOME
+    // override (the codex bridge injects provider env keys from here).
+    const files = credentialStoreFiles(home);
+    /** Parse one store into a YAML document; undefined for a file that
      *  cannot be read or does not parse (never rebuilt over). An absent file
      *  parses as an empty document, so the first write can create it. */
-    const load = () => {
+    const load = (file) => {
         let text;
         try {
-            text = readFileSync(path, 'utf8');
+            text = readFileSync(file, 'utf8');
         }
         catch (error) {
             if (error.code === 'ENOENT')
@@ -77,6 +84,14 @@ export function fileChannelTokens(home = dshHomeDir(), debug = () => undefined)
             return undefined;
         return isMap(refs) ? refs : null;
     };
+    /** The `refs` mapping of one candidate store (undefined when it has none). */
+    const refsAt = (file) => {
+        const doc = load(file);
+        if (doc === undefined)
+            return undefined;
+        const refs = refsOf(doc);
+        return refs === undefined || refs === null ? undefined : refs;
+    };
     const commit = (next) => {
         try {
             writeFileAtomic(home, FILE, next);
@@ -87,19 +102,17 @@ export function fileChannelTokens(home = dshHomeDir(), debug = () => undefined)
     };
     return {
         read: ref => {
-            const doc = load();
-            if (doc === undefined)
-                return undefined;
-            const refs = refsOf(doc);
-            if (refs === undefined || refs === null)
-                return undefined;
-            const value = refs.get(ref);
-            // Only a non-empty string scalar is a token; null/number/boolean
-            // scalars are declared but not usable credential material.
-            return typeof value === 'string' && value !== '' ? value : undefined;
+            for (const file of files) {
+                const value = refsAt(file)?.get(ref);
+                // Only a non-empty string scalar is a token; null/number/boolean
+                // scalars are declared but not usable credential material.
+                if (typeof value === 'string' && value !== '')
+                    return value;
+            }
+            return undefined;
         },
         write: (ref, value) => {
-            const doc = load();
+            const doc = load(path);
             if (doc === undefined)
                 return;
             const refs = refsOf(doc);
@@ -122,7 +135,7 @@ export function fileChannelTokens(home = dshHomeDir(), debug = () => undefined)
                 commit(next);
         },
         erase: ref => {
-            const doc = load();
+            const doc = load(path);
             if (doc === undefined)
                 return;
             const refs = refsOf(doc);
@@ -133,13 +146,7 @@ export function fileChannelTokens(home = dshHomeDir(), debug = () => undefined)
             refs.delete(ref);
             commit(doc.toString({ lineWidth: 0 }));
         },
-        declared: ref => {
-            const doc = load();
-            if (doc === undefined)
-                return false;
-            const refs = refsOf(doc);
-            return refs !== undefined && refs !== null && refs.has(ref);
-        },
+        declared: ref => files.some(file => refsAt(file)?.has(ref) === true),
     };
 }
 /** An in-memory store (tests, embedders). */

package/lib/types/{channel → backends/shared}/elicitation.d.ts

@@ -23,10 +23,75 @@
  * are matched against the very strings the panel showed, so a language
  * switch meanwhile cannot turn a valid answer into a mismatch.
  *
- * Backend-neutral (`verify:boundary`): no vendor types, no I/O.
+ * **Locale-free (B-3)**: this module writes no copy of its own. Every string
+ * it puts on screen comes from the {@link ElicitationText} the caller hands
+ * over — one snapshot per flow, taken in the backend's own language through
+ * `BackendHost.locale()`. A backend's text is its own (D2); the host
+ * dictionary is not readable from here.
+ *
+ * Backend-neutral (`verify:boundary`): no vendor types, no I/O, no host
+ * module — the module lives in `src/backends/shared/` because the two
+ * backends are its only callers.
  */
-import type { QuestionAnswers } from '../agent/capabilities.js';
-import type { QuestionItemView } from '../agent/events.js';
+import type { QuestionAnswers } from '../../agent/capabilities.js';
+import type { QuestionItemView } from '../../agent/events.js';
+/** Every string this flow puts on screen, in one language, as the caller's
+ *  own dictionary holds it. Values may carry `{{name}}` placeholders: this
+ *  module fills them from the values of the call. */
+export interface ElicitationText {
+    /** The label that skips an optional field. */
+    readonly skip: string;
+    readonly skipDesc: string;
+    readonly yes: string;
+    readonly no: string;
+    /** The last question's two options. */
+    readonly send: string;
+    readonly sendDesc: string;
+    readonly decline: string;
+    readonly declineDesc: string;
+    readonly confirm: string;
+    /** `{{title}}` = the field's title. */
+    readonly optional: string;
+    /** `{{reason}}` = the reason the field is asked again. */
+    readonly invalid: string;
+    readonly invalidChoice: string;
+    readonly invalidRequired: string;
+    readonly invalidNumber: string;
+    readonly invalidInteger: string;
+    /** `{{min}}` / `{{max}}` / `{{n}}`. */
+    readonly invalidMin: string;
+    readonly invalidMax: string;
+    readonly invalidMinLength: string;
+    readonly invalidMaxLength: string;
+    readonly invalidMinItems: string;
+    readonly invalidMaxItems: string;
+    readonly invalidJson: string;
+    readonly invalidEmail: string;
+    readonly invalidUri: string;
+    readonly invalidDate: string;
+    readonly invalidDateTime: string;
+    readonly invalidPattern: string;
+    readonly kindInteger: string;
+    readonly kindNumber: string;
+    /** `{{kind}}` / `{{min}}` / `{{max}}`. */
+    readonly hintRange: string;
+    readonly hintMin: string;
+    readonly hintMax: string;
+    readonly hintJson: string;
+    /** `{{format}}` = the declared string format (email, date, …). */
+    readonly hintFormat: string;
+    readonly urlAccept: string;
+    readonly urlAcceptDesc: string;
+    /** `{{server}}` = the MCP server's name. */
+    readonly urlQuestion: string;
+    readonly urlDetail: string;
+    /** `{{server}}` + `{{url}}`. */
+    readonly urlNotice: string;
+    readonly urlComplete: string;
+    readonly urlMissing: string;
+    /** `{{server}}` + `{{mode}}`. */
+    readonly unsupported: string;
+}
 /** A JSON object as read from an untyped schema. */
 type Rec = Readonly<Record<string, unknown>>;
 /** A form value the MCP result carries. */
@@ -48,23 +113,15 @@ export interface FormField {
 /** The fields of a requested schema, in declaration order. */
 export declare function formFields(schema: unknown): FormField[];
 /** Validate one typed value against its field; the value or the reason. */
-export declare function parseFieldText(field: FormField, text: string): {
+export declare function parseFieldText(field: FormField, text: string, elicit: ElicitationText): {
     readonly value: ElicitationValue;
 } | {
     readonly error: string;
 };
-/** The option labels of one form flow, fixed when it is first asked. */
-export interface FormLabels {
-    readonly skip: string;
-    readonly yes: string;
-    readonly no: string;
-}
-/** The current language's form labels. */
-export declare const formLabels: () => FormLabels;
 /** A field's question (with the reason it is asked again, if any). */
-export declare function fieldQuestion(field: FormField, header: string, lead: string | undefined, error: string | undefined, labels?: FormLabels): QuestionItemView;
+export declare function fieldQuestion(field: FormField, header: string, lead: string | undefined, error: string | undefined, elicit: ElicitationText): QuestionItemView;
 /** One answered field: its value, `skip`, or why it is invalid. */
-export declare function fieldValue(field: FormField, answer: QuestionAnswers['answers'][number] | undefined, labels?: FormLabels): {
+export declare function fieldValue(field: FormField, answer: QuestionAnswers['answers'][number] | undefined, elicit: ElicitationText): {
     readonly value: ElicitationValue;
 } | {
     readonly skip: true;
@@ -111,7 +168,7 @@ export interface ElicitationForm {
  * send / decline choice is asked once, after the first round; a re-ask
  * keeps the values already accepted and replaces the re-asked ones.
  */
-export declare function createElicitationForm(request: ElicitationRequestView): ElicitationForm;
+export declare function createElicitationForm(request: ElicitationRequestView, elicit: ElicitationText): ElicitationForm;
 /** A URL elicitation as one accept / decline question carrying the link. */
 export interface ElicitationUrlAsk {
     readonly questions: readonly QuestionItemView[];
@@ -119,17 +176,17 @@ export interface ElicitationUrlAsk {
     accepted(answers: QuestionAnswers): boolean;
 }
 /** The URL-mode question; undefined when the request names no URL. */
-export declare function createElicitationUrlAsk(request: ElicitationRequestView): ElicitationUrlAsk | undefined;
+export declare function createElicitationUrlAsk(request: ElicitationRequestView, elicit: ElicitationText): ElicitationUrlAsk | undefined;
 /** The notice texts a backend shows around an elicitation. */
-export declare const elicitationNotices: {
+export declare function elicitationNotices(elicit: ElicitationText): {
     /** URL mode: the server asks the user to open a page. */
-    urlOpen: (server: string, url: string) => string;
+    urlOpen(server: string, url: string): string;
     /** URL mode: the server reported the flow done. */
-    urlComplete: (server: string) => string;
+    urlComplete(server: string): string;
     /** URL mode without a URL: declined. */
-    urlMissing: (server: string) => string;
+    urlMissing(server: string): string;
     /** A mode this client cannot render: declined. */
-    unsupported: (server: string, mode: string) => string;
+    unsupported(server: string, mode: string): string;
 };
 export {};
 //# sourceMappingURL=elicitation.d.ts.map

package/lib/types/backends/shared/elicitation.d.ts.map

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

package/lib/types/{channel → backends/shared}/elicitation.js

@@ -1,4 +1,7 @@
-import { t } from '../i18n.js';
+import { fillTemplate } from './localized-text.js';
+/** Substitute the values of this call into a template of {@link ElicitationText}
+ *  (one rule for every backend: `shared/localized-text.ts`). */
+const fill = fillTemplate;
 const rec = (value) => typeof value === 'object' && value !== null && !Array.isArray(value) ? value : undefined;
 const str = (value) => typeof value === 'string' ? value : undefined;
 const num = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
@@ -86,20 +89,20 @@ function calendarDay(year, month, day) {
     return day <= length;
 }
 /** Validate one typed value against its field; the value or the reason. */
-export function parseFieldText(field, text) {
+export function parseFieldText(field, text, elicit) {
     const schema = field.schema;
     if (field.kind === 'number' || field.kind === 'integer') {
         const value = Number(text);
         if (text.trim() === '' || !Number.isFinite(value))
-            return { error: t('elicit-invalid-number') };
+            return { error: elicit.invalidNumber };
         if (field.kind === 'integer' && !Number.isInteger(value))
-            return { error: t('elicit-invalid-integer') };
+            return { error: elicit.invalidInteger };
         const min = num(schema.minimum);
         const max = num(schema.maximum);
         if (min !== undefined && value < min)
-            return { error: t('elicit-invalid-min', { min }) };
+            return { error: fill(elicit.invalidMin, { min }) };
         if (max !== undefined && value > max)
-            return { error: t('elicit-invalid-max', { max }) };
+            return { error: fill(elicit.invalidMax, { max }) };
         return { value };
     }
     if (field.kind === 'json') {
@@ -108,7 +111,7 @@ export function parseFieldText(field, text) {
             value = JSON.parse(text);
         }
         catch {
-            return { error: t('elicit-invalid-json') };
+            return { error: elicit.invalidJson };
         }
         const type = str(schema.type);
         const fits = type === 'array'
@@ -116,33 +119,33 @@ export function parseFieldText(field, text) {
             : type === 'object' ? false : typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
         // An MCP form value is a string, number, boolean or string array.
         if (!fits)
-            return { error: t('elicit-invalid-json') };
+            return { error: elicit.invalidJson };
         return { value: value };
     }
     const length = [...text].length;
     const minLength = num(schema.minLength);
     const maxLength = num(schema.maxLength);
     if (minLength !== undefined && length < minLength)
-        return { error: t('elicit-invalid-min-length', { n: minLength }) };
+        return { error: fill(elicit.invalidMinLength, { n: minLength }) };
     if (maxLength !== undefined && length > maxLength)
-        return { error: t('elicit-invalid-max-length', { n: maxLength }) };
+        return { error: fill(elicit.invalidMaxLength, { n: maxLength }) };
     switch (str(schema.format)) {
         case 'email':
             if (!EMAIL.test(text))
-                return { error: t('elicit-invalid-email') };
+                return { error: elicit.invalidEmail };
             break;
         case 'uri':
             try {
                 new URL(text);
             }
             catch {
-                return { error: t('elicit-invalid-uri') };
+                return { error: elicit.invalidUri };
             }
             break;
         case 'date': {
             const match = DATE.exec(text);
             if (match === null || !calendarDay(Number(match[1]), Number(match[2]), Number(match[3])))
-                return { error: t('elicit-invalid-date') };
+                return { error: elicit.invalidDate };
             break;
         }
         case 'date-time': {
@@ -155,7 +158,7 @@ export function parseFieldText(field, text) {
                 || !calendarDay(Number(match[1]), Number(match[2]), Number(match[3]))
                 || Number(match[4]) > 23 || Number(match[5]) > 59 || Number(match[6]) > 60
                 || Number(match[7]) > 23 || Number(match[8]) > 59)
-                return { error: t('elicit-invalid-date-time') };
+                return { error: elicit.invalidDateTime };
             break;
         }
         default:
@@ -171,50 +174,48 @@ export function parseFieldText(field, text) {
             // A pattern this runtime cannot compile is the server's to check.
         }
         if (!matches)
-            return { error: t('elicit-invalid-pattern') };
+            return { error: elicit.invalidPattern };
     }
     return { value: text };
 }
 /** A short constraint hint for a free-text field (shown under the question). */
-function constraintHint(field) {
+function constraintHint(field, elicit) {
     const schema = field.schema;
     switch (field.kind) {
         case 'number':
         case 'integer': {
             const min = num(schema.minimum);
             const max = num(schema.maximum);
-            const kind = t(field.kind === 'integer' ? 'elicit-kind-integer' : 'elicit-kind-number');
+            const kind = field.kind === 'integer' ? elicit.kindInteger : elicit.kindNumber;
             if (min !== undefined && max !== undefined)
-                return t('elicit-hint-range', { kind, min, max });
+                return fill(elicit.hintRange, { kind, min, max });
             if (min !== undefined)
-                return t('elicit-hint-min', { kind, min });
+                return fill(elicit.hintMin, { kind, min });
             if (max !== undefined)
-                return t('elicit-hint-max', { kind, max });
+                return fill(elicit.hintMax, { kind, max });
             return kind;
         }
         case 'json':
-            return t('elicit-hint-json');
+            return elicit.hintJson;
         case 'text': {
             const format = str(schema.format);
-            return format === undefined ? undefined : t('elicit-hint-format', { format });
+            return format === undefined ? undefined : fill(elicit.hintFormat, { format });
         }
         default:
             return undefined;
     }
 }
-/** The current language's form labels. */
-export const formLabels = () => ({ skip: t('elicit-skip'), yes: t('elicit-yes'), no: t('elicit-no') });
 /** A field's question (with the reason it is asked again, if any). */
-export function fieldQuestion(field, header, lead, error, labels = formLabels()) {
-    const skip = labels.skip;
+export function fieldQuestion(field, header, lead, error, elicit) {
+    const skip = elicit.skip;
     const detail = [
-        error === undefined ? undefined : t('elicit-invalid', { reason: error }),
+        error === undefined ? undefined : fill(elicit.invalid, { reason: error }),
         lead,
         field.description,
-        constraintHint(field),
+        constraintHint(field, elicit),
     ].filter((line) => line !== undefined && line !== '').join('\n');
-    const question = field.required ? field.title : t('elicit-optional', { title: field.title });
-    const optional = field.required ? [] : [{ label: skip, description: t('elicit-skip-desc') }];
+    const question = field.required ? field.title : fill(elicit.optional, { title: field.title });
+    const optional = field.required ? [] : [{ label: skip, description: elicit.skipDesc }];
     const defaults = (labels) => labels.length === 0 ? {} : { defaultSelected: labels };
     const base = { question, header, ...(detail === '' ? {} : { detail }) };
     switch (field.kind) {
@@ -223,7 +224,7 @@ export function fieldQuestion(field, header, lead, error, labels = formLabels())
             return { ...base, options: [...field.choices.map(choice => ({ label: choice.label })), ...optional], hideCustomInput: true, ...defaults(field.choices.filter(choice => choice.value === fallback).map(choice => choice.label)) };
         }
         case 'boolean': {
-            const { yes, no } = labels;
+            const { yes, no } = elicit;
             const fallback = field.schema.default;
             return { ...base, options: [{ label: yes }, { label: no }, ...optional], hideCustomInput: true, ...defaults(fallback === true ? [yes] : fallback === false ? [no] : []) };
         }
@@ -236,40 +237,40 @@ export function fieldQuestion(field, header, lead, error, labels = formLabels())
     }
 }
 /** One answered field: its value, `skip`, or why it is invalid. */
-export function fieldValue(field, answer, labels = formLabels()) {
+export function fieldValue(field, answer, elicit) {
     const selected = answer?.selected ?? [];
     const custom = answer?.custom?.trim() ?? '';
-    const skip = labels.skip;
+    const skip = elicit.skip;
     const skipped = selected.includes(skip);
     switch (field.kind) {
         case 'choice': {
             const choice = field.choices.find(item => item.label === selected[0]);
             if (choice !== undefined)
                 return { value: choice.value };
-            return skipped && !field.required ? { skip: true } : { error: t('elicit-invalid-choice') };
+            return skipped && !field.required ? { skip: true } : { error: elicit.invalidChoice };
         }
         case 'boolean':
-            if (selected[0] === labels.yes)
+            if (selected[0] === elicit.yes)
                 return { value: true };
-            if (selected[0] === labels.no)
+            if (selected[0] === elicit.no)
                 return { value: false };
-            return skipped && !field.required ? { skip: true } : { error: t('elicit-invalid-choice') };
+            return skipped && !field.required ? { skip: true } : { error: elicit.invalidChoice };
         case 'multi': {
             const values = field.choices.filter(choice => selected.includes(choice.label)).map(choice => choice.value);
             if (values.length === 0)
-                return skipped && !field.required ? { skip: true } : { error: t('elicit-invalid-choice') };
+                return skipped && !field.required ? { skip: true } : { error: elicit.invalidChoice };
             const min = num(field.schema.minItems);
             const max = num(field.schema.maxItems);
             if (min !== undefined && values.length < min)
-                return { error: t('elicit-invalid-min-items', { n: min }) };
+                return { error: fill(elicit.invalidMinItems, { n: min }) };
             if (max !== undefined && values.length > max)
-                return { error: t('elicit-invalid-max-items', { n: max }) };
+                return { error: fill(elicit.invalidMaxItems, { n: max }) };
             return { value: values };
         }
         default:
             if (custom === '')
-                return skipped && !field.required ? { skip: true } : { error: t('elicit-invalid-required') };
-            return parseFieldText(field, custom);
+                return skipped && !field.required ? { skip: true } : { error: elicit.invalidRequired };
+            return parseFieldText(field, custom, elicit);
     }
 }
 /** A short server label for the panel header chip. */
@@ -283,18 +284,17 @@ export function serverHeader(name) {
  * send / decline choice is asked once, after the first round; a re-ask
  * keeps the values already accepted and replaces the re-asked ones.
  */
-export function createElicitationForm(request) {
+export function createElicitationForm(request, elicit) {
     const fields = formFields(request.requestedSchema);
     const header = serverHeader(request.displayName ?? request.serverName);
     const lead = [request.title, request.message].filter((line) => line !== undefined && line.trim() !== '').join('\n');
-    const send = t('elicit-send');
-    const decline = t('elicit-decline');
-    const labels = formLabels();
+    const send = elicit.send;
+    const decline = elicit.decline;
     const confirm = {
-        question: t('elicit-confirm', { server: request.serverName }),
+        question: fill(elicit.confirm, { server: request.serverName }),
         header,
         ...(fields.length === 0 && lead !== '' ? { detail: lead } : {}),
-        options: [{ label: send, description: t('elicit-send-desc') }, { label: decline, description: t('elicit-decline-desc') }],
+        options: [{ label: send, description: elicit.sendDesc }, { label: decline, description: elicit.declineDesc }],
         hideCustomInput: true,
     };
     const values = new Map();
@@ -302,7 +302,7 @@ export function createElicitationForm(request) {
     let asked = fields;
     let sending = false;
     return {
-        questions: [...fields.map((field, index) => fieldQuestion(field, header, index === 0 ? lead : undefined, undefined, labels)), confirm],
+        questions: [...fields.map((field, index) => fieldQuestion(field, header, index === 0 ? lead : undefined, undefined, elicit)), confirm],
         answer: answers => {
             if (!sending) {
                 const choice = answers.answers[asked.length]?.selected[0];
@@ -312,7 +312,7 @@ export function createElicitationForm(request) {
             }
             const invalid = [];
             asked.forEach((field, index) => {
-                const outcome = fieldValue(field, answers.answers[index], labels);
+                const outcome = fieldValue(field, answers.answers[index], elicit);
                 if ('error' in outcome)
                     invalid.push({ field, error: outcome.error });
                 else if ('skip' in outcome)
@@ -322,39 +322,37 @@ export function createElicitationForm(request) {
             });
             if (invalid.length > 0) {
                 asked = invalid.map(item => item.field);
-                return { kind: 'reask', questions: invalid.map(item => fieldQuestion(item.field, header, undefined, item.error, labels)) };
+                return { kind: 'reask', questions: invalid.map(item => fieldQuestion(item.field, header, undefined, item.error, elicit)) };
             }
             return { kind: 'accept', content: Object.fromEntries(values) };
         },
     };
 }
 /** The URL-mode question; undefined when the request names no URL. */
-export function createElicitationUrlAsk(request) {
+export function createElicitationUrlAsk(request, elicit) {
     const target = request.url;
     if (target === undefined || target.trim() === '')
         return undefined;
-    const accept = t('elicit-url-accept');
+    const accept = elicit.urlAccept;
     const message = request.message ?? '';
     return {
         questions: [{
-                question: message.trim() === '' ? t('elicit-url-question', { server: request.serverName }) : message,
+                question: message.trim() === '' ? fill(elicit.urlQuestion, { server: request.serverName }) : message,
                 header: serverHeader(request.displayName ?? request.serverName),
-                detail: t('elicit-url-detail'),
+                detail: elicit.urlDetail,
                 link: target,
-                options: [{ label: accept, description: t('elicit-url-accept-desc') }, { label: t('elicit-decline'), description: t('elicit-decline-desc') }],
+                options: [{ label: accept, description: elicit.urlAcceptDesc }, { label: elicit.decline, description: elicit.declineDesc }],
                 hideCustomInput: true,
             }],
         accepted: answers => answers.answers[0]?.selected[0] === accept,
     };
 }
 /** The notice texts a backend shows around an elicitation. */
-export const elicitationNotices = {
-    /** URL mode: the server asks the user to open a page. */
-    urlOpen: (server, url) => t('elicit-url-notice', { server, url }),
-    /** URL mode: the server reported the flow done. */
-    urlComplete: (server) => t('elicit-url-complete', { server }),
-    /** URL mode without a URL: declined. */
-    urlMissing: (server) => t('elicit-url-missing', { server }),
-    /** A mode this client cannot render: declined. */
-    unsupported: (server, mode) => t('elicit-unsupported', { server, mode }),
-};
+export function elicitationNotices(elicit) {
+    return {
+        urlOpen: (server, url) => fill(elicit.urlNotice, { server, url }),
+        urlComplete: server => fill(elicit.urlComplete, { server }),
+        urlMissing: server => fill(elicit.urlMissing, { server }),
+        unsupported: (server, mode) => fill(elicit.unsupported, { server, mode }),
+    };
+}