@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.
Files changed (113) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +412 -0
  3. package/bin/openclawbrain.js +15 -0
  4. package/docs/END_STATE.md +244 -0
  5. package/docs/EVIDENCE.md +128 -0
  6. package/docs/RELEASE_CONTRACT.md +91 -0
  7. package/docs/agent-tools.md +106 -0
  8. package/docs/architecture.md +224 -0
  9. package/docs/configuration.md +178 -0
  10. package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/status.json +87 -0
  11. package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/summary.md +16 -0
  12. package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/trace.json +273 -0
  13. package/docs/evidence/2026-03-16/3188b50c4ed30f07dea111e35ce52aabefaced63/brain-teach-session-bound/validation-report.json +652 -0
  14. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/channels-status.txt +31 -0
  15. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/config-snapshot.json +66 -0
  16. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/doctor.json +14 -0
  17. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/gateway-probe.txt +34 -0
  18. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/gateway-status.txt +41 -0
  19. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/logs.txt +428 -0
  20. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/status-all.txt +60 -0
  21. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/status.json +223 -0
  22. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/summary.md +13 -0
  23. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/trace.json +4 -0
  24. package/docs/evidence/2026-03-16/4941429588810da5d6f7ef1509f229f83fa08031/validation-report.json +334 -0
  25. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/channels-status.txt +25 -0
  26. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/config-snapshot.json +91 -0
  27. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/doctor.json +14 -0
  28. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/gateway-probe.txt +36 -0
  29. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/gateway-status.txt +44 -0
  30. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/logs.txt +428 -0
  31. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/preflight-doctor.json +10 -0
  32. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/preflight-sdk-probe.json +11 -0
  33. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/preflight-setup-only.json +12 -0
  34. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/summary.md +30 -0
  35. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/short-static-classification/validation-report.json +72 -0
  36. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/status-all.txt +63 -0
  37. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/status.json +200 -0
  38. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/summary.md +13 -0
  39. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/trace.json +4 -0
  40. package/docs/evidence/2026-03-16/7f8dbcb27e741abdeefd5656c210639d0acdd440/validation-report.json +311 -0
  41. package/docs/evidence/README.md +16 -0
  42. package/docs/fts5.md +161 -0
  43. package/docs/tui.md +506 -0
  44. package/index.ts +1372 -0
  45. package/openclaw.plugin.json +136 -0
  46. package/package.json +66 -0
  47. package/src/assembler.ts +804 -0
  48. package/src/brain-cli.ts +316 -0
  49. package/src/brain-core/decay.ts +35 -0
  50. package/src/brain-core/episode.ts +82 -0
  51. package/src/brain-core/graph.ts +321 -0
  52. package/src/brain-core/health.ts +116 -0
  53. package/src/brain-core/mutator.ts +281 -0
  54. package/src/brain-core/pack.ts +117 -0
  55. package/src/brain-core/policy.ts +153 -0
  56. package/src/brain-core/replay.ts +1 -0
  57. package/src/brain-core/teacher.ts +105 -0
  58. package/src/brain-core/trace.ts +40 -0
  59. package/src/brain-core/traverse.ts +230 -0
  60. package/src/brain-core/types.ts +405 -0
  61. package/src/brain-core/update.ts +123 -0
  62. package/src/brain-harvest/human.ts +46 -0
  63. package/src/brain-harvest/scanner.ts +98 -0
  64. package/src/brain-harvest/self.ts +147 -0
  65. package/src/brain-runtime/assembler-extension.ts +230 -0
  66. package/src/brain-runtime/evidence-detectors.ts +68 -0
  67. package/src/brain-runtime/graph-io.ts +72 -0
  68. package/src/brain-runtime/harvester-extension.ts +98 -0
  69. package/src/brain-runtime/service.ts +659 -0
  70. package/src/brain-runtime/tools.ts +109 -0
  71. package/src/brain-runtime/worker-state.ts +106 -0
  72. package/src/brain-runtime/worker-supervisor.ts +169 -0
  73. package/src/brain-store/embedding.ts +179 -0
  74. package/src/brain-store/init.ts +347 -0
  75. package/src/brain-store/migrations.ts +188 -0
  76. package/src/brain-store/store.ts +816 -0
  77. package/src/brain-worker/child-runner.ts +321 -0
  78. package/src/brain-worker/jobs.ts +12 -0
  79. package/src/brain-worker/mutation-job.ts +5 -0
  80. package/src/brain-worker/promotion-job.ts +5 -0
  81. package/src/brain-worker/protocol.ts +79 -0
  82. package/src/brain-worker/teacher-job.ts +5 -0
  83. package/src/brain-worker/update-job.ts +5 -0
  84. package/src/brain-worker/worker.ts +422 -0
  85. package/src/compaction.ts +1332 -0
  86. package/src/db/config.ts +265 -0
  87. package/src/db/connection.ts +72 -0
  88. package/src/db/features.ts +42 -0
  89. package/src/db/migration.ts +561 -0
  90. package/src/engine.ts +1995 -0
  91. package/src/expansion-auth.ts +351 -0
  92. package/src/expansion-policy.ts +303 -0
  93. package/src/expansion.ts +383 -0
  94. package/src/integrity.ts +600 -0
  95. package/src/large-files.ts +527 -0
  96. package/src/openclaw-bridge.ts +22 -0
  97. package/src/retrieval.ts +357 -0
  98. package/src/store/conversation-store.ts +748 -0
  99. package/src/store/fts5-sanitize.ts +29 -0
  100. package/src/store/full-text-fallback.ts +74 -0
  101. package/src/store/index.ts +29 -0
  102. package/src/store/summary-store.ts +918 -0
  103. package/src/summarize.ts +847 -0
  104. package/src/tools/common.ts +53 -0
  105. package/src/tools/lcm-conversation-scope.ts +76 -0
  106. package/src/tools/lcm-describe-tool.ts +234 -0
  107. package/src/tools/lcm-expand-query-tool.ts +594 -0
  108. package/src/tools/lcm-expand-tool.delegation.ts +556 -0
  109. package/src/tools/lcm-expand-tool.ts +448 -0
  110. package/src/tools/lcm-expansion-recursion-guard.ts +286 -0
  111. package/src/tools/lcm-grep-tool.ts +200 -0
  112. package/src/transcript-repair.ts +301 -0
  113. 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
+ }