@zhin.js/mcp-feature 1.1.3 → 1.1.5

package/README.md

@@ -57,3 +57,14 @@ MCP 候选连接不会触碰旧 client。旧 turn 继续通过旧 projection 与
 pnpm --filter @zhin.js/mcp-feature test
 pnpm --filter @zhin.js/mcp-feature build
 ```
+
+
+### Transport 创建上下文
+
+`create(context)` 只提供 `owner`、`config`、`generation`、`signal` 和 `use(token)`；
+Adapter 还提供端点的 `id`、`endpointId` 和 `name`。这些值属于 owner 的创建生命周期，
+不是每次消息或工具调用的 operation snapshot。未改 owner 的连接可跨局部热重载保留。
+
+创建上下文不提供 `project()`，类型和实际对象都如此；JavaScript 强行调用会抛出
+`TypeError`，不会悄悄读取旧代投影。需要跨 Feature 的业务执行放在 command、handler、
+middleware 或 tool 中，通过它们当前 operation 的上下文解析。

package/lib/definition.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityContext } from '@zhin.js/feature-kit';
+import type { ConstructionContext } from '@zhin.js/feature-kit';
 declare const mcpBrand: "zhin.mcp/1";
 export interface McpToolDescriptor {
     readonly name: string;
@@ -14,7 +14,7 @@ export interface McpClientInstance {
 export interface McpDefinition<TConfig = unknown> {
     readonly $feature: typeof mcpBrand;
     readonly description?: string;
-    create(context: CapabilityContext<TConfig>): McpClientInstance | Promise<McpClientInstance>;
+    create(context: ConstructionContext<TConfig>): McpClientInstance | Promise<McpClientInstance>;
 }
 declare module '@zhin.js/plugin-runtime' {
     interface PluginSetupContext<TConfig = unknown> {

package/lib/mcp-index.js

@@ -1,5 +1,5 @@
 import { DisposeStack, } from '@zhin.js/plugin-runtime';
-import { OwnerCapabilityIndex, createCapabilityContext, } from '@zhin.js/feature-kit';
+import { OwnerCapabilityIndex, createConstructionContext, } from '@zhin.js/feature-kit';
 import { assertMcpClient, } from './definition.js';
 export class McpIndex {
     $projection = 'zhin.mcp-index/1';
@@ -18,7 +18,7 @@ export class McpIndex {
         try {
             for (const entry of index.entries()) {
                 signal.throwIfAborted();
-                const client = await entry.slot.definition.create(createCapabilityContext(snapshot, entry.owner, undefined, signal));
+                const client = await entry.slot.definition.create(createConstructionContext(snapshot, entry.owner, undefined, signal));
                 signal.throwIfAborted();
                 assertMcpClient(client, entry.source);
                 records.push({ entry, client, started: false, stopped: false });

package/lib/provider.js

@@ -15,6 +15,7 @@ const mcpFeature = defineFeatureProvider({
         validate: parseMcpDefinition,
     },
     runtime: {
+        retain: 'when-owner-unchanged',
         async project(slots, context) {
             const index = await McpIndex.create(slots, context.snapshot, context.signal);
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/mcp-feature",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Convention-based MCP client Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -17,8 +17,8 @@
     "src"
   ],
   "dependencies": {
-    "@zhin.js/feature-kit": "1.1.2",
-    "@zhin.js/plugin-runtime": "1.1.11"
+    "@zhin.js/feature-kit": "1.1.4",
+    "@zhin.js/plugin-runtime": "1.1.13"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",

package/src/definition.ts

@@ -1,4 +1,4 @@
-import type { CapabilityContext } from '@zhin.js/feature-kit';
+import type { ConstructionContext } from '@zhin.js/feature-kit';
 
 const mcpBrand = 'zhin.mcp/1' as const;
 
@@ -18,7 +18,7 @@ export interface McpClientInstance {
 export interface McpDefinition<TConfig = unknown> {
   readonly $feature: typeof mcpBrand;
   readonly description?: string;
-  create(context: CapabilityContext<TConfig>): McpClientInstance | Promise<McpClientInstance>;
+  create(context: ConstructionContext<TConfig>): McpClientInstance | Promise<McpClientInstance>;
 }
 
 declare module '@zhin.js/plugin-runtime' {

package/src/mcp-index.ts

@@ -6,7 +6,7 @@ import {
 } from '@zhin.js/plugin-runtime';
 import {
   OwnerCapabilityIndex,
-  createCapabilityContext,
+  createConstructionContext,
   type OwnerCapabilityEntry,
 } from '@zhin.js/feature-kit';
 import {
@@ -57,7 +57,7 @@ export class McpIndex {
       for (const entry of index.entries()) {
         signal.throwIfAborted();
         const client = await entry.slot.definition.create(
-          createCapabilityContext(snapshot, entry.owner, undefined, signal),
+          createConstructionContext(snapshot, entry.owner, undefined, signal),
         );
         signal.throwIfAborted();
         assertMcpClient(client, entry.source);

package/src/provider.ts

@@ -17,6 +17,7 @@ const mcpFeature = defineFeatureProvider({
     validate: parseMcpDefinition,
   },
   runtime: {
+    retain: 'when-owner-unchanged',
     async project(slots, context) {
       const index = await McpIndex.create(slots, context.snapshot, context.signal);
       return {