@yahyahammad/venastine 0.3.8 → 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 (128) hide show
  1. package/.env.example +19 -19
  2. package/CONFIG_ARCHITECTURE.md +2030 -2002
  3. package/LICENSE +201 -201
  4. package/README.md +1034 -1034
  5. package/agents/builtin/compactor.md +75 -75
  6. package/agents/builtin/explore.md +77 -77
  7. package/agents/builtin/pipeline-reviewer.md +100 -100
  8. package/agents/builtin/plan.md +106 -106
  9. package/agents/builtin/review.md +74 -74
  10. package/agents/manager.py +261 -261
  11. package/agents/subagent_tool.py +472 -472
  12. package/agents/tui_commands.py +238 -146
  13. package/bin/venastine.mjs +528 -528
  14. package/bin/venastine.py +71 -71
  15. package/cli_commands.py +838 -835
  16. package/config.yaml +13 -0
  17. package/config_edit.py +1301 -1301
  18. package/config_schema.py +971 -966
  19. package/config_update.py +749 -749
  20. package/core/agent_activity.py +256 -256
  21. package/core/ansi.py +452 -452
  22. package/core/approval.py +137 -137
  23. package/core/call_view.py +364 -364
  24. package/core/cancel.py +121 -121
  25. package/core/chatgpt_auth.py +747 -747
  26. package/core/claims_view.py +107 -107
  27. package/core/client.py +2715 -2715
  28. package/core/commands.py +460 -454
  29. package/core/compaction.py +1735 -1735
  30. package/core/config_loader.py +1982 -1982
  31. package/core/connect.py +686 -686
  32. package/core/events.py +123 -123
  33. package/core/file_mentions.py +280 -280
  34. package/core/interaction.py +411 -411
  35. package/core/loop.py +2566 -2566
  36. package/core/memory.py +482 -482
  37. package/core/pipeline_models.py +190 -190
  38. package/core/provider_errors.py +234 -234
  39. package/core/reasoning/authorization.py +130 -130
  40. package/core/reasoning/base.py +219 -219
  41. package/core/reasoning/confidence_scoring.py +484 -484
  42. package/core/reasoning/events.py +149 -149
  43. package/core/reasoning/orchestrator.py +1561 -1561
  44. package/core/reasoning/output_writer.py +345 -345
  45. package/core/reasoning/payload_validation.py +524 -524
  46. package/core/reasoning/pipeline_storage.py +427 -427
  47. package/core/reasoning/scholar.py +458 -458
  48. package/core/reasoning/source_corpus.py +433 -433
  49. package/core/reasoning/source_scoring.py +855 -855
  50. package/core/replay.py +315 -315
  51. package/core/shell_sessions.py +1553 -1553
  52. package/credentials.py +307 -307
  53. package/database.py +333 -333
  54. package/docs/PRIVACY.md +78 -78
  55. package/docs/SECURITY.md +108 -108
  56. package/docs/THIRD_PARTY_NOTICES.md +148 -148
  57. package/env_secrets.py +118 -118
  58. package/json_store.py +343 -343
  59. package/logging_setup.py +295 -295
  60. package/main.py +3433 -3433
  61. package/mcp_client/client.py +733 -733
  62. package/mcp_client/config.py +484 -484
  63. package/mcp_client/registration.py +343 -343
  64. package/memories/manager.py +147 -147
  65. package/memories/tui_commands.py +319 -239
  66. package/package.json +303 -303
  67. package/project_init/config_files.py +282 -282
  68. package/project_init/generator.py +728 -728
  69. package/project_init/manifest.py +418 -418
  70. package/project_init/tui_commands.py +147 -147
  71. package/prompts/critic_pass.md +24 -24
  72. package/prompts/revalidate.md +25 -25
  73. package/prompts/revise.md +17 -17
  74. package/prompts/source_grounding.md +66 -66
  75. package/prompts/system_prompts.py +316 -316
  76. package/providers.json.example +94 -94
  77. package/pyproject.toml +149 -149
  78. package/requirements.txt +295 -295
  79. package/safety/policy_enforcement.py +1082 -1082
  80. package/security/askpass.py +419 -419
  81. package/security/capability.py +207 -207
  82. package/security/confine.py +484 -484
  83. package/security/hosted.py +182 -182
  84. package/security/permissions.py +237 -237
  85. package/security/protected_paths.py +501 -501
  86. package/security/sandbox.py +4108 -4108
  87. package/skills/builtin/math/formal-specification.md +67 -67
  88. package/skills/builtin/math/numerical-methods.md +66 -66
  89. package/skills/builtin/research/experiment-design.md +62 -62
  90. package/skills/builtin/research/reproducibility.md +55 -55
  91. package/skills/builtin/research/source-evaluation.md +70 -70
  92. package/skills/builtin/research/statistical-inference.md +63 -63
  93. package/skills/builtin/research/technical-writing.md +59 -59
  94. package/skills/builtin/software/code-review.md +61 -61
  95. package/skills/builtin/software/debugging.md +61 -61
  96. package/skills/builtin/software/test-design.md +67 -67
  97. package/skills/tui_commands.py +110 -110
  98. package/storage.py +1338 -1338
  99. package/tools/base.py +465 -465
  100. package/tools/builtin/_math_common.py +667 -667
  101. package/tools/builtin/_net_common.py +267 -267
  102. package/tools/builtin/arxiv.py +681 -681
  103. package/tools/builtin/fetch_url.py +371 -371
  104. package/tools/builtin/file_ops.py +720 -720
  105. package/tools/builtin/geometry.py +184 -184
  106. package/tools/builtin/load_skill.py +76 -76
  107. package/tools/builtin/pin.py +227 -227
  108. package/tools/builtin/probability_stats.py +224 -224
  109. package/tools/builtin/project_docs.py +464 -464
  110. package/tools/builtin/remember.py +175 -175
  111. package/tools/builtin/shell.py +980 -980
  112. package/tools/builtin/todo.py +149 -149
  113. package/tools/builtin/web_search.py +328 -328
  114. package/tools/context.py +159 -159
  115. package/tools/isolation.py +387 -387
  116. package/tools/registry.py +1242 -1242
  117. package/tui/app.py +8318 -8307
  118. package/tui/app.tcss +747 -739
  119. package/tui/commands.py +26 -26
  120. package/tui/diffs.py +286 -286
  121. package/tui/history.py +128 -128
  122. package/tui/hosted_driver.py +102 -102
  123. package/tui/markdown.py +1329 -1329
  124. package/tui/meters.py +364 -364
  125. package/tui/ravens.py +146 -146
  126. package/tui/screens.py +1255 -1197
  127. package/tui/themes.py +599 -599
  128. package/tui/widgets.py +3813 -3796
@@ -1,110 +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 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))
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))