@fusionkit/protocol 0.1.0

package/dist/vocabulary.js

@@ -0,0 +1,79 @@
+export const RUN_STATUSES = [
+    "created",
+    "claimed",
+    "provisioning",
+    "running",
+    "awaiting_approval",
+    "completed",
+    "failed",
+    "cancelled"
+];
+export const TERMINAL_RUN_STATUSES = [
+    "completed",
+    "failed",
+    "cancelled"
+];
+export const AGENT_KINDS = [
+    "claude-code",
+    "codex",
+    "pi",
+    "mock",
+    "command"
+];
+export const SESSION_ISOLATIONS = [
+    "process",
+    "hermetic",
+    "vercel-sandbox"
+];
+export const DISCLOSURE_MODES = [
+    "none",
+    "metadata-only",
+    "redacted",
+    "minimal-context",
+    "full"
+];
+export const CHECKPOINT_TIERS = [
+    "semantic",
+    "workspace"
+];
+export const ACTOR_KINDS = [
+    "human",
+    "service"
+];
+/**
+ * Every event type a run can record. The `Record` satisfies-check makes the
+ * map provably complete: adding a `RunEvent` variant fails compilation here
+ * until the vocabulary (and therefore every renderer parity test) learns
+ * it. Renderers that cannot import this module (the dependency-free control
+ * panel) are held to the same set by a parity test instead.
+ */
+const RUN_EVENT_TYPE_MAP = {
+    "run.created": true,
+    "run.claimed": true,
+    "workspace.materialized": true,
+    "policy.evaluated": true,
+    "consent.requested": true,
+    "consent.granted": true,
+    "secret.released": true,
+    "command.executed": true,
+    "file.changed": true,
+    "network.connected": true,
+    "model.called": true,
+    "boundary.crossed": true,
+    "artifact.created": true,
+    "checkpoint.created": true,
+    "run.completed": true,
+    "run.failed": true,
+    "run.cancelled": true
+};
+export const RUN_EVENT_TYPES = Object.keys(RUN_EVENT_TYPE_MAP);
+export const HEX_HASH_PATTERN = /^[0-9a-f]{64}$/;
+function includes(values, value) {
+    return values.includes(value);
+}
+export function isTerminalStatus(status) {
+    return includes(TERMINAL_RUN_STATUSES, status);
+}
+export function isAgentKind(value) {
+    return includes(AGENT_KINDS, value);
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@fusionkit/protocol",
+  "private": false,
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velum-labs/handoffkit.git",
+    "directory": "packages/protocol"
+  },
+  "description": "Warrant protocol schemas and primitives: contracts, receipts, event chains, manifests, checkpoints, and handoff envelopes. Zero runtime dependencies.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public",
+    "provenance": true
+  }
+}