bare-agent 0.3.2 → 0.3.3

package/README.md

@@ -43,6 +43,15 @@ Use bare-agent. The integration guide is in bareagent.context.md.
 
 That's it. The context doc is structured for LLM consumption — your agent reads it once and knows how to wire every component.
 
+**Not sure what you need?** Paste this into any AI assistant:
+
+```
+I want to build an agent using bare-agent. Read the integration guide at
+node_modules/bare-agent/bareagent.context.md, then ask me up to 5 questions
+about what I need. Based on my answers, tell me which components to use
+and show me the wiring code.
+```
+
 ---
 
 ## What's inside
@@ -68,15 +77,60 @@ Every piece works alone — take what you need, ignore the rest.
 
 **Tools:** Any function is a tool. REST APIs, MCP servers, CLI commands, browser automation, shell scripts — if it's a function, it works.
 
-**Cross-language:** Runs as a subprocess. Communicate via JSONL on stdin/stdout from Python, Go, Rust, or anything that can spawn a process.
+**Cross-language:** Runs as a subprocess. Communicate via JSONL on stdin/stdout from Python, Go, Rust, Ruby, Java, or anything that can spawn a process. Ready-made wrappers in [`contrib/`](contrib/README.md).
 
 **Deps:** 0 required. Optional: `cron-parser` (cron expressions), `better-sqlite3` (SQLite store).
 
 ---
 
+## Cross-language usage
+
+Not using Node.js? Spawn bare-agent as a subprocess from any language. Ready-made wrappers in [`contrib/`](contrib/README.md) for Python, Go, Rust, Ruby, and Java — copy one file, no package registry needed.
+
+```python
+# Python — 3 lines to run an agent
+from bareagent import BareAgent
+
+agent = BareAgent(provider="openai", model="gpt-4o-mini")
+result = agent.run("What is the capital of France?")
+print(result["text"])  # → "The capital of France is Paris."
+agent.close()
+```
+
+```go
+// Go — same pattern
+agent, _ := bareagent.New("anthropic", "claude-haiku-4-5-20251001", "")
+result, _ := agent.Run("What is the capital of France?")
+fmt.Println(result.Text)
+agent.Close()
+```
+
+```ruby
+# Ruby — same pattern
+agent = BareAgent.new(provider: "ollama", model: "llama3.2")
+result = agent.run("What is the capital of France?")
+puts result["text"]
+agent.close
+```
+
+All wrappers support optional event streaming for intermediate results. See [`contrib/README.md`](contrib/README.md) for Rust, Java, and full protocol reference.
+
+---
+
 ## Production-validated
 
-bare-agent powers the SOAR2 pipeline in [Aurora](https://github.com/hamr0/aurora), replacing ~400 lines of hand-rolled orchestration with ~60 lines of bare-agent wiring — zero workarounds, zero framework plumbing, 100% domain logic.
+| Component | Aurora (SOAR2) | Multis (assistant) |
+|---|:---:|:---:|
+| Loop | ✓ | ✓ |
+| Planner | ✓ | ✓ |
+| runPlan | ✓ | — |
+| Retry | ✓ | ✓ |
+| CircuitBreaker | — | ✓ |
+| Scheduler | — | ✓ |
+| Checkpoint | — | ✓ |
+| CLIPipe | ✓ | — |
+
+Aurora replaced ~400 lines of hand-rolled orchestration with ~60 lines of bare-agent wiring — zero workarounds, zero framework plumbing, 100% domain logic.
 
 For wiring recipes and API details, see the **[Integration Guide](bareagent.context.md)** (LLM-optimized). For the full human guide — usage patterns, composition examples, and what bare-agent deliberately doesn't build in (with recipes to do it yourself), see the **[Usage Guide](docs/02-features/usage-guide.md)**. For error reference, see **[Error Guide](docs/02-features/errors.md)**. For release history, see **[CHANGELOG](CHANGELOG.md)**.
 

package/bin/test-provider.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+'use strict';
+
+const args = process.argv.slice(2);
+const flag = (name) => {
+  const i = args.indexOf(`--${name}`);
+  return i >= 0 ? args[i + 1] : undefined;
+};
+
+const providerName = flag('provider') || 'openai';
+const model = flag('model');
+
+function createProvider() {
+  if (providerName === 'openai') {
+    const { OpenAIProvider } = require('../src/provider-openai');
+    return new OpenAIProvider({
+      apiKey: process.env.OPENAI_API_KEY,
+      ...(model && { model }),
+    });
+  }
+  if (providerName === 'anthropic') {
+    const { AnthropicProvider } = require('../src/provider-anthropic');
+    return new AnthropicProvider({
+      apiKey: process.env.ANTHROPIC_API_KEY,
+      ...(model && { model }),
+    });
+  }
+  if (providerName === 'ollama') {
+    const { OllamaProvider } = require('../src/provider-ollama');
+    return new OllamaProvider({
+      ...(model && { model }),
+      ...(flag('url') && { url: flag('url') }),
+    });
+  }
+  console.error(`Unknown provider: ${providerName}`);
+  process.exit(1);
+}
+
+async function main() {
+  const provider = createProvider();
+  const prompt = [{ role: 'user', content: 'Reply with exactly: ok' }];
+
+  console.log(`Testing ${providerName}${model ? ` (${model})` : ''}...`);
+
+  try {
+    const result = await provider.generate(prompt, []);
+    console.log(`PASS — Response: "${result.text.trim()}"`);
+    if (result.usage) {
+      console.log(`  Tokens: ${result.usage.inputTokens} in / ${result.usage.outputTokens} out`);
+    }
+  } catch (err) {
+    console.error(`FAIL — ${err.message}`);
+    if (err.status === 401 || err.status === 403) {
+      console.error('  Check your API key. Expected env var:');
+      console.error(`  ${providerName === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY'}`);
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-agent",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "files": [
     "index.js",
     "src/",