@alex.botez/elaborate 1.0.0

package/dist/interview/composition.js

@@ -0,0 +1,19 @@
+/**
+ * Question composition — LLM call that produces an interview question with
+ * optional suggested answers, preceded by the composition quality preamble.
+ */
+import { WorkflowContext } from "../durable/index.js";
+import { compositionPreamble } from "./preambles.js";
+/** Compose a question with suggestions; falls back to step.fallback if agent returns empty. */
+WorkflowContext.prototype.compose = async function (step) {
+    const compPre = compositionPreamble();
+    const enrichedStep = compPre
+        ? { ...step, message: compPre + "\n\n" + step.message }
+        : step;
+    const { question, suggestions } = await this.infer(enrichedStep);
+    return question ? { question, suggestions } : { question: step.fallback };
+};
+if (typeof WorkflowContext.prototype.compose !== "function") {
+    throw new Error("interview/composition.ts self-check failed: WorkflowContext.prototype.compose is not a function.");
+}
+//# sourceMappingURL=composition.js.map

package/dist/interview/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../src/interview/composition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AASrD,+FAA+F;AAC/F,eAAe,CAAC,SAAS,CAAC,OAAO,GAAG,KAAK,WAAW,IAAmB;IACrE,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO;QAC1B,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE;QACvD,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjE,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC5E,CAAC,CAAC;AAEF,IAAI,OAAQ,eAAe,CAAC,SAAgD,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;IACpG,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;AACtH,CAAC"}

package/dist/interview/describe.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Derives LLM prompt schemas from Zod definitions — single source of truth
+ * for both TypeScript types (z.infer) and prompt schema strings.
+ *
+ * Supported Zod types: string, number, boolean, array, object, optional.
+ * Throws on unsupported types to surface gaps early.
+ */
+import { ZodString, ZodArray, ZodObject } from "zod";
+import { z } from "zod";
+import type { InferStep } from "../durable/index.js";
+export declare const ComposeSchema: ZodObject<{
+    question: ZodString;
+    suggestions: ZodArray<ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    suggestions: string[];
+    question: string;
+}, {
+    suggestions: string[];
+    question: string;
+}>;
+/** InferStep pre-loaded with a fallback question — used by ctx.compose. */
+export interface ComposeParams extends InferStep<{
+    question: string;
+    suggestions: string[];
+}> {
+    readonly fallback: string;
+}
+/** Create an InferStep from a Zod schema — converts schema to prompt format, brands return type. */
+export declare function inferStep<S extends ZodObject<any>>(args: {
+    id: string;
+    schema: S;
+    message: string;
+}): InferStep<S["_output"]>;
+/** Create an inferCompositionStep — inferStep plus a fallback question for when the LLM response is empty. */
+export declare function inferCompositionStep(args: {
+    id: string;
+    message: string;
+    fallback: string;
+}): ComposeParams;
+export declare function zodToPromptSchema(schema: ZodObject<any>): Record<string, string>;
+//# sourceMappingURL=describe.d.ts.map

package/dist/interview/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/interview/describe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,SAAS,EAGT,QAAQ,EACR,SAAS,EAIV,MAAM,KAAK,CAAC;AACb,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,2EAA2E;AAC3E,MAAM,WAAW,aAAc,SAAQ,SAAS,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;IAC3F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA8CD,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAG1B;AAED,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,aAAa,CAGhB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAShF"}

package/dist/interview/describe.js

@@ -0,0 +1,80 @@
+/**
+ * Derives LLM prompt schemas from Zod definitions — single source of truth
+ * for both TypeScript types (z.infer) and prompt schema strings.
+ *
+ * Supported Zod types: string, number, boolean, array, object, optional.
+ * Throws on unsupported types to surface gaps early.
+ */
+import { ZodString, ZodNumber, ZodBoolean, ZodArray, ZodObject, ZodOptional, ZodNullable, ZodEnum, } from "zod";
+import { z } from "zod";
+export const ComposeSchema = z.object({
+    question: z.string().describe("the question to ask the stakeholder"),
+    suggestions: z.array(z.string()).describe("2-3 suggested answers"),
+});
+/** Serialize a Zod type to compact inline notation (e.g. `{ description: string, relatedGoals?: string[] }[]`). */
+function zodTypeToString(schema, path = "") {
+    if (schema instanceof ZodOptional) {
+        return zodTypeToString(schema._def.innerType, path);
+    }
+    if (schema instanceof ZodNullable) {
+        return `${zodTypeToString(schema._def.innerType, path)} | null`;
+    }
+    if (schema instanceof ZodString)
+        return "string";
+    if (schema instanceof ZodNumber)
+        return "number";
+    if (schema instanceof ZodBoolean)
+        return "boolean";
+    if (schema instanceof ZodEnum) {
+        return schema._def.values.map((v) => `"${v}"`).join(" | ");
+    }
+    if (schema instanceof ZodArray) {
+        return `${zodTypeToString(schema._def.type, `${path}[]`)}[]`;
+    }
+    if (schema instanceof ZodObject) {
+        const shape = schema._def.shape();
+        const fields = Object.entries(shape).map(([key, val]) => {
+            const opt = val instanceof ZodOptional ? "?" : "";
+            const desc = getDescription(val);
+            const nested = path ? `${path}.${key}` : key;
+            const typeStr = zodTypeToString(val, nested);
+            return desc ? `${key}${opt}: ${typeStr} - ${desc}` : `${key}${opt}: ${typeStr}`;
+        });
+        return `{ ${fields.join(", ")} }`;
+    }
+    const where = path ? ` at "${path}"` : "";
+    throw new Error(`zodTypeToString: unsupported Zod type ${schema._def?.typeName ?? "unknown"}${where}`);
+}
+/** Get .describe() text from either the outer wrapper or the inner type. */
+function getDescription(schema) {
+    if (schema.description)
+        return schema.description;
+    if (schema instanceof ZodOptional && schema._def.innerType.description) {
+        return schema._def.innerType.description;
+    }
+    if (schema instanceof ZodNullable && schema._def.innerType.description) {
+        return schema._def.innerType.description;
+    }
+    return "";
+}
+/** Create an InferStep from a Zod schema — converts schema to prompt format, brands return type. */
+export function inferStep(args) {
+    const { id, message, schema } = args;
+    return { id, message, schema: zodToPromptSchema(schema) };
+}
+/** Create an inferCompositionStep — inferStep plus a fallback question for when the LLM response is empty. */
+export function inferCompositionStep(args) {
+    const { fallback, ...rest } = args;
+    return { ...inferStep({ schema: ComposeSchema, ...rest }), fallback };
+}
+export function zodToPromptSchema(schema) {
+    const shape = schema._def.shape();
+    const result = {};
+    for (const [key, field] of Object.entries(shape)) {
+        const desc = getDescription(field);
+        const typeStr = zodTypeToString(field);
+        result[key] = desc ? `${typeStr} - ${desc}` : typeStr;
+    }
+    return result;
+}
+//# sourceMappingURL=describe.js.map

package/dist/interview/describe.js.map

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

package/dist/interview/deviation.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Deviation resilience — classification errors and retry primitive.
+ *
+ * When ctx.extract detects that the stakeholder didn't answer the question
+ * (clarification request, off-topic, pushback), it throws a typed error.
+ * The retry primitive catches these and gives the callback a chance to re-ask.
+ *
+ * One error class per deviation type:
+ * - Confusion → user is confused, rephrase the question
+ * - OffTopic → unrelated information or new idea
+ * - Pushback → questioned the process or method
+ * - TopicChange → tried to steer to a different subject
+ * - Frustration → expressed fatigue or impatience
+ */
+/** Detailed classification of the stakeholder's response. */
+export type ResponseClass = "answer" | "confusion" | "off_topic" | "pushback" | "topic_change" | "frustration";
+/** Thrown when the stakeholder expresses confusion or asks for clarification. */
+export declare class Confusion extends Error {
+    readonly response: string;
+    constructor(response: string);
+}
+/** Thrown when the stakeholder provides unrelated information or a new idea. */
+export declare class OffTopic extends Error {
+    readonly response: string;
+    readonly parkedItems: Array<{
+        content: string;
+    }>;
+    constructor(response: string, parkedItems?: Array<{
+        content: string;
+    }>);
+}
+/** Thrown when the stakeholder questions the process or method. */
+export declare class Pushback extends Error {
+    readonly response: string;
+    readonly parkedItems: Array<{
+        content: string;
+    }>;
+    constructor(response: string, parkedItems?: Array<{
+        content: string;
+    }>);
+}
+/** Thrown when the stakeholder tries to steer to a different subject. */
+export declare class TopicChange extends Error {
+    readonly response: string;
+    readonly parkedItems: Array<{
+        content: string;
+    }>;
+    constructor(response: string, parkedItems?: Array<{
+        content: string;
+    }>);
+}
+/** Thrown when the stakeholder expresses fatigue or impatience. */
+export declare class Frustration extends Error {
+    readonly response: string;
+    readonly parkedItems: Array<{
+        content: string;
+    }>;
+    constructor(response: string, parkedItems?: Array<{
+        content: string;
+    }>);
+}
+/** Union of all deviation error types. */
+export type DeviationError = Confusion | OffTopic | Pushback | TopicChange | Frustration;
+/** All deviation error constructors. */
+declare const DEVIATION_CLASSES: readonly [typeof Confusion, typeof OffTopic, typeof Pushback, typeof TopicChange, typeof Frustration];
+/** Check if a value is a deviation error. */
+export declare function isDeviationError(e: unknown): e is DeviationError;
+/** Map a ResponseClass to its error, or null for 'answer'. */
+export declare function classifyResponse(responseClass: ResponseClass, response: string, parkedItems?: Array<{
+    content: string;
+}>): DeviationError | null;
+/** Human-readable acknowledgment text for the stakeholder after a deviation. */
+export declare function deviationMessage(error: DeviationError): string;
+/** Constructor type for any deviation error class. */
+type DeviationErrorClass = (typeof DEVIATION_CLASSES)[number];
+/** Options for ctx.retryOnDeviation(). */
+export interface RetryOptions<T> {
+    /** Maximum number of retries after the initial attempt. Default: 2. */
+    maxRetries?: number;
+    /** Value returned when all retries are exhausted. If absent, the last error is re-thrown. */
+    defaults?: T;
+    /** Error types to retry on. Default: all deviation errors. */
+    retryOn?: DeviationErrorClass[];
+}
+declare module "../durable/workflow.js" {
+    interface WorkflowContext {
+        retryOnDeviation<T>(callback: (index: number, error?: DeviationError) => Promise<T>, options?: RetryOptions<T>): Promise<T>;
+    }
+}
+export {};
+//# sourceMappingURL=deviation.d.ts.map

package/dist/interview/deviation.d.ts.map

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

package/dist/interview/deviation.js

@@ -0,0 +1,137 @@
+/**
+ * Deviation resilience — classification errors and retry primitive.
+ *
+ * When ctx.extract detects that the stakeholder didn't answer the question
+ * (clarification request, off-topic, pushback), it throws a typed error.
+ * The retry primitive catches these and gives the callback a chance to re-ask.
+ *
+ * One error class per deviation type:
+ * - Confusion → user is confused, rephrase the question
+ * - OffTopic → unrelated information or new idea
+ * - Pushback → questioned the process or method
+ * - TopicChange → tried to steer to a different subject
+ * - Frustration → expressed fatigue or impatience
+ */
+import { WorkflowContext } from "../durable/index.js";
+// ── Error classes ──
+/** Thrown when the stakeholder expresses confusion or asks for clarification. */
+export class Confusion extends Error {
+    response;
+    constructor(response) {
+        super(response);
+        this.name = "Confusion";
+        this.response = response;
+    }
+}
+/** Thrown when the stakeholder provides unrelated information or a new idea. */
+export class OffTopic extends Error {
+    response;
+    parkedItems;
+    constructor(response, parkedItems) {
+        super(response);
+        this.name = "OffTopic";
+        this.response = response;
+        this.parkedItems = parkedItems ?? [];
+    }
+}
+/** Thrown when the stakeholder questions the process or method. */
+export class Pushback extends Error {
+    response;
+    parkedItems;
+    constructor(response, parkedItems) {
+        super(response);
+        this.name = "Pushback";
+        this.response = response;
+        this.parkedItems = parkedItems ?? [];
+    }
+}
+/** Thrown when the stakeholder tries to steer to a different subject. */
+export class TopicChange extends Error {
+    response;
+    parkedItems;
+    constructor(response, parkedItems) {
+        super(response);
+        this.name = "TopicChange";
+        this.response = response;
+        this.parkedItems = parkedItems ?? [];
+    }
+}
+/** Thrown when the stakeholder expresses fatigue or impatience. */
+export class Frustration extends Error {
+    response;
+    parkedItems;
+    constructor(response, parkedItems) {
+        super(response);
+        this.name = "Frustration";
+        this.response = response;
+        this.parkedItems = parkedItems ?? [];
+    }
+}
+/** All deviation error constructors. */
+const DEVIATION_CLASSES = [Confusion, OffTopic, Pushback, TopicChange, Frustration];
+/** Check if a value is a deviation error. */
+export function isDeviationError(e) {
+    return DEVIATION_CLASSES.some((cls) => e instanceof cls);
+}
+// ── Classification → Error mapping ──
+/** Map a ResponseClass to its error, or null for 'answer'. */
+export function classifyResponse(responseClass, response, parkedItems) {
+    switch (responseClass) {
+        case "answer": return null;
+        case "confusion": return new Confusion(response);
+        case "off_topic": return new OffTopic(response, parkedItems);
+        case "pushback": return new Pushback(response, parkedItems);
+        case "topic_change": return new TopicChange(response, parkedItems);
+        case "frustration": return new Frustration(response, parkedItems);
+        default: return null;
+    }
+}
+// ── Deviation messages ──
+/** Human-readable acknowledgment text for the stakeholder after a deviation. */
+export function deviationMessage(error) {
+    if (error instanceof Confusion) {
+        return "Let me put that differently.";
+    }
+    if (error instanceof Frustration) {
+        return "I understand — we're almost through this part. Let me keep it focused.";
+    }
+    if (error instanceof Pushback) {
+        return "Fair question. This helps us make sure nothing important is missed. Let me continue.";
+    }
+    return "Thanks for that — I've noted it. Let me come back to what I was asking.";
+}
+/**
+ * Retry on deviation errors.
+ *
+ * Calls the callback. If it throws a deviation error (filtered by retryOn),
+ * retries with (index+1, error). The callback uses the error to adjust
+ * its prompt (rephrase for clarification, redirect for divergence).
+ *
+ * Durable-safe: each callback invocation uses index to derive unique
+ * prompt/infer IDs. Memoized values replay correctly on resume.
+ */
+WorkflowContext.prototype.retryOnDeviation = async function (callback, options) {
+    const maxRetries = options?.maxRetries ?? 2;
+    const retryOn = options?.retryOn;
+    let lastError;
+    for (let index = 0; index <= maxRetries; index++) {
+        try {
+            return await callback(index, lastError);
+        }
+        catch (e) {
+            if (isDeviationError(e)) {
+                if (retryOn && !retryOn.some((cls) => e instanceof cls)) {
+                    throw e;
+                }
+                lastError = e;
+                continue;
+            }
+            throw e;
+        }
+    }
+    if (options && "defaults" in options) {
+        return options.defaults;
+    }
+    throw lastError;
+};
+//# sourceMappingURL=deviation.js.map

package/dist/interview/deviation.js.map

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

package/dist/interview/extraction.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Response extraction — LLM calls that parse the respondent's words into
+ * structured data via a Zod schema, with extraction-quality preamble and
+ * response classification (deviation detection).
+ */
+import { z } from "zod";
+import type { QuestionContext } from "./prompt.js";
+/** Parameters for `ctx.extract` — unified response-parsing template. */
+export interface ExtractParams<S extends z.ZodObject<any>> {
+    id: string;
+    response: string;
+    artifactsContext: string;
+    schema: S;
+    asked?: QuestionContext;
+    focus?: string;
+    guidance?: string;
+}
+/** Parameters for `ctx.seed` — unified artifact-mining template. */
+export interface SeedParams<S extends z.ZodObject<any>> {
+    id: string;
+    artifactsContext: string;
+    schema: S;
+    guidance?: string;
+}
+declare module "../durable/workflow.js" {
+    interface WorkflowContext {
+        extract<S extends z.ZodObject<any>>(params: ExtractParams<S>): Promise<z.infer<S>>;
+        seed<S extends z.ZodObject<any>>(params: SeedParams<S>): Promise<z.infer<S>>;
+        reextract<S extends z.ZodObject<any>>(id: string, clarification: string, artifactsContext: string, schema: S): Promise<z.infer<S>>;
+    }
+}
+//# sourceMappingURL=extraction.d.ts.map

package/dist/interview/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../src/interview/extraction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,wEAAwE;AACxE,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,eAAe;QACvB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACpI;CACF"}

package/dist/interview/extraction.js

@@ -0,0 +1,102 @@
+/**
+ * Response extraction — LLM calls that parse the respondent's words into
+ * structured data via a Zod schema, with extraction-quality preamble and
+ * response classification (deviation detection).
+ */
+import { z } from "zod";
+import { WorkflowContext } from "../durable/index.js";
+import { inferStep } from "./describe.js";
+import { extractionPreamble } from "./preambles.js";
+import { classifyResponse } from "./deviation.js";
+/** Schema field added to every extraction to classify the stakeholder's response. */
+const ResponseClassField = z.enum([
+    "answer", "confusion", "off_topic", "pushback", "topic_change", "frustration",
+]).describe("Classify the respondent's response: answer (addressed the question, even partially — includes disagreeing with content, pointing out conflicts, suggesting corrections, or challenging captured artifacts), confusion (asked what you mean or expressed confusion), off_topic (unrelated information), pushback (rejected the interview process itself — e.g. 'why are you asking me this' or 'this is pointless'), topic_change (steered to different subject), frustration (expressed fatigue/impatience). If in doubt, classify as answer.");
+/** Common response + artifact context block for extraction prompts */
+function extractionBody(response, artifactsContext, asked) {
+    const parts = [];
+    if (asked?.question) {
+        parts.push(`Question asked: "${asked.question}"`);
+        if (asked.suggestions && asked.suggestions.length > 0) {
+            const letters = "abcdefghijklmnopqrstuvwxyz";
+            const formatted = asked.suggestions.map((s, i) => `${letters[i]}) ${s}`).join(", ");
+            parts.push(`Suggestions offered: ${formatted}`);
+        }
+    }
+    parts.push(`Their response: "${response}"`);
+    parts.push("");
+    parts.push(`Existing artifacts: ${artifactsContext}`);
+    return parts;
+}
+/** Extract structured data from a user response. Schema drives what to extract. */
+WorkflowContext.prototype.extract = async function (params) {
+    const message = buildExtractionMessage(params);
+    const augmented = params.schema.extend({ responseClass: ResponseClassField });
+    const result = await this.infer(inferStep({ id: params.id, message, schema: augmented }));
+    return extractOrThrowOnDeviation(result, params.response);
+};
+/** Assemble the extraction prompt: preamble + classification block + focus + body + guidance. */
+function buildExtractionMessage(params) {
+    const { response, artifactsContext, asked, focus, guidance } = params;
+    const parts = [];
+    const extPre = extractionPreamble();
+    if (extPre)
+        parts.push(extPre);
+    parts.push(`<response_classification>
+Before extracting, classify the respondent's response:
+- "answer": They addressed the question (even partially or tangentially). This includes disagreeing with captured content, pointing out conflicts between items, suggesting corrections or restructuring, or challenging the substance of what was discussed. Content-level engagement is always an answer.
+- "confusion": They asked what you mean, requested rephrasing, or expressed confusion about the question
+- "off_topic": They provided unrelated information or introduced a new idea
+- "pushback": They rejected the interview process itself — e.g. "why are you asking me this?", "this is pointless", "I don't see the point of this exercise". Challenging content or disagreeing with artifacts is NOT pushback — that is an answer.
+- "topic_change": They tried to steer the conversation to a different subject
+- "frustration": They expressed fatigue, impatience, or annoyance
+Set responseClass accordingly. If in doubt, classify as "answer".
+When responseClass is NOT "answer", deposit the respondent's actual content into waitingRoomItems (if the schema has that field) so it is preserved for later phases.
+</response_classification>`);
+    if (focus)
+        parts.push(`Focus: ${focus}`);
+    parts.push(...extractionBody(response, artifactsContext, asked));
+    if (guidance)
+        parts.push(guidance);
+    return parts.join("\n");
+}
+/** Strip responseClass; if non-answer, throw the matching deviation error. */
+function extractOrThrowOnDeviation(result, response) {
+    const { responseClass = "answer", ...extraction } = result;
+    const error = classifyResponse(responseClass, response, extraction.waitingRoomItems);
+    if (error)
+        throw error;
+    return extraction;
+}
+/**
+ * Mine artifacts for initial items. Schema drives what to extract.
+ *
+ * Callers opting to include waiting-room items for drain/seeding pass
+ * `buildFullContext(artifacts, { includeWaitingRoom: true })` so the items
+ * surface under the `waitingRoom` JSON field within `artifactsContext`.
+ */
+WorkflowContext.prototype.seed = async function (params) {
+    const { id, artifactsContext, schema, guidance } = params;
+    const parts = [];
+    if (guidance)
+        parts.push(guidance);
+    parts.push(`\nConversation context:\n${artifactsContext}`);
+    return this.infer(inferStep({ id, message: parts.join("\n"), schema }));
+};
+/** Re-extract artifacts after a contradiction clarification, using the same schema as the original extraction. */
+WorkflowContext.prototype.reextract = async function (id, clarification, artifactsContext, schema) {
+    return this.extract({
+        id,
+        response: clarification,
+        artifactsContext,
+        schema,
+        guidance: "The respondent clarified a contradiction. Re-extract incorporating the clarification.",
+    });
+};
+const REQUIRED_PROTOTYPE_METHODS = ["extract", "seed", "reextract"];
+for (const method of REQUIRED_PROTOTYPE_METHODS) {
+    if (typeof WorkflowContext.prototype[method] !== "function") {
+        throw new Error(`interview/extraction.ts self-check failed: WorkflowContext.prototype.${method} is not a function.`);
+    }
+}
+//# sourceMappingURL=extraction.js.map

package/dist/interview/extraction.js.map

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

package/dist/interview/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Interview layer barrel — side-effect imports that register all
+ * `WorkflowContext` prototype augmentations, plus public re-exports.
+ *
+ * Consumers that need a phase to "just work" should import this barrel
+ * (e.g., `phases/shared.ts`) so every prototype method is available.
+ *
+ * The API-structure child will prune this barrel to a deliberate
+ * public surface; for now it re-exports what cross-layer callers use today.
+ */
+import "./deviation.js";
+import "./progress.js";
+import "./prompt.js";
+import "./composition.js";
+import "./extraction.js";
+import "./classification.js";
+import "./macros.js";
+export { compositionPreamble, classificationPreamble, extractionPreamble, suggestionCloser, confirmationCloser } from "./preambles.js";
+export { formatSublabel, type ProgressState } from "./progress.js";
+export { type QuestionContext } from "./prompt.js";
+export { type ExtractParams, type SeedParams } from "./extraction.js";
+export { type ComposePromptExtractOptions, type PromptExtractOptions, type PromptConfirmOptions } from "./macros.js";
+export { type DeviationError, type ResponseClass, classifyResponse, deviationMessage, isDeviationError, Confusion, OffTopic, Pushback, TopicChange, Frustration } from "./deviation.js";
+export { zodToPromptSchema, inferStep, inferCompositionStep, ComposeSchema, type ComposeParams } from "./describe.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interview/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,gBAAgB,CAAC;AACxB,OAAO,eAAe,CAAC;AACvB,OAAO,aAAa,CAAC;AACrB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,iBAAiB,CAAC;AACzB,OAAO,qBAAqB,CAAC;AAC7B,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvI,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxL,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/interview/index.js

@@ -0,0 +1,22 @@
+/**
+ * Interview layer barrel — side-effect imports that register all
+ * `WorkflowContext` prototype augmentations, plus public re-exports.
+ *
+ * Consumers that need a phase to "just work" should import this barrel
+ * (e.g., `phases/shared.ts`) so every prototype method is available.
+ *
+ * The API-structure child will prune this barrel to a deliberate
+ * public surface; for now it re-exports what cross-layer callers use today.
+ */
+import "./deviation.js";
+import "./progress.js";
+import "./prompt.js";
+import "./composition.js";
+import "./extraction.js";
+import "./classification.js";
+import "./macros.js";
+export { compositionPreamble, classificationPreamble, extractionPreamble, suggestionCloser, confirmationCloser } from "./preambles.js";
+export { formatSublabel } from "./progress.js";
+export { classifyResponse, deviationMessage, isDeviationError, Confusion, OffTopic, Pushback, TopicChange, Frustration } from "./deviation.js";
+export { zodToPromptSchema, inferStep, inferCompositionStep, ComposeSchema } from "./describe.js";
+//# sourceMappingURL=index.js.map

package/dist/interview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interview/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,gBAAgB,CAAC;AACxB,OAAO,eAAe,CAAC;AACvB,OAAO,aAAa,CAAC;AACrB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,iBAAiB,CAAC;AACzB,OAAO,qBAAqB,CAAC;AAC7B,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvI,OAAO,EAAE,cAAc,EAAsB,MAAM,eAAe,CAAC;AAInE,OAAO,EAA2C,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxL,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAC"}