@proposit/proposit-core 2.3.1 → 2.4.0

package/dist/cli/builder-repl.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=builder-repl.d.ts.map

package/dist/cli/builder-repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-repl.d.ts","sourceRoot":"","sources":["../../src/cli/builder-repl.ts"],"names":[],"mappings":""}

package/dist/cli/builder-repl.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+// Terminal Argument Builder — interactive REPL.
+//
+// Usage: node dist/cli/builder-repl.js [--provider openai] [--api-key KEY]
+//
+// Commands:
+//   /simulate   — run a simulate turn (play-the-user)
+//   /distill    — run a distill turn and exit
+//   /quit       — exit
+//   any other   — runs a review turn with your input as the user message
+import * as readline from "node:readline";
+import { createOpenAiResponsesProvider } from "../extensions/openai/index.js";
+import { createConversation } from "../lib/conversation/conversation.js";
+import { createReviewTurn } from "../extensions/builder/review.js";
+import { createSimulateTurn } from "../extensions/builder/simulate.js";
+import { createDistillTurn } from "../extensions/builder/distill.js";
+const DEFAULT_MODEL = "gpt-5.5";
+const DEFAULT_API_KEY = process.env.PROPOSIT_API_KEY ?? process.env.OPENAI_API_KEY;
+function parseArgs() {
+    const args = [];
+    for (let i = 2; i < process.argv.length; i++) {
+        args.push(process.argv[i]);
+    }
+    let provider = "openai";
+    let apiKey;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--provider" && i + 1 < args.length) {
+            provider = args[++i];
+        }
+        else if (args[i] === "--api-key" && i + 1 < args.length) {
+            apiKey = args[++i];
+        }
+    }
+    return { provider, apiKey };
+}
+function buildDeps(provider, apiKey) {
+    let llm;
+    switch (provider) {
+        case "openai":
+            llm = createOpenAiResponsesProvider({ apiKey });
+            break;
+        default:
+            console.error(`Unknown provider "${provider}". Supported: openai.`);
+            process.exit(1);
+    }
+    return { llm };
+}
+function printResult(result, turnName) {
+    if (result.failures.length > 0) {
+        for (const f of result.failures) {
+            console.error(`[${f.code}] ${f.message}`);
+        }
+    }
+    if (result.output !== null) {
+        console.log(`\n--- ${turnName} ---`);
+        const output = result.output;
+        if (output.uncategorizedText) {
+            console.log(output.uncategorizedText);
+        }
+        if (output.failureText) {
+            console.log(output.failureText);
+        }
+        if (output.selectionRationale) {
+            console.log(output.selectionRationale);
+        }
+        if (output.argument) {
+            const arg = output.argument;
+            if (arg.claims) {
+                console.log("\nClaims:");
+                for (const c of arg.claims) {
+                    const role = c.role;
+                    const type = c.type;
+                    const miniId = c.miniId;
+                    console.log(`  ${miniId} [${role}, ${type}]`);
+                }
+            }
+            if (arg.premises) {
+                console.log("\nPremises:");
+                for (const p of arg.premises) {
+                    const miniId = p.miniId;
+                    const formula = p.formula;
+                    console.log(`  ${miniId}: ${formula}`);
+                }
+            }
+        }
+        console.log();
+    }
+    else {
+        console.log(`[${turnName}]: no output (turn failed)`);
+        console.log();
+    }
+}
+function buildTurnFactory(conversation, turnName, factory) {
+    return (model) => {
+        return async () => {
+            const stage = factory(model);
+            const result = await conversation.turn(stage, {
+                userMessage: "[conversation transcript]",
+            });
+            printResult(result, turnName);
+        };
+    };
+}
+// eslint-disable-next-line @typescript-eslint/require-await
+async function main() {
+    const { provider, apiKey } = parseArgs();
+    const key = apiKey ?? DEFAULT_API_KEY;
+    if (!key) {
+        console.error("No API key provided. Set PROPOSIT_API_KEY or use --api-key.");
+        process.exit(1);
+    }
+    const deps = buildDeps(provider, key);
+    const model = DEFAULT_MODEL;
+    const conversation = createConversation(deps);
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: "builder> ",
+    });
+    const doReview = buildTurnFactory(conversation, "review", createReviewTurn);
+    const doSimulate = buildTurnFactory(conversation, "simulate", createSimulateTurn);
+    const review = doReview(model);
+    const simulate = doSimulate(model);
+    const doDistill = async () => {
+        const stage = createDistillTurn({
+            model,
+            // eslint-disable-next-line @typescript-eslint/no-empty-function
+            onClose: () => { },
+        });
+        const result = await conversation.turn(stage, {
+            userMessage: "[conversation transcript]",
+        }, { onComplete: () => conversation.close() });
+        printResult(result, "distill");
+        conversation.close();
+    };
+    console.log("Terminal Argument Builder");
+    console.log("Commands: /simulate, /distill, /quit");
+    console.log("Enter your text to start a review turn.\n");
+    rl.prompt();
+    rl.on("line", (line) => {
+        // Fire-and-forget async handler: the REPL keeps running regardless.
+        const trimmed = line.trim();
+        if (!trimmed) {
+            rl.prompt();
+            return;
+        }
+        if (trimmed === "/simulate") {
+            void simulate().then(() => rl.prompt());
+            return;
+        }
+        if (trimmed === "/distill") {
+            void doDistill().then(() => {
+                console.log("Argument distilled. Goodbye.");
+                rl.close();
+            });
+            return;
+        }
+        if (trimmed === "/quit") {
+            console.log("Goodbye.");
+            rl.close();
+            return;
+        }
+        void review().then(() => rl.prompt());
+    });
+    rl.on("close", () => {
+        console.log();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=builder-repl.js.map

package/dist/cli/builder-repl.js.map

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

package/dist/extensions/builder/distill.d.ts

@@ -0,0 +1,38 @@
+import type { TStage } from "../../lib/pipelines/types.js";
+import type { TReasoningEffort } from "../../lib/llm/types.js";
+export type TDistillOutput = {
+    argumentText: string;
+};
+/**
+ * Options for creating a distill turn.
+ */
+export type TDistillTurnOptions = {
+    model: string;
+    reasoningEffort?: TReasoningEffort;
+    /** Called after the turn completes to seal the conversation. */
+    onClose: () => void;
+};
+/**
+ * Create a distill turn stage.
+ *
+ * The distill stage reads the full builder conversation (user↔reviewer
+ * transcript) and produces clean single-author prose representing the user's
+ * final, settled argument. The prose is then fed into the existing ingestion
+ * pipeline (by the consumer) to yield a `TParsedArgumentResponse` shaped
+ * exactly like ingested arguments — same enrichment, same parser, zero drift.
+ *
+ * The whole transcript reaches this turn via the existing chaining
+ * (`previousResponseId` / `userMessage`) — chained off the latest response,
+ * not a re-rooted pre-review response. The distill prompt uses reviewer
+ * questions only as context to interpret the user's (often terse, reactive)
+ * answers; the ingestion pipeline keeps receiving single-author text and is
+ * never told it originated from a conversation.
+ *
+ * This is the terminal turn — seals the conversation via `onClose`.
+ * No further turns are allowed after this.
+ *
+ * `retry.maxAttempts: 1` — distillation failure is a content issue, not a
+ * transient one. Retrying the same prompt will not help.
+ */
+export declare function createDistillTurn(options: TDistillTurnOptions): TStage<TDistillOutput>;
+//# sourceMappingURL=distill.d.ts.map

package/dist/extensions/builder/distill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distill.d.ts","sourceRoot":"","sources":["../../../src/extensions/builder/distill.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAkB9D,MAAM,MAAM,cAAc,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,gBAAgB,CAAA;IAClC,gEAAgE;IAChE,OAAO,EAAE,MAAM,IAAI,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,mBAAmB,GAC7B,MAAM,CAAC,cAAc,CAAC,CA+BxB"}

package/dist/extensions/builder/distill.js

@@ -0,0 +1,81 @@
+// Distill turn — collapse the builder conversation into clean single-author prose.
+//
+// Produces a `TStage` that runs the distill action: the model reads the full
+// conversation (user↔reviewer transcript) and emits the user's final, settled
+// argument as a single prose block. The consumer then feeds that prose into the
+// existing ingestion pipeline (`createScribePipeline(basicsExtension)`) to get
+// a schema-valid `TParsedArgumentResponse`.
+//
+// One parser, zero schema drift. Finalize's output is identical to ingestion by
+// construction.
+import Type from "typebox";
+import { llmStage } from "../../lib/pipelines/stage-helpers.js";
+/**
+ * Minimal output schema for the distill turn.
+ *
+ * Distill emits prose — not a parsed argument — so there is no
+ * `buildParsingPrompt` import, no `ParsedArgumentResponseSchema`, and no
+ * structured-argument shape to drift. The consumer feeds this string into the
+ * existing ingestion pipeline to get the final `TParsedArgumentResponse`.
+ */
+const DistillOutputSchema = Type.Object({
+    argumentText: Type.String({
+        minLength: 1,
+        description: "The user's final, settled argument as a single self-contained prose statement.",
+    }),
+});
+/**
+ * Create a distill turn stage.
+ *
+ * The distill stage reads the full builder conversation (user↔reviewer
+ * transcript) and produces clean single-author prose representing the user's
+ * final, settled argument. The prose is then fed into the existing ingestion
+ * pipeline (by the consumer) to yield a `TParsedArgumentResponse` shaped
+ * exactly like ingested arguments — same enrichment, same parser, zero drift.
+ *
+ * The whole transcript reaches this turn via the existing chaining
+ * (`previousResponseId` / `userMessage`) — chained off the latest response,
+ * not a re-rooted pre-review response. The distill prompt uses reviewer
+ * questions only as context to interpret the user's (often terse, reactive)
+ * answers; the ingestion pipeline keeps receiving single-author text and is
+ * never told it originated from a conversation.
+ *
+ * This is the terminal turn — seals the conversation via `onClose`.
+ * No further turns are allowed after this.
+ *
+ * `retry.maxAttempts: 1` — distillation failure is a content issue, not a
+ * transient one. Retrying the same prompt will not help.
+ */
+export function createDistillTurn(options) {
+    return llmStage({
+        id: "builder:distill",
+        dependsOn: [],
+        outputSchema: DistillOutputSchema,
+        model: options.model,
+        reasoningEffort: options.reasoningEffort,
+        buildPrompt: () => ({
+            system: `You are reading a conversation between a user building a propositional argument and a Socratic reviewer.
+
+Your job is to distill the user's final, settled argument into a single self-contained prose statement.
+
+## Instructions
+
+- Extract the user's final, settled position — the argument as it stands after the full back-and-forth.
+- Use the reviewer's questions ONLY as context to interpret the user's answers. Resolve terse or reactive answers into standalone claims (e.g. fold "yes, and also Y" into a complete proposition).
+- Ignore the reviewer's questions themselves, discarded ideas, simulated-user turns, and any material the user moved away from.
+- Write in third person, present tense, active voice. Each sentence should be a clear declarative statement.
+- Do NOT prepend author-attribution frames like "The author claims…" — write the proposition itself.
+- The output must be a single coherent prose passage (one or more paragraphs) that fully expresses the argument.
+
+## Output
+
+Respond with exactly:
+{"argumentText": "The distilled argument goes here."}
+
+The argumentText field must be non-empty.`,
+            user: "", // overridden by executeTurn with transcript
+        }),
+        retry: { maxAttempts: 1 },
+    });
+}
+//# sourceMappingURL=distill.js.map

package/dist/extensions/builder/distill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distill.js","sourceRoot":"","sources":["../../../src/extensions/builder/distill.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,4CAA4C;AAC5C,EAAE;AACF,gFAAgF;AAChF,gBAAgB;AAEhB,OAAO,IAAI,MAAM,SAAS,CAAA;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAE/D;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QACtB,SAAS,EAAE,CAAC;QACZ,WAAW,EACP,gFAAgF;KACvF,CAAC;CACL,CAAC,CAAA;AAaF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAC7B,OAA4B;IAE5B,OAAO,QAAQ,CAAC;QACZ,EAAE,EAAE,iBAAiB;QACrB,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,mBAAmB;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAChB,MAAM,EAAE;;;;;;;;;;;;;;;;;;0CAkBsB;YAC9B,IAAI,EAAE,EAAE,EAAE,4CAA4C;SACzD,CAAC;QACF,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;KAC5B,CAAC,CAAA;AACN,CAAC"}

package/dist/extensions/builder/index.d.ts

@@ -0,0 +1,7 @@
+export { createReviewTurn } from "./review.js";
+export type {} from "./review.js";
+export { createSimulateTurn } from "./simulate.js";
+export type {} from "./simulate.js";
+export { createDistillTurn } from "./distill.js";
+export type { TDistillTurnOptions, TDistillOutput } from "./distill.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/builder/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,YAAY,EAAE,MAAM,aAAa,CAAA;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,YAAY,EAAE,MAAM,eAAe,CAAA;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/extensions/builder/index.js

@@ -0,0 +1,11 @@
+// Builder extension — Argument Builder turn factories.
+//
+// Subpath: @proposit/proposit-core/builder
+//
+// Provides `TStage` factories for the three Argument Builder turns:
+// review, simulate, and distill. Each is a `TStage` that can be run
+// through the conversation primitive's `executeTurn`.
+export { createReviewTurn } from "./review.js";
+export { createSimulateTurn } from "./simulate.js";
+export { createDistillTurn } from "./distill.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/builder/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,sDAAsD;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}

package/dist/extensions/builder/review.d.ts

@@ -0,0 +1,11 @@
+import type { TStage } from "../../lib/pipelines/types.js";
+import type { TReasoningEffort } from "../../lib/llm/types.js";
+/**
+ * Create a review turn stage.
+ *
+ * The review stage runs one turn of Socratic dialogue: the model examines
+ * the user's argument, asks probing questions, and provides feedback to
+ * strengthen it. Output is validated against the parsing response schema.
+ */
+export declare function createReviewTurn(model: string, reasoningEffort?: TReasoningEffort): TStage<unknown>;
+//# sourceMappingURL=review.d.ts.map

package/dist/extensions/builder/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/extensions/builder/review.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI9D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,gBAAgB,GACnC,MAAM,CAAC,OAAO,CAAC,CAgBjB"}

package/dist/extensions/builder/review.js

@@ -0,0 +1,32 @@
+// Review turn — Socratic reviewer stage.
+//
+// Produces a `TStage` that runs one turn of Socratic dialogue: the model
+// examines the user's argument, asks probing questions, and provides
+// feedback to strengthen it. Does NOT call `.close()` on the conversation.
+import { ParsedArgumentResponseSchema } from "../../lib/parsing/schemata.js";
+import { llmStage } from "../../lib/pipelines/stage-helpers.js";
+/**
+ * Create a review turn stage.
+ *
+ * The review stage runs one turn of Socratic dialogue: the model examines
+ * the user's argument, asks probing questions, and provides feedback to
+ * strengthen it. Output is validated against the parsing response schema.
+ */
+export function createReviewTurn(model, reasoningEffort) {
+    return llmStage({
+        id: "builder:review",
+        dependsOn: [],
+        outputSchema: ParsedArgumentResponseSchema,
+        model,
+        reasoningEffort,
+        buildPrompt: () => ({
+            system: `You are a Socratic reviewer helping to strengthen a propositional argument. Examine the user's argument below and ask probing questions that challenge its assumptions, evidence, and logical structure.
+
+Your goal is to help the user build a more rigorous, well-supported argument through guided questioning. Provide at most 2-3 focused questions per turn.
+
+Respond as a single message — do NOT attempt to parse or structure the argument. Just ask questions.`,
+            user: "", // overridden by executeTurn
+        }),
+    });
+}
+//# sourceMappingURL=review.js.map

package/dist/extensions/builder/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/extensions/builder/review.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,2EAA2E;AAI3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAa,EACb,eAAkC;IAElC,OAAO,QAAQ,CAAC;QACZ,EAAE,EAAE,gBAAgB;QACpB,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,4BAA4B;QAC1C,KAAK;QACL,eAAe;QACf,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAChB,MAAM,EAAE;;;;qGAIiF;YACzF,IAAI,EAAE,EAAE,EAAE,4BAA4B;SACzC,CAAC;KACL,CAAC,CAAA;AACN,CAAC"}

package/dist/extensions/builder/simulate.d.ts

@@ -0,0 +1,12 @@
+import type { TStage } from "../../lib/pipelines/types.js";
+import type { TReasoningEffort } from "../../lib/llm/types.js";
+/**
+ * Create a simulate turn stage.
+ *
+ * The simulate stage generates a user-side message that challenges the
+ * argument — a counterargument, clarification request, or objection.
+ * This turn is discardable: its output does not need to be chained
+ * forward.
+ */
+export declare function createSimulateTurn(model: string, reasoningEffort?: TReasoningEffort): TStage<unknown>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/extensions/builder/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../src/extensions/builder/simulate.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI9D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,gBAAgB,GACnC,MAAM,CAAC,OAAO,CAAC,CAgBjB"}

package/dist/extensions/builder/simulate.js

@@ -0,0 +1,33 @@
+// Simulate turn — play-the-user stage.
+//
+// Produces a `TStage` that generates a simulated user message challenging
+// the argument. This turn is discardable: its output does not need to be
+// chained forward (the caller omits it from `branchFrom`).
+import { ParsedArgumentResponseSchema } from "../../lib/parsing/schemata.js";
+import { llmStage } from "../../lib/pipelines/stage-helpers.js";
+/**
+ * Create a simulate turn stage.
+ *
+ * The simulate stage generates a user-side message that challenges the
+ * argument — a counterargument, clarification request, or objection.
+ * This turn is discardable: its output does not need to be chained
+ * forward.
+ */
+export function createSimulateTurn(model, reasoningEffort) {
+    return llmStage({
+        id: "builder:simulate",
+        dependsOn: [],
+        outputSchema: ParsedArgumentResponseSchema,
+        model,
+        reasoningEffort,
+        buildPrompt: () => ({
+            system: `You are playing the role of a skeptical but reasonable user in a dialogue about an argument. Generate a single user-side message that challenges, questions, or objects to the argument being discussed.
+
+Your message should be a realistic counterargument, clarification request, or objection. Be specific — reference particular claims or reasoning in the argument.
+
+Respond as a single message — do NOT attempt to parse or structure anything. Just write your user-side message.`,
+            user: "", // overridden by executeTurn
+        }),
+    });
+}
+//# sourceMappingURL=simulate.js.map

package/dist/extensions/builder/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../../src/extensions/builder/simulate.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,2DAA2D;AAI3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAC9B,KAAa,EACb,eAAkC;IAElC,OAAO,QAAQ,CAAC;QACZ,EAAE,EAAE,kBAAkB;QACtB,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,4BAA4B;QAC1C,KAAK;QACL,eAAe;QACf,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAChB,MAAM,EAAE;;;;gHAI4F;YACpG,IAAI,EAAE,EAAE,EAAE,4BAA4B;SACzC,CAAC;KACL,CAAC,CAAA;AACN,CAAC"}

package/dist/extensions/openai/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/provider.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACR,YAAY,EAIf,MAAM,wBAAwB,CAAA;AAmB/B,OAAO,EAGH,KAAK,YAAY,EAGpB,MAAM,YAAY,CAAA;AAYnB,MAAM,MAAM,qCAAqC,GAAG;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;;;;;;;;;;;OAiBG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAED,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,qCAAqC,GAC/C,YAAY,CA0Td"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/extensions/openai/provider.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACR,YAAY,EAIf,MAAM,wBAAwB,CAAA;AAmB/B,OAAO,EAGH,KAAK,YAAY,EAGpB,MAAM,YAAY,CAAA;AAYnB,MAAM,MAAM,qCAAqC,GAAG;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;;;;;;;;;;;OAiBG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAED,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,qCAAqC,GAC/C,YAAY,CA6Td"}

package/dist/extensions/openai/provider.js

@@ -96,6 +96,9 @@ export function createOpenAiResponsesProvider(options) {
                     schema: convertedSchema,
                 }),
             };
+            if (req.previousResponseId) {
+                body.previous_response_id = req.previousResponseId;
+            }
             if (req.maxOutputTokens !== undefined) {
                 body.max_output_tokens = req.maxOutputTokens;
             }

package/dist/extensions/openai/provider.js.map

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

package/dist/extensions/openai/types.d.ts

@@ -67,6 +67,8 @@ export type TOpenAiResponsesRequestBody = {
     stream?: boolean;
     background?: boolean;
     store?: boolean;
+    /** Continue from a prior stored response (conversation chaining). */
+    previous_response_id?: string;
 };
 export type TOpenAiOutputContentBlock = {
     type?: string;

package/dist/extensions/openai/types.d.ts.map

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

package/dist/lib/conversation/contract.d.ts

@@ -0,0 +1,16 @@
+import type { TResponseId } from "../llm/types.js";
+/**
+ * Extends an input shape `I` with optional `previousResponseId` so a
+ * consumer can carry the upstream response chain alongside its payload.
+ */
+export type TMultiTurnInput<I> = I & {
+    previousResponseId?: TResponseId;
+};
+/**
+ * Extends an output shape `O` with a `responseId` field so the consumer
+ * can record the provider response id for the next turn's chain.
+ */
+export type TMultiTurnOutput<O> = O & {
+    responseId: TResponseId | null;
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/lib/conversation/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/lib/conversation/contract.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,kBAAkB,CAAC,EAAE,WAAW,CAAA;CAAE,CAAA;AAEzE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,UAAU,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAA"}

package/dist/lib/conversation/contract.js

@@ -0,0 +1,9 @@
+// Conversation contract types — thin schema composition for multi-turn
+// exchanges. Consumed by both the server adapter (proposit-server) and
+// any future interactive consumer.
+//
+// These are TypeBox-style shape descriptions, not class hierarchies.
+// The types live in core (forced by dependency direction: shared depends
+// on core, not vice-versa).
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/lib/conversation/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/lib/conversation/contract.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,uEAAuE;AACvE,mCAAmC;AACnC,EAAE;AACF,qEAAqE;AACrE,yEAAyE;AACzE,4BAA4B"}

package/dist/lib/conversation/conversation.d.ts

@@ -0,0 +1,43 @@
+import type { TStage } from "../pipelines/types.js";
+import type { TLlmTokenUsage, TResponseId } from "../llm/types.js";
+import type { TExecuteTurnDeps, TTurnInput, TTurnResult } from "./turn.js";
+/**
+ * The conversation object. Methods:
+ *   - `turn(stage, input, opts?)` — run one turn
+ *   - `close()` — seal the conversation (finalize calls this)
+ *
+ * `.turn` after `.close()` throws `ConversationClosedError`.
+ */
+export type TConversation = {
+    /**
+     * Run one turn: execute the stage, thread `previousResponseId`
+     * (from `branchFrom` or the last response id), and return the
+     * result including the new response id.
+     */
+    turn<TOut>(stage: TStage<TOut>, input: TTurnInput, opts?: {
+        branchFrom?: TResponseId;
+        onComplete?: () => void;
+    }): Promise<TTurnResult<TOut>>;
+    /** The latest provider response id in the chain. */
+    readonly lastResponseId: TResponseId | null;
+    /** Cumulative token usage across all turns. */
+    readonly tokenUsage: TLlmTokenUsage;
+    /** Whether the conversation has been closed. */
+    readonly closed: boolean;
+    /** Seal the conversation. Subsequent `.turn` calls throw. */
+    close(): void;
+};
+/** Thrown when `.turn` is called on a closed conversation. */
+export declare class ConversationClosedError extends Error {
+    constructor();
+}
+/**
+ * Create a new stateful conversation object.
+ *
+ * The conversation holds the response-ID chain and cumulative token
+ * usage. Each `.turn(...)` call executes a single stage through the
+ * conversation primitive's execution path, threading `previousResponseId`
+ * so the provider can chain against the upstream response.
+ */
+export declare function createConversation(deps: TExecuteTurnDeps): TConversation;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/lib/conversation/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/lib/conversation/conversation.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAK1E;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;;;OAIG;IACH,IAAI,CAAC,IAAI,EACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EACnB,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAC7D,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,cAAc,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3C,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;IACnC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAA;CAChB,CAAA;AAED,8DAA8D;AAC9D,qBAAa,uBAAwB,SAAQ,KAAK;;CAKjD;AAID;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAmDxE"}

package/dist/lib/conversation/conversation.js

@@ -0,0 +1,65 @@
+// Stateful conversation primitive for interactive, user-driven multi-turn
+// LLM exchanges.
+//
+// Holds the response-ID chain and cumulative token usage. The user
+// decides which turn runs next, in any amount and order, until a
+// terminal `finalize` turn ends it.
+//
+// A conversation is NOT a pipeline. It is a thin, builder-agnostic
+// stateful object that threads response-IDs and tallies tokens.
+import { executeTurn } from "./turn.js";
+/** Thrown when `.turn` is called on a closed conversation. */
+export class ConversationClosedError extends Error {
+    constructor() {
+        super("Conversation is closed — no more turns allowed.");
+        this.name = "ConversationClosedError";
+    }
+}
+// -- createConversation ----------------------------------------------------
+/**
+ * Create a new stateful conversation object.
+ *
+ * The conversation holds the response-ID chain and cumulative token
+ * usage. Each `.turn(...)` call executes a single stage through the
+ * conversation primitive's execution path, threading `previousResponseId`
+ * so the provider can chain against the upstream response.
+ */
+export function createConversation(deps) {
+    let closed = false;
+    let lastResponseId = null;
+    let cumulativeTokens = { input: 0, output: 0 };
+    return {
+        async turn(stage, input, opts) {
+            if (closed) {
+                throw new ConversationClosedError();
+            }
+            const turnInput = {
+                userMessage: input.userMessage,
+                previousResponseId: opts?.branchFrom ?? lastResponseId ?? undefined,
+            };
+            const result = await executeTurn(stage, turnInput, {
+                ...deps,
+                onComplete: opts?.onComplete,
+            });
+            lastResponseId = result.responseId;
+            cumulativeTokens = {
+                input: cumulativeTokens.input + result.tokenUsage.input,
+                output: cumulativeTokens.output + result.tokenUsage.output,
+            };
+            return result;
+        },
+        get lastResponseId() {
+            return lastResponseId;
+        },
+        get tokenUsage() {
+            return cumulativeTokens;
+        },
+        get closed() {
+            return closed;
+        },
+        close() {
+            closed = true;
+        },
+    };
+}
+//# sourceMappingURL=conversation.js.map

package/dist/lib/conversation/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../../src/lib/conversation/conversation.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,iBAAiB;AACjB,EAAE;AACF,mEAAmE;AACnE,iEAAiE;AACjE,oCAAoC;AACpC,EAAE;AACF,mEAAmE;AACnE,gEAAgE;AAKhE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAgCvC,8DAA8D;AAC9D,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C;QACI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACzC,CAAC;CACJ;AAED,6EAA6E;AAE7E;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACrD,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,cAAc,GAAuB,IAAI,CAAA;IAC7C,IAAI,gBAAgB,GAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;IAE9D,OAAO;QACH,KAAK,CAAC,IAAI,CACN,KAAmB,EACnB,KAAiB,EACjB,IAA4D;YAE5D,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,IAAI,uBAAuB,EAAE,CAAA;YACvC,CAAC;YAED,MAAM,SAAS,GAAe;gBAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,kBAAkB,EACd,IAAI,EAAE,UAAU,IAAI,cAAc,IAAI,SAAS;aACtD,CAAA;YAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE;gBAC/C,GAAG,IAAI;gBACP,UAAU,EAAE,IAAI,EAAE,UAAU;aAC/B,CAAC,CAAA;YAEF,cAAc,GAAG,MAAM,CAAC,UAAU,CAAA;YAClC,gBAAgB,GAAG;gBACf,KAAK,EAAE,gBAAgB,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK;gBACvD,MAAM,EAAE,gBAAgB,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM;aAC7D,CAAA;YAED,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,IAAI,cAAc;YACd,OAAO,cAAc,CAAA;QACzB,CAAC;QAED,IAAI,UAAU;YACV,OAAO,gBAAgB,CAAA;QAC3B,CAAC;QAED,IAAI,MAAM;YACN,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,KAAK;YACD,MAAM,GAAG,IAAI,CAAA;QACjB,CAAC;KACJ,CAAA;AACL,CAAC"}

package/dist/lib/conversation/index.d.ts

@@ -0,0 +1,8 @@
+export { executeTurn } from "./turn.js";
+export type { TTurnInput, TTurnResult, TExecuteTurnDeps } from "./turn.js";
+export { createConversation } from "./conversation.js";
+export type { TConversation } from "./conversation.js";
+export { ConversationClosedError } from "./conversation.js";
+export type { TMultiTurnInput, TMultiTurnOutput } from "./contract.js";
+export type { TResponseId } from "../llm/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/conversation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/lib/conversation/index.js

@@ -0,0 +1,7 @@
+// Barrel export for the conversation primitive module.
+//
+// Subpath: @proposit/proposit-core/conversation
+export { executeTurn } from "./turn.js";
+export { createConversation } from "./conversation.js";
+export { ConversationClosedError } from "./conversation.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/conversation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/conversation/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,gDAAgD;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/lib/conversation/turn.d.ts

@@ -0,0 +1,55 @@
+import type { TStage, TProcessingFailure, TPipelineEvent } from "../pipelines/types.js";
+import type { TLlmProvider, TLlmTokenUsage, TResponseId } from "../llm/types.js";
+/**
+ * Input supplied to a single conversational turn. The caller is
+ * responsible for assembling the user message (which may include the
+ * full transcript when the provider cannot chain by reference).
+ */
+export type TTurnInput = {
+    /** The user message for this turn. */
+    userMessage: string;
+    /** The provider response id to chain against; absent for the first turn. */
+    previousResponseId?: TResponseId;
+};
+/**
+ * Result of a single conversational turn. Mirrors the shape the
+ * server's Argument Builder actions need: output, the new response id,
+ * token usage, and any processing failures.
+ */
+export type TTurnResult<TOut> = {
+    /** The stage's parsed output, or `null` when the turn failed. */
+    output: TOut | null;
+    /** The provider response id for this turn (nullable for
+     * non-chaining providers such as chat-completions). */
+    responseId: TResponseId | null;
+    /** Cumulative token usage for this turn's LLM call. */
+    tokenUsage: TLlmTokenUsage;
+    /** Processing failures recorded during the turn. */
+    failures: TProcessingFailure[];
+};
+/**
+ * Minimal dependencies for a single-turn execution. A subset of the
+ * full pipeline deps — no concurrency or pipeline-level bookkeeping.
+ */
+export type TExecuteTurnDeps = {
+    llm: TLlmProvider;
+    signal?: AbortSignal;
+    onEvent?: (event: TPipelineEvent) => void;
+    /** Called after the stage completes (after retry loop + validation).
+     * Useful for terminal turns that need to seal a conversation. */
+    onComplete?: () => void;
+};
+/**
+ * Run one conversational turn: execute the stage through the single-stage
+ * executor (preserving retry loop, output-schema validation, event
+ * emission, token accounting) while threading `previousResponseId` into
+ * the LLM request and surfacing the provider response id.
+ *
+ * Uses a synthetic pipeline so `executeStage` can run the arbitrary stage
+ * through the same execution machinery the full pipeline uses. The stage's
+ * own `dependsOn` are preserved; since no upstream stages exist, any
+ * dependencies that are satisfied will be `completed` (they simply don't
+ * exist, so `ctx.get` returns `undefined` for them).
+ */
+export declare function executeTurn<TOut>(stage: TStage<TOut>, input: TTurnInput, deps: TExecuteTurnDeps): Promise<TTurnResult<TOut>>;
+//# sourceMappingURL=turn.d.ts.map

package/dist/lib/conversation/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../src/lib/conversation/turn.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACR,MAAM,EACN,kBAAkB,EAClB,cAAc,EACjB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAShF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,WAAW,CAAA;CACnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI;IAC5B,iEAAiE;IACjE,MAAM,EAAE,IAAI,GAAG,IAAI,CAAA;IACnB;2DACuD;IACvD,UAAU,EAAE,WAAW,GAAG,IAAI,CAAA;IAC9B,uDAAuD;IACvD,UAAU,EAAE,cAAc,CAAA;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,kBAAkB,EAAE,CAAA;CACjC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,GAAG,EAAE,YAAY,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACzC;qEACiE;IACjE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B,CAAA;AA+CD;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAClC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EACnB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GACvB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CA6D5B"}

package/dist/lib/conversation/turn.js

@@ -0,0 +1,112 @@
+// Stateless single-turn execution primitive.
+//
+// Wraps one `TStage` run with the full pipeline machinery (retry loop,
+// output-schema validation, event emission, token accounting) and
+// threads `previousResponseId` into the LLM request so the provider can
+// chain against the upstream response. Surfaces the provider response id
+// so the caller can forward it on the next turn.
+//
+// This is the shared substrate for both:
+//   - the server's stateless per-request executor (threads the chain
+//     from the client-supplied `lastResponseId`)
+//   - the CLI's stateful conversation object (accumulates the chain)
+import { executeStage } from "../pipelines/execute.js";
+import { Value } from "typebox/value";
+import Type from "typebox";
+// -- Internal: module-level bridge for user message ------------------------
+//
+// `llmStage` builds its user message from `buildPrompt(ctx)`. To override
+// it without modifying the stage, we use a module-level variable that the
+// provider wrapper reads. This keeps `executeTurn`'s signature clean
+// while still letting the caller supply the actual user message.
+//
+// The variable is set synchronously before `executeStage` and cleared
+// after it resolves, so it's safe for sequential (non-concurrent) use.
+let currentTurnInput = null;
+// -- Internal: LLM provider wrapper ----------------------------------------
+//
+// Wraps the underlying provider to inject `previousResponseId` into each
+// `respond` call and capture the surfaced response id. Also overrides the
+// user message via the module-level bridge so `llmStage`'s `buildPrompt`
+// user message is replaced with the caller-supplied one.
+function wrapProviderForTurn(llm, previousResponseId, captured) {
+    const underlying = llm;
+    return {
+        async respond(req) {
+            // Inject `previousResponseId` into the request.
+            req.previousResponseId = previousResponseId;
+            // Override user message via the module-level bridge.
+            if (currentTurnInput) {
+                req.userMessage = currentTurnInput.userMessage;
+            }
+            const response = await underlying.respond(req);
+            // Capture the response id if surfaced.
+            if (response.rawResponseId) {
+                captured.responseId = response.rawResponseId;
+            }
+            return response;
+        },
+    };
+}
+// -- executeTurn -----------------------------------------------------------
+/**
+ * Run one conversational turn: execute the stage through the single-stage
+ * executor (preserving retry loop, output-schema validation, event
+ * emission, token accounting) while threading `previousResponseId` into
+ * the LLM request and surfacing the provider response id.
+ *
+ * Uses a synthetic pipeline so `executeStage` can run the arbitrary stage
+ * through the same execution machinery the full pipeline uses. The stage's
+ * own `dependsOn` are preserved; since no upstream stages exist, any
+ * dependencies that are satisfied will be `completed` (they simply don't
+ * exist, so `ctx.get` returns `undefined` for them).
+ */
+export async function executeTurn(stage, input, deps) {
+    // Capture the response id from the provider's response.
+    const captured = {
+        responseId: null,
+    };
+    // Wrap the LLM provider to inject `previousResponseId` and capture
+    // the response id.
+    const wrapped = wrapProviderForTurn(deps.llm, input.previousResponseId, captured);
+    // Bridge the user message to the provider wrapper.
+    currentTurnInput = input;
+    // Create a synthetic pipeline containing just this stage.
+    const stageId = stage.id;
+    const pipeline = {
+        id: "turn",
+        version: "0.0.0",
+        inputSchema: Value.Check(TypeAnySchema, {})
+            ? TypeAnySchema
+            : Type.Object({}),
+        outputSchema: stage.outputSchema,
+        stages: [stage],
+        finalize: {
+            dependsOn: [stageId],
+            run: (ctx) => ctx.get(stageId),
+        },
+    };
+    // Run the stage through the single-stage executor.
+    const upstream = {};
+    const result = await executeStage(pipeline, stageId, upstream, {}, {
+        llm: wrapped,
+        signal: deps.signal,
+        onEvent: deps.onEvent,
+    });
+    // Clear the user message bridge.
+    currentTurnInput = null;
+    // Call the completion callback (for terminal turns like finalize).
+    deps.onComplete?.();
+    return {
+        output: (result.outcome === "completed"
+            ? (result.output ?? null)
+            : null),
+        responseId: captured.responseId,
+        tokenUsage: result.tokenUsage ?? { input: 0, output: 0 },
+        failures: result.failures,
+    };
+}
+// -- Minimal `Type.Any()` without importing TypeBox ------------------------
+// Used as the synthetic pipeline's input schema.
+const TypeAnySchema = { type: "any" };
+//# sourceMappingURL=turn.js.map

package/dist/lib/conversation/turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.js","sourceRoot":"","sources":["../../../src/lib/conversation/turn.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,uEAAuE;AACvE,kEAAkE;AAClE,wEAAwE;AACxE,yEAAyE;AACzE,iDAAiD;AACjD,EAAE;AACF,yCAAyC;AACzC,qEAAqE;AACrE,iDAAiD;AACjD,qEAAqE;AAQrE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAGtD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,IAAI,MAAM,SAAS,CAAA;AA8C1B,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,iEAAiE;AACjE,EAAE;AACF,sEAAsE;AACtE,uEAAuE;AAEvE,IAAI,gBAAgB,GAAsB,IAAI,CAAA;AAE9C,6EAA6E;AAC7E,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,yEAAyE;AACzE,yDAAyD;AAEzD,SAAS,mBAAmB,CACxB,GAAiB,EACjB,kBAA2C,EAC3C,QAA4C;IAE5C,MAAM,UAAU,GAAG,GAAG,CAAA;IACtB,OAAO;QACH,KAAK,CAAC,OAAO,CAAI,GAA6C;YAC1D,gDAAgD;YAChD,GAAG,CAAC,kBAAkB,GAAG,kBAAkB,CAAA;YAC3C,qDAAqD;YACrD,IAAI,gBAAgB,EAAE,CAAC;gBACnB,GAAG,CAAC,WAAW,GAAG,gBAAgB,CAAC,WAAW,CAAA;YAClD,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC9C,uCAAuC;YACvC,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;gBACzB,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAA;YAChD,CAAC;YACD,OAAO,QAAQ,CAAA;QACnB,CAAC;KACJ,CAAA;AACL,CAAC;AAED,6EAA6E;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,KAAmB,EACnB,KAAiB,EACjB,IAAsB;IAEtB,wDAAwD;IACxD,MAAM,QAAQ,GAAuC;QACjD,UAAU,EAAE,IAAI;KACnB,CAAA;IAED,mEAAmE;IACnE,mBAAmB;IACnB,MAAM,OAAO,GAAG,mBAAmB,CAC/B,IAAI,CAAC,GAAG,EACR,KAAK,CAAC,kBAAkB,EACxB,QAAQ,CACX,CAAA;IAED,mDAAmD;IACnD,gBAAgB,GAAG,KAAK,CAAA;IAExB,0DAA0D;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAA;IACxB,MAAM,QAAQ,GAA6D;QACvE,EAAE,EAAE,MAAM;QACV,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC;YACvC,CAAC,CAAC,aAAa;YACf,CAAC,CAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAa;QAClC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,QAAQ,EAAE;YACN,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAS;SACzC;KACJ,CAAA;IAED,mDAAmD;IACnD,MAAM,QAAQ,GAAwC,EAAE,CAAA;IACxD,MAAM,MAAM,GAAG,MAAM,YAAY,CAC7B,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,EAAE,EACF;QACI,GAAG,EAAE,OAAO;QACZ,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CACJ,CAAA;IAED,iCAAiC;IACjC,gBAAgB,GAAG,IAAI,CAAA;IAEvB,mEAAmE;IACnE,IAAI,CAAC,UAAU,EAAE,EAAE,CAAA;IAEnB,OAAO;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,WAAW;YACnC,CAAC,CAAC,CAAE,MAAM,CAAC,MAAkC,IAAI,IAAI,CAAC;YACtD,CAAC,CAAC,IAAI,CAAgB;QAC1B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QACxD,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC5B,CAAA;AACL,CAAC;AAED,6EAA6E;AAC7E,iDAAiD;AAEjD,MAAM,aAAa,GAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA"}

package/dist/lib/index.d.ts

@@ -70,4 +70,8 @@ export { collectArgumentReferencedClaims } from "./core/review-helpers.js";
 export type { TCollectArgumentReferencedClaimsResult } from "./core/review-helpers.js";
 export { canonicalizeOperatorAssignments } from "./core/review-helpers.js";
 export type { TCanonicalizeOperatorAssignmentsInput } from "./core/review-helpers.js";
+export { executeTurn, createConversation, ConversationClosedError, } from "./conversation/index.js";
+export type { TTurnInput, TTurnResult, TExecuteTurnDeps, TConversation, TMultiTurnInput, TMultiTurnOutput, TResponseId, } from "./conversation/index.js";
+export { createReviewTurn, createSimulateTurn, createDistillTurn, } from "../extensions/builder/index.js";
+export type { TDistillTurnOptions } from "../extensions/builder/index.js";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/lib/index.js

@@ -58,4 +58,10 @@ export { NonRetryableLlmError, QuotaExhaustedLlmError, RateLimitLlmError, Schema
 export { InvalidArgumentStructureError, UnknownExpressionError, NotOperatorNotDecidableError, } from "./core/review-errors.js";
 export { collectArgumentReferencedClaims } from "./core/review-helpers.js";
 export { canonicalizeOperatorAssignments } from "./core/review-helpers.js";
+// Conversation primitive — multi-turn LLM exchange support.
+// Subpath: @proposit/proposit-core/conversation
+export { executeTurn, createConversation, ConversationClosedError, } from "./conversation/index.js";
+// Builder extension — Argument Builder turn factories.
+// Subpath: @proposit/proposit-core/builder
+export { createReviewTurn, createSimulateTurn, createDistillTurn, } from "../extensions/builder/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

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

package/dist/lib/llm/index.d.ts

@@ -1,2 +1,2 @@
-export type { TLlmModel, TReasoningEffort, TToolSpec, TLlmRequest, TLlmResponse, TLlmProvider, TLlmTokenUsage, TResponseStatus, TRetrievedResponse, } from "./types.js";
+export type { TLlmModel, TReasoningEffort, TToolSpec, TResponseId, TLlmRequest, TLlmResponse, TLlmProvider, TLlmTokenUsage, TResponseStatus, TRetrievedResponse, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/llm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/llm/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACR,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,GACrB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/llm/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACR,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,GACrB,MAAM,YAAY,CAAA"}

package/dist/lib/llm/types.d.ts

@@ -1,4 +1,7 @@
 import type { TSchema } from "typebox";
+/** Opaque provider response identifier. Carried across turns so a
+ * downstream request can be chained to a specific upstream response. */
+export type TResponseId = string;
 export type TLlmModel = "gpt-5.5" | "gpt-5.4" | "gpt-5.4-mini" | "gpt-5.4-nano";
 export type TReasoningEffort = "minimal" | "low" | "medium" | "high";
 export type TToolSpec = {
@@ -42,6 +45,16 @@ export type TLlmRequest<T> = {
      * provider call (per attempt).
      */
     onResponseCreated?: (responseId: string) => void;
+    /**
+     * The provider response id to chain this request against. When set,
+     * the provider should continue from the specified prior response
+     * rather than starting a fresh conversation. Only meaningful for
+     * providers that support response chaining (e.g. the OpenAI
+     * Responses API). Synchronous providers (e.g. chat-completions)
+     * ignore this field — the caller folds the transcript into
+     * `userMessage` instead. Optional + backward-compatible.
+     */
+    previousResponseId?: TResponseId;
     /**
      * Phantom field that carries the structured-output type `T` from
      * `outputSchema` into the response. Always `undefined` at runtime.

package/dist/lib/llm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/llm/types.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAA;AAE/E,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEpE,MAAM,MAAM,SAAS,GACf;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IACI,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/C,CAAA;AAEP,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IACzB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,gBAAgB,CAAA;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD;;;OAGG;IAEH,WAAW,CAAC,EAAE,CAAC,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC1B,MAAM,EAAE,CAAC,CAAA;IACT,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CAC5D,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GACrB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,CAAA;AAEjB;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,6CAA6C;IAC7C,MAAM,EAAE,eAAe,CAAA;IACvB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/llm/types.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;wEACwE;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAA;AAE/E,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEpE,MAAM,MAAM,SAAS,GACf;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IACI,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/C,CAAA;AAEP,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IACzB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,gBAAgB,CAAA;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAA;IAChC;;;OAGG;IAEH,WAAW,CAAC,EAAE,CAAC,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC1B,MAAM,EAAE,CAAC,CAAA;IACT,UAAU,EAAE,cAAc,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CAC5D,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GACrB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,CAAA;AAEjB;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,6CAA6C;IAC7C,MAAM,EAAE,eAAe,CAAA;IACvB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA"}

package/dist/lib/parsing/prompt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/lib/parsing/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA4RhD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,cAAc,GACzB,MAAM,CAYR"}
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/lib/parsing/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAoShD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,cAAc,GACzB,MAAM,CAYR"}

package/dist/lib/parsing/prompt-builder.js

@@ -97,13 +97,21 @@ When formulating claims, write in third person, present tense, active voice. Eac
 
 State the proposition itself — never prepend an author-attributive reporting frame such as "The author claims that…", "The author argues…", "The writer believes…", or "According to the author…". Write *what is asserted*, not *that someone asserts it*: emit "Rain wets the ground," not "The author claims that rain wets the ground." (This applies only to author-attribution of the argument's own claims. Citation claims that summarize what an external **cited source** asserts — e.g. "NASA reports a temperature rise" — keep that source attribution; it is intentional and not the target here.)
 
-## Claim Types
+## Claim: \`type\` vs \`role\` — Do Not Confuse
 
-Every claim has a \`type\` field, which is one of:
+Every claim has **two** independent fields — they describe different things:
 
-- **\`"normal"\`**: a claim authored as part of the argument's primary reasoning (the propositions being argued for or from). Most claims are normal.
-- **\`"citation"\`**: a claim representing **cited evidence** — an external reference, source, or citation that another claim relies on for support. Citation claims live in the **same** \`claims\` array as normal claims; they are NOT a separate array.
-- **\`"axiomatic"\`**: a self-evident claim invoked as the bottom-level justification of a normal claim. Examples: "true by definition," "logically required," "historically established." Like citations, axiomatic claims appear on the supporting side of derivation premises, but their truth is taken as given rather than evidentially supplied. Apps using this library may extend axiomatic claims with a \`reasonCode\` field describing the category of self-evidence, and may constrain that field to a closed enum of allowed values via their schema extension; the core parser does not require any such field.
+1. **\`type\`**: the *kind* of claim. One of:
+   - **\`"normal"\`**: a proposition authored as part of the argument's primary reasoning (the claims being argued for or from). Most claims are normal.
+   - **\`"citation"\`**: a claim representing **cited evidence** — an external reference, source, or citation that another claim relies on for support. Citation claims live in the **same** \`claims\` array as normal claims; they are NOT a separate array.
+   - **\`"axiomatic"\`**: a self-evident claim invoked as the bottom-level justification of a normal claim. Examples: "true by definition," "logically required," "historically established." Like citations, axiomatic claims appear on the supporting side of derivation premises, but their truth is taken as given rather than evidentially supplied.
+
+2. **\`role\`**: the *logical function* of the claim within the argument's reasoning chain. One of:
+   - **\`"premise"\`**: a claim that supports other claims. This is the most common role.
+   - **\`"intermediate"\`**: a claim that both receives support and provides support (a bridge in a reasoning chain). It is derived from other claims and in turn supports further claims.
+   - **\`"conclusion"\`**: the claim that the argument is trying to establish. Only one claim should have this role.
+
+**Critical: \`type\` and \`role\` are orthogonal.** A normal claim can have any role: \`{ "type": "normal", "role": "conclusion" }\` is perfectly valid. A citation claim always has \`type: "citation"\` regardless of its role. Never set \`type\` to "premise", "conclusion", or "intermediate" — those values belong only in \`role\`.
 
 A citation claim is just a claim whose propositional content is "the cited material says/shows X". Logical relationships between all claim kinds — normal, citation, axiomatic — are expressed through variables, formulas, and premises. The parser derives the citation and axiom support graphs from those formulas; you do not list supports as a separate field.
 

package/dist/lib/parsing/prompt-builder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proposit/proposit-core",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Core engine for building and manipulating propositional logic arguments.",
   "license": "MIT",
   "keywords": [
@@ -57,6 +57,16 @@
       "types": "./dist/extensions/pipelines/ingestion/index.d.ts",
       "import": "./dist/extensions/pipelines/ingestion/index.js",
       "default": "./dist/extensions/pipelines/ingestion/index.js"
+    },
+    "./conversation": {
+      "types": "./dist/lib/conversation/index.d.ts",
+      "import": "./dist/lib/conversation/index.js",
+      "default": "./dist/lib/conversation/index.js"
+    },
+    "./builder": {
+      "types": "./dist/extensions/builder/index.d.ts",
+      "import": "./dist/extensions/builder/index.js",
+      "default": "./dist/extensions/builder/index.js"
     }
   },
   "bin": {