@yahyahammad/venastine 0.3.10 → 0.3.12
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/NOTICE +5 -3
- package/README.md +52 -3
- package/docs/THIRD_PARTY_NOTICES.md +133 -60
- package/package.json +19 -2
- package/pyproject.toml +15 -1
- package/requirements.txt +8 -8
package/NOTICE
CHANGED
|
@@ -9,6 +9,8 @@ You may obtain a copy of the License at
|
|
|
9
9
|
|
|
10
10
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
The source installers resolve Python dependencies from PyPI under their own
|
|
13
|
+
licenses. The hosted terminal delivers third-party JavaScript and CSS to
|
|
14
|
+
visitors, with full browser notices in deploy/hosted/browser-NOTICES.txt and
|
|
15
|
+
at /venastine-static/NOTICE.txt on the hosted service. See
|
|
16
|
+
docs/THIRD_PARTY_NOTICES.md for dependency and distribution details.
|
package/README.md
CHANGED
|
@@ -1,7 +1,22 @@
|
|
|
1
|
-

|
|
2
|
-
|
|
3
1
|
# Venastine Research Harness
|
|
4
2
|
|
|
3
|
+
**Venastine Research Harness is an open-source, security-first agentic harness for large language models: a tool-using chat assistant and a ten-pass deep-research pipeline that fact-checks, critiques and scores its own claims, in your terminal or in the browser.**
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
<a href="https://huggingface.co/spaces/SolenopsisCampo/VenastineHarnessDemo"><img alt="Try the demo on a Hugging Face Space" src="https://img.shields.io/badge/Demo-Hugging%20Face%20Space-1783FF?logo=huggingface&logoColor=white"></a>
|
|
7
|
+
<a href="https://www.modelscope.ai/studios/Venastine-Research/VenastineHarnessDemo"><img alt="Try the demo on a ModelScope Studio" src="https://img.shields.io/badge/Demo-ModelScope%20Studio-1783FF?logo=modelscope&logoColor=white"></a>
|
|
8
|
+
<a href="https://huggingface.co/Venastine-Research"><img alt="Venastine-Research on Hugging Face" src="https://img.shields.io/badge/Hugging%20Face-Venastine--Research-FFC107?logo=huggingface&logoColor=white"></a>
|
|
9
|
+
<a href="https://www.modelscope.ai/organization/Venastine-Research"><img alt="Venastine-Research on ModelScope" src="https://img.shields.io/badge/ModelScope-Venastine--Research-624AFF?logo=modelscope&logoColor=white"></a>
|
|
10
|
+
<br>
|
|
11
|
+
<a href="https://github.com/YahyaHammad/Venastine-Research-Harness/releases/latest"><img alt="Latest GitHub release" src="https://img.shields.io/github/v/release/YahyaHammad/Venastine-Research-Harness?logo=github&label=release"></a>
|
|
12
|
+
<a href="https://www.npmjs.com/package/@yahyahammad/venastine"><img alt="npm package @yahyahammad/venastine" src="https://img.shields.io/npm/v/%40yahyahammad%2Fvenastine?logo=npm&label=npm"></a>
|
|
13
|
+
<a href="https://github.com/YahyaHammad/Venastine-Research-Harness/actions/workflows/tests.yml"><img alt="Tests on main" src="https://img.shields.io/github/actions/workflow/status/YahyaHammad/Venastine-Research-Harness/tests.yml?branch=main&label=tests&logo=githubactions&logoColor=white"></a>
|
|
14
|
+
<a href="#setup"><img alt="Python 3.11, 3.12 and 3.13" src="https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-3776AB?logo=python&logoColor=white"></a>
|
|
15
|
+
<a href="./LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-F5DE53"></a>
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+

|
|
19
|
+
|
|
5
20
|
An agentic harness built from scratch — no LangChain, no agent framework — with two modes that share the same machinery:
|
|
6
21
|
|
|
7
22
|
- **Chat** — a normal tool-using assistant loop.
|
|
@@ -122,6 +137,40 @@ Two things differ from a clone, both to make a command you run from anywhere beh
|
|
|
122
137
|
|
|
123
138
|
`venastine --venastine-doctor` prints every one of those resolved paths, plus the interpreter and environment it found.
|
|
124
139
|
|
|
140
|
+
#### With yarn, bun or pnpm
|
|
141
|
+
|
|
142
|
+
The same package installs from the npm registry with the other package
|
|
143
|
+
managers, and everything above about the launcher applies to each. The
|
|
144
|
+
launcher still needs Node.js 18 or newer, and the harness Python 3.11 or newer.
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
yarn global add @yahyahammad/venastine
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
bun add -g --backend=copyfile @yahyahammad/venastine
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
pnpm add -g --config.package-import-method=copy @yahyahammad/venastine
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
To update, run the same command with `@latest` after the package name.
|
|
159
|
+
|
|
160
|
+
* **yarn means Yarn 1 (classic).** Yarn 2 and later have no global install.
|
|
161
|
+
* **bun and pnpm need the copy flag, on updates too.** By default both
|
|
162
|
+
hardlink the package's files out of a shared cache or store, so the
|
|
163
|
+
harness's own source, which it protects from tool writes, would have a
|
|
164
|
+
second name in a folder it does not protect. The flag makes them copy,
|
|
165
|
+
as npm and yarn do.
|
|
166
|
+
* **pnpm does not carry `config.yaml` edits across an update.** It puts
|
|
167
|
+
every install in a new directory, and the harness keys your saved
|
|
168
|
+
`config.yaml` values by the install's directory, so after an update the
|
|
169
|
+
values you set with `/config` or by editing that file are back at the
|
|
170
|
+
shipped defaults. What lives in `~/.config/venastine` (`settings.json`,
|
|
171
|
+
keys, conversations and memories) is unaffected. If you rely on
|
|
172
|
+
`config.yaml` edits, install with npm, yarn or bun instead.
|
|
173
|
+
|
|
125
174
|
### From a clone
|
|
126
175
|
|
|
127
176
|
```bash
|
|
@@ -1015,7 +1064,7 @@ note that shell approval is governed solely by `shell_approval_mode` -- `tool_ap
|
|
|
1015
1064
|
deliberately has no `shell` key, so an old file carrying one is refused at startup
|
|
1016
1065
|
naming the key — see `tests/BREAKING_CHANGES.md` §24.
|
|
1017
1066
|
|
|
1018
|
-
Run the test suite with `pytest` —
|
|
1067
|
+
Run the test suite with `pytest` — 9199 tests, fully offline, no API keys needed. Since batch 243 the suite holds itself to that: a test that asks DNS for a name, or writes into your home folder, fails by name, and every test process runs with HOME pointing at a throwaway folder of its own. The suite's own packages are `requirements-test.txt`, separate from `requirements.txt` since batch 136: they used to be in the shipped dependency list, so installing the harness also installed a test runner. It runs in parallel by default (`pytest-xdist`, 70% of your cores): **1:26 on a 16-core machine, against 9:06 single-process.** `pytest -n0` forces the old serial run, which is what you want under a debugger or when something is parsing the output. Eight further tests are marked `integration` and excluded by default: three spawn a real stdio MCP server, one runs an external program through the host fallback shell, one builds the hosted bundle's Docker image, and three run the installers' uv path against a real uv (`pytest -m integration`).
|
|
1019
1068
|
|
|
1020
1069
|
## Documentation
|
|
1021
1070
|
|
|
@@ -1,14 +1,27 @@
|
|
|
1
1
|
# Third-Party Notices
|
|
2
2
|
|
|
3
|
-
This project is licensed under the **Apache License 2.0** — see [LICENSE](
|
|
4
|
-
|
|
5
|
-
The
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
>
|
|
3
|
+
This project is licensed under the **Apache License 2.0** — see [LICENSE](../LICENSE) and [NOTICE](../NOTICE) (Copyright 2026 Yahya Hammad).
|
|
4
|
+
|
|
5
|
+
The tables record the declared core, test, optional, build and hosted dependencies.
|
|
6
|
+
Their project-level licenses are permissive; this is not a license assessment of
|
|
7
|
+
all transitive packages or embedded native libraries. Declarations and the
|
|
8
|
+
license corrections below were checked on 2026-11-07 against the manifests,
|
|
9
|
+
PyPI release metadata and the relevant wheel license files.
|
|
10
|
+
|
|
11
|
+
> **Distribution scope.** Git source archives, the GitHub installers and npm
|
|
12
|
+
> carry first-party source and notices; Python dependencies are fetched separately.
|
|
13
|
+
> The hosted terminal **does deliver third-party JavaScript and CSS** to browsers.
|
|
14
|
+
> Its notices accompany the JavaScript response and are linked from the terminal.
|
|
15
|
+
> A built ModelScope container contains installed dependencies and Debian packages;
|
|
16
|
+
> distributing that image requires a separate review of the exact image layers.
|
|
17
|
+
|
|
18
|
+
> **Transitive dependencies.** These tables are not a full resolved inventory.
|
|
19
|
+
> For example, HTTP clients bring certifi (MPL-2.0), hosted installs bring tqdm
|
|
20
|
+
> (MPL-2.0 AND MIT) and Gradio brings orjson (MPL-2.0 AND (Apache-2.0 OR MIT)).
|
|
21
|
+
> `httpx2` (BSD-3-Clause) and SQLAlchemy (MIT) are imported directly by the
|
|
22
|
+
> harness but supplied transitively by the SDKs/MCP and SQLModel, respectively.
|
|
23
|
+
> Versions selected by ranges can change; use the exact installed artifacts
|
|
24
|
+
> when reviewing a redistributed environment.
|
|
12
25
|
|
|
13
26
|
## Runtime / core dependencies
|
|
14
27
|
|
|
@@ -31,12 +44,18 @@ The dependencies listed below are **not** part of the project's own source but a
|
|
|
31
44
|
| google-re2 | `==1.1.20251105` | BSD-3-Clause | Yes | https://pypi.org/project/google-re2/ |
|
|
32
45
|
| cryptography | `>=50.0.0,<52` | Apache-2.0 OR BSD-3-Clause | Yes | https://pypi.org/project/cryptography/ |
|
|
33
46
|
| PyJWT | `>=2.15.0,<3` | MIT | Yes | https://pypi.org/project/PyJWT/ |
|
|
47
|
+
| defusedxml | `==0.7.1` | PSF-2.0 | Yes | https://pypi.org/project/defusedxml/ |
|
|
48
|
+
| pypdf | `==6.21.4` | BSD-3-Clause | Yes | https://pypi.org/project/pypdf/ |
|
|
34
49
|
|
|
35
|
-
`google-re2`
|
|
36
|
-
|
|
37
|
-
|
|
50
|
+
`google-re2` and `cryptography` ship compiled native code. RE2's wheels
|
|
51
|
+
include the RE2 C++ library (BSD-3-Clause) and Abseil (Apache-2.0).
|
|
52
|
+
Cryptography's wheels include a Rust extension and OpenSSL (Apache-2.0).
|
|
53
|
+
The source installers fetch these wheels onto the user's machine; a distributor
|
|
54
|
+
of an installed environment must inspect their bundled notices separately.
|
|
55
|
+
Declaring cryptography did not introduce it to the install closure: Google
|
|
56
|
+
Auth already required it through Google Gen AI.
|
|
38
57
|
|
|
39
|
-
`pillow` was declared on 2026-10-28 (batch 201), as a floor under what `matplotlib` pulled in, and removed with `matplotlib` in batch 212:
|
|
58
|
+
`pillow` was declared on 2026-10-28 (batch 201), as a floor under what `matplotlib` pulled in, and removed with `matplotlib` in batch 212: the default harness install no longer reaches it; optional document/PDF dependencies can still bring it. The hosted demo's Gradio bridge still installs it, in an environment of its own (`deploy/hosted/requirements.txt`).
|
|
40
59
|
|
|
41
60
|
## Test dependencies (not used by end users during runtime, only for CI and developer testing)
|
|
42
61
|
|
|
@@ -46,24 +65,39 @@ The dependencies listed below are **not** part of the project's own source but a
|
|
|
46
65
|
| pytest-mock | `>=3.14` | MIT | Yes |
|
|
47
66
|
| pytest-asyncio | `>=1.0` | Apache-2.0 | Yes |
|
|
48
67
|
| pytest-xdist | `>=3.6` | MIT | Yes |
|
|
68
|
+
| starlette | `>=0.40` | BSD-3-Clause | Yes |
|
|
49
69
|
| execnet | transitive (via `pytest-xdist`) | MIT | Yes |
|
|
50
70
|
|
|
51
|
-
`execnet` is listed although nothing declares it: it is `pytest-xdist`'s only dependency and the process that actually runs each worker, so a reader auditing what a `pip install -r requirements.txt` puts on the machine would otherwise have to go and find it.
|
|
71
|
+
`execnet` is listed although nothing declares it: it is `pytest-xdist`'s only dependency and the process that actually runs each worker, so a reader auditing what a `pip install -r requirements-test.txt` puts on the machine would otherwise have to go and find it. It belongs to the test environment rather than the default runtime.
|
|
52
72
|
|
|
53
73
|
## Optional dependencies (`pyproject.toml` extras)
|
|
54
74
|
|
|
55
75
|
| Package | Version (as pinned) | Primary License | Apache 2.0 Compatible | Notes |
|
|
56
76
|
|---|---|---|---|---|
|
|
57
77
|
| markitdown | `==0.1.9` (extra `documents`) | MIT | Yes | Permissive; only reachable behind `read`/`write`/`edit` (globally denied). |
|
|
58
|
-
| protobuf | `==7.36.2` (extra `documents`) | BSD-3-Clause
|
|
78
|
+
| protobuf | `==7.36.2` (extra `documents`) | BSD-3-Clause | Yes | Permissive; transitive via `markitdown`→`onnxruntime`. |
|
|
59
79
|
| markdown | unpinned (extra `pdf`) | BSD-3-Clause | Yes | Permissive |
|
|
60
|
-
| weasyprint | unpinned (extra `pdf`) | BSD-3-Clause (package) | Yes (with caveats) | Package itself BSD-3-Clause;
|
|
80
|
+
| weasyprint | unpinned (extra `pdf`) | BSD-3-Clause (package) | Yes (with caveats) | Package itself BSD-3-Clause; Pyphen has alternative GPL/LGPL/MPL code terms and separate dictionary terms; system libraries have their own licenses. |
|
|
81
|
+
|
|
82
|
+
`weasyprint` is BSD-3-Clause itself. Its Python closure includes Pyphen with
|
|
83
|
+
alternative GPL/LGPL/MPL code licenses and separately licensed dictionaries.
|
|
84
|
+
Its native stack includes Pango (LGPL) and HarfBuzz (MIT-style); current
|
|
85
|
+
WeasyPrint uses pydyf for PDF output. Review exact Python and OS artifacts
|
|
86
|
+
before redistributing a PDF-capable environment. Windows MCP installs also
|
|
87
|
+
bring pywin32, whose adodbapi component has LGPL-2.1 terms.
|
|
61
88
|
|
|
62
|
-
|
|
89
|
+
## Build backend
|
|
90
|
+
|
|
91
|
+
| Package | Declaration | Primary License | Source |
|
|
92
|
+
|---|---|---|---|
|
|
93
|
+
| setuptools | `>=77` in `pyproject.toml` | MIT, with separate vendor notices | https://pypi.org/project/setuptools/ |
|
|
63
94
|
|
|
64
95
|
## Hosted demo (`deploy/`, ROADMAP_v3 §79)
|
|
65
96
|
|
|
66
|
-
|
|
97
|
+
The bridge runs separately from the harness's session environment. These
|
|
98
|
+
packages are installed by the hosting platform or generated Docker build;
|
|
99
|
+
`deploy/` is excluded from npm and the metadata-only Python wheel. Installing
|
|
100
|
+
packages on the server and sending their assets to browsers are distinct paths.
|
|
67
101
|
|
|
68
102
|
| Package | Version (as pinned) | Primary License | Apache 2.0 Compatible | Where |
|
|
69
103
|
|---|---|---|---|---|
|
|
@@ -73,38 +107,65 @@ What the bridge -- the process that serves a Space's or Studio's page and relays
|
|
|
73
107
|
| gradio | `==6.30.0` | Apache-2.0 | Yes | installed by the Space at the README's `sdk_version`; in the Studio's `bridge.lock` |
|
|
74
108
|
| spaces | `==0.51.3` | Apache-2.0 | Yes | installed by the Space itself; in the Studio's `bridge.lock` |
|
|
75
109
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
110
|
+
### Browser assets
|
|
111
|
+
|
|
112
|
+
The bridge serves only `js/textual.js`, `css/xterm.css` and `NOTICE.txt` under
|
|
113
|
+
`/venastine-static/`. It does not expose the wheel's unused Roboto Mono fonts
|
|
114
|
+
or background image. The font name tables in Textual Serve 1.1.3 identify
|
|
115
|
+
Apache-2.0; blocking those URLs avoids delivering unneeded font copies.
|
|
116
|
+
The terminal's external Google Fonts stylesheet is a separate delivery by Google.
|
|
117
|
+
|
|
118
|
+
The reviewed wheel SHA-256 is
|
|
119
|
+
`207a472bc6604e725b1adab4ab8bf12f4c4dc25b04eea31e4d04731d8bf30f18`.
|
|
120
|
+
The bridge checks the original JS and CSS hashes before serving them and adds
|
|
121
|
+
[full browser notices](../deploy/hosted/browser-NOTICES.txt) to every JS response.
|
|
122
|
+
The same text is available at `/venastine-static/NOTICE.txt` and linked from the
|
|
123
|
+
terminal. The CSS retains its full MIT notice. Embedded components identified
|
|
124
|
+
in the JS include xterm.js and its addons (MIT), js-base64 3.7.7 (BSD-3-Clause),
|
|
125
|
+
and webpack loader/runtime code (MIT), as well as Textual Serve (MIT).
|
|
126
|
+
Upstream supplies no frontend lockfile, so exact versions of every embedded
|
|
127
|
+
component are not established. A changed asset hash requires a renewed review.
|
|
128
|
+
|
|
129
|
+
### Installed images and native components
|
|
130
|
+
|
|
131
|
+
The ModelScope recipe installs the bridge and session packages into a
|
|
132
|
+
Debian-based Python image. This review did not obtain the deployed image or
|
|
133
|
+
establish its delivery terms. It therefore makes no claim of image compliance
|
|
134
|
+
or violation. Before supplying an image copy, inspect its exact wheels and OS
|
|
135
|
+
packages, preserve bundled LICENSE/NOTICE files, and satisfy applicable source
|
|
136
|
+
availability and license requirements for MPL/LGPL/GPL-covered components.
|
|
137
|
+
Include OpenSSL, Abseil, native libraries bundled in wheels and Debian packages
|
|
138
|
+
in that review. Platform-managed Hugging Face packages, including GPU wheels,
|
|
139
|
+
are not a fixed inventory established by the source manifests alone.
|
|
140
|
+
|
|
141
|
+
## Development and deployment tooling
|
|
142
|
+
|
|
143
|
+
These tools run in CI or the operator's environment; they are not npm runtime
|
|
144
|
+
dependencies. Entries describe the primary project licenses, not every vendored
|
|
145
|
+
component or service agreement.
|
|
146
|
+
|
|
147
|
+
| Package | Declaration / use | Primary License |
|
|
148
|
+
|---|---|---|
|
|
149
|
+
| huggingface_hub | `==2.2.0`, deployment CI | Apache-2.0 |
|
|
150
|
+
| pip-audit | `==2.10.1`, dependency audit | Apache-2.0 |
|
|
151
|
+
| bandit | `==1.9.4`, security scan | Apache-2.0 |
|
|
152
|
+
| ruff | `==0.15.21`, lint | MIT |
|
|
153
|
+
| uv | `==0.13.4`, CI and hosted setup | MIT OR Apache-2.0 |
|
|
154
|
+
| modelscope | optional operator login CLI, unpinned | Apache-2.0 |
|
|
155
|
+
| gitleaks | `8.30.1`, secret scan | MIT |
|
|
156
|
+
|
|
157
|
+
CPython, Node.js/npm, GitHub Actions, CodeQL and optional Docker/Podman and SSH
|
|
158
|
+
helpers have their own project, bundled-component and, for CodeQL, service/tool
|
|
159
|
+
terms. They are execution tools rather than dependencies embedded in the source
|
|
160
|
+
package. Do not infer their complete license inventory from the Python tables.
|
|
84
161
|
|
|
85
162
|
## Non-code third-party material
|
|
86
163
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
(`config.yaml`, `pyproject.toml`, the three requirements files, `package.json`, `pytest.ini`, the
|
|
93
|
-
`.github/` workflows, issue templates and scanner configuration, the dotfiles), the two prompt
|
|
94
|
-
texts, `bin/venastine.mjs` and `scripts/prepublish-check.mjs`, `docs/assets/research-mode-birds-eye.mermaid`,
|
|
95
|
-
`tui/app.tcss`, the two `.example` templates, the hosted demo's four page templates in
|
|
96
|
-
`deploy/hosted/`, one screenshot of this project's own interface, and its cover image with the
|
|
97
|
-
page it is rendered from. **No third-party fonts, images or data files are bundled.** The
|
|
98
|
-
cover's text is set in Cascadia Mono, Microsoft's font under the SIL Open Font License: the PNG
|
|
99
|
-
holds rendered glyphs, and its page names the font, and neither carries a copy of it.
|
|
100
|
-
|
|
101
|
-
*(Counts restated in batch 83. The figure had been 166 against 200, the enumeration named
|
|
102
|
-
five of the thirty-four, and the closing sentence said there were no images at all while the
|
|
103
|
-
screenshot was tracked. The claim itself held throughout; only its arithmetic had drifted.)*
|
|
104
|
-
|
|
105
|
-
*(Restated again in batch 198, when the cover joined: 200 and 34 had become 277 and 43 as the
|
|
106
|
-
project grew. Both sweeps were run again and found nothing new, and every file added since
|
|
107
|
-
batch 83 is first-party.)*
|
|
164
|
+
The repository does not vendor dependency wheels, third-party fonts or browser
|
|
165
|
+
bundles. The hosted bridge reads the browser bundle from its installed wheel
|
|
166
|
+
and adds the reproduced license texts in `deploy/hosted/browser-NOTICES.txt`.
|
|
167
|
+
The cover image contains rendered glyphs from Cascadia Mono (SIL Open Font
|
|
168
|
+
License); it does not carry the font file.
|
|
108
169
|
|
|
109
170
|
What the repository *does* reproduce is third-party **text**:
|
|
110
171
|
|
|
@@ -128,21 +189,33 @@ What the repository *does* reproduce is third-party **text**:
|
|
|
128
189
|
|
|
129
190
|
## What this means
|
|
130
191
|
|
|
131
|
-
*
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
* The
|
|
135
|
-
|
|
192
|
+
* The harness's Apache-2.0 license does not replace the licenses of dependencies,
|
|
193
|
+
browser components, fonts or native libraries. Permissive direct dependencies
|
|
194
|
+
do not imply that the full installed closure contains no copyleft components.
|
|
195
|
+
* The source channels fetch Python packages separately. The npm launcher uses
|
|
196
|
+
Node built-ins and declares no npm dependencies or bundled dependencies.
|
|
197
|
+
Do not add wheels or installed dependency directories to the npm tarball.
|
|
198
|
+
* Hosted JS and CSS are copies delivered to visitors. Their notices must
|
|
199
|
+
accompany those copies; a LICENSE file only in server-side wheel metadata
|
|
200
|
+
does not accompany the browser response.
|
|
201
|
+
* A redistributed installed image needs its own artifact inventory, notices
|
|
202
|
+
and any applicable source availability arrangements. A source-only assessment
|
|
203
|
+
does not establish compliance for that image.
|
|
204
|
+
* The root [NOTICE](../NOTICE) describes these delivery paths. The first-party
|
|
205
|
+
copyright notice is voluntary; recipients must still retain applicable
|
|
206
|
+
third-party notices when redistributing their covered components.
|
|
136
207
|
|
|
137
208
|
## How to regenerate
|
|
138
209
|
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
210
|
+
Read `requirements.txt`, `requirements-test.txt`, the build backend and extras
|
|
211
|
+
in `pyproject.toml`, `deploy/hosted/requirements.txt`, and generated platform
|
|
212
|
+
inputs in `scripts/build_demo_bundle.py`. Inspect the exact resolved wheels
|
|
213
|
+
and their license files, including vendor notices; metadata alone can omit them.
|
|
214
|
+
`pip-licenses --format markdown --with-urls --with-license-file` can help list
|
|
215
|
+
an installed environment, but does not inventory browser bundles or OS layers.
|
|
144
216
|
|
|
145
|
-
When a
|
|
217
|
+
When a declaration changes, update its table row and review the actual delivery
|
|
218
|
+
path. For a Textual Serve repin, inspect the bundle components and fonts, update
|
|
219
|
+
browser notices and the reviewed asset hashes, and verify the served responses.
|
|
146
220
|
|
|
147
|
-
|
|
148
|
-
*Last updated: 2026-08-27. If any row's upstream re-licenses, this file must be updated.*
|
|
221
|
+
*Last checked: 2026-11-07.*
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@yahyahammad/venastine",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.12",
|
|
4
4
|
"description": "A from-scratch agentic harness: tool-using chat plus a ten-pass self-critiquing research pipeline.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent",
|
|
@@ -8,7 +8,24 @@
|
|
|
8
8
|
"research",
|
|
9
9
|
"anthropic",
|
|
10
10
|
"openai",
|
|
11
|
-
"mcp"
|
|
11
|
+
"mcp",
|
|
12
|
+
"agentic-ai",
|
|
13
|
+
"ai-agent",
|
|
14
|
+
"agent-harness",
|
|
15
|
+
"llm-agent",
|
|
16
|
+
"research-agent",
|
|
17
|
+
"deep-research",
|
|
18
|
+
"fact-checking",
|
|
19
|
+
"tool-use",
|
|
20
|
+
"model-context-protocol",
|
|
21
|
+
"gemini",
|
|
22
|
+
"deepseek",
|
|
23
|
+
"openrouter",
|
|
24
|
+
"hugging-face",
|
|
25
|
+
"modelscope",
|
|
26
|
+
"security",
|
|
27
|
+
"cli",
|
|
28
|
+
"tui"
|
|
12
29
|
],
|
|
13
30
|
"homepage": "https://github.com/YahyaHammad/Venastine-Research-Harness#readme",
|
|
14
31
|
"bugs": {
|
package/pyproject.toml
CHANGED
|
@@ -18,9 +18,17 @@ build-backend = "setuptools.build_meta"
|
|
|
18
18
|
|
|
19
19
|
[project]
|
|
20
20
|
name = "venastine-research-harness"
|
|
21
|
-
version = "0.3.
|
|
21
|
+
version = "0.3.12"
|
|
22
22
|
description = "A from-scratch agentic harness: tool-using chat plus a ten-pass self-critiquing research pipeline."
|
|
23
23
|
readme = "README.md"
|
|
24
|
+
# The same words as package.json's `keywords`, in the same order: what a
|
|
25
|
+
# package index searches. test_docs_consistency.py holds the two lists equal.
|
|
26
|
+
keywords = [
|
|
27
|
+
"agent", "llm", "research", "anthropic", "openai", "mcp", "agentic-ai",
|
|
28
|
+
"ai-agent", "agent-harness", "llm-agent", "research-agent", "deep-research",
|
|
29
|
+
"fact-checking", "tool-use", "model-context-protocol", "gemini", "deepseek",
|
|
30
|
+
"openrouter", "hugging-face", "modelscope", "security", "cli", "tui",
|
|
31
|
+
]
|
|
24
32
|
requires-python = ">=3.11"
|
|
25
33
|
# PEP 639: a bare SPDX expression, not the deprecated `{ text = ... }` table, and no
|
|
26
34
|
# `License :: OSI Approved ::` classifier -- PEP 639 supersedes those and setuptools warns on
|
|
@@ -39,6 +47,9 @@ classifiers = [
|
|
|
39
47
|
"Programming Language :: Python :: 3.11",
|
|
40
48
|
"Programming Language :: Python :: 3.12",
|
|
41
49
|
"Programming Language :: Python :: 3.13",
|
|
50
|
+
"Environment :: Console",
|
|
51
|
+
"Operating System :: OS Independent",
|
|
52
|
+
"Intended Audience :: Developers",
|
|
42
53
|
"Intended Audience :: Science/Research",
|
|
43
54
|
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
44
55
|
]
|
|
@@ -63,6 +74,9 @@ dynamic = ["dependencies"]
|
|
|
63
74
|
Homepage = "https://github.com/YahyaHammad/Venastine-Research-Harness"
|
|
64
75
|
Repository = "https://github.com/YahyaHammad/Venastine-Research-Harness"
|
|
65
76
|
Issues = "https://github.com/YahyaHammad/Venastine-Research-Harness/issues"
|
|
77
|
+
Documentation = "https://github.com/YahyaHammad/Venastine-Research-Harness#readme"
|
|
78
|
+
Changelog = "https://github.com/YahyaHammad/Venastine-Research-Harness/releases"
|
|
79
|
+
Demo = "https://huggingface.co/spaces/SolenopsisCampo/VenastineHarnessDemo"
|
|
66
80
|
|
|
67
81
|
[project.optional-dependencies]
|
|
68
82
|
# markitdown's only consumer is tools/builtin/file_ops.py, which implements
|
package/requirements.txt
CHANGED
|
@@ -21,10 +21,10 @@
|
|
|
21
21
|
# test_sdk_conformance.py re-checks the shapes. What to re-measure when
|
|
22
22
|
# these move: that the stream, the effort query and the error types still
|
|
23
23
|
# match, since the suite fakes both packages everywhere else.
|
|
24
|
-
anthropic==2.
|
|
25
|
-
ddgs==9.16.
|
|
24
|
+
anthropic==2.5.0
|
|
25
|
+
ddgs==9.16.1
|
|
26
26
|
httpx==0.28.1
|
|
27
|
-
openai==3.
|
|
27
|
+
openai==3.45.0
|
|
28
28
|
# ROADMAP_v3 §82 (GS1), batch 172: 1.0.0 -> 2.29.0, the owner's choice.
|
|
29
29
|
# Gemini 3 refuses a request whose current turn holds a function call
|
|
30
30
|
# without the thought signature it came with; 1.0.0's Part had no field
|
|
@@ -37,7 +37,7 @@ openai==3.36.0
|
|
|
37
37
|
# transport is httpx now, not requests. 2.32.0 since batch 234, the newest
|
|
38
38
|
# release at least two weeks old; test_sdk_conformance.py is the evidence,
|
|
39
39
|
# with no live Gemini call (no key on this machine).
|
|
40
|
-
google-genai==2.
|
|
40
|
+
google-genai==2.34.0
|
|
41
41
|
# Batch 208, from Dependabot's group, the owner's choice of which: the
|
|
42
42
|
# packages below are ones the suite runs for real rather than faking, so
|
|
43
43
|
# a green suite is evidence about them, and each release was at least two
|
|
@@ -52,7 +52,7 @@ google-genai==2.32.0
|
|
|
52
52
|
# core/reasoning/output_writer.py draws the chart as SVG with the standard
|
|
53
53
|
# library now. pillow's floor (batch 201) went with it: nothing else here
|
|
54
54
|
# reaches pillow.
|
|
55
|
-
pydantic==2.14.
|
|
55
|
+
pydantic==2.14.2
|
|
56
56
|
sympy==1.14.0
|
|
57
57
|
# 0.0.48 since batch 234: test_storage_e2e.py runs it for real.
|
|
58
58
|
sqlmodel==0.0.48
|
|
@@ -122,7 +122,7 @@ textual==8.2.8
|
|
|
122
122
|
# without declaring, i.e. the one place such a migration would be silent.
|
|
123
123
|
# The FLOOR is textual's, not a guess: 8.2.8 requires `rich>=14.2.0`, so
|
|
124
124
|
# `>=13` stated a version this project can no longer be installed with.
|
|
125
|
-
rich>=
|
|
125
|
+
rich>=15.0.0,<16
|
|
126
126
|
|
|
127
127
|
# ROADMAP_v2 §17 MCP client. Upper-bounded per D22 -- and D22 exists
|
|
128
128
|
# BECAUSE of this package: it was mid-major-version transition when §17
|
|
@@ -239,7 +239,7 @@ google-re2==1.1.20251105
|
|
|
239
239
|
# message (the store relies on the three failure causes being
|
|
240
240
|
# indistinguishable), and the wheel list still covers this project's
|
|
241
241
|
# platforms.
|
|
242
|
-
cryptography>=50.0.
|
|
242
|
+
cryptography>=50.0.2,<52
|
|
243
243
|
|
|
244
244
|
# ROADMAP_v3 §83 (CG6, CG16). Checks the ID token a ChatGPT-plan sign-in
|
|
245
245
|
# returns against OpenAI's published keys: RS256, issuer, audience, expiry
|
|
@@ -266,7 +266,7 @@ cryptography>=50.0.0,<52
|
|
|
266
266
|
# moves: `jwt.decode` still refuses an algorithm outside the list it is
|
|
267
267
|
# given (the `none` and HS256 tests in tests/test_chatgpt_auth.py), and
|
|
268
268
|
# `PyJWKSet` still reads OpenAI's JWKS.
|
|
269
|
-
PyJWT>=2.15.
|
|
269
|
+
PyJWT>=2.15.1,<3
|
|
270
270
|
|
|
271
271
|
# TECHNICAL_DEBT 18, batch 116. A PRODUCTION dependency: `arxiv.py` imports
|
|
272
272
|
# it at module load, and pyproject.toml reads this file for its dependency
|