vis-agent 0.3.3.dev7975__tar.gz → 0.3.4__tar.gz

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/.gitignore

@@ -117,3 +117,6 @@ own_your_harness.pptx
 # Call journal written by the e2e schema-probe fixture when it runs from this
 # checkout instead of a temporary workspace.
 /schema-calls.jsonl
+
+# uv lockfiles. The SDK and the examples are libraries; uv writes the lock locally.
+uv.lock

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vis-agent
-Version: 0.3.3.dev7975
+Version: 0.3.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

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/contracts/fixtures/live-primitives.json

@@ -62,7 +62,7 @@
       "id": "spinners",
       "type": "group",
       "direction": "row",
-      "fields": [
+      "children": [
         {
           "id": "braille",
           "type": "spinner",
@@ -97,7 +97,7 @@
       "id": "actions",
       "type": "group",
       "direction": "row",
-      "fields": [
+      "children": [
         {
           "id": "refresh",
           "type": "button",
@@ -111,6 +111,136 @@
           "label": "Unavailable action",
           "is_disabled": true,
           "clicks": 0
+        },
+        {
+          "id": "target",
+          "name": "target",
+          "type": "plaintext",
+          "label": "Target",
+          "is_required": false,
+          "is_secret": false,
+          "value": "db-2"
+        },
+        {
+          "id": "token",
+          "name": "token",
+          "type": "password",
+          "label": "Token",
+          "is_required": false,
+          "is_secret": true
+        },
+        {
+          "id": "notes",
+          "name": "notes",
+          "type": "multiline",
+          "label": "Notes",
+          "is_required": false,
+          "is_secret": false,
+          "value": "Ship after the checks pass."
+        },
+        {
+          "id": "region",
+          "name": "region",
+          "type": "select",
+          "label": "Region",
+          "is_required": false,
+          "is_secret": false,
+          "options": [
+            {
+              "value": "eu",
+              "label": "EU"
+            },
+            {
+              "value": "us",
+              "label": "US"
+            }
+          ],
+          "value": "eu"
+        },
+        {
+          "id": "tags",
+          "name": "tags",
+          "type": "multiselect",
+          "label": "Tags",
+          "is_required": false,
+          "is_secret": false,
+          "options": [
+            {
+              "value": "api",
+              "label": "API"
+            },
+            {
+              "value": "web",
+              "label": "Web"
+            }
+          ],
+          "value": [
+            "api"
+          ]
+        },
+        {
+          "id": "notify",
+          "name": "notify",
+          "type": "checkbox",
+          "label": "Notify",
+          "is_required": false,
+          "is_secret": false,
+          "value": true
+        },
+        {
+          "id": "risk",
+          "name": "risk",
+          "type": "range",
+          "label": "Risk",
+          "is_required": false,
+          "is_secret": false,
+          "min": 0,
+          "max": 10,
+          "step": 1,
+          "value": 3
+        },
+        {
+          "id": "pin",
+          "name": "pin",
+          "type": "otp",
+          "label": "Code",
+          "is_required": false,
+          "is_secret": true,
+          "min_length": 6,
+          "max_length": 6
+        },
+        {
+          "id": "apply",
+          "type": "button",
+          "label": "Apply",
+          "action": "submit",
+          "is_disabled": false,
+          "clicks": 0
+        }
+      ]
+    },
+    {
+      "id": "plans",
+      "type": "group",
+      "direction": "row",
+      "label": "Plans",
+      "children": [
+        {
+          "id": "plan-small",
+          "type": "card",
+          "title": "Small",
+          "text": "Two hosts, one region",
+          "meta": "2 vCPU",
+          "tone": "ok",
+          "is_selectable": true,
+          "clicks": 0
+        },
+        {
+          "id": "plan-large",
+          "type": "card",
+          "title": "Large",
+          "text": "Six hosts, three regions",
+          "meta": "8 vCPU"
         }
       ]
     },
@@ -121,7 +251,7 @@
       "label": "Details",
       "is_collapsible": true,
       "default_expanded": false,
-      "fields": [
+      "children": [
         {
           "id": "inside",
           "type": "paragraph",

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/contracts/fixtures/view.json

@@ -2,7 +2,7 @@
   "input": {
     "id": "input-one",
     "title": "Name",
-    "fields": [
+    "nodes": [
       {
         "id": "name",
         "name": "name",

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/contracts/schema/agents.json

@@ -15,6 +15,9 @@
           "maxLength": 8192,
           "pattern": "\\S"
         },
+        "role": {
+          "$ref": "#/$defs/role"
+        },
         "model": {
           "type": "string",
           "minLength": 1
@@ -77,6 +80,9 @@
                   "task": {
                     "$ref": "#/$defs/spawn/properties/task"
                   },
+                  "role": {
+                    "$ref": "#/$defs/spawn/properties/role"
+                  },
                   "model": {
                     "$ref": "#/$defs/spawn/properties/model"
                   },
@@ -191,8 +197,29 @@
       ],
       "additionalProperties": false
     },
+    "answer": {
+      "$comment": "A person answers the open question of a subagent for its parent.",
+      "type": "object",
+      "properties": {
+        "session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 8192,
+          "pattern": "\\S"
+        }
+      },
+      "required": [
+        "session_id",
+        "text"
+      ],
+      "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.",
+      "$comment": "Add file rules to the grant of a subagent. A child without write rules already writes where its parent writes, so a write grant changes nothing for it. A write rule under a read_only or deny rule of the child fails.",
       "type": "object",
       "properties": {
         "session_id": {
@@ -238,6 +265,10 @@
         "task": {
           "$ref": "#/$defs/spawn/properties/task"
         },
+        "files": {
+          "$comment": "Replace the grant of the child for the follow-up task.",
+          "$ref": "#/$defs/files"
+        },
         "timeout_secs": {
           "$ref": "#/$defs/wait/properties/timeout_secs"
         }
@@ -270,6 +301,32 @@
       ],
       "additionalProperties": false
     },
+    "role": {
+      "description": "Choose the role by the result that you need: facts, changed files, a pass or fail, or findings.",
+      "$comment": "A role is a label for people and the leader. It sets no tool, file or model limit. The TUI writes the role name. The Companion draws a Lucide icon for each role.",
+      "oneOf": [
+        {
+          "const": "research",
+          "title": "Finds facts",
+          "description": "Finds facts. Reads code, docs, logs and history, and answers one question with evidence. Use it before you decide or plan."
+        },
+        {
+          "const": "implement",
+          "title": "Changes files",
+          "description": "Changes files. Writes code, tests, docs or configuration and runs the checks for its change. Use it for one bounded change."
+        },
+        {
+          "const": "verify",
+          "title": "Proves it works",
+          "description": "Proves that something works. Runs tests, reproduces a bug or checks the app, and reports pass or fail with evidence."
+        },
+        {
+          "const": "audit",
+          "title": "Judges the work",
+          "description": "Judges finished work. Reviews a change, plan or release for risks and mistakes, and reports findings. Give it the work, not your conclusion."
+        }
+      ]
+    },
     "model_pair": {
       "type": "object",
       "properties": {
@@ -338,6 +395,9 @@
           "type": "string",
           "minLength": 1
         },
+        "role": {
+          "$ref": "#/$defs/role"
+        },
         "status": {
           "enum": [
             "queued",
@@ -377,6 +437,42 @@
           "type": "integer",
           "minimum": 0
         },
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "question_entry_id": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "budget_request": {
+          "type": "object",
+          "properties": {
+            "iterations": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "reason": {
+              "type": "string"
+            }
+          }
+        },
+        "files_request": {
+          "type": "object",
+          "properties": {
+            "files": {
+              "$ref": "#/$defs/files"
+            },
+            "reason": {
+              "type": "string"
+            }
+          }
+        },
+        "activity": {
+          "$comment": "The latest Activity line of a queued or running agent, such as Patched ~/src/a.clj.",
+          "type": "string",
+          "minLength": 1
+        },
         "usage": {
           "type": [
             "object",
@@ -479,6 +575,63 @@
           "type": "integer",
           "minimum": 0
         },
+        "activity": {
+          "description": "The latest Activity line of a running child.",
+          "type": "string"
+        },
+        "notes": {
+          "description": "The new progress notes of a running child since the last wait.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "messages": {
+          "description": "The new Council messages of a running child since the last wait.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "entry_id": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "kind": {
+                "type": "string"
+              },
+              "content": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "entry_id",
+              "kind",
+              "content"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "step_secs": {
+          "description": "The seconds that a running child is in its current step.",
+          "type": "integer",
+          "minimum": 0
+        },
+        "elapsed_secs": {
+          "description": "The seconds since a running child started its current task.",
+          "type": "integer",
+          "minimum": 0
+        },
+        "alerts": {
+          "description": "For a running child: slow_step after 300 s in one step, errors for three failed steps of the last five, budget at 80% of the iteration budget.",
+          "type": "array",
+          "items": {
+            "enum": [
+              "slow_step",
+              "errors",
+              "budget"
+            ]
+          }
+        },
         "warning": {
           "type": "string"
         },

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/contracts/schema/config.json

@@ -694,6 +694,32 @@
       },
       "additionalProperties": false
     },
+    "toolList": {
+      "type": "array",
+      "maxItems": 256,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Za-z_*][A-Za-z0-9_.*]*$",
+        "maxLength": 200
+      },
+      "description": "Tool names as python_execution binds them, such as memo.recall. * matches any characters."
+    },
+    "tools": {
+      "type": "object",
+      "properties": {
+        "allow": {
+          "$ref": "#/$defs/toolList",
+          "description": "Keep only these tools of each extension that the list names. Other tools of that extension, also later ones, are off."
+        },
+        "deny": {
+          "$ref": "#/$defs/toolList",
+          "description": "Turn these tools off."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Tools of optional extensions that a session can call. Every scope applies: a narrower scope can turn tools off, never on."
+    },
     "jail": {
       "type": "object",
       "properties": {
@@ -1328,6 +1354,9 @@
         "jail": {
           "$ref": "#/$defs/jail"
         },
+        "tools": {
+          "$ref": "#/$defs/tools"
+        },
         "environment": {
           "$ref": "#/$defs/environment"
         },
@@ -1367,31 +1396,6 @@
         "python": {
           "$ref": "#/$defs/python"
         },
-        "improve": {
-          "type": "object",
-          "properties": {
-            "provider": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "minLength": 1
-            },
-            "model": {
-              "type": [
-                "string",
-                "null"
-              ],
-              "minLength": 1
-            },
-            "interval_minutes": {
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 1440
-            }
-          },
-          "additionalProperties": false
-        },
         "titling": {
           "$ref": "#/$defs/titling"
         },

{vis_agent-0.3.3.dev7975 → vis_agent-0.3.4}/contracts/schema/evals.json

@@ -149,6 +149,12 @@
         },
         "candidate_name": {
           "type": "string"
+        },
+        "margin_points": {
+          "description": "The smallest change in points that matters. It splits a result without a clear change into equivalent, not worse, not better or inconclusive.",
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "maximum": 100
         }
       },
       "required": [
@@ -580,7 +586,7 @@
       "additionalProperties": false
     },
     "agreement": {
-      "description": "The agreement of automatic results with human labels, with Cohen kappa and advice.",
+      "description": "The agreement of automatic results with human labels, with Cohen kappa, Krippendorff alpha and advice.",
       "type": "object",
       "properties": {
         "labelled": {
@@ -598,6 +604,12 @@
             "null"
           ]
         },
+        "alpha": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
         "disagreements": {
           "type": "array",
           "items": {
@@ -612,6 +624,7 @@
         "labelled",
         "agreement_percent",
         "kappa",
+        "alpha",
         "disagreements",
         "advice"
       ],
@@ -642,7 +655,16 @@
           "maxItems": 2
         },
         "verdict": {
-          "type": "string"
+          "type": "string",
+          "enum": [
+            "better",
+            "worse",
+            "no measurable difference",
+            "equivalent",
+            "not worse",
+            "not better",
+            "inconclusive"
+          ]
         },
         "detectable_change_points": {
           "type": "number"
@@ -676,6 +698,12 @@
           "items": {
             "type": "string"
           }
+        },
+        "margin_points": {
+          "type": [
+            "number",
+            "null"
+          ]
         }
       },
       "required": [
@@ -691,7 +719,8 @@
         "worse",
         "better",
         "unpaired",
-        "caveats"
+        "caveats",
+        "margin_points"
       ],
       "additionalProperties": false
     },