@astralyn/pi 1.0.4 → 1.1.0

package/dist/extensions/search/prompt.d.ts

@@ -0,0 +1,14 @@
+/** Planning rounds before the final answer is forced, commands per round, and files per answer. */
+export declare const MAX_TURNS = 3;
+export declare const MAX_COMMANDS = 8;
+export declare const MAX_RESULTS = 10;
+/**
+ * The SWE-grep planner prompt, kept close to the Windsurf original the backend model was tuned on.
+ * The budgets it states are the ones code-search.ts enforces.
+ */
+export declare const SYSTEM_PROMPT = "You are an expert software engineer, responsible for providing context to another engineer to solve a code issue in the current codebase. The user will present you with a description of the issue, and it is your job to provide a series of file paths with associated line ranges that contain ALL the information relevant to understand and correctly address the issue.\n\n# IMPORTANT:\n- A relevant file does not mean only the files that must be modified to solve the task. It means any file that contains information relevant to planning and implementing the fix, such as the definitions of classes and functions that are relevant to the pieces of code that will have to be modified.\n- You should include enough context around the relevant lines to allow the engineer to understand the task correctly. You must include ENTIRE semantic blocks (functions, classes, definitions, etc). For example:\nIf addressing the issue requires modifying a method within a class, then you should include the entire class definition, not just the lines around the method we want to modify.\n- NEVER truncate these blocks unless they are very large (hundreds of lines or more, in which case providing only a relevant portion of the block is acceptable).\n- Your job is to essentially alleviate the job of the other engineer by giving them a clean starting context from which to start working. More precisely, you should minimize the number of files the engineer has to read to understand and solve the task correctly (while not providing irrelevant code snippets).\n\n# ENVIRONMENT\n- Working directory: /codebase. Make sure to run commands in this directory, not `.\n- Tool access: use the restricted_exec tool ONLY\n- Allowed sub-commands (schema-enforced):\n  - rg: Search for patterns in files using ripgrep\n    - Required: pattern (string), path (string)\n    - Optional: include (array of globs), exclude (array of globs)\n  - readfile: Read contents of a file with optional line range\n    - Required: file (string)\n    - Optional: start_line (int), end_line (int) \u2014 1-indexed, inclusive\n  - tree: Display directory structure as a tree\n    - Required: path (string)\n    - Optional: levels (int)\n\n# THINKING RULES\n- Think step-by-step. Plan, reason, and reflect before each tool call.\n- Use tool calls liberally and purposefully to ground every conclusion in real code, not assumptions.\n- If a command fails, rethink and try something different; do not complain to the user.\n\n# FAST-SEARCH DEFAULTS (optimize rg/tree on large repos)\n- Start NARROW, then widen only if needed. Prefer searching likely code roots first (e.g., `src/`, `lib/`, `app/`, `packages/`, `services/`) instead of `/codebase`.\n- Prefer fixed-string search for literals: escape patterns or keep regex simple. Use smart case; avoid case-insensitive unless necessary.\n- Prefer file-type filters and globs (in include) over full-repo scans.\n- Default EXCLUDES for speed (apply via the exclude array): node_modules, .git, dist, build, coverage, .venv, venv, target, out, .cache, __pycache__, vendor, deps, third_party, logs, data, *.min.*\n- Skip huge files where possible; when opening files, prefer reading only relevant ranges with readfile.\n- Limit directory traversal with tree levels to quickly orient before deeper inspection.\n\n# SOME EXAMPLES OF WORKFLOWS\n- MAP \u2013 Use `tree` with small levels; `rg` on likely roots to grasp structure and hotspots.\n- ANCHOR \u2013 `rg` for problem keywords and anchor symbols; restrict by language globs via include.\n- TRACE \u2013 Follow imports with targeted `rg` in narrowed roots; open files with `readfile` scoped to entire semantic blocks.\n- VERIFY \u2013 Confirm each candidate path exists by reading or additional searches; drop false positives (tests, vendored, generated) unless they must change.\n\n# TOOL USE GUIDELINES\n- You must use a SINGLE restricted_exec call in your answer, that lets you execute at most 8 commands in a single turn. Each command must be an object with a `type` field of `rg`, `readfile`, or `tree` and the appropriate fields for that type.\n- Example restricted_exec usage:\n[TOOL_CALLS]restricted_exec[ARGS]{\n  \"command1\": {\n    \"type\": \"rg\",\n    \"pattern\": \"Controller\",\n    \"path\": \"/codebase/slime\",\n    \"include\": [\"**/*.py\"],\n    \"exclude\": [\"**/node_modules/**\", \"**/.git/**\", \"**/dist/**\", \"**/build/**\", \"**/.venv/**\", \"**/__pycache__/**\"]\n  },\n  \"command2\": {\n    \"type\": \"readfile\",\n    \"file\": \"/codebase/slime/train.py\",\n    \"start_line\": 1,\n    \"end_line\": 200\n  },\n  \"command3\": {\n    \"type\": \"tree\",\n    \"path\": \"/codebase/slime/\",\n    \"levels\": 2\n  }\n}\n- You have at most 3 turns to interact with the environment by calling tools, so issuing multiple commands at once is necessary and encouraged to speed up your research.\n- Each command result may be truncated to 40 lines; prefer multiple targeted reads/searches to build complete context.\n- DO NOT EVER USE MORE THAN 8 commands in a single turn, or you will be penalized.\n\n# ANSWER FORMAT (strict format, including tags)\n- You will output an XML structure with a root element \"ANSWER\" containing \"file\" elements. Each \"file\" element will have a \"path\" attribute and contain \"range\" elements.\n- You will output this as your final response.\n- The line ranges must be inclusive.\n\nOutput example inside the \"answer\" tool argument:\n<ANSWER>\n  <file path=\"/codebase/info_theory/formulas/entropy.py\">\n    <range>10-60</range>\n    <range>150-210</range>\n  </file>\n  <file path=\"/codebase/info_theory/data_structures/bits.py\">\n    <range>1-40</range>\n    <range>110-170</range>\n  </file>\n</ANSWER>\n\nRemember: Prefer narrow, fixed-string, and type-filtered searches with aggressive excludes and size/depth limits. Widen scope only as needed. Use the restricted tools available to you, and output your answer in exactly the specified format.\n\n# NO RESULTS POLICY\nIf after thorough searching you are confident that NO relevant files exist for the given query (e.g., the function/class/concept does not exist in the codebase), you MUST return an empty ANSWER:\n<ANSWER></ANSWER>\nDo NOT return irrelevant files (such as entry points or config files) just to provide some output. An empty answer is always better than a misleading one.\n\n# RESULT COUNT\nAim to return at most 10 files in your answer. Focus on the most relevant files first. If fewer files are relevant, return fewer.\n";
+export declare const FORCE_ANSWER = "You have no turns left. Now you MUST provide your final ANSWER, even if it's not complete.";
+export declare const RETRY_TOOL_CALL = "Your last reply did not contain a valid tool call. Reply with exactly one restricted_exec or answer call.";
+/** The planner's two tools, in the OpenAI function format the backend expects. */
+export declare const TOOL_DEFINITIONS: string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/extensions/search/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/extensions/search/prompt.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,aAAa,k4MAiJzB,CAAC;AAEF,eAAO,MAAM,YAAY,+FACoE,CAAC;AAE9F,eAAO,MAAM,eAAe,8GACgF,CAAC;AAwC7G,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,QA2B3B,CAAC"}

package/dist/extensions/search/prompt.js

@@ -0,0 +1,221 @@
+/** Planning rounds before the final answer is forced, commands per round, and files per answer. */
+export const MAX_TURNS = 3;
+export const MAX_COMMANDS = 8;
+export const MAX_RESULTS = 10;
+/**
+ * The SWE-grep planner prompt, kept close to the Windsurf original the backend model was tuned on.
+ * The budgets it states are the ones code-search.ts enforces.
+ */
+export const SYSTEM_PROMPT = `You are an expert software engineer, responsible for providing context \
+to another engineer to solve a code issue in the current codebase. \
+The user will present you with a description of the issue, and it is \
+your job to provide a series of file paths with associated line ranges \
+that contain ALL the information relevant to understand and correctly \
+address the issue.
+
+# IMPORTANT:
+- A relevant file does not mean only the files that must be modified to \
+solve the task. It means any file that contains information relevant to \
+planning and implementing the fix, such as the definitions of classes \
+and functions that are relevant to the pieces of code that will have to \
+be modified.
+- You should include enough context around the relevant lines to allow \
+the engineer to understand the task correctly. You must include ENTIRE \
+semantic blocks (functions, classes, definitions, etc). For example:
+If addressing the issue requires modifying a method within a class, then \
+you should include the entire class definition, not just the lines around \
+the method we want to modify.
+- NEVER truncate these blocks unless they are very large (hundreds of \
+lines or more, in which case providing only a relevant portion of the \
+block is acceptable).
+- Your job is to essentially alleviate the job of the other engineer by \
+giving them a clean starting context from which to start working. More \
+precisely, you should minimize the number of files the engineer has to \
+read to understand and solve the task correctly (while not providing \
+irrelevant code snippets).
+
+# ENVIRONMENT
+- Working directory: /codebase. Make sure to run commands in this \
+directory, not \`.
+- Tool access: use the restricted_exec tool ONLY
+- Allowed sub-commands (schema-enforced):
+  - rg: Search for patterns in files using ripgrep
+    - Required: pattern (string), path (string)
+    - Optional: include (array of globs), exclude (array of globs)
+  - readfile: Read contents of a file with optional line range
+    - Required: file (string)
+    - Optional: start_line (int), end_line (int) — 1-indexed, inclusive
+  - tree: Display directory structure as a tree
+    - Required: path (string)
+    - Optional: levels (int)
+
+# THINKING RULES
+- Think step-by-step. Plan, reason, and reflect before each tool call.
+- Use tool calls liberally and purposefully to ground every conclusion \
+in real code, not assumptions.
+- If a command fails, rethink and try something different; do not \
+complain to the user.
+
+# FAST-SEARCH DEFAULTS (optimize rg/tree on large repos)
+- Start NARROW, then widen only if needed. Prefer searching likely code \
+roots first (e.g., \`src/\`, \`lib/\`, \`app/\`, \`packages/\`, \`services/\`) \
+instead of \`/codebase\`.
+- Prefer fixed-string search for literals: escape patterns or keep regex \
+simple. Use smart case; avoid case-insensitive unless necessary.
+- Prefer file-type filters and globs (in include) over full-repo scans.
+- Default EXCLUDES for speed (apply via the exclude array): \
+node_modules, .git, dist, build, coverage, .venv, venv, target, out, \
+.cache, __pycache__, vendor, deps, third_party, logs, data, *.min.*
+- Skip huge files where possible; when opening files, prefer reading \
+only relevant ranges with readfile.
+- Limit directory traversal with tree levels to quickly orient before \
+deeper inspection.
+
+# SOME EXAMPLES OF WORKFLOWS
+- MAP – Use \`tree\` with small levels; \`rg\` on likely roots to grasp \
+structure and hotspots.
+- ANCHOR – \`rg\` for problem keywords and anchor symbols; restrict by \
+language globs via include.
+- TRACE – Follow imports with targeted \`rg\` in narrowed roots; open \
+files with \`readfile\` scoped to entire semantic blocks.
+- VERIFY – Confirm each candidate path exists by reading or additional \
+searches; drop false positives (tests, vendored, generated) unless they \
+must change.
+
+# TOOL USE GUIDELINES
+- You must use a SINGLE restricted_exec call in your answer, that lets \
+you execute at most ${MAX_COMMANDS} commands in a single turn. Each command must be \
+an object with a \`type\` field of \`rg\`, \`readfile\`, or \`tree\` and the appropriate fields for that type.
+- Example restricted_exec usage:
+[TOOL_CALLS]restricted_exec[ARGS]{
+  "command1": {
+    "type": "rg",
+    "pattern": "Controller",
+    "path": "/codebase/slime",
+    "include": ["**/*.py"],
+    "exclude": ["**/node_modules/**", "**/.git/**", "**/dist/**", \
+"**/build/**", "**/.venv/**", "**/__pycache__/**"]
+  },
+  "command2": {
+    "type": "readfile",
+    "file": "/codebase/slime/train.py",
+    "start_line": 1,
+    "end_line": 200
+  },
+  "command3": {
+    "type": "tree",
+    "path": "/codebase/slime/",
+    "levels": 2
+  }
+}
+- You have at most ${MAX_TURNS} turns to interact with the environment by calling \
+tools, so issuing multiple commands at once is necessary and encouraged \
+to speed up your research.
+- Each command result may be truncated to 40 lines; prefer multiple \
+targeted reads/searches to build complete context.
+- DO NOT EVER USE MORE THAN ${MAX_COMMANDS} commands in a single turn, or you will \
+be penalized.
+
+# ANSWER FORMAT (strict format, including tags)
+- You will output an XML structure with a root element "ANSWER" \
+containing "file" elements. Each "file" element will have a "path" \
+attribute and contain "range" elements.
+- You will output this as your final response.
+- The line ranges must be inclusive.
+
+Output example inside the "answer" tool argument:
+<ANSWER>
+  <file path="/codebase/info_theory/formulas/entropy.py">
+    <range>10-60</range>
+    <range>150-210</range>
+  </file>
+  <file path="/codebase/info_theory/data_structures/bits.py">
+    <range>1-40</range>
+    <range>110-170</range>
+  </file>
+</ANSWER>
+
+Remember: Prefer narrow, fixed-string, and type-filtered searches with \
+aggressive excludes and size/depth limits. Widen scope only as needed. \
+Use the restricted tools available to you, and output your answer in \
+exactly the specified format.
+
+# NO RESULTS POLICY
+If after thorough searching you are confident that NO relevant files exist \
+for the given query (e.g., the function/class/concept does not exist in the \
+codebase), you MUST return an empty ANSWER:
+<ANSWER></ANSWER>
+Do NOT return irrelevant files (such as entry points or config files) just \
+to provide some output. An empty answer is always better than a misleading one.
+
+# RESULT COUNT
+Aim to return at most ${MAX_RESULTS} files in your answer. Focus on the most \
+relevant files first. If fewer files are relevant, return fewer.
+`;
+export const FORCE_ANSWER = "You have no turns left. Now you MUST provide your final ANSWER, even if it's not complete.";
+export const RETRY_TOOL_CALL = "Your last reply did not contain a valid tool call. Reply with exactly one restricted_exec or answer call.";
+const COMMAND_SCHEMA = {
+    type: "object",
+    description: "One command. Must be one of: rg, readfile, or tree.",
+    oneOf: [
+        {
+            properties: {
+                type: { type: "string", const: "rg", description: "Search for patterns in files using ripgrep." },
+                pattern: { type: "string", description: "The regex pattern to search for." },
+                path: { type: "string", description: "The path to search in." },
+                include: { type: "array", items: { type: "string" }, description: "File patterns to include." },
+                exclude: { type: "array", items: { type: "string" }, description: "File patterns to exclude." },
+            },
+            required: ["type", "pattern", "path"],
+        },
+        {
+            properties: {
+                type: {
+                    type: "string",
+                    const: "readfile",
+                    description: "Read contents of a file with optional line range.",
+                },
+                file: { type: "string", description: "Path to the file to read." },
+                start_line: { type: "integer", description: "Starting line number (1-indexed)." },
+                end_line: { type: "integer", description: "Ending line number (1-indexed)." },
+            },
+            required: ["type", "file"],
+        },
+        {
+            properties: {
+                type: { type: "string", const: "tree", description: "Display directory structure as a tree." },
+                path: { type: "string", description: "Path to the directory." },
+                levels: { type: "integer", description: "Number of directory levels." },
+            },
+            required: ["type", "path"],
+        },
+    ],
+};
+/** The planner's two tools, in the OpenAI function format the backend expects. */
+export const TOOL_DEFINITIONS = JSON.stringify([
+    {
+        type: "function",
+        function: {
+            name: "restricted_exec",
+            description: "Execute restricted commands (rg, readfile, tree) in parallel.",
+            parameters: {
+                type: "object",
+                properties: Object.fromEntries(Array.from({ length: MAX_COMMANDS }, (_, i) => [`command${i + 1}`, COMMAND_SCHEMA])),
+                required: ["command1"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "answer",
+            description: "Final answer with relevant files and line ranges.",
+            parameters: {
+                type: "object",
+                properties: { answer: { type: "string", description: "The final answer in XML format." } },
+                required: ["answer"],
+            },
+        },
+    },
+]);
+//# sourceMappingURL=prompt.js.map

package/dist/extensions/search/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/extensions/search/prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/** Planning rounds before the final answer is forced, commands per round, and files per answer. */\nexport const MAX_TURNS = 3;\nexport const MAX_COMMANDS = 8;\nexport const MAX_RESULTS = 10;\n\n/**\n * The SWE-grep planner prompt, kept close to the Windsurf original the backend model was tuned on.\n * The budgets it states are the ones code-search.ts enforces.\n */\nexport const SYSTEM_PROMPT = `You are an expert software engineer, responsible for providing context \\\nto another engineer to solve a code issue in the current codebase. \\\nThe user will present you with a description of the issue, and it is \\\nyour job to provide a series of file paths with associated line ranges \\\nthat contain ALL the information relevant to understand and correctly \\\naddress the issue.\n\n# IMPORTANT:\n- A relevant file does not mean only the files that must be modified to \\\nsolve the task. It means any file that contains information relevant to \\\nplanning and implementing the fix, such as the definitions of classes \\\nand functions that are relevant to the pieces of code that will have to \\\nbe modified.\n- You should include enough context around the relevant lines to allow \\\nthe engineer to understand the task correctly. You must include ENTIRE \\\nsemantic blocks (functions, classes, definitions, etc). For example:\nIf addressing the issue requires modifying a method within a class, then \\\nyou should include the entire class definition, not just the lines around \\\nthe method we want to modify.\n- NEVER truncate these blocks unless they are very large (hundreds of \\\nlines or more, in which case providing only a relevant portion of the \\\nblock is acceptable).\n- Your job is to essentially alleviate the job of the other engineer by \\\ngiving them a clean starting context from which to start working. More \\\nprecisely, you should minimize the number of files the engineer has to \\\nread to understand and solve the task correctly (while not providing \\\nirrelevant code snippets).\n\n# ENVIRONMENT\n- Working directory: /codebase. Make sure to run commands in this \\\ndirectory, not \\`.\n- Tool access: use the restricted_exec tool ONLY\n- Allowed sub-commands (schema-enforced):\n  - rg: Search for patterns in files using ripgrep\n    - Required: pattern (string), path (string)\n    - Optional: include (array of globs), exclude (array of globs)\n  - readfile: Read contents of a file with optional line range\n    - Required: file (string)\n    - Optional: start_line (int), end_line (int) — 1-indexed, inclusive\n  - tree: Display directory structure as a tree\n    - Required: path (string)\n    - Optional: levels (int)\n\n# THINKING RULES\n- Think step-by-step. Plan, reason, and reflect before each tool call.\n- Use tool calls liberally and purposefully to ground every conclusion \\\nin real code, not assumptions.\n- If a command fails, rethink and try something different; do not \\\ncomplain to the user.\n\n# FAST-SEARCH DEFAULTS (optimize rg/tree on large repos)\n- Start NARROW, then widen only if needed. Prefer searching likely code \\\nroots first (e.g., \\`src/\\`, \\`lib/\\`, \\`app/\\`, \\`packages/\\`, \\`services/\\`) \\\ninstead of \\`/codebase\\`.\n- Prefer fixed-string search for literals: escape patterns or keep regex \\\nsimple. Use smart case; avoid case-insensitive unless necessary.\n- Prefer file-type filters and globs (in include) over full-repo scans.\n- Default EXCLUDES for speed (apply via the exclude array): \\\nnode_modules, .git, dist, build, coverage, .venv, venv, target, out, \\\n.cache, __pycache__, vendor, deps, third_party, logs, data, *.min.*\n- Skip huge files where possible; when opening files, prefer reading \\\nonly relevant ranges with readfile.\n- Limit directory traversal with tree levels to quickly orient before \\\ndeeper inspection.\n\n# SOME EXAMPLES OF WORKFLOWS\n- MAP – Use \\`tree\\` with small levels; \\`rg\\` on likely roots to grasp \\\nstructure and hotspots.\n- ANCHOR – \\`rg\\` for problem keywords and anchor symbols; restrict by \\\nlanguage globs via include.\n- TRACE – Follow imports with targeted \\`rg\\` in narrowed roots; open \\\nfiles with \\`readfile\\` scoped to entire semantic blocks.\n- VERIFY – Confirm each candidate path exists by reading or additional \\\nsearches; drop false positives (tests, vendored, generated) unless they \\\nmust change.\n\n# TOOL USE GUIDELINES\n- You must use a SINGLE restricted_exec call in your answer, that lets \\\nyou execute at most ${MAX_COMMANDS} commands in a single turn. Each command must be \\\nan object with a \\`type\\` field of \\`rg\\`, \\`readfile\\`, or \\`tree\\` and the appropriate fields for that type.\n- Example restricted_exec usage:\n[TOOL_CALLS]restricted_exec[ARGS]{\n  \"command1\": {\n    \"type\": \"rg\",\n    \"pattern\": \"Controller\",\n    \"path\": \"/codebase/slime\",\n    \"include\": [\"**/*.py\"],\n    \"exclude\": [\"**/node_modules/**\", \"**/.git/**\", \"**/dist/**\", \\\n\"**/build/**\", \"**/.venv/**\", \"**/__pycache__/**\"]\n  },\n  \"command2\": {\n    \"type\": \"readfile\",\n    \"file\": \"/codebase/slime/train.py\",\n    \"start_line\": 1,\n    \"end_line\": 200\n  },\n  \"command3\": {\n    \"type\": \"tree\",\n    \"path\": \"/codebase/slime/\",\n    \"levels\": 2\n  }\n}\n- You have at most ${MAX_TURNS} turns to interact with the environment by calling \\\ntools, so issuing multiple commands at once is necessary and encouraged \\\nto speed up your research.\n- Each command result may be truncated to 40 lines; prefer multiple \\\ntargeted reads/searches to build complete context.\n- DO NOT EVER USE MORE THAN ${MAX_COMMANDS} commands in a single turn, or you will \\\nbe penalized.\n\n# ANSWER FORMAT (strict format, including tags)\n- You will output an XML structure with a root element \"ANSWER\" \\\ncontaining \"file\" elements. Each \"file\" element will have a \"path\" \\\nattribute and contain \"range\" elements.\n- You will output this as your final response.\n- The line ranges must be inclusive.\n\nOutput example inside the \"answer\" tool argument:\n<ANSWER>\n  <file path=\"/codebase/info_theory/formulas/entropy.py\">\n    <range>10-60</range>\n    <range>150-210</range>\n  </file>\n  <file path=\"/codebase/info_theory/data_structures/bits.py\">\n    <range>1-40</range>\n    <range>110-170</range>\n  </file>\n</ANSWER>\n\nRemember: Prefer narrow, fixed-string, and type-filtered searches with \\\naggressive excludes and size/depth limits. Widen scope only as needed. \\\nUse the restricted tools available to you, and output your answer in \\\nexactly the specified format.\n\n# NO RESULTS POLICY\nIf after thorough searching you are confident that NO relevant files exist \\\nfor the given query (e.g., the function/class/concept does not exist in the \\\ncodebase), you MUST return an empty ANSWER:\n<ANSWER></ANSWER>\nDo NOT return irrelevant files (such as entry points or config files) just \\\nto provide some output. An empty answer is always better than a misleading one.\n\n# RESULT COUNT\nAim to return at most ${MAX_RESULTS} files in your answer. Focus on the most \\\nrelevant files first. If fewer files are relevant, return fewer.\n`;\n\nexport const FORCE_ANSWER =\n\t\"You have no turns left. Now you MUST provide your final ANSWER, even if it's not complete.\";\n\nexport const RETRY_TOOL_CALL =\n\t\"Your last reply did not contain a valid tool call. Reply with exactly one restricted_exec or answer call.\";\n\nconst COMMAND_SCHEMA = {\n\ttype: \"object\",\n\tdescription: \"One command. Must be one of: rg, readfile, or tree.\",\n\toneOf: [\n\t\t{\n\t\t\tproperties: {\n\t\t\t\ttype: { type: \"string\", const: \"rg\", description: \"Search for patterns in files using ripgrep.\" },\n\t\t\t\tpattern: { type: \"string\", description: \"The regex pattern to search for.\" },\n\t\t\t\tpath: { type: \"string\", description: \"The path to search in.\" },\n\t\t\t\tinclude: { type: \"array\", items: { type: \"string\" }, description: \"File patterns to include.\" },\n\t\t\t\texclude: { type: \"array\", items: { type: \"string\" }, description: \"File patterns to exclude.\" },\n\t\t\t},\n\t\t\trequired: [\"type\", \"pattern\", \"path\"],\n\t\t},\n\t\t{\n\t\t\tproperties: {\n\t\t\t\ttype: {\n\t\t\t\t\ttype: \"string\",\n\t\t\t\t\tconst: \"readfile\",\n\t\t\t\t\tdescription: \"Read contents of a file with optional line range.\",\n\t\t\t\t},\n\t\t\t\tfile: { type: \"string\", description: \"Path to the file to read.\" },\n\t\t\t\tstart_line: { type: \"integer\", description: \"Starting line number (1-indexed).\" },\n\t\t\t\tend_line: { type: \"integer\", description: \"Ending line number (1-indexed).\" },\n\t\t\t},\n\t\t\trequired: [\"type\", \"file\"],\n\t\t},\n\t\t{\n\t\t\tproperties: {\n\t\t\t\ttype: { type: \"string\", const: \"tree\", description: \"Display directory structure as a tree.\" },\n\t\t\t\tpath: { type: \"string\", description: \"Path to the directory.\" },\n\t\t\t\tlevels: { type: \"integer\", description: \"Number of directory levels.\" },\n\t\t\t},\n\t\t\trequired: [\"type\", \"path\"],\n\t\t},\n\t],\n};\n\n/** The planner's two tools, in the OpenAI function format the backend expects. */\nexport const TOOL_DEFINITIONS = JSON.stringify([\n\t{\n\t\ttype: \"function\",\n\t\tfunction: {\n\t\t\tname: \"restricted_exec\",\n\t\t\tdescription: \"Execute restricted commands (rg, readfile, tree) in parallel.\",\n\t\t\tparameters: {\n\t\t\t\ttype: \"object\",\n\t\t\t\tproperties: Object.fromEntries(\n\t\t\t\t\tArray.from({ length: MAX_COMMANDS }, (_, i) => [`command${i + 1}`, COMMAND_SCHEMA]),\n\t\t\t\t),\n\t\t\t\trequired: [\"command1\"],\n\t\t\t},\n\t\t},\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tfunction: {\n\t\t\tname: \"answer\",\n\t\t\tdescription: \"Final answer with relevant files and line ranges.\",\n\t\t\tparameters: {\n\t\t\t\ttype: \"object\",\n\t\t\t\tproperties: { answer: { type: \"string\", description: \"The final answer in XML format.\" } },\n\t\t\t\trequired: [\"answer\"],\n\t\t\t},\n\t\t},\n\t},\n]);\n"]}

package/dist/extensions/search/render.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Rows for code_search and web_search, in the shape of the built-in explore tools: a one-line
+ * header that carries progress and the result count, and a body only when expanded (or failed).
+ * The model-facing text is untouched; these read `details`.
+ */
+import { type Component } from "@earendil-works/pi-tui";
+import type { AgentToolResult, ToolRenderContext, ToolRenderResultOptions } from "../../core/extensions/types.ts";
+import type { Theme } from "../../modes/interactive/theme/theme.ts";
+import type { CodeLocation } from "./code-search.ts";
+import type { WebResult } from "./devin.ts";
+export interface CodeSearchDetails {
+    locations: CodeLocation[];
+}
+export interface WebSearchDetails {
+    results: WebResult[];
+}
+export declare function renderCodeSearchCall(args: {
+    query?: string;
+    path?: string;
+}, theme: Theme, context: ToolRenderContext<unknown, unknown, CodeSearchDetails>): Component;
+export declare function renderCodeSearchResult(result: AgentToolResult<CodeSearchDetails>, options: ToolRenderResultOptions, theme: Theme, context: ToolRenderContext<unknown, {
+    path?: string;
+}, CodeSearchDetails>): Component;
+export declare function renderWebSearchCall(args: {
+    query?: string;
+}, theme: Theme, context: ToolRenderContext<unknown, unknown, WebSearchDetails>): Component;
+export declare function renderWebSearchResult(result: AgentToolResult<WebSearchDetails>, options: ToolRenderResultOptions, theme: Theme, context: ToolRenderContext<unknown, unknown, WebSearchDetails>): Component;
+//# sourceMappingURL=render.d.ts.map

package/dist/extensions/search/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/extensions/search/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,SAAS,EAA6D,MAAM,wBAAwB,CAAC;AACnH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAClH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,SAAS,EAAE,CAAC;CACrB;AAqDD,wBAAgB,oBAAoB,CACnC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACvC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,GAC7D,SAAS,CAMX;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAC1C,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,iBAAiB,CAAC,GACvE,SAAS,CAiBX;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAC5D,SAAS,CAKX;AAED,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,eAAe,CAAC,gBAAgB,CAAC,EACzC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAC5D,SAAS,CAaX"}

package/dist/extensions/search/render.js

@@ -0,0 +1,86 @@
+/**
+ * Rows for code_search and web_search, in the shape of the built-in explore tools: a one-line
+ * header that carries progress and the result count, and a body only when expanded (or failed).
+ * The model-facing text is untouched; these read `details`.
+ */
+import { Container, hyperlink, Text, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+/** Columns beyond which a path or title stops pushing the second column right. */
+const MAX_FIRST_COLUMN = 56;
+function textOf(result) {
+    const block = result?.content.find((c) => c.type === "text");
+    return block && "text" in block ? block.text.trim() : "";
+}
+function plural(n, word) {
+    return `${n} ${word}${n === 1 ? "" : "s"}`;
+}
+/** `● name "query"<scope> · <status>`, where status is live progress, then the result count. */
+function header(theme, name, query, scope, context, summary) {
+    let line = `${theme.fg("toolTitle", theme.bold(name))} ${theme.fg("accent", `"${query ?? ""}"`)}`;
+    if (scope)
+        line += theme.fg("toolOutput", scope);
+    const status = !context.result || context.isError ? "" : context.isPartial ? textOf(context.result) : summary();
+    if (status)
+        line += theme.fg("muted", ` · ${status}`);
+    return new Text(line, 0, 0);
+}
+/** Two aligned columns; the first is padded to the widest entry, up to MAX_FIRST_COLUMN. */
+function columns(rows) {
+    const width = Math.min(MAX_FIRST_COLUMN, Math.max(...rows.map((r) => visibleWidth(r.first))));
+    const lines = rows.map(({ first, second }) => {
+        const cell = visibleWidth(first) > width ? truncateToWidth(first, width, "…") : first;
+        return `${cell}${" ".repeat(Math.max(0, width - visibleWidth(cell)))}   ${second}`;
+    });
+    return new Text(lines.join("\n"), 0, 0);
+}
+/** Collapsed and still-running rows show nothing below the header; a failure always shows its message. */
+function body(result, options, theme, context, expanded) {
+    if (context.isError)
+        return new Text(theme.fg("error", textOf(result).split("\n")[0] ?? ""), 0, 0);
+    if (!options.expanded || options.isPartial)
+        return new Container();
+    return expanded();
+}
+export function renderCodeSearchCall(args, theme, context) {
+    const scope = args.path && args.path !== "." ? ` in ${args.path.replace(/\\/g, "/")}` : "";
+    return header(theme, "code_search", args.query, scope, context, () => {
+        const n = context.result?.details?.locations.length ?? 0;
+        return n ? plural(n, "file") : "nothing found";
+    });
+}
+export function renderCodeSearchResult(result, options, theme, context) {
+    return body(result, options, theme, context, () => {
+        const locations = result.details?.locations ?? [];
+        if (!locations.length)
+            return new Text(theme.fg("muted", "No relevant code found."), 0, 0);
+        // Paths are relative to the session directory; show them relative to the searched path.
+        const scope = context.args.path?.replace(/\\/g, "/").replace(/^\.\/?|\/+$/g, "");
+        return columns(locations.map(({ path, ranges }) => {
+            const shown = scope && path.startsWith(`${scope}/`) ? path.slice(scope.length + 1) : path;
+            const slash = shown.lastIndexOf("/");
+            return {
+                first: theme.fg("muted", shown.slice(0, slash + 1)) + theme.fg("toolOutput", shown.slice(slash + 1)),
+                second: theme.fg("accent", ranges.map(([s, e]) => (s === e ? `${s}` : `${s}-${e}`)).join(" · ")),
+            };
+        }));
+    });
+}
+export function renderWebSearchCall(args, theme, context) {
+    return header(theme, "web_search", args.query, "", context, () => {
+        const n = context.result?.details?.results.length ?? 0;
+        return n ? plural(n, "result") : "no results";
+    });
+}
+export function renderWebSearchResult(result, options, theme, context) {
+    return body(result, options, theme, context, () => {
+        const results = result.details?.results ?? [];
+        if (!results.length)
+            return new Text(theme.fg("muted", "No results."), 0, 0);
+        return columns(results.map(({ url, title }) => {
+            const host = new URL(url).hostname.replace(/^www\./, "");
+            const label = title ?? url;
+            const cell = visibleWidth(label) > MAX_FIRST_COLUMN ? truncateToWidth(label, MAX_FIRST_COLUMN, "…") : label;
+            return { first: hyperlink(theme.fg("toolOutput", cell), url), second: theme.fg("muted", host) };
+        }));
+    });
+}
+//# sourceMappingURL=render.js.map

package/dist/extensions/search/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/extensions/search/render.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Rows for code_search and web_search, in the shape of the built-in explore tools: a one-line\n * header that carries progress and the result count, and a body only when expanded (or failed).\n * The model-facing text is untouched; these read `details`.\n */\nimport { type Component, Container, hyperlink, Text, truncateToWidth, visibleWidth } from \"@earendil-works/pi-tui\";\nimport type { AgentToolResult, ToolRenderContext, ToolRenderResultOptions } from \"../../core/extensions/types.ts\";\nimport type { Theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { CodeLocation } from \"./code-search.ts\";\nimport type { WebResult } from \"./devin.ts\";\n\nexport interface CodeSearchDetails {\n\tlocations: CodeLocation[];\n}\n\nexport interface WebSearchDetails {\n\tresults: WebResult[];\n}\n\n/** Columns beyond which a path or title stops pushing the second column right. */\nconst MAX_FIRST_COLUMN = 56;\n\nfunction textOf(result: AgentToolResult<unknown> | undefined): string {\n\tconst block = result?.content.find((c) => c.type === \"text\");\n\treturn block && \"text\" in block ? block.text.trim() : \"\";\n}\n\nfunction plural(n: number, word: string): string {\n\treturn `${n} ${word}${n === 1 ? \"\" : \"s\"}`;\n}\n\n/** `● name \"query\"<scope> · <status>`, where status is live progress, then the result count. */\nfunction header(\n\ttheme: Theme,\n\tname: string,\n\tquery: string | undefined,\n\tscope: string,\n\tcontext: ToolRenderContext,\n\tsummary: () => string,\n): Component {\n\tlet line = `${theme.fg(\"toolTitle\", theme.bold(name))} ${theme.fg(\"accent\", `\"${query ?? \"\"}\"`)}`;\n\tif (scope) line += theme.fg(\"toolOutput\", scope);\n\tconst status = !context.result || context.isError ? \"\" : context.isPartial ? textOf(context.result) : summary();\n\tif (status) line += theme.fg(\"muted\", ` · ${status}`);\n\treturn new Text(line, 0, 0);\n}\n\n/** Two aligned columns; the first is padded to the widest entry, up to MAX_FIRST_COLUMN. */\nfunction columns(rows: Array<{ first: string; second: string }>): Component {\n\tconst width = Math.min(MAX_FIRST_COLUMN, Math.max(...rows.map((r) => visibleWidth(r.first))));\n\tconst lines = rows.map(({ first, second }) => {\n\t\tconst cell = visibleWidth(first) > width ? truncateToWidth(first, width, \"…\") : first;\n\t\treturn `${cell}${\" \".repeat(Math.max(0, width - visibleWidth(cell)))}   ${second}`;\n\t});\n\treturn new Text(lines.join(\"\\n\"), 0, 0);\n}\n\n/** Collapsed and still-running rows show nothing below the header; a failure always shows its message. */\nfunction body(\n\tresult: AgentToolResult<unknown>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tcontext: ToolRenderContext,\n\texpanded: () => Component,\n): Component {\n\tif (context.isError) return new Text(theme.fg(\"error\", textOf(result).split(\"\\n\")[0] ?? \"\"), 0, 0);\n\tif (!options.expanded || options.isPartial) return new Container();\n\treturn expanded();\n}\n\nexport function renderCodeSearchCall(\n\targs: { query?: string; path?: string },\n\ttheme: Theme,\n\tcontext: ToolRenderContext<unknown, unknown, CodeSearchDetails>,\n): Component {\n\tconst scope = args.path && args.path !== \".\" ? ` in ${args.path.replace(/\\\\/g, \"/\")}` : \"\";\n\treturn header(theme, \"code_search\", args.query, scope, context, () => {\n\t\tconst n = context.result?.details?.locations.length ?? 0;\n\t\treturn n ? plural(n, \"file\") : \"nothing found\";\n\t});\n}\n\nexport function renderCodeSearchResult(\n\tresult: AgentToolResult<CodeSearchDetails>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tcontext: ToolRenderContext<unknown, { path?: string }, CodeSearchDetails>,\n): Component {\n\treturn body(result, options, theme, context, () => {\n\t\tconst locations = result.details?.locations ?? [];\n\t\tif (!locations.length) return new Text(theme.fg(\"muted\", \"No relevant code found.\"), 0, 0);\n\t\t// Paths are relative to the session directory; show them relative to the searched path.\n\t\tconst scope = context.args.path?.replace(/\\\\/g, \"/\").replace(/^\\.\\/?|\\/+$/g, \"\");\n\t\treturn columns(\n\t\t\tlocations.map(({ path, ranges }) => {\n\t\t\t\tconst shown = scope && path.startsWith(`${scope}/`) ? path.slice(scope.length + 1) : path;\n\t\t\t\tconst slash = shown.lastIndexOf(\"/\");\n\t\t\t\treturn {\n\t\t\t\t\tfirst: theme.fg(\"muted\", shown.slice(0, slash + 1)) + theme.fg(\"toolOutput\", shown.slice(slash + 1)),\n\t\t\t\t\tsecond: theme.fg(\"accent\", ranges.map(([s, e]) => (s === e ? `${s}` : `${s}-${e}`)).join(\" · \")),\n\t\t\t\t};\n\t\t\t}),\n\t\t);\n\t});\n}\n\nexport function renderWebSearchCall(\n\targs: { query?: string },\n\ttheme: Theme,\n\tcontext: ToolRenderContext<unknown, unknown, WebSearchDetails>,\n): Component {\n\treturn header(theme, \"web_search\", args.query, \"\", context, () => {\n\t\tconst n = context.result?.details?.results.length ?? 0;\n\t\treturn n ? plural(n, \"result\") : \"no results\";\n\t});\n}\n\nexport function renderWebSearchResult(\n\tresult: AgentToolResult<WebSearchDetails>,\n\toptions: ToolRenderResultOptions,\n\ttheme: Theme,\n\tcontext: ToolRenderContext<unknown, unknown, WebSearchDetails>,\n): Component {\n\treturn body(result, options, theme, context, () => {\n\t\tconst results = result.details?.results ?? [];\n\t\tif (!results.length) return new Text(theme.fg(\"muted\", \"No results.\"), 0, 0);\n\t\treturn columns(\n\t\t\tresults.map(({ url, title }) => {\n\t\t\t\tconst host = new URL(url).hostname.replace(/^www\\./, \"\");\n\t\t\t\tconst label = title ?? url;\n\t\t\t\tconst cell = visibleWidth(label) > MAX_FIRST_COLUMN ? truncateToWidth(label, MAX_FIRST_COLUMN, \"…\") : label;\n\t\t\t\treturn { first: hyperlink(theme.fg(\"toolOutput\", cell), url), second: theme.fg(\"muted\", host) };\n\t\t\t}),\n\t\t);\n\t});\n}\n"]}

package/dist/extensions/search/workspace.d.ts

@@ -0,0 +1,38 @@
+export declare const VIRTUAL_ROOT = "/codebase";
+/** `rg` backend: pattern, directory or file, optional glob → `path:line: text` lines. */
+export type Grep = (pattern: string, path: string, glob: string | undefined, signal?: AbortSignal) => Promise<string>;
+/** Pi's own grep tool: gitignore-aware, with its bundled ripgrep. It takes one glob, so only the first include applies. */
+export declare function piGrep(root: string): Grep;
+/** Whether `path` lies inside `root`, both as written and after following symlinks. */
+export declare function isInside(root: string, path: string): boolean;
+export interface Command {
+    type?: unknown;
+    pattern?: unknown;
+    path?: unknown;
+    include?: unknown;
+    file?: unknown;
+    start_line?: unknown;
+    end_line?: unknown;
+    levels?: unknown;
+}
+export declare class Workspace {
+    readonly root: string;
+    private readonly grep;
+    private readonly noise;
+    constructor(root: string, grep?: Grep);
+    contains(path: string): boolean;
+    /** `/codebase/src/a.ts` or `src/a.ts` → an absolute path inside the root, or null. */
+    toReal(virtual: unknown): string | null;
+    toVirtual(real: string): string;
+    /** The deepest tree of the root, up to three levels, that fits the map budget. */
+    repoMap(): {
+        depth: number;
+        tree: string;
+    };
+    run(command: Command, signal?: AbortSignal): Promise<string>;
+    private rg;
+    private readfile;
+    private tree;
+    private renderTree;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/extensions/search/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/extensions/search/workspace.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,YAAY,cAAc,CAAC;AA6BxC,yFAAyF;AACzF,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtH,2HAA2H;AAC3H,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAWzC;AAwBD,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG5D;AAWD,MAAM,WAAW,OAAO;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,SAAS;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAmB;IAMnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,sFAAsF;IACtF,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAgBvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK/B,kFAAkF;IAClF,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQpC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YAapD,EAAE;IA2BhB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,UAAU;CA0BlB"}