vsh-python 0.3.1__tar.gz → 0.5.0__tar.gz

{vsh_python-0.3.1 → vsh_python-0.5.0}/Cargo.lock

@@ -245,6 +245,18 @@ version = "1.0.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
+[[package]]
+name = "char_str"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "576ba56f6ca18ebb069d0d07260407171712aff4dfe15ee3f8982dc16a455bcf"
+dependencies = [
+ "castaway",
+ "get-size2",
+ "itoa",
+ "ryu",
+]
+
 [[package]]
 name = "chrono"
 version = "0.4.45"
@@ -276,16 +288,15 @@ checksum = "2550f75b8cfac212855f6b1885455df8eaee8fe8e246b647d69146142e016084"
 
 [[package]]
 name = "compact_str"
-version = "0.9.1"
+version = "0.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9dfdd1c2274d9aa354115b09dc9a901d6c5576818cdf70d14cae2bdb47df00ab"
+checksum = "79fcda08c33bb58b97008b2cdada6622500e949e060f5913361763121abd2416"
 dependencies = [
  "castaway",
  "cfg-if",
  "itoa",
- "rustversion",
- "ryu",
  "static_assertions",
+ "zmij",
 ]
 
 [[package]]
@@ -337,6 +348,12 @@ dependencies = [
  "syn 3.0.4",
 ]
 
+[[package]]
+name = "drop_bomb"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9bda8e21c04aca2ae33ffc2fd8c23134f3cac46db123ba97bd9d3f3b8a4a85e1"
+
 [[package]]
 name = "either"
 version = "1.18.0"
@@ -448,9 +465,9 @@ dependencies = [
 
 [[package]]
 name = "get-size2"
-version = "0.10.1"
+version = "0.10.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "823645bc6404ae2915707777061a47d3a031a9ee0bff51b34ec973df3d8d2990"
+checksum = "b411f34418305908ab15a82ff78958c2a9aee9a272b2a2e663836b20a4e4b9d3"
 dependencies = [
  "compact_str",
  "get-size-derive2",
@@ -832,13 +849,14 @@ checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
 
 [[package]]
 name = "monty"
-version = "0.0.21"
+version = "0.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "db44565f603ada5dd98bd580623cd9ce299c8b823bd7195c654826fa536b4d48"
+checksum = "a7d13cc6e5bbcadffceadecd5cbe51a765a29451381d6ed760b23933fb714f37"
 dependencies = [
  "ahash",
  "chrono",
  "fancy-regex",
+ "getrandom 0.3.4",
  "hashbrown 0.16.1",
  "indexmap",
  "itertools 0.14.0",
@@ -869,18 +887,18 @@ dependencies = [
 
 [[package]]
 name = "monty-alloc"
-version = "0.0.21"
+version = "0.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c0116e09c9b26d3ff56bdc9678a2a8704a8e868a58b743d1df947f85109258d2"
+checksum = "a0caad99e04b35d032ebd8c51a2c157255035d0a6c106960420c35adb80a9827"
 dependencies = [
  "monty-types",
 ]
 
 [[package]]
 name = "monty-macros"
-version = "0.0.21"
+version = "0.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "40ed428288161f63d2bec7929438563fe31390f08e014e58ce20be96d7ef82ee"
+checksum = "017842a9c6539f60ced38edab5b75a3c35223e908e9221c3b5c1a08537e21d2b"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -889,9 +907,9 @@ dependencies = [
 
 [[package]]
 name = "monty-proto"
-version = "0.0.21"
+version = "0.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b8741cb0a667eebd8bf090affd2f5f92bcf1597b9216f7714e9ea6b2ef6ac556"
+checksum = "f08c2cfd327e6fcb45f7e2c4dae9bbe9aa8a2cc99c292798a8a11531b30ebd90"
 dependencies = [
  "monty-types",
  "num-bigint",
@@ -901,9 +919,9 @@ dependencies = [
 
 [[package]]
 name = "monty-types"
-version = "0.0.21"
+version = "0.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "00b4b3318107fee36c5eee05c52f16f6565a63aa29d04f8608ebc221e3fe5dd8"
+checksum = "7cde2e299aa36171838b74a67ef7d3fbd116174ccaf2cbdd537a42a9658c024d"
 dependencies = [
  "chrono",
  "monty-macros",
@@ -1234,13 +1252,14 @@ checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
 
 [[package]]
 name = "ruff_python_ast"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a10ab966362319801f5e85ce5c6aeac69f0cf50936a31e888f5d004e9279f337"
+checksum = "2ca96e1ff7a76b0235df556968ae10e5f8a00a0efa3061f247ad18365f769c2d"
 dependencies = [
  "aho-corasick",
  "arrayvec",
  "bitflags",
+ "char_str",
  "compact_str",
  "get-size2",
  "is-macro",
@@ -1255,9 +1274,9 @@ dependencies = [
 
 [[package]]
 name = "ruff_python_codegen"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1902d82ae0745be9d3d12a1aee4429acff987c768710dc38a6521eab05990ca0"
+checksum = "d160278f35f69e31610f068ecac420baaee14be8b1defadc4ea464b5c5523b78"
 dependencies = [
  "ruff_python_ast",
  "ruff_python_literal",
@@ -1268,9 +1287,9 @@ dependencies = [
 
 [[package]]
 name = "ruff_python_literal"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af3e1f868fa58adc12d1fa3ce1b29c6098aa4b101739d9589cbde9fec239af59"
+checksum = "66ef25a922a0345c97a9eda5896a8bc9313b937b828596c4c65016e206285663"
 dependencies = [
  "bitflags",
  "icu_properties",
@@ -1280,13 +1299,13 @@ dependencies = [
 
 [[package]]
 name = "ruff_python_parser"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4e3b8436fb010636ea79ce545acc3e391296ef4e804f7cef336dd5f9c8a4aa3a"
+checksum = "1cf63608d433331007574be9d7fa17f3d99fc4b9305abcd9cf47a8033690628d"
 dependencies = [
  "bitflags",
  "bstr",
- "compact_str",
+ "drop_bomb",
  "get-size2",
  "memchr",
  "ruff_python_ast",
@@ -1302,9 +1321,9 @@ dependencies = [
 
 [[package]]
 name = "ruff_python_stdlib"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8c8860927bf42efdabb31ccb2ac9b8f98ee43897b45536f8023e217b158e49a4"
+checksum = "cbd1e8d8e6d805f5a39a38ae2c7db3e885ef598fabeea36443f2a35c07f555bc"
 dependencies = [
  "bitflags",
  "unicode-ident",
@@ -1312,21 +1331,22 @@ dependencies = [
 
 [[package]]
 name = "ruff_python_trivia"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "969e4a14b2550818efea99b9e2361c714c72e4f1fb94799251d55aed20345189"
+checksum = "cb21454ef368d9f4f55cc3d42cf262fa61cd4109e3f1c8aeb138d696b74d563d"
 dependencies = [
  "itertools 0.15.0",
  "ruff_source_file",
  "ruff_text_size",
+ "rustc-hash",
  "unicode-ident",
 ]
 
 [[package]]
 name = "ruff_source_file"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c194e02d121e4a1744464ce3a982c4c196eb039bbf67532d18c8ce09f8da6381"
+checksum = "9d7b074f9b29744b641588c521c6943534ca6e7c161b2b1299c01d1cc1b860f3"
 dependencies = [
  "memchr",
  "ruff_text_size",
@@ -1334,9 +1354,9 @@ dependencies = [
 
 [[package]]
 name = "ruff_text_size"
-version = "0.0.3"
+version = "0.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c91652ad39be604bc4d5299a5d19feccdd89e255609d89a031e7bb8e0d0aef9f"
+checksum = "0944e5527042c3e1ef3e79bfed2655fe3ae66433f0112fa38d702e078f549d49"
 dependencies = [
  "get-size2",
 ]
@@ -1666,7 +1686,7 @@ checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
 
 [[package]]
 name = "vbash"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "vsh",
 ]
@@ -1679,14 +1699,14 @@ checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
 
 [[package]]
 name = "vsh"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "vsh-runtime",
 ]
 
 [[package]]
 name = "vsh-commit"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "blake3",
  "cap-fs-ext",
@@ -1699,7 +1719,7 @@ dependencies = [
 
 [[package]]
 name = "vsh-monty"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "get-size2",
  "monty",
@@ -1713,7 +1733,7 @@ dependencies = [
 
 [[package]]
 name = "vsh-monty-worker"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "monty",
  "monty-alloc",
@@ -1728,7 +1748,7 @@ dependencies = [
 
 [[package]]
 name = "vsh-policy"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "vsh-store",
  "vsh-types",
@@ -1737,7 +1757,7 @@ dependencies = [
 
 [[package]]
 name = "vsh-python"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "monty-proto",
  "pyo3",
@@ -1747,7 +1767,7 @@ dependencies = [
 
 [[package]]
 name = "vsh-runtime"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "postcard",
  "vsh-commit",
@@ -1760,7 +1780,7 @@ dependencies = [
 
 [[package]]
 name = "vsh-store"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "blake3",
  "cap-fs-ext",
@@ -1770,14 +1790,14 @@ dependencies = [
 
 [[package]]
 name = "vsh-types"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "blake3",
 ]
 
 [[package]]
 name = "vsh-vfs"
-version = "0.3.1"
+version = "0.5.0"
 dependencies = [
  "vsh-store",
  "vsh-types",
@@ -2195,3 +2215,9 @@ dependencies = [
  "quote",
  "syn 3.0.4",
 ]
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

{vsh_python-0.3.1 → vsh_python-0.5.0}/Cargo.toml

@@ -3,11 +3,12 @@ resolver = "3"
 members = ["crates/vsh-types", "crates/vsh-store", "crates/vsh-vfs", "crates/vsh-policy", "crates/vsh-monty", "crates/vsh-commit", "crates/vbash", "crates/vsh", "crates/vsh-python", "crates/vsh-worker"]
 
 [workspace.package]
-version = "0.3.1"
+version = "0.5.0"
 edition = "2024"
 rust-version = "1.95"
 license = "Apache-2.0"
 authors = ["Mert <62549656+fswair@users.noreply.github.com>"]
+readme = "README.md"
 repository = "https://github.com/fswair/vsh"
 homepage = "https://github.com/fswair/vsh"
 
@@ -15,21 +16,21 @@ homepage = "https://github.com/fswair/vsh"
 blake3 = { version = "=1.8.7", default-features = false, features = ["std"] }
 cap-fs-ext = { version = "=4.0.3", default-features = false, features = ["std"] }
 cap-std = { version = "=4.0.3", default-features = false }
-get-size2 = { version = "=0.10.1", default-features = false }
-monty = { version = "=0.0.21", default-features = false }
-monty-alloc = { version = "=0.0.21", default-features = false, features = ["exit-code"] }
-monty-proto = { version = "=0.0.21", default-features = false }
-monty-types = { version = "=0.0.21", default-features = false }
+get-size2 = { version = "=0.10.3", default-features = false }
+monty = { version = "=0.0.22", default-features = false }
+monty-alloc = { version = "=0.0.22", default-features = false, features = ["exit-code"] }
+monty-proto = { version = "=0.0.22", default-features = false }
+monty-types = { version = "=0.0.22", default-features = false }
 postcard = { version = "=1.1.3", default-features = false, features = ["alloc"] }
 pyo3 = { version = "=0.29.2", default-features = false }
-vsh-monty = { path = "crates/vsh-monty", version = "=0.3.1" }
-vsh-commit = { path = "crates/vsh-commit", version = "=0.3.1" }
-vsh-policy = { path = "crates/vsh-policy", version = "=0.3.1" }
-vsh-types = { path = "crates/vsh-types", version = "=0.3.1" }
-vsh-store = { path = "crates/vsh-store", version = "=0.3.1" }
-vsh-vfs = { path = "crates/vsh-vfs", version = "=0.3.1" }
-vsh-runtime = { path = "crates/vbash", version = "=0.3.1" }
-vsh = { path = "crates/vsh", version = "=0.3.1" }
+vsh-monty = { path = "crates/vsh-monty", version = "=0.5.0" }
+vsh-commit = { path = "crates/vsh-commit", version = "=0.5.0" }
+vsh-policy = { path = "crates/vsh-policy", version = "=0.5.0" }
+vsh-types = { path = "crates/vsh-types", version = "=0.5.0" }
+vsh-store = { path = "crates/vsh-store", version = "=0.5.0" }
+vsh-vfs = { path = "crates/vsh-vfs", version = "=0.5.0" }
+vsh-runtime = { path = "crates/vbash", version = "=0.5.0" }
+vsh = { path = "crates/vsh", version = "=0.5.0" }
 
 [workspace.lints.rust]
 elided_lifetimes_in_paths = "deny"

{vsh_python-0.3.1 → vsh_python-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vsh-python
-Version: 0.3.1
+Version: 0.5.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -11,6 +11,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Rust
 Requires-Dist: basedpyright ; extra == 'dev'
 Requires-Dist: maturin==1.15.0 ; extra == 'dev'
+Requires-Dist: pydantic-ai-slim==2.40.0 ; extra == 'dev'
 Requires-Dist: pytest ; extra == 'dev'
 Requires-Dist: pytest-cov ; extra == 'dev'
 Requires-Dist: ruff ; extra == 'dev'
@@ -18,8 +19,10 @@ Requires-Dist: setuptools==84.0.0 ; extra == 'dev'
 Requires-Dist: ty ; extra == 'dev'
 Requires-Dist: zensical==0.0.57 ; extra == 'dev'
 Requires-Dist: fastmcp==3.4.7 ; extra == 'mcp'
+Requires-Dist: pydantic-ai-slim==2.40.0 ; extra == 'pydantic-ai'
 Provides-Extra: dev
 Provides-Extra: mcp
+Provides-Extra: pydantic-ai
 License-File: LICENSE
 Summary: VSH is a low-latency transactional filesystem simulator backed by Rust.
 Keywords: agents,commands,mcp,simulation,workspaces
@@ -38,6 +41,9 @@ VSH is one low-latency transactional filesystem simulator with two SDK surfaces:
 Both surfaces execute the same Rust pipeline. Python is a thin PyO3 binding; it does
 not contain a fallback simulator or committer.
 
+Special thanks to [Artyom Pavlov](https://github.com/newpavlov) for generously
+donating the `vsh` crate name to this project.
+
 ```text
 Monty program → immutable snapshot → Rust VirtualFs → canonical diff → policy
               → dependency revalidation → recoverable commit → verified receipt
@@ -54,8 +60,9 @@ Install the wheel:
 uv add vsh-python
 ```
 
-Run one complete transaction. `PREVIEW` guarantees that host files are unchanged;
-`AUTO` commits only a deterministic native auto-approval.
+Run one complete transaction. `PREVIEW` does not apply changes to user workspace files;
+the host runtime may still persist bounded transaction/storage artifacts. `AUTO`
+commits only a deterministic native auto-approval.
 
 ```python
 from vsh import ReceiptDetail, RunMode, RunRequest, Runtime
@@ -80,11 +87,39 @@ print(receipt.state, receipt.result, receipt.changes)
 The GIL is released while snapshotting, executing Monty, generating the diff,
 evaluating policy, revalidating dependencies, and committing.
 
+### Pydantic AI
+
+Install the exact-pinned optional integration:
+
+```bash
+uv add "vsh-python[pydantic-ai]"
+```
+
+```python
+from pydantic_ai import Agent
+from vsh.pydantic_ai import VshCapability
+
+capability = VshCapability("/path/to/workspace")
+agent = Agent("openai:gpt-5", capabilities=[capability])
+```
+
+The capability contributes the ten native `vsh_*` filesystem operations plus
+`vsh_run` for atomic multi-step work. Every call executes in a virtual snapshot first.
+Policy-controlled changes commit exactly once or return `pending_approval`; no internal
+LLM judge is created implicitly.
+
+For explicitly configured model review, attach a
+[`CommitJudge`](https://fswair.github.io/vsh/python/commit-judge/) through
+`hook_handler=judge.hook_handler`. It evaluates canonical changes, before/after
+content, effects and intent together. A valid approval can directly commit pending
+work; native hard-deny and stale checks remain enforced. Review returns actionable
+feedback to the main agent.
+
 ## Rust
 
 ```toml
 [dependencies]
-vsh = "=0.3.1"
+vsh = "=0.5.0"
 ```
 
 ```rust,no_run
@@ -108,6 +143,21 @@ Production execution expects the matching `vsh-monty-worker` executable. Python
 wheels bundle it; native embedders configure its trusted path through
 `RuntimeConfig::with_worker_path`.
 
+## Active-snapshot filesystem functions
+
+VSH injects ten bounded `vsh_*` functions into each Monty program: read, write,
+list, make directory, remove, move, copy, glob, literal search and exact text patch.
+They share the same copy-on-write snapshot as `pathlib`, so earlier virtual writes are
+visible to later calls without creating a nested runtime or crossing MCP.
+
+```python
+files = vsh_glob('**/*.toml', path='/workspace/services', max_results=101)
+assert len(files) <= 100, 'split this migration into reviewed batches'
+for path in files:
+    assert vsh_patch(path, 'timeout = 5', 'timeout = 15', count=1) == 1
+{'updated': len(files)}
+```
+
 ## MCP
 
 Install the optional adapter and start the stdio server:
@@ -127,6 +177,14 @@ the same live `Runtime` (or MCP server process). The exact artifact is made dura
 before reservation and commit. Transactions that require independent approval are
 durable immediately and survive a runtime restart.
 
+## Performance
+
+On the dated macOS arm64 release-profile matrix, VSH 0.4.0 lowers median latency by
+roughly 25–30% for 10,000-file discovery/glob and 5,050-entry removal workloads. The
+whole benchmark harness reports about 19% less CPU time. Small-call variance remains,
+and sampled process-tree RSS does not establish a repeatable memory reduction. See the
+[protocol, complete results and caveats](https://fswair.github.io/vsh/performance/).
+
 ## Security and dependency policy
 
 - External Rust crates are exact-pinned in the workspace manifest and lockfile.
@@ -141,19 +199,16 @@ durable immediately and survive a runtime restart.
 - Process-local preview retention is fail-closed and bounded by both artifact count and
   encoded bytes; it cannot become an unbounded parent-process cache.
 
-See [the threat model](docs/rust-rewrite/THREAT_MODEL.md),
-[guarantees](docs/rust-rewrite/GUARANTEES.md), and
-[dependency record](docs/rust-rewrite/DEPENDENCY_POLICY.md). Upgrade and benchmark
-details are in the [migration guide](docs/rust-rewrite/MIGRATION.md) and
-[performance record](docs/rust-rewrite/PERFORMANCE.md). Merge coverage scope and floors
-are recorded in the [coverage contract](docs/rust-rewrite/COVERAGE.md). The cross-platform build,
-validation, provenance, and dual-registry order are in the
-[release guide](docs/rust-rewrite/RELEASE.md).
+See the [threat model](https://fswair.github.io/vsh/threat-model/),
+[guarantees](https://fswair.github.io/vsh/guarantees/),
+[dependency policy](https://fswair.github.io/vsh/dependency-policy/), current
+[performance report](https://fswair.github.io/vsh/performance/), and
+[coverage contract](https://fswair.github.io/vsh/coverage/).
 
-## Compatibility handles
+## Package names
 
-Existing declarations may continue to install `vbash==0.3.1` from PyPI or depend on
-`vbash = "=0.3.1"` from crates.io. Both packages are implementation-free mirrors of
+Existing declarations may install `vbash==0.5.0` from PyPI or depend on
+`vbash = "=0.5.0"` from crates.io. Both names are implementation-free mirrors of
 the exact matching VSH release. New projects should use `vsh-python` and `vsh`
 directly; Python code continues to write `import vsh` either way.
 
@@ -168,8 +223,8 @@ uv run zensical serve
 uv run zensical build --clean --strict
 ```
 
-Start at [`docs/index.md`](docs/index.md). The site includes a VSH-specific dark-red
-design, automatic light/dark palette selection, and a **Copy as Markdown** action on
+Start at the [VSH documentation](https://fswair.github.io/vsh/). The site includes a
+Venus-inspired palette, automatic light/dark selection, and a **Copy as Markdown** action on
 every page. It also publishes a compact LLM index at `/llms.txt` and the complete
 Markdown source corpus at `/llms-full.txt`, with navigation pages first; CI verifies
 both generated files are current.