@clowder-ai/plugin-contract 0.1.0-beta.9 → 0.2.0

package/dist/wire/row-shapes.d.ts

@@ -2,14 +2,14 @@
  * Per-row input/result shapes for the 13-row method registry.
  * Mechanized from #1165 frozen shape.
  *
- * CLOSED rows (1, 2, 5, 7, 10, 11, 12): full executable shapes with bounds.
- * RESERVED rows (3, 4, 6, 8, 9): type stubs only — no executable
- * contract may be exported until the row's matrix entries close.
+ * Every row has a closed executable target shape. Rows 3–9 are exposed for
+ * the beta.11 M0-C slice; registry readiness still depends on the exact
+ * source-admission and byte-proof evidence tracked by that slice.
  *
  * Each closed row's shape is additionalProperties: false.
  * Bounds constants are provided for runtime validation.
  */
-import type { GrantSnapshot } from './grants.js';
+import type { AppendElementsRequest, AppendReceipt, M0CAckInput, M0CAckResult, PluginDeliveryInput, PluginDeliveryReceipt, M0CReadEmptyResult, M0CReadInput, M0CReadNormalResult, M0CReadResult, M0CReadStaleResult, M0CSnapshotFinalResult, M0CSnapshotInput, M0CSnapshotIntermediateResult, M0CSnapshotResult, M0CSubscribeInput, M0CSubscribeResult, MediaReadInput as GeneratedMediaReadInput, MediaReadResult as GeneratedMediaReadResult, MessageDraft, SendReceipt } from '../generated/contract.generated.js';
 import type { BrokerReadyParams, CandidateHello, SessionBinding } from './handshake.js';
 /**
  * Row 5 input: subscribe to a handle for event delivery.
@@ -18,18 +18,12 @@ import type { BrokerReadyParams, CandidateHello, SessionBinding } from './handsh
  * The handle is a reference identifier (1..256 code points, M4 CLOSED).
  * The peer responds with a subscriptionId for subsequent read/ack calls.
  */
-export interface SubscribeInput {
-    /** M4 CLOSED — 1..256 code points. */
-    readonly handle: string;
-}
+export type SubscribeInput = M0CSubscribeInput;
 /**
  * Row 5 result: the created subscription identifier.
  * Wire shape: `{ subscriptionId: string }` — additionalProperties: false.
  */
-export interface SubscribeResult {
-    /** M4 CLOSED — 1..128 code points. */
-    readonly subscriptionId: string;
-}
+export type SubscribeResult = M0CSubscribeResult;
 /** Minimum code-point length for subscribe handle. */
 export declare const SUBSCRIBE_HANDLE_MIN_LENGTH: 1;
 /** Maximum code-point length for subscribe handle. */
@@ -55,17 +49,12 @@ export declare const SUBSCRIBE_SUBSCRIPTION_ID_MAX_ENCODED_BYTES: 770;
  *
  * Closed shape per R3 addendum (owner-specified).
  */
-export interface MessagingAckRequest {
-    /** M4 CLOSED — 1..128 code points. */
-    readonly subscriptionId: string;
-    /** M4 CLOSED — 1..512 code points. */
-    readonly ackToken: string;
-}
+export type MessagingAckRequest = M0CAckInput;
 /**
  * Row 7 result: null.
  * Ack is fire-and-confirm — a null result signals success.
  */
-export type MessagingAckResult = null;
+export type MessagingAckResult = M0CAckResult;
 /** Minimum code-point length for ack subscriptionId. */
 export declare const ACK_SUBSCRIPTION_ID_MIN_LENGTH: 1;
 /** Maximum code-point length for ack subscriptionId. */
@@ -95,7 +84,10 @@ export declare const ACK_TOKEN_MAX_ENCODED_BYTES: 3074;
  *
  * additionalProperties: false. CLOSED.
  */
-export type GrantsChangedInput = GrantSnapshot;
+/**
+ * Runtime key set mirror of {@link GrantsChangedInput} (= GrantSnapshot).
+ * additionalProperties: false — { grantRevision, effectiveGrants }.
+ */
 export type { GrantSnapshot } from './grants.js';
 /**
  * Row 11 input: liveness ping carrying a nonce.
@@ -107,6 +99,11 @@ export interface PingInput {
     /** M4 CLOSED — string 1..512 code points. */
     readonly nonce: string;
 }
+/**
+ * Runtime key set mirror of the {@link PingInput} interface.
+ * additionalProperties: false — { nonce }.
+ */
+export declare const PING_INPUT_KEYS: ReadonlySet<string>;
 /**
  * Row 11 result: echo of the input nonce.
  * Wire shape: `{ nonce: string }` — additionalProperties: false.
@@ -117,6 +114,11 @@ export interface PingResult {
     /** Byte-equal echo of the input nonce. */
     readonly nonce: string;
 }
+/**
+ * Runtime key set mirror of the {@link PingResult} interface.
+ * additionalProperties: false — { nonce }.
+ */
+export declare const PING_RESULT_KEYS: ReadonlySet<string>;
 /** Minimum code-point length for ping nonce. */
 export declare const PING_NONCE_MIN_LENGTH: 1;
 /** Maximum code-point length for ping nonce. */
@@ -137,19 +139,15 @@ export declare const PING_NONCE_MAX_ENCODED_BYTES: 3074;
  *
  * W2 covers "row 12 `params.input.deadlineUnixMs`".
  */
-export interface DrainInput {
-    /**
-     * Drain-specific deadline.
-     * WireUInt53(1, 9_007_199_254_740_991) — same profile as CallMeta.
-     */
-    readonly deadlineUnixMs: number;
-}
+/**
+ * Runtime key set mirror of the {@link DrainInput} interface.
+ * additionalProperties: false — { deadlineUnixMs }.
+ */
 /**
  * Row 12 result: null.
  * Drain is fire-and-confirm — a null result signals the plugin
  * has completed its graceful shutdown sequence.
  */
-export type DrainResult = null;
 /**
  * Row 1 — broker.hello: CLOSED in beta.8.
  *
@@ -168,45 +166,64 @@ export type HelloResult = SessionBinding;
 export type ReadyInput = BrokerReadyParams;
 export type ReadyResult = null;
 /**
- * Row 3 — messaging.send: RESERVED (M1/M2/M5/I1).
- *
- * Plugin → Host message send. The domain types (MessageDraft,
- * SendReceipt) exist in the generated contract types, but the wire
- * input/result shapes remain reserved until the row's matrix entries close.
- */
-export type SendInput = never;
-export type SendResult = never;
-/**
- * Row 4 — messaging.appendElements: RESERVED (M1/M2/M5/I1).
- *
- * Plugin → Host element append. The domain types exist in the
- * generated contract types, but the wire input/result shapes remain
- * reserved until the row's matrix entries close.
- */
-export type AppendInput = never;
-export type AppendResult = never;
-/**
- * Row 6 — messaging.read: RESERVED (M1/M2/M3/M4/M5/M6/M7/I1).
- *
- * Plugin → Host subscription read. The wire input/result shapes
- * remain reserved until the row's matrix entries close.
- */
-export type ReadInput = never;
-export type ReadResult = never;
-/**
- * Row 8 — messaging.snapshot: RESERVED (M1/M2/M5/M7/I1).
- *
- * Plugin → Host snapshot request. The wire input/result shapes
- * remain reserved until the row's matrix entries close.
- */
-export type SnapshotInput = never;
-export type SnapshotResult = never;
-/**
- * Row 9 — host.messaging.deliver: RESERVED (M1/M2/M5/M7/I1).
- *
- * Host → Plugin delivery push. The wire input/result shapes
- * remain reserved until the row's matrix entries close.
- */
-export type DeliverInput = never;
-export type DeliverResult = never;
+ * Row 3 — messaging.send.
+ * Plugin → Host message send using the canonical generated domain types.
+ */
+export type SendInput = MessageDraft;
+export type SendResult = SendReceipt;
+/**
+ * Row 4 — messaging.appendElements.
+ * Plugin → Host append with revision-CAS settlement in K-1.
+ */
+export type AppendInput = AppendElementsRequest;
+export type AppendResult = AppendReceipt;
+/**
+ * Row 6 request. No page token is exposed: reads resume from the Host-owned
+ * acknowledged cursor.
+ */
+export type SubscriptionReadPageRequest = M0CReadInput;
+export type SubscriptionNormalPageResponse = M0CReadNormalResult;
+export type SubscriptionEmptyPageResponse = M0CReadEmptyResult;
+export type SubscriptionStalePageResponse = M0CReadStaleResult;
+/** Closed three-variant row-6 result. */
+export type BoundedSubscriptionReadPageResponse = M0CReadResult;
+export type ReadInput = SubscriptionReadPageRequest;
+export type ReadResult = BoundedSubscriptionReadPageResponse;
+export declare const READ_SUBSCRIPTION_ID_MIN_LENGTH: 1;
+export declare const READ_SUBSCRIPTION_ID_MAX_LENGTH: 128;
+export declare const READ_LIMIT_MIN: 1;
+export declare const READ_LIMIT_MAX: 32;
+export declare const READ_ACK_TOKEN_MIN_LENGTH: 1;
+export declare const READ_ACK_TOKEN_MAX_LENGTH: 512;
+/**
+ * Row 8 request. An absent pageToken starts an immutable Host view.
+ */
+export type SnapshotPageRequest = M0CSnapshotInput;
+export type SnapshotIntermediatePageResponse = M0CSnapshotIntermediateResult;
+export type SnapshotFinalPageResponse = M0CSnapshotFinalResult;
+/** Closed intermediate/final row-8 result. */
+export type SnapshotPageResponse = M0CSnapshotResult;
+export type SnapshotInput = SnapshotPageRequest;
+export type SnapshotResult = SnapshotPageResponse;
+export declare const SNAPSHOT_SUBSCRIPTION_ID_MIN_LENGTH: 1;
+export declare const SNAPSHOT_SUBSCRIPTION_ID_MAX_LENGTH: 128;
+export declare const SNAPSHOT_MAX_ITEMS_MIN: 1;
+export declare const SNAPSHOT_MAX_ITEMS_MAX: 64;
+export declare const SNAPSHOT_PAGE_TOKEN_MIN_LENGTH: 1;
+export declare const SNAPSHOT_PAGE_TOKEN_MAX_LENGTH: 512;
+export declare const SNAPSHOT_ACK_TOKEN_MIN_LENGTH: 1;
+export declare const SNAPSHOT_ACK_TOKEN_MAX_LENGTH: 512;
+/**
+ * Row 9 — Host → Plugin callback request and byte-equal acknowledgement.
+ */
+export type HostMessagingDeliverRequest = PluginDeliveryInput;
+export type HostMessagingDeliverResult = PluginDeliveryReceipt;
+export type DeliverInput = HostMessagingDeliverRequest;
+export type DeliverResult = HostMessagingDeliverResult;
+export declare const DELIVER_DELIVERY_ID_MIN_LENGTH: 1;
+export declare const DELIVER_DELIVERY_ID_MAX_LENGTH: 128;
+/** P1 media byte streaming row. Each result is bounded to one 512 KiB chunk. */
+export type MediaReadInput = GeneratedMediaReadInput;
+export type MediaReadResult = GeneratedMediaReadResult;
+export declare const MEDIA_READ_CHUNK_MAX_BYTES: 524288;
 //# sourceMappingURL=row-shapes.d.ts.map

package/dist/wire/row-shapes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"row-shapes.d.ts","sourceRoot":"","sources":["../../src/wire/row-shapes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"row-shapes.d.ts","sourceRoot":"","sources":["../../src/wire/row-shapes.ts"],"names":[],"mappings":"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"}

package/dist/wire/row-shapes.js

@@ -2,9 +2,9 @@
  * Per-row input/result shapes for the 13-row method registry.
  * Mechanized from #1165 frozen shape.
  *
- * CLOSED rows (1, 2, 5, 7, 10, 11, 12): full executable shapes with bounds.
- * RESERVED rows (3, 4, 6, 8, 9): type stubs only — no executable
- * contract may be exported until the row's matrix entries close.
+ * Every row has a closed executable target shape. Rows 3–9 are exposed for
+ * the beta.11 M0-C slice; registry readiness still depends on the exact
+ * source-admission and byte-proof evidence tracked by that slice.
  *
  * Each closed row's shape is additionalProperties: false.
  * Bounds constants are provided for runtime validation.
@@ -46,6 +46,16 @@ export const ACK_TOKEN_MAX_LENGTH = 512;
  * 6 * 512 + 2 quotes = 3074 bytes.
  */
 export const ACK_TOKEN_MAX_ENCODED_BYTES = 3074;
+/**
+ * Runtime key set mirror of the {@link PingInput} interface.
+ * additionalProperties: false — { nonce }.
+ */
+export const PING_INPUT_KEYS = new Set(['nonce']);
+/**
+ * Runtime key set mirror of the {@link PingResult} interface.
+ * additionalProperties: false — { nonce }.
+ */
+export const PING_RESULT_KEYS = new Set(['nonce']);
 /** Minimum code-point length for ping nonce. */
 export const PING_NONCE_MIN_LENGTH = 1;
 /** Maximum code-point length for ping nonce. */
@@ -56,4 +66,21 @@ export const PING_NONCE_MAX_LENGTH = 512;
  * 6 * 512 + 2 quotes = 3074 bytes.
  */
 export const PING_NONCE_MAX_ENCODED_BYTES = 3074;
+export const READ_SUBSCRIPTION_ID_MIN_LENGTH = 1;
+export const READ_SUBSCRIPTION_ID_MAX_LENGTH = 128;
+export const READ_LIMIT_MIN = 1;
+export const READ_LIMIT_MAX = 32;
+export const READ_ACK_TOKEN_MIN_LENGTH = 1;
+export const READ_ACK_TOKEN_MAX_LENGTH = 512;
+export const SNAPSHOT_SUBSCRIPTION_ID_MIN_LENGTH = 1;
+export const SNAPSHOT_SUBSCRIPTION_ID_MAX_LENGTH = 128;
+export const SNAPSHOT_MAX_ITEMS_MIN = 1;
+export const SNAPSHOT_MAX_ITEMS_MAX = 64;
+export const SNAPSHOT_PAGE_TOKEN_MIN_LENGTH = 1;
+export const SNAPSHOT_PAGE_TOKEN_MAX_LENGTH = 512;
+export const SNAPSHOT_ACK_TOKEN_MIN_LENGTH = 1;
+export const SNAPSHOT_ACK_TOKEN_MAX_LENGTH = 512;
+export const DELIVER_DELIVERY_ID_MIN_LENGTH = 1;
+export const DELIVER_DELIVERY_ID_MAX_LENGTH = 128;
+export const MEDIA_READ_CHUNK_MAX_BYTES = 524_288;
 //# sourceMappingURL=row-shapes.js.map

package/dist/wire/row-shapes.js.map

@@ -1 +1 @@
-{"version":3,"file":"row-shapes.js","sourceRoot":"","sources":["../../src/wire/row-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmCH,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAU,CAAC;AAEtD,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAa,CAAC;AAEhE,oDAAoD;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAU,CAAC;AAE/D,oDAAoD;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAY,CAAC;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAY,CAAC;AAyBxE,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AAEzD,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAY,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAY,CAAC;AAElE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC;AAE/C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAY,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAa,CAAC;AAiDzD,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC;AAEhD,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAa,CAAC"}
+{"version":3,"file":"row-shapes.js","sourceRoot":"","sources":["../../src/wire/row-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoDH,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAU,CAAC;AAEtD,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAa,CAAC;AAEhE,oDAAoD;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAU,CAAC;AAE/D,oDAAoD;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAY,CAAC;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAY,CAAC;AAoBxE,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AAEzD,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAY,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAY,CAAC;AAElE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC;AAE/C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAY,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAa,CAAC;AA4CzD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAavE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAExE,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC;AAEhD,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAa,CAAC;AAqG1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAY,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAY,CAAC;AAiBtD,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAU,CAAC;AAC9D,MAAM,CAAC,MAAM,mCAAmC,GAAG,GAAY,CAAC;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAU,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAW,CAAC;AAClD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,CAAC;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAY,CAAC;AAY1D,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAY,CAAC;AAK3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAgB,CAAC"}

package/fixtures/behavior/messaging/adversarial-invariants.json

@@ -10,6 +10,11 @@
     {
       "id": "raw-thread-id-rejection",
       "invariant": "Plugins cannot address threads by raw threadId.",
+      "execution": {
+        "plane": "wire-admission",
+        "method": "messaging.send",
+        "verdictOracle": { "kind": "json-rpc-error", "code": -32602, "sideEffects": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.send"],
@@ -40,6 +45,11 @@
     {
       "id": "system-audience-dual-rejection",
       "invariant": "Drafts cannot express the host-only system audience.",
+      "execution": {
+        "plane": "wire-admission",
+        "method": "messaging.send",
+        "verdictOracle": { "kind": "json-rpc-error", "code": -32602, "sideEffects": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.send"],
@@ -73,6 +83,11 @@
     {
       "id": "cross-instance-handle-rejection",
       "invariant": "A message handle issued to one plugin instance cannot authorize another.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.appendElements",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.appendElements"],
@@ -103,6 +118,11 @@
     {
       "id": "origin-forgery-rejection",
       "invariant": "A thread-handle send may only declare the caller's own plugin origin.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.send",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.send"],
@@ -135,6 +155,11 @@
     {
       "id": "base-revision-conflict-zero-change",
       "invariant": "A stale baseRevision produces CONFLICT and no mutation.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.appendElements",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.appendElements"],
@@ -165,6 +190,11 @@
     {
       "id": "stale-cursor-snapshot-roundtrip",
       "invariant": "A stale cursor reports stale and snapshot catch-up supplies an exact resume point.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.read",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["message.event.subscribe"],
@@ -189,6 +219,11 @@
     {
       "id": "cross-subscription-ack-rejection",
       "invariant": "Ack tokens are subscription-local and cannot cross subscriptions.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.ack",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["message.event.subscribe"],
@@ -214,6 +249,11 @@
     {
       "id": "reply-to-cross-thread-leakage",
       "invariant": "replyTo cannot reference a message from another thread.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.send",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.send"],
@@ -247,6 +287,11 @@
     {
       "id": "epistemic-status-upgrade-rejection",
       "invariant": "Derived content cannot claim a stronger epistemic status than its source.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.appendElements",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.appendElements"],
@@ -277,6 +322,10 @@
     {
       "id": "preset-l2-rejected",
       "invariant": "First-party presets are derived from L1 and cannot silently grant L2 capabilities.",
+      "execution": {
+        "plane": "host-control",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "first-party-plugin" },
         "grants": ["messaging.send"],
@@ -298,6 +347,10 @@
     {
       "id": "preset-visible-revocable",
       "invariant": "A first-party L1 preset remains visible and independently revocable.",
+      "execution": {
+        "plane": "host-control",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "first-party-plugin" },
         "grants": ["messaging.send"],
@@ -318,6 +371,11 @@
     {
       "id": "whisper-target-beyond-default-empty-grant-rejected",
       "invariant": "The default whisper target grant is empty; messaging.send alone cannot add a target.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.send",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": ["messaging.send"],
@@ -351,6 +409,11 @@
     {
       "id": "append-without-grant-rejected",
       "invariant": "A valid message handle does not bypass the messaging.appendElements grant.",
+      "execution": {
+        "plane": "plugin-to-host-wire",
+        "method": "messaging.appendElements",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": [],
@@ -381,6 +444,11 @@
     {
       "id": "denied-on-message-rejected",
       "invariant": "The Host cannot deliver an onMessage envelope without an explicit scoped L2 grant.",
+      "execution": {
+        "plane": "host-to-plugin-delivery",
+        "method": "host.messaging.deliver",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": [],
@@ -408,6 +476,10 @@
     {
       "id": "permission-matrix-complete",
       "invariant": "The loopback policy matrix covers every signed capability and presets only L1 for first-party plugins.",
+      "execution": {
+        "plane": "host-control",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "policy-auditor" },
         "grants": [],
@@ -423,18 +495,23 @@
             { "capability": "plugin.state.set", "layer": "L0", "firstPartyPreset": false },
             { "capability": "messaging.send", "layer": "L1", "firstPartyPreset": true },
             { "capability": "schedule.register", "layer": "L1", "firstPartyPreset": true },
-            { "capability": "events.publish", "layer": "L1", "firstPartyPreset": true },
             { "capability": "messaging.appendElements", "layer": "L1", "firstPartyPreset": true },
+            { "capability": "streams.read", "layer": "L1", "firstPartyPreset": true },
             { "capability": "onMessage", "layer": "L2", "firstPartyPreset": false },
             { "capability": "message.event.subscribe", "layer": "L2", "firstPartyPreset": false },
             { "capability": "secret.read", "layer": "L2", "firstPartyPreset": false },
             { "capability": "thread.listMetadata", "layer": "L2", "firstPartyPreset": false },
             { "capability": "thread.readContent", "layer": "L2", "firstPartyPreset": false },
+            { "capability": "thread.write", "layer": "L2", "firstPartyPreset": false },
+            { "capability": "task.read", "layer": "L2", "firstPartyPreset": false },
+            { "capability": "task.write", "layer": "L2", "firstPartyPreset": false },
+            { "capability": "task.admitEntrusted", "layer": "L2", "firstPartyPreset": false },
             { "capability": "memory.query", "layer": "L2", "firstPartyPreset": false },
             { "capability": "memory.append", "layer": "L2", "firstPartyPreset": false },
             { "capability": "memory.retrieve", "layer": "L2", "firstPartyPreset": false },
             { "capability": "windows.create", "layer": "L2", "firstPartyPreset": false },
-            { "capability": "whisper.extend", "layer": "L2", "firstPartyPreset": false }
+            { "capability": "whisper.extend", "layer": "L2", "firstPartyPreset": false },
+            { "capability": "cloud.conversation.host", "layer": "L2", "firstPartyPreset": false }
           ]
         }
       },
@@ -448,6 +525,10 @@
     {
       "id": "delete-replay-events-preserves-canonical-messages",
       "invariant": "Deleting the replay transport buffer cannot delete canonical messages or threads.",
+      "execution": {
+        "plane": "host-control",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "host-retention" },
         "grants": ["message.event.subscribe"],
@@ -474,6 +555,11 @@
     {
       "id": "snapshot-without-grant-rejected",
       "invariant": "A subscription identifier cannot bypass the message.event.subscribe grant for snapshots.",
+      "execution": {
+        "plane": "wire-admission",
+        "method": "messaging.snapshot",
+        "verdictOracle": { "kind": "json-rpc-error", "code": -32602, "sideEffects": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-a" },
         "grants": [],
@@ -498,6 +584,10 @@
     {
       "id": "foreign-replay-delete-rejected",
       "invariant": "A caller cannot delete another plugin instance's subscription replay buffer.",
+      "execution": {
+        "plane": "host-control",
+        "verdictOracle": { "kind": "behavior-expectation" }
+      },
       "given": {
         "caller": { "pluginInstanceId": "plugin-b" },
         "grants": ["message.event.subscribe"],

package/fixtures/manifest/invalid/duplicate-signal-type.json

@@ -8,7 +8,7 @@
       "id": "meeting-intake",
       "name": "Meeting intake",
       "resources": [],
-      "capabilities": ["events.publish"]
+      "capabilities": []
     }
   ],
   "signals": {
@@ -29,5 +29,7 @@
       }
     ]
   },
-  "runtime": { "transport": "builtin" }
+  "runtime": {
+    "transport": "builtin"
+  }
 }

package/fixtures/manifest/invalid/icon-package-escape.json

@@ -0,0 +1,22 @@
+{
+  "pluginId": "com.example.icon-escape",
+  "version": "1.0.0",
+  "contractVersion": "0.1.0-beta.13",
+  "name": "Icon escape fixture",
+  "description": "Legacy description remains accepted.",
+  "icon": {
+    "type": "svg",
+    "src": "../outside.svg"
+  },
+  "features": [
+    {
+      "id": "main",
+      "name": "Main",
+      "resources": [],
+      "capabilities": []
+    }
+  ],
+  "runtime": {
+    "transport": "builtin"
+  }
+}

package/fixtures/manifest/valid/localized-product-metadata.json

@@ -0,0 +1,27 @@
+{
+  "pluginId": "com.example.localized-metadata",
+  "version": "1.0.0",
+  "contractVersion": "0.1.0-beta.13",
+  "name": "Localized metadata fixture",
+  "description": {
+    "default": "Describe this plugin for agents and people.",
+    "translations": {
+      "zh-CN": "向 Agent 和用户介绍这个插件。"
+    }
+  },
+  "icon": {
+    "type": "svg",
+    "src": "assets/icon.svg"
+  },
+  "features": [
+    {
+      "id": "main",
+      "name": "Main",
+      "resources": [],
+      "capabilities": []
+    }
+  ],
+  "runtime": {
+    "transport": "builtin"
+  }
+}

package/fixtures/messaging/valid/subscription-delivery.json

@@ -18,7 +18,7 @@
           "audience": {
             "kind": "public"
           },
-          "occurredAt": "2026-07-15T02:42:00Z",
+          "occurredAt": "2026-07-15T02:42:00.000Z",
           "payload": {
             "provenance": {
               "origin": {