@ilbie/capybara-code-darwin-arm64 0.1.0-alpha.3

package/share/capybara/schemas/events/event.schema.json

@@ -0,0 +1,461 @@
+{
+  "x-dialect": "json-schema-draft-2020-12",
+  "$id": "cbc:events/event",
+  "title": "Capybara Code domain event",
+  "description": "PRD 20.6 and 20.7. One envelope serves the agent kernel, the TUI reducer, the durable session journal, and repository-owned benchmark adapters. A change here affects persisted sessions and internal consumers and must be recorded in schemas/CHANGELOG.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sequence",
+    "id",
+    "timestamp",
+    "sessionId",
+    "kind",
+    "level",
+    "visibility",
+    "durability",
+    "payload"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "description": "19.12: the event schema version is independent of the product and protocol versions.",
+      "const": "1.0"
+    },
+    "sequence": {
+      "description": "20.10: strictly monotonic within a session, so a consumer can detect a dropped line.",
+      "type": "integer",
+      "minimum": 1
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sessionId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "turnId": {
+      "type": "string"
+    },
+    "agentId": {
+      "description": "Present for a subagent's events, so 15.x delegation is inspectable in the stream.",
+      "type": "string"
+    },
+    "parentEventId": {
+      "type": "string"
+    },
+    "correlationId": {
+      "type": "string"
+    },
+    "kind": {
+      "$ref": "#/$defs/kind"
+    },
+    "level": {
+      "$ref": "#/$defs/level"
+    },
+    "visibility": {
+      "$ref": "#/$defs/visibility"
+    },
+    "durability": {
+      "$ref": "#/$defs/durability"
+    },
+    "payload": {
+      "description": "Canonical assistant.thinking payloads are validated below; other event kinds retain their provider-specific payload shapes."
+    },
+    "callerId": {
+      "type": "string"
+    },
+    "taskEpochId": {
+      "type": "string"
+    },
+    "workspaceIdentityDigest": {
+      "type": "string"
+    }
+  },
+  "$defs": {
+    "thinkingPayload": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "thinkingId",
+        "requestId",
+        "segmentIndex",
+        "providerItemIds",
+        "state",
+        "sources"
+      ],
+      "properties": {
+        "thinkingId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "requestId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "responseId": {
+          "type": "string"
+        },
+        "modelId": {
+          "type": "string"
+        },
+        "segmentIndex": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "providerItemIds": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "completed",
+            "interrupted",
+            "failed"
+          ]
+        },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "enum": [
+              "provider_summary",
+              "provider_reasoning",
+              "status_only"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "title": {
+          "type": "string",
+          "maxLength": 80
+        },
+        "summaryText": {
+          "type": "string",
+          "maxLength": 4096
+        },
+        "summaryOrigin": {
+          "type": "string",
+          "enum": [
+            "provider",
+            "derived_from_visible_detail"
+          ]
+        },
+        "detailText": {
+          "type": "string",
+          "maxLength": 65536
+        },
+        "startedAtMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "endedAtMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "durationMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "truncated": {
+          "type": "boolean"
+        }
+      }
+    },
+    "level": {
+      "type": "string",
+      "enum": [
+        "debug",
+        "info",
+        "success",
+        "warning",
+        "error"
+      ]
+    },
+    "visibility": {
+      "description": "Where the event is shown. A hidden event is journaled but not rendered.",
+      "type": "string",
+      "enum": [
+        "timeline",
+        "live",
+        "drawer",
+        "hidden"
+      ]
+    },
+    "durability": {
+      "description": "20.9: a journaled event is durable once the runtime acknowledges the append. An ephemeral event drives the UI immediately and may be coalesced before storage.",
+      "type": "string",
+      "enum": [
+        "ephemeral",
+        "journaled"
+      ]
+    },
+    "kind": {
+      "description": "20.7 event kinds, in declaration order. 20.10 requires a consumer to skip an unknown kind rather than fail, so adding one is a minor change.",
+      "type": "string",
+      "enum": [
+        "session.started",
+        "session.resumed",
+        "session.forked",
+        "session.compacted",
+        "turn.started",
+        "turn.interrupted",
+        "turn.cancelled",
+        "turn.completed",
+        "run.completed",
+        "user.message",
+        "assistant.delta",
+        "assistant.commentary",
+        "assistant.reasoning",
+        "assistant.reasoning_summary",
+        "assistant.final",
+        "plan.created",
+        "plan.updated",
+        "plan.approved",
+        "mode.changed",
+        "tool.discovery",
+        "tool.started",
+        "tool.progress",
+        "tool.completed",
+        "tool.failed",
+        "tool.preflight_repaired",
+        "tool.attempt_failed",
+        "tool.recovery_applied",
+        "tool.reconciled",
+        "tool.recovery_exhausted",
+        "approval.requested",
+        "approval.resolved",
+        "transaction.started",
+        "transaction.committed",
+        "transaction.rolled_back",
+        "transaction.conflicted",
+        "diff.updated",
+        "task.created",
+        "task.profile_resolved",
+        "task.started",
+        "task.progress",
+        "task.await_interrupted",
+        "task.completed",
+        "task.failed",
+        "task.cancelled",
+        "job.started",
+        "job.output",
+        "job.completed",
+        "job.failed",
+        "notification.update_available",
+        "notification.retry",
+        "error.provider",
+        "error.protocol",
+        "error.internal",
+        "usage.updated",
+        "permission.changed",
+        "token_saving.changed",
+        "token_saving.policy_applied",
+        "token_saving.relaxed",
+        "assistant.thinking",
+        "model.capability_snapshot",
+        "model.route_decided",
+        "model.phase_changed",
+        "model.route_changed",
+        "model.route_escalated",
+        "reasoning.epoch_started",
+        "reasoning.epoch_reset",
+        "reasoning.context_effective",
+        "context.plan_created",
+        "context.evidence_selected",
+        "context.evidence_invalidated",
+        "context.observation_ingested",
+        "context.pack_compiled",
+        "context.item_evicted",
+        "context.evidence_rejected",
+        "context.cache_segment",
+        "context.scope_created",
+        "context.scope_seeded",
+        "context.handoff_created",
+        "context.handoff_validation_failed",
+        "context.handoff_accepted",
+        "context.handoff_rejected",
+        "context.handoff_consumed",
+        "context.scope_disposed",
+        "cache.plan_created",
+        "cache.write_observed",
+        "cache.read_observed",
+        "program.started",
+        "program.tool_call_started",
+        "program.tool_call_completed",
+        "program.completed",
+        "program.failed",
+        "hosted_agent.spawned",
+        "hosted_agent.progress",
+        "hosted_agent.completed",
+        "hosted_agent.cancelled",
+        "tool.batch_started",
+        "tool.batch_completed",
+        "evidence.recorded",
+        "evidence.invalidated",
+        "verification.coverage_updated",
+        "verification.plan_created",
+        "verification.step_started",
+        "verification.step_completed",
+        "verification.escalated",
+        "budget.plan_created",
+        "budget.reservation_changed",
+        "budget.guard_triggered",
+        "budget.exhausted",
+        "retrieval.plan_created",
+        "retrieval.preview_completed",
+        "retrieval.exact_selected",
+        "retrieval.coverage_updated",
+        "retrieval.completed",
+        "verification.blocked_completion",
+        "run.trace_started",
+        "repository.orientation_started",
+        "repository.orientation_completed",
+        "repository.full_scan_started",
+        "repository.full_scan_completed",
+        "context.prepare_started",
+        "context.prepare_completed",
+        "prompt.compile_started",
+        "prompt.compile_completed",
+        "provider.connection_started",
+        "provider.connection_ready",
+        "provider.request_sent",
+        "provider.response_created",
+        "provider.first_delta",
+        "provider.response_completed",
+        "provider.fallback",
+        "verification.started",
+        "verification.completed",
+        "review.started",
+        "review.completed",
+        "run.trace_completed"
+      ]
+    },
+    "mustJournal": {
+      "description": "20.9's MUST-journal set: final text, tool intent and result summaries, approvals, mutations, usage, and task transitions. Every kind here has durability 'journaled' by default and a factory may not weaken it.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/kind"
+      }
+    },
+    "finalStatusPayload": {
+      "description": "8.9: the payload of the run.completed event a `cbc run` appends after the turn's single turn.completed. The exitCode here is the same value the process exits with.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "exitCode",
+        "changedFiles"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "completed",
+            "partial",
+            "failed",
+            "cancelled"
+          ]
+        },
+        "exitCode": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10
+        },
+        "changedFiles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tests": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "passed",
+            "failed",
+            "notRun"
+          ],
+          "properties": {
+            "passed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "failed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "notRun": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "assistant.thinking"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/thinkingPayload"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "enum": [
+              "program.started",
+              "program.tool_call_started",
+              "program.tool_call_completed",
+              "program.completed",
+              "program.failed",
+              "hosted_agent.spawned",
+              "hosted_agent.progress",
+              "hosted_agent.completed",
+              "hosted_agent.cancelled",
+              "tool.batch_started",
+              "tool.batch_completed"
+            ]
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "turnId",
+          "agentId",
+          "callerId",
+          "taskEpochId"
+        ]
+      }
+    }
+  ]
+}

package/share/capybara/schemas/protocol/handshake.schema.json

@@ -0,0 +1,207 @@
+{
+  "x-dialect": "json-schema-draft-2020-12",
+  "$id": "cbc:protocol/handshake",
+  "title": "runtime.initialize",
+  "description": "PRD 20.2. The first exchange on the framed transport. 24.5 forbids overclaiming a sandbox, so every capability in the result is a literal fact about the host rather than an aspirational default; crates/cbc-protocol/src/handshake.rs and packages/protocol-ts/src/client.ts both mirror this.",
+  "type": "object",
+  "$defs": {
+    "clientCapabilities": {
+      "description": "What the control plane is prepared to handle. Absent fields default to false, so an older client never appears to support something it does not.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "pty": {
+          "type": "boolean",
+          "default": false
+        },
+        "eventJournal": {
+          "type": "boolean",
+          "default": false
+        },
+        "credentialLease": {
+          "type": "boolean",
+          "default": false
+        },
+        "artifactHandles": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "interactionMode": {
+      "description": "Initial runtime enforcement mode. Plan is read-only and only accepted after startup recovery is quiescent.",
+      "type": "string",
+      "enum": [
+        "build",
+        "plan"
+      ],
+      "default": "build"
+    },
+    "runtimeCapabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enhancedSandbox",
+        "keychain",
+        "pty",
+        "git",
+        "sandboxLevel",
+        "sandboxBackends",
+        "platform",
+        "arch",
+        "maxFrameBytes",
+        "artifactStore",
+        "eventJournal"
+      ],
+      "properties": {
+        "enhancedSandbox": {
+          "description": "R-06: true only when an OS-level confinement beyond the path guard is actually active.",
+          "type": "boolean"
+        },
+        "keychain": {
+          "description": "9.3 storage backend. 'session-only' and 'encrypted-file' are weaker promises than 'os-native' and must be reported as such.",
+          "type": "string",
+          "enum": [
+            "os-native",
+            "encrypted-file",
+            "session-only",
+            "unavailable"
+          ]
+        },
+        "pty": {
+          "type": "boolean"
+        },
+        "git": {
+          "type": "boolean"
+        },
+        "sandboxLevel": {
+          "description": "14.4 enforcement level actually achieved on this host.",
+          "type": "string",
+          "enum": [
+            "none",
+            "workspace",
+            "standard",
+            "strict"
+          ]
+        },
+        "sandboxBackends": {
+          "description": "Named mechanisms in use, e.g. landlock, seccomp, seatbelt. Empty means the path guard alone.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "platform": {
+          "type": "string"
+        },
+        "arch": {
+          "type": "string"
+        },
+        "maxFrameBytes": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "artifactStore": {
+          "type": "boolean"
+        },
+        "eventJournal": {
+          "type": "boolean"
+        }
+      }
+    },
+    "initializeParams": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocolVersion",
+        "clientVersion",
+        "workspace"
+      ],
+      "properties": {
+        "protocolVersion": {
+          "type": "string",
+          "pattern": "^\\d+(\\.\\d+)?$"
+        },
+        "clientVersion": {
+          "type": "string",
+          "minLength": 1
+        },
+        "workspace": {
+          "description": "Absolute path. The runtime canonicalizes it independently (14.2); the client's spelling is a request, not a fact.",
+          "type": "string",
+          "minLength": 1
+        },
+        "capabilities": {
+          "$ref": "#/$defs/clientCapabilities"
+        },
+        "dataDir": {
+          "description": "Overrides the durable data directory. Used by CAPYBARA_DATA_DIR and by tests (21.1).",
+          "type": "string"
+        },
+        "sandboxLevel": {
+          "description": "Requested sandbox level from configuration (sandbox.level). The runtime clamps it to what the host can actually enforce (RT-006) and reports only the effective level in its capabilities (24.5); enforcement lives in the runtime, never the control plane (P0-04).",
+          "type": "string",
+          "enum": [
+            "none",
+            "workspace",
+            "standard",
+            "strict"
+          ]
+        },
+        "networkForShell": {
+          "description": "sandbox.networkForShell. 'deny' forces network isolation on raw shells; 'ask' and 'allow' leave the per-call decision to the approval flow.",
+          "type": "string",
+          "enum": [
+            "deny",
+            "ask",
+            "allow"
+          ]
+        },
+        "interactionMode": {
+          "$ref": "#/$defs/interactionMode",
+          "default": "build"
+        },
+        "capabilityIssuerToken": {
+          "description": "Secret control-plane token required for runtime capability issuance.",
+          "type": "string",
+          "minLength": 32
+        }
+      }
+    },
+    "initializeResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocolVersion",
+        "runtimeVersion",
+        "workspaceId",
+        "capabilities"
+      ],
+      "properties": {
+        "protocolVersion": {
+          "type": "string",
+          "pattern": "^\\d+(\\.\\d+)?$"
+        },
+        "runtimeVersion": {
+          "type": "string",
+          "minLength": 1
+        },
+        "workspaceId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "capabilities": {
+          "$ref": "#/$defs/runtimeCapabilities"
+        }
+      }
+    }
+  },
+  "oneOf": [
+    {
+      "$ref": "#/$defs/initializeParams"
+    },
+    {
+      "$ref": "#/$defs/initializeResult"
+    }
+  ]
+}