attention-manifest-protocol 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this
 project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.6] - 2026-11-02
+
+### Added
+
+- Host-owned `SkillRegistry`, `KnowledgeRegistry` and `ProtocolRegistry` with validated registration, duplicate rejection, defensive copies and deterministic listing.
+- Metadata-only `skills`, `knowledge` and `protocols` discovery scopes, with registry injection through workspace and global agent services. Disabled skills and protocols are excluded from discovery.
+
+### Changed
+
+- Share in-memory registry storage and query mechanics through `InMemoryRegistry` while keeping validation and list policies in each domain.
+
+### Fixed
+
+- Reserve discovery node capacity for ancestors before visiting descendants so tight limits preserve tree structure and accurate summary counts.
+
 ## [Unreleased]
 
 ### Added

package/CHANGELOG.zh-CN.md

@@ -5,6 +5,21 @@
 格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循
 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.4.6] - 2026-11-02
+
+### 新增
+
+- 宿主维护的 `SkillRegistry`、`KnowledgeRegistry` 与 `ProtocolRegistry`，支持登记校验、重复 ID 拒绝、防御性副本与稳定列表。
+- 只返回元数据的 `skills`、`knowledge`、`protocols` 发现范围，并贯通 workspace/global agent 服务的注册中心注入；发现时排除禁用的 skill 与 protocol。
+
+### 变更
+
+- 通过 `InMemoryRegistry` 复用内存存储与查询机制，各领域保留独立校验和列表策略。
+
+### 修复
+
+- 发现树先为祖先预留节点容量，紧凑预算下仍保留树结构并准确统计节点。
+
 ## [未发布]
 
 ### 新增

package/README.md

@@ -53,7 +53,9 @@ Offline parsers live in `tools/support/`. The runtime stays database-free and us
 
 ### Discovery
 
-`amp_tool_workspace_discover` returns one structural tree over the authorized projects. File nodes carry a module kind (`service`, `tool`, `controller`, `route`, `repository`, `model`, `config`, `test`, `middleware`, `component`, `util`), an extension and bounded content matches. Hosts register project descriptions, purposes, summaries, plugins, services and tools through `HostCatalog`; project metadata is attached to project nodes, and an unregistered project falls back to its workspace summary. Discovery is read-only, never widens `projectIds`, and returns snippets as discovery evidence rather than as a Frame-allocated detail read.
+`amp_tool_workspace_discover` returns one structural tree over authorized projects, host components, skills, knowledge and protocols. File nodes carry a module kind (`service`, `tool`, `controller`, `route`, `repository`, `model`, `config`, `test`, `middleware`, `component`, `util`), an extension and bounded content matches. Hosts register projects and components through `HostCatalog`, reusable instructions through `SkillRegistry`, source-aware entries through `KnowledgeRegistry`, and protocol metadata through `ProtocolRegistry`. Discovery exposes skill/knowledge/protocol metadata only; full entries are fetched from their registries by ID. Discovery is read-only, never widens `projectIds`, and returns snippets as discovery evidence rather than as a Frame-allocated detail read.
+
+These registries are domain-owned catalogs, not a mandate to duplicate every concept as a generic registry. Existing runtime state and policies for ability, cognition, progress and behavior should stay in their domain models; add a read-only catalog/discovery projection only when enumeration is needed. Agents should not write directly to active registries by default. A future contribution flow should create a sourced, versioned proposal and require host authorization, review and audit before activation.
 
 ## Quick start
 

package/README.zh-CN.md

@@ -38,7 +38,7 @@ Context 使用结构树和类型化关系图。项目依赖、导入、调用与
 - MCP 执行、参数 Schema 校验、摘要固定与旧式握手回退，以及 A2A 发现与消息绑定。
 - 项目树、项目依赖图、TS/JS 的部分静态导入/调用/引用图，以及知识库词法检索。
 - Agent 工作区：`File`/`Directory` 树（指纹、字符集、bigint 行数/字节数、时间、描述/摘要/用途）；分页读、CAS 原子写、按策略提取的大纲（代码/项目/文章/Office）；import/export/dependency 图（Tarjan SCC、拓扑序、有界闭包）；Session 身份与上下文隔离；`src/hook` 组合层；SQLite 实体与仓储。
-- 宿主发现：以一棵结构树返回获准项目、内部模块（service/tool/controller/route/repository/model/config/test/...）、文件名、有界内容匹配，以及宿主注册的插件、服务与工具。项目节点带描述、用途与简介。
+- 宿主发现：以一棵结构树返回获准项目、内部模块（service/tool/controller/route/repository/model/config/test/...）、文件名、有界内容匹配，以及宿主注册的插件、服务、工具、skills 和 knowledge。项目节点带描述、用途与简介；skill/knowledge 节点只暴露元数据，详情由注册中心按 ID 查询。
 - Markdown、TXT、DOCX、XLSX、PPTX、TeX/LaTeX/BibTeX 的结构提取、原生定位与摘要/详情分层。
 - `amp_protocol_workspace` v1 服务、8 个 agent 工具、本地运行时接入与 MCP stdio 服务端。
 - 带显式策略的指纹：值使用 RFC 8785 规范化 JSON，文件按字节哈希，目录树使用域分隔的 Merkle 根，`verify` 比较算法、`kind` 与策略，而不是只比对裸十六进制字符串。未配对代理项与 `-0` 被拒绝，而不是被静默改写。
@@ -53,7 +53,9 @@ Context 使用结构树和类型化关系图。项目依赖、导入、调用与
 
 ### 发现
 
-`amp_tool_workspace_discover` 以一棵结构树返回获准项目。文件节点带模块分类（`service`、`tool`、`controller`、`route`、`repository`、`model`、`config`、`test`、`middleware`、`component`、`util`）、扩展名与有界内容匹配。宿主通过 `HostCatalog` 登记项目的描述、用途、简介，以及插件、服务和工具；项目元数据附在项目节点上，未登记的项目回退到 workspace 摘要。发现是只读的，不会扩大 `projectIds`；内容匹配只是发现证据，不能替代 Frame 分配后的详情读取。
+`amp_tool_workspace_discover` 以一棵结构树返回获准项目、宿主组件、skill、knowledge 与 protocol。文件节点带模块分类（`service`、`tool`、`controller`、`route`、`repository`、`model`、`config`、`test`、`middleware`、`component`、`util`）、扩展名与有界内容匹配。宿主通过 `HostCatalog` 登记项目与插件/服务/工具，通过 `SkillRegistry`、`KnowledgeRegistry`、`ProtocolRegistry` 登记可复用指令、知识条目与协议元数据。发现只暴露 skill/knowledge/protocol 元数据，不返回指令或正文；注册中心按 ID 提供完整条目。发现是只读的，不会扩大 `projectIds`；内容匹配只是发现证据，不能替代 Frame 分配后的详情读取。
+
+这些 registry 是各自领域的宿主目录，不要求每个概念都复制成同构 registry。Ability、cognition、progress 等若已有运行时状态、策略或事件模型，应由现有领域模块维护；需要统一枚举时增加只读 catalog/discovery 投影即可。Agent 默认只读正式目录；可选的登记工作流应先创建带来源、版本和提案状态的候选项，再经宿主权限校验、人工审核与审计后发布，不授予模型直接改写已生效条目的能力。
 
 ## 快速开始
 
@@ -220,11 +222,13 @@ Frame、快照、ContentStore 与后备执行器由宿主提供；将 `tools` /
 | [src/naming](src/naming/) | 冻结的 ID 表、ID 文法、兼容别名与 catalog 摘要 |
 | [src/context](src/context/) | Context 生命周期、树/图投影、CAS、工作区事实、上下文装配与 agent 服务 |
 | [src/session](src/session/) | 身份、令牌、TTL、上下文隔离、fork/revoke/rotate |
+| [src/skill](src/skill/) | 可复用 agent skill 注册、校验、查询与隔离副本 |
+| [src/knowledge](src/knowledge/) | 带来源元数据的 knowledge 注册、校验、查询与隔离副本 |
+| [src/protocol](src/protocol/) | 线上协议契约、通道，以及宿主维护的协议元数据注册中心 |
 | [src/file](src/file/) | File/Directory 树、元数据、分页读、原子写、会话运行时/服务、模块图与 ZIP/CFB 容器 |
 | [src/syntax](src/syntax/) | 字符集检测/编解码、字节/行索引、语法注册表与无损只读语法树 |
 | [src/outline](src/outline/) | 代码/文档大纲、范围与标签索引、关键字/策略注册表、React/Shell/SQL/Visual Basic 策略与 Office 解析 |
 | [src/hook](src/hook/) | 面向 agent 的组合 hooks 与运行记录 |
-| [src/protocol](src/protocol/) | 线上契约：信封、A2A、通道与 `amp_protocol_workspace` 接口 |
 | [src/module](src/module/) | 模型/工具端口、MCP 适配器与执行策略 |
 | [src/runtime](src/runtime/) | agent 回合、工具循环与治理接入 |
 | [src/governance](src/governance/) | 清单、凭据、预算、工作流、签名与审计 |

package/lib/context/workspaceService.d.ts

@@ -1,5 +1,8 @@
 import type { Frame } from "../frame/frame.js";
 import { HostCatalog } from "../discover/host.js";
+import type { KnowledgeRegistry } from "../knowledge/registry.js";
+import type { ProtocolRegistry } from "../protocol/registry.js";
+import type { SkillRegistry } from "../skill/registry.js";
 import type { ToolCatalog } from "../naming/index.js";
 import type { WorkspaceErrorCode, WorkspaceProjectAction, WorkspaceResponse, WorkspaceToolDefinition } from "../protocol/workspace.js";
 import type { Receipt } from "../receipt/receipt.js";
@@ -116,6 +119,9 @@ export interface WorkspaceServiceOptions {
      * components are filtered against `projectIds` before discovery sees them.
      */
     host?: HostCatalog;
+    skills?: SkillRegistry;
+    knowledge?: KnowledgeRegistry;
+    protocols?: ProtocolRegistry;
 }
 export declare class WorkspaceAgentService {
     private readonly agentId;
@@ -127,6 +133,9 @@ export declare class WorkspaceAgentService {
     private readonly roots;
     private readonly definitions;
     private readonly host;
+    private readonly skills?;
+    private readonly knowledge?;
+    private readonly protocols?;
     private readonly projectIds;
     private readonly store;
     private readonly writer?;

package/lib/context/workspaceService.js

@@ -468,6 +468,9 @@ export class WorkspaceAgentService {
     roots;
     definitions = workspaceToolDefinitions();
     host;
+    skills;
+    knowledge;
+    protocols;
     projectIds;
     store;
     writer;
@@ -493,6 +496,9 @@ export class WorkspaceAgentService {
         }
         this.agentId = options.agentId;
         this.host = options.host ?? new HostCatalog();
+        this.skills = options.skills;
+        this.knowledge = options.knowledge;
+        this.protocols = options.protocols;
         this.projectIds = new Set(options.projectIds);
         this.writer = options.writer;
         this.runner = options.runner;
@@ -824,6 +830,9 @@ export class WorkspaceAgentService {
             projects,
             components,
             builtIn: this.builtInComponents(),
+            ...(this.skills === (void 0) ? {} : { skills: this.skills }),
+            ...(this.knowledge === (void 0) ? {} : { knowledge: this.knowledge }),
+            ...(this.protocols === (void 0) ? {} : { protocols: this.protocols }),
             query,
             contentOf: (entity) => {
                 if (entity.detailRef === (void 0)) {

package/lib/discover/kinds.d.ts

@@ -8,7 +8,7 @@ export declare const ModuleKinds: readonly ["service", "tool", "controller", "ro
 export type ModuleKind = (typeof ModuleKinds)[number];
 export declare const ComponentKinds: readonly ["plugin", "service", "tool", "module"];
 export type ComponentKind = (typeof ComponentKinds)[number];
-export declare const DiscoveryScopes: readonly ["all", "projects", "host"];
+export declare const DiscoveryScopes: readonly ["all", "projects", "host", "skills", "knowledge", "protocols"];
 export type DiscoveryScope = (typeof DiscoveryScopes)[number];
 export declare const ComponentStatuses: readonly ["active", "disabled", "deprecated"];
 export type ComponentStatus = (typeof ComponentStatuses)[number];

package/lib/discover/kinds.js

@@ -19,5 +19,5 @@ export const ModuleKinds = [
     "unknown",
 ];
 export const ComponentKinds = ["plugin", "service", "tool", "module"];
-export const DiscoveryScopes = ["all", "projects", "host"];
+export const DiscoveryScopes = ["all", "projects", "host", "skills", "knowledge", "protocols"];
 export const ComponentStatuses = ["active", "disabled", "deprecated"];

package/lib/discover/tree.js

@@ -1,3 +1,6 @@
+import { KnowledgeRegistry } from "../knowledge/registry.js";
+import { ProtocolRegistry } from "../protocol/registry.js";
+import { SkillRegistry } from "../skill/registry.js";
 import { classifyModule, extensionOf, normalizeExtension } from "./classify.js";
 import { ComponentKinds, DiscoveryScopes, ModuleKinds } from "./kinds.js";
 const DefaultLimit = 100;
@@ -45,6 +48,9 @@ const normalizeQuery = (input = {}) => {
 const metadataText = (entity) => `${entity.label} ${entity.source.uri} ${entity.summary} ${(entity.tags ?? []).join(" ")} ${(entity.searchTerms ?? []).join(" ")}`.toLowerCase();
 const componentText = (component) => `${component.id} ${component.name} ${component.description} ${component.purpose ?? ""} ${component.version ?? ""} ${component.endpoint ?? ""} ${(component.capabilities ?? []).join(" ")}`.toLowerCase();
 const projectText = (project) => `${project.id} ${project.name} ${project.description} ${project.purpose} ${project.summary} ${(project.tags ?? []).join(" ")}`.toLowerCase();
+const skillText = (skill) => `${skill.id} ${skill.name} ${skill.description} ${(skill.tags ?? []).join(" ")} ${(skill.capabilities ?? []).join(" ")}`.toLowerCase();
+const knowledgeText = (knowledge) => `${knowledge.id} ${knowledge.title} ${knowledge.summary} ${knowledge.sourceUri ?? ""} ${(knowledge.tags ?? []).join(" ")}`.toLowerCase();
+const protocolText = (protocol) => `${protocol.id} ${protocol.name} ${protocol.version} ${protocol.description} ${protocol.status ?? "active"} ${protocol.endpoint ?? ""} ${(protocol.capabilities ?? []).join(" ")}`.toLowerCase();
 const passesStructuralFilters = (entity, query) => {
     if (entity.kind !== "file") {
         return true;
@@ -92,12 +98,7 @@ const contentMatches = (entity, query, state, contentOf) => {
     state.contentCache.set(entity.id, matches);
     return matches;
 };
-const makeEntityNode = (entity, query, state, matched, matches, children, truncated, hostProjectByRoot, usedHostProjects) => {
-    if (state.used >= query.limit) {
-        state.truncated = true;
-        return undefined;
-    }
-    state.used += 1;
+const makeEntityNode = (entity, state, matched, matches, children, truncated, hostProjectByRoot, usedHostProjects) => {
     const hostProject = entity.kind === "project" ? hostProjectByRoot.get(entity.id) : undefined;
     const node = {
         id: entity.id,
@@ -224,6 +225,9 @@ export const buildDiscoveryTree = (input) => {
         plugins: 0,
         services: 0,
         tools: 0,
+        skills: 0,
+        knowledge: 0,
+        protocols: 0,
         moduleCounts: {},
         contentReads: 0,
         contentCache: new Map(),
@@ -297,6 +301,15 @@ export const buildDiscoveryTree = (input) => {
         const fileMatched = entity.kind === "file" && structural && (query.text === "" || textMatched || matches.length > 0);
         const projectMatched = entity.kind === "project" && query.text === "" && !structuralFiltersActive(query);
         const selfMatched = fileMatched || projectMatched || textMatched;
+        if (state.used >= query.limit) {
+            const matched = selfMatched || hasMatchInSubtree(entity);
+            if (matched) {
+                state.truncated = true;
+            }
+            return { node: null, matched, cut: matched };
+        }
+        // Reserve an ancestor before walking descendants; release it if none match.
+        state.used += 1;
         const childEntities = childrenByParent.get(entity.id) ?? [];
         const children = [];
         let childMatched = false;
@@ -321,17 +334,18 @@ export const buildDiscoveryTree = (input) => {
             }
         }
         if (!selfMatched && !childMatched && !cut) {
+            state.used -= 1;
             return { node: null, matched: false, cut: false };
         }
         if (cut) {
             state.truncated = true;
         }
-        const node = makeEntityNode(entity, query, state, selfMatched, matches, children, cut, hostProjectByRoot, usedHostProjects);
-        return node === (void 0) ? { node: null, matched: true, cut: true } : { node, matched: true, cut };
+        const node = makeEntityNode(entity, state, selfMatched, matches, children, cut, hostProjectByRoot, usedHostProjects);
+        return { node, matched: true, cut };
     };
     const projectNodes = [];
-    const includeProjects = query.scope !== "host" && query.componentKind === (void 0);
-    const includeHost = query.scope !== "projects" && !structuralFiltersActive(query);
+    const includeProjects = query.scope !== "host" && query.scope !== "skills" && query.scope !== "knowledge" && query.scope !== "protocols" && query.componentKind === (void 0);
+    const includeHost = (query.scope === "all" || query.scope === "host") && !structuralFiltersActive(query);
     if (includeProjects) {
         for (let index = 0; index < projectEntities.length; index += 1) {
             const result = walk(projectEntities[index], 0);
@@ -375,11 +389,94 @@ export const buildDiscoveryTree = (input) => {
             componentNodes.set(component.kind, group);
         }
     }
+    const protocolNodes = [];
+    if (query.scope === "all" || query.scope === "protocols") {
+        const protocols = input.protocols === (void 0) ? [] : input.protocols instanceof ProtocolRegistry ? input.protocols.list() : input.protocols;
+        for (let index = 0; index < protocols.length; index += 1) {
+            const protocol = protocols[index];
+            if (protocol.status === "disabled" || (query.text !== "" && !protocolText(protocol).includes(query.text.toLowerCase()))) {
+                continue;
+            }
+            if (state.used >= query.limit) {
+                state.truncated = true;
+                break;
+            }
+            state.used += 1;
+            state.protocols += 1;
+            protocolNodes.push({
+                id: protocol.id,
+                kind: "protocol",
+                label: protocol.name,
+                description: protocol.description,
+                version: protocol.version,
+                ...(protocol.endpoint === (void 0) ? {} : { endpoint: protocol.endpoint }),
+                ...(protocol.capabilities === (void 0) ? {} : { capabilities: [...protocol.capabilities] }),
+                protocolStatus: protocol.status ?? "active",
+                matched: true,
+                children: [],
+            });
+        }
+    }
+    const skillNodes = [];
+    if (query.scope === "all" || query.scope === "skills") {
+        const skills = input.skills === (void 0) ? [] : input.skills instanceof SkillRegistry ? input.skills.list({ enabledOnly: true }) : input.skills;
+        for (let index = 0; index < skills.length; index += 1) {
+            const skill = skills[index];
+            if (skill.enabled === false || (query.text !== "" && !skillText(skill).includes(query.text.toLowerCase()))) {
+                continue;
+            }
+            if (state.used >= query.limit) {
+                state.truncated = true;
+                break;
+            }
+            state.used += 1;
+            state.skills += 1;
+            skillNodes.push({
+                id: skill.id,
+                kind: "skill",
+                label: skill.name,
+                description: skill.description,
+                ...(skill.version === (void 0) ? {} : { version: skill.version }),
+                ...(skill.capabilities === (void 0) ? {} : { capabilities: [...skill.capabilities] }),
+                ...(skill.tags === (void 0) ? {} : { tags: [...skill.tags] }),
+                matched: true,
+                children: [],
+            });
+        }
+    }
+    const knowledgeNodes = [];
+    if (query.scope === "all" || query.scope === "knowledge") {
+        const knowledgeEntries = input.knowledge === (void 0) ? [] : input.knowledge instanceof KnowledgeRegistry ? input.knowledge.list() : input.knowledge;
+        for (let index = 0; index < knowledgeEntries.length; index += 1) {
+            const knowledge = knowledgeEntries[index];
+            if (query.text !== "" && !knowledgeText(knowledge).includes(query.text.toLowerCase())) {
+                continue;
+            }
+            if (state.used >= query.limit) {
+                state.truncated = true;
+                break;
+            }
+            state.used += 1;
+            state.knowledge += 1;
+            knowledgeNodes.push({
+                id: knowledge.id,
+                kind: "knowledge",
+                label: knowledge.title,
+                description: knowledge.summary,
+                ...(knowledge.sourceUri === (void 0) ? {} : { sourceUri: knowledge.sourceUri }),
+                ...(knowledge.version === (void 0) ? {} : { version: knowledge.version }),
+                ...(knowledge.tags === (void 0) ? {} : { tags: [...knowledge.tags] }),
+                ...(knowledge.skillIds === (void 0) ? {} : { skillIds: [...knowledge.skillIds] }),
+                matched: true,
+                children: [],
+            });
+        }
+    }
     const root = {
         id: "discover:host",
         kind: "host",
         label: "host",
-        description: "Authorized projects, internal modules, files and host-registered components.",
+        description: "Authorized projects, host components, skills, knowledge and protocols.",
         matched: true,
         children: [],
     };
@@ -401,6 +498,16 @@ export const buildDiscoveryTree = (input) => {
             root.children.push({ id: `discover:${groupLabels[kind]}`, kind: "group", label: groupLabels[kind], matched: true, children: nodes });
         }
     }
+    for (const [label, nodes] of [
+        ["skills", skillNodes],
+        ["knowledge", knowledgeNodes],
+        ["protocols", protocolNodes],
+    ]) {
+        if (nodes.length > 0) {
+            nodes.sort((left, right) => left.label.localeCompare(right.label) || left.id.localeCompare(right.id));
+            root.children.push({ id: `discover:${label}`, kind: "group", label, matched: true, children: nodes });
+        }
+    }
     const summary = {
         projects: state.projects,
         modules: state.modules,
@@ -409,6 +516,9 @@ export const buildDiscoveryTree = (input) => {
         plugins: state.plugins,
         services: state.services,
         tools: state.tools,
+        skills: state.skills,
+        knowledge: state.knowledge,
+        protocols: state.protocols,
         nodes: state.used,
         truncated: state.truncated,
     };

package/lib/discover/types.d.ts

@@ -3,6 +3,9 @@
  * authorized workspace snapshot.
  */
 import type { WorkspaceEntity, WorkspaceEntityKind } from "../context/workspace.js";
+import type { KnowledgeEntry, KnowledgeRegistry } from "../knowledge/registry.js";
+import type { ProtocolEntry, ProtocolRegistry } from "../protocol/registry.js";
+import type { SkillEntry, SkillRegistry } from "../skill/registry.js";
 import type { ComponentKind, ComponentStatus, DiscoveryScope, ModuleKind } from "./kinds.js";
 /**
  * Host-registered project metadata. The workspace snapshot already carries a
@@ -41,7 +44,7 @@ export interface DiscoveryMatch {
     line: number;
     text: string;
 }
-export type DiscoveryNodeKind = "host" | "group" | WorkspaceEntityKind | ComponentKind;
+export type DiscoveryNodeKind = "host" | "group" | WorkspaceEntityKind | ComponentKind | "skill" | "knowledge" | "protocol";
 /**
  * One node of the discovery tree. Project nodes carry description, purpose and
  * summary; file nodes carry module classification, extension and bounded
@@ -62,6 +65,9 @@ export interface DiscoveryNode {
     endpoint?: string;
     capabilities?: string[];
     projectId?: string;
+    tags?: string[];
+    skillIds?: string[];
+    protocolStatus?: "active" | "deprecated" | "disabled";
     matched: boolean;
     truncated?: boolean;
     contentMatches?: DiscoveryMatch[];
@@ -90,6 +96,10 @@ export interface DiscoverySummary {
     plugins: number;
     services: number;
     tools: number;
+    /** Optional for consumers constructing pre-registry discovery summaries. */
+    skills?: number;
+    knowledge?: number;
+    protocols?: number;
     nodes: number;
     truncated: boolean;
 }
@@ -110,6 +120,9 @@ export interface DiscoveryInput {
      * `amp.workspace` service and its tools. Host components win on id clashes.
      */
     builtIn?: readonly HostComponent[];
+    skills?: readonly SkillEntry[] | SkillRegistry;
+    knowledge?: readonly KnowledgeEntry[] | KnowledgeRegistry;
+    protocols?: readonly ProtocolEntry[] | ProtocolRegistry;
     query?: DiscoveryQuery;
     contentOf?: (entity: WorkspaceEntity) => string | undefined;
 }

package/lib/global/service.d.ts

@@ -3,6 +3,9 @@ import type { WorkspaceRunner, WorkspaceServiceLimits, WorkspaceWriter } from ".
 import type { ContentStore } from "../context/contentStore.js";
 import type { WorkspaceSnapshot } from "../context/workspace.js";
 import type { HostCatalog } from "../discover/host.js";
+import type { KnowledgeRegistry } from "../knowledge/registry.js";
+import type { ProtocolRegistry } from "../protocol/registry.js";
+import type { SkillRegistry } from "../skill/registry.js";
 import type { Frame } from "../frame/frame.js";
 import type { ContextSnapshot } from "../context/lifecycle.js";
 import type { Receipt } from "../receipt/receipt.js";
@@ -17,6 +20,9 @@ export interface GlobalServiceOptions {
      */
     projectIds?: readonly string[];
     host?: HostCatalog;
+    skills?: SkillRegistry;
+    knowledge?: KnowledgeRegistry;
+    protocols?: ProtocolRegistry;
     limits?: Partial<WorkspaceServiceLimits>;
     /**
      * Optional persistence port forwarded to the underlying workspace service.

package/lib/global/service.js

@@ -25,6 +25,9 @@ export class GlobalAgentService {
             projectIds,
             store: options.store,
             ...(options.host === (void 0) ? {} : { host: options.host }),
+            ...(options.skills === (void 0) ? {} : { skills: options.skills }),
+            ...(options.knowledge === (void 0) ? {} : { knowledge: options.knowledge }),
+            ...(options.protocols === (void 0) ? {} : { protocols: options.protocols }),
             ...(options.limits === (void 0) ? {} : { limits: options.limits }),
             ...(options.writer === (void 0) ? {} : { writer: options.writer }),
             ...(options.runner === (void 0) ? {} : { runner: options.runner }),

package/lib/index.d.ts

@@ -16,5 +16,9 @@ export * as session from "./session/index.js";
 export * from "./frame/index.js";
 export * from "./ledger/index.js";
 export * from "./manifest/index.js";
+export { ProtocolRegistry } from "./protocol/registry.js";
+export type { ProtocolEntry, ProtocolStatus } from "./protocol/registry.js";
+export * from "./skill/index.js";
+export * from "./knowledge/index.js";
 export * from "./receipt/index.js";
 export * from "./warrant/index.js";

package/lib/index.js

@@ -16,5 +16,8 @@ export * as session from "./session/index.js";
 export * from "./frame/index.js";
 export * from "./ledger/index.js";
 export * from "./manifest/index.js";
+export { ProtocolRegistry } from "./protocol/registry.js";
+export * from "./skill/index.js";
+export * from "./knowledge/index.js";
 export * from "./receipt/index.js";
 export * from "./warrant/index.js";

package/lib/knowledge/index.d.ts

@@ -0,0 +1,2 @@
+export { KnowledgeRegistry } from "./registry.js";
+export type { KnowledgeEntry } from "./registry.js";

package/lib/knowledge/index.js

@@ -0,0 +1 @@
+export { KnowledgeRegistry } from "./registry.js";

package/lib/knowledge/registry.d.ts

@@ -0,0 +1,19 @@
+/** Registry for source-aware, discoverable knowledge entries. */
+export interface KnowledgeEntry {
+    id: string;
+    title: string;
+    summary: string;
+    content: string;
+    sourceUri?: string;
+    version?: string;
+    tags?: string[];
+    skillIds?: string[];
+    updatedAt?: string;
+}
+export declare class KnowledgeRegistry {
+    private readonly entries;
+    register(knowledge: KnowledgeEntry): KnowledgeEntry;
+    get(id: string): KnowledgeEntry | undefined;
+    list(): KnowledgeEntry[];
+    has(id: string): boolean;
+}

package/lib/knowledge/registry.js

@@ -0,0 +1,39 @@
+import { InMemoryRegistry } from "../registry/memory.js";
+const cloneKnowledge = (knowledge) => ({
+    ...knowledge,
+    ...(knowledge.tags === (void 0) ? {} : { tags: [...knowledge.tags] }),
+    ...(knowledge.skillIds === (void 0) ? {} : { skillIds: [...knowledge.skillIds] }),
+});
+const validateKnowledge = (knowledge) => {
+    for (const [field, value] of Object.entries({ id: knowledge.id, title: knowledge.title, summary: knowledge.summary, content: knowledge.content })) {
+        if (typeof (value) !== "string" || value.trim().length === 0) {
+            throw new Error(`knowledge ${field} must be a non-empty string`);
+        }
+    }
+    for (const [field, values] of Object.entries({ tags: knowledge.tags, skillIds: knowledge.skillIds })) {
+        if (values !== (void 0) && (!Array.isArray(values) || values.some((value) => typeof (value) !== "string" || value.trim().length === 0))) {
+            throw new Error(`knowledge ${field} must contain non-empty strings`);
+        }
+    }
+    if (knowledge.sourceUri !== (void 0) && knowledge.sourceUri.trim().length === 0) {
+        throw new Error("knowledge sourceUri must be a non-empty string");
+    }
+};
+export class KnowledgeRegistry {
+    entries = new InMemoryRegistry(cloneKnowledge, (id) => new Error(`knowledge ${id} is already registered`));
+    register(knowledge) {
+        validateKnowledge(knowledge);
+        return this.entries.register(knowledge);
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    list() {
+        return this.entries.list({
+            compare: (left, right) => left.title.localeCompare(right.title) || left.id.localeCompare(right.id),
+        });
+    }
+    has(id) {
+        return this.entries.has(id);
+    }
+}

package/lib/protocol/index.d.ts

@@ -8,3 +8,4 @@ export * from "./workspace.js";
 export * from "./global.js";
 export * from "./filesystem.js";
 export * from "./globalFilesystem.js";
+export * from "./registry.js";

package/lib/protocol/index.js

@@ -8,3 +8,4 @@ export * from "./workspace.js";
 export * from "./global.js";
 export * from "./filesystem.js";
 export * from "./globalFilesystem.js";
+export * from "./registry.js";

package/lib/protocol/registry.d.ts

@@ -0,0 +1,20 @@
+/** Host-owned catalog of protocol metadata exposed through discovery. */
+export type ProtocolStatus = "active" | "deprecated" | "disabled";
+export interface ProtocolEntry {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    status?: ProtocolStatus;
+    endpoint?: string;
+    capabilities?: string[];
+}
+export declare class ProtocolRegistry {
+    private readonly entries;
+    register(protocol: ProtocolEntry): ProtocolEntry;
+    get(id: string): ProtocolEntry | undefined;
+    list(options?: {
+        includeDisabled?: boolean;
+    }): ProtocolEntry[];
+    has(id: string): boolean;
+}

package/lib/protocol/registry.js

@@ -0,0 +1,46 @@
+import { InMemoryRegistry } from "../registry/memory.js";
+const cloneProtocol = (protocol) => ({
+    ...protocol,
+    ...(protocol.capabilities === (void 0) ? {} : { capabilities: [...protocol.capabilities] }),
+});
+const validateProtocol = (protocol) => {
+    for (const [field, value] of Object.entries({
+        id: protocol.id,
+        name: protocol.name,
+        version: protocol.version,
+        description: protocol.description,
+    })) {
+        if (typeof (value) !== "string" || value.trim().length === 0) {
+            throw new Error(`protocol ${field} must be a non-empty string`);
+        }
+    }
+    if (protocol.status !== (void 0) && !["active", "deprecated", "disabled"].includes(protocol.status)) {
+        throw new Error(`unknown protocol status ${protocol.status}`);
+    }
+    if (protocol.endpoint !== (void 0) && protocol.endpoint.trim().length === 0) {
+        throw new Error("protocol endpoint must be a non-empty string");
+    }
+    if (protocol.capabilities !== (void 0) &&
+        (!Array.isArray(protocol.capabilities) || protocol.capabilities.some((value) => typeof (value) !== "string" || value.trim().length === 0))) {
+        throw new Error("protocol capabilities must contain non-empty strings");
+    }
+};
+export class ProtocolRegistry {
+    entries = new InMemoryRegistry(cloneProtocol, (id) => new Error(`protocol ${id} is already registered`));
+    register(protocol) {
+        validateProtocol(protocol);
+        return this.entries.register(protocol);
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    list(options = {}) {
+        return this.entries.list({
+            filter: (protocol) => options.includeDisabled === true || protocol.status !== "disabled",
+            compare: (left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id),
+        });
+    }
+    has(id) {
+        return this.entries.has(id);
+    }
+}

package/lib/protocol/workspace.js

@@ -115,7 +115,7 @@ const Definitions = [
         relationKind: { type: "string", enum: Kinds },
         ...Page,
     }, ["revision", "nodeId", "direction"]),
-    definition(ToolIds.workspaceDiscover, "read", "Discover authorized projects, internal modules (service/tool/...), file names and bounded content matches, plus host-registered plugins/services/tools, as one structural tree. Project nodes carry description, purpose and summary. Read-only; snippets are discovery evidence, not a detail grant.", {
+    definition(ToolIds.workspaceDiscover, "read", "Discover authorized projects, internal modules (service/tool/...), file names and bounded content matches, plus host-registered plugins/services/tools and registered skills/knowledge/protocols, as one structural tree. Registry nodes expose metadata only. Read-only; snippets are discovery evidence, not a detail grant.", {
         revision: Key,
         text: { type: "string", maxLength: 512 },
         scope: { type: "string", enum: DiscoveryScopes },

package/lib/registry/index.d.ts

@@ -2,3 +2,5 @@ export { attest, declareConcept, declareModule, dependencies, hasDependencyCycle
 export type { AttestationResult, ConceptInput, ConceptLinkRole, DeclarationResult, DependencyRow, ModuleInput, ModuleKind, RegistryStatus, } from "./registry.js";
 export { collectDirectory, diffDirectory, digestDirectory } from "./content.js";
 export type { ContentEntry } from "./content.js";
+export { InMemoryRegistry } from "./memory.js";
+export type { InMemoryRegistryListOptions } from "./memory.js";

package/lib/registry/index.js

@@ -1,2 +1,3 @@
 export { attest, declareConcept, declareModule, dependencies, hasDependencyCycle, linkConcept, linkDependency, verifyModuleContent, verifyRegistry, } from "./registry.js";
 export { collectDirectory, diffDirectory, digestDirectory } from "./content.js";
+export { InMemoryRegistry } from "./memory.js";

package/lib/registry/memory.d.ts

@@ -0,0 +1,17 @@
+/** Small in-memory registry primitive with defensive cloning. */
+export interface InMemoryRegistryListOptions<T> {
+    filter?: (entry: T) => boolean;
+    compare?: (left: T, right: T) => number;
+}
+export declare class InMemoryRegistry<T extends {
+    id: string;
+}> {
+    private readonly entries;
+    private readonly cloneEntry;
+    private readonly duplicateError;
+    constructor(cloneEntry: (entry: T) => T, duplicateError: (id: string) => Error);
+    register(entry: T): T;
+    get(id: string): T | undefined;
+    list(options?: InMemoryRegistryListOptions<T>): T[];
+    has(id: string): boolean;
+}

package/lib/registry/memory.js

@@ -0,0 +1,33 @@
+export class InMemoryRegistry {
+    entries = new Map();
+    cloneEntry;
+    duplicateError;
+    constructor(cloneEntry, duplicateError) {
+        this.cloneEntry = cloneEntry;
+        this.duplicateError = duplicateError;
+    }
+    register(entry) {
+        if (this.entries.has(entry.id)) {
+            throw this.duplicateError(entry.id);
+        }
+        const stored = this.cloneEntry(entry);
+        this.entries.set(stored.id, stored);
+        return this.cloneEntry(stored);
+    }
+    get(id) {
+        const entry = this.entries.get(id);
+        return entry === (void 0) ? undefined : this.cloneEntry(entry);
+    }
+    list(options = {}) {
+        const entries = [...this.entries.values()]
+            .filter((entry) => options.filter === (void 0) || options.filter(entry))
+            .map(this.cloneEntry);
+        if (options.compare !== (void 0)) {
+            entries.sort(options.compare);
+        }
+        return entries;
+    }
+    has(id) {
+        return this.entries.has(id);
+    }
+}

package/lib/skill/index.d.ts

@@ -0,0 +1,2 @@
+export { SkillRegistry } from "./registry.js";
+export type { SkillEntry } from "./registry.js";

package/lib/skill/index.js

@@ -0,0 +1 @@
+export { SkillRegistry } from "./registry.js";

package/lib/skill/registry.d.ts

@@ -0,0 +1,20 @@
+/** Registry for reusable agent skills. */
+export interface SkillEntry {
+    id: string;
+    name: string;
+    description: string;
+    instructions: string;
+    version?: string;
+    tags?: string[];
+    capabilities?: string[];
+    enabled?: boolean;
+}
+export declare class SkillRegistry {
+    private readonly entries;
+    register(skill: SkillEntry): SkillEntry;
+    get(id: string): SkillEntry | undefined;
+    list(options?: {
+        enabledOnly?: boolean;
+    }): SkillEntry[];
+    has(id: string): boolean;
+}

package/lib/skill/registry.js

@@ -0,0 +1,37 @@
+import { InMemoryRegistry } from "../registry/memory.js";
+const cloneSkill = (skill) => ({
+    ...skill,
+    ...(skill.tags === (void 0) ? {} : { tags: [...skill.tags] }),
+    ...(skill.capabilities === (void 0) ? {} : { capabilities: [...skill.capabilities] }),
+});
+const validateSkill = (skill) => {
+    for (const [field, value] of Object.entries({ id: skill.id, name: skill.name, description: skill.description, instructions: skill.instructions })) {
+        if (typeof (value) !== "string" || value.trim().length === 0) {
+            throw new Error(`skill ${field} must be a non-empty string`);
+        }
+    }
+    for (const [field, values] of Object.entries({ tags: skill.tags, capabilities: skill.capabilities })) {
+        if (values !== (void 0) && (!Array.isArray(values) || values.some((value) => typeof (value) !== "string" || value.trim().length === 0))) {
+            throw new Error(`skill ${field} must contain non-empty strings`);
+        }
+    }
+};
+export class SkillRegistry {
+    entries = new InMemoryRegistry(cloneSkill, (id) => new Error(`skill ${id} is already registered`));
+    register(skill) {
+        validateSkill(skill);
+        return this.entries.register(skill);
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    list(options = {}) {
+        return this.entries.list({
+            filter: (skill) => options.enabledOnly !== true || skill.enabled !== false,
+            compare: (left, right) => left.name.localeCompare(right.name) || left.id.localeCompare(right.id),
+        });
+    }
+    has(id) {
+        return this.entries.has(id);
+    }
+}

package/package.json

@@ -1,72 +1,72 @@
-{
-  "name": "attention-manifest-protocol",
-  "version": "0.4.4",
-  "files": [
-    "lib",
-    "docs/schemas",
-    "README.md",
-    "README.zh-CN.md",
-    "CHANGELOG.md",
-    "CHANGELOG.zh-CN.md",
-    "LICENSE",
-    "NOTICE"
-  ],
-  "private": false,
-  "description": "A metacognitive protocol for agent attention and warrant: signed manifests, attention frames with explicit exclusions, receipts, T0-T4 evidence tiers, MCP execution, federation, persistence, agent governance (manifests, credentials, budgets, workflows) and multi-agent delegation.",
-  "keywords": [
-    "agent-protocol",
-    "attention",
-    "metacognition",
-    "context-engineering",
-    "mcp",
-    "a2a",
-    "provenance",
-    "multi-agent",
-    "governance"
-  ],
-  "license": "Apache-2.0",
-  "author": "Eloy Kim",
-  "type": "module",
-  "main": "./lib/index.js",
-  "types": "./lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./package.json": "./package.json",
-    "./schemas/*": "./docs/schemas/*",
-    "./*.js": {
-      "types": "./lib/*.d.ts",
-      "default": "./lib/*.js"
-    },
-    "./*": {
-      "types": "./lib/*/index.d.ts",
-      "default": "./lib/*/index.js"
-    }
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "build:lib": "tsc -p tsconfig.build.json && node tools/rewriteDeclarationExtensions.ts",
-    "prebuild:lib": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
-    "preview": "vite preview",
-    "prepublishOnly": "npm run build:lib"
-  },
-  "devDependencies": {
-    "@stylistic/eslint-plugin": "^5.10.0",
-    "@types/node": "^26.6.5",
-    "@typescript-eslint/utils": "^8.72.0",
-    "eslint": "^10.13.0",
-    "fast-xml-parser": "^5.11.2",
-    "fflate": "^0.8.3",
-    "jiti": "^2.7.0",
-    "prettier": "^3.9.10",
-    "typescript": "~6.0.3",
-    "typescript-eslint": "^8.72.0",
-    "vite": "^8.3.4"
-  }
-}
+{
+  "name": "attention-manifest-protocol",
+  "version": "0.4.6",
+  "files": [
+    "lib",
+    "docs/schemas",
+    "README.md",
+    "README.zh-CN.md",
+    "CHANGELOG.md",
+    "CHANGELOG.zh-CN.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "private": false,
+  "description": "A metacognitive protocol for agent attention and warrant: signed manifests, attention frames with explicit exclusions, receipts, T0-T4 evidence tiers, MCP execution, federation, persistence, agent governance (manifests, credentials, budgets, workflows) and multi-agent delegation.",
+  "keywords": [
+    "agent-protocol",
+    "attention",
+    "metacognition",
+    "context-engineering",
+    "mcp",
+    "a2a",
+    "provenance",
+    "multi-agent",
+    "governance"
+  ],
+  "license": "Apache-2.0",
+  "author": "Eloy Kim",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json",
+    "./schemas/*": "./docs/schemas/*",
+    "./*.js": {
+      "types": "./lib/*.d.ts",
+      "default": "./lib/*.js"
+    },
+    "./*": {
+      "types": "./lib/*/index.d.ts",
+      "default": "./lib/*/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "build:lib": "tsc -p tsconfig.build.json && node tools/rewriteDeclarationExtensions.ts",
+    "prebuild:lib": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build:lib"
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@types/node": "^26.6.5",
+    "@typescript-eslint/utils": "^8.72.0",
+    "eslint": "^10.13.0",
+    "fast-xml-parser": "^5.11.2",
+    "fflate": "^0.8.3",
+    "jiti": "^2.7.0",
+    "prettier": "^3.9.10",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.72.0",
+    "vite": "^8.3.4"
+  }
+}