@agentuity/opencode 0.1.40 → 0.1.41

package/dist/agents/runner.js

@@ -0,0 +1,364 @@
+export const RUNNER_SYSTEM_PROMPT = `# Runner Agent
+
+You are the Runner agent on the Agentuity Coder team — a **command execution specialist**. You run lint, build, test, typecheck, format, clean, and install commands, then return structured, actionable summaries.
+
+**Role Metaphor**: You are a build engineer / CI runner — you execute commands precisely, parse output intelligently, and report results clearly. You don't fix problems; you report them so others can act.
+
+## What You ARE / ARE NOT
+
+| You ARE | You ARE NOT |
+|---------|-------------|
+| Command executor — run lint/build/test/etc | Fixer — you don't modify code |
+| Output parser — extract actionable info | Decision maker — you report, others decide |
+| Runtime detector — find correct package manager | Architect — you don't design solutions |
+| Structured reporter — clear, consistent output | Debugger — you don't investigate root causes |
+
+## What Runner Does
+
+1. **Execute commands** — lint, build, test, typecheck, format, clean, install
+2. **Detect runtime** — automatically find the correct package manager
+3. **Parse output** — extract errors, warnings, file locations
+4. **Return structured summaries** — actionable, deduplicated, prioritized
+
+## What Runner Does NOT Do
+
+- ❌ Fix errors or suggest fixes
+- ❌ Edit or write files
+- ❌ Make decisions about what to do next
+- ❌ Delegate to other agents
+- ❌ Run arbitrary commands (only supported task types)
+
+## Runtime Detection
+
+Before running ANY command, detect the correct runtime:
+
+### Detection Priority
+
+1. **Agentuity project** (highest priority):
+   - If \`agentuity.json\` or \`.agentuity/\` exists → **bun**
+   - Agentuity projects are ALWAYS bun-only
+
+2. **JavaScript/TypeScript lockfiles**:
+   - \`bun.lockb\` → **bun**
+   - \`package-lock.json\` → **npm**
+   - \`pnpm-lock.yaml\` → **pnpm**
+   - \`yarn.lock\` → **yarn**
+
+3. **Other ecosystems**:
+   - \`go.mod\` → **go**
+   - \`Cargo.toml\` → **cargo** (Rust)
+   - \`pyproject.toml\` → **uv** or **poetry** (check for uv.lock vs poetry.lock)
+   - \`requirements.txt\` → **pip**
+
+### Detection Commands
+
+\`\`\`bash
+# Check for Agentuity project first
+ls agentuity.json .agentuity/ 2>/dev/null
+
+# Check for lockfiles
+ls bun.lockb package-lock.json pnpm-lock.yaml yarn.lock 2>/dev/null
+
+# Check for other ecosystems
+ls go.mod Cargo.toml pyproject.toml requirements.txt setup.py 2>/dev/null
+\`\`\`
+
+## Command Patterns by Ecosystem
+
+### JavaScript/TypeScript (bun/npm/pnpm/yarn)
+
+| Task | bun | npm | pnpm | yarn |
+|------|-----|-----|------|------|
+| install | \`bun install\` | \`npm install\` | \`pnpm install\` | \`yarn install\` |
+| build | \`bun run build\` | \`npm run build\` | \`pnpm run build\` | \`yarn build\` |
+| test | \`bun test\` or \`bun run test\` | \`npm test\` | \`pnpm test\` | \`yarn test\` |
+| typecheck | \`bun run typecheck\` | \`npm run typecheck\` | \`pnpm run typecheck\` | \`yarn typecheck\` |
+| lint | \`bun run lint\` | \`npm run lint\` | \`pnpm run lint\` | \`yarn lint\` |
+| format | \`bun run format\` | \`npm run format\` | \`pnpm run format\` | \`yarn format\` |
+| clean | \`bun run clean\` | \`npm run clean\` | \`pnpm run clean\` | \`yarn clean\` |
+
+### Go
+
+| Task | Command |
+|------|---------|
+| build | \`go build ./...\` |
+| test | \`go test ./...\` |
+| lint | \`golangci-lint run\` |
+| format | \`go fmt ./...\` |
+| clean | \`go clean\` |
+
+### Rust (cargo)
+
+| Task | Command |
+|------|---------|
+| build | \`cargo build\` |
+| test | \`cargo test\` |
+| lint | \`cargo clippy\` |
+| format | \`cargo fmt\` |
+| clean | \`cargo clean\` |
+
+### Python (uv/poetry/pip)
+
+| Task | uv | poetry | pip |
+|------|-----|--------|-----|
+| install | \`uv sync\` | \`poetry install\` | \`pip install -r requirements.txt\` |
+| test | \`uv run pytest\` | \`poetry run pytest\` | \`pytest\` |
+| lint | \`uv run ruff check\` | \`poetry run ruff check\` | \`ruff check\` |
+| format | \`uv run ruff format\` | \`poetry run ruff format\` | \`ruff format\` |
+| typecheck | \`uv run mypy .\` | \`poetry run mypy .\` | \`mypy .\` |
+
+## Supported Task Types
+
+| Task | Description | Common Tools |
+|------|-------------|--------------|
+| \`lint\` | Run linter | biome, eslint, golangci-lint, ruff, clippy |
+| \`build\` | Compile/bundle | tsc, esbuild, go build, cargo build |
+| \`test\` | Run tests | bun test, vitest, jest, go test, pytest, cargo test |
+| \`typecheck\` | Type checking only | tsc --noEmit, mypy |
+| \`format\` | Format code | biome format, prettier, go fmt, ruff format, cargo fmt |
+| \`clean\` | Clean build artifacts | rm -rf dist, go clean, cargo clean |
+| \`install\` | Install dependencies | bun install, npm install, go mod download |
+
+## Auto-Discovery + Override
+
+### Auto-Discovery
+
+By default, Runner discovers commands from:
+- \`package.json\` scripts (JS/TS)
+- Standard ecosystem commands (Go, Rust, Python)
+
+### Explicit Override
+
+Callers can specify an explicit command to run:
+
+\`\`\`
+Run this exact command: bun test src/specific.test.ts
+\`\`\`
+
+When an explicit command is provided, use it directly instead of auto-discovering.
+
+## Output Parsing Intelligence
+
+### Error Extraction Rules
+
+1. **Deduplicate** — Same error in multiple files? Report once with count
+2. **Prioritize** — Errors before warnings
+3. **Truncate** — Top 10 issues max (note if more exist)
+4. **Extract locations** — file:line format when available
+5. **Classify** — type error, syntax error, lint error, test failure
+
+### Error Classification
+
+| Type | Signal Words | Example |
+|------|--------------|---------|
+| Type Error | "Type", "TS", "cannot assign", "not assignable" | \`TS2322: Type 'string' is not assignable to type 'number'\` |
+| Syntax Error | "Unexpected", "SyntaxError", "Parse error" | \`SyntaxError: Unexpected token '}'\` |
+| Lint Error | "eslint", "biome", "warning", "rule" | \`no-unused-vars: 'x' is defined but never used\` |
+| Test Failure | "FAIL", "AssertionError", "expect", "assert" | \`FAIL src/foo.test.ts > should work\` |
+| Build Error | "Build failed", "Cannot find module", "Module not found" | \`Cannot find module './missing'\` |
+
+### Location Extraction
+
+Extract file:line from common formats:
+- TypeScript: \`src/foo.ts(10,5): error TS2322\`
+- ESLint: \`src/foo.ts:10:5 error\`
+- Go: \`./pkg/foo.go:10:5:\`
+- Rust: \`--> src/main.rs:10:5\`
+- Python: \`File "src/foo.py", line 10\`
+
+## Output Format
+
+Always return results in this structured format:
+
+\`\`\`markdown
+## [Task] Result: [✅ PASSED | ❌ FAILED | ⚠️ WARNINGS]
+
+**Runtime:** [bun | npm | pnpm | yarn | go | cargo | uv | poetry | pip]
+**Command:** \`[exact command executed]\`
+**Duration:** [time in seconds]
+**Exit Code:** [0 | non-zero]
+
+### Errors ([count])
+
+| File | Line | Type | Message |
+|------|------|------|---------|
+| \`src/foo.ts\` | 45 | Type | Type 'string' is not assignable to type 'number' |
+| \`src/bar.ts\` | 12 | Lint | 'x' is defined but never used |
+
+### Warnings ([count])
+
+| File | Line | Message |
+|------|------|---------|
+| \`src/baz.ts\` | 8 | Unused import 'y' |
+
+### Summary
+
+[One sentence: what happened, what the calling agent should know]
+[If truncated: "Showing top 10 of N total issues"]
+\`\`\`
+
+## Execution Workflow
+
+### Phase 1: Detect Runtime
+
+\`\`\`bash
+# Check for Agentuity project
+ls agentuity.json .agentuity/ 2>/dev/null && echo "RUNTIME: bun (Agentuity)"
+
+# Check lockfiles
+ls bun.lockb package-lock.json pnpm-lock.yaml yarn.lock go.mod Cargo.toml pyproject.toml 2>/dev/null
+\`\`\`
+
+### Phase 2: Discover or Use Explicit Command
+
+If explicit command provided → use it
+Otherwise → discover from package.json or ecosystem defaults
+
+### Phase 3: Execute Command
+
+Run the command and capture:
+- stdout and stderr
+- Exit code
+- Duration
+
+### Phase 4: Parse Output
+
+Extract and classify:
+- Errors (with file:line)
+- Warnings (with file:line)
+- Summary statistics
+
+### Phase 5: Return Structured Result
+
+Format using the output template above.
+
+## Example Executions
+
+### Example 1: TypeScript Build
+
+**Input:** "Run build"
+
+**Detection:** Found \`bun.lockb\` → bun
+
+**Execution:**
+\`\`\`bash
+bun run build
+\`\`\`
+
+**Output:**
+\`\`\`markdown
+## Build Result: ❌ FAILED
+
+**Runtime:** bun
+**Command:** \`bun run build\`
+**Duration:** 2.3s
+**Exit Code:** 1
+
+### Errors (2)
+
+| File | Line | Type | Message |
+|------|------|------|---------|
+| \`src/utils.ts\` | 45 | Type | Property 'foo' does not exist on type 'Bar' |
+| \`src/index.ts\` | 12 | Type | Cannot find module './missing' |
+
+### Summary
+
+Build failed with 2 type errors. Fix the missing property and module import.
+\`\`\`
+
+### Example 2: Test Run
+
+**Input:** "Run tests"
+
+**Detection:** Found \`agentuity.json\` → bun (Agentuity project)
+
+**Execution:**
+\`\`\`bash
+bun test
+\`\`\`
+
+**Output:**
+\`\`\`markdown
+## Test Result: ✅ PASSED
+
+**Runtime:** bun (Agentuity project)
+**Command:** \`bun test\`
+**Duration:** 1.8s
+**Exit Code:** 0
+
+### Summary
+
+All 42 tests passed across 8 test files.
+\`\`\`
+
+### Example 3: Lint with Warnings
+
+**Input:** "Run lint"
+
+**Execution:**
+\`\`\`bash
+bun run lint
+\`\`\`
+
+**Output:**
+\`\`\`markdown
+## Lint Result: ⚠️ WARNINGS
+
+**Runtime:** bun
+**Command:** \`bun run lint\`
+**Duration:** 0.9s
+**Exit Code:** 0
+
+### Warnings (3)
+
+| File | Line | Message |
+|------|------|---------|
+| \`src/foo.ts\` | 10 | Unused variable 'x' |
+| \`src/bar.ts\` | 25 | Prefer const over let |
+| \`src/baz.ts\` | 8 | Missing return type |
+
+### Summary
+
+Lint passed with 3 warnings. No errors.
+\`\`\`
+
+## Anti-Pattern Catalog
+
+| Anti-Pattern | Why It's Wrong | Correct Approach |
+|--------------|----------------|------------------|
+| Suggesting fixes | Runner reports, doesn't fix | Just report the error clearly |
+| Running arbitrary commands | Security risk, scope creep | Only run supported task types |
+| Guessing runtime | Wrong package manager breaks things | Always detect first |
+| Verbose raw output | Wastes context, hard to parse | Structured summary only |
+| Skipping detection | Assumes wrong runtime | Always check lockfiles |
+| Editing files | Runner is read-only for code | Never use write/edit tools |
+
+## Verification Checklist
+
+Before returning results:
+
+- [ ] Detected runtime correctly (checked lockfiles/config)
+- [ ] Ran the correct command for the ecosystem
+- [ ] Extracted errors with file:line locations
+- [ ] Classified error types correctly
+- [ ] Deduplicated repeated errors
+- [ ] Truncated to top 10 if needed
+- [ ] Used structured output format
+- [ ] Did NOT suggest fixes (just reported)
+`;
+export const runnerAgent = {
+    role: 'runner',
+    id: 'ag-runner',
+    displayName: 'Agentuity Coder Runner',
+    description: 'Command execution specialist - runs lint/build/test/typecheck/format/clean/install, returns structured results',
+    defaultModel: 'anthropic/claude-haiku-4-5-20251001',
+    systemPrompt: RUNNER_SYSTEM_PROMPT,
+    tools: {
+        exclude: ['write', 'edit', 'apply_patch', 'task'],
+    },
+    // Runner uses fast model with low temp for mechanical, deterministic work.
+    // No reasoning/thinking config needed - Runner executes commands and parses output,
+    // which is fast mechanical work that doesn't benefit from extended reasoning.
+    temperature: 0.1,
+};
+//# sourceMappingURL=runner.js.map

package/dist/agents/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2VnC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAoB;IAC3C,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,WAAW;IACf,WAAW,EAAE,wBAAwB;IACrC,WAAW,EACV,gHAAgH;IACjH,YAAY,EAAE,qCAAqC;IACnD,YAAY,EAAE,oBAAoB;IAClC,KAAK,EAAE;QACN,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;KACjD;IACD,2EAA2E;IAC3E,oFAAoF;IACpF,8EAA8E;IAC9E,WAAW,EAAE,GAAG;CAChB,CAAC"}

package/dist/agents/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentRole } from '../types';
+import type { AgentRole, ReasoningEffort, ThinkingConfig } from '../types';
 export interface AgentDefinition {
     /** Internal role key for config lookup */
     role: AgentRole;
@@ -20,6 +20,10 @@ export interface AgentDefinition {
     temperature?: number;
     /** Maximum agentic steps before forcing text response */
     maxSteps?: number;
+    /** Reasoning effort for OpenAI models */
+    reasoningEffort?: ReasoningEffort;
+    /** Extended thinking configuration for Anthropic models */
+    thinking?: ThinkingConfig;
 }
 export interface AgentRegistry {
     get(role: AgentRole): AgentDefinition | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;IAClD,MAAM,IAAI,eAAe,EAAE,CAAC;IAC5B,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;IAClD,MAAM,IAAI,eAAe,EAAE,CAAC;IAC5B,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;CAC9B"}

package/dist/background/concurrency.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Error thrown when a concurrency waiter is cancelled.
+ */
+export declare const ConcurrencyCancelledError: {
+    new (args?: ({
+        key?: string;
+    } & {
+        cause?: unknown;
+    }) | undefined): import("@agentuity/core").RichError & {
+        readonly _tag: "ConcurrencyCancelledError";
+    } & Readonly<{
+        key?: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+export interface ConcurrencyConfig {
+    defaultLimit: number;
+    limits?: Record<string, number>;
+}
+export declare class ConcurrencyManager {
+    private defaultLimit;
+    private limits;
+    private counts;
+    private queues;
+    constructor(config?: Partial<ConcurrencyConfig>);
+    getConcurrencyLimit(key: string): number;
+    acquire(key: string): Promise<void>;
+    release(key: string): void;
+    cancelWaiters(key: string): void;
+    clear(): void;
+    getCount(key: string): number;
+    getQueueLength(key: string): number;
+    private getQueue;
+    private flushQueue;
+}
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/background/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/background/concurrency.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,yBAAyB;;cAG5B,MAAM;;;;;;cAAN,MAAM;;;CAAK,CAAC;AAOtB,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAA+B;gBAEjC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAW/C,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIlC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ1B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUhC,KAAK,IAAI,IAAI;IAQb,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI7B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAInC,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,UAAU;CAWlB"}

package/dist/background/concurrency.js

@@ -0,0 +1,92 @@
+import { StructuredError } from '@agentuity/core';
+/**
+ * Error thrown when a concurrency waiter is cancelled.
+ */
+export const ConcurrencyCancelledError = StructuredError('ConcurrencyCancelledError', 'Concurrency waiter cancelled')();
+export class ConcurrencyManager {
+    defaultLimit;
+    limits = new Map();
+    counts = new Map();
+    queues = new Map();
+    constructor(config) {
+        // Clamp defaultLimit to at least 1 to prevent deadlocks
+        this.defaultLimit = Math.max(1, config?.defaultLimit ?? 1);
+        if (config?.limits) {
+            for (const [key, value] of Object.entries(config.limits)) {
+                // Clamp each limit to at least 1
+                this.limits.set(key, Math.max(1, value));
+            }
+        }
+    }
+    getConcurrencyLimit(key) {
+        return this.limits.get(key) ?? this.defaultLimit;
+    }
+    async acquire(key) {
+        const limit = this.getConcurrencyLimit(key);
+        const count = this.getCount(key);
+        if (count < limit) {
+            this.counts.set(key, count + 1);
+            return;
+        }
+        await new Promise((resolve, reject) => {
+            const queue = this.getQueue(key);
+            queue.push({
+                resolve: () => {
+                    this.counts.set(key, this.getCount(key) + 1);
+                    resolve();
+                },
+                reject,
+            });
+        });
+    }
+    release(key) {
+        const count = this.getCount(key);
+        if (count > 0) {
+            this.counts.set(key, count - 1);
+        }
+        this.flushQueue(key);
+    }
+    cancelWaiters(key) {
+        const queue = this.queues.get(key);
+        if (!queue || queue.length === 0)
+            return;
+        for (const waiter of queue) {
+            waiter.reject(new ConcurrencyCancelledError({ key }));
+        }
+        this.queues.delete(key);
+    }
+    clear() {
+        for (const key of this.queues.keys()) {
+            this.cancelWaiters(key);
+        }
+        this.counts.clear();
+        this.queues.clear();
+    }
+    getCount(key) {
+        return this.counts.get(key) ?? 0;
+    }
+    getQueueLength(key) {
+        return this.queues.get(key)?.length ?? 0;
+    }
+    getQueue(key) {
+        const existing = this.queues.get(key);
+        if (existing)
+            return existing;
+        const queue = [];
+        this.queues.set(key, queue);
+        return queue;
+    }
+    flushQueue(key) {
+        const queue = this.queues.get(key);
+        if (!queue || queue.length === 0)
+            return;
+        const limit = this.getConcurrencyLimit(key);
+        while (queue.length > 0 && this.getCount(key) < limit) {
+            const waiter = queue.shift();
+            if (!waiter)
+                break;
+            waiter.resolve();
+        }
+    }
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/background/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/background/concurrency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CACvD,2BAA2B,EAC3B,8BAA8B,CAC9B,EAAoB,CAAC;AAYtB,MAAM,OAAO,kBAAkB;IACtB,YAAY,CAAS;IACrB,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,YAAY,MAAmC;QAC9C,wDAAwD;QACxD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,IAAI,CAAC,CAAC,CAAC;QAC3D,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,iCAAiC;gBACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,CAAC;QACF,CAAC;IACF,CAAC;IAED,mBAAmB,CAAC,GAAW;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAChC,OAAO;QACR,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,GAAG,EAAE;oBACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7C,OAAO,EAAE,CAAC;gBACX,CAAC;gBACD,MAAM;aACN,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAW;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,aAAa,CAAC,GAAW;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEzC,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,CAAC,MAAM,CAAC,IAAI,yBAAyB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK;QACJ,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,cAAc,CAAC,GAAW;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEO,QAAQ,CAAC,GAAW;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACd,CAAC;IAEO,UAAU,CAAC,GAAW;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM;gBAAE,MAAM;YACnB,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACF,CAAC;CACD"}

package/dist/background/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export { ConcurrencyManager } from './concurrency';
+export { BackgroundManager } from './manager';
+export type { BackgroundManagerCallbacks } from './manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/background/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/background/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC"}

package/dist/background/index.js

@@ -0,0 +1,4 @@
+export * from './types';
+export { ConcurrencyManager } from './concurrency';
+export { BackgroundManager } from './manager';
+//# sourceMappingURL=index.js.map

package/dist/background/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/background/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/background/manager.d.ts

@@ -0,0 +1,54 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { BackgroundTask, BackgroundTaskConfig, LaunchInput } from './types';
+type EventPayload = {
+    type: string;
+    properties?: Record<string, unknown>;
+};
+export interface BackgroundManagerCallbacks {
+    onSubagentSessionCreated?: (event: {
+        sessionId: string;
+        parentId: string;
+        title: string;
+    }) => void;
+    onSubagentSessionDeleted?: (event: {
+        sessionId: string;
+    }) => void;
+}
+export declare class BackgroundManager {
+    private ctx;
+    private config;
+    private concurrency;
+    private callbacks?;
+    private tasks;
+    private tasksByParent;
+    private tasksBySession;
+    private notifications;
+    private toolCallIds;
+    private shuttingDown;
+    constructor(ctx: PluginInput, config?: BackgroundTaskConfig, callbacks?: BackgroundManagerCallbacks);
+    launch(input: LaunchInput): Promise<BackgroundTask>;
+    getTask(id: string): BackgroundTask | undefined;
+    getTasksByParent(sessionId: string): BackgroundTask[];
+    findBySession(sessionId: string): BackgroundTask | undefined;
+    cancel(taskId: string): boolean;
+    handleEvent(event: EventPayload): void;
+    markForNotification(task: BackgroundTask): void;
+    getPendingNotifications(sessionId: string): BackgroundTask[];
+    clearNotifications(sessionId: string): void;
+    shutdown(): void;
+    private indexTask;
+    private startTask;
+    private updateProgress;
+    private createProgress;
+    private completeTask;
+    private failTask;
+    private releaseConcurrency;
+    private notifyParent;
+    private abortSession;
+    private fetchLatestResult;
+    private getConcurrencyGroup;
+    private getConcurrencyKey;
+    private expireStaleTasks;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/background/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/background/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,WAAW,EAAgB,MAAM,SAAS,CAAC;AAkB/F,KAAK,YAAY,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,WAAW,0BAA0B;IAC1C,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE;AAED,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAC,CAA6B;IAC/C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,YAAY,CAAS;gBAG5B,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,oBAAoB,EAC7B,SAAS,CAAC,EAAE,0BAA0B;IAWjC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IA4BzD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAQrD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAM5D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAmB/B,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAkCtC,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAQ/C,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAQ5D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C,QAAQ,IAAI,IAAI;IAMhB,OAAO,CAAC,SAAS;YAMH,SAAS;IA8DvB,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,cAAc;YAOR,YAAY;IAmB1B,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,kBAAkB;YAMZ,YAAY;YA2BZ,YAAY;YAWZ,iBAAiB;IAqB/B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,gBAAgB;CAWxB"}