@chantier/tools 0.3.0 → 0.5.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ToolDefinition } from "@chantier/core";
+import { SubagentDeps, ToolDefinition } from "@chantier/core";
 //#region src/bash.d.ts
 export declare const bashTool: ToolDefinition;
 //#endregion
@@ -42,6 +42,13 @@ export declare function formatNumbered(text: string, offset?: number, limit?: nu
 /** Parses a tool input field as a string, with a model-facing prose error. */
 export declare function requireString(input: Record<string, unknown>, field: string): string | undefined;
 //#endregion
+//#region src/task.d.ts
+/**
+ * The `task` tool: delegates one self-contained subtask to a fresh child agent
+ * run (Phase A of the subagent roadmap; see core spawnSubagent).
+ */
+export declare function createTaskTool(deps: SubagentDeps): ToolDefinition;
+//#endregion
 //#region src/index.d.ts
 /** The seven v0.1 built-in tools. */
 export declare function buildTools(): ToolDefinition[];

package/dist/index.mjs

@@ -5,6 +5,7 @@ import path from "node:path";
 import { homedir } from "node:os";
 import { createTwoFilesPatch } from "diff";
 import { glob } from "tinyglobby";
+import { spawnSubagent } from "@chantier/core";
 //#region src/common.ts
 /** Model-facing tool output is capped at this many chars, with a visible note. */
 const MAX_TOOL_OUTPUT_CHARS = 4e4;
@@ -691,6 +692,41 @@ const writeTool = {
 	}
 };
 //#endregion
+//#region src/task.ts
+/**
+* The `task` tool: delegates one self-contained subtask to a fresh child agent
+* run (Phase A of the subagent roadmap; see core spawnSubagent).
+*/
+function createTaskTool(deps) {
+	return {
+		name: "task",
+		description: "Delegate one self-contained subtask to a fresh subagent that runs with the builtin tools (no task tool, so it cannot delegate further). The prompt must be self-contained — the subagent sees only it, optionally plus background via context — and the subagent works independently, returning a single summary of what it did and found. Use for read-biased work: research, reading, exploration-sized subtasks. One subtask per call; do quick lookups yourself.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				prompt: {
+					type: "string",
+					description: "Self-contained subtask: the goal plus everything needed to work alone."
+				},
+				context: {
+					type: "string",
+					description: "Optional background (paths, constraints, prior findings)."
+				}
+			},
+			required: ["prompt"]
+		},
+		readOnly: false,
+		handler: async (input, ctx) => {
+			const prompt = requireString(input, "prompt");
+			if (prompt === void 0) return "Error: the `prompt` argument is required and must be a string.";
+			const context = requireString(input, "context");
+			const composed = context === void 0 ? prompt : `${prompt}\n\n# Context\n\n${context}`;
+			const result = await spawnSubagent({ prompt: composed }, deps, ctx);
+			return `${result.text}\n\n(subagent session: ${result.sessionId})`;
+		}
+	};
+}
+//#endregion
 //#region src/index.ts
 /** The seven v0.1 built-in tools. */
 function buildTools() {
@@ -705,4 +741,4 @@ function buildTools() {
 	];
 }
 //#endregion
-export { MAX_TOOL_OUTPUT_CHARS, bashTool, buildTools, denyReadMessage, editTool, formatNumbered, globTool, grepTool, htmlToText, isDenyReadPath, readTool, requireString, resolveInCwd, truncateOutput, webfetchTool, writeTool };
+export { MAX_TOOL_OUTPUT_CHARS, bashTool, buildTools, createTaskTool, denyReadMessage, editTool, formatNumbered, globTool, grepTool, htmlToText, isDenyReadPath, readTool, requireString, resolveInCwd, truncateOutput, webfetchTool, writeTool };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chantier/tools",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Built-in tools (bash, edit, glob, grep, read, webfetch, write) for the chantier coding agent",
@@ -36,7 +36,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@chantier/core": "^0.3.0",
+    "@chantier/core": "^0.5.0",
     "diff": "^8.0.4",
     "tinyglobby": "0.2.17"
   },