@almightygpt/core 0.2.0

package/dist/adapters/claude.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Anthropic / Claude adapter — second real provider in MVP 1.
+ *
+ * Reads ANTHROPIC_API_KEY from the environment. Never stores or logs the key.
+ * Default model: claude-3-5-sonnet-latest (best Worker default; strong on
+ * code reasoning, fast enough for interactive use).
+ *
+ * Pricing (USD per 1M tokens, as of 2026-05):
+ *   claude-3-5-sonnet:  3.00 in / 15.00 out
+ *   claude-3-5-haiku:   0.80 in / 4.00 out
+ *   claude-3-opus:     15.00 in / 75.00 out
+ */
+import { type Adapter, type AdapterInput, type AdapterOutput } from "./types.js";
+export interface ClaudeAdapterOptions {
+    apiKey?: string;
+    defaultModel?: string;
+    defaultMaxOutputTokens?: number;
+    defaultTimeoutMs?: number;
+}
+export declare class ClaudeAdapter implements Adapter {
+    readonly name: string;
+    readonly provider = "anthropic";
+    private readonly client;
+    private readonly defaultModel;
+    private readonly defaultMaxOutputTokens;
+    private readonly defaultTimeoutMs;
+    constructor(name?: string, options?: ClaudeAdapterOptions);
+    isAvailable(): Promise<boolean>;
+    execute(input: AdapterInput): Promise<AdapterOutput>;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,IAAI,SAAW,EAAE,OAAO,GAAE,oBAAyB;IAUzD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CA2D3D"}

package/dist/adapters/claude.js

@@ -0,0 +1,90 @@
+/**
+ * Anthropic / Claude adapter — second real provider in MVP 1.
+ *
+ * Reads ANTHROPIC_API_KEY from the environment. Never stores or logs the key.
+ * Default model: claude-3-5-sonnet-latest (best Worker default; strong on
+ * code reasoning, fast enough for interactive use).
+ *
+ * Pricing (USD per 1M tokens, as of 2026-05):
+ *   claude-3-5-sonnet:  3.00 in / 15.00 out
+ *   claude-3-5-haiku:   0.80 in / 4.00 out
+ *   claude-3-opus:     15.00 in / 75.00 out
+ */
+import Anthropic from "@anthropic-ai/sdk";
+import { AdapterError, } from "./types.js";
+const PRICING_USD_PER_1M = {
+    "claude-3-5-sonnet": { input: 3.0, output: 15.0 },
+    "claude-3-5-haiku": { input: 0.8, output: 4.0 },
+    "claude-3-opus": { input: 15.0, output: 75.0 },
+};
+const DEFAULT_MODEL = "claude-3-5-sonnet-latest";
+export class ClaudeAdapter {
+    name;
+    provider = "anthropic";
+    client;
+    defaultModel;
+    defaultMaxOutputTokens;
+    defaultTimeoutMs;
+    constructor(name = "claude", options = {}) {
+        this.name = name;
+        this.defaultModel = options.defaultModel ?? DEFAULT_MODEL;
+        this.defaultMaxOutputTokens = options.defaultMaxOutputTokens ?? 4096;
+        this.defaultTimeoutMs = options.defaultTimeoutMs ?? 120_000;
+        const apiKey = options.apiKey ?? process.env["ANTHROPIC_API_KEY"];
+        this.client = apiKey ? new Anthropic({ apiKey }) : null;
+    }
+    async isAvailable() {
+        return this.client !== null;
+    }
+    async execute(input) {
+        if (!this.client) {
+            throw new AdapterError("ANTHROPIC_API_KEY is not set. Export it in your environment.", this.name);
+        }
+        const model = input.model ?? this.defaultModel;
+        const maxOutputTokens = input.maxOutputTokens ?? this.defaultMaxOutputTokens;
+        const timeoutMs = input.timeoutMs ?? this.defaultTimeoutMs;
+        const start = Date.now();
+        let response;
+        try {
+            response = await this.client.messages.create({
+                model,
+                max_tokens: maxOutputTokens,
+                system: input.systemPrompt,
+                messages: [{ role: "user", content: input.userMessage }],
+            }, { timeout: timeoutMs });
+        }
+        catch (err) {
+            throw new AdapterError(`Anthropic call failed: ${err instanceof Error ? err.message : String(err)}`, this.name, err);
+        }
+        // Anthropic returns content as a typed array; we want text blocks only.
+        const content = response.content
+            .filter((block) => block.type === "text")
+            .map((b) => b.text)
+            .join("\n");
+        if (!content) {
+            throw new AdapterError("Anthropic returned no text content (tool-use or empty response).", this.name);
+        }
+        const tokensIn = response.usage.input_tokens;
+        const tokensOut = response.usage.output_tokens;
+        const costUsd = estimateCostUsd(model, tokensIn, tokensOut);
+        return {
+            content,
+            tokensIn,
+            tokensOut,
+            costUsd,
+            latencyMs: Date.now() - start,
+            modelUsed: response.model,
+            provider: this.provider,
+        };
+    }
+}
+function estimateCostUsd(model, tokensIn, tokensOut) {
+    const key = Object.keys(PRICING_USD_PER_1M).find((k) => model.toLowerCase().startsWith(k));
+    if (!key)
+        return 0;
+    const rates = PRICING_USD_PER_1M[key];
+    if (!rates)
+        return 0;
+    return (tokensIn / 1_000_000) * rates.input + (tokensOut / 1_000_000) * rates.output;
+}
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

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

package/dist/adapters/gemini.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Google / Gemini adapter — third real provider.
+ *
+ * Reads GOOGLE_API_KEY (or GEMINI_API_KEY as a fallback) from the
+ * environment. Never stores or logs the key.
+ *
+ * Default model: gemini-2.5-pro. Configurable per-call. Earlier
+ * gemini-1.5-* models have been retired from the v1beta API as of
+ * late 2025/early 2026.
+ *
+ * Pricing (USD per 1M tokens, approximate as of 2026-05):
+ *   gemini-2.5-pro:    1.25 in / 10.00 out
+ *   gemini-2.5-flash:  0.30 in / 2.50 out
+ *   gemini-2.0-flash:  0.10 in / 0.40 out
+ *   gemini-3.x-*:      pricing TBD — falls back to conservative defaults
+ *
+ * Pricing changes frequently — verify at ai.google.dev/pricing if cost
+ * accuracy matters for a given run.
+ *
+ * Note on system prompts: the @google/generative-ai SDK accepts a
+ * `systemInstruction` field on getGenerativeModel(). We use that
+ * instead of stitching system text into the user message.
+ */
+import { type Adapter, type AdapterInput, type AdapterOutput } from "./types.js";
+export interface GeminiAdapterOptions {
+    apiKey?: string;
+    defaultModel?: string;
+    defaultMaxOutputTokens?: number;
+    defaultTimeoutMs?: number;
+}
+export declare class GeminiAdapter implements Adapter {
+    readonly name: string;
+    readonly provider = "google";
+    private readonly client;
+    private readonly defaultModel;
+    private readonly defaultMaxOutputTokens;
+    private readonly defaultTimeoutMs;
+    constructor(name?: string, options?: GeminiAdapterOptions);
+    isAvailable(): Promise<boolean>;
+    execute(input: AdapterInput): Promise<AdapterOutput>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/adapters/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAmBpB,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,IAAI,SAAW,EAAE,OAAO,GAAE,oBAAyB;IAkBzD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAiF3D"}

package/dist/adapters/gemini.js

@@ -0,0 +1,133 @@
+/**
+ * Google / Gemini adapter — third real provider.
+ *
+ * Reads GOOGLE_API_KEY (or GEMINI_API_KEY as a fallback) from the
+ * environment. Never stores or logs the key.
+ *
+ * Default model: gemini-2.5-pro. Configurable per-call. Earlier
+ * gemini-1.5-* models have been retired from the v1beta API as of
+ * late 2025/early 2026.
+ *
+ * Pricing (USD per 1M tokens, approximate as of 2026-05):
+ *   gemini-2.5-pro:    1.25 in / 10.00 out
+ *   gemini-2.5-flash:  0.30 in / 2.50 out
+ *   gemini-2.0-flash:  0.10 in / 0.40 out
+ *   gemini-3.x-*:      pricing TBD — falls back to conservative defaults
+ *
+ * Pricing changes frequently — verify at ai.google.dev/pricing if cost
+ * accuracy matters for a given run.
+ *
+ * Note on system prompts: the @google/generative-ai SDK accepts a
+ * `systemInstruction` field on getGenerativeModel(). We use that
+ * instead of stitching system text into the user message.
+ */
+import { GoogleGenerativeAI } from "@google/generative-ai";
+import { AdapterError, } from "./types.js";
+const PRICING_USD_PER_1M = {
+    "gemini-2.5-pro": { input: 1.25, output: 10.0 },
+    "gemini-2.5-flash": { input: 0.3, output: 2.5 },
+    "gemini-2.0-flash": { input: 0.1, output: 0.4 },
+    // Older models kept for reproducibility on saved runs:
+    "gemini-1.5-pro": { input: 1.25, output: 5.0 },
+    "gemini-1.5-flash": { input: 0.075, output: 0.3 },
+};
+// Defaulting to flash, not pro, because Google's free tier typically has
+// zero quota on the pro models but allows real usage on flash. Users with
+// paid billing can override via the `model` field in config.yaml (when that
+// field lands in v0.3) or by constructing the adapter directly. For code
+// review of typical-sized diffs, flash quality is sufficient — pro pays for
+// itself only on very large diffs or complex reasoning chains.
+const DEFAULT_MODEL = "gemini-2.5-flash";
+export class GeminiAdapter {
+    name;
+    provider = "google";
+    client;
+    defaultModel;
+    defaultMaxOutputTokens;
+    defaultTimeoutMs;
+    constructor(name = "gemini", options = {}) {
+        this.name = name;
+        this.defaultModel = options.defaultModel ?? DEFAULT_MODEL;
+        // Bigger than other adapters by design: gemini-2.5-* spends a portion
+        // of the output budget on internal "thinking" tokens before producing
+        // visible output. 8192 leaves ~4-6k for the actual response after the
+        // model finishes its reasoning. We also disable thinking explicitly
+        // below to make sure the visible response gets the full budget.
+        this.defaultMaxOutputTokens = options.defaultMaxOutputTokens ?? 8192;
+        this.defaultTimeoutMs = options.defaultTimeoutMs ?? 120_000;
+        const apiKey = options.apiKey ??
+            process.env["GOOGLE_API_KEY"] ??
+            process.env["GEMINI_API_KEY"];
+        this.client = apiKey ? new GoogleGenerativeAI(apiKey) : null;
+    }
+    async isAvailable() {
+        return this.client !== null;
+    }
+    async execute(input) {
+        if (!this.client) {
+            throw new AdapterError("GOOGLE_API_KEY (or GEMINI_API_KEY) is not set. " +
+                "Export one in your environment.", this.name);
+        }
+        const model = input.model ?? this.defaultModel;
+        const maxOutputTokens = input.maxOutputTokens ?? this.defaultMaxOutputTokens;
+        const timeoutMs = input.timeoutMs ?? this.defaultTimeoutMs;
+        // gemini-2.5-* "thinks" before responding. Without an explicit cap the
+        // model can consume most/all of maxOutputTokens on internal reasoning
+        // tokens, leaving the user-facing response truncated mid-sentence. We
+        // pass thinkingConfig via a type-relaxed cast because @google/generative-ai
+        // 0.21 doesn't declare it on GenerationConfig yet, but the v1beta REST
+        // API accepts it.
+        const generationConfig = {
+            maxOutputTokens,
+            thinkingConfig: { thinkingBudget: 0 },
+        };
+        if (input.responseFormat === "json_object") {
+            generationConfig["responseMimeType"] = "application/json";
+        }
+        const generative = this.client.getGenerativeModel({
+            model,
+            systemInstruction: input.systemPrompt,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            generationConfig: generationConfig,
+        });
+        const start = Date.now();
+        let response;
+        try {
+            // The SDK doesn't expose a per-call timeout option, so we race manually.
+            response = await Promise.race([
+                generative.generateContent(input.userMessage),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Gemini call exceeded timeout of ${timeoutMs}ms`)), timeoutMs)),
+            ]);
+        }
+        catch (err) {
+            throw new AdapterError(`Gemini call failed: ${err instanceof Error ? err.message : String(err)}`, this.name, err);
+        }
+        const content = response.response.text();
+        if (!content) {
+            throw new AdapterError("Gemini returned no text content (filtered, empty, or tool-only response).", this.name);
+        }
+        const usage = response.response.usageMetadata;
+        const tokensIn = usage?.promptTokenCount ?? 0;
+        const tokensOut = usage?.candidatesTokenCount ?? 0;
+        const costUsd = estimateCostUsd(model, tokensIn, tokensOut);
+        return {
+            content,
+            tokensIn,
+            tokensOut,
+            costUsd,
+            latencyMs: Date.now() - start,
+            modelUsed: model,
+            provider: this.provider,
+        };
+    }
+}
+function estimateCostUsd(model, tokensIn, tokensOut) {
+    const key = Object.keys(PRICING_USD_PER_1M).find((k) => model.toLowerCase().startsWith(k));
+    if (!key)
+        return 0;
+    const rates = PRICING_USD_PER_1M[key];
+    if (!rates)
+        return 0;
+    return (tokensIn / 1_000_000) * rates.input + (tokensOut / 1_000_000) * rates.output;
+}
+//# sourceMappingURL=gemini.js.map

package/dist/adapters/gemini.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Adapter exports.
+ *
+ * Add new adapters here as they're implemented:
+ *   - Claude (Anthropic) — task #15
+ *   - Gemini — post-MVP 1
+ *   - OpenRouter — post-MVP 1 (for cost-conscious users; see
+ *     docs/claude/competitor-ai-council.md)
+ */
+export type { Adapter, AdapterInput, AdapterOutput, AgentRole, } from "./types.js";
+export { AdapterError } from "./types.js";
+export { MockAdapter } from "./mock.js";
+export { OpenAIAdapter, type OpenAIAdapterOptions } from "./openai.js";
+export { ClaudeAdapter, type ClaudeAdapterOptions } from "./claude.js";
+export { GeminiAdapter, type GeminiAdapterOptions } from "./gemini.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,15 @@
+/**
+ * Adapter exports.
+ *
+ * Add new adapters here as they're implemented:
+ *   - Claude (Anthropic) — task #15
+ *   - Gemini — post-MVP 1
+ *   - OpenRouter — post-MVP 1 (for cost-conscious users; see
+ *     docs/claude/competitor-ai-council.md)
+ */
+export { AdapterError } from "./types.js";
+export { MockAdapter } from "./mock.js";
+export { OpenAIAdapter } from "./openai.js";
+export { ClaudeAdapter } from "./claude.js";
+export { GeminiAdapter } from "./gemini.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC"}

package/dist/adapters/mock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Mock adapter — produces deterministic, realistic-shaped output without
+ * calling any external API. Used for end-to-end testing, demos without
+ * API keys, and to exercise the review pipeline in CI.
+ *
+ * The mock is deliberately "good enough to look real" so we can spot
+ * format problems. It is not a substitute for real model output.
+ */
+import type { Adapter, AdapterInput, AdapterOutput } from "./types.js";
+export declare class MockAdapter implements Adapter {
+    private readonly opts;
+    readonly name = "mock";
+    readonly provider = "mock";
+    constructor(opts?: {
+        /** Optional simulated latency in ms. Default 50. */
+        latencyMs?: number;
+    });
+    isAvailable(): Promise<boolean>;
+    execute(input: AdapterInput): Promise<AdapterOutput>;
+    private mockReview;
+    private mockWork;
+}
+//# sourceMappingURL=mock.d.ts.map

package/dist/adapters/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/adapters/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,qBAAa,WAAY,YAAW,OAAO;IAKvC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,QAAQ,UAAU;gBAGR,IAAI,GAAE;QACrB,oDAAoD;QACpD,SAAS,CAAC,EAAE,MAAM,CAAC;KACf;IAGF,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4B1D,OAAO,CAAC,UAAU;IAqDlB,OAAO,CAAC,QAAQ;CAiBjB"}

package/dist/adapters/mock.js

@@ -0,0 +1,107 @@
+/**
+ * Mock adapter — produces deterministic, realistic-shaped output without
+ * calling any external API. Used for end-to-end testing, demos without
+ * API keys, and to exercise the review pipeline in CI.
+ *
+ * The mock is deliberately "good enough to look real" so we can spot
+ * format problems. It is not a substitute for real model output.
+ */
+export class MockAdapter {
+    opts;
+    name = "mock";
+    provider = "mock";
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async isAvailable() {
+        return true;
+    }
+    async execute(input) {
+        const start = Date.now();
+        const latency = this.opts.latencyMs ?? 50;
+        await new Promise((r) => setTimeout(r, latency));
+        const content = input.role === "reviewer"
+            ? this.mockReview(input.userMessage)
+            : this.mockWork(input.userMessage);
+        // Token counts are rough — 4 chars/token heuristic. Cost is always 0
+        // because the mock never bills anyone.
+        const tokensIn = Math.ceil((input.systemPrompt.length + input.userMessage.length) / 4);
+        const tokensOut = Math.ceil(content.length / 4);
+        return {
+            content,
+            tokensIn,
+            tokensOut,
+            costUsd: 0,
+            latencyMs: Date.now() - start,
+            modelUsed: "mock-1",
+            provider: "mock",
+        };
+    }
+    mockReview(userMessage) {
+        // Extract any file paths the user mentioned to make the mock look at-the-code.
+        const fileHints = Array.from(userMessage.matchAll(/[\w./-]+\.(ts|js|tsx|jsx|py|go|rb|md|json|yaml)/g))
+            .slice(0, 3)
+            .map((m) => m[0]);
+        const refs = fileHints.length
+            ? fileHints
+            : ["src/index.ts", "src/lib/foo.ts", "src/utils/bar.ts"];
+        return [
+            "## Decision Required",
+            "Needs changes before merge. Three concrete issues identified.",
+            "",
+            "## Highest-Risk Findings",
+            "",
+            `### 1. (mock) Missing input validation in ${refs[0]}`,
+            "**Severity:** High",
+            "**Where:** entry point of the diff",
+            "**Why:** Untrusted input flows into a parser without bounds checks.",
+            "**Suggested fix:** Add a Zod schema at the boundary; reject malformed input early.",
+            "",
+            `### 2. (mock) Unhandled rejection in ${refs[1] ?? refs[0]}`,
+            "**Severity:** Medium",
+            "**Where:** the awaited call without try/catch",
+            "**Why:** A network failure here will surface as an uncaught promise rejection.",
+            "**Suggested fix:** Wrap in try/catch, log to the audit channel, return a typed error.",
+            "",
+            `### 3. (mock) Missing test coverage on ${refs[2] ?? refs[0]}`,
+            "**Severity:** Medium",
+            "**Where:** the branch added in this diff",
+            "**Why:** The new conditional has no exercise in the test suite.",
+            "**Suggested fix:** Add a unit test that exercises the new branch with a representative payload.",
+            "",
+            "## Concrete Weaknesses",
+            `1. ${refs[0]}: input validation gap (see Finding 1).`,
+            `2. ${refs[1] ?? refs[0]}: unhandled promise rejection (see Finding 2).`,
+            `3. ${refs[2] ?? refs[0]}: no test coverage for the new branch (see Finding 3).`,
+            "",
+            "## Test Plan",
+            "- Run the existing unit suite; expect no regressions.",
+            "- Add the test described in Finding 3 and verify it fails before fix, passes after.",
+            "- Manually trigger the network-error path described in Finding 2.",
+            "",
+            "## Human Decision",
+            "_(blank — record via `almightygpt decide`)_",
+            "",
+            "---",
+            "_Mock adapter output — no real model was invoked. Replace `--reviewer mock` with `--reviewer codex` or another real adapter for production review._",
+        ].join("\n");
+    }
+    mockWork(userMessage) {
+        return [
+            "## Plan",
+            "1. Understand the change requested.",
+            "2. Identify affected files and surfaces.",
+            "3. Write the implementation in small, testable steps.",
+            "4. Add or update tests.",
+            "5. Verify locally.",
+            "",
+            "## Notes",
+            "_(mock worker output — real Worker adapters produce code or detailed plans here.)_",
+            "",
+            `## Echo of input (first 200 chars):`,
+            "",
+            "> " + userMessage.slice(0, 200) + (userMessage.length > 200 ? "…" : ""),
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=mock.js.map

package/dist/adapters/mock.js.map

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

package/dist/adapters/openai.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OpenAI adapter — first real provider in MVP 1.
+ *
+ * Reads OPENAI_API_KEY from the environment. Never stores or logs the key.
+ * Default model: gpt-4o (best balance of quality and structured-output maturity
+ * for the Reviewer's JSON schema needs in later tasks). Configurable per-call.
+ *
+ * Pricing as of 2026-05 (USD per 1M tokens, gpt-4o):
+ *   input:  2.50
+ *   output: 10.00
+ * These are recorded in PRICING_USD_PER_1M below. Update when OpenAI changes
+ * their published rates.
+ */
+import { type Adapter, type AdapterInput, type AdapterOutput } from "./types.js";
+export interface OpenAIAdapterOptions {
+    /** Override the API key source. Defaults to process.env.OPENAI_API_KEY. */
+    apiKey?: string;
+    /** Default model used when execute() does not supply one. */
+    defaultModel?: string;
+    /** Default response token cap. */
+    defaultMaxOutputTokens?: number;
+    /** Default wall-clock timeout. */
+    defaultTimeoutMs?: number;
+    /** OpenAI organization id (optional). */
+    organization?: string;
+}
+export declare class OpenAIAdapter implements Adapter {
+    readonly name: string;
+    readonly provider = "openai";
+    private readonly client;
+    private readonly defaultModel;
+    private readonly defaultMaxOutputTokens;
+    private readonly defaultTimeoutMs;
+    constructor(name?: string, options?: OpenAIAdapterOptions);
+    isAvailable(): Promise<boolean>;
+    execute(input: AdapterInput): Promise<AdapterOutput>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/adapters/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAY/F,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAGxC,IAAI,SAAU,EACd,OAAO,GAAE,oBAAyB;IAkB9B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CA6D3D"}

package/dist/adapters/openai.js

@@ -0,0 +1,105 @@
+/**
+ * OpenAI adapter — first real provider in MVP 1.
+ *
+ * Reads OPENAI_API_KEY from the environment. Never stores or logs the key.
+ * Default model: gpt-4o (best balance of quality and structured-output maturity
+ * for the Reviewer's JSON schema needs in later tasks). Configurable per-call.
+ *
+ * Pricing as of 2026-05 (USD per 1M tokens, gpt-4o):
+ *   input:  2.50
+ *   output: 10.00
+ * These are recorded in PRICING_USD_PER_1M below. Update when OpenAI changes
+ * their published rates.
+ */
+import OpenAI from "openai";
+import { AdapterError } from "./types.js";
+/** USD per 1M tokens, by model. Lowercased keys. */
+const PRICING_USD_PER_1M = {
+    "gpt-4o": { input: 2.5, output: 10.0 },
+    "gpt-4o-mini": { input: 0.15, output: 0.6 },
+    "gpt-4-turbo": { input: 10.0, output: 30.0 },
+    "gpt-3.5-turbo": { input: 0.5, output: 1.5 },
+};
+const DEFAULT_MODEL = "gpt-4o";
+export class OpenAIAdapter {
+    name;
+    provider = "openai";
+    client;
+    defaultModel;
+    defaultMaxOutputTokens;
+    defaultTimeoutMs;
+    constructor(name = "codex", options = {}) {
+        this.name = name;
+        this.defaultModel = options.defaultModel ?? DEFAULT_MODEL;
+        this.defaultMaxOutputTokens = options.defaultMaxOutputTokens ?? 4096;
+        this.defaultTimeoutMs = options.defaultTimeoutMs ?? 120_000;
+        const apiKey = options.apiKey ?? process.env["OPENAI_API_KEY"];
+        if (apiKey && apiKey.length > 0) {
+            this.client = new OpenAI({
+                apiKey,
+                ...(options.organization ? { organization: options.organization } : {}),
+            });
+        }
+        else {
+            this.client = null;
+        }
+    }
+    async isAvailable() {
+        return this.client !== null;
+    }
+    async execute(input) {
+        if (!this.client) {
+            throw new AdapterError("OPENAI_API_KEY is not set. Export it in your environment or pass it " +
+                "via the adapter constructor.", this.name);
+        }
+        const model = input.model ?? this.defaultModel;
+        const maxOutputTokens = input.maxOutputTokens ?? this.defaultMaxOutputTokens;
+        const timeoutMs = input.timeoutMs ?? this.defaultTimeoutMs;
+        const start = Date.now();
+        let response;
+        try {
+            response = await this.client.chat.completions.create({
+                model,
+                max_tokens: maxOutputTokens,
+                messages: [
+                    { role: "system", content: input.systemPrompt },
+                    { role: "user", content: input.userMessage },
+                ],
+                ...(input.responseFormat === "json_object"
+                    ? { response_format: { type: "json_object" } }
+                    : {}),
+            }, { timeout: timeoutMs });
+        }
+        catch (err) {
+            throw new AdapterError(`OpenAI call failed: ${err instanceof Error ? err.message : String(err)}`, this.name, err);
+        }
+        const choice = response.choices[0];
+        if (!choice || !choice.message.content) {
+            throw new AdapterError("OpenAI returned an empty response (no choices or empty content).", this.name);
+        }
+        const content = choice.message.content;
+        const tokensIn = response.usage?.prompt_tokens ?? 0;
+        const tokensOut = response.usage?.completion_tokens ?? 0;
+        const costUsd = estimateCostUsd(model, tokensIn, tokensOut);
+        return {
+            content,
+            tokensIn,
+            tokensOut,
+            costUsd,
+            latencyMs: Date.now() - start,
+            modelUsed: response.model ?? model,
+            provider: this.provider,
+        };
+    }
+}
+function estimateCostUsd(model, tokensIn, tokensOut) {
+    // Match by prefix so versioned model names (gpt-4o-2024-08-06) still resolve.
+    const key = Object.keys(PRICING_USD_PER_1M).find((k) => model.toLowerCase().startsWith(k));
+    if (!key)
+        return 0;
+    const rates = PRICING_USD_PER_1M[key];
+    if (!rates)
+        return 0;
+    return (tokensIn / 1_000_000) * rates.input + (tokensOut / 1_000_000) * rates.output;
+}
+//# sourceMappingURL=openai.js.map