@hardlydifficult/agent-tools 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+/** Max bytes to return from read_file before truncating. */
+export declare const MAX_READ_BYTES = 100000;
+/** Max file size (bytes) to scan during content search — skip larger files. */
+export declare const MAX_GREP_FILE_SIZE: number;
+/** Max total matches returned by search_files. */
+export declare const MAX_SEARCH_RESULTS = 100;
+/** Lines of context to show around each edit in write_file output. */
+export declare const MAX_CONTEXT_LINES = 3;
+/** Timeout for verify tool commands (ms). */
+export declare const VERIFY_TIMEOUT = 120000;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,cAAc,SAAU,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,QAAa,CAAC;AAE7C,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,6CAA6C;AAC7C,eAAO,MAAM,cAAc,SAAU,CAAC"}

package/dist/config.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERIFY_TIMEOUT = exports.MAX_CONTEXT_LINES = exports.MAX_SEARCH_RESULTS = exports.MAX_GREP_FILE_SIZE = exports.MAX_READ_BYTES = void 0;
+/** Max bytes to return from read_file before truncating. */
+exports.MAX_READ_BYTES = 100_000;
+/** Max file size (bytes) to scan during content search — skip larger files. */
+exports.MAX_GREP_FILE_SIZE = 100 * 1024;
+/** Max total matches returned by search_files. */
+exports.MAX_SEARCH_RESULTS = 100;
+/** Lines of context to show around each edit in write_file output. */
+exports.MAX_CONTEXT_LINES = 3;
+/** Timeout for verify tool commands (ms). */
+exports.VERIFY_TIMEOUT = 120_000;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC/C,QAAA,cAAc,GAAG,OAAO,CAAC;AAEtC,+EAA+E;AAClE,QAAA,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE7C,kDAAkD;AACrC,QAAA,kBAAkB,GAAG,GAAG,CAAC;AAEtC,sEAAsE;AACzD,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAEnC,6CAA6C;AAChC,QAAA,cAAc,GAAG,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { parsePath, type ParsedPath } from "./parsePath.js";
+export { MAX_READ_BYTES, MAX_GREP_FILE_SIZE, MAX_SEARCH_RESULTS, MAX_CONTEXT_LINES, VERIFY_TIMEOUT, } from "./config.js";
+export { toArray, executeWithErrorHandling, formatArrayResult, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatArrayResult = exports.executeWithErrorHandling = exports.toArray = exports.VERIFY_TIMEOUT = exports.MAX_CONTEXT_LINES = exports.MAX_SEARCH_RESULTS = exports.MAX_GREP_FILE_SIZE = exports.MAX_READ_BYTES = exports.parsePath = void 0;
+var parsePath_js_1 = require("./parsePath.js");
+Object.defineProperty(exports, "parsePath", { enumerable: true, get: function () { return parsePath_js_1.parsePath; } });
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "MAX_READ_BYTES", { enumerable: true, get: function () { return config_js_1.MAX_READ_BYTES; } });
+Object.defineProperty(exports, "MAX_GREP_FILE_SIZE", { enumerable: true, get: function () { return config_js_1.MAX_GREP_FILE_SIZE; } });
+Object.defineProperty(exports, "MAX_SEARCH_RESULTS", { enumerable: true, get: function () { return config_js_1.MAX_SEARCH_RESULTS; } });
+Object.defineProperty(exports, "MAX_CONTEXT_LINES", { enumerable: true, get: function () { return config_js_1.MAX_CONTEXT_LINES; } });
+Object.defineProperty(exports, "VERIFY_TIMEOUT", { enumerable: true, get: function () { return config_js_1.VERIFY_TIMEOUT; } });
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "toArray", { enumerable: true, get: function () { return utils_js_1.toArray; } });
+Object.defineProperty(exports, "executeWithErrorHandling", { enumerable: true, get: function () { return utils_js_1.executeWithErrorHandling; } });
+Object.defineProperty(exports, "formatArrayResult", { enumerable: true, get: function () { return utils_js_1.formatArrayResult; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAA4D;AAAnD,yGAAA,SAAS,OAAA;AAClB,yCAMqB;AALnB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,2GAAA,cAAc,OAAA;AAEhB,uCAIoB;AAHlB,mGAAA,OAAO,OAAA;AACP,oHAAA,wBAAwB,OAAA;AACxB,6GAAA,iBAAiB,OAAA"}

package/dist/parsePath.d.ts

@@ -0,0 +1,15 @@
+export interface ParsedPath {
+    filePath: string;
+    startLine?: number;
+    endLine?: number;
+}
+/**
+ * Parse a GitHub-style path with optional line range.
+ *
+ * Examples:
+ *   'src/index.ts'          → { filePath: 'src/index.ts' }
+ *   'src/index.ts#L10'      → { filePath: 'src/index.ts', startLine: 10, endLine: 10 }
+ *   'src/index.ts#L10-L20'  → { filePath: 'src/index.ts', startLine: 10, endLine: 20 }
+ */
+export declare function parsePath(path: string): ParsedPath;
+//# sourceMappingURL=parsePath.d.ts.map

package/dist/parsePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePath.d.ts","sourceRoot":"","sources":["../src/parsePath.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAWlD"}

package/dist/parsePath.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePath = parsePath;
+/**
+ * Parse a GitHub-style path with optional line range.
+ *
+ * Examples:
+ *   'src/index.ts'          → { filePath: 'src/index.ts' }
+ *   'src/index.ts#L10'      → { filePath: 'src/index.ts', startLine: 10, endLine: 10 }
+ *   'src/index.ts#L10-L20'  → { filePath: 'src/index.ts', startLine: 10, endLine: 20 }
+ */
+function parsePath(path) {
+    const match = /^(.+?)#L(\d+)(?:-L(\d+))?$/.exec(path);
+    if (!match) {
+        return { filePath: path };
+    }
+    const filePath = match[1];
+    const startLine = parseInt(match[2], 10);
+    const endLine = match[3] ? parseInt(match[3], 10) : startLine;
+    return { filePath, startLine, endLine };
+}
+//# sourceMappingURL=parsePath.js.map

package/dist/parsePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePath.js","sourceRoot":"","sources":["../src/parsePath.ts"],"names":[],"mappings":";;AAcA,8BAWC;AAnBD;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Normalize a value that may be a single item or an array into an array.
+ * Used by batchable tools to accept both `string` and `string[]` inputs.
+ */
+export declare function toArray<T>(input: T | T[]): T[];
+/**
+ * Wraps tool execution in try-catch and returns error message string.
+ * Eliminates duplicate try-catch blocks across tools.
+ */
+export declare function executeWithErrorHandling<T>(operation: () => Promise<T>, errorPrefix: string): Promise<T | string>;
+/**
+ * Formats array results with empty handling.
+ * Returns a custom message if the array is empty, otherwise joins with newlines.
+ */
+export declare function formatArrayResult(items: string[], emptyMessage: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAMrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR"}

package/dist/utils.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toArray = toArray;
+exports.executeWithErrorHandling = executeWithErrorHandling;
+exports.formatArrayResult = formatArrayResult;
+/**
+ * Normalize a value that may be a single item or an array into an array.
+ * Used by batchable tools to accept both `string` and `string[]` inputs.
+ */
+function toArray(input) {
+    return Array.isArray(input) ? input : [input];
+}
+/**
+ * Wraps tool execution in try-catch and returns error message string.
+ * Eliminates duplicate try-catch blocks across tools.
+ */
+async function executeWithErrorHandling(operation, errorPrefix) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        return `${errorPrefix}: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+/**
+ * Formats array results with empty handling.
+ * Returns a custom message if the array is empty, otherwise joins with newlines.
+ */
+function formatArrayResult(items, emptyMessage) {
+    if (items.length === 0) {
+        return emptyMessage;
+    }
+    return items.join("\n");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAIA,0BAEC;AAMD,4DASC;AAMD,8CAQC;AAnCD;;;GAGG;AACH,SAAgB,OAAO,CAAI,KAAc;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,wBAAwB,CAC5C,SAA2B,EAC3B,WAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,WAAW,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACrF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,KAAe,EACf,YAAoB;IAEpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@hardlydifficult/agent-tools",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}