@hanhnd/agent-kit 1.0.18 → 1.0.20

package/dist/kit-server.js

@@ -21051,20 +21051,30 @@ function registerCoreTools(server2) {
     "kit_save_handoff",
     "Save a brainstorm, plan, or ticket handoff artifact to .agent-kit/handoffs/. Returns the saved file path to use in next-step instructions.",
     {
-      type: external_exports.enum(["brainstorm", "plan", "ticket"]).describe("Handoff type"),
+      type: external_exports.enum(["brainstorm", "plan", "ticket", "research"]).describe("Handoff type"),
       content: external_exports.string().describe("Full markdown content to save"),
-      slug: external_exports.string().describe('Short identifier for the filename, e.g. "user-auth" or "PROJ-123"')
+      slug: external_exports.string().describe(
+        'Short identifier for the filename, e.g. "user-auth" or "PROJ-123". Do NOT append version numbers (v2, v3, etc); the tool will automatically update the existing file if it exists.'
+      )
     },
     async ({ type, content, slug }) => {
       try {
-        const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
         const safeSlug = slug.replace(/[^a-zA-Z0-9-_]/g, "-").toLowerCase();
-        const filename = `${type}-${timestamp}-${safeSlug}.md`;
         const handoffDir = path.join(getWorkspaceRoot(), ".agent-kit", "handoffs", `${type}s`);
         if (!fs.existsSync(handoffDir)) {
           fs.mkdirSync(handoffDir, { recursive: true });
         }
-        const filePath = path.join(handoffDir, filename);
+        const files = fs.readdirSync(handoffDir);
+        const slugPattern = new RegExp(`^${type}-([0-9T-]{19}-)?${safeSlug}\\.md$`);
+        const existingFile = files.filter((f) => slugPattern.test(f)).sort().pop();
+        let filePath;
+        if (existingFile) {
+          filePath = path.join(handoffDir, existingFile);
+        } else {
+          const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+          const filename = `${type}-${timestamp}-${safeSlug}.md`;
+          filePath = path.join(handoffDir, filename);
+        }
         fs.writeFileSync(filePath, content, "utf8");
         return mcpText(`\u2705 Saved to: ${filePath}`);
       } catch (error2) {
@@ -21212,20 +21222,32 @@ function registerAgentTools(server2) {
         const jobId = randomUUID();
         const child = spawn(usedAgent, agentArgs, {
           cwd: workspaceRoot,
-          env: { ...process.env, GEMINI_WORKSPACE: workspaceRoot }
+          env: { ...process.env, GEMINI_WORKSPACE: workspaceRoot },
+          detached: process.platform !== "win32"
         });
+        const killTree = (sig) => {
+          if (process.platform !== "win32" && child.pid) {
+            try {
+              process.kill(-child.pid, sig);
+            } catch {
+              child.kill(sig);
+            }
+          } else {
+            child.kill(sig);
+          }
+        };
         job = {
           agent: usedAgent,
           process: child,
           startedAt: /* @__PURE__ */ new Date(),
           chunks: [],
           logStream,
-          timeoutHandle: setTimeout(() => child.kill("SIGTERM"), AGENT_TIMEOUT)
+          timeoutHandle: setTimeout(() => killTree("SIGTERM"), AGENT_TIMEOUT)
         };
         jobRegistry.set(jobId, job);
         killChild = () => {
-          child.kill("SIGTERM");
-          setTimeout(() => child.kill("SIGKILL"), 5e3).unref();
+          killTree("SIGTERM");
+          setTimeout(() => killTree("SIGKILL"), 5e3).unref();
         };
         if (extra.signal.aborted) killChild();
         else extra.signal.addEventListener("abort", killChild);

package/dist/tools/agent.js

@@ -86,23 +86,39 @@ export function registerAgentTools(server) {
             const { logPath: lp, logStream } = initAgentLog(workspaceRoot, taskSlug(task), usedAgent);
             logPath = lp;
             const jobId = randomUUID();
+            // detached=true on Unix creates a new process group so we can kill the
+            // entire tree (CLI + its sub-agents) with process.kill(-pid, signal).
             const child = spawn(usedAgent, agentArgs, {
                 cwd: workspaceRoot,
                 env: { ...process.env, GEMINI_WORKSPACE: workspaceRoot },
+                detached: process.platform !== 'win32',
             });
+            const killTree = (sig) => {
+                if (process.platform !== 'win32' && child.pid) {
+                    try {
+                        process.kill(-child.pid, sig);
+                    }
+                    catch {
+                        child.kill(sig);
+                    }
+                }
+                else {
+                    child.kill(sig);
+                }
+            };
             job = {
                 agent: usedAgent,
                 process: child,
                 startedAt: new Date(),
                 chunks: [],
                 logStream,
-                timeoutHandle: setTimeout(() => child.kill('SIGTERM'), AGENT_TIMEOUT),
+                timeoutHandle: setTimeout(() => killTree('SIGTERM'), AGENT_TIMEOUT),
             };
             jobRegistry.set(jobId, job);
             // Kill child if the MCP request is cancelled (e.g. user presses ESC)
             killChild = () => {
-                child.kill('SIGTERM');
-                setTimeout(() => child.kill('SIGKILL'), 5000).unref();
+                killTree('SIGTERM');
+                setTimeout(() => killTree('SIGKILL'), 5000).unref();
             };
             if (extra.signal.aborted)
                 killChild();

package/dist/tools/core.js

@@ -16,21 +16,33 @@ export function registerCoreTools(server) {
     // Returns the saved file path for use in next-step instructions
     // ═══════════════════════════════════════════════════════════════
     server.tool('kit_save_handoff', 'Save a brainstorm, plan, or ticket handoff artifact to .agent-kit/handoffs/. Returns the saved file path to use in next-step instructions.', {
-        type: z.enum(['brainstorm', 'plan', 'ticket']).describe('Handoff type'),
+        type: z.enum(['brainstorm', 'plan', 'ticket', 'research']).describe('Handoff type'),
         content: z.string().describe('Full markdown content to save'),
         slug: z
             .string()
-            .describe('Short identifier for the filename, e.g. "user-auth" or "PROJ-123"'),
+            .describe('Short identifier for the filename, e.g. "user-auth" or "PROJ-123". Do NOT append version numbers (v2, v3, etc); the tool will automatically update the existing file if it exists.'),
     }, async ({ type, content, slug }) => {
         try {
-            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
             const safeSlug = slug.replace(/[^a-zA-Z0-9-_]/g, '-').toLowerCase();
-            const filename = `${type}-${timestamp}-${safeSlug}.md`;
             const handoffDir = path.join(getWorkspaceRoot(), '.agent-kit', 'handoffs', `${type}s`);
             if (!fs.existsSync(handoffDir)) {
                 fs.mkdirSync(handoffDir, { recursive: true });
             }
-            const filePath = path.join(handoffDir, filename);
+            const files = fs.readdirSync(handoffDir);
+            const slugPattern = new RegExp(`^${type}-([0-9T-]{19}-)?${safeSlug}\\.md$`);
+            const existingFile = files
+                .filter((f) => slugPattern.test(f))
+                .sort()
+                .pop();
+            let filePath;
+            if (existingFile) {
+                filePath = path.join(handoffDir, existingFile);
+            }
+            else {
+                const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+                const filename = `${type}-${timestamp}-${safeSlug}.md`;
+                filePath = path.join(handoffDir, filename);
+            }
             fs.writeFileSync(filePath, content, 'utf8');
             return mcpText(`✅ Saved to: ${filePath}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanhnd/agent-kit",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "Super Engineer - Team of AI Agents for software development (Claude Code Plugin)",
   "type": "module",
   "main": "dist/kit-server.js",