@zhin.js/agent 1.1.9 → 1.1.11

package/lib/prompt/discover-prompt-sections.js

@@ -0,0 +1,49 @@
+import * as path from 'node:path';
+import { getLogger } from '@zhin.js/logger';
+import { PromptSectionLoader } from './prompt-section-loader.js';
+const logger = getLogger('PromptSectionDiscovery');
+const CONVENTION_SUBDIR = 'agent/prompt-sections';
+/**
+ * 从一批插件根目录中发现并注册提示词节点。
+ *
+ * @returns 成功注册的节点总数
+ */
+export async function discoverAndRegisterPromptSections(pluginRootDirs, registry, options) {
+    const loader = new PromptSectionLoader();
+    const subdir = options?.subdir ?? CONVENTION_SUBDIR;
+    let count = 0;
+    for (const root of pluginRootDirs) {
+        const dirPath = path.join(root, subdir);
+        const sections = await loader.loadFromDir(dirPath, { strict: options?.strict });
+        await loader.registerToRegistry(sections, registry);
+        count += sections.length;
+    }
+    return count;
+}
+/**
+ * 在 Agent 初始化时调用，自动从 ctx 中获取所有插件根目录，
+ * 扫描 `agent/prompt-sections/` 目录并注册到 registry。
+ *
+ * ctx 需要提供 `getPluginRoots()` 或 `plugins`（含 `root` 属性）。
+ */
+export async function bootstrapPromptSections(ctx, registry, options) {
+    let roots;
+    if (typeof ctx.getPluginRoots === 'function') {
+        roots = ctx.getPluginRoots();
+    }
+    else if (Array.isArray(ctx.plugins)) {
+        roots = ctx.plugins
+            .map(p => p.root)
+            .filter((r) => typeof r === 'string');
+    }
+    else {
+        roots = [];
+    }
+    if (roots.length === 0) {
+        logger.debug('[bootstrapPromptSections] no plugin roots found — skipping discovery');
+        return;
+    }
+    const count = await discoverAndRegisterPromptSections(roots, registry, options);
+    logger.debug(`[bootstrapPromptSections] discovered ${count} prompt section(s) from ${roots.length} plugin(s)`);
+}
+//# sourceMappingURL=discover-prompt-sections.js.map

package/lib/prompt/discover-prompt-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-prompt-sections.js","sourceRoot":"","sources":["../../src/prompt/discover-prompt-sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAmC,MAAM,4BAA4B,CAAC;AAGlG,MAAM,MAAM,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;AAEnD,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,cAAwB,EACxB,QAAgC,EAChC,OAAoC;IAEpC,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,iBAAiB,CAAC;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACpD,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAGC,EACD,QAAgC,EAChC,OAAoC;IAEpC,IAAI,KAAe,CAAC;IAEpB,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC7C,KAAK,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,KAAK,GAAG,GAAG,CAAC,OAAO;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,EAAE,CAAC;IACb,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;QACrF,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,iCAAiC,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,CAAC,wCAAwC,KAAK,2BAA2B,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;AACjH,CAAC"}

package/lib/prompt/index.d.ts

@@ -10,6 +10,11 @@ export type { PromptAssemblyEntry, PromptAssemblySection, PromptSectionRegistry,
 export { promptAssemblyToken } from './tokens.js';
 export type { PromptAssemblyToken, PromptAssemblyResource } from './tokens.js';
 export type { AgentPromptProfile } from './turn-prompt-profile.js';
+export { defineAgentPromptSection, } from './define-agent-prompt-section.js';
+export type { AgentPromptSectionConfig } from './define-agent-prompt-section.js';
+export { PromptSectionLoader, } from './prompt-section-loader.js';
+export type { PromptSectionLoaderOptions } from './prompt-section-loader.js';
+export { discoverAndRegisterPromptSections, bootstrapPromptSections, } from './discover-prompt-sections.js';
 export { buildDisciplinedPrompt, describeAgentPathPromptSections, buildAgentPathSystemPrompt, buildChatPathSystemPrompt, buildMultimodalVisionSystemPrompt, buildAgentUserMessage, } from './assembly.js';
 export * from './prompt-builder.js';
 export * from './templates.js';

package/lib/prompt/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,iCAAiC,EACjC,mCAAmC,EACnC,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EACL,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,iCAAiC,EACjC,mCAAmC,EACnC,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EACL,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EACL,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,OAAO,EACL,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,EACL,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/lib/prompt/index.js

@@ -5,6 +5,9 @@ export { resolveWorkspacePrompt, clearWorkspacePromptCache, } from './workspace-
 export { FIXED_DISCIPLINE_RULES, buildUserMessageWithHistory, describePromptSectionsForDebug, buildRichSystemPrompt, buildLiteSystemPromptWithPlatform, createDefaultPromptAssemblyRegistry, enforcePromptBudget, } from './system-prompt.js';
 export { PromptAssemblyRegistry, } from './prompt-assembly-registry.js';
 export { promptAssemblyToken } from './tokens.js';
+export { defineAgentPromptSection, } from './define-agent-prompt-section.js';
+export { PromptSectionLoader, } from './prompt-section-loader.js';
+export { discoverAndRegisterPromptSections, bootstrapPromptSections, } from './discover-prompt-sections.js';
 export { buildDisciplinedPrompt, describeAgentPathPromptSections, buildAgentPathSystemPrompt, buildChatPathSystemPrompt, buildMultimodalVisionSystemPrompt, buildAgentUserMessage, } from './assembly.js';
 export * from './prompt-builder.js';
 export * from './templates.js';

package/lib/prompt/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,iCAAiC,EACjC,mCAAmC,EACnC,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,iCAAiC,EACjC,mCAAmC,EACnC,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,EACL,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/lib/prompt/prompt-assembly-registry.d.ts

@@ -14,7 +14,13 @@ export interface PromptSectionRegistry {
 }
 export declare class PromptAssemblyRegistry implements PromptSectionRegistry {
     private readonly sections;
+    private onRegisterCallbacks;
     register(id: string, section: PromptAssemblySection): void;
+    /**
+     * 注册回调函数，在新节点注册时调用（用于 debug/logging）。
+     * 返回取消注册的函数。
+     */
+    onRegister(callback: (id: string, section: PromptAssemblySection) => void): () => void;
     merge(other: PromptAssemblyRegistry): this;
     snapshot(): Array<[string, PromptAssemblySection]>;
     entries(ctx?: RichSystemPromptContext): PromptAssemblyEntry[];

package/lib/prompt/prompt-assembly-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-assembly-registry.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-assembly-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,CAAC,CAAC,GAAG,EAAE,uBAAuB,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAElE,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IAC3E,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D,IAAI,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,aAAa,EAAE,CAAC;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC;CAChE;AAED,qBAAa,sBAAuB,YAAW,qBAAqB;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAErE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI1D,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAO1C,QAAQ,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAIlD,OAAO,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,mBAAmB,EAAE;IAU7D,IAAI,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,aAAa,EAAE;IAIpD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,uBAAuB,GAAG,MAAM;IAU9D,OAAO,CAAC,cAAc;CAQvB"}
+{"version":3,"file":"prompt-assembly-registry.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-assembly-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,CAAC,CAAC,GAAG,EAAE,uBAAuB,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAElE,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IAC3E,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D,IAAI,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,aAAa,EAAE,CAAC;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC;CAChE;AAED,qBAAa,sBAAuB,YAAW,qBAAqB;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,mBAAmB,CAAmE;IAE9F,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAK1D;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOtF,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAO1C,QAAQ,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAIlD,OAAO,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,mBAAmB,EAAE;IAU7D,IAAI,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,aAAa,EAAE;IAIpD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,uBAAuB,GAAG,MAAM;IAU9D,OAAO,CAAC,cAAc;CAQvB"}

package/lib/prompt/prompt-assembly-registry.js

@@ -1,8 +1,21 @@
 import { enforcePromptBudget } from './prompt-budget.js';
 export class PromptAssemblyRegistry {
     sections = new Map();
+    onRegisterCallbacks = [];
     register(id, section) {
         this.sections.set(id, section);
+        for (const cb of this.onRegisterCallbacks)
+            cb(id, section);
+    }
+    /**
+     * 注册回调函数，在新节点注册时调用（用于 debug/logging）。
+     * 返回取消注册的函数。
+     */
+    onRegister(callback) {
+        this.onRegisterCallbacks.push(callback);
+        return () => {
+            this.onRegisterCallbacks = this.onRegisterCallbacks.filter(cb => cb !== callback);
+        };
     }
     merge(other) {
         for (const [id, section] of other.snapshot()) {

package/lib/prompt/prompt-assembly-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-assembly-registry.js","sourceRoot":"","sources":["../../src/prompt/prompt-assembly-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAsBzD,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IAErE,QAAQ,CAAC,EAAU,EAAE,OAA8B;QACjD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAA6B;QACjC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,GAA6B;QACnC,OAAO,IAAI,CAAC,QAAQ,EAAE;aACnB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;aAC7D,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;gBAAE,OAAO,EAAE,CAAC;YAChC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,GAA6B;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,QAAgB,EAAE,GAA6B;QACnD,OAAO,mBAAmB,CACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC,EACH,QAAQ,CACT,CAAC;IACJ,CAAC;IAEO,cAAc,CACpB,OAA6B,EAC7B,GAA6B;QAE7B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"prompt-assembly-registry.js","sourceRoot":"","sources":["../../src/prompt/prompt-assembly-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAsBzD,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC7D,mBAAmB,GAAgE,EAAE,CAAC;IAE9F,QAAQ,CAAC,EAAU,EAAE,OAA8B;QACjD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB;YAAE,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,QAA8D;QACvE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QACpF,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAA6B;QACjC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,GAA6B;QACnC,OAAO,IAAI,CAAC,QAAQ,EAAE;aACnB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;aAC7D,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;gBAAE,OAAO,EAAE,CAAC;YAChC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,GAA6B;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,QAAgB,EAAE,GAA6B;QACnD,OAAO,mBAAmB,CACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC,EACH,QAAQ,CACT,CAAC;IACJ,CAAC;IAEO,cAAc,CACpB,OAA6B,EAC7B,GAA6B;QAE7B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAC9B,CAAC;CACF"}

package/lib/prompt/prompt-section-loader.d.ts

@@ -0,0 +1,27 @@
+import type { AgentPromptSectionConfig } from './define-agent-prompt-section.js';
+import type { PromptAssemblyRegistry } from './prompt-assembly-registry.js';
+export interface PromptSectionLoaderOptions {
+    /**
+     * 相对于插件根目录的 glob 模式
+     * @default 'agent/prompt-sections'
+     */
+    subdir?: string;
+    /**
+     * 是否在发现失败时抛出错误
+     * @default false
+     */
+    strict?: boolean;
+}
+export declare class PromptSectionLoader {
+    /**
+     * 从指定目录路径加载所有提示词节点文件。
+     *
+     * @param dirPath 绝对路径，对应 `agent/prompt-sections/` 目录
+     */
+    loadFromDir(dirPath: string, options?: Pick<PromptSectionLoaderOptions, 'strict'>): Promise<AgentPromptSectionConfig[]>;
+    /**
+     * 将提示词节点列表批量注册到 registry。
+     */
+    registerToRegistry(sections: AgentPromptSectionConfig[], registry: PromptAssemblyRegistry): Promise<void>;
+}
+//# sourceMappingURL=prompt-section-loader.d.ts.map

package/lib/prompt/prompt-section-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-section-loader.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-section-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAI5E,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAYD,qBAAa,mBAAmB;IAC9B;;;;OAIG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,GACnD,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAyCtC;;OAEG;IACG,kBAAkB,CACtB,QAAQ,EAAE,wBAAwB,EAAE,EACpC,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC;CAajB"}

package/lib/prompt/prompt-section-loader.js

@@ -0,0 +1,75 @@
+import * as path from 'node:path';
+import { getLogger } from '@zhin.js/logger';
+const logger = getLogger('PromptSectionLoader');
+function isValidPromptSection(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const s = obj;
+    return (typeof s['id'] === 'string' &&
+        typeof s['title'] === 'string' &&
+        typeof s['content'] === 'string');
+}
+export class PromptSectionLoader {
+    /**
+     * 从指定目录路径加载所有提示词节点文件。
+     *
+     * @param dirPath 绝对路径，对应 `agent/prompt-sections/` 目录
+     */
+    async loadFromDir(dirPath, options) {
+        const { default: fs } = await import('node:fs');
+        const sections = [];
+        let files;
+        try {
+            // Node recursive readdir may be typed as Dirent[] depending on overloads; normalize to relative paths.
+            const entries = fs.readdirSync(dirPath, { recursive: true });
+            files = entries
+                .map((entry) => {
+                if (typeof entry === 'string')
+                    return entry;
+                const parent = entry.parentPath ?? entry.path;
+                return parent ? path.relative(dirPath, path.join(parent, entry.name)) : entry.name;
+            })
+                .filter((f) => f.endsWith('.ts') || f.endsWith('.js'));
+        }
+        catch {
+            // 目录不存在时静默忽略
+            return sections;
+        }
+        for (const rel of files) {
+            const filePath = path.join(dirPath, rel);
+            try {
+                const mod = await import(filePath);
+                const section = mod.default;
+                if (isValidPromptSection(section)) {
+                    sections.push(section);
+                }
+                else {
+                    logger.warn(`[PromptSectionLoader] ${filePath} default export is not a valid AgentPromptSectionConfig — skipped`);
+                }
+            }
+            catch (err) {
+                if (options?.strict)
+                    throw err;
+                logger.warn(`[PromptSectionLoader] failed to load ${filePath}: ${err.message}`);
+            }
+        }
+        return sections;
+    }
+    /**
+     * 将提示词节点列表批量注册到 registry。
+     */
+    async registerToRegistry(sections, registry) {
+        for (const section of sections) {
+            registry.register(section.id, {
+                layer: section.layer ?? 'context',
+                title: section.title,
+                content: section.content,
+                priority: section.priority ?? 50,
+                truncatable: section.truncatable ?? true,
+                maxChars: section.maxChars,
+                metadata: section.metadata,
+            });
+        }
+    }
+}
+//# sourceMappingURL=prompt-section-loader.js.map

package/lib/prompt/prompt-section-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-section-loader.js","sourceRoot":"","sources":["../../src/prompt/prompt-section-loader.ts"],"names":[],"mappings":"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"}

package/lib/seam/index.d.ts

@@ -0,0 +1,8 @@
+export { SeamProviderRegistry } from './seam-provider.js';
+export type { SeamProvider, SeamScope } from './seam-provider.js';
+export type { ToolService, ToolServiceProvider, ToolSchema, ToolExecutionResult, } from './tool-service.js';
+export type { SkillService, SkillServiceProvider, SkillMetadata, SkillInvocationRequest, SkillInvocationResult, } from './skill-service.js';
+export { SeamIntegration } from './seam-integration.js';
+export { seamIntegrationToken } from './tokens.js';
+export type { SeamIntegrationToken } from './tokens.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/seam/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seam/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAElE,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/lib/seam/index.js

@@ -0,0 +1,4 @@
+export { SeamProviderRegistry } from './seam-provider.js';
+export { SeamIntegration } from './seam-integration.js';
+export { seamIntegrationToken } from './tokens.js';
+//# sourceMappingURL=index.js.map

package/lib/seam/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seam/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAkB1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/lib/seam/seam-integration.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 统一的能力接缝集成器
+ *
+ * 管理 Tool / Skill 两类能力的 Provider Registry，并提供便利方法。
+ * 在 ZhinAgent 的作用域中提供，供 Consumer（AgentDispatcher、PromptAssemblyRegistry）使用。
+ */
+import { SeamProviderRegistry, type SeamScope } from './seam-provider.js';
+import type { ToolService, ToolSchema, ToolExecutionResult } from './tool-service.js';
+import type { SkillService, SkillMetadata, SkillInvocationResult } from './skill-service.js';
+export declare class SeamIntegration {
+    readonly toolRegistry: SeamProviderRegistry<ToolService>;
+    readonly skillRegistry: SeamProviderRegistry<SkillService>;
+    /**
+     * 在指定作用域下注册一个 Tool Service
+     */
+    registerToolService(scope: SeamScope | 'global', service: ToolService): void;
+    /**
+     * 获取指定作用域下的所有 Tool Schema
+     *
+     * 自动遍历所有注册的 Tool Services，收集 schemas。
+     */
+    getToolSchemas(scope: SeamScope | 'global'): ToolSchema[];
+    /**
+     * 执行一个工具
+     *
+     * 自动查找提供该工具的 Service，然后执行。
+     */
+    executeTool(scope: SeamScope | 'global', toolName: string, args: unknown): Promise<ToolExecutionResult>;
+    /**
+     * 在指定作用域下注册一个 Skill Service
+     */
+    registerSkillService(scope: SeamScope | 'global', service: SkillService): void;
+    /**
+     * 获取指定作用域下的所有 Skill 元数据
+     *
+     * 自动遍历所有注册的 Skill Services，收集 catalogs。
+     */
+    getSkillCatalog(scope: SeamScope | 'global'): Promise<SkillMetadata[]>;
+    /**
+     * 调用一个 Skill
+     *
+     * 自动查找提供该 Skill 的 Service，然后调用。
+     */
+    invokeSkill(scope: SeamScope | 'global', skillId: string, input: unknown): Promise<SkillInvocationResult>;
+}
+//# sourceMappingURL=seam-integration.d.ts.map

package/lib/seam/seam-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seam-integration.d.ts","sourceRoot":"","sources":["../../src/seam/seam-integration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,eAAe;IAC1B,QAAQ,CAAC,YAAY,oCAA2C;IAChE,QAAQ,CAAC,aAAa,qCAA4C;IAIlE;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAI5E;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,EAAE;IAMzD;;;;OAIG;IACG,WAAW,CACf,KAAK,EAAE,SAAS,GAAG,QAAQ,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAiB/B;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAI9E;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAO5E;;;;OAIG;IACG,WAAW,CACf,KAAK,EAAE,SAAS,GAAG,QAAQ,EAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,qBAAqB,CAAC;CAYlC"}

package/lib/seam/seam-integration.js

@@ -0,0 +1,70 @@
+/**
+ * 统一的能力接缝集成器
+ *
+ * 管理 Tool / Skill 两类能力的 Provider Registry，并提供便利方法。
+ * 在 ZhinAgent 的作用域中提供，供 Consumer（AgentDispatcher、PromptAssemblyRegistry）使用。
+ */
+import { SeamProviderRegistry } from './seam-provider.js';
+export class SeamIntegration {
+    toolRegistry = new SeamProviderRegistry();
+    skillRegistry = new SeamProviderRegistry();
+    // ── Tool ────────────────────────────────────────────────────────────
+    /**
+     * 在指定作用域下注册一个 Tool Service
+     */
+    registerToolService(scope, service) {
+        this.toolRegistry.register(scope, service);
+    }
+    /**
+     * 获取指定作用域下的所有 Tool Schema
+     *
+     * 自动遍历所有注册的 Tool Services，收集 schemas。
+     */
+    getToolSchemas(scope) {
+        return this.toolRegistry
+            .getFor(scope)
+            .flatMap((service) => service.schema(scope));
+    }
+    /**
+     * 执行一个工具
+     *
+     * 自动查找提供该工具的 Service，然后执行。
+     */
+    async executeTool(scope, toolName, args) {
+        const provider = this.toolRegistry.find(scope, (service) => service.isAvailable?.(scope, toolName) !== false &&
+            service.schema(scope).some((s) => s.function.name === toolName));
+        if (!provider) {
+            return { success: false, error: `Tool not found: ${toolName}` };
+        }
+        return provider.execute(scope, toolName, args);
+    }
+    // ── Skill ────────────────────────────────────────────────────────────
+    /**
+     * 在指定作用域下注册一个 Skill Service
+     */
+    registerSkillService(scope, service) {
+        this.skillRegistry.register(scope, service);
+    }
+    /**
+     * 获取指定作用域下的所有 Skill 元数据
+     *
+     * 自动遍历所有注册的 Skill Services，收集 catalogs。
+     */
+    async getSkillCatalog(scope) {
+        const results = await Promise.all(this.skillRegistry.getFor(scope).map((service) => service.catalog(scope)));
+        return results.flat();
+    }
+    /**
+     * 调用一个 Skill
+     *
+     * 自动查找提供该 Skill 的 Service，然后调用。
+     */
+    async invokeSkill(scope, skillId, input) {
+        const provider = this.skillRegistry.find(scope, (service) => service.isAvailable?.(scope, skillId) !== false);
+        if (!provider) {
+            return { success: false, error: `Skill not found: ${skillId}` };
+        }
+        return provider.invoke(scope, { skillId, input });
+    }
+}
+//# sourceMappingURL=seam-integration.js.map

package/lib/seam/seam-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seam-integration.js","sourceRoot":"","sources":["../../src/seam/seam-integration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAkB,MAAM,oBAAoB,CAAC;AAQ1E,MAAM,OAAO,eAAe;IACjB,YAAY,GAAG,IAAI,oBAAoB,EAAe,CAAC;IACvD,aAAa,GAAG,IAAI,oBAAoB,EAAgB,CAAC;IAElE,uEAAuE;IAEvE;;OAEG;IACH,mBAAmB,CAAC,KAA2B,EAAE,OAAoB;QACnE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,KAA2B;QACxC,OAAO,IAAI,CAAC,YAAY;aACrB,MAAM,CAAC,KAAK,CAAC;aACb,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CACf,KAA2B,EAC3B,QAAgB,EAChB,IAAa;QAEb,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CACrC,KAAK,EACL,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,KAAK;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAClE,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC;QAClE,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,wEAAwE;IAExE;;OAEG;IACH,oBAAoB,CAAC,KAA2B,EAAE,OAAqB;QACrE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,KAA2B;QAC/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC1E,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CACf,KAA2B,EAC3B,OAAe,EACf,KAAc;QAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CACtC,KAAK,EACL,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,CAC7D,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,OAAO,EAAE,EAAE,CAAC;QAClE,CAAC;QAED,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;CACF"}

package/lib/seam/seam-provider.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 能力接缝基类与注册表
+ *
+ * 所有 Service Provider（LLM / Tool / Skill）必须遵循此约束。
+ */
+/**
+ * 能力接缝提供者基接口
+ *
+ * 定义所有 Service Provider 必须遵循的约束：
+ * 1. 声明身份（id + description）
+ * 2. 实现一个主操作接口（如 schema、invoke）
+ * 3. 支持作用域隔离（scoped per agent/session）
+ */
+export interface SeamProvider {
+    /**
+     * 唯一标识符（建议格式：namespace:name）
+     * 例：llm:deepseek, tool:filesystem, skill:github
+     */
+    readonly id: string;
+    /**
+     * 人类可读的描述
+     */
+    readonly description: string;
+    /**
+     * 可选：该能力的平台/运行时标记
+     */
+    readonly tags?: string[];
+    /**
+     * 可选：该能力的版本
+     */
+    readonly version?: string;
+}
+export type SeamScope = string | symbol;
+/**
+ * 能力接缝提供者注册表
+ *
+ * 支持作用域隔离、查询和消费方模式。
+ * 'global' 作用域的提供者对所有查询可见。
+ */
+export declare class SeamProviderRegistry<T extends SeamProvider> {
+    private readonly providers;
+    /**
+     * 在指定作用域下注册一个 Service Provider
+     */
+    register(scope: SeamScope | 'global', provider: T): void;
+    /**
+     * 获取指定作用域下的所有提供者（包含 global 中的提供者）
+     */
+    getFor(scope: SeamScope | 'global'): T[];
+    /**
+     * 查询满足条件的首个提供者
+     */
+    find(scope: SeamScope | 'global', predicate: (p: T) => boolean): T | null;
+    /**
+     * 获取指定 ID 的提供者
+     */
+    getById(scope: SeamScope | 'global', id: string): T | null;
+    /**
+     * 移除已注册的提供者（返回是否实际移除）
+     */
+    remove(scope: SeamScope | 'global', id: string): boolean;
+}
+//# sourceMappingURL=seam-provider.d.ts.map

package/lib/seam/seam-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seam-provider.d.ts","sourceRoot":"","sources":["../../src/seam/seam-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAMxC;;;;;GAKG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAQxD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,CAAC,EAAE;IAQxC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI;IAKzE;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAI1D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;CASzD"}

package/lib/seam/seam-provider.js

@@ -0,0 +1,66 @@
+/**
+ * 能力接缝基类与注册表
+ *
+ * 所有 Service Provider（LLM / Tool / Skill）必须遵循此约束。
+ */
+function toKey(scope) {
+    return typeof scope === 'symbol' ? scope.toString() : scope;
+}
+/**
+ * 能力接缝提供者注册表
+ *
+ * 支持作用域隔离、查询和消费方模式。
+ * 'global' 作用域的提供者对所有查询可见。
+ */
+export class SeamProviderRegistry {
+    providers = new Map();
+    /**
+     * 在指定作用域下注册一个 Service Provider
+     */
+    register(scope, provider) {
+        const key = toKey(scope);
+        if (!this.providers.has(key)) {
+            this.providers.set(key, []);
+        }
+        this.providers.get(key).push(provider);
+    }
+    /**
+     * 获取指定作用域下的所有提供者（包含 global 中的提供者）
+     */
+    getFor(scope) {
+        const key = toKey(scope);
+        const scoped = this.providers.get(key) ?? [];
+        if (key === 'global')
+            return scoped;
+        const global = this.providers.get('global') ?? [];
+        return [...global, ...scoped];
+    }
+    /**
+     * 查询满足条件的首个提供者
+     */
+    find(scope, predicate) {
+        const providers = this.getFor(scope);
+        return providers.find(predicate) ?? null;
+    }
+    /**
+     * 获取指定 ID 的提供者
+     */
+    getById(scope, id) {
+        return this.find(scope, (p) => p.id === id);
+    }
+    /**
+     * 移除已注册的提供者（返回是否实际移除）
+     */
+    remove(scope, id) {
+        const key = toKey(scope);
+        const list = this.providers.get(key);
+        if (!list)
+            return false;
+        const idx = list.findIndex((p) => p.id === id);
+        if (idx === -1)
+            return false;
+        list.splice(idx, 1);
+        return true;
+    }
+}
+//# sourceMappingURL=seam-provider.js.map

package/lib/seam/seam-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seam-provider.js","sourceRoot":"","sources":["../../src/seam/seam-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,SAAS,KAAK,CAAC,KAAgB;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACd,SAAS,GAAG,IAAI,GAAG,EAAe,CAAC;IAEpD;;OAEG;IACH,QAAQ,CAAC,KAA2B,EAAE,QAAW;QAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAA2B;QAChC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,GAAG,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAA2B,EAAE,SAA4B;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAA2B,EAAE,EAAU;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAA2B,EAAE,EAAU;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/seam/skill-service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skill Service Definition
+ *
+ * Skills 是更高层的能力，通常由多个 Tool 组合而成。
+ * 例：GitHub Skill = git tool + GitHub API tool + code analysis tool
+ */
+import type { SeamProvider, SeamScope } from './seam-provider.js';
+import type { SkillMetadata } from '../orchestrator/types.js';
+export type { SkillMetadata };
+/**
+ * Skill 调用请求
+ */
+export interface SkillInvocationRequest {
+    skillId: string;
+    input: unknown;
+    context?: Record<string, unknown>;
+}
+/**
+ * Skill 调用结果
+ */
+export interface SkillInvocationResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Skill Service Definition
+ */
+export interface SkillService extends SeamProvider {
+    /**
+     * 获取该 Service 提供的所有 Skill 元数据
+     */
+    catalog(scope: SeamScope | 'global'): Promise<SkillMetadata[]>;
+    /**
+     * 获取指定 Skill 的完整文档
+     */
+    describe(scope: SeamScope | 'global', skillId: string): Promise<string>;
+    /**
+     * 调用一个 Skill
+     */
+    invoke(scope: SeamScope | 'global', request: SkillInvocationRequest): Promise<SkillInvocationResult>;
+    /**
+     * 可选：Skill 是否在该作用域可用
+     */
+    isAvailable?(scope: SeamScope | 'global', skillId: string): boolean;
+}
+export type SkillServiceProvider = SkillService;
+//# sourceMappingURL=skill-service.d.ts.map

package/lib/seam/skill-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-service.d.ts","sourceRoot":"","sources":["../../src/seam/skill-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;OAEG;IACH,MAAM,CACJ,KAAK,EAAE,SAAS,GAAG,QAAQ,EAC3B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAElC;;OAEG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACrE;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC"}

package/lib/seam/skill-service.js

@@ -0,0 +1,8 @@
+/**
+ * Skill Service Definition
+ *
+ * Skills 是更高层的能力，通常由多个 Tool 组合而成。
+ * 例：GitHub Skill = git tool + GitHub API tool + code analysis tool
+ */
+export {};
+//# sourceMappingURL=skill-service.js.map

package/lib/seam/skill-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-service.js","sourceRoot":"","sources":["../../src/seam/skill-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/seam/tokens.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 能力接缝 DI Token
+ */
+import type { SeamIntegration } from './seam-integration.js';
+export declare const seamIntegrationToken: unique symbol;
+export type SeamIntegrationToken = typeof seamIntegrationToken;
+export type { SeamIntegration };
+//# sourceMappingURL=tokens.d.ts.map