agentool 1.1.0 → 1.1.1

package/dist/{chunk-4YI2H55A.js → chunk-TXZ3BMMR.js}

@@ -1,3 +1,7 @@
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
+
 // src/bash/index.ts
 import { tool } from "ai";
 import { z } from "zod";
@@ -103,12 +107,54 @@ async function executeShell(command, options) {
   });
 }
 
+// src/bash/prompt.ts
+function getPrompt(config = {}) {
+  const timeout = config.timeout ?? 12e4;
+  const timeoutMin = timeout / 6e4;
+  const shell = config.shell ?? "$SHELL or /bin/bash";
+  return `Execute a shell command and return its output (stdout, stderr, exit code).
+
+Runs the command in ${shell} with \`-c\`. The working directory persists between calls.
+
+## When to Use
+- Build commands, git operations, system administration, installing packages
+- Running scripts, compiling code, process management
+- Any shell task that doesn't have a dedicated tool available
+
+## When NOT to Use
+- Reading file contents \u2014 use the dedicated file reading tool instead
+- Searching file contents \u2014 use the dedicated content search tool instead
+- Finding files by name/pattern \u2014 use the dedicated file search tool instead
+- Editing files \u2014 use the dedicated file editing tool instead
+- Writing new files \u2014 use the dedicated file writing tool instead
+Prefer dedicated tools over shell equivalents (e.g., don't use cat, head, tail, sed, awk, grep, find, or echo when a dedicated tool exists). Dedicated tools provide better output formatting and permission handling.
+
+## Usage Guidelines
+- Default timeout: ${timeout}ms (${timeoutMin} minutes). Override with the timeout parameter.
+- Timeout escalation: SIGTERM first, then SIGKILL after 5-second grace period.
+- Output is capped at 10 MB per stream (stdout/stderr).
+- Always quote file paths containing spaces with double quotes.
+- When issuing multiple commands:
+  - Independent commands: make separate tool calls in parallel.
+  - Sequential with dependency: chain with \`&&\`.
+  - Sequential ignoring failures: chain with \`;\`.
+  - Do NOT use newlines to separate commands.
+- Avoid unnecessary \`sleep\` commands:
+  - Don't sleep between commands that can run immediately.
+  - Don't retry failing commands in a sleep loop \u2014 diagnose the root cause.
+  - If you must sleep, keep it short (1-5 seconds).
+- For git commands:
+  - Prefer creating new commits rather than amending existing ones.
+  - Never skip hooks (--no-verify) unless the user explicitly requests it.
+  - Before destructive operations (reset --hard, push --force), consider safer alternatives.`;
+}
+
 // src/bash/index.ts
 function createBash(config = {}) {
   const cwd = config.cwd ?? process.cwd();
   const timeout = config.timeout ?? 12e4;
   return tool({
-    description: "Execute a shell command and return its output. Runs the command in a bash shell with the configured working directory. Returns stdout, stderr, and exit code. Use this for running build commands, git operations, system administration, and any other shell tasks.",
+    description: config.description ?? getPrompt(config),
     inputSchema: z.object({
       command: z.string().describe("The shell command to execute"),
       timeout: z.number().optional().describe("Timeout in milliseconds (default: 120000)"),
@@ -128,7 +174,7 @@ ${result.stderr}`);
         if (result.exitCode !== 0) parts.push(`Exit code: ${result.exitCode}`);
         return parts.length > 0 ? parts.join("\n") : `Command completed with exit code ${result.exitCode}`;
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = extractErrorMessage(error);
         return `Error [bash]: Failed to execute command: ${msg}`;
       }
     }
@@ -137,6 +183,7 @@ ${result.stderr}`);
 var bash = createBash();
 
 export {
+  getPrompt,
   createBash,
   bash
 };

package/dist/{chunk-IRRNYFI5.js → chunk-UCA6LURO.js}

@@ -1,9 +1,34 @@
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
+
 // src/tool-search/index.ts
 import { tool } from "ai";
 import { z } from "zod";
+
+// src/tool-search/prompt.ts
+function getPrompt() {
+  return `Search for available tools by name or keyword. Returns matching tool names and their descriptions.
+
+Uses fuzzy matching \u2014 scores results by name and description relevance.
+
+## When to Use
+- To discover what tools are available when you're unsure which tool to use
+- To find the right tool for a specific task by searching with keywords
+
+## When NOT to Use
+- When you already know the tool name \u2014 just use it directly
+
+## Usage Guidelines
+- Requires a tools registry to be configured via createToolSearch({ tools: { ... } })
+- Returns up to \`max_results\` matches (default: 5), sorted by relevance
+- Matches against both tool names and descriptions`;
+}
+
+// src/tool-search/index.ts
 function createToolSearch(config = {}) {
   return tool({
-    description: "Search for available tools by name or keyword. Returns matching tool names and descriptions.",
+    description: config.description ?? getPrompt(),
     inputSchema: z.object({
       query: z.string().describe("Query to find tools by name or keyword"),
       max_results: z.number().optional().default(5).describe("Max results to return")
@@ -34,7 +59,7 @@ function createToolSearch(config = {}) {
         }
         return scored.map((e) => `${e.name}: ${e.description}`).join("\n");
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = extractErrorMessage(error);
         return `Error [tool-search]: ${msg}`;
       }
     }
@@ -43,6 +68,7 @@ function createToolSearch(config = {}) {
 var toolSearch = createToolSearch();
 
 export {
+  getPrompt,
   createToolSearch,
   toolSearch
 };

package/dist/{chunk-EA3YV7ZG.js → chunk-VE4U27HI.js}

@@ -1,33 +1,52 @@
 import {
   applyEditToFile,
+  countOccurrences,
   findActualString,
   preserveQuoteStyle
-} from "./chunk-G3ITTPGX.js";
+} from "./chunk-4MXDQEPA.js";
 import {
+  readTextContent,
   writeTextContent
-} from "./chunk-6PQLFDGT.js";
+} from "./chunk-PWBVB6MN.js";
 import {
   expandPath
 } from "./chunk-I3ONDY7P.js";
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
 
 // src/multi-edit/index.ts
-import { readFile } from "fs/promises";
 import { tool } from "ai";
 import { z } from "zod";
-function countOccurrences(text, search) {
-  if (search.length === 0) return 0;
-  let count = 0;
-  let pos = 0;
-  while ((pos = text.indexOf(search, pos)) !== -1) {
-    count++;
-    pos += search.length;
-  }
-  return count;
+
+// src/multi-edit/prompt.ts
+function getPrompt() {
+  return `Atomically apply multiple text edits to a single file. All edits succeed together or none are applied.
+
+Each edit replaces one occurrence of old_string with new_string. Edits are applied sequentially in the order provided.
+
+## When to Use
+- When you need to make several related changes to the same file in one operation
+- When changes depend on each other and partial application would leave the file in a broken state
+- To rename a variable in multiple locations within the same file
+
+## When NOT to Use
+- For a single edit \u2014 use the regular file editing tool instead (simpler)
+- For changes across multiple files \u2014 make separate edit calls per file
+- For creating new files \u2014 use the file writing tool instead
+
+## Usage Guidelines
+- If any edit fails (old_string not found or not unique), the entire batch is rolled back \u2014 the file stays unchanged
+- Each old_string must appear exactly once in the file at the time that edit is applied
+- Edits are applied in order, so later edits see the result of earlier ones
+- Supports curly-quote fallback matching and quote-style preservation`;
 }
+
+// src/multi-edit/index.ts
 function createMultiEdit(config = {}) {
   const cwd = config.cwd ?? process.cwd();
   return tool({
-    description: "Atomically apply multiple text edits to a single file. All edits succeed together or none are applied (rollback on failure). Each edit replaces one occurrence of old_string with new_string. Edits are applied sequentially in the order provided.",
+    description: config.description ?? getPrompt(),
     inputSchema: z.object({
       file_path: z.string().describe("Path to the file to edit (absolute or relative to cwd)"),
       edits: z.array(
@@ -43,7 +62,7 @@ function createMultiEdit(config = {}) {
           return "No edits provided. File unchanged.";
         }
         const resolvedPath = expandPath(file_path, cwd);
-        const originalContent = await readFile(resolvedPath, "utf-8");
+        const originalContent = await readTextContent(resolvedPath);
         let content = originalContent;
         for (let i = 0; i < edits.length; i++) {
           const edit = edits[i];
@@ -65,7 +84,7 @@ function createMultiEdit(config = {}) {
         await writeTextContent(resolvedPath, content);
         return `Successfully applied ${edits.length} edit${edits.length === 1 ? "" : "s"} to ${resolvedPath}`;
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = extractErrorMessage(error);
         return `Error [multi-edit]: ${msg}`;
       }
     }
@@ -74,6 +93,7 @@ function createMultiEdit(config = {}) {
 var multiEdit = createMultiEdit();
 
 export {
+  getPrompt,
   createMultiEdit,
   multiEdit
 };

package/dist/{chunk-E6NBEYZD.js → chunk-VHLY7LQE.js}

@@ -1,21 +1,23 @@
+import {
+  readTextContent,
+  writeTextContent
+} from "./chunk-PWBVB6MN.js";
+
 // src/shared/task-store.ts
-import { mkdir, readFile, writeFile } from "fs/promises";
-import { dirname } from "path";
 import { randomBytes } from "crypto";
 function generateId() {
   return randomBytes(4).toString("hex");
 }
 async function loadTasks(filePath) {
   try {
-    const data = await readFile(filePath, "utf-8");
+    const data = await readTextContent(filePath);
     return JSON.parse(data);
   } catch {
     return [];
   }
 }
 async function saveTasks(filePath, tasks) {
-  await mkdir(dirname(filePath), { recursive: true });
-  await writeFile(filePath, JSON.stringify(tasks, null, 2), "utf-8");
+  await writeTextContent(filePath, JSON.stringify(tasks, null, 2));
 }
 function formatTask(t) {
   const lines = [

package/dist/{chunk-FW3UJ622.cjs → chunk-VPRUYL4T.cjs}

@@ -1,6 +1,35 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/context-compaction/index.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/context-compaction/index.ts
 var _ai = require('ai');
 var _zod = require('zod');
+
+// src/context-compaction/prompt.ts
+function getPrompt(config = {}) {
+  const maxTokens = _nullishCoalesce(config.maxTokens, () => ( 4096));
+  return `Compact conversation history by summarizing older messages to reduce context size. Target budget: ${maxTokens} tokens.
+
+Requires a summarize callback to be configured \u2014 the application provides the summarization implementation.
+
+## When to Use
+- When the conversation is getting long and approaching context limits
+- When earlier messages contain details no longer relevant to the current task
+- To free up context space for new work without losing important context
+
+## When NOT to Use
+- When the conversation is still within budget \u2014 the tool returns early if already compact
+- When every message contains critical details that shouldn't be summarized
+- For persisting information long-term \u2014 use the memory tool instead
+
+## Usage Guidelines
+- Messages already within the token budget (${maxTokens} tokens, ~${maxTokens * 4} characters) are returned unchanged
+- The summarize callback receives all messages and should return a condensed summary
+- The result replaces the original messages with a single system message containing the summary`;
+}
+
+// src/context-compaction/index.ts
 var parametersSchema = _zod.z.object({
   messages: _zod.z.array(
     _zod.z.object({
@@ -14,7 +43,7 @@ var parametersSchema = _zod.z.object({
 });
 function createContextCompaction(config = {}) {
   return _ai.tool.call(void 0, {
-    description: "Compact conversation history by summarizing older messages to reduce context size. Requires a summarize function in config. Returns compacted messages where total chars < maxTokens * 4.",
+    description: _nullishCoalesce(config.description, () => ( getPrompt(config))),
     inputSchema: _ai.zodSchema.call(void 0, parametersSchema),
     execute: async ({
       messages,
@@ -45,7 +74,7 @@ function createContextCompaction(config = {}) {
           originalCount: messages.length
         });
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
         return `Error [context-compaction]: Summarization failed: ${msg}`;
       }
     }
@@ -56,4 +85,5 @@ var contextCompaction = createContextCompaction();
 
 
 
-exports.createContextCompaction = createContextCompaction; exports.contextCompaction = contextCompaction;
+
+exports.getPrompt = getPrompt; exports.createContextCompaction = createContextCompaction; exports.contextCompaction = contextCompaction;

package/dist/{chunk-3VO6NETR.cjs → chunk-VPV6WG5V.cjs}

@@ -2,32 +2,51 @@
 
 
 
-var _chunk5NW4OGRIcjs = require('./chunk-5NW4OGRI.cjs');
 
+var _chunkYTPZHJDCcjs = require('./chunk-YTPZHJDC.cjs');
 
-var _chunkCAEVLIQBcjs = require('./chunk-CAEVLIQB.cjs');
+
+
+var _chunkBIAODQ2Pcjs = require('./chunk-BIAODQ2P.cjs');
 
 
 var _chunkQZ5GS6HWcjs = require('./chunk-QZ5GS6HW.cjs');
 
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
 // src/multi-edit/index.ts
-var _promises = require('fs/promises');
 var _ai = require('ai');
 var _zod = require('zod');
-function countOccurrences(text, search) {
-  if (search.length === 0) return 0;
-  let count = 0;
-  let pos = 0;
-  while ((pos = text.indexOf(search, pos)) !== -1) {
-    count++;
-    pos += search.length;
-  }
-  return count;
+
+// src/multi-edit/prompt.ts
+function getPrompt() {
+  return `Atomically apply multiple text edits to a single file. All edits succeed together or none are applied.
+
+Each edit replaces one occurrence of old_string with new_string. Edits are applied sequentially in the order provided.
+
+## When to Use
+- When you need to make several related changes to the same file in one operation
+- When changes depend on each other and partial application would leave the file in a broken state
+- To rename a variable in multiple locations within the same file
+
+## When NOT to Use
+- For a single edit \u2014 use the regular file editing tool instead (simpler)
+- For changes across multiple files \u2014 make separate edit calls per file
+- For creating new files \u2014 use the file writing tool instead
+
+## Usage Guidelines
+- If any edit fails (old_string not found or not unique), the entire batch is rolled back \u2014 the file stays unchanged
+- Each old_string must appear exactly once in the file at the time that edit is applied
+- Edits are applied in order, so later edits see the result of earlier ones
+- Supports curly-quote fallback matching and quote-style preservation`;
 }
+
+// src/multi-edit/index.ts
 function createMultiEdit(config = {}) {
   const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
   return _ai.tool.call(void 0, {
-    description: "Atomically apply multiple text edits to a single file. All edits succeed together or none are applied (rollback on failure). Each edit replaces one occurrence of old_string with new_string. Edits are applied sequentially in the order provided.",
+    description: _nullishCoalesce(config.description, () => ( getPrompt())),
     inputSchema: _zod.z.object({
       file_path: _zod.z.string().describe("Path to the file to edit (absolute or relative to cwd)"),
       edits: _zod.z.array(
@@ -43,29 +62,29 @@ function createMultiEdit(config = {}) {
           return "No edits provided. File unchanged.";
         }
         const resolvedPath = _chunkQZ5GS6HWcjs.expandPath.call(void 0, file_path, cwd);
-        const originalContent = await _promises.readFile.call(void 0, resolvedPath, "utf-8");
+        const originalContent = await _chunkBIAODQ2Pcjs.readTextContent.call(void 0, resolvedPath);
         let content = originalContent;
         for (let i = 0; i < edits.length; i++) {
           const edit = edits[i];
-          const actualOldString = _chunk5NW4OGRIcjs.findActualString.call(void 0, content, edit.old_string);
+          const actualOldString = _chunkYTPZHJDCcjs.findActualString.call(void 0, content, edit.old_string);
           if (actualOldString === null) {
             return `Error [multi-edit]: Edit ${i + 1}/${edits.length} failed \u2014 old_string not found in file. No edits were applied. File: ${resolvedPath}`;
           }
-          const occurrences = countOccurrences(content, actualOldString);
+          const occurrences = _chunkYTPZHJDCcjs.countOccurrences.call(void 0, content, actualOldString);
           if (occurrences > 1) {
             return `Error [multi-edit]: Edit ${i + 1}/${edits.length} failed \u2014 old_string matches ${occurrences} locations (must be unique). No edits were applied. File: ${resolvedPath}`;
           }
-          const styledNewString = _chunk5NW4OGRIcjs.preserveQuoteStyle.call(void 0, 
+          const styledNewString = _chunkYTPZHJDCcjs.preserveQuoteStyle.call(void 0, 
             edit.old_string,
             actualOldString,
             edit.new_string
           );
-          content = _chunk5NW4OGRIcjs.applyEditToFile.call(void 0, content, actualOldString, styledNewString);
+          content = _chunkYTPZHJDCcjs.applyEditToFile.call(void 0, content, actualOldString, styledNewString);
         }
-        await _chunkCAEVLIQBcjs.writeTextContent.call(void 0, resolvedPath, content);
+        await _chunkBIAODQ2Pcjs.writeTextContent.call(void 0, resolvedPath, content);
         return `Successfully applied ${edits.length} edit${edits.length === 1 ? "" : "s"} to ${resolvedPath}`;
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
         return `Error [multi-edit]: ${msg}`;
       }
     }
@@ -76,4 +95,5 @@ var multiEdit = createMultiEdit();
 
 
 
-exports.createMultiEdit = createMultiEdit; exports.multiEdit = multiEdit;
+
+exports.getPrompt = getPrompt; exports.createMultiEdit = createMultiEdit; exports.multiEdit = multiEdit;

package/dist/{chunk-L5JH4I77.cjs → chunk-VQSWMGG7.cjs}

@@ -1,21 +1,23 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/shared/task-store.ts
-var _promises = require('fs/promises');
-var _path = require('path');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkBIAODQ2Pcjs = require('./chunk-BIAODQ2P.cjs');
+
+// src/shared/task-store.ts
 var _crypto = require('crypto');
 function generateId() {
   return _crypto.randomBytes.call(void 0, 4).toString("hex");
 }
 async function loadTasks(filePath) {
   try {
-    const data = await _promises.readFile.call(void 0, filePath, "utf-8");
+    const data = await _chunkBIAODQ2Pcjs.readTextContent.call(void 0, filePath);
     return JSON.parse(data);
   } catch (e) {
     return [];
   }
 }
 async function saveTasks(filePath, tasks) {
-  await _promises.mkdir.call(void 0, _path.dirname.call(void 0, filePath), { recursive: true });
-  await _promises.writeFile.call(void 0, filePath, JSON.stringify(tasks, null, 2), "utf-8");
+  await _chunkBIAODQ2Pcjs.writeTextContent.call(void 0, filePath, JSON.stringify(tasks, null, 2));
 }
 function formatTask(t) {
   const lines = [

package/dist/{chunk-4HIATLKI.js → chunk-VZRXTFS4.js}

@@ -1,3 +1,7 @@
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
+
 // src/web-fetch/index.ts
 import { tool } from "ai";
 import { z } from "zod";
@@ -73,10 +77,31 @@ async function fetchUrl(url, options) {
   };
 }
 
+// src/web-fetch/prompt.ts
+function getPrompt(config = {}) {
+  const timeout = config.timeout ?? 3e4;
+  return `Fetch a URL and return its content. HTML pages are automatically converted to markdown for easier reading. JSON and other text content is returned as-is.
+
+## When to Use
+- To retrieve and read web page content, documentation, or articles
+- To fetch API responses, JSON data, or raw text from URLs
+- To check what a web page contains
+
+## When NOT to Use
+- For API interactions that need custom HTTP methods (POST, PUT, DELETE) \u2014 use the dedicated HTTP request tool instead
+- For searching the web \u2014 use the dedicated web search tool instead
+
+## Usage Guidelines
+- Content is truncated at 100,000 characters to manage context size
+- The URL must be a fully-formed valid URL (e.g., https://example.com)
+- Timeout: ${timeout}ms
+- This tool is read-only \u2014 it does not modify any files or state`;
+}
+
 // src/web-fetch/index.ts
 function createWebFetch(config = {}) {
   return tool({
-    description: "Fetch a URL and return its content. HTML pages are automatically converted to markdown for easier reading. JSON and other text content is returned as-is. Content is truncated at 100,000 characters to manage context size.",
+    description: config.description ?? getPrompt(config),
     inputSchema: z.object({
       url: z.string().url().describe("The URL to fetch")
     }),
@@ -98,7 +123,7 @@ function createWebFetch(config = {}) {
         parts.push(result.content);
         return parts.join("\n");
       } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = extractErrorMessage(error);
         return `Error [web-fetch]: Failed to fetch ${url}: ${msg}`;
       }
     }
@@ -107,6 +132,7 @@ function createWebFetch(config = {}) {
 var webFetch = createWebFetch();
 
 export {
+  getPrompt,
   createWebFetch,
   webFetch
 };

package/dist/chunk-WCR62UZ3.js

@@ -0,0 +1,67 @@
+import {
+  formatTask,
+  loadTasks
+} from "./chunk-VHLY7LQE.js";
+import {
+  extractErrorMessage
+} from "./chunk-X6ZY2KFU.js";
+
+// src/task-get/index.ts
+import { tool } from "ai";
+import { z } from "zod";
+import { join } from "path";
+
+// src/task-get/prompt.ts
+function getPrompt() {
+  return `Retrieve a task by its ID to see full details including description, dependencies, and metadata.
+
+## When to Use
+- Before starting work on a task \u2014 read the full description and requirements
+- To check a task's dependencies (what it blocks, what blocks it)
+- To verify a task's current status before updating it
+- When you need more detail than the task list summary provides
+
+## Output
+Returns full task details:
+- **id**, **subject**, **description**, **status**
+- **owner**: Who is assigned (if set)
+- **activeForm**: Present continuous label (if set)
+- **blocks**: Tasks waiting on this one to complete
+- **blockedBy**: Tasks that must complete before this one can start
+- **metadata**: Attached key-value data
+- **createdAt**, **updatedAt**: Timestamps
+
+## Tips
+- Always verify a task's \`blockedBy\` list is empty before beginning work on it
+- Use the task list tool to see all tasks in summary form, then this tool for details on specific ones`;
+}
+
+// src/task-get/index.ts
+function createTaskGet(config = {}) {
+  const cwd = config.cwd ?? process.cwd();
+  const tasksFile = config.tasksFile ?? join(cwd, ".agentool", "tasks.json");
+  return tool({
+    description: config.description ?? getPrompt(),
+    inputSchema: z.object({
+      taskId: z.string().describe("The ID of the task to retrieve")
+    }),
+    execute: async ({ taskId }) => {
+      try {
+        const tasks = await loadTasks(tasksFile);
+        const found = tasks.find((t) => t.id === taskId);
+        if (!found) return `Error [task-get]: Task "${taskId}" not found.`;
+        return formatTask(found);
+      } catch (error) {
+        const msg = extractErrorMessage(error);
+        return `Error [task-get]: ${msg}`;
+      }
+    }
+  });
+}
+var taskGet = createTaskGet();
+
+export {
+  getPrompt,
+  createTaskGet,
+  taskGet
+};

package/dist/chunk-X6ZY2KFU.js

@@ -0,0 +1,8 @@
+// src/shared/errors.ts
+function extractErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export {
+  extractErrorMessage
+};

package/dist/chunk-XGDE7S2D.cjs

@@ -0,0 +1,67 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+var _chunkVQSWMGG7cjs = require('./chunk-VQSWMGG7.cjs');
+
+
+var _chunkKONXT2SFcjs = require('./chunk-KONXT2SF.cjs');
+
+// src/task-get/index.ts
+var _ai = require('ai');
+var _zod = require('zod');
+var _path = require('path');
+
+// src/task-get/prompt.ts
+function getPrompt() {
+  return `Retrieve a task by its ID to see full details including description, dependencies, and metadata.
+
+## When to Use
+- Before starting work on a task \u2014 read the full description and requirements
+- To check a task's dependencies (what it blocks, what blocks it)
+- To verify a task's current status before updating it
+- When you need more detail than the task list summary provides
+
+## Output
+Returns full task details:
+- **id**, **subject**, **description**, **status**
+- **owner**: Who is assigned (if set)
+- **activeForm**: Present continuous label (if set)
+- **blocks**: Tasks waiting on this one to complete
+- **blockedBy**: Tasks that must complete before this one can start
+- **metadata**: Attached key-value data
+- **createdAt**, **updatedAt**: Timestamps
+
+## Tips
+- Always verify a task's \`blockedBy\` list is empty before beginning work on it
+- Use the task list tool to see all tasks in summary form, then this tool for details on specific ones`;
+}
+
+// src/task-get/index.ts
+function createTaskGet(config = {}) {
+  const cwd = _nullishCoalesce(config.cwd, () => ( process.cwd()));
+  const tasksFile = _nullishCoalesce(config.tasksFile, () => ( _path.join.call(void 0, cwd, ".agentool", "tasks.json")));
+  return _ai.tool.call(void 0, {
+    description: _nullishCoalesce(config.description, () => ( getPrompt())),
+    inputSchema: _zod.z.object({
+      taskId: _zod.z.string().describe("The ID of the task to retrieve")
+    }),
+    execute: async ({ taskId }) => {
+      try {
+        const tasks = await _chunkVQSWMGG7cjs.loadTasks.call(void 0, tasksFile);
+        const found = tasks.find((t) => t.id === taskId);
+        if (!found) return `Error [task-get]: Task "${taskId}" not found.`;
+        return _chunkVQSWMGG7cjs.formatTask.call(void 0, found);
+      } catch (error) {
+        const msg = _chunkKONXT2SFcjs.extractErrorMessage.call(void 0, error);
+        return `Error [task-get]: ${msg}`;
+      }
+    }
+  });
+}
+var taskGet = createTaskGet();
+
+
+
+
+
+exports.getPrompt = getPrompt; exports.createTaskGet = createTaskGet; exports.taskGet = taskGet;