@piagent/platform 1.3.1 → 1.4.1

package/schemas/piagent-webui/handoff-history-v1.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/handoff-history-v1.schema.json",
+  "title": "Piagent WebUI bounded handoff history and next action v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "runRef", "state", "historyRevision", "completeness", "current", "nextAction", "events", "page", "warnings", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-handoff-history-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "runRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "historyRevision": { "$ref": "common-v1.schema.json#/$defs/nullableRevisionToken" },
+    "completeness": { "enum": ["complete", "partial", "snapshot-only", "missing", "unknown"] },
+    "current": { "anyOf": [{ "$ref": "#/$defs/current" }, { "type": "null" }] },
+    "nextAction": { "$ref": "#/$defs/nextAction" },
+    "events": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/event" } },
+    "page": { "$ref": "#/$defs/page" },
+    "warnings": { "type": "array", "maxItems": 8, "items": { "$ref": "#/$defs/warning" } },
+    "health": { "$ref": "common-v1.schema.json#/$defs/health" }
+  },
+  "allOf": [
+    { "properties": { "identity": { "type": "object", "properties": {
+      "taskId": { "$ref": "common-v1.schema.json#/$defs/publicId" }, "taskRunId": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+      "agentOperationId": { "type": "null" }, "toolCallId": { "type": "null" }
+    } } } },
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": { "properties": {
+        "historyRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "completeness": { "enum": ["complete", "partial", "snapshot-only", "missing"] },
+        "nextAction": { "type": "object", "properties": {
+          "action": { "enum": ["terminal", "inspect-handoff", "wait-paused", "retry-checkpoint", "rerun-exact-verifier", "continue-plan", "request-completion"] },
+          "enforcementSafe": { "type": "boolean" }
+        } },
+        "health": { "type": "object", "properties": { "state": { "enum": ["ok", "degraded"] } } }
+      } },
+      "else": { "properties": {
+        "historyRevision": { "type": "null" }, "completeness": { "const": "unknown" }, "current": { "type": "null" },
+        "nextAction": { "type": "object", "properties": { "action": { "const": "unknown" }, "stepRef": { "type": "null" },
+          "exactCommandCount": { "const": 0 }, "dispatchable": { "const": false }, "enforcementSafe": { "const": false } } },
+        "events": { "type": "array", "maxItems": 0 },
+        "page": { "type": "object", "properties": { "total": { "const": 0 }, "returned": { "const": 0 }, "truncated": { "const": false } } },
+        "health": { "type": "object", "properties": { "state": { "enum": ["unavailable", "error"] } } }
+      } }
+    }
+  ],
+  "$defs": {
+    "current": {
+      "type": "object", "additionalProperties": false,
+      "required": ["handoffRef", "generatedAt", "phase", "taskOutcome", "gateDecision", "completionApproved", "requiredAuthority", "treeEvidenceCurrent", "latestVerifierMatchesCurrentTree", "changedFileCount", "missingCount", "projectedAction"],
+      "properties": {
+        "handoffRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }, "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "phase": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
+        "taskOutcome": { "enum": ["pending", "completed", "blocked", "partial", "failed"] },
+        "gateDecision": { "enum": ["pass", "fail"] }, "completionApproved": { "type": "boolean" },
+        "requiredAuthority": { "enum": ["none", "operator", "permission", "scope", "fresh-session"] },
+        "treeEvidenceCurrent": { "type": "boolean" }, "latestVerifierMatchesCurrentTree": { "type": "boolean" },
+        "changedFileCount": { "type": "integer", "minimum": 0, "maximum": 500 }, "missingCount": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "projectedAction": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }
+      }
+    },
+    "nextAction": {
+      "type": "object", "additionalProperties": false,
+      "required": ["action", "stepRef", "reason", "exactCommandCount", "dispatchable", "enforcementSafe"],
+      "properties": {
+        "action": { "enum": ["terminal", "inspect-handoff", "wait-paused", "retry-checkpoint", "rerun-exact-verifier", "continue-plan", "request-completion", "unknown"] },
+        "stepRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" }, "reason": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "exactCommandCount": { "type": "integer", "minimum": 0, "maximum": 50 }, "dispatchable": { "const": false }, "enforcementSafe": { "type": "boolean" }
+      }
+    },
+    "event": {
+      "type": "object", "additionalProperties": false,
+      "required": ["eventRef", "evidenceRef", "sequence", "recordedAt", "phase", "completionApproved", "projectedAction"],
+      "properties": {
+        "eventRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }, "evidenceRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "sequence": { "type": "integer", "minimum": 1, "maximum": 2147483647 }, "recordedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "phase": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" }, "completionApproved": { "type": "boolean" },
+        "projectedAction": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }
+      }
+    },
+    "page": { "type": "object", "additionalProperties": false, "required": ["total", "returned", "truncated"], "properties": {
+      "total": { "type": "integer", "minimum": 0, "maximum": 100000 }, "returned": { "type": "integer", "minimum": 0, "maximum": 100 }, "truncated": { "type": "boolean" }
+    } },
+    "warning": { "type": "object", "additionalProperties": false, "required": ["code", "count", "message"], "properties": {
+      "code": { "enum": ["telemetry-missing", "telemetry-corrupt", "telemetry-incomplete-tail", "telemetry-input-truncated", "history-truncated", "current-handoff-missing", "history-snapshot-only"] },
+      "count": { "type": "integer", "minimum": 1, "maximum": 1000000000 }, "message": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }
+    } }
+  }
+}

package/schemas/piagent-webui/model-catalog-v1.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/model-catalog-v1.schema.json",
+  "title": "Piagent WebUI authenticated model catalog v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "revision", "state", "catalogScope", "effectScope", "activeModelRef", "activeThinkingLevel", "models", "reasonCode"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-model-catalog-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "revision": { "$ref": "common-v1.schema.json#/$defs/domainRevision" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "catalogScope": { "enum": ["authenticated-all", "session-scoped", "unavailable"] },
+    "effectScope": { "const": "session-and-user-default" },
+    "activeModelRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+    "activeThinkingLevel": { "$ref": "#/$defs/nullableThinkingLevel" },
+    "models": {
+      "type": "array",
+      "maxItems": 300,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/model" }
+    },
+    "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": {
+        "properties": {
+          "catalogScope": { "enum": ["authenticated-all", "session-scoped"] },
+          "activeModelRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+          "activeThinkingLevel": { "$ref": "#/$defs/thinkingLevel" },
+          "models": { "type": "array", "minItems": 1 },
+          "reasonCode": { "type": "null" }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "state": { "const": "unavailable" } }, "required": ["state"] },
+      "then": {
+        "properties": {
+          "catalogScope": { "const": "unavailable" },
+          "activeModelRef": { "type": "null" },
+          "activeThinkingLevel": { "type": "null" },
+          "models": { "type": "array", "maxItems": 0 },
+          "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "thinkingLevel": { "enum": ["off", "minimal", "low", "medium", "high", "xhigh", "max"] },
+    "nullableThinkingLevel": {
+      "anyOf": [
+        { "$ref": "#/$defs/thinkingLevel" },
+        { "type": "null" }
+      ]
+    },
+    "safeName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[^\\u0000-\\u001F\\u007F]*$"
+    },
+    "model": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["modelRef", "provider", "modelId", "displayName", "reasoning", "inputCapabilities", "supportedThinkingLevels", "contextWindow", "maxOutputTokens"],
+      "properties": {
+        "modelRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "provider": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+        "modelId": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+        "displayName": { "$ref": "#/$defs/safeName" },
+        "reasoning": { "type": "boolean" },
+        "inputCapabilities": {
+          "type": "array",
+          "maxItems": 2,
+          "uniqueItems": true,
+          "items": { "enum": ["text", "image"] }
+        },
+        "supportedThinkingLevels": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 7,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/thinkingLevel" }
+        },
+        "contextWindow": { "type": "integer", "minimum": 1, "maximum": 100000000 },
+        "maxOutputTokens": { "type": "integer", "minimum": 1, "maximum": 100000000 }
+      }
+    }
+  }
+}

package/schemas/piagent-webui/queue-v1.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/queue-v1.schema.json",
+  "title": "Piagent WebUI held message queue projection v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "revision", "state", "heldCount", "quarantinedCount", "items", "reasonCode"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-queue-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "#/$defs/identity" },
+    "revision": { "$ref": "common-v1.schema.json#/$defs/domainRevision" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "heldCount": { "$ref": "#/$defs/count" },
+    "quarantinedCount": { "$ref": "#/$defs/count" },
+    "items": {
+      "type": "array",
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/item" }
+    },
+    "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": { "properties": { "reasonCode": { "type": "null" } } }
+    },
+    {
+      "if": { "properties": { "state": { "const": "unavailable" } }, "required": ["state"] },
+      "then": {
+        "properties": {
+          "heldCount": { "const": 0 },
+          "quarantinedCount": { "const": 0 },
+          "items": { "type": "array", "maxItems": 0 },
+          "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "count": { "type": "integer", "minimum": 0, "maximum": 100 },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectRef", "runtimeInstanceId", "sessionRef", "taskId", "taskRunId", "agentOperationId", "toolCallId"],
+      "properties": {
+        "projectRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "runtimeInstanceId": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "taskId": { "$ref": "common-v1.schema.json#/$defs/nullablePublicId" },
+        "taskRunId": { "$ref": "common-v1.schema.json#/$defs/nullablePublicId" },
+        "agentOperationId": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "toolCallId": { "type": "null" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "taskRunId": { "type": "string" } }, "required": ["taskRunId"] },
+          "then": { "properties": { "taskId": { "$ref": "common-v1.schema.json#/$defs/publicId" } } }
+        }
+      ]
+    },
+    "previewText": {
+      "type": "string",
+      "maxLength": 4000,
+      "pattern": "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]*$"
+    },
+    "item": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["queueItemRef", "messageRequestId", "position", "state", "preview", "redacted", "truncated", "attachmentCount", "previewDigest", "createdAt", "updatedAt", "reasonCode"],
+      "properties": {
+        "queueItemRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "messageRequestId": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "position": { "type": "integer", "minimum": 0, "maximum": 99 },
+        "state": { "enum": ["held", "quarantined"] },
+        "preview": { "$ref": "#/$defs/previewText" },
+        "redacted": { "type": "boolean" },
+        "truncated": { "type": "boolean" },
+        "attachmentCount": { "type": "integer", "minimum": 0, "maximum": 16 },
+        "previewDigest": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "createdAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "updatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "const": "held" } }, "required": ["state"] },
+          "then": { "properties": { "reasonCode": { "type": "null" } } }
+        },
+        {
+          "if": { "properties": { "state": { "const": "quarantined" } }, "required": ["state"] },
+          "then": { "properties": { "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" } } }
+        }
+      ]
+    }
+  }
+}

package/schemas/piagent-webui/recovery-history-v1.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/recovery-history-v1.schema.json",
+  "title": "Piagent WebUI bounded compaction and recovery history v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "runRef", "state", "historyRevision", "completeness", "summary", "recovery", "retainedContent", "events", "page", "warnings", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-recovery-history-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "runRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "historyRevision": { "$ref": "common-v1.schema.json#/$defs/nullableRevisionToken" },
+    "completeness": { "enum": ["complete", "partial", "missing", "unknown"] },
+    "summary": { "$ref": "#/$defs/summary" },
+    "recovery": { "$ref": "#/$defs/recovery" },
+    "retainedContent": { "$ref": "#/$defs/retainedContent" },
+    "events": { "type": "array", "maxItems": 300, "items": { "$ref": "#/$defs/event" } },
+    "page": { "$ref": "#/$defs/page" },
+    "warnings": { "type": "array", "maxItems": 8, "items": { "$ref": "#/$defs/warning" } },
+    "health": { "$ref": "common-v1.schema.json#/$defs/health" }
+  },
+  "allOf": [
+    { "properties": { "identity": { "type": "object", "properties": {
+      "taskId": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+      "taskRunId": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+      "agentOperationId": { "type": "null" },
+      "toolCallId": { "type": "null" }
+    } } } },
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": {
+        "properties": {
+          "historyRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+          "completeness": { "enum": ["complete", "partial", "missing"] },
+          "recovery": { "type": "object", "properties": {
+            "decision": { "enum": ["resume", "retry", "paused", "terminal", "blocked"] },
+            "enforcementSafe": { "type": "boolean" },
+            "verifierState": { "enum": ["current", "stale", "not-current"] },
+            "invalidatedFileCount": { "type": "integer", "minimum": 0, "maximum": 100000 },
+            "handoffState": { "enum": ["none", "available", "invalid"] }
+          } },
+          "health": { "type": "object", "properties": { "state": { "enum": ["ok", "degraded"] } } }
+        }
+      },
+      "else": {
+        "properties": {
+          "historyRevision": { "type": "null" },
+          "completeness": { "const": "unknown" },
+          "summary": { "type": "object", "properties": { "contextCompactions": { "const": 0 }, "toolResultCompactions": { "const": 0 }, "compactedToolResults": { "const": 0 } } },
+          "recovery": { "type": "object", "properties": {
+            "decision": { "const": "unknown" }, "enforcementSafe": { "type": "null" }, "latestCheckpointRef": { "type": "null" },
+            "verifierState": { "const": "unknown" }, "invalidatedFileCount": { "type": "null" }, "invalidatedFilesKnown": { "const": false },
+            "handoffState": { "const": "unknown" }
+          } },
+          "events": { "type": "array", "maxItems": 0 },
+          "page": { "type": "object", "properties": { "total": { "const": 0 }, "returned": { "const": 0 }, "truncated": { "const": false } } },
+          "health": { "type": "object", "properties": { "state": { "enum": ["unavailable", "error"] } } }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "nullableCount": { "anyOf": [{ "type": "integer", "minimum": 0, "maximum": 1000000000 }, { "type": "null" }] },
+    "summary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contextCompactions", "toolResultCompactions", "compactedToolResults"],
+      "properties": {
+        "contextCompactions": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "toolResultCompactions": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "compactedToolResults": { "type": "integer", "minimum": 0, "maximum": 1000000000 }
+      }
+    },
+    "recovery": {
+      "type": "object", "additionalProperties": false,
+      "required": ["decision", "enforcementSafe", "latestCheckpointRef", "verifierState", "invalidatedFileCount", "invalidatedFilesKnown", "handoffState", "reasonCode"],
+      "properties": {
+        "decision": { "enum": ["resume", "retry", "paused", "terminal", "blocked", "unknown"] },
+        "enforcementSafe": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
+        "latestCheckpointRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "verifierState": { "enum": ["current", "stale", "not-current", "unknown"] },
+        "invalidatedFileCount": { "anyOf": [{ "type": "integer", "minimum": 0, "maximum": 100000 }, { "type": "null" }] },
+        "invalidatedFilesKnown": { "type": "boolean" },
+        "handoffState": { "enum": ["none", "available", "invalid", "unknown"] },
+        "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" }
+      }
+    },
+    "retainedContent": {
+      "type": "object", "additionalProperties": false,
+      "required": ["access", "exposed", "reasonCode"],
+      "properties": {
+        "access": { "const": "omitted" }, "exposed": { "const": false },
+        "reasonCode": { "const": "protected-runtime-evidence" }
+      }
+    },
+    "event": {
+      "type": "object", "additionalProperties": false,
+      "required": ["eventRef", "evidenceRef", "sequence", "recordedAt", "kind", "title", "detail", "toolName", "originalChars", "originalLines", "captureCount", "willRetry", "fromExtension"],
+      "properties": {
+        "eventRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "evidenceRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "sequence": { "type": "integer", "minimum": 1, "maximum": 2147483647 },
+        "recordedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "kind": { "enum": ["context-compaction", "tool-result-compaction"] },
+        "title": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "detail": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
+        "toolName": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
+        "originalChars": { "$ref": "#/$defs/nullableCount" },
+        "originalLines": { "$ref": "#/$defs/nullableCount" },
+        "captureCount": { "$ref": "#/$defs/nullableCount" },
+        "willRetry": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] },
+        "fromExtension": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
+      },
+      "allOf": [
+        { "if": { "properties": { "kind": { "const": "context-compaction" } }, "required": ["kind"] }, "then": { "properties": {
+          "toolName": { "type": "null" }, "originalChars": { "type": "null" }, "originalLines": { "type": "null" }, "captureCount": { "type": "null" },
+          "willRetry": { "type": "boolean" }, "fromExtension": { "type": "boolean" }
+        } } },
+        { "if": { "properties": { "kind": { "const": "tool-result-compaction" } }, "required": ["kind"] }, "then": { "properties": {
+          "toolName": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }, "captureCount": { "type": "integer", "minimum": 1, "maximum": 10000 },
+          "willRetry": { "type": "null" }, "fromExtension": { "type": "null" }
+        } } }
+      ]
+    },
+    "page": {
+      "type": "object", "additionalProperties": false, "required": ["total", "returned", "truncated"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "returned": { "type": "integer", "minimum": 0, "maximum": 300 },
+        "truncated": { "type": "boolean" }
+      }
+    },
+    "warning": {
+      "type": "object", "additionalProperties": false, "required": ["code", "count", "message"],
+      "properties": {
+        "code": { "enum": ["telemetry-missing", "telemetry-corrupt", "telemetry-incomplete-tail", "telemetry-input-truncated", "history-truncated"] },
+        "count": { "type": "integer", "minimum": 1, "maximum": 1000000000 },
+        "message": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }
+      }
+    }
+  }
+}

package/schemas/piagent-webui/release-monitor-v1.schema.json

@@ -0,0 +1,173 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/release-monitor-v1.schema.json",
+  "title": "Piagent WebUI bounded benchmark and release monitor v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "state", "monitorRevision", "benchmark", "release", "actions", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-release-monitor-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "monitorRevision": { "$ref": "common-v1.schema.json#/$defs/nullableRevisionToken" },
+    "benchmark": { "$ref": "#/$defs/benchmark" },
+    "release": { "$ref": "#/$defs/release" },
+    "actions": { "$ref": "#/$defs/actions" },
+    "health": { "$ref": "common-v1.schema.json#/$defs/health" }
+  },
+  "allOf": [
+    {
+      "properties": {
+        "identity": { "type": "object", "properties": { "agentOperationId": { "type": "null" }, "toolCallId": { "type": "null" } } }
+      }
+    },
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": {
+        "properties": {
+          "monitorRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+          "health": { "type": "object", "properties": { "state": { "enum": ["ok", "degraded"] } } }
+        }
+      },
+      "else": {
+        "properties": {
+          "monitorRevision": { "type": "null" },
+          "benchmark": {
+            "type": "object",
+            "properties": {
+              "state": { "const": "unavailable" },
+              "runs": { "type": "array", "maxItems": 0 },
+              "warnings": { "type": "array", "maxItems": 0 },
+              "page": { "type": "object", "properties": { "total": { "const": 0 }, "returned": { "const": 0 }, "truncated": { "const": false } } }
+            }
+          },
+          "release": { "type": "object", "properties": { "state": { "const": "unavailable" } } },
+          "health": { "type": "object", "properties": { "state": { "const": "error" } } }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "benchmark": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "runs", "warnings", "page"],
+      "properties": {
+        "state": { "enum": ["ready", "missing", "unavailable"] },
+        "runs": { "type": "array", "maxItems": 20, "items": { "$ref": "#/$defs/run" } },
+        "warnings": { "type": "array", "maxItems": 8, "items": { "$ref": "#/$defs/warning" } },
+        "page": { "$ref": "#/$defs/page" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+          "then": { "properties": { "runs": { "type": "array", "minItems": 1 } } },
+          "else": { "properties": { "runs": { "type": "array", "maxItems": 0 } } }
+        }
+      ]
+    },
+    "run": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runRef", "suiteId", "lifecycle", "evidenceState", "sourceState", "startedAt", "updatedAt", "completedRuns", "expectedRuns", "verdict", "releaseGate", "tokenClaimAllowed", "claimTier", "scores"],
+      "properties": {
+        "runRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "suiteId": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "lifecycle": { "enum": ["completed", "paused", "interrupted", "stopped", "aborted", "in-progress", "incomplete"] },
+        "evidenceState": { "enum": ["complete", "partial"] },
+        "sourceState": { "enum": ["current", "stale"] },
+        "startedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "updatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "completedRuns": { "type": "integer", "minimum": 0, "maximum": 1000 },
+        "expectedRuns": { "type": "integer", "minimum": 0, "maximum": 1000 },
+        "verdict": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
+        "releaseGate": { "enum": ["passed", "failed", "not-applicable", "unknown"] },
+        "tokenClaimAllowed": { "type": ["boolean", "null"] },
+        "claimTier": { "enum": ["smoke", "public-regression", "capability", "private-holdout", "production-shadow", "unknown"] },
+        "scores": { "$ref": "#/$defs/scores" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "lifecycle": { "const": "completed" } }, "required": ["lifecycle"] },
+          "then": { "properties": { "evidenceState": { "const": "complete" }, "releaseGate": { "enum": ["passed", "failed", "not-applicable"] } } },
+          "else": { "properties": { "evidenceState": { "const": "partial" }, "verdict": { "type": "null" }, "releaseGate": { "const": "unknown" }, "tokenClaimAllowed": { "type": "null" }, "claimTier": { "const": "unknown" } } }
+        }
+      ]
+    },
+    "scores": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["quality", "safety", "reliability", "workflow", "efficiency", "overall"],
+      "properties": {
+        "quality": { "$ref": "#/$defs/nullableScore" },
+        "safety": { "$ref": "#/$defs/nullableScore" },
+        "reliability": { "$ref": "#/$defs/nullableScore" },
+        "workflow": { "$ref": "#/$defs/nullableScore" },
+        "efficiency": { "$ref": "#/$defs/nullableScore" },
+        "overall": { "$ref": "#/$defs/nullableScore" }
+      }
+    },
+    "nullableScore": { "type": ["number", "null"], "minimum": 0, "maximum": 10 },
+    "warning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "count", "message"],
+      "properties": {
+        "code": { "enum": ["benchmark-evidence-corrupt", "benchmark-directory-truncated"] },
+        "count": { "type": "integer", "minimum": 1, "maximum": 1000000 },
+        "message": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }
+      }
+    },
+    "page": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total", "returned", "truncated"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0, "maximum": 1000000 },
+        "returned": { "type": "integer", "minimum": 0, "maximum": 20 },
+        "truncated": { "type": "boolean" }
+      }
+    },
+    "release": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "reportRef", "generatedAt", "sourceState", "localSafeGate", "rcAssembly", "beta", "gaRelease", "blockerCount", "blockers", "authorization"],
+      "properties": {
+        "state": { "enum": ["ready", "stale", "missing", "unavailable"] },
+        "reportRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "generatedAt": { "anyOf": [{ "$ref": "common-v1.schema.json#/$defs/timestamp" }, { "type": "null" }] },
+        "sourceState": { "enum": ["current", "stale", "unknown"] },
+        "localSafeGate": { "enum": ["passed", "failed", "unknown"] },
+        "rcAssembly": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "beta": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "gaRelease": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "blockerCount": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "blockers": { "type": "array", "maxItems": 8, "items": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" } },
+        "authorization": { "$ref": "#/$defs/releaseAuthorization" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "enum": ["ready", "stale"] } }, "required": ["state"] },
+          "then": { "properties": { "reportRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }, "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" }, "sourceState": { "enum": ["current", "stale"] } } },
+          "else": { "properties": { "reportRef": { "type": "null" }, "generatedAt": { "type": "null" }, "sourceState": { "const": "unknown" }, "localSafeGate": { "const": "unknown" }, "rcAssembly": { "const": "unknown" }, "beta": { "const": "unknown" }, "gaRelease": { "const": "unknown" }, "blockerCount": { "const": 0 }, "blockers": { "type": "array", "maxItems": 0 } } }
+        },
+        { "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] }, "then": { "properties": { "sourceState": { "const": "current" } } } },
+        { "if": { "properties": { "state": { "const": "stale" } }, "required": ["state"] }, "then": { "properties": { "sourceState": { "const": "stale" } } } }
+      ]
+    },
+    "releaseAuthorization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["releaseCommit", "tag", "publish", "push"],
+      "properties": { "releaseCommit": { "const": false }, "tag": { "const": false }, "publish": { "const": false }, "push": { "const": false } }
+    },
+    "actions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runBenchmark", "resumeBenchmark", "releaseCommit", "tag", "publish", "push"],
+      "properties": { "runBenchmark": { "const": false }, "resumeBenchmark": { "const": false }, "releaseCommit": { "const": false }, "tag": { "const": false }, "publish": { "const": false }, "push": { "const": false } }
+    }
+  }
+}