alchemy 2.0.0-beta.3 → 2.0.0-beta.31

package/lib/Agent/coding/bash.d.ts

@@ -0,0 +1,36 @@
+import * as Effect from "effect/Effect";
+import * as S from "effect/Schema";
+declare const command_base: import("../index.ts").Parameter<"command", [], S.String>;
+export declare class command extends command_base {
+}
+declare const timeout_base: import("../index.ts").Parameter<"timeout", [], S.optional<S.Number>>;
+export declare class timeout extends timeout_base {
+}
+declare const workdir_base: import("../index.ts").Parameter<"workdir", [], S.optional<S.String>>;
+export declare class workdir extends workdir_base {
+}
+declare const description_base: import("../index.ts").Parameter<"description", [], S.String>;
+export declare class description extends description_base {
+}
+declare const exitCode_base: import("../index.ts").Result<"exitCode", [], S.Number>;
+export declare class exitCode extends exitCode_base {
+}
+declare const stdout_base: import("../index.ts").Result<"stdout", [], S.String>;
+export declare class stdout extends stdout_base {
+}
+declare const bash_base: import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect</*elided*/ any, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", "bash", [typeof command, typeof timeout, typeof exitCode, typeof stdout, S.String, typeof workdir, typeof description], {
+    alias: (model: string) => "AnthropicBash" | undefined;
+}, (input: {
+    readonly description: string;
+    readonly command: string;
+    readonly timeout?: number | undefined;
+    readonly workdir?: string | undefined;
+}) => Effect.Effect<NoInfer<string | ({
+    exitCode: number;
+} & {
+    stdout: string;
+})>, import("effect/PlatformError").PlatformError, import("effect/Scope").Scope | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner>>;
+export declare class bash extends bash_base {
+}
+export {};
+//# sourceMappingURL=bash.d.ts.map

package/lib/Agent/coding/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/Agent/coding/bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;;AAOnC,qBAAa,OAAQ,SAAQ,YAA6C;CAAG;;AAE7E,qBAAa,OAAQ,SAAQ,YAGM;CAAG;;AAEtC,qBAAa,OAAQ,SAAQ,YAGsE;CAAG;;AAEtG,qBAAa,WAAY,SAAQ,gBAaD;CAAG;;AAEnC,qBAAa,QAAS,SAAQ,aAGE;CAAG;;AAEnC,qBAAa,MAAO,SAAQ,WAGS;CAAG;;;;;;;;;;;;;AAExC,qBAAa,IAAK,SAAQ,SAsJxB;CAAG"}

package/lib/Agent/coding/bash.js

@@ -0,0 +1,170 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as S from "effect/Schema";
+import { ChildProcess } from "effect/unstable/process";
+import { AspectConfig } from "../Aspect.js";
+import { Tool } from "../tool/tool.js";
+import { CommandValidator } from "../util/command-validator.js";
+import { exec } from "../util/exec.js";
+export class command extends Tool.input("command") `The command to execute` {
+}
+export class timeout extends Tool.input("timeout", S.optional(S.Number)) `Optional timeout in milliseconds` {
+}
+export class workdir extends Tool.input("workdir", S.optional(S.String)) `The working directory to run the command in. Defaults to cwd. Use this instead of 'cd' commands.` {
+}
+export class description extends Tool.input("description") `Clear, concise description of what this command does in 5-10 words. Examples:
+Input: ls
+Output: Lists files in current directory
+
+Input: git status
+Output: Shows working tree status
+
+Input: npm install
+Output: Installs package dependencies
+
+Input: mkdir foo
+Output: Creates directory 'foo'` {
+}
+export class exitCode extends Tool.output("exitCode", S.Number) `The exit code of the command.` {
+}
+export class stdout extends Tool.output("stdout", S.String) `Containing both stdout and stderr.` {
+}
+export class bash extends Tool("bash", {
+    alias: (model) => (model.includes("anthropic") ? "AnthropicBash" : undefined),
+}) `Executes a given bash ${command} in a persistent shell session with optional ${timeout}, ensuring proper handling and security measures.
+Returns the ${exitCode} and ${stdout} containing both stdout and stderr.
+If the command is invalid, an error message will be returned as a ${S.String}.
+
+All commands run in cwd by default. Use the ${workdir} parameter if you need to run a command in a different directory. AVOID using \`cd <directory> && <command>\` patterns - use \`workdir\` instead.
+
+IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead.
+
+Before executing the command, please follow these steps:
+
+1. Directory Verification:
+   - If the command will create new directories or files, first use \`ls\` to verify the parent directory exists and is the correct location
+   - For example, before running "mkdir foo/bar", first use \`ls foo\` to check that "foo" exists and is the intended parent directory
+
+2. Command Execution:
+   - Always quote file paths that contain spaces with double quotes (e.g., rm "path with spaces/file.txt")
+   - Examples of proper quoting:
+     - mkdir "/Users/name/My Documents" (correct)
+     - mkdir /Users/name/My Documents (incorrect - will fail)
+     - python "/path/with spaces/script.py" (correct)
+     - python /path/with spaces/script.py (incorrect - will fail)
+   - After ensuring proper quoting, execute the command.
+   - Capture the output of the command.
+
+Usage notes:
+  - The command argument is required.
+  - You can specify an optional timeout in milliseconds (up to 600000ms / 10 minutes). If not specified, commands will time out after 120000ms (2 minutes).
+  - It is very helpful if you write a clear, concise ${description} of what this command does in 5-10 words.
+  - If the output exceeds 30000 characters, output will be truncated before being returned to you.
+  - You can use the \`run_in_background\` parameter to run the command in the background, which allows you to continue working while the command runs. You can monitor the output using the Bash tool as it becomes available. You do not need to use '&' at the end of the command when using this parameter.
+
+  - Avoid using Bash with the \`find\`, \`grep\`, \`cat\`, \`head\`, \`tail\`, \`sed\`, \`awk\`, or \`echo\` commands, unless explicitly instructed or when these commands are truly necessary for the task. Instead, always prefer using the dedicated tools for these commands:
+    - File search: Use Glob (NOT find or ls)
+    - Content search: Use Grep (NOT grep or rg)
+    - Read files: Use Read (NOT cat/head/tail)
+    - Edit files: Use Edit (NOT sed/awk)
+    - Write files: Use Write (NOT echo >/cat <<EOF)
+    - Communication: Output text directly (NOT echo/printf)
+  - When issuing multiple commands:
+    - If the commands are independent and can run in parallel, make multiple Bash tool calls in a single message. For example, if you need to run "git status" and "git diff", send a single message with two Bash tool calls in parallel.
+    - If the commands depend on each other and must run sequentially, use a single Bash call with '&&' to chain them together (e.g., \`git add . && git commit -m "message" && git push\`). For instance, if one operation must complete before another starts (like mkdir before cp, Write before Bash for git operations, or git add before git commit), run these operations sequentially instead.
+    - Use ';' only when you need to run commands sequentially but don't care if earlier commands fail
+    - DO NOT use newlines to separate commands (newlines are ok in quoted strings)
+  - AVOID using \`cd <directory> && <command>\`. Use the \`workdir\` parameter to change directories instead.
+    <good-example>
+    Use workdir="/foo/bar" with command: pytest tests
+    </good-example>
+    <bad-example>
+    cd /foo/bar && pytest tests
+    </bad-example>
+
+# Committing changes with git
+
+Only create commits when requested by the user. If unclear, ask first. When the user asks you to create a new git commit, follow these steps carefully:
+
+Git Safety Protocol:
+- NEVER update the git config
+- NEVER run destructive/irreversible git commands (like push --force, hard reset, etc) unless the user explicitly requests them
+- NEVER skip hooks (--no-verify, --no-gpg-sign, etc) unless the user explicitly requests it
+- NEVER run force push to main/master, warn the user if they request it
+- Avoid git commit --amend. ONLY use --amend when ALL conditions are met:
+  (1) User explicitly requested amend, OR commit SUCCEEDED but pre-commit hook auto-modified files that need including
+  (2) HEAD commit was created by you in this conversation (verify: git log -1 --format='%an %ae')
+  (3) Commit has NOT been pushed to remote (verify: git status shows "Your branch is ahead")
+- CRITICAL: If commit FAILED or was REJECTED by hook, NEVER amend - fix the issue and create a NEW commit
+- CRITICAL: If you already pushed to remote, NEVER amend unless user explicitly requests it (requires force push)
+- NEVER commit changes unless the user explicitly asks you to. It is VERY IMPORTANT to only commit when explicitly asked, otherwise the user will feel that you are being too proactive.
+
+1. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following bash commands in parallel, each using the Bash tool:
+  - Run a git status command to see all untracked files.
+  - Run a git diff command to see both staged and unstaged changes that will be committed.
+  - Run a git log command to see recent commit messages, so that you can follow this repository's commit message style.
+2. Analyze all staged changes (both previously staged and newly added) and draft a commit message:
+  - Summarize the nature of the changes (eg. new feature, enhancement to an existing feature, bug fix, refactoring, test, docs, etc.). Ensure the message accurately reflects the changes and their purpose (i.e. "add" means a wholly new feature, "update" means an enhancement to an existing feature, "fix" means a bug fix, etc.).
+  - Do not commit files that likely contain secrets (.env, credentials.json, etc.). Warn the user if they specifically request to commit those files
+  - Draft a concise (1-2 sentences) commit message that focuses on the "why" rather than the "what"
+  - Ensure it accurately reflects the changes and their purpose
+3. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following commands:
+   - Add relevant untracked files to the staging area.
+   - Create the commit with a message
+   - Run git status after the commit completes to verify success.
+   Note: git status depends on the commit completing, so run it sequentially after the commit.
+4. If the commit fails due to pre-commit hook, fix the issue and create a NEW commit (see amend rules above)
+
+Important notes:
+- NEVER run additional commands to read or explore code, besides git bash commands
+- NEVER use the TodoWrite or Task tools
+- DO NOT push to the remote repository unless the user explicitly asks you to do so
+- IMPORTANT: Never use git commands with the -i flag (like git rebase -i or git add -i) since they require interactive input which is not supported.
+- If there are no changes to commit (i.e., no untracked files and no modifications), do not create an empty commit
+
+# Creating pull requests
+Use the gh command via the Bash tool for ALL GitHub-related tasks including working with issues, pull requests, checks, and releases. If given a Github URL use the gh command to get the information needed.
+
+IMPORTANT: When the user asks you to create a pull request, follow these steps carefully:
+
+1. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following bash commands in parallel using the Bash tool, in order to understand the current state of the branch since it diverged from the main branch:
+   - Run a git status command to see all untracked files
+   - Run a git diff command to see both staged and unstaged changes that will be committed
+   - Check if the current branch tracks a remote branch and is up to date with the remote, so you know if you need to push to the remote
+   - Run a git log command and \`git diff [base-branch]...HEAD\` to understand the full commit history for the current branch (from the time it diverged from the base branch)
+2. Analyze all changes that will be included in the pull request, making sure to look at all relevant commits (NOT just the latest commit, but ALL commits that will be included in the pull request!!!), and draft a pull request summary
+3. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following commands in parallel:
+   - Create new branch if needed
+   - Push to remote with -u flag if needed
+   - Create PR using gh pr create with the format below. Use a HEREDOC to pass the body to ensure correct formatting.
+<example>
+gh pr create --title "the pr title" --body "$(cat <<'EOF'
+## Summary
+<1-3 bullet points>
+</example>
+
+Important:
+- DO NOT use the TodoWrite or Task tools
+- Return the PR URL when you're done, so the user can see it
+
+# Other common operations
+- View comments on a Github PR: gh api repos/foo/bar/pulls/123/comments
+`(function* ({ command, workdir }) {
+    const config = yield* Effect.serviceOption(AspectConfig).pipe(Effect.map(Option.getOrElse(() => ({ cwd: process.cwd() }))));
+    const validator = yield* Effect.serviceOption(CommandValidator).pipe(Effect.map(Option.getOrUndefined));
+    yield* Effect.logDebug(`[bash] command=${command}`);
+    if (validator) {
+        const validationError = yield* validator.validate(command).pipe(Effect.map(() => null), Effect.catch((e) => Effect.succeed(`${e}`)));
+        if (validationError) {
+            return `Security violation: ${validationError}`;
+        }
+    }
+    const cmd = ChildProcess.setCwd(ChildProcess.make(command, [], { shell: true }), workdir ?? config.cwd);
+    const result = yield* exec(cmd);
+    return {
+        exitCode: result.exitCode,
+        stdout: result.stdout + result.stderr,
+    };
+}) {
+}
+//# sourceMappingURL=bash.js.map

package/lib/Agent/coding/bash.js.map

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

package/lib/Agent/coding/edit.d.ts

@@ -0,0 +1,31 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as S from "effect/Schema";
+declare const filePath_base: import("../index.ts").Parameter<"filePath", [], S.String>;
+export declare class filePath extends filePath_base {
+}
+declare const oldString_base: import("../index.ts").Parameter<"oldString", [], S.String>;
+export declare class oldString extends oldString_base {
+}
+declare const newString_base: import("../index.ts").Parameter<"newString", [], S.String>;
+export declare class newString extends newString_base {
+}
+declare const replaceAll_base: import("../index.ts").Parameter<"replaceAll", [], S.Boolean>;
+export declare class replaceAll extends replaceAll_base {
+}
+declare const output_base: import("../index.ts").Result<"result", [], S.String>;
+export declare class output extends output_base {
+}
+declare const edit_base: import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect</*elided*/ any, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", "edit", [typeof output, typeof filePath, typeof oldString, typeof newString, typeof oldString, typeof newString, typeof replaceAll, typeof oldString, typeof newString], import("../index.ts").ToolProps, (input: {
+    readonly replaceAll: boolean;
+    readonly oldString: string;
+    readonly filePath: string;
+    readonly newString: string;
+}) => Effect.Effect<NoInfer<{
+    result: string;
+}>, never, Path.Path | FileSystem.FileSystem>>;
+export declare class edit extends edit_base {
+}
+export {};
+//# sourceMappingURL=edit.d.ts.map

package/lib/Agent/coding/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/Agent/coding/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;;AASnC,qBAAa,QAAS,SAAQ,aAEY;CAAG;;AAE7C,qBAAa,SAAU,SAAQ,cAEqC;CAAG;;AAEvE,qBAAa,SAAU,SAAQ,cAEkC;CAAG;;AAEpE,qBAAa,UAAW,SAAQ,eAGwF;CAAG;;AAE3H,qBAAa,MAAO,SAAQ,WAE4C;CAAG;;;;;;;;;AAE3E,qBAAa,IAAK,SAAQ,SAqHxB;CAAG"}

package/lib/Agent/coding/edit.js

@@ -0,0 +1,90 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as S from "effect/Schema";
+import { AspectConfig } from "../Aspect.js";
+import { formatDiagnostics, getDiagnosticsIfAvailable, } from "../lsp/diagnostics.js";
+import { Tool } from "../tool/tool.js";
+import { replace } from "../util/replace.js";
+export class filePath extends Tool.input("filePath") `The absolute path to the file to modify` {
+}
+export class oldString extends Tool.input("oldString") `The text to replace. Use an empty string "" to create a new file.` {
+}
+export class newString extends Tool.input("newString") `The text to replace it with (must be different from oldString)` {
+}
+export class replaceAll extends Tool.input("replaceAll", S.Boolean) `Replace all occurrences of oldString (default false). Use this when renaming variables or updating repeated patterns.` {
+}
+export class output extends Tool.output("result") `The result of the edit operation, including any diagnostics from LSP.` {
+}
+export class edit extends Tool("edit") `Performs exact string replacements in files.
+Returns the ${output} of the operation.
+
+Given a ${filePath}, ${oldString}, and ${newString}:
+- Replaces the first occurrence of ${oldString} with ${newString}
+- Use ${replaceAll} to replace all occurrences (defaults to false)
+- Use empty ${oldString} ("") to create a new file with ${newString} as content
+`(function* ({ filePath: _filePath, oldString, newString, replaceAll: doReplaceAll, }) {
+    const config = yield* Effect.serviceOption(AspectConfig).pipe(Effect.map(Option.getOrElse(() => ({ cwd: process.cwd() }))));
+    const pathService = yield* Path.Path;
+    const fs = yield* FileSystem.FileSystem;
+    const filePath = pathService.isAbsolute(_filePath)
+        ? _filePath
+        : pathService.join(config.cwd, _filePath);
+    // Determine new content and whether this is a create operation
+    let newContent;
+    if (oldString === "") {
+        // Create new file
+        newContent = newString;
+    }
+    else {
+        // Edit existing file - validate it exists
+        const stat = yield* fs
+            .stat(filePath)
+            .pipe(Effect.catch(() => Effect.succeed(null)));
+        if (!stat) {
+            return { result: `File not found: ${filePath}` };
+        }
+        if (stat.type === "Directory") {
+            return { result: `Path is a directory, not a file: ${filePath}` };
+        }
+        // Read existing content
+        const oldContent = yield* fs
+            .readFileString(filePath)
+            .pipe(Effect.catch((e) => Effect.succeed(`Failed to read file: ${e}`)));
+        if (oldContent.startsWith("Failed to read")) {
+            return { result: oldContent };
+        }
+        // Perform replacement
+        const replaceResult = yield* replace(oldContent, oldString, newString, doReplaceAll ?? false).pipe(Effect.catchTag("ReplaceSameStringError", () => Effect.succeed("oldString and newString must be different")), Effect.catchTag("ReplaceNotFoundError", (e) => Effect.succeed(`Could not find oldString in file. The text "${e.oldString.slice(0, 100)}${e.oldString.length > 100 ? "..." : ""}" was not found in ${filePath}.`)), Effect.catchTag("ReplaceMultipleMatchesError", (e) => Effect.succeed(`Found multiple matches for oldString "${e.oldString.slice(0, 50)}${e.oldString.length > 50 ? "..." : ""}". Provide more surrounding context to identify the correct match, or use replaceAll=true to replace all occurrences.`)));
+        // Check for replace errors
+        if (replaceResult.startsWith("Could not find") ||
+            replaceResult.startsWith("Found multiple") ||
+            replaceResult.startsWith("oldString and newString")) {
+            yield* Effect.logDebug(`[edit] ${replaceResult}`);
+            return { result: replaceResult };
+        }
+        newContent = replaceResult;
+    }
+    const isCreate = oldString === "";
+    // Write file
+    const writeResult = yield* fs
+        .writeFileString(filePath, newContent)
+        .pipe(Effect.catch((e) => Effect.succeed(`Failed to ${isCreate ? "create" : "write"} file: ${e.message}`)));
+    if (typeof writeResult === "string") {
+        yield* Effect.logDebug(`[edit] ${writeResult}`);
+        return { result: writeResult };
+    }
+    // Get diagnostics from LSP servers
+    const diagnostics = yield* getDiagnosticsIfAvailable(filePath, newContent);
+    const formatted = formatDiagnostics(diagnostics);
+    yield* Effect.logDebug(`[edit] diagnostics for ${filePath}: ${formatted || "(none)"}`);
+    const action = isCreate ? "Created" : "Edited";
+    return {
+        result: formatted
+            ? `${action} file: ${filePath}\n\n${formatted}`
+            : `${action} file: ${filePath}`,
+    };
+}) {
+}
+//# sourceMappingURL=edit.js.map

package/lib/Agent/coding/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/Agent/coding/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,OAAO,QAAS,SAAQ,IAAI,CAAC,KAAK,CACtC,UAAU,CACX,CAAA,yCAAyC;CAAG;AAE7C,MAAM,OAAO,SAAU,SAAQ,IAAI,CAAC,KAAK,CACvC,WAAW,CACZ,CAAA,mEAAmE;CAAG;AAEvE,MAAM,OAAO,SAAU,SAAQ,IAAI,CAAC,KAAK,CACvC,WAAW,CACZ,CAAA,gEAAgE;CAAG;AAEpE,MAAM,OAAO,UAAW,SAAQ,IAAI,CAAC,KAAK,CACxC,YAAY,EACZ,CAAC,CAAC,OAAO,CACV,CAAA,uHAAuH;CAAG;AAE3H,MAAM,OAAO,MAAO,SAAQ,IAAI,CAAC,MAAM,CACrC,QAAQ,CACT,CAAA,uEAAuE;CAAG;AAE3E,MAAM,OAAO,IAAK,SAAQ,IAAI,CAC5B,MAAM,CACP,CAAA;cACa,MAAM;;UAEV,QAAQ,KAAK,SAAS,SAAS,SAAS;qCACb,SAAS,SAAS,SAAS;QACxD,UAAU;cACJ,SAAS,mCAAmC,SAAS;CAClE,CAAC,QAAQ,CAAC,EAAE,EACX,QAAQ,EAAE,SAAS,EACnB,SAAS,EACT,SAAS,EACT,UAAU,EAAE,YAAY,GACzB;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAC7D,CAAC;IACF,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACrC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAExC,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;QAChD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAE5C,+DAA+D;IAC/D,IAAI,UAAkB,CAAC;IAEvB,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,kBAAkB;QAClB,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,0CAA0C;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE;aACnB,IAAI,CAAC,QAAQ,CAAC;aACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,MAAM,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,oCAAoC,QAAQ,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,EAAE;aACzB,cAAc,CAAC,QAAQ,CAAC;aACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,IAAI,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAChC,CAAC;QAED,sBAAsB;QACtB,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,OAAO,CAClC,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,IAAI,KAAK,CACtB,CAAC,IAAI,CACJ,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAC7C,MAAM,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAC5D,EACD,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5C,MAAM,CAAC,OAAO,CACZ,+CAA+C,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,sBAAsB,QAAQ,GAAG,CAClJ,CACF,EACD,MAAM,CAAC,QAAQ,CAAC,6BAA6B,EAAE,CAAC,CAAC,EAAE,EAAE,CACnD,MAAM,CAAC,OAAO,CACZ,yCAAyC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,uHAAuH,CAChO,CACF,CACF,CAAC;QAEF,2BAA2B;QAC3B,IACE,aAAa,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAC1C,aAAa,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAC1C,aAAa,CAAC,UAAU,CAAC,yBAAyB,CAAC,EACnD,CAAC;YACD,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,aAAa,EAAE,CAAC,CAAC;YAClD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnC,CAAC;QACD,UAAU,GAAG,aAAa,CAAC;IAC7B,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,KAAK,EAAE,CAAC;IAElC,aAAa;IACb,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,EAAE;SAC1B,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC;SACrC,IAAI,CACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACjB,MAAM,CAAC,OAAO,CACZ,aAAa,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,OAAO,EAAE,CAChE,CACF,CACF,CAAC;IACJ,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,mCAAmC;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,yBAAyB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAEjD,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CACpB,0BAA0B,QAAQ,KAAK,SAAS,IAAI,QAAQ,EAAE,CAC/D,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,SAAS;YACf,CAAC,CAAC,GAAG,MAAM,UAAU,QAAQ,OAAO,SAAS,EAAE;YAC/C,CAAC,CAAC,GAAG,MAAM,UAAU,QAAQ,EAAE;KAClC,CAAC;AACJ,CAAC,CAAC;CAAG"}

package/lib/Agent/coding/glob.d.ts

@@ -0,0 +1,23 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as S from "effect/Schema";
+declare const pattern_base: import("../index.ts").Parameter<"pattern", [], S.String>;
+export declare class pattern extends pattern_base {
+}
+declare const path_base: import("../index.ts").Parameter<"path", [], S.optional<S.String>>;
+export declare class path extends path_base {
+}
+declare const files_base: import("../index.ts").Result<"files", [], S.String>;
+export declare class files extends files_base {
+}
+declare const glob_base: import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect</*elided*/ any, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", "glob", [typeof files, typeof pattern, typeof path], import("../index.ts").ToolProps, (input: {
+    readonly pattern: string;
+    readonly path?: string | undefined;
+}) => Effect.Effect<NoInfer<{
+    files: string;
+}>, never, Path.Path | FileSystem.FileSystem | import("effect/Scope").Scope | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner>>;
+export declare class glob extends glob_base {
+}
+export {};
+//# sourceMappingURL=glob.d.ts.map

package/lib/Agent/coding/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/Agent/coding/glob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;;AAKnC,qBAAa,OAAQ,SAAQ,YAQ+C;CAAG;;AAE/E,qBAAa,IAAK,SAAQ,SAGsC;CAAG;;AAEnE,qBAAa,KAAM,SAAQ,UAEkG;CAAG;;;;;;;AAEhI,qBAAa,IAAK,SAAQ,SAmExB;CAAG"}

package/lib/Agent/coding/glob.js

@@ -0,0 +1,78 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as S from "effect/Schema";
+import { AspectConfig } from "../Aspect.js";
+import { Tool } from "../tool/tool.js";
+import * as Ripgrep from "../util/ripgrep.js";
+export class pattern extends Tool.input("pattern") `The glob pattern to match files against.
+Patterns not starting with "**/" are automatically prepended with "**/" to enable recursive searching.
+
+Examples:
+  - "*.js" (becomes "**/*.js") - find all .js files
+  - "**/node_modules/**" - find all node_modules directories
+  - "**/test/**/test_*.ts" - find all test_*.ts files in any test directory` {
+}
+export class path extends Tool.input("path", S.optional(S.String)) `The directory to search in. Defaults to cwd if not specified.` {
+}
+export class files extends Tool.output("files") `The list of matching file paths, sorted by modification time (most recent first). Returns a message if no files are found.` {
+}
+export class glob extends Tool("glob") `Fast file pattern matching tool that works with any codebase size.
+Returns matching ${files} sorted by modification time.
+
+Given a ${pattern} and optional ${path}:
+- Supports glob patterns like "**/*.js" or "src/**/*.ts"
+- Returns matching file paths sorted by modification time
+- Use this tool when you need to find files by name patterns
+- When you are doing an open-ended search that may require multiple rounds of globbing and grepping, use the Task tool instead
+- You have the capability to call multiple tools in a single response. It is always better to speculatively perform multiple searches as a batch that are potentially useful.
+`(function* ({ pattern, path: searchDir }) {
+    yield* Effect.logDebug(`[glob] pattern=${pattern} path=${searchDir}`);
+    const config = yield* Effect.serviceOption(AspectConfig).pipe(Effect.map(Option.getOrElse(() => ({ cwd: process.cwd() }))));
+    const pathService = yield* Path.Path;
+    const fs = yield* FileSystem.FileSystem;
+    let searchPath = searchDir || config.cwd;
+    searchPath = pathService.isAbsolute(searchPath)
+        ? searchPath
+        : pathService.resolve(config.cwd, searchPath);
+    const fileList = [];
+    const limit = 100;
+    let truncated = false;
+    const foundFiles = yield* Ripgrep.findFiles({
+        cwd: searchPath,
+        glob: [pattern],
+    }).pipe(Effect.catch(() => Effect.succeed([])));
+    for (const filePath of foundFiles) {
+        if (fileList.length >= limit) {
+            truncated = true;
+            break;
+        }
+        const stats = yield* fs
+            .stat(filePath)
+            .pipe(Effect.catch(() => Effect.succeed(null)));
+        if (!stats)
+            continue;
+        fileList.push({
+            path: filePath,
+            mtime: stats.mtime.pipe(Option.getOrElse(() => new Date(0))).getTime(),
+        });
+    }
+    fileList.sort((a, b) => b.mtime - a.mtime);
+    const output = fileList.map((f) => f.path);
+    if (output.length === 0) {
+        return {
+            files: `No files found matching pattern "${pattern}" in ${searchPath}`,
+        };
+    }
+    if (truncated) {
+        return {
+            files: `${output.join("\n")}\n\n(${output.length} files found. Results are truncated, consider using a more specific pattern.)`,
+        };
+    }
+    return {
+        files: output.join("\n"),
+    };
+}) {
+}
+//# sourceMappingURL=glob.js.map

package/lib/Agent/coding/glob.js.map

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

package/lib/Agent/coding/grep.d.ts

@@ -0,0 +1,26 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as S from "effect/Schema";
+declare const pattern_base: import("../index.ts").Parameter<"pattern", [], S.String>;
+declare class pattern extends pattern_base {
+}
+declare const path_base: import("../index.ts").Parameter<"path", [], S.optional<S.String>>;
+declare class path extends path_base {
+}
+declare const include_base: import("../index.ts").Parameter<"include", [], S.optional<S.String>>;
+declare class include extends include_base {
+}
+declare const matches_base: import("../index.ts").Result<"matches", [], S.String>;
+declare class matches extends matches_base {
+}
+declare const grep_base: import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect<import("../Aspect.ts").Aspect</*elided*/ any, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", string, any[], import("../index.ts").ToolProps, any>, "tool", "grep", [typeof matches, typeof pattern, typeof path, typeof include], import("../index.ts").ToolProps, (input: {
+    readonly pattern: string;
+    readonly path?: string | undefined;
+    readonly include?: string | undefined;
+}) => Effect.Effect<NoInfer<{
+    matches: string;
+}>, never, FileSystem.FileSystem | import("effect/Scope").Scope | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner>>;
+export declare class grep extends grep_base {
+}
+export {};
+//# sourceMappingURL=grep.d.ts.map

package/lib/Agent/coding/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/Agent/coding/grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;;AAQnC,cAAM,OAAQ,SAAQ,YAGoD;CAAG;;AAE7E,cAAM,IAAK,SAAQ,SAG6C;CAAG;;AAEnE,cAAM,OAAQ,SAAQ,YAG+C;CAAG;;AAExE,cAAM,OAAQ,SAAQ,YAEmE;CAAG;;;;;;;;AAE5F,qBAAa,IAAK,SAAQ,SAgHxB;CAAG"}

package/lib/Agent/coding/grep.js

@@ -0,0 +1,105 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as S from "effect/Schema";
+import { ChildProcess } from "effect/unstable/process";
+import { AspectConfig } from "../Aspect.js";
+import { Tool } from "../tool/tool.js";
+import { exec } from "../util/exec.js";
+const MAX_LINE_LENGTH = 2000;
+class pattern extends Tool.input("pattern") `The regex pattern to search for in file contents.
+Supports full regex syntax (e.g., "log.*Error", "function\\s+\\w+", etc.)` {
+}
+class path extends Tool.input("path", S.optional(S.String)) `The directory to search in. Defaults to cwd if not specified.` {
+}
+class include extends Tool.input("include", S.optional(S.String)) `File pattern to include in the search (e.g., "*.js", "*.{ts,tsx}")` {
+}
+class matches extends Tool.output("matches") `The search results showing file paths and matching lines, sorted by modification time.` {
+}
+export class grep extends Tool("grep") `Fast content search tool that works with any codebase size.
+Returns ${matches} with file paths and line numbers.
+
+Given a ${pattern} and optional ${path} and ${include}:
+- Searches file contents using regular expressions
+- Supports full regex syntax (e.g., "log.*Error", "function\\s+\\w+", etc.)
+- Filter files by pattern with the include parameter (e.g., "*.js", "*.{ts,tsx}")
+- Returns file paths and line numbers with at least one match sorted by modification time
+- Use this tool when you need to find files containing specific patterns
+- If you need to identify/count the number of matches within files, use the Bash tool with \`rg\` (ripgrep) directly. Do NOT use \`grep\`.
+- When you are doing an open-ended search that may require multiple rounds of globbing and grepping, use the Task tool instead
+`(function* ({ pattern, path: searchDir, include }) {
+    yield* Effect.logDebug(`[grep] pattern=${pattern} path=${searchDir}`);
+    const config = yield* Effect.serviceOption(AspectConfig).pipe(Effect.map(Option.getOrElse(() => ({ cwd: process.cwd() }))));
+    const fs = yield* FileSystem.FileSystem;
+    const searchPath = searchDir || config.cwd;
+    const rgArgs = ["-nH", "--field-match-separator=|", "--regexp", pattern];
+    if (include) {
+        rgArgs.push("--glob", include);
+    }
+    rgArgs.push(searchPath);
+    const { stdout, stderr, exitCode } = yield* exec(ChildProcess.make("rg", rgArgs)).pipe(Effect.catch(() => Effect.succeed({ stdout: "", stderr: "", exitCode: 1 })));
+    if (exitCode === 1) {
+        return {
+            matches: `No matches found for pattern "${pattern}" in ${searchPath}`,
+        };
+    }
+    else if (exitCode !== 0) {
+        return { matches: `ripgrep failed with exit code ${exitCode}: ${stderr}` };
+    }
+    const lines = stdout.split(/\r?\n/);
+    const matchList = [];
+    for (const line of lines) {
+        if (!line)
+            continue;
+        const [filePath, lineNumStr, ...lineTextParts] = line.split("|");
+        if (!filePath || !lineNumStr || lineTextParts.length === 0)
+            continue;
+        const lineNum = parseInt(lineNumStr, 10);
+        const lineText = lineTextParts.join("|");
+        const stats = yield* fs
+            .stat(filePath)
+            .pipe(Effect.catch(() => Effect.succeed(null)));
+        if (!stats)
+            continue;
+        const modTime = stats.mtime;
+        if (!modTime)
+            continue;
+        matchList.push({
+            path: filePath,
+            modTime: modTime.pipe(Option.getOrElse(() => new Date(0))).getTime(),
+            lineNum,
+            lineText,
+        });
+    }
+    matchList.sort((a, b) => b.modTime - a.modTime);
+    const limit = 100;
+    const truncated = matchList.length > limit;
+    const finalMatches = truncated ? matchList.slice(0, limit) : matchList;
+    if (finalMatches.length === 0) {
+        return {
+            matches: `No matches found for pattern "${pattern}" in ${searchPath}`,
+        };
+    }
+    const outputLines = [`Found ${finalMatches.length} matches`];
+    let currentFile = "";
+    for (const match of finalMatches) {
+        if (currentFile !== match.path) {
+            if (currentFile !== "") {
+                outputLines.push("");
+            }
+            currentFile = match.path;
+            outputLines.push(`${match.path}:`);
+        }
+        const truncatedLineText = match.lineText.length > MAX_LINE_LENGTH
+            ? match.lineText.substring(0, MAX_LINE_LENGTH) + "..."
+            : match.lineText;
+        outputLines.push(`  Line ${match.lineNum}: ${truncatedLineText}`);
+    }
+    if (truncated) {
+        outputLines.push("");
+        outputLines.push("(Results are truncated. Consider using a more specific path or pattern.)");
+    }
+    return { matches: outputLines.join("\n") };
+}) {
+}
+//# sourceMappingURL=grep.js.map

package/lib/Agent/coding/grep.js.map

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