@yahyahammad/venastine 0.1.0
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.
- package/.env.example +14 -0
- package/LICENSE +201 -0
- package/NOTICE +14 -0
- package/PRIVACY.md +66 -0
- package/README.md +878 -0
- package/SECURITY.md +88 -0
- package/THIRD_PARTY_NOTICES.md +100 -0
- package/agents/builtin/compactor.md +75 -0
- package/agents/builtin/explore.md +77 -0
- package/agents/builtin/grill-me.md +27 -0
- package/agents/builtin/initializer.md +94 -0
- package/agents/builtin/pipeline-reviewer.md +100 -0
- package/agents/builtin/plan.md +88 -0
- package/agents/builtin/review.md +74 -0
- package/agents/manager.py +195 -0
- package/agents/subagent_tool.py +215 -0
- package/agents/tui_commands.py +136 -0
- package/bin/venastine.mjs +382 -0
- package/config.py +1198 -0
- package/core/__init__.py +0 -0
- package/core/approval.py +115 -0
- package/core/client.py +1548 -0
- package/core/compaction.py +959 -0
- package/core/config_loader.py +1563 -0
- package/core/events.py +61 -0
- package/core/interaction.py +328 -0
- package/core/loop.py +1353 -0
- package/core/memory.py +370 -0
- package/core/model_windows.py +175 -0
- package/core/pipeline_models.py +176 -0
- package/core/reasoning/__init__.py +0 -0
- package/core/reasoning/authorization.py +130 -0
- package/core/reasoning/base.py +219 -0
- package/core/reasoning/confidence_scoring.py +468 -0
- package/core/reasoning/events.py +149 -0
- package/core/reasoning/json_retry.py +219 -0
- package/core/reasoning/orchestrator.py +1382 -0
- package/core/reasoning/output_writer.py +286 -0
- package/core/reasoning/payload_validation.py +398 -0
- package/core/reasoning/pipeline_storage.py +361 -0
- package/core/reasoning/review.py +615 -0
- package/core/reasoning/scholar.py +434 -0
- package/core/reasoning/source_corpus.py +327 -0
- package/core/reasoning/source_scoring.py +855 -0
- package/core/replay.py +167 -0
- package/core/session.py +153 -0
- package/core/workspace_trust.py +207 -0
- package/credentials.py +180 -0
- package/database.py +252 -0
- package/env_secrets.py +77 -0
- package/json_store.py +123 -0
- package/logging_setup.py +185 -0
- package/main.py +1959 -0
- package/mcp_client/__init__.py +15 -0
- package/mcp_client/client.py +499 -0
- package/mcp_client/config.py +379 -0
- package/mcp_client/registration.py +182 -0
- package/memories/manager.py +132 -0
- package/memories/tui_commands.py +232 -0
- package/package.json +73 -0
- package/project_init/config_files.py +278 -0
- package/project_init/doc_sets.py +330 -0
- package/project_init/generator.py +564 -0
- package/project_init/manifest.py +406 -0
- package/project_init/tui_commands.py +144 -0
- package/prompts/__init__.py +0 -0
- package/prompts/annotate.md +14 -0
- package/prompts/assumption_audit.md +27 -0
- package/prompts/claim_extraction.md +34 -0
- package/prompts/completeness.md +18 -0
- package/prompts/confidence_tiers.md +23 -0
- package/prompts/critic_pass.md +24 -0
- package/prompts/final_synthesis.md +13 -0
- package/prompts/initial_generation.md +14 -0
- package/prompts/preliminary_plan.md +23 -0
- package/prompts/revalidate.md +25 -0
- package/prompts/revise.md +15 -0
- package/prompts/source_grounding.md +66 -0
- package/prompts/system_prompts.py +262 -0
- package/prompts/universal_system_prompt +7 -0
- package/prompts/untrusted_content +1 -0
- package/providers.json.example +92 -0
- package/pyproject.toml +100 -0
- package/requirements.txt +72 -0
- package/safety/__init__.py +0 -0
- package/safety/policy_enforcement.py +682 -0
- package/security/__init__.py +0 -0
- package/security/capability.py +177 -0
- package/security/permissions.py +190 -0
- package/security/posture.py +302 -0
- package/security/protected_paths.py +309 -0
- package/security/sandbox.py +985 -0
- package/skills/builtin/crypto/cryptography-verification.md +66 -0
- package/skills/builtin/math/formal-specification.md +67 -0
- package/skills/builtin/math/numerical-methods.md +66 -0
- package/skills/builtin/math/proof-writing.md +61 -0
- package/skills/builtin/research/experiment-design.md +62 -0
- package/skills/builtin/research/literature-review.md +65 -0
- package/skills/builtin/research/reproducibility.md +55 -0
- package/skills/builtin/research/source-evaluation.md +70 -0
- package/skills/builtin/research/statistical-inference.md +63 -0
- package/skills/builtin/research/technical-writing.md +59 -0
- package/skills/builtin/security/cybersecurity-research.md +63 -0
- package/skills/builtin/software/code-review.md +61 -0
- package/skills/builtin/software/debugging.md +61 -0
- package/skills/builtin/software/test-design.md +67 -0
- package/skills/manager.py +138 -0
- package/skills/tui_commands.py +111 -0
- package/storage.py +1005 -0
- package/tools/base.py +305 -0
- package/tools/builtin/__init__.py +0 -0
- package/tools/builtin/_math_common.py +377 -0
- package/tools/builtin/_net_common.py +61 -0
- package/tools/builtin/arxiv.py +223 -0
- package/tools/builtin/ask_user.py +213 -0
- package/tools/builtin/discrete_math.py +134 -0
- package/tools/builtin/fetch_url.py +153 -0
- package/tools/builtin/file_ops.py +412 -0
- package/tools/builtin/geometry.py +148 -0
- package/tools/builtin/get_time.py +20 -0
- package/tools/builtin/linear_algebra.py +155 -0
- package/tools/builtin/load_skill.py +66 -0
- package/tools/builtin/logic.py +96 -0
- package/tools/builtin/pin.py +193 -0
- package/tools/builtin/probability_stats.py +228 -0
- package/tools/builtin/project_docs.py +405 -0
- package/tools/builtin/remember.py +158 -0
- package/tools/builtin/shell.py +461 -0
- package/tools/builtin/symbolic_math.py +119 -0
- package/tools/builtin/todo.py +147 -0
- package/tools/builtin/web_search.py +151 -0
- package/tools/context.py +136 -0
- package/tools/isolation.py +314 -0
- package/tools/registry.py +897 -0
- package/tui/app.py +3423 -0
- package/tui/app.tcss +458 -0
- package/tui/commands.py +61 -0
- package/tui/diffs.py +265 -0
- package/tui/preferences.py +182 -0
- package/tui/ravens.py +146 -0
- package/tui/screens.py +943 -0
- package/tui/themes.py +366 -0
- package/tui/widgets.py +1239 -0
package/pyproject.toml
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# Issue #144 -- requirements.txt was the whole of what this project said
|
|
2
|
+
# about how to install it, and it is the one packaging format that cannot
|
|
3
|
+
# express a Python floor or an optional group.
|
|
4
|
+
#
|
|
5
|
+
# Python 3.11 is a hard requirement, not a preference: mcp_client/client.py
|
|
6
|
+
# uses asyncio.timeout (3.11+), and 27 sites use runtime `X | Y` annotations
|
|
7
|
+
# (3.10+). On 3.10 a user got `AttributeError: module 'asyncio' has no
|
|
8
|
+
# attribute 'timeout'` from inside the MCP connect path, AFTER
|
|
9
|
+
# `pip install -r requirements.txt` reported success. requires-python turns
|
|
10
|
+
# that into a refusal at install time.
|
|
11
|
+
|
|
12
|
+
# setuptools>=77 is the floor for PEP 639: the SPDX `license = "Apache-2.0"` string below is
|
|
13
|
+
# read as a classifier expression only from that release on. An older backend treats it as a
|
|
14
|
+
# path and fails the build rather than warning, so this floor and that line move together.
|
|
15
|
+
[build-system]
|
|
16
|
+
requires = ["setuptools>=77"]
|
|
17
|
+
build-backend = "setuptools.build_meta"
|
|
18
|
+
|
|
19
|
+
[project]
|
|
20
|
+
name = "venastine-research-harness"
|
|
21
|
+
version = "0.1.0"
|
|
22
|
+
description = "A from-scratch agentic harness: tool-using chat plus a ten-pass self-critiquing research pipeline."
|
|
23
|
+
readme = "README.md"
|
|
24
|
+
requires-python = ">=3.11"
|
|
25
|
+
# PEP 639: a bare SPDX expression, not the deprecated `{ text = ... }` table, and no
|
|
26
|
+
# `License :: OSI Approved ::` classifier -- PEP 639 supersedes those and setuptools warns on
|
|
27
|
+
# both. `license-files` is declared rather than left to the backend's default glob so the file
|
|
28
|
+
# that ships is the one named here.
|
|
29
|
+
license = "Apache-2.0"
|
|
30
|
+
# NOTICE ships WITH the licence, not beside it in the repo only: a NOTICE that
|
|
31
|
+
# is not listed here exists in a checkout and is absent from every sdist and
|
|
32
|
+
# wheel, which defeats the reason for having one. Apache-2.0 4(d) is what makes
|
|
33
|
+
# the pairing meaningful downstream.
|
|
34
|
+
license-files = ["LICENSE", "NOTICE"]
|
|
35
|
+
authors = [{ name = "Yahya Hammad" }]
|
|
36
|
+
maintainers = [{ name = "Yahya Hammad" }]
|
|
37
|
+
classifiers = [
|
|
38
|
+
"Programming Language :: Python :: 3",
|
|
39
|
+
"Programming Language :: Python :: 3.11",
|
|
40
|
+
"Programming Language :: Python :: 3.12",
|
|
41
|
+
"Programming Language :: Python :: 3.13",
|
|
42
|
+
"Intended Audience :: Science/Research",
|
|
43
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
44
|
+
]
|
|
45
|
+
|
|
46
|
+
# ONE dependency list, and it stays in requirements.txt -- the file that
|
|
47
|
+
# already carries the D22 rationale comments explaining why `textual` and
|
|
48
|
+
# `mcp` are upper-bounded. Inlining the list here would create a second
|
|
49
|
+
# hand-maintained copy of the same fact, which is the shape #144 was filed
|
|
50
|
+
# about in the first place ("a hand-maintained list is only as complete as
|
|
51
|
+
# the file it lives in"). setuptools strips comments and blank lines.
|
|
52
|
+
#
|
|
53
|
+
# THIS KEY MUST STAY INSIDE [project], above the sub-tables. TOML scopes a
|
|
54
|
+
# bare key to the most recent table header, so when this sat below
|
|
55
|
+
# [project.urls] it parsed as `project.urls.dynamic` and setuptools refused
|
|
56
|
+
# the whole file: "`project.urls.dynamic` must be string". `pip install -e .`
|
|
57
|
+
# failed outright, which also meant requires-python -- the entire point of
|
|
58
|
+
# #144 -- was never enforced, because the install never got far enough to
|
|
59
|
+
# check it. Moving a key past a table header here is not cosmetic.
|
|
60
|
+
dynamic = ["dependencies"]
|
|
61
|
+
|
|
62
|
+
[project.urls]
|
|
63
|
+
Homepage = "https://github.com/YahyaHammad/Venastine-Research-Harness"
|
|
64
|
+
Repository = "https://github.com/YahyaHammad/Venastine-Research-Harness"
|
|
65
|
+
Issues = "https://github.com/YahyaHammad/Venastine-Research-Harness/issues"
|
|
66
|
+
|
|
67
|
+
[project.optional-dependencies]
|
|
68
|
+
# markitdown's only consumer is tools/builtin/file_ops.py, which implements
|
|
69
|
+
# read/write/edit -- all three globally denied, and per S24 they cannot be
|
|
70
|
+
# re-enabled at runtime at all (is_tool_allowed reads config.ToolPermissions
|
|
71
|
+
# directly, settings.json has no permissions section, and D14 forbids a
|
|
72
|
+
# ToolContext widening anything). The import is lazy, so a default install
|
|
73
|
+
# never reaches it. It brought 11 transitive distributions, 5 of them for
|
|
74
|
+
# markitdown alone.
|
|
75
|
+
#
|
|
76
|
+
# protobuf moves with it rather than staying in the default set: nothing in
|
|
77
|
+
# the repo imports it, and the only installed distribution requiring it is
|
|
78
|
+
# onnxruntime, which arrives through markitdown. Left behind it would pin a
|
|
79
|
+
# transitive dependency of a package no longer installed by default.
|
|
80
|
+
documents = ["markitdown==0.1.6", "protobuf==7.35.1"]
|
|
81
|
+
|
|
82
|
+
# Optional in the code too, and documented as such at
|
|
83
|
+
# core/reasoning/output_writer.py:185 -- the PDF path is guarded by
|
|
84
|
+
# `except ImportError: return`. Declared here so the group has a name;
|
|
85
|
+
# neither was ever in requirements.txt.
|
|
86
|
+
pdf = ["markdown", "weasyprint"]
|
|
87
|
+
|
|
88
|
+
[tool.setuptools.dynamic]
|
|
89
|
+
dependencies = { file = ["requirements.txt"] }
|
|
90
|
+
|
|
91
|
+
[tool.setuptools]
|
|
92
|
+
# DECLARATIVE ONLY -- this project is run from a checkout, not installed.
|
|
93
|
+
# `pip install .` would otherwise put `config`, `main`, `storage` and
|
|
94
|
+
# `conftest` into site-packages as top-level names, where they collide with
|
|
95
|
+
# anything. Empty lists mean `pip install -e .` resolves the dependencies
|
|
96
|
+
# and enforces the Python floor without installing a single module, which
|
|
97
|
+
# is exactly what is wanted here. README's `pip install -r requirements.txt`
|
|
98
|
+
# remains the documented install path.
|
|
99
|
+
packages = []
|
|
100
|
+
py-modules = []
|
package/requirements.txt
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# The Python floor is 3.11 (mcp_client/client.py uses asyncio.timeout).
|
|
2
|
+
# requirements.txt cannot express that; pyproject.toml's requires-python
|
|
3
|
+
# can, and reads THIS file for the list below via dynamic dependencies --
|
|
4
|
+
# so there is one dependency list, not two. See issue #144.
|
|
5
|
+
#
|
|
6
|
+
# markitdown and protobuf moved to pyproject's `documents` extra: their
|
|
7
|
+
# only reachable consumer is behind read/write/edit, which are globally
|
|
8
|
+
# denied. `pip install -e ".[documents]"` brings them back.
|
|
9
|
+
|
|
10
|
+
anthropic==0.116.0
|
|
11
|
+
ddgs==9.14.4
|
|
12
|
+
httpx==0.28.1
|
|
13
|
+
openai==2.45.0
|
|
14
|
+
# NOTE (ROADMAP_v2 §16): this pin has no ThinkingConfig.thinking_budget --
|
|
15
|
+
# that field arrived in a later release. core/client.py checks for it at
|
|
16
|
+
# runtime and reports no effort levels on GOOGLE rather than sending a
|
|
17
|
+
# field the SDK cannot carry. Moving this pin enables Google effort; it
|
|
18
|
+
# also puts §9's verified Google implementation back in scope for retest.
|
|
19
|
+
google-genai==1.0.0
|
|
20
|
+
pydantic==2.13.4
|
|
21
|
+
sympy==1.13.3
|
|
22
|
+
sqlmodel==0.0.39
|
|
23
|
+
python-dotenv==1.2.2
|
|
24
|
+
matplotlib==3.10.3
|
|
25
|
+
pyyaml==6.0.3
|
|
26
|
+
# ROADMAP_v2 §16 TUI. Upper-bounded per D22 -- the mcp lesson was that an
|
|
27
|
+
# unpinned dependency mid-major-version-transition migrates you by accident.
|
|
28
|
+
textual>=1.0,<2.0
|
|
29
|
+
|
|
30
|
+
# Imported DIRECTLY at tui/widgets.py:8-9 (`rich.syntax.Syntax`,
|
|
31
|
+
# `rich.text.Text`) and previously undeclared -- present only because
|
|
32
|
+
# textual, mcp and httpx all happen to require it, so its major version was
|
|
33
|
+
# chosen by whatever textual's own range resolved to. Upper-bounded per D22
|
|
34
|
+
# for D22's own reason, and this was the one package the project imported
|
|
35
|
+
# without declaring, i.e. the one place such a migration would be silent.
|
|
36
|
+
rich>=13,<16
|
|
37
|
+
|
|
38
|
+
# ROADMAP_v2 §17 MCP client. Upper-bounded per D22 -- and D22 exists
|
|
39
|
+
# BECAUSE of this package: it was mid-major-version transition when §17
|
|
40
|
+
# was written, and 2.0.0 landed 2026-07-28 before implementation started.
|
|
41
|
+
#
|
|
42
|
+
# v2 is a real break for consumers, verified in hand rather than from the
|
|
43
|
+
# docs: result fields are snake_case (.content/.structured_content/
|
|
44
|
+
# .is_error, was camelCase), timeouts are float seconds (was timedelta),
|
|
45
|
+
# the exception is MCPError (was McpError), streamablehttp_client is
|
|
46
|
+
# removed, and httpx/httpx-sse are replaced by httpx2 -- which is why
|
|
47
|
+
# there are now two HTTP stacks installed. httpx stays; anthropic, openai
|
|
48
|
+
# and ddgs all still need it.
|
|
49
|
+
# EXACT, not the `>=2.0,<3` range this used to carry (batch 32, CI run
|
|
50
|
+
# 32778904550). D22's upper bound did its job -- no major migration -- but a
|
|
51
|
+
# MINOR still changed observable behaviour underneath it: 2.1.0 stopped
|
|
52
|
+
# passing a crashed tool's exception text back to the client ("the
|
|
53
|
+
# exception's own text stays on the server"), so a test asserting the
|
|
54
|
+
# message went red on main while every local run stayed green. The range
|
|
55
|
+
# meant CI's result depended on WHEN it ran, and CI was not testing what
|
|
56
|
+
# anyone runs locally -- which is the more serious half of that.
|
|
57
|
+
#
|
|
58
|
+
# So this is pinned the way anthropic, openai and google-genai already are.
|
|
59
|
+
# Moving it is now a deliberate step: read 2.1.0's split first -- a tool
|
|
60
|
+
# raising ToolError on purpose keeps its message, a tool that CRASHES has
|
|
61
|
+
# its text withheld -- and re-run tests/test_mcp_client.py, which is written
|
|
62
|
+
# to hold on both versions.
|
|
63
|
+
mcp==2.0.0
|
|
64
|
+
|
|
65
|
+
# --- Test dependencies -------------------------------------------------
|
|
66
|
+
# Previously absent, which the docs recorded as a known open item since
|
|
67
|
+
# §14: the suite has always needed pytest and pytest-mock, and §16's TUI
|
|
68
|
+
# pilot tests add pytest-asyncio. Listed now so `pip install -r` produces
|
|
69
|
+
# a working suite instead of one that fails at import.
|
|
70
|
+
pytest>=8.0
|
|
71
|
+
pytest-mock>=3.14
|
|
72
|
+
pytest-asyncio>=1.0
|
|
File without changes
|