@8lines/gauntlet-protocol 0.1.0

package/fixtures/v1/operation.valid.json

@@ -0,0 +1,227 @@
+{
+  "id": "application-access-review",
+  "revision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "label": "Review application access",
+  "featureId": "security",
+  "description": "Review application access and optionally notify its owners.",
+  "icon": "shield-check",
+  "order": 10,
+  "tags": ["access", "security"],
+  "requirements": {
+    "profiles": ["tc-schema-core@1", "tc-rich-forms@1", "tc-rich-results@1"],
+    "capabilities": ["tc-uploads@1", "tc-session-launch@1"]
+  },
+  "inputSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "required": ["applicationId", "message", "notify", "options", "roles", "apiToken", "attachment"],
+    "properties": {
+      "applicationId": {
+        "type": "string",
+        "minLength": 1,
+        "title": "Application"
+      },
+      "message": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 500,
+        "title": "Review message"
+      },
+      "notify": {
+        "type": "boolean",
+        "default": true,
+        "title": "Notify owners"
+      },
+      "options": {
+        "type": "object",
+        "required": ["includeInactive", "mode"],
+        "properties": {
+          "includeInactive": { "type": "boolean", "default": false },
+          "mode": { "type": "string", "enum": ["preview", "apply"] }
+        },
+        "additionalProperties": false
+      },
+      "roles": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 },
+        "minItems": 1,
+        "uniqueItems": true
+      },
+      "apiToken": {
+        "type": "string",
+        "minLength": 1,
+        "title": "API token"
+      },
+      "attachment": {
+        "type": "object",
+        "required": ["kind", "uploadId", "name", "mediaType", "sizeBytes", "expiresAt"],
+        "properties": {
+          "kind": { "const": "file" },
+          "uploadId": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" },
+          "name": { "type": "string", "minLength": 1 },
+          "mediaType": { "type": "string", "minLength": 1 },
+          "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+          "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+          "expiresAt": { "type": "string", "format": "date-time" },
+          "extensions": {
+            "type": "object",
+            "propertyNames": { "pattern": "^urn:[A-Za-z0-9][A-Za-z0-9:._/-]*$" }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "additionalProperties": false
+  },
+  "inputHandling": {
+    "rules": [
+      {
+        "kind": "secret",
+        "schemaPointer": "/properties/apiToken",
+        "retention": "none"
+      },
+      {
+        "kind": "file",
+        "schemaPointer": "/properties/attachment",
+        "multiple": false,
+        "mediaTypes": ["application/pdf", "text/plain"],
+        "maxBytes": 10485760
+      }
+    ]
+  },
+  "contextSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "required": ["requestId", "target"],
+    "properties": {
+      "requestId": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
+      },
+      "locale": { "type": "string" },
+      "timeZone": { "type": "string" },
+      "actor": {
+        "type": "object",
+        "required": ["id"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
+          },
+          "displayName": { "type": "string" }
+        },
+        "additionalProperties": false
+      },
+      "target": {
+        "type": "object",
+        "required": ["id"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
+          },
+          "environment": { "type": "string" }
+        },
+        "additionalProperties": false
+      },
+      "extensions": {
+        "type": "object",
+        "propertyNames": {
+          "pattern": "^urn:[A-Za-z0-9][A-Za-z0-9:._/-]*$"
+        }
+      }
+    },
+    "additionalProperties": false
+  },
+  "uiSchema": {
+    "profile": "tc-rich-forms@1",
+    "root": {
+      "type": "group",
+      "label": "Access review",
+      "children": [
+        {
+          "type": "field",
+          "pointer": "/applicationId",
+          "widget": "autocomplete",
+          "dataSourceId": "application-catalog",
+          "label": "Application",
+          "help": "Search the target application catalog."
+        },
+        {
+          "type": "field",
+          "pointer": "/message",
+          "widget": "textarea"
+        },
+        {
+          "type": "field",
+          "pointer": "/notify",
+          "widget": "toggle"
+        },
+        {
+          "type": "group",
+          "label": "Notification options",
+          "visibleWhen": { "op": "equals", "pointer": "/notify", "value": true },
+          "children": [
+            { "type": "field", "pointer": "/options/includeInactive", "widget": "toggle" },
+            { "type": "field", "pointer": "/options/mode", "widget": "select" },
+            { "type": "field", "pointer": "/roles", "widget": "multi-select" }
+          ]
+        },
+        {
+          "type": "columns",
+          "children": [
+            { "type": "field", "pointer": "/apiToken", "widget": "secret" },
+            { "type": "field", "pointer": "/attachment", "widget": "file" }
+          ]
+        }
+      ]
+    }
+  },
+  "dataSources": [
+    {
+      "id": "application-catalog",
+      "inputPointer": "/applicationId",
+      "dependencyPointers": ["/options/includeInactive"],
+      "contextPointers": ["/target/id"],
+      "required": true
+    }
+  ],
+  "presets": [
+    {
+      "id": "preview-active",
+      "label": "Preview active applications",
+      "description": "Starts with a safe, secret-free preview configuration.",
+      "input": {
+        "notify": false,
+        "options": { "includeInactive": false, "mode": "preview" },
+        "roles": ["viewer"]
+      },
+      "lockedPointers": ["/options/mode"]
+    }
+  ],
+  "execution": {
+    "impact": "write",
+    "confirmationRequired": true,
+    "dryRunSupported": true,
+    "idempotency": "required",
+    "cancellationSupported": false,
+    "timeoutSeconds": 120,
+    "concurrency": "queue"
+  },
+  "output": {
+    "schema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "required": ["reviewed", "notified"],
+      "properties": {
+        "reviewed": { "type": "integer", "minimum": 0 },
+        "notified": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "presentation": {
+      "profile": "tc-rich-results@1",
+      "defaultView": "summary"
+    }
+  }
+}

package/fixtures/v1/problem.unsupported-capability.valid.json

@@ -0,0 +1,7 @@
+{
+  "type": "urn:gauntlet:problem:unsupported-capability",
+  "title": "Capability is not supported",
+  "status": 501,
+  "detail": "This adapter does not support run event streaming.",
+  "capability": "tc-run-sse@1"
+}

package/fixtures/v1/problem.valid.json

@@ -0,0 +1,8 @@
+{
+  "type": "urn:gauntlet:problem:run-not-found",
+  "title": "Run not found",
+  "status": 404,
+  "detail": "No run exists with ID run-missing.",
+  "instance": "/_gauntlet/v1/runs/run-missing",
+  "correlationId": "correlation-404"
+}

package/fixtures/v1/problem.validation.valid.json

@@ -0,0 +1,16 @@
+{
+  "type": "urn:gauntlet:problem:validation-failed",
+  "title": "Request validation failed",
+  "status": 422,
+  "detail": "The operation input is invalid.",
+  "correlationId": "correlation-422",
+  "errors": [
+    {
+      "instancePath": "/applicationId",
+      "schemaPath": "#/properties/applicationId/minLength",
+      "keyword": "minLength",
+      "message": "must NOT have fewer than 1 characters",
+      "params": { "limit": 1 }
+    }
+  ]
+}

package/fixtures/v1/run-event.valid.json

@@ -0,0 +1,21 @@
+{
+  "id": "event-01",
+  "sequence": 0,
+  "occurredAt": "2026-08-29T12:00:00Z",
+  "type": "run.updated",
+  "run": {
+    "id": "run-01",
+    "operationId": "application-access-review",
+    "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+    "sequence": 0,
+    "state": "queued",
+    "createdAt": "2026-08-29T12:00:00Z",
+    "updatedAt": "2026-08-29T12:00:00Z",
+    "summary": {
+      "title": "Access review queued",
+      "tone": "neutral"
+    },
+    "artifacts": [],
+    "actions": []
+  }
+}

package/fixtures/v1/run.cancelled.valid.json

@@ -0,0 +1,17 @@
+{
+  "id": "run-cancelled-01",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 1,
+  "state": "cancelled",
+  "createdAt": "2026-08-29T12:20:00Z",
+  "updatedAt": "2026-08-29T12:20:02Z",
+  "completedAt": "2026-08-29T12:20:02Z",
+  "artifacts": [],
+  "actions": [],
+  "problem": {
+    "type": "urn:gauntlet:problem:run-cancelled",
+    "title": "Run cancelled",
+    "status": 409
+  }
+}

package/fixtures/v1/run.failed.valid.json

@@ -0,0 +1,32 @@
+{
+  "id": "run-02",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 2,
+  "state": "failed",
+  "createdAt": "2026-08-29T12:10:00Z",
+  "updatedAt": "2026-08-29T12:10:02Z",
+  "startedAt": "2026-08-29T12:10:01Z",
+  "completedAt": "2026-08-29T12:10:02Z",
+  "summary": {
+    "title": "Access review failed",
+    "message": "The target application was unavailable.",
+    "tone": "error"
+  },
+  "artifacts": [
+    {
+      "id": "failure-notice",
+      "kind": "notice",
+      "level": "error",
+      "message": "The target application was unavailable."
+    }
+  ],
+  "actions": [],
+  "problem": {
+    "type": "urn:gauntlet:problem:handler-failed",
+    "title": "Operation handler failed",
+    "status": 502,
+    "detail": "The target application was unavailable.",
+    "correlationId": "correlation-02"
+  }
+}

package/fixtures/v1/run.invalid-active-problem.json

@@ -0,0 +1,16 @@
+{
+  "id": "run-invalid-active",
+  "operationId": "fixture-operation",
+  "operationRevision": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+  "sequence": 1,
+  "state": "running",
+  "createdAt": "2026-08-29T12:00:00Z",
+  "updatedAt": "2026-08-29T12:00:01Z",
+  "artifacts": [],
+  "actions": [],
+  "problem": {
+    "type": "urn:gauntlet:problem:handler-failed",
+    "title": "Handler failed",
+    "status": 500
+  }
+}

package/fixtures/v1/run.invalid-cancelled-problem.json

@@ -0,0 +1,17 @@
+{
+  "id": "run-cancelled-invalid-01",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 1,
+  "state": "cancelled",
+  "createdAt": "2026-08-29T12:20:00Z",
+  "updatedAt": "2026-08-29T12:20:02Z",
+  "completedAt": "2026-08-29T12:20:02Z",
+  "artifacts": [],
+  "actions": [],
+  "problem": {
+    "type": "urn:gauntlet:problem:handler-failed",
+    "title": "Operation failed",
+    "status": 500
+  }
+}

package/fixtures/v1/run.invalid-terminal-without-problem.json

@@ -0,0 +1,12 @@
+{
+  "id": "run-invalid-terminal",
+  "operationId": "fixture-operation",
+  "operationRevision": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+  "sequence": 2,
+  "state": "failed",
+  "createdAt": "2026-08-29T12:00:00Z",
+  "updatedAt": "2026-08-29T12:00:02Z",
+  "completedAt": "2026-08-29T12:00:02Z",
+  "artifacts": [],
+  "actions": []
+}

package/fixtures/v1/run.invalid-timed-out-status.json

@@ -0,0 +1,18 @@
+{
+  "id": "run-timed-out-invalid-01",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 2,
+  "state": "timed_out",
+  "createdAt": "2026-08-29T12:30:00Z",
+  "updatedAt": "2026-08-29T12:32:01Z",
+  "startedAt": "2026-08-29T12:30:01Z",
+  "completedAt": "2026-08-29T12:32:01Z",
+  "artifacts": [],
+  "actions": [],
+  "problem": {
+    "type": "urn:gauntlet:problem:run-timed-out",
+    "title": "Run timed out",
+    "status": 409
+  }
+}

package/fixtures/v1/run.queued.valid.json

@@ -0,0 +1,15 @@
+{
+  "id": "run-01",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 0,
+  "state": "queued",
+  "createdAt": "2026-08-29T12:00:00Z",
+  "updatedAt": "2026-08-29T12:00:00Z",
+  "summary": {
+    "title": "Access review queued",
+    "tone": "neutral"
+  },
+  "artifacts": [],
+  "actions": []
+}

package/fixtures/v1/run.succeeded.valid.json

@@ -0,0 +1,68 @@
+{
+  "id": "run-01",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 2,
+  "state": "succeeded",
+  "createdAt": "2026-08-29T12:00:00Z",
+  "updatedAt": "2026-08-29T12:00:03Z",
+  "startedAt": "2026-08-29T12:00:01Z",
+  "completedAt": "2026-08-29T12:00:03Z",
+  "progress": {
+    "current": 12,
+    "total": 12,
+    "phase": "complete",
+    "message": "Review completed",
+    "updatedAt": "2026-08-29T12:00:03Z"
+  },
+  "summary": {
+    "title": "Access review complete",
+    "message": "12 access grants were reviewed.",
+    "tone": "success"
+  },
+  "output": {
+    "reviewed": 12,
+    "notified": true
+  },
+  "artifacts": [
+    {
+      "id": "review-counts",
+      "kind": "metrics",
+      "title": "Review counts",
+      "metrics": [
+        { "name": "reviewed", "value": 12, "unit": "grants" }
+      ]
+    },
+    {
+      "id": "review-summary",
+      "kind": "table",
+      "title": "Reviewed roles",
+      "columns": [
+        { "key": "role", "label": "Role" },
+        { "key": "count", "label": "Count" }
+      ],
+      "rows": [
+        { "role": "viewer", "count": 8 },
+        { "role": "auditor", "count": 4 }
+      ]
+    },
+    {
+      "id": "browser-session",
+      "kind": "browser-launch",
+      "label": "Open reviewed application"
+    }
+  ],
+  "actions": [
+    {
+      "kind": "invoke-operation",
+      "label": "Review another application",
+      "operationId": "application-access-review",
+      "input": { "notify": false }
+    },
+    {
+      "kind": "browser-launch",
+      "label": "Open reviewed application",
+      "artifactId": "browser-session"
+    }
+  ]
+}

package/fixtures/v1/run.timed-out.valid.json

@@ -0,0 +1,18 @@
+{
+  "id": "run-timed-out-01",
+  "operationId": "application-access-review",
+  "operationRevision": "sha256:2e301a636fb48d2bec64fc7e91b62d8a45e47af3a28f665b6b809f6a4b19d9e8",
+  "sequence": 2,
+  "state": "timed_out",
+  "createdAt": "2026-08-29T12:30:00Z",
+  "updatedAt": "2026-08-29T12:32:01Z",
+  "startedAt": "2026-08-29T12:30:01Z",
+  "completedAt": "2026-08-29T12:32:01Z",
+  "artifacts": [],
+  "actions": [],
+  "problem": {
+    "type": "urn:gauntlet:problem:run-timed-out",
+    "title": "Run timed out",
+    "status": 504
+  }
+}

package/fixtures/v1/session-launch.valid.json

@@ -0,0 +1,5 @@
+{
+  "url": "https://portal.example.test/gauntlet/session/launch-01",
+  "expiresAt": "2026-08-29T12:15:00Z",
+  "singleUse": true
+}