@cydm/pie 1.0.7 → 1.0.8

package/README.md

@@ -92,6 +92,7 @@ Validate the file explicitly:
 ```bash
 pie models validate
 pie models validate --path /abs/path/to/models.json
+pie models validate --probe web_search
 ```
 
 Generate a starter template:
@@ -249,13 +250,15 @@ node <resolvedPath for browser-tools/playwright-cli.js> install-browser chromium
 
 Run `pie doctor` to check whether Playwright CLI and its browser runtime are discoverable.
 
-## Web Search
+## Web Research
 
-Pie exposes a canonical `web_search` tool for public web research, current information, online documentation, and internet inspiration. Workspace search remains separate: use `grep_text`, `find_files`, and `list_dir` for local repository content.
+Pie exposes a canonical `web_research` tool for public web research, current information, online documentation, and internet inspiration. It plans search variants, uses provider-native search, fetches credible sources, and returns citations. Workspace search remains separate: use `grep_text`, `find_files`, and `list_dir` for local repository content.
 
-`web_search` uses provider-native web search where supported. It does not scrape DuckDuckGo or fall back to `bash` with `curl` or Python HTTP scripts. If the current provider/model cannot perform native web search, the tool returns a clear unavailable result with provider/configuration details.
+`web_search` remains available as the lower-level provider-native search tool. It does not scrape DuckDuckGo or fall back to `bash` with `curl` or Python HTTP scripts. If the configured provider/model cannot perform native web search, the tool returns a clear unavailable result with provider/configuration details.
 
-Use `web_fetch` after search when the agent needs to read a specific URL, documentation page, changelog, issue, or PDF. `web_fetch` follows redirects, extracts readable text/markdown, returns citation anchors and extraction diagnostics, and reports `requires_browser` for JavaScript-heavy pages instead of pretending the content was read.
+Use `web_fetch` directly when the agent needs to read a specific URL, documentation page, changelog, issue, or PDF. `web_fetch` follows redirects, extracts readable text/markdown, returns citation anchors and extraction diagnostics, and reports `requires_browser` for JavaScript-heavy pages instead of pretending the content was read. In the CLI, `web_research` can use browser-tools for browser-rendered sources when the Playwright runtime is available; Unity reports those pages as `requires_browser`.
+
+`web_research` records route health and latency in Pie's state directory so later runs can prefer providers with better source quality, fewer timeouts, and lower rate-limit pressure. `pie doctor --json` reports the recorded provider health, and `verify:web` writes web metrics including p50/p95 latency, failure categories, and citation quality artifacts.
 
 ## Permissions
 
@@ -305,8 +308,10 @@ npm run verify:terminal:matrix
 ```
 
 Use `npm run verify:agent` when model credentials are available and you want the real daily agent gate.
-Use `npm run verify:agent:nightly` and `npm run verify:unity:reliability` before release candidates that claim real-provider or Unity reliability.
+Use `npm run verify:agent:nightly` before release candidates that claim real-provider reliability.
+Use `UNITY_EDITOR="/path/to/Unity" npm run verify:unity:reliability` before Unity release candidates. For live Unity Dev RPC coverage, run `PIE_UNITY_REAL_RPC=1 UNITY_EDITOR="/path/to/Unity" npm run verify:unity:reliability`.
 Set `PIE_REAL_BROWSER=1` when you want `verify:browser` to open a real browser session instead of only checking the Playwright CLI contract.
+Set `PIE_REAL_WEB=1` when you want `verify:web` to run real provider web research smoke with fetched or browser-read citations.
 
 ## Publishing
 

package/dist/builtin/extensions/ask-user/index.js

@@ -1,7 +1,7 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   createAskUserCapability
-} from "../../../chunks/chunk-BHNULR7U.js";
+} from "../../../chunks/chunk-6WD2NFIC.js";
 import "../../../chunks/chunk-A5JSJAPK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 

package/dist/builtin/extensions/init/index.js

@@ -1,136 +1,138 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+import {
+  resolveCliProjectRoot
+} from "../../../chunks/chunk-NTYHFBUA.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 
 // builtin/extensions/init/index.ts
+import fs from "node:fs";
+import path from "node:path";
+function resolveProjectAgentsTarget(cwd) {
+  const projectRoot = resolveCliProjectRoot(cwd);
+  return {
+    projectRoot,
+    agentsPath: path.join(projectRoot, "AGENTS.md")
+  };
+}
 async function loadExistingKnowledge(cwd) {
+  const target = resolveProjectAgentsTarget(cwd);
   try {
-    const fs = await import("fs");
-    const path = await import("path");
-    const agentsPath = path.join(cwd, ".pie", "agents.md");
-    if (fs.existsSync(agentsPath)) {
-      return fs.readFileSync(agentsPath, "utf-8");
+    if (fs.existsSync(target.agentsPath)) {
+      return { target, content: fs.readFileSync(target.agentsPath, "utf-8") };
     }
   } catch {
   }
-  return null;
-}
-async function ensurePieDir(cwd) {
-  const fs = await import("fs");
-  const path = await import("path");
-  const pieDir = path.join(cwd, ".pie");
-  if (!fs.existsSync(pieDir)) {
-    fs.mkdirSync(pieDir, { recursive: true });
-  }
+  return { target, content: null };
 }
 function buildResearchPrompt(params) {
-  const { isUpdate, existingContent, userIntent, cwd } = params;
+  const { isUpdate, existingContent, userIntent, cwd, projectRoot, agentsPath } = params;
   if (isUpdate && existingContent) {
     const truncatedContent = existingContent.length > 4e3 ? existingContent.slice(0, 4e3) + "\n... (truncated)" : existingContent;
-    return `\u{1F4DD} \u66F4\u65B0\u9879\u76EE\u77E5\u8BC6\u6587\u6863
+    return `\u{1F4DD} \u66F4\u65B0 root AGENTS.md \u9879\u76EE\u4E0A\u4E0B\u6587
+
+\u76EE\u6807\u6587\u4EF6\uFF1A${agentsPath}
+\u9879\u76EE\u6839\u76EE\u5F55\uFF1A${projectRoot}
+\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF1A${cwd}
 
-\u5F53\u524D .pie/agents.md \u5185\u5BB9\uFF1A
+\u5F53\u524D root AGENTS.md \u5185\u5BB9\uFF1A
 \`\`\`
 ${truncatedContent}
 \`\`\`
 
 ${userIntent ? `\u{1F4CC} \u7528\u6237\u66F4\u65B0\u610F\u56FE\uFF1A${userIntent}
 
-` : ""}\u8BF7\u91CD\u65B0\u7814\u7A76\u9879\u76EE\u5E76\u66F4\u65B0\u77E5\u8BC6\u6587\u6863\uFF1A
+` : ""}\u8BF7\u91CD\u65B0\u7814\u7A76\u9879\u76EE\u5E76\u66F4\u65B0 root AGENTS.md\uFF1A
 
-1. \u63A2\u7D22\u5F53\u524D\u4EE3\u7801\u7ED3\u6784\uFF0C\u5BF9\u6BD4\u73B0\u6709\u6587\u6863
-2. \u8BC6\u522B\u65B0\u589E/\u53D8\u66F4/\u79FB\u9664\u7684\u6A21\u5757\u548C\u6587\u4EF6
-3. ${userIntent ? `\u91CD\u70B9\u5173\u6CE8\uFF1A${userIntent}` : "\u8865\u5145\u7F3A\u5931\u7684\u7EC6\u8282\u548C\u67B6\u6784\u8BF4\u660E\uFF0C\u66F4\u65B0\u8FC7\u65F6\u7684\u4FE1\u606F"}
-4. \u4FDD\u6301\u6587\u6863\u7ED3\u6784\u6E05\u6670\uFF0C\u7EF4\u62A4\u7AE0\u8282\u5B8C\u6574\u6027
-5. \u66F4\u65B0\u540E\u786E\u4FDD agents.md \u4ECD\u7136\u6709\u7528\u4E14\u51C6\u786E
+1. \u4FDD\u6301 AGENTS.md \u662F progressive disclosure index\uFF0C\u4E0D\u8981\u5199\u6210\u957F\u7BC7\u9879\u76EE\u767E\u79D1
+2. \u4FDD\u7559\u7B80\u77ED root instructions\uFF0C\u7136\u540E\u7EF4\u62A4 Repo Map
+3. Repo Map \u91CC\u7684\u6BCF\u4E2A\u91CD\u8981\u76EE\u5F55\u90FD\u8981\u6709 desc\uFF0C\u8BF4\u660E\u4EC0\u4E48\u65F6\u5019\u9700\u8981\u8BFB\u8BE5\u76EE\u5F55\u6216\u76F8\u5173\u6587\u6863
+4. \u53EA\u8865\u5145\u7A33\u5B9A\u89C4\u5219\u3001\u76EE\u5F55\u8DEF\u7531\u3001\u9A8C\u8BC1\u95E8\u7981\u548C\u751F\u6210\u7269\u89C4\u5219
+5. \u5220\u9664\u8FC7\u65F6\u6216\u91CD\u590D README/ARCHITECTURE \u7684\u5927\u6BB5\u5185\u5BB9
 
-\u8BF7\u4F7F\u7528 write \u5DE5\u5177\u66F4\u65B0 \`.pie/agents.md\` \u6587\u4EF6\u3002
-
-\u5DE5\u4F5C\u76EE\u5F55\uFF1A${cwd}`;
+\u8BF7\u4F7F\u7528 write_file \u5DE5\u5177\u66F4\u65B0\u76EE\u6807\u6587\u4EF6\uFF1A${agentsPath}
+CLI \u6587\u4EF6\u5DE5\u5177\u4F1A\u4EE5\u9879\u76EE\u6839\u76EE\u5F55\u4F5C\u4E3A\u8BBF\u95EE\u8FB9\u754C\uFF1B\u4E0D\u8981\u4F7F\u7528\u989D\u5916\u7684 root \u53C2\u6570\u3002`;
   }
-  return `\u{1F50D} \u521D\u59CB\u5316\u9879\u76EE\u7814\u7A76
+  return `\u{1F50D} \u521D\u59CB\u5316 root AGENTS.md \u9879\u76EE\u4E0A\u4E0B\u6587
+
+\u76EE\u6807\u6587\u4EF6\uFF1A${agentsPath}
+\u9879\u76EE\u6839\u76EE\u5F55\uFF1A${projectRoot}
+\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\uFF1A${cwd}
 
 ${userIntent ? `\u{1F4CC} \u7528\u6237\u7814\u7A76\u610F\u56FE\uFF1A${userIntent}
 
-` : ""}\u8BF7\u5E2E\u6211\u5168\u9762\u7814\u7A76\u5F53\u524D\u9879\u76EE\u5E76\u521B\u5EFA \`.pie/agents.md\` \u77E5\u8BC6\u6587\u6863\u3002
+` : ""}\u8BF7\u7814\u7A76\u5F53\u524D\u9879\u76EE\u5E76\u521B\u5EFA root \`AGENTS.md\`\u3002\u8FD9\u4E2A\u6587\u4EF6\u5E94\u8BE5\u662F progressive disclosure index\uFF0C\u7528\u6765\u6307\u5BFC\u540E\u7EED agent \u6309\u9700\u8BFB\u53D6\u76F8\u5173\u6587\u6863\uFF0C\u800C\u4E0D\u662F\u4E00\u6B21\u6027\u603B\u7ED3\u6574\u4E2A\u4ED3\u5E93\u3002
 
 \u7814\u7A76\u4EFB\u52A1\uFF1A
 1. \u8BC6\u522B\u9879\u76EE\u7C7B\u578B\u548C\u6280\u672F\u6808\uFF08\u67E5\u770B package.json, Cargo.toml, go.mod, requirements.txt, pyproject.toml \u7B49\uFF09
-2. \u63A2\u7D22\u6E90\u4EE3\u7801\u76EE\u5F55\u7ED3\u6784\uFF08src/, lib/, app/ \u7B49\u5E38\u89C1\u76EE\u5F55\uFF09
-3. \u8BFB\u53D6\u5173\u952E\u914D\u7F6E\u6587\u4EF6\u7406\u89E3\u9879\u76EE\u8BBE\u7F6E
-4. \u8BC6\u522B\u4E3B\u8981\u6A21\u5757\u3001\u5165\u53E3\u70B9\u3001\u6838\u5FC3\u7C7B/\u51FD\u6570
-5. \u5206\u6790\u67B6\u6784\u6A21\u5F0F\u548C\u8BBE\u8BA1\u51B3\u7B56
-6. \u63A8\u65AD\u5F00\u53D1\u89C4\u8303\uFF08\u4EE3\u7801\u98CE\u683C\u3001\u6D4B\u8BD5\u3001\u6784\u5EFA\u6D41\u7A0B\uFF09
+2. \u63A2\u7D22\u9876\u5C42\u76EE\u5F55\u7ED3\u6784\u548C\u5173\u952E package/product \u8FB9\u754C
+3. \u8BFB\u53D6 README\u3001ARCHITECTURE\u3001docs/public-api \u7B49\u5DF2\u6709\u6587\u6863\uFF0C\u907F\u514D\u91CD\u590D\u7C98\u8D34
+4. \u8BC6\u522B\u751F\u6210\u7269\u89C4\u5219\u3001\u6D4B\u8BD5\u95E8\u7981\u3001\u4EE3\u7801\u5206\u5C42\u548C\u9AD8\u98CE\u9669\u6539\u52A8\u8FB9\u754C
+5. \u751F\u6210\u7B80\u77ED\u3001\u7A33\u5B9A\u3001\u53EF\u7EF4\u62A4\u7684\u76EE\u5F55\u8DEF\u7531\u8BF4\u660E
 
-\u8BF7\u751F\u6210\u5305\u542B\u4EE5\u4E0B\u7AE0\u8282\u7684 agents.md\uFF1A
+\u8BF7\u751F\u6210\u5305\u542B\u4EE5\u4E0B\u7AE0\u8282\u7684 AGENTS.md\uFF1A
 
 \`\`\`
-# Project: <\u9879\u76EE\u540D\u79F0>
+# AGENTS.md
 
-## \u6982\u89C8
-- \u7C7B\u578B\uFF1A<\u9879\u76EE\u7C7B\u578B>
-- \u6280\u672F\u6808\uFF1A<\u4E3B\u8981\u6280\u672F>
-- \u4E00\u53E5\u8BDD\u63CF\u8FF0\uFF1A<\u9879\u76EE\u7528\u9014>
+## How To Use This File
+Briefly explain that this file is an index/router. Agents should read linked docs on demand.
 
-## \u67B6\u6784\u5206\u6790
-- \u6A21\u5757\u5212\u5206
-- \u5173\u952E\u7EC4\u4EF6\u8BF4\u660E
-- \u4F9D\u8D56\u5173\u7CFB
+## Repo Map
+- \`path\`
+  desc: When to read this directory and what it owns.
 
-## \u6838\u5FC3\u6587\u4EF6
-| \u7528\u9014 | \u8DEF\u5F84 | \u8BF4\u660E |
-|------|------|------|
+## Architecture Rules
+Stable cross-package boundaries only.
 
-## \u5F00\u53D1\u89C4\u8303
-- \u4EE3\u7801\u98CE\u683C
-- \u6D4B\u8BD5\u6A21\u5F0F
-- \u6784\u5EFA/\u8FD0\u884C\u65B9\u5F0F
+## Context And Generated Artifacts
+Rules for AGENTS.md, generated bundles, and source-of-truth files.
 
-## \u63A2\u7D22\u6E05\u5355\uFF08\u5F85\u6DF1\u5165\u7814\u7A76\uFF09
-- [ ] 
+## Verification Map
+Which focused tests/checks to run by touched area.
 \`\`\`
 
-\u8BF7\u4F7F\u7528 write \u5DE5\u5177\u521B\u5EFA \`.pie/agents.md\` \u6587\u4EF6\u3002
-
-\u5DE5\u4F5C\u76EE\u5F55\uFF1A${cwd}`;
+\u8BF7\u4F7F\u7528 write_file \u5DE5\u5177\u521B\u5EFA\u76EE\u6807\u6587\u4EF6\uFF1A${agentsPath}
+CLI \u6587\u4EF6\u5DE5\u5177\u4F1A\u4EE5\u9879\u76EE\u6839\u76EE\u5F55\u4F5C\u4E3A\u8BBF\u95EE\u8FB9\u754C\uFF1B\u4E0D\u8981\u4F7F\u7528\u989D\u5916\u7684 root \u53C2\u6570\u3002`;
 }
 async function initExtension(ctx) {
   ctx.log("Init extension loaded");
   let cachedKnowledge = null;
   try {
-    cachedKnowledge = await loadExistingKnowledge(ctx.cwd);
+    const existing = await loadExistingKnowledge(ctx.cwd);
+    cachedKnowledge = existing.content;
     if (cachedKnowledge) {
-      const firstLine = cachedKnowledge.split("\n")[0] || "";
-      const projectName = firstLine.replace(/^#\s*/, "").trim() || "\u9879\u76EE";
-      ctx.log(`Pre-loaded agents.md (${cachedKnowledge.length} chars)`);
+      ctx.log(`Pre-loaded root AGENTS.md (${cachedKnowledge.length} chars) from ${existing.target.agentsPath}`);
     } else {
-      ctx.log("No existing agents.md found");
+      ctx.log(`No existing root AGENTS.md found at ${existing.target.agentsPath}`);
     }
   } catch (err) {
-    ctx.log(`Failed to pre-load agents.md: ${err}`);
+    ctx.log(`Failed to pre-load root AGENTS.md: ${err}`);
   }
   ctx.registerCommand({
     path: ["tools", "init"],
-    description: "\u7814\u7A76\u9879\u76EE\u5E76\u751F\u6210/\u66F4\u65B0 agents.md \u77E5\u8BC6\u6587\u6863",
+    description: "\u7814\u7A76\u9879\u76EE\u5E76\u751F\u6210/\u66F4\u65B0 root AGENTS.md \u9879\u76EE\u4E0A\u4E0B\u6587\u7D22\u5F15",
     handler: async (ctx2, args) => {
-      await ensurePieDir(ctx2.cwd);
-      const existingContent = await loadExistingKnowledge(ctx2.cwd);
-      const isUpdate = !!existingContent;
+      const existing = await loadExistingKnowledge(ctx2.cwd);
+      const existingContent = existing.content;
+      const isUpdate = !!existing.content;
       const userIntent = args?.trim();
       cachedKnowledge = existingContent;
       if (isUpdate) {
         if (userIntent) {
           ctx2.ui.notify(`\u{1F4DD} \u6B63\u5728\u66F4\u65B0\u9879\u76EE\u77E5\u8BC6\uFF08${userIntent}\uFF09...`, "info");
         } else {
-          ctx2.ui.notify("\u{1F4DD} \u6B63\u5728\u66F4\u65B0\u9879\u76EE\u77E5\u8BC6...", "info");
+          ctx2.ui.notify("\u{1F4DD} \u6B63\u5728\u66F4\u65B0 root AGENTS.md...", "info");
         }
       } else {
-        ctx2.ui.notify("\u{1F50D} \u6B63\u5728\u521D\u59CB\u5316\u9879\u76EE\u7814\u7A76...", "info");
+        ctx2.ui.notify("\u{1F50D} \u6B63\u5728\u521D\u59CB\u5316 root AGENTS.md...", "info");
       }
       const researchPrompt = buildResearchPrompt({
         isUpdate,
         existingContent,
         userIntent,
-        cwd: ctx2.cwd
+        cwd: ctx2.cwd,
+        projectRoot: existing.target.projectRoot,
+        agentsPath: existing.target.agentsPath
       });
       return researchPrompt;
     }

package/dist/builtin/extensions/plan-mode/index.js

@@ -7,7 +7,7 @@ import {
   isPlanModeSafeCommand,
   markCompletedPlanSteps,
   restoreExecutionState
-} from "../../../chunks/chunk-BHNULR7U.js";
+} from "../../../chunks/chunk-6WD2NFIC.js";
 import "../../../chunks/chunk-A5JSJAPK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 

package/dist/builtin/extensions/subagent/index.js

@@ -1,14 +1,11 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   createCliHostCapabilities
-} from "../../../chunks/chunk-GDTN4UPJ.js";
+} from "../../../chunks/chunk-ZRONUKTW.js";
 import {
-  createReadResourceCapability,
-  createReadSkillCapability,
-  createResolveResourceCapability,
   createSharedFileSystemTools,
   createSubagentCapability
-} from "../../../chunks/chunk-BHNULR7U.js";
+} from "../../../chunks/chunk-6WD2NFIC.js";
 import "../../../chunks/chunk-A5JSJAPK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 
@@ -65,68 +62,16 @@ function subagentExtension(ctx) {
         return parentRuntimeTools.filter((tool) => tool?.name !== "spawn_subagents_parallel");
       }
       const configDir = path.join(os.homedir(), ".pie");
-      const fsOptions = ctx.yoloMode ? { allowlistedDirs: ["/"] } : { allowlistedDirs: [configDir] };
+      const fsOptions = ctx.yoloMode ? { allowlistedDirs: ["/"] } : {
+        accessRoots: [
+          ctx.cwd,
+          configDir,
+          ...skills.map((skill) => skill.baseDir).filter((entry) => entry && entry.length > 0)
+        ]
+      };
       const fsTools = createSharedFileSystemTools(ctx.cwd, fsOptions);
-      const readSkillTool = createReadSkillCapability({
-        resolveSkill(name) {
-          const skill = skills.find((entry) => entry.name === name);
-          if (!skill || !skill.filePath) {
-            return null;
-          }
-          const content = skill.content ?? fs.readFileSync(skill.filePath, "utf8");
-          return {
-            name: skill.name,
-            content,
-            resources: skill.resourceRefs
-          };
-        }
-      }).tool;
-      const readResourceTool = createReadResourceCapability({
-        resolveResource(owner, resourcePath) {
-          const skill = skills.find((entry) => entry.name === owner);
-          if (!skill) {
-            return null;
-          }
-          const trimmed = String(resourcePath || "").trim().replace(/\\/g, "/");
-          if (!trimmed || trimmed.startsWith("/") || /^[A-Za-z]:\//.test(trimmed)) {
-            return null;
-          }
-          const segments = trimmed.split("/").filter(Boolean);
-          if (segments.some((segment) => segment === "..")) {
-            return null;
-          }
-          const absolutePath = path.resolve(skill.baseDir, ...segments);
-          const relativePath = path.relative(skill.baseDir, absolutePath).replace(/\\/g, "/");
-          if (relativePath.startsWith("../") || relativePath === ".." || !fs.existsSync(absolutePath)) {
-            return null;
-          }
-          return {
-            owner: skill.name,
-            path: trimmed.replace(/^\.\/+/, ""),
-            content: fs.readFileSync(absolutePath, "utf8")
-          };
-        }
-      }).tool;
-      const resolveResourceTool = createResolveResourceCapability({
-        resolveResource(owner, resourcePath) {
-          const skill = skills.find((entry) => entry.name === owner);
-          if (!skill) return null;
-          const trimmed = String(resourcePath || "").trim().replace(/\\/g, "/");
-          if (!trimmed || trimmed.startsWith("/") || /^[A-Za-z]:\//.test(trimmed)) return null;
-          const segments = trimmed.split("/").filter(Boolean);
-          if (segments.some((segment) => segment === "..")) return null;
-          const absolutePath = path.resolve(skill.baseDir, ...segments);
-          const relativePath = path.relative(skill.baseDir, absolutePath).replace(/\\/g, "/");
-          if (relativePath.startsWith("../") || relativePath === ".." || !fs.existsSync(absolutePath)) return null;
-          return {
-            owner: skill.name,
-            path: trimmed.replace(/^\.\/+/, ""),
-            resolvedPath: absolutePath
-          };
-        }
-      }).tool;
       const cliHostCapabilities = createCliHostCapabilities(ctx.cwd);
-      return [...fsTools, readSkillTool, readResourceTool, resolveResourceTool, ...cliHostCapabilities.tools];
+      return [...fsTools, ...cliHostCapabilities.tools];
     }
   });
   for (const tool of capability.tools) {

package/dist/builtin/extensions/todo/index.js

@@ -7,7 +7,7 @@ import {
   executeManageTodoList,
   executionStateToTodos,
   restoreExecutionState
-} from "../../../chunks/chunk-BHNULR7U.js";
+} from "../../../chunks/chunk-6WD2NFIC.js";
 import "../../../chunks/chunk-A5JSJAPK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 

package/dist/builtin/skills/browser-tools/SKILL.md

@@ -5,25 +5,25 @@ description: Interactive browser automation via Microsoft Playwright CLI. Use wh
 
 # Browser Tools
 
-Use Pie's packaged Microsoft Playwright CLI wrapper. Scripts live next to this skill; use `read_resource("browser-tools", "playwright-cli.js")` or `resolve_resource("browser-tools", "playwright-cli.js")` to get the executable path.
+Use Pie's packaged Microsoft Playwright CLI wrapper. Scripts live next to this skill; resolve `playwright-cli.js` against this skill's `baseDir` and use the resulting ordinary path with `bash`.
 
 No manual dependency install is required when this skill is shipped with Pie.
 
 ## Common Commands
 
 ```bash
-node <resolvedPath for playwright-cli.js> open https://example.com
-node <resolvedPath for playwright-cli.js> goto https://example.com
-node <resolvedPath for playwright-cli.js> snapshot
-node <resolvedPath for playwright-cli.js> click "Submit"
-node <resolvedPath for playwright-cli.js> type "hello"
-node <resolvedPath for playwright-cli.js> screenshot
-node <resolvedPath for playwright-cli.js> console
-node <resolvedPath for playwright-cli.js> network
-node <resolvedPath for playwright-cli.js> close
+node <baseDir>/playwright-cli.js open https://example.com
+node <baseDir>/playwright-cli.js goto https://example.com
+node <baseDir>/playwright-cli.js snapshot
+node <baseDir>/playwright-cli.js click "Submit"
+node <baseDir>/playwright-cli.js type "hello"
+node <baseDir>/playwright-cli.js screenshot
+node <baseDir>/playwright-cli.js console
+node <baseDir>/playwright-cli.js network
+node <baseDir>/playwright-cli.js close
 ```
 
-Use `node <resolvedPath for playwright-cli.js> --help` for the full command list.
+Use `node <baseDir>/playwright-cli.js --help` for the full command list.
 
 ## Workflow
 
@@ -32,12 +32,12 @@ Start with `open` or `goto`, then use `snapshot` before interacting. Prefer snap
 If the browser is not installed, run:
 
 ```bash
-node <resolvedPath for playwright-cli.js> install-browser chromium
+node <baseDir>/playwright-cli.js install-browser chromium
 ```
 
 If a session gets stuck, use:
 
 ```bash
-node <resolvedPath for playwright-cli.js> close
-node <resolvedPath for playwright-cli.js> kill-all
+node <baseDir>/playwright-cli.js close
+node <baseDir>/playwright-cli.js kill-all
 ```