@yahyahammad/venastine 0.1.0 → 0.3.8

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 (130) hide show
  1. package/.env.example +19 -14
  2. package/CONFIG_ARCHITECTURE.md +2002 -0
  3. package/NOTICE +1 -1
  4. package/README.md +249 -93
  5. package/agents/builtin/build.md +73 -0
  6. package/agents/builtin/general.md +80 -0
  7. package/agents/builtin/plan.md +23 -5
  8. package/agents/builtin/test.md +65 -0
  9. package/agents/builtin/writer.md +67 -0
  10. package/agents/manager.py +261 -195
  11. package/agents/subagent_tool.py +280 -23
  12. package/agents/tui_commands.py +31 -21
  13. package/bin/venastine.mjs +528 -382
  14. package/bin/venastine.py +71 -0
  15. package/cli_commands.py +835 -0
  16. package/config.py +95 -1198
  17. package/config.yaml +1090 -0
  18. package/config_edit.py +1301 -0
  19. package/config_schema.py +966 -0
  20. package/config_update.py +749 -0
  21. package/core/agent_activity.py +256 -0
  22. package/core/ansi.py +452 -0
  23. package/core/approval.py +27 -5
  24. package/core/call_view.py +364 -0
  25. package/core/cancel.py +121 -0
  26. package/core/chatgpt_auth.py +747 -0
  27. package/core/claims_view.py +107 -0
  28. package/core/client.py +1249 -82
  29. package/core/commands.py +454 -0
  30. package/core/compaction.py +1735 -959
  31. package/core/config_loader.py +516 -97
  32. package/core/connect.py +686 -0
  33. package/core/events.py +68 -6
  34. package/core/file_mentions.py +280 -0
  35. package/core/interaction.py +87 -4
  36. package/core/line_pattern.py +128 -0
  37. package/core/loop.py +2566 -1353
  38. package/core/memory.py +482 -370
  39. package/core/pipeline_models.py +23 -9
  40. package/core/provider_errors.py +234 -0
  41. package/core/reasoning/confidence_scoring.py +70 -54
  42. package/core/reasoning/json_retry.py +19 -1
  43. package/core/reasoning/orchestrator.py +232 -53
  44. package/core/reasoning/output_writer.py +90 -31
  45. package/core/reasoning/payload_validation.py +133 -7
  46. package/core/reasoning/pipeline_storage.py +427 -361
  47. package/core/reasoning/review.py +659 -615
  48. package/core/reasoning/scholar.py +38 -14
  49. package/core/reasoning/source_corpus.py +110 -4
  50. package/core/replay.py +315 -167
  51. package/core/session.py +36 -12
  52. package/core/session_view.py +259 -0
  53. package/core/session_wake.py +259 -0
  54. package/core/shell_sessions.py +1553 -0
  55. package/core/workspace_trust.py +1 -1
  56. package/credentials.py +308 -180
  57. package/database.py +82 -1
  58. package/{PRIVACY.md → docs/PRIVACY.md} +19 -7
  59. package/docs/SECURITY.md +108 -0
  60. package/docs/THIRD_PARTY_NOTICES.md +148 -0
  61. package/env_secrets.py +118 -77
  62. package/json_store.py +236 -16
  63. package/logging_setup.py +121 -11
  64. package/main.py +1672 -198
  65. package/mcp_client/client.py +257 -23
  66. package/mcp_client/config.py +484 -379
  67. package/mcp_client/registration.py +163 -2
  68. package/memories/manager.py +15 -0
  69. package/memories/tui_commands.py +21 -14
  70. package/package.json +303 -73
  71. package/project_init/config_files.py +4 -0
  72. package/project_init/generator.py +201 -37
  73. package/project_init/manifest.py +418 -406
  74. package/project_init/tui_commands.py +7 -4
  75. package/prompts/revalidate.md +1 -1
  76. package/prompts/revise.md +17 -15
  77. package/prompts/system_prompts.py +64 -10
  78. package/providers.json.example +94 -92
  79. package/pyproject.toml +149 -100
  80. package/requirements.txt +252 -29
  81. package/safety/policy_enforcement.py +1082 -682
  82. package/security/askpass.py +419 -0
  83. package/security/capability.py +37 -7
  84. package/security/confine.py +484 -0
  85. package/security/hosted.py +182 -0
  86. package/security/permissions.py +54 -7
  87. package/security/posture.py +124 -12
  88. package/security/protected_paths.py +198 -6
  89. package/security/sandbox.py +3262 -139
  90. package/security/secrets.py +855 -0
  91. package/skills/tui_commands.py +3 -4
  92. package/storage.py +1338 -1005
  93. package/tools/base.py +465 -305
  94. package/tools/builtin/_math_common.py +306 -16
  95. package/tools/builtin/_net_common.py +267 -61
  96. package/tools/builtin/arxiv.py +681 -223
  97. package/tools/builtin/ask_user.py +231 -213
  98. package/tools/builtin/discrete_math.py +35 -4
  99. package/tools/builtin/fetch_url.py +239 -21
  100. package/tools/builtin/file_ops.py +341 -33
  101. package/tools/builtin/geometry.py +184 -148
  102. package/tools/builtin/get_time.py +2 -2
  103. package/tools/builtin/linear_algebra.py +66 -23
  104. package/tools/builtin/load_skill.py +10 -0
  105. package/tools/builtin/logic.py +171 -12
  106. package/tools/builtin/pin.py +46 -12
  107. package/tools/builtin/probability_stats.py +224 -228
  108. package/tools/builtin/project_docs.py +80 -21
  109. package/tools/builtin/remember.py +21 -4
  110. package/tools/builtin/shell.py +586 -67
  111. package/tools/builtin/shell_sessions.py +613 -0
  112. package/tools/builtin/symbolic_math.py +80 -10
  113. package/tools/builtin/todo.py +5 -3
  114. package/tools/builtin/web_search.py +329 -151
  115. package/tools/context.py +23 -0
  116. package/tools/isolation.py +387 -314
  117. package/tools/registry.py +374 -29
  118. package/tui/app.py +5281 -397
  119. package/tui/app.tcss +290 -9
  120. package/tui/commands.py +26 -61
  121. package/tui/diffs.py +286 -265
  122. package/tui/history.py +128 -0
  123. package/tui/hosted_driver.py +102 -0
  124. package/tui/markdown.py +1329 -0
  125. package/tui/meters.py +364 -0
  126. package/tui/screens.py +346 -92
  127. package/tui/themes.py +599 -366
  128. package/tui/widgets.py +2673 -116
  129. package/SECURITY.md +0 -88
  130. package/THIRD_PARTY_NOTICES.md +0 -100
package/package.json CHANGED
@@ -1,73 +1,303 @@
1
- {
2
- "name": "@yahyahammad/venastine",
3
- "version": "0.1.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.8",
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
+ }
@@ -101,6 +101,10 @@ OMITTED = {
101
101
  "vestigial -- the roster's length decides the count now, and the "
102
102
  "loader warns when this is set, so a template carrying it would "
103
103
  "ship that warning to everyone who ran the command",
104
+ "confidence.disagreement_penalty_factor":
105
+ "retired by ROADMAP_v3 §90 for the same reason as ensemble_n: "
106
+ "disagreement routes a claim to be checked and subtracts nothing, "
107
+ "and the loader warns when this is set",
104
108
  "ensemble_mode":
105
109
  "resolved as `config.ENSEMBLE_MODE if value is None`, so writing "
106
110
  "`false` is not a restatement of the default but a decision to "