@openwop/openwop-conformance 1.6.1 → 1.10.0

package/src/scenarios/multi-agent-confidence-escalation.test.ts

@@ -50,6 +50,7 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { pollUntilTerminal } from '../lib/polling.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 const FIXTURE = 'conformance-multi-agent-confidence-escalation';
@@ -84,7 +85,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-confidence-escalation: capability shape
   it('confidenceEscalationFloor (when advertised) MUST be in [0.5, 1.0]', async () => {
     const d = await readDiscovery();
     if (d === null) return;
-    const em = d.capabilities?.multiAgent?.executionModel;
+    const em = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel;
     if (em === undefined) return;
     const floor = em.confidenceEscalationFloor;
     if (floor === undefined) return;
@@ -101,8 +102,8 @@ describe.skipIf(HTTP_SKIP)('multi-agent-confidence-escalation: capability shape
 describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral (RFC 0039 §A)', () => {
   it('happy-path: low-confidence decision → confidence-escalated event + clarification interrupt + zero dispatch events', async () => {
     const d = await readDiscovery();
-    const supported = d?.capabilities?.multiAgent?.executionModel?.supported === true;
-    const versionRaw = d?.capabilities?.multiAgent?.executionModel?.version;
+    const supported = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.supported === true;
+    const versionRaw = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.version;
     const version = typeof versionRaw === 'number' ? versionRaw : 0;
     if (!supported || version < 2) return; // soft-skip — `version: 1` hosts pass via this absence
 
@@ -125,7 +126,7 @@ describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-confidence-escalation: behavioral
     // status — the host's own interrupt.md mapping determines the suffix).
     // When the host does NOT advertise the field, fall back to the canonical
     // either-status check.
-    const advertisedKind = d?.capabilities?.multiAgent?.executionModel?.confidenceEscalationInterruptKind;
+    const advertisedKind = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.confidenceEscalationInterruptKind;
     const isVendorKind = typeof advertisedKind === 'string' && /^x-host-[a-z][a-z0-9-]*-[a-z][a-z0-9-]*$/.test(advertisedKind);
     const isCanonicalKind = advertisedKind === 'clarification' || advertisedKind === 'approval';
 

package/src/scenarios/multi-agent-handoff-state-machine.test.ts

@@ -10,7 +10,7 @@
  * Asserts (Phase 1 — execution-loop + handoff state machine per spec/v1/multi-agent-execution.md):
  *
  *   1. Advertisement shape: when capabilities.multiAgent.executionModel.supported
- *      is present, version MUST be integer in [1, 4]; supported MUST be boolean.
+ *      is present, version MUST be integer in [1, 5]; supported MUST be boolean.
  *
  *   2. Behavioral (gated on supported: true + fixture availability): a
  *      supervisor → next-worker → child-completed run emits the 4 expected
@@ -34,6 +34,7 @@ import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { pollUntilTerminal } from '../lib/polling.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -62,7 +63,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-handoff-state-machine: advertisement sha
   it('capabilities.multiAgent.executionModel (when present) conforms to RFC 0037 §C', async () => {
     const d = await readDiscovery();
     if (d === null) return; // discovery unavailable — skip
-    const executionModel = d.capabilities?.multiAgent?.executionModel;
+    const executionModel = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel;
     if (executionModel === undefined) return; // host doesn't advertise — soft-skip
     expect(
       typeof executionModel.supported,
@@ -80,10 +81,10 @@ describe.skipIf(HTTP_SKIP)('multi-agent-handoff-state-machine: advertisement sha
     ).toBe('number');
     const v = executionModel.version as number;
     expect(
-      Number.isInteger(v) && v >= 1 && v <= 4,
+      Number.isInteger(v) && v >= 1 && v <= 5,
       driver.describe(
         'RFCS/0037-multi-agent-execution-model.md §C',
-        'version MUST be an integer in [1, 4] (1 = Phase 1 only; Phases 2-4 lift the ceiling additively)',
+        'version MUST be an integer in [1, 5] (1 = Phase 1 only; Phases 2-5 lift the ceiling additively — Phase 5 = RFC 0061 stateful agent-loop lifecycle, matching `capabilities.schema.json` §multiAgent.executionModel.version maximum)',
       ),
     ).toBe(true);
   });
@@ -104,7 +105,7 @@ const BEHAVIORAL_SKIP = HTTP_SKIP || !isFixtureAdvertised(PARENT_FIXTURE) || !is
 describe.skipIf(BEHAVIORAL_SKIP)('multi-agent-handoff-state-machine: behavioral 4-event causation chain (RFC 0037 §"Handoff state machine")', () => {
   it('happy-path: dispatch.began → dispatch.succeeded → child.completed → output.harvested fire in causation order', async () => {
     const d = await readDiscovery();
-    const advertised = d?.capabilities?.multiAgent?.executionModel?.supported === true;
+    const advertised = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.supported === true;
     if (!advertised) return; // soft-skip — host honest about not implementing
 
     const create = await driver.post('/v1/runs', { workflowId: PARENT_FIXTURE });

package/src/scenarios/multi-agent-memory-lifecycle.test.ts

@@ -48,6 +48,7 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -81,7 +82,7 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: advertisement shape (R
       ctx.skip();
       return;
     }
-    const ccmc = d.capabilities?.multiAgent?.executionModel?.crossChildMemoryConcurrency;
+    const ccmc = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.crossChildMemoryConcurrency;
     if (ccmc === undefined) {
       ctx.skip(); // optional advertisement — host hasn't opted in
       return;
@@ -135,8 +136,8 @@ describe.skipIf(HTTP_SKIP)('multi-agent-memory-lifecycle: behavioral (RFC 0039
       ctx.skip();
       return;
     }
-    const v = d.capabilities?.multiAgent?.executionModel?.version;
-    const memorySupported = d.capabilities?.memory?.supported;
+    const v = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.version;
+    const memorySupported = capabilityFamily<{ supported?: unknown }>(d, 'memory')?.supported;
     const phase2OrLater = typeof v === 'number' && v >= 2;
     const expiredRunId = process.env.OPENWOP_TEST_EXPIRED_REPLAY_RUN_ID;
     if (!phase2OrLater || memorySupported !== true || !expiredRunId) {

package/src/scenarios/multi-region-idempotency.test.ts

@@ -20,6 +20,7 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const ALLOWED = new Set(['single-region', 'best-effort', 'strict']);
 const REQUIRED_METRICS_WHEN_MULTI_REGION = [
@@ -40,9 +41,7 @@ interface ObservabilityCaps {
 describe('multi-region-idempotency: capability shape', () => {
   it('idempotency.crossRegion (when advertised) MUST be one of the closed enum', async () => {
     const disco = await driver.get('/.well-known/openwop');
-    const idem =
-      (disco.json as { capabilities?: { idempotency?: IdempotencyCaps } }).capabilities
-        ?.idempotency;
+    const idem = capabilityFamily<IdempotencyCaps>(disco.json, 'idempotency');
 
     if (!idem || idem.crossRegion === undefined) {
       // eslint-disable-next-line no-console
@@ -67,16 +66,16 @@ describe('multi-region-idempotency: capability shape', () => {
 
   it('multi-region hosts SHOULD expose the cross-region conflict counter per §"Operator surface"', async () => {
     const disco = await driver.get('/.well-known/openwop');
-    const caps = (disco.json as { capabilities?: { idempotency?: IdempotencyCaps; observability?: ObservabilityCaps } })
-      .capabilities;
-    const crossRegion = caps?.idempotency?.crossRegion;
+    const idem = capabilityFamily<IdempotencyCaps>(disco.json, 'idempotency');
+    const observability = capabilityFamily<ObservabilityCaps>(disco.json, 'observability');
+    const crossRegion = idem?.crossRegion;
 
     if (crossRegion !== 'best-effort' && crossRegion !== 'strict') {
       // Single-region hosts have no conflicts to count — skip.
       return;
     }
 
-    const advertised = new Set(caps?.observability?.metrics?.names ?? []);
+    const advertised = new Set(observability?.metrics?.names ?? []);
     for (const name of REQUIRED_METRICS_WHEN_MULTI_REGION) {
       expect(advertised.has(name), driver.describe(
         'idempotency.md §"Operator surface"',
@@ -103,9 +102,10 @@ interface MultiRegionCaps {
 describe('multi-region-idempotency: granular multiRegion advertisement shape (RFC 0036 §A)', () => {
   it('capabilities.idempotency.multiRegion (when present) conforms to RFC 0036 §A', async () => {
     const disco = await driver.get('/.well-known/openwop');
-    const idem =
-      (disco.json as { capabilities?: { idempotency?: IdempotencyCaps & { multiRegion?: MultiRegionCaps } } })
-        .capabilities?.idempotency;
+    const idem = capabilityFamily<IdempotencyCaps & { multiRegion?: MultiRegionCaps }>(
+      disco.json,
+      'idempotency',
+    );
     const mr = idem?.multiRegion;
     if (mr === undefined) return; // host doesn't advertise the granular block — soft-skip
 

package/src/scenarios/oauth-capability-shape.test.ts

@@ -18,6 +18,7 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryOAuthProvider {
   id?: string;
@@ -47,7 +48,7 @@ const VALID_GRANTS: ReadonlySet<string> = new Set([
 async function readOAuth(): Promise<DiscoveryOAuth | null> {
   const res = await driver.get('/.well-known/openwop');
   const body = res.json as DiscoveryDoc | undefined;
-  return body?.capabilities?.oauth ?? null;
+  return capabilityFamily(body, 'oauth') ?? null;
 }
 
 describe('oauth-capability-shape: advertisement shape (RFC 0047 §A)', () => {

package/src/scenarios/oauth-connector-redaction.test.ts

@@ -26,6 +26,7 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryOAuth {
   supported?: boolean;
@@ -42,7 +43,7 @@ const TOKEN_CANARY = 'OPENWOP_OAUTH_CANARY_b7d3e1a9c2';
 async function readOAuth(): Promise<DiscoveryOAuth | null> {
   const res = await driver.get('/.well-known/openwop');
   const body = res.json as DiscoveryDoc | undefined;
-  return body?.capabilities?.oauth ?? null;
+  return capabilityFamily(body, 'oauth') ?? null;
 }
 
 describe('oauth-connector-redaction: advertisement shape (RFC 0047 §A)', () => {

package/src/scenarios/pause-resume.test.ts

@@ -19,6 +19,7 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 import { pollUntilStatus, pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 
@@ -235,9 +236,8 @@ describe.skipIf(SKIP)('pause/resume: drainPolicy discrimination per capabilities
   it('every drainPolicy advertised by the host is accepted on :pause', async () => {
     const disco = await driver.get('/.well-known/openwop');
     const drainPolicies =
-      (disco.json as {
-        capabilities?: { runs?: { pauseResume?: { drainPolicies?: string[] } } };
-      }).capabilities?.runs?.pauseResume?.drainPolicies ?? [];
+      capabilityFamily<{ pauseResume?: { drainPolicies?: string[] } }>(disco.json, 'runs')
+        ?.pauseResume?.drainPolicies ?? [];
     if (drainPolicies.length === 0) {
       // eslint-disable-next-line no-console
       console.warn('[pause-resume] host advertises no drainPolicies; skipping policy-discrimination subtest');

package/src/scenarios/production-backpressure.test.ts

@@ -40,6 +40,7 @@ import { driver } from '../lib/driver.js';
 import { loadEnv } from '../lib/env.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface BackpressureCaps {
   supported?: boolean;
@@ -54,8 +55,7 @@ interface ProductionCaps {
 
 async function readProductionCaps(): Promise<ProductionCaps | undefined> {
   const disco = await driver.get('/.well-known/openwop');
-  return (disco.json as { capabilities?: { production?: ProductionCaps } })
-    .capabilities?.production;
+  return capabilityFamily<ProductionCaps>(disco.json, 'production');
 }
 
 function isProfileAdvertised(prod: ProductionCaps | undefined): boolean {

package/src/scenarios/production-retention-expiry.test.ts

@@ -31,6 +31,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface RetentionCaps {
   supported?: boolean;
@@ -45,8 +46,7 @@ interface ProductionCaps {
 
 async function readProductionCaps(): Promise<ProductionCaps | undefined> {
   const disco = await driver.get('/.well-known/openwop');
-  return (disco.json as { capabilities?: { production?: ProductionCaps } })
-    .capabilities?.production;
+  return capabilityFamily<ProductionCaps>(disco.json, 'production');
 }
 
 function isProfileAdvertised(prod: ProductionCaps | undefined): boolean {

package/src/scenarios/prompt-all-four-kinds-events.test.ts

@@ -34,6 +34,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const WORKFLOW_ID = 'conformance-prompt-all-four-kinds';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(WORKFLOW_ID);
@@ -64,7 +65,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.supported === true;
+  return capabilityFamily(d, 'prompts')?.supported === true;
 }
 
 async function readAllEvents(runId: string): Promise<RunEventDoc[]> {

package/src/scenarios/prompt-composed-secret-redaction.test.ts

@@ -33,6 +33,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -63,7 +64,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsSupportFull(d: DiscoveryDoc | null): boolean {
-  const p = d?.capabilities?.prompts;
+  const p = capabilityFamily(d, 'prompts');
   if (!p) return false;
   return p.supported === true && p.observability === 'full';
 }

package/src/scenarios/prompt-composed-trust-marker.test.ts

@@ -32,6 +32,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -59,7 +60,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsSupportFull(d: DiscoveryDoc | null): boolean {
-  const p = d?.capabilities?.prompts;
+  const p = capabilityFamily(d, 'prompts');
   if (!p) return false;
   return p.supported === true && p.observability === 'full';
 }

package/src/scenarios/prompt-end-to-end-events.test.ts

@@ -34,6 +34,7 @@ import { driver } from '../lib/driver.js';
 import { pollUntilTerminal } from '../lib/polling.js';
 import { isFixtureAdvertised } from '../lib/fixtures.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const WORKFLOW_ID = 'conformance-prompt-end-to-end';
 const SKIP_NO_FIXTURE = !isFixtureAdvertised(WORKFLOW_ID);
@@ -64,7 +65,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.supported === true;
+  return capabilityFamily(d, 'prompts')?.supported === true;
 }
 
 /** Drain the run's event log via polling. The fixture is tiny so all

package/src/scenarios/prompt-list-and-fetch.test.ts

@@ -34,6 +34,7 @@ import { join } from 'node:path';
 import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -65,7 +66,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function endpointsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.endpointsSupported === true;
+  return capabilityFamily(d, 'prompts')?.endpointsSupported === true;
 }
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;

package/src/scenarios/prompt-mutable-lifecycle.test.ts

@@ -35,6 +35,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -60,7 +61,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function mutableSupport(d: DiscoveryDoc | null): boolean {
-  const p = d?.capabilities?.prompts;
+  const p = capabilityFamily(d, 'prompts');
   return p?.endpointsSupported === true && p?.mutableLibrary === true;
 }
 

package/src/scenarios/prompt-mutation-workspace-membership-enforced.test.ts

@@ -41,6 +41,7 @@
 import { describe, it, expect } from 'vitest';
 import { randomUUID } from 'node:crypto';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -71,7 +72,7 @@ describe.skipIf(HTTP_SKIP)(
         ctx.skip();
         return;
       }
-      const mutableLibrary = d.capabilities?.prompts?.mutableLibrary;
+      const mutableLibrary = capabilityFamily(d, 'prompts')?.mutableLibrary;
       if (mutableLibrary !== true) {
         ctx.skip();
         return;

package/src/scenarios/prompt-pack-install.test.ts

@@ -46,6 +46,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -79,7 +80,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function endpointsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.endpointsSupported === true;
+  return capabilityFamily(d, 'prompts')?.endpointsSupported === true;
 }
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;

package/src/scenarios/prompt-read-workspace-membership-enforced.test.ts

@@ -67,6 +67,7 @@
 import { describe, it, expect } from 'vitest';
 import { randomUUID } from 'node:crypto';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -101,7 +102,7 @@ describe.skipIf(HTTP_SKIP)(
         ctx.skip();
         return;
       }
-      const promptsSupported = d.capabilities?.prompts?.supported;
+      const promptsSupported = capabilityFamily(d, 'prompts')?.supported;
       if (promptsSupported !== true) {
         ctx.skip();
         return;

package/src/scenarios/prompt-render-deterministic.test.ts

@@ -23,6 +23,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -60,7 +61,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function endpointsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.endpointsSupported === true;
+  return capabilityFamily(d, 'prompts')?.endpointsSupported === true;
 }
 
 /** Pick a template that has at least one input-source variable

package/src/scenarios/prompt-resolution-chain-agent-intrinsic.test.ts

@@ -30,6 +30,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -60,7 +61,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsAgentBindings(d: DiscoveryDoc | null): boolean {
-  const p = d?.capabilities?.prompts;
+  const p = capabilityFamily(d, 'prompts');
   if (!p) return false;
   return p.supported === true && p.agentBindings === true;
 }

package/src/scenarios/prompt-resolution-chain-fallback-cascade.test.ts

@@ -31,6 +31,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -60,7 +61,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.supported === true;
+  return capabilityFamily(d, 'prompts')?.supported === true;
 }
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;

package/src/scenarios/prompt-resolution-chain-node-wins.test.ts

@@ -29,6 +29,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { behaviorGate } from '../lib/behavior-gate.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -58,7 +59,7 @@ async function readDiscovery(): Promise<DiscoveryDoc | null> {
 }
 
 function promptsSupported(d: DiscoveryDoc | null): boolean {
-  return d?.capabilities?.prompts?.supported === true;
+  return capabilityFamily(d, 'prompts')?.supported === true;
 }
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;

package/src/scenarios/prompt-template-shape.test.ts

@@ -33,6 +33,7 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const PROMPT_KIND_VALUES = ['system', 'user', 'few-shot', 'schema-hint'] as const;
 
@@ -326,7 +327,7 @@ describe.skipIf(HTTP_SKIP)('prompt-template-shape: capabilities.prompts advertis
   it('capabilities.prompts (when present) carries the optional shape per RFC 0027 §D', async () => {
     const d = await readDiscovery();
     if (d === null) return;
-    const prompts = d.capabilities?.prompts;
+    const prompts = capabilityFamily(d, 'prompts');
     if (prompts === undefined) return; // optional block; host MAY omit
     expect(
       typeof prompts.supported,

package/src/scenarios/provider-usage.test.ts

@@ -26,6 +26,7 @@ import { join } from 'node:path';
 import { driver } from '../lib/driver.js';
 import { SCHEMAS_DIR } from '../lib/paths.js';
 import { queryTestEvents, isEventLogSeamAvailable, resetTestSeam } from '../lib/event-log-query.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 interface DiscoveryDoc {
   capabilities?: {
@@ -36,7 +37,7 @@ interface DiscoveryDoc {
 async function readProviderUsageCap(): Promise<{ supported?: boolean; costEstimates?: boolean; currency?: string } | null> {
   const res = await driver.get('/.well-known/openwop');
   const body = res.json as DiscoveryDoc | undefined;
-  const cap = body?.capabilities?.providerUsage;
+  const cap = capabilityFamily(body, 'providerUsage');
   return cap && typeof cap === 'object' ? cap : null;
 }
 

package/src/scenarios/replay-divergence-at-refusal.test.ts

@@ -46,6 +46,7 @@
 
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -79,7 +80,7 @@ describe.skipIf(HTTP_SKIP)('replay-divergence-at-refusal: advertisement shape (R
       ctx.skip();
       return;
     }
-    const rd = d.capabilities?.multiAgent?.executionModel?.replayDeterminism;
+    const rd = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.replayDeterminism;
     if (rd === undefined) {
       ctx.skip(); // optional advertisement — host hasn't opted in
       return;
@@ -94,7 +95,7 @@ describe.skipIf(HTTP_SKIP)('replay-divergence-at-refusal: advertisement shape (R
     ).toBe('boolean');
 
     if (rd.supported === true) {
-      const version = d.capabilities?.multiAgent?.executionModel?.version as number | undefined;
+      const version = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.version as number | undefined;
       expect(
         typeof version === 'number' && version >= 4,
         driver.describe(
@@ -170,7 +171,7 @@ describe.skipIf(HTTP_SKIP)('replay-divergence-at-refusal: behavioral (RFC 0041
 
   async function gateOnPhase4(ctx: { skip: () => void }): Promise<boolean> {
     const d = await readDiscovery();
-    const rd = d?.capabilities?.multiAgent?.executionModel?.replayDeterminism;
+    const rd = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel?.replayDeterminism;
     if (rd?.supported !== true || rd?.refusalDivergenceEmission !== true) {
       ctx.skip();
       return false;

package/src/scenarios/replay-fork-arbitrary.test.ts

@@ -110,7 +110,9 @@ function structuralShape(
   return events.map((e) => ({
     type: e.type,
     nodeId: e.nodeId ?? null,
-    data: e.data ?? null,
+    // Canonical `payload` (run-event.schema.json) with the legacy `data`
+    // field as a fallback for hosts that haven't migrated their envelope.
+    data: e.payload ?? e.data ?? null,
   }));
 }
 

package/src/scenarios/replay-llm-cache-key-portable.test.ts

@@ -53,6 +53,7 @@
 import { describe, it, expect } from 'vitest';
 import { driver } from '../lib/driver.js';
 import { expectedCacheKey, callCacheKeySeam as callSeam } from '../lib/llm-cache-key-recipe.js';
+import { capabilityFamily } from '../lib/discovery-capabilities.js';
 
 const HTTP_SKIP = !process.env.OPENWOP_BASE_URL;
 
@@ -167,7 +168,7 @@ describe.skipIf(HTTP_SKIP)('replay-llm-cache-key-portable: non-recipe-field inva
 describe.skipIf(HTTP_SKIP)('replay-llm-cache-key-portable: Phase 4 advertisement alignment (RFC 0041 §D)', () => {
   it('hosts advertising version: 4 MUST advertise replayDeterminism.llmCacheKeyRecipe', async (ctx) => {
     const d = await readDiscovery();
-    const em = d?.capabilities?.multiAgent?.executionModel;
+    const em = capabilityFamily<{ executionModel?: { [k: string]: unknown; crossHostCausation?: Record<string, unknown>; replayDeterminism?: Record<string, unknown> } }>(d, 'multiAgent')?.executionModel;
     const version = em?.version;
     if (typeof version !== 'number' || version < 4) {
       ctx.skip(); // pre-Phase-4 or no multiAgent advertisement

package/src/scenarios/replayDeterminism.test.ts

@@ -60,7 +60,9 @@ function structuralShape(events: readonly RawEvent[]): Array<{ type: unknown; no
   return events.map((e) => ({
     type: e.type,
     nodeId: e.nodeId ?? null,
-    data: e.data ?? null,
+    // Canonical `payload` (run-event.schema.json) with the legacy `data`
+    // field as a fallback for hosts that haven't migrated their envelope.
+    data: e.payload ?? e.data ?? null,
   }));
 }