@mmerterden/multi-agent-pipeline 20.29.0 → 20.30.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}$" }
+      }
+    }
+  }
+}

package/pipeline/schemas/activity.schema.json

@@ -0,0 +1,429 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/activity.schema.json",
+  "title": "Office activity",
+  "description": "What GET /v1/activity returns and `activity-snapshot.mjs --json` prints, and what each GET /v1/activity/stream event carries: one room per repository, one table per run (its team; a session no run claims sits at a table of its own), one seat per agent seen in the recent window, the orchestrator at the head. Derived from disk on every call. No field is machine-local: there are no paths, seat labels come from allow-listed fields only (tool name, file basename, sidecar description), and every free-text string has been through the redactor, so the redacted and the full view are the same document.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "generatedAt", "recentMinutes", "rooms", "corridors", "counts"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "x-sensitivity": "none"
+    },
+    "recentMinutes": {
+      "type": "number",
+      "description": "A session or subagent whose transcript changed within this window has a desk.",
+      "x-sensitivity": "none"
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["rooms", "tables", "seats", "live", "waiting"],
+      "x-sensitivity": "none",
+      "properties": {
+        "rooms": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "tables": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "seats": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "live": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "waiting": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "rooms": {
+      "type": "array",
+      "x-sensitivity": "none",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["repo", "tables"],
+        "properties": {
+          "repo": {
+            "type": "string"
+          },
+          "tables": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/table"
+            }
+          }
+        }
+      }
+    },
+    "corridors": {
+      "type": "array",
+      "x-sensitivity": "none",
+      "description": "Runs over more than one repository: the table and the rooms its corridor joins.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["tableId", "repos"],
+        "properties": {
+          "tableId": {
+            "type": "string"
+          },
+          "repos": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "table": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "kind",
+        "taskId",
+        "title",
+        "host",
+        "limited",
+        "sessionId",
+        "matchedBy",
+        "repos",
+        "phase",
+        "now",
+        "status",
+        "waitingForYou",
+        "pendingQuestion",
+        "tokens",
+        "estUsd",
+        "costSource",
+        "repo",
+        "location",
+        "branch",
+        "phaseHistory",
+        "startedAt",
+        "elapsedSeconds",
+        "holder",
+        "previousHolder",
+        "seats"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "kind": {
+          "enum": ["run", "session", "unmatched"],
+          "description": "run: a pipeline run; session: a session no run claims (outside the pipeline); unmatched: a session more than one run could claim, kept apart rather than guessed."
+        },
+        "taskId": {
+          "type": ["string", "null"]
+        },
+        "title": {
+          "type": ["string", "null"]
+        },
+        "host": {
+          "enum": ["claude", "copilot", "codex"]
+        },
+        "limited": {
+          "type": "boolean",
+          "description": "true for a Copilot CLI or Codex session: no subagent detail exists there."
+        },
+        "sessionId": {
+          "type": ["string", "null"]
+        },
+        "matchedBy": {
+          "enum": ["session", "cwd-branch", null],
+          "description": "How the session was tied to the run: the session id the run recorded, or its working directory and branch."
+        },
+        "repos": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "phase": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "name", "last"],
+              "properties": {
+                "id": {
+                  "type": "integer"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "last": {
+                  "type": "integer",
+                  "description": "The last phase id, for an n of last display."
+                }
+              }
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "now": {
+          "type": ["string", "null"]
+        },
+        "status": {
+          "type": ["string", "null"]
+        },
+        "waitingForYou": {
+          "type": "boolean"
+        },
+        "pendingQuestion": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "text", "kind", "options"],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                },
+                "kind": {
+                  "enum": ["single-select", "multi-select"]
+                },
+                "options": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["id", "label"],
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "label": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "tokens": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["in", "out", "cached"],
+              "properties": {
+                "in": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "out": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "cached": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              }
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "estUsd": {
+          "type": ["number", "null"]
+        },
+        "costSource": {
+          "enum": ["tracker-state", "not-measured"],
+          "description": "Where tokens and estUsd come from. not-measured means the numbers are null, never 0."
+        },
+        "repo": {
+          "type": "string",
+          "description": "The room this table stands in."
+        },
+        "location": {
+          "enum": ["worktree", "local", "unknown"],
+          "description": "worktree: the run works in its own worktree; local: in the main checkout; unknown when the state does not say."
+        },
+        "branch": {
+          "type": ["string", "null"]
+        },
+        "phaseHistory": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "name", "status", "startedAt", "completedAt"],
+            "properties": {
+              "id": {
+                "type": ["integer", "null"]
+              },
+              "name": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string"
+              },
+              "startedAt": {
+                "type": ["string", "null"]
+              },
+              "completedAt": {
+                "type": ["string", "null"]
+              }
+            }
+          }
+        },
+        "startedAt": {
+          "type": ["string", "null"]
+        },
+        "elapsedSeconds": {
+          "type": ["integer", "null"],
+          "minimum": 0
+        },
+        "holder": {
+          "type": ["string", "null"],
+          "description": "The seat id that holds the work now."
+        },
+        "previousHolder": {
+          "type": ["string", "null"],
+          "description": "The last seat of an earlier phase, for drawing the handoff."
+        },
+        "seats": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/seat"
+          }
+        }
+      }
+    },
+    "seat": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "sessionId",
+        "agentId",
+        "agentType",
+        "role",
+        "label",
+        "known",
+        "sprite",
+        "color",
+        "model",
+        "modelLabel",
+        "description",
+        "state",
+        "tool",
+        "detail",
+        "live",
+        "startedAt",
+        "lastAt",
+        "phase",
+        "status",
+        "doing"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "sessionId": {
+          "type": ["string", "null"]
+        },
+        "agentId": {
+          "type": ["string", "null"],
+          "description": "null for the session's own (orchestrator) desk."
+        },
+        "agentType": {
+          "type": ["string", "null"]
+        },
+        "role": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string",
+          "description": "The role, numbered when agents of the same role sit at one table (Reviewer 1, Reviewer 2)."
+        },
+        "known": {
+          "type": "boolean",
+          "description": "false when the agent type is in no role table entry and the raw type is shown."
+        },
+        "sprite": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "color": {
+          "type": "string",
+          "pattern": "^#[0-9a-f]{6}$"
+        },
+        "model": {
+          "type": ["string", "null"]
+        },
+        "modelLabel": {
+          "type": ["string", "null"]
+        },
+        "description": {
+          "type": ["string", "null"],
+          "maxLength": 64
+        },
+        "state": {
+          "enum": ["reading", "writing", "spawning", "waiting", "idle", "done"]
+        },
+        "tool": {
+          "type": ["string", "null"]
+        },
+        "detail": {
+          "type": ["string", "null"]
+        },
+        "live": {
+          "type": ["boolean", "null"],
+          "description": "Whether the session is alive per `claude agents --json`; null when that list cannot be read."
+        },
+        "startedAt": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "lastAt": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        },
+        "phase": {
+          "type": ["integer", "null"],
+          "description": "The run phase the agent was spawned in; null for the orchestrator or outside a run."
+        },
+        "status": {
+          "enum": ["working", "idle", "done"]
+        },
+        "doing": {
+          "type": "string",
+          "description": "What the seat is doing in a few plain words (Reading Foo.swift, Running a command), else the raw tool name."
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/autopilot-on-request.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/autopilot-on-request.schema.json",
+  "title": "Autopilot on request",
+  "description": "The body of POST /v1/autopilot/on. The first request names the selection (repos, by nameWithOwner, each already in the autopilot config) and gets a preview and a confirm token; the second sends only the token and turns the mode on for exactly what was previewed. An empty selection is refused: the mode is never turned on without a repository.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "repos": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 50,
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9._-]{1,100}(/[A-Za-z0-9._-]{1,100})?$"
+      }
+    },
+    "configureOnly": {
+      "type": "boolean",
+      "description": "Save the selection without scheduling anything."
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}