@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/tui/ravens.py CHANGED
@@ -1,146 +1,146 @@
1
- """
2
- tui/ravens.py
3
-
4
- ROADMAP_v2 §16. The two ravens, and the mapping from loop activity to a
5
- raven state.
6
-
7
- Deliberately data-only: this module owns the art and the state table, and
8
- nothing else. The widgets in tui/widgets.py render it; tui/app.py decides
9
- when the state changes. Keeping the mapping here means adding a tool never
10
- requires touching a widget.
11
-
12
- Why a table rather than a match on tool names inside the app: §17 (MCP)
13
- registers tools at runtime with names nobody has written down yet, and §18
14
- adds subagents. Unknown names resolve to WORKING rather than falling
15
- through to an unchanged raven, so a new tool always animates something.
16
- """
17
-
18
- from dataclasses import dataclass
19
-
20
-
21
- @dataclass(frozen=True)
22
- class RavenState:
23
- key: str
24
- label: str
25
- frames: tuple[str, ...] # cycled when animations are on; frames[0] is static
26
-
27
-
28
- # Three-line art. Each state varies the head/wing so the change is legible
29
- # at a glance in a small corner panel rather than needing the label read.
30
- IDLE = RavenState(
31
- "idle", "idle",
32
- (
33
- " __\n<o )___\n `----'",
34
- " __\n<- )___\n `----'", # blink
35
- ),
36
- )
37
-
38
- THINKING = RavenState(
39
- "thinking", "thinking",
40
- (
41
- " __\n<o )___\n `--^-'",
42
- " __\n<o )___\n `--`-'",
43
- " __\n<o )___\n `--,-'",
44
- ),
45
- )
46
-
47
- SEARCHING = RavenState(
48
- "searching", "searching",
49
- (
50
- " __\n<o )___ o\n `----'",
51
- " __\n<o )___ o\n `----'",
52
- " __\n<o )___ o\n `----'",
53
- ),
54
- )
55
-
56
- READING = RavenState(
57
- "reading", "reading",
58
- (
59
- " __\n<o )___\n `--[]'",
60
- " __\n<- )___\n `--[]'",
61
- ),
62
- )
63
-
64
- EDITING = RavenState(
65
- "editing", "editing",
66
- (
67
- " __\n<o )___\n `--/-'",
68
- " __\n<o )___\n `--\\-'",
69
- ),
70
- )
71
-
72
- RUNNING = RavenState(
73
- "running", "running",
74
- (
75
- " __\n<o )___\n `--$-'",
76
- " __\n<0 )___\n `--$-'",
77
- ),
78
- )
79
-
80
- WAITING = RavenState(
81
- "waiting", "waiting on you",
82
- (
83
- " __\n<? )___\n `----'",
84
- " __\n<! )___\n `----'",
85
- ),
86
- )
87
-
88
- WORKING = RavenState(
89
- "working", "working",
90
- (
91
- " __\n<o )___\n `--*-'",
92
- " __\n<o )___\n `--+-'",
93
- ),
94
- )
95
-
96
- # Tool name -> state. Anything not listed maps to WORKING (see module
97
- # docstring): runtime-registered MCP tools and §18 subagents must animate
98
- # without this table being edited.
99
- TOOL_STATES = {
100
- "web_search": SEARCHING,
101
- "arxiv_search": SEARCHING,
102
- "fetch_url": SEARCHING,
103
- "read": READING,
104
- "load_skill": READING,
105
- "write": EDITING,
106
- "edit": EDITING,
107
- "shell": RUNNING,
108
- }
109
-
110
-
111
- def state_for_tool(tool_name: str) -> RavenState:
112
- return TOOL_STATES.get(tool_name, WORKING)
113
-
114
-
115
- # --- Effort raven -----------------------------------------------------------
116
- # A separate, one-line raven whose plumage reflects the current reasoning
117
- # effort, so the setting is visible rather than remembered. Ordered
118
- # least-to-most. An UNSET level renders as "auto" (the provider's own
119
- # default, which is what effort=None sends); an unknown one renders by
120
- # name with no bar, since its rank is exactly what we don't know.
121
- EFFORT_PLUMAGE = {
122
- "low": "▁",
123
- "medium": "▃",
124
- "high": "▅",
125
- "xhigh": "▇",
126
- "ultra": "▇",
127
- "max": "█",
128
- }
129
-
130
-
131
- def effort_raven(effort: str | None) -> str:
132
- """One-line effort indicator: a small raven plus a plumage bar.
133
-
134
- An unknown level keeps its NAME but gets no plumage, rather than
135
- borrowing "low"'s single bar. Levels are discovered at runtime from
136
- the Models API, so a provider reporting one outside this table is a
137
- reachable state -- and drawing it as the least-effort setting
138
- misreports the rank while the comment above promised the neutral
139
- display.
140
- """
141
- if not effort:
142
- return "<o)~ auto"
143
- plumage = EFFORT_PLUMAGE.get(effort)
144
- if plumage is None:
145
- return f"<o)~ {effort}"
146
- return f"<o)~ {plumage * 3} {effort}"
1
+ """
2
+ tui/ravens.py
3
+
4
+ ROADMAP_v2 §16. The two ravens, and the mapping from loop activity to a
5
+ raven state.
6
+
7
+ Deliberately data-only: this module owns the art and the state table, and
8
+ nothing else. The widgets in tui/widgets.py render it; tui/app.py decides
9
+ when the state changes. Keeping the mapping here means adding a tool never
10
+ requires touching a widget.
11
+
12
+ Why a table rather than a match on tool names inside the app: §17 (MCP)
13
+ registers tools at runtime with names nobody has written down yet, and §18
14
+ adds subagents. Unknown names resolve to WORKING rather than falling
15
+ through to an unchanged raven, so a new tool always animates something.
16
+ """
17
+
18
+ from dataclasses import dataclass
19
+
20
+
21
+ @dataclass(frozen=True)
22
+ class RavenState:
23
+ key: str
24
+ label: str
25
+ frames: tuple[str, ...] # cycled when animations are on; frames[0] is static
26
+
27
+
28
+ # Three-line art. Each state varies the head/wing so the change is legible
29
+ # at a glance in a small corner panel rather than needing the label read.
30
+ IDLE = RavenState(
31
+ "idle", "idle",
32
+ (
33
+ " __\n<o )___\n `----'",
34
+ " __\n<- )___\n `----'", # blink
35
+ ),
36
+ )
37
+
38
+ THINKING = RavenState(
39
+ "thinking", "thinking",
40
+ (
41
+ " __\n<o )___\n `--^-'",
42
+ " __\n<o )___\n `--`-'",
43
+ " __\n<o )___\n `--,-'",
44
+ ),
45
+ )
46
+
47
+ SEARCHING = RavenState(
48
+ "searching", "searching",
49
+ (
50
+ " __\n<o )___ o\n `----'",
51
+ " __\n<o )___ o\n `----'",
52
+ " __\n<o )___ o\n `----'",
53
+ ),
54
+ )
55
+
56
+ READING = RavenState(
57
+ "reading", "reading",
58
+ (
59
+ " __\n<o )___\n `--[]'",
60
+ " __\n<- )___\n `--[]'",
61
+ ),
62
+ )
63
+
64
+ EDITING = RavenState(
65
+ "editing", "editing",
66
+ (
67
+ " __\n<o )___\n `--/-'",
68
+ " __\n<o )___\n `--\\-'",
69
+ ),
70
+ )
71
+
72
+ RUNNING = RavenState(
73
+ "running", "running",
74
+ (
75
+ " __\n<o )___\n `--$-'",
76
+ " __\n<0 )___\n `--$-'",
77
+ ),
78
+ )
79
+
80
+ WAITING = RavenState(
81
+ "waiting", "waiting on you",
82
+ (
83
+ " __\n<? )___\n `----'",
84
+ " __\n<! )___\n `----'",
85
+ ),
86
+ )
87
+
88
+ WORKING = RavenState(
89
+ "working", "working",
90
+ (
91
+ " __\n<o )___\n `--*-'",
92
+ " __\n<o )___\n `--+-'",
93
+ ),
94
+ )
95
+
96
+ # Tool name -> state. Anything not listed maps to WORKING (see module
97
+ # docstring): runtime-registered MCP tools and §18 subagents must animate
98
+ # without this table being edited.
99
+ TOOL_STATES = {
100
+ "web_search": SEARCHING,
101
+ "arxiv_search": SEARCHING,
102
+ "fetch_url": SEARCHING,
103
+ "read": READING,
104
+ "load_skill": READING,
105
+ "write": EDITING,
106
+ "edit": EDITING,
107
+ "shell": RUNNING,
108
+ }
109
+
110
+
111
+ def state_for_tool(tool_name: str) -> RavenState:
112
+ return TOOL_STATES.get(tool_name, WORKING)
113
+
114
+
115
+ # --- Effort raven -----------------------------------------------------------
116
+ # A separate, one-line raven whose plumage reflects the current reasoning
117
+ # effort, so the setting is visible rather than remembered. Ordered
118
+ # least-to-most. An UNSET level renders as "auto" (the provider's own
119
+ # default, which is what effort=None sends); an unknown one renders by
120
+ # name with no bar, since its rank is exactly what we don't know.
121
+ EFFORT_PLUMAGE = {
122
+ "low": "▁",
123
+ "medium": "▃",
124
+ "high": "▅",
125
+ "xhigh": "▇",
126
+ "ultra": "▇",
127
+ "max": "█",
128
+ }
129
+
130
+
131
+ def effort_raven(effort: str | None) -> str:
132
+ """One-line effort indicator: a small raven plus a plumage bar.
133
+
134
+ An unknown level keeps its NAME but gets no plumage, rather than
135
+ borrowing "low"'s single bar. Levels are discovered at runtime from
136
+ the Models API, so a provider reporting one outside this table is a
137
+ reachable state -- and drawing it as the least-effort setting
138
+ misreports the rank while the comment above promised the neutral
139
+ display.
140
+ """
141
+ if not effort:
142
+ return "<o)~ auto"
143
+ plumage = EFFORT_PLUMAGE.get(effort)
144
+ if plumage is None:
145
+ return f"<o)~ {effort}"
146
+ return f"<o)~ {plumage * 3} {effort}"