能力组合与声明式安装
集中列出模块、工具引用和注册顺序；通用循环只消费这份实际清单。
defineCapabilityCatalog 核对模块与工具的唯一身份，建立 tools 及 findToolOwner 投影；requiredToolIds 与 optionalToolIds 都必须指向已经登记的工具，optional 只表示使用关系，并不容许写错引用。它不创建新的 Core 执行阶段。
defineRegistrationCatalog 将静态安装项编译为只读目录，install(app) 按顺序评估 when 并调用 register。后项可观察前项安装后的状态。谓词与注册都同步，不用 enabled 代替部署配置、本次权限和执行授权三个不同判断。
defineAssociatedCatalog 在装配时核对 owner 到工具的引用：字符串只能指向独立登记的工具，内联声明可补全默认值；重复工具 ID 与未知 owner 直接拒绝，不创建平行意图身份，也不执行工具。
Catalog 的 get 可返回 undefined，require 未找到时抛错；ids/definitions/values/entries 是同一集合的不同视图，不是平行清单。
由简到繁的同业务示例
直接复用现有模块声明
入门 · Node.js
ts
import { Support } from '@jangts/agent-core';
const modules = [{ id: 'service', description: '服务查询能力', tools: [{ id: 'get_status' }] }];
const catalog = Support.defineCapabilityCatalog(modules);
console.log(catalog.ids(), catalog.findToolOwner('get_status')?.id);js
import { Support } from '@jangts/agent-core';
const modules = [{ id: 'service', description: '服务查询能力', tools: [{ id: 'get_status' }] }];
const catalog = Support.defineCapabilityCatalog(modules);
console.log(catalog.ids(), catalog.findToolOwner('get_status')?.id);增加工具引用和有序安装
配置 · Node.js
ts
import { Support } from '@jangts/agent-core';
const modules = [{ id: 'service', description: '服务查询', tools: [{ id: 'get_status' }],
references: [{ id: 'status-skill', requiredToolIds: ['get_status'], optionalToolIds: [] }] }];
const moduleCatalog = Support.defineCapabilityCatalog(modules, { toolReferences: module => module.references });
const registration = Support.defineRegistrationCatalog<{ installed: string[] }>([
{ id: 'service', register: app => { app.installed.push(moduleCatalog.require('service').id); } },
{ id: 'status-view', when: app => app.installed.includes('service'), register: app => { app.installed.push('status-view'); } },
]);
const app = { installed: [] as string[] };
registration.install(app);
console.log(app.installed);js
import { Support } from '@jangts/agent-core';
const modules = [{ id: 'service', description: '服务查询', tools: [{ id: 'get_status' }],
references: [{ id: 'status-skill', requiredToolIds: ['get_status'], optionalToolIds: [] }] }];
const moduleCatalog = Support.defineCapabilityCatalog(modules, { toolReferences: module => module.references });
const registration = Support.defineRegistrationCatalog([
{ id: 'service', register: app => { app.installed.push(moduleCatalog.require('service').id); } },
{ id: 'status-view', when: app => app.installed.includes('service'), register: app => { app.installed.push('status-view'); } },
]);
const app = { installed: [] };
registration.install(app);
console.log(app.installed);