@yahyahammad/venastine 0.2.0 → 0.3.9

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 (152) hide show
  1. package/.env.example +9 -4
  2. package/CONFIG_ARCHITECTURE.md +2030 -0
  3. package/LICENSE +201 -201
  4. package/NOTICE +1 -1
  5. package/README.md +1034 -895
  6. package/agents/builtin/build.md +73 -0
  7. package/agents/builtin/compactor.md +75 -75
  8. package/agents/builtin/explore.md +77 -77
  9. package/agents/builtin/general.md +80 -0
  10. package/agents/builtin/pipeline-reviewer.md +100 -100
  11. package/agents/builtin/plan.md +106 -88
  12. package/agents/builtin/review.md +74 -74
  13. package/agents/builtin/test.md +65 -0
  14. package/agents/builtin/writer.md +67 -0
  15. package/agents/manager.py +68 -2
  16. package/agents/subagent_tool.py +472 -238
  17. package/agents/tui_commands.py +238 -151
  18. package/bin/venastine.mjs +150 -4
  19. package/bin/venastine.py +71 -0
  20. package/cli_commands.py +838 -0
  21. package/config.py +95 -1198
  22. package/config.yaml +1103 -0
  23. package/config_edit.py +1301 -0
  24. package/config_schema.py +971 -0
  25. package/config_update.py +749 -0
  26. package/core/agent_activity.py +256 -118
  27. package/core/ansi.py +452 -0
  28. package/core/approval.py +137 -115
  29. package/core/call_view.py +364 -0
  30. package/core/cancel.py +121 -0
  31. package/core/chatgpt_auth.py +747 -0
  32. package/core/claims_view.py +107 -0
  33. package/core/client.py +2715 -1559
  34. package/core/commands.py +460 -0
  35. package/core/compaction.py +1735 -971
  36. package/core/config_loader.py +1982 -1563
  37. package/core/connect.py +686 -0
  38. package/core/events.py +123 -61
  39. package/core/file_mentions.py +280 -0
  40. package/core/interaction.py +411 -328
  41. package/core/line_pattern.py +128 -0
  42. package/core/loop.py +2566 -1490
  43. package/core/memory.py +482 -370
  44. package/core/pipeline_models.py +190 -176
  45. package/core/provider_errors.py +234 -0
  46. package/core/reasoning/authorization.py +130 -130
  47. package/core/reasoning/base.py +219 -219
  48. package/core/reasoning/confidence_scoring.py +484 -468
  49. package/core/reasoning/events.py +149 -149
  50. package/core/reasoning/json_retry.py +19 -1
  51. package/core/reasoning/orchestrator.py +1561 -1382
  52. package/core/reasoning/output_writer.py +345 -286
  53. package/core/reasoning/payload_validation.py +524 -398
  54. package/core/reasoning/pipeline_storage.py +88 -22
  55. package/core/reasoning/review.py +659 -615
  56. package/core/reasoning/scholar.py +458 -434
  57. package/core/reasoning/source_corpus.py +433 -327
  58. package/core/reasoning/source_scoring.py +855 -855
  59. package/core/replay.py +315 -183
  60. package/core/session.py +36 -12
  61. package/core/session_view.py +259 -0
  62. package/core/session_wake.py +259 -0
  63. package/core/shell_sessions.py +1553 -0
  64. package/core/workspace_trust.py +1 -1
  65. package/credentials.py +148 -20
  66. package/database.py +333 -252
  67. package/{PRIVACY.md → docs/PRIVACY.md} +78 -66
  68. package/docs/SECURITY.md +108 -0
  69. package/docs/THIRD_PARTY_NOTICES.md +148 -0
  70. package/env_secrets.py +50 -9
  71. package/json_store.py +343 -123
  72. package/logging_setup.py +295 -185
  73. package/main.py +3433 -1961
  74. package/mcp_client/client.py +733 -499
  75. package/mcp_client/config.py +126 -21
  76. package/mcp_client/registration.py +343 -182
  77. package/memories/manager.py +147 -132
  78. package/memories/tui_commands.py +319 -244
  79. package/package.json +303 -73
  80. package/project_init/config_files.py +282 -278
  81. package/project_init/generator.py +728 -564
  82. package/project_init/manifest.py +18 -6
  83. package/project_init/tui_commands.py +147 -144
  84. package/prompts/critic_pass.md +24 -24
  85. package/prompts/revalidate.md +25 -25
  86. package/prompts/revise.md +2 -0
  87. package/prompts/source_grounding.md +66 -66
  88. package/prompts/system_prompts.py +316 -262
  89. package/providers.json.example +4 -2
  90. package/pyproject.toml +149 -100
  91. package/requirements.txt +295 -72
  92. package/safety/policy_enforcement.py +1082 -746
  93. package/security/askpass.py +419 -0
  94. package/security/capability.py +207 -177
  95. package/security/confine.py +484 -0
  96. package/security/hosted.py +182 -0
  97. package/security/permissions.py +237 -190
  98. package/security/posture.py +124 -12
  99. package/security/protected_paths.py +501 -309
  100. package/security/sandbox.py +4108 -985
  101. package/security/secrets.py +855 -0
  102. package/skills/builtin/math/formal-specification.md +67 -67
  103. package/skills/builtin/math/numerical-methods.md +66 -66
  104. package/skills/builtin/research/experiment-design.md +62 -62
  105. package/skills/builtin/research/reproducibility.md +55 -55
  106. package/skills/builtin/research/source-evaluation.md +70 -70
  107. package/skills/builtin/research/statistical-inference.md +63 -63
  108. package/skills/builtin/research/technical-writing.md +59 -59
  109. package/skills/builtin/software/code-review.md +61 -61
  110. package/skills/builtin/software/debugging.md +61 -61
  111. package/skills/builtin/software/test-design.md +67 -67
  112. package/skills/tui_commands.py +110 -111
  113. package/storage.py +1338 -1005
  114. package/tools/base.py +161 -1
  115. package/tools/builtin/_math_common.py +667 -377
  116. package/tools/builtin/_net_common.py +225 -19
  117. package/tools/builtin/arxiv.py +497 -39
  118. package/tools/builtin/ask_user.py +231 -213
  119. package/tools/builtin/discrete_math.py +35 -4
  120. package/tools/builtin/fetch_url.py +371 -153
  121. package/tools/builtin/file_ops.py +720 -412
  122. package/tools/builtin/geometry.py +48 -12
  123. package/tools/builtin/get_time.py +2 -2
  124. package/tools/builtin/linear_algebra.py +66 -23
  125. package/tools/builtin/load_skill.py +76 -66
  126. package/tools/builtin/logic.py +171 -12
  127. package/tools/builtin/pin.py +227 -193
  128. package/tools/builtin/probability_stats.py +12 -16
  129. package/tools/builtin/project_docs.py +464 -405
  130. package/tools/builtin/remember.py +175 -158
  131. package/tools/builtin/shell.py +980 -461
  132. package/tools/builtin/shell_sessions.py +613 -0
  133. package/tools/builtin/symbolic_math.py +80 -10
  134. package/tools/builtin/todo.py +149 -147
  135. package/tools/builtin/web_search.py +191 -13
  136. package/tools/context.py +159 -136
  137. package/tools/isolation.py +107 -34
  138. package/tools/registry.py +1242 -925
  139. package/tui/app.py +8318 -4100
  140. package/tui/app.tcss +747 -556
  141. package/tui/commands.py +26 -170
  142. package/tui/diffs.py +34 -13
  143. package/tui/history.py +128 -128
  144. package/tui/hosted_driver.py +102 -0
  145. package/tui/markdown.py +1329 -1279
  146. package/tui/meters.py +364 -268
  147. package/tui/ravens.py +146 -146
  148. package/tui/screens.py +1255 -943
  149. package/tui/themes.py +599 -559
  150. package/tui/widgets.py +3813 -2332
  151. package/SECURITY.md +0 -88
  152. package/THIRD_PARTY_NOTICES.md +0 -100
package/package.json CHANGED
@@ -1,73 +1,303 @@
1
- {
2
- "name": "@yahyahammad/venastine",
3
- "version": "0.2.0",
4
- "description": "A from-scratch agentic harness: tool-using chat plus a ten-pass self-critiquing research pipeline.",
5
- "keywords": [
6
- "agent",
7
- "llm",
8
- "research",
9
- "anthropic",
10
- "openai",
11
- "mcp"
12
- ],
13
- "homepage": "https://github.com/YahyaHammad/Venastine-Research-Harness#readme",
14
- "bugs": {
15
- "url": "https://github.com/YahyaHammad/Venastine-Research-Harness/issues"
16
- },
17
- "repository": {
18
- "type": "git",
19
- "url": "git+https://github.com/YahyaHammad/Venastine-Research-Harness.git"
20
- },
21
- "license": "Apache-2.0",
22
- "author": "Yahya Hammad",
23
- "type": "module",
24
- "bin": {
25
- "venastine": "bin/venastine.mjs"
26
- },
27
- "engines": {
28
- "node": ">=18"
29
- },
30
- "publishConfig": {
31
- "access": "public"
32
- },
33
- "scripts": {
34
- "prepublishOnly": "node scripts/prepublish-check.mjs",
35
- "check-pack": "node scripts/prepublish-check.mjs"
36
- },
37
- "files": [
38
- "bin/",
39
- "main.py",
40
- "config.py",
41
- "storage.py",
42
- "database.py",
43
- "credentials.py",
44
- "env_secrets.py",
45
- "logging_setup.py",
46
- "json_store.py",
47
- "core/",
48
- "tools/",
49
- "tui/",
50
- "agents/",
51
- "skills/",
52
- "prompts/",
53
- "mcp_client/",
54
- "security/",
55
- "safety/",
56
- "memories/",
57
- "project_init/",
58
- "requirements.txt",
59
- "pyproject.toml",
60
- "README.md",
61
- "LICENSE",
62
- "NOTICE",
63
- "THIRD_PARTY_NOTICES.md",
64
- "SECURITY.md",
65
- "PRIVACY.md",
66
- "providers.json.example",
67
- ".env.example",
68
- "!**/__pycache__",
69
- "!**/*.pyc",
70
- "!**/.ipynb_checkpoints",
71
- "!**/.pytest_cache"
72
- ]
73
- }
1
+ {
2
+ "name": "@yahyahammad/venastine",
3
+ "version": "0.3.9",
4
+ "description": "A from-scratch agentic harness: tool-using chat plus a ten-pass self-critiquing research pipeline.",
5
+ "keywords": [
6
+ "agent",
7
+ "llm",
8
+ "research",
9
+ "anthropic",
10
+ "openai",
11
+ "mcp"
12
+ ],
13
+ "homepage": "https://github.com/YahyaHammad/Venastine-Research-Harness#readme",
14
+ "bugs": {
15
+ "url": "https://github.com/YahyaHammad/Venastine-Research-Harness/issues"
16
+ },
17
+ "repository": {
18
+ "type": "git",
19
+ "url": "git+https://github.com/YahyaHammad/Venastine-Research-Harness.git"
20
+ },
21
+ "license": "Apache-2.0",
22
+ "author": "Yahya Hammad",
23
+ "type": "module",
24
+ "bin": {
25
+ "venastine": "bin/venastine.mjs"
26
+ },
27
+ "engines": {
28
+ "node": ">=18"
29
+ },
30
+ "publishConfig": {
31
+ "access": "public"
32
+ },
33
+ "scripts": {
34
+ "prepublishOnly": "node scripts/prepublish-check.mjs",
35
+ "check-pack": "node scripts/prepublish-check.mjs"
36
+ },
37
+ "neverDistribute": [
38
+ {
39
+ "label": "provider credentials",
40
+ "match": "exact",
41
+ "value": [
42
+ "providers.json"
43
+ ],
44
+ "channels": [
45
+ "git",
46
+ "archive",
47
+ "npm"
48
+ ],
49
+ "samples": [
50
+ "providers.json"
51
+ ]
52
+ },
53
+ {
54
+ "label": "tool secrets",
55
+ "match": "basename",
56
+ "value": [
57
+ ".env"
58
+ ],
59
+ "channels": [
60
+ "git",
61
+ "archive",
62
+ "npm"
63
+ ],
64
+ "samples": [
65
+ ".env",
66
+ "sub/.env"
67
+ ]
68
+ },
69
+ {
70
+ "label": "the harness-held secret store",
71
+ "match": "exact",
72
+ "value": [
73
+ "secrets.json"
74
+ ],
75
+ "channels": [
76
+ "git",
77
+ "archive",
78
+ "npm"
79
+ ],
80
+ "samples": [
81
+ "secrets.json"
82
+ ]
83
+ },
84
+ {
85
+ "label": "ChatGPT plan tokens",
86
+ "match": "exact",
87
+ "value": [
88
+ "chatgpt_auth.json",
89
+ "chatgpt_auth.json.lock"
90
+ ],
91
+ "channels": [
92
+ "git",
93
+ "archive",
94
+ "npm"
95
+ ],
96
+ "samples": [
97
+ "chatgpt_auth.json",
98
+ "chatgpt_auth.json.lock"
99
+ ],
100
+ "note": "ROADMAP_v3 §83 (CG4). The ChatGPT-plan sign-in's access and refresh tokens, written beside providers.json; the .lock is the empty file its refreshes serialize on."
101
+ },
102
+ {
103
+ "label": "local databases and their WAL sidecars",
104
+ "match": "suffix",
105
+ "value": [
106
+ ".db",
107
+ ".db-wal",
108
+ ".db-shm"
109
+ ],
110
+ "channels": [
111
+ "git",
112
+ "archive",
113
+ "npm"
114
+ ],
115
+ "samples": [
116
+ "app.db",
117
+ "app.db-wal",
118
+ "app.db-shm"
119
+ ]
120
+ },
121
+ {
122
+ "label": "logs",
123
+ "match": "dir",
124
+ "value": [
125
+ "logs"
126
+ ],
127
+ "channels": [
128
+ "git",
129
+ "archive",
130
+ "npm"
131
+ ],
132
+ "samples": [
133
+ "logs/app.log"
134
+ ]
135
+ },
136
+ {
137
+ "label": "research output",
138
+ "match": "dir",
139
+ "value": [
140
+ "output"
141
+ ],
142
+ "channels": [
143
+ "git",
144
+ "archive",
145
+ "npm"
146
+ ],
147
+ "samples": [
148
+ "output/run-1/report.md"
149
+ ]
150
+ },
151
+ {
152
+ "label": "compiled python",
153
+ "match": "suffix-or-segment",
154
+ "value": [
155
+ ".pyc",
156
+ "__pycache__"
157
+ ],
158
+ "channels": [
159
+ "git",
160
+ "npm"
161
+ ],
162
+ "samples": [
163
+ "x.pyc",
164
+ "__pycache__/README.txt"
165
+ ],
166
+ "note": "No archive row by decision (S18-08): `git archive` ships only TRACKED content, so export-ignore on a gitignored path is belt and braces. The row that mattered there was .venastine/."
167
+ },
168
+ {
169
+ "label": "notebook checkpoints",
170
+ "match": "segment",
171
+ "value": [
172
+ ".ipynb_checkpoints"
173
+ ],
174
+ "channels": [
175
+ "git",
176
+ "archive",
177
+ "npm"
178
+ ],
179
+ "samples": [
180
+ ".ipynb_checkpoints/system.md"
181
+ ]
182
+ },
183
+ {
184
+ "label": "security scan artifacts",
185
+ "match": "prefix",
186
+ "value": [
187
+ "CLAUDE-SECURITY"
188
+ ],
189
+ "channels": [
190
+ "git",
191
+ "archive",
192
+ "npm"
193
+ ],
194
+ "samples": [
195
+ "CLAUDE-SECURITY-2026-01-01/report.md"
196
+ ]
197
+ },
198
+ {
199
+ "label": "atomic-write debris",
200
+ "match": "suffix",
201
+ "value": [
202
+ ".tmp"
203
+ ],
204
+ "channels": [
205
+ "git",
206
+ "archive",
207
+ "npm"
208
+ ],
209
+ "samples": [
210
+ "providers.json.a1b2c3d4.tmp",
211
+ "secrets.json.a1b2c3d4.tmp"
212
+ ]
213
+ },
214
+ {
215
+ "label": "the unsafe-mode branch marker",
216
+ "match": "exact",
217
+ "value": [
218
+ "UNSAFE_BRANCH"
219
+ ],
220
+ "channels": [
221
+ "npm"
222
+ ],
223
+ "samples": [
224
+ "UNSAFE_BRANCH"
225
+ ],
226
+ "note": "npm only, deliberately. UN5 keeps this marker OUT of the tarball while the unsafe branch must be able to track it, so gitignoring it would break the thing it exists to mark."
227
+ },
228
+ {
229
+ "label": "project MCP server configuration",
230
+ "match": "exact",
231
+ "value": [
232
+ ".venastine/mcp.json"
233
+ ],
234
+ "channels": [
235
+ "git",
236
+ "archive",
237
+ "npm"
238
+ ],
239
+ "samples": [
240
+ ".venastine/mcp.json"
241
+ ],
242
+ "note": "S18-01. `env` and `headers` are live fields and README names `Authorization` as where a hosted server's credential rides. The directory is NOT excluded wholesale: .venastine/agents and .venastine/skills are project content meant to travel with the repo, which is what D17's trust prompt exists for."
243
+ },
244
+ {
245
+ "label": "project settings",
246
+ "match": "exact",
247
+ "value": [
248
+ ".venastine/settings.json"
249
+ ],
250
+ "channels": [
251
+ "git",
252
+ "archive",
253
+ "npm"
254
+ ],
255
+ "samples": [
256
+ ".venastine/settings.json"
257
+ ],
258
+ "note": "The sibling `/init --config` writes in the same call as mcp.json, so it travels with it."
259
+ }
260
+ ],
261
+ "files": [
262
+ "bin/",
263
+ "main.py",
264
+ "config.py",
265
+ "config.yaml",
266
+ "config_schema.py",
267
+ "config_edit.py",
268
+ "config_update.py",
269
+ "cli_commands.py",
270
+ "storage.py",
271
+ "database.py",
272
+ "credentials.py",
273
+ "env_secrets.py",
274
+ "logging_setup.py",
275
+ "json_store.py",
276
+ "core/",
277
+ "tools/",
278
+ "tui/",
279
+ "agents/",
280
+ "skills/",
281
+ "prompts/",
282
+ "mcp_client/",
283
+ "security/",
284
+ "safety/",
285
+ "memories/",
286
+ "project_init/",
287
+ "requirements.txt",
288
+ "pyproject.toml",
289
+ "README.md",
290
+ "LICENSE",
291
+ "NOTICE",
292
+ "docs/THIRD_PARTY_NOTICES.md",
293
+ "CONFIG_ARCHITECTURE.md",
294
+ "docs/SECURITY.md",
295
+ "docs/PRIVACY.md",
296
+ "providers.json.example",
297
+ ".env.example",
298
+ "!**/__pycache__",
299
+ "!**/*.pyc",
300
+ "!**/.ipynb_checkpoints",
301
+ "!**/.pytest_cache"
302
+ ]
303
+ }