vis-agent 0.3.5.dev8110__tar.gz → 0.3.5.dev8276__tar.gz

{vis_agent-0.3.5.dev8110 → vis_agent-0.3.5.dev8276}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vis-agent
-Version: 0.3.5.dev8110
+Version: 0.3.5.dev8276
 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.5.dev8110 → vis_agent-0.3.5.dev8276}/contracts/fixtures/activity-results.json

@@ -120,7 +120,7 @@
       "resources": []
     },
     {
-      "result_summary": "{:title \"Activity review\", :entry_id 42, :kind \"informational\", :thread_id 42, :ping [\"reviewer\"], :content \"Read links to the file; Patch shows its **changes** after one disclosure.\"}",
+      "result_summary": "{:title \"Activity review\", :entry_id 42, :thread_id 42, :ping [\"reviewer\"], :content \"Read links to the file; Patch shows its **changes** after one disclosure.\"}",
       "id": "result-4",
       "summary": "Activity review",
       "signal": "observation",
@@ -148,7 +148,7 @@
       "resources": []
     },
     {
-      "result_summary": "{:title \"Activity review\", :entry_id 42, :kind \"informational\", :thread_id 42, :ping [\"reviewer\"], :content \"Read links to the file; Patch shows its **changes** after one disclosure.\"}",
+      "result_summary": "{:title \"Activity review\", :entry_id 42, :thread_id 42, :ping [\"reviewer\"], :content \"Read links to the file; Patch shows its **changes** after one disclosure.\"}",
       "id": "result-5",
       "summary": "Activity review",
       "signal": "observation",

{vis_agent-0.3.5.dev8110 → vis_agent-0.3.5.dev8276}/contracts/fixtures/live-primitives.json

@@ -353,6 +353,174 @@
           "target_kind": "url"
         }
       ]
+    },
+    {
+      "id": "change",
+      "type": "diff",
+      "label": "Proposed change",
+      "patch": "diff --git a/src/a.py b/src/a.py\n--- a/src/a.py\n+++ b/src/a.py\n@@ -1,3 +1,3 @@\n x = 1\n-y = 2\n+y = 3\n z = 4\n",
+      "old_revision": "abc1234",
+      "new_revision": "def5678",
+      "threads": [
+        {
+          "id": "line-2",
+          "anchor": {
+            "path": "src/a.py",
+            "side": "new",
+            "line": 2
+          },
+          "messages": [
+            {
+              "id": "m-1",
+              "author": {
+                "kind": "human",
+                "name": "Ann"
+              },
+              "body": "Why does y change to 3?",
+              "created_at": 1787037267000
+            },
+            {
+              "id": "m-2",
+              "author": {
+                "kind": "agent"
+              },
+              "body": "The spec asks for 3.",
+              "created_at": 1787037268000
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "scene",
+      "type": "scene",
+      "label": "Scene",
+      "width": 16,
+      "height": 9,
+      "background": "#0b0e14",
+      "fov": 40,
+      "is_wrapping": true,
+      "tick_ms": 100,
+      "meshes": [
+        {
+          "id": "shard",
+          "vertices": [
+            [
+              0,
+              1,
+              0
+            ],
+            [
+              -0.8,
+              -0.6,
+              0.3
+            ],
+            [
+              0.8,
+              -0.6,
+              0.3
+            ],
+            [
+              0,
+              -0.4,
+              -0.9
+            ]
+          ],
+          "faces": [
+            [
+              0,
+              1,
+              2
+            ],
+            [
+              0,
+              3,
+              1
+            ],
+            [
+              0,
+              2,
+              3
+            ],
+            [
+              1,
+              3,
+              2
+            ]
+          ]
+        }
+      ],
+      "objects": [
+        {
+          "id": "rock",
+          "mesh": "icosahedron",
+          "x": 4,
+          "y": 5,
+          "z": 0,
+          "rx": 20,
+          "ry": 30,
+          "rz": 0,
+          "scale": 1.5,
+          "color": "#c8a26b",
+          "is_emissive": false
+        },
+        {
+          "id": "ship",
+          "mesh": "cone",
+          "x": 9,
+          "y": 4,
+          "z": 0,
+          "rx": 0,
+          "ry": 0,
+          "rz": -90,
+          "scale": 0.8,
+          "color": "#7fd4ff",
+          "is_emissive": false
+        },
+        {
+          "id": "shot",
+          "mesh": "sphere",
+          "x": 12,
+          "y": 4,
+          "z": 0,
+          "rx": 0,
+          "ry": 0,
+          "rz": 0,
+          "scale": 0.2,
+          "color": "#ffe66b",
+          "is_emissive": true
+        },
+        {
+          "id": "shard-1",
+          "mesh": "shard",
+          "x": 13,
+          "y": 7,
+          "z": 0,
+          "rx": 45,
+          "ry": 10,
+          "rz": 0,
+          "scale": 1,
+          "color": "#b48ead",
+          "is_emissive": false
+        }
+      ]
+    },
+    {
+      "id": "general",
+      "type": "thread",
+      "label": "General discussion",
+      "messages": [
+        {
+          "id": "m-3",
+          "author": {
+            "kind": "extension",
+            "name": "review"
+          },
+          "body": "The review is ready.",
+          "created_at": 1787037269000
+        }
+      ],
+      "draft": "Thanks, this looks good."
     }
   ],
   "title": "Live view components",

{vis_agent-0.3.5.dev8110 → vis_agent-0.3.5.dev8276}/contracts/schema/agents.json

@@ -12,9 +12,16 @@
         "task": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 8192,
+          "maxLength": 65536,
           "pattern": "\\S"
         },
+        "title": {
+          "description": "A short label for people: one line of 1 to 40 characters. Without it, people see the child number, such as #2.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 40,
+          "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$"
+        },
         "role": {
           "$ref": "#/$defs/role"
         },
@@ -80,6 +87,9 @@
                   "task": {
                     "$ref": "#/$defs/spawn/properties/task"
                   },
+                  "title": {
+                    "$ref": "#/$defs/spawn/properties/title"
+                  },
                   "role": {
                     "$ref": "#/$defs/spawn/properties/role"
                   },
@@ -255,27 +265,26 @@
       ],
       "additionalProperties": false
     },
-    "resume": {
+    "result": {
+      "$comment": "The arguments of council.result: the one-line result of a child's current task.",
       "type": "object",
       "properties": {
-        "session_id": {
+        "text": {
           "type": "string",
-          "minLength": 1
-        },
-        "task": {
-          "$ref": "#/$defs/spawn/properties/task"
-        },
-        "files": {
-          "$comment": "Replace the grant of the child for the follow-up task.",
-          "$ref": "#/$defs/files"
+          "minLength": 1,
+          "maxLength": 200,
+          "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$"
         },
-        "timeout_secs": {
-          "$ref": "#/$defs/wait/properties/timeout_secs"
+        "outcome": {
+          "description": "The verdict of a verify child: passed or failed.",
+          "enum": [
+            "passed",
+            "failed"
+          ]
         }
       },
       "required": [
-        "session_id",
-        "task"
+        "text"
       ],
       "additionalProperties": false
     },
@@ -303,7 +312,7 @@
     },
     "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.",
+      "$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 writes it in capitals, in the ink of the role.",
       "oneOf": [
         {
           "const": "research",
@@ -395,6 +404,9 @@
           "type": "string",
           "minLength": 1
         },
+        "title": {
+          "$ref": "#/$defs/spawn/properties/title"
+        },
         "role": {
           "$ref": "#/$defs/role"
         },
@@ -473,6 +485,19 @@
           "type": "string",
           "minLength": 1
         },
+        "note": {
+          "$comment": "The newest progress note of a queued or running agent: the prose of its newest step, as its leader reads it.",
+          "type": "string",
+          "minLength": 1
+        },
+        "result": {
+          "$comment": "The one-line result of a finished task: from council.result, else the first line of the answer.",
+          "type": "string",
+          "minLength": 1
+        },
+        "outcome": {
+          "$ref": "#/$defs/result/properties/outcome"
+        },
         "usage": {
           "type": [
             "object",
@@ -481,6 +506,24 @@
         },
         "files": {
           "$ref": "#/$defs/files"
+        },
+        "created_at": {
+          "$comment": "Epoch ms of the spawn.",
+          "type": "integer",
+          "minimum": 0
+        },
+        "resumed_at": {
+          "$comment": "Epoch ms of the last follow-up Council ping.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "finished_at": {
+          "$comment": "Epoch ms when the current task ended.",
+          "type": "integer",
+          "minimum": 0
         }
       },
       "required": [
@@ -512,7 +555,6 @@
             "failed",
             "cancelled",
             "budget_limited",
-            "lost",
             "unknown"
           ]
         },
@@ -636,12 +678,14 @@
           "type": "string"
         },
         "error": {
-          "description": "Why a failed child stopped. Code rate_limited means a 429 from its provider.",
+          "description": "Why a failed child stopped. Code rate_limited means a 429 from its provider. Code not_started means that its turn never started. Code interrupted means that its turn stopped before its end.",
           "type": "object",
           "properties": {
             "code": {
               "enum": [
-                "rate_limited"
+                "rate_limited",
+                "not_started",
+                "interrupted"
               ]
             },
             "message": {
@@ -681,6 +725,58 @@
       "items": {
         "$ref": "#/$defs/record"
       }
+    },
+    "timeline": {
+      "$comment": "GET /v1/sessions/:sid/agents/:child-id/timeline: the steps of one child, oldest first, from its turns, notes and Council messages.",
+      "type": "object",
+      "properties": {
+        "session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "at": {
+                "$comment": "Epoch ms.",
+                "type": "integer",
+                "minimum": 0
+              },
+              "kind": {
+                "enum": [
+                  "started",
+                  "continued",
+                  "note",
+                  "message",
+                  "finished"
+                ]
+              },
+              "text": {
+                "type": "string",
+                "minLength": 1
+              },
+              "status": {
+                "$ref": "#/$defs/agent/properties/status"
+              },
+              "outcome": {
+                "$ref": "#/$defs/result/properties/outcome"
+              }
+            },
+            "required": [
+              "at",
+              "kind"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "session_id",
+        "items"
+      ],
+      "additionalProperties": false
     }
   }
 }

{vis_agent-0.3.5.dev8110 → vis_agent-0.3.5.dev8276}/contracts/schema/council.json

@@ -68,13 +68,13 @@
         "reply_to": {
           "$ref": "#/$defs/entry_id"
         },
-        "kind": {
-          "$ref": "#/$defs/kind"
+        "files": {
+          "$comment": "Replace the file grant of the one pinged idle subagent for its follow-up task.",
+          "$ref": "agents.json#/$defs/files"
         }
       },
       "required": [
-        "content",
-        "kind"
+        "content"
       ],
       "additionalProperties": false
     },
@@ -84,9 +84,6 @@
         "content": {
           "$ref": "#/$defs/publish/properties/content"
         },
-        "kind": {
-          "$ref": "#/$defs/publish/properties/kind"
-        },
         "group_id": {
           "$ref": "#/$defs/publish/properties/group_id"
         },
@@ -101,8 +98,7 @@
         }
       },
       "required": [
-        "content",
-        "kind"
+        "content"
       ],
       "additionalProperties": false
     },
@@ -304,8 +300,7 @@
         "source": {
           "enum": [
             "host",
-            "sdk",
-            "autocomplain"
+            "sdk"
           ]
         },
         "ping": {
@@ -339,9 +334,6 @@
         },
         "entry_id": {
           "$ref": "#/$defs/entry_id"
-        },
-        "kind": {
-          "$ref": "#/$defs/kind"
         }
       },
       "required": [
@@ -352,8 +344,7 @@
         "author_session_id",
         "created_at",
         "source",
-        "ping",
-        "kind"
+        "ping"
       ],
       "additionalProperties": false
     },
@@ -374,17 +365,13 @@
         "created_at": {
           "type": "integer",
           "minimum": 0
-        },
-        "kind": {
-          "$ref": "#/$defs/kind"
         }
       },
       "required": [
         "thread_id",
         "title",
         "author_session_id",
-        "created_at",
-        "kind"
+        "created_at"
       ],
       "additionalProperties": false
     },
@@ -423,17 +410,13 @@
         "entry_id": {
           "$ref": "#/$defs/entry_id"
         },
-        "kind": {
-          "$ref": "#/$defs/kind"
-        },
         "source_ref": {
           "$ref": "#/$defs/source_ref"
         },
         "source": {
           "enum": [
             "host",
-            "sdk",
-            "autocomplain"
+            "sdk"
           ]
         }
       },
@@ -444,8 +427,7 @@
         "content",
         "author_session_id",
         "created_at",
-        "truncated",
-        "kind"
+        "truncated"
       ],
       "additionalProperties": false
     },
@@ -464,16 +446,12 @@
         },
         "entry_id": {
           "$ref": "#/$defs/entry_id"
-        },
-        "kind": {
-          "$ref": "#/$defs/kind"
         }
       },
       "required": [
         "entry_id",
         "thread_id",
-        "group_id",
-        "kind"
+        "group_id"
       ],
       "additionalProperties": false
     },
@@ -640,14 +618,6 @@
       "type": "integer",
       "minimum": 0,
       "description": "Exclusive entry-ID cursor; zero starts a page. Keep the same group and filters."
-    },
-    "kind": {
-      "enum": [
-        "complain",
-        "coordination",
-        "informational"
-      ],
-      "description": "Per-entry information classification, independent of recipients and reply obligations."
     }
   }
 }

{vis_agent-0.3.5.dev8110 → vis_agent-0.3.5.dev8276}/contracts/schema/diff.json

@@ -58,8 +58,7 @@
       "required": [
         "schema_version",
         "patch",
-        "source",
-        "comments"
+        "source"
       ],
       "properties": {
         "schema_version": {
@@ -72,13 +71,13 @@
           "$ref": "#/$defs/source"
         },
         "comments": {
+          "description": "Review comments that older Vis versions stored. Readers ignore them.",
           "type": "array",
           "items": {
             "$ref": "#/$defs/comment"
           }
         }
-      },
-      "x-vis-review-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."
+      }
     },
     "attachment": {
       "type": "string",