vis-agent 0.2.52.dev7755__tar.gz → 0.2.52.dev7781__tar.gz

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vis-agent
-Version: 0.2.52.dev7755
+Version: 0.2.52.dev7781
 Summary: The Vis Python SDK — author extensions and control local or remote engines.
 Project-URL: Homepage, https://vis.blockether.com
 Project-URL: Documentation, https://vis.blockether.com

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/contracts/schema/agents.json

@@ -38,16 +38,13 @@
           "maxItems": 64,
           "uniqueItems": true
         },
+        "files": {
+          "$ref": "#/$defs/files"
+        },
         "key": {
           "type": "string",
           "minLength": 1,
           "maxLength": 256
-        },
-        "context": {
-          "enum": [
-            "full",
-            "task"
-          ]
         }
       },
       "required": [
@@ -119,6 +116,43 @@
       ],
       "additionalProperties": false
     },
+    "grant": {
+      "$comment": "Add file rules to the grant of a subagent. A child without write rules writes only the granted rules after a write grant.",
+      "type": "object",
+      "properties": {
+        "session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "files": {
+          "$ref": "#/$defs/files"
+        }
+      },
+      "required": [
+        "session_id",
+        "files"
+      ],
+      "additionalProperties": false
+    },
+    "ask_files": {
+      "type": "object",
+      "properties": {
+        "files": {
+          "$ref": "#/$defs/files"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000,
+          "pattern": "\\S"
+        }
+      },
+      "required": [
+        "files",
+        "reason"
+      ],
+      "additionalProperties": false
+    },
     "resume": {
       "type": "object",
       "properties": {
@@ -176,6 +210,35 @@
       ],
       "additionalProperties": false
     },
+    "files": {
+      "$comment": "A subagent file grant. Each rule is a path or a glob, absolute, ~ or relative to the parent's workspace root. Rules also cover files that do not exist yet.",
+      "type": "object",
+      "properties": {
+        "write": {
+          "$ref": "#/$defs/file_rules"
+        },
+        "read_only": {
+          "$ref": "#/$defs/file_rules"
+        },
+        "deny": {
+          "$ref": "#/$defs/file_rules"
+        }
+      },
+      "minProperties": 1,
+      "additionalProperties": false
+    },
+    "file_rules": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 4096,
+        "pattern": "\\S"
+      },
+      "minItems": 1,
+      "maxItems": 64,
+      "uniqueItems": true
+    },
     "agent": {
       "type": "object",
       "properties": {
@@ -209,11 +272,6 @@
             "budget_limited"
           ]
         },
-        "depth": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 2
-        },
         "iteration_budget": {
           "$ref": "#/$defs/spawn/properties/iteration_budget"
         },
@@ -248,6 +306,9 @@
             "object",
             "null"
           ]
+        },
+        "files": {
+          "$ref": "#/$defs/files"
         }
       },
       "required": [
@@ -257,7 +318,6 @@
         "team_id",
         "task",
         "status",
-        "depth",
         "iteration_budget",
         "iterations_used"
       ],

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/contracts/schema/gateway.json

@@ -2370,6 +2370,9 @@
         {
           "const": "context.updated"
         },
+        {
+          "const": "extensions.reloaded"
+        },
         {
           "const": "iteration.completed",
           "x-vis-turn-stream": true
@@ -2979,13 +2982,18 @@
       "required": [
         "loaded",
         "failed",
-        "scopes"
+        "scopes",
+        "reload_id"
       ],
       "properties": {
         "loaded": {
           "type": "integer",
           "minimum": 0
         },
+        "reload_id": {
+          "type": "string",
+          "minLength": 1
+        },
         "failed": {
           "type": "integer",
           "minimum": 0

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vis-agent"
-version = "0.2.52.dev7755"
+version = "0.2.52.dev7781"
 description = "The Vis Python SDK — author extensions and control local or remote engines."
 readme = "README.md"
 requires-python = ">=3.12"

vis_agent-0.2.52.dev7781/release-tag

@@ -0,0 +1 @@
+beta-b6ab13874bc1a3f1b91af75e89436713cc1db147

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/src/blockether/vis/engine/_agents.py

@@ -16,7 +16,6 @@ class Subagent:
     team_id: str
     task: str
     status: str
-    depth: int
     iteration_budget: int
     iterations_used: int
     provider: str | None = None
@@ -24,6 +23,7 @@ class Subagent:
     routing_locked: bool = False
     pending_input: bool = False
     usage: dict[str, Any] | None = None
+    files: dict[str, list[str]] | None = None
 
     @classmethod
     def from_wire(cls, value: dict[str, Any]) -> Subagent:

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/src/blockether/vis/engine/_council.py

@@ -235,6 +235,7 @@ class Council:
         model: str | None = None,
         iteration_budget: int | None = None,
         allowed_models: list[dict[str, str]] | None = None,
+        files: dict[str, list[str]] | None = None,
         key: str | None = None,
     ) -> Subagent:
         """Create a subagent and publish its delegated task through Council.
@@ -244,7 +245,8 @@ class Council:
         share the checkout, inherit authorization and use their own bounded model
         iterations. A key makes retries idempotent within the parent turn, and reusing
         it with different input is rejected. This is not an ordinary independent fork,
-        and it does not grant broader permissions.
+        and it does not grant broader permissions. ``files`` narrows file access with
+        ``write``, ``read_only`` and ``deny`` rules: paths or globs, also for future files.
         """
         body = {"task": task}
         body.update(
@@ -255,6 +257,7 @@ class Council:
                     "iteration_budget": iteration_budget,
                     "model": model,
                     "allowed_models": allowed_models,
+                    "files": files,
                     "key": key,
                 }.items()
                 if value is not None

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/tests/test_agents.py

@@ -13,7 +13,6 @@ CHILD = {
     "team_id": "task",
     "task": "Check the contract",
     "status": "running",
-    "depth": 1,
     "iteration_budget": 4,
     "iterations_used": 1,
     "provider": "p",
@@ -63,6 +62,7 @@ def test_managed_team_transport():
             model="small",
             iteration_budget=4,
             allowed_models=[{"provider": "p", "model": "small"}],
+            files={"write": ["src/owner/**"]},
             key="contract",
         )
         assert isinstance(child, Subagent)
@@ -86,6 +86,7 @@ def test_managed_team_transport():
                     "provider": "p",
                     "model": "small",
                     "allowed_models": [{"provider": "p", "model": "small"}],
+                    "files": {"write": ["src/owner/**"]},
                     "key": "contract",
                 },
             ),
@@ -167,6 +168,9 @@ def test_group_members_are_not_the_managed_team():
         {"task": "x", "iteration_budget": 601},
         {"task": "x", "model": "small"},
         {"task": "x", "allowed_models": []},
+        {"task": "x", "files": {}},
+        {"task": "x", "files": {"exec": ["a"]}},
+        {"task": "x", "files": {"write": []}},
     ],
 )
 def test_spawn_rejects_invalid_input_before_http(opts):
@@ -293,7 +297,6 @@ def test_all_lifecycle_states_and_optional_response_defaults(status):
             "leader_id",
             "team_id",
             "task",
-            "depth",
             "iteration_budget",
             "iterations_used",
         )

{vis_agent-0.2.52.dev7755 → vis_agent-0.2.52.dev7781}/tests/test_client.py

@@ -634,7 +634,6 @@ def test_dedicated_methods_cover_every_public_nonstreaming_operation():
         "team_id": "task",
         "task": "Check the contract",
         "status": "running",
-        "depth": 1,
         "iteration_budget": 4,
         "iterations_used": 1,
         "provider": "fixture",

vis_agent-0.2.52.dev7755/release-tag

@@ -1 +0,0 @@
-beta-030ba6505ce00caad546fbff1bfdfe01b71c641d