@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.2

package/dist/internal/serving-contracts/agent-catalog.js

@@ -0,0 +1,56 @@
+const row = (category, title, description, readOnly, terms) => ({ category, title, description, readOnly, terms });
+export const agentCatalog = {
+    knowledge_resource_search_body: row('materials', 'Search document body / 搜索正文', 'Search indexed native UTF-8 text and JSON string passages with hash-bound exact citations; coverage is partial.', true, ['body', 'body search', 'full text', 'passage', 'quote', 'citation', '正文', '搜索正文', '正文检索', '全文', '段落', '引用', '原句']),
+    knowledge_resource_read_passage: row('materials', 'Verify exact citation / 核验准确引用', 'Re-read canonical material and verify an exact quote, content hash, JSON pointer and UTF-16 offsets under current authority.', true, ['verify', 'citation', 'quote', '核验', '引用', '出处']),
+    knowledge_resource_search: row('materials', 'Search retained material / 搜索资料', 'Search authorized indexed titles and descriptions; consult index status for coverage.', true, ['search', 'find', '查找', '搜索', '检索', '资料', '文档']),
+    knowledge_resource_list: row('materials', 'Browse material / 浏览资料', 'Page authorized material without requiring a search phrase.', true, ['list', 'browse', '列出', '浏览', '资料', '文档']),
+    knowledge_resource_describe: row('materials', 'Inspect material / 查看资料信息', 'Inspect one exact ref and its access decision before reading.', true, ['describe', 'metadata', '详情', '元数据', '资料']),
+    knowledge_resource_read: row('materials', 'Read original / 读取原文', 'Read a bounded original or obtain its authorized download location.', true, ['read', 'original', 'download', '读取', '原文', '下载', '文件']),
+    knowledge_resource_capabilities: row('materials', 'Inspect representations / 查看可读表示', 'Inspect available content representations and access boundaries.', true, ['representation', 'capabilities', '表示', '格式', '能力']),
+    knowledge_resource_media: row('materials', 'Browse media / 查看图片附件', 'Page images, video and other media of an exact document.', true, ['media', 'image', 'video', '图片', '视频', '媒体', '附件']),
+    knowledge_resource_counts: row('materials', 'Count material / 统计资料', 'Read bounded resource counts with a continuation when needed.', true, ['count', 'statistics', '统计', '数量']),
+    knowledge_resource_window: row('materials', 'Capture sync window / 获取同步窗口', 'Capture the retained directory change window before synchronization.', true, ['sync', 'window', '同步', '窗口']),
+    knowledge_resource_changes: row('materials', 'Read changes / 查看资料变更', 'Page directory changes within the captured synchronization window.', true, ['changes', 'updates', '变更', '同步', '更新']),
+    knowledge_resource_index_status: row('runtime', 'Inspect search index / 查看索引状态', 'Inspect actual index coverage; registration does not imply searchable content.', true, ['index', 'searchable', '索引', '搜不到']),
+    tenant_material_submit: row('materials', 'Save original / 保存原件', 'Register author-provided bytes and provenance; does not collect websites.', false, ['save', 'upload', 'submit', '保存', '上传', '原件']),
+    tenant_artifact_draft: row('governance', 'Create draft / 创建草稿', 'Persist an authored draft with its explicit provenance.', false, ['draft', 'write', '草稿', '撰写']),
+    tenant_knowledge_compose: row('governance', 'Compose knowledge / 合成知识', 'Compose from exact retained source refs without asserting review approval.', false, ['compose', 'synthesize', '合成', '研究', '知识']),
+    tenant_knowledge_review: row('governance', 'Record review / 记录审核', 'Record an actual independent review and explicit decision.', false, ['review', 'audit', '审核', '审查']),
+    tenant_artifact_promote: row('governance', 'Advance lifecycle / 推进审核状态', 'Apply an explicit target status; approval requires its independent scope and review.', false, ['promote', 'approve', '审批', '批准', '状态']),
+    tenant_snapshot_declare: row('governance', 'Declare snapshot / 声明快照', 'Declare retained snapshot currentness without pretending to reobserve the source.', false, ['declare', 'freshness', '快照', '声明', '时效']),
+    tenant_snapshot_status: row('governance', 'Inspect snapshot / 查看快照状态', 'Read currentness of one exact retained resource.', true, ['snapshot', 'currentness', '快照', '时效', '新鲜度']),
+    tenant_workflow_plan: row('governance', 'Plan next step / 规划下一步', 'Use actual persisted facts to identify blockers, missing inputs and allowed next actions.', true, ['plan', 'next', 'blocker', '下一步', '怎么办', '规划', '阻塞', '发布']),
+    tenant_workflow_advance: row('governance', 'Execute plan action / 执行计划动作', 'Execute one explicitly chosen lifecycle action; never invent a PASS review.', false, ['advance', 'transition', '推进', '提交审核', '完成审核']),
+    tenant_knowledge_read: row('governance', 'Read reviewed knowledge / 读取受治理知识', 'Read reviewed Knowledge under the current consumer policy.', true, ['governed', 'reviewed', 'knowledge', '已审核', '知识', '受治理']),
+    tenant_material_share: row('sharing', 'Share material / 共享资料', 'Create an explicit authorized route to an exact resource.', false, ['share', 'route', '共享', '分享']),
+    tenant_material_revoke: row('sharing', 'Revoke sharing / 撤销共享', 'Revoke an existing sharing route explicitly.', false, ['revoke', 'unshare', '撤销', '取消共享']),
+    tenant_material_routes: row('sharing', 'Inspect sharing / 查看共享', 'Page the current Tenant sharing routes.', true, ['routes', 'sharing', '共享', '路由']),
+    tenant_source_define: row('sources', 'Define source / 定义来源', 'Register or revise explicit source semantics.', false, ['define', 'register', 'source', '定义', '登记', '来源']),
+    tenant_source_configure: row('sources', 'Configure source / 配置来源', 'Pause, enable or set an explicit refresh policy with the expected generation.', false, ['configure', 'pause', 'refresh', '配置', '暂停', '来源', '刷新']),
+    tenant_source_get: row('sources', 'Inspect source / 查看来源', 'Get an exact registered source and its current generation.', true, ['get', 'source', '查看', '来源']),
+    tenant_source_list: row('sources', 'List managed sources / 列出管理来源', 'Page source definitions under source management authority.', true, ['list', 'source', '列出', '来源']),
+    tenant_source_inventory: row('sources', 'Browse source inventory / 浏览来源清单', 'Page registered source metadata using read authority.', true, ['inventory', 'source', '来源', '清单']),
+    tenant_collection_request: row('collection', 'Request source collection / 请求采集来源', 'Persist an explicit manual collection request; Host policy still controls execution.', false, ['collect', 'request', '采集', '抓取', '手动']),
+    tenant_collection_status: row('collection', 'Inspect collection request / 查看采集请求', 'Read an exact request and its completion or failure metadata.', true, ['request', 'status', 'progress', '采集', '请求', '进度']),
+    tenant_work_queue: row('governance', 'Browse work queue / 查看待办', 'Page authorized research, draft, review and rework metadata.', true, ['queue', 'todo', 'work', '待办', '队列', '返工']),
+    tenant_project_list: row('projects', 'Browse projects / 浏览项目', 'Page explicit purpose contexts; Tenant owns the underlying material.', true, ['list', 'project', '项目', '列表']),
+    tenant_project_get: row('projects', 'Inspect project / 查看项目', 'Inspect purpose, scope and selection using separate continuations.', true, ['project', 'purpose', '项目', '目的', '范围']),
+    tenant_project_materials: row('projects', 'Browse project material / 查看项目资料', 'Page materials inside the explicitly selected project scope.', true, ['project', 'material', '项目', '资料']),
+    tenant_project_scope_set: row('projects', 'Set project scope / 修改项目范围', 'Change explicit material selection with an expected revision.', false, ['scope', 'selection', '范围', '选择']),
+    tenant_project_lifecycle_set: row('projects', 'Archive or restore project / 归档恢复项目', 'Apply explicit project lifecycle changes without deleting Tenant assets.', false, ['archive', 'restore', '归档', '恢复']),
+    tenant_runtime_status: row('runtime', 'Inspect runtime / 查看运行状态', 'Page authorized runtime metadata and actual execution blockers.', true, ['runtime', 'status', 'failure', '运行', '失败', '预算', '执行']),
+    tenant_web_collect_preview: row('collection', 'Preview website task / 预览网站采集', 'Validate a website collection intent and extraction plan before submission.', true, ['preview', 'website', 'web', '预览', '网站', '网页', '采集']),
+    tenant_web_collect_submit: row('collection', 'Submit website task / 提交网站采集', 'Submit an explicit bounded website task under current Host capabilities.', false, ['submit', 'website', 'crawl', '提交', '网站', '采集', '抓取']),
+    tenant_web_collect_status: row('collection', 'Inspect website task / 查看网站任务', 'Read lifecycle, acquisition, registration and requirements separately.', true, ['website', 'status', 'progress', '网站', '采集', '进度', '状态']),
+    tenant_web_collect_results: row('collection', 'Browse website results / 浏览网站结果', 'Page sealed result snapshots while preserving the exact job and window.', true, ['results', 'website', 'extraction', '结果', '网站', '提取']),
+    tenant_web_collect_cycles: row('collection', 'Browse observation cycles / 浏览观察周期', 'Page retained observation cycles of an exact website task.', true, ['cycles', 'observations', '周期', '观察']),
+    tenant_web_collect_control: row('collection', 'Pause resume or cancel task / 暂停恢复取消任务', 'Apply an explicit lifecycle control with the expected epoch.', false, ['pause', 'resume', 'cancel', '暂停', '恢复', '取消', '任务']),
+    tenant_web_collect_refresh: row('collection', 'Refresh website task / 刷新网站任务', 'Request one explicit new observation; replay cannot renew an old observation.', false, ['refresh', 'reobserve', '刷新', '重新观察']),
+    tenant_web_collect_read: row('collection', 'Read website result / 读取网站原件结果', 'Read an exact retained ORIGINAL, DOM or RESULT with separate read authority.', true, ['read', 'website', 'original', 'result', '读取', '网站', '原文', '结果']),
+    tenant_web_collect_index_status: row('runtime', 'Inspect website index / 查看网站索引', 'Read actual indexing status separately from successful acquisition.', true, ['website', 'index', '网站', '索引']),
+};
+export const agentCategoryTitles = { materials: 'Material discovery / 资料检索', sources: 'Source management / 来源管理', collection: 'Collection tasks / 采集任务', governance: 'Knowledge workflow / 知识工作流', sharing: 'Sharing / 共享', projects: 'Project purpose / 项目用途', runtime: 'Runtime diagnostics / 运行诊断' };
+export function recallAgentCapabilities(query, names) {
+    const text = query.normalize('NFKC').toLowerCase(), tokens = [...new Set((text.match(/[a-z0-9_]+/g) ?? []).filter(t => t.length >= 3 && !['the', 'and', 'for', 'with', 'from', 'that', 'this', 'want', 'would', 'please'].includes(t)))];
+    return names.map(name => { const card = agentCatalog[name], terms = card.terms, score = name === text ? 1000 : terms.reduce((n, term) => n + (text.includes(term) ? 2 : 0), 0) + tokens.reduce((n, t) => n + ((card.description + ' ' + card.title).toLowerCase().includes(t) ? 1 : 0), 0); return { name, score }; }).filter(item => item.score > 0).sort((a, b) => b.score - a.score || a.name.localeCompare(b.name)).map(item => item.name);
+}