@principal-ai / subsystems-core
用于主体AI的子系统模型类型/模式和代理会话工具。
入口点
| 进口 | 使用 |
|---|---|
@principal-ai/subsystems-core | 浏览器安全的子系统模型/主题类型，参考链接+ isSubsystemModelDocument |
@principal-ai/subsystems-core/node | OpenCode存储，代理会话列表/获取/规范化，主题存储，固定装置 |
@principal-ai/subsystems-core/pipeline | 安全会话正常化/累积(no better-sqlite3） |
模式
可移植文档模式： schemas/subsystem-model.schema.json
主题的引用
DraftTopic.references 通过ID附加本地主题，C4草图和图纸：
import {
formatTopicReferenceLink,
parseTopicReferenceLink,
type TopicReference,
} from '@principal-ai/subsystems-core';
const reference: TopicReference = { kind: 'c4-sketch', sketchId: 'c4s-123-abc' };
formatTopicReferenceLink(reference); // principal://c4-sketch/c4s-123-abc
parseTopicReferenceLink('principal://topic/topic-123-abc');
// { kind: 'topic', topicId: 'topic-123-abc' }
parseTopicReferenceLink('principal://drawing/0b6f7c1e');
// { kind: 'drawing', drawingId: '0b6f7c1e' }
绘图ID是文件的文件名，不带扩展名 .excalidraw 存档于
主机的图纸文件夹（桌面应用程序使用） ~/.alexandria/drawings/）. 标题
来自图纸文件的 appState.name 并由主机解析。
创建/更新接受 references;更新将替换整个数组([] 清除
它)。现有主题可以省略该字段。引用是定向的且仅限本地的。
目标保持独立的工件；删除目标会留下一个缺失的引用，
不是级联删除。现有的 subsystemModels 关联不变。
降价链接，如 [Architecture](principal://c4-sketch/c4s-123-abc)，
[Whiteboard](principal://drawing/0b6f7c1e),
[Related](principal://topic/topic-123-abc) 使用相同的目标形状，但是
独立于附件的。帮助程序只格式化/解析href；主机必须允许
principal 协议和处理分辨率，导航，
目标验证、重复数据删除和自我引用拒绝。素描的引用
不要把作者的假设变成证据。
安装
npm install @principal-ai/subsystems-core
# or
bun add @principal-ai/subsystems-core
同行: @principal-ai/agent-monitoring （会话管道/ fixture）。
许可证
apache - 2.0