weifuwu 0.12.0 → 0.13.0

package/cli.ts

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { mkdir, writeFile, copyFile, readdir } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { join, dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const pkgRoot = resolve(__dirname, '..')
+
+async function cmdSkill() {
+  const targetDir = join(homedir(), '.agents', 'skills', 'weifuwu')
+  const docsTarget = join(targetDir, 'docs')
+
+  await mkdir(docsTarget, { recursive: true })
+  await copyFile(join(pkgRoot, 'README.md'), join(targetDir, 'SKILL.md'))
+
+  const docDir = join(pkgRoot, 'docs')
+  const entries = await readdir(docDir)
+  for (const entry of entries) {
+    if (entry.endsWith('.md')) {
+      await copyFile(join(docDir, entry), join(docsTarget, entry))
+    }
+  }
+
+  console.log('✅ Installed weifuwu skill to ~/.agents/skills/weifuwu/')
+}
+
+async function cmdInit(name: string) {
+  const targetDir = resolve(process.cwd(), name)
+  await mkdir(targetDir, { recursive: true })
+
+  await writeFile(join(targetDir, 'package.json'), JSON.stringify({
+    name,
+    type: 'module',
+    scripts: {
+      dev: 'node --watch app.ts',
+      start: 'node app.ts',
+    },
+    dependencies: {
+      weifuwu: 'latest',
+    },
+  }, null, 2) + '\n')
+
+  await writeFile(join(targetDir, 'tsconfig.json'), JSON.stringify({
+    compilerOptions: {
+      target: 'ESNext',
+      module: 'NodeNext',
+      moduleResolution: 'NodeNext',
+      strict: true,
+      jsx: 'react-jsx',
+      skipLibCheck: true,
+    },
+    include: ['*.ts'],
+  }, null, 2) + '\n')
+
+  await writeFile(join(targetDir, '.gitignore'), 'node_modules\ndist\n.env\n.sessions\n')
+
+  await writeFile(join(targetDir, '.env'), 'PORT=3000\n')
+
+  await writeFile(join(targetDir, 'app.ts'), [
+    "import { serve, loadEnv } from 'weifuwu'",
+    '',
+    "loadEnv()",
+    "const port = Number(process.env.PORT) || 3000",
+    '',
+    "serve((req, ctx) => new Response('Hello, Weifuwu!'), { port })",
+    '',
+  ].join('\n'))
+
+  console.log(`✅ Created ${name}/ — cd ${name} && npm install && npm run dev`)
+}
+
+const cmd = process.argv[2]
+
+if (cmd === 'skill') {
+  cmdSkill().catch(console.error)
+} else if (cmd === 'init') {
+  const name = process.argv[3]
+  if (!name) {
+    console.error('Usage: npx weifuwu init <name>')
+    process.exit(1)
+  }
+  cmdInit(name).catch(console.error)
+} else {
+  console.log('\nUsage:\n  npx weifuwu init <name>    Create a new weifuwu project\n  npx weifuwu skill           Install weifuwu skill to ~/.agents/skills/\n')
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+// cli.ts
+import { mkdir, writeFile, copyFile, readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var pkgRoot = resolve(__dirname, "..");
+async function cmdSkill() {
+  const targetDir = join(homedir(), ".agents", "skills", "weifuwu");
+  const docsTarget = join(targetDir, "docs");
+  await mkdir(docsTarget, { recursive: true });
+  await copyFile(join(pkgRoot, "README.md"), join(targetDir, "SKILL.md"));
+  const docDir = join(pkgRoot, "docs");
+  const entries = await readdir(docDir);
+  for (const entry of entries) {
+    if (entry.endsWith(".md")) {
+      await copyFile(join(docDir, entry), join(docsTarget, entry));
+    }
+  }
+  console.log("\u2705 Installed weifuwu skill to ~/.agents/skills/weifuwu/");
+}
+async function cmdInit(name) {
+  const targetDir = resolve(process.cwd(), name);
+  await mkdir(targetDir, { recursive: true });
+  await writeFile(join(targetDir, "package.json"), JSON.stringify({
+    name,
+    type: "module",
+    scripts: {
+      dev: "node --watch app.ts",
+      start: "node app.ts"
+    },
+    dependencies: {
+      weifuwu: "latest"
+    }
+  }, null, 2) + "\n");
+  await writeFile(join(targetDir, "tsconfig.json"), JSON.stringify({
+    compilerOptions: {
+      target: "ESNext",
+      module: "NodeNext",
+      moduleResolution: "NodeNext",
+      strict: true,
+      jsx: "react-jsx",
+      skipLibCheck: true
+    },
+    include: ["*.ts"]
+  }, null, 2) + "\n");
+  await writeFile(join(targetDir, ".gitignore"), "node_modules\ndist\n.env\n.sessions\n");
+  await writeFile(join(targetDir, ".env"), "PORT=3000\n");
+  await writeFile(join(targetDir, "app.ts"), [
+    "import { serve, loadEnv } from 'weifuwu'",
+    "",
+    "loadEnv()",
+    "const port = Number(process.env.PORT) || 3000",
+    "",
+    "serve((req, ctx) => new Response('Hello, Weifuwu!'), { port })",
+    ""
+  ].join("\n"));
+  console.log(`\u2705 Created ${name}/ \u2014 cd ${name} && npm install && npm run dev`);
+}
+var cmd = process.argv[2];
+if (cmd === "skill") {
+  cmdSkill().catch(console.error);
+} else if (cmd === "init") {
+  const name = process.argv[3];
+  if (!name) {
+    console.error("Usage: npx weifuwu init <name>");
+    process.exit(1);
+  }
+  cmdInit(name).catch(console.error);
+} else {
+  console.log("\nUsage:\n  npx weifuwu init <name>    Create a new weifuwu project\n  npx weifuwu skill           Install weifuwu skill to ~/.agents/skills/\n");
+}

package/dist/env.d.ts

@@ -0,0 +1 @@
+export declare function loadEnv(path?: string): void;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { Context, Handler, Middleware, ErrorHandler } from './types.ts';
+export { loadEnv } from './env.ts';
 export { serve, createTestServer } from './serve.ts';
 export type { ServeOptions, Server } from './serve.ts';
 export { Router } from './router.ts';

package/dist/index.js

@@ -1,3 +1,31 @@
+// env.ts
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+function loadEnv(path2) {
+  const filePath = resolve(process.cwd(), path2 ?? ".env");
+  if (!existsSync(filePath)) return;
+  const content = readFileSync(filePath, "utf-8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    if (!key) continue;
+    if (process.env[key] !== void 0) continue;
+    let value = trimmed.slice(eqIdx + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    } else {
+      const commentIdx = value.indexOf(" #");
+      if (commentIdx !== -1) {
+        value = value.slice(0, commentIdx).trimEnd();
+      }
+    }
+    process.env[key] = value;
+  }
+}
+
 // serve.ts
 import http from "node:http";
 async function readBody(req, maxSize) {
@@ -334,13 +362,13 @@ var Router = class _Router {
             const mw = match.middlewares[index++];
             return mw(innerReq, ctx2, dispatch);
           }
-          return await new Promise((resolve10) => {
+          return await new Promise((resolve11) => {
             try {
               upgradeSocket(router.wss, req, socket, head, match.handler, ctx2);
-              resolve10(new Response(null, { status: 101 }));
+              resolve11(new Response(null, { status: 101 }));
             } catch {
               socket.destroy();
-              resolve10(new Response("WebSocket upgrade failed", { status: 500 }));
+              resolve11(new Response("WebSocket upgrade failed", { status: 500 }));
             }
           });
         };
@@ -530,8 +558,8 @@ function sendHttpResponseOnSocket(socket, response) {
 import { createElement } from "react";
 import { renderToReadableStream } from "react-dom/server";
 import * as esbuild from "esbuild";
-import { readdirSync, statSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, relative, resolve, sep, dirname, basename } from "node:path";
+import { readdirSync, statSync, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
+import { join, relative, resolve as resolve2, sep, dirname, basename } from "node:path";
 import { pathToFileURL } from "node:url";
 import { createHash } from "node:crypto";
 import vm from "node:vm";
@@ -577,17 +605,17 @@ function resolveAliases() {
   if (_alias) return _alias;
   const configFiles = ["tsconfig.json", "jsconfig.json"];
   for (const file of configFiles) {
-    const p = resolve(file);
-    if (existsSync(p)) {
+    const p = resolve2(file);
+    if (existsSync2(p)) {
       try {
-        const config = JSON.parse(readFileSync(p, "utf-8"));
+        const config = JSON.parse(readFileSync2(p, "utf-8"));
         const paths = config.compilerOptions?.paths;
         if (paths) {
           const alias = {};
           for (const [key, values] of Object.entries(paths)) {
             const cleanKey = key.replace("/*", "");
             const val = values[0]?.replace("/*", "");
-            if (val) alias[cleanKey] = resolve(dirname(p), val);
+            if (val) alias[cleanKey] = resolve2(dirname(p), val);
           }
           _alias = alias;
           return alias;
@@ -639,9 +667,9 @@ function scanPages(dir) {
     const pagePath = join(current, "page.tsx");
     const tsPagePath = join(current, "page.ts");
     let entryPath = "";
-    if (existsSync(pagePath)) {
+    if (existsSync2(pagePath)) {
       entryPath = pagePath;
-    } else if (existsSync(tsPagePath)) {
+    } else if (existsSync2(tsPagePath)) {
       entryPath = tsPagePath;
     }
     if (entryPath) {
@@ -650,8 +678,8 @@ function scanPages(dir) {
       relPath = relPath.replace(/^page\.tsx?$/, "");
       const route = filePathToRoute(relPath);
       const layouts = resolveLayouts(current, dir);
-      const loadPath = existsSync(join(current, "load.ts")) ? join(current, "load.ts") : void 0;
-      const rPath = existsSync(join(current, "route.ts")) ? join(current, "route.ts") : void 0;
+      const loadPath = existsSync2(join(current, "load.ts")) ? join(current, "load.ts") : void 0;
+      const rPath = existsSync2(join(current, "route.ts")) ? join(current, "route.ts") : void 0;
       pages.push({
         route,
         entryPath,
@@ -661,7 +689,7 @@ function scanPages(dir) {
       });
     } else {
       const rPath = join(current, "route.ts");
-      if (existsSync(rPath)) {
+      if (existsSync2(rPath)) {
         let relPath = relative(dir, rPath).replace(sep, "/");
         relPath = relPath.replace(/\/route\.tsx?$/, "");
         const route = filePathToRoute(relPath);
@@ -690,7 +718,7 @@ function resolveLayouts(dir, pagesDir) {
   let current = dir;
   while (current.startsWith(pagesDir)) {
     const p = join(current, "layout.tsx");
-    if (existsSync(p)) {
+    if (existsSync2(p)) {
       layouts.push(p);
     }
     const parent = dirname(current);
@@ -750,8 +778,8 @@ var TsxInstance = class {
   clientBuildParams = /* @__PURE__ */ new Map();
   clientRouteLog = /* @__PURE__ */ new Set();
   constructor(options) {
-    this.uiDir = resolve(options.dir);
-    this.pagesDir = existsSync(join(this.uiDir, "pages")) ? join(this.uiDir, "pages") : this.uiDir;
+    this.uiDir = resolve2(options.dir);
+    this.pagesDir = existsSync2(join(this.uiDir, "pages")) ? join(this.uiDir, "pages") : this.uiDir;
     this.outDir = join(this.uiDir, ".weifuwu", "ssr");
     this.router = new Router();
   }
@@ -766,7 +794,7 @@ var TsxInstance = class {
       if (p.routePath) allFiles.add(p.routePath);
     }
     const nfPath = join(this.pagesDir, "not-found.tsx");
-    const hasNotFound = existsSync(nfPath);
+    const hasNotFound = existsSync2(nfPath);
     if (hasNotFound) {
       allFiles.add(nfPath);
       const rootLayouts = resolveLayouts(this.pagesDir, this.pagesDir);
@@ -899,14 +927,14 @@ ${body}`;
     } catch {
       return "";
     }
-    const inputFile = resolve(this.uiDir, "app.css");
-    if (!existsSync(inputFile)) {
+    const inputFile = resolve2(this.uiDir, "app.css");
+    if (!existsSync2(inputFile)) {
       mkdirSync(this.uiDir, { recursive: true });
       writeFileSync(inputFile, '@import "tailwindcss"\n', "utf-8");
       console.log("\u2139 weifuwu/tsx: created " + relative(process.cwd(), inputFile));
     }
     try {
-      let src = readFileSync(inputFile, "utf-8");
+      let src = readFileSync2(inputFile, "utf-8");
       const sourceRel = relative(this.uiDir, this.pagesDir) || ".";
       const sourcePath = sourceRel === "." ? "./" : `./${sourceRel}/`;
       src = `@source "${sourcePath}";
@@ -924,7 +952,7 @@ ${src}`;
       headers: { "content-type": "text/css; charset=utf-8" }
     }));
     if (isDev) {
-      const inputFile = resolve(this.uiDir, "app.css");
+      const inputFile = resolve2(this.uiDir, "app.css");
       chokidar.watch(inputFile, { persistent: false }).on("change", async () => {
         this.compiledTailwindCss = "";
         await this.compileTailwind();
@@ -1073,7 +1101,7 @@ ${body}`;
         timeout = null;
         const files = [...pending];
         pending.clear();
-        const exists = files.filter((f) => existsSync(f));
+        const exists = files.filter((f) => existsSync2(f));
         const allKnown = exists.every(
           (f) => this.pageModules.has(f) || this.layoutModules.has(f) || this.loadModules.has(f) || this.routeModules.has(f)
         );
@@ -1138,7 +1166,7 @@ ${body}`;
         if (p.routePath) freshFiles.add(p.routePath);
       }
       const nfPath = join(this.pagesDir, "not-found.tsx");
-      if (existsSync(nfPath)) {
+      if (existsSync2(nfPath)) {
         freshFiles.add(nfPath);
         const rootLayouts = resolveLayouts(this.pagesDir, this.pagesDir);
         for (const lp of rootLayouts) freshFiles.add(lp);
@@ -1376,9 +1404,9 @@ function auth(options) {
 // static.ts
 import { createHash as createHash2 } from "node:crypto";
 import { open, realpath } from "node:fs/promises";
-import { extname, resolve as resolve2, normalize, sep as sep2 } from "node:path";
+import { extname, resolve as resolve3, normalize, sep as sep2 } from "node:path";
 function serveStatic(root, options) {
-  const rootDir = resolve2(root);
+  const rootDir = resolve3(root);
   const opts = options ?? {};
   return async (req, ctx) => {
     const relativePath = ctx.params["*"] ?? new URL(req.url).pathname.slice(1);
@@ -1386,7 +1414,7 @@ function serveStatic(root, options) {
     if (decoded.includes("..") || decoded.includes("\0")) {
       return new Response("Forbidden", { status: 403 });
     }
-    let filePath = normalize(resolve2(rootDir, decoded));
+    let filePath = normalize(resolve3(rootDir, decoded));
     if (!filePath.startsWith(rootDir + sep2) && filePath !== rootDir) {
       return new Response("Forbidden", { status: 403 });
     }
@@ -1402,7 +1430,7 @@ function serveStatic(root, options) {
       if (stat.isDirectory()) {
         await fileHandle.close();
         const indexFile = opts.index ?? "index.html";
-        filePath = resolve2(filePath, indexFile);
+        filePath = resolve3(filePath, indexFile);
         if (!filePath.startsWith(rootDir + sep2)) {
           return new Response("Forbidden", { status: 403 });
         }
@@ -5106,14 +5134,14 @@ function forkApp(opts) {
   return { child, port: opts.port };
 }
 function stopProcess(mp, timeout = 1e4) {
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const timer = setTimeout(() => {
       mp.child.kill("SIGKILL");
-      resolve10();
+      resolve11();
     }, timeout);
     mp.child.on("exit", () => {
       clearTimeout(timer);
-      resolve10();
+      resolve11();
     });
     mp.child.kill("SIGTERM");
   });
@@ -5672,10 +5700,10 @@ function createBashTool(ctx) {
         return { stdout: "", stderr: "Command denied: potentially dangerous command", exitCode: 1 };
       }
       const cwd = workdir ? `${ctx.workspace}/${workdir}` : ctx.workspace;
-      return new Promise((resolve10) => {
+      return new Promise((resolve11) => {
         const child = exec(command, { cwd, timeout: timeout * 1e3, maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => {
           const truncated = stdout.length > 1e6 || stderr.length > 1e6;
-          resolve10({
+          resolve11({
             stdout: stdout.slice(0, 1e6),
             stderr: stderr.slice(0, 1e6),
             exitCode: error?.code ?? 0,
@@ -5691,8 +5719,8 @@ function createBashTool(ctx) {
 // opencode/tools/read.ts
 import { tool as tool3 } from "ai";
 import { z as z6 } from "zod";
-import { readFileSync as readFileSync2 } from "node:fs";
-import { resolve as resolve3 } from "node:path";
+import { readFileSync as readFileSync3 } from "node:fs";
+import { resolve as resolve4 } from "node:path";
 function createReadTool(ctx) {
   return tool3({
     description: "Read file contents. Supports offset and limit for reading specific line ranges.",
@@ -5702,11 +5730,11 @@ function createReadTool(ctx) {
       limit: z6.number().optional().describe("Number of lines to read")
     }),
     execute: async ({ path: path2, offset, limit }) => {
-      const resolved = resolve3(ctx.workspace, path2);
+      const resolved = resolve4(ctx.workspace, path2);
       if (!isPathAllowed(resolved, ctx.workspace, ctx.permissions)) {
         return { error: "Path not allowed", content: null, totalLines: 0 };
       }
-      const content = readFileSync2(resolved, "utf-8");
+      const content = readFileSync3(resolved, "utf-8");
       const lines = content.split("\n");
       const totalLines = lines.length;
       if (offset !== void 0) {
@@ -5734,7 +5762,7 @@ function createReadTool(ctx) {
 import { tool as tool4 } from "ai";
 import { z as z7 } from "zod";
 import { writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
-import { resolve as resolve4, dirname as dirname2 } from "node:path";
+import { resolve as resolve5, dirname as dirname2 } from "node:path";
 function createWriteTool(ctx) {
   return tool4({
     description: "Create or overwrite a file. Parent directories are created automatically.",
@@ -5743,7 +5771,7 @@ function createWriteTool(ctx) {
       content: z7.string().describe("File content")
     }),
     execute: async ({ path: path2, content }) => {
-      const resolved = resolve4(ctx.workspace, path2);
+      const resolved = resolve5(ctx.workspace, path2);
       if (!isPathAllowed(resolved, ctx.workspace, ctx.permissions)) {
         return { error: "Path not allowed" };
       }
@@ -5757,8 +5785,8 @@ function createWriteTool(ctx) {
 // opencode/tools/edit.ts
 import { tool as tool5 } from "ai";
 import { z as z8 } from "zod";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { resolve as resolve5 } from "node:path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { resolve as resolve6 } from "node:path";
 function createEditTool(ctx) {
   return tool5({
     description: "Perform exact string replacements in a file. If oldString appears multiple times, provide more surrounding context.",
@@ -5769,11 +5797,11 @@ function createEditTool(ctx) {
       replaceAll: z8.boolean().default(false).describe("Replace all occurrences")
     }),
     execute: async ({ path: path2, oldString, newString, replaceAll }) => {
-      const resolved = resolve5(ctx.workspace, path2);
+      const resolved = resolve6(ctx.workspace, path2);
       if (!isPathAllowed(resolved, ctx.workspace, ctx.permissions)) {
         return { error: "Path not allowed" };
       }
-      const content = readFileSync3(resolved, "utf-8");
+      const content = readFileSync4(resolved, "utf-8");
       if (replaceAll) {
         if (!content.includes(oldString)) {
           return { error: "oldString not found in file", replaced: 0 };
@@ -5802,8 +5830,8 @@ function createEditTool(ctx) {
 import { tool as tool6 } from "ai";
 import { z as z9 } from "zod";
 import { execSync as execSync2 } from "node:child_process";
-import { resolve as resolve6 } from "node:path";
-import { existsSync as existsSync2 } from "node:fs";
+import { resolve as resolve7 } from "node:path";
+import { existsSync as existsSync3 } from "node:fs";
 function createGrepTool(ctx) {
   return tool6({
     description: "Search file contents using regex. Supports file type filtering and context lines.",
@@ -5814,10 +5842,10 @@ function createGrepTool(ctx) {
       context: z9.number().default(0).describe("Number of context lines before and after each match")
     }),
     execute: async ({ pattern, include, path: path2, context }) => {
-      const searchDir = path2 ? resolve6(ctx.workspace, path2) : ctx.workspace;
+      const searchDir = path2 ? resolve7(ctx.workspace, path2) : ctx.workspace;
       const contextArg = context > 0 ? `-C ${context}` : "";
       let cmd;
-      if (existsSync2("/usr/bin/rg") || existsSync2("/usr/local/bin/rg")) {
+      if (existsSync3("/usr/bin/rg") || existsSync3("/usr/local/bin/rg")) {
         cmd = `rg -n ${contextArg} ${include ? `-g '${include}'` : ""} '${pattern.replace(/'/g, "'\\''")}' '${searchDir}'`;
       } else {
         cmd = `grep -rn ${contextArg} ${include ? `--include='${include}'` : ""} '${pattern.replace(/'/g, "'\\''")}' '${searchDir}'`;
@@ -5840,7 +5868,7 @@ function createGrepTool(ctx) {
 import { tool as tool7 } from "ai";
 import { z as z10 } from "zod";
 import { execSync as execSync3 } from "node:child_process";
-import { resolve as resolve7 } from "node:path";
+import { resolve as resolve8 } from "node:path";
 function createGlobTool(ctx) {
   return tool7({
     description: "Find files matching a glob pattern.",
@@ -5849,7 +5877,7 @@ function createGlobTool(ctx) {
       path: z10.string().optional().describe("Subdirectory relative to workspace")
     }),
     execute: async ({ pattern, path: path2 }) => {
-      const searchDir = path2 ? resolve7(ctx.workspace, path2) : ctx.workspace;
+      const searchDir = path2 ? resolve8(ctx.workspace, path2) : ctx.workspace;
       try {
         const stdout = execSync3(`find '${searchDir}' -name '${pattern.replace(/'/g, "'\\''")}' -not -path '*/node_modules/*' 2>/dev/null | head -200`, {
           timeout: 1e4,
@@ -5903,7 +5931,7 @@ function createQuestionTool(ctx) {
       options: z12.array(z12.string()).optional().describe("Optional multiple choice options")
     }),
     execute: async ({ question, options }, { toolCallId }) => {
-      return new Promise((resolve10, reject) => {
+      return new Promise((resolve11, reject) => {
         const timeout = setTimeout(() => {
           ctx.pendingQuestions.delete(toolCallId);
           reject(new Error("Question timed out"));
@@ -5911,7 +5939,7 @@ function createQuestionTool(ctx) {
         ctx.pendingQuestions.set(toolCallId, {
           resolve: (answer) => {
             clearTimeout(timeout);
-            resolve10(answer);
+            resolve11(answer);
           },
           reject: (err) => {
             clearTimeout(timeout);
@@ -6194,7 +6222,7 @@ function createWSHandler2(deps) {
 import { readFile } from "node:fs/promises";
 import { glob } from "node:fs/promises";
 import { homedir } from "node:os";
-import { resolve as resolve8 } from "node:path";
+import { resolve as resolve9 } from "node:path";
 import { parse as parseYaml } from "yaml";
 var SEARCH_DIRS = [
   (ws) => `${ws}/.opencode/skills`,
@@ -6232,7 +6260,7 @@ async function scanDir(dir) {
   try {
     const files = [];
     for await (const entry of glob("*/SKILL.md", { cwd: dir })) {
-      const skill = await parseSkillFile(resolve8(dir, entry));
+      const skill = await parseSkillFile(resolve9(dir, entry));
       if (skill) files.push(skill);
     }
     return files;
@@ -6316,17 +6344,17 @@ function health(options) {
 
 // i18n.ts
 import { readFile as readFile2 } from "node:fs/promises";
-import { existsSync as existsSync3 } from "node:fs";
-import { join as join4, resolve as resolve9 } from "node:path";
+import { existsSync as existsSync4 } from "node:fs";
+import { join as join4, resolve as resolve10 } from "node:path";
 function i18n(options) {
-  const dir = resolve9(options.dir);
+  const dir = resolve10(options.dir);
   const defaultLocale = options.defaultLocale ?? "en";
   const cache = /* @__PURE__ */ new Map();
   async function load(locale) {
     const cached = cache.get(locale);
     if (cached) return cached;
     const filePath = join4(dir, `${locale}.json`);
-    if (!existsSync3(filePath)) return {};
+    if (!existsSync4(filePath)) return {};
     try {
       const content = await readFile2(filePath, "utf-8");
       const data = JSON.parse(content);
@@ -6412,6 +6440,7 @@ export {
   graphql,
   health,
   i18n,
+  loadEnv,
   logger,
   mailer,
   messager,

package/docs/agent.md

@@ -0,0 +1,44 @@
+# AI Agent
+
+> [Home](../README.md) → AI Agent
+
+## AI Agent
+
+Server-side AI agents with OpenAI-compatible API. Built-in chat, tool-use (tool-calling), and knowledge (RAG) types. Works out of the box with Ollama or any OpenAI-compatible provider.
+
+```ts
+import { agent } from 'weifuwu'
+
+const agents = agent({ pg })
+
+await agents.migrate()
+app.use('/api', agents.router())
+```
+
+| Type | Description | Execution |
+|------|-------------|-----------|
+| `chat` | Pure conversation | `streamText()` / `generateText()` |
+| `tool-use` | Tool-calling agent | `streamText({ tools })` |
+
+### Knowledge (RAG)
+
+Add documents to any agent — `searchKnowledge` tool auto-injected:
+
+```ts
+await agents.addKnowledge(agentId, 'Title', 'Document content...')
+// The agent automatically calls searchKnowledge when answering
+```
+
+### Streaming
+
+```http
+POST /agents/:id/run  { input: "hello", stream: true }
+→ event-stream (fullStream SSE: text-delta, tool-call, tool-result, finish)
+```
+
+### Programmatic API
+
+```ts
+const result = await agents.run(agentId, { input: 'hello', stream: false })
+// { output: "Hello!", elapsed: 1234 }
+```