@mmerterden/multi-agent-pipeline 20.29.0 → 20.30.0

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

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/autopilot-on.schema.json",
+  "title": "Autopilot on",
+  "description": "What POST /v1/autopilot/on returns (`autopilot-control.mjs on-preview`, then `on`). Step one: preview {keep, drop, probe, configureOnly} with confirmToken and expiresAt. Step two: enabled and scheduled say whether the schedule was loaded; it is not when configureOnly was asked or a credential probe failed, and probe says which.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "preview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["keep", "drop", "probe", "configureOnly"],
+      "properties": {
+        "keep": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "drop": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "probe": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ready", "problems", "warnings"],
+          "properties": {
+            "ready": {
+              "type": "boolean"
+            },
+            "problems": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "warnings": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "configureOnly": {
+          "type": "boolean"
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "enabled": {
+      "type": "boolean"
+    },
+    "scheduled": {
+      "type": "boolean"
+    },
+    "awake": {
+      "type": ["boolean", "null"]
+    },
+    "repos": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "dropped": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "probe": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ready", "problems", "warnings"],
+      "properties": {
+        "ready": {
+          "type": "boolean"
+        },
+        "problems": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "warnings": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/contract-error.schema.json

@@ -47,13 +47,43 @@
         "confirm-mismatch",
         "unattended-profile-missing",
         "workspace-not-trusted",
+        "no-selection",
+        "repo-not-configured",
+        "invalid-config",
+        "not-installed",
+        "repo-ambiguous",
+        "unreadable-settings",
+        "not-removable",
+        "not-steerable",
+        "too-many-streams",
+        "no-review",
+        "upstream-failed",
+        "tool-not-allowed",
+        "busy",
+        "review-incomplete",
+        "host-not-allowed",
         "internal"
       ],
       "x-sensitivity": "none"
     },
-    "message": { "type": "string", "x-sensitivity": "none" },
-    "errors": { "type": "array", "items": { "type": "string" }, "x-sensitivity": "none" },
-    "supported": { "type": "array", "items": { "type": "integer" }, "x-sensitivity": "none" },
+    "message": {
+      "type": "string",
+      "x-sensitivity": "none"
+    },
+    "errors": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "x-sensitivity": "none"
+    },
+    "supported": {
+      "type": "array",
+      "items": {
+        "type": "integer"
+      },
+      "x-sensitivity": "none"
+    },
     "remedy": {
       "type": "string",
       "x-sensitivity": "none",

package/pipeline/schemas/issue-maturity.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/issue-maturity.schema.json",
+  "title": "Issue maturity",
+  "description": "What GET /v1/issues/{key}/maturity returns (`work-items.mjs maturity <key>`, from lib/issue-fetcher.sh): the maturity check the pipeline runs before it starts on an issue. key is a Jira key, owner/repo#N or #N. Blockers stop a run; warnings are asked about. Text is redacted.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "key",
+    "kind",
+    "title",
+    "type",
+    "status",
+    "maturity",
+    "description"
+  ],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "key": {
+      "type": "string"
+    },
+    "kind": {
+      "enum": ["jira", "github", "freetext"]
+    },
+    "title": {
+      "type": "string"
+    },
+    "type": {
+      "type": ["string", "null"]
+    },
+    "status": {
+      "type": ["string", "null"]
+    },
+    "maturity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["score", "blockers", "warnings", "summary"],
+      "properties": {
+        "score": {
+          "type": ["number", "null"]
+        },
+        "blockers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "warnings": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "summary": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "description": {
+      "type": ["string", "null"]
+    }
+  }
+}

package/pipeline/schemas/ledger.schema.json

@@ -0,0 +1,202 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/ledger.schema.json",
+  "title": "Office ledger",
+  "description": "What GET /v1/ledger returns and `office-ledger.mjs --json` prints: tokens and estimated USD for today, this week (from Monday) and this month, in local time, broken down by run, repository, model and phase. A run's numbers come from its tracker-state.json when the tracker carries tokens, else from the usage records of the transcripts tied to it; a run with neither is not-measured, and its usd and tokens are null, never 0. Sessions no run claims are counted apart as outside the pipeline. Prices come from cost-table.json; a cache write is priced at 1.25 times input. Every amount names its source.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "generatedAt", "prices", "windows"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "x-sensitivity": "none"
+    },
+    "prices": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["table", "verifiedAt", "ageDays", "stale", "warning"],
+      "x-sensitivity": "none",
+      "properties": {
+        "table": {
+          "const": "cost-table.json"
+        },
+        "verifiedAt": {
+          "type": ["string", "null"]
+        },
+        "ageDays": {
+          "type": ["integer", "null"]
+        },
+        "stale": {
+          "type": "boolean"
+        },
+        "warning": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "windows": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["today", "week", "month"],
+      "x-sensitivity": "none",
+      "properties": {
+        "today": {
+          "$ref": "#/$defs/window"
+        },
+        "week": {
+          "$ref": "#/$defs/window"
+        },
+        "month": {
+          "$ref": "#/$defs/window"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "source": {
+      "enum": ["tracker-state", "transcript", "mixed", "not-measured"],
+      "description": "tracker-state: the pipeline's own ledger; transcript: derived from the host's usage records; mixed: a sum of both kinds; not-measured: nothing could be read, so the numbers are null."
+    },
+    "tokens": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["in", "out", "cacheRead", "cacheWrite"],
+          "properties": {
+            "in": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "out": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cacheRead": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cacheWrite": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "amount": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tokens", "usd", "source", "unpriced"],
+      "properties": {
+        "tokens": {
+          "$ref": "#/$defs/tokens"
+        },
+        "usd": {
+          "type": ["number", "null"]
+        },
+        "source": {
+          "$ref": "#/$defs/source"
+        },
+        "unpriced": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Usage records whose model has no price; their tokens are counted, their cost is not."
+        }
+      }
+    },
+    "row": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "tokens", "usd", "source", "unpriced"],
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "repo": {
+          "type": ["string", "null"],
+          "description": "On byRun rows: the run repository."
+        },
+        "tokens": {
+          "$ref": "#/$defs/tokens"
+        },
+        "usd": {
+          "type": ["number", "null"]
+        },
+        "source": {
+          "$ref": "#/$defs/source"
+        },
+        "unpriced": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "window": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "since",
+        "total",
+        "outsidePipeline",
+        "notMeasured",
+        "byRun",
+        "byRepo",
+        "byModel",
+        "byPhase"
+      ],
+      "properties": {
+        "since": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "total": {
+          "$ref": "#/$defs/amount"
+        },
+        "outsidePipeline": {
+          "$ref": "#/$defs/amount"
+        },
+        "notMeasured": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Task ids of runs active in the window whose cost could not be measured."
+        },
+        "byRun": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/row"
+          }
+        },
+        "byRepo": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/row"
+          }
+        },
+        "byModel": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/row"
+          }
+        },
+        "byPhase": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/row"
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/permissions.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/permissions.schema.json",
+  "title": "Pending permission prompts",
+  "description": "What GET /v1/permissions returns: the host permission prompts waiting on the user. available is false while the host records none where another process can read them; requests is then empty and reason says so. When available, each request names its session, the tool and a redacted summary.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "available", "reason", "requests"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "available": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": ["string", "null"]
+    },
+    "requests": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "sessionId", "tool", "summary", "at"],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "sessionId": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "at": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/prefs.schema.json

@@ -309,6 +309,25 @@
             "maxItems": 10
           }
         },
+        "office": {
+          "type": "object",
+          "description": "The office panel (/multi-agent:office-on). page overrides the installed panel page; toolkitVersion pins an @latest toolkit registration for the panel's tool calls; remote is read only to report that a separately installed remote layer is present, and no remote code ships with the pipeline.",
+          "additionalProperties": false,
+          "properties": {
+            "page": {
+              "type": "string",
+              "description": "Absolute path of an HTML page GET /office serves instead of the installed one."
+            },
+            "toolkitVersion": {
+              "type": "string",
+              "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[0-9A-Za-z.-]+)?$"
+            },
+            "remote": {
+              "type": "object",
+              "description": "Configuration owned by a separately installed remote layer; the pipeline only checks that it exists."
+            }
+          }
+        },
         "routines": {
           "type": "array",
           "description": "v2.4.0+. User-defined routines saved via /multi-agent:save. Each entry indexes a local-only /multi-agent:<name> command dir under ~/.claude/commands/multi-agent/. Never synced (personal). Managed by routine-registry.mjs.",

package/pipeline/schemas/prs.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/prs.schema.json",
+  "title": "Pull requests",
+  "description": "What GET /v1/prs returns (`work-items.mjs prs`): open pull requests where you are asked to review or are the author. sources says per host whether it was read; Bitbucket listing is not implemented and says so rather than showing an empty list. url is dropped under redact.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "items", "sources"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "repo", "number", "title", "url", "author", "updatedAt", "role"],
+        "properties": {
+          "source": {
+            "enum": ["github", "bitbucket"]
+          },
+          "repo": {
+            "type": "string"
+          },
+          "number": {
+            "type": "integer"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "type": ["string", "null"],
+            "x-sensitivity": "local"
+          },
+          "author": {
+            "type": ["string", "null"]
+          },
+          "updatedAt": {
+            "type": ["string", "null"]
+          },
+          "role": {
+            "enum": ["reviewer", "author"]
+          }
+        }
+      }
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "ok", "count"],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "count": {
+            "type": "integer"
+          },
+          "reason": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/review-verdict-request.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/review-verdict-request.schema.json",
+  "title": "Review verdict request",
+  "description": "The body of POST /v1/runs/{id}/review-verdict: empty for the preview, confirmToken to post. The verdict is never chosen by the request; it follows from the review's recorded findings.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}

package/pipeline/schemas/review-verdict.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/review-verdict.schema.json",
+  "title": "Review verdict",
+  "description": "What POST /v1/runs/{id}/review-verdict returns (`work-items.mjs verdict <id> [--post]`). Only a finished review whose every finding is triaged (accepted, rejected or deferred) is previewed (409 review-incomplete otherwise). The preview carries findingsDigest, the hash of the findings it was made from, and the decision lib/post-pr-review.sh would post (approve with no accepted blocking or important finding, else needs-work), a confirmToken bound to that decision and digest, and expiresAt; a confirmation after either changed is 409 confirm-mismatch; the confirmation runs post-pr-review.sh, which posts the comments and the verdict with the user's own credential, and says posted.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "taskId",
+    "provider",
+    "prNumber",
+    "decision",
+    "acceptedBlocking",
+    "acceptedImportant",
+    "findings",
+    "findingsDigest"
+  ],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "taskId": {
+      "type": "string"
+    },
+    "provider": {
+      "enum": ["github", "bitbucket-server", null]
+    },
+    "prNumber": {
+      "type": ["integer", "null"]
+    },
+    "decision": {
+      "enum": ["approve", "needs-work"]
+    },
+    "acceptedBlocking": {
+      "type": "integer"
+    },
+    "acceptedImportant": {
+      "type": "integer"
+    },
+    "findings": {
+      "type": "integer"
+    },
+    "posted": {
+      "type": "boolean"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "findingsDigest": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    }
+  }
+}