agent-bober 0.6.2 → 0.8.0

package/dist/providers/openai-compat.js

@@ -0,0 +1,42 @@
+/**
+ * OpenAI-compatible provider adapter.
+ *
+ * Creates an OpenAI client pointed at a custom base URL, enabling use with
+ * any OpenAI-compatible API server (e.g. Ollama, LM Studio, vLLM, Together AI).
+ *
+ * Reuses all tool conversion, message conversion, and response normalisation
+ * logic from OpenAIAdapter by extending it with a custom base URL and a
+ * default API key of "not-needed" (required by the openai SDK but ignored
+ * by servers like Ollama that don't require authentication).
+ */
+import { OpenAIAdapter } from "./openai.js";
+/**
+ * LLMClient implementation for OpenAI-compatible endpoints.
+ *
+ * Extends OpenAIAdapter with a required `endpoint` (baseURL) parameter.
+ * All tool conversion and response normalisation is inherited from
+ * OpenAIAdapter — only the client configuration differs.
+ *
+ * Usage example (Ollama):
+ * ```ts
+ * const client = new OpenAICompatAdapter(
+ *   "http://localhost:11434/v1",
+ *   "llama3",
+ * );
+ * ```
+ */
+export class OpenAICompatAdapter extends OpenAIAdapter {
+    /**
+     * @param endpoint - Required base URL of the OpenAI-compatible server
+     *   (e.g. "http://localhost:11434/v1" for Ollama).
+     * @param model - Model identifier to use with this server.
+     * @param apiKey - Optional API key. Defaults to "not-needed" for servers
+     *   that do not require authentication (e.g. Ollama).
+     */
+    constructor(endpoint, model, apiKey) {
+        // Pass "not-needed" as apiKey default — the openai SDK requires a non-empty
+        // value but OpenAI-compat servers (like Ollama) typically ignore it.
+        super(model, apiKey ?? "not-needed", endpoint);
+    }
+}
+//# sourceMappingURL=openai-compat.js.map

package/dist/providers/openai-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compat.js","sourceRoot":"","sources":["../../src/providers/openai-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD;;;;;;OAMG;IACH,YAAY,QAAgB,EAAE,KAAa,EAAE,MAAe;QAC1D,4EAA4E;QAC5E,qEAAqE;QACrE,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OpenAI provider adapter.
+ *
+ * Uses a dynamic import so the `openai` package is an optional peer dependency.
+ * If the package is not installed, a clear installation error is thrown at
+ * call-time rather than at module load time.
+ *
+ * All OpenAI SDK types are inlined below so this file compiles without the
+ * `openai` package present in node_modules.
+ */
+import type { LLMClient, ChatParams, ChatResponse } from "./types.js";
+/**
+ * LLMClient implementation that wraps the OpenAI chat completions API.
+ *
+ * The `openai` npm package is dynamically imported so it remains an optional
+ * peer dependency. If the package is absent a descriptive install error is
+ * thrown on the first call.
+ *
+ * Supports:
+ * - Function/tool calling via the tools array format
+ * - Parallel tool calls
+ * - Custom base URL for OpenAI-compatible endpoints
+ * - Optional provider-level configuration
+ */
+export declare class OpenAIAdapter implements LLMClient {
+    private readonly model;
+    private readonly apiKey;
+    private readonly baseURL;
+    private readonly providerConfig;
+    /** Lazily initialised after the dynamic import succeeds. */
+    private client;
+    constructor(model: string, apiKey?: string, endpoint?: string, providerConfig?: Record<string, unknown>);
+    /**
+     * Lazily import the `openai` package and return the initialised client.
+     *
+     * @throws If the `openai` package is not installed.
+     */
+    private getClient;
+    chat(params: ChatParams): Promise<ChatResponse>;
+}
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AA0MpB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAA8B;gBAG1C,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ1C;;;;OAIG;YACW,SAAS;IAqCjB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA8CtD"}

package/dist/providers/openai.js

@@ -0,0 +1,205 @@
+/**
+ * OpenAI provider adapter.
+ *
+ * Uses a dynamic import so the `openai` package is an optional peer dependency.
+ * If the package is not installed, a clear installation error is thrown at
+ * call-time rather than at module load time.
+ *
+ * All OpenAI SDK types are inlined below so this file compiles without the
+ * `openai` package present in node_modules.
+ */
+// ── Conversion helpers ──────────────────────────────────────────────
+/**
+ * Convert a provider-agnostic ToolDef to OpenAI function calling format.
+ */
+function toOpenAITool(tool) {
+    return {
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            // input_schema is already a JSON Schema object; OpenAI uses `parameters`
+            parameters: tool.input_schema,
+        },
+    };
+}
+/**
+ * Normalize the OpenAI finish_reason to our StopReason type.
+ */
+function normalizeStopReason(finishReason) {
+    switch (finishReason) {
+        case "stop":
+            return "end";
+        case "tool_calls":
+            return "tool_use";
+        case "length":
+            return "max_tokens";
+        default:
+            return finishReason ?? "end";
+    }
+}
+/**
+ * Convert a provider-agnostic Message to one or more OpenAI request messages.
+ *
+ * Returns an array because ToolResultMessage expands into one OAI tool
+ * message per tool result (OpenAI requires separate messages per tool call).
+ */
+function toOpenAIMessages(message) {
+    // ToolResultMessage → one role:"tool" message per result
+    if ("toolResults" in message) {
+        return message.toolResults.map((tr) => ({
+            role: "tool",
+            tool_call_id: tr.toolUseId,
+            content: tr.content,
+        }));
+    }
+    // AssistantMessage → role:"assistant" with optional tool_calls
+    if ("toolCalls" in message && message.toolCalls.length > 0) {
+        const oaiMsg = {
+            role: "assistant",
+            content: message.content || null,
+            tool_calls: message.toolCalls.map((tc) => ({
+                id: tc.id,
+                type: "function",
+                function: {
+                    name: tc.name,
+                    arguments: JSON.stringify(tc.input),
+                },
+            })),
+        };
+        return [oaiMsg];
+    }
+    // TextMessage (user or assistant without tool calls)
+    const textMsg = message;
+    if (textMsg.role === "user") {
+        return [{ role: "user", content: textMsg.content }];
+    }
+    // Plain assistant text message (no tool calls)
+    return [{ role: "assistant", content: textMsg.content }];
+}
+/**
+ * Parse tool_calls from an OAI response message into ToolCall[].
+ *
+ * Guards against an empty array (treated as no tool calls) and handles
+ * JSON parse errors in arguments gracefully.
+ */
+function normalizeToolCalls(toolCalls) {
+    if (!toolCalls || toolCalls.length === 0) {
+        return [];
+    }
+    return toolCalls.map((tc) => {
+        let input = {};
+        try {
+            const parsed = JSON.parse(tc.function.arguments);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                input = parsed;
+            }
+        }
+        catch {
+            // Malformed JSON from the model — fall back to empty input
+        }
+        return {
+            id: tc.id,
+            name: tc.function.name,
+            input,
+        };
+    });
+}
+// ── OpenAIAdapter ────────────────────────────────────────────────────
+/**
+ * LLMClient implementation that wraps the OpenAI chat completions API.
+ *
+ * The `openai` npm package is dynamically imported so it remains an optional
+ * peer dependency. If the package is absent a descriptive install error is
+ * thrown on the first call.
+ *
+ * Supports:
+ * - Function/tool calling via the tools array format
+ * - Parallel tool calls
+ * - Custom base URL for OpenAI-compatible endpoints
+ * - Optional provider-level configuration
+ */
+export class OpenAIAdapter {
+    model;
+    apiKey;
+    baseURL;
+    providerConfig;
+    /** Lazily initialised after the dynamic import succeeds. */
+    client = null;
+    constructor(model, apiKey, endpoint, providerConfig) {
+        this.model = model;
+        this.apiKey = apiKey;
+        this.baseURL = endpoint;
+        this.providerConfig = providerConfig;
+    }
+    /**
+     * Lazily import the `openai` package and return the initialised client.
+     *
+     * @throws If the `openai` package is not installed.
+     */
+    async getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        let OpenAI;
+        try {
+            // Construct the specifier at runtime so TypeScript does not attempt
+            // to statically resolve the optional peer dependency at compile time.
+            const specifier = "openai";
+            const mod = (await import(/* @vite-ignore */ specifier));
+            // Handle both ESM default export and CommonJS-style .default wrapping
+            OpenAI = (mod["default"] ?? mod);
+        }
+        catch {
+            throw new Error('OpenAI provider requires the "openai" package. Run: npm install openai');
+        }
+        const apiKey = this.apiKey ??
+            (typeof this.providerConfig?.["apiKey"] === "string"
+                ? this.providerConfig["apiKey"]
+                : process.env["OPENAI_API_KEY"]);
+        this.client = new OpenAI({
+            apiKey,
+            ...(this.baseURL ? { baseURL: this.baseURL } : {}),
+        });
+        return this.client;
+    }
+    async chat(params) {
+        const { model, system, messages, tools, maxTokens = 16384 } = params;
+        const client = await this.getClient();
+        // Build the messages array: system message first, then conversation
+        const oaiMessages = [
+            { role: "system", content: system },
+            ...messages.flatMap(toOpenAIMessages),
+        ];
+        // Convert ToolDef[] to OpenAI tools format
+        const oaiTools = tools && tools.length > 0 ? tools.map(toOpenAITool) : undefined;
+        const response = await client.chat.completions.create({
+            model: model || this.model,
+            messages: oaiMessages,
+            ...(oaiTools ? { tools: oaiTools } : {}),
+            max_tokens: maxTokens,
+        });
+        const choice = response.choices[0];
+        if (!choice) {
+            return {
+                text: "",
+                toolCalls: [],
+                stopReason: "error",
+                usage: { inputTokens: 0, outputTokens: 0 },
+            };
+        }
+        const text = choice.message.content ?? "";
+        const toolCalls = normalizeToolCalls(choice.message.tool_calls);
+        const stopReason = normalizeStopReason(choice.finish_reason);
+        return {
+            text,
+            toolCalls,
+            stopReason,
+            usage: {
+                inputTokens: response.usage?.prompt_tokens ?? 0,
+                outputTokens: response.usage?.completion_tokens ?? 0,
+            },
+        };
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Provider-agnostic LLM interface types.
+ *
+ * These types decouple agent-bober from any specific LLM SDK. All provider
+ * adapters (Anthropic, OpenAI, etc.) convert to/from these types.
+ */
+export interface JsonSchemaProperty {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: JsonSchemaProperty;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+}
+export interface JsonSchemaObject {
+    type: "object";
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+    /** Allow extra keys so this type is assignable to Anthropic's InputSchema (which has [k: string]: unknown). */
+    [key: string]: unknown;
+}
+/**
+ * Provider-agnostic tool definition.
+ *
+ * Uses plain JSON Schema for parameters (no SDK-specific types).
+ * Maps directly to the Anthropic Tool shape (input_schema → parameters)
+ * and to OpenAI function calling format.
+ */
+export interface ToolDef {
+    /** Unique tool name (snake_case). */
+    name: string;
+    /** Human-readable description of what the tool does. */
+    description: string;
+    /** JSON Schema object describing the tool's input parameters. */
+    input_schema: JsonSchemaObject;
+}
+/**
+ * A single tool invocation requested by the model.
+ */
+export interface ToolCall {
+    /** Unique ID for this tool call (used to correlate results). */
+    id: string;
+    /** Tool name. */
+    name: string;
+    /** Parsed input arguments. */
+    input: Record<string, unknown>;
+}
+/**
+ * A tool result item, returned by the agent after executing a tool.
+ * Used within ToolResultMessage to correlate results with tool call IDs.
+ */
+export interface ToolResult {
+    /** The ID of the tool call this result corresponds to. */
+    toolUseId: string;
+    /** The output text from the tool execution. */
+    content: string;
+    /** Whether this result represents a tool execution error. */
+    isError?: boolean;
+}
+/**
+ * An assistant message that contains both optional text and tool call requests.
+ */
+export interface AssistantMessage {
+    role: "assistant";
+    /** Text portion of the response (may be empty when only tool calls are present). */
+    content: string;
+    /** Tool calls the assistant wants to execute. */
+    toolCalls: ToolCall[];
+}
+/**
+ * A user message that carries tool execution results back to the model.
+ */
+export interface ToolResultMessage {
+    role: "user";
+    /** Tool results keyed by tool call ID. */
+    toolResults: ToolResult[];
+}
+/**
+ * A plain text message from user or assistant.
+ */
+export interface TextMessage {
+    role: "user" | "assistant";
+    /** Text content. */
+    content: string;
+}
+/**
+ * A message in the conversation history.
+ *
+ * Three variants:
+ * - TextMessage: plain user or assistant text
+ * - AssistantMessage: assistant response that includes tool call requests
+ * - ToolResultMessage: user message carrying tool execution results
+ */
+export type Message = TextMessage | AssistantMessage | ToolResultMessage;
+/**
+ * Parameters for a single LLM chat request.
+ */
+export interface ChatParams {
+    /** Model identifier (resolved by the factory / model-resolver). */
+    model: string;
+    /** System prompt. */
+    system: string;
+    /** Conversation history. */
+    messages: Message[];
+    /** Tools available to the model for this request. */
+    tools?: ToolDef[];
+    /** Maximum tokens to generate. Defaults to 16384. */
+    maxTokens?: number;
+}
+/**
+ * Stop reason indicating why the model stopped generating.
+ */
+export type StopReason = "end" | "tool_use" | "max_tokens" | "error" | string;
+/**
+ * Normalized response from a single LLM chat request.
+ */
+export interface ChatResponse {
+    /** The assistant's text response (may be empty if only tool calls). */
+    text: string;
+    /** Tool calls requested by the model (may be empty). */
+    toolCalls: ToolCall[];
+    /** Why the model stopped generating. */
+    stopReason: StopReason;
+    /** Token usage for this request. */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Unified interface for all LLM provider adapters.
+ *
+ * Implementations must handle tool conversion to/from their native
+ * format and normalize responses to ChatResponse.
+ */
+export interface LLMClient {
+    /**
+     * Send a chat request to the underlying provider and return a
+     * normalized ChatResponse.
+     */
+    chat(params: ChatParams): Promise<ChatResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

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

package/dist/providers/types.js

@@ -0,0 +1,8 @@
+/**
+ * Provider-agnostic LLM interface types.
+ *
+ * These types decouple agent-bober from any specific LLM SDK. All provider
+ * adapters (Anthropic, OpenAI, etc.) convert to/from these types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-bober",
-  "version": "0.6.2",
-  "description": "Generator-Evaluator multi-agent harness for building applications autonomously with Claude. Implements planner, sprint, and evaluator patterns.",
+  "version": "0.8.0",
+  "description": "Generator-Evaluator multi-agent harness for building applications autonomously with any LLM. Supports Claude, GPT, Gemini, Ollama. Includes MCP server for Cursor/Windsurf.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,18 +17,23 @@
     "prepublishOnly": "npm run build"
   },
   "keywords": [
-    "claude",
     "agent",
     "harness",
     "multi-agent",
     "autonomous",
     "generator-evaluator",
     "claude-code",
+    "cursor",
+    "mcp",
+    "claude",
+    "openai",
+    "gemini",
+    "ollama",
     "plugin"
   ],
   "author": "BOBER3r",
   "license": "MIT",
-  "homepage": "https://github.com/BOBER3r/agent-bober#readme",
+  "homepage": "https://agentbober.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/BOBER3r/agent-bober.git"
@@ -50,6 +55,7 @@
   ],
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.28.0",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "execa": "^9.5.2",
@@ -58,6 +64,18 @@
     "prompts": "^2.4.2",
     "zod": "^3.24.2"
   },
+  "peerDependencies": {
+    "@google/generative-ai": ">=0.21.0",
+    "openai": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "@google/generative-ai": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^22.13.0",

package/skills/bober.principles/SKILL.md

@@ -37,7 +37,40 @@ If the user wants to update, proceed to Step 3 with the existing content as a st
 
 Proceed to Step 2.
 
-## Step 2: Interview the User
+## Step 2: Auto-Discovery (Brownfield mode)
+
+**Check this FIRST before interviewing the user.**
+
+If `bober.config.json` exists with `"mode": "brownfield"` AND no arguments were provided to this command:
+
+1. **Run the auto-discovery pipeline** — analyze the codebase to discover conventions:
+   - Read and parse `package.json` to detect scripts, dependencies, and package manager
+   - Scan `.github/workflows/` or `.gitlab-ci.yml` to identify CI checks
+   - Read recent git log to detect commit style (conventional commits, prefix patterns)
+   - Sample source files to detect naming conventions, import style, export style, TypeScript patterns
+   - Find test files to identify the testing framework and file patterns
+
+2. **Generate principles from discovered patterns** — synthesize the discovered conventions into a structured `principles.md` document using the same format as Step 3. Ground every rule in actual evidence from the codebase scan.
+
+3. **Show the generated principles** to the user:
+   ```
+   I analyzed your codebase and discovered these conventions:
+
+   <generated principles content>
+   ```
+
+4. **Ask for additions or confirmation:**
+   ```
+   Want to add or modify anything? You can provide additional notes or say "looks good".
+   ```
+
+5. **If the user provides additions**, merge them into the generated principles document. Expand any short notes into full principle statements following the quality rules in Step 3.
+
+6. **Save to `.bober/principles.md`** and proceed to Step 4 (Confirm and Report).
+
+The existing interview flow (below) applies only to greenfield projects or when arguments are provided.
+
+## Step 2a: Interview the User (Greenfield or with args)
 
 Ask the user 3-5 targeted questions to understand their project principles. Adapt the questions based on whether `bober.config.json` exists and what it reveals about the project type.
 
@@ -80,7 +113,7 @@ E) Not applicable (no UI in this project)
 F) Other (please describe)
 ```
 
-## Step 2a: Expand Raw Input (if user provides a prompt/argument)
+## Step 2b: Expand Raw Input (if user provides a prompt/argument)
 
 If the user provides text with this command — whether a short note like `"performance-first, minimal dependencies"` or a long paste of requirements, a PRD, or rough notes — your job is to **intelligently expand and elevate** that input into a polished principles document:
 
@@ -92,7 +125,7 @@ If the user provides text with this command — whether a short note like `"perf
 
 The goal: the user pastes rough notes, you produce a comprehensive, opinionated principles document that makes them say "yes, exactly — and I didn't even think of those."
 
-Skip the interview (Step 2) entirely when the user provides substantive input. Go straight to generating the document.
+Skip the interview (Step 2a) entirely when the user provides substantive input. Go straight to generating the document.
 
 ## Step 3: Generate Principles Document