@jonathangu/openclawbrain 0.3.0
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.
- package/LICENSE +21 -0
- package/README.md +412 -0
- package/bin/openclawbrain.js +15 -0
- package/docs/END_STATE.md +244 -0
- package/docs/EVIDENCE.md +128 -0
- package/docs/RELEASE_CONTRACT.md +91 -0
- package/docs/agent-tools.md +106 -0
- package/docs/architecture.md +224 -0
- package/docs/configuration.md +178 -0
- package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/status.json +87 -0
- package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/summary.md +16 -0
- package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/trace.json +273 -0
- package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/validation-report.json +652 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/channels-status.txt +31 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/config-snapshot.json +66 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/doctor.json +14 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/gateway-probe.txt +34 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/gateway-status.txt +41 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/logs.txt +428 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/status-all.txt +60 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/status.json +223 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/summary.md +13 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/trace.json +4 -0
- package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/validation-report.json +334 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/channels-status.txt +25 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/config-snapshot.json +91 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/doctor.json +14 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/gateway-probe.txt +36 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/gateway-status.txt +44 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/logs.txt +428 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/preflight-doctor.json +10 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/preflight-sdk-probe.json +11 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/preflight-setup-only.json +12 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/summary.md +30 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/validation-report.json +72 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/status-all.txt +63 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/status.json +200 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/summary.md +13 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/trace.json +4 -0
- package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/validation-report.json +311 -0
- package/docs/evidence/README.md +16 -0
- package/docs/fts5.md +161 -0
- package/docs/tui.md +506 -0
- package/index.ts +1372 -0
- package/openclaw.plugin.json +136 -0
- package/package.json +66 -0
- package/src/assembler.ts +804 -0
- package/src/brain-cli.ts +316 -0
- package/src/brain-core/decay.ts +35 -0
- package/src/brain-core/episode.ts +82 -0
- package/src/brain-core/graph.ts +321 -0
- package/src/brain-core/health.ts +116 -0
- package/src/brain-core/mutator.ts +281 -0
- package/src/brain-core/pack.ts +117 -0
- package/src/brain-core/policy.ts +153 -0
- package/src/brain-core/replay.ts +1 -0
- package/src/brain-core/teacher.ts +105 -0
- package/src/brain-core/trace.ts +40 -0
- package/src/brain-core/traverse.ts +230 -0
- package/src/brain-core/types.ts +405 -0
- package/src/brain-core/update.ts +123 -0
- package/src/brain-harvest/human.ts +46 -0
- package/src/brain-harvest/scanner.ts +98 -0
- package/src/brain-harvest/self.ts +147 -0
- package/src/brain-runtime/assembler-extension.ts +230 -0
- package/src/brain-runtime/evidence-detectors.ts +68 -0
- package/src/brain-runtime/graph-io.ts +72 -0
- package/src/brain-runtime/harvester-extension.ts +98 -0
- package/src/brain-runtime/service.ts +659 -0
- package/src/brain-runtime/tools.ts +109 -0
- package/src/brain-runtime/worker-state.ts +106 -0
- package/src/brain-runtime/worker-supervisor.ts +169 -0
- package/src/brain-store/embedding.ts +179 -0
- package/src/brain-store/init.ts +347 -0
- package/src/brain-store/migrations.ts +188 -0
- package/src/brain-store/store.ts +816 -0
- package/src/brain-worker/child-runner.ts +321 -0
- package/src/brain-worker/jobs.ts +12 -0
- package/src/brain-worker/mutation-job.ts +5 -0
- package/src/brain-worker/promotion-job.ts +5 -0
- package/src/brain-worker/protocol.ts +79 -0
- package/src/brain-worker/teacher-job.ts +5 -0
- package/src/brain-worker/update-job.ts +5 -0
- package/src/brain-worker/worker.ts +422 -0
- package/src/compaction.ts +1332 -0
- package/src/db/config.ts +265 -0
- package/src/db/connection.ts +72 -0
- package/src/db/features.ts +42 -0
- package/src/db/migration.ts +561 -0
- package/src/engine.ts +1995 -0
- package/src/expansion-auth.ts +351 -0
- package/src/expansion-policy.ts +303 -0
- package/src/expansion.ts +383 -0
- package/src/integrity.ts +600 -0
- package/src/large-files.ts +527 -0
- package/src/openclaw-bridge.ts +22 -0
- package/src/retrieval.ts +357 -0
- package/src/store/conversation-store.ts +748 -0
- package/src/store/fts5-sanitize.ts +29 -0
- package/src/store/full-text-fallback.ts +74 -0
- package/src/store/index.ts +29 -0
- package/src/store/summary-store.ts +918 -0
- package/src/summarize.ts +847 -0
- package/src/tools/common.ts +53 -0
- package/src/tools/lcm-conversation-scope.ts +76 -0
- package/src/tools/lcm-describe-tool.ts +234 -0
- package/src/tools/lcm-expand-query-tool.ts +594 -0
- package/src/tools/lcm-expand-tool.delegation.ts +556 -0
- package/src/tools/lcm-expand-tool.ts +448 -0
- package/src/tools/lcm-expansion-recursion-guard.ts +286 -0
- package/src/tools/lcm-grep-tool.ts +200 -0
- package/src/transcript-repair.ts +301 -0
- package/src/types.ts +149 -0
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "openclawbrain",
|
|
3
|
+
"uiHints": {
|
|
4
|
+
"contextThreshold": {
|
|
5
|
+
"label": "Context Threshold",
|
|
6
|
+
"help": "Fraction of context window that triggers compaction (0.0–1.0)"
|
|
7
|
+
},
|
|
8
|
+
"incrementalMaxDepth": {
|
|
9
|
+
"label": "Incremental Max Depth",
|
|
10
|
+
"help": "How deep incremental compaction goes (0 = leaf only, -1 = unlimited)"
|
|
11
|
+
},
|
|
12
|
+
"freshTailCount": {
|
|
13
|
+
"label": "Fresh Tail Count",
|
|
14
|
+
"help": "Number of recent messages protected from compaction"
|
|
15
|
+
},
|
|
16
|
+
"dbPath": {
|
|
17
|
+
"label": "Database Path",
|
|
18
|
+
"help": "Path to LCM SQLite database (default: ~/.openclaw/lcm.db)"
|
|
19
|
+
},
|
|
20
|
+
"summaryModel": {
|
|
21
|
+
"label": "Summary Model",
|
|
22
|
+
"help": "Model override for LCM summarization (e.g., 'gpt-5.4' or 'openai-resp/gpt-5.4')"
|
|
23
|
+
},
|
|
24
|
+
"summaryProvider": {
|
|
25
|
+
"label": "Summary Provider",
|
|
26
|
+
"help": "Provider override for LCM summarization (e.g., 'openai-resp')"
|
|
27
|
+
},
|
|
28
|
+
"brainRoot": {
|
|
29
|
+
"label": "Brain Root",
|
|
30
|
+
"help": "Directory containing OpenClawBrain state.db and immutable packs"
|
|
31
|
+
},
|
|
32
|
+
"brainEmbeddingProvider": {
|
|
33
|
+
"label": "Embedding Provider",
|
|
34
|
+
"help": "Provider used for learned retrieval embeddings"
|
|
35
|
+
},
|
|
36
|
+
"brainEmbeddingModel": {
|
|
37
|
+
"label": "Embedding Model",
|
|
38
|
+
"help": "Embedding model used for init, retrieval, and brain_teach"
|
|
39
|
+
},
|
|
40
|
+
"brainWorkerMode": {
|
|
41
|
+
"label": "Worker Mode",
|
|
42
|
+
"help": "Run the learner in a supervised child process (default) or fall back to in-process mode"
|
|
43
|
+
}
|
|
44
|
+
},
|
|
45
|
+
"configSchema": {
|
|
46
|
+
"type": "object",
|
|
47
|
+
"additionalProperties": false,
|
|
48
|
+
"properties": {
|
|
49
|
+
"enabled": {
|
|
50
|
+
"type": "boolean"
|
|
51
|
+
},
|
|
52
|
+
"contextThreshold": {
|
|
53
|
+
"type": "number",
|
|
54
|
+
"minimum": 0,
|
|
55
|
+
"maximum": 1
|
|
56
|
+
},
|
|
57
|
+
"incrementalMaxDepth": {
|
|
58
|
+
"type": "integer",
|
|
59
|
+
"minimum": -1
|
|
60
|
+
},
|
|
61
|
+
"freshTailCount": {
|
|
62
|
+
"type": "integer",
|
|
63
|
+
"minimum": 1
|
|
64
|
+
},
|
|
65
|
+
"leafMinFanout": {
|
|
66
|
+
"type": "integer",
|
|
67
|
+
"minimum": 2
|
|
68
|
+
},
|
|
69
|
+
"condensedMinFanout": {
|
|
70
|
+
"type": "integer",
|
|
71
|
+
"minimum": 2
|
|
72
|
+
},
|
|
73
|
+
"condensedMinFanoutHard": {
|
|
74
|
+
"type": "integer",
|
|
75
|
+
"minimum": 2
|
|
76
|
+
},
|
|
77
|
+
"dbPath": {
|
|
78
|
+
"type": "string"
|
|
79
|
+
},
|
|
80
|
+
"largeFileThresholdTokens": {
|
|
81
|
+
"type": "integer",
|
|
82
|
+
"minimum": 1000
|
|
83
|
+
},
|
|
84
|
+
"summaryModel": {
|
|
85
|
+
"type": "string"
|
|
86
|
+
},
|
|
87
|
+
"summaryProvider": {
|
|
88
|
+
"type": "string"
|
|
89
|
+
},
|
|
90
|
+
"brainEnabled": {
|
|
91
|
+
"type": "boolean"
|
|
92
|
+
},
|
|
93
|
+
"brainRoot": {
|
|
94
|
+
"type": "string"
|
|
95
|
+
},
|
|
96
|
+
"brainEmbeddingProvider": {
|
|
97
|
+
"type": "string"
|
|
98
|
+
},
|
|
99
|
+
"brainEmbeddingModel": {
|
|
100
|
+
"type": "string"
|
|
101
|
+
},
|
|
102
|
+
"brainEmbeddingBaseUrl": {
|
|
103
|
+
"type": "string"
|
|
104
|
+
},
|
|
105
|
+
"brainMaxHops": {
|
|
106
|
+
"type": "integer",
|
|
107
|
+
"minimum": 1
|
|
108
|
+
},
|
|
109
|
+
"brainMaxSeeds": {
|
|
110
|
+
"type": "integer",
|
|
111
|
+
"minimum": 1
|
|
112
|
+
},
|
|
113
|
+
"brainSemanticThreshold": {
|
|
114
|
+
"type": "number",
|
|
115
|
+
"minimum": 0,
|
|
116
|
+
"maximum": 1
|
|
117
|
+
},
|
|
118
|
+
"brainTrainerIntervalMs": {
|
|
119
|
+
"type": "integer",
|
|
120
|
+
"minimum": 1000
|
|
121
|
+
},
|
|
122
|
+
"brainWorkerMode": {
|
|
123
|
+
"type": "string",
|
|
124
|
+
"enum": ["child", "in_process"]
|
|
125
|
+
},
|
|
126
|
+
"brainWorkerHeartbeatTimeoutMs": {
|
|
127
|
+
"type": "integer",
|
|
128
|
+
"minimum": 1000
|
|
129
|
+
},
|
|
130
|
+
"brainWorkerRestartDelayMs": {
|
|
131
|
+
"type": "integer",
|
|
132
|
+
"minimum": 0
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
}
|
package/package.json
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@jonathangu/openclawbrain",
|
|
3
|
+
"version": "0.3.0",
|
|
4
|
+
"description": "OpenClawBrain v2 for OpenClaw — lossless transcript memory with a clean learning-layer rebuild",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "index.ts",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"author": "Jonathan Gu",
|
|
9
|
+
"keywords": [
|
|
10
|
+
"openclaw",
|
|
11
|
+
"openclaw-plugin",
|
|
12
|
+
"context-management",
|
|
13
|
+
"llm",
|
|
14
|
+
"summarization",
|
|
15
|
+
"conversation-memory",
|
|
16
|
+
"dag"
|
|
17
|
+
],
|
|
18
|
+
"files": [
|
|
19
|
+
"bin/",
|
|
20
|
+
"index.ts",
|
|
21
|
+
"src/**/*.ts",
|
|
22
|
+
"openclaw.plugin.json",
|
|
23
|
+
"docs/",
|
|
24
|
+
"README.md",
|
|
25
|
+
"LICENSE"
|
|
26
|
+
],
|
|
27
|
+
"scripts": {
|
|
28
|
+
"changeset": "changeset",
|
|
29
|
+
"release:verify": "npm test && npm pack --dry-run",
|
|
30
|
+
"test": "vitest run --dir test",
|
|
31
|
+
"version-packages": "changeset version"
|
|
32
|
+
},
|
|
33
|
+
"dependencies": {
|
|
34
|
+
"@mariozechner/pi-agent-core": "*",
|
|
35
|
+
"@mariozechner/pi-ai": "*",
|
|
36
|
+
"@sinclair/typebox": "0.34.48",
|
|
37
|
+
"tsx": "^4.20.6"
|
|
38
|
+
},
|
|
39
|
+
"devDependencies": {
|
|
40
|
+
"@changesets/cli": "^2.30.0",
|
|
41
|
+
"typescript": "^5.7.0",
|
|
42
|
+
"vitest": "^3.0.0"
|
|
43
|
+
},
|
|
44
|
+
"peerDependencies": {
|
|
45
|
+
"openclaw": "*"
|
|
46
|
+
},
|
|
47
|
+
"publishConfig": {
|
|
48
|
+
"access": "public"
|
|
49
|
+
},
|
|
50
|
+
"bin": {
|
|
51
|
+
"openclawbrain": "./bin/openclawbrain.js"
|
|
52
|
+
},
|
|
53
|
+
"openclaw": {
|
|
54
|
+
"extensions": [
|
|
55
|
+
"./index.ts"
|
|
56
|
+
]
|
|
57
|
+
},
|
|
58
|
+
"repository": {
|
|
59
|
+
"type": "git",
|
|
60
|
+
"url": "git+https://github.com/jonathangu/openclawbrain.git"
|
|
61
|
+
},
|
|
62
|
+
"homepage": "https://github.com/jonathangu/openclawbrain#readme",
|
|
63
|
+
"bugs": {
|
|
64
|
+
"url": "https://github.com/jonathangu/openclawbrain/issues"
|
|
65
|
+
}
|
|
66
|
+
}
|