@kilnai/cli 0.23.1 → 1.0.0

package/dist/wrapper/preamble-builder.d.ts

@@ -0,0 +1,7 @@
+import type { Agent } from "@kilnai/core";
+import type { KilnPermissionPolicy } from "./session.js";
+import type { SessionContext } from "./index.js";
+export declare const PREAMBLE_CACHE_BOUNDARY = "__KILN_PROMPT_DYNAMIC_BOUNDARY__";
+export declare function buildProviderSystemPrompt(basePrompt: string, constraintInstructions?: readonly string[]): string;
+export declare function buildPreamble(ctx: SessionContext, policy: KilnPermissionPolicy, agent?: Agent): string;
+//# sourceMappingURL=preamble-builder.d.ts.map

package/dist/wrapper/preamble-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble-builder.d.ts","sourceRoot":"","sources":["../../src/wrapper/preamble-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,uBAAuB,qCAAqC,CAAC;AAI1E,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,GACzC,MAAM,CAUR;AA6ED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,oBAAoB,EAC5B,KAAK,CAAC,EAAE,KAAK,GACZ,MAAM,CAgCR"}

package/dist/wrapper/preamble-builder.js

@@ -0,0 +1,103 @@
+import { renderProjectedContext } from "../application/context-types.js";
+export const PREAMBLE_CACHE_BOUNDARY = "__KILN_PROMPT_DYNAMIC_BOUNDARY__";
+const MEMORY_LINE_LIMIT = 200;
+export function buildProviderSystemPrompt(basePrompt, constraintInstructions) {
+    if (!constraintInstructions || constraintInstructions.length === 0) {
+        return basePrompt;
+    }
+    const section = `[KILN POLICY CONSTRAINTS]\n${constraintInstructions.join("\n")}`;
+    if (basePrompt.trim().length === 0) {
+        return section;
+    }
+    return `${basePrompt}\n\n${section}`;
+}
+function trimMemory(memory) {
+    const lines = memory.split("\n");
+    if (lines.length <= MEMORY_LINE_LIMIT)
+        return memory;
+    const omitted = lines.length - MEMORY_LINE_LIMIT;
+    return (lines.slice(0, MEMORY_LINE_LIMIT).join("\n") +
+        `\n[memory truncated — ${omitted} lines omitted]`);
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function tag(name, content) {
+    return `<${name}>${content}</${name}>`;
+}
+function buildRoleSection(agent) {
+    if (!agent.name && !agent.role && !agent.goal)
+        return null;
+    const parts = [];
+    parts.push(`You are ${agent.name || "Agent"}, ${agent.role || "assistant"}. Goal: ${agent.goal || "assist the user"}`);
+    if (agent.backstory) {
+        parts.push(agent.backstory);
+    }
+    return tag("role", parts.join("\n"));
+}
+function buildTaskSection(task) {
+    return tag("task", escapeXml(task));
+}
+function buildDomainSection(domain) {
+    const toolTags = [...domain.toolTags];
+    const gates = domain.qualityGates.map((g) => g.name);
+    if (toolTags.length === 0 && gates.length === 0)
+        return null;
+    const parts = [];
+    parts.push(`Project type: ${domain.displayName}`);
+    if (toolTags.length > 0) {
+        parts.push(`Tool tags: ${toolTags.join(", ")}`);
+    }
+    if (gates.length > 0) {
+        parts.push(`Quality gates: ${gates.join(", ")}`);
+    }
+    return tag("domain", parts.join("\n"));
+}
+function buildConstraintsSection(policy) {
+    return tag("constraints", `Approval mode: ${policy.approval}\nSandbox: ${policy.sandbox}`);
+}
+function buildMemorySection(snapshot) {
+    if (!snapshot || snapshot.trim() === "")
+        return null;
+    return tag("memory", escapeXml(trimMemory(snapshot)));
+}
+function buildInstructionsSection(instructions) {
+    if (!instructions || instructions.trim() === "")
+        return null;
+    return tag("instructions", escapeXml(instructions));
+}
+function buildCompactionRecoverySection() {
+    return `<kiln-compaction-recovery>After any context compaction: 1) save a session summary using format Goal/Instructions/Discoveries/Accomplished/Next Steps/Relevant Files, 2) recall your memory context, then continue.</kiln-compaction-recovery>`;
+}
+export function buildPreamble(ctx, policy, agent) {
+    const shouldExcludeMemory = policy.fileGovernance?.excludeFromContext === true;
+    const renderedProjectedContext = shouldExcludeMemory
+        ? undefined
+        : renderProjectedContext(ctx.projectedContext);
+    const staticSections = [
+        agent ? buildRoleSection(agent) : null,
+        buildDomainSection(ctx.domain),
+        buildConstraintsSection(policy),
+        buildCompactionRecoverySection(),
+    ];
+    const dynamicSections = [
+        buildTaskSection(ctx.task),
+        buildMemorySection(renderedProjectedContext),
+        buildInstructionsSection(agent?.instructions),
+    ];
+    const parts = [
+        ...staticSections.filter((s) => s !== null),
+        PREAMBLE_CACHE_BOUNDARY,
+        ...dynamicSections.filter((s) => s !== null),
+    ];
+    if (ctx.isWorker) {
+        parts.push(`<kiln-fork-boilerplate>\nYou are a focused subagent. Complete the task above, emit your result, then stop. Do not ask for clarification. Do not loop. Output structured results as requested.\n</kiln-fork-boilerplate>`);
+    }
+    return tag("kiln-preamble", parts.join("\n"));
+}
+//# sourceMappingURL=preamble-builder.js.map

package/dist/wrapper/preamble-builder.js.map

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

package/dist/wrapper/provider-context.d.ts

@@ -0,0 +1,20 @@
+export interface ProviderContextTrackerConfig {
+    readonly maxContextTokens: number;
+    readonly compactionThreshold: number;
+    readonly initialTokens?: number;
+}
+export declare class ProviderContextTracker {
+    private totalTokensValue;
+    private readonly maxContextTokensValue;
+    private readonly compactionThresholdValue;
+    private readonly compactionThresholdTokensValue;
+    constructor(config: ProviderContextTrackerConfig);
+    get totalTokens(): number;
+    get maxContextTokens(): number;
+    get compactionThreshold(): number;
+    get compactionThresholdTokens(): number;
+    update(inputTokens?: number, outputTokens?: number): number;
+    shouldTriggerCompaction(pendingTokens?: number): boolean;
+    reset(tokens?: number): void;
+}
+//# sourceMappingURL=provider-context.d.ts.map

package/dist/wrapper/provider-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-context.d.ts","sourceRoot":"","sources":["../../src/wrapper/provider-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAoBD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAS;gBAE5C,MAAM,EAAE,4BAA4B;IAchD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED,IAAI,yBAAyB,IAAI,MAAM,CAEtC;IAED,MAAM,CAAC,WAAW,SAAI,EAAE,YAAY,SAAI,GAAG,MAAM;IAOjD,uBAAuB,CAAC,aAAa,SAAI,GAAG,OAAO;IAKnD,KAAK,CAAC,MAAM,SAAI,GAAG,IAAI;CAIxB"}

package/dist/wrapper/provider-context.js

@@ -0,0 +1,58 @@
+function assertNonNegativeInteger(value, label) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new RangeError(`${label} must be a non-negative integer`);
+    }
+}
+function assertPositiveInteger(value, label) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new RangeError(`${label} must be a positive integer`);
+    }
+}
+function assertUnitInterval(value, label) {
+    if (!Number.isFinite(value) || value <= 0 || value > 1) {
+        throw new RangeError(`${label} must be > 0 and <= 1`);
+    }
+}
+export class ProviderContextTracker {
+    totalTokensValue;
+    maxContextTokensValue;
+    compactionThresholdValue;
+    compactionThresholdTokensValue;
+    constructor(config) {
+        assertPositiveInteger(config.maxContextTokens, "maxContextTokens");
+        assertUnitInterval(config.compactionThreshold, "compactionThreshold");
+        const initialTokens = config.initialTokens ?? 0;
+        assertNonNegativeInteger(initialTokens, "initialTokens");
+        this.maxContextTokensValue = config.maxContextTokens;
+        this.compactionThresholdValue = config.compactionThreshold;
+        this.compactionThresholdTokensValue = Math.floor(this.maxContextTokensValue * this.compactionThresholdValue);
+        this.totalTokensValue = initialTokens;
+    }
+    get totalTokens() {
+        return this.totalTokensValue;
+    }
+    get maxContextTokens() {
+        return this.maxContextTokensValue;
+    }
+    get compactionThreshold() {
+        return this.compactionThresholdValue;
+    }
+    get compactionThresholdTokens() {
+        return this.compactionThresholdTokensValue;
+    }
+    update(inputTokens = 0, outputTokens = 0) {
+        assertNonNegativeInteger(inputTokens, "inputTokens");
+        assertNonNegativeInteger(outputTokens, "outputTokens");
+        this.totalTokensValue += inputTokens + outputTokens;
+        return this.totalTokensValue;
+    }
+    shouldTriggerCompaction(pendingTokens = 0) {
+        assertNonNegativeInteger(pendingTokens, "pendingTokens");
+        return this.totalTokensValue + pendingTokens >= this.compactionThresholdTokensValue;
+    }
+    reset(tokens = 0) {
+        assertNonNegativeInteger(tokens, "tokens");
+        this.totalTokensValue = tokens;
+    }
+}
+//# sourceMappingURL=provider-context.js.map

package/dist/wrapper/provider-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-context.js","sourceRoot":"","sources":["../../src/wrapper/provider-context.ts"],"names":[],"mappings":"AAMA,SAAS,wBAAwB,CAAC,KAAa,EAAE,KAAa;IAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,iCAAiC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,KAAa;IACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,uBAAuB,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,MAAM,OAAO,sBAAsB;IACzB,gBAAgB,CAAS;IAChB,qBAAqB,CAAS;IAC9B,wBAAwB,CAAS;IACjC,8BAA8B,CAAS;IAExD,YAAY,MAAoC;QAC9C,qBAAqB,CAAC,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QACnE,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;QACtE,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;QAChD,wBAAwB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QAEzD,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACrD,IAAI,CAAC,wBAAwB,GAAG,MAAM,CAAC,mBAAmB,CAAC;QAC3D,IAAI,CAAC,8BAA8B,GAAG,IAAI,CAAC,KAAK,CAC9C,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,CAC3D,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,aAAa,CAAC;IACxC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,wBAAwB,CAAC;IACvC,CAAC;IAED,IAAI,yBAAyB;QAC3B,OAAO,IAAI,CAAC,8BAA8B,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC;QACtC,wBAAwB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QACrD,wBAAwB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,gBAAgB,IAAI,WAAW,GAAG,YAAY,CAAC;QACpD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,uBAAuB,CAAC,aAAa,GAAG,CAAC;QACvC,wBAAwB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,gBAAgB,GAAG,aAAa,IAAI,IAAI,CAAC,8BAA8B,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;IACjC,CAAC;CACF"}

package/dist/wrapper/provider-session.d.ts

@@ -0,0 +1,27 @@
+import type { IKilnSession, KilnPermissionPolicy, SessionCapabilities, SessionEvent, SessionRunOptions } from "./session.js";
+export interface ProviderSessionConfig {
+    readonly provider: "anthropic" | "openai" | "deepseek" | "openrouter" | "ollama";
+    readonly model?: string;
+    readonly task: string;
+    readonly systemPrompt?: string;
+    readonly cwd?: string;
+    readonly env?: Record<string, string>;
+    readonly permissionPolicy: KilnPermissionPolicy;
+    readonly constraintInstructions?: readonly string[];
+}
+export declare class ProviderSession implements IKilnSession {
+    private readonly config;
+    readonly sessionId: string;
+    private readonly _capabilities;
+    private readonly contextTracker;
+    constructor(config: ProviderSessionConfig);
+    get capabilities(): SessionCapabilities;
+    get providerSessionId(): string | undefined;
+    run(options: SessionRunOptions): AsyncIterable<SessionEvent>;
+    dispose(): Promise<void>;
+    private resolveEnv;
+    private createAdapter;
+    private resolveRequiredApiKey;
+    private isStructuredPreamble;
+}
+//# sourceMappingURL=provider-session.d.ts.map

package/dist/wrapper/provider-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-session.d.ts","sourceRoot":"","sources":["../../src/wrapper/provider-session.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrD;AAUD,qBAAa,eAAgB,YAAW,YAAY;IAMtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE3B,MAAM,EAAE,qBAAqB;IAoB1D,IAAI,YAAY,IAAI,mBAAmB,CAEtC;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAEM,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,YAAY,CAAC;IAoI7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,oBAAoB;CAG7B"}

package/dist/wrapper/provider-session.js

@@ -0,0 +1,208 @@
+import { randomUUID } from "node:crypto";
+import { AnthropicAdapter, appendExecutionIdentity, OpenAIAdapter, DeepSeekAdapter, OpenRouterAdapter, OllamaAdapter, resolveExecutionIdentity, textPart, } from "@kilnai/core";
+import { buildProviderSystemPrompt } from "./preamble-builder.js";
+import { ProviderContextTracker } from "./provider-context.js";
+const PROVIDER_PRIORITY = {
+    anthropic: 4,
+    openai: 5,
+    openrouter: 6,
+    deepseek: 7,
+    ollama: 8,
+};
+export class ProviderSession {
+    config;
+    sessionId;
+    _capabilities;
+    contextTracker;
+    constructor(config) {
+        this.config = config;
+        this.sessionId = randomUUID();
+        this.contextTracker = new ProviderContextTracker({
+            maxContextTokens: 128000,
+            compactionThreshold: 0.85,
+        });
+        this._capabilities = {
+            mcp: false,
+            streaming: true,
+            resumable: false,
+            resume: false,
+            costTrackingMode: "computed",
+            supportedTools: [],
+            maxContextTokens: null,
+            priority: PROVIDER_PRIORITY[config.provider],
+            fallbackTo: null,
+            permissionPolicy: config.permissionPolicy,
+        };
+    }
+    get capabilities() {
+        return this._capabilities;
+    }
+    get providerSessionId() {
+        return undefined;
+    }
+    async *run(options) {
+        const startedAt = Date.now();
+        let isError = false;
+        if (options.abortSignal?.aborted) {
+            yield {
+                type: "error",
+                code: "ABORTED",
+                message: "Aborted before start",
+                isRetryable: false,
+            };
+            yield {
+                type: "completed",
+                totalUsd: 0,
+                durationMs: Date.now() - startedAt,
+                isError: true,
+                isPreflightCrash: true,
+            };
+            return;
+        }
+        try {
+            const adapter = this.createAdapter(options.env);
+            const hasStructuredPreamble = this.isStructuredPreamble(options.prompt);
+            const baseSystemPrompt = hasStructuredPreamble
+                ? options.prompt
+                : (this.config.systemPrompt ?? "");
+            const userPrompt = hasStructuredPreamble
+                ? this.config.task
+                : options.prompt;
+            const systemPrompt = appendExecutionIdentity(buildProviderSystemPrompt(baseSystemPrompt, this.config.constraintInstructions), resolveExecutionIdentity({
+                configuredProvider: this.config.provider,
+                configuredModel: this.config.model,
+            }));
+            const messages = [{
+                    role: "user",
+                    parts: [textPart(userPrompt)],
+                }];
+            for await (const event of adapter.streamMessage({
+                system: systemPrompt,
+                messages,
+            })) {
+                if (options.abortSignal?.aborted) {
+                    isError = true;
+                    yield {
+                        type: "error",
+                        code: "ABORTED",
+                        message: "Aborted during execution",
+                        isRetryable: false,
+                    };
+                    yield {
+                        type: "completed",
+                        totalUsd: 0,
+                        durationMs: Date.now() - startedAt,
+                        isError,
+                        isPreflightCrash: false,
+                    };
+                    return;
+                }
+                if (event.type === "thinking") {
+                    yield { type: "text_delta", content: event.content, isThinking: true };
+                    continue;
+                }
+                if (event.type === "text") {
+                    yield { type: "text_delta", content: event.content };
+                    continue;
+                }
+                if (event.type === "tool_use") {
+                    // Direct API providers are not wired to Kiln's executable tool substrate.
+                    // Surface provider content as text only; do not emit executable tool events.
+                    yield { type: "text_delta", content: event.content };
+                    continue;
+                }
+                if (event.type === "tool_result") {
+                    // Same rule as tool_use: no executable tool semantics for direct providers.
+                    yield { type: "text_delta", content: event.content };
+                    continue;
+                }
+                if (event.type === "done") {
+                    const doneEvent = event;
+                    const inputTokens = typeof doneEvent.inputTokens === "number" ? doneEvent.inputTokens : 0;
+                    const outputTokens = typeof doneEvent.outputTokens === "number" ? doneEvent.outputTokens : 0;
+                    this.contextTracker.update(inputTokens, outputTokens);
+                    yield { type: "cost_update", usd: 0, mode: "computed" };
+                    yield {
+                        type: "completed",
+                        totalUsd: 0,
+                        durationMs: Date.now() - startedAt,
+                        isError,
+                        isPreflightCrash: false,
+                    };
+                    return;
+                }
+            }
+            yield { type: "cost_update", usd: 0, mode: "computed" };
+            yield {
+                type: "completed",
+                totalUsd: 0,
+                durationMs: Date.now() - startedAt,
+                isError,
+                isPreflightCrash: false,
+            };
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                code: "PROVIDER_SESSION_ERROR",
+                message: err instanceof Error ? err.message : String(err),
+                isRetryable: false,
+            };
+            yield {
+                type: "completed",
+                totalUsd: 0,
+                durationMs: Date.now() - startedAt,
+                isError: true,
+                isPreflightCrash: false,
+            };
+        }
+    }
+    async dispose() {
+        // Stateless direct-provider session; no process/socket lifecycle to tear down.
+    }
+    resolveEnv(name, runtimeEnv) {
+        return runtimeEnv?.[name] ?? this.config.env?.[name] ?? process.env[name];
+    }
+    createAdapter(runtimeEnv) {
+        const provider = this.config.provider;
+        if (provider === "anthropic") {
+            const apiKey = this.resolveRequiredApiKey("ANTHROPIC_API_KEY", runtimeEnv);
+            return new AnthropicAdapter({ apiKey, defaultModel: this.config.model });
+        }
+        if (provider === "openai") {
+            const apiKey = this.resolveRequiredApiKey("OPENAI_API_KEY", runtimeEnv);
+            return new OpenAIAdapter({ apiKey, defaultModel: this.config.model });
+        }
+        if (provider === "deepseek") {
+            const apiKey = this.resolveRequiredApiKey("DEEPSEEK_API_KEY", runtimeEnv);
+            return new DeepSeekAdapter({ apiKey, defaultModel: this.config.model });
+        }
+        if (provider === "openrouter") {
+            const apiKey = this.resolveRequiredApiKey("OPENROUTER_API_KEY", runtimeEnv);
+            const appUrl = this.resolveEnv("OPENROUTER_APP_URL", runtimeEnv);
+            const appName = this.resolveEnv("OPENROUTER_APP_NAME", runtimeEnv);
+            return new OpenRouterAdapter({
+                apiKey,
+                defaultModel: this.config.model,
+                appUrl,
+                appName,
+            });
+        }
+        const baseUrl = this.resolveEnv("OLLAMA_BASE_URL", runtimeEnv);
+        return new OllamaAdapter({
+            baseUrl,
+            defaultModel: this.config.model,
+        });
+    }
+    resolveRequiredApiKey(name, runtimeEnv) {
+        const apiKey = this.resolveEnv(name, runtimeEnv);
+        if (!apiKey || apiKey.trim().length === 0) {
+            throw new Error(`Missing required API key: ${name}`);
+        }
+        return apiKey;
+    }
+    isStructuredPreamble(prompt) {
+        return prompt.trimStart().startsWith("<kiln-preamble>");
+    }
+}
+//# sourceMappingURL=provider-session.js.map

package/dist/wrapper/provider-session.js.map

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

package/dist/wrapper/session-manager.d.ts

@@ -1,5 +1,9 @@
-import type { WrapperConfig, SessionContext, SessionReport } from "./index.js";
+import type { ContextArtifactCache, QualityGate, VerificationResult } from "@kilnai/core";
+import type { ResumeFeedback, WrapperConfig, SessionContext, SessionReport } from "./index.js";
 import type { KilnAppConfig } from "../config.js";
+import type { PersistedSessionMeta } from "./session-store.js";
+import type { ProviderId } from "./session-registry.js";
+import type { WorktreeManager } from "./worktree-manager.js";
 /**
  * Manages the full session lifecycle: prepare -> cleanup.
  *
@@ -9,18 +13,31 @@ import type { KilnAppConfig } from "../config.js";
 export declare class SessionManager {
     private readonly wrapperConfig;
     private readonly appConfig;
+    private readonly contextArtifactCache;
+    private readonly worktreeManager?;
     private orchestrator;
     private domain;
     private sessionStartTime;
-    constructor(wrapperConfig: WrapperConfig, appConfig: KilnAppConfig);
+    private activeSessionId;
+    private costTurns;
+    private lastThreeOutputs;
+    private turnIndex;
+    get sessionStartTimeMs(): number | null;
+    constructor(wrapperConfig: WrapperConfig, appConfig: KilnAppConfig, contextArtifactCache: ContextArtifactCache, worktreeManager?: WorktreeManager);
     /**
      * Pre-session setup: detect domain, build system prompt, resolve MCP entry path.
      * Returns a SessionContext with all fields populated.
      */
-    prepare(task: string, projectPath: string, memorySnapshot?: string): SessionContext;
+    prepare(task: string, projectPath: string, memorySnapshot?: string, isolate?: boolean, resumeSessionId?: string, resumedMeta?: PersistedSessionMeta, preferredProvider?: ProviderId, resumeStrategyFeedback?: ResumeFeedback): Promise<SessionContext>;
     /**
      * Post-session cleanup: build report.
+     * @param totalCostUsd Cost reported directly from the session (ClaudeSession.total_cost_usd).
+     *                       Falls back to Orchestrator costSummary when session cost is unavailable.
      */
-    cleanup(sessionId: string): SessionReport;
+    cleanup(sessionId: string, totalCostUsd?: number, verificationResult?: VerificationResult, evalScore?: SessionReport["evalScore"]): SessionReport;
+    cleanupWorktree(context: SessionContext): Promise<void>;
+    trackCostUpdate(inputTokens: number, outputTokens: number, cacheReadTokens: number, costUsd: number): void;
+    resetCostTracking(): void;
+    runVerification(gates: readonly QualityGate[], cwd: string): Promise<VerificationResult>;
 }
 //# sourceMappingURL=session-manager.d.ts.map

package/dist/wrapper/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/wrapper/session-manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa;IAKlE;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc;IAiCnF;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;CAyB1C"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/wrapper/session-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAA2B,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEnH,OAAO,KAAK,EAAE,cAAc,EAAkB,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAclD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAwF7D;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAkB;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAMT;IACR,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,SAAS,CAAK;IAEtB,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;gBAGC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,aAAa,EACxB,oBAAoB,EAAE,oBAAoB,EAC1C,eAAe,CAAC,EAAE,eAAe;IAQnC;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,OAAO,EACjB,eAAe,CAAC,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE,oBAAoB,EAClC,iBAAiB,CAAC,EAAE,UAAU,EAC9B,sBAAsB,CAAC,EAAE,cAAc,GACtC,OAAO,CAAC,cAAc,CAAC;IAqF1B;;;;OAIG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,GACrC,aAAa;IA+BV,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,GACd,IAAI;IAqBP,iBAAiB,IAAI,IAAI;IAMnB,eAAe,CACnB,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,CAAC;CAY/B"}