vis-agent 0.2.2__tar.gz → 0.2.4__tar.gz

vis_agent-0.2.4/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.5
+Name: vis-agent
+Version: 0.2.4
+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
+Project-URL: Source, https://github.com/Blockether/vis
+Project-URL: Issues, https://github.com/Blockether/vis/issues
+Author: Blockether
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: agent,automation,extension,human-in-the-loop,vis
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: jsonschema<5,>=4.23
+Requires-Dist: packaging>=24
+Provides-Extra: docs
+Requires-Dist: pdoc==16.0.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# vis-agent
+
+Python SDK for Vis extensions and agent sessions.
+
+```sh
+pip install vis-agent
+```
+
+Requires Python 3.11+. Install the Vis executable and configure a provider
+separately for local use.
+
+- [Python SDK guide](https://vis.blockether.com/python-sdk.html) — run a local
+  agent, continue a conversation or connect to a shared gateway. `Agent` is
+  available in SDK `0.2.3` and newer.
+- [Python API reference](https://vis.blockether.com/python-sdk-api/) — browse
+  classes, methods, signatures and types generated from the SDK source.
+- [Extension guide](https://vis.blockether.com/extending.html) — add tools to Vis.
+- [Documentation](https://vis.blockether.com) — browse all guides and reference pages.
+
+The online API reference follows `main`, so it can include unreleased APIs that
+are not yet available in the latest PyPI package. The SDK guide marks those APIs.
+
+## Generate the API reference locally
+
+From `packages/vis-agent` in a Vis checkout, create a virtual environment and
+install the documentation dependencies:
+
+```sh
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e '.[docs]'
+python -m pdoc blockether.vis '!blockether\.vis\._' \
+  --docformat google --no-show-source -o ../../target/python-sdk-api
+```
+
+Open `../../target/python-sdk-api/index.html` in your browser. [pdoc](https://pdoc.dev/)
+generates the reference from public Python symbols, type annotations and
+docstrings; you do not need to start Vis or configure a model provider. The docs
+workflow regenerates and publishes it when SDK changes reach `main`.

vis_agent-0.2.4/README.md

@@ -0,0 +1,39 @@
+# vis-agent
+
+Python SDK for Vis extensions and agent sessions.
+
+```sh
+pip install vis-agent
+```
+
+Requires Python 3.11+. Install the Vis executable and configure a provider
+separately for local use.
+
+- [Python SDK guide](https://vis.blockether.com/python-sdk.html) — run a local
+  agent, continue a conversation or connect to a shared gateway. `Agent` is
+  available in SDK `0.2.3` and newer.
+- [Python API reference](https://vis.blockether.com/python-sdk-api/) — browse
+  classes, methods, signatures and types generated from the SDK source.
+- [Extension guide](https://vis.blockether.com/extending.html) — add tools to Vis.
+- [Documentation](https://vis.blockether.com) — browse all guides and reference pages.
+
+The online API reference follows `main`, so it can include unreleased APIs that
+are not yet available in the latest PyPI package. The SDK guide marks those APIs.
+
+## Generate the API reference locally
+
+From `packages/vis-agent` in a Vis checkout, create a virtual environment and
+install the documentation dependencies:
+
+```sh
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e '.[docs]'
+python -m pdoc blockether.vis '!blockether\.vis\._' \
+  --docformat google --no-show-source -o ../../target/python-sdk-api
+```
+
+Open `../../target/python-sdk-api/index.html` in your browser. [pdoc](https://pdoc.dev/)
+generates the reference from public Python symbols, type annotations and
+docstrings; you do not need to start Vis or configure a model provider. The docs
+workflow regenerates and publishes it when SDK changes reach `main`.

{vis_agent-0.2.2 → vis_agent-0.2.4}/contracts/activity.json

@@ -46,7 +46,7 @@
     "lifecycle": "The engine allocates invocation identity and entry sequence, records running before execution, and exactly one succeeded, failed or cancelled result. Presentation cannot control the operation.",
     "counts": "Counts describe observed invocations, including omitted rows. Group rows are presentation, not additional invocations. omitted.by_classification counts omitted evidence by signal. Readers form one group per exact operation across an Activity block, not just adjacent runs. operation_groups supplies known labels; unknown operations use their exact names. Groups follow first-entry order and members retain sequence order; grouping is not a global chronology. A group keeps its first row identity (the first child for an engine shell group). Labels, presenters, presentations and states never determine membership. Shell polling children remain evidence of one command, not more commands.",
     "arguments": "Within each operation group, readers may collapse rows with the same argument_key and show ×N. The engine supplies this optional opaque 64-character lowercase hexadecimal equality key for complete portable arguments within a block, salted per block. Map order is irrelevant; sequence order and value types are significant. Oversized or unsupported arguments have no key and stay separate. Never infer equality from redacted or truncated display text. Keep first-invocation disclosure identity, all outcomes and child evidence; counts still describe actual invocations. A shell group inherits its launch key, never a poll key.",
-    "bounds": "Redact credential-bearing structured fields before summarizing; enforce admission limits per event and presentation. Retain all admitted invocations and details durably without a total count or byte cap. Limit each history-bearing response to max_page_rows invocations and max_page_bytes, never shedding details. Row ids are globally unique within a projection. Legacy omitted counts describe already-lost historical records, never records still available through paging.",
-    "declaration": "Symbols publish human-facing presentations: understandable sentence-case English headlines, a one-line summary, content blocks and optional sections of the same headline/summary/content shape. Headline and summary remain visible when collapsed; only content is disclosed. Declare show_start=false for quick operations that need only an end result; the default true shows running progress. Internal start/end events still preserve ordering, timing, failures and cancellation. End-only content stays hidden until settlement. Up to 8 sections, 32 blocks in total and 32 KiB per replacement; each headline and summary is at most 512 UTF-8 bytes. Content includes headings, Markdown, tables, code, diffs, attachment references and progress. The engine alone owns identity, timing and outcome; presentation failures never alter tool results."
+    "bounds": "Redact credential-bearing structured fields before summarizing. Retain complete valid presentation content and all admitted invocations durably without a total count or byte cap. History-bearing responses contain at most max_page_rows invocations and target max_page_bytes; one indivisible invocation may exceed the byte target and is never discarded. Row ids are globally unique within a projection. Legacy omitted counts describe already-lost historical records, never records still available through paging.",
+    "declaration": "Symbols publish human-facing presentations: understandable sentence-case English headlines, a one-line summary, content blocks and optional sections of the same headline/summary/content shape. Headline and summary remain visible when collapsed; only content is disclosed. Declare show_start=false for quick operations that need only an end result; the default true shows running progress. Internal start/end events still preserve ordering, timing, failures and cancellation. End-only content stays hidden until settlement. Content and non-nested sections are retained in full without block-count or byte ceilings; each headline and summary is at most 512 UTF-8 bytes. Content includes headings, Markdown, tables, code, diffs, attachment references and progress. The engine alone owns identity, timing and outcome; presentation failures never alter tool results."
   }
 }

vis_agent-0.2.4/contracts/agents.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "limits": {
+    "depth": 2,
+    "team_children": 32,
+    "active_children": 8,
+    "default_iterations": 32,
+    "max_iterations": 200,
+    "task_chars": 8192
+  }
+}

vis_agent-0.2.4/contracts/diff.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "media_type": "application/vnd.vis.diff+json",
+  "revision_request": "Review every comment on this exact diff version. Check that it is still the latest version before acting. Apply requested fixes only within the already authorized implementation scope, run affected checks and attach the updated diff and implementation record. Do not treat this review as approval of new scope or permission to commit, push or deploy."
+}

{vis_agent-0.2.2 → vis_agent-0.2.4}/contracts/fixtures/activity-cases.json

@@ -1803,8 +1803,8 @@
     }
   },
   {
-    "name": "sections-share-block-bound",
-    "valid": false,
+    "name": "sections-retain-all-blocks",
+    "valid": true,
     "projection": {
       "state": "running",
       "counts": {

vis_agent-0.2.4/contracts/fixtures/diff.json

@@ -0,0 +1,16 @@
+{
+  "schema_version": 1,
+  "patch": "diff --git a/search.clj b/search.clj\n--- a/search.clj\n+++ b/search.clj\n@@ -1 +1 @@\n-(search title)\n+(search title {:archived true})\n",
+  "source": {
+    "type": "draft",
+    "backend": "worktree",
+    "label": "session-search",
+    "base_revision": "0123456789abcdef"
+  },
+  "comments": [
+    {
+      "quote": "+(search title {:archived true})",
+      "body": "Keep archived sessions optional."
+    }
+  ]
+}

{vis_agent-0.2.2 → vis_agent-0.2.4}/contracts/fixtures/live-primitives.json

@@ -6,6 +6,10 @@
   ],
   "id": "live-primitives",
   "nodes": [
+    {
+      "id": "section-break",
+      "type": "divider"
+    },
     {
       "id": "h1",
       "type": "heading",

vis_agent-0.2.4/contracts/fixtures/plans.json

@@ -0,0 +1,117 @@
+{
+  "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.2 → vis_agent-0.2.4}/contracts/gateway.json

@@ -30,6 +30,50 @@
     "semantics": "Authenticated requests carrying client_id refresh an existing lease; idle connected clients send a bounded GET keepalive. Failure invalidates the client until it is closed and connected anew. Closing releases only its lease, never the gateway or sessions."
   },
   "routes": [
+    {
+      "audience": "sdk",
+      "operations": {
+        "put": {
+          "request": "json",
+          "response": "json"
+        },
+        "delete": {
+          "request": "none",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/client-extensions"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "get": {
+          "request": "none",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/client-calls"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "post": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/client-calls/:call_id/result"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "post": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/client-calls/:call_id/activity"
+    },
     {
       "audience": "public",
       "operations": {
@@ -644,6 +688,40 @@
       },
       "path": "/v1/sessions/:sid/council"
     },
+    {
+      "audience": "sdk",
+      "operations": {
+        "get": {
+          "request": "none",
+          "response": "json"
+        },
+        "post": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/agents"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "post": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/agents/cancel"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "post": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/sessions/:sid/agents/route"
+    },
     {
       "audience": "sdk",
       "operations": {
@@ -1096,6 +1174,58 @@
       },
       "path": "/v1/sessions/actions/search"
     },
+    {
+      "audience": "sdk",
+      "operations": {
+        "get": {
+          "request": "none",
+          "response": "json"
+        },
+        "post": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/improve"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "get": {
+          "request": "none",
+          "response": "json"
+        },
+        "patch": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/improve/settings"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "post": {
+          "request": "none",
+          "response": "json"
+        }
+      },
+      "path": "/v1/improve/review"
+    },
+    {
+      "audience": "sdk",
+      "operations": {
+        "get": {
+          "request": "none",
+          "response": "json"
+        },
+        "patch": {
+          "request": "json",
+          "response": "json"
+        }
+      },
+      "path": "/v1/improve/:id"
+    },
     {
       "audience": "sdk",
       "operations": {

vis_agent-0.2.4/contracts/improve.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "statuses": [
+    "open",
+    "closed"
+  ],
+  "max_page_size": 200,
+  "analysis_format": "markdown",
+  "source_policy": "Council content and provenance are immutable; workflow content is separate editable analysis.",
+  "hierarchy_policy": "Parents and descendants share a project. Closing closes all descendants atomically. Reopening opens ancestors. Project moves include descendants.",
+  "review_policy": "Automatic reviews require every touched record version and a still-current settings gate in the write transaction. They do not authorize code execution or remediation."
+}

vis_agent-0.2.4/contracts/plans.json

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "filename_pattern": "^(PLAN|IMPLEMENTATION)-([a-z0-9]+(?:-[a-z0-9]+)*)\\.md$",
+  "statuses": [
+    "draft",
+    "in-review",
+    "ready",
+    "accepted",
+    "implementing",
+    "done"
+  ],
+  "actions": {
+    "revise": "Revise this document, resolve every human comment and attach the next version under the same filename. Do not implement or change project files.",
+    "approve": "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."
+  }
+}

{vis_agent-0.2.2 → vis_agent-0.2.4}/contracts/schema/activity.json

@@ -679,7 +679,6 @@
     },
     "content": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "oneOf": [
           {
@@ -690,8 +689,7 @@
                 "const": "heading"
               },
               "text": {
-                "type": "string",
-                "maxLength": 16384
+                "type": "string"
               }
             },
             "required": [
@@ -707,8 +705,7 @@
                 "const": "text"
               },
               "text": {
-                "type": "string",
-                "maxLength": 16384
+                "type": "string"
               }
             },
             "required": [
@@ -724,8 +721,7 @@
                 "const": "markdown"
               },
               "text": {
-                "type": "string",
-                "maxLength": 16384
+                "type": "string"
               }
             },
             "required": [
@@ -741,8 +737,7 @@
                 "const": "code"
               },
               "text": {
-                "type": "string",
-                "maxLength": 16384
+                "type": "string"
               },
               "language": {
                 "type": "string",
@@ -762,8 +757,7 @@
                 "const": "diff"
               },
               "text": {
-                "type": "string",
-                "maxLength": 16384
+                "type": "string"
               },
               "language": {
                 "type": "string",
@@ -785,21 +779,16 @@
               "columns": {
                 "type": "array",
                 "minItems": 1,
-                "maxItems": 16,
                 "items": {
-                  "type": "string",
-                  "maxLength": 256
+                  "type": "string"
                 }
               },
               "rows": {
                 "type": "array",
-                "maxItems": 200,
                 "items": {
                   "type": "array",
-                  "maxItems": 16,
                   "items": {
-                    "type": "string",
-                    "maxLength": 256
+                    "type": "string"
                   }
                 }
               }
@@ -983,7 +972,6 @@
         },
         "sections": {
           "type": "array",
-          "maxItems": 8,
           "items": {
             "$ref": "#/$defs/section"
           }