@opensoha/contracts 0.1.4

package/fixtures/openapi/AgentRunCallbackRequest/valid/with-events.json

@@ -0,0 +1,39 @@
+{
+  "runId": "run-1",
+  "callbackToken": "agent-run-token",
+  "agentId": "agent-1",
+  "status": "succeeded",
+  "payload": {
+    "summary": "Completed"
+  },
+  "events": [
+    {
+      "type": "thinking.delta",
+      "textDelta": "Checking recent deployment events."
+    },
+    {
+      "type": "agent.status",
+      "status": "running"
+    },
+    {
+      "type": "tool.delta",
+      "toolCallId": "tool-1",
+      "logDelta": "kubectl get events returned 12 rows"
+    },
+    {
+      "type": "tool.completed",
+      "toolCall": {
+        "id": "tool-1",
+        "adapterId": "kubernetes",
+        "toolName": "events.list",
+        "status": "success",
+        "summary": "Collected recent warning events"
+      }
+    },
+    {
+      "type": "message.done",
+      "role": "assistant",
+      "content": "The rollout failed because the new pod image could not be pulled."
+    }
+  ]
+}

package/fixtures/openapi/AuthResultEnvelope/invalid/missing-tokens.json

@@ -0,0 +1,13 @@
+{
+  "data": {
+    "user": {
+      "userId": "u-1",
+      "userName": "admin",
+      "email": "admin@example.com",
+      "roles": [],
+      "teams": [],
+      "projects": [],
+      "tags": []
+    }
+  }
+}

package/fixtures/openapi/AuthResultEnvelope/valid/session.json

@@ -0,0 +1,20 @@
+{
+  "data": {
+    "user": {
+      "userId": "u-1",
+      "userName": "admin",
+      "email": "admin@example.com",
+      "roles": ["platform-admin"],
+      "teams": [],
+      "projects": [],
+      "tags": []
+    },
+    "tokens": {
+      "accessToken": "access-token",
+      "refreshToken": "refresh-token",
+      "tokenType": "Bearer",
+      "expiresIn": 3600,
+      "expiresAt": "2026-06-09T13:00:00Z"
+    }
+  }
+}

package/fixtures/openapi/CloudExtensionPointListEnvelope/invalid/missing-exclusions.json

@@ -0,0 +1,11 @@
+{
+  "items": [
+    {
+      "id": "cloud.managed-connector",
+      "name": "Managed Connector",
+      "kind": "managed-connector",
+      "boundary": "event-sink",
+      "contractRefs": ["connectors/connector-event-envelope.schema.json"]
+    }
+  ]
+}

package/fixtures/openapi/CloudExtensionPointListEnvelope/valid/managed-fleet.json

@@ -0,0 +1,19 @@
+{
+  "items": [
+    {
+      "id": "cloud.managed-agent-fleet",
+      "name": "Managed Agent Fleet",
+      "kind": "managed-agent-fleet",
+      "boundary": "public-contract",
+      "description": "Cloud managed Agent fleet integration point built on public Agent and capability contracts.",
+      "contractRefs": [
+        "agent/agent-protocol.schema.json",
+        "capabilities/cluster-capability-matrix.schema.json",
+        "runner/operation-lifecycle.schema.json"
+      ],
+      "supportedConsumers": ["agent", "cli", "web", "cloud"],
+      "eventTypes": ["agent.registered", "agent.heartbeat", "agent.capabilities.updated"],
+      "excludedCloudOnlyDomains": ["billing", "quota", "saas-iam"]
+    }
+  ]
+}

package/fixtures/openapi/ComputeAccessSourceListEnvelope/invalid/bad-source-type.json

@@ -0,0 +1,15 @@
+{
+  "items": [
+    {
+      "id": "source-1",
+      "sourceType": "provider",
+      "resource": {
+        "domain": "agent",
+        "kind": "agent_host",
+        "id": "agent-1",
+        "displayName": "edge-agent-1"
+      },
+      "status": "healthy"
+    }
+  ]
+}

package/fixtures/openapi/ComputeAccessSourceListEnvelope/valid/mixed.json

@@ -0,0 +1,19 @@
+{
+  "items": [
+    {
+      "id": "agent-1",
+      "sourceType": "agent_host",
+      "resource": {
+        "domain": "agent",
+        "kind": "agent_host",
+        "id": "agent-1",
+        "displayName": "edge-agent-1",
+        "scope": "default/default"
+      },
+      "status": "healthy",
+      "availableActions": ["inspect"],
+      "lastObservedAt": "2026-07-14T02:00:00Z"
+    }
+  ],
+  "nextCursor": "cursor-2"
+}

package/fixtures/openapi/ComputeOverviewEnvelope/invalid/bad-section-status.json

@@ -0,0 +1,9 @@
+{
+  "data": {
+    "runtimes": { "status": "offline" },
+    "attention": [],
+    "providerHealth": [],
+    "partial": true,
+    "warnings": []
+  }
+}

package/fixtures/openapi/ComputeOverviewEnvelope/valid/partial.json

@@ -0,0 +1,33 @@
+{
+  "data": {
+    "virtualization": {
+      "status": "ok",
+      "summary": {
+        "connectionsTotal": 2,
+        "connectionsHealthy": 2,
+        "connectionsDegraded": 0,
+        "connectionsUnsynced": 0,
+        "vmsTotal": 8,
+        "vmsRunning": 6,
+        "vmsStopped": 2,
+        "vmsError": 0
+      }
+    },
+    "runtimes": {
+      "status": "unavailable",
+      "warnings": [{ "code": "runtime_read_timeout", "message": "Runtime data is temporarily unavailable." }]
+    },
+    "attention": [],
+    "providerHealth": [
+      {
+        "domain": "virtualization",
+        "providerKey": "pve",
+        "status": "healthy",
+        "generation": 1,
+        "checkedAt": "2026-07-14T02:00:00Z"
+      }
+    ],
+    "partial": true,
+    "warnings": [{ "code": "runtime_section_unavailable" }]
+  }
+}

package/fixtures/openapi/ComputeProviderListEnvelope/invalid/bad-domain.json

@@ -0,0 +1,23 @@
+{
+  "items": [
+    {
+      "providerKey": "docker",
+      "domain": "agent",
+      "displayName": "Docker",
+      "version": "builtin",
+      "source": "builtin",
+      "contractVersion": "0.1.2",
+      "activationLevel": "write",
+      "resourceKinds": ["runtime_host"],
+      "capabilities": [],
+      "runtimeMode": "builtin",
+      "generation": 1,
+      "health": {
+        "domain": "container_runtime",
+        "providerKey": "docker",
+        "status": "healthy",
+        "generation": 1
+      }
+    }
+  ]
+}

package/fixtures/openapi/ComputeProviderListEnvelope/valid/builtin.json

@@ -0,0 +1,30 @@
+{
+  "items": [
+    {
+      "providerKey": "docker",
+      "domain": "container_runtime",
+      "displayName": "Docker",
+      "version": "builtin",
+      "source": "builtin",
+      "contractVersion": "0.1.2",
+      "activationLevel": "write",
+      "resourceKinds": ["runtime_host", "container", "project", "service", "port", "template"],
+      "capabilities": [
+        {
+          "id": "inventory.discover",
+          "level": "read",
+          "resourceKinds": ["runtime_host", "container"],
+          "enabled": true
+        }
+      ],
+      "runtimeMode": "builtin",
+      "generation": 1,
+      "health": {
+        "domain": "container_runtime",
+        "providerKey": "docker",
+        "status": "healthy",
+        "generation": 1
+      }
+    }
+  ]
+}

package/fixtures/openapi/ComputeResourceRelationListEnvelope/invalid/bad-relation.json

@@ -0,0 +1,29 @@
+{
+  "data": {
+    "resource": {
+      "domain": "virtualization",
+      "kind": "vm",
+      "id": "vm-101",
+      "displayName": "runtime-node-1"
+    },
+    "relations": [
+      {
+        "from": {
+          "domain": "virtualization",
+          "kind": "vm",
+          "id": "vm-101",
+          "displayName": "runtime-node-1"
+        },
+        "type": "owns_everything",
+        "to": {
+          "domain": "container_runtime",
+          "kind": "runtime_host",
+          "id": "host-1",
+          "displayName": "runtime-node-1"
+        },
+        "source": "derived",
+        "observedAt": "2026-07-14T02:00:00Z"
+      }
+    ]
+  }
+}

package/fixtures/openapi/ComputeResourceRelationListEnvelope/valid/vm-runtime.json

@@ -0,0 +1,33 @@
+{
+  "data": {
+    "resource": {
+      "domain": "virtualization",
+      "kind": "vm",
+      "id": "vm-101",
+      "displayName": "runtime-node-1",
+      "providerKey": "pve",
+      "providerSource": "builtin",
+      "providerInstanceRef": "connection-1",
+      "accessMode": "direct"
+    },
+    "relations": [
+      {
+        "from": {
+          "domain": "virtualization",
+          "kind": "vm",
+          "id": "vm-101",
+          "displayName": "runtime-node-1"
+        },
+        "type": "runs_on",
+        "to": {
+          "domain": "container_runtime",
+          "kind": "runtime_host",
+          "id": "host-1",
+          "displayName": "runtime-node-1"
+        },
+        "source": "derived",
+        "observedAt": "2026-07-14T02:00:00Z"
+      }
+    ]
+  }
+}

package/fixtures/openapi/ComputeTaskListEnvelope/invalid/missing-source-id.json

@@ -0,0 +1,19 @@
+{
+  "items": [
+    {
+      "id": "virtualization:task-1",
+      "domain": "virtualization",
+      "sourceType": "virtualization_task",
+      "kind": "vm.create",
+      "category": "lifecycle",
+      "normalizedStatus": "running",
+      "rawStatus": "running",
+      "resources": [],
+      "attemptCount": 1,
+      "cancelable": true,
+      "retryable": false,
+      "availableActions": ["cancel"],
+      "createdAt": "2026-07-14T02:00:00Z"
+    }
+  ]
+}

package/fixtures/openapi/ComputeTaskListEnvelope/valid/running.json

@@ -0,0 +1,30 @@
+{
+  "items": [
+    {
+      "id": "virtualization:task-1",
+      "domain": "virtualization",
+      "sourceType": "virtualization_task",
+      "sourceId": "task-1",
+      "providerKey": "pve",
+      "providerSource": "builtin",
+      "kind": "vm.create",
+      "category": "lifecycle",
+      "normalizedStatus": "running",
+      "rawStatus": "running",
+      "resources": [
+        {
+          "domain": "virtualization",
+          "kind": "vm",
+          "id": "vm-101",
+          "displayName": "runtime-node-1"
+        }
+      ],
+      "attemptCount": 1,
+      "cancelable": true,
+      "retryable": false,
+      "availableActions": ["logs", "cancel"],
+      "createdAt": "2026-07-14T02:00:00Z",
+      "startedAt": "2026-07-14T02:00:01Z"
+    }
+  ]
+}

package/fixtures/openapi/DeliveryDraftInput/invalid/missing-application-key.json

@@ -0,0 +1,9 @@
+{
+  "source": "ai",
+  "applicationDraft": {
+    "name": "Checkout",
+    "group": "commerce",
+    "language": "go",
+    "enabled": true
+  }
+}

package/fixtures/openapi/DeliveryDraftInput/valid/ai-service.json

@@ -0,0 +1,25 @@
+{
+  "source": "ai",
+  "applicationDraft": {
+    "name": "Checkout",
+    "key": "checkout",
+    "group": "commerce",
+    "language": "go",
+    "enabled": true
+  },
+  "services": [
+    {
+      "key": "api",
+      "name": "Checkout API",
+      "serviceKind": "kubernetes_workload",
+      "enabled": true,
+      "containers": [
+        {
+          "name": "api",
+          "runtimePorts": [8080]
+        }
+      ]
+    }
+  ],
+  "postCreateActions": ["review_delivery_plan"]
+}

package/fixtures/openapi/DirectoryEventListEnvelope/invalid/unknown-status.json

@@ -0,0 +1,13 @@
+{
+  "items": [
+    {
+      "id": "directory-event-42",
+      "providerEventId": "feishu-event-42",
+      "eventType": "contact.user.updated_v3",
+      "status": "retrying",
+      "attempts": 1,
+      "occurredAt": "2026-07-28T08:08:00Z",
+      "receivedAt": "2026-07-28T08:08:01Z"
+    }
+  ]
+}

package/fixtures/openapi/DirectoryEventListEnvelope/valid/failed.json

@@ -0,0 +1,16 @@
+{
+  "items": [
+    {
+      "id": "directory-event-42",
+      "providerEventId": "feishu-event-42",
+      "eventType": "contact.user.updated_v3",
+      "status": "failed",
+      "attempts": 3,
+      "occurredAt": "2026-07-28T08:08:00Z",
+      "receivedAt": "2026-07-28T08:08:01Z",
+      "processedAt": "2026-07-28T08:08:02Z",
+      "nextAttemptAt": "2026-07-28T08:10:00Z",
+      "errorSummary": "directory object lookup failed"
+    }
+  ]
+}

package/fixtures/openapi/DirectoryPersonLifecycle/invalid/unknown-employment-status.json

@@ -0,0 +1,5 @@
+{
+  "directoryStatus": "archived",
+  "employmentStatus": "resigned",
+  "departedAt": "2026-07-28T08:08:00Z"
+}

package/fixtures/openapi/DirectoryPersonLifecycle/valid/departed.json

@@ -0,0 +1,6 @@
+{
+  "directoryStatus": "archived",
+  "employmentStatus": "departed",
+  "departedAt": "2026-07-28T08:08:00Z",
+  "lastDirectoryEventAt": "2026-07-28T08:08:01Z"
+}

package/fixtures/openapi/DirectoryRuntimeStatusEnvelope/invalid/negative-event-count.json

@@ -0,0 +1,11 @@
+{
+  "data": {
+    "connectionId": "directory-feishu-primary",
+    "callbackUrl": "/api/v1/integrations/directory/directory-feishu-primary/events",
+    "callbackConfigured": true,
+    "callbackStatus": "verified",
+    "queuedEvents": -1,
+    "failedEvents": 0,
+    "needsFullReconcile": false
+  }
+}

package/fixtures/openapi/DirectoryRuntimeStatusEnvelope/valid/verified.json

@@ -0,0 +1,14 @@
+{
+  "data": {
+    "connectionId": "directory-feishu-primary",
+    "callbackUrl": "/api/v1/integrations/directory/directory-feishu-primary/events",
+    "callbackConfigured": true,
+    "callbackStatus": "verified",
+    "callbackVerifiedAt": "2026-07-28T08:05:00Z",
+    "lastEventAt": "2026-07-28T08:08:00Z",
+    "queuedEvents": 0,
+    "failedEvents": 1,
+    "needsFullReconcile": true,
+    "reconcileReason": "event version gap"
+  }
+}

package/fixtures/openapi/DockerContainerStartInput/invalid/missing-image.json

@@ -0,0 +1,8 @@
+{
+  "hostId": "host-1",
+  "name": "preview-api",
+  "sourceKind": "git_dockerfile",
+  "gitBuild": {
+    "repositoryUrl": "https://github.com/opensoha/example.git"
+  }
+}

package/fixtures/openapi/DockerContainerStartInput/valid/git-dockerfile.json

@@ -0,0 +1,22 @@
+{
+  "hostId": "host-1",
+  "name": "preview-api",
+  "image": "preview-api:git-main",
+  "sourceKind": "git_dockerfile",
+  "gitBuild": {
+    "repositoryUrl": "https://github.com/opensoha/example.git",
+    "ref": "main",
+    "dockerfilePath": "deploy/Dockerfile",
+    "contextDir": ".",
+    "pull": true,
+    "noCache": false
+  },
+  "ports": [
+    {
+      "name": "http",
+      "hostPort": 18080,
+      "containerPort": 8080,
+      "protocol": "tcp"
+    }
+  ]
+}

package/fixtures/openapi/DockerOperationCallbackRequest/invalid/logs-not-array.json

@@ -0,0 +1,7 @@
+{
+  "operationId": "op-1",
+  "workerId": "worker-1",
+  "status": "succeeded",
+  "payload": {},
+  "logs": "started container"
+}

package/fixtures/openapi/DockerOperationCallbackRequest/valid/succeeded.json

@@ -0,0 +1,9 @@
+{
+  "operationId": "op-1",
+  "workerId": "worker-1",
+  "status": "succeeded",
+  "payload": {
+    "containerId": "container-1"
+  },
+  "logs": ["pulled image", "started container"]
+}

package/fixtures/openapi/ErrorEnvelope/invalid/extra-field.json

@@ -0,0 +1,7 @@
+{
+  "error": {
+    "code": "unauthorized",
+    "message": "Authentication is required.",
+    "details": {}
+  }
+}

package/fixtures/openapi/ErrorEnvelope/valid/error.json

@@ -0,0 +1,7 @@
+{
+  "error": {
+    "code": "unauthorized",
+    "message": "Authentication is required.",
+    "request_id": "req-1"
+  }
+}

package/fixtures/openapi/EvaluationGateRequest/invalid/missing-candidate.json

@@ -0,0 +1,4 @@
+{
+  "policyId": "release",
+  "baselineRunId": "run-baseline"
+}

package/fixtures/openapi/EvaluationGateRequest/valid/candidate.json

@@ -0,0 +1,5 @@
+{
+  "policyId": "release",
+  "baselineRunId": "run-baseline",
+  "candidateRunId": "run-candidate"
+}

package/fixtures/openapi/ExecutionCallbackRequest/invalid/extra-field.json

@@ -0,0 +1,6 @@
+{
+  "callbackToken": "task-callback-token",
+  "status": "succeeded",
+  "payload": {},
+  "runnerId": "runner-1"
+}

package/fixtures/openapi/ExecutionCallbackRequest/valid/succeeded.json

@@ -0,0 +1,7 @@
+{
+  "callbackToken": "task-callback-token",
+  "status": "succeeded",
+  "payload": {
+    "artifactId": "artifact-1"
+  }
+}

package/fixtures/openapi/GovernanceStatusEnvelope/invalid/window-hours-string.json

@@ -0,0 +1,81 @@
+{
+  "data": {
+    "generatedAt": "2026-06-09T12:00:00Z",
+    "windowHours": "24",
+    "health": {
+      "status": "ok",
+      "message": "healthy"
+    },
+    "metrics": {
+      "totalCalls": 0,
+      "successCount": 0,
+      "denyCount": 0,
+      "failureCount": 0,
+      "pendingApprovalCount": 0,
+      "dryRunCount": 0
+    },
+    "tokens": {
+      "personalAccessTokens": {
+        "total": 0,
+        "active": 0,
+        "revoked": 0,
+        "expired": 0,
+        "expiringSoon": 0,
+        "stale": 0,
+        "neverUsed": 0
+      },
+      "serviceAccountTokens": {
+        "total": 0,
+        "active": 0,
+        "revoked": 0,
+        "expired": 0,
+        "expiringSoon": 0,
+        "stale": 0,
+        "neverUsed": 0
+      },
+      "lastUsedTrackingState": "enabled"
+    },
+    "clients": {
+      "total": 0,
+      "active": 0,
+      "disabled": 0,
+      "pendingApproval": 0,
+      "registrationApproval": "disabled"
+    },
+    "approvals": {
+      "pending": 0,
+      "dueSoon": 0,
+      "stalePending": 0,
+      "overdue": 0
+    },
+    "policyCoverage": {
+      "accessPolicies": 0,
+      "toolGrants": 0,
+      "skillBindings": 0,
+      "activeAccessPolicies": 0,
+      "activeToolGrants": 0,
+      "activeSkillBindings": 0,
+      "budgetPolicies": 0,
+      "rateLimitPolicies": 0,
+      "redactionPolicies": 0,
+      "resourceScopedAccessPolicies": 0,
+      "resourceScopedToolGrants": 0,
+      "budgetState": "not_configured",
+      "rateLimitState": "not_configured",
+      "redactionPolicyState": "not_configured",
+      "resourceScopeState": "not_configured"
+    },
+    "redaction": {
+      "totalMatches": 0,
+      "auditsWithRedaction": 0,
+      "inputAudits": 0,
+      "outputAudits": 0,
+      "fieldMatches": 0,
+      "sensitiveKeyMatches": 0,
+      "sensitiveTextMatches": 0,
+      "valuePatternMatches": 0,
+      "secretClassifierMatches": 0,
+      "structuredSecretMatches": 0
+    }
+  }
+}