@openspoon/subtask2 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @openspoon/subtask2
+
+OpenCode plugin for enhanced subtask control with **return context injection** and **prompt chaining**.
+
+## Features
+
+- **`return`**: Append context to subtask output, ensuring the parent agent receives specific information
+- **`chain`**: Queue follow-up user messages that execute sequentially after the subtask completes
+
+## Installation
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugins": ["@openspoon/subtask2"]
+}
+```
+
+or 
+
+```bash
+npm install @openspoon/subtask2
+```
+
+## Usage
+
+Add `return` and/or `chain` to your command frontmatter:
+
+### Example: Code Review Command
+
+`.opencode/command/review.md`
+
+```markdown
+---
+description: Review code changes and create summary
+agent: general
+subtask: true
+return: You are the agent in charge of assessing the bug review, challenge, verify and validate it, then discard it or implement it.
+chain:
+  - Let's now rinse and repeat with PR#356, use the task tool to review it for bugs etc... then assess, challenge, validate -> discard or implement.
+  - Rinse and repeat, with next PR.
+---
+
+Review PR#355 for bugs, security issues, and code style problems.
+```
+
+## How It Works
+
+1. When a subtask command with `return` executes, the return text is appended to the task output
+2. When the subtask completes, each `chain` prompt is sent as a synthetic user message
+3. Chain prompts execute sequentially, each waiting for the previous to complete
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAiElD,QAAA,MAAM,MAAM,EAAE,MAqCb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,98 @@
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const fm = {};
+    const lines = match[1].split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const keyMatch = line.match(/^(\w+):\s*(.*)/);
+        if (!keyMatch)
+            continue;
+        const [, key, value] = keyMatch;
+        if (!value.trim()) {
+            const items = [];
+            while (i + 1 < lines.length && lines[i + 1].match(/^\s+-\s+/)) {
+                i++;
+                items.push(lines[i].replace(/^\s+-\s+/, "").trim());
+            }
+            if (items.length) {
+                fm[key] = items;
+                continue;
+            }
+        }
+        fm[key] = value.trim();
+    }
+    return fm;
+}
+async function buildManifest() {
+    const manifest = {};
+    const home = Bun.env.HOME ?? "";
+    const dirs = [`${home}/.config/opencode/command`, `${Bun.env.PWD ?? "."}/.opencode/command`];
+    for (const dir of dirs) {
+        try {
+            const glob = new Bun.Glob("*.md");
+            for await (const file of glob.scan(dir)) {
+                const name = file.replace(/\.md$/, "");
+                const content = await Bun.file(`${dir}/${file}`).text();
+                const fm = parseFrontmatter(content);
+                const chain = fm.chain;
+                const chainArr = chain ? (Array.isArray(chain) ? chain : [chain]) : [];
+                if (fm.return || chainArr.length) {
+                    manifest[name] = {
+                        return: fm.return,
+                        chain: chainArr,
+                    };
+                }
+            }
+        }
+        catch { }
+    }
+    return manifest;
+}
+let configs = {};
+let client = null;
+const callState = new Map();
+const chainState = new Map();
+const plugin = async (ctx) => {
+    configs = await buildManifest();
+    client = ctx.client;
+    return {
+        "tool.execute.before": async (input, output) => {
+            if (input.tool !== "task")
+                return;
+            const cmd = output.args?.command;
+            if (cmd && configs[cmd]) {
+                callState.set(input.callID, cmd);
+                if (configs[cmd].chain.length) {
+                    chainState.set(input.sessionID, [...configs[cmd].chain]);
+                }
+            }
+        },
+        "tool.execute.after": async (input, output) => {
+            if (input.tool !== "task")
+                return;
+            const cmd = callState.get(input.callID);
+            if (!cmd)
+                return;
+            if (configs[cmd]?.return) {
+                output.output += `\n\n${configs[cmd].return}`;
+            }
+            callState.delete(input.callID);
+        },
+        "experimental.text.complete": async (input) => {
+            const chain = chainState.get(input.sessionID);
+            if (!chain?.length || !client)
+                return;
+            const next = chain.shift();
+            if (!chain.length)
+                chainState.delete(input.sessionID);
+            await client.session.promptAsync({
+                path: { id: input.sessionID },
+                body: { parts: [{ type: "text", text: next, synthetic: true }] },
+            });
+        },
+    };
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@openspoon/subtask2",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Opencode plugin for enhanced subtask control with return context and prompt chaining",
+  "main": "./dist/subtask2/index.js",
+  "types": "./dist/subtask2/index.d.ts",
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plugin",
+    "subtask",
+    "chaining",
+    "automation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spoons-and-mirrors/subtask2.git"
+  },
+  "author": "openspoon",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.13.7"
+  },
+  "dependencies": {
+    "@opencode-ai/sdk": "latest"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.0.143",
+    "@types/node": "^24.10.1",
+    "bun-types": "^1.3.4",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ]
+}