@pi-unipi/subagents 0.1.13 → 0.2.2

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Test: Config auto-generation and corruption recovery
+ *
+ * Verifies:
+ * - Missing config → auto-generated with defaults
+ * - Corrupted config → renamed to .json.bak, fresh generated
+ * - Workspace config overrides global config
+ * - Atomic writes prevent corruption
+ */
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/__tests__/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/config.test.js

@@ -0,0 +1,196 @@
+/**
+ * Test: Config auto-generation and corruption recovery
+ *
+ * Verifies:
+ * - Missing config → auto-generated with defaults
+ * - Corrupted config → renamed to .json.bak, fresh generated
+ * - Workspace config overrides global config
+ * - Atomic writes prevent corruption
+ */
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, renameSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+// Inline config implementation for testing
+const DEFAULT_CONFIG = {
+    maxConcurrent: 4,
+    enabled: true,
+    types: {
+        explore: { enabled: true },
+        work: { enabled: true },
+    },
+};
+function loadConfigFromPath(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function repairCorrupted(filePath) {
+    const backupPath = filePath + ".bak";
+    try {
+        renameSync(filePath, backupPath);
+    }
+    catch {
+        // If rename fails, just overwrite
+    }
+    writeConfigAtomic(filePath, DEFAULT_CONFIG);
+    return DEFAULT_CONFIG;
+}
+function writeConfigAtomic(filePath, config) {
+    const tmpPath = filePath + ".tmp";
+    writeFileSync(tmpPath, JSON.stringify(config, null, 2), "utf-8");
+    renameSync(tmpPath, filePath);
+}
+function initConfig(globalDir, workspaceDir) {
+    const globalPath = join(globalDir, "subagents.json");
+    const workspacePath = join(workspaceDir, "subagents.json");
+    // Load or create global config
+    let globalConfig = loadConfigFromPath(globalPath);
+    if (globalConfig === null) {
+        globalConfig = repairCorrupted(globalPath);
+    }
+    // Load workspace override if exists
+    const workspaceConfig = loadConfigFromPath(workspacePath);
+    if (workspaceConfig) {
+        // Merge: workspace overrides global on any field present
+        return {
+            ...globalConfig,
+            ...workspaceConfig,
+            types: {
+                ...globalConfig.types,
+                ...workspaceConfig.types,
+            },
+        };
+    }
+    return globalConfig;
+}
+describe("Config Management", () => {
+    let testDir;
+    let globalDir;
+    let workspaceDir;
+    beforeEach(() => {
+        // Create temp directories for testing
+        testDir = join(tmpdir(), `subagents-test-${Date.now()}`);
+        globalDir = join(testDir, "global");
+        workspaceDir = join(testDir, "workspace");
+        mkdirSync(globalDir, { recursive: true });
+        mkdirSync(workspaceDir, { recursive: true });
+    });
+    afterEach(() => {
+        // Cleanup
+        rmSync(testDir, { recursive: true, force: true });
+    });
+    describe("Missing config", () => {
+        it("should auto-generate with defaults when no config exists", () => {
+            const config = initConfig(globalDir, workspaceDir);
+            assert.deepEqual(config, DEFAULT_CONFIG);
+            assert.equal(existsSync(join(globalDir, "subagents.json")), true);
+            // Verify the generated file
+            const content = readFileSync(join(globalDir, "subagents.json"), "utf-8");
+            const parsed = JSON.parse(content);
+            assert.deepEqual(parsed, DEFAULT_CONFIG);
+        });
+        it("should create global config even if workspace exists", () => {
+            // Write workspace config only
+            const workspaceConfig = { maxConcurrent: 8, enabled: true, types: {} };
+            writeFileSync(join(workspaceDir, "subagents.json"), JSON.stringify(workspaceConfig));
+            const config = initConfig(globalDir, workspaceDir);
+            // Global should be created
+            assert.equal(existsSync(join(globalDir, "subagents.json")), true);
+            // Config should merge
+            assert.equal(config.maxConcurrent, 8); // workspace overrides
+        });
+    });
+    describe("Corrupted config", () => {
+        it("should backup corrupted config and generate fresh", () => {
+            const configPath = join(globalDir, "subagents.json");
+            const backupPath = configPath + ".bak";
+            // Write corrupted JSON
+            writeFileSync(configPath, "{ invalid json !!!");
+            const config = initConfig(globalDir, workspaceDir);
+            // Should have created backup
+            assert.equal(existsSync(backupPath), true, "Backup should exist");
+            // Backup should contain corrupted content
+            assert.equal(readFileSync(backupPath, "utf-8"), "{ invalid json !!!");
+            // New config should be defaults
+            assert.deepEqual(config, DEFAULT_CONFIG);
+            // New file should be valid JSON
+            const content = readFileSync(configPath, "utf-8");
+            assert.deepEqual(JSON.parse(content), DEFAULT_CONFIG);
+        });
+        it("should handle completely empty file", () => {
+            const configPath = join(globalDir, "subagents.json");
+            writeFileSync(configPath, "");
+            const config = initConfig(globalDir, workspaceDir);
+            assert.deepEqual(config, DEFAULT_CONFIG);
+            assert.equal(existsSync(configPath + ".bak"), true);
+        });
+        it("should handle non-object JSON", () => {
+            const configPath = join(globalDir, "subagents.json");
+            writeFileSync(configPath, '"just a string"');
+            const config = initConfig(globalDir, workspaceDir);
+            // JSON.parse succeeds but returns string, not object
+            // loadConfigFromPath checks typeof === "object"
+            assert.deepEqual(config, DEFAULT_CONFIG);
+        });
+    });
+    describe("Workspace override", () => {
+        it("should merge workspace config with global", () => {
+            const globalConfig = { maxConcurrent: 4, enabled: true, types: { explore: { enabled: true } } };
+            const workspaceConfig = { maxConcurrent: 8, types: { work: { enabled: false } } };
+            writeFileSync(join(globalDir, "subagents.json"), JSON.stringify(globalConfig));
+            writeFileSync(join(workspaceDir, "subagents.json"), JSON.stringify(workspaceConfig));
+            const config = initConfig(globalDir, workspaceDir);
+            assert.equal(config.maxConcurrent, 8); // workspace overrides
+            assert.equal(config.enabled, true); // global preserved
+            assert.deepEqual(config.types.explore, { enabled: true }); // global preserved
+            assert.deepEqual(config.types.work, { enabled: false }); // workspace added
+        });
+        it("should override specific fields only", () => {
+            const globalConfig = {
+                maxConcurrent: 4,
+                enabled: true,
+                types: { explore: { enabled: true }, work: { enabled: true } },
+            };
+            const workspaceConfig = { enabled: false };
+            writeFileSync(join(globalDir, "subagents.json"), JSON.stringify(globalConfig));
+            writeFileSync(join(workspaceDir, "subagents.json"), JSON.stringify(workspaceConfig));
+            const config = initConfig(globalDir, workspaceDir);
+            assert.equal(config.maxConcurrent, 4); // global preserved
+            assert.equal(config.enabled, false); // workspace overrides
+            assert.deepEqual(config.types, { explore: { enabled: true }, work: { enabled: true } }); // global preserved
+        });
+        it("should handle empty workspace config", () => {
+            const globalConfig = { maxConcurrent: 4, enabled: true, types: {} };
+            writeFileSync(join(globalDir, "subagents.json"), JSON.stringify(globalConfig));
+            writeFileSync(join(workspaceDir, "subagents.json"), "{}");
+            const config = initConfig(globalDir, workspaceDir);
+            assert.deepEqual(config, globalConfig);
+        });
+    });
+    describe("Atomic writes", () => {
+        it("should write config atomically", () => {
+            const configPath = join(globalDir, "subagents.json");
+            const config = { maxConcurrent: 8, enabled: false, types: {} };
+            writeConfigAtomic(configPath, config);
+            // Should have main file
+            assert.equal(existsSync(configPath), true);
+            // Should not have temp file
+            assert.equal(existsSync(configPath + ".tmp"), false);
+            // Content should be valid
+            const content = readFileSync(configPath, "utf-8");
+            assert.deepEqual(JSON.parse(content), config);
+        });
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

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

package/dist/__tests__/esc-propagation.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Test: ESC propagation — all children abort on parent ESC
+ *
+ * Verifies:
+ * - forwardAbortSignal wires parent signal to child session
+ * - abortAll stops all running agents
+ * - All agents stop within reasonable time
+ */
+export {};
+//# sourceMappingURL=esc-propagation.test.d.ts.map

package/dist/__tests__/esc-propagation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esc-propagation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/esc-propagation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/esc-propagation.test.js

@@ -0,0 +1,140 @@
+/**
+ * Test: ESC propagation — all children abort on parent ESC
+ *
+ * Verifies:
+ * - forwardAbortSignal wires parent signal to child session
+ * - abortAll stops all running agents
+ * - All agents stop within reasonable time
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+// Mock AbortController to track abort calls
+function createMockAbortController() {
+    let aborted = false;
+    const listeners = [];
+    return {
+        get signal() {
+            return {
+                aborted,
+                addEventListener: (_event, listener) => {
+                    listeners.push(listener);
+                },
+                removeEventListener: (_event, listener) => {
+                    const idx = listeners.indexOf(listener);
+                    if (idx !== -1)
+                        listeners.splice(idx, 1);
+                },
+            };
+        },
+        abort() {
+            aborted = true;
+            for (const listener of listeners)
+                listener();
+        },
+        get wasAborted() {
+            return aborted;
+        },
+    };
+}
+describe("ESC Propagation", () => {
+    describe("forwardAbortSignal", () => {
+        it("should call session.abort() when signal fires", () => {
+            // Simulate the forwardAbortSignal logic from agent-runner.ts
+            const sessionAborted = { value: false };
+            const session = { abort: () => { sessionAborted.value = true; } };
+            const controller = createMockAbortController();
+            // Wire abort signal
+            const onAbort = () => session.abort();
+            controller.signal.addEventListener("abort", onAbort);
+            // Trigger abort
+            controller.abort();
+            assert.equal(sessionAborted.value, true, "Session should be aborted");
+        });
+        it("should not call session.abort() if signal not fired", () => {
+            const sessionAborted = { value: false };
+            const session = { abort: () => { sessionAborted.value = true; } };
+            const controller = createMockAbortController();
+            const onAbort = () => session.abort();
+            controller.signal.addEventListener("abort", onAbort);
+            // Don't abort
+            assert.equal(sessionAborted.value, false, "Session should not be aborted");
+        });
+        it("should cleanup listener when returned function called", () => {
+            const controller = createMockAbortController();
+            let callCount = 0;
+            const onAbort = () => { callCount++; };
+            controller.signal.addEventListener("abort", onAbort);
+            // Simulate cleanup
+            const cleanup = () => controller.signal.removeEventListener("abort", onAbort);
+            cleanup();
+            controller.abort();
+            assert.equal(callCount, 0, "Listener should not fire after cleanup");
+        });
+    });
+    describe("abortAll", () => {
+        it("should abort all running agents", () => {
+            const agents = new Map();
+            // Create 3 mock agents
+            for (let i = 0; i < 3; i++) {
+                const controller = createMockAbortController();
+                agents.set(`agent-${i}`, {
+                    abortController: controller,
+                    status: "running",
+                });
+            }
+            // Simulate abortAll
+            let abortedCount = 0;
+            for (const [id, record] of agents) {
+                if (record.status === "running") {
+                    record.abortController.abort();
+                    record.status = "stopped";
+                    abortedCount++;
+                }
+            }
+            assert.equal(abortedCount, 3, "Should abort all 3 agents");
+            for (const [_, record] of agents) {
+                assert.equal(record.status, "stopped", "All agents should be stopped");
+                assert.equal(record.abortController.wasAborted, true, "All controllers should be aborted");
+            }
+        });
+        it("should handle queued agents by removing from queue", () => {
+            const queue = [
+                { id: "queued-1", status: "queued" },
+                { id: "queued-2", status: "queued" },
+            ];
+            const agents = new Map();
+            for (const item of queue) {
+                agents.set(item.id, { status: item.status });
+            }
+            // Simulate abortAll for queued
+            for (const item of queue) {
+                const record = agents.get(item.id);
+                if (record) {
+                    record.status = "stopped";
+                }
+            }
+            queue.length = 0;
+            assert.equal(queue.length, 0, "Queue should be empty");
+            for (const [_, record] of agents) {
+                assert.equal(record.status, "stopped", "All queued agents should be stopped");
+            }
+        });
+    });
+    describe("ESC timing", () => {
+        it("should abort within reasonable time", async () => {
+            const controller = createMockAbortController();
+            let abortedAt = null;
+            const startedAt = Date.now();
+            const onAbort = () => { abortedAt = Date.now(); };
+            controller.signal.addEventListener("abort", onAbort);
+            // Simulate abort after small delay
+            setTimeout(() => controller.abort(), 10);
+            // Wait for abort
+            await new Promise(resolve => setTimeout(resolve, 50));
+            assert.notEqual(abortedAt, null, "Should have aborted");
+            const elapsed = abortedAt - startedAt;
+            assert.ok(elapsed < 500, `Abort should happen within 500ms, took ${elapsed}ms`);
+        });
+    });
+});
+//# sourceMappingURL=esc-propagation.test.js.map

package/dist/__tests__/esc-propagation.test.js.map

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

package/dist/__tests__/file-lock.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test: File locking — concurrent writes to same file queue correctly
+ *
+ * Verifies:
+ * - Per-file locking works correctly
+ * - Same file writes queue (second waits for first)
+ * - Different file writes proceed in parallel
+ * - Lock release unblocks waiting acquires
+ * - releaseAll releases all locks for an agent
+ */
+export {};
+//# sourceMappingURL=file-lock.test.d.ts.map

package/dist/__tests__/file-lock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/file-lock.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/file-lock.test.js

@@ -0,0 +1,187 @@
+/**
+ * Test: File locking — concurrent writes to same file queue correctly
+ *
+ * Verifies:
+ * - Per-file locking works correctly
+ * - Same file writes queue (second waits for first)
+ * - Different file writes proceed in parallel
+ * - Lock release unblocks waiting acquires
+ * - releaseAll releases all locks for an agent
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+class FileLock {
+    locks = new Map();
+    queues = new Map();
+    async acquire(filePath, agentId) {
+        while (this.locks.has(filePath)) {
+            await new Promise((resolve) => {
+                const queue = this.queues.get(filePath) ?? [];
+                queue.push(resolve);
+                this.queues.set(filePath, queue);
+            });
+        }
+        let releaseFn;
+        const promise = new Promise((resolve) => {
+            releaseFn = () => {
+                this.locks.delete(filePath);
+                resolve();
+                const queue = this.queues.get(filePath);
+                if (queue && queue.length > 0) {
+                    const next = queue.shift();
+                    next();
+                }
+            };
+        });
+        const entry = {
+            agentId,
+            filePath,
+            promise,
+            release: releaseFn,
+        };
+        this.locks.set(filePath, entry);
+        return releaseFn;
+    }
+    isLocked(filePath) {
+        return this.locks.has(filePath);
+    }
+    getHolder(filePath) {
+        return this.locks.get(filePath)?.agentId;
+    }
+    get lockCount() {
+        return this.locks.size;
+    }
+    releaseAll(agentId) {
+        for (const [filePath, entry] of this.locks) {
+            if (entry.agentId === agentId) {
+                entry.release();
+            }
+        }
+    }
+    clear() {
+        for (const entry of this.locks.values()) {
+            entry.release();
+        }
+        this.locks.clear();
+        this.queues.clear();
+    }
+}
+describe("FileLock", () => {
+    describe("Basic locking", () => {
+        it("should acquire lock on unlocked file", async () => {
+            const lock = new FileLock();
+            const release = await lock.acquire("/src/auth.ts", "agent-1");
+            assert.equal(lock.isLocked("/src/auth.ts"), true);
+            assert.equal(lock.getHolder("/src/auth.ts"), "agent-1");
+            assert.equal(lock.lockCount, 1);
+            release();
+            assert.equal(lock.isLocked("/src/auth.ts"), false);
+        });
+        it("should track multiple locks on different files", async () => {
+            const lock = new FileLock();
+            const release1 = await lock.acquire("/src/auth.ts", "agent-1");
+            const release2 = await lock.acquire("/src/login.ts", "agent-2");
+            assert.equal(lock.lockCount, 2);
+            assert.equal(lock.getHolder("/src/auth.ts"), "agent-1");
+            assert.equal(lock.getHolder("/src/login.ts"), "agent-2");
+            release1();
+            release2();
+            assert.equal(lock.lockCount, 0);
+        });
+    });
+    describe("Queuing behavior", () => {
+        it("should queue second acquire on same file", async () => {
+            const lock = new FileLock();
+            const events = [];
+            // First acquire
+            const release1 = await lock.acquire("/src/auth.ts", "agent-1");
+            events.push("agent-1-acquired");
+            // Second acquire (should queue)
+            const acquire2Promise = lock.acquire("/src/auth.ts", "agent-2").then((release) => {
+                events.push("agent-2-acquired");
+                return release;
+            });
+            // agent-2 should not have acquired yet
+            assert.deepEqual(events, ["agent-1-acquired"]);
+            // Release first lock
+            release1();
+            events.push("agent-1-released");
+            // Wait for agent-2
+            const release2 = await acquire2Promise;
+            assert.deepEqual(events, ["agent-1-acquired", "agent-1-released", "agent-2-acquired"]);
+            release2();
+        });
+        it("should queue multiple acquires on same file", async () => {
+            const lock = new FileLock();
+            const events = [];
+            const release1 = await lock.acquire("/src/auth.ts", "agent-1");
+            events.push("1-acquired");
+            const p2 = lock.acquire("/src/auth.ts", "agent-2").then(r => { events.push("2-acquired"); return r; });
+            const p3 = lock.acquire("/src/auth.ts", "agent-3").then(r => { events.push("3-acquired"); return r; });
+            release1();
+            const release2 = await p2;
+            assert.deepEqual(events, ["1-acquired", "2-acquired"]);
+            release2();
+            const release3 = await p3;
+            assert.deepEqual(events, ["1-acquired", "2-acquired", "3-acquired"]);
+            release3();
+        });
+    });
+    describe("Parallel different files", () => {
+        it("should allow parallel writes to different files", async () => {
+            const lock = new FileLock();
+            const events = [];
+            // Both should acquire immediately (different files)
+            const release1 = await lock.acquire("/src/auth.ts", "agent-1");
+            events.push("auth-acquired");
+            const release2 = await lock.acquire("/src/login.ts", "agent-2");
+            events.push("login-acquired");
+            assert.deepEqual(events, ["auth-acquired", "login-acquired"]);
+            assert.equal(lock.lockCount, 2);
+            release1();
+            release2();
+        });
+    });
+    describe("releaseAll", () => {
+        it("should release all locks for a specific agent", async () => {
+            const lock = new FileLock();
+            // agent-1 holds 3 files
+            await lock.acquire("/src/a.ts", "agent-1");
+            await lock.acquire("/src/b.ts", "agent-1");
+            await lock.acquire("/src/c.ts", "agent-1");
+            // agent-2 holds 1 file
+            await lock.acquire("/src/d.ts", "agent-2");
+            assert.equal(lock.lockCount, 4);
+            // Release all for agent-1
+            lock.releaseAll("agent-1");
+            assert.equal(lock.lockCount, 1);
+            assert.equal(lock.isLocked("/src/a.ts"), false);
+            assert.equal(lock.isLocked("/src/b.ts"), false);
+            assert.equal(lock.isLocked("/src/c.ts"), false);
+            assert.equal(lock.isLocked("/src/d.ts"), true);
+        });
+        it("should unblock queued acquires when releasing all", async () => {
+            const lock = new FileLock();
+            const events = [];
+            const release1 = await lock.acquire("/src/a.ts", "agent-1");
+            const p2 = lock.acquire("/src/a.ts", "agent-2").then(r => { events.push("agent-2-acquired"); return r; });
+            // Release all for agent-1
+            lock.releaseAll("agent-1");
+            const release2 = await p2;
+            assert.deepEqual(events, ["agent-2-acquired"]);
+            release2();
+        });
+    });
+    describe("clear", () => {
+        it("should release all locks and clear queues", async () => {
+            const lock = new FileLock();
+            await lock.acquire("/src/a.ts", "agent-1");
+            await lock.acquire("/src/b.ts", "agent-2");
+            lock.clear();
+            assert.equal(lock.lockCount, 0);
+            assert.equal(lock.isLocked("/src/a.ts"), false);
+            assert.equal(lock.isLocked("/src/b.ts"), false);
+        });
+    });
+});
+//# sourceMappingURL=file-lock.test.js.map

package/dist/__tests__/file-lock.test.js.map

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

package/dist/__tests__/workflow-integration.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test: Workflow integration — `/unipi:work` with subagent support
+ *
+ * Verifies:
+ * - spawn_helper and get_helper_result tools are properly defined
+ * - Agent types (explore, work) are correctly configured
+ * - Concurrency limit is respected
+ * - Custom agent type loading works
+ * - System prompt builder generates correct prompts
+ */
+export {};
+//# sourceMappingURL=workflow-integration.test.d.ts.map

package/dist/__tests__/workflow-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/workflow-integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}