vis-agent 0.2.30__tar.gz → 0.2.32.dev7313__tar.gz

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vis-agent
-Version: 0.2.30
+Version: 0.2.32.dev7313
 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.30 → vis_agent-0.2.32.dev7313}/contracts/schema/gateway.json

@@ -896,6 +896,16 @@
       },
       "path": "/v1/sessions/:sid/model"
     },
+    {
+      "audience": "sdk",
+      "operations": {
+        "post": {
+          "request": "none",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/queue/send-now"
+    },
     {
       "audience": "sdk",
       "operations": {
@@ -2331,6 +2341,10 @@
           "const": "turn.failed",
           "x-vis-turn-terminal": true
         },
+        {
+          "const": "turn.input",
+          "x-vis-turn-stream": true
+        },
         {
           "const": "turn.progress",
           "x-vis-turn-stream": true
@@ -2347,6 +2361,10 @@
           "const": "turn.queued.drained",
           "x-vis-queue-mirror": true
         },
+        {
+          "const": "turn.queued.sent",
+          "x-vis-queue-mirror": true
+        },
         {
           "const": "turn.queued.updated",
           "x-vis-queue-mirror": true

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/pyproject.toml

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

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/src/blockether/vis/_contracts.py

@@ -20,7 +20,6 @@ _SCHEMA_NAMES = (
     "diff",
     "gateway",
     "improve",
-    "plans",
     "provider",
     "rooms",
     "symbol",

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/src/blockether/vis/engine/_client.py

@@ -1621,6 +1621,19 @@ class ExecutionLayer(ABC):
         )
         return response.json()
 
+    def post_session_queue_send_now(
+        self, sid: str, *, query: Query | None = None, timeout: float | None = None
+    ) -> JSONValue:
+        """POST /v1/sessions/:sid/queue/send-now — json response."""
+        response = self._request(
+            "POST",
+            "/v1/sessions/:sid/queue/send-now",
+            path={"sid": sid},
+            query=query,
+            timeout=timeout,
+        )
+        return response.json()
+
     def put_session_read(
         self,
         sid: str,

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/src/blockether/vis/extension_package.py

@@ -55,6 +55,22 @@ def _relative(value):
     return value
 
 
+def _skill(entry):
+    """Normalize a skills entry: a directory, or a table with path and settings."""
+    if isinstance(entry, str):
+        return {"path": _relative(entry), "settings": True}
+    if (
+        not isinstance(entry, dict)
+        or "path" not in entry
+        or set(entry) - {"path", "settings"}
+    ):
+        raise ValueError("A skills table needs path and accepts only path and settings")
+    settings = entry.get("settings", True)
+    if not isinstance(settings, bool):
+        raise ValueError("skills settings must be true or false")
+    return {"path": _relative(entry["path"]), "settings": settings}
+
+
 def project_subdirectory(value=""):
     """An empty value or dot selects the repository root. Otherwise, use a portable path."""
     return "" if value in ("", ".") else _relative(value)
@@ -131,7 +147,8 @@ def manifest_metadata(text, vis_version=None, python_version=None):
 
     Returns:
         A metadata dictionary containing normalized name and version, description,
-        category, Python requirement, dependencies, source paths and skill paths.
+        category, Python requirement, dependencies, source paths and skills. Each skill
+        is a `path` and a `settings` flag; False keeps the skill out of settings.
 
     Raises:
         ValueError: Required metadata, dependency constraints or portable paths
@@ -182,8 +199,8 @@ def manifest_metadata(text, vis_version=None, python_version=None):
         skills = vis.get("skills", [])
         if not isinstance(skills, list) or len(skills) > 64:
             raise ValueError("skills must be a list of at most 64 skill directories")
-        skills = [_relative(p) for p in skills]
-        if len(set(skills)) != len(skills):
+        skills = [_skill(entry) for entry in skills]
+        if len({skill["path"] for skill in skills}) != len(skills):
             raise ValueError("skills must not repeat a directory")
         return {
             "name": canonicalize_name(name),
@@ -233,7 +250,7 @@ def inspect_source(directory, vis_version=None, python_version=None):
         resolved = (directory / path).resolve(strict=True)
         if not resolved.is_relative_to(directory) or not resolved.is_dir():
             raise ValueError("source_paths must be directories inside the project")
-    for path in metadata["skills"]:
+    for path in (entry["path"] for entry in metadata["skills"]):
         skill = directory / path
         if not skill.is_dir() or not (skill / "SKILL.md").is_file():
             raise ValueError(

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/tests/test_authoring.py

@@ -38,7 +38,7 @@ def test_example_manifest_registration_and_domain_behavior(monkeypatch):
     )
     metadata = extension_package.inspect_source(EXAMPLE)
     assert metadata["name"] == "vis-greeter"
-    assert metadata["skills"] == ["skills/greeting"]
+    assert metadata["skills"] == [{"path": "skills/greeting", "settings": True}]
     assert vis._registration["spec"] is None
     runpy.run_path(str(EXAMPLE / "extension.py"))
     declaration = vis._registration["spec"]

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/tests/test_contracts.py

@@ -55,10 +55,10 @@ def test_gateway_routes_and_lease_policy_are_shared():
     lease = gateway["x-vis-client-lease"]
     assert 0 < lease["touch_ms"] < lease["keepalive_ms"] < lease["ttl_ms"]
     assert 0 < lease["keepalive_timeout_ms"] < lease["keepalive_ms"]
-    assert len(routes) == 154
-    assert len(operations) == 193
+    assert len(routes) == 155
+    assert len(operations) == 194
     assert Counter(operation["request"] for operation in operations) == {
-        "none": 124,
+        "none": 125,
         "json": 64,
         "binary": 5,
     }

{vis_agent-0.2.30 → vis_agent-0.2.32.dev7313}/tests/test_extension_package.py

@@ -331,8 +331,18 @@ def test_remote_failure_and_invalid_revision_leave_no_installation(
         package.install(REPOSITORY, target, trust=True, revision="--upload-pack=bad")
 
 
-@pytest.mark.parametrize("skills", ['["skills/greeting"]', "[]"])
-def test_manifest_declares_skills_without_executing_code(tmp_path, skills):
+@pytest.mark.parametrize(
+    ("skills", "expected"),
+    [
+        ('["skills/greeting"]', [{"path": "skills/greeting", "settings": True}]),
+        (
+            '[{ path = "skills/greeting", settings = false }]',
+            [{"path": "skills/greeting", "settings": False}],
+        ),
+        ("[]", []),
+    ],
+)
+def test_manifest_declares_skills_without_executing_code(tmp_path, skills, expected):
     source = project(tmp_path / "source", MANIFEST + f"skills = {skills}\n")
     skill = source / "skills/greeting"
     skill.mkdir(parents=True)
@@ -340,7 +350,7 @@ def test_manifest_declares_skills_without_executing_code(tmp_path, skills):
         "---\nname: greeting\ndescription: Greet a person.\n---\nRead the tool contract."
     )
     metadata = package.inspect_source(source)
-    assert metadata["skills"] == (["skills/greeting"] if skills != "[]" else [])
+    assert metadata["skills"] == expected
 
 
 @pytest.mark.parametrize(
@@ -350,6 +360,10 @@ def test_manifest_declares_skills_without_executing_code(tmp_path, skills):
         '["../outside"]',
         '["skills/a", "skills/a"]',
         '["/absolute"]',
+        "[{ settings = false }]",
+        '[{ path = "skills/a", settings = "no" }]',
+        '[{ path = "skills/a", hidden = true }]',
+        '["skills/a", { path = "skills/a" }]',
     ],
 )
 def test_invalid_skill_declarations_are_rejected(skills):

vis_agent-0.2.30/contracts/fixtures/plans.json

@@ -1,117 +0,0 @@
-{
-  "documents": [
-    {
-      "filename": "PLAN-search.md",
-      "text": "# Search\n\n**Feature:** search\n**Status:** ready\n\n## Spec\nFind sessions.\n",
-      "expected": {
-        "kind": "plan",
-        "feature": "search",
-        "status": "ready"
-      },
-      "actions": [
-        "approve"
-      ]
-    },
-    {
-      "filename": "PLAN-search.md",
-      "text": "# Search\n**Feature:** search\n**Status:** accepted\n",
-      "expected": {
-        "kind": "plan",
-        "feature": "search",
-        "status": "accepted"
-      },
-      "actions": [
-        "approve"
-      ]
-    },
-    {
-      "filename": "IMPLEMENTATION-search.md",
-      "text": "# Search\n**Feature:** search\n**Status:** implementing\n",
-      "expected": {
-        "kind": "implementation",
-        "feature": "search",
-        "status": "implementing"
-      },
-      "actions": []
-    },
-    {
-      "filename": "PLAN-search.md",
-      "text": "# Search\n**Feature:** search\n**Status:** in-review\n",
-      "expected": {
-        "kind": "plan",
-        "feature": "search",
-        "status": "in-review"
-      },
-      "actions": []
-    },
-    {
-      "filename": "notes.md",
-      "text": "# Search\n**Feature:** search\n**Status:** ready\n",
-      "expected": null,
-      "actions": []
-    },
-    {
-      "filename": "PLAN-search.md",
-      "text": "# Search\n**Feature:** other\n**Status:** ready\n",
-      "expected": null,
-      "actions": []
-    },
-    {
-      "filename": "PLAN-search.md",
-      "text": "# Search\n**Feature:** search\n**Status:** ready\n**Status:** accepted\n",
-      "expected": null,
-      "actions": []
-    },
-    {
-      "filename": "PLAN-search.md",
-      "text": "# Search\n## Spec\n**Feature:** search\n**Status:** ready\n",
-      "expected": null,
-      "actions": []
-    }
-  ],
-  "annotations": [
-    {
-      "body": "# Plan\n\n## Resolved comments\n\n- **Whole document** — Earlier remark\n  - Resolved in v2: Kept.",
-      "comments": [
-        {
-          "quote": "",
-          "body": "Keep the review separate."
-        },
-        {
-          "quote": "A “passage”\n here",
-          "body": "A\n decision."
-        }
-      ],
-      "rendered": "# Plan\n\n## Resolved comments\n\n- **Whole document** — Earlier remark\n  - Resolved in v2: Kept.\n\n## Comments\n\n- **Whole document** — Keep the review separate.\n- **“A \"passage\" here”** — A decision.\n"
-    },
-    {
-      "body": "# Plan\n\n",
-      "comments": [
-        {
-          "quote": "x",
-          "body": "   "
-        }
-      ],
-      "rendered": "# Plan\n"
-    },
-    {
-      "body": "# Plan",
-      "comments": [],
-      "rendered": "# Plan\n"
-    }
-  ],
-  "unrecognized": [
-    "# Plan\n\n## Comments\n\nOrdinary prose.\n",
-    "# Plan\n\n## Resolved comments\n\nDecisions.\n"
-  ],
-  "quotes": [
-    {
-      "input": "  A “quote”\n with spaces  ",
-      "expected": "A \"quote\" with spaces"
-    },
-    {
-      "input": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-      "expected": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa…aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
-    }
-  ]
-}

vis_agent-0.2.30/contracts/schema/plans.json

@@ -1,79 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://contract.blockether.com/vis/schema/plans.json",
-  "$ref": "#/$defs/document",
-  "$defs": {
-    "filename": {
-      "type": "string",
-      "pattern": "^(PLAN|IMPLEMENTATION)-([a-z0-9]+(?:-[a-z0-9]+)*)\\.md$"
-    },
-    "status": {
-      "type": "string",
-      "enum": [
-        "draft",
-        "in-review",
-        "ready",
-        "accepted",
-        "implementing",
-        "done"
-      ]
-    },
-    "document": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "kind",
-        "feature",
-        "status"
-      ],
-      "properties": {
-        "kind": {
-          "enum": [
-            "plan",
-            "implementation"
-          ]
-        },
-        "feature": {
-          "type": "string",
-          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
-        },
-        "status": {
-          "$ref": "#/$defs/status"
-        }
-      }
-    },
-    "action": {
-      "oneOf": [
-        {
-          "const": "revise",
-          "x-vis-request": "Revise this document, resolve every human comment and attach the next version under the same filename. Do not implement or change project files."
-        },
-        {
-          "const": "approve",
-          "x-vis-request": "I approve this specification and its implementation plan. Start implementation now. Check that this is the latest version, its status is ready or accepted, and no questions or comments remain before editing. If not, stop and explain what needs review. Otherwise start implementation of this exact reviewed scope, keep the versioned implementation record current and follow existing verification and permission rules."
-        }
-      ]
-    },
-    "action_request": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "filename",
-        "version",
-        "action"
-      ],
-      "properties": {
-        "filename": {
-          "$ref": "#/$defs/filename"
-        },
-        "version": {
-          "type": "integer",
-          "minimum": 1
-        },
-        "action": {
-          "$ref": "#/$defs/action"
-        }
-      }
-    }
-  }
-}