nx-ce 0.1.0 → 0.1.1

package/README.md

@@ -1,5 +1,8 @@
 # nx-ce — Claude Engine
 
+[![npm version](https://img.shields.io/npm/v/nx-ce)](https://www.npmjs.com/package/nx-ce)
+[![CI](https://github.com/joke-lx/nx-ce/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/joke-lx/nx-ce/actions/workflows/npm-publish.yml)
+
 **nx-ce** 是一个轻量级 Node.js 适配器，封装了 `@anthropic-ai/claude-agent-sdk`。
 通过长度前缀的 JSON 协议（与 Chrome Native Messaging 格式一致）在 stdin/stdout 上暴露 SDK 接口，
 支持一次性冷启动查询与持久化服务两种运行模式。
@@ -48,6 +51,7 @@ nx-ce query "Analyze" --skill all
 | `--system-prompt <text>` | 系统提示词覆盖 / System prompt override |
 | `--resume <sessionId>` | 续接之前的会话（长对话）/ Resume a prior session |
 | `--skill <name>[,<name>...]` | 加载指定 Skill（逗号分隔，传 `all` 加载全部）/ Load specific skills |
+| `--include-metadata` | 输出中附带 skills/tools/slash_commands 信息 / Include skill/tool metadata in output |
 | `--no-persist` | 不持久化会话 / Don't persist session |
 | `--env "KEY=value,KEY2=val"` | 额外环境变量 / Extra environment variables |
 
@@ -98,6 +102,10 @@ All IPC uses the same wire format as Chrome native messaging:
 ```
 → { "prompt": "...", "model": "...", "systemPrompt": "..." }
 ← { "text": "...", "sessionId": "sess_xxx" }
+
+# 加 --include-metadata 时返回 metadata
+# With --include-metadata, response includes metadata:
+← { "text": "...", "sessionId": "sess_xxx", "metadata": { "skills": [...], "tools": [...], "slashCommands": [...] } }
 ```
 
 ### 服务（持久化）/ Serve (persistent)
@@ -111,6 +119,12 @@ All IPC uses the same wire format as Chrome native messaging:
 
 → { "type":"ping" }
 ← { "type":"pong", "sessionId":"..." }
+
+→ { "type":"getSkills" }
+← { "type":"skills", "skills":["browse",...], "tools":["Read",...], "slashCommands":[...], "agents":[...] }
+
+(首次 init 自动推送)
+← { "type":"init", "skills":[...], "tools":[...], ... }
 ```
 
 协议消息类型 / Message types:
@@ -125,6 +139,8 @@ All IPC uses the same wire format as Chrome native messaging:
 | ← | `error` | 错误消息 / Error message |
 | → | `ping` | 心跳检测 / Heartbeat |
 | ← | `pong` | 心跳回复 / Heartbeat response |
+| → | `getSkills` | Go 端按需拉取技能/工具列表 / Fetch skills/tools list |
+| ← | `init` / `skills` | 技能列表回复 / Skills metadata response |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-ce",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Claude Engine — SDK adapter layer for native messaging host. Bridges @anthropic-ai/claude-agent-sdk calls over a length-prefixed JSON protocol.",
   "type": "module",
   "main": "src/index.js",

package/src/cli.js

@@ -32,6 +32,9 @@ export function parseArgs(argv = process.argv.slice(2)) {
       if (eqIdx !== -1) {
         // --key=value 格式
         flags[arg.slice(2, eqIdx)] = arg.slice(eqIdx + 1);
+      } else if (rest[i + 1] === undefined || rest[i + 1].startsWith('--')) {
+        // --key 后面没有值，或下一个参数也是 flag → boolean flag
+        flags[arg.slice(2)] = true;
       } else {
         // --key value 格式（下一个参数作为值）
         flags[arg.slice(2)] = rest[++i] ?? true;
@@ -71,7 +74,11 @@ export async function runCli() {
         env: flags.env ? parseEnvString(flags.env) : undefined,
       });
 
-      return result;
+      // 默认只返回 text + sessionId，加 --include-metadata 才返回 metadata
+      if (flags['include-metadata']) {
+        return result;
+      }
+      return { text: result.text, sessionId: result.sessionId };
     }
 
     case 'serve': {
@@ -111,6 +118,7 @@ export async function runCli() {
     --system-prompt <text>        系统提示词覆盖
     --resume <sessionId>          续接之前的会话（长对话）
     --skill <name>[,<name>...]    加载指定 Skill（逗号分隔，传 "all" 加载全部）
+    --include-metadata            输出中附带 skills/tools/slash_commands 列表
     --no-persist                  不持久化会话
     --env "KEY=value,KEY2=val"    额外环境变量
 

package/src/query.js

@@ -22,7 +22,7 @@ import { query as agentQuery } from '@anthropic-ai/claude-agent-sdk';
  * @param {string} [options.resumeSessionId] - 恢复之前的会话
  * @param {string[]|'all'} [options.skills] - 加载哪些 Skill（数组或 'all'）
  * @param {AbortController} [options.signal] - 中止信号
- * @returns {Promise<{ text: string, sessionId: string | null }>}
+ * @returns {Promise<{ text: string, sessionId: string | null, metadata: object | null }>}
  */
 export async function runQuery(options) {
   const {
@@ -86,6 +86,7 @@ export async function runQuery(options) {
 
   let text = '';
   let sessionId = null;
+  let metadata = null;
 
   // 遍历 SDK 返回的流式消息
   for await (const message of response) {
@@ -95,9 +96,16 @@ export async function runQuery(options) {
       break;
     }
 
-    // 从初始化消息中捕获会话 ID
-    if (message.type === 'system' && message.subtype === 'init' && message.session_id) {
+    // 从 init 消息中捕获 sessionId + 技能/工具/命令 元数据
+    if (message.type === 'system' && message.subtype === 'init') {
       sessionId = message.session_id;
+      metadata = {
+        model: message.model,
+        skills: message.skills || [],
+        tools: message.tools || [],
+        slashCommands: message.slash_commands || [],
+        agents: message.agents || [],
+      };
     }
 
     // 提取助手的文本回复内容
@@ -116,5 +124,5 @@ export async function runQuery(options) {
     }
   }
 
-  return { text, sessionId };
+  return { text, sessionId, metadata };
 }

package/src/serve.js

@@ -11,6 +11,8 @@
  *   ← { "id":"...", "type":"error", "content":"..." }
  *   → { "type":"ping" }
  *   ← { "type":"pong", "sessionId":"..." }
+ *   → { "type":"getSkills" }
+ *   ← { "type":"skills", "skills":[...], "tools":[...], ... }
  */
 
 import { query as agentQuery } from '@anthropic-ai/claude-agent-sdk';
@@ -102,6 +104,8 @@ export async function startServe(options) {
   });
 
   let currentSessionId = existingState?.sessionId || null;
+  // 缓存 session 元数据，供 getSkills 按需查询
+  let sessionMetadata = null;
 
   // 持久化初始状态
   writeState(name, {
@@ -116,7 +120,7 @@ export async function startServe(options) {
   const consumerPromise = (async () => {
     try {
       for await (const message of response) {
-        // 捕获初始化消息中的会话 ID，更新持久化状态
+        // 捕获初始化消息中的会话 ID + 元数据，更新持久化状态
         if (message.type === 'system' && message.subtype === 'init' && message.session_id) {
           currentSessionId = message.session_id;
           writeState(name, {
@@ -126,6 +130,17 @@ export async function startServe(options) {
             sessionId: currentSessionId,
             model: sdkOptions.model,
           });
+          // 将技能/工具/命令列表转发给客户端 + 缓存供 getSkills 查询
+          sessionMetadata = {
+            type: 'init',
+            sessionId: currentSessionId,
+            model: message.model,
+            skills: message.skills || [],
+            tools: message.tools || [],
+            slashCommands: message.slash_commands || [],
+            agents: message.agents || [],
+          };
+          writeMessage(process.stdout, sessionMetadata);
         }
 
         // 助手消息 → 区分为 text / tool_use / thinking 块写入 stdout
@@ -199,6 +214,16 @@ export async function startServe(options) {
       } else if (req.type === 'ping') {
         // ping/pong 心跳
         writeMessage(process.stdout, { type: 'pong', sessionId: currentSessionId });
+      } else if (req.type === 'getSkills') {
+        // Go 端主动拉取 skill/工具/命令 列表（可重复查询）
+        writeMessage(process.stdout, sessionMetadata || {
+          type: 'skills',
+          skills: [],
+          tools: [],
+          slashCommands: [],
+          agents: [],
+          note: 'session not yet initialized',
+        });
       }
     }
   } finally {