@zhin.js/agent-feature 1.0.1 → 1.0.3

package/README.md

@@ -22,6 +22,10 @@ Break the request into verifiable steps. Prefer reversible actions.
 
 完整 Markdown 是 `instructions` SSOT。首个 heading 作为 description；没有 heading 时使用文件 identity。Feature 不绑定模型、system prompt 模板、tool policy 或 session store，这些属于 orchestrator adapter。
 
+单文件插件可用 `setup({ addAgent })` 注册 Markdown Agent，例如
+`addAgent('planner', '# Planner\n\nBreak work into verifiable steps.')`；目录模式和 setup
+模式共用 AgentIndex。
+
 ## Projection
 
 `AgentIndex.list()` 返回全树 qualified descriptors；`visible(owner)` 和 `get(owner, name)` 使用 nearest-owner inheritance。不同 Plugin owner 的同名 Agent 不通过扫描顺序覆盖。

package/lib/definition.d.ts

@@ -6,5 +6,10 @@ export interface AgentDefinition {
     readonly description: string;
     readonly instructions: string;
 }
+declare module '@zhin.js/plugin-runtime' {
+    interface PluginSetupContext<TConfig> {
+        addAgent(localName: string, markdown: string): void;
+    }
+}
 export declare function parseAgentMarkdown(value: unknown, context: ValidationContext): AgentDefinition;
 export {};

package/lib/provider.js

@@ -28,6 +28,7 @@ const agentFeature = defineFeatureProvider({
     protocol: 1,
     id: agentFeatureId,
     authoring: {
+        setupMethod: 'addAgent',
         conventions: [agentFiles],
         validate: parseAgentMarkdown,
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/agent-feature",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Convention-based Markdown Agent Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -17,8 +17,8 @@
     "src"
   ],
   "dependencies": {
-    "@zhin.js/feature-kit": "1.0.1",
-    "@zhin.js/plugin-runtime": "1.0.1"
+    "@zhin.js/feature-kit": "1.0.3",
+    "@zhin.js/plugin-runtime": "1.1.1"
   },
   "devDependencies": {
     "@types/node": "^26.1.0",

package/src/definition.ts

@@ -9,6 +9,14 @@ export interface AgentDefinition {
   readonly instructions: string;
 }
 
+declare module '@zhin.js/plugin-runtime' {
+  // Type parameter name must match the base PluginSetupContext declaration (TS2428).
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  interface PluginSetupContext<TConfig> {
+    addAgent(localName: string, markdown: string): void;
+  }
+}
+
 export function parseAgentMarkdown(value: unknown, context: ValidationContext): AgentDefinition {
   if (typeof value !== 'string' || !value.trim()) {
     throw new TypeError(`Agent ${context.source} must contain Markdown instructions`);

package/src/provider.ts

@@ -33,6 +33,7 @@ const agentFeature = defineFeatureProvider({
   protocol: 1,
   id: agentFeatureId,
   authoring: {
+    setupMethod: 'addAgent',
     conventions: [agentFiles],
     validate: parseAgentMarkdown,
   },