@docyrus/docyrus 0.0.22 → 0.0.23

package/README.md

@@ -186,6 +186,17 @@ Launch the OpenTUI terminal UI (requires Bun):
 docyrus tui
 ```
 
+Start the agent HTTP server:
+
+```bash
+docyrus server
+docyrus server --port 4000
+docyrus server --profile agent
+docyrus server --model anthropic/claude-sonnet-4-20250514 --thinking high
+```
+
+For full endpoint documentation see [docs/API.md](docs/API.md).
+
 Launch the scoped pi assistant and coding agent:
 
 ```bash
@@ -208,4 +219,5 @@ Inside the interactive agent TUI:
 ```bash
 /login   # browser or API-key provider chooser
 /logout  # remove saved provider configuration
+/architect <brief>  # discover tenant data sources and generate local planning artifacts under docs/architect/
 ```

package/main.js

@@ -18851,7 +18851,7 @@ var require_core3 = __commonJS({
       return match && match.index === 0;
     }
     var BACKREF_RE = /\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./;
-    function join7(regexps, separator = "|") {
+    function join8(regexps, separator = "|") {
       let numCaptures = 0;
       return regexps.map((regex) => {
         numCaptures += 1;
@@ -19155,7 +19155,7 @@ var require_core3 = __commonJS({
             this.exec = () => null;
           }
           const terminators = this.regexes.map((el) => el[1]);
-          this.matcherRe = langRe(join7(terminators), true);
+          this.matcherRe = langRe(join8(terminators), true);
           this.lastIndex = 0;
         }
         /** @param {string} s */
@@ -124678,7 +124678,7 @@ function buildInputSchema(args, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.22",
+  version: "0.0.23",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -124686,17 +124686,19 @@ var package_default = {
     docyrus: "main.js"
   },
   dependencies: {
-    "@mozilla/readability": "^0.6.0",
     "@clack/prompts": "^0.11.0",
-    "@modelcontextprotocol/ext-apps": "^1.2.2",
-    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@hono/node-server": "^1.14.1",
     "@mariozechner/pi-ai": "0.61.0",
     "@mariozechner/pi-coding-agent": "0.61.1",
+    "@modelcontextprotocol/ext-apps": "^1.2.2",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@mozilla/readability": "^0.6.0",
     "@opentui/core": "^0.1.85",
     "@opentui/react": "^0.1.85",
     "@xterm/headless": "^5.5.0",
     cheerio: "^1.1.2",
     diff: "^8.0.2",
+    hono: "^4.7.10",
     incur: "^0.1.6",
     jsdom: "^27.0.1",
     marked: "^15.0.12",
@@ -124872,6 +124874,41 @@ function createCoderCli(dependencies) {
   });
 }
 
+// src/commands/serverCommand.ts
+var PI_AGENT_THINKING_LEVELS2 = ["off", "minimal", "low", "medium", "high", "xhigh"];
+function hasRawVerboseFlag2() {
+  return process.argv.includes("--verbose");
+}
+function createServerCli(dependencies) {
+  return Cli_exports.create("server", {
+    description: "Start HTTP server bridging pi agent to AI SDK useChat",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      profile: external_exports.enum(["agent", "coder"]).default("coder").describe("Agent profile to use"),
+      port: external_exports.coerce.number().int().default(3111).describe("Server port"),
+      provider: external_exports.string().optional().describe("Model provider"),
+      model: external_exports.string().optional().describe("Model pattern or full provider/model id"),
+      thinking: external_exports.enum(PI_AGENT_THINKING_LEVELS2).optional().describe("Thinking level"),
+      sessionDir: external_exports.string().optional().describe("Override session storage directory"),
+      apiKey: external_exports.string().optional().describe("Temporary provider API key override for this run"),
+      verbose: external_exports.boolean().optional().describe("Enable verbose pi startup output")
+    }),
+    run: async (context) => {
+      await dependencies.launchPiAgentServer({
+        profile: context.options.profile,
+        port: context.options.port,
+        provider: context.options.provider,
+        model: context.options.model,
+        thinking: context.options.thinking,
+        sessionDir: context.options.sessionDir,
+        apiKey: context.options.apiKey,
+        verbose: context.options.verbose || hasRawVerboseFlag2() ? true : void 0
+      });
+    }
+  });
+}
+
 // src/commands/aiCommand.ts
 var import_node_crypto2 = require("node:crypto");
 
@@ -129268,6 +129305,40 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
   }
   return resolved;
 }
+function resolveDocyrusCliEntryPath(options2 = {}) {
+  const cwd = options2.cwd ?? process.cwd();
+  const dirname6 = options2.dirname ?? __dirname;
+  const argv = options2.argv ?? process.argv;
+  const fileExists = options2.existsSyncFn ?? import_node_fs5.existsSync;
+  const seen = /* @__PURE__ */ new Set();
+  const candidates = options2.candidatePaths ?? [];
+  const addCandidate = (candidate) => {
+    if (!candidate) {
+      return;
+    }
+    const resolvedCandidate = (0, import_node_path10.resolve)(candidate);
+    if (!seen.has(resolvedCandidate)) {
+      seen.add(resolvedCandidate);
+      candidates.push(resolvedCandidate);
+    }
+  };
+  const argvScript = argv[1]?.trim();
+  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path10.resolve)(cwd, argvScript) : void 0;
+  if (normalizedArgvScript && normalizedArgvScript.endsWith(".js")) {
+    addCandidate(normalizedArgvScript);
+  }
+  addCandidate((0, import_node_path10.resolve)(cwd, "dist/apps/api-cli/main.js"));
+  addCandidate((0, import_node_path10.resolve)(dirname6, "../main.js"));
+  addCandidate((0, import_node_path10.resolve)(dirname6, "main.js"));
+  if (normalizedArgvScript) {
+    addCandidate(normalizedArgvScript);
+  }
+  const resolved = candidates.find((candidate) => fileExists(candidate));
+  if (!resolved) {
+    throw new UserInputError(`Unable to locate the Docyrus CLI entry file. Checked: ${candidates.join(", ")}`);
+  }
+  return resolved;
+}
 function resolveInstalledPiPackageRootPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname6 = options2.dirname ?? __dirname;
@@ -129498,6 +129569,7 @@ function createPiAgentLauncher(options2) {
   const processExecPath = options2.processExecPath ?? process.execPath;
   const resolveResourceRoot = options2.resolvePackagedPiResourceRootFn ?? resolvePackagedPiResourceRoot;
   const resolveLoaderPath = options2.resolveDocyrusPiLoaderEntryPathFn ?? resolveDocyrusPiLoaderEntryPath;
+  const resolveCliEntryPath = options2.resolveDocyrusCliEntryPathFn ?? resolveDocyrusCliEntryPath;
   const resolvePiPackageRoot = options2.resolveInstalledPiPackageRootPathFn ?? resolveInstalledPiPackageRootPath;
   return async (request) => {
     validatePiAgentLaunchRequest({
@@ -129536,6 +129608,7 @@ function createPiAgentLauncher(options2) {
       spawnCommand
     });
     const loaderEntryPath = resolveLoaderPath({ cwd });
+    const cliEntryPath = resolveCliEntryPath({ cwd });
     const piPackageRoot = resolvePiPackageRoot({ cwd });
     const result = spawnCommand(processExecPath, [loaderEntryPath], {
       stdio: ["inherit", "inherit", "inherit"],
@@ -129546,7 +129619,10 @@ function createPiAgentLauncher(options2) {
         PI_CODING_AGENT_DIR: agentRootPath,
         PI_PACKAGE_DIR: piPackageRoot,
         DOCYRUS_PI_REQUEST: JSON.stringify(request),
-        DOCYRUS_PI_VERSION: options2.version || "dev"
+        DOCYRUS_PI_VERSION: options2.version || "dev",
+        DOCYRUS_CLI_EXECUTABLE: processExecPath,
+        DOCYRUS_CLI_ENTRY: cliEntryPath,
+        DOCYRUS_CLI_SCOPE: options2.settingsPaths.scope
       }
     });
     if (result.error) {
@@ -129560,9 +129636,141 @@ function createPiAgentLauncher(options2) {
   };
 }
 
+// src/services/piAgentServerLauncher.ts
+var import_node_child_process5 = require("node:child_process");
+var import_node_fs6 = require("node:fs");
+var import_node_path11 = require("node:path");
+var import_node_child_process6 = require("node:child_process");
+function resolveServerLoaderEntryPath(cwd, dirname6) {
+  const seen = /* @__PURE__ */ new Set();
+  const candidates = [];
+  const addCandidate = (candidate) => {
+    if (!seen.has(candidate)) {
+      seen.add(candidate);
+      candidates.push(candidate);
+    }
+  };
+  const collectAncestorCandidates = (startDir) => {
+    let currentDir = (0, import_node_path11.resolve)(startDir);
+    while (true) {
+      addCandidate((0, import_node_path11.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path11.join)(currentDir, "server-loader.js"));
+      if ((0, import_node_path11.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path11.join)(currentDir, "apps", "api-cli", "server-loader.js"));
+      }
+      const parentDir = (0, import_node_path11.resolve)(currentDir, "..");
+      if (parentDir === currentDir) {
+        break;
+      }
+      currentDir = parentDir;
+    }
+  };
+  addCandidate((0, import_node_path11.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
+  addCandidate((0, import_node_path11.resolve)(dirname6, "../server-loader.js"));
+  addCandidate((0, import_node_path11.resolve)(dirname6, "server-loader.js"));
+  collectAncestorCandidates(cwd);
+  collectAncestorCandidates(dirname6);
+  const resolved = candidates.find((candidate) => (0, import_node_fs6.existsSync)(candidate));
+  if (!resolved) {
+    throw new UserInputError(`Unable to locate Docyrus pi server loader entry file. Checked: ${candidates.join(", ")}`);
+  }
+  return resolved;
+}
+function createPiAgentServerLauncher(options2) {
+  const cwd = options2.cwd ?? process.cwd();
+  return async (request) => {
+    const activeEnvironment = await options2.environmentConfigService.getActiveEnvironment();
+    const activeProfile = await options2.authStore.getActiveProfile(activeEnvironment.apiBaseUrl);
+    const settingsRootPath = options2.settingsPaths.rootPath;
+    const agentRootPath = resolveDocyrusPiAgentRootPath(settingsRootPath);
+    const resourceRoot = resolvePackagedPiResourceRoot({ cwd });
+    await syncPackagedSkills({
+      resourceRoot,
+      agentRootPath
+    });
+    await writeRuntimeSkill({
+      agentRootPath,
+      content: createPiAgentRuntimeSkill({
+        scope: options2.settingsPaths.scope,
+        cwd,
+        activeEnvironment,
+        activeProfile,
+        settingsRootPath
+      })
+    });
+    await installExternalDocyrusSkillsOnce({
+      agentRootPath,
+      cwd,
+      scope: options2.settingsPaths.scope,
+      spawnCommand: import_node_child_process6.spawnSync
+    });
+    installPackagedDocyrusPlatformSkill({
+      resourceRoot,
+      cwd,
+      scope: options2.settingsPaths.scope,
+      spawnCommand: import_node_child_process6.spawnSync
+    });
+    const loaderEntryPath = resolveServerLoaderEntryPath(cwd, __dirname);
+    const piPackageRoot = resolveInstalledPiPackageRootPath({ cwd });
+    const child = (0, import_node_child_process5.spawn)(process.execPath, [loaderEntryPath], {
+      stdio: "inherit",
+      cwd,
+      env: {
+        ...process.env,
+        PI_CODING_AGENT_DIR: agentRootPath,
+        PI_PACKAGE_DIR: piPackageRoot,
+        DOCYRUS_PI_REQUEST: JSON.stringify(request),
+        DOCYRUS_PI_VERSION: options2.version || "dev"
+      }
+    });
+    await new Promise((resolve, reject) => {
+      child.on("error", (error48) => {
+        reject(new UserInputError(`Unable to start Docyrus pi server loader: ${error48.message}`, {
+          cause: error48
+        }));
+      });
+      child.on("exit", (code, signal) => {
+        if (code === 0 || code === null) {
+          resolve();
+        } else if (signal) {
+          reject(new UserInputError(`Docyrus pi server loader exited due to signal ${signal}.`));
+        } else {
+          reject(new UserInputError(`Docyrus pi server loader exited with code ${code}.`));
+        }
+      });
+    });
+  };
+}
+
+// src/services/stderrFilter.ts
+var INCUR_SKILLS_OUT_OF_DATE_WARNING_PATTERN = /^⚠ Skills are out of date\. Run '.* skills add' to update\.\n\n$/;
+function isIncurSkillsOutOfDateWarning(chunk) {
+  const text = typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8");
+  return INCUR_SKILLS_OUT_OF_DATE_WARNING_PATTERN.test(text);
+}
+async function runWithIncurSkillsOutOfDateWarningSuppressed(params) {
+  const stderr = params.stderr ?? process.stderr;
+  const originalWrite = stderr.write;
+  const forwardWrite = stderr.write.bind(stderr);
+  stderr.write = ((...args) => {
+    const [chunk, encodingOrCallback, callback] = args;
+    if (isIncurSkillsOutOfDateWarning(chunk)) {
+      const resolvedCallback = typeof encodingOrCallback === "function" ? encodingOrCallback : callback;
+      resolvedCallback?.();
+      return true;
+    }
+    return forwardWrite(...args);
+  });
+  try {
+    return await params.run();
+  } finally {
+    stderr.write = originalWrite;
+  }
+}
+
 // src/services/tenantOpenApi.ts
 var import_promises8 = require("node:fs/promises");
-var import_node_path11 = require("node:path");
+var import_node_path12 = require("node:path");
 function resolveSourceUrl(tenantId, template) {
   return template.replace("{tenantId}", encodeURIComponent(tenantId));
 }
@@ -129586,7 +129794,7 @@ var TenantOpenApiService = class {
   }
   async #writeOpenApiFile(tenantId, parsedContent) {
     const filePath = this.getTenantOpenApiFilePath(tenantId);
-    await (0, import_promises8.mkdir)((0, import_node_path11.dirname)(filePath), {
+    await (0, import_promises8.mkdir)((0, import_node_path12.dirname)(filePath), {
       recursive: true,
       mode: 448
     });
@@ -129632,7 +129840,7 @@ var TenantOpenApiService = class {
       throw new AuthSessionError("Tenant ID is required to resolve OpenAPI spec path.");
     }
     const rootPath = this.params?.rootPath || TENANT_OPENAPI_ROOT_PATH;
-    return (0, import_node_path11.join)(rootPath, normalizedTenantId, "openapi.json");
+    return (0, import_node_path12.join)(rootPath, normalizedTenantId, "openapi.json");
   }
   async downloadTenantOpenApi(tenantId, options2 = {}) {
     const normalizedTenantId = tenantId.trim();
@@ -129695,6 +129903,7 @@ var ROOT_HELP_COMMANDS = [
   { command: 'ai "<prompt>"', description: "Send a prompt to the default Docyrus CLI agent" },
   { command: "agent [prompt]", description: "Launch the scoped Docyrus pi assistant" },
   { command: "coder [prompt]", description: "Launch the scoped Docyrus pi coding agent" },
+  { command: "server", description: "Start HTTP server bridging pi agent to AI SDK useChat" },
   { command: "chrome start", description: "Launch Chrome with remote debugging on :9222" },
   { command: "chrome nav <url>", description: "Navigate the active Chrome tab" },
   { command: "chrome content <url>", description: "Extract readable page content as markdown" },
@@ -129731,6 +129940,13 @@ function createDocyrusCli(params) {
     cwd: params?.cwd,
     version: package_default.version
   });
+  const piAgentServerLauncher = createPiAgentServerLauncher({
+    settingsPaths,
+    environmentConfigService,
+    authStore,
+    cwd: params?.cwd,
+    version: package_default.version
+  });
   const createAuthSessionService = (apiBaseUrl) => {
     return new AuthSessionService({
       apiBaseUrl: normalizeApiBaseUrl(apiBaseUrl),
@@ -129788,6 +130004,9 @@ function createDocyrusCli(params) {
   cli2.command(createCoderCli({
     launchPiAgent: piAgentLauncher
   }));
+  cli2.command(createServerCli({
+    launchPiAgentServer: piAgentServerLauncher
+  }));
   cli2.command(createChromeCli({
     cwd: params?.cwd
   }));
@@ -129828,7 +130047,11 @@ var runtimeArgs = extractGlobalFlagFromArgv(process.argv.slice(2));
 var cli = createDocyrusCli({
   forceGlobalSettings: runtimeArgs.forceGlobal
 });
-cli.serve(runtimeArgs.argv);
+void runWithIncurSkillsOutOfDateWarningSuppressed({
+  run: async () => {
+    await cli.serve(runtimeArgs.argv);
+  }
+});
 var main_default = cli;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {