@peerllm/client-core 0.1.0

package/dist/exposers/tools/GitTools.js

@@ -0,0 +1,53 @@
+import { answerOrRaise } from "./Refusals.js";
+// The four read-only git tools (SPEC.md 7.2).
+//
+// Each one is a fixed argv with nothing the model fills in, which is the whole reason they are Safe
+// while `run_command` is Irreversible. A `git` tool that took arguments would be `run_command`
+// wearing a friendlier name, and the first thing through it would be `git push --force`.
+const GIT_TOOLS = [
+    {
+        name: "git_status",
+        argv: ["git", "status", "--short", "--branch"],
+        description: "What git says has changed in the workspace, and which branch it is on.",
+        narration: "Checking git status",
+    },
+    {
+        name: "git_diff",
+        argv: ["git", "diff"],
+        description: "The unstaged changes in the workspace, as a unified diff.",
+        narration: "Reading the diff",
+    },
+    {
+        name: "git_log",
+        argv: ["git", "log", "--oneline", "-20"],
+        description: "The last twenty commits, one line each.",
+        narration: "Reading the history",
+    },
+    {
+        name: "git_branch",
+        argv: ["git", "branch", "--show-current"],
+        description: "The branch the workspace is on.",
+        narration: "Checking the branch",
+    },
+];
+export function createGitTools(processProcessingService, workspaceRoot) {
+    return GIT_TOOLS.map((git) => ({
+        name: git.name,
+        description: git.description,
+        // No parameters at all, so there is nothing for a model to put a second command into.
+        parameters: JSON.stringify({ type: "object", properties: {} }),
+        risk: "Safe",
+        narrationStarting: git.narration,
+        scopeOf: () => workspaceRoot,
+        execute: async () => {
+            try {
+                return await processProcessingService.runCommand(git.argv, workspaceRoot);
+            }
+            catch (error) {
+                return answerOrRaise(error);
+            }
+        },
+    }));
+}
+export const GIT_TOOL_NAMES = GIT_TOOLS.map((git) => git.name);
+//# sourceMappingURL=GitTools.js.map

package/dist/exposers/tools/GitTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitTools.js","sourceRoot":"","sources":["../../../src/exposers/tools/GitTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,8CAA8C;AAC9C,EAAE;AACF,oGAAoG;AACpG,+FAA+F;AAC/F,yFAAyF;AACzF,MAAM,SAAS,GAAqG;IAClH;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;QAC9C,WAAW,EAAE,wEAAwE;QACrF,SAAS,EAAE,qBAAqB;KACjC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,2DAA2D;QACxE,SAAS,EAAE,kBAAkB;KAC9B;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC;QACxC,WAAW,EAAE,yCAAyC;QACtD,SAAS,EAAE,qBAAqB;KACjC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC;QACzC,WAAW,EAAE,iCAAiC;QAC9C,SAAS,EAAE,qBAAqB;KACjC;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,wBAAkD,EAClD,aAAqB;IAErB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAE5B,sFAAsF;QACtF,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC9D,IAAI,EAAE,MAAe;QACrB,iBAAiB,EAAE,GAAG,CAAC,SAAS;QAChC,OAAO,EAAE,GAAW,EAAE,CAAC,aAAa;QAEpC,OAAO,EAAE,KAAK,IAAqB,EAAE;YACnC,IAAI,CAAC;gBACH,OAAO,MAAM,wBAAwB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YAC5E,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/dist/exposers/tools/GlobFilesTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createGlobFilesTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=GlobFilesTool.d.ts.map

package/dist/exposers/tools/GlobFilesTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobFilesTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/GlobFilesTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAGlI,wBAAgB,mBAAmB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAsBxG"}

package/dist/exposers/tools/GlobFilesTool.js

@@ -0,0 +1,41 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// glob_files (SPEC.md 7.2): every file under a root whose path a pattern names, newest first.
+export function createGlobFilesTool(workspaceFileProcessingService) {
+    return {
+        name: "glob_files",
+        description: GLOB_FILES_DESCRIPTION,
+        parameters: GLOB_FILES_PARAMETERS,
+        risk: "Safe",
+        narrationStarting: "Looking for files",
+        scopeOf: (input) => scopeOrNothing(input)?.root ?? "",
+        execute: async (input) => {
+            try {
+                const asked = readArguments(input);
+                const paths = await workspaceFileProcessingService.glob(asked.root, asked.pattern);
+                // An empty answer reads to a model as a tool that failed, and it asks again with the same
+                // pattern.
+                return paths.length === 0 ? "no file under that directory matches that pattern" : paths.join("\n");
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault that ends the run.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+function readArguments(input) {
+    const asked = readArgumentsOrRefuse(input, "glob_files");
+    return { root: asked.root ?? "", pattern: asked.pattern ?? "" };
+}
+const GLOB_FILES_DESCRIPTION = "Find files under a directory whose path matches a pattern, newest first. One star stays inside " +
+    "a name, two stars cross directories, and a question mark is one character. What .gitignore and " +
+    ".peerllmignore hide is not searched.";
+const GLOB_FILES_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        root: { type: "string", description: "The directory to search under." },
+        pattern: { type: "string", description: "The pattern to match against each path, such as **/*.ts." },
+    },
+    required: ["root", "pattern"],
+});
+//# sourceMappingURL=GlobFilesTool.js.map

package/dist/exposers/tools/GlobFilesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobFilesTool.js","sourceRoot":"","sources":["../../../src/exposers/tools/GlobFilesTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CAAC,8BAA8D;IAChG,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sBAAsB;QACnC,UAAU,EAAE,qBAAqB;QACjC,IAAI,EAAE,MAAM;QACZ,iBAAiB,EAAE,mBAAmB;QACtC,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,cAAc,CAAyB,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE;QAC7F,OAAO,EAAE,KAAK,EAAE,KAAa,EAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,KAAK,GAAG,MAAM,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAEnF,0FAA0F;gBAC1F,WAAW;gBACX,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mDAAmD,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrG,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,mFAAmF;gBACnF,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAOD,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,qBAAqB,CAAyB,KAAK,EAAE,YAAY,CAAC,CAAC;IAEjF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,sBAAsB,GAC1B,iGAAiG;IACjG,iGAAiG;IACjG,sCAAsC,CAAC;AAEzC,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC;IAC3C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;QACvE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;KACrG;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;CAC9B,CAAC,CAAC"}

package/dist/exposers/tools/GrepFilesTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createGrepFilesTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=GrepFilesTool.d.ts.map

package/dist/exposers/tools/GrepFilesTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrepFilesTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/GrepFilesTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAIlI,wBAAgB,mBAAmB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAwBxG"}

package/dist/exposers/tools/GrepFilesTool.js

@@ -0,0 +1,56 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// grep_files (SPEC.md 7.2): every line under a root that an expression matches, with the lines
+// around it.
+export function createGrepFilesTool(workspaceFileProcessingService) {
+    return {
+        name: "grep_files",
+        description: GREP_FILES_DESCRIPTION,
+        parameters: GREP_FILES_PARAMETERS,
+        risk: "Safe",
+        narrationStarting: "Searching the files",
+        scopeOf: (input) => scopeOrNothing(input)?.root ?? "",
+        execute: async (input) => {
+            try {
+                const asked = readArguments(input);
+                const matches = await workspaceFileProcessingService.grep(asked.root, asked.expression, asked.contextLines);
+                // An empty answer reads to a model as a tool that failed, and it asks again with the same
+                // expression.
+                return matches.length === 0
+                    ? "no line under that directory matches that expression"
+                    : matches.map((match) => present(match)).join("\n");
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault that ends the run.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+// A colon is the line that matched and a dash is a line carried for company, which is the shape
+// every developer already reads without being told.
+function present(match) {
+    const first = match.lineNumber - match.before.length;
+    const lines = [
+        ...match.before.map((line, index) => `${match.relativePath}:${first + index}- ${line}`),
+        `${match.relativePath}:${match.lineNumber}: ${match.line}`,
+        ...match.after.map((line, index) => `${match.relativePath}:${match.lineNumber + 1 + index}- ${line}`),
+    ];
+    return lines.join("\n");
+}
+function readArguments(input) {
+    const asked = readArgumentsOrRefuse(input, "grep_files");
+    return { root: asked.root ?? "", expression: asked.expression ?? "", contextLines: asked.contextLines ?? 0 };
+}
+const GREP_FILES_DESCRIPTION = "Search the text of files under a directory for a regular expression. Answers each match as " +
+    "path:line: text, with any lines asked for around it written path:line- text. What .gitignore " +
+    "and .peerllmignore hide is not searched, and a file the workspace will not show is passed over.";
+const GREP_FILES_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        root: { type: "string", description: "The directory to search under." },
+        expression: { type: "string", description: "The regular expression to look for in each line." },
+        contextLines: { type: "integer", description: "How many lines to carry either side of a match. Defaults to 0." },
+    },
+    required: ["root", "expression"],
+});
+//# sourceMappingURL=GrepFilesTool.js.map

package/dist/exposers/tools/GrepFilesTool.js.map

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

package/dist/exposers/tools/ListDirectoryTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createListDirectoryTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=ListDirectoryTool.d.ts.map

package/dist/exposers/tools/ListDirectoryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListDirectoryTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/ListDirectoryTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAGlI,wBAAgB,uBAAuB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAuB5G"}

package/dist/exposers/tools/ListDirectoryTool.js

@@ -0,0 +1,45 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// list_directory (SPEC.md 7.2): what one directory holds, as the workspace is willing to show it.
+export function createListDirectoryTool(workspaceFileProcessingService) {
+    return {
+        name: "list_directory",
+        description: LIST_DIRECTORY_DESCRIPTION,
+        parameters: LIST_DIRECTORY_PARAMETERS,
+        risk: "Safe",
+        narrationStarting: "Listing a directory",
+        scopeOf: (input) => scopeOrNothing(input)?.path ?? "",
+        execute: async (input) => {
+            try {
+                const entries = await workspaceFileProcessingService.listDirectory(readPath(input));
+                // A directory that holds nothing the workspace will show says so in words. An empty answer
+                // reads to a model as a tool that failed, and it asks again.
+                return entries.length === 0
+                    ? "the directory holds nothing the workspace will show"
+                    : entries.map((entry) => describe(entry)).join("\n");
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault that ends the run.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+// A directory wears its slash and a file wears its size, so one glance says which is which and
+// what a read would cost.
+function describe(entry) {
+    return entry.isDirectory ? `${entry.name}/` : `${entry.name}  ${entry.size}`;
+}
+function readPath(input) {
+    return readArgumentsOrRefuse(input, "list_directory").path ?? "";
+}
+const LIST_DIRECTORY_DESCRIPTION = "List what a directory in the workspace holds. Directories are named with a trailing slash and " +
+    "files with their size in bytes. What .gitignore and .peerllmignore hide is not listed, and the " +
+    "repository store is never listed.";
+const LIST_DIRECTORY_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        path: { type: "string", description: "The directory to list, absolute or relative to the workspace." },
+    },
+    required: ["path"],
+});
+//# sourceMappingURL=ListDirectoryTool.js.map

package/dist/exposers/tools/ListDirectoryTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListDirectoryTool.js","sourceRoot":"","sources":["../../../src/exposers/tools/ListDirectoryTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,kGAAkG;AAClG,MAAM,UAAU,uBAAuB,CAAC,8BAA8D;IACpG,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,yBAAyB;QACrC,IAAI,EAAE,MAAM;QACZ,iBAAiB,EAAE,qBAAqB;QACxC,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,cAAc,CAAoB,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE;QACxF,OAAO,EAAE,KAAK,EAAE,KAAa,EAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,8BAA8B,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEpF,2FAA2F;gBAC3F,6DAA6D;gBAC7D,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC;oBACzB,CAAC,CAAC,qDAAqD;oBACvD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,mFAAmF;gBACnF,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,0BAA0B;AAC1B,SAAS,QAAQ,CAAC,KAAqB;IACrC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;AAC/E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,qBAAqB,CAAoB,KAAK,EAAE,gBAAgB,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACtF,CAAC;AAED,MAAM,0BAA0B,GAC9B,gGAAgG;IAChG,iGAAiG;IACjG,mCAAmC,CAAC;AAEtC,MAAM,yBAAyB,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;KACvG;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;CACnB,CAAC,CAAC"}

package/dist/exposers/tools/ReadFileTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createReadFileTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=ReadFileTool.d.ts.map

package/dist/exposers/tools/ReadFileTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadFileTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/ReadFileTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAGlI,wBAAgB,kBAAkB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAmCvG"}

package/dist/exposers/tools/ReadFileTool.js

@@ -0,0 +1,65 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// read_file (SPEC.md 7.2): a window of one file in the workspace, by line range.
+export function createReadFileTool(workspaceFileProcessingService) {
+    return {
+        name: "read_file",
+        description: READ_FILE_DESCRIPTION,
+        parameters: READ_FILE_PARAMETERS,
+        risk: "Safe",
+        narrationStarting: "Reading a file",
+        scopeOf: (input) => scopeOrNothing(input)?.path ?? "",
+        execute: async (input) => {
+            try {
+                const asked = readArguments(input);
+                const paged = await workspaceFileProcessingService.retrieveFile(asked.path, asked.offset, asked.limit);
+                // The file's own text, unchanged, every time it is asked for.
+                //
+                // A second read used to be answered with the fact rather than the file, on the reasoning
+                // that it told the model nothing it did not already have. A model that asks twice is a
+                // model that does not have it, and the cost of being wrong about that was the whole run:
+                // starved of the text it could not produce an exact anchor for an edit, so it described the
+                // edit in prose, asked the user to approve it, and could not act on the approval either.
+                //
+                // What is left of the idea is the note. It is worth telling a model that it is reading the
+                // same bytes again; it is not worth refusing to show them.
+                const hints = [
+                    ...(paged.alreadyRead ? [alreadyReadNote(paged)] : []),
+                    ...(paged.truncated ? [pagingHint(paged)] : []),
+                ];
+                return hints.length === 0 ? paged.text : [paged.text, ...hints].join("\n");
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault that ends the run.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+// An exposer maps and nothing else. A number nobody named is the processing's own default rather
+// than this module's opinion, which is why the absent cases are the values the processing already
+// treats as "from the top" and "as much as fits".
+function readArguments(input) {
+    const asked = readArgumentsOrRefuse(input, "read_file");
+    return { path: asked.path ?? "", offset: asked.offset ?? 1, limit: asked.limit ?? 0 };
+}
+// Said beside the file rather than instead of it: the same bytes, and nothing has happened to them
+// since. A model reading a file it changed a moment ago needs to know which of those two this is.
+function alreadyReadNote(paged) {
+    return `[read_file] ${paged.path} lines ${paged.firstLine} to ${paged.lastLine}, unchanged since you read it in this run`;
+}
+function pagingHint(paged) {
+    return (`[read_file] ${paged.path} lines ${paged.firstLine} to ${paged.lastLine} of ${paged.totalLines}; ` +
+        `ask again with offset ${paged.lastLine + 1} for the rest`);
+}
+const READ_FILE_DESCRIPTION = "Read a file in the workspace. Answers with the file's own text, unchanged, from the first line " +
+    "asked for. Large files come back a window at a time and say how to ask for the rest.";
+const READ_FILE_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        path: { type: "string", description: "The file to read, absolute or relative to the workspace." },
+        offset: { type: "integer", description: "The first line to read, counting from 1. Defaults to 1." },
+        limit: { type: "integer", description: "How many lines to read. Defaults to as many as fit." },
+    },
+    required: ["path"],
+});
+//# sourceMappingURL=ReadFileTool.js.map

package/dist/exposers/tools/ReadFileTool.js.map

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

package/dist/exposers/tools/Refusals.d.ts

@@ -0,0 +1,6 @@
+export declare const REFUSAL_MARKERS: string[];
+export declare function readArgumentsOrRefuse<T>(input: string, toolName: string): T;
+export declare function scopeOrNothing<T>(input: string): T | null;
+export declare function refusalIn(error: unknown): string | null;
+export declare function answerOrRaise(error: unknown): string;
+//# sourceMappingURL=Refusals.d.ts.map

package/dist/exposers/tools/Refusals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Refusals.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/Refusals.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,eAAe,UAU3B,CAAC;AAYF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAU3E;AAYD,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMzD;AAMD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQvD;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQpD"}

package/dist/exposers/tools/Refusals.js

@@ -0,0 +1,91 @@
+// What a tool answers when the workspace said no (PLAN.md 4.5).
+//
+// A refusal is a result, not a fault. The model asked for something it may not have or named an
+// anchor that is not there; it can read again and try, and it can only do that if the refusal comes
+// back to it as an observation. An exception here ends the whole run over a mistake the next turn
+// would have fixed.
+//
+// Every refusal this client raises begins with one of these, which is also what the orchestrator's
+// loop-breaker watches for.
+export const REFUSAL_MARKERS = [
+    "could not find",
+    "could not apply",
+    "could not read",
+    "could not delete",
+    "could not write",
+    "does not exist",
+    "already exists",
+    "permission denied",
+    "too large",
+];
+// A model's own arguments, read back.
+//
+// A tool call arrives as a JSON string the model wrote, and a model writing a long one can be cut
+// off partway: the provider stops generating and what reaches here ends mid-string. That is a
+// mistake the next turn can fix, so it comes back as a refusal rather than ending the run. It used
+// to throw, and the person watching was told "contact support" about a file they asked to be
+// written.
+//
+// Named with the tool, because "your arguments were cut off" is only useful if the model knows
+// which call it was.
+export function readArgumentsOrRefuse(input, toolName) {
+    try {
+        return JSON.parse(input);
+    }
+    catch {
+        throw new Error(`could not read: the arguments to ${toolName} were cut off before the end, or are not valid JSON. ` +
+            `Send the call again with less in it: a long file can be written in parts, and one region of it ` +
+            `can be changed with single_find_and_replace.`);
+    }
+}
+// The same arguments, read for the act's name rather than for the act.
+//
+// scopeOf describes what a call is about to touch, so the approval guarding it can name it. The
+// framework calls it while building the effect, before the tool runs and outside any catch of the
+// tool's own, so a throw here is not a refusal the model hears: it is the coordination fault a
+// person was shown as "contact support" after asking for a file.
+//
+// A call nobody can read has no scope to name, so it names none. Every grant is remembered for the
+// tool and the scope it was given for, and the empty scope is already what an act with nothing to
+// name carries, so nothing is remembered for a call that is about to be refused anyway.
+export function scopeOrNothing(input) {
+    try {
+        return JSON.parse(input);
+    }
+    catch {
+        return null;
+    }
+}
+// The refusal inside a categorised exception, or nothing when this was not a refusal at all. The
+// chain is walked because every tier wraps the one below it, and the sentence worth telling the
+// model is the innermost one: the tier names say what kind of failure it was, and the model can do
+// nothing with that.
+export function refusalIn(error) {
+    for (const message of messagesIn(error)) {
+        if (REFUSAL_MARKERS.some((marker) => message.startsWith(marker))) {
+            return message;
+        }
+    }
+    return null;
+}
+// Anything that is not a refusal is left to rise. A tool that swallowed a real fault would tell the
+// model the act succeeded, and the model would build on it.
+export function answerOrRaise(error) {
+    const refusal = refusalIn(error);
+    if (refusal === null) {
+        throw error;
+    }
+    return refusal;
+}
+function messagesIn(error) {
+    const messages = [];
+    let current = error;
+    while (current !== null && current !== undefined) {
+        messages.push((current.message ?? "").trim());
+        current = current.innerError;
+    }
+    // Innermost first: the outermost is a category, and a category is not something a model can act
+    // on.
+    return messages.reverse();
+}
+//# sourceMappingURL=Refusals.js.map

package/dist/exposers/tools/Refusals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Refusals.js","sourceRoot":"","sources":["../../../src/exposers/tools/Refusals.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,gGAAgG;AAChG,oGAAoG;AACpG,kGAAkG;AAClG,oBAAoB;AACpB,EAAE;AACF,mGAAmG;AACnG,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,WAAW;CACZ,CAAC;AAEF,sCAAsC;AACtC,EAAE;AACF,kGAAkG;AAClG,8FAA8F;AAC9F,mGAAmG;AACnG,6FAA6F;AAC7F,WAAW;AACX,EAAE;AACF,+FAA+F;AAC/F,qBAAqB;AACrB,MAAM,UAAU,qBAAqB,CAAI,KAAa,EAAE,QAAgB;IACtE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,uDAAuD;YACjG,iGAAiG;YACjG,8CAA8C,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,+FAA+F;AAC/F,iEAAiE;AACjE,EAAE;AACF,mGAAmG;AACnG,kGAAkG;AAClG,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAI,KAAa;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,gGAAgG;AAChG,mGAAmG;AACnG,qBAAqB;AACrB,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACjE,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,KAAsE,CAAC;IAErF,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,OAAO,CAAC,UAA2E,CAAC;IAChG,CAAC;IAED,gGAAgG;IAChG,MAAM;IACN,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/dist/exposers/tools/RunCommandTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { ProcessProcessingService } from "../../services/processings/processes/ProcessProcessingService.js";
+export declare function createRunCommandTool(processProcessingService: ProcessProcessingService, workspaceRoot: string): Tool;
+//# sourceMappingURL=RunCommandTool.d.ts.map

package/dist/exposers/tools/RunCommandTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunCommandTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/RunCommandTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AASjH,wBAAgB,oBAAoB,CAClC,wBAAwB,EAAE,wBAAwB,EAClD,aAAa,EAAE,MAAM,GACpB,IAAI,CAoBN"}

package/dist/exposers/tools/RunCommandTool.js

@@ -0,0 +1,51 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// run_command (SPEC.md 7.2): a program, run in the workspace, with what it said and what it
+// returned.
+//
+// Irreversible, and it means it. A command can delete a branch, push to a remote or drop a
+// database, and nothing here can tell which one it is looking at: `npm test` and `npm run deploy`
+// are the same shape. So the risk is the highest one and the approval is the user's every time.
+export function createRunCommandTool(processProcessingService, workspaceRoot) {
+    return {
+        name: "run_command",
+        description: RUN_DESCRIPTION,
+        parameters: RUN_PARAMETERS,
+        risk: "Irreversible",
+        narrationStarting: "Running a command",
+        // The program and what follows it, which is what a person deciding is actually looking at. A
+        // scope of the program alone would let one approved `git` stand for every `git` there is.
+        scopeOf: (input) => argvIn(scopeOrNothing(input)).join(" "),
+        execute: async (input) => {
+            try {
+                return await processProcessingService.runCommand(readArgv(input), workspaceRoot);
+            }
+            catch (error) {
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+function readArgv(input) {
+    return argvIn(readArgumentsOrRefuse(input, "run_command"));
+}
+// A command is a list, and anything else is no command at all: an argv the model sent as one
+// string would otherwise be spawned as a program whose whole name is "git status".
+function argvIn(asked) {
+    return Array.isArray(asked?.argv) ? asked.argv.map((part) => String(part)) : [];
+}
+const RUN_DESCRIPTION = "Run a program in the workspace and read back what it printed and what it returned. Give argv as " +
+    "a list: the program first, then each argument as its own item. There is no shell, so pipes, " +
+    "redirection, globs and $(...) are not interpreted; run the program directly instead. The user " +
+    "is asked before anything runs. A non-zero exit is an answer, not a failure of the tool.";
+const RUN_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        argv: {
+            type: "array",
+            items: { type: "string" },
+            description: 'The program and its arguments, such as ["npm", "test"]. Not a shell line.',
+        },
+    },
+    required: ["argv"],
+});
+//# sourceMappingURL=RunCommandTool.js.map

package/dist/exposers/tools/RunCommandTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunCommandTool.js","sourceRoot":"","sources":["../../../src/exposers/tools/RunCommandTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErF,4FAA4F;AAC5F,YAAY;AACZ,EAAE;AACF,2FAA2F;AAC3F,kGAAkG;AAClG,gGAAgG;AAChG,MAAM,UAAU,oBAAoB,CAClC,wBAAkD,EAClD,aAAqB;IAErB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,eAAe;QAC5B,UAAU,EAAE,cAAc;QAC1B,IAAI,EAAE,cAAc;QACpB,iBAAiB,EAAE,mBAAmB;QAEtC,6FAA6F;QAC7F,0FAA0F;QAC1F,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,cAAc,CAAqB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAE/F,OAAO,EAAE,KAAK,EAAE,KAAa,EAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,OAAO,MAAM,wBAAwB,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,MAAM,CAAC,qBAAqB,CAAqB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,6FAA6F;AAC7F,mFAAmF;AACnF,SAAS,MAAM,CAAC,KAAgC;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,eAAe,GACnB,kGAAkG;IAClG,8FAA8F;IAC9F,gGAAgG;IAChG,yFAAyF,CAAC;AAE5F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,2EAA2E;SACzF;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;CACnB,CAAC,CAAC"}

package/dist/exposers/tools/SingleFindAndReplaceTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createSingleFindAndReplaceTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=SingleFindAndReplaceTool.d.ts.map

package/dist/exposers/tools/SingleFindAndReplaceTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleFindAndReplaceTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/SingleFindAndReplaceTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAGlI,wBAAgB,8BAA8B,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAqBnH"}

package/dist/exposers/tools/SingleFindAndReplaceTool.js

@@ -0,0 +1,42 @@
+import { answerOrRaise, readArgumentsOrRefuse, scopeOrNothing } from "./Refusals.js";
+// single_find_and_replace (SPEC.md 6.3): one edit, by a verbatim anchor that occurs exactly once.
+export function createSingleFindAndReplaceTool(workspaceFileProcessingService) {
+    return {
+        name: "single_find_and_replace",
+        description: EDIT_DESCRIPTION,
+        parameters: EDIT_PARAMETERS,
+        risk: "Sensitive",
+        narrationStarting: "Editing a file",
+        scopeOf: (input) => scopeOrNothing(input)?.path ?? "",
+        execute: async (input) => {
+            try {
+                const asked = readArguments(input);
+                const applied = await workspaceFileProcessingService.applyEdit(asked.path, asked.find, asked.replace);
+                // Where it landed, so the model can read back around it rather than the whole file again.
+                return `edited ${applied.path} at line ${applied.line}`;
+            }
+            catch (error) {
+                // A refusal is an observation the model can act on, not a fault that ends the run.
+                return answerOrRaise(error);
+            }
+        },
+    };
+}
+function readArguments(input) {
+    const asked = readArgumentsOrRefuse(input, "single_find_and_replace");
+    return { path: asked.path ?? "", find: asked.find ?? "", replace: asked.replace ?? "" };
+}
+const EDIT_DESCRIPTION = "Replace one exact passage of a file with another. The text you give as 'find' must appear in the " +
+    "file exactly once, character for character, including its indentation. There is no count " +
+    "argument: if it appears twice the edit is refused, and you extend it until it is unique. Never " +
+    "write a placeholder such as '...' or 'existing code' in either argument; write the text out.";
+const EDIT_PARAMETERS = JSON.stringify({
+    type: "object",
+    properties: {
+        path: { type: "string", description: "The file to edit." },
+        find: { type: "string", description: "The exact passage to replace, occurring once in the file." },
+        replace: { type: "string", description: "What to put in its place." },
+    },
+    required: ["path", "find", "replace"],
+});
+//# sourceMappingURL=SingleFindAndReplaceTool.js.map

package/dist/exposers/tools/SingleFindAndReplaceTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleFindAndReplaceTool.js","sourceRoot":"","sources":["../../../src/exposers/tools/SingleFindAndReplaceTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,kGAAkG;AAClG,MAAM,UAAU,8BAA8B,CAAC,8BAA8D;IAC3G,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,gBAAgB;QAC7B,UAAU,EAAE,eAAe;QAC3B,IAAI,EAAE,WAAW;QACjB,iBAAiB,EAAE,gBAAgB;QACnC,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,cAAc,CAAyB,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE;QAC7F,OAAO,EAAE,KAAK,EAAE,KAAa,EAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,OAAO,GAAG,MAAM,8BAA8B,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAEtG,0FAA0F;gBAC1F,OAAO,UAAU,OAAO,CAAC,IAAI,YAAY,OAAO,CAAC,IAAI,EAAE,CAAC;YAC1D,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,mFAAmF;gBACnF,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAQD,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,qBAAqB,CAAyB,KAAK,EAAE,yBAAyB,CAAC,CAAC;IAE9F,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,gBAAgB,GACpB,mGAAmG;IACnG,2FAA2F;IAC3F,iGAAiG;IACjG,8FAA8F,CAAC;AAEjG,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;QAC1D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;QAClG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;KACtE;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;CACtC,CAAC,CAAC"}

package/dist/exposers/tools/WriteFileTool.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@hassanhabib/standard-agents";
+import type { WorkspaceFileProcessingService } from "../../services/processings/workspaceFiles/WorkspaceFileProcessingService.js";
+export declare function createWriteFileTool(workspaceFileProcessingService: WorkspaceFileProcessingService): Tool;
+//# sourceMappingURL=WriteFileTool.d.ts.map

package/dist/exposers/tools/WriteFileTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteFileTool.d.ts","sourceRoot":"","sources":["../../../src/exposers/tools/WriteFileTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6EAA6E,CAAC;AAOlI,wBAAgB,mBAAmB,CAAC,8BAA8B,EAAE,8BAA8B,GAAG,IAAI,CAqBxG"}