@bowenqt/qiniu-ai-sdk 0.47.0 → 0.49.2

package/README.md

@@ -34,12 +34,13 @@
 - 🏭 **createAgent** — Reusable agent factory with configurable behaviors
 
 ### Advanced Capabilities
+- 🧭 **Capability Registry** — Query model capabilities and module maturity from the SDK
 - 📋 **Skills Injection** — Markdown-based agent knowledge (Claude Skills compatible)
 - 🏪 **Skill Marketplace** — Remote skill loading with SHA256 integrity verification (v0.32.0+)
 - 🔐 **Security Hardening** — Atomic remote install, cumulative size limits, deny-first tool policy (v0.38.0+)
 - ⚡ **MCP Tool Policy** — SDK-native timeout, progress reset, output truncation per server (v0.38.0+)
 - 🔗 **MCP Host** — `NodeMCPHost` with stdio + HTTP transport + per-server tool policies
-- 🖥️ **MCP Server** — Built-in Qiniu MCP server for OCR/Censor/Vframe tools
+- 🖥️ **MCP Server** — Built-in Qiniu MCP server for chat, OCR, image/video censor, and image generation
 - 💾 **Checkpointer** — State persistence (Memory, Redis, PostgreSQL, Kodo)
 - 🧠 **Memory Manager** — Short-term + long-term memory with LLM summarization
 - ✅ **Tool Approval (HITL)** — Human-in-the-loop with deny-first source policy (v0.38.0+)
@@ -57,19 +58,119 @@
 npm install @bowenqt/qiniu-ai-sdk
 ```
 
-### Recommended Imports
+### Choose Your Entry
 
-```typescript
-import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
-import { createAgent, generateText } from '@bowenqt/qiniu-ai-sdk/core';
-import { createNodeQiniuAI, NodeMCPHost, FileTokenStore } from '@bowenqt/qiniu-ai-sdk/node';
-```
+| I want to... | Use |
+|--------------|-----|
+| Call Qiniu cloud APIs directly | `@bowenqt/qiniu-ai-sdk/qiniu` |
+| Build agent/runtime workflows | `@bowenqt/qiniu-ai-sdk/qiniu` + `@bowenqt/qiniu-ai-sdk/core` |
+| Add MCP, sandbox, skills, or non-memory checkpointers | `@bowenqt/qiniu-ai-sdk/qiniu` + `@bowenqt/qiniu-ai-sdk/core` + `@bowenqt/qiniu-ai-sdk/node` |
 
 ### Entry Guarantees
 
 - `@bowenqt/qiniu-ai-sdk/node` is the only supported Node integration surface for MCP, sandbox, audit sinks, and non-memory checkpointers.
 - `@bowenqt/qiniu-ai-sdk/core` and `@bowenqt/qiniu-ai-sdk/browser` are kept free of Node-only transitive dependencies.
-- `ResponseAPI` remains experimental and provider-specific; use `QiniuAI#response` or import it from `@bowenqt/qiniu-ai-sdk/qiniu`, not from the root entry.
+- `ResponseAPI` is promoted to beta for the core subset only: `create`, `followUp`, `createTextResult`, and `followUpTextResult`; the stronger evidence-backed beta basis only applies when fresh nightly `response-api` evidence is present.
+- Other `ResponseAPI` helpers remain deferred/provider-only in this phase, including stream, JSON/messages, reasoning, and chat-completion projection helpers. The recommended access path for that deferred surface is `client.response.experimental.*`; legacy direct helper methods remain compatibility aliases and are not part of the official beta surface.
+- `NodeMCPHost` remains `beta (held)`; it only forwards already-resolved bearer tokens via `token` or `tokenProvider`, and the remaining deferred risks are OAuth token acquisition beyond that boundary plus cross-server routing.
+- The current management surface is intentionally narrow: `client.account` is limited to `usage()`, and `client.admin` is limited to API key CRUD (`createKeys`, `listKeys`, `getKey`, `revokeKey`), not quota/billing/project/tenant administration.
+- The runtime story smoke in this branch is intentionally local-first: it validates `createAgent` plus session/checkpointer, approval resume, and MCP host composition, while leaving the final runtime/node contract to the dedicated lane workers.
+- The root entry remains a compatibility surface, not the recommended teaching surface for new projects.
+
+```typescript
+const text = await client.response.createTextResult({
+  model: 'openai/gpt-5',
+  input: 'Summarize the request.',
+});
+
+const json = await client.response.experimental.createJson({
+  model: 'openai/gpt-5',
+  input: 'Return {"ok":true}.',
+});
+```
+
+### Cloud API Quickstart
+
+```typescript
+import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
+
+const client = new QiniuAI({
+  apiKey: process.env.QINIU_API_KEY || '',
+});
+
+const result = await client.chat.create({
+  model: 'gemini-2.5-flash',
+  messages: [{ role: 'user', content: 'Introduce Qiniu AI SDK in one sentence.' }],
+});
+
+console.log(result.choices[0]?.message?.content ?? '');
+```
+
+### Agent Quickstart
+
+```typescript
+import { z } from 'zod';
+import { zodToJsonSchema } from '@bowenqt/qiniu-ai-sdk/ai-tools';
+import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
+import { generateText } from '@bowenqt/qiniu-ai-sdk/core';
+
+const calculatorSchema = z.object({ a: z.number(), b: z.number() });
+
+const client = new QiniuAI({
+  apiKey: process.env.QINIU_API_KEY || '',
+});
+
+const result = await generateText({
+  client,
+  model: 'gemini-2.5-flash',
+  prompt: 'What is 42 multiplied by 17?',
+  tools: {
+    calculator: {
+      description: 'Perform arithmetic',
+      parameters: zodToJsonSchema(calculatorSchema),
+      execute: async (args) => {
+        const { a, b } = calculatorSchema.parse(args);
+        return a * b;
+      },
+    },
+  },
+});
+
+console.log(result.text);
+```
+
+### Node Agent Quickstart
+
+```typescript
+import { z } from 'zod';
+import { zodToJsonSchema } from '@bowenqt/qiniu-ai-sdk/ai-tools';
+import { createAgent } from '@bowenqt/qiniu-ai-sdk/core';
+import { createNodeQiniuAI } from '@bowenqt/qiniu-ai-sdk/node';
+
+const nowSchema = z.object({});
+
+const client = createNodeQiniuAI({
+  apiKey: process.env.QINIU_API_KEY || '',
+});
+
+const agent = createAgent({
+  client,
+  model: 'gemini-2.5-flash',
+  tools: {
+    now: {
+      description: 'Return the current ISO timestamp',
+      parameters: zodToJsonSchema(nowSchema),
+      execute: async () => ({ now: new Date().toISOString() }),
+    },
+  },
+});
+
+const result = await agent.run({
+  prompt: 'Use the now tool, then explain why ISO timestamps are useful.',
+});
+
+console.log(result.text);
+```
 
 ### v0.46 Migration
 
@@ -113,6 +214,45 @@ npm install ioredis
 npm install pg
 ```
 
+### Capability Metadata
+
+```typescript
+import {
+  getModelCapabilities,
+  getModuleMaturity,
+  listModels,
+} from '@bowenqt/qiniu-ai-sdk/qiniu';
+
+const featuredChatModels = listModels({ type: 'chat' }).slice(0, 3);
+const responseApi = getModuleMaturity('ResponseAPI');
+const gemini = getModelCapabilities('gemini-2.5-flash');
+
+console.log(featuredChatModels.map((model) => model.id));
+console.log(responseApi?.maturity); // beta
+console.log(gemini?.capabilities);
+```
+
+### Worktree Delivery
+
+```bash
+# Create the integration worktree and default .worktrees/ layout
+qiniu-ai worktree init
+
+# Spawn a lane from codex/vnext-integration
+qiniu-ai worktree spawn --lane foundation
+
+# Inspect current worktrees and inferred lanes
+qiniu-ai worktree status
+
+# Merge a lane back into the integration branch
+qiniu-ai worktree integrate --lane foundation
+
+# Run the default live probe for a lane
+qiniu-ai verify live --lane runtime
+```
+
+Use worktree lanes for broad SDK upgrades. Keep the root workspace focused on orchestration and integration, and let each lane own a single subsystem group.
+
 ### Kodo Audit Sink
 
 ```typescript
@@ -130,36 +270,6 @@ const logger = auditLogger({
 });
 ```
 
----
-
-## 🚀 Quick Start
-
-```typescript
-import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
-
-const client = new QiniuAI({
-  apiKey: 'Sk-xxxxxxxxxxxxxxxx',
-});
-
-// Chat completion
-const chat = await client.chat.create({
-  model: 'gemini-2.5-flash',
-  messages: [{ role: 'user', content: 'Hello!' }],
-});
-console.log(chat.choices[0].message.content);
-
-// Streaming chat
-const stream = await client.chat.createStream({
-  model: 'gemini-2.5-flash',
-  messages: [{ role: 'user', content: 'Explain AI briefly' }],
-});
-for await (const chunk of stream) {
-  process.stdout.write(chunk.choices[0]?.delta?.content || '');
-}
-```
-
----
-
 ## 🤖 Agentic Usage
 
 ### Tool Execution with generateText
@@ -241,6 +351,7 @@ const videoTask = await client.video.create({
 });
 const videoResult = await client.video.waitForCompletion(videoTask.id);
 console.log(videoResult.task_result?.videos[0].url);
+// videoTask.cancel() currently rejects explicitly because remote media-task cancellation is unsupported
 
 // viduq video generation (v0.36.0+)
 const viduqTask = await client.video.create({
@@ -251,6 +362,7 @@ const viduqTask = await client.video.create({
 // Use full handle for reliable polling
 const viduqResult = await client.video.waitForCompletion(viduqTask);
 console.log(viduqResult.task_result?.videos[0].url);
+// Use AbortSignal to stop local waiting; viduqTask.cancel() still fails fast today
 
 // kling-image-o1 high-quality image (v0.36.0+)
 const klingImg = await client.image.generate({
@@ -485,8 +597,27 @@ await instance.kill();
 
 ## 🛠️ CLI Tools
 
+### Project Setup
+
+```bash
+npx qiniu-ai init --template chat
+npx qiniu-ai init --template agent
+npx qiniu-ai init --template node-agent
+npx qiniu-ai doctor --template agent
+```
+
 ### MCP Server
 
+The built-in `QiniuMCPServer` currently exposes these built-in tools:
+
+- `qiniu_chat`
+- `qiniu_ocr`
+- `qiniu_image_censor`
+- `qiniu_video_censor`
+- `qiniu_image_generate`
+
+It does not currently expose `qiniu_vframe`. If you need frame extraction, use the SDK's `@bowenqt/qiniu-ai-sdk/ai-tools` / `QINIU_TOOLS` or asset resolver surface directly.
+
 ```bash
 npx qiniu-mcp-server
 ```
@@ -494,6 +625,7 @@ npx qiniu-mcp-server
 ### Skill Manager (v0.39.0+)
 
 ```bash
+npx qiniu-ai doctor --template node-agent  # Validate env, peers, and import choices
 npx qiniu-ai skill list          # List installed skills
 npx qiniu-ai skill add <url>     # Install a remote skill from manifest URL
 npx qiniu-ai skill add <url> --sha256 <hash>  # With integrity verification
@@ -503,8 +635,7 @@ npx qiniu-ai skill remove <name>  # Remove skill + lockfile entry
 ```
 
 **Environment variables:**
-- `QINIU_API_KEY` — API key for OCR/Censor operations
-- `QINIU_ACCESS_KEY` / `QINIU_SECRET_KEY` — For Vframe/signed operations
+- `QINIU_API_KEY` — Required API key for the built-in MCP server tools listed above
 
 ---
 

package/README.zh-CN.md

@@ -34,12 +34,13 @@
 - 🏭 **createAgent** — 可复用的 Agent 工厂
 
 ### 高级能力
+- 🧭 **能力注册表** — 通过 SDK 查询模型能力和模块成熟度
 - 📋 **技能注入** — Markdown 格式的 Agent 知识库（兼容 Claude Skills）
 - 🏪 **Skill 市场** — 远程技能加载 + SHA256 完整性验证 (v0.32.0+)
 - 🔐 **安全加固** — 原子远程安装、累计大小限制、deny-first 工具策略 (v0.38.0+)
 - ⚡ **MCP 工具策略** — SDK 原生 timeout、进度重置、输出截断，按服务器配置 (v0.38.0+)
 - 🔗 **MCP Host** — `NodeMCPHost` 支持 stdio + HTTP 传输 + 按服务器工具策略
-- 🖥️ **MCP 服务端** — 内置七牛 MCP Server（OCR/审核/抽帧）
+- 🖥️ **MCP 服务端** — 内置七牛 MCP Server（对话、OCR、图片/视频审核、图片生成）
 - 💾 **Checkpointer** — 状态持久化（Memory、Redis、PostgreSQL、Kodo）
 - 🧠 **Memory Manager** — 短期 + 长期记忆，LLM 自动摘要
 - ✅ **工具审批 (HITL)** — 敏感操作人工确认 + deny-first 来源策略 (v0.38.0+)
@@ -57,19 +58,119 @@
 npm install @bowenqt/qiniu-ai-sdk
 ```
 
-### 推荐导入方式
+### 如何选择入口
 
-```typescript
-import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
-import { createAgent, generateText } from '@bowenqt/qiniu-ai-sdk/core';
-import { createNodeQiniuAI, NodeMCPHost, FileTokenStore } from '@bowenqt/qiniu-ai-sdk/node';
-```
+| 我想做什么 | 使用哪个入口 |
+|------------|--------------|
+| 直接调用七牛云 API | `@bowenqt/qiniu-ai-sdk/qiniu` |
+| 构建 agent/runtime 工作流 | `@bowenqt/qiniu-ai-sdk/qiniu` + `@bowenqt/qiniu-ai-sdk/core` |
+| 接入 MCP、sandbox、skills 或非内存 checkpointer | `@bowenqt/qiniu-ai-sdk/qiniu` + `@bowenqt/qiniu-ai-sdk/core` + `@bowenqt/qiniu-ai-sdk/node` |
 
 ### 入口契约
 
 - `@bowenqt/qiniu-ai-sdk/node` 是 MCP、sandbox、audit sink 以及非内存 checkpointer 的唯一正式 Node integration 入口。
 - `@bowenqt/qiniu-ai-sdk/core` 和 `@bowenqt/qiniu-ai-sdk/browser` 保持不含 Node-only 传递依赖。
-- `ResponseAPI` 继续保持 experimental/provider-only；推荐使用 `QiniuAI#response` 或从 `@bowenqt/qiniu-ai-sdk/qiniu` 导入，不再从 root 入口导入。
+- `ResponseAPI` 仅核心子集晋级为 beta：`create`、`followUp`、`createTextResult`、`followUpTextResult`；只有在存在 fresh nightly `response-api` 证据时，才会启用更强的 evidence-backed beta 结论。
+- 其余 `ResponseAPI` helpers 仍处于 deferred/provider-only（包括 stream、JSON/messages、reasoning、chat-completion projection）。推荐通过 `client.response.experimental.*` 访问这部分 deferred surface；旧的直接 helper 仍保留为兼容别名，但不属于官方 beta surface。
+- `NodeMCPHost` 仍为 `beta (held)`；当前只负责透传已经解析好的 bearer token（`token` / `tokenProvider`），剩余 deferred risks 为超出该边界的 OAuth token acquisition 与 cross-server routing。
+- 当前管理面有意保持很窄：`client.account` 只有 `usage()`，`client.admin` 只覆盖 API key CRUD（`createKeys`、`listKeys`、`getKey`、`revokeKey`），并不代表 quota/billing/project/tenant 一类更大的管理平台能力。
+- 本分支的 runtime story smoke 保持本地优先：只验证 `createAgent` + session/checkpointer、approval resume、MCP host 组合，最终 runtime/node contract 仍由对应 lane worker 收敛。
+- root 入口继续保留兼容性，但不再作为新项目的默认教学入口。
+
+```typescript
+const text = await client.response.createTextResult({
+  model: 'openai/gpt-5',
+  input: '请总结这个请求。',
+});
+
+const json = await client.response.experimental.createJson({
+  model: 'openai/gpt-5',
+  input: '返回 {"ok":true}。',
+});
+```
+
+### Cloud API Quickstart
+
+```typescript
+import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
+
+const client = new QiniuAI({
+  apiKey: process.env.QINIU_API_KEY || '',
+});
+
+const result = await client.chat.create({
+  model: 'gemini-2.5-flash',
+  messages: [{ role: 'user', content: '用一句话介绍七牛 AI SDK。' }],
+});
+
+console.log(result.choices[0]?.message?.content ?? '');
+```
+
+### Agent Quickstart
+
+```typescript
+import { z } from 'zod';
+import { zodToJsonSchema } from '@bowenqt/qiniu-ai-sdk/ai-tools';
+import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
+import { generateText } from '@bowenqt/qiniu-ai-sdk/core';
+
+const calculatorSchema = z.object({ a: z.number(), b: z.number() });
+
+const client = new QiniuAI({
+  apiKey: process.env.QINIU_API_KEY || '',
+});
+
+const result = await generateText({
+  client,
+  model: 'gemini-2.5-flash',
+  prompt: '42 乘以 17 等于多少？',
+  tools: {
+    calculator: {
+      description: '做乘法计算',
+      parameters: zodToJsonSchema(calculatorSchema),
+      execute: async (args) => {
+        const { a, b } = calculatorSchema.parse(args);
+        return a * b;
+      },
+    },
+  },
+});
+
+console.log(result.text);
+```
+
+### Node Agent Quickstart
+
+```typescript
+import { z } from 'zod';
+import { zodToJsonSchema } from '@bowenqt/qiniu-ai-sdk/ai-tools';
+import { createAgent } from '@bowenqt/qiniu-ai-sdk/core';
+import { createNodeQiniuAI } from '@bowenqt/qiniu-ai-sdk/node';
+
+const nowSchema = z.object({});
+
+const client = createNodeQiniuAI({
+  apiKey: process.env.QINIU_API_KEY || '',
+});
+
+const agent = createAgent({
+  client,
+  model: 'gemini-2.5-flash',
+  tools: {
+    now: {
+      description: '返回当前 ISO 时间戳',
+      parameters: zodToJsonSchema(nowSchema),
+      execute: async () => ({ now: new Date().toISOString() }),
+    },
+  },
+});
+
+const result = await agent.run({
+  prompt: '先调用 now 工具，再说明为什么 ISO 时间戳适合做系统集成。',
+});
+
+console.log(result.text);
+```
 
 ### v0.46 迁移表
 
@@ -113,6 +214,45 @@ npm install ioredis
 npm install pg
 ```
 
+### 能力元数据
+
+```typescript
+import {
+  getModelCapabilities,
+  getModuleMaturity,
+  listModels,
+} from '@bowenqt/qiniu-ai-sdk/qiniu';
+
+const featuredChatModels = listModels({ type: 'chat' }).slice(0, 3);
+const responseApi = getModuleMaturity('ResponseAPI');
+const gemini = getModelCapabilities('gemini-2.5-flash');
+
+console.log(featuredChatModels.map((model) => model.id));
+console.log(responseApi?.maturity); // beta
+console.log(gemini?.capabilities);
+```
+
+### Worktree 交付流
+
+```bash
+# 初始化 integration worktree，并建立默认 .worktrees/ 目录
+qiniu-ai worktree init
+
+# 从 codex/vnext-integration 派生 lane
+qiniu-ai worktree spawn --lane foundation
+
+# 查看当前 worktree 与推断出来的 lane
+qiniu-ai worktree status
+
+# 把 lane 合流回 integration branch
+qiniu-ai worktree integrate --lane foundation
+
+# 运行该 lane 的默认 live probe
+qiniu-ai verify live --lane runtime
+```
+
+适用于跨模块的大规模 SDK 演进：root 工作区只负责编排和集成，每个 lane 只负责一组子系统。
+
 ### Kodo 审计 Sink
 
 ```typescript
@@ -130,36 +270,6 @@ const logger = auditLogger({
 });
 ```
 
----
-
-## 🚀 快速开始
-
-```typescript
-import { QiniuAI } from '@bowenqt/qiniu-ai-sdk/qiniu';
-
-const client = new QiniuAI({
-  apiKey: 'Sk-xxxxxxxxxxxxxxxx',
-});
-
-// 对话补全
-const chat = await client.chat.create({
-  model: 'gemini-2.5-flash',
-  messages: [{ role: 'user', content: '你好！' }],
-});
-console.log(chat.choices[0].message.content);
-
-// 流式对话
-const stream = await client.chat.createStream({
-  model: 'gemini-2.5-flash',
-  messages: [{ role: 'user', content: '简单介绍一下 AI' }],
-});
-for await (const chunk of stream) {
-  process.stdout.write(chunk.choices[0]?.delta?.content || '');
-}
-```
-
----
-
 ## 🤖 Agent 使用
 
 ### 使用 generateText 执行工具
@@ -241,6 +351,7 @@ const videoTask = await client.video.create({
 });
 const videoResult = await client.video.waitForCompletion(videoTask.id);
 console.log(videoResult.task_result?.videos[0].url);
+// videoTask.cancel() 当前会显式报错，因为远端媒体任务取消还不支持
 
 // viduq 视频生成 (v0.36.0+)
 const viduqTask = await client.video.create({
@@ -251,6 +362,7 @@ const viduqTask = await client.video.create({
 // 使用完整句柄进行可靠轮询
 const viduqResult = await client.video.waitForCompletion(viduqTask);
 console.log(viduqResult.task_result?.videos[0].url);
+// 如需停止本地等待，请使用 AbortSignal；viduqTask.cancel() 当前仍为 fail-fast
 
 // kling-image-o1 高质量图像 (v0.36.0+)
 const klingImg = await client.image.generate({
@@ -489,17 +601,49 @@ await instance.kill();
 
 ---
 
-## 🛠️ CLI：MCP Server
+## 🛠️ CLI
+
+### 项目初始化与诊断
+
+```bash
+npx qiniu-ai init --template chat
+npx qiniu-ai init --template agent
+npx qiniu-ai init --template node-agent
+npx qiniu-ai doctor --template agent
+```
+
+### MCP Server
 
 运行内置的七牛 MCP Server：
 
+当前内置 `QiniuMCPServer` 提供的 built-in tools 为：
+
+- `qiniu_chat`
+- `qiniu_ocr`
+- `qiniu_image_censor`
+- `qiniu_video_censor`
+- `qiniu_image_generate`
+
+当前不包含 `qiniu_vframe`。如果你需要抽帧，请直接使用 SDK 的 `@bowenqt/qiniu-ai-sdk/ai-tools` / `QINIU_TOOLS` 或 asset resolver 能力。
+
 ```bash
 npx qiniu-mcp-server
 ```
 
+### Skill CLI
+
+```bash
+npx qiniu-ai doctor --template node-agent   # 检查环境、peer deps 与导入路径
+npx qiniu-ai skill list                     # 列出已安装 skills
+npx qiniu-ai skill add <url>                # 从 manifest URL 安装远端 skill
+npx qiniu-ai skill add <url> --sha256 <hash>  # 附带完整性校验
+npx qiniu-ai skill verify                   # 校验 lockfile 与本地文件
+npx qiniu-ai skill verify --fix             # 从本地目录重建 lockfile
+npx qiniu-ai skill remove <name>            # 删除 skill 与 lockfile 条目
+```
+
 **环境变量：**
-- `QINIU_API_KEY` — OCR/审核操作的 API Key
-- `QINIU_ACCESS_KEY` / `QINIU_SECRET_KEY` — 抽帧/签名操作的密钥对
+- `QINIU_API_KEY` — 运行上述内置 MCP tools 所需的 API Key
 
 ---
 

package/bin/qiniu-ai.mjs

@@ -3,11 +3,18 @@
  * Qiniu AI CLI — Skill management and SDK utilities.
  *
  * Usage:
+ *   npx qiniu-ai init --template <chat|agent|node-agent>
+ *   npx qiniu-ai doctor [--template <chat|agent|node-agent>] [--lane <name>]
+ *   npx qiniu-ai worktree <init|spawn|status|integrate>
+ *   npx qiniu-ai verify live --lane <name>
  *   npx qiniu-ai skill list [--dir <skills-dir>]
  *   npx qiniu-ai skill verify [--fix] [--dir <skills-dir>]
  *   npx qiniu-ai skill remove <name> [--dir <skills-dir>]
  */
 
+import { fileURLToPath } from 'node:url';
 import { runCLI } from '../dist/cli/skill-cli.mjs';
 
-runCLI(process.argv.slice(2));
+await runCLI(process.argv.slice(2), {
+  packageRoot: fileURLToPath(new URL('..', import.meta.url)),
+});

package/dist/ai/agent-graph.d.ts

@@ -9,12 +9,14 @@ import type { ResponseFormat } from '../lib/types';
 import type { RegisteredTool } from '../lib/tool-registry';
 import type { Skill } from '../modules/skills/types';
 import type { ReferenceMode } from '../modules/skills/reference-mode';
+import type { Guardrail } from './guardrails';
 import { type TokenEstimatorConfig } from '../lib/token-estimator';
 import type { MemoryManager } from './memory';
 import type { AgentState, InternalMessage, StepResult, AgentGraphEvents } from './internal-types';
 import type { ApprovalConfig } from './tool-approval';
 import type { Checkpointer, PendingApproval } from './graph/checkpointer';
 import { type AgentMetrics } from '../lib/metrics';
+import type { ControlPlaneRunMetadata, CriticPolicy, PricePolicy, ReflectionLimits, TraceStore, VerifierPolicy } from './control-plane';
 /** AgentGraph options */
 export interface AgentGraphOptions {
     client: LanguageModelClient;
@@ -45,12 +47,28 @@ export interface AgentGraphOptions {
     memory?: MemoryManager;
     /** Thread ID for memory isolation (used with memory option) */
     threadId?: string;
+    /** Guardrails applied across runtime phases */
+    guardrails?: Guardrail[];
+    /** Agent ID for guardrail attribution */
+    agentId?: string;
     /** Auto-retry configuration for RecoverableError handling */
     autoRetry?: AutoRetryConfig;
     /** Skill reference injection mode (default: 'none') */
     skillReferenceMode?: ReferenceMode;
     /** Token-level event callback for streaming. Fault-isolated at predict-node level. */
     onTokenEvent?: (event: TokenEvent) => void;
+    /** Optional structured trace sink for control-plane integrations */
+    traceStore?: TraceStore;
+    /** Optional model pricing lookup for per-step cost attribution */
+    pricePolicy?: PricePolicy;
+    /** Optional run metadata/revision references attached to emitted traces */
+    runMetadata?: ControlPlaneRunMetadata;
+    /** Optional critic policy for bounded reflection scaffolding */
+    criticPolicy?: CriticPolicy;
+    /** Optional verifier policy for bounded reflection scaffolding */
+    verifierPolicy?: VerifierPolicy;
+    /** Optional stop conditions for bounded reflection scaffolding */
+    reflectionLimits?: ReflectionLimits;
 }
 /** Token-level event emitted during graph execution */
 export type TokenEvent = {
@@ -164,6 +182,7 @@ export declare class AgentGraph {
     private compactionOccurred;
     private droppedSkills;
     private droppedMessages;
+    private traceSteps;
     constructor(options: AgentGraphOptions);
     /**
      * Get current metrics snapshot.
@@ -236,5 +255,7 @@ export declare class AgentGraph {
      * Each skill becomes a separate system message with _meta.
      */
     private injectSkills;
+    private resolveToolTraceSource;
+    private flushRunTrace;
 }
 //# sourceMappingURL=agent-graph.d.ts.map

package/dist/ai/agent-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-graph.d.ts","sourceRoot":"","sources":["../../src/ai/agent-graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-graph.d.ts","sourceRoot":"","sources":["../../src/ai/agent-graph.ts"],"names":[],"mappings":"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"}