muonroi-cli 1.2.0

package/dist/pil/response-tools.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+const RefactorSchema = z.object({
+    summary: z.string().describe("One-line summary of what changed"),
+    changes: z.array(z.object({
+        file: z.string().describe("File path"),
+        diff: z.string().describe("Unified diff or replacement code"),
+    })),
+    verify_command: z.string().optional().describe("Command to verify the change"),
+});
+const DebugSchema = z.object({
+    hypothesis: z.string().describe("What you think is wrong"),
+    root_cause: z.string().describe("Confirmed root cause, one line"),
+    fix: z.object({
+        file: z.string(),
+        diff: z.string().describe("Code fix as unified diff"),
+    }),
+    verify_command: z.string().describe("Command to verify the fix"),
+});
+const PlanSchema = z.object({
+    steps: z.array(z.object({
+        action: z.string().describe("Action verb + what to do"),
+        criterion: z.string().describe("How to know this step is done"),
+        rationale: z.string().optional().describe("Why this step"),
+    })),
+    assumptions: z.array(z.string()).optional(),
+    risks: z.array(z.string()).optional(),
+});
+const AnalyzeSchema = z.object({
+    findings: z.array(z.object({
+        text: z.string().describe("Finding description"),
+        evidence: z.string().describe("file:line or direct quote"),
+        severity: z.enum(["high", "medium", "low"]).describe("Impact level"),
+    })),
+});
+const DocsSchema = z.object({
+    content: z.string().describe("Markdown documentation"),
+    examples: z
+        .array(z.object({
+        code: z.string(),
+        description: z.string(),
+    }))
+        .optional(),
+});
+const GenerateSchema = z.object({
+    files: z.array(z.object({
+        path: z.string().describe("Output file path"),
+        content: z.string().describe("Complete file content with all imports"),
+        language: z.string().describe("Language identifier"),
+    })),
+    explanation: z.string().optional().describe("Brief design rationale"),
+});
+const GeneralSchema = z.object({
+    response: z.string().describe("Direct answer to the user"),
+    reasoning: z.string().optional().describe("Optional brief reasoning"),
+});
+const RESPONSE_SCHEMAS = {
+    refactor: RefactorSchema,
+    debug: DebugSchema,
+    plan: PlanSchema,
+    analyze: AnalyzeSchema,
+    documentation: DocsSchema,
+    generate: GenerateSchema,
+    general: GeneralSchema,
+};
+export const RESPONSE_TOOL_PREFIX = "respond_";
+export function isResponseTool(toolName) {
+    return toolName.startsWith(RESPONSE_TOOL_PREFIX);
+}
+export function getResponseTaskType(toolName) {
+    const suffix = toolName.slice(RESPONSE_TOOL_PREFIX.length);
+    return suffix in RESPONSE_SCHEMAS ? suffix : null;
+}
+export function buildResponseTools(taskType) {
+    const schema = RESPONSE_SCHEMAS[taskType];
+    if (!schema)
+        return {};
+    const toolName = `${RESPONSE_TOOL_PREFIX}${taskType}`;
+    return {
+        [toolName]: {
+            description: `Return your ${taskType} response as structured JSON. Always use this tool to respond.`,
+            inputSchema: schema,
+            execute: async (input) => input,
+        },
+    };
+}
+export { RefactorSchema, DebugSchema, PlanSchema, AnalyzeSchema, DocsSchema, GenerateSchema, GeneralSchema };
+//# sourceMappingURL=response-tools.js.map

package/dist/pil/response-tools.js.map

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

package/dist/pil/schema.d.ts

@@ -0,0 +1,80 @@
+/**
+ * src/pil/schema.ts
+ *
+ * Zod schemas for runtime validation of PIL pipeline output.
+ * Used in runPipeline() with safeParse — fail-open on invalid data.
+ */
+import { z } from "zod";
+export declare const TaskTypeSchema: z.ZodEnum<{
+    debug: "debug";
+    plan: "plan";
+    refactor: "refactor";
+    analyze: "analyze";
+    documentation: "documentation";
+    generate: "generate";
+}>;
+export declare const OutputStyleSchema: z.ZodEnum<{
+    balanced: "balanced";
+    concise: "concise";
+    detailed: "detailed";
+}>;
+export declare const LayerResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    applied: z.ZodBoolean;
+    delta: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const LayerTimingSchema: z.ZodObject<{
+    name: z.ZodString;
+    ms: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PipelineMetricsSchema: z.ZodObject<{
+    totalMs: z.ZodNumber;
+    layerTimings: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        ms: z.ZodNumber;
+    }, z.core.$strip>>;
+    inputChars: z.ZodNumber;
+    outputChars: z.ZodNumber;
+    estimatedTokensSaved: z.ZodNumber;
+    enrichmentTokensAdded: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PipelineContextSchema: z.ZodObject<{
+    raw: z.ZodString;
+    enriched: z.ZodString;
+    taskType: z.ZodNullable<z.ZodEnum<{
+        debug: "debug";
+        plan: "plan";
+        refactor: "refactor";
+        analyze: "analyze";
+        documentation: "documentation";
+        generate: "generate";
+    }>>;
+    domain: z.ZodNullable<z.ZodString>;
+    confidence: z.ZodNumber;
+    outputStyle: z.ZodNullable<z.ZodEnum<{
+        balanced: "balanced";
+        concise: "concise";
+        detailed: "detailed";
+    }>>;
+    tokenBudget: z.ZodNumber;
+    metrics: z.ZodNullable<z.ZodObject<{
+        totalMs: z.ZodNumber;
+        layerTimings: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            ms: z.ZodNumber;
+        }, z.core.$strip>>;
+        inputChars: z.ZodNumber;
+        outputChars: z.ZodNumber;
+        estimatedTokensSaved: z.ZodNumber;
+        enrichmentTokensAdded: z.ZodNumber;
+    }, z.core.$strip>>;
+    layers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        applied: z.ZodBoolean;
+        delta: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    gsdPhase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    resumeDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    activeRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    digestAgeMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;

package/dist/pil/schema.js

@@ -0,0 +1,43 @@
+/**
+ * src/pil/schema.ts
+ *
+ * Zod schemas for runtime validation of PIL pipeline output.
+ * Used in runPipeline() with safeParse — fail-open on invalid data.
+ */
+import { z } from "zod";
+export const TaskTypeSchema = z.enum(["refactor", "debug", "plan", "analyze", "documentation", "generate"]);
+export const OutputStyleSchema = z.enum(["concise", "detailed", "balanced"]);
+export const LayerResultSchema = z.object({
+    name: z.string(),
+    applied: z.boolean(),
+    delta: z.string().nullable(),
+});
+export const LayerTimingSchema = z.object({
+    name: z.string(),
+    ms: z.number().min(0),
+});
+export const PipelineMetricsSchema = z.object({
+    totalMs: z.number().min(0),
+    layerTimings: z.array(LayerTimingSchema),
+    inputChars: z.number().min(0),
+    outputChars: z.number().min(0),
+    estimatedTokensSaved: z.number().min(0),
+    enrichmentTokensAdded: z.number().min(0),
+});
+export const PipelineContextSchema = z.object({
+    raw: z.string(),
+    enriched: z.string(),
+    taskType: TaskTypeSchema.nullable(),
+    domain: z.string().nullable(),
+    confidence: z.number().min(0).max(1),
+    outputStyle: OutputStyleSchema.nullable(),
+    tokenBudget: z.number().positive(),
+    metrics: PipelineMetricsSchema.nullable(),
+    layers: z.array(LayerResultSchema),
+    // P2: optional context fields
+    gsdPhase: z.string().nullable().optional(),
+    resumeDigest: z.string().nullable().optional(),
+    activeRunId: z.string().nullable().optional(),
+    digestAgeMs: z.number().nullable().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/pil/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/pil/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC;AAE5G,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAClC,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC"}

package/dist/pil/store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * src/pil/store.ts
+ *
+ * Module-level last-result store for the /optimize command.
+ * Single-threaded per session — no zustand needed.
+ */
+import type { PipelineContext } from "./types.js";
+export type OutputMode = "structured" | "text-fallback" | "conversational";
+export declare function setPilLastResult(ctx: PipelineContext): void;
+export declare function getPilLastResult(): PipelineContext | null;
+export declare function setLastOutputMode(mode: OutputMode): void;
+export declare function getLastOutputMode(): OutputMode;

package/dist/pil/store.js

@@ -0,0 +1,21 @@
+/**
+ * src/pil/store.ts
+ *
+ * Module-level last-result store for the /optimize command.
+ * Single-threaded per session — no zustand needed.
+ */
+let _last = null;
+let _lastOutputMode = "conversational";
+export function setPilLastResult(ctx) {
+    _last = ctx;
+}
+export function getPilLastResult() {
+    return _last;
+}
+export function setLastOutputMode(mode) {
+    _lastOutputMode = mode;
+}
+export function getLastOutputMode() {
+    return _lastOutputMode;
+}
+//# sourceMappingURL=store.js.map

package/dist/pil/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/pil/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,IAAI,KAAK,GAA2B,IAAI,CAAC;AACzC,IAAI,eAAe,GAAe,gBAAgB,CAAC;AAEnD,MAAM,UAAU,gBAAgB,CAAC,GAAoB;IACnD,KAAK,GAAG,GAAG,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/pil/task-tier-map.d.ts

@@ -0,0 +1,30 @@
+/**
+ * src/pil/task-tier-map.ts
+ *
+ * Maps PIL TaskTypes to EE routing tiers.
+ * EE tiers: 'fast' | 'balanced' | 'premium'
+ *
+ * Rationale for each mapping:
+ * - fast: Low-complexity tasks where speed matters more than model depth
+ * - balanced: Most coding tasks — needs competence but not premium reasoning
+ * - premium: High-stakes planning tasks requiring deep reasoning
+ */
+import type { ModelRole } from "../utils/settings.js";
+export type EETier = "fast" | "balanced" | "premium";
+/**
+ * Map a PIL taskType to an EE routing tier.
+ * Returns 'fast' for null (conversational turns).
+ * Returns 'balanced' for unknown task types (safe fallback).
+ */
+export declare function taskTypeToTier(taskType: string | null): EETier;
+/**
+ * Map a PIL taskType to an appropriate maxOutputTokens budget.
+ * Keeps conversational turns short and reserves headroom for generation-heavy tasks.
+ */
+export declare function taskTypeToMaxTokens(taskType: string | null): number;
+/**
+ * Map a PIL taskType to a reasoning effort level.
+ * High-stakes planning gets full reasoning; simple tasks get minimal.
+ */
+export declare function taskTypeToReasoningEffort(taskType: string | null): "low" | "medium" | "high";
+export declare function taskTypeToRole(taskType: string | null): ModelRole | null;

package/dist/pil/task-tier-map.js

@@ -0,0 +1,83 @@
+/**
+ * src/pil/task-tier-map.ts
+ *
+ * Maps PIL TaskTypes to EE routing tiers.
+ * EE tiers: 'fast' | 'balanced' | 'premium'
+ *
+ * Rationale for each mapping:
+ * - fast: Low-complexity tasks where speed matters more than model depth
+ * - balanced: Most coding tasks — needs competence but not premium reasoning
+ * - premium: High-stakes planning tasks requiring deep reasoning
+ */
+const MAP = {
+    refactor: "balanced",
+    debug: "balanced",
+    plan: "premium",
+    analyze: "balanced",
+    documentation: "fast",
+    generate: "balanced",
+    general: "fast",
+};
+/**
+ * Map a PIL taskType to an EE routing tier.
+ * Returns 'fast' for null (conversational turns).
+ * Returns 'balanced' for unknown task types (safe fallback).
+ */
+export function taskTypeToTier(taskType) {
+    if (!taskType)
+        return "fast";
+    return MAP[taskType] ?? "balanced";
+}
+/**
+ * Map a PIL taskType to an appropriate maxOutputTokens budget.
+ * Keeps conversational turns short and reserves headroom for generation-heavy tasks.
+ */
+export function taskTypeToMaxTokens(taskType) {
+    switch (taskType) {
+        case "analyze":
+        case "documentation":
+            return 4_096;
+        case "debug":
+        case "refactor":
+            return 6_144;
+        case "plan":
+            return 8_192;
+        case "generate":
+            return 12_288;
+        default:
+            return 4_096; // conversational — keep short
+    }
+}
+/**
+ * Map a PIL taskType to a reasoning effort level.
+ * High-stakes planning gets full reasoning; simple tasks get minimal.
+ */
+export function taskTypeToReasoningEffort(taskType) {
+    switch (taskType) {
+        case "plan":
+            return "high";
+        case "debug":
+        case "refactor":
+        case "generate":
+            return "medium";
+        case "analyze":
+        case "documentation":
+            return "low";
+        default:
+            return "low"; // conversational — minimal reasoning
+    }
+}
+const ROLE_MAP = {
+    plan: "leader",
+    analyze: "leader",
+    generate: "implement",
+    refactor: "implement",
+    debug: "verify",
+    documentation: "research",
+};
+export function taskTypeToRole(taskType) {
+    if (!taskType)
+        return null;
+    return ROLE_MAP[taskType] ?? null;
+}
+//# sourceMappingURL=task-tier-map.js.map

package/dist/pil/task-tier-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-tier-map.js","sourceRoot":"","sources":["../../src/pil/task-tier-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,GAAG,GAA2B;IAClC,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,UAAU;IACnB,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAuB;IACpD,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC7B,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,eAAe;YAClB,OAAO,KAAK,CAAC;QACf,KAAK,OAAO,CAAC;QACb,KAAK,UAAU;YACb,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,KAAK,CAAC,CAAC,8BAA8B;IAChD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAuB;IAC/D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS,CAAC;QACf,KAAK,eAAe;YAClB,OAAO,KAAK,CAAC;QACf;YACE,OAAO,KAAK,CAAC,CAAC,qCAAqC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,QAAQ,GAA8B;IAC1C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,QAAQ;IACf,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,QAAuB;IACpD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACpC,CAAC"}

package/dist/pil/timeout.d.ts

@@ -0,0 +1,7 @@
+/**
+ * src/pil/timeout.ts
+ *
+ * Promise.race timeout helper for the PIL pipeline.
+ * Returns a promise that resolves to `value` after `ms` milliseconds.
+ */
+export declare function resolveAfter<T>(ms: number, value: T): Promise<T>;

package/dist/pil/timeout.js

@@ -0,0 +1,10 @@
+/**
+ * src/pil/timeout.ts
+ *
+ * Promise.race timeout helper for the PIL pipeline.
+ * Returns a promise that resolves to `value` after `ms` milliseconds.
+ */
+export function resolveAfter(ms, value) {
+    return new Promise((resolve) => setTimeout(() => resolve(value), ms));
+}
+//# sourceMappingURL=timeout.js.map

package/dist/pil/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/pil/timeout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,YAAY,CAAI,EAAU,EAAE,KAAQ;IAClD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/pil/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * src/pil/types.ts
+ *
+ * Core type definitions for the Prompt Intelligence Layer (PIL) pipeline.
+ */
+export type TaskType = "refactor" | "debug" | "plan" | "analyze" | "documentation" | "generate";
+export type OutputStyle = "concise" | "detailed" | "balanced";
+export interface LayerResult {
+    name: string;
+    applied: boolean;
+    delta: string | null;
+}
+export interface PipelineMetrics {
+    totalMs: number;
+    layerTimings: Array<{
+        name: string;
+        ms: number;
+    }>;
+    inputChars: number;
+    outputChars: number;
+    estimatedTokensSaved: number;
+    enrichmentTokensAdded: number;
+}
+export interface PipelineContext {
+    raw: string;
+    enriched: string;
+    taskType: TaskType | null;
+    domain: string | null;
+    /** Classifier confidence score 0..1. 0 = fallback/timeout path. */
+    confidence: number;
+    outputStyle: OutputStyle | null;
+    tokenBudget: number;
+    metrics: PipelineMetrics | null;
+    layers: LayerResult[];
+    gsdPhase?: string | null;
+    resumeDigest?: string | null;
+    activeRunId?: string | null;
+    digestAgeMs?: number | null;
+}

package/dist/pil/types.js

@@ -0,0 +1,7 @@
+/**
+ * src/pil/types.ts
+ *
+ * Core type definitions for the Prompt Intelligence Layer (PIL) pipeline.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pil/types.js.map

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

package/dist/providers/__test-utils__/load-fixture.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Parse a JSONL fixture file into an array of AI SDK v6 TextStreamPart-like objects.
+ */
+export declare function loadFixtureChunks(provider: string, scenario: string): unknown[];
+/**
+ * Create a mock async iterable that yields fixture chunks,
+ * simulating AI SDK v6's result.fullStream.
+ */
+export declare function createMockFullStream(chunks: unknown[]): AsyncIterable<unknown>;

package/dist/providers/__test-utils__/load-fixture.js

@@ -0,0 +1,34 @@
+/**
+ * Shared test helper: load JSONL fixture files and create a mock fullStream async iterable.
+ * Used by all provider adapter tests to replay recorded streams without network.
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+// Fixtures are at <repo>/tests/fixtures/providers/<provider>/<scenario>.jsonl
+// This file lives at <repo>/src/providers/__test-utils__/load-fixture.ts
+const FIXTURES_ROOT = resolve(__dirname, "..", "..", "..", "tests", "fixtures", "providers");
+/**
+ * Parse a JSONL fixture file into an array of AI SDK v6 TextStreamPart-like objects.
+ */
+export function loadFixtureChunks(provider, scenario) {
+    const filePath = resolve(FIXTURES_ROOT, provider, `${scenario}.jsonl`);
+    const text = readFileSync(filePath, "utf-8");
+    return text
+        .split("\n")
+        .filter((line) => line.trim().length > 0)
+        .map((line) => JSON.parse(line));
+}
+/**
+ * Create a mock async iterable that yields fixture chunks,
+ * simulating AI SDK v6's result.fullStream.
+ */
+export function createMockFullStream(chunks) {
+    return {
+        async *[Symbol.asyncIterator]() {
+            for (const chunk of chunks) {
+                yield chunk;
+            }
+        },
+    };
+}
+//# sourceMappingURL=load-fixture.js.map

package/dist/providers/__test-utils__/load-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-fixture.js","sourceRoot":"","sources":["../../../src/providers/__test-utils__/load-fixture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,8EAA8E;AAC9E,yEAAyE;AACzE,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,GAAG,QAAQ,QAAQ,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,OAAO;QACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/__tests__/runtime-integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/providers/__tests__/runtime-integration.test.js

@@ -0,0 +1,71 @@
+import { describe, expect, test, beforeAll } from "vitest";
+import { createProviderFactory, detectProviderForModel, resolveModelRuntime } from "../runtime.js";
+import { loadCatalog } from "../../models/registry.js";
+beforeAll(async () => {
+    await loadCatalog();
+});
+describe("model → provider detection", () => {
+    const cases = [
+        ["claude-sonnet-4-6", "anthropic"],
+        ["claude-opus-4-7", "anthropic"],
+        ["gpt-4o", "openai"],
+        ["gpt-4o-mini", "openai"],
+        ["o3", "openai"],
+        ["deepseek-chat", "deepseek"],
+        ["deepseek-reasoner", "deepseek"],
+        ["grok-3", "xai"],
+        ["grok-3-mini", "xai"],
+        ["unknown-custom-model", "anthropic"],
+    ];
+    for (const [modelId, expectedProvider] of cases) {
+        test(`${modelId} → ${expectedProvider}`, () => {
+            expect(detectProviderForModel(modelId)).toBe(expectedProvider);
+        });
+    }
+});
+describe("end-to-end: create factory + resolve runtime", () => {
+    test("openai model resolves without anthropic-specific options", () => {
+        const pf = createProviderFactory("openai", {
+            apiKey: "sk-openai-test-key-long-enough-for-validation",
+        });
+        const runtime = resolveModelRuntime(pf.factory, "gpt-4o");
+        expect(runtime.modelId).toBe("gpt-4o");
+        expect(runtime.model).toBeDefined();
+        expect(runtime.providerOptions?.anthropic).toBeUndefined();
+    });
+    test("anthropic thinking model gets providerOptions", () => {
+        const pf = createProviderFactory("anthropic", {
+            apiKey: "sk-ant-test-key-long-enough-for-validation",
+        });
+        const runtime = resolveModelRuntime(pf.factory, "claude-sonnet-4-6");
+        expect(runtime.modelId).toBe("claude-sonnet-4-6");
+        expect(runtime.providerOptions?.anthropic?.thinking?.type).toBe("enabled");
+    });
+    test("xai reasoning model gets xai providerOptions", () => {
+        const pf = createProviderFactory("xai", {
+            apiKey: "xai-test-key-long-enough-for-validation",
+        });
+        const runtime = resolveModelRuntime(pf.factory, "grok-3-mini");
+        expect(runtime.modelId).toBe("grok-3-mini");
+        expect(runtime.providerOptions?.xai?.reasoningEffort).toBe("medium");
+    });
+    test("ollama factory works without API key", () => {
+        const pf = createProviderFactory("ollama", {});
+        const runtime = resolveModelRuntime(pf.factory, "llama3");
+        expect(runtime.modelId).toBe("llama3");
+        expect(runtime.model).toBeDefined();
+    });
+    test("anthropic factory has responses method", () => {
+        const pf = createProviderFactory("anthropic", {
+            apiKey: "sk-ant-test-key-long-enough-for-validation",
+        });
+        expect(typeof pf.factory.responses).toBe("function");
+    });
+    test("openai factory does not have responses method", () => {
+        const pf = createProviderFactory("openai", {
+            apiKey: "sk-openai-test-key-long-enough-for-validation",
+        });
+        expect(pf.factory.responses).toBeUndefined();
+    });
+});
+//# sourceMappingURL=runtime-integration.test.js.map

package/dist/providers/__tests__/runtime-integration.test.js.map

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

package/dist/providers/__tests__/runtime.test.d.ts

@@ -0,0 +1 @@
+export {};