@piagent/platform 1.3.1 → 1.4.0

package/evals/fixtures/piagent-webui/gateway-capabilities-v1.valid.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-gateway-capabilities-v1",
+  "generatedAt": "2026-08-14T04:30:00.000Z",
+  "gatewayInstanceRef": "gateway_01",
+  "protocol": {
+    "minimum": 1,
+    "maximum": 1,
+    "selected": 1,
+    "compatibility": "ready"
+  },
+  "mode": "full",
+  "capabilities": {
+    "catalog": { "status": "available", "version": 1, "reasonCode": null },
+    "events": { "status": "available", "version": 1, "reasonCode": null },
+    "terminalAdapter": { "status": "available", "version": 1, "reasonCode": null },
+    "sessionRuntime": { "status": "available", "version": 1, "reasonCode": null },
+    "sessionActions": {
+      "create": { "status": "available", "version": 1, "reasonCode": null },
+      "send": { "status": "available", "version": 1, "reasonCode": null },
+      "abort": { "status": "available", "version": 1, "reasonCode": null },
+      "setModel": { "status": "available", "version": 1, "reasonCode": null },
+      "setThinking": { "status": "available", "version": 1, "reasonCode": null },
+      "setPermission": { "status": "available", "version": 1, "reasonCode": null },
+      "rename": { "status": "available", "version": 1, "reasonCode": null },
+      "pin": { "status": "available", "version": 1, "reasonCode": null },
+      "archive": { "status": "available", "version": 1, "reasonCode": null },
+      "unarchive": { "status": "available", "version": 1, "reasonCode": null },
+      "fork": { "status": "available", "version": 1, "reasonCode": null },
+      "acquire": { "status": "available", "version": 1, "reasonCode": null },
+      "release": { "status": "available", "version": 1, "reasonCode": null }
+    }
+  },
+  "reasonCode": null
+}

package/evals/fixtures/piagent-webui/gateway-protocol-v1.invalid.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-gateway-protocol-v1",
+  "messageType": "request",
+  "requestId": "request_abcdefgh01",
+  "method": "sessions.get",
+  "params": {
+    "cursor": null,
+    "limit": 50,
+    "filter": "active",
+    "query": null,
+    "projectRef": null
+  }
+}

package/evals/fixtures/piagent-webui/gateway-protocol-v1.valid.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-gateway-protocol-v1",
+  "messageType": "request",
+  "requestId": "request_abcdefgh01",
+  "method": "sessions.list",
+  "params": {
+    "cursor": null,
+    "limit": 50,
+    "filter": "active",
+    "query": null,
+    "projectRef": null
+  }
+}

package/evals/fixtures/piagent-webui/handoff-history-v1.invalid.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-handoff-history-v1",
+  "generatedAt": "2026-08-14T13:00:00.000Z",
+  "identity": { "projectRef": "project.fixture", "runtimeInstanceId": "runtime.fixture", "sessionRef": "session.fixture", "taskId": "task-active", "taskRunId": "task-active-run", "agentOperationId": null, "toolCallId": null },
+  "runRef": "run.fixture",
+  "state": "ready",
+  "historyRevision": "handoff-history.fixture",
+  "completeness": "complete",
+  "current": null,
+  "nextAction": { "action": "unknown", "stepRef": null, "reason": "Click to continue.", "exactCommandCount": 0, "dispatchable": true, "enforcementSafe": false },
+  "events": [],
+  "page": { "total": 0, "returned": 0, "truncated": false },
+  "warnings": [],
+  "health": { "state": "ok", "reasonCode": null, "message": null }
+}

package/evals/fixtures/piagent-webui/handoff-history-v1.valid.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-handoff-history-v1",
+  "generatedAt": "2026-08-14T13:00:00.000Z",
+  "identity": { "projectRef": "project.fixture", "runtimeInstanceId": "runtime.fixture", "sessionRef": "session.fixture", "taskId": "task-active", "taskRunId": "task-active-run", "agentOperationId": null, "toolCallId": null },
+  "runRef": "run.fixture",
+  "state": "ready",
+  "historyRevision": "handoff-history.fixture",
+  "completeness": "complete",
+  "current": { "handoffRef": "handoff.fixture", "generatedAt": "2026-08-14T12:30:00.000Z", "phase": "handoff", "taskOutcome": "pending", "gateDecision": "fail", "completionApproved": false, "requiredAuthority": "operator", "treeEvidenceCurrent": true, "latestVerifierMatchesCurrentTree": true, "changedFileCount": 2, "missingCount": 1, "projectedAction": "ask-operator" },
+  "nextAction": { "action": "inspect-handoff", "stepRef": null, "reason": "Review the latest handoff before continuing.", "exactCommandCount": 0, "dispatchable": false, "enforcementSafe": true },
+  "events": [{ "eventRef": "handoff-event.fixture", "evidenceRef": "telemetry.fixture", "sequence": 1, "recordedAt": "2026-08-14T12:30:00.000Z", "phase": "handoff", "completionApproved": false, "projectedAction": "ask-operator" }],
+  "page": { "total": 1, "returned": 1, "truncated": false },
+  "warnings": [],
+  "health": { "state": "ok", "reasonCode": null, "message": null }
+}

package/evals/fixtures/piagent-webui/model-catalog-v1.invalid.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-model-catalog-v1",
+  "generatedAt": "2026-08-13T15:00:00.000Z",
+  "identity": {
+    "projectRef": "project_01",
+    "runtimeInstanceId": "runtime_01",
+    "sessionRef": "session_01",
+    "taskId": null,
+    "taskRunId": null,
+    "agentOperationId": null,
+    "toolCallId": null
+  },
+  "revision": {
+    "runtimeRevision": "runtime_rev_01",
+    "taskRevision": null,
+    "controlRevision": null,
+    "workspaceRevision": null,
+    "indexRevision": null,
+    "approvalRevision": null,
+    "sessionOptionRevision": null,
+    "queueRevision": "queue_rev_01"
+  },
+  "state": "unavailable",
+  "catalogScope": "authenticated-all",
+  "effectScope": "session-and-user-default",
+  "activeModelRef": "model_01",
+  "activeThinkingLevel": "ultra",
+  "models": [{ "provider": "secret", "apiKey": "raw-secret" }],
+  "reasonCode": null
+}

package/evals/fixtures/piagent-webui/model-catalog-v1.valid.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-model-catalog-v1",
+  "generatedAt": "2026-08-13T15:00:00.000Z",
+  "identity": {
+    "projectRef": "project_01",
+    "runtimeInstanceId": "runtime_01",
+    "sessionRef": "session_01",
+    "taskId": null,
+    "taskRunId": null,
+    "agentOperationId": null,
+    "toolCallId": null
+  },
+  "revision": {
+    "runtimeRevision": "runtime_rev_01",
+    "taskRevision": null,
+    "controlRevision": null,
+    "workspaceRevision": null,
+    "indexRevision": null,
+    "approvalRevision": null,
+    "sessionOptionRevision": "session_option_rev_01",
+    "queueRevision": "queue_rev_01"
+  },
+  "state": "ready",
+  "catalogScope": "authenticated-all",
+  "effectScope": "session-and-user-default",
+  "activeModelRef": "model_01",
+  "activeThinkingLevel": "high",
+  "models": [
+    {
+      "modelRef": "model_01",
+      "provider": "provider-01",
+      "modelId": "model-01",
+      "displayName": "Model 01",
+      "reasoning": true,
+      "inputCapabilities": ["text", "image"],
+      "supportedThinkingLevels": ["off", "low", "medium", "high"],
+      "contextWindow": 200000,
+      "maxOutputTokens": 32000
+    }
+  ],
+  "reasonCode": null
+}

package/evals/fixtures/piagent-webui/queue-v1.invalid.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-queue-v1",
+  "generatedAt": "2026-08-13T14:00:00.000Z",
+  "identity": {
+    "projectRef": "project_01",
+    "runtimeInstanceId": "runtime_01",
+    "sessionRef": "session_01",
+    "taskId": null,
+    "taskRunId": null,
+    "agentOperationId": null,
+    "toolCallId": null
+  },
+  "revision": {
+    "runtimeRevision": "runtime_rev_01",
+    "taskRevision": null,
+    "controlRevision": null,
+    "workspaceRevision": null,
+    "indexRevision": null,
+    "approvalRevision": null,
+    "sessionOptionRevision": null,
+    "queueRevision": "queue_rev_01"
+  },
+  "state": "unavailable",
+  "heldCount": 1,
+  "quarantinedCount": 0,
+  "items": [{ "queueItemRef": "raw-secret", "exactText": "secret" }],
+  "reasonCode": null
+}

package/evals/fixtures/piagent-webui/queue-v1.valid.json

@@ -0,0 +1,44 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-queue-v1",
+  "generatedAt": "2026-08-13T14:00:00.000Z",
+  "identity": {
+    "projectRef": "project_01",
+    "runtimeInstanceId": "runtime_01",
+    "sessionRef": "session_01",
+    "taskId": null,
+    "taskRunId": null,
+    "agentOperationId": "operation_01",
+    "toolCallId": null
+  },
+  "revision": {
+    "runtimeRevision": "runtime_rev_01",
+    "taskRevision": null,
+    "controlRevision": null,
+    "workspaceRevision": null,
+    "indexRevision": null,
+    "approvalRevision": null,
+    "sessionOptionRevision": null,
+    "queueRevision": "queue_rev_01"
+  },
+  "state": "ready",
+  "heldCount": 1,
+  "quarantinedCount": 0,
+  "items": [
+    {
+      "queueItemRef": "queue_item_01",
+      "messageRequestId": "message_request_01",
+      "position": 0,
+      "state": "held",
+      "preview": "Continue after the current tool finishes.",
+      "redacted": false,
+      "truncated": false,
+      "attachmentCount": 0,
+      "previewDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "createdAt": "2026-08-13T13:59:00.000Z",
+      "updatedAt": "2026-08-13T13:59:00.000Z",
+      "reasonCode": null
+    }
+  ],
+  "reasonCode": null
+}

package/evals/fixtures/piagent-webui/recovery-history-v1.invalid.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-recovery-history-v1",
+  "generatedAt": "2026-08-14T12:00:00.000Z",
+  "identity": { "projectRef": "project.fixture", "runtimeInstanceId": "runtime.fixture", "sessionRef": "session.fixture", "taskId": "task-active", "taskRunId": "task-active-run", "agentOperationId": null, "toolCallId": null },
+  "runRef": "run.fixture",
+  "state": "ready",
+  "historyRevision": "recovery-history.fixture",
+  "completeness": "complete",
+  "summary": { "contextCompactions": 1, "toolResultCompactions": 0, "compactedToolResults": 0 },
+  "recovery": { "decision": "unknown", "enforcementSafe": null, "latestCheckpointRef": null, "verifierState": "unknown", "invalidatedFileCount": null, "invalidatedFilesKnown": false, "handoffState": "unknown", "reasonCode": "invented-recovery" },
+  "retainedContent": { "access": "available", "exposed": true, "reasonCode": "raw-capture" },
+  "events": [],
+  "page": { "total": 0, "returned": 0, "truncated": false },
+  "warnings": [],
+  "health": { "state": "ok", "reasonCode": null, "message": null }
+}

package/evals/fixtures/piagent-webui/recovery-history-v1.valid.json

@@ -0,0 +1,20 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-recovery-history-v1",
+  "generatedAt": "2026-08-14T12:00:00.000Z",
+  "identity": { "projectRef": "project.fixture", "runtimeInstanceId": "runtime.fixture", "sessionRef": "session.fixture", "taskId": "task-active", "taskRunId": "task-active-run", "agentOperationId": null, "toolCallId": null },
+  "runRef": "run.fixture",
+  "state": "ready",
+  "historyRevision": "recovery-history.fixture",
+  "completeness": "complete",
+  "summary": { "contextCompactions": 1, "toolResultCompactions": 1, "compactedToolResults": 2 },
+  "recovery": { "decision": "paused", "enforcementSafe": true, "latestCheckpointRef": "checkpoint.fixture", "verifierState": "stale", "invalidatedFileCount": 1, "invalidatedFilesKnown": true, "handoffState": "available", "reasonCode": "recovery-paused" },
+  "retainedContent": { "access": "omitted", "exposed": false, "reasonCode": "protected-runtime-evidence" },
+  "events": [
+    { "eventRef": "compaction.context", "evidenceRef": "telemetry.context", "sequence": 1, "recordedAt": "2026-08-14T10:00:00.000Z", "kind": "context-compaction", "title": "Context compacted", "detail": "threshold", "toolName": null, "originalChars": null, "originalLines": null, "captureCount": null, "willRetry": false, "fromExtension": false },
+    { "eventRef": "compaction.tool", "evidenceRef": "telemetry.tool", "sequence": 2, "recordedAt": "2026-08-14T10:01:00.000Z", "kind": "tool-result-compaction", "title": "Tool result compacted", "detail": null, "toolName": "bash", "originalChars": 120000, "originalLines": 3000, "captureCount": 2, "willRetry": null, "fromExtension": null }
+  ],
+  "page": { "total": 2, "returned": 2, "truncated": false },
+  "warnings": [],
+  "health": { "state": "ok", "reasonCode": null, "message": null }
+}

package/evals/fixtures/piagent-webui/release-monitor-v1.invalid.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-release-monitor-v1",
+  "generatedAt": "2026-08-14T12:00:00.000Z",
+  "identity": { "projectRef": "project.fixture", "runtimeInstanceId": "runtime.fixture", "sessionRef": "session.fixture", "taskId": null, "taskRunId": null, "agentOperationId": null, "toolCallId": null },
+  "state": "ready",
+  "monitorRevision": "release-monitor.fixture",
+  "benchmark": { "state": "missing", "runs": [], "warnings": [], "page": { "total": 0, "returned": 0, "truncated": false } },
+  "release": { "state": "missing", "reportRef": null, "generatedAt": null, "sourceState": "unknown", "localSafeGate": "unknown", "rcAssembly": "unknown", "beta": "unknown", "gaRelease": "unknown", "blockerCount": 0, "blockers": [], "authorization": { "releaseCommit": false, "tag": false, "publish": true, "push": false } },
+  "actions": { "runBenchmark": true, "resumeBenchmark": false, "releaseCommit": false, "tag": false, "publish": false, "push": false },
+  "health": { "state": "ok", "reasonCode": null, "message": null }
+}

package/evals/fixtures/piagent-webui/release-monitor-v1.valid.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-release-monitor-v1",
+  "generatedAt": "2026-08-14T12:00:00.000Z",
+  "identity": { "projectRef": "project.fixture", "runtimeInstanceId": "runtime.fixture", "sessionRef": "session.fixture", "taskId": null, "taskRunId": null, "agentOperationId": null, "toolCallId": null },
+  "state": "ready",
+  "monitorRevision": "release-monitor.fixture",
+  "benchmark": {
+    "state": "ready",
+    "runs": [
+      {
+        "runRef": "benchmark.fixture", "suiteId": "production-v1", "lifecycle": "completed", "evidenceState": "complete", "sourceState": "current",
+        "startedAt": "2026-08-14T10:00:00.000Z", "updatedAt": "2026-08-14T11:00:00.000Z", "completedRuns": 12, "expectedRuns": 12,
+        "verdict": "passed", "releaseGate": "passed", "tokenClaimAllowed": true, "claimTier": "production-shadow",
+        "scores": { "quality": 9.1, "safety": 10, "reliability": 9.5, "workflow": 9, "efficiency": 8.8, "overall": 9.3 }
+      }
+    ],
+    "warnings": [],
+    "page": { "total": 1, "returned": 1, "truncated": false }
+  },
+  "release": {
+    "state": "ready", "reportRef": "release.fixture", "generatedAt": "2026-08-14T11:30:00.000Z", "sourceState": "current",
+    "localSafeGate": "passed", "rcAssembly": "ready", "beta": "blocked", "gaRelease": "blocked", "blockerCount": 1,
+    "blockers": ["explicit operator approval missing"],
+    "authorization": { "releaseCommit": false, "tag": false, "publish": false, "push": false }
+  },
+  "actions": { "runBenchmark": false, "resumeBenchmark": false, "releaseCommit": false, "tag": false, "publish": false, "push": false },
+  "health": { "state": "ok", "reasonCode": null, "message": null }
+}

package/evals/fixtures/piagent-webui/review-state-v1.invalid.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-review-state-v1",
+  "generatedAt": "2026-08-14T12:00:00.000Z",
+  "identity": {
+    "projectRef": "project_01",
+    "runtimeInstanceId": "runtime_01",
+    "sessionRef": "session_01",
+    "taskId": "task_01",
+    "taskRunId": "task_run_01",
+    "agentOperationId": null,
+    "toolCallId": null
+  },
+  "state": "reviewed",
+  "target": null,
+  "recordedState": "reviewed",
+  "recordedAt": "2026-08-14T12:00:00.000Z",
+  "evidenceRef": "review_evidence_01",
+  "reasonCode": null,
+  "health": {
+    "state": "ok",
+    "reasonCode": null,
+    "message": null
+  }
+}

package/evals/fixtures/piagent-webui/review-state-v1.valid.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-review-state-v1",
+  "generatedAt": "2026-08-14T12:00:00.000Z",
+  "identity": {
+    "projectRef": "project_01",
+    "runtimeInstanceId": "runtime_01",
+    "sessionRef": "session_01",
+    "taskId": "task_01",
+    "taskRunId": "task_run_01",
+    "agentOperationId": null,
+    "toolCallId": null
+  },
+  "state": "reviewed",
+  "target": {
+    "view": "task",
+    "fileRef": "file_01",
+    "diffRef": "diff_01",
+    "taskRevision": "task_rev_01",
+    "workspaceRevision": "workspace_rev_01",
+    "indexRevision": "index_rev_01",
+    "viewRevision": "view_rev_01",
+    "fileRevision": "file_rev_01",
+    "baseDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+    "currentDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "patchPreimage": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "contentDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "recordedState": "reviewed",
+  "recordedAt": "2026-08-14T12:00:00.000Z",
+  "evidenceRef": "review_evidence_01",
+  "reasonCode": null,
+  "health": {
+    "state": "ok",
+    "reasonCode": null,
+    "message": null
+  }
+}

package/evals/fixtures/piagent-webui/runtime-event-v2.invalid.json

@@ -0,0 +1,49 @@
+{
+  "schemaVersion": 2,
+  "eventId": "event_01",
+  "eventCursor": "cursor_01",
+  "writerSequence": 1,
+  "recordedAt": "2026-08-13T09:06:00.000Z",
+  "sourceObservedAt": "2026-08-13T09:06:00.000Z",
+  "projectRef": "project_01",
+  "runtimeInstanceId": "runtime_01",
+  "sessionRef": "session_01",
+  "taskId": null,
+  "taskRunId": null,
+  "agentOperationId": null,
+  "turnIndex": null,
+  "messageRef": null,
+  "toolCallId": null,
+  "revision": {
+    "runtimeRevision": "runtime_rev_01",
+    "taskRevision": null,
+    "controlRevision": null,
+    "workspaceRevision": null,
+    "indexRevision": null,
+    "approvalRevision": null,
+    "sessionOptionRevision": null,
+    "queueRevision": null
+  },
+  "kind": "runtime.started",
+  "correlation": {
+    "commandId": null,
+    "messageRequestId": null,
+    "replacementId": null,
+    "approvalRequestId": null,
+    "causationEventId": null,
+    "idempotencyKeyDigest": null
+  },
+  "evidence": "observed",
+  "payload": {
+    "connectionState": "connected",
+    "operationState": "idle",
+    "buildRef": "runtime_build_01",
+    "capabilitySnapshotRef": "capabilities_01",
+    "sessionFile": "/private/session.jsonl"
+  },
+  "redaction": {
+    "applied": false,
+    "valuesRemoved": 0,
+    "truncated": false
+  }
+}

package/evals/fixtures/piagent-webui/runtime-event-v2.valid.json

@@ -0,0 +1,49 @@
+{
+  "schemaVersion": 2,
+  "eventId": "event_01",
+  "eventCursor": "cursor_01",
+  "writerSequence": 1,
+  "recordedAt": "2026-08-13T09:06:00.000Z",
+  "sourceObservedAt": "2026-08-13T09:06:00.000Z",
+  "projectRef": "project_01",
+  "runtimeInstanceId": "runtime_01",
+  "sessionRef": "session_01",
+  "taskId": null,
+  "taskRunId": null,
+  "agentOperationId": null,
+  "turnIndex": null,
+  "messageRef": null,
+  "toolCallId": null,
+  "revision": {
+    "runtimeRevision": "runtime_rev_01",
+    "taskRevision": null,
+    "controlRevision": null,
+    "workspaceRevision": null,
+    "indexRevision": null,
+    "approvalRevision": null,
+    "sessionOptionRevision": null,
+    "queueRevision": null
+  },
+  "kind": "runtime.started",
+  "correlation": {
+    "commandId": null,
+    "messageRequestId": null,
+    "replacementId": null,
+    "approvalRequestId": null,
+    "causationEventId": null,
+    "idempotencyKeyDigest": null
+  },
+  "evidence": "observed",
+  "payload": {
+    "connectionState": "connected",
+    "operationState": "idle",
+    "buildRef": "runtime_build_01",
+    "capabilitySnapshotRef": "capabilities_01",
+    "reasonCode": null
+  },
+  "redaction": {
+    "applied": false,
+    "valuesRemoved": 0,
+    "truncated": false
+  }
+}

package/evals/fixtures/piagent-webui/session-catalog-v1.invalid.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-session-catalog-v1",
+  "generatedAt": "2026-08-14T04:30:00.000Z",
+  "gatewayInstanceRef": "gateway_01",
+  "state": "unavailable",
+  "catalogRevision": "invented_revision",
+  "sessions": [],
+  "page": {
+    "limit": 50,
+    "returned": 0,
+    "total": 0,
+    "nextCursor": null,
+    "truncated": false
+  },
+  "reasonCode": "gateway-offline"
+}

package/evals/fixtures/piagent-webui/session-catalog-v1.valid.json

@@ -0,0 +1,58 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-session-catalog-v1",
+  "generatedAt": "2026-08-14T04:30:00.000Z",
+  "gatewayInstanceRef": "gateway_01",
+  "state": "ready",
+  "catalogRevision": "catalog_rev_01",
+  "sessions": [
+    {
+      "sessionRef": "session_01",
+      "projectRef": "project_01",
+      "title": "Build the Session Hub",
+      "projectLabel": "pi-company-platform",
+      "preview": "Implementing the durable gateway contract.",
+      "createdAt": "2026-08-14T03:00:00.000Z",
+      "updatedAt": "2026-08-14T04:29:59.000Z",
+      "state": "gateway-owned",
+      "liveState": "idle",
+      "pinned": true,
+      "archived": false,
+      "unread": false,
+      "composerAvailable": true,
+      "needsAttention": false,
+      "modelLabel": "Claude Sonnet",
+      "thinkingLevel": "high",
+      "contextUsage": {
+        "usedTokens": 24000,
+        "contextWindow": 200000,
+        "ratio": 0.12,
+        "state": "known"
+      },
+      "task": {
+        "taskRef": "task_01",
+        "summary": "Ship durable session management",
+        "outcome": "pending",
+        "progressCompleted": 2,
+        "progressTotal": 8
+      },
+      "owner": {
+        "kind": "gateway",
+        "ownerEpoch": "owner_epoch_01",
+        "gatewayInstanceRef": "gateway_01",
+        "runtimeInstanceRef": "runtime_01",
+        "continuity": "exact"
+      },
+      "sessionRevision": "session_rev_01",
+      "reasonCode": null
+    }
+  ],
+  "page": {
+    "limit": 50,
+    "returned": 1,
+    "total": 1,
+    "nextCursor": null,
+    "truncated": false
+  },
+  "reasonCode": null
+}

package/evals/fixtures/piagent-webui/session-command-v1.invalid.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-session-command-v1",
+  "messageType": "command",
+  "commandId": "command_01",
+  "idempotencyKey": "session_send_01_abcdefgh",
+  "action": "session.send",
+  "requestedAt": "2026-08-14T04:30:00.000Z",
+  "expiresAt": "2026-08-14T04:35:00.000Z",
+  "sessionRef": "session_01",
+  "expectedCatalogRevision": "catalog_rev_01",
+  "expectedSessionRevision": "session_rev_01",
+  "payload": {
+    "delivery": "steer",
+    "message": "Change direction.",
+    "messageRequestId": "message_request_01",
+    "expectedOperationRef": null
+  }
+}

package/evals/fixtures/piagent-webui/session-command-v1.valid.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-session-command-v1",
+  "messageType": "command",
+  "commandId": "command_01",
+  "idempotencyKey": "session_send_01_abcdefgh",
+  "action": "session.send",
+  "requestedAt": "2026-08-14T04:30:00.000Z",
+  "expiresAt": "2026-08-14T04:35:00.000Z",
+  "sessionRef": "session_01",
+  "expectedCatalogRevision": "catalog_rev_01",
+  "expectedSessionRevision": "session_rev_01",
+  "payload": {
+    "delivery": "new-operation",
+    "message": "Continue the gateway implementation.",
+    "messageRequestId": "message_request_01",
+    "expectedOperationRef": null
+  }
+}

package/evals/fixtures/piagent-webui/snapshot-v1.invalid.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-snapshot-v1",
+  "sessionId": "/raw/private/session.jsonl"
+}