foliko 1.1.0 → 1.1.1

package/calc_tokens_weixin.js

@@ -0,0 +1,81 @@
+const fs = require('fs');
+
+function encode(text) {
+  if (!text || typeof text !== 'string') return 0;
+  const cleanText = text.replace(/\0+/g, '').replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '').slice(0, 100000);
+  if (!cleanText) return 0;
+  const chineseChars = (cleanText.match(/[\u4e00-\u9fff\u3400-\u4dbf]/g) || []).length;
+  const englishChars = cleanText.length - chineseChars;
+  const chineseTokens = chineseChars / 2;
+  const englishTokens = englishChars / 4;
+  return Math.ceil(chineseTokens + englishTokens);
+}
+
+const filePath = 'D:/code/vb-agent/.agent/sessions/weixin_o9cq80zgZqKPA2-s59PN43GdDy1w@im.wechat.json';
+const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+
+let totalTokens = 0;
+let totalChars = 0;
+let largeMessages = [];
+const messages = data.messages || [];
+
+for (let i = 0; i < messages.length; i++) {
+  const msg = messages[i];
+  let msgTokens = 4;
+  let msgChars = 0;
+
+  if (typeof msg.content === 'string') {
+    msgTokens += encode(msg.content);
+    msgChars += msg.content.length;
+  } else if (Array.isArray(msg.content)) {
+    for (const part of msg.content) {
+      if (!part || typeof part !== 'object') continue;
+      if (part.text) {
+        const text = String(part.text);
+        msgTokens += encode(text);
+        msgChars += text.length;
+      }
+      if (part.type === 'tool-result' && part.output) {
+        let outputText = '';
+        if (typeof part.output === 'string') {
+          outputText = part.output;
+        } else if (part.output && part.output.value) {
+          outputText = String(part.output.value);
+        } else if (part.output && part.output.html) {
+          outputText = part.output.html;
+        } else if (part.output) {
+          outputText = JSON.stringify(part.output);
+        }
+        msgTokens += encode(outputText);
+        msgChars += outputText.length;
+      }
+      if (part.type === 'tool_use' && part.input) {
+        const inputStr = JSON.stringify(part.input);
+        msgTokens += encode(inputStr);
+        msgChars += inputStr.length;
+      }
+    }
+  } else if (msg.content && typeof msg.content === 'object') {
+    try {
+      const str = JSON.stringify(msg.content);
+      msgTokens += encode(str);
+      msgChars += str.length;
+    } catch (e) {}
+  }
+
+  totalTokens += msgTokens;
+  totalChars += msgChars;
+
+  if (msgTokens > 3000) {
+    largeMessages.push({ index: i, role: msg.role, tokens: msgTokens, chars: msgChars });
+  }
+}
+
+console.log('Messages:', messages.length);
+console.log('Total chars:', totalChars);
+console.log('Total tokens (approx):', totalTokens);
+console.log('File size:', fs.statSync(filePath).size, 'bytes');
+console.log('\nLarge messages (>3000 tokens):');
+largeMessages.forEach(m => {
+  console.log(`  [${m.index}] ${m.role}: ${m.tokens} tokens, ${m.chars} chars`);
+});

package/cli/src/commands/chat.js

@@ -94,7 +94,8 @@ async function chatCommand(args) {
       baseURL: options.baseURL,
       apiKey: options.apiKey,
       providerOptions: {
-        maxOutputTokens: 8192,
+        maxOutputTokens: 16384,
+        reasoning_split: true,
       },
     },
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",

package/plugins/extension-executor-plugin.js

@@ -23,6 +23,52 @@ class ExtensionExecutorPlugin extends Plugin {
     this._extensions = new Map();
   }
 
+  /**
+   * 从 JSON Schema 构建 Zod Schema
+   * @param {Object} jsonSchema - JSON Schema 对象
+   * @returns {z.ZodObject}
+   */
+  _buildZodSchema(jsonSchema) {
+    const properties = jsonSchema.properties || {};
+    const required = jsonSchema.required || [];
+    const shape = {};
+
+    for (const [name, prop] of Object.entries(properties)) {
+      let field;
+      const isRequired = required.includes(name);
+
+      switch (prop.type) {
+        case 'string':
+          field = z.string();
+          break;
+        case 'number':
+          field = z.number();
+          break;
+        case 'boolean':
+          field = z.boolean();
+          break;
+        case 'array':
+          field = z.array(z.any());
+          break;
+        case 'object':
+          field = z.object({});
+          break;
+        default:
+          field = z.any();
+      }
+
+      if (prop.description) {
+        field = field.describe(prop.description);
+      }
+      if (!isRequired) {
+        field = field.optional();
+      }
+      shape[name] = field;
+    }
+
+    return z.object(shape);
+  }
+
   install(framework) {
     this._framework = framework;
 
@@ -142,7 +188,35 @@ class ExtensionExecutorPlugin extends Plugin {
 
         const toolDef = ext.tools.find((t) => t.name === tool);
         if (!toolDef) {
-          return { success: false, error: `扩展工具 '${tool}' 不存在` };
+          const availableTools = ext.tools.map((t) => t.name).join(', ');
+          return {
+            success: false,
+            error: `扩展工具 '${tool}' 不存在。可用工具: ${availableTools || '无'}`
+          };
+        }
+
+        // 验证参数
+        if (toolDef.inputSchema) {
+          try {
+            const schema = toolDef.inputSchema instanceof z.ZodType
+              ? toolDef.inputSchema
+              : this._buildZodSchema(toolDef.inputSchema);
+            schema.parse(toolArgs);
+          } catch (err) {
+            if (err instanceof z.ZodError) {
+              const fieldErrors = err.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join('; ');
+              return {
+                success: false,
+                error: `参数错误: ${fieldErrors}`,
+                inputSchema: toolDef.inputSchema,
+              };
+            }
+            return {
+              success: false,
+              error: `参数验证失败: ${err.message}`,
+              inputSchema: toolDef.inputSchema,
+            };
+          }
         }
 
         try {
@@ -220,7 +294,11 @@ class ExtensionExecutorPlugin extends Plugin {
 
         const toolDef = ext.tools.find((t) => t.name === tool);
         if (!toolDef) {
-          return { success: false, error: `扩展工具 '${tool}' 不存在` };
+          const availableTools = ext.tools.map((t) => t.name).join(', ');
+          return {
+            success: false,
+            error: `扩展工具 '${tool}' 不存在。可用工具: ${availableTools || '无'}`
+          };
         }
 
         return {

package/plugins/file-system-plugin.js

@@ -827,10 +827,10 @@ class FileSystemPlugin extends Plugin {
         timeout: z.number().optional().describe('超时时间(ms)，默认 30000'),
         proxy: z.boolean().optional().describe('是否使用代理，默认 false。访问失败时可自动设为 true 重试'),
         toMarkdown: z.boolean().default(true).describe('是否将 HTML 响应转换为 Markdown 格式，默认 true'),
-        maxLength: z.number().optional().describe('最大返回长度（字符数），超过则截断')
+        maxLength: z.number().default(50000).describe('最大返回长度（字符数），超过则截断，默认 50000')
       }),
       execute: async (args, framework) => {
-        const { url, method = 'GET', headers = {}, body, timeout = 30000, proxy = false, toMarkdown = true, maxLength } = args
+        const { url, method = 'GET', headers = {}, body, timeout = 30000, proxy = false, toMarkdown = true, maxLength = 50000 } = args
         try {
           const controller = new AbortController()
           const timeoutId = setTimeout(() => controller.abort(), timeout)

package/plugins/weixin-plugin.js

@@ -6,7 +6,7 @@
  * - forceLogin: 是否强制重新扫码登录
  * - qrcodeTerminal: 是否在终端渲染二维码 (默认 true)
  */
-
+const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../cli/src/utils/ansi');
 const { Plugin } = require('../src/core/plugin-base')
 const { logger } = require('../src/utils/logger')
 const log = logger.child('WeChat')
@@ -468,11 +468,14 @@ class WeixinPlugin extends Plugin {
 
     try {
       // 使用 chatStream 保持和 CLI 一致的行为
-      
       let fullResponse = '';
       for await (const chunk of agent.chatStream(text, { sessionId })) {
         if (chunk.type === 'text') {
           fullResponse += chunk.text;
+        } else if (chunk.type === 'tool-call') {
+          log.info(`[工具调用] ${chunk.toolName}`);
+        } else if (chunk.type === 'error') {
+          log.warn(' Chat stream error:', chunk.error);
         }
       }
       const response = cleanResponse(fullResponse);
@@ -516,6 +519,11 @@ class WeixinPlugin extends Plugin {
       for await (const chunk of agent.chatStream(text, { sessionId })) {
         if (chunk.type === 'text') {
           fullResponse += chunk.text;
+        } else if (chunk.type === 'tool-call') {
+          // 发送工具调用提示
+          log.info(`[工具调用] ${chunk.toolName}`);
+        } else if (chunk.type === 'error') {
+          log.warn(' Chat stream error:', chunk.error);
         }
       }
       const response = cleanResponse(fullResponse);

package/skills/find-skills/AGENTS.md

@@ -1,162 +1,162 @@
-# AGENTS.md
-
-This file provides guidance to AI coding agents working on the `skills` CLI codebase.
-
-## Project Overview
-
-`skills` is the CLI for the open agent skills ecosystem.
-
-## Commands
-
-| Command                       | Description                                         |
-| ----------------------------- | --------------------------------------------------- |
-| `skills`                      | Show banner with available commands                 |
-| `skills add <pkg>`            | Install skills from git repos, URLs, or local paths |
-| `skills experimental_install` | Restore skills from skills-lock.json                |
-| `skills experimental_sync`    | Sync skills from node_modules into agent dirs       |
-| `skills list`                 | List installed skills (alias: `ls`)                 |
-| `skills check`                | Check for available skill updates                   |
-| `skills update`               | Update all skills to latest versions                |
-| `skills init [name]`          | Create a new SKILL.md template                      |
-
-Aliases: `skills a` works for `add`. `skills i`, `skills install` (no args) restore from `skills-lock.json`. `skills ls` works for `list`. `skills experimental_install` restores from `skills-lock.json`. `skills experimental_sync` crawls `node_modules` for skills.
-
-## Architecture
-
-```
-src/
-├── cli.ts           # Main entry point, command routing, init/check/update
-├── cli.test.ts      # CLI tests
-├── add.ts           # Core add command logic
-├── add.test.ts      # Add command tests
-├── list.ts          # List installed skills command
-├── list.test.ts     # List command tests
-├── agents.ts        # Agent definitions and detection
-├── installer.ts     # Skill installation logic (symlink/copy) + listInstalledSkills
-├── skills.ts        # Skill discovery and parsing
-├── skill-lock.ts    # Global lock file management (~/.agents/.skill-lock.json)
-├── local-lock.ts    # Local lock file management (skills-lock.json, checked in)
-├── sync.ts          # Sync command - crawl node_modules for skills
-├── source-parser.ts # Parse git URLs, GitHub shorthand, local paths
-├── git.ts           # Git clone operations
-├── telemetry.ts     # Anonymous usage tracking
-├── types.ts         # TypeScript types
-├── mintlify.ts      # Mintlify skill fetching (legacy)
-├── providers/       # Remote skill providers (GitHub, HuggingFace, Mintlify)
-│   ├── index.ts
-│   ├── registry.ts
-│   ├── types.ts
-│   ├── huggingface.ts
-│   └── mintlify.ts
-├── init.test.ts     # Init command tests
-└── test-utils.ts    # Test utilities
-
-tests/
-├── sanitize-name.test.ts     # Tests for sanitizeName (path traversal prevention)
-├── skill-matching.test.ts    # Tests for filterSkills (multi-word skill name matching)
-├── source-parser.test.ts     # Tests for URL/path parsing
-├── installer-symlink.test.ts # Tests for symlink installation
-├── list-installed.test.ts    # Tests for listing installed skills
-├── skill-path.test.ts        # Tests for skill path handling
-├── wellknown-provider.test.ts # Tests for well-known provider
-└── dist.test.ts              # Tests for built distribution
-```
-
-## Update Checking System
-
-### How `skills check` and `skills update` Work
-
-1. Read `~/.agents/.skill-lock.json` for installed skills
-2. For each skill, get `skillFolderHash` from lock file
-3. POST to `https://add-skill.vercel.sh/check-updates` with:
-   ```json
-   {
-     "skills": [{ "name": "...", "source": "...", "skillFolderHash": "..." }],
-     "forceRefresh": true
-   }
-   ```
-4. API fetches fresh content from GitHub, computes hash, compares
-5. Returns list of skills with different hashes (updates available)
-
-### Why `forceRefresh: true`?
-
-Both `check` and `update` always send `forceRefresh: true`. This ensures the API fetches fresh content from GitHub rather than using its Redis cache.
-
-**Without forceRefresh:** Users saw phantom "updates available" due to stale cached hashes. The fix was to always fetch fresh.
-
-**Tradeoff:** Slightly slower (GitHub API call per skill), but always accurate.
-
-### Lock File Compatibility
-
-The lock file format is v3. Key field: `skillFolderHash` (GitHub tree SHA for the skill folder).
-
-If reading an older lock file version, it's wiped. Users must reinstall skills to populate the new format.
-
-## Key Integration Points
-
-| Feature                    | Implementation                              |
-| -------------------------- | ------------------------------------------- |
-| `skills add`               | `src/add.ts` - full implementation          |
-| `skills experimental_sync` | `src/sync.ts` - crawl node_modules          |
-| `skills check`             | `POST /check-updates` API                   |
-| `skills update`            | `POST /check-updates` + reinstall per skill |
-
-## Development
-
-```bash
-# Install dependencies
-pnpm install
-
-# Build
-pnpm build
-
-# Test locally
-pnpm dev add vercel-labs/agent-skills --list
-pnpm dev experimental_sync
-pnpm dev check
-pnpm dev update
-pnpm dev init my-skill
-
-# Run all tests
-pnpm test
-
-# Run specific test file(s)
-pnpm test tests/sanitize-name.test.ts
-pnpm test tests/skill-matching.test.ts tests/source-parser.test.ts
-
-# Type check
-pnpm type-check
-
-# Format code
-pnpm format
-```
-
-## Code Style
-
-This project uses Prettier for code formatting. **Always run `pnpm format` before committing changes** to ensure consistent formatting.
-
-```bash
-# Format all files
-pnpm format
-
-# Check formatting without fixing
-pnpm prettier --check .
-```
-
-CI will fail if code is not properly formatted.
-
-## Publishing
-
-```bash
-# 1. Bump version in package.json
-# 2. Build
-pnpm build
-# 3. Publish
-npm publish
-```
-
-## Adding a New Agent
-
-1. Add the agent definition to `src/agents.ts`
-2. Run `pnpm run -C scripts validate-agents.ts` to validate
-3. Run `pnpm run -C scripts sync-agents.ts` to update README.md
+# AGENTS.md
+
+This file provides guidance to AI coding agents working on the `skills` CLI codebase.
+
+## Project Overview
+
+`skills` is the CLI for the open agent skills ecosystem.
+
+## Commands
+
+| Command                       | Description                                         |
+| ----------------------------- | --------------------------------------------------- |
+| `skills`                      | Show banner with available commands                 |
+| `skills add <pkg>`            | Install skills from git repos, URLs, or local paths |
+| `skills experimental_install` | Restore skills from skills-lock.json                |
+| `skills experimental_sync`    | Sync skills from node_modules into agent dirs       |
+| `skills list`                 | List installed skills (alias: `ls`)                 |
+| `skills check`                | Check for available skill updates                   |
+| `skills update`               | Update all skills to latest versions                |
+| `skills init [name]`          | Create a new SKILL.md template                      |
+
+Aliases: `skills a` works for `add`. `skills i`, `skills install` (no args) restore from `skills-lock.json`. `skills ls` works for `list`. `skills experimental_install` restores from `skills-lock.json`. `skills experimental_sync` crawls `node_modules` for skills.
+
+## Architecture
+
+```
+src/
+├── cli.ts           # Main entry point, command routing, init/check/update
+├── cli.test.ts      # CLI tests
+├── add.ts           # Core add command logic
+├── add.test.ts      # Add command tests
+├── list.ts          # List installed skills command
+├── list.test.ts     # List command tests
+├── agents.ts        # Agent definitions and detection
+├── installer.ts     # Skill installation logic (symlink/copy) + listInstalledSkills
+├── skills.ts        # Skill discovery and parsing
+├── skill-lock.ts    # Global lock file management (~/.agents/.skill-lock.json)
+├── local-lock.ts    # Local lock file management (skills-lock.json, checked in)
+├── sync.ts          # Sync command - crawl node_modules for skills
+├── source-parser.ts # Parse git URLs, GitHub shorthand, local paths
+├── git.ts           # Git clone operations
+├── telemetry.ts     # Anonymous usage tracking
+├── types.ts         # TypeScript types
+├── mintlify.ts      # Mintlify skill fetching (legacy)
+├── providers/       # Remote skill providers (GitHub, HuggingFace, Mintlify)
+│   ├── index.ts
+│   ├── registry.ts
+│   ├── types.ts
+│   ├── huggingface.ts
+│   └── mintlify.ts
+├── init.test.ts     # Init command tests
+└── test-utils.ts    # Test utilities
+
+tests/
+├── sanitize-name.test.ts     # Tests for sanitizeName (path traversal prevention)
+├── skill-matching.test.ts    # Tests for filterSkills (multi-word skill name matching)
+├── source-parser.test.ts     # Tests for URL/path parsing
+├── installer-symlink.test.ts # Tests for symlink installation
+├── list-installed.test.ts    # Tests for listing installed skills
+├── skill-path.test.ts        # Tests for skill path handling
+├── wellknown-provider.test.ts # Tests for well-known provider
+└── dist.test.ts              # Tests for built distribution
+```
+
+## Update Checking System
+
+### How `skills check` and `skills update` Work
+
+1. Read `~/.agents/.skill-lock.json` for installed skills
+2. For each skill, get `skillFolderHash` from lock file
+3. POST to `https://add-skill.vercel.sh/check-updates` with:
+   ```json
+   {
+     "skills": [{ "name": "...", "source": "...", "skillFolderHash": "..." }],
+     "forceRefresh": true
+   }
+   ```
+4. API fetches fresh content from GitHub, computes hash, compares
+5. Returns list of skills with different hashes (updates available)
+
+### Why `forceRefresh: true`?
+
+Both `check` and `update` always send `forceRefresh: true`. This ensures the API fetches fresh content from GitHub rather than using its Redis cache.
+
+**Without forceRefresh:** Users saw phantom "updates available" due to stale cached hashes. The fix was to always fetch fresh.
+
+**Tradeoff:** Slightly slower (GitHub API call per skill), but always accurate.
+
+### Lock File Compatibility
+
+The lock file format is v3. Key field: `skillFolderHash` (GitHub tree SHA for the skill folder).
+
+If reading an older lock file version, it's wiped. Users must reinstall skills to populate the new format.
+
+## Key Integration Points
+
+| Feature                    | Implementation                              |
+| -------------------------- | ------------------------------------------- |
+| `skills add`               | `src/add.ts` - full implementation          |
+| `skills experimental_sync` | `src/sync.ts` - crawl node_modules          |
+| `skills check`             | `POST /check-updates` API                   |
+| `skills update`            | `POST /check-updates` + reinstall per skill |
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Test locally
+pnpm dev add vercel-labs/agent-skills --list
+pnpm dev experimental_sync
+pnpm dev check
+pnpm dev update
+pnpm dev init my-skill
+
+# Run all tests
+pnpm test
+
+# Run specific test file(s)
+pnpm test tests/sanitize-name.test.ts
+pnpm test tests/skill-matching.test.ts tests/source-parser.test.ts
+
+# Type check
+pnpm type-check
+
+# Format code
+pnpm format
+```
+
+## Code Style
+
+This project uses Prettier for code formatting. **Always run `pnpm format` before committing changes** to ensure consistent formatting.
+
+```bash
+# Format all files
+pnpm format
+
+# Check formatting without fixing
+pnpm prettier --check .
+```
+
+CI will fail if code is not properly formatted.
+
+## Publishing
+
+```bash
+# 1. Bump version in package.json
+# 2. Build
+pnpm build
+# 3. Publish
+npm publish
+```
+
+## Adding a New Agent
+
+1. Add the agent definition to `src/agents.ts`
+2. Run `pnpm run -C scripts validate-agents.ts` to validate
+3. Run `pnpm run -C scripts sync-agents.ts` to update README.md