@statechange/council 0.1.0

package/README.md

@@ -0,0 +1,207 @@
+# @statechange/council
+
+A CLI + Electron GUI for orchestrating round-robin AI counsellor discussions. Build a council of AI personas — each with their own backend, model, personality, and source material — and have them debate topics in structured or freeform formats.
+
+## Quick Start with Claude Code Skills
+
+The fastest way to get started is through [Claude Code](https://claude.com/claude-code) skills. Install the package, and the skills handle the rest:
+
+```bash
+npm install -g @statechange/council
+```
+
+Then in Claude Code:
+
+- **`/council-manage`** — Create counsellors, run discussions, manage your council. Ask it to "create a counsellor based on [person]" or "run a debate about [topic]".
+- **`/council-setup-keys`** — Find API keys scattered across your env files and shell profiles, then consolidate them into `~/.ai-council/config.json`.
+
+The skills know how to use the CLI, create counsellors from source material, and troubleshoot configuration issues.
+
+## Install
+
+```bash
+# Global install (recommended for CLI use)
+npm install -g @statechange/council
+
+# Or run directly
+npx @statechange/council discuss "Should we adopt microservices?"
+```
+
+## CLI Usage
+
+```bash
+# Run a freeform discussion (default)
+council discuss "Should we pivot to enterprise?" --rounds 3
+
+# Run a structured debate
+council discuss "Should AI be open source?" --mode debate --rounds 3
+
+# Use specific counsellors
+council discuss "Topic" --counsellors ./council/strategist ./council/critic
+
+# Topic from a file
+council discuss ./topics/architecture.md
+
+# List available counsellors
+council list
+
+# View past discussions
+council history
+council history <id>
+```
+
+### Discussion Modes
+
+**Freeform** (default) — Open group chat. Every counsellor sees the full conversation history on every turn. The first speaker sets the tone and later speakers react.
+
+**Debate** — Structured argument with three key differences:
+1. **Round 1 (Constructive)**: Each counsellor argues their position based only on the question — no visibility into what others said.
+2. **Rebuttal rounds**: Counsellors see the constructives plus only the previous round. Speaker order is shuffled each round.
+3. **Interim summaries**: A brief secretary summary after each round, creating a running debate narrative.
+
+### Options
+
+```
+--council, -c       Path to council directory (default: ./council/)
+--counsellors       Specific counsellor directory paths (space-separated)
+--rounds, -r        Number of discussion rounds (default: 2)
+--mode, -m          freeform or debate (default: freeform)
+--output, -o        Output directory (default: ./output)
+--format, -f        md, json, or both (default: both)
+--infographic, -i   Generate an infographic after discussion
+```
+
+## GUI
+
+Launch the Electron app for a visual interface with real-time streaming, counsellor management, and discussion history:
+
+```bash
+# Development
+council-gui          # if installed globally
+# or from source:
+bun run dev:gui
+```
+
+The GUI includes:
+- Counsellor selection chips with health indicators
+- Freeform/Debate mode toggle with explanatory tooltips
+- Real-time streaming of counsellor responses
+- Round dividers and interim summaries in debate mode
+- Secretary summary with Excalidraw position diagrams
+- Infographic generation (OpenAI / Google)
+- Full discussion history with search
+
+## Configuration
+
+### API Keys
+
+Backends need API keys (except Ollama which runs locally). Keys can come from:
+
+1. **Environment variables**: `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY`
+2. **Config file**: `~/.ai-council/config.json`
+3. **`.env` file** in the project root
+
+Use the CLI to find and import keys:
+
+```bash
+council config show              # See what's configured
+council config scan              # Find keys in env files and shell profiles
+council config scan ~/project/.env  # Scan additional paths
+council config import            # Import discovered keys
+```
+
+Or configure in the GUI under Settings.
+
+### Secretary
+
+Add a `secretary` block to `~/.ai-council/config.json` to enable post-discussion summaries and debate interim summaries:
+
+```json
+{
+  "backends": { ... },
+  "secretary": {
+    "backend": "anthropic",
+    "model": "claude-sonnet-4-5-20250929"
+  }
+}
+```
+
+## Creating Counsellors
+
+Each counsellor is a directory with an `ABOUT.md` file:
+
+```
+council/
+  my-counsellor/
+    ABOUT.md
+    avatar.jpg    # optional
+```
+
+### ABOUT.md Format
+
+```markdown
+---
+name: "The Strategist"
+description: "Thinks in systems, moats, and long-term positioning"
+interests: ["strategy", "markets", "competition"]
+backend: "anthropic"
+model: "claude-sonnet-4-5-20250929"
+temperature: 0.7
+avatar: "avatar.jpg"
+---
+
+You are The Strategist. You sit on a council of experts and bring a
+strategic lens to every discussion...
+```
+
+### Supported Backends
+
+| Backend | Default Model | API Key |
+|---------|--------------|---------|
+| anthropic | claude-sonnet-4-5-20250929 | `ANTHROPIC_API_KEY` |
+| openai | gpt-4o | `OPENAI_API_KEY` |
+| google | gemini-2.0-flash | `GOOGLE_API_KEY` |
+| ollama | llama3.2 | None (local) |
+
+### Registering External Counsellors
+
+```bash
+# From a local directory
+council counsellor add ./path/to/counsellor
+
+# From a git repository
+council counsellor add https://github.com/user/my-counsellors.git
+
+# List registered counsellors
+council counsellor list
+
+# Remove
+council counsellor remove my-counsellor
+```
+
+## Logging
+
+Errors are logged to `~/.ai-council/council.log` with timestamps, context, and full stack traces. Check this file when a counsellor fails to respond or a summary doesn't generate.
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# CLI development
+bun run dev -- discuss "topic"
+
+# GUI development
+bun run dev:gui
+
+# Build CLI
+bun run build
+
+# Build GUI
+bun run build:gui
+```
+
+## License
+
+MIT

package/council/creative/ABOUT.md

@@ -0,0 +1,23 @@
+---
+name: "The Creative2"
+description: "Lateral thinker who finds unconventional angles and unexpected connections"
+interests: ["innovation", "creativity", "lateral thinking", "analogies", "reframing"]
+backend: "anthropic"
+model: "claude-opus-4-6"
+temperature: 0.9
+avatar: "https://api.dicebear.com/9.x/personas/svg?seed=Creative&backgroundColor=ffd5dc"
+---
+You are The Creative, an unconventional lateral thinker on a council of experts.
+
+Your role is to bring fresh perspectives, unexpected analogies, and reframed questions to the discussion. You see connections others miss and challenge the group to think beyond obvious solutions.
+
+When contributing to a discussion:
+- Reframe the problem in surprising ways
+- Draw analogies from completely different domains
+- Propose ideas that might seem wild but have a kernel of insight
+- Build unexpected bridges between what other council members have said
+- Question whether the group is even asking the right question
+
+You balance creative provocation with practical grounding. Your best ideas are ones that make people say "I never thought of it that way" — not just "that's weird."
+
+Keep your responses focused and substantive. Aim for 2-4 paragraphs per turn.

package/council/critic/ABOUT.md

@@ -0,0 +1,23 @@
+---
+name: "The Critic"
+description: "Devil's advocate who stress-tests ideas and finds weaknesses"
+interests: ["risk analysis", "critical thinking", "failure modes", "assumptions"]
+backend: "google"
+model: "gemini-flash-latest"
+temperature: 0.6
+avatar: "https://api.dicebear.com/9.x/personas/svg?seed=Critic&backgroundColor=d1d4f9"
+---
+You are The Critic, a sharp analytical thinker on a council of experts.
+
+Your role is to be the constructive devil's advocate. You stress-test ideas, surface hidden assumptions, identify failure modes, and push the council toward more rigorous thinking.
+
+When contributing to a discussion:
+- Challenge assumptions other council members are making
+- Identify what could go wrong and why
+- Ask the uncomfortable questions others might avoid
+- Point out blind spots and biases in the reasoning so far
+- Be respectful but unflinching — soft criticism helps no one
+
+You are not a pessimist. You genuinely want the best outcome, which means being honest about the risks. When an idea is strong, acknowledge it — then probe for weaknesses anyway.
+
+Keep your responses focused and substantive. Aim for 2-4 paragraphs per turn.

package/council/strategist/ABOUT.md

@@ -0,0 +1,21 @@
+---
+name: "The Strategist"
+description: "Strategic business advisor focused on positioning, growth, and competitive advantage"
+interests: ["strategy", "business", "growth", "positioning", "market analysis"]
+backend: "anthropic"
+model: "claude-haiku-4-5-20251001"
+temperature: 0.7
+avatar: "https://api.dicebear.com/9.x/personas/svg?seed=Strategist&backgroundColor=b6e3f4"
+---
+You are The Strategist, a senior business strategy advisor on a council of experts.
+
+Your role is to analyze topics through the lens of strategic thinking: competitive advantage, market positioning, resource allocation, and long-term growth trajectories.
+
+When contributing to a discussion:
+- Build on what other council members have said, but bring your strategic perspective
+- Think about second and third-order effects
+- Consider both offensive and defensive strategic positions
+- Ground your thinking in frameworks like Porter's Five Forces, Blue Ocean Strategy, or Jobs-to-be-Done when relevant
+- Be direct and opinionated — the council values strong perspectives that can be debated
+
+Keep your responses focused and substantive. Aim for 2-4 paragraphs per turn.

package/dist/backends/anthropic.d.ts

@@ -0,0 +1,2 @@
+import type { BackendProvider, BackendConfig } from "./types.js";
+export declare function createAnthropicBackend(config: BackendConfig): BackendProvider;

package/dist/backends/anthropic.js

@@ -0,0 +1,57 @@
+import Anthropic from "@anthropic-ai/sdk";
+export function createAnthropicBackend(config) {
+    const client = new Anthropic({
+        apiKey: config.apiKey ?? process.env.ANTHROPIC_API_KEY,
+        ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+    });
+    return {
+        name: "anthropic",
+        defaultModel: "claude-sonnet-4-5-20250929",
+        async chat(request) {
+            const response = await client.messages.create({
+                model: request.model,
+                max_tokens: 4096,
+                system: request.systemPrompt,
+                messages: request.messages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+                ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+            });
+            const textBlock = response.content.find((b) => b.type === "text");
+            return {
+                content: textBlock?.text ?? "",
+                tokenUsage: {
+                    input: response.usage.input_tokens,
+                    output: response.usage.output_tokens,
+                },
+            };
+        },
+        async *chatStream(request) {
+            const stream = client.messages.stream({
+                model: request.model,
+                max_tokens: 4096,
+                system: request.systemPrompt,
+                messages: request.messages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+                ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+            });
+            for await (const event of stream) {
+                if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
+                    yield { delta: event.delta.text };
+                }
+            }
+            const finalMessage = await stream.finalMessage();
+            yield {
+                delta: "",
+                tokenUsage: {
+                    input: finalMessage.usage.input_tokens,
+                    output: finalMessage.usage.output_tokens,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/backends/anthropic.js.map

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

package/dist/backends/google.d.ts

@@ -0,0 +1,2 @@
+import type { BackendProvider, BackendConfig } from "./types.js";
+export declare function createGoogleBackend(config: BackendConfig): BackendProvider;

package/dist/backends/google.js

@@ -0,0 +1,68 @@
+import { GoogleGenerativeAI } from "@google/generative-ai";
+export function createGoogleBackend(config) {
+    const apiKey = config.apiKey ?? process.env.GOOGLE_API_KEY ?? "";
+    const genAI = new GoogleGenerativeAI(apiKey);
+    return {
+        name: "google",
+        defaultModel: "gemini-2.0-flash",
+        async chat(request) {
+            const model = genAI.getGenerativeModel({
+                model: request.model,
+                systemInstruction: request.systemPrompt,
+                generationConfig: {
+                    ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+                },
+            });
+            const history = request.messages.slice(0, -1).map((m) => ({
+                role: m.role === "assistant" ? "model" : "user",
+                parts: [{ text: m.content }],
+            }));
+            const chat = model.startChat({ history });
+            const lastMessage = request.messages[request.messages.length - 1];
+            const result = await chat.sendMessage(lastMessage?.content ?? "");
+            const response = result.response;
+            return {
+                content: response.text(),
+                tokenUsage: response.usageMetadata
+                    ? {
+                        input: response.usageMetadata.promptTokenCount ?? 0,
+                        output: response.usageMetadata.candidatesTokenCount ?? 0,
+                    }
+                    : undefined,
+            };
+        },
+        async *chatStream(request) {
+            const genModel = genAI.getGenerativeModel({
+                model: request.model,
+                systemInstruction: request.systemPrompt,
+                generationConfig: {
+                    ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+                },
+            });
+            const history = request.messages.slice(0, -1).map((m) => ({
+                role: m.role === "assistant" ? "model" : "user",
+                parts: [{ text: m.content }],
+            }));
+            const chat = genModel.startChat({ history });
+            const lastMessage = request.messages[request.messages.length - 1];
+            const result = await chat.sendMessageStream(lastMessage?.content ?? "");
+            for await (const chunk of result.stream) {
+                const text = chunk.text();
+                if (text) {
+                    yield { delta: text };
+                }
+            }
+            const response = await result.response;
+            yield {
+                delta: "",
+                tokenUsage: response.usageMetadata
+                    ? {
+                        input: response.usageMetadata.promptTokenCount ?? 0,
+                        output: response.usageMetadata.candidatesTokenCount ?? 0,
+                    }
+                    : undefined,
+            };
+        },
+    };
+}
+//# sourceMappingURL=google.js.map

package/dist/backends/google.js.map

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

package/dist/backends/index.d.ts

@@ -0,0 +1,3 @@
+import type { BackendProvider } from "../types.js";
+export declare function clearCaches(): void;
+export declare function getBackend(name: string): Promise<BackendProvider>;

package/dist/backends/index.js

@@ -0,0 +1,47 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { createAnthropicBackend } from "./anthropic.js";
+import { createOpenAIBackend } from "./openai.js";
+import { createGoogleBackend } from "./google.js";
+import { createOllamaBackend } from "./ollama.js";
+const factories = {
+    anthropic: createAnthropicBackend,
+    openai: createOpenAIBackend,
+    google: createGoogleBackend,
+    ollama: createOllamaBackend,
+};
+let configCache = null;
+async function loadConfig() {
+    if (configCache)
+        return configCache;
+    const configPath = join(homedir(), ".ai-council", "config.json");
+    try {
+        const raw = await readFile(configPath, "utf-8");
+        configCache = JSON.parse(raw);
+    }
+    catch {
+        configCache = { backends: {} };
+    }
+    return configCache;
+}
+const backendCache = new Map();
+export function clearCaches() {
+    configCache = null;
+    backendCache.clear();
+}
+export async function getBackend(name) {
+    const cached = backendCache.get(name);
+    if (cached)
+        return cached;
+    const factory = factories[name];
+    if (!factory) {
+        throw new Error(`Unknown backend: "${name}". Available: ${Object.keys(factories).join(", ")}`);
+    }
+    const config = await loadConfig();
+    const backendConfig = config.backends[name] ?? {};
+    const backend = factory(backendConfig);
+    backendCache.set(name, backend);
+    return backend;
+}
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,SAAS,GAAmC;IAChD,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,mBAAmB;CAC5B,CAAC;AAEF,IAAI,WAAW,GAAyB,IAAI,CAAC;AAE7C,KAAK,UAAU,UAAU;IACvB,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;AAExD,MAAM,UAAU,WAAW;IACzB,WAAW,GAAG,IAAI,CAAC;IACnB,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/backends/ollama.d.ts

@@ -0,0 +1,2 @@
+import type { BackendProvider, BackendConfig } from "./types.js";
+export declare function createOllamaBackend(config: BackendConfig): BackendProvider;

package/dist/backends/ollama.js

@@ -0,0 +1,68 @@
+import { Ollama } from "ollama";
+export function createOllamaBackend(config) {
+    const client = new Ollama({
+        host: config.baseUrl ?? "http://localhost:11434",
+    });
+    return {
+        name: "ollama",
+        defaultModel: "llama3.2",
+        async chat(request) {
+            const response = await client.chat({
+                model: request.model,
+                messages: [
+                    { role: "system", content: request.systemPrompt },
+                    ...request.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                ],
+                options: {
+                    ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+                },
+            });
+            return {
+                content: response.message.content,
+                tokenUsage: response.prompt_eval_count !== undefined
+                    ? {
+                        input: response.prompt_eval_count ?? 0,
+                        output: response.eval_count ?? 0,
+                    }
+                    : undefined,
+            };
+        },
+        async *chatStream(request) {
+            const response = await client.chat({
+                model: request.model,
+                messages: [
+                    { role: "system", content: request.systemPrompt },
+                    ...request.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                ],
+                options: {
+                    ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+                },
+                stream: true,
+            });
+            let promptEvalCount;
+            let evalCount;
+            for await (const chunk of response) {
+                if (chunk.message.content) {
+                    yield { delta: chunk.message.content };
+                }
+                if (chunk.done) {
+                    promptEvalCount = chunk.prompt_eval_count;
+                    evalCount = chunk.eval_count;
+                }
+            }
+            yield {
+                delta: "",
+                tokenUsage: promptEvalCount !== undefined
+                    ? { input: promptEvalCount ?? 0, output: evalCount ?? 0 }
+                    : undefined,
+            };
+        },
+    };
+}
+//# sourceMappingURL=ollama.js.map

package/dist/backends/ollama.js.map

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

package/dist/backends/openai.d.ts

@@ -0,0 +1,2 @@
+import type { BackendProvider, BackendConfig } from "./types.js";
+export declare function createOpenAIBackend(config: BackendConfig): BackendProvider;

package/dist/backends/openai.js

@@ -0,0 +1,62 @@
+import OpenAI from "openai";
+export function createOpenAIBackend(config) {
+    const client = new OpenAI({
+        apiKey: config.apiKey ?? process.env.OPENAI_API_KEY,
+        ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+    });
+    return {
+        name: "openai",
+        defaultModel: "gpt-4o",
+        async chat(request) {
+            const response = await client.chat.completions.create({
+                model: request.model,
+                messages: [
+                    { role: "system", content: request.systemPrompt },
+                    ...request.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                ],
+                ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+            });
+            const choice = response.choices[0];
+            return {
+                content: choice?.message?.content ?? "",
+                tokenUsage: response.usage
+                    ? { input: response.usage.prompt_tokens, output: response.usage.completion_tokens }
+                    : undefined,
+            };
+        },
+        async *chatStream(request) {
+            const stream = await client.chat.completions.create({
+                model: request.model,
+                messages: [
+                    { role: "system", content: request.systemPrompt },
+                    ...request.messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                ],
+                ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
+                stream: true,
+                stream_options: { include_usage: true },
+            });
+            for await (const chunk of stream) {
+                const delta = chunk.choices[0]?.delta?.content;
+                if (delta) {
+                    yield { delta };
+                }
+                if (chunk.usage) {
+                    yield {
+                        delta: "",
+                        tokenUsage: {
+                            input: chunk.usage.prompt_tokens,
+                            output: chunk.usage.completion_tokens,
+                        },
+                    };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/backends/openai.js.map

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

package/dist/backends/types.d.ts

@@ -0,0 +1 @@
+export type { BackendProvider, BackendConfig, ChatRequest, ChatResponse, ChatStreamChunk } from "../types.js";

package/dist/backends/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backends/types.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";