@owlmeans/llm-common 0.1.18-rc.38 → 0.1.18-rc.39

package/README.md

@@ -20,7 +20,7 @@ extends these; `@owlmeans/llm` implements against them.
 ## Installation
 
 ```bash
-bun add @owlmeans/llm-common@^0.1.18-rc.38
+bun add @owlmeans/llm-common@^0.1.18-rc.39
 ```
 
 ## Usage
@@ -96,7 +96,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.48
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/llm-common",
-  "version": "0.1.18-rc.38",
-  "generatedAt": "2026-10-05T08:32:19.123Z",
+  "version": "0.1.18-rc.39",
+  "generatedAt": "2026-10-05T21:03:06.400Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/llm-common/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/llm-common
 
 **Layer:** Core
-**Install:** `"@owlmeans/llm-common": "^0.1.18-rc.38"` in `dependencies`
+**Install:** `"@owlmeans/llm-common": "^0.1.18-rc.39"` in `dependencies`
 
 The contracts half of the LLM stack. **No `@langchain/*` runtime dependency** — importable
 from a browser bundle, a queue worker, or any package that must not pull an inference SDK.

package/build/inquiry/helper/types.d.ts

@@ -0,0 +1,47 @@
+import type { Inquiry, InquiryAnswer } from '../types.js';
+/**
+ * Pure helpers over an inquiry and its answer — no IO, no state, no clock.
+ *
+ * They are here rather than in the runtime because every layer needs the same reading of an
+ * answer: the execution service, the pipeline runner, the `ask_user` tool, the connector and the
+ * screen that finally shows it. A second reading of "was this answered" is a second contract.
+ */
+export interface InquiryHelper {
+    /**
+     * What to assume when nobody answers: the question's own default, or a decline.
+     *
+     * A decline is an ANSWER — the run carries on and records what it assumed — which is why this
+     * never throws and never returns null.
+     */
+    defaultAnswerFor: (inquiry: Inquiry) => InquiryAnswer;
+    /**
+     * The one thing an answer says, as a string — the first chosen value, else the free text, else
+     * `null` when it says nothing at all (a decline, or an empty answer).
+     */
+    answeredWith: (answer: InquiryAnswer) => string | null;
+    /** Nobody could decide. Distinct from an empty answer — see {@link InquiryHelper.answeredWith}. */
+    isDeclined: (answer: InquiryAnswer) => boolean;
+    /**
+     * Cut an answer's free TEXT to the ceiling and SAY SO.
+     *
+     * Only the prose is cut. A `value` IS the decision — for a choice it has to equal one of the
+     * question's own option values — so slicing one does not degrade an answer, it silently replaces
+     * it with an identifier nobody offered and nothing matches, which `answeredWith` then hands on as
+     * what the person chose. An over-long value is a defect upstream rather than a long answer (the
+     * connector's schema refuses one outright instead of shortening it), so it travels on whole and is
+     * REPORTED through `truncated` — the flag every consumer already reads as "this is not exactly
+     * what the person gave".
+     */
+    capAnswer: (answer: InquiryAnswer, max?: number) => InquiryAnswer;
+    /**
+     * The copy of an answer a resumable pipeline STATE keeps: the decision whole, the prose cut to
+     * {@link INQUIRY_STATE_TEXT_CHARS}.
+     *
+     * The full answer goes back to whoever asked; only this reduced one is persisted, so a run that
+     * asks several questions still holds a state made of keys rather than of paragraphs.
+     */
+    stateAnswerOf: (answer: InquiryAnswer) => InquiryAnswer;
+    /** One-line label of a question — for a note, a trace line or a run row. */
+    renderInquiry: (inquiry: Inquiry) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/inquiry/helper/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/inquiry/helper/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,CAAA;IACrD;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI,CAAA;IACtD,mGAAmG;IACnG,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAA;IAC9C;;;;;;;;;;OAUG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,CAAA;IACjE;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAA;IACvD,4EAA4E;IAC5E,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;CAC5C"}

package/build/inquiry/helper/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/inquiry/helper/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/inquiry/helper/types.ts"],"names":[],"mappings":""}

package/build/inquiry/helper.d.ts

@@ -0,0 +1,4 @@
+import type { InquiryHelper } from './helper/types.js';
+export declare const createInquiryHelper: () => InquiryHelper;
+export declare const inquiryHelper: InquiryHelper;
+//# sourceMappingURL=helper.d.ts.map

package/build/inquiry/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/inquiry/helper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,eAAO,MAAM,mBAAmB,QAAO,aA8CtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/build/inquiry/helper.js

@@ -0,0 +1,39 @@
+import { DEFAULT_INQUIRY_ANSWER_CHARS, INQUIRY_STATE_TEXT_CHARS } from './consts.js';
+export const createInquiryHelper = () => {
+    const defaultAnswerFor = (inquiry) => inquiry.default != null
+        ? { inquiryId: inquiry.id, value: inquiry.default }
+        : { inquiryId: inquiry.id, declined: true };
+    const answeredWith = (answer) => {
+        const value = Array.isArray(answer.value) ? answer.value[0] : answer.value;
+        if (value != null && value !== '')
+            return value;
+        if (answer.text != null && answer.text !== '')
+            return answer.text;
+        return null;
+    };
+    const isDeclined = (answer) => answer.declined === true;
+    const capAnswer = (answer, max = DEFAULT_INQUIRY_ANSWER_CHARS) => {
+        const text = answer.text != null && answer.text.length > max
+            ? answer.text.slice(0, max)
+            : undefined;
+        const values = Array.isArray(answer.value)
+            ? answer.value
+            : answer.value != null ? [answer.value] : [];
+        const oversized = values.some(value => value.length > max);
+        if (text == null && !oversized)
+            return answer;
+        return { ...answer, ...(text != null ? { text } : {}), truncated: true };
+    };
+    const stateAnswerOf = (answer) => answer.text != null && answer.text.length > INQUIRY_STATE_TEXT_CHARS
+        ? { ...answer, text: answer.text.slice(0, INQUIRY_STATE_TEXT_CHARS), truncated: true }
+        : answer;
+    const renderInquiry = (inquiry) => {
+        const options = inquiry.options != null && inquiry.options.length > 0
+            ? ` (${inquiry.options.map(option => option.value).join(' | ')})`
+            : '';
+        return `[${inquiry.kind}] ${inquiry.question}${options}`.replace(/\s+/g, ' ').trim();
+    };
+    return { defaultAnswerFor, answeredWith, isDeclined, capAnswer, stateAnswerOf, renderInquiry };
+};
+export const inquiryHelper = createInquiryHelper();
+//# sourceMappingURL=helper.js.map

package/build/inquiry/helper.js.map

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

package/build/inquiry/index.d.ts

@@ -1,4 +1,6 @@
 export * from './consts.js';
 export type * from './types.js';
+export type * from './helper/types.js';
+export * from './helper.js';
 export * from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/build/inquiry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inquiry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inquiry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/build/inquiry/index.js

@@ -1,3 +1,4 @@
 export * from './consts.js';
+export * from './helper.js';
 export * from './utils.js';
 //# sourceMappingURL=index.js.map

package/build/inquiry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inquiry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAE3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inquiry/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAG3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/build/inquiry/utils.d.ts

@@ -1,45 +1,14 @@
 import type { Inquiry, InquiryAnswer } from './types.js';
-/**
- * Pure helpers over an inquiry and its answer — no IO, no state, no clock.
- *
- * They are here rather than in the runtime because every layer needs the same reading of an
- * answer: the execution service, the pipeline runner, the `ask_user` tool, the connector and the
- * screen that finally shows it. A second reading of "was this answered" is a second contract.
- */
-/**
- * What to assume when nobody answers: the question's own default, or a decline.
- *
- * A decline is an ANSWER — the run carries on and records what it assumed — which is why this
- * never throws and never returns null.
- */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.defaultAnswerFor(…)` */
 export declare const defaultAnswerFor: (inquiry: Inquiry) => InquiryAnswer;
-/**
- * The one thing an answer says, as a string — the first chosen value, else the free text, else
- * `null` when it says nothing at all (a decline, or an empty answer).
- */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.answeredWith(…)` */
 export declare const answeredWith: (answer: InquiryAnswer) => string | null;
-/** Nobody could decide. Distinct from an empty answer — see {@link answeredWith}. */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.isDeclined(…)` */
 export declare const isDeclined: (answer: InquiryAnswer) => boolean;
-/**
- * Cut an answer's free TEXT to the ceiling and SAY SO.
- *
- * Only the prose is cut. A `value` IS the decision — for a choice it has to equal one of the
- * question's own option values — so slicing one does not degrade an answer, it silently replaces
- * it with an identifier nobody offered and nothing matches, which `answeredWith` then hands on as
- * what the person chose. An over-long value is a defect upstream rather than a long answer (the
- * connector's schema refuses one outright instead of shortening it), so it travels on whole and is
- * REPORTED through `truncated` — the flag every consumer already reads as "this is not exactly
- * what the person gave".
- */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.capAnswer(…)` */
 export declare const capAnswer: (answer: InquiryAnswer, max?: number) => InquiryAnswer;
-/**
- * The copy of an answer a resumable pipeline STATE keeps: the decision whole, the prose cut to
- * {@link INQUIRY_STATE_TEXT_CHARS}.
- *
- * The full answer goes back to whoever asked; only this reduced one is persisted, so a run that
- * asks several questions still holds a state made of keys rather than of paragraphs.
- */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.stateAnswerOf(…)` */
 export declare const stateAnswerOf: (answer: InquiryAnswer) => InquiryAnswer;
-/** One-line label of a question — for a note, a trace line or a run row. */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.renderInquiry(…)` */
 export declare const renderInquiry: (inquiry: Inquiry) => string;
 //# sourceMappingURL=utils.d.ts.map

package/build/inquiry/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/inquiry/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;GAMG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,aAGL,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,YAAY,WAAY,aAAa,KAAG,MAAM,GAAG,IAM7D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,OAAmC,CAAA;AAEtF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,WACZ,aAAa,QAAO,MAAM,KACjC,aAYF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,WAAY,aAAa,KAAG,aAG1C,CAAA;AAEZ,4EAA4E;AAC5E,eAAO,MAAM,aAAa,YAAa,OAAO,KAAG,MAMhD,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/inquiry/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAExD,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,aAAwD,CAAA;AAE5G,gFAAgF;AAChF,eAAO,MAAM,YAAY,WAAY,aAAa,KAAG,MAAM,GAAG,IAA0C,CAAA;AAExG,8EAA8E;AAC9E,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,OAA2C,CAAA;AAE9F,6EAA6E;AAC7E,eAAO,MAAM,SAAS,WAAY,aAAa,QAAQ,MAAM,KAAG,aAAqD,CAAA;AAErH,iFAAiF;AACjF,eAAO,MAAM,aAAa,WAAY,aAAa,KAAG,aAAoD,CAAA;AAE1G,iFAAiF;AACjF,eAAO,MAAM,aAAa,YAAa,OAAO,KAAG,MAA8C,CAAA"}

package/build/inquiry/utils.js

@@ -1,72 +1,14 @@
-import { DEFAULT_INQUIRY_ANSWER_CHARS, INQUIRY_STATE_TEXT_CHARS } from './consts.js';
-/**
- * Pure helpers over an inquiry and its answer — no IO, no state, no clock.
- *
- * They are here rather than in the runtime because every layer needs the same reading of an
- * answer: the execution service, the pipeline runner, the `ask_user` tool, the connector and the
- * screen that finally shows it. A second reading of "was this answered" is a second contract.
- */
-/**
- * What to assume when nobody answers: the question's own default, or a decline.
- *
- * A decline is an ANSWER — the run carries on and records what it assumed — which is why this
- * never throws and never returns null.
- */
-export const defaultAnswerFor = (inquiry) => inquiry.default != null
-    ? { inquiryId: inquiry.id, value: inquiry.default }
-    : { inquiryId: inquiry.id, declined: true };
-/**
- * The one thing an answer says, as a string — the first chosen value, else the free text, else
- * `null` when it says nothing at all (a decline, or an empty answer).
- */
-export const answeredWith = (answer) => {
-    const value = Array.isArray(answer.value) ? answer.value[0] : answer.value;
-    if (value != null && value !== '')
-        return value;
-    if (answer.text != null && answer.text !== '')
-        return answer.text;
-    return null;
-};
-/** Nobody could decide. Distinct from an empty answer — see {@link answeredWith}. */
-export const isDeclined = (answer) => answer.declined === true;
-/**
- * Cut an answer's free TEXT to the ceiling and SAY SO.
- *
- * Only the prose is cut. A `value` IS the decision — for a choice it has to equal one of the
- * question's own option values — so slicing one does not degrade an answer, it silently replaces
- * it with an identifier nobody offered and nothing matches, which `answeredWith` then hands on as
- * what the person chose. An over-long value is a defect upstream rather than a long answer (the
- * connector's schema refuses one outright instead of shortening it), so it travels on whole and is
- * REPORTED through `truncated` — the flag every consumer already reads as "this is not exactly
- * what the person gave".
- */
-export const capAnswer = (answer, max = DEFAULT_INQUIRY_ANSWER_CHARS) => {
-    const text = answer.text != null && answer.text.length > max
-        ? answer.text.slice(0, max)
-        : undefined;
-    const values = Array.isArray(answer.value)
-        ? answer.value
-        : answer.value != null ? [answer.value] : [];
-    const oversized = values.some(value => value.length > max);
-    if (text == null && !oversized)
-        return answer;
-    return { ...answer, ...(text != null ? { text } : {}), truncated: true };
-};
-/**
- * The copy of an answer a resumable pipeline STATE keeps: the decision whole, the prose cut to
- * {@link INQUIRY_STATE_TEXT_CHARS}.
- *
- * The full answer goes back to whoever asked; only this reduced one is persisted, so a run that
- * asks several questions still holds a state made of keys rather than of paragraphs.
- */
-export const stateAnswerOf = (answer) => answer.text != null && answer.text.length > INQUIRY_STATE_TEXT_CHARS
-    ? { ...answer, text: answer.text.slice(0, INQUIRY_STATE_TEXT_CHARS), truncated: true }
-    : answer;
-/** One-line label of a question — for a note, a trace line or a run row. */
-export const renderInquiry = (inquiry) => {
-    const options = inquiry.options != null && inquiry.options.length > 0
-        ? ` (${inquiry.options.map(option => option.value).join(' | ')})`
-        : '';
-    return `[${inquiry.kind}] ${inquiry.question}${options}`.replace(/\s+/g, ' ').trim();
-};
+import { inquiryHelper } from './helper.js';
+/** @deprecated compat:factory-refactor — use `inquiryHelper.defaultAnswerFor(…)` */
+export const defaultAnswerFor = (inquiry) => inquiryHelper.defaultAnswerFor(inquiry);
+/** @deprecated compat:factory-refactor — use `inquiryHelper.answeredWith(…)` */
+export const answeredWith = (answer) => inquiryHelper.answeredWith(answer);
+/** @deprecated compat:factory-refactor — use `inquiryHelper.isDeclined(…)` */
+export const isDeclined = (answer) => inquiryHelper.isDeclined(answer);
+/** @deprecated compat:factory-refactor — use `inquiryHelper.capAnswer(…)` */
+export const capAnswer = (answer, max) => inquiryHelper.capAnswer(answer, max);
+/** @deprecated compat:factory-refactor — use `inquiryHelper.stateAnswerOf(…)` */
+export const stateAnswerOf = (answer) => inquiryHelper.stateAnswerOf(answer);
+/** @deprecated compat:factory-refactor — use `inquiryHelper.renderInquiry(…)` */
+export const renderInquiry = (inquiry) => inquiryHelper.renderInquiry(inquiry);
 //# sourceMappingURL=utils.js.map

package/build/inquiry/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/inquiry/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/inquiry/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAAiB,EAAE,CAAC,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;AAE5G,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAqB,EAAiB,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AAExG,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAqB,EAAW,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AAE9F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAqB,EAAE,GAAY,EAAiB,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAErH,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAqB,EAAiB,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;AAE1G,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAgB,EAAU,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/llm-common",
-  "version": "0.1.18-rc.38",
+  "version": "0.1.18-rc.39",
   "license": "MIT",
   "type": "module",
   "scripts": {

package/src/inquiry/helper/types.ts

@@ -0,0 +1,47 @@
+import type { Inquiry, InquiryAnswer } from '../types.js'
+
+/**
+ * Pure helpers over an inquiry and its answer — no IO, no state, no clock.
+ *
+ * They are here rather than in the runtime because every layer needs the same reading of an
+ * answer: the execution service, the pipeline runner, the `ask_user` tool, the connector and the
+ * screen that finally shows it. A second reading of "was this answered" is a second contract.
+ */
+export interface InquiryHelper {
+  /**
+   * What to assume when nobody answers: the question's own default, or a decline.
+   *
+   * A decline is an ANSWER — the run carries on and records what it assumed — which is why this
+   * never throws and never returns null.
+   */
+  defaultAnswerFor: (inquiry: Inquiry) => InquiryAnswer
+  /**
+   * The one thing an answer says, as a string — the first chosen value, else the free text, else
+   * `null` when it says nothing at all (a decline, or an empty answer).
+   */
+  answeredWith: (answer: InquiryAnswer) => string | null
+  /** Nobody could decide. Distinct from an empty answer — see {@link InquiryHelper.answeredWith}. */
+  isDeclined: (answer: InquiryAnswer) => boolean
+  /**
+   * Cut an answer's free TEXT to the ceiling and SAY SO.
+   *
+   * Only the prose is cut. A `value` IS the decision — for a choice it has to equal one of the
+   * question's own option values — so slicing one does not degrade an answer, it silently replaces
+   * it with an identifier nobody offered and nothing matches, which `answeredWith` then hands on as
+   * what the person chose. An over-long value is a defect upstream rather than a long answer (the
+   * connector's schema refuses one outright instead of shortening it), so it travels on whole and is
+   * REPORTED through `truncated` — the flag every consumer already reads as "this is not exactly
+   * what the person gave".
+   */
+  capAnswer: (answer: InquiryAnswer, max?: number) => InquiryAnswer
+  /**
+   * The copy of an answer a resumable pipeline STATE keeps: the decision whole, the prose cut to
+   * {@link INQUIRY_STATE_TEXT_CHARS}.
+   *
+   * The full answer goes back to whoever asked; only this reduced one is persisted, so a run that
+   * asks several questions still holds a state made of keys rather than of paragraphs.
+   */
+  stateAnswerOf: (answer: InquiryAnswer) => InquiryAnswer
+  /** One-line label of a question — for a note, a trace line or a run row. */
+  renderInquiry: (inquiry: Inquiry) => string
+}

package/src/inquiry/helper.ts

@@ -0,0 +1,53 @@
+import { DEFAULT_INQUIRY_ANSWER_CHARS, INQUIRY_STATE_TEXT_CHARS } from './consts.js'
+import type { Inquiry, InquiryAnswer } from './types.js'
+import type { InquiryHelper } from './helper/types.js'
+
+export const createInquiryHelper = (): InquiryHelper => {
+  const defaultAnswerFor = (inquiry: Inquiry): InquiryAnswer =>
+    inquiry.default != null
+      ? { inquiryId: inquiry.id, value: inquiry.default }
+      : { inquiryId: inquiry.id, declined: true }
+
+  const answeredWith = (answer: InquiryAnswer): string | null => {
+    const value = Array.isArray(answer.value) ? answer.value[0] : answer.value
+    if (value != null && value !== '') return value
+    if (answer.text != null && answer.text !== '') return answer.text
+
+    return null
+  }
+
+  const isDeclined = (answer: InquiryAnswer): boolean => answer.declined === true
+
+  const capAnswer = (
+    answer: InquiryAnswer, max: number = DEFAULT_INQUIRY_ANSWER_CHARS
+  ): InquiryAnswer => {
+    const text = answer.text != null && answer.text.length > max
+      ? answer.text.slice(0, max)
+      : undefined
+    const values = Array.isArray(answer.value)
+      ? answer.value
+      : answer.value != null ? [answer.value] : []
+    const oversized = values.some(value => value.length > max)
+
+    if (text == null && !oversized) return answer
+
+    return { ...answer, ...(text != null ? { text } : {}), truncated: true }
+  }
+
+  const stateAnswerOf = (answer: InquiryAnswer): InquiryAnswer =>
+    answer.text != null && answer.text.length > INQUIRY_STATE_TEXT_CHARS
+      ? { ...answer, text: answer.text.slice(0, INQUIRY_STATE_TEXT_CHARS), truncated: true }
+      : answer
+
+  const renderInquiry = (inquiry: Inquiry): string => {
+    const options = inquiry.options != null && inquiry.options.length > 0
+      ? ` (${inquiry.options.map(option => option.value).join(' | ')})`
+      : ''
+
+    return `[${inquiry.kind}] ${inquiry.question}${options}`.replace(/\s+/g, ' ').trim()
+  }
+
+  return { defaultAnswerFor, answeredWith, isDeclined, capAnswer, stateAnswerOf, renderInquiry }
+}
+
+export const inquiryHelper = createInquiryHelper()

package/src/inquiry/index.ts

@@ -1,3 +1,5 @@
 export * from './consts.js'
 export type * from './types.js'
+export type * from './helper/types.js'
+export * from './helper.js'
 export * from './utils.js'

package/src/inquiry/utils.ts

@@ -1,84 +1,20 @@
-import { DEFAULT_INQUIRY_ANSWER_CHARS, INQUIRY_STATE_TEXT_CHARS } from './consts.js'
+import { inquiryHelper } from './helper.js'
 import type { Inquiry, InquiryAnswer } from './types.js'
 
-/**
- * Pure helpers over an inquiry and its answer — no IO, no state, no clock.
- *
- * They are here rather than in the runtime because every layer needs the same reading of an
- * answer: the execution service, the pipeline runner, the `ask_user` tool, the connector and the
- * screen that finally shows it. A second reading of "was this answered" is a second contract.
- */
+/** @deprecated compat:factory-refactor — use `inquiryHelper.defaultAnswerFor(…)` */
+export const defaultAnswerFor = (inquiry: Inquiry): InquiryAnswer => inquiryHelper.defaultAnswerFor(inquiry)
 
-/**
- * What to assume when nobody answers: the question's own default, or a decline.
- *
- * A decline is an ANSWER — the run carries on and records what it assumed — which is why this
- * never throws and never returns null.
- */
-export const defaultAnswerFor = (inquiry: Inquiry): InquiryAnswer =>
-  inquiry.default != null
-    ? { inquiryId: inquiry.id, value: inquiry.default }
-    : { inquiryId: inquiry.id, declined: true }
+/** @deprecated compat:factory-refactor — use `inquiryHelper.answeredWith(…)` */
+export const answeredWith = (answer: InquiryAnswer): string | null => inquiryHelper.answeredWith(answer)
 
-/**
- * The one thing an answer says, as a string — the first chosen value, else the free text, else
- * `null` when it says nothing at all (a decline, or an empty answer).
- */
-export const answeredWith = (answer: InquiryAnswer): string | null => {
-  const value = Array.isArray(answer.value) ? answer.value[0] : answer.value
-  if (value != null && value !== '') return value
-  if (answer.text != null && answer.text !== '') return answer.text
+/** @deprecated compat:factory-refactor — use `inquiryHelper.isDeclined(…)` */
+export const isDeclined = (answer: InquiryAnswer): boolean => inquiryHelper.isDeclined(answer)
 
-  return null
-}
+/** @deprecated compat:factory-refactor — use `inquiryHelper.capAnswer(…)` */
+export const capAnswer = (answer: InquiryAnswer, max?: number): InquiryAnswer => inquiryHelper.capAnswer(answer, max)
 
-/** Nobody could decide. Distinct from an empty answer — see {@link answeredWith}. */
-export const isDeclined = (answer: InquiryAnswer): boolean => answer.declined === true
+/** @deprecated compat:factory-refactor — use `inquiryHelper.stateAnswerOf(…)` */
+export const stateAnswerOf = (answer: InquiryAnswer): InquiryAnswer => inquiryHelper.stateAnswerOf(answer)
 
-/**
- * Cut an answer's free TEXT to the ceiling and SAY SO.
- *
- * Only the prose is cut. A `value` IS the decision — for a choice it has to equal one of the
- * question's own option values — so slicing one does not degrade an answer, it silently replaces
- * it with an identifier nobody offered and nothing matches, which `answeredWith` then hands on as
- * what the person chose. An over-long value is a defect upstream rather than a long answer (the
- * connector's schema refuses one outright instead of shortening it), so it travels on whole and is
- * REPORTED through `truncated` — the flag every consumer already reads as "this is not exactly
- * what the person gave".
- */
-export const capAnswer = (
-  answer: InquiryAnswer, max: number = DEFAULT_INQUIRY_ANSWER_CHARS
-): InquiryAnswer => {
-  const text = answer.text != null && answer.text.length > max
-    ? answer.text.slice(0, max)
-    : undefined
-  const values = Array.isArray(answer.value)
-    ? answer.value
-    : answer.value != null ? [answer.value] : []
-  const oversized = values.some(value => value.length > max)
-
-  if (text == null && !oversized) return answer
-
-  return { ...answer, ...(text != null ? { text } : {}), truncated: true }
-}
-
-/**
- * The copy of an answer a resumable pipeline STATE keeps: the decision whole, the prose cut to
- * {@link INQUIRY_STATE_TEXT_CHARS}.
- *
- * The full answer goes back to whoever asked; only this reduced one is persisted, so a run that
- * asks several questions still holds a state made of keys rather than of paragraphs.
- */
-export const stateAnswerOf = (answer: InquiryAnswer): InquiryAnswer =>
-  answer.text != null && answer.text.length > INQUIRY_STATE_TEXT_CHARS
-    ? { ...answer, text: answer.text.slice(0, INQUIRY_STATE_TEXT_CHARS), truncated: true }
-    : answer
-
-/** One-line label of a question — for a note, a trace line or a run row. */
-export const renderInquiry = (inquiry: Inquiry): string => {
-  const options = inquiry.options != null && inquiry.options.length > 0
-    ? ` (${inquiry.options.map(option => option.value).join(' | ')})`
-    : ''
-
-  return `[${inquiry.kind}] ${inquiry.question}${options}`.replace(/\s+/g, ' ').trim()
-}
+/** @deprecated compat:factory-refactor — use `inquiryHelper.renderInquiry(…)` */
+export const renderInquiry = (inquiry: Inquiry): string => inquiryHelper.renderInquiry(inquiry)

package/tests/inquiry.spec.ts

@@ -1,7 +1,6 @@
 import { describe, expect, test } from 'bun:test'
 import {
-  answeredWith, capAnswer, CONFIRM_NO, CONFIRM_YES, defaultAnswerFor, DEFAULT_INQUIRY_ANSWER_CHARS,
-  INQUIRY_STATE_TEXT_CHARS, InquiryKind, isDeclined, renderInquiry, stateAnswerOf,
+  CONFIRM_NO, CONFIRM_YES, DEFAULT_INQUIRY_ANSWER_CHARS, INQUIRY_STATE_TEXT_CHARS, InquiryKind, inquiryHelper,
 } from '../src/index.js'
 import type { Inquiry, InquiryAnswer } from '../src/index.js'
 
@@ -24,61 +23,61 @@ const inquiry = (patch: Partial<Inquiry> = {}): Inquiry => ({
 
 describe('@owlmeans/llm-common — what an unanswered question assumes', () => {
   test('a question with a default answers itself with it', () => {
-    expect(defaultAnswerFor(inquiry({ default: 'postgres' })))
+    expect(inquiryHelper.defaultAnswerFor(inquiry({ default: 'postgres' })))
       .toEqual({ inquiryId: 'q1', value: 'postgres' })
   })
 
   test('a question without one declines — a decision, never a failure', () => {
-    const answer = defaultAnswerFor(inquiry())
-    expect(isDeclined(answer)).toBe(true)
-    expect(answeredWith(answer)).toBeNull()
+    const answer = inquiryHelper.defaultAnswerFor(inquiry())
+    expect(inquiryHelper.isDeclined(answer)).toBe(true)
+    expect(inquiryHelper.answeredWith(answer)).toBeNull()
   })
 
   test('a multiple-choice default travels whole', () => {
-    expect(defaultAnswerFor(inquiry({ multiple: true, default: ['postgres', 'mongo'] })).value)
+    expect(inquiryHelper.defaultAnswerFor(inquiry({ multiple: true, default: ['postgres', 'mongo'] })).value)
       .toEqual(['postgres', 'mongo'])
   })
 })
 
 describe('@owlmeans/llm-common — reading one answer', () => {
   test('the chosen value wins over free text, and the first of a list is the answer', () => {
-    expect(answeredWith({ inquiryId: 'q1', value: 'mongo', text: 'or postgres' })).toBe('mongo')
-    expect(answeredWith({ inquiryId: 'q1', value: ['mongo', 'redis'] })).toBe('mongo')
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1', value: 'mongo', text: 'or postgres' })).toBe('mongo')
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1', value: ['mongo', 'redis'] })).toBe('mongo')
   })
 
   test('free text answers a question that offered no options', () => {
-    expect(answeredWith({ inquiryId: 'q1', text: 'the vendor one' })).toBe('the vendor one')
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1', text: 'the vendor one' })).toBe('the vendor one')
   })
 
   test('an answer that says nothing reads as nothing, declined or not', () => {
-    expect(answeredWith({ inquiryId: 'q1' })).toBeNull()
-    expect(answeredWith({ inquiryId: 'q1', value: '', text: '' })).toBeNull()
-    expect(isDeclined({ inquiryId: 'q1' })).toBe(false)
-    expect(isDeclined({ inquiryId: 'q1', declined: true })).toBe(true)
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1' })).toBeNull()
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1', value: '', text: '' })).toBeNull()
+    expect(inquiryHelper.isDeclined({ inquiryId: 'q1' })).toBe(false)
+    expect(inquiryHelper.isDeclined({ inquiryId: 'q1', declined: true })).toBe(true)
   })
 
   test('a confirmation is just its two values', () => {
-    expect(answeredWith({ inquiryId: 'q1', value: CONFIRM_YES })).toBe(CONFIRM_YES)
-    expect(answeredWith({ inquiryId: 'q1', value: CONFIRM_NO })).toBe(CONFIRM_NO)
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1', value: CONFIRM_YES })).toBe(CONFIRM_YES)
+    expect(inquiryHelper.answeredWith({ inquiryId: 'q1', value: CONFIRM_NO })).toBe(CONFIRM_NO)
   })
 })
 
 describe('@owlmeans/llm-common — the one ceiling', () => {
   test('an answer inside the ceiling is left exactly as it came', () => {
     const answer: InquiryAnswer = { inquiryId: 'q1', value: 'mongo', text: 'because of the driver' }
-    expect(capAnswer(answer)).toEqual(answer)
-    expect(capAnswer(answer).truncated).toBeUndefined()
+    expect(inquiryHelper.capAnswer(answer)).toEqual(answer)
+    expect(inquiryHelper.capAnswer(answer).truncated).toBeUndefined()
   })
 
   test('a cut is never silent', () => {
-    const capped = capAnswer({ inquiryId: 'q1', text: 'x'.repeat(DEFAULT_INQUIRY_ANSWER_CHARS + 5) })
+    const capped = inquiryHelper.capAnswer({ inquiryId: 'q1', text: 'x'.repeat(DEFAULT_INQUIRY_ANSWER_CHARS + 5) })
     expect(capped.text).toHaveLength(DEFAULT_INQUIRY_ANSWER_CHARS)
     expect(capped.truncated).toBe(true)
   })
 
   test('an over-long value is reported, never shortened into an option nobody offered', () => {
     const value = ['ok', 'y'.repeat(40)]
-    const capped = capAnswer({ inquiryId: 'q1', value }, 10)
+    const capped = inquiryHelper.capAnswer({ inquiryId: 'q1', value }, 10)
     // Cutting prose degrades an answer; cutting an identifier CHANGES it — `answeredWith` would
     // then hand the caller a choice the question never carried.
     expect(capped.value).toEqual(value)
@@ -89,24 +88,24 @@ describe('@owlmeans/llm-common — the one ceiling', () => {
     const answer: InquiryAnswer = {
       inquiryId: 'q1', value: 'postgres', text: 'z'.repeat(INQUIRY_STATE_TEXT_CHARS + 100),
     }
-    const stored = stateAnswerOf(answer)
+    const stored = inquiryHelper.stateAnswerOf(answer)
     expect(stored.value).toBe('postgres')
     expect(stored.text).toHaveLength(INQUIRY_STATE_TEXT_CHARS)
     expect(stored.truncated).toBe(true)
     // The answer handed back to whoever asked is untouched — only the persisted copy is reduced.
     expect(answer.text).toHaveLength(INQUIRY_STATE_TEXT_CHARS + 100)
-    expect(stateAnswerOf({ inquiryId: 'q1', value: 'postgres' }).truncated).toBeUndefined()
+    expect(inquiryHelper.stateAnswerOf({ inquiryId: 'q1', value: 'postgres' }).truncated).toBeUndefined()
   })
 })
 
 describe('@owlmeans/llm-common — one line for a trace', () => {
   test('the label names the kind, the question and the choices, on one line', () => {
-    expect(renderInquiry(inquiry({ question: 'Which\n  database?' })))
+    expect(inquiryHelper.renderInquiry(inquiry({ question: 'Which\n  database?' })))
       .toBe('[choice] Which database? (postgres | mongo)')
   })
 
   test('a question with no options renders without an empty bracket', () => {
-    expect(renderInquiry({ id: 'q2', kind: InquiryKind.Confirm, question: 'Relocate the origin?' }))
+    expect(inquiryHelper.renderInquiry({ id: 'q2', kind: InquiryKind.Confirm, question: 'Relocate the origin?' }))
       .toBe('[confirm] Relocate the origin?')
   })
 })