@docyrus/docyrus 0.0.31 → 0.0.33

package/server-loader.js

@@ -690,9 +690,9 @@ var init_dist = __esm({
 });
 
 // src/server/server-loader.ts
-var import_node_fs = require("node:fs");
+var import_node_fs2 = require("node:fs");
 var import_node_url = require("node:url");
-var import_node_path6 = require("node:path");
+var import_node_path7 = require("node:path");
 var import_picocolors2 = __toESM(require_picocolors());
 
 // src/agent/envStore.ts
@@ -793,11 +793,31 @@ var AgentEnvStore = class {
   }
 };
 
+// src/agent/packagedExtensions.ts
+var import_node_fs = require("node:fs");
+var import_node_path2 = require("node:path");
+var SERVER_ONLY_PACKAGED_EXTENSION_NAMES = /* @__PURE__ */ new Set(["docyrus-web-browser"]);
+function isPackagedExtensionEntry(entryName, isDirectory) {
+  return isDirectory || entryName.endsWith(".ts") || entryName.endsWith(".js");
+}
+function getPackagedExtensionName(entryName) {
+  return entryName.replace(/\.(ts|js)$/u, "");
+}
+function resolvePackagedExtensionPaths(resourceRoot, runtime = "terminal") {
+  const extensionsRoot = (0, import_node_path2.join)(resourceRoot, "extensions");
+  if (!(0, import_node_fs.existsSync)(extensionsRoot)) {
+    return [];
+  }
+  return (0, import_node_fs.readdirSync)(extensionsRoot, {
+    withFileTypes: true
+  }).filter((entry) => isPackagedExtensionEntry(entry.name, entry.isDirectory())).filter((entry) => runtime === "server" || !SERVER_ONLY_PACKAGED_EXTENSION_NAMES.has(getPackagedExtensionName(entry.name))).map((entry) => (0, import_node_path2.join)(extensionsRoot, entry.name)).sort((left, right) => left.localeCompare(right));
+}
+
 // src/server/agentServer.ts
 var import_node_child_process = require("node:child_process");
 var import_node_crypto3 = require("node:crypto");
 var import_promises5 = require("node:fs/promises");
-var import_node_path5 = require("node:path");
+var import_node_path6 = require("node:path");
 
 // ../../node_modules/.pnpm/hono@4.12.8/node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
@@ -3105,9 +3125,122 @@ function parseAskUserResponseFromToolOutput(output) {
   return normalizeAskUserResponse(output);
 }
 
+// resources/pi-agent/shared/docyrusWebBrowserProtocol.ts
+var DOCYRUS_WEB_BROWSER_TAG = "docyrus_web_browser";
+var DOCYRUS_WEB_BROWSER_OPEN = `<${DOCYRUS_WEB_BROWSER_TAG}>`;
+var DOCYRUS_WEB_BROWSER_CLOSE = `</${DOCYRUS_WEB_BROWSER_TAG}>`;
+var DOCYRUS_WEB_BROWSER_RESULT_TAG = "docyrus_web_browser_result";
+var DOCYRUS_WEB_BROWSER_RESULT_OPEN = `<${DOCYRUS_WEB_BROWSER_RESULT_TAG}>`;
+var DOCYRUS_WEB_BROWSER_RESULT_CLOSE = `</${DOCYRUS_WEB_BROWSER_RESULT_TAG}>`;
+var WEB_PREVIEW_CONTEXT_TOOL = "web_preview_context";
+var WEB_PREVIEW_PLAYWRIGHT_TOOL = "web_preview_playwright";
+var DOCYRUS_WEB_BROWSER_TOOL_NAMES = [
+  WEB_PREVIEW_CONTEXT_TOOL,
+  WEB_PREVIEW_PLAYWRIGHT_TOOL
+];
+var DOCYRUS_WEB_BROWSER_CLIENT_TOOLS = [
+  {
+    name: WEB_PREVIEW_CONTEXT_TOOL,
+    description: "Inspect the current Docyrus web preview state before automation. Prefer this first when preview availability or bridge state is unknown.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        includeSnapshot: { type: "boolean" }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: WEB_PREVIEW_PLAYWRIGHT_TOOL,
+    description: "Run Playwright-style actions against the Docyrus web preview. Prefer structured steps over raw scripts.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        script: { type: "string" },
+        steps: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              action: { type: "string" },
+              selector: { type: "string" },
+              url: { type: "string" },
+              value: { type: "string" },
+              values: {
+                type: "array",
+                items: { type: "string" }
+              },
+              key: { type: "string" },
+              attribute: { type: "string" },
+              timeoutMs: { type: "number" },
+              state: { type: "string" }
+            },
+            additionalProperties: true
+          }
+        },
+        timeoutMs: { type: "number" },
+        stopOnError: { type: "boolean" }
+      },
+      additionalProperties: true
+    }
+  }
+];
+function hashString2(value) {
+  let hash = 0;
+  for (let index = 0; index < value.length; index += 1) {
+    hash = (hash << 5) - hash + value.charCodeAt(index);
+    hash |= 0;
+  }
+  return Math.abs(hash).toString(36);
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isDocyrusWebBrowserToolName(value) {
+  return DOCYRUS_WEB_BROWSER_TOOL_NAMES.some((toolName) => toolName === value);
+}
+function normalizeDocyrusWebBrowserToolRequest(value) {
+  if (!isRecord2(value) || !isDocyrusWebBrowserToolName(value.tool)) {
+    return void 0;
+  }
+  return {
+    tool: value.tool,
+    input: isRecord2(value.input) ? value.input : void 0
+  };
+}
+function createDocyrusWebBrowserToolCallId(request) {
+  return `docyrus_web_browser_${hashString2(JSON.stringify(request))}`;
+}
+function parseDocyrusWebBrowserRequestFromText(text) {
+  const trimmed = text.trim();
+  if (!trimmed.startsWith(DOCYRUS_WEB_BROWSER_OPEN) || !trimmed.endsWith(DOCYRUS_WEB_BROWSER_CLOSE)) {
+    return void 0;
+  }
+  const body = trimmed.slice(DOCYRUS_WEB_BROWSER_OPEN.length, trimmed.length - DOCYRUS_WEB_BROWSER_CLOSE.length).trim();
+  if (!body) {
+    return void 0;
+  }
+  try {
+    return normalizeDocyrusWebBrowserToolRequest(JSON.parse(body));
+  } catch {
+    return void 0;
+  }
+}
+function formatDocyrusWebBrowserToolResponsePrompt(response) {
+  return [
+    "The docyrus-web-browser client tool returned a result.",
+    "",
+    `${DOCYRUS_WEB_BROWSER_RESULT_OPEN}`,
+    JSON.stringify(response, null, 2),
+    `${DOCYRUS_WEB_BROWSER_RESULT_CLOSE}`,
+    "",
+    "Continue the task using this result. If the tool reported an availability or bridge blocker, explain that blocker exactly and do not claim success."
+  ].join("\n");
+}
+
 // src/server/eventBridge.ts
 function createEventBridge(params) {
-  const { messageId, onChunk, onDone, onError, onAskUser } = params;
+  const { messageId, onChunk, onDone, onError, onAskUser, onDocyrusWebBrowserTool } = params;
   const activeToolCalls = /* @__PURE__ */ new Map();
   let activeTextBuffer = null;
   function flushBufferedTextToStream(close) {
@@ -3143,6 +3276,27 @@ function createEventBridge(params) {
     });
     return true;
   }
+  function maybeEmitDocyrusWebBrowserTool(text) {
+    const request = parseDocyrusWebBrowserRequestFromText(text);
+    if (!request) {
+      return false;
+    }
+    const toolCallId = createDocyrusWebBrowserToolCallId(request);
+    onDocyrusWebBrowserTool?.({ toolCallId, request });
+    onChunk({ type: "tool-input-start", toolCallId, toolName: request.tool, dynamic: true });
+    onChunk({
+      type: "tool-input-available",
+      toolCallId,
+      toolName: request.tool,
+      input: request.input ?? {},
+      dynamic: true
+    });
+    return true;
+  }
+  function shouldKeepBufferingDynamicToolText(text) {
+    const dynamicToolTags = ["<ask_user>", "<docyrus_web_browser>"];
+    return dynamicToolTags.some((tag) => tag.startsWith(text) || text.startsWith(tag));
+  }
   function handleEvent(event) {
     switch (event.type) {
       case "message_update": {
@@ -3181,7 +3335,7 @@ function createEventBridge(params) {
           break;
         }
         activeTextBuffer.text += assistantEvent.delta ?? "";
-        if ("<ask_user>".startsWith(activeTextBuffer.text) || activeTextBuffer.text.startsWith("<ask_user>")) {
+        if (shouldKeepBufferingDynamicToolText(activeTextBuffer.text)) {
           break;
         }
         flushBufferedTextToStream(false);
@@ -3197,7 +3351,7 @@ function createEventBridge(params) {
           activeTextBuffer = null;
           break;
         }
-        if (!maybeEmitAskUser(activeTextBuffer.text)) {
+        if (!maybeEmitAskUser(activeTextBuffer.text) && !maybeEmitDocyrusWebBrowserTool(activeTextBuffer.text)) {
           flushBufferedTextToStream(true);
         } else {
           activeTextBuffer = null;
@@ -3282,7 +3436,7 @@ function createEventBridge(params) {
 
 // src/agent/modelsConfig.ts
 var import_promises2 = require("node:fs/promises");
-var import_node_path2 = require("node:path");
+var import_node_path3 = require("node:path");
 function createDefaultState2() {
   return {
     providers: {}
@@ -3306,7 +3460,7 @@ async function readModelsConfig(filePath) {
   }
 }
 async function writeModelsConfig(filePath, state) {
-  const directory = (0, import_node_path2.dirname)(filePath);
+  const directory = (0, import_node_path3.dirname)(filePath);
   await (0, import_promises2.mkdir)(directory, {
     recursive: true,
     mode: 448
@@ -3361,7 +3515,7 @@ function createCustomOpenAiProviderConfig(params) {
 function createAzureProviderConfig(params) {
   const providerConfig = {
     baseUrl: params.baseUrl,
-    apiKey: "env:AZURE_OPENAI_API_KEY"
+    apiKey: "AZURE_OPENAI_API_KEY"
   };
   if (params.useCustomModel) {
     providerConfig.api = "azure-openai-responses";
@@ -3390,6 +3544,22 @@ function trimOrUndefined(value) {
   const trimmed = value?.trim();
   return trimmed && trimmed.length > 0 ? trimmed : void 0;
 }
+function normalizeAzureBaseUrl(baseUrl) {
+  const trimmed = baseUrl.trim().replace(/\/+$/, "");
+  try {
+    const url = new URL(trimmed);
+    url.search = "";
+    url.hash = "";
+    if (url.pathname.endsWith("/openai/v1")) {
+      url.pathname = url.pathname.slice(0, -3);
+    } else if (url.pathname.endsWith("/openai/responses")) {
+      url.pathname = url.pathname.slice(0, -10);
+    }
+    return url.toString().replace(/\/+$/, "");
+  } catch {
+    return trimmed.replace(/\/openai\/v1$/i, "/openai").replace(/\/openai\/responses$/i, "/openai");
+  }
+}
 async function saveGenericApiKey(params) {
   params.authStorage.set(params.providerId, {
     type: "api_key",
@@ -3416,6 +3586,7 @@ async function saveCustomOpenAiConfig(params) {
 async function saveAzureConfig(params) {
   const modelId = params.modelId.trim();
   const useCustomModel = params.useCustomModel ?? false;
+  const normalizedBaseUrl = normalizeAzureBaseUrl(params.baseUrl);
   params.authStorage.set("azure-openai-responses", {
     type: "api_key",
     key: params.apiKey.trim()
@@ -3440,7 +3611,7 @@ async function saveAzureConfig(params) {
   }
   await params.envStore.setMany(envValues);
   await upsertModelsProvider(params.modelsJsonPath, "azure-openai-responses", createAzureProviderConfig({
-    baseUrl: params.baseUrl.trim(),
+    baseUrl: normalizedBaseUrl,
     modelId,
     useCustomModel
   }));
@@ -3687,7 +3858,7 @@ function getProviderFormFields(params) {
           title: "Azure OpenAI base URL",
           required: true,
           component: "text",
-          placeholder: "https://my-resource.openai.azure.com/openai/v1",
+          placeholder: "https://my-resource.openai.azure.com/openai",
           dependsOn: { field: "configMode", equals: "base-url" }
         },
         {
@@ -3716,8 +3887,8 @@ function getProviderFormFields(params) {
           name: "apiVersion",
           title: "API version",
           component: "text",
-          defaultValue: "2025-03-01-preview",
-          placeholder: "2025-03-01-preview"
+          defaultValue: "2025-04-01-preview",
+          placeholder: "2025-04-01-preview"
         }
       ];
     case "amazon-bedrock":
@@ -3909,7 +4080,7 @@ async function applyProviderLogin(params) {
       return { providerId: provider.id, preferredModelId: params.input.modelId };
     }
     case "azure-openai-responses": {
-      const baseUrl = params.input.baseUrl ?? (params.input.resourceName ? `https://${params.input.resourceName}.openai.azure.com/openai/v1` : void 0);
+      const baseUrl = params.input.baseUrl ?? (params.input.resourceName ? `https://${params.input.resourceName}.openai.azure.com/openai` : void 0);
       if (!baseUrl) {
         throw new Error("Azure login requires either baseUrl or resourceName.");
       }
@@ -3949,9 +4120,14 @@ async function applyProviderLogin(params) {
   }
 }
 async function refreshSessionAfterCredentialChange(params) {
+  await params.envStore?.hydrateProcessEnv(process.env);
   params.modelRegistry.refresh();
   const availableModels = params.modelRegistry.getAvailable();
   const preferredModel = params.preferredProviderId && params.preferredModelId ? availableModels.find((model) => model.provider === params.preferredProviderId && model.id === params.preferredModelId) : params.preferredProviderId ? availableModels.find((model) => model.provider === params.preferredProviderId) : void 0;
+  if (preferredModel) {
+    await params.session.setModel(preferredModel);
+    return;
+  }
   const currentModel = params.session.model;
   const currentModelStillAvailable = currentModel ? availableModels.some((model) => model.provider === currentModel.provider && model.id === currentModel.id) : false;
   if (currentModel && !currentModelStillAvailable) {
@@ -4132,21 +4308,21 @@ var OAuthFlowManager = class {
 var import_node_crypto2 = require("node:crypto");
 var import_promises3 = require("node:fs/promises");
 var import_node_os = require("node:os");
-var import_node_path3 = require("node:path");
+var import_node_path4 = require("node:path");
 var PROJECT_CONFIG_NAME = ".pi/mcp.json";
 var IMPORT_PATHS = {
-  "cursor": (0, import_node_path3.join)((0, import_node_os.homedir)(), ".cursor", "mcp.json"),
-  "claude-code": (0, import_node_path3.join)((0, import_node_os.homedir)(), ".claude", "claude_desktop_config.json"),
-  "claude-desktop": (0, import_node_path3.join)((0, import_node_os.homedir)(), "Library", "Application Support", "Claude", "claude_desktop_config.json"),
-  "codex": (0, import_node_path3.join)((0, import_node_os.homedir)(), ".codex", "config.json"),
-  "windsurf": (0, import_node_path3.join)((0, import_node_os.homedir)(), ".windsurf", "mcp.json"),
+  "cursor": (0, import_node_path4.join)((0, import_node_os.homedir)(), ".cursor", "mcp.json"),
+  "claude-code": (0, import_node_path4.join)((0, import_node_os.homedir)(), ".claude", "claude_desktop_config.json"),
+  "claude-desktop": (0, import_node_path4.join)((0, import_node_os.homedir)(), "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+  "codex": (0, import_node_path4.join)((0, import_node_os.homedir)(), ".codex", "config.json"),
+  "windsurf": (0, import_node_path4.join)((0, import_node_os.homedir)(), ".windsurf", "mcp.json"),
   "vscode": ".vscode/mcp.json"
 };
 function getMcpConfigPath(agentDir) {
-  return (0, import_node_path3.join)(agentDir, "mcp.json");
+  return (0, import_node_path4.join)(agentDir, "mcp.json");
 }
 function getMcpCachePath(agentDir) {
-  return (0, import_node_path3.join)(agentDir, "mcp-cache.json");
+  return (0, import_node_path4.join)(agentDir, "mcp-cache.json");
 }
 var SERVER_NAME_REGEX = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
 function validateServerName(name) {
@@ -4283,7 +4459,7 @@ async function loadMcpServerConfig(agentDir, cwd) {
       if (!importPath) {
         continue;
       }
-      const fullPath = importPath.startsWith(".") ? (0, import_node_path3.resolve)(cwd, importPath) : importPath;
+      const fullPath = importPath.startsWith(".") ? (0, import_node_path4.resolve)(cwd, importPath) : importPath;
       const imported = await readJsonFile(fullPath);
       if (!imported) {
         continue;
@@ -4296,7 +4472,7 @@ async function loadMcpServerConfig(agentDir, cwd) {
       }
     }
   }
-  const projectPath = (0, import_node_path3.resolve)(cwd, PROJECT_CONFIG_NAME);
+  const projectPath = (0, import_node_path4.resolve)(cwd, PROJECT_CONFIG_NAME);
   if (projectPath !== configPath) {
     const projectRaw = await readJsonFile(projectPath);
     if (projectRaw) {
@@ -4380,7 +4556,7 @@ async function getServerProvenance(agentDir, cwd) {
       if (!importPath) {
         continue;
       }
-      const fullPath = importPath.startsWith(".") ? (0, import_node_path3.resolve)(cwd, importPath) : importPath;
+      const fullPath = importPath.startsWith(".") ? (0, import_node_path4.resolve)(cwd, importPath) : importPath;
       const imported = await readJsonFile(fullPath);
       if (!imported) {
         continue;
@@ -4393,7 +4569,7 @@ async function getServerProvenance(agentDir, cwd) {
       }
     }
   }
-  const projectPath = (0, import_node_path3.resolve)(cwd, PROJECT_CONFIG_NAME);
+  const projectPath = (0, import_node_path4.resolve)(cwd, PROJECT_CONFIG_NAME);
   if (projectPath !== userPath) {
     const projectRaw = await readJsonFile(projectPath);
     if (projectRaw) {
@@ -4417,7 +4593,7 @@ async function readUserConfig(agentDir) {
 }
 async function writeUserConfig(agentDir, raw2) {
   const configPath = getMcpConfigPath(agentDir);
-  await (0, import_promises3.mkdir)((0, import_node_path3.dirname)(configPath), { recursive: true });
+  await (0, import_promises3.mkdir)((0, import_node_path4.dirname)(configPath), { recursive: true });
   const tmpPath = `${configPath}.${process.pid}.tmp`;
   await (0, import_promises3.writeFile)(tmpPath, JSON.stringify(raw2, null, 2) + "\n", "utf-8");
   await (0, import_promises3.rename)(tmpPath, configPath);
@@ -4475,7 +4651,7 @@ function formatToolName(toolName, serverName, prefix) {
 
 // src/server/skillsService.ts
 var import_promises4 = require("node:fs/promises");
-var import_node_path4 = require("node:path");
+var import_node_path5 = require("node:path");
 function parseFrontmatter(content) {
   const frontmatter = {};
   if (!content.startsWith("---")) {
@@ -4509,7 +4685,7 @@ async function dirExists(path) {
   }
 }
 async function listSkills(agentDir) {
-  const skillsDir = (0, import_node_path4.join)(agentDir, "skills");
+  const skillsDir = (0, import_node_path5.join)(agentDir, "skills");
   let entries;
   try {
     entries = await (0, import_promises4.readdir)(skillsDir, { withFileTypes: true });
@@ -4521,8 +4697,8 @@ async function listSkills(agentDir) {
     if (!entry.isDirectory()) {
       continue;
     }
-    const skillDir = (0, import_node_path4.join)(skillsDir, entry.name);
-    const skillMdPath = (0, import_node_path4.join)(skillDir, "SKILL.md");
+    const skillDir = (0, import_node_path5.join)(skillsDir, entry.name);
+    const skillMdPath = (0, import_node_path5.join)(skillDir, "SKILL.md");
     let content;
     try {
       content = await (0, import_promises4.readFile)(skillMdPath, "utf-8");
@@ -4530,7 +4706,7 @@ async function listSkills(agentDir) {
       continue;
     }
     const parsed = parseFrontmatter(content);
-    const hasReferences = await dirExists((0, import_node_path4.join)(skillDir, "references"));
+    const hasReferences = await dirExists((0, import_node_path5.join)(skillDir, "references"));
     skills.push({
       name: parsed.frontmatter.name || entry.name,
       description: parsed.frontmatter.description || null,
@@ -4543,7 +4719,7 @@ async function listSkills(agentDir) {
   return skills.sort((a, b) => a.name.localeCompare(b.name));
 }
 async function getSkillDetail(agentDir, skillName) {
-  const skillsDir = (0, import_node_path4.join)(agentDir, "skills");
+  const skillsDir = (0, import_node_path5.join)(agentDir, "skills");
   let entries;
   try {
     entries = await (0, import_promises4.readdir)(skillsDir, { withFileTypes: true });
@@ -4554,8 +4730,8 @@ async function getSkillDetail(agentDir, skillName) {
     if (!entry.isDirectory()) {
       continue;
     }
-    const skillDir = (0, import_node_path4.join)(skillsDir, entry.name);
-    const skillMdPath = (0, import_node_path4.join)(skillDir, "SKILL.md");
+    const skillDir = (0, import_node_path5.join)(skillsDir, entry.name);
+    const skillMdPath = (0, import_node_path5.join)(skillDir, "SKILL.md");
     let content;
     try {
       content = await (0, import_promises4.readFile)(skillMdPath, "utf-8");
@@ -4565,7 +4741,7 @@ async function getSkillDetail(agentDir, skillName) {
     const parsed = parseFrontmatter(content);
     const fmName = parsed.frontmatter.name || entry.name;
     if (entry.name === skillName || fmName === skillName) {
-      const hasReferences = await dirExists((0, import_node_path4.join)(skillDir, "references"));
+      const hasReferences = await dirExists((0, import_node_path5.join)(skillDir, "references"));
       return {
         skill: {
           name: fmName,
@@ -4602,7 +4778,7 @@ var BUILT_IN_TOOLS = {
   ]
 };
 async function listAllTools(params) {
-  const { profile, agentDir, cwd } = params;
+  const { profile, agentDir, cwd, includeDocyrusWebBrowser } = params;
   const tools = [];
   const builtIn = BUILT_IN_TOOLS[profile] ?? BUILT_IN_TOOLS.coder;
   for (const tool of builtIn) {
@@ -4612,6 +4788,16 @@ async function listAllTools(params) {
       source: "built-in"
     });
   }
+  if (includeDocyrusWebBrowser) {
+    for (const tool of DOCYRUS_WEB_BROWSER_CLIENT_TOOLS) {
+      tools.push({
+        name: tool.name,
+        description: tool.description,
+        source: "built-in",
+        inputSchema: tool.inputSchema
+      });
+    }
+  }
   let config;
   let cache;
   try {
@@ -4661,6 +4847,13 @@ async function listAllTools(params) {
 function generateMessageId() {
   return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
 }
+function getLastAssistantMessage(messages) {
+  if (messages.length === 0) {
+    return void 0;
+  }
+  const lastMessage = messages[messages.length - 1];
+  return lastMessage.role === "assistant" ? lastMessage : void 0;
+}
 function extractLastUserText(messages) {
   if (messages.length === 0) {
     return void 0;
@@ -4677,21 +4870,58 @@ function extractLastUserText(messages) {
   return void 0;
 }
 function extractAskUserToolResponse(messages) {
-  for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex -= 1) {
-    const message = messages[messageIndex];
-    if (message.role !== "assistant") {
-      continue;
+  const message = getLastAssistantMessage(messages);
+  if (!message) {
+    return void 0;
+  }
+  for (let partIndex = message.parts.length - 1; partIndex >= 0; partIndex -= 1) {
+    const part = message.parts[partIndex];
+    if (part.type === "dynamic-tool" && part.toolName === "ask_user" && part.state === "output-available" && typeof part.toolCallId === "string") {
+      const response = parseAskUserResponseFromToolOutput(part.output);
+      if (response) {
+        return {
+          toolCallId: part.toolCallId,
+          response
+        };
+      }
     }
-    for (let partIndex = message.parts.length - 1; partIndex >= 0; partIndex -= 1) {
-      const part = message.parts[partIndex];
-      if (part.type === "dynamic-tool" && part.toolName === "ask_user" && part.state === "output-available" && typeof part.toolCallId === "string") {
-        const response = parseAskUserResponseFromToolOutput(part.output);
-        if (response) {
-          return {
-            toolCallId: part.toolCallId,
-            response
-          };
-        }
+  }
+  return void 0;
+}
+function extractDocyrusWebBrowserToolResponse(messages) {
+  const message = getLastAssistantMessage(messages);
+  if (!message) {
+    return void 0;
+  }
+  for (let partIndex = message.parts.length - 1; partIndex >= 0; partIndex -= 1) {
+    const part = message.parts[partIndex];
+    if (part.type === "dynamic-tool" && isDocyrusWebBrowserToolName(part.toolName) && typeof part.toolCallId === "string" && (part.state === "output-available" || part.state === "output-error")) {
+      const errorText = typeof part.errorText === "string" ? part.errorText : typeof part.output === "string" && part.state === "output-error" ? part.output : void 0;
+      return {
+        toolCallId: part.toolCallId,
+        toolName: part.toolName,
+        output: part.state === "output-available" ? part.output : void 0,
+        errorText,
+        isError: part.state === "output-error"
+      };
+    }
+  }
+  return void 0;
+}
+function extractDocyrusWebBrowserToolRequest(messages, toolCallId) {
+  const message = getLastAssistantMessage(messages);
+  if (!message) {
+    return void 0;
+  }
+  for (let partIndex = message.parts.length - 1; partIndex >= 0; partIndex -= 1) {
+    const part = message.parts[partIndex];
+    if (part.type === "dynamic-tool" && isDocyrusWebBrowserToolName(part.toolName) && part.toolCallId === toolCallId) {
+      const request = normalizeDocyrusWebBrowserToolRequest({
+        tool: part.toolName,
+        input: part.input
+      });
+      if (request) {
+        return request;
       }
     }
   }
@@ -4797,6 +5027,17 @@ function convertSessionEntriesToUIMessages(entries) {
             });
             continue;
           }
+          const docyrusWebBrowserRequest = parseDocyrusWebBrowserRequestFromText(block.text);
+          if (docyrusWebBrowserRequest) {
+            parts.push({
+              type: "dynamic-tool",
+              toolCallId: createDocyrusWebBrowserToolCallId(docyrusWebBrowserRequest),
+              toolName: docyrusWebBrowserRequest.tool,
+              state: "input-available",
+              input: docyrusWebBrowserRequest.input ?? {}
+            });
+            continue;
+          }
           parts.push({ type: "text", text: block.text });
         } else if (block.type === "thinking" && typeof block.thinking === "string") {
           parts.push({ type: "reasoning", text: block.thinking, state: "complete" });
@@ -4841,8 +5082,8 @@ var FS_IGNORE = /* @__PURE__ */ new Set([
   ".svelte-kit"
 ]);
 function resolveSafePath(cwd, requestPath) {
-  const resolved = (0, import_node_path5.resolve)(cwd, requestPath);
-  const normalizedCwd = cwd.endsWith(import_node_path5.sep) ? cwd : cwd + import_node_path5.sep;
+  const resolved = (0, import_node_path6.resolve)(cwd, requestPath);
+  const normalizedCwd = cwd.endsWith(import_node_path6.sep) ? cwd : cwd + import_node_path6.sep;
   if (resolved !== cwd && !resolved.startsWith(normalizedCwd)) {
     throw new Error("Path escapes working directory");
   }
@@ -4879,8 +5120,8 @@ async function buildTree(params) {
     if (ignore.has(entry.name)) {
       continue;
     }
-    const fullPath = (0, import_node_path5.join)(dir, entry.name);
-    const relativePath = (0, import_node_path5.relative)(cwd, fullPath);
+    const fullPath = (0, import_node_path6.join)(dir, entry.name);
+    const relativePath = (0, import_node_path6.relative)(cwd, fullPath);
     if (entry.isDirectory()) {
       const children = await buildTree({
         dir: fullPath,
@@ -4917,8 +5158,8 @@ async function walkFiles(params) {
     if (ignore.has(entry.name)) {
       continue;
     }
-    const fullPath = (0, import_node_path5.join)(dir, entry.name);
-    const relativePath = (0, import_node_path5.relative)(cwd, fullPath);
+    const fullPath = (0, import_node_path6.join)(dir, entry.name);
+    const relativePath = (0, import_node_path6.relative)(cwd, fullPath);
     if (entry.isDirectory()) {
       await walkFiles({ dir: fullPath, cwd, pattern, ignore, maxResults, results });
     } else if (entry.isFile() && pattern.test(relativePath)) {
@@ -4930,6 +5171,7 @@ async function createAgentServer(params) {
   const { port, sessionManager, modelRegistry, authRuntime, context, onCreateSession, onResumeSession, authToken } = params;
   let activeSession = params.session;
   const pendingAskUserRequests = /* @__PURE__ */ new Map();
+  const pendingDocyrusWebBrowserRequests = /* @__PURE__ */ new Map();
   const oauthFlowManager = new OAuthFlowManager();
   const app = new Hono2();
   function getModelIdsByProvider() {
@@ -4983,14 +5225,31 @@ async function createAgentServer(params) {
     }
     const sessionId = body.sessionId?.trim() || activeSession.id?.trim() || "active";
     const askUserResponse = extractAskUserToolResponse(messages);
+    const docyrusWebBrowserResponse = extractDocyrusWebBrowserToolResponse(messages);
     const pendingAskUser = pendingAskUserRequests.get(sessionId);
-    const userMessage = askUserResponse ? pendingAskUser && pendingAskUser.toolCallId === askUserResponse.toolCallId ? formatAskUserResponsePrompt(askUserResponse.response) : void 0 : extractLastUserText(messages);
+    const pendingDocyrusWebBrowser = pendingDocyrusWebBrowserRequests.get(sessionId);
+    const pendingDocyrusWebBrowserRequest = docyrusWebBrowserResponse ? pendingDocyrusWebBrowser?.get(docyrusWebBrowserResponse.toolCallId) ?? extractDocyrusWebBrowserToolRequest(messages, docyrusWebBrowserResponse.toolCallId) : void 0;
+    const userMessage = askUserResponse ? pendingAskUser && pendingAskUser.toolCallId === askUserResponse.toolCallId ? formatAskUserResponsePrompt(askUserResponse.response) : void 0 : docyrusWebBrowserResponse ? pendingDocyrusWebBrowserRequest ? formatDocyrusWebBrowserToolResponsePrompt({
+      tool: docyrusWebBrowserResponse.toolName,
+      request: pendingDocyrusWebBrowserRequest.input,
+      status: docyrusWebBrowserResponse.isError ? "error" : "success",
+      output: docyrusWebBrowserResponse.output,
+      errorText: docyrusWebBrowserResponse.errorText
+    }) : void 0 : extractLastUserText(messages);
     if (!userMessage) {
-      return c.json({ error: askUserResponse ? "No matching pending ask_user request found" : "No user message found" }, 400);
+      return c.json({
+        error: askUserResponse ? "No matching pending ask_user request found" : docyrusWebBrowserResponse ? "No matching pending docyrus-web-browser request found" : "No user message found"
+      }, 400);
     }
     if (askUserResponse) {
       pendingAskUserRequests.delete(sessionId);
     }
+    if (docyrusWebBrowserResponse && pendingDocyrusWebBrowser) {
+      pendingDocyrusWebBrowser.delete(docyrusWebBrowserResponse.toolCallId);
+      if (pendingDocyrusWebBrowser.size === 0) {
+        pendingDocyrusWebBrowserRequests.delete(sessionId);
+      }
+    }
     if (activeSession.isStreaming) {
       await activeSession.abort();
       await waitForIdle(activeSession);
@@ -5012,6 +5271,11 @@ async function createAgentServer(params) {
           onAskUser: ({ toolCallId, request }) => {
             pendingAskUserRequests.set(sessionId, { toolCallId, request });
           },
+          onDocyrusWebBrowserTool: ({ toolCallId, request }) => {
+            const pendingForSession = pendingDocyrusWebBrowserRequests.get(sessionId) ?? /* @__PURE__ */ new Map();
+            pendingForSession.set(toolCallId, request);
+            pendingDocyrusWebBrowserRequests.set(sessionId, pendingForSession);
+          },
           onDone: () => {
             writeChunk({ type: "finish-step" });
             writeChunk({ type: "finish" });
@@ -5194,6 +5458,7 @@ async function createAgentServer(params) {
       await refreshSessionAfterCredentialChange({
         session: activeSession,
         modelRegistry,
+        envStore: authRuntime.envStore,
         preferredProviderId: result.providerId,
         preferredModelId: result.preferredModelId
       });
@@ -5225,6 +5490,7 @@ async function createAgentServer(params) {
         await refreshSessionAfterCredentialChange({
           session: activeSession,
           modelRegistry,
+          envStore: authRuntime.envStore,
           preferredProviderId: providerId
         });
       }
@@ -5256,7 +5522,8 @@ async function createAgentServer(params) {
       modelRegistry.refresh();
       await refreshSessionAfterCredentialChange({
         session: activeSession,
-        modelRegistry
+        modelRegistry,
+        envStore: authRuntime.envStore
       });
       return c.json({
         ok: true,
@@ -5383,7 +5650,7 @@ async function createAgentServer(params) {
     }
     try {
       const resolved = resolveSafePath(context.cwd, body.path);
-      await (0, import_promises5.mkdir)((0, import_node_path5.join)(resolved, ".."), { recursive: true });
+      await (0, import_promises5.mkdir)((0, import_node_path6.join)(resolved, ".."), { recursive: true });
       await (0, import_promises5.writeFile)(resolved, body.content, "utf-8");
       const fileStat = await (0, import_promises5.stat)(resolved);
       return c.json({ ok: true, path: body.path, size: fileStat.size });
@@ -5414,7 +5681,7 @@ async function createAgentServer(params) {
     try {
       const resolvedFrom = resolveSafePath(context.cwd, body.from);
       const resolvedTo = resolveSafePath(context.cwd, body.to);
-      await (0, import_promises5.mkdir)((0, import_node_path5.join)(resolvedTo, ".."), { recursive: true });
+      await (0, import_promises5.mkdir)((0, import_node_path6.join)(resolvedTo, ".."), { recursive: true });
       await (0, import_promises5.rename)(resolvedFrom, resolvedTo);
       return c.json({ ok: true, from: body.from, to: body.to });
     } catch (error) {
@@ -5443,7 +5710,7 @@ async function createAgentServer(params) {
     }
   });
   const CLI_EXEC = process.env.DOCYRUS_CLI_EXECUTABLE || process.execPath;
-  const CLI_ENTRY = process.env.DOCYRUS_CLI_ENTRY || (0, import_node_path5.resolve)(process.argv[1] ? (0, import_node_path5.join)(process.argv[1], "..") : __dirname, "main.js");
+  const CLI_ENTRY = process.env.DOCYRUS_CLI_ENTRY || (0, import_node_path6.resolve)(process.argv[1] ? (0, import_node_path6.join)(process.argv[1], "..") : __dirname, "main.js");
   const CLI_SCOPE = process.env.DOCYRUS_CLI_SCOPE;
   const CLI_TIMEOUT_MS = 3e4;
   function runCliCommand(args) {
@@ -5493,7 +5760,7 @@ async function createAgentServer(params) {
   }
   async function detectDevPort(cwd) {
     try {
-      const pkg = JSON.parse(await (0, import_promises5.readFile)((0, import_node_path5.join)(cwd, "package.json"), "utf-8"));
+      const pkg = JSON.parse(await (0, import_promises5.readFile)((0, import_node_path6.join)(cwd, "package.json"), "utf-8"));
       const devScript = pkg.scripts?.dev;
       if (devScript) {
         const portFlag = devScript.match(/--port\s+(\d+)/);
@@ -5509,7 +5776,7 @@ async function createAgentServer(params) {
     }
     for (const name of ["vite.config.ts", "vite.config.mts", "vite.config.js"]) {
       try {
-        const content = await (0, import_promises5.readFile)((0, import_node_path5.join)(cwd, name), "utf-8");
+        const content = await (0, import_promises5.readFile)((0, import_node_path6.join)(cwd, name), "utf-8");
         const portMatch = content.match(/port\s*:\s*(\d+)/);
         if (portMatch) {
           return Number(portMatch[1]);
@@ -5519,19 +5786,19 @@ async function createAgentServer(params) {
     }
     for (const name of ["next.config.ts", "next.config.mts", "next.config.js", "next.config.mjs"]) {
       try {
-        await (0, import_promises5.stat)((0, import_node_path5.join)(cwd, name));
+        await (0, import_promises5.stat)((0, import_node_path6.join)(cwd, name));
         return 3e3;
       } catch {
       }
     }
     try {
-      await (0, import_promises5.stat)((0, import_node_path5.join)(cwd, "angular.json"));
+      await (0, import_promises5.stat)((0, import_node_path6.join)(cwd, "angular.json"));
       return 4200;
     } catch {
     }
     for (const name of ["nuxt.config.ts", "nuxt.config.js"]) {
       try {
-        await (0, import_promises5.stat)((0, import_node_path5.join)(cwd, name));
+        await (0, import_promises5.stat)((0, import_node_path6.join)(cwd, name));
         return 3e3;
       } catch {
       }
@@ -5561,14 +5828,14 @@ async function createAgentServer(params) {
     } catch {
     }
     try {
-      const pkg = JSON.parse(await (0, import_promises5.readFile)((0, import_node_path5.join)(cwd, "package.json"), "utf-8"));
+      const pkg = JSON.parse(await (0, import_promises5.readFile)((0, import_node_path6.join)(cwd, "package.json"), "utf-8"));
       packageName = pkg.name ?? null;
       packageVersion = pkg.version ?? null;
     } catch {
     }
     cachedProjectInfo = {
       path: cwd,
-      folder: (0, import_node_path5.basename)(cwd),
+      folder: (0, import_node_path6.basename)(cwd),
       repo,
       packageName,
       packageVersion
@@ -5779,7 +6046,7 @@ async function createAgentServer(params) {
         }
         if (entry.status !== "deleted") {
           try {
-            const resolved = (0, import_node_path5.resolve)(cwd, entry.path);
+            const resolved = (0, import_node_path6.resolve)(cwd, entry.path);
             const buf = await (0, import_promises5.readFile)(resolved);
             if (buf.subarray(0, 8192).includes(0)) {
               return null;
@@ -5958,7 +6225,7 @@ async function createAgentServer(params) {
   });
   app.get("/api/skills", async (c) => {
     try {
-      const skills = await listSkills(context.agentDir);
+      const skills = (await listSkills(context.agentDir)).filter((skill) => skill.name !== "docyrus-chrome-devtools-cli");
       return c.json({ skills });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -5968,6 +6235,9 @@ async function createAgentServer(params) {
   app.get("/api/skills/:skillName", async (c) => {
     const skillName = c.req.param("skillName");
     try {
+      if (skillName === "docyrus-chrome-devtools-cli") {
+        return c.json({ error: `Skill "${skillName}" not found` }, 404);
+      }
       const result = await getSkillDetail(context.agentDir, skillName);
       if (!result) {
         return c.json({ error: `Skill "${skillName}" not found` }, 404);
@@ -5983,7 +6253,8 @@ async function createAgentServer(params) {
       const tools = await listAllTools({
         profile: context.profile,
         agentDir: context.agentDir,
-        cwd: context.cwd
+        cwd: context.cwd,
+        includeDocyrusWebBrowser: true
       });
       const builtInCount = tools.filter((t) => t.source === "built-in").length;
       const mcpCount = tools.filter((t) => t.source !== "built-in").length;
@@ -6288,31 +6559,22 @@ function readLoaderRequest() {
 }
 async function loadPiExports() {
   const piPackageDir = readRequiredEnv("PI_PACKAGE_DIR");
-  const moduleUrl = (0, import_node_url.pathToFileURL)((0, import_node_path6.join)(piPackageDir, "dist", "index.js")).href;
+  const moduleUrl = (0, import_node_url.pathToFileURL)((0, import_node_path7.join)(piPackageDir, "dist", "index.js")).href;
   return await import(moduleUrl);
 }
 function resolvePackagedPiResourceRoot() {
   const candidates = [
-    (0, import_node_path6.resolve)(process.cwd(), "apps/api-cli/resources/pi-agent"),
-    (0, import_node_path6.resolve)(__dirname, "../resources/pi-agent"),
-    (0, import_node_path6.resolve)(__dirname, "resources/pi-agent"),
-    (0, import_node_path6.resolve)(process.cwd(), "dist/apps/api-cli/resources/pi-agent")
+    (0, import_node_path7.resolve)(process.cwd(), "apps/api-cli/resources/pi-agent"),
+    (0, import_node_path7.resolve)(__dirname, "../resources/pi-agent"),
+    (0, import_node_path7.resolve)(__dirname, "resources/pi-agent"),
+    (0, import_node_path7.resolve)(process.cwd(), "dist/apps/api-cli/resources/pi-agent")
   ];
-  const resolved = candidates.find((candidate) => (0, import_node_fs.existsSync)(candidate));
+  const resolved = candidates.find((candidate) => (0, import_node_fs2.existsSync)(candidate));
   if (!resolved) {
     throw new Error(`Unable to locate pi agent resources. Checked: ${candidates.join(", ")}`);
   }
   return resolved;
 }
-function resolvePackagedExtensionPaths(resourceRoot) {
-  const extensionsRoot = (0, import_node_path6.join)(resourceRoot, "extensions");
-  if (!(0, import_node_fs.existsSync)(extensionsRoot)) {
-    return [];
-  }
-  return (0, import_node_fs.readdirSync)(extensionsRoot, {
-    withFileTypes: true
-  }).filter((entry) => entry.isDirectory() || entry.isFile() && (entry.name.endsWith(".ts") || entry.name.endsWith(".js"))).map((entry) => (0, import_node_path6.join)(extensionsRoot, entry.name)).sort((left, right) => left.localeCompare(right));
-}
 function setProcessArgValue(flag, value) {
   const existingIndex = process.argv.indexOf(flag);
   if (existingIndex >= 0) {
@@ -6424,17 +6686,17 @@ async function main() {
   const agentDir = readRequiredEnv("PI_CODING_AGENT_DIR");
   const version = process.env.DOCYRUS_PI_VERSION || "dev";
   const resourceRoot = resolvePackagedPiResourceRoot();
-  const packagedExtensionPaths = resolvePackagedExtensionPaths(resourceRoot);
-  const mcpConfigPath = (0, import_node_path6.join)(agentDir, "mcp.json");
+  const packagedExtensionPaths = resolvePackagedExtensionPaths(resourceRoot, "server");
+  const mcpConfigPath = (0, import_node_path7.join)(agentDir, "mcp.json");
   const hasPackagedMcpAdapter = packagedExtensionPaths.some((extensionPath) => extensionPath.includes("pi-mcp-adapter"));
-  const envStore = new AgentEnvStore((0, import_node_path6.join)(agentDir, "env.json"));
+  const envStore = new AgentEnvStore((0, import_node_path7.join)(agentDir, "env.json"));
   await envStore.hydrateProcessEnv(process.env);
   if (hasPackagedMcpAdapter) {
     setProcessArgValue("--mcp-config", mcpConfigPath);
   }
-  const authStorage = pi.AuthStorage.create((0, import_node_path6.join)(agentDir, "auth.json"));
+  const authStorage = pi.AuthStorage.create((0, import_node_path7.join)(agentDir, "auth.json"));
   const settingsManager = pi.SettingsManager.create(cwd, agentDir);
-  const modelsJsonPath = (0, import_node_path6.join)(agentDir, "models.json");
+  const modelsJsonPath = (0, import_node_path7.join)(agentDir, "models.json");
   const modelRegistry = new pi.ModelRegistry(authStorage, modelsJsonPath);
   const quietStartup = !request.verbose;
   if (quietStartup) {
@@ -6463,7 +6725,11 @@ async function main() {
     agentDir,
     settingsManager,
     additionalExtensionPaths: packagedExtensionPaths,
-    systemPrompt: (0, import_node_path6.join)(
+    skillsOverride: ({ skills, diagnostics }) => ({
+      skills: skills.filter((skill) => skill.name !== "docyrus-chrome-devtools-cli"),
+      diagnostics
+    }),
+    systemPrompt: (0, import_node_path7.join)(
       resourceRoot,
       "prompts",
       request.profile === "agent" ? "agent-system.md" : "coder-system.md"