orka-cli 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [1.0.0] — 2026-03-12
+
+### Added
+- Live Ink TUI board selama `orka run` (auto-detect TTY, `--no-ink` untuk CI)
+- Mock/demo mode (`--mock`) — test tanpa API key atau Ollama
+- `orka login --provider claude|openai` — credential storage di `~/.orka/credentials.json`
+- `orka logout --provider <name>`, `orka whoami`
+- Claude Code credential import (best-effort)
+- OpenAI/GPT-4o provider
+- Error messages Bahasa Indonesia untuk semua provider errors
+- `ORKA_DEBUG=1` — tampilkan stack trace lengkap
+- AbortSignal support di renderBoard — board unmount bersih saat session selesai
+
+### Foundation (v0.x → v1.0)
+- Multi-agent orchestration: Coordinator + Scout + N Builders + Reviewer
+- Zero file conflict via atomic SQLite file locks
+- Claude dan Ollama provider
+- Auto-branch, auto-merge, rebase, conflict resolution
+- `orka resume` — lanjut dari crash atau pause
+- `orka rollback`, `orka cost`, `orka rules`, `orka memory`, `orka plugin`
+
+### Platform
+macOS dan Linux. Windows tidak didukung penuh di v1.0.

package/CONTRIBUTING.md

@@ -0,0 +1,59 @@
+# Contributing to Orka
+
+## Prerequisites
+
+- Node.js v20+, npm v10+, Git
+- Platform: macOS atau Linux
+  (Windows: `chmod 600` pada credentials.json tidak efektif — known limitation v1.0)
+
+## Setup
+
+```bash
+git clone <repo>
+cd orka
+npm install
+npm test       # 270+ tests
+npm run build  # compile ke dist/
+```
+
+## Quick Demo (tanpa API key)
+
+```bash
+npm run build
+node dist/cli/index.js run "buat CRUD API" --mock
+node dist/cli/index.js whoami
+```
+
+## Real Provider Test
+
+```bash
+node dist/cli/index.js login --provider claude   # import dari Claude Code atau masukkan API key
+node dist/cli/index.js login --provider openai   # masukkan sk-...
+node dist/cli/index.js run "buat hello world"
+```
+
+## Credential Storage
+
+Disimpan di `~/.orka/credentials.json` (chmod 600, plaintext JSON).
+Known limitation v1.0: tidak pakai OS keychain. Auto-refresh direncanakan v1.1.
+
+## Debugging
+
+```bash
+ORKA_DEBUG=1 node dist/cli/index.js run "test" --mock
+```
+
+## Commit Convention
+
+Format: `type(scope): message`
+
+- `feat(cli): ...` — fitur baru
+- `fix(providers): ...` — bug fix
+- `chore: ...` — maintenance
+- `docs: ...` — dokumentasi
+- `test: ...` — perubahan test
+
+## Branch Strategy
+
+- `main` — stabil, langsung ke npm
+- `feature/<nama>` — PR ke main

package/README.md

@@ -0,0 +1,208 @@
+# Orka
+
+Multi-agent coding orchestration CLI. Orka mengorkestrasi AI agents untuk bekerja seperti tim engineering — Coordinator dekomposisi goal, Scout analisis codebase, Builder implementasi paralel, Reviewer jaga kualitas — semua terkoordinasi otomatis tanpa konflik file.
+
+```
+$ orka run "build user authentication with OAuth2 and JWT"
+
+  ┌─────────────────────────────────────────────────────────┐
+  │  Orka — session #a3f2                                   │
+  │  Goal: Build user authentication with OAuth2 and JWT    │
+  │  Elapsed: 2m 34s  │  Tokens: 12.4k  │  Cost: $0.03     │
+  ├──────────┬──────────────────────────┬────────┬──────────┤
+  │  Status  │  Task                    │  Agent │  Files   │
+  ├──────────┼──────────────────────────┼────────┼──────────┤
+  │  ✓ DONE  │  Scan codebase           │  scout │  —       │
+  │  ✓ DONE  │  Auth types & schemas    │  bld-1 │  3 files │
+  │  ◎ REVIEW│  Auth service            │  bld-1 │  2 files │
+  │  ⚡ BUILD │  API routes & middleware │  bld-2 │  4 files │
+  │  ⏳ QUEUE │  Login & signup UI       │  —     │  5 files │
+  └──────────┴──────────────────────────┴────────┴──────────┘
+  [P]ause  [L]ogs  [C]ost detail  [Q]uit
+```
+
+## Fitur
+
+- **Multi-agent paralel** — Coordinator + Scout + N Builders + Reviewer bekerja serentak
+- **Zero file conflict** — file ownership via atomic SQLite lock, tidak ada dua agent edit file yang sama
+- **Review gate** — setiap perubahan di-review Reviewer sebelum di-commit, max 3x retry sebelum eskalasi ke user
+- **Agent-agnostic** — Claude, Ollama (gratis/lokal), OpenAI, Gemini — bisa dicampur per role
+- **Git integration** — auto-branch per task, auto-merge setelah approved, rebase in-flight branches
+- **Survive crash** — state di SQLite, `orka resume` lanjut dari titik terakhir
+- **Cost tracking** — token dan biaya per agent, real-time di TUI
+
+## Instalasi
+
+```bash
+npm install -g orka-cli
+```
+
+Atau run tanpa install:
+```bash
+npx orka-cli init
+```
+
+**Prasyarat:** Node.js v20+, minimal satu LLM provider (API key atau Ollama)
+
+## Quickstart
+
+```bash
+# Bootstrap config awal
+orka init --profile ollama
+
+# Mode core (default): goal -> scout -> coordinator -> builder/reviewer
+orka run "buat CRUD endpoint untuk /api/products"
+
+# Mode manual: pakai target file eksplisit untuk single-task run
+orka run "buat CRUD endpoint untuk /api/products" --files src/api/products.ts
+
+# Rollback ke base commit session terakhir
+orka rollback
+
+# Lihat status implementasi yang sudah tersedia
+orka status
+```
+
+## Konfigurasi
+
+`orka init` akan generate `orka.config.yaml` di root project. Edit manual jika perlu:
+
+```yaml
+providers:
+  claude:
+    apiKey: ${ANTHROPIC_API_KEY}      # dari environment variable
+  ollama:
+    baseUrl: http://localhost:11434
+
+swarm:
+  builders: 2   # jumlah Builder agent paralel
+
+roles:
+  coordinator: { provider: claude, model: claude-sonnet-4-20250514 }
+  scout:       { provider: claude, model: claude-haiku-4-5-20251001 }
+  builder:     { provider: ollama, model: deepseek-coder-v2 }
+  reviewer:    { provider: claude, model: claude-sonnet-4-20250514 }
+
+git:
+  auto_branch: true
+  auto_merge: true
+  commit_prefix: "[orka]"
+  push: false                         # tidak pernah push tanpa izin user
+  conflict_resolution: prompt         # prompt | auto | manual
+```
+
+### Setup Hemat (semua Ollama, gratis)
+
+```yaml
+roles:
+  coordinator: { provider: ollama, model: llama3 }
+  scout:       { provider: ollama, model: llama3 }
+  builder:     { provider: ollama, model: deepseek-coder-v2 }
+  reviewer:    { provider: ollama, model: llama3 }
+```
+
+### Setup Quality (cloud untuk Coordinator & Reviewer)
+
+```yaml
+roles:
+  coordinator: { provider: claude, model: claude-sonnet-4-20250514 }
+  scout:       { provider: claude, model: claude-haiku-4-5-20251001 }
+  builder:     { provider: ollama, model: deepseek-coder-v2 }
+  reviewer:    { provider: claude, model: claude-sonnet-4-20250514 }
+```
+
+## Rules System
+
+Buat `orka.rules.md` di root project untuk mengatur perilaku semua agent:
+
+```markdown
+## Code Style
+- Gunakan Bahasa Indonesia untuk error messages
+- Naming: camelCase untuk functions, PascalCase untuk types
+
+## Architecture
+- Semua API routes di src/app/api/
+- Pakai Zod untuk validation, bukan manual type checking
+```
+
+Global rules (berlaku semua project): `~/.orka/rules.md`
+
+## Commands
+
+```bash
+orka init                              # generate config dari preset
+orka init --wizard                     # setup wizard interaktif
+orka init --profile ollama             # local-first preset (tanpa Claude)
+orka run "goal"                        # auto-planning orchestration flow
+orka run "goal" --files src/app.ts     # manual single-task run
+orka run "goal" --no-git               # nonaktifkan session branch + auto-commit
+orka status                            # tampilkan status board session terakhir
+orka status --ink                      # status board interaktif via Ink
+orka status --watch                    # status board live refresh (text)
+orka board                             # tampilkan session board terakhir
+orka board --watch                     # board mode live refresh
+orka board --ink                       # board interaktif berbasis Ink
+orka board --ink --watch               # board Ink + live refresh
+orka logs                              # activity log session terakhir
+orka logs --session session-123        # filter ke session tertentu
+orka logs --type task:completed        # filter berdasarkan message type
+orka pause                             # pause semua agent
+orka resume                            # lanjut dari pause / crash
+orka rollback                          # rollback session branch terakhir ke base commit
+orka fix                               # resolve git conflict otomatis (LLM)
+orka fix --strategy ours               # pakai versi branch saat ini
+orka fix --strategy theirs             # pakai versi incoming branch
+orka cost                              # token & cost summary
+orka rules edit                        # edit orka.rules.md
+orka memory show                       # tampilkan memory
+orka memory add "catatan"              # tambah entry
+orka memory clear                      # hapus semua memory
+orka plugin add my-plugin              # pasang plugin ke registry lokal
+orka plugin list                       # lihat plugin aktif
+```
+
+## Git Flow
+
+Orka tidak pernah mengubah branch aktif kamu secara langsung:
+
+```
+main (branch kamu)
+  │
+  └── orka/session-<timestamp>        ← session branch
+       ├── orka/task-auth-schemas     ← per-task branch (builder-1)
+       ├── orka/task-auth-service     ← per-task branch (builder-2)
+       └── orka/task-api-routes       ← per-task branch (builder-2)
+```
+
+Setelah semua task approved, Orka tanya: `Merge ke main? [Y/n]`
+
+**Safety rules:**
+- Tidak pernah force push
+- Tidak pernah push ke remote tanpa konfirmasi
+- Merge conflict → pause + notifikasi, tidak auto-resolve diam-diam
+
+## Dokumentasi
+
+- [Design Spec](docs/superpowers/specs/2026-03-11-orka-design.md) — arsitektur lengkap
+- [BRD](docs/superpowers/specs/2026-03-11-brd.md) — business requirements
+- [PRD](docs/superpowers/specs/2026-03-11-prd.md) — product requirements & user stories
+- [ERD](docs/superpowers/specs/2026-03-11-erd.md) — database schema
+- [Contributing](CONTRIBUTING.md) — setup development, commit rules, branching strategy repo
+
+## Roadmap
+
+| Versi | Fitur |
+|-------|-------|
+| **v1.0** | Core orchestration, 4 roles, Claude + Ollama, TUI, git integration, rules, resume |
+| **v1.1** | OpenAI + Gemini, smart context management, memory auto-learning, `--dry-run` |
+| **v1.2** | Plugin system (custom roles, providers, hooks) |
+| **v2.0** | Desktop app (Electron/Tauri) |
+| **v3.0** | Web dashboard + managed cloud service |
+
+## Contributing
+
+Lihat [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT

package/dist/agents/base-agent.d.ts

@@ -0,0 +1,48 @@
+import type { BusMessage, MessageBus } from '../core/bus.js';
+import type { StateStore } from '../core/state.js';
+import { ContextManager } from '../core/context.js';
+import type { ChatMessage, ChatOptions, LLMProvider, TokenUsage } from '../providers/base-provider.js';
+import type { AgentRole, TaskRecord } from '../types.js';
+export interface AgentResult {
+    success: boolean;
+    output: string;
+}
+type Subscription = {
+    type: string;
+    handler: (message: BusMessage) => void;
+};
+export declare abstract class BaseAgent {
+    readonly id: string;
+    protected readonly bus: MessageBus;
+    protected readonly provider: LLMProvider;
+    protected readonly store?: (Pick<StateStore, "registerAgent"> & {
+        recordCost?: (agentId: string, usage: TokenUsage, meta?: {
+            provider?: string;
+            model?: string;
+            sessionId?: string | null;
+        }) => void;
+    }) | undefined;
+    protected readonly sessionId?: string | undefined;
+    protected readonly contextManager?: ContextManager | undefined;
+    abstract readonly role: AgentRole;
+    private unsubscribers;
+    private usage;
+    constructor(id: string, bus: MessageBus, provider: LLMProvider, store?: (Pick<StateStore, "registerAgent"> & {
+        recordCost?: (agentId: string, usage: TokenUsage, meta?: {
+            provider?: string;
+            model?: string;
+            sessionId?: string | null;
+        }) => void;
+    }) | undefined, sessionId?: string | undefined, contextManager?: ContextManager | undefined);
+    initialize(): Promise<void>;
+    listen(): void;
+    stop(): void;
+    abstract execute(task: TaskRecord): Promise<AgentResult>;
+    abstract report(result: AgentResult): void;
+    protected abstract subscriptions(): Subscription[];
+    protected abstract systemPrompt(): string;
+    protected chat(messages: ChatMessage[], options?: ChatOptions): Promise<import("../providers/base-provider.js").ChatResponse>;
+    get totalUsage(): TokenUsage;
+}
+export {};
+//# sourceMappingURL=base-agent.d.ts.map

package/dist/agents/base-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AACtG,OAAO,KAAK,EAAE,SAAS,EAA6B,UAAU,EAAE,MAAM,aAAa,CAAA;AAEnF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAA;CAAE,CAAA;AAE5E,8BAAsB,SAAS;aAOX,EAAE,EAAE,MAAM;IAC1B,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU;IAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW;IACxC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAE,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,GAAG;QAC7D,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,KACpE,IAAI,CAAA;KACV;IACD,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IACrC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc;IAjBpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IAEjC,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,KAAK,CAAkD;gBAG7C,EAAE,EAAE,MAAM,EACP,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,WAAW,EACrB,KAAK,CAAC,GAAE,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,GAAG;QAC7D,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,KACpE,IAAI,CAAA;KACV,aAAA,EACkB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,cAAc,CAAC,EAAE,cAAc,YAAA;IAG9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,MAAM,IAAI,IAAI;IAOd,IAAI,IAAI,IAAI;IAQZ,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAExD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAE1C,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,YAAY,EAAE;IAElD,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM;cAEzB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW;IAanE,IAAI,UAAU,IAAI,UAAU,CAE3B;CACF"}

package/dist/agents/base-agent.js

@@ -0,0 +1,59 @@
+export class BaseAgent {
+    id;
+    bus;
+    provider;
+    store;
+    sessionId;
+    contextManager;
+    unsubscribers = [];
+    usage = { inputTokens: 0, outputTokens: 0 };
+    constructor(id, bus, provider, store, sessionId, contextManager) {
+        this.id = id;
+        this.bus = bus;
+        this.provider = provider;
+        this.store = store;
+        this.sessionId = sessionId;
+        this.contextManager = contextManager;
+    }
+    async initialize() {
+        if (!this.store) {
+            return;
+        }
+        this.store.registerAgent({
+            id: this.id,
+            role: this.role,
+            provider: this.provider.name,
+            model: this.provider.name,
+            status: 'idle',
+            currentTask: null,
+        });
+    }
+    listen() {
+        for (const subscription of this.subscriptions()) {
+            const unsubscribe = this.bus.subscribe(subscription.type, subscription.handler);
+            this.unsubscribers.push(unsubscribe);
+        }
+    }
+    stop() {
+        for (const unsubscribe of this.unsubscribers) {
+            unsubscribe();
+        }
+        this.unsubscribers = [];
+    }
+    async chat(messages, options) {
+        const prepared = this.contextManager ? await this.contextManager.prepare(messages) : messages;
+        const response = await this.provider.chat(prepared, options);
+        this.usage.inputTokens += response.usage.inputTokens;
+        this.usage.outputTokens += response.usage.outputTokens;
+        this.store?.recordCost?.(this.id, response.usage, {
+            provider: this.provider.name,
+            model: this.provider.name,
+            sessionId: this.sessionId ?? null,
+        });
+        return response;
+    }
+    get totalUsage() {
+        return { ...this.usage };
+    }
+}
+//# sourceMappingURL=base-agent.js.map

package/dist/agents/base-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.js","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AAaA,MAAM,OAAgB,SAAS;IAOX;IACG;IACA;IACA;IAOA;IACA;IAfb,aAAa,GAAsB,EAAE,CAAA;IACrC,KAAK,GAAe,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;IAE/D,YACkB,EAAU,EACP,GAAe,EACf,QAAqB,EACrB,KAMlB,EACkB,SAAkB,EAClB,cAA+B;QAXlC,OAAE,GAAF,EAAE,CAAQ;QACP,QAAG,GAAH,GAAG,CAAY;QACf,aAAQ,GAAR,QAAQ,CAAa;QACrB,UAAK,GAAL,KAAK,CAMvB;QACkB,cAAS,GAAT,SAAS,CAAS;QAClB,mBAAc,GAAd,cAAc,CAAiB;IACjD,CAAC;IAEJ,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAM;QACR,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACvB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAoB;YAC5C,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACzB,MAAM,EAAE,MAA4B;YACpC,WAAW,EAAE,IAAI;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,MAAM;QACJ,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YAChD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,IAAa,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;YACxF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAED,IAAI;QACF,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7C,WAAW,EAAE,CAAA;QACf,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;IACzB,CAAC;IAUS,KAAK,CAAC,IAAI,CAAC,QAAuB,EAAE,OAAqB;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QAC7F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC5D,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAA;QACpD,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAA;QACtD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,KAAK,EAAE;YAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YAC5B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;SAClC,CAAC,CAAA;QACF,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/agents/builder.d.ts

@@ -0,0 +1,53 @@
+import type { BusMessage, MessageBus } from '../core/bus.js';
+import type { StateStore } from '../core/state.js';
+import type { LLMProvider } from '../providers/base-provider.js';
+import type { AgentRole, TaskRecord } from '../types.js';
+import { BaseAgent, type AgentResult } from './base-agent.js';
+export interface BuilderFileOps {
+    isOwnedBy(filePath: string, agentId: string): boolean;
+    writeFile(path: string, content: string): Promise<void>;
+    readFile(path: string): Promise<string>;
+}
+interface FileChange {
+    path: string;
+    content: string;
+}
+export declare class BuilderAgent extends BaseAgent {
+    private readonly fileOps;
+    readonly role: AgentRole;
+    private codebaseBrief;
+    private reviewFeedback;
+    private currentTask;
+    private pendingReviews;
+    constructor(id: string, bus: MessageBus, provider: LLMProvider, fileOps: BuilderFileOps, store?: Pick<StateStore, 'registerAgent'> & {
+        recordCost?: (agentId: string, usage: {
+            inputTokens: number;
+            outputTokens: number;
+        }, meta?: {
+            provider?: string;
+            model?: string;
+            sessionId?: string | null;
+        }) => void;
+    }, sessionId?: string);
+    protected subscriptions(): {
+        type: string;
+        handler: (message: BusMessage) => void;
+    }[];
+    protected systemPrompt(): string;
+    execute(task: TaskRecord): Promise<AgentResult>;
+    private buildPrompt;
+    private extractJson;
+    applyChanges(agentId: string, changes: FileChange[]): Promise<{
+        applied: string[];
+        rejected: string[];
+    }>;
+    report(result: AgentResult): void;
+    setCodebaseBrief(brief: string): void;
+    setReviewFeedback(feedback: string): void;
+    get currentTaskId(): string | null;
+    addPendingReview(taskId: string): void;
+    removePendingReview(taskId: string): void;
+    get pendingReviewCount(): number;
+}
+export {};
+//# sourceMappingURL=builder.d.ts.map

package/dist/agents/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/agents/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACxC;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,YAAa,SAAQ,SAAS;IAWvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAY;IACpC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,cAAc,CAAoB;gBAGxC,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,WAAW,EACJ,OAAO,EAAE,cAAc,EACxC,KAAK,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,GAAG;QAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,EAAE,IAAI,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,KAAK,IAAI,CAAA;KACtK,EACD,SAAS,CAAC,EAAE,MAAM;IAKpB,SAAS,CAAC,aAAa;;2BAIE,UAAU;;IAsBnC,SAAS,CAAC,YAAY,IAAI,MAAM;IAc1B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBrD,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,WAAW;IAoBb,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAgB9G,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAajC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIzC,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzC,IAAI,kBAAkB,IAAI,MAAM,CAE/B;CACF"}

package/dist/agents/builder.js

@@ -0,0 +1,147 @@
+import { BaseAgent } from './base-agent.js';
+export class BuilderAgent extends BaseAgent {
+    fileOps;
+    role = 'builder';
+    codebaseBrief = null;
+    reviewFeedback = null;
+    currentTask = null;
+    pendingReviews = new Set();
+    constructor(id, bus, provider, fileOps, store, sessionId) {
+        super(id, bus, provider, store, sessionId);
+        this.fileOps = fileOps;
+    }
+    subscriptions() {
+        return [
+            {
+                type: 'task:assigned',
+                handler: (message) => {
+                    if (message.payload.target === this.id) {
+                        this.bus.publish({
+                            type: 'agent:status',
+                            agentId: this.id,
+                            payload: { status: 'building', taskId: message.taskId },
+                            timestamp: Date.now(),
+                        });
+                    }
+                },
+            },
+            {
+                type: 'task:rejected',
+                handler: (message) => {
+                    if (message.payload.builder === this.id) {
+                        this.reviewFeedback = message.payload.feedback;
+                    }
+                },
+            },
+        ];
+    }
+    systemPrompt() {
+        let prompt = `You are a Builder agent — a senior software engineer.
+Your job is to implement code changes for a given task.
+Output your changes as JSON: { "files": [{ "path": "...", "content": "..." }] }
+Only modify files that you have been assigned ownership of.
+Ensure code is correct, follows project conventions, and handles edge cases.`;
+        if (this.codebaseBrief) {
+            prompt += `\n\nCodebase Brief:\n${this.codebaseBrief}`;
+        }
+        return prompt;
+    }
+    async execute(task) {
+        this.currentTask = task.id;
+        const response = await this.chat([
+            { role: 'system', content: this.systemPrompt() },
+            { role: 'user', content: this.buildPrompt(task) },
+        ]);
+        try {
+            const parsed = this.extractJson(response.content);
+            if (parsed?.files?.length) {
+                const result = await this.applyChanges(this.id, parsed.files);
+                return {
+                    success: result.rejected.length === 0,
+                    output: response.content,
+                };
+            }
+        }
+        catch {
+            return { success: true, output: response.content };
+        }
+        return { success: true, output: response.content };
+    }
+    buildPrompt(task) {
+        let prompt = `Task: ${task.goal}\n\nOwned files:\n${task.filesOwned.join('\n')}`;
+        if (this.reviewFeedback) {
+            prompt += `\n\nPrevious review feedback (attempt ${task.reviewAttempts}):\n${this.reviewFeedback}`;
+            this.reviewFeedback = null;
+        }
+        return prompt;
+    }
+    extractJson(content) {
+        // Strategy 1: content is pure JSON
+        try {
+            return JSON.parse(content.trim());
+        }
+        catch { /* continue */ }
+        // Strategy 2: JSON inside a ```json ... ``` fence (anywhere in the response)
+        const fenceMatch = content.match(/```(?:json)?\s*([\s\S]*?)```/i);
+        if (fenceMatch) {
+            try {
+                return JSON.parse(fenceMatch[1].trim());
+            }
+            catch { /* continue */ }
+        }
+        // Strategy 3: find first { to last } (handles text before/after JSON)
+        const start = content.indexOf('{');
+        const end = content.lastIndexOf('}');
+        if (start !== -1 && end > start) {
+            try {
+                return JSON.parse(content.slice(start, end + 1));
+            }
+            catch { /* continue */ }
+        }
+        return null;
+    }
+    async applyChanges(agentId, changes) {
+        const applied = [];
+        const rejected = [];
+        for (const change of changes) {
+            if (this.fileOps.isOwnedBy(change.path, agentId)) {
+                await this.fileOps.writeFile(change.path, change.content);
+                applied.push(change.path);
+            }
+            else {
+                rejected.push(change.path);
+            }
+        }
+        return { applied, rejected };
+    }
+    report(result) {
+        const taskId = this.currentTask;
+        this.currentTask = null;
+        this.bus.publish({
+            type: 'task:completed',
+            agentId: this.id,
+            taskId: taskId ?? undefined,
+            payload: { output: result.output },
+            timestamp: Date.now(),
+        });
+    }
+    setCodebaseBrief(brief) {
+        this.codebaseBrief = brief;
+    }
+    setReviewFeedback(feedback) {
+        this.reviewFeedback = feedback;
+    }
+    get currentTaskId() {
+        return this.currentTask;
+    }
+    addPendingReview(taskId) {
+        this.pendingReviews.add(taskId);
+    }
+    removePendingReview(taskId) {
+        this.pendingReviews.delete(taskId);
+    }
+    get pendingReviewCount() {
+        return this.pendingReviews.size;
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/agents/builder.js.map

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

package/dist/agents/coordinator.d.ts

@@ -0,0 +1,45 @@
+import type { BusMessage, MessageBus } from '../core/bus.js';
+import type { StateStore } from '../core/state.js';
+import type { LLMProvider } from '../providers/base-provider.js';
+import type { AgentRole, TaskRecord } from '../types.js';
+import { BaseAgent, type AgentResult } from './base-agent.js';
+interface DecomposedTask {
+    id: string;
+    goal: string;
+    dependencies: string[];
+    files: string[];
+}
+interface FileConflict {
+    file: string;
+    tasks: string[];
+}
+type CostStore = Pick<StateStore, 'registerAgent'> & {
+    recordCost?: (agentId: string, usage: {
+        inputTokens: number;
+        outputTokens: number;
+    }, meta?: {
+        provider?: string;
+        model?: string;
+        sessionId?: string | null;
+    }) => void;
+};
+export declare class CoordinatorAgent extends BaseAgent {
+    readonly role: AgentRole;
+    private codebaseBrief;
+    constructor(id: string, bus: MessageBus, provider: LLMProvider, store?: CostStore, sessionId?: string);
+    protected subscriptions(): {
+        type: string;
+        handler: (message: BusMessage) => void;
+    }[];
+    protected systemPrompt(): string;
+    execute(task: TaskRecord): Promise<AgentResult>;
+    decompose(goal: string): Promise<DecomposedTask[]>;
+    detectFileConflicts(tasks: DecomposedTask[]): FileConflict[];
+    resolveConflicts(tasks: DecomposedTask[]): DecomposedTask[];
+    toTaskRecords(tasks: DecomposedTask[], sessionId: string): TaskRecord[];
+    startSession(sessionId: string, goal: string): void;
+    report(result: AgentResult): void;
+    setCodebaseBrief(brief: string): void;
+}
+export {};
+//# sourceMappingURL=coordinator.d.ts.map