@proposit/proposit-core 1.0.2 → 1.2.0

package/dist/cli/commands/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA+CxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAoKxD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmDxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CA0NxD"}

package/dist/cli/commands/parse.js

@@ -1,5 +1,4 @@
-import { buildParsingPrompt } from "../../lib/parsing/index.js";
-import { BasicsArgumentParser, BasicsParsingSchema, } from "../../extensions/basics/index.js";
+import { BasicsArgumentParser } from "../../extensions/basics/index.js";
 import { hydratePropositCore, persistEngine, persistCore } from "../engine.js";
 import { PropositCore } from "../../lib/core/proposit-core.js";
 import { ClaimLibrary } from "../../lib/core/claim-library.js";
@@ -7,6 +6,8 @@ import { ClaimCitationLibrary } from "../../lib/core/claim-citation-library.js";
 import { cliLog } from "../logging.js";
 import { errorExit, printJson, printLine, printWarning } from "../output.js";
 import { resolveApiKey, createLlmProvider } from "../llm/index.js";
+import { basicsExtension, createIngestionV1Pipeline, executePipeline, } from "../../lib/index.js";
+const DEFAULT_PARSE_MODEL = "gpt-5.4";
 class CliArgumentParser extends BasicsArgumentParser {
     cliTitle;
     cliDescription;
@@ -39,11 +40,23 @@ export function registerParseCommand(args) {
         .option("--llm <provider>", "LLM provider name", "openai")
         .option("--api-key <key>", "API key (overrides env var)")
         .option("--model <model>", "Model override")
+        .option("--pipeline <version>", "Ingestion pipeline version (v1 only in Phase 1; v2 lands in Phase 2)", "v1")
         .option("--title <title>", "Argument title (overrides LLM-generated title)")
         .option("--description <desc>", "Argument description", "")
         .option("--dry-run", "Print raw LLM JSON without persisting")
         .action(async (text, opts) => {
-        // 1. Resolve API key
+        // 1. Resolve pipeline version. v1 is the only
+        //    supported value in Phase 1; v2 lands in Phase 2
+        //    (slice 2A) and is wired as a clean rejection
+        //    until then so users discover the flag exists
+        //    without silent fallbacks.
+        if (opts.pipeline !== "v1") {
+            if (opts.pipeline === "v2") {
+                errorExit("v2 pipeline not yet shipped — coming in Phase 2.");
+            }
+            errorExit(`Unknown pipeline version "${opts.pipeline}". Supported: v1.`);
+        }
+        // 2. Resolve API key
         let apiKey;
         try {
             apiKey = resolveApiKey(opts.llm, opts.apiKey);
@@ -51,7 +64,7 @@ export function registerParseCommand(args) {
         catch (error) {
             errorExit(error instanceof Error ? error.message : String(error));
         }
-        // 2. Resolve input text
+        // 3. Resolve input text
         let inputText;
         if (text) {
             inputText = text;
@@ -65,44 +78,66 @@ export function registerParseCommand(args) {
         if (!inputText.trim()) {
             errorExit("Input text is empty.");
         }
-        // 3. Build prompt and schema
-        const responseSchema = BasicsParsingSchema;
-        const systemPrompt = buildParsingPrompt(responseSchema);
-        // 4. Call LLM
-        const provider = createLlmProvider(opts.llm, {
-            apiKey,
-            model: opts.model,
+        // 4. Build the v1 ingestion pipeline and execute.
+        //    The pipeline owns the LLM call + structured-
+        //    output validation; the CLI is left with engine
+        //    construction + persistence.
+        const provider = createLlmProvider(opts.llm, { apiKey });
+        const pipeline = createIngestionV1Pipeline(basicsExtension, {
+            model: opts.model ?? DEFAULT_PARSE_MODEL,
         });
-        let result;
+        let pipelineResult;
         try {
-            result = await provider.complete({
-                systemPrompt,
-                userMessage: inputText,
-                responseSchema,
-            });
+            pipelineResult = await executePipeline(pipeline, { text: inputText }, { llm: provider });
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
-            await cliLog("parse:llm-error", { error: msg });
+            await cliLog("parse:pipeline-error", { error: msg });
             errorExit(msg);
         }
+        // Forward-compatibility branch — `output === null` is
+        // not reachable under the v1 single-shot pipeline
+        // (the `parse-argument` stage either completes or
+        // throws via `LlmStageRetryExhaustedError`, both of
+        // which surface here as a failures-non-empty + null
+        // output OR an outer `executePipeline` throw caught
+        // above). Slice 2A's v2 multi-stage pipeline will
+        // reach this branch when its finalize returns null
+        // on irresolvable-conclusion / empty-canonicalization
+        // outcomes (per spec §7.5). Leave the branch wired
+        // so the v2 cutover doesn't need to revisit the CLI.
+        if (pipelineResult.output === null) {
+            const failureSummary = pipelineResult.failures
+                .map((f) => `[${f.code}] ${f.message}`)
+                .join("; ");
+            await cliLog("parse:pipeline-null-output", {
+                provider: opts.llm,
+                model: opts.model ?? "(default)",
+                failures: pipelineResult.failures,
+            });
+            errorExit(failureSummary ||
+                "Ingestion pipeline returned no output.");
+        }
+        const response = pipelineResult.output;
         // 5. Log raw LLM response
         await cliLog("parse:llm-response", {
             provider: opts.llm,
             model: opts.model ?? "(default)",
             inputText,
-            response: result,
+            response,
         });
         // 6. Dry-run: print raw response and exit
         if (opts.dryRun) {
-            printJson(result);
+            printJson(response);
             return;
         }
-        // 7. Validate
+        // 7. Validate via the parser (re-validates against
+        //    the parser's schema; idempotent in the happy
+        //    path).
         const parser = new CliArgumentParser(opts.title, opts.description);
-        let response;
+        let validated;
         try {
-            response = parser.validate(result);
+            validated = parser.validate(response);
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
@@ -110,18 +145,18 @@ export function registerParseCommand(args) {
             errorExit(`Validation failed: ${msg}`);
         }
         // 8. Check for null argument
-        if (response.argument === null) {
-            const msg = response.failureText ??
+        if (validated.argument === null) {
+            const msg = validated.failureText ??
                 "The LLM could not parse the input as an argument.";
             await cliLog("parse:null-argument", {
-                failureText: response.failureText,
+                failureText: validated.failureText,
             });
             errorExit(msg);
         }
         // 9. Build engine
         let built;
         try {
-            built = parser.build(response, { strict: false });
+            built = parser.build(validated, { strict: false });
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);

package/dist/cli/commands/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/cli/commands/parse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/cli/commands/parse.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EACH,eAAe,EACf,yBAAyB,EACzB,eAAe,GAClB,MAAM,oBAAoB,CAAA;AAG3B,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAErC,MAAM,iBAAkB,SAAQ,oBAAoB;IAC/B,QAAQ,CAAS;IACjB,cAAc,CAAQ;IAEvC,YAAY,KAAc,EAAE,WAAoB;QAC5C,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,IAAI,CAAC,cAAc,GAAG,WAAW,IAAI,EAAE,CAAA;IAC3C,CAAC;IAEkB,WAAW,CAC1B,MAAuB;QAEvB,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAC9C,OAAO;YACH,GAAG,YAAY;YACf,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,WAAW,EAAE,IAAI,CAAC,cAAc;YAChC,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,KAAK;SACnB,CAAA;IACL,CAAC;CACJ;AAED,KAAK,UAAU,SAAS;IACpB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;IAChC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAC9C,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CACR,qEAAqE,CACxE;SACA,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,QAAQ,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;SACxD,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;SAC3C,MAAM,CACH,sBAAsB,EACtB,sEAAsE,EACtE,IAAI,CACP;SACA,MAAM,CACH,iBAAiB,EACjB,gDAAgD,CACnD;SACA,MAAM,CAAC,sBAAsB,EAAE,sBAAsB,EAAE,EAAE,CAAC;SAC1D,MAAM,CAAC,WAAW,EAAE,uCAAuC,CAAC;SAC5D,MAAM,CACH,KAAK,EACD,IAAwB,EACxB,IAQC,EACH,EAAE;QACA,8CAA8C;QAC9C,qDAAqD;QACrD,kDAAkD;QAClD,kDAAkD;QAClD,+BAA+B;QAC/B,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACzB,SAAS,CACL,kDAAkD,CACrD,CAAA;YACL,CAAC;YACD,SAAS,CACL,6BAA6B,IAAI,CAAC,QAAQ,mBAAmB,CAChE,CAAA;QACL,CAAC;QAED,qBAAqB;QACrB,IAAI,MAAc,CAAA;QAClB,IAAI,CAAC;YACD,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,CACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACzD,CAAA;QACL,CAAC;QAED,wBAAwB;QACxB,IAAI,SAAiB,CAAA;QACrB,IAAI,IAAI,EAAE,CAAC;YACP,SAAS,GAAG,IAAI,CAAA;QACpB,CAAC;aAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9B,SAAS,GAAG,MAAM,SAAS,EAAE,CAAA;QACjC,CAAC;aAAM,CAAC;YACJ,SAAS,CACL,4DAA4D,CAC/D,CAAA;QACL,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,SAAS,CAAC,sBAAsB,CAAC,CAAA;QACrC,CAAC;QAED,kDAAkD;QAClD,kDAAkD;QAClD,oDAAoD;QACpD,iCAAiC;QACjC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QACxD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,eAAe,EAAE;YACxD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,mBAAmB;SAC3C,CAAC,CAAA;QAEF,IAAI,cAAc,CAAA;QAClB,IAAI,CAAC;YACD,cAAc,GAAG,MAAM,eAAe,CAClC,QAAQ,EACR,EAAE,IAAI,EAAE,SAAS,EAAE,EACnB,EAAE,GAAG,EAAE,QAAQ,EAAE,CACpB,CAAA;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,GAAG,GACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1D,MAAM,MAAM,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;YACpD,SAAS,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC;QAED,sDAAsD;QACtD,kDAAkD;QAClD,kDAAkD;QAClD,oDAAoD;QACpD,oDAAoD;QACpD,oDAAoD;QACpD,kDAAkD;QAClD,mDAAmD;QACnD,sDAAsD;QACtD,mDAAmD;QACnD,qDAAqD;QACrD,IAAI,cAAc,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ;iBACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACtC,IAAI,CAAC,IAAI,CAAC,CAAA;YACf,MAAM,MAAM,CAAC,4BAA4B,EAAE;gBACvC,QAAQ,EAAE,IAAI,CAAC,GAAG;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,WAAW;gBAChC,QAAQ,EAAE,cAAc,CAAC,QAAQ;aACpC,CAAC,CAAA;YACF,SAAS,CACL,cAAc;gBACV,wCAAwC,CAC/C,CAAA;QACL,CAAC;QAED,MAAM,QAAQ,GACgB,cAAc,CAAC,MAAM,CAAA;QAEnD,0BAA0B;QAC1B,MAAM,MAAM,CAAC,oBAAoB,EAAE;YAC/B,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,WAAW;YAChC,SAAS;YACT,QAAQ;SACX,CAAC,CAAA;QAEF,0CAA0C;QAC1C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,SAAS,CAAC,QAA8C,CAAC,CAAA;YACzD,OAAM;QACV,CAAC;QAED,mDAAmD;QACnD,kDAAkD;QAClD,YAAY;QACZ,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAChC,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,WAAW,CACnB,CAAA;QACD,IAAI,SAAS,CAAA;QACb,IAAI,CAAC;YACD,SAAS,GAAG,MAAM,CAAC,QAAQ,CACvB,QAA8C,CACjD,CAAA;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,GAAG,GACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1D,MAAM,MAAM,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;YACtD,SAAS,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAA;QAC1C,CAAC;QAED,6BAA6B;QAC7B,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,GAAG,GACL,SAAS,CAAC,WAAW;gBACrB,mDAAmD,CAAA;YACvD,MAAM,MAAM,CAAC,qBAAqB,EAAE;gBAChC,WAAW,EAAE,SAAS,CAAC,WAAW;aACrC,CAAC,CAAA;YACF,SAAS,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC;QAED,kBAAkB;QAClB,IAAI,KAAK,CAAA;QACT,IAAI,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,GAAG,GACL,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1D,MAAM,MAAM,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;YACjD,SAAS,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAA;QACrC,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC7B,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;YAC5C,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,EAAE,CAAA;QAC5C,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC;YAC3C,MAAM,EAAE;gBACJ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM;gBACpC,GAAG,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM;aAC1C;SACJ,CAAC,CAAA;QACF,MAAM,eAAe,GAAG,oBAAoB,CAAC,YAAY,CACrD;YACI,WAAW,EAAE;gBACT,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,WAAW;gBAC5C,GAAG,KAAK,CAAC,oBAAoB,CAAC,QAAQ,EAAE;qBACnC,WAAW;aACnB;SACJ,EACD,YAAY,CACf,CAAA;QAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;YAC5B,YAAY,EAAE,YAAY;YAC1B,oBAAoB,EAAE,eAAe;YACrC,WAAW,EAAE,QAAQ,CAAC,KAAK;SAC9B,CAAC,CAAA;QAEF,yBAAyB;QACzB,MAAM,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACjC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAA;QACzB,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAA;IAC5C,CAAC,CACJ,CAAA;AACT,CAAC"}

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

@@ -1,6 +1,7 @@
-export type { TLlmCompletionRequest, TLlmProvider, TLlmProviderOptions, } from "./types.js";
-export { createOpenAiProvider, OPENAI_API_KEY_ENV } from "./openai.js";
-import type { TLlmProvider, TLlmProviderOptions } from "./types.js";
+import { type TCreateOpenAiResponsesProviderOptions } from "../../extensions/openai/index.js";
+import type { TLlmProvider } from "../../lib/llm/index.js";
+export declare const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 export declare function resolveApiKey(providerName: string, explicit?: string): string;
-export declare function createLlmProvider(name: string, options: TLlmProviderOptions): TLlmProvider;
+export type TCliLlmProviderOptions = Pick<TCreateOpenAiResponsesProviderOptions, "apiKey" | "baseUrl">;
+export declare function createLlmProvider(name: string, options: TCliLlmProviderOptions): TLlmProvider;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/llm/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAMnE,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC7B,YAAY,CASd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/llm/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAEH,KAAK,qCAAqC,EAC7C,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAMlD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACrC,qCAAqC,EACrC,QAAQ,GAAG,SAAS,CACvB,CAAA;AAED,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,GAChC,YAAY,CAYd"}

package/dist/cli/llm/index.js

@@ -1,5 +1,14 @@
-export { createOpenAiProvider, OPENAI_API_KEY_ENV } from "./openai.js";
-import { createOpenAiProvider, OPENAI_API_KEY_ENV } from "./openai.js";
+// CLI-side LLM factory.
+//
+// Slice 1B moved the concrete OpenAI provider into
+// `src/extensions/openai/`. This module now provides only the CLI's
+// API-key resolution + the named-provider factory; the provider
+// itself is constructed from `createOpenAiResponsesProvider` in the
+// extensions tree. Callers should depend on `TLlmProvider` (from
+// `src/lib/llm/`) as their provider contract, not on this CLI
+// factory's shape.
+import { createOpenAiResponsesProvider, } from "../../extensions/openai/index.js";
+export const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 const PROVIDER_ENV_VARS = {
     openai: OPENAI_API_KEY_ENV,
 };
@@ -18,7 +27,10 @@ export function resolveApiKey(providerName, explicit) {
 export function createLlmProvider(name, options) {
     switch (name) {
         case "openai":
-            return createOpenAiProvider(options);
+            return createOpenAiResponsesProvider({
+                apiKey: options.apiKey,
+                baseUrl: options.baseUrl,
+            });
         default:
             throw new Error(`Unknown LLM provider "${name}". Supported: openai.`);
     }

package/dist/cli/llm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/llm/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEtE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGtE,MAAM,iBAAiB,GAA2B;IAC9C,MAAM,EAAE,kBAAkB;CAC7B,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,QAAiB;IACjE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;IAC9C,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACjC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACjD,MAAM,IAAI,KAAK,CACX,4BAA4B,YAAY,mBAAmB,OAAO,GAAG,CACxE,CAAA;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,IAAY,EACZ,OAA4B;IAE5B,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,QAAQ;YACT,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAA;QACxC;YACI,MAAM,IAAI,KAAK,CACX,yBAAyB,IAAI,uBAAuB,CACvD,CAAA;IACT,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/llm/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,EAAE;AACF,mDAAmD;AACnD,oEAAoE;AACpE,gEAAgE;AAChE,oEAAoE;AACpE,iEAAiE;AACjE,8DAA8D;AAC9D,mBAAmB;AAEnB,OAAO,EACH,6BAA6B,GAEhC,MAAM,kCAAkC,CAAA;AAGzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAA;AAElD,MAAM,iBAAiB,GAA2B;IAC9C,MAAM,EAAE,kBAAkB;CAC7B,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,QAAiB;IACjE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;IAC9C,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACjC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACjD,MAAM,IAAI,KAAK,CACX,4BAA4B,YAAY,mBAAmB,OAAO,GAAG,CACxE,CAAA;AACL,CAAC;AAOD,MAAM,UAAU,iBAAiB,CAC7B,IAAY,EACZ,OAA+B;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,QAAQ;YACT,OAAO,6BAA6B,CAAC;gBACjC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;aAC3B,CAAC,CAAA;QACN;YACI,MAAM,IAAI,KAAK,CACX,yBAAyB,IAAI,uBAAuB,CACvD,CAAA;IACT,CAAC;AACL,CAAC"}

package/dist/extensions/argument-ingestion/index.d.ts

@@ -0,0 +1,9 @@
+export { createIngestionV1Pipeline } from "./v1-single-shot.js";
+export type { TCreateIngestionV1PipelineOptions } from "./v1-single-shot.js";
+export { basicsExtension } from "./shared/basics-extension.js";
+export type { TIngestionExtension, TIngestionInput } from "./shared/types.js";
+export { finalizeResponse } from "./shared/finalize-response.js";
+export type { TFinalizeResponseInput } from "./shared/finalize-response.js";
+export { deriveRoles } from "./shared/role-derivation.js";
+export type { TClaimRole, TDeriveRolesInput } from "./shared/role-derivation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/argument-ingestion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/argument-ingestion/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC9D,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/extensions/argument-ingestion/index.js

@@ -0,0 +1,11 @@
+// Barrel for the argument-ingestion extension.
+//
+// Exposes the v1 single-shot pipeline factory + the default
+// `basicsExtension`. v2 (Phase 2 / slice 2A) will add
+// `createIngestionV2Pipeline` alongside the v1 entry-point; the
+// `TIngestionExtension` descriptor is forward-compatible across both.
+export { createIngestionV1Pipeline } from "./v1-single-shot.js";
+export { basicsExtension } from "./shared/basics-extension.js";
+export { finalizeResponse } from "./shared/finalize-response.js";
+export { deriveRoles } from "./shared/role-derivation.js";
+//# sourceMappingURL=index.js.map

package/dist/extensions/argument-ingestion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/argument-ingestion/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,4DAA4D;AAC5D,sDAAsD;AACtD,gEAAgE;AAChE,sEAAsE;AAEtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/extensions/argument-ingestion/shared/basics-extension.d.ts

@@ -0,0 +1,9 @@
+import type { TIngestionExtension } from "./types.js";
+/**
+ * Default ingestion extension composing the `basics` per-entity
+ * fields. Matches what the CLI's `parse` command and the server's
+ * argument-ingestion endpoint use today. Hand to
+ * `createIngestionV1Pipeline(basicsExtension)` for a drop-in pipeline.
+ */
+export declare const basicsExtension: TIngestionExtension;
+//# sourceMappingURL=basics-extension.d.ts.map

package/dist/extensions/argument-ingestion/shared/basics-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basics-extension.d.ts","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/basics-extension.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,mBAM7B,CAAA"}

package/dist/extensions/argument-ingestion/shared/basics-extension.js

@@ -0,0 +1,25 @@
+// `basicsExtension` — the default `TIngestionExtension` value used by
+// CLI / server consumers that don't ship a custom per-entity field
+// set. Composes the per-entity extension shapes from
+// `src/extensions/basics/schemata.ts` directly so the composite
+// `BasicsParsingSchema` and the per-entity slots in this descriptor
+// stay structurally identical without manual duplication.
+//
+// Slice 2A's multi-stage pipeline will consume the per-entity slots
+// to wire decomposed stage outputs; for v1 only `responseSchema` is
+// consumed by the factory.
+import { BasicsArgumentExtension, BasicsClaimExtension, BasicsParsingSchema, BasicsPremiseExtension, BasicsVariableExtension, } from "../../basics/schemata.js";
+/**
+ * Default ingestion extension composing the `basics` per-entity
+ * fields. Matches what the CLI's `parse` command and the server's
+ * argument-ingestion endpoint use today. Hand to
+ * `createIngestionV1Pipeline(basicsExtension)` for a drop-in pipeline.
+ */
+export const basicsExtension = {
+    responseSchema: BasicsParsingSchema,
+    claimSchema: BasicsClaimExtension,
+    variableSchema: BasicsVariableExtension,
+    premiseSchema: BasicsPremiseExtension,
+    argumentSchema: BasicsArgumentExtension,
+};
+//# sourceMappingURL=basics-extension.js.map

package/dist/extensions/argument-ingestion/shared/basics-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basics-extension.js","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/basics-extension.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,mEAAmE;AACnE,qDAAqD;AACrD,gEAAgE;AAChE,oEAAoE;AACpE,0DAA0D;AAC1D,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,2BAA2B;AAE3B,OAAO,EACH,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GAC1B,MAAM,0BAA0B,CAAA;AAGjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAwB;IAChD,cAAc,EAAE,mBAAmB;IACnC,WAAW,EAAE,oBAAoB;IACjC,cAAc,EAAE,uBAAuB;IACvC,aAAa,EAAE,sBAAsB;IACrC,cAAc,EAAE,uBAAuB;CAC1C,CAAA"}

package/dist/extensions/argument-ingestion/shared/finalize-response.d.ts

@@ -0,0 +1,21 @@
+import type { TParsedArgumentResponse } from "../../../lib/parsing/index.js";
+import type { TProcessingFailure } from "../../../lib/pipelines/index.js";
+export type TFinalizeResponseInput = {
+    /** Output of the single `parse-argument` llmStage in v1. */
+    parsedResponse: TParsedArgumentResponse;
+    /**
+     * Pipeline-level failures aggregated so far. v1's single stage
+     * either succeeds (empty array) or the executor skips finalize.
+     * v2 stages will add warnings/errors here.
+     */
+    failures: readonly TProcessingFailure[];
+};
+/**
+ * Wire the per-stage outputs into the final response shape. v1's
+ * implementation is a passthrough of `parsedResponse` with the v1's
+ * empty `processingFailures` slot wired through. Returning a plain
+ * `TParsedArgumentResponse` keeps the existing `ArgumentParser.build()`
+ * consumer path unchanged.
+ */
+export declare function finalizeResponse(input: TFinalizeResponseInput): TParsedArgumentResponse;
+//# sourceMappingURL=finalize-response.d.ts.map

package/dist/extensions/argument-ingestion/shared/finalize-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-response.d.ts","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/finalize-response.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEzE,MAAM,MAAM,sBAAsB,GAAG;IACjC,4DAA4D;IAC5D,cAAc,EAAE,uBAAuB,CAAA;IACvC;;;;OAIG;IACH,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAC1C,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,sBAAsB,GAC9B,uBAAuB,CAczB"}

package/dist/extensions/argument-ingestion/shared/finalize-response.js

@@ -0,0 +1,33 @@
+// `finalize-response` — assembles the final `TParsedArgumentResponse`
+// from per-stage outputs accumulated by the pipeline executor.
+//
+// v1 is a single-shot pipeline: the LLM emits the full response in
+// one call, the `parse-argument` stage outputs that response verbatim,
+// and `finalize` just attaches an empty `processingFailures` array
+// (a forward-compat slot reserved for v2's per-stage failure aggregation).
+//
+// v2 will do most of the assembly here: each per-stage output
+// (claims, variables, premises, conclusion selection, …) is merged
+// into a single response and per-stage failures get folded into
+// `processingFailures`. Today the function is intentionally trivial.
+/**
+ * Wire the per-stage outputs into the final response shape. v1's
+ * implementation is a passthrough of `parsedResponse` with the v1's
+ * empty `processingFailures` slot wired through. Returning a plain
+ * `TParsedArgumentResponse` keeps the existing `ArgumentParser.build()`
+ * consumer path unchanged.
+ */
+export function finalizeResponse(input) {
+    const passthrough = {
+        ...input.parsedResponse,
+    };
+    // Reserve a `processingFailures` slot on the response. Today
+    // `TParsedArgumentResponse` carries `additionalProperties: true`
+    // so attaching this field is type-safe at runtime; v2 will
+    // populate it from real stage warnings/errors. v1 always emits
+    // an empty array so server-side consumers can rely on the slot
+    // being present.
+    passthrough.processingFailures = [...input.failures];
+    return passthrough;
+}
+//# sourceMappingURL=finalize-response.js.map

package/dist/extensions/argument-ingestion/shared/finalize-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-response.js","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/finalize-response.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,+DAA+D;AAC/D,EAAE;AACF,mEAAmE;AACnE,uEAAuE;AACvE,mEAAmE;AACnE,2EAA2E;AAC3E,EAAE;AACF,8DAA8D;AAC9D,mEAAmE;AACnE,gEAAgE;AAChE,qEAAqE;AAgBrE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAA6B;IAE7B,MAAM,WAAW,GAAG;QAChB,GAAG,KAAK,CAAC,cAAc;KAG1B,CAAA;IACD,6DAA6D;IAC7D,iEAAiE;IACjE,2DAA2D;IAC3D,+DAA+D;IAC/D,+DAA+D;IAC/D,iBAAiB;IACjB,WAAW,CAAC,kBAAkB,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;IACpD,OAAO,WAAW,CAAA;AACtB,CAAC"}

package/dist/extensions/argument-ingestion/shared/role-derivation.d.ts

@@ -0,0 +1,11 @@
+import type { TParsedClaim } from "../../../lib/parsing/index.js";
+export type TClaimRole = "conclusion" | "premise" | "intermediate";
+export type TDeriveRolesInput = {
+    claims: readonly TParsedClaim[];
+};
+/**
+ * Returns a `claimMiniId -> role` map. v1 trusts the LLM's
+ * self-assigned roles; v2 will compute roles from premise relations.
+ */
+export declare function deriveRoles(input: TDeriveRolesInput): Record<string, TClaimRole>;
+//# sourceMappingURL=role-derivation.d.ts.map

package/dist/extensions/argument-ingestion/shared/role-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-derivation.d.ts","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/role-derivation.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAEjE,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,cAAc,CAAA;AAElE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;CAClC,CAAA;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,iBAAiB,GACzB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAM5B"}

package/dist/extensions/argument-ingestion/shared/role-derivation.js

@@ -0,0 +1,26 @@
+// `role-derivation` — pure helper that assigns each claim a role
+// (`'conclusion'` | `'premise'` | `'intermediate'`) given the
+// argument's premise/variable graph + the selected conclusion premise.
+//
+// v1 is trivial: the LLM already emits per-claim roles in its
+// `parsed.argument.claims[].role` field; v1's pipeline just trusts
+// that assignment and `deriveRoles` returns the LLM-provided map.
+//
+// v2 will derive roles from the relations graph + selected conclusion
+// (the LLM no longer self-assigns roles in the multi-stage pipeline).
+// The helper signature is forward-compatible: it accepts a generic
+// `claims` collection plus the selected conclusion premise miniId and
+// the per-premise variable wiring, so v2 can swap in a real
+// derivation without breaking v1 callers.
+/**
+ * Returns a `claimMiniId -> role` map. v1 trusts the LLM's
+ * self-assigned roles; v2 will compute roles from premise relations.
+ */
+export function deriveRoles(input) {
+    const out = {};
+    for (const claim of input.claims) {
+        out[claim.miniId] = claim.role;
+    }
+    return out;
+}
+//# sourceMappingURL=role-derivation.js.map

package/dist/extensions/argument-ingestion/shared/role-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-derivation.js","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/role-derivation.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,8DAA8D;AAC9D,uEAAuE;AACvE,EAAE;AACF,8DAA8D;AAC9D,mEAAmE;AACnE,kEAAkE;AAClE,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,mEAAmE;AACnE,sEAAsE;AACtE,4DAA4D;AAC5D,0CAA0C;AAU1C;;;GAGG;AACH,MAAM,UAAU,WAAW,CACvB,KAAwB;IAExB,MAAM,GAAG,GAA+B,EAAE,CAAA;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAA;IAClC,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC"}

package/dist/extensions/argument-ingestion/shared/types.d.ts

@@ -0,0 +1,34 @@
+import type { TSchema } from "typebox";
+/**
+ * Bundle of TypeBox schemas a caller hands to an ingestion pipeline
+ * factory. Only `responseSchema` is consumed by v1; the per-entity
+ * slots are forward-compat surface for v2's stage decomposition (see
+ * Phase 2 / slice 2A).
+ *
+ * `responseSchema` is the full `TParsedArgumentResponse` shape with
+ * any caller extensions merged in — typically built via
+ * `buildParsingResponseSchema({ claimSchema, premiseSchema,
+ * parsedArgumentSchema })` from `src/lib/parsing/`.
+ */
+export type TIngestionExtension = {
+    /** Full extended TParsedArgumentResponse schema (the LLM's output schema). */
+    responseSchema: TSchema;
+    /** Extension shape for individual claims (Type.Object or discriminated Type.Union of Type.Objects). */
+    claimSchema: TSchema;
+    /** Extension shape for individual variables. */
+    variableSchema: TSchema;
+    /** Extension shape for individual premises. */
+    premiseSchema: TSchema;
+    /** Extension shape for the top-level argument object. */
+    argumentSchema: TSchema;
+};
+/**
+ * Input shape every ingestion pipeline accepts: the raw natural-
+ * language text to parse. Wrapped in an object so future v2 stages
+ * can attach side-input (per-stage hints, prior corrections, …)
+ * without breaking the wire-shape.
+ */
+export type TIngestionInput = {
+    text: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/argument-ingestion/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/types.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAA;IACvB,uGAAuG;IACvG,WAAW,EAAE,OAAO,CAAA;IACpB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAA;IACvB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAA;IACtB,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/extensions/argument-ingestion/shared/types.js

@@ -0,0 +1,16 @@
+// Shared types for the argument-ingestion extension.
+//
+// The v1 single-shot pipeline and the (future) v2 multi-stage pipeline
+// both produce a `TParsedArgumentResponse`-shaped output that the
+// existing `ArgumentParser.build()` consumes. They share an extension
+// descriptor — `TIngestionExtension` — so callers can plug in custom
+// per-entity field shapes (titles, bodies, URLs, axiom labels, …)
+// without reimplementing the pipelines.
+//
+// For v1 the descriptor is consumed in exactly one place:
+// `createIngestionV1Pipeline` reads `responseSchema` and hands it to
+// the single `llmStage`'s `outputSchema` (and to `buildParsingPrompt`
+// for system-prompt construction). The per-entity slots are retained
+// in the descriptor so v2 stages can compose them.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/argument-ingestion/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/extensions/argument-ingestion/shared/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,uEAAuE;AACvE,kEAAkE;AAClE,sEAAsE;AACtE,qEAAqE;AACrE,kEAAkE;AAClE,wCAAwC;AACxC,EAAE;AACF,0DAA0D;AAC1D,qEAAqE;AACrE,sEAAsE;AACtE,qEAAqE;AACrE,mDAAmD"}

package/dist/extensions/argument-ingestion/v1-single-shot.d.ts

@@ -0,0 +1,18 @@
+import type { TPipeline } from "../../lib/pipelines/index.js";
+import type { TParsedArgumentResponse } from "../../lib/parsing/index.js";
+import type { TIngestionExtension, TIngestionInput } from "./shared/types.js";
+export type TCreateIngestionV1PipelineOptions = {
+    /** Override the default `gpt-5.4` model. */
+    model?: string;
+    /** Optional caller-supplied custom-instructions appendix. */
+    customInstructions?: string;
+};
+/**
+ * Build the v1 ingestion pipeline for the supplied extension.
+ *
+ * The returned `TPipeline` accepts a `{ text }` input, calls one
+ * `llmStage` against `extension.responseSchema`, and finalizes into
+ * the parser-consumable `TParsedArgumentResponse` shape.
+ */
+export declare function createIngestionV1Pipeline(extension: TIngestionExtension, options?: TCreateIngestionV1PipelineOptions): TPipeline<TIngestionInput, TParsedArgumentResponse>;
+//# sourceMappingURL=v1-single-shot.d.ts.map

package/dist/extensions/argument-ingestion/v1-single-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-single-shot.d.ts","sourceRoot":"","sources":["../../../src/extensions/argument-ingestion/v1-single-shot.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAQ7E,MAAM,MAAM,iCAAiC,GAAG;IAC5C,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,mBAAmB,EAC9B,OAAO,CAAC,EAAE,iCAAiC,GAC5C,SAAS,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAkErD"}