@octopi-agent/engine 0.58.0 → 0.70.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/dist/config-schema/context.d.ts +1 -1
  2. package/dist/config-schema/context.js +1 -1
  3. package/dist/config-schema/engine.d.ts +122 -1
  4. package/dist/config-schema/engine.js +4 -1
  5. package/dist/config-schema/substrate.d.ts +123 -0
  6. package/dist/config-schema/substrate.js +161 -0
  7. package/dist/config.d.ts +101 -1
  8. package/dist/harness/agent/builder.d.ts +15 -1
  9. package/dist/harness/agent/builder.js +41 -4
  10. package/dist/harness/agent/config-bridge.js +17 -4
  11. package/dist/harness/{context/capabilities → capabilities}/document/backends/docx.d.ts +1 -1
  12. package/dist/harness/{context/capabilities → capabilities}/document/backends/docx.js +1 -1
  13. package/dist/harness/{context/capabilities → capabilities}/document/backends/office-parser.d.ts +1 -1
  14. package/dist/harness/{context/capabilities → capabilities}/document/backends/office-parser.js +1 -1
  15. package/dist/harness/{context/capabilities → capabilities}/document/backends/pdf.d.ts +1 -1
  16. package/dist/harness/{context/capabilities → capabilities}/document/backends/pdf.js +13 -3
  17. package/dist/harness/{context/capabilities → capabilities}/document/backends/plain.d.ts +1 -1
  18. package/dist/harness/{context/capabilities → capabilities}/document/backends/plain.js +13 -4
  19. package/dist/harness/{context/capabilities → capabilities}/document/backends/sheet.d.ts +1 -1
  20. package/dist/harness/{context/capabilities → capabilities}/document/backends/sheet.js +25 -5
  21. package/dist/harness/{context/capabilities → capabilities}/document/backends/xmind.d.ts +1 -1
  22. package/dist/harness/{context/capabilities → capabilities}/document/backends/xmind.js +1 -1
  23. package/dist/harness/{context/capabilities → capabilities}/document/errors.d.ts +1 -1
  24. package/dist/harness/{context/capabilities → capabilities}/document/errors.js +1 -1
  25. package/dist/harness/capabilities/document/factory.d.ts +33 -0
  26. package/dist/harness/capabilities/document/factory.js +37 -0
  27. package/dist/harness/{context/capabilities → capabilities}/document/format.d.ts +1 -1
  28. package/dist/harness/{context/capabilities → capabilities}/document/format.js +1 -1
  29. package/dist/harness/{context/capabilities → capabilities}/document/html-to-md.d.ts +1 -1
  30. package/dist/harness/{context/capabilities → capabilities}/document/html-to-md.js +1 -1
  31. package/dist/harness/{context/capabilities → capabilities}/document/index.d.ts +3 -1
  32. package/dist/harness/{context/capabilities → capabilities}/document/index.js +2 -1
  33. package/dist/harness/{context/capabilities → capabilities}/document/legacy/factory.d.ts +3 -1
  34. package/dist/harness/{context/capabilities → capabilities}/document/legacy/factory.js +3 -1
  35. package/dist/harness/{context/capabilities → capabilities}/document/legacy/soffice.d.ts +3 -1
  36. package/dist/harness/{context/capabilities → capabilities}/document/legacy/soffice.js +44 -1
  37. package/dist/harness/{context/capabilities → capabilities}/document/port.d.ts +1 -1
  38. package/dist/harness/{context/capabilities → capabilities}/document/port.js +4 -4
  39. package/dist/harness/{context/capabilities → capabilities}/document/types.d.ts +11 -1
  40. package/dist/harness/{context/capabilities → capabilities}/document/types.js +1 -1
  41. package/dist/harness/capabilities/document/worker-port.d.ts +13 -0
  42. package/dist/harness/capabilities/document/worker-port.js +78 -0
  43. package/dist/harness/context/capabilities/index.d.ts +2 -2
  44. package/dist/harness/context/capabilities/index.js +2 -2
  45. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  46. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  47. package/dist/harness/context/capabilities/summary/registry.js +29 -24
  48. package/dist/harness/context/layer-health.js +3 -2
  49. package/dist/harness/context/layers.d.ts +27 -13
  50. package/dist/harness/context/layers.js +76 -66
  51. package/dist/harness/context/system-prompt-assembler.d.ts +3 -0
  52. package/dist/harness/context/system-prompt-assembler.js +11 -1
  53. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  54. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  55. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  56. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  57. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  58. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  59. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  60. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  61. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +109 -0
  62. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  63. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  64. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  65. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +1 -1
  66. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.d.ts +10 -0
  67. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +102 -5
  68. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  69. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +14 -0
  70. package/dist/harness/index.d.ts +8 -5
  71. package/dist/harness/index.js +4 -2
  72. package/dist/harness/knowledge/adapters.d.ts +8 -5
  73. package/dist/harness/knowledge/adapters.js +53 -13
  74. package/dist/harness/knowledge/client.d.ts +197 -0
  75. package/dist/harness/knowledge/client.js +237 -0
  76. package/dist/harness/knowledge/connector-fetcher.d.ts +2 -2
  77. package/dist/harness/knowledge/connectors.d.ts +3 -3
  78. package/dist/harness/knowledge/connectors.js +14 -8
  79. package/dist/harness/knowledge/db.d.ts +40 -5
  80. package/dist/harness/knowledge/db.js +441 -113
  81. package/dist/harness/knowledge/document-extract-worker.js +55 -12
  82. package/dist/harness/knowledge/embed-runner.d.ts +53 -0
  83. package/dist/harness/knowledge/embed-runner.js +171 -0
  84. package/dist/harness/knowledge/engine-thread.d.ts +1 -0
  85. package/dist/harness/knowledge/engine-thread.js +302 -0
  86. package/dist/harness/knowledge/extract-document.d.ts +21 -5
  87. package/dist/harness/knowledge/extract-document.js +32 -8
  88. package/dist/harness/knowledge/fetchers.d.ts +14 -3
  89. package/dist/harness/knowledge/fetchers.js +52 -16
  90. package/dist/harness/knowledge/file-identity.d.ts +53 -0
  91. package/dist/harness/knowledge/file-identity.js +172 -0
  92. package/dist/harness/knowledge/file-index-store.d.ts +50 -0
  93. package/dist/harness/knowledge/file-index-store.js +132 -0
  94. package/dist/harness/knowledge/file-limits.d.ts +86 -0
  95. package/dist/harness/knowledge/file-limits.js +175 -0
  96. package/dist/harness/knowledge/fts.d.ts +60 -0
  97. package/dist/harness/knowledge/fts.js +218 -0
  98. package/dist/harness/knowledge/grounding.d.ts +3 -2
  99. package/dist/harness/knowledge/http-app.d.ts +50 -0
  100. package/dist/harness/knowledge/http-app.js +652 -0
  101. package/dist/harness/knowledge/http-bridge.d.ts +49 -0
  102. package/dist/harness/knowledge/http-bridge.js +17 -0
  103. package/dist/harness/knowledge/index-store.d.ts +158 -93
  104. package/dist/harness/knowledge/index-store.js +982 -441
  105. package/dist/harness/knowledge/index.d.ts +45 -5
  106. package/dist/harness/knowledge/index.js +23 -2
  107. package/dist/harness/knowledge/ingest.d.ts +262 -87
  108. package/dist/harness/knowledge/ingest.js +1072 -480
  109. package/dist/harness/knowledge/job-control-state.d.ts +29 -0
  110. package/dist/harness/knowledge/job-control-state.js +44 -0
  111. package/dist/harness/knowledge/job-control.d.ts +35 -0
  112. package/dist/harness/knowledge/job-control.js +86 -0
  113. package/dist/harness/knowledge/job-queue.d.ts +62 -0
  114. package/dist/harness/knowledge/job-queue.js +173 -0
  115. package/dist/harness/knowledge/knowledge-serve-child.d.ts +1 -0
  116. package/dist/harness/knowledge/knowledge-serve-child.js +100 -0
  117. package/dist/harness/knowledge/local-stack.d.ts +27 -0
  118. package/dist/harness/knowledge/local-stack.js +63 -0
  119. package/dist/harness/knowledge/membership-store.d.ts +65 -0
  120. package/dist/harness/knowledge/membership-store.js +198 -0
  121. package/dist/harness/knowledge/network-guard.d.ts +11 -2
  122. package/dist/harness/knowledge/network-guard.js +130 -85
  123. package/dist/harness/knowledge/parse-text-in-worker.d.ts +32 -0
  124. package/dist/harness/knowledge/parse-text-in-worker.js +158 -0
  125. package/dist/harness/knowledge/query-service.d.ts +272 -0
  126. package/dist/harness/knowledge/query-service.js +326 -0
  127. package/dist/harness/knowledge/query-worker-client.d.ts +96 -0
  128. package/dist/harness/knowledge/query-worker-client.js +207 -0
  129. package/dist/harness/knowledge/query-worker.d.ts +1 -0
  130. package/dist/harness/knowledge/query-worker.js +186 -0
  131. package/dist/harness/knowledge/read-http.d.ts +35 -0
  132. package/dist/harness/knowledge/read-http.js +373 -0
  133. package/dist/harness/knowledge/retriever.d.ts +22 -5
  134. package/dist/harness/knowledge/retriever.js +66 -35
  135. package/dist/harness/knowledge/secret-scan.d.ts +13 -2
  136. package/dist/harness/knowledge/secret-scan.js +25 -2
  137. package/dist/harness/knowledge/serve.d.ts +48 -0
  138. package/dist/harness/knowledge/serve.js +336 -0
  139. package/dist/harness/knowledge/source-store.d.ts +97 -19
  140. package/dist/harness/knowledge/source-store.js +166 -94
  141. package/dist/harness/knowledge/start-service-process.d.ts +49 -0
  142. package/dist/harness/knowledge/start-service-process.js +158 -0
  143. package/dist/harness/knowledge/text-parse-worker.d.ts +1 -0
  144. package/dist/harness/knowledge/text-parse-worker.js +54 -0
  145. package/dist/harness/knowledge/types.d.ts +1 -1
  146. package/dist/harness/knowledge/types.js +1 -1
  147. package/dist/harness/knowledge/vector-ann.d.ts +42 -0
  148. package/dist/harness/knowledge/vector-ann.js +68 -0
  149. package/dist/harness/knowledge/writer-lock.d.ts +13 -0
  150. package/dist/harness/knowledge/writer-lock.js +71 -0
  151. package/dist/harness/knowledge/writer-service.d.ts +194 -0
  152. package/dist/harness/knowledge/writer-service.js +355 -0
  153. package/dist/harness/knowledge/writer-worker-client.d.ts +102 -0
  154. package/dist/harness/knowledge/writer-worker-client.js +381 -0
  155. package/dist/harness/knowledge/writer-worker.d.ts +1 -0
  156. package/dist/harness/knowledge/writer-worker.js +189 -0
  157. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  158. package/dist/harness/memory/cognition-decay.js +55 -0
  159. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  160. package/dist/harness/memory/cognition-gates.js +191 -0
  161. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  162. package/dist/harness/memory/cognition-trigger.js +41 -0
  163. package/dist/harness/memory/cognition-types.d.ts +1 -1
  164. package/dist/harness/memory/cognition.d.ts +40 -8
  165. package/dist/harness/memory/cognition.js +432 -79
  166. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  167. package/dist/harness/memory/conceptualizer.js +246 -0
  168. package/dist/harness/memory/index.d.ts +16 -2
  169. package/dist/harness/memory/index.js +11 -1
  170. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  171. package/dist/harness/memory/sqlite/agent-db.js +118 -15
  172. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  173. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  174. package/dist/harness/memory/sqlite/embedding.d.ts +5 -2
  175. package/dist/harness/memory/sqlite/embedding.js +109 -16
  176. package/dist/harness/memory/sqlite/keyword-search.d.ts +21 -0
  177. package/dist/harness/memory/sqlite/keyword-search.js +64 -0
  178. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  179. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  180. package/dist/harness/memory/types.d.ts +331 -16
  181. package/dist/harness/memory/types.js +49 -0
  182. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  183. package/dist/harness/memory/wisdom-formation.js +304 -0
  184. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  185. package/dist/harness/memory/wisdom-gates.js +204 -0
  186. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  187. package/dist/harness/memory/wisdom-policy.js +220 -0
  188. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  189. package/dist/harness/memory/wisdom-types.js +2 -2
  190. package/dist/harness/memory/wisdom.d.ts +27 -0
  191. package/dist/harness/memory/wisdom.js +181 -0
  192. package/dist/harness/run/agent/agent.d.ts +9 -0
  193. package/dist/harness/run/agent/agent.js +19 -0
  194. package/dist/harness/run/reliability/run-agent.js +6 -2
  195. package/dist/harness/run/runner.js +2 -1
  196. package/dist/harness/session/attachments/service.d.ts +1 -1
  197. package/dist/harness/session/attachments/service.js +1 -1
  198. package/dist/harness/session/index.d.ts +1 -0
  199. package/dist/harness/session/index.js +1 -0
  200. package/dist/harness/session/title.d.ts +86 -0
  201. package/dist/harness/session/title.js +268 -0
  202. package/dist/harness/shared/events/agent-event-map.d.ts +8 -0
  203. package/dist/harness/shared/events/agent-event-map.js +1 -0
  204. package/dist/index.d.ts +7 -3
  205. package/dist/index.js +3 -1
  206. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  207. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  208. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  209. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  210. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  211. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  212. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  213. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  214. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  215. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  216. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  217. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  218. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  219. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  220. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  221. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  222. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  223. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  224. package/dist/worker-path.d.ts +8 -0
  225. package/dist/worker-path.js +15 -0
  226. package/package.json +2 -2
@@ -0,0 +1,246 @@
1
+ /**
2
+ * Conceptualizer — 命题 + 证据语境 → 概念/关系假设 → 门控入库
3
+ *
4
+ * 唯一概念化入口。禁止 session 全文 ETL / 正则 extractFromText。
5
+ * LLM 判义项与关系假设;本模块做结构解析与持证执法。
6
+ *
7
+ * @module harness/memory/conceptualizer
8
+ */
9
+ import { CONCEPT_KINDS, CONCEPT_RELATION_TYPES } from './types.js';
10
+ import { evaluateConceptGate, licenseEdge, } from './cognition-gates.js';
11
+ const MAX_NODES = 6;
12
+ const MAX_EDGES = 12;
13
+ function asString(v) {
14
+ return typeof v === 'string' ? v.trim() : '';
15
+ }
16
+ function parseKind(v) {
17
+ const s = asString(v);
18
+ return CONCEPT_KINDS.includes(s) ? s : null;
19
+ }
20
+ function parseRelation(v) {
21
+ const s = asString(v);
22
+ return CONCEPT_RELATION_TYPES.includes(s) ? s : null;
23
+ }
24
+ function parseEvidenceClass(v) {
25
+ const s = asString(v);
26
+ const allowed = ['causal', 'mereonymy', 'negation', 'analogy', 'evolution', 'cooccur'];
27
+ return allowed.includes(s) ? s : null;
28
+ }
29
+ /**
30
+ * 从 LLM 文本中提取 JSON 对象(`{nodes,edges}`)。
31
+ *
32
+ * @param text - LLM 输出
33
+ * @returns 解析结果或 null
34
+ */
35
+ export function parseConceptualizerJson(text) {
36
+ const start = text.indexOf('{');
37
+ if (start === -1)
38
+ return null;
39
+ let depth = 0;
40
+ let inString = false;
41
+ let escape = false;
42
+ for (let i = start; i < text.length; i++) {
43
+ const ch = text[i];
44
+ if (escape) {
45
+ escape = false;
46
+ continue;
47
+ }
48
+ if (ch === '\\') {
49
+ escape = true;
50
+ continue;
51
+ }
52
+ if (ch === '"') {
53
+ inString = !inString;
54
+ continue;
55
+ }
56
+ if (inString)
57
+ continue;
58
+ if (ch === '{')
59
+ depth++;
60
+ else if (ch === '}') {
61
+ depth--;
62
+ if (depth === 0) {
63
+ try {
64
+ return JSON.parse(text.slice(start, i + 1));
65
+ }
66
+ catch {
67
+ return null;
68
+ }
69
+ }
70
+ }
71
+ }
72
+ return null;
73
+ }
74
+ /**
75
+ * 解析 + 门控 + 入库(store 可选时只评估不写)。
76
+ *
77
+ * @param raw - LLM 结构化输出或原文
78
+ * @param input - 输入包(须含 contextSlice)
79
+ * @param store - ConceptGraphStore;省略则只跑门控
80
+ */
81
+ export async function conceptualizeAndAdmit(raw, input, store) {
82
+ const parsed = typeof raw === 'string' ? parseConceptualizerJson(raw) : raw;
83
+ const rejected = [];
84
+ if (!parsed) {
85
+ return { nodes: [], edges: [], rejected: [{ name: '*', reason: 'parse_failed' }] };
86
+ }
87
+ if (!input.contextSlice?.trim() && !input.evidenceText?.trim()) {
88
+ return {
89
+ nodes: [],
90
+ edges: [],
91
+ rejected: [{ name: '*', reason: 'no_context_slice' }],
92
+ };
93
+ }
94
+ const evidenceText = input.evidenceText ?? `${input.evidence}\n${input.contextSlice}`;
95
+ const supportBase = 1;
96
+ // 预载既有概念名 → id(跨命题连边)
97
+ const nameToId = new Map();
98
+ if (store) {
99
+ try {
100
+ const full = await store.getFullGraph();
101
+ for (const n of full.nodes) {
102
+ const key = n.name.trim().toLowerCase();
103
+ if (!nameToId.has(key))
104
+ nameToId.set(key, n.id);
105
+ }
106
+ }
107
+ catch {
108
+ // 读图失败时仅能连本批节点
109
+ }
110
+ }
111
+ // ── nodes ──
112
+ const rawNodes = Array.isArray(parsed.nodes) ? parsed.nodes : [];
113
+ const nodes = [];
114
+ for (const item of rawNodes.slice(0, MAX_NODES * 2)) {
115
+ if (nodes.length >= MAX_NODES)
116
+ break;
117
+ if (!item || typeof item !== 'object')
118
+ continue;
119
+ const o = item;
120
+ const name = asString(o.name);
121
+ const rawKind = asString(o.kind);
122
+ const kind = parseKind(o.kind);
123
+ if (rawKind && !kind) {
124
+ rejected.push({ name, reason: 'kind_invalid' });
125
+ continue;
126
+ }
127
+ const resolvedKind = kind ?? 'construct';
128
+ const description = asString(o.description) || undefined;
129
+ const domain = Array.isArray(o.domain)
130
+ ? o.domain.filter((d) => typeof d === 'string').map((d) => d.trim()).filter(Boolean)
131
+ : [];
132
+ const gate = evaluateConceptGate({
133
+ name,
134
+ kind: resolvedKind,
135
+ description,
136
+ domain,
137
+ memoryIds: [input.memoryId],
138
+ supportCount: supportBase,
139
+ });
140
+ if (!gate.ok) {
141
+ rejected.push({ name, reason: gate.reason });
142
+ continue;
143
+ }
144
+ let admit = {
145
+ action: 'rejected',
146
+ reason: gate.reason,
147
+ message: 'store not provided',
148
+ };
149
+ if (store) {
150
+ admit = await store.admitConcept({
151
+ name,
152
+ kind: resolvedKind,
153
+ description,
154
+ domain,
155
+ memoryIds: [input.memoryId],
156
+ supportCount: supportBase,
157
+ });
158
+ }
159
+ else {
160
+ admit = { action: 'created', reason: 'ok' };
161
+ }
162
+ if (admit.id)
163
+ nameToId.set(name.toLowerCase(), admit.id);
164
+ nodes.push({
165
+ name,
166
+ kind: resolvedKind,
167
+ description,
168
+ domain,
169
+ supportCount: supportBase,
170
+ admit,
171
+ });
172
+ }
173
+ // ── edges ──
174
+ const rawEdges = Array.isArray(parsed.edges) ? parsed.edges : [];
175
+ const edges = [];
176
+ for (const item of rawEdges.slice(0, MAX_EDGES * 2)) {
177
+ if (edges.length >= MAX_EDGES)
178
+ break;
179
+ if (!item || typeof item !== 'object')
180
+ continue;
181
+ const o = item;
182
+ const fromName = asString(o.fromName ?? o.from ?? o.source);
183
+ const toName = asString(o.toName ?? o.to ?? o.target);
184
+ const requestedType = parseRelation(o.relationType ?? o.relation) ?? 'related';
185
+ const evidenceClass = parseEvidenceClass(o.evidenceClass) ?? 'cooccur';
186
+ const cue = asString(o.cue);
187
+ const license = licenseEdge({
188
+ relationType: requestedType,
189
+ evidenceClass,
190
+ cue,
191
+ evidenceText,
192
+ memoryIds: [input.memoryId],
193
+ memoryStatuses: input.memoryStatus ? [input.memoryStatus] : [],
194
+ });
195
+ const edgeOut = {
196
+ fromName,
197
+ toName,
198
+ requestedType,
199
+ license,
200
+ };
201
+ if (store && license.status !== 'rejected') {
202
+ const sourceId = nameToId.get(fromName.toLowerCase());
203
+ const targetId = nameToId.get(toName.toLowerCase());
204
+ if (!sourceId || !targetId) {
205
+ edgeOut.license = {
206
+ ...license,
207
+ status: 'rejected',
208
+ reason: 'cue_mismatch',
209
+ message: 'endpoint concept not admitted',
210
+ };
211
+ }
212
+ else if (license.status === 'candidate_only') {
213
+ await store.addCausalCandidate({
214
+ sourceId,
215
+ targetId,
216
+ memoryIds: [input.memoryId],
217
+ cue,
218
+ note: license.message,
219
+ });
220
+ edgeOut.admit = {
221
+ action: 'candidate_only',
222
+ reason: license.reason,
223
+ message: license.message,
224
+ };
225
+ }
226
+ else {
227
+ const admit = await store.admitEdge({
228
+ sourceId,
229
+ targetId,
230
+ relationType: license.relationType,
231
+ strength: license.status === 'active' ? 0.7 : 0.4,
232
+ basis: {
233
+ memoryIds: [input.memoryId],
234
+ cue,
235
+ evidenceClass,
236
+ licensedAt: Date.now(),
237
+ },
238
+ evidenceText,
239
+ });
240
+ edgeOut.admit = admit;
241
+ }
242
+ }
243
+ edges.push(edgeOut);
244
+ }
245
+ return { nodes, edges, rejected };
246
+ }
@@ -4,9 +4,23 @@
4
4
  * 价值模型:fact / method / norm(见 docs/memory.md、arch/memory-system-redesign.md)。
5
5
  * system prompt ContextLayer 契约在 harness/context/。
6
6
  */
7
- export type { MemoryType, MemoryChannel, MemoryStatus, SoftDeleteReason, MemoryEntry, MemoryQuery, MemoryStats, MemoryStore, MemoryWriteSlot, WisdomEntry, WisdomStore, ConceptNode, ConceptEdge, ConceptGraph, ConceptGraphStore, } from './types.js';
8
- export { MEMORY_TYPES } from './types.js';
7
+ export type { MemoryType, MemoryChannel, MemoryStatus, SoftDeleteReason, MemoryEntry, MemoryQuery, MemoryStats, MemoryStore, MemoryWriteSlot, WisdomStatus, WisdomOrigin, WisdomKind, WisdomRetireReason, WisdomScenario, WisdomEffect, WisdomDerivation, WisdomCounterevidence, WisdomOutcomes, WisdomEntry, WisdomGateReason, WisdomGateOutcome, AdmitWisdomInput, AdmitWisdomAction, AdmitWisdomResult, WisdomInjectQuery, WisdomInjectPick, WisdomOutcomeSignal, WisdomOutcomeEvent, WisdomStats, WisdomStore, ConceptKind, ConceptRelationType, ConceptStatus, EvidenceClass, EdgeBasis, ConceptNode, ConceptEdge, ConceptGraph, MergeCandidate, EdgeAux, AdmitConceptInput, AdmitConceptResult, AdmitEdgeInput, AdmitEdgeResult, ConceptGateReason, SpreadingActivateOptions, ActivatedGraph, ConceptGraphStats, DecayResult, ConceptGraphStore, } from './types.js';
8
+ export { MEMORY_TYPES, WISDOM_STATUSES, WISDOM_INJECTABLE_STATUSES, WISDOM_ORIGINS, WISDOM_KINDS, CONCEPT_KINDS, CONCEPT_RELATION_TYPES, STRONG_RELATION_TYPES, } from './types.js';
9
+ export { evaluateWisdomGate, resolveInitialWisdomStatus, normalizeStatement, looksOpposed, WISDOM_DEFAULT_MIN_SUPPORT, } from './wisdom-gates.js';
10
+ export { DEFAULT_WISDOM_EVALUATION, DEFAULT_WISDOM_GOVERN, foldOutcomeEvents, planConfidenceUpdate, planWisdomGovern, wisdomUtility, wisdomInjectScore, } from './wisdom-policy.js';
11
+ export type { WisdomEvaluationConfig, WisdomGovernConfig, WisdomConfidenceUpdate, WisdomGoverPlanItem, } from './wisdom-policy.js';
12
+ export { parseWisdomFormationJson, normalizeWisdomFormation, toAdmitWisdomInput, formAndAdmit, scenarioMatchScore, pickForInjection, formatWisdomBody, } from './wisdom-formation.js';
13
+ export type { RawWisdomFormationOutput, ParsedWisdomItem, ParsedWisdomFormation, } from './wisdom-formation.js';
14
+ export { evaluateConceptGate, licenseEdge, edgeBasisFromLicense, normalizeForCue, } from './cognition-gates.js';
15
+ export type { ConceptGateOutcome, EdgeLicenseInput, EdgeLicenseOutcome, } from './cognition-gates.js';
16
+ export { DEFAULT_EDGE_DECAY_PER_DAY, DEFAULT_EDGE_DECAY_FLOOR, DEFAULT_RETRIEVE_STATUSES, decayMultiplier, nextEdgeStrength, hebbianStrengthen, counterEvidenceWeaken, } from './cognition-decay.js';
17
+ export type { EdgeDecayConfig } from './cognition-decay.js';
18
+ export { conceptualizeAndAdmit, parseConceptualizerJson, } from './conceptualizer.js';
19
+ export type { ConceptualizerInput, ConceptualizerResult, ConceptualizerNodeOut, ConceptualizerEdgeOut, RawConceptualizerOutput, } from './conceptualizer.js';
20
+ export { COGNITIZE_REQUEST_EVENT, emitConceptualizeRequest, } from './cognition-trigger.js';
21
+ export type { ConceptualizeRequestPayload } from './cognition-trigger.js';
9
22
  export { InMemoryMemoryStore } from './store.js';
23
+ export { InMemoryWisdomStore } from './wisdom.js';
10
24
  export { InMemoryConceptGraph } from './cognition.js';
11
25
  export { AgentDatabase, SqliteMemoryStore, SqliteWisdomStore, SqliteConceptGraph, createEmbeddingProvider, SqliteBackfillCoverageStore } from './sqlite/index.js';
12
26
  export type { AgentDatabaseOptions, SqliteMemoryStoreOptions, SqliteConceptGraphOptions, EmbeddingProvider, EmbeddingConfig } from './sqlite/index.js';
@@ -4,9 +4,19 @@
4
4
  * 价值模型:fact / method / norm(见 docs/memory.md、arch/memory-system-redesign.md)。
5
5
  * system prompt ContextLayer 契约在 harness/context/。
6
6
  */
7
- export { MEMORY_TYPES } from './types.js';
7
+ export { MEMORY_TYPES, WISDOM_STATUSES, WISDOM_INJECTABLE_STATUSES, WISDOM_ORIGINS, WISDOM_KINDS, CONCEPT_KINDS, CONCEPT_RELATION_TYPES, STRONG_RELATION_TYPES, } from './types.js';
8
+ // ── Wisdom 门控 / 策略 / 形成 ──
9
+ export { evaluateWisdomGate, resolveInitialWisdomStatus, normalizeStatement, looksOpposed, WISDOM_DEFAULT_MIN_SUPPORT, } from './wisdom-gates.js';
10
+ export { DEFAULT_WISDOM_EVALUATION, DEFAULT_WISDOM_GOVERN, foldOutcomeEvents, planConfidenceUpdate, planWisdomGovern, wisdomUtility, wisdomInjectScore, } from './wisdom-policy.js';
11
+ export { parseWisdomFormationJson, normalizeWisdomFormation, toAdmitWisdomInput, formAndAdmit, scenarioMatchScore, pickForInjection, formatWisdomBody, } from './wisdom-formation.js';
12
+ // ── Cognition 门控 / 可塑 / 概念化 ──
13
+ export { evaluateConceptGate, licenseEdge, edgeBasisFromLicense, normalizeForCue, } from './cognition-gates.js';
14
+ export { DEFAULT_EDGE_DECAY_PER_DAY, DEFAULT_EDGE_DECAY_FLOOR, DEFAULT_RETRIEVE_STATUSES, decayMultiplier, nextEdgeStrength, hebbianStrengthen, counterEvidenceWeaken, } from './cognition-decay.js';
15
+ export { conceptualizeAndAdmit, parseConceptualizerJson, } from './conceptualizer.js';
16
+ export { COGNITIZE_REQUEST_EVENT, emitConceptualizeRequest, } from './cognition-trigger.js';
8
17
  // ── 内存实现 ──
9
18
  export { InMemoryMemoryStore } from './store.js';
19
+ export { InMemoryWisdomStore } from './wisdom.js';
10
20
  export { InMemoryConceptGraph } from './cognition.js';
11
21
  // ── SQLite 实现 ──
12
22
  export { AgentDatabase, SqliteMemoryStore, SqliteWisdomStore, SqliteConceptGraph, createEmbeddingProvider, SqliteBackfillCoverageStore } from './sqlite/index.js';
@@ -41,6 +41,15 @@ export declare class AgentDatabase {
41
41
  get vectorDimensions(): number | null;
42
42
  /** 旧库升级:补齐 memories 治理列 + 旧类型映射(必须在依赖新列的 INDEX 之前) */
43
43
  private migrateMemoryColumns;
44
+ /**
45
+ * Cognition 表结构一次性重建(概念图未投入生产;发现旧列即 DROP 重建)。
46
+ * 禁止对旧 `concepts(name)` UNIQUE 语义做兼容——义项允许多节点同名。
47
+ */
48
+ private migrateConceptTables;
49
+ /**
50
+ * Wisdom 一次性重建:旧 content 形态无兼容价值,发现即 DROP(maxim 表随后 CREATE)。
51
+ */
52
+ private migrateWisdomTable;
44
53
  /**
45
54
  * 创建所有表结构
46
55
  *
@@ -111,6 +111,60 @@ export class AgentDatabase {
111
111
  WHERE type IN ('preference','decision','lesson','discovery','context','relationship')
112
112
  `);
113
113
  }
114
+ /**
115
+ * Cognition 表结构一次性重建(概念图未投入生产;发现旧列即 DROP 重建)。
116
+ * 禁止对旧 `concepts(name)` UNIQUE 语义做兼容——义项允许多节点同名。
117
+ */
118
+ migrateConceptTables() {
119
+ let needsRebuild = false;
120
+ try {
121
+ const cols = this.db.prepare('PRAGMA table_info(concepts)').all();
122
+ const names = new Set(cols.map((c) => c.name));
123
+ if (cols.length > 0 && (!names.has('kind') || !names.has('status') || !names.has('domain'))) {
124
+ needsRebuild = true;
125
+ }
126
+ }
127
+ catch {
128
+ // table missing — CREATE IF NOT EXISTS will handle
129
+ }
130
+ try {
131
+ const edgeCols = this.db.prepare('PRAGMA table_info(concept_edges)').all();
132
+ const edgeNames = new Set(edgeCols.map((c) => c.name));
133
+ if (edgeCols.length > 0 && (!edgeNames.has('status') || !edgeNames.has('basis'))) {
134
+ needsRebuild = true;
135
+ }
136
+ }
137
+ catch {
138
+ // ignore
139
+ }
140
+ if (!needsRebuild)
141
+ return;
142
+ this.db.exec(`
143
+ DROP TABLE IF EXISTS concept_edges_aux;
144
+ DROP TABLE IF EXISTS concept_merge_candidates;
145
+ DROP TABLE IF EXISTS concept_edges;
146
+ DROP TABLE IF EXISTS concepts;
147
+ `);
148
+ }
149
+ /**
150
+ * Wisdom 一次性重建:旧 content 形态无兼容价值,发现即 DROP(maxim 表随后 CREATE)。
151
+ */
152
+ migrateWisdomTable() {
153
+ let needsRebuild = false;
154
+ try {
155
+ const cols = this.db.prepare('PRAGMA table_info(wisdom)').all();
156
+ const names = new Set(cols.map((c) => c.name));
157
+ if (cols.length > 0 && (!names.has('statement') || names.has('content') || names.has('derived_from'))) {
158
+ needsRebuild = true;
159
+ }
160
+ }
161
+ catch {
162
+ // table missing — CREATE IF NOT EXISTS will handle
163
+ }
164
+ if (!needsRebuild)
165
+ return;
166
+ this.db.exec(`DROP TABLE IF EXISTS wisdom`);
167
+ }
114
168
  /**
115
169
  * 创建所有表结构
116
170
  *
@@ -148,6 +202,8 @@ export class AgentDatabase {
148
202
  `);
149
203
  // 旧库可能仍是无 deleted/status 的 schema —— 先补列再建索引
150
204
  this.migrateMemoryColumns();
205
+ this.migrateConceptTables();
206
+ this.migrateWisdomTable();
151
207
  this.db.exec(`
152
208
  CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
153
209
  CREATE INDEX IF NOT EXISTS idx_memories_confidence ON memories(confidence);
@@ -155,50 +211,89 @@ export class AgentDatabase {
155
211
  CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
156
212
  CREATE INDEX IF NOT EXISTS idx_memories_deleted ON memories(deleted);
157
213
 
158
- -- ── Concept 表 ──
214
+ -- ── Concept 表(cognition-graph-formation;义项可同名多节点)──
159
215
  CREATE TABLE IF NOT EXISTS concepts (
160
216
  id TEXT PRIMARY KEY,
161
217
  name TEXT NOT NULL,
218
+ kind TEXT NOT NULL DEFAULT 'construct',
162
219
  description TEXT,
163
220
  frequency INTEGER NOT NULL DEFAULT 1,
164
221
  memory_ids TEXT NOT NULL DEFAULT '[]',
165
- properties TEXT NOT NULL DEFAULT '[]',
222
+ domain TEXT NOT NULL DEFAULT '[]',
223
+ status TEXT NOT NULL DEFAULT 'shadow',
166
224
  embedding TEXT,
167
225
  created_at INTEGER NOT NULL,
168
226
  updated_at INTEGER NOT NULL
169
227
  );
170
228
 
171
- CREATE UNIQUE INDEX IF NOT EXISTS idx_concepts_name ON concepts(name);
172
-
173
- -- ── Concept Edge 表 ──
174
229
  CREATE TABLE IF NOT EXISTS concept_edges (
175
230
  id TEXT PRIMARY KEY,
176
- source_id TEXT NOT NULL REFERENCES concepts(id),
177
- target_id TEXT NOT NULL REFERENCES concepts(id),
231
+ source_id TEXT NOT NULL,
232
+ target_id TEXT NOT NULL,
178
233
  relation_type TEXT NOT NULL,
179
234
  strength REAL NOT NULL DEFAULT 0.5,
180
235
  description TEXT,
181
- constraints TEXT NOT NULL DEFAULT '[]',
236
+ status TEXT NOT NULL DEFAULT 'shadow',
237
+ basis TEXT NOT NULL DEFAULT '{}',
182
238
  created_at INTEGER NOT NULL,
239
+ updated_at INTEGER NOT NULL,
183
240
  UNIQUE(source_id, target_id, relation_type)
184
241
  );
185
242
 
243
+ CREATE TABLE IF NOT EXISTS concept_merge_candidates (
244
+ id TEXT PRIMARY KEY,
245
+ left_id TEXT NOT NULL,
246
+ right_id TEXT NOT NULL,
247
+ reason TEXT NOT NULL,
248
+ distance REAL,
249
+ fingerprint_diff TEXT NOT NULL DEFAULT '[]',
250
+ status TEXT NOT NULL DEFAULT 'open',
251
+ created_at INTEGER NOT NULL,
252
+ resolved_at INTEGER,
253
+ resolved_action TEXT
254
+ );
255
+
256
+ CREATE TABLE IF NOT EXISTS concept_edges_aux (
257
+ id TEXT PRIMARY KEY,
258
+ edge_key TEXT NOT NULL,
259
+ kind TEXT NOT NULL,
260
+ memory_ids TEXT NOT NULL DEFAULT '[]',
261
+ cue TEXT NOT NULL DEFAULT '',
262
+ note TEXT,
263
+ created_at INTEGER NOT NULL
264
+ );
265
+
266
+ CREATE INDEX IF NOT EXISTS idx_concepts_name ON concepts(name);
267
+ CREATE INDEX IF NOT EXISTS idx_concepts_status ON concepts(status);
268
+ CREATE INDEX IF NOT EXISTS idx_concepts_kind ON concepts(kind);
186
269
  CREATE INDEX IF NOT EXISTS idx_edges_source ON concept_edges(source_id);
187
270
  CREATE INDEX IF NOT EXISTS idx_edges_target ON concept_edges(target_id);
188
271
  CREATE INDEX IF NOT EXISTS idx_edges_type ON concept_edges(relation_type);
272
+ CREATE INDEX IF NOT EXISTS idx_edges_status ON concept_edges(status);
273
+ CREATE INDEX IF NOT EXISTS idx_merge_candidates_status ON concept_merge_candidates(status);
189
274
 
190
- -- ── Wisdom 表 ──
275
+ -- ── Wisdom 表(maxim)──旧 content 形态在 migrateWisdomSchema 一次性拆除
191
276
  CREATE TABLE IF NOT EXISTS wisdom (
192
277
  id TEXT PRIMARY KEY,
193
- content TEXT NOT NULL,
194
- derived_from TEXT NOT NULL DEFAULT '[]',
195
- priority INTEGER NOT NULL DEFAULT 0,
278
+ statement TEXT NOT NULL,
279
+ rationale TEXT,
280
+ scenario_json TEXT NOT NULL DEFAULT '{"problemTypes":[]}',
281
+ effect_json TEXT NOT NULL DEFAULT '{}',
282
+ status TEXT NOT NULL DEFAULT 'trial',
196
283
  confidence REAL NOT NULL DEFAULT 0.5,
197
- applicable_scenarios TEXT NOT NULL DEFAULT '[]',
198
- status TEXT NOT NULL DEFAULT 'active',
284
+ priority INTEGER NOT NULL DEFAULT 30,
285
+ derived_from_json TEXT NOT NULL DEFAULT '{"memoryIds":[]}',
286
+ exceptions_json TEXT NOT NULL DEFAULT '[]',
287
+ counterevidence_json TEXT NOT NULL DEFAULT '[]',
288
+ outcomes_json TEXT NOT NULL DEFAULT '{"applied":0,"cited":0,"assisted":0,"contested":0}',
289
+ origin TEXT NOT NULL DEFAULT 'distilled',
290
+ kind TEXT NOT NULL DEFAULT 'generalize',
291
+ superseded_by TEXT,
199
292
  created_at INTEGER NOT NULL,
200
293
  updated_at INTEGER NOT NULL
201
294
  );
295
+ CREATE INDEX IF NOT EXISTS idx_wisdom_status ON wisdom(status);
296
+ CREATE INDEX IF NOT EXISTS idx_wisdom_priority ON wisdom(priority);
202
297
 
203
298
  -- ── Knowledge Sources 注册表 ──
204
299
  CREATE TABLE IF NOT EXISTS knowledge_sources (
@@ -261,7 +356,15 @@ export class AgentDatabase {
261
356
  * 统计信息
262
357
  */
263
358
  stats() {
264
- const tables = ['memories', 'concepts', 'concept_edges', 'wisdom', 'knowledge_sources'];
359
+ const tables = [
360
+ 'memories',
361
+ 'concepts',
362
+ 'concept_edges',
363
+ 'concept_merge_candidates',
364
+ 'concept_edges_aux',
365
+ 'wisdom',
366
+ 'knowledge_sources',
367
+ ];
265
368
  const result = {};
266
369
  for (const table of tables) {
267
370
  try {
@@ -1,34 +1,73 @@
1
1
  /**
2
- * SqliteConceptGraph — SQLite 认知图谱
2
+ * SqliteConceptGraph — SQLite 认知图谱(生产路径)
3
+ *
4
+ * 契约见 arch/cognition-graph-formation.md:
5
+ * 结构同一性合并、持证边、衰减、扩散激活、merge_candidates、causal_candidate。
3
6
  *
4
7
  * @module
5
8
  */
6
- import type { ConceptGraphStore, ConceptNode, ConceptEdge, ConceptGraph } from '../cognition-types.js';
9
+ import type { ActivatedGraph, AdmitConceptInput, AdmitConceptResult, AdmitEdgeInput, AdmitEdgeResult, ConceptGraph, ConceptGraphStats, ConceptGraphStore, DecayResult, MergeCandidate, SpreadingActivateOptions } from '../cognition-types.js';
7
10
  import { AgentDatabase } from './agent-db.js';
8
11
  import type { EmbeddingProvider } from './embedding.js';
9
12
  export interface SqliteConceptGraphOptions {
10
13
  embeddingProvider?: EmbeddingProvider | null;
11
- /** 自动合并的 cosine distance 阈值(默认 0.25) */
14
+ /** embedding 自动合并距离上限(仅指纹兼容时);默认 0.20 */
12
15
  mergeThreshold?: number;
16
+ /** 近阈带上界;[lo, hi) 写 merge_candidates,默认 0.35 */
17
+ candidateBandHi?: number;
18
+ /** capacity 软顶 */
19
+ warnNodes?: number;
20
+ warnEdges?: number;
21
+ stopNodes?: number;
22
+ stopEdges?: number;
23
+ decayFloor?: number;
24
+ /** causes 最少独立命题(默认 2) */
25
+ causesMinIndependentMemories?: number;
13
26
  }
14
27
  export declare class SqliteConceptGraph implements ConceptGraphStore {
15
28
  private db;
16
29
  private embedding;
17
30
  private mergeThreshold;
31
+ private candidateBandHi;
32
+ private stopNodes;
33
+ private stopEdges;
34
+ private decayFloor;
35
+ private causesMinIndependentMemories;
18
36
  constructor(db: AgentDatabase, options?: SqliteConceptGraphOptions);
19
- addConcept(concept: Omit<ConceptNode, 'id' | 'frequency' | 'memoryIds'>): Promise<string>;
20
- addEdge(edge: ConceptEdge): Promise<void>;
21
- queryRelated(conceptName: string, depth?: number): Promise<ConceptGraph>;
22
- extractFromText(text: string, memoryId: string): Promise<void>;
23
- getFullGraph(): Promise<ConceptGraph>;
24
- /**
25
- * 查找语义相似的概念(用于去重)
26
- */
27
- private findSimilarConcept;
28
- /**
29
- * 关联记忆到概念(从外部调用)
30
- */
31
- linkMemory(conceptId: string, memoryId: string): void;
37
+ private get capacityStop();
32
38
  private rowToNode;
33
39
  private rowToEdge;
40
+ admitConcept(input: AdmitConceptInput): Promise<AdmitConceptResult>;
41
+ private fingerprintConflict;
42
+ private insertConcept;
43
+ private insertMergeCandidate;
44
+ private findSimilarConcept;
45
+ /** 同 pair(无向)已有 memoryIds:边 basis + causal_candidate */
46
+ private collectPairMemoryIds;
47
+ admitEdge(input: AdmitEdgeInput): Promise<AdmitEdgeResult>;
48
+ addCausalCandidate(input: {
49
+ sourceId: string;
50
+ targetId: string;
51
+ memoryIds: string[];
52
+ cue: string;
53
+ note?: string;
54
+ }): Promise<void>;
55
+ listMergeCandidates(limit?: number): Promise<MergeCandidate[]>;
56
+ resolveMerge(id: string, action: 'merge' | 'keep_split' | 'drop'): Promise<void>;
57
+ reinforce(input: {
58
+ nodeIds?: string[];
59
+ edgeIds?: string[];
60
+ evidenceStrength?: number;
61
+ }): Promise<void>;
62
+ counterEvidence(input: {
63
+ edgeId: string;
64
+ memoryId?: string;
65
+ markOpposes?: boolean;
66
+ }): Promise<void>;
67
+ promote(ids: string[], to: 'active' | 'strengthened'): Promise<void>;
68
+ demote(ids: string[], to: 'shadow'): Promise<void>;
69
+ applyDecay(now?: number): Promise<DecayResult>;
70
+ spreadingActivate(seeds: string[], options?: SpreadingActivateOptions): Promise<ActivatedGraph>;
71
+ getFullGraph(): Promise<ConceptGraph>;
72
+ stats(): Promise<ConceptGraphStats>;
34
73
  }