bobs-workshop 0.3.3 → 3.1.1

package/config/agents.json

@@ -0,0 +1,27 @@
+{
+  "alice": {
+    "description": "Architect agent - planning and manual authoring",
+    "model": "zai-coding-plan/glm-4.7",
+    "temperature": 0.2
+  },
+  "bob": {
+    "description": "Unified orchestration & implementation - executes tasks and routes workflow",
+    "model": "minimax/MiniMax-M2.1",
+    "temperature": 0.1
+  },
+  "bob-rev": {
+    "description": "Reviewer - PASS/FAIL verification",
+    "model": "minimax/MiniMax-M2.1",
+    "temperature": 0
+  },
+  "trace": {
+    "description": "Debug agent - root cause analysis and fixes",
+    "model": "zai-coding-plan/glm-4.7",
+    "temperature": 0.15
+  },
+  "bob-send": {
+    "description": "Shipper - build, lint, test, final verify (fast)",
+    "model": "minimax/MiniMax-M2.1",
+    "temperature": 0
+  }
+}

package/dist/plugins/bobs-workshop.js

@@ -0,0 +1,34 @@
+import { background_agent, manual_update, verify_manual, list_background_tasks, background_output, background_cancel, } from "../tools/index.js";
+import { BackgroundManager } from "../tools/background-agent/manager.js";
+export const BobWorkshopPlugin = async (ctx) => {
+    const manager = BackgroundManager.getInstance(ctx);
+    return {
+        tool: {
+            background_agent,
+            manual_update,
+            verify_manual,
+            list_background_tasks,
+            background_output,
+            background_cancel,
+        },
+        "session.idle": async (input) => {
+            const event = input;
+            if (event.properties?.sessionID) {
+                manager.handleEvent({
+                    type: "session.idle",
+                    properties: event.properties,
+                });
+            }
+        },
+        "session.deleted": async (input) => {
+            const event = input;
+            if (event.properties?.info?.id) {
+                manager.handleEvent({
+                    type: "session.deleted",
+                    properties: event.properties,
+                });
+            }
+        },
+    };
+};
+export default BobWorkshopPlugin;

package/dist/tools/background-agent/cancel.d.ts

@@ -0,0 +1,3 @@
+declare const BackgroundCancelTool: any;
+export default BackgroundCancelTool;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/tools/background-agent/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/cancel.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,oBAAoB,EAAE,GA4D1B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/tools/background-agent/cancel.js

@@ -0,0 +1,52 @@
+import { tool } from "@opencode-ai/plugin";
+import { BackgroundManager } from "./manager.js";
+const BackgroundCancelTool = tool({
+    description: "Cancel running background agent sessions (cleanup)",
+    args: {
+        task_id: tool.schema.string().optional()
+            .describe("Specific task ID to cancel (omit to cancel all)"),
+        all: tool.schema.boolean().optional()
+            .describe("Cancel all running tasks"),
+    },
+    async execute(args, context) {
+        const ctx = context;
+        const manager = BackgroundManager.getInstance(ctx);
+        if (!args.task_id && !args.all) {
+            return "❌ Must specify task_id OR all=true";
+        }
+        if (args.all) {
+            const runningTasks = manager.getRunningTasks();
+            if (runningTasks.length === 0) {
+                return "📭 No running tasks to cancel";
+            }
+            let cancelledCount = 0;
+            for (const task of runningTasks) {
+                if (task.sessionID) {
+                    await ctx.client.session.delete({
+                        path: { id: task.sessionID },
+                    });
+                    cancelledCount++;
+                }
+            }
+            return `🗑️ Cancelled ${cancelledCount} running tasks`;
+        }
+        if (args.task_id) {
+            const task = manager.getTask(args.task_id);
+            if (!task) {
+                return `❌ Task ${args.task_id} not found`;
+            }
+            if (task.status !== "running") {
+                return `⚠️ Task ${args.task_id} is ${task.status}, cannot cancel`;
+            }
+            if (!task.sessionID) {
+                return `❌ Task ${args.task_id} has no session`;
+            }
+            await ctx.client.session.delete({
+                path: { id: task.sessionID },
+            });
+            return `🗑️ Cancelled task ${args.task_id}`;
+        }
+        return "";
+    },
+});
+export default BackgroundCancelTool;

package/dist/tools/background-agent/concurrency.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple concurrency manager for background agents.
+ * Limits concurrent tasks per model/agent.
+ */
+export declare class ConcurrencyManager {
+    private counts;
+    private queues;
+    private readonly defaultLimit;
+    getConcurrencyLimit(key: string): number;
+    acquire(key: string): Promise<void>;
+    release(key: string): void;
+    clear(): void;
+    private cancelWaiters;
+}
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/tools/background-agent/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/concurrency.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAK;IAElC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIlC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAwB1B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,aAAa;CAMtB"}

package/dist/tools/background-agent/concurrency.js

@@ -0,0 +1,61 @@
+/**
+ * Simple concurrency manager for background agents.
+ * Limits concurrent tasks per model/agent.
+ */
+export class ConcurrencyManager {
+    counts = new Map();
+    queues = new Map();
+    defaultLimit = 5;
+    getConcurrencyLimit(key) {
+        return this.defaultLimit;
+    }
+    async acquire(key) {
+        const limit = this.getConcurrencyLimit(key);
+        if (limit === Infinity) {
+            return;
+        }
+        const current = this.counts.get(key) ?? 0;
+        if (current < limit) {
+            this.counts.set(key, current + 1);
+            return;
+        }
+        return new Promise((resolve) => {
+            const queue = this.queues.get(key) ?? [];
+            queue.push(resolve);
+            this.queues.set(key, queue);
+        });
+    }
+    release(key) {
+        const limit = this.getConcurrencyLimit(key);
+        if (limit === Infinity) {
+            return;
+        }
+        const queue = this.queues.get(key);
+        // Try to hand off to a waiting entry
+        while (queue && queue.length > 0) {
+            const next = queue.shift();
+            if (next) {
+                next();
+                return;
+            }
+        }
+        // No handoff occurred - decrement count to free slot
+        const current = this.counts.get(key) ?? 0;
+        if (current > 0) {
+            this.counts.set(key, current - 1);
+        }
+    }
+    clear() {
+        for (const [key] of this.queues) {
+            this.cancelWaiters(key);
+        }
+        this.counts.clear();
+        this.queues.clear();
+    }
+    cancelWaiters(key) {
+        const queue = this.queues.get(key);
+        if (queue) {
+            this.queues.delete(key);
+        }
+    }
+}

package/dist/tools/background-agent/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types";
+export { BackgroundManager } from "./manager";
+export { ConcurrencyManager } from "./concurrency";
+export { default as background_agent } from "./launch.js";
+export { default as list_background_tasks } from "./list.js";
+export { default as background_output } from "./output.js";
+export { default as background_cancel } from "./cancel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/background-agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/background-agent/index.js

@@ -0,0 +1,7 @@
+export * from "./types";
+export { BackgroundManager } from "./manager";
+export { ConcurrencyManager } from "./concurrency";
+export { default as background_agent } from "./launch.js";
+export { default as list_background_tasks } from "./list.js";
+export { default as background_output } from "./output.js";
+export { default as background_cancel } from "./cancel.js";

package/dist/tools/background-agent/launch.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+import { BackgroundManager } from "./manager.js";
+declare const BackgroundAgentTool: ToolDefinition;
+export default BackgroundAgentTool;
+export { BackgroundManager };
+//# sourceMappingURL=launch.d.ts.map

package/dist/tools/background-agent/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,QAAA,MAAM,mBAAmB,EAAE,cA8BzB,CAAC;AAEH,eAAe,mBAAmB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/tools/background-agent/launch.js

@@ -0,0 +1,33 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import { BackgroundManager } from "./manager.js";
+const BackgroundAgentTool = tool({
+    description: "Launch a background agent for LSP code exploration or verification",
+    args: {
+        agent: tool.schema.enum(["alice", "bob", "bob-eng", "bob-rev", "trace", "bob-send"])
+            .describe("Agent name to launch in background"),
+        prompt: tool.schema.string().describe("Prompt for the background agent"),
+        skills: tool.schema.array(tool.schema.string()).optional()
+            .describe("Skills to load from .opencode/skill/"),
+        model: tool.schema.string().optional()
+            .describe("Override model (defaults to agent's configured model)"),
+        manual_path: tool.schema.string().optional()
+            .describe("Path to MANUAL file (for bob/bob-rev agents)"),
+    },
+    async execute(args, context) {
+        const ctx = context;
+        const manager = BackgroundManager.getInstance(ctx);
+        const input = {
+            description: `${args.agent} - ${args.prompt.slice(0, 50)}`,
+            prompt: args.prompt,
+            agent: args.agent,
+            parentSessionID: ctx.sessionID,
+            model: args.model,
+            skills: args.skills,
+            manual_path: args.manual_path,
+        };
+        const task = await manager.launch(input);
+        return `✅ Started background ${args.agent} session: ${task.id}`;
+    },
+});
+export default BackgroundAgentTool;
+export { BackgroundManager };

package/dist/tools/background-agent/list.d.ts

@@ -0,0 +1,7 @@
+declare const ListBackgroundTasksTool: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export default ListBackgroundTasksTool;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/background-agent/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/list.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,uBAAuB;;;;CA2C3B,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/dist/tools/background-agent/list.js

@@ -0,0 +1,40 @@
+import { tool } from "@opencode-ai/plugin";
+import { BackgroundManager } from "./index.js";
+const ListBackgroundTasksTool = tool({
+    description: "List all running background agent sessions",
+    args: {},
+    async execute(args, context) {
+        const ctx = context;
+        const manager = BackgroundManager.getInstance(ctx);
+        const tasks = manager.getAllTasks();
+        if (tasks.length === 0) {
+            return "📭 No background sessions running";
+        }
+        const output = tasks.map((t) => {
+            const statusEmoji = {
+                pending: "⏳",
+                running: "🔄",
+                completed: "✅",
+                error: "❌",
+                cancelled: "🚫",
+            };
+            const emoji = statusEmoji[t.status] || "❓";
+            const duration = t.startedAt && t.completedAt
+                ? `${Math.round((t.completedAt.getTime() - t.startedAt.getTime()) / 1000)}s`
+                : t.startedAt
+                    ? `${Math.round((Date.now() - t.startedAt.getTime()) / 1000)}s (running)`
+                    : "-";
+            const skillInfo = t.skills && t.skills.length > 0
+                ? ` [skills: ${t.skills.join(", ")}]`
+                : "";
+            return `${emoji} \`${t.id}\` - ${t.description} [${t.status}] ${duration}${skillInfo}`;
+        }).join('\n');
+        const runningCount = tasks.filter(t => t.status === "running").length;
+        const completedCount = tasks.filter(t => t.status === "completed").length;
+        const errorCount = tasks.filter(t => t.status === "error").length;
+        return `🗂️ Background Sessions (${tasks.length} total):\n` +
+            `  🔄 Running: ${runningCount} | ✅ Completed: ${completedCount} | ❌ Error: ${errorCount}\n\n` +
+            `${output}`;
+    },
+});
+export default ListBackgroundTasksTool;

package/dist/tools/background-agent/manager.d.ts

@@ -0,0 +1,29 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundTask, LaunchInput } from "./types";
+export declare class BackgroundManager {
+    private tasks;
+    private client;
+    private directory;
+    private pollingInterval?;
+    private concurrencyManager;
+    private shutdownTriggered;
+    private static instance;
+    static getInstance(ctx: PluginInput): BackgroundManager;
+    private constructor();
+    launch(input: LaunchInput): Promise<BackgroundTask>;
+    private startTask;
+    getTask(id: string): BackgroundTask | undefined;
+    getAllTasks(): BackgroundTask[];
+    getRunningTasks(): BackgroundTask[];
+    handleEvent(event: {
+        type: string;
+        properties?: Record<string, unknown>;
+    }): void;
+    private tryCompleteTask;
+    private validateSessionHasOutput;
+    private startPolling;
+    private stopPolling;
+    private pollRunningTasks;
+    shutdown(): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/tools/background-agent/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAGZ,MAAM,SAAS,CAAC;AAQjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB;IAOvD,OAAO;IAOD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;YAoC3C,SAAS;IAyGvB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/C,WAAW,IAAI,cAAc,EAAE;IAI/B,eAAe,IAAI,cAAc,EAAE;IAInC,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;YAuClE,eAAe;YAmCf,wBAAwB;IAoCtC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;YAOL,gBAAgB;IAkI9B,QAAQ,IAAI,IAAI;CAmBjB"}