pi-harness-runtime 0.10.12 → 0.10.13

package/packages/codex-adapter/dist/executor.js

@@ -0,0 +1,69 @@
+/**
+ * Codex Adapter — Execution Sandbox (RFC-0070)
+ */
+import { spawn } from "node:child_process";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Execute code in a sandboxed environment
+ */
+export class ExecutionSandbox {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            timeout: config.timeout ?? DEFAULT_TIMEOUT_MS,
+            memoryLimitMB: config.memoryLimitMB ?? 512,
+            cwd: config.cwd ?? process.cwd(),
+            env: config.env ?? {},
+        };
+    }
+    async execute(command) {
+        const start = Date.now();
+        return new Promise((resolve) => {
+            const proc = spawn(command, [], {
+                shell: true,
+                cwd: this.config.cwd,
+                env: { ...process.env, ...this.config.env },
+            });
+            let stdout = "";
+            let stderr = "";
+            proc.stdout?.on("data", (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr?.on("data", (data) => {
+                stderr += data.toString();
+            });
+            const timer = setTimeout(() => {
+                proc.kill("SIGKILL");
+            }, this.config.timeout);
+            proc.on("close", (code) => {
+                clearTimeout(timer);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: code ?? -1,
+                    durationMs: Date.now() - start,
+                });
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timer);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: -1,
+                    durationMs: Date.now() - start,
+                });
+            });
+        });
+    }
+    async executeCode(code, language) {
+        switch (language) {
+            case "python":
+                return this.execute(`python3 -c ${JSON.stringify(code)}`);
+            case "javascript":
+                return this.execute(`node -e ${JSON.stringify(code)}`);
+            case "bash":
+                return this.execute(code);
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/packages/codex-adapter/dist/executor.js.map

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

package/packages/codex-adapter/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Codex Adapter — Main Entry (RFC-0070)
+ */
+export { CodexProvider } from "./provider.js";
+export { ExecutionSandbox } from "./executor.js";
+export { DEFAULT_TOOLS } from "./types.js";
+export type { CodexConfig, CodexOptions, CodexResponse, CodexTool, ExecutionResult, ExecutionConfig, CodexModel, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/codex-adapter/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,eAAe,EACf,eAAe,EACf,UAAU,GACV,MAAM,YAAY,CAAC"}

package/packages/codex-adapter/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * Codex Adapter — Main Entry (RFC-0070)
+ */
+export { CodexProvider } from "./provider.js";
+export { ExecutionSandbox } from "./executor.js";
+export { DEFAULT_TOOLS } from "./types.js";
+//# sourceMappingURL=index.js.map

package/packages/codex-adapter/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/packages/codex-adapter/dist/provider.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Codex Adapter — Provider (RFC-0070)
+ */
+import type { CodexConfig, CodexOptions, CodexResponse } from "./types.js";
+import { DEFAULT_TOOLS } from "./types.js";
+export { DEFAULT_TOOLS };
+/**
+ * OpenAI Codex Provider for pi-harness
+ */
+export declare class CodexProvider {
+    readonly id = "codex";
+    readonly name = "OpenAI Codex";
+    readonly provider: {
+        complete: (prompt: string, options?: unknown) => Promise<CodexResponse>;
+        stream: undefined;
+        embed: undefined;
+    };
+    private apiKey;
+    private cfg;
+    constructor(config: CodexConfig);
+    complete(prompt: string, options?: CodexOptions): Promise<CodexResponse>;
+    stream(prompt: string, options?: CodexOptions): AsyncGenerator<string>;
+    healthCheck(): Promise<boolean>;
+    estimateCost(inputTokens: number, outputTokens: number): number;
+}
+//# sourceMappingURL=provider.d.ts.map

package/packages/codex-adapter/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;GAEG;AACH,qBAAa,aAAa;IACzB,QAAQ,CAAC,EAAE,WAAW;IACtB,QAAQ,CAAC,IAAI,kBAAkB;IAE/B,QAAQ,CAAC,QAAQ;QAChB,QAAQ,WAAW,MAAM,YAAY,OAAO;QAE5C,MAAM;QACN,KAAK;MACJ;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAwC;IAEnD,YAAY,MAAM,EAAE,WAAW,EAY9B;IAEK,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,aAAa,CAAC,CAuExB;IAEM,MAAM,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACpB,cAAc,CAAC,MAAM,CAAC,CAmExB;IAEK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAUpC;IAED,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAW9D;CACD"}

package/packages/codex-adapter/dist/provider.js

@@ -0,0 +1,170 @@
+/**
+ * Codex Adapter — Provider (RFC-0070)
+ */
+import { DEFAULT_TOOLS } from "./types.js";
+export { DEFAULT_TOOLS };
+/**
+ * OpenAI Codex Provider for pi-harness
+ */
+export class CodexProvider {
+    id = "codex";
+    name = "OpenAI Codex";
+    provider = {
+        complete: (prompt, options) => this.complete(prompt, options),
+        stream: undefined,
+        embed: undefined,
+    };
+    apiKey;
+    cfg;
+    constructor(config) {
+        if (!config.apiKey?.trim()) {
+            throw new Error("CodexProvider requires an API key");
+        }
+        this.apiKey = config.apiKey;
+        this.cfg = {
+            model: config.model ?? "gpt-4o",
+            baseUrl: config.baseUrl ?? "https://api.openai.com/v1",
+            maxTokens: config.maxTokens ?? 8192,
+            temperature: config.temperature ?? 0.7,
+            timeout: config.timeout ?? 60000,
+        };
+    }
+    async complete(prompt, options) {
+        const model = options?.model ?? this.cfg.model;
+        const maxTokens = options?.maxTokens ?? this.cfg.maxTokens;
+        const temperature = options?.temperature ?? this.cfg.temperature;
+        const tools = options?.tools ?? DEFAULT_TOOLS;
+        const body = {
+            model,
+            messages: [{ role: "user", content: prompt }],
+            max_tokens: maxTokens,
+            temperature,
+        };
+        if (tools.length > 0) {
+            body.tools = tools;
+            body.tool_choice = options?.toolChoice ?? "auto";
+        }
+        const response = await fetch(`${this.cfg.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(this.cfg.timeout),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`OpenAI API error ${response.status}: ${text}`);
+        }
+        const data = (await response.json());
+        const choice = data.choices[0];
+        let content = choice.message.content ?? "";
+        if (choice.message.tool_calls && choice.message.tool_calls.length > 0) {
+            content +=
+                "\n\n[Tool calls: " +
+                    choice.message.tool_calls
+                        .map((tc) => `${tc.function.name}(${tc.function.arguments})`)
+                        .join(", ") +
+                    "]";
+        }
+        return {
+            content,
+            finishReason: choice.finish_reason,
+            usage: data.usage
+                ? {
+                    inputTokens: data.usage.prompt_tokens,
+                    outputTokens: data.usage.completion_tokens,
+                    totalTokens: data.usage.total_tokens,
+                }
+                : undefined,
+        };
+    }
+    async *stream(prompt, options) {
+        const model = options?.model ?? this.cfg.model;
+        const maxTokens = options?.maxTokens ?? this.cfg.maxTokens;
+        const temperature = options?.temperature ?? this.cfg.temperature;
+        const tools = options?.tools ?? DEFAULT_TOOLS;
+        const body = {
+            model,
+            messages: [{ role: "user", content: prompt }],
+            max_tokens: maxTokens,
+            temperature,
+            stream: true,
+        };
+        if (tools.length > 0) {
+            body.tools = tools;
+            body.tool_choice = options?.toolChoice ?? "auto";
+        }
+        const response = await fetch(`${this.cfg.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(this.cfg.timeout),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`OpenAI API error ${response.status}: ${text}`);
+        }
+        if (!response.body)
+            throw new Error("No response body");
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (line.startsWith("data: ")) {
+                        const raw = line.slice(6);
+                        if (raw === "[DONE]")
+                            continue;
+                        try {
+                            const chunk = JSON.parse(raw);
+                            if (chunk.choices[0]?.delta?.content) {
+                                yield chunk.choices[0].delta.content;
+                            }
+                        }
+                        catch {
+                            // ignore parse errors
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async healthCheck() {
+        try {
+            const response = await fetch(`${this.cfg.baseUrl}/models`, {
+                headers: { Authorization: `Bearer ${this.apiKey}` },
+                signal: AbortSignal.timeout(10000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    estimateCost(inputTokens, outputTokens) {
+        const pricing = {
+            "gpt-4o": { input: 2.5, output: 10.0 },
+            o3: { input: 10.0, output: 40.0 },
+            "o4-mini": { input: 1.0, output: 4.0 },
+        };
+        const p = pricing[this.cfg.model] ?? pricing["gpt-4o"];
+        return ((inputTokens / 1_000_000) * p.input +
+            (outputTokens / 1_000_000) * p.output);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/packages/codex-adapter/dist/provider.js.map

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

package/packages/codex-adapter/dist/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Codex Adapter — Types (RFC-0070)
+ */
+export type CodexModel = "gpt-4o" | "o3" | "o4-mini";
+export interface CodexConfig {
+    apiKey: string;
+    model?: CodexModel;
+    baseUrl?: string;
+    maxTokens?: number;
+    temperature?: number;
+    timeout?: number;
+}
+export interface CodexOptions {
+    model?: CodexModel;
+    maxTokens?: number;
+    temperature?: number;
+    tools?: CodexTool[];
+    toolChoice?: "auto" | "none";
+}
+export interface CodexTool {
+    type: "function";
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface CodexResponse {
+    content: string;
+    finishReason: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+}
+export interface ExecutionResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+}
+export interface ExecutionConfig {
+    timeout?: number;
+    memoryLimitMB?: number;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export declare const DEFAULT_TOOLS: CodexTool[];
+//# sourceMappingURL=types.d.ts.map

package/packages/codex-adapter/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACF;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACpB,CAAC;CACF;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAGD,eAAO,MAAM,aAAa,EAAE,SAAS,EA0DpC,CAAC"}

package/packages/codex-adapter/dist/types.js

@@ -0,0 +1,64 @@
+/**
+ * Codex Adapter — Types (RFC-0070)
+ */
+// Default Codex tools
+export const DEFAULT_TOOLS = [
+    {
+        type: "function",
+        name: "Read",
+        description: "Read the complete contents of a file from the filesystem",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Absolute path to the file" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        type: "function",
+        name: "Write",
+        description: "Write content to a file, creating directories if needed",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Absolute path to write to" },
+                content: { type: "string", description: "Content to write" },
+            },
+            required: ["path", "content"],
+        },
+    },
+    {
+        type: "function",
+        name: "Bash",
+        description: "Execute a shell command in a sandboxed environment",
+        parameters: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "Shell command to execute" },
+                timeout: {
+                    type: "number",
+                    description: "Max execution time in seconds",
+                },
+            },
+            required: ["command"],
+        },
+    },
+    {
+        type: "function",
+        name: "WebSearch",
+        description: "Search the web for information",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                max_results: {
+                    type: "number",
+                    description: "Max results (default: 5)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+];
+//# sourceMappingURL=types.js.map

package/packages/codex-adapter/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwDH,sBAAsB;AACtB,MAAM,CAAC,MAAM,aAAa,GAAgB;IACzC;QACC,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0DAA0D;QACvE,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SAClB;KACD;IACD;QACC,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,yDAAyD;QACtE,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBAClE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;aAC5D;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC7B;KACD;IACD;QACC,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;gBACpE,OAAO,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC5C;aACD;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACrB;KACD;IACD;QACC,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gCAAgC;QAC7C,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;gBACtD,WAAW,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACvC;aACD;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACnB;KACD;CACD,CAAC"}

package/packages/context-compiler/dist/budget.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Context Compiler - Token Budget Fitting
+ *
+ * Fits optional candidates into the available token budget.
+ * Required candidates always fit first.
+ * Uses the RFC-0041 character-based estimation (1 token ≈ 4 characters).
+ */
+import type { CompiledContextItem, ContextCandidate, OmittedItem } from "./types.js";
+/**
+ * Result of budget fitting.
+ */
+export interface BudgetFitResult {
+    included: ContextCandidate[];
+    omitted: OmittedItem[];
+    estimatedTokens: number;
+}
+/**
+ * Estimate tokens from content using 4 chars/token approximation.
+ */
+export declare function estimateTokens(content: string): number;
+/**
+ * Fit candidates into the token budget.
+ *
+ * Algorithm:
+ * 1. Always include required candidates
+ * 2. Sort optional by score (descending)
+ * 3. Greedily add optional until budget exhausted
+ * 4. Record all omitted with reason "budget"
+ *
+ * @param candidates - Ranked candidates (highest score first)
+ * @param maximumTokens - Available budget
+ * @returns Candidates to include and items to omit
+ */
+export declare function fitToBudget(candidates: Array<{
+    candidate: ContextCandidate;
+    score: number;
+}>, maximumTokens: number): BudgetFitResult;
+/**
+ * Convert included candidates to compiled items.
+ */
+export declare function toCompiledItems(candidates: ContextCandidate[]): CompiledContextItem[];
+//# sourceMappingURL=budget.d.ts.map

package/packages/context-compiler/dist/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAC1B,UAAU,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACjE,aAAa,EAAE,MAAM,GACnB,eAAe,CAmDjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,gBAAgB,EAAE,GAC5B,mBAAmB,EAAE,CAgBvB"}

package/packages/context-compiler/dist/budget.js

@@ -0,0 +1,94 @@
+/**
+ * Context Compiler - Token Budget Fitting
+ *
+ * Fits optional candidates into the available token budget.
+ * Required candidates always fit first.
+ * Uses the RFC-0041 character-based estimation (1 token ≈ 4 characters).
+ */
+/**
+ * Estimate tokens from content using 4 chars/token approximation.
+ */
+export function estimateTokens(content) {
+    if (!content || content.trim() === "")
+        return 0;
+    return Math.ceil(content.length / 4);
+}
+/**
+ * Fit candidates into the token budget.
+ *
+ * Algorithm:
+ * 1. Always include required candidates
+ * 2. Sort optional by score (descending)
+ * 3. Greedily add optional until budget exhausted
+ * 4. Record all omitted with reason "budget"
+ *
+ * @param candidates - Ranked candidates (highest score first)
+ * @param maximumTokens - Available budget
+ * @returns Candidates to include and items to omit
+ */
+export function fitToBudget(candidates, maximumTokens) {
+    const included = [];
+    const omitted = [];
+    let usedTokens = 0;
+    for (const { candidate } of candidates) {
+        const tokens = estimateTokens(candidate.content);
+        // Optional items with no content are omitted (broken/unavailable)
+        if (!candidate.required &&
+            (!candidate.content || candidate.content.trim() === "")) {
+            omitted.push({
+                id: candidate.id,
+                kind: candidate.kind,
+                reason: "source_unavailable",
+                reasonDetail: "no content",
+                estimatedTokens: 0,
+            });
+            continue;
+        }
+        if (candidate.required) {
+            // Required: always include
+            included.push(candidate);
+            usedTokens += tokens;
+            continue;
+        }
+        // Optional: check budget
+        if (usedTokens + tokens <= maximumTokens) {
+            included.push(candidate);
+            usedTokens += tokens;
+        }
+        else {
+            omitted.push({
+                id: candidate.id,
+                kind: candidate.kind,
+                reason: "budget",
+                reasonDetail: `estimated ${tokens} tokens, only ${maximumTokens - usedTokens} remaining`,
+                estimatedTokens: tokens,
+            });
+        }
+    }
+    return {
+        included,
+        omitted,
+        estimatedTokens: usedTokens,
+    };
+}
+/**
+ * Convert included candidates to compiled items.
+ */
+export function toCompiledItems(candidates) {
+    return candidates.map((c) => ({
+        id: c.id,
+        kind: c.kind,
+        content: c.content,
+        source: c.source,
+        priority: c.priority,
+        required: c.required,
+        trust: c.trust,
+        estimatedTokens: estimateTokens(c.content),
+        contentHash: c.contentHash,
+        filePath: c.filePath,
+        startLine: c.startLine,
+        endLine: c.endLine,
+        symbols: c.symbols,
+    }));
+}
+//# sourceMappingURL=budget.js.map

package/packages/context-compiler/dist/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAC1B,UAAiE,EACjE,aAAqB;IAErB,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjD,kEAAkE;QAClE,IACC,CAAC,SAAS,CAAC,QAAQ;YACnB,CAAC,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EACtD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM,EAAE,oBAAoB;gBAC5B,YAAY,EAAE,YAAY;gBAC1B,eAAe,EAAE,CAAC;aAClB,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxB,2BAA2B;YAC3B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,UAAU,IAAI,MAAM,CAAC;YACrB,SAAS;QACV,CAAC;QAED,yBAAyB;QACzB,IAAI,UAAU,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,UAAU,IAAI,MAAM,CAAC;QACtB,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,aAAa,MAAM,iBAAiB,aAAa,GAAG,UAAU,YAAY;gBACxF,eAAe,EAAE,MAAM;aACvB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO;QACN,QAAQ;QACR,OAAO;QACP,eAAe,EAAE,UAAU;KAC3B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,UAA8B;IAE9B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1C,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;KAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/context-compiler/dist/cache.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Context Compiler - Cache & Invalidation
+ *
+ * Generates deterministic cache keys from selected source hashes.
+ * Tracks invalidation triggers.
+ */
+import type { CompiledContext, CompiledContextItem, ContextInvalidation } from "./types.js";
+/**
+ * Generate a deterministic cache key from compiled context items.
+ * Includes source file hashes for content invalidation.
+ */
+export declare function generateCacheKey(taskId: string, items: CompiledContextItem[], taskObjective: string): string;
+/**
+ * Check if a compiled context should be invalidated.
+ *
+ * Invalidation triggers:
+ * - A selected source file hash changed
+ * - A project rule changed
+ * - A required OKF concept changed
+ * - The task objective changed
+ * - A test failure superseded an old one
+ * - Worktree branch/HEAD changed
+ */
+export declare function shouldInvalidate(previous: CompiledContext, invalidation: ContextInvalidation, currentItemHashes: Map<string, string>): boolean;
+/**
+ * Generate current item hashes from a compiled context.
+ */
+export declare function extractItemHashes(items: CompiledContextItem[]): Map<string, string>;
+/**
+ * Simple deterministic hash for strings.
+ * Used for cache keys when crypto is unavailable.
+ */
+export declare function simpleHash(text: string): string;
+//# sourceMappingURL=cache.d.ts.map

package/packages/context-compiler/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,EAAE,EAC5B,aAAa,EAAE,MAAM,GACnB,MAAM,CAWR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,mBAAmB,EACjC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAuDT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,mBAAmB,EAAE,GAC1B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C"}