@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
@@ -1,111 +1,110 @@
1
- """
2
- skills/tui_commands.py
3
-
4
- ROADMAP_v2 §19, D7: `/skill` registers into §16's slash registry. The
5
- shell hosts the command; this section owns it -- the same
6
- mechanism-vs-policy split tools/registry.py uses for tools and
7
- agents/tui_commands.py uses for /agent.
8
-
9
- Handlers receive the app object from tui.commands.dispatch(); this module
10
- deliberately does NOT import tui.app, so app.py can import it without a
11
- cycle.
12
-
13
- The app owns `active_skills` (K5: session-scoped, unpersisted, matching
14
- /agent rather than /goal). This module reads and replaces it through the
15
- manager, which holds no state of its own (K3).
16
- """
17
-
18
- from agents.manager import manager as agents
19
- from skills.manager import manager as skills
20
- from tui.commands import SlashCommand, registry as commands
21
-
22
-
23
- def _current_context(app):
24
- """The ToolContext the NEXT turn will actually run under.
25
-
26
- The precondition check has to use the same context the loop will, or
27
- /skill reports one thing and the turn enforces another -- which is the
28
- divergence the check exists to prevent in the first place.
29
- """
30
- if app.active_agent is None:
31
- return None
32
- return agents.active_context(app.active_agent)
33
-
34
-
35
- def _list(app) -> None:
36
- grouped = skills.by_category()
37
- if not grouped:
38
- app._transcript.write_system("No skills discovered.")
39
- return
40
- lines = []
41
- for category in sorted(grouped):
42
- if category:
43
- lines.append(f" [{category}]")
44
- for skill in grouped[category]:
45
- mark = "*" if skill.name in app.active_skills else "-"
46
- lines.append(f" {mark} {skill.name}: {skill.description}")
47
- active = ", ".join(app.active_skills) or "none"
48
- app._transcript.write_system(
49
- "Skills (* = active):\n" + "\n".join(lines)
50
- + f"\nActive: {active}."
51
- + "\n/skill <name> to activate, /skill off <name>, /skill clear."
52
- )
53
-
54
-
55
- def _cmd_skill(app, args: str) -> None:
56
- """Activate a skill for this session: its full body is pinned into
57
- every subsequent turn's system prompt until deactivated (K1)."""
58
- args = (args or "").strip()
59
- if not args:
60
- _list(app)
61
- return
62
-
63
- if args == "clear":
64
- app.active_skills = []
65
- app._transcript.write_system("All skills deactivated.")
66
- return
67
-
68
- if args.startswith("off "):
69
- name = args[4:].strip()
70
- if name not in app.active_skills:
71
- app._transcript.write_error(f"{name!r} is not active.")
72
- return
73
- app.active_skills = skills.deactivate(name, app.active_skills)
74
- app._transcript.write_system(f"Deactivated {name}.")
75
- return
76
-
77
- skill = skills.get(args)
78
- if skill is None:
79
- app._transcript.write_error(
80
- f"Unknown skill {args!r}. "
81
- f"Available: {', '.join(skills.names()) or 'none'}.")
82
- return
83
-
84
- already = args in app.active_skills
85
- app.active_skills = skills.activate(args, app.active_skills)
86
- if already:
87
- app._transcript.write_system(f"{skill.name} is already active.")
88
- return
89
-
90
- app._transcript.write_system(
91
- f"Activated {skill.name} — {skill.description}. "
92
- "Its full instructions now apply to every turn until /skill off.")
93
-
94
- # K2: report, do not refuse. A skill is often useful without an
95
- # optional tool, and a hard failure here would make a restrictive agent
96
- # silently un-pairable with half the catalog. Saying it now beats the
97
- # model discovering it mid-turn as a denied call.
98
- missing = skills.missing_tools(skill, _current_context(app))
99
- if missing:
100
- app._transcript.write_system(
101
- f"Note: {skill.name} expects {', '.join(missing)}, which "
102
- f"{'is' if len(missing) == 1 else 'are'} not available in this "
103
- "session. The skill is active; those steps will not be.")
104
-
105
-
106
- def register_skill_commands() -> None:
107
- """Idempotent -- registering by name overwrites, matching §16's
108
- register_builtin_commands() and §18's register_agent_commands()."""
109
- commands.register(SlashCommand(
110
- "skill", "activate a skill for this session", _cmd_skill,
111
- "[name|off <name>|clear]"))
1
+ """
2
+ skills/tui_commands.py
3
+
4
+ ROADMAP_v2 §19, D7: `/skill` registers into §16's slash registry. The
5
+ shell hosts the command; this section owns it -- the same
6
+ mechanism-vs-policy split tools/registry.py uses for tools and
7
+ agents/tui_commands.py uses for /agent.
8
+
9
+ Handlers receive the app object from tui.commands.dispatch(); this module
10
+ deliberately does NOT import tui.app, so app.py can import it without a
11
+ cycle.
12
+
13
+ The app owns `active_skills` (K5: session-scoped, unpersisted, matching
14
+ /agent rather than /goal). This module reads and replaces it through the
15
+ manager, which holds no state of its own (K3).
16
+ """
17
+
18
+ from agents.manager import manager as agents
19
+ from skills.manager import manager as skills
20
+ from tui.commands import bind
21
+ from tui.commands import registry as commands
22
+
23
+
24
+ def _current_context(app):
25
+ """The ToolContext the NEXT turn will actually run under.
26
+
27
+ The precondition check has to use the same context the loop will, or
28
+ /skill reports one thing and the turn enforces another -- which is the
29
+ divergence the check exists to prevent in the first place.
30
+ """
31
+ if app.active_agent is None:
32
+ return None
33
+ return agents.active_context(app.active_agent)
34
+
35
+
36
+ def _list(app) -> None:
37
+ grouped = skills.by_category()
38
+ if not grouped:
39
+ app._transcript.write_system("No skills discovered.")
40
+ return
41
+ lines = []
42
+ for category in sorted(grouped):
43
+ if category:
44
+ lines.append(f" [{category}]")
45
+ for skill in grouped[category]:
46
+ mark = "*" if skill.name in app.active_skills else "-"
47
+ lines.append(f" {mark} {skill.name}: {skill.description}")
48
+ active = ", ".join(app.active_skills) or "none"
49
+ app._transcript.write_system(
50
+ "Skills (* = active):\n" + "\n".join(lines)
51
+ + f"\nActive: {active}."
52
+ + "\n/skill <name> to activate, /skill off <name>, /skill clear."
53
+ )
54
+
55
+
56
+ def _cmd_skill(app, args: str) -> None:
57
+ """Activate a skill for this session: its full body is pinned into
58
+ every subsequent turn's system prompt until deactivated (K1)."""
59
+ args = (args or "").strip()
60
+ if not args:
61
+ _list(app)
62
+ return
63
+
64
+ if args == "clear":
65
+ app.active_skills = []
66
+ app._transcript.write_system("All skills deactivated.")
67
+ return
68
+
69
+ if args.startswith("off "):
70
+ name = args[4:].strip()
71
+ if name not in app.active_skills:
72
+ app._transcript.write_error(f"{name!r} is not active.")
73
+ return
74
+ app.active_skills = skills.deactivate(name, app.active_skills)
75
+ app._transcript.write_system(f"Deactivated {name}.")
76
+ return
77
+
78
+ skill = skills.get(args)
79
+ if skill is None:
80
+ app._transcript.write_error(
81
+ f"Unknown skill {args!r}. "
82
+ f"Available: {', '.join(skills.names()) or 'none'}.")
83
+ return
84
+
85
+ already = args in app.active_skills
86
+ app.active_skills = skills.activate(args, app.active_skills)
87
+ if already:
88
+ app._transcript.write_system(f"{skill.name} is already active.")
89
+ return
90
+
91
+ app._transcript.write_system(
92
+ f"Activated {skill.name} — {skill.description}. "
93
+ "Its full instructions now apply to every turn until /skill off.")
94
+
95
+ # K2: report, do not refuse. A skill is often useful without an
96
+ # optional tool, and a hard failure here would make a restrictive agent
97
+ # silently un-pairable with half the catalog. Saying it now beats the
98
+ # model discovering it mid-turn as a denied call.
99
+ missing = skills.missing_tools(skill, _current_context(app))
100
+ if missing:
101
+ app._transcript.write_system(
102
+ f"Note: {skill.name} expects {', '.join(missing)}, which "
103
+ f"{'is' if len(missing) == 1 else 'are'} not available in this "
104
+ "session. The skill is active; those steps will not be.")
105
+
106
+
107
+ def register_skill_commands() -> None:
108
+ """Idempotent -- registering by name overwrites, matching §16's
109
+ register_builtin_commands() and §18's register_agent_commands()."""
110
+ commands.register(bind("skill", _cmd_skill))