better-opencode-async-agents 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +47 -24
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -3,7 +3,17 @@
3
3
  [![npm version](https://img.shields.io/npm/v/better-opencode-async-agents)](https://www.npmjs.com/package/better-opencode-async-agents)
4
4
  [![license](https://img.shields.io/npm/l/better-opencode-async-agents)](https://github.com/mainsoft-2024/better-opencode-async-agents/blob/main/LICENSE)
5
5
 
6
- An unopinionated, **Non-Blocking(optional), Async** Background agent plugin for OpenCode, **same as (or better than) that of Claude Code!**
6
+ An unopinionated,
7
+
8
+ **Async**,
9
+
10
+ Forkable,
11
+
12
+ Resumable,
13
+
14
+ Parallelizable
15
+
16
+ multi-agent plugin for OpenCode.
7
17
 
8
18
  ## Configuration
9
19
 
@@ -15,24 +25,45 @@ Add the plugin to your `opencode.json(c)`:
15
25
  }
16
26
  ```
17
27
 
18
- ## Features
28
+ ## Overview
29
+
30
+ This is the subagent/subtask plugin we all know and love, with some key features that support advanced agent control:
31
+
32
+ - **Async & Batch Task Execution**: Run multiple agent tasks in parallel without blocking the main conversation. Launch tasks individually or in batches and continue working while they execute.
33
+
34
+ - **Real-time Progress Tracking**: Live updates with spinner animations and tool call counts. See exactly what each agent is doing as it works.
35
+
36
+ - **Resumable & Cancellable**: Resume completed tasks with follow-up messages for multi-turn conversations. Cancel running tasks at any time.
37
+
38
+ - **Context Forking Support**: Fork the current conversation context to spawn new agent sessions that inherit the parent's context.
19
39
 
20
- - **Async Task Execution**: Run long-running agent tasks in parallel without blocking
21
- - **Real-time Progress Tracking**: Live updates with spinner animations and tool call counts
22
- - **Toast Notifications**: Visual status updates directly in your OpenCode UI
23
- - **Automatic Completion Notifications**: Get notified when tasks finish (success/error/cancelled)
24
- - **Batch Task Management**: Track multiple tasks as a batch with progress indicators
25
- - **Result Retrieval**: Block or non-blocking result fetching with configurable timeouts
26
- - **Session Integration**: Tasks automatically clean up when parent sessions change or are deleted
40
+ - **Automatic Context Truncation**: When forking, context is intelligently truncated to fit within token limits while preserving the most relevant information.
41
+
42
+ - **Dynamic Agent Response Collection**: Collect responses from agents in blocking or non-blocking modes. Wait for all tasks to complete or check progress incrementally.
43
+
44
+ - **Variable Timeouts**: Configure custom timeouts per task. Some tasks need seconds, others need minutes - you decide.
27
45
 
28
46
  ## Tools Provided
29
47
 
30
- - **`superagents_task(description: string, prompt: string, agent: string)`**: Launch async background agent tasks
31
- - **`superagents_output(task_id: string, block: boolean, timeout?: number)`**: Get task results (blocking/non-blocking)
32
- - **`superagents_cancel(task_id: string)`**: Cancel running tasks
33
- - **`superagents_resume(task_id: string, message: string, block?: boolean, timeout?: number)`**: Resume a completed task with a follow-up message for multi-turn conversations
34
- - **`superagents_list(status?: "running" | "completed" | "error" | "cancelled")`**: List all tasks with status filter
35
- - **`superagents_clear()`**: Abort and clear all tasks
48
+ | Tool | Description |
49
+ |------|-------------|
50
+ | `superagents_task` | Launch async background agent tasks with description, prompt, and agent type |
51
+ | `superagents_output` | Get task results (blocking or non-blocking) with configurable timeout |
52
+ | `superagents_cancel` | Cancel a running task |
53
+ | `superagents_resume` | Resume a completed task with a follow-up message |
54
+ | `superagents_list` | List all tasks with optional status filter |
55
+ | `superagents_clear` | Abort and clear all tasks |
56
+
57
+ ## Philosophy
58
+
59
+ This is an unopinionated tool. It provides the primitives for async multi-agent orchestration without imposing a specific workflow. You decide:
60
+
61
+ - When to block vs. fire-and-forget
62
+ - How to structure your agent hierarchy
63
+ - What context to fork and when
64
+ - How long to wait for results
65
+
66
+ Build your own patterns on top of these building blocks.
36
67
 
37
68
  ## Development
38
69
 
@@ -46,14 +77,8 @@ bun run build
46
77
  # Run tests
47
78
  bun test
48
79
 
49
- # Run linter
50
- bun run lint
51
-
52
80
  # Type check
53
81
  bun run typecheck
54
-
55
- # Format code
56
- bun run format
57
82
  ```
58
83
 
59
84
  ## License
@@ -62,6 +87,4 @@ MIT
62
87
 
63
88
  ---
64
89
 
65
- ## Support
66
-
67
- For issues, questions, or contributions, please visit the [GitHub repository](https://github.com/mainsoft-2024/better-opencode-async-agents).
90
+ For issues, questions, or contributions, visit the [GitHub repository](https://github.com/mainsoft-2024/better-opencode-async-agents).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "better-opencode-async-agents",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
4
  "description": "Background task management plugin for OpenCode AI",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",