@piagent/platform 1.3.1 → 1.4.0

package/schemas/piagent-webui/source-mutation-v1.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/source-mutation-v1.schema.json",
+  "title": "Piagent WebUI guarded selected-file source mutation preview v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "action", "state", "target", "reasonCode", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-source-mutation-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "action": { "enum": ["source.stage", "source.unstage"] },
+    "state": { "enum": ["ready", "unavailable"] },
+    "target": {
+      "anyOf": [
+        { "$ref": "#/$defs/mutationTarget" },
+        { "type": "null" }
+      ]
+    },
+    "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" },
+    "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": {
+          "target": { "$ref": "#/$defs/mutationTarget" },
+          "reasonCode": { "type": "null" },
+          "health": { "type": "object", "properties": { "state": { "const": "ok" } } }
+        }
+      },
+      "else": {
+        "properties": {
+          "target": { "type": "null" },
+          "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" },
+          "health": { "type": "object", "properties": { "state": { "enum": ["unavailable", "error"] } } }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "action": { "const": "source.stage" } }, "required": ["action"] },
+      "then": { "properties": { "target": { "type": "object", "properties": { "view": { "const": "working-tree" }, "effect": { "const": "copy-worktree-to-index" } } } } }
+    },
+    {
+      "if": { "properties": { "action": { "const": "source.unstage" } }, "required": ["action"] },
+      "then": { "properties": { "target": { "type": "object", "properties": { "view": { "const": "staged" }, "effect": { "const": "restore-index-from-head" } } } } }
+    }
+  ],
+  "$defs": {
+    "mutationTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["view", "repoRef", "fileRef", "diffRef", "status", "path", "oldPath", "effect", "taskRevision", "workspaceRevision", "indexRevision", "viewRevision", "fileRevision", "workspacePreimage", "indexPreimage", "patchPreimage", "contentDigest", "hunkRefs"],
+      "properties": {
+        "view": { "enum": ["working-tree", "staged"] },
+        "repoRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "fileRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "diffRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "status": { "enum": ["A", "M", "D", "R", "U"] },
+        "path": { "$ref": "common-v1.schema.json#/$defs/safeDisplayPath" },
+        "oldPath": { "$ref": "common-v1.schema.json#/$defs/nullableSafeDisplayPath" },
+        "effect": { "enum": ["copy-worktree-to-index", "restore-index-from-head"] },
+        "taskRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "workspaceRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "indexRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "viewRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "fileRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "workspacePreimage": { "$ref": "common-v1.schema.json#/$defs/workingTreeDigest" },
+        "indexPreimage": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "patchPreimage": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "contentDigest": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "hunkRefs": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }
+        }
+      }
+    }
+  }
+}

package/schemas/piagent-webui/source-revert-v1.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/source-revert-v1.schema.json",
+  "title": "Piagent WebUI confirmed exact source revert preview v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "action", "state", "target", "preview", "reasonCode", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-source-revert-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "action": { "const": "source.revert" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "target": { "anyOf": [{ "$ref": "#/$defs/revertTarget" }, { "type": "null" }] },
+    "preview": { "anyOf": [{ "$ref": "#/$defs/revertPreview" }, { "type": "null" }] },
+    "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" },
+    "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": {
+          "target": { "$ref": "#/$defs/revertTarget" },
+          "preview": { "$ref": "#/$defs/revertPreview" },
+          "reasonCode": { "type": "null" },
+          "health": { "type": "object", "properties": { "state": { "const": "ok" } } }
+        }
+      },
+      "else": {
+        "properties": {
+          "target": { "type": "null" },
+          "preview": { "type": "null" },
+          "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" },
+          "health": { "type": "object", "properties": { "state": { "enum": ["unavailable", "error"] } } }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "revertPreview": {
+      "type": "object", "additionalProperties": false,
+      "required": ["basis", "hunks", "truncated"],
+      "properties": {
+        "basis": { "const": "index-to-working-tree" },
+        "hunks": {
+          "type": "array", "minItems": 1, "maxItems": 128,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["hunkRef", "header", "lines"],
+            "properties": {
+              "hunkRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+              "header": { "type": "string", "minLength": 1, "maxLength": 1024 },
+              "lines": {
+                "type": "array", "maxItems": 5000,
+                "items": {
+                  "type": "object", "additionalProperties": false,
+                  "required": ["kind", "marker", "text"],
+                  "properties": {
+                    "kind": { "enum": ["added", "deleted", "context", "meta"] },
+                    "marker": { "enum": ["+", "-", " ", "\\"] },
+                    "text": { "type": "string", "maxLength": 16384 }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "truncated": { "const": false }
+      }
+    },
+    "revertTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["view", "repoRef", "fileRef", "diffRef", "status", "path", "oldPath", "effect", "taskRevision", "workspaceRevision", "indexRevision", "viewRevision", "fileRevision", "workspacePreimage", "indexPreimage", "patchPreimage", "contentDigest", "hunkRefs", "previewRef", "confirmedPreviewDigest", "expiresAt", "summary"],
+      "properties": {
+        "view": { "const": "working-tree" },
+        "repoRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "fileRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "diffRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "status": { "const": "M" },
+        "path": { "$ref": "common-v1.schema.json#/$defs/safeDisplayPath" },
+        "oldPath": { "type": "null" },
+        "effect": { "const": "restore-worktree-from-index" },
+        "taskRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "workspaceRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "indexRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "viewRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "fileRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "workspacePreimage": { "$ref": "common-v1.schema.json#/$defs/workingTreeDigest" },
+        "indexPreimage": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "patchPreimage": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "contentDigest": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "hunkRefs": {
+          "type": "array", "maxItems": 1, "uniqueItems": true,
+          "items": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }
+        },
+        "previewRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "confirmedPreviewDigest": { "$ref": "common-v1.schema.json#/$defs/digest" },
+        "expiresAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "summary": {
+          "type": "object", "additionalProperties": false,
+          "required": ["files", "hunks", "additionsDiscarded", "deletionsRestored", "effect", "recovery"],
+          "properties": {
+            "files": { "const": 1 },
+            "hunks": { "type": "integer", "minimum": 1, "maximum": 128 },
+            "additionsDiscarded": { "type": "integer", "minimum": 0, "maximum": 65536 },
+            "deletionsRestored": { "type": "integer", "minimum": 0, "maximum": 65536 },
+            "effect": { "const": "discard-unstaged-keep-index" },
+            "recovery": { "const": "not-guaranteed" }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/piagent-webui/subagent-tree-v1.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/subagent-tree-v1.schema.json",
+  "title": "Piagent WebUI bounded subagent ownership tree v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "runRef", "state", "treeRevision", "evidenceState", "orchestration", "parent", "children", "writer", "nestedLineage", "summary", "warnings", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-subagent-tree-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"] },
+    "treeRevision": { "$ref": "common-v1.schema.json#/$defs/nullableRevisionToken" },
+    "evidenceState": { "enum": ["complete", "partial", "aggregate-only", "missing", "unknown"] },
+    "orchestration": { "$ref": "#/$defs/orchestration" },
+    "parent": { "anyOf": [{ "$ref": "#/$defs/parent" }, { "type": "null" }] },
+    "children": { "type": "array", "maxItems": 64, "items": { "$ref": "#/$defs/child" } },
+    "writer": { "$ref": "#/$defs/writer" },
+    "nestedLineage": { "$ref": "#/$defs/nestedLineage" },
+    "summary": { "$ref": "#/$defs/summary" },
+    "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": {
+        "treeRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "evidenceState": { "enum": ["complete", "partial", "aggregate-only", "missing"] },
+        "parent": { "$ref": "#/$defs/parent" },
+        "health": { "type": "object", "properties": { "state": { "enum": ["ok", "degraded"] } } }
+      } },
+      "else": { "properties": {
+        "treeRevision": { "type": "null" }, "evidenceState": { "const": "unknown" }, "parent": { "type": "null" },
+        "children": { "type": "array", "maxItems": 0 },
+        "writer": { "type": "object", "properties": { "state": { "const": "unknown" }, "ownerNodeRef": { "type": "null" } } },
+        "summary": { "type": "object", "properties": { "total": { "const": 0 }, "active": { "const": 0 }, "completed": { "const": 0 }, "staleResults": { "const": 0 }, "readOnly": { "const": 0 }, "singleWriter": { "const": 0 } } },
+        "warnings": { "type": "array", "maxItems": 0 },
+        "health": { "type": "object", "properties": { "state": { "enum": ["unavailable", "error"] } } }
+      } }
+    }
+  ],
+  "$defs": {
+    "orchestration": { "type": "object", "additionalProperties": false, "required": ["mode", "subagents"], "properties": {
+      "mode": { "enum": ["solo-first", "bounded-subagents", "parallel-readonly", "unknown"] },
+      "subagents": { "enum": ["not-used", "optional", "used", "unknown"] }
+    } },
+    "parent": { "type": "object", "additionalProperties": false, "required": ["nodeRef", "lifecycleState", "budgetTerminal", "mergeOwner"], "properties": {
+      "nodeRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }, "lifecycleState": { "enum": ["active", "terminal", "unknown"] },
+      "budgetTerminal": { "type": ["boolean", "null"] }, "mergeOwner": { "const": "parent" }
+    } },
+    "child": { "type": "object", "additionalProperties": false, "required": ["nodeRef", "parentRef", "role", "authority", "lifecycleState", "reservedAt", "expiresAt", "completedAt", "currentWriter", "result"], "properties": {
+      "nodeRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" }, "parentRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+      "role": { "enum": ["retriever", "scout", "planner", "worker", "reviewer", "oracle", "researcher"] },
+      "authority": { "enum": ["read-only", "single-writer"] }, "lifecycleState": { "enum": ["active", "succeeded", "failed", "cancelled", "orphaned"] },
+      "reservedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" }, "expiresAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+      "completedAt": { "anyOf": [{ "$ref": "common-v1.schema.json#/$defs/timestamp" }, { "type": "null" }] }, "currentWriter": { "type": "boolean" },
+      "result": { "$ref": "#/$defs/result" }
+    } },
+    "result": { "type": "object", "additionalProperties": false, "required": ["state", "disposition", "calls", "tokens"], "properties": {
+      "state": { "enum": ["accepted", "rejected", "stale-result", "not-recorded"] },
+      "disposition": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
+      "calls": { "type": ["integer", "null"], "minimum": 0, "maximum": 101 },
+      "tokens": { "type": ["integer", "null"], "minimum": 0, "maximum": 100001 }
+    } },
+    "writer": { "type": "object", "additionalProperties": false, "required": ["state", "ownerNodeRef"], "properties": {
+      "state": { "enum": ["parent", "helper", "unknown"] }, "ownerNodeRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" }
+    } },
+    "nestedLineage": { "type": "object", "additionalProperties": false, "required": ["state", "reasonCode"], "properties": {
+      "state": { "const": "unavailable" }, "reasonCode": { "const": "no-durable-nested-lineage" }
+    } },
+    "summary": { "type": "object", "additionalProperties": false, "required": ["total", "active", "completed", "staleResults", "readOnly", "singleWriter"], "properties": {
+      "total": { "type": "integer", "minimum": 0, "maximum": 64 }, "active": { "type": "integer", "minimum": 0, "maximum": 64 },
+      "completed": { "type": "integer", "minimum": 0, "maximum": 64 }, "staleResults": { "type": "integer", "minimum": 0, "maximum": 64 },
+      "readOnly": { "type": "integer", "minimum": 0, "maximum": 64 }, "singleWriter": { "type": "integer", "minimum": 0, "maximum": 64 }
+    } },
+    "warning": { "type": "object", "additionalProperties": false, "required": ["code", "count", "message"], "properties": {
+      "code": { "enum": ["helper-budget-missing", "expired-helper-derived-orphan", "helper-receipt-unmatched"] },
+      "count": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "message": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" }
+    } }
+  }
+}

package/schemas/piagent-webui/task-index-v1.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/task-index-v1.schema.json",
+  "title": "Piagent WebUI authoritative local task run index v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "state", "indexRevision", "activeRunRef", "runs", "page", "warnings", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-task-index-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "common-v1.schema.json#/$defs/identity" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "indexRevision": { "$ref": "common-v1.schema.json#/$defs/nullableRevisionToken" },
+    "activeRunRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+    "runs": { "type": "array", "maxItems": 200, "items": { "$ref": "#/$defs/run" } },
+    "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": { "agentOperationId": { "type": "null" }, "toolCallId": { "type": "null" } } } }
+    },
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": { "properties": { "indexRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" },
+        "health": { "type": "object", "properties": { "state": { "enum": ["ok", "degraded"] } } } } },
+      "else": { "properties": { "indexRevision": { "type": "null" }, "activeRunRef": { "type": "null" }, "runs": { "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": {
+    "run": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runRef", "taskRef", "taskId", "taskRunId", "summary", "sessionLabel", "outcome", "terminal", "attempt", "maxAttempts", "changeMode", "riskLane", "createdAt", "updatedAt", "isCurrentSession", "isActive", "progress"],
+      "properties": {
+        "runRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "taskRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "taskId": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+        "taskRunId": { "$ref": "common-v1.schema.json#/$defs/publicId" },
+        "summary": { "type": "string", "maxLength": 240, "pattern": "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]*$" },
+        "sessionLabel": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
+        "outcome": { "enum": ["pending", "completed", "blocked", "partial", "failed", "unknown"] },
+        "terminal": { "type": "boolean" },
+        "attempt": { "type": "integer", "minimum": 1, "maximum": 100 },
+        "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "changeMode": { "enum": ["read-only", "source-change"] },
+        "riskLane": { "enum": ["tiny", "normal", "high-risk"] },
+        "createdAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "updatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "isCurrentSession": { "type": "boolean" },
+        "isActive": { "type": "boolean" },
+        "progress": { "type": "object", "additionalProperties": false, "required": ["completed", "total"],
+          "properties": { "completed": { "type": "integer", "minimum": 0, "maximum": 12 }, "total": { "type": "integer", "minimum": 0, "maximum": 12 } } }
+      },
+      "allOf": [
+        { "if": { "properties": { "outcome": { "const": "pending" } }, "required": ["outcome"] }, "then": { "properties": { "terminal": { "const": false } } }, "else": { "properties": { "terminal": { "const": true } } } },
+        { "if": { "properties": { "isActive": { "const": true } }, "required": ["isActive"] }, "then": { "properties": { "isCurrentSession": { "const": true }, "outcome": { "const": "pending" }, "terminal": { "const": false } } } }
+      ]
+    },
+    "page": {
+      "type": "object", "additionalProperties": false, "required": ["total", "returned", "truncated"],
+      "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 100000 }, "returned": { "type": "integer", "minimum": 0, "maximum": 200 }, "truncated": { "type": "boolean" } }
+    },
+    "warning": {
+      "type": "object", "additionalProperties": false, "required": ["code", "count", "message"],
+      "properties": { "code": { "enum": ["corrupt-task-state", "legacy-task-state", "task-index-truncated"] },
+        "count": { "type": "integer", "minimum": 1, "maximum": 100000 }, "message": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" } }
+    }
+  }
+}

package/schemas/piagent-webui/task-timeline-v1.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/task-timeline-v1.schema.json",
+  "title": "Piagent WebUI durable task recovery timeline v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "version", "generatedAt", "identity", "runRef", "state", "timelineRevision", "continuity", "events", "page", "warnings", "health"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-task-timeline-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"] },
+    "timelineRevision": { "$ref": "common-v1.schema.json#/$defs/nullableRevisionToken" },
+    "continuity": { "$ref": "#/$defs/continuity" },
+    "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": { "timelineRevision": { "$ref": "common-v1.schema.json#/$defs/revisionToken" }, "health": { "type": "object", "properties": { "state": { "enum": ["ok", "degraded"] } } } } },
+      "else": { "properties": { "timelineRevision": { "type": "null" }, "events": { "type": "array", "maxItems": 0 },
+        "continuity": { "type": "object", "properties": { "crashEvidence": { "const": "unknown" }, "recoveryDecision": { "const": "unknown" }, "latestCheckpointRef": { "type": "null" }, "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" } } },
+        "page": { "type": "object", "properties": { "total": { "const": 0 }, "returned": { "const": 0 }, "truncated": { "const": false } } },
+        "health": { "type": "object", "properties": { "state": { "enum": ["unavailable", "error"] } } } } }
+    }
+  ],
+  "$defs": {
+    "continuity": { "type": "object", "additionalProperties": false, "required": ["crashEvidence", "recoveryDecision", "latestCheckpointRef", "reasonCode"],
+      "properties": { "crashEvidence": { "enum": ["possible-interruption", "unknown"] }, "recoveryDecision": { "enum": ["resume", "retry", "paused", "terminal", "blocked", "unknown"] },
+        "latestCheckpointRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" }, "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" } } },
+    "event": { "type": "object", "additionalProperties": false, "required": ["eventRef", "evidenceRef", "sequence", "recordedAt", "kind", "state", "title", "detail", "checkpointRef"],
+      "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": ["task-written", "session-bound", "checkpoint", "pause-requested", "paused", "pause-cancelled", "resume-requested", "resumed", "resume-rejected", "stop-requested", "stop-settled", "continuation", "digest-migrated"] },
+        "state": { "enum": ["observed", "requested", "settled", "failed", "unknown"] }, "title": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" },
+        "detail": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" }, "checkpointRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" } } },
+    "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": ["journal-corrupt", "recoverable-tail", "timeline-truncated", "journal-input-truncated", "crash-not-observed"] }, "count": { "type": "integer", "minimum": 1, "maximum": 100000 },
+      "message": { "$ref": "common-v1.schema.json#/$defs/nonEmptyDisplayText" } } }
+  }
+}