@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
@@ -0,0 +1,107 @@
1
+ """
2
+ core/claims_view.py
3
+
4
+ What a research run's claims view shows (ROADMAP_v2 §26), for either shell.
5
+
6
+ Moved out of `tui/screens.py` by ROADMAP_v3 §89 (#8), when the CLI got a
7
+ `/claims` of its own: which claims come first, which fields are shown and
8
+ how a malformed stored field reads are decisions about the RUN, not about
9
+ a modal, and the CLI printing its own copy of them is the disagreement
10
+ `core/replay.py` exists to prevent. The TUI's ClaimsScreen and the CLI's
11
+ `/claims` both draw what this returns.
12
+
13
+ Plain dicts, not Claim objects: the sources are `vars(c)` for a finished
14
+ in-session run, `pipeline_storage.load_pipeline_run()` for a stored one,
15
+ and the partial picture assembled from PipelineEvents mid-run.
16
+ """
17
+
18
+ from __future__ import annotations
19
+
20
+ # Tier order for the claims view: worst first. A reader opening this is
21
+ # looking for what NOT to trust, and burying the unverified claims under
22
+ # the confident ones makes them the hardest thing to find.
23
+ TIER_ORDER = ("UNVERIFIED", "UNVERIFIED_COVERAGE", "LOW", "MEDIUM", "HIGH")
24
+
25
+
26
+ def as_display_list(value) -> list:
27
+ """The members of a model-supplied list field, as text.
28
+
29
+ EVERY FIELD THIS GUARDS IS MODEL DATA READ BACK FROM A STORED RUN, AND
30
+ A STORED RUN MAY HAVE FAILED (batch 149). The orchestrator's except
31
+ block persists a snapshot before it re-raises, so a run that died in
32
+ Pass 5 on `assumption_flags: 123` leaves that value in the record --
33
+ and `/claims <run id>` then rendered it. `'; '.join(map(str, 123))`
34
+ raises TypeError inside `compose()`, which is NOT covered by the
35
+ containment batch 145 put at the `/` dispatch site: `push_screen`
36
+ returns an `await_mount`, so compose runs in the message pump rather
37
+ than in the handler's call stack, and the exception reaches Textual's
38
+ `_handle_exception` and takes the whole app down. Measured against the
39
+ real ClaimsScreen in a minimal host app.
40
+
41
+ The payload boundary now rejects each of these shapes at the pass that
42
+ sent them (§66 A25), which closes the producer -- but not for a record
43
+ written before it did, and this view's whole job is reading those.
44
+
45
+ A value that is not a list is shown as the one value it is, rather
46
+ than dropped: the reader asked what the run recorded, and "123" is the
47
+ answer.
48
+ """
49
+ if isinstance(value, (list, tuple)):
50
+ return [str(member) for member in value]
51
+ return [str(value)]
52
+
53
+
54
+ def claims_header(title: str, count: int, partial: bool) -> str:
55
+ """The view's first line: the run, how many claims, and whether the
56
+ run is still going.
57
+
58
+ The partial note is said rather than left to inference: mid-run, only
59
+ id, text and tier have been broadcast as events, and thin rows with no
60
+ note would read as a pipeline that recorded nothing.
61
+ """
62
+ header = f"{title} ({count})"
63
+ if partial:
64
+ header += " — run in progress, metadata incomplete"
65
+ return header
66
+
67
+
68
+ def render_claims(claims: list) -> str:
69
+ if not claims:
70
+ return "No claims recorded for this run."
71
+
72
+ def _rank(claim):
73
+ tier = claim.get("confidence_tier")
74
+ return TIER_ORDER.index(tier) if tier in TIER_ORDER else len(TIER_ORDER)
75
+
76
+ out = []
77
+ for claim in sorted(claims, key=_rank):
78
+ tier = claim.get("confidence_tier") or "—"
79
+ head = f"{tier:<20} {claim.get('id', '?')} {claim.get('type') or ''}"
80
+ if claim.get("retry_count"):
81
+ head += f" revised x{claim['retry_count']}"
82
+ out.append(head.rstrip())
83
+ # final_text is what the claim carries into the report; text is
84
+ # what Pass 2 extracted. Showing final_text when they differ means
85
+ # the view matches the report rather than the draft behind it.
86
+ out.append(f" {claim.get('final_text') or claim.get('text') or ''}")
87
+ if claim.get("entities"):
88
+ out.append(" entities: "
89
+ + ", ".join(as_display_list(claim["entities"])))
90
+ if claim.get("grounding_status") or claim.get("grounding_sources"):
91
+ sources = len(as_display_list(claim.get("grounding_sources")
92
+ or ()))
93
+ out.append(f" grounding: {claim.get('grounding_status') or 'none'}"
94
+ f" ({sources} source{'s' if sources != 1 else ''})")
95
+ for field, label in (("fallacies", "fallacies"),
96
+ ("contradictions", "contradictions"),
97
+ ("assumption_flags", "assumptions")):
98
+ if claim.get(field):
99
+ out.append(f" {label}: "
100
+ + "; ".join(as_display_list(claim[field])))
101
+ if claim.get("score_breakdown"):
102
+ out.append(" score: " + ", ".join(
103
+ f"{k}={v}" for k, v in claim["score_breakdown"].items()))
104
+ if claim.get("annotation"):
105
+ out.append(f" {claim['annotation']}")
106
+ out.append("")
107
+ return "\n".join(out).rstrip()