@mmerterden/multi-agent-pipeline 20.29.0 → 20.33.0

package/pipeline/office/toolkit.json

@@ -0,0 +1,3 @@
+{
+  "toolkitVersion": "3.26.0"
+}

package/pipeline/schemas/activity-chat.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/activity-chat.schema.json",
+  "title": "Agent chat page",
+  "description": "What GET /v1/agents/{sessionId}/{agentId}/chat returns and `activity-snapshot.mjs chat` prints: one page of an agent's transcript read from its end, oldest first, at most `limit` messages. Only user and assistant records are read; api-request records are never parsed and thinking blocks are never emitted. Every text has been through the redactor; a text the outbound gate still flags is replaced by a marker. `before` is the byte offset to send back for the previous page, null at the start of the file.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "sessionId", "agentId", "messages", "before", "redacted"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "sessionId": { "type": "string", "x-sensitivity": "none" },
+    "agentId": {
+      "type": ["string", "null"],
+      "description": "null for the session's own transcript (the orchestrator).",
+      "x-sensitivity": "none"
+    },
+    "messages": {
+      "type": "array",
+      "x-sensitivity": "none",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["offset", "role", "at", "blocks"],
+        "properties": {
+          "offset": { "type": "integer", "minimum": 0 },
+          "role": { "enum": ["user", "assistant"] },
+          "at": { "type": ["string", "null"] },
+          "blocks": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["kind", "text"],
+                  "properties": { "kind": { "const": "text" }, "text": { "type": "string" } }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["kind", "name", "summary", "toolUseId"],
+                  "properties": {
+                    "kind": { "const": "tool" },
+                    "name": { "type": "string" },
+                    "summary": { "type": "string" },
+                    "toolUseId": { "type": ["string", "null"] }
+                  }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["kind", "toolUseId", "text", "isError"],
+                  "properties": {
+                    "kind": { "const": "result" },
+                    "toolUseId": { "type": ["string", "null"] },
+                    "text": { "type": "string" },
+                    "isError": { "type": "boolean" }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "before": { "type": ["integer", "null"], "minimum": 0, "x-sensitivity": "none" },
+    "redacted": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "How many items the redactor replaced on this page.",
+      "x-sensitivity": "none"
+    }
+  }
+}

package/pipeline/schemas/activity-roles.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "./activity-roles.schema.json",
+  "contractVersion": "1.0.0",
+  "description": "The role label shown above each agent in the office view, by agent type. activity-snapshot.mjs reads it and nothing else names a role. Labels stay English (they are technical names). A type in `untyped` takes its role from the run phase it was spawned in; a type in neither list is shown as its raw agentType, never guessed. smoke-activity-roles.sh fails when an agent under pipeline/agents/ is missing from `agentTypes`.",
+  "orchestrator": "Orchestrator",
+  "agentTypes": {
+    "task-clarifier": "Clarifier",
+    "test-gen-analyst": "Test Gap Analyst",
+    "explorer": "Explorer",
+    "Explore": "Explorer",
+    "Plan": "Planner",
+    "plan-critic": "Plan Critic",
+    "ios-architect": "iOS Architect",
+    "android-architect": "Android Architect",
+    "backend-architect": "Backend Architect",
+    "dev-critic": "Dev Critic",
+    "code-reviewer": "Reviewer",
+    "security-auditor": "Security Auditor",
+    "bulk-reader": "Reader"
+  },
+  "untyped": ["general-purpose", "claude", "fork"],
+  "phaseRoles": {
+    "1": "Planner",
+    "2": "Developer",
+    "3": "Reviewer",
+    "4": "Committer",
+    "5": "Reporter"
+  },
+  "styles": {
+    "Orchestrator": { "sprite": 0, "color": "#3d6fd8" },
+    "Clarifier": { "sprite": 1, "color": "#8a63d2" },
+    "Explorer": { "sprite": 2, "color": "#1f9e89" },
+    "Planner": { "sprite": 3, "color": "#d98b1f" },
+    "Plan Critic": { "sprite": 4, "color": "#c2553d" },
+    "iOS Architect": { "sprite": 5, "color": "#2b8bd6" },
+    "Android Architect": { "sprite": 5, "color": "#3f9c35" },
+    "Backend Architect": { "sprite": 5, "color": "#7a6a55" },
+    "Developer": { "sprite": 6, "color": "#2f8f5b" },
+    "Dev Critic": { "sprite": 4, "color": "#b5487a" },
+    "Test Gap Analyst": { "sprite": 2, "color": "#9a7b1c" },
+    "Reviewer": { "sprite": 7, "color": "#c43d3d" },
+    "Security Auditor": { "sprite": 8, "color": "#4a4a4a" },
+    "Reader": { "sprite": 2, "color": "#6b7f99" },
+    "Committer": { "sprite": 9, "color": "#5c6bc0" },
+    "Reporter": { "sprite": 9, "color": "#00897b" }
+  },
+  "unknownStyle": { "sprite": 10, "color": "#888888" }
+}

package/pipeline/schemas/activity-roles.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/activity-roles.schema.json",
+  "title": "Office role table",
+  "description": "The shape of activity-roles.json: the role label per agent type, the agent types whose role follows the run phase, the phase-to-role map and one fixed sprite and color per role.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "orchestrator",
+    "agentTypes",
+    "untyped",
+    "phaseRoles",
+    "styles",
+    "unknownStyle"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "contractVersion": { "type": "string", "pattern": "^1\\.[0-9]+\\.[0-9]+$" },
+    "description": { "type": "string" },
+    "orchestrator": { "type": "string", "minLength": 1 },
+    "agentTypes": {
+      "type": "object",
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "untyped": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "phaseRoles": {
+      "type": "object",
+      "propertyNames": { "pattern": "^[0-9]+$" },
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "styles": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/style" }
+    },
+    "unknownStyle": { "$ref": "#/$defs/style" }
+  },
+  "$defs": {
+    "style": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sprite", "color"],
+      "properties": {
+        "sprite": { "type": "integer", "minimum": 0, "maximum": 15 },
+        "color": { "type": "string", "pattern": "^#[0-9a-f]{6}$" }
+      }
+    }
+  }
+}