bare-agent 0.2.0 → 0.2.1

package/README.md

@@ -13,7 +13,7 @@
 
 # bare-agent
 
-**Agent orchestration in ~800 lines. Zero required deps. MIT license.**
+**Agent orchestration in ~1500 lines. Zero required deps. MIT license.**
 
 Everything between "call the LLM" and "ship the agent" — loop, plan, remember, schedule, checkpoint. Each works alone. All compose together.
 
@@ -217,12 +217,19 @@ Same pattern works from Go, Rust, Java, Ruby — any language that can spawn a p
 required:     0
 optional:     cron-parser (for cron expressions in scheduler)
 peer:         better-sqlite3 (for SQLite memory store)
-total lines:  ~820
+total lines:  ~1500
 ```
 
 ## Status
 
-Early development. Core components built and validated through POCs. See [project plan](docs/01-product/prd.md) for the full design.
+**Production-validated.** bare-agent powers the SOAR2 pipeline in [Aurora](https://github.com/hamr0/aurora), replacing ~400 lines of hand-rolled agent orchestration with ~60 lines of bare-agent wiring. In production use, bare-agent eliminated:
+
+- **Boilerplate** — Tool-calling loop, provider normalization, retry logic, and state tracking that every agent project reinvents. Aurora's SOAR2 pipeline dropped from custom loop + manual state management to `Loop + Planner + runPlan + StateMachine`.
+- **Fragile glue code** — Manual wave execution, dependency resolution, and error propagation replaced by `runPlan` with built-in parallelism and failure cascading.
+- **Provider lock-in** — Switching from OpenAI to Anthropic to CLIPipe required zero orchestration changes — just swap the provider constructor.
+- **Debugging friction** — Structured `[ComponentName]` error prefixes and `Stream` events made failures traceable in minutes instead of hours.
+
+See [project plan](docs/01-product/prd.md) for the full design. See [CHANGELOG.md](CHANGELOG.md) for release history.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-agent",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "files": [
     "index.js",
     "src/",
@@ -20,7 +20,8 @@
   "exports": {
     ".": "./index.js",
     "./providers": "./src/providers.js",
-    "./stores": "./src/stores.js"
+    "./stores": "./src/stores.js",
+    "./transports": "./src/transports.js"
   },
   "engines": {
     "node": ">=18"

package/src/provider-clipipe.js

@@ -11,6 +11,7 @@ class CLIPipeProvider {
    * @param {string} [options.cwd] - Working directory for the child process.
    * @param {object} [options.env] - Environment variables for the child process.
    * @param {number} [options.timeout=30000] - Timeout in milliseconds.
+   * @param {string} [options.systemPromptFlag] - CLI flag for system prompt (e.g. '--system'). When set, system messages are extracted and passed via this flag instead of stdin.
    * @throws {Error} `[CLIPipeProvider] requires command` — when options.command is missing.
    */
   constructor(options = {}) {
@@ -20,6 +21,7 @@ class CLIPipeProvider {
     this.cwd = options.cwd || undefined;
     this.env = options.env || undefined;
     this.timeout = options.timeout ?? 30000;
+    this.systemPromptFlag = options.systemPromptFlag || null;
   }
 
   /**
@@ -34,8 +36,20 @@ class CLIPipeProvider {
    * @throws {Error} `[CLIPipeProvider] process produced no output` — when stdout is empty.
    */
   async generate(messages, tools = [], options = {}) {
-    const prompt = this._formatPrompt(messages);
-    const text = await this._spawn(prompt);
+    let extraArgs = [];
+    let promptMessages = messages;
+
+    if (this.systemPromptFlag) {
+      const systemMessages = messages.filter(m => m.role === 'system');
+      if (systemMessages.length > 0) {
+        const systemContent = systemMessages.map(m => m.content).join('\n\n');
+        extraArgs = [this.systemPromptFlag, systemContent];
+        promptMessages = messages.filter(m => m.role !== 'system');
+      }
+    }
+
+    const prompt = this._formatPrompt(promptMessages);
+    const text = await this._spawn(prompt, extraArgs);
     return {
       text,
       toolCalls: [],
@@ -58,11 +72,12 @@ class CLIPipeProvider {
   /**
    * Spawn the CLI process, pipe prompt to stdin, collect stdout.
    * @param {string} prompt
+   * @param {string[]} [extraArgs=[]] - Additional args prepended to this.args.
    * @returns {Promise<string>}
    */
-  _spawn(prompt) {
+  _spawn(prompt, extraArgs = []) {
     return new Promise((resolve, reject) => {
-      const child = spawn(this.command, this.args, {
+      const child = spawn(this.command, [...this.args, ...extraArgs], {
         cwd: this.cwd,
         env: this.env,
         stdio: ['pipe', 'pipe', 'pipe'],

package/src/run-plan.js

@@ -10,6 +10,7 @@
  * @param {function} [options.onStepStart] - Callback(step) fired when a step begins.
  * @param {function} [options.onStepDone] - Callback(step, result) fired on success.
  * @param {function} [options.onStepFail] - Callback(step, error) fired on failure.
+ * @param {function} [options.onWaveStart] - Callback(waveNumber, steps) fired before each wave executes.
  * @returns {Promise<Array<{id: string, status: string, result?: *, error?: string}>>}
  * @throws {Error} `[runPlan] steps must be a non-empty array` — when steps is not a non-empty array.
  * @throws {Error} `[runPlan] executeFn must be a function` — when executeFn is not a function.
@@ -47,7 +48,9 @@ async function runPlan(steps, executeFn, options = {}) {
     }
   }
 
-  const { concurrency = Infinity, stateMachine, onStepStart, onStepDone, onStepFail } = options;
+  const { concurrency = Infinity, stateMachine, onStepStart, onStepDone, onStepFail, onWaveStart } = options;
+
+  let waveNumber = 0;
 
   // Wave loop
   while (true) {
@@ -81,6 +84,9 @@ async function runPlan(steps, executeFn, options = {}) {
     // Apply concurrency limit
     const wave = ready.slice(0, concurrency);
 
+    waveNumber++;
+    onWaveStart?.(waveNumber, wave.map(e => e.step));
+
     // Execute wave
     await Promise.all(wave.map(async entry => {
       const { step } = entry;

package/src/transports.js

@@ -0,0 +1,3 @@
+'use strict';
+const { JsonlTransport } = require('./transport-jsonl');
+module.exports = { JsonlTransport };