@ggui-ai/protocol-conformance 0.1.0-rc.1

package/dist/fixtures/refresh-semantics/stream-refresh-success.json

@@ -0,0 +1,40 @@
+{
+    "name": "stream-refresh-success",
+    "description": "Happy-path refresh: a wired action succeeds, the declared `streamSpec[channel].tool` refresh tool fires, and the channel's next stream-update reflects the new snapshot. Proves the refresh-after-action contract is observable on the wire (not only on the DOM).",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-refresh-success-1" },
+        { "type": "register-tool", "toolName": "tasks_create", "handler": "echo" },
+        { "type": "register-tool", "toolName": "tasks_list", "handler": "list-snapshot" },
+        { "type": "register-actionspec", "name": "createTask", "tool": "tasks_create" },
+        { "type": "register-streamspec", "channel": "tasks", "tool": "tasks_list" }
+    ],
+    "inputEnvelope": {
+        "type": "action",
+        "channel": 0,
+        "sessionId": "ck-refresh-success-1",
+        "action": {
+            "name": "createTask",
+            "data": { "title": "ck-refresh" }
+        }
+    },
+    "expectedBehavior": {
+        "kind": "stream-update",
+        "channel": "tasks",
+        "value": {
+            "items": []
+        }
+    },
+    "expectedObservability": [
+        {
+            "kind": "wired-tool-invoked",
+            "toolName": "tasks_create",
+            "actionName": "createTask"
+        },
+        {
+            "kind": "wired-tool-invoked",
+            "toolName": "tasks_list"
+        }
+    ],
+    "teardown": [{ "type": "close-session", "sessionId": "ck-refresh-success-1" }]
+}

package/dist/fixtures/reserved-channel-authority/index.d.ts

@@ -0,0 +1,4 @@
+import type { TestCase } from '../../types.js';
+/** All fixtures asserting reserved-channel authority (SPEC §4.4). */
+export declare const reservedChannelAuthorityFixtures: readonly TestCase[];
+//# sourceMappingURL=index.d.ts.map

package/dist/fixtures/reserved-channel-authority/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fixtures/reserved-channel-authority/index.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qEAAqE;AACrE,eAAO,MAAM,gCAAgC,EAAE,SAAS,QAAQ,EAG/D,CAAC"}

package/dist/fixtures/reserved-channel-authority/index.js

@@ -0,0 +1,21 @@
+/**
+ * `reserved-channel-authority` fixture sub-module.
+ *
+ * Exercises the reserved-channel contract (SPEC §4.4 Reserved-channel
+ * Authority):
+ *   - Declared-channel schema violations surface as
+ *     `_ggui:contract-error` envelopes with `SCHEMA_VIOLATION` code.
+ *   - Channel-0 `props_update` round-trips deliver new props and the
+ *     iframe DOM reflects the update.
+ *
+ * Both fixtures are `ConformanceHost`-gated — `stream-schema-
+ * violation` drives via malformed-tool setup, `props-update-roundtrip`
+ * via direct envelope dispatch.
+ */
+import propsUpdateRoundtrip from './props-update-roundtrip.json' with { type: 'json' };
+import streamSchemaViolation from './stream-schema-violation.json' with { type: 'json' };
+/** All fixtures asserting reserved-channel authority (SPEC §4.4). */
+export const reservedChannelAuthorityFixtures = [
+    propsUpdateRoundtrip,
+    streamSchemaViolation,
+];

package/dist/fixtures/reserved-channel-authority/props-update-roundtrip.json

@@ -0,0 +1,34 @@
+{
+    "name": "props-update-roundtrip",
+    "description": "Host delivers a `props_update` envelope on channel 0 with a new props payload. The iframe's DOM reflects the new props within `timeoutMs` — evidence on a stamped data-attribute. Proves the host -> iframe props channel is live-wired, complementing the wired-action (iframe -> host) path.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-props-update-1" },
+        {
+            "type": "emit-envelope",
+            "channel": "_ggui:props",
+            "payload": {
+                "type": "props_update",
+                "sessionId": "ck-props-update-1",
+                "props": { "greeting": "initial" }
+            }
+        }
+    ],
+    "inputEnvelope": {
+        "type": "props-update",
+        "channel": 0,
+        "sessionId": "ck-props-update-1",
+        "props": { "greeting": "updated-by-host" }
+    },
+    "expectedBehavior": {
+        "kind": "props-update",
+        "channel": "_ggui:props",
+        "props": { "greeting": "updated-by-host" },
+        "evidence": {
+            "selector": "[data-ggui-greeting]",
+            "attribute": "data-ggui-greeting",
+            "expected": "updated-by-host"
+        }
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-props-update-1" }]
+}

package/dist/fixtures/reserved-channel-authority/stream-schema-violation.json

@@ -0,0 +1,45 @@
+{
+    "name": "stream-schema-violation",
+    "description": "Refresh-stream tool returns a shape that violates the declared channel schema. `assertStreamContract` rejects the payload BEFORE fanOut, emits `_ggui:contract-error` with code SCHEMA_VIOLATION + sourceAction `refresh-stream`. Channel's previous state is preserved — subscribers never see the corruption. Matches `runtime-contract.spec.ts::schema-violation-on-refresh`.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-schema-violation-1" },
+        { "type": "register-tool", "toolName": "tasks_list", "handler": "echo" },
+        {
+            "type": "register-tool",
+            "toolName": "tasks_malformed_list",
+            "handler": "malformed-stream"
+        },
+        {
+            "type": "register-actionspec",
+            "name": "triggerMalformedRefresh",
+            "tool": "tasks_list"
+        },
+        {
+            "type": "register-streamspec",
+            "channel": "tasks",
+            "tool": "tasks_malformed_list"
+        }
+    ],
+    "inputEnvelope": {
+        "type": "action",
+        "channel": 0,
+        "sessionId": "ck-schema-violation-1",
+        "action": {
+            "name": "triggerMalformedRefresh",
+            "data": {}
+        }
+    },
+    "expectedBehavior": {
+        "kind": "contract-error",
+        "code": "SCHEMA_VIOLATION",
+        "toolName": "tasks_malformed_list",
+        "sourceAction": "refresh-stream",
+        "observability": {
+            "kind": "contract-error-emitted",
+            "code": "SCHEMA_VIOLATION",
+            "toolName": "tasks_malformed_list"
+        }
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-schema-violation-1" }]
+}

package/dist/fixtures/schema-version-handshake/index.d.ts

@@ -0,0 +1,4 @@
+import type { TestCase } from '../../types.js';
+/** All fixtures asserting the schema-version handshake (Protocol #3). */
+export declare const schemaVersionHandshakeFixtures: readonly TestCase[];
+//# sourceMappingURL=index.d.ts.map

package/dist/fixtures/schema-version-handshake/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fixtures/schema-version-handshake/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,EAAE,SAAS,QAAQ,EAG7D,CAAC"}

package/dist/fixtures/schema-version-handshake/index.js

@@ -0,0 +1,20 @@
+/**
+ * `schema-version-handshake` fixture sub-module.
+ *
+ * Exercises the optional version-negotiation handshake (SPEC §12.2.2):
+ *   - `SubscribePayload.supportedVersions` + `AckPayload.serverVersion`.
+ *   - `UPGRADE_REQUIRED` error frame on mismatch per server's
+ *     `versionPolicy` setting.
+ *
+ * Two fixtures; `version-match` is redundant-by-design with
+ * `bootstrap-success` on today's harness but authored distinctly so
+ * a `ConformanceHost` can expose the handshake as a discrete
+ * assertion slot.
+ */
+import versionMatch from './version-match.json' with { type: 'json' };
+import versionMismatch from './version-mismatch.json' with { type: 'json' };
+/** All fixtures asserting the schema-version handshake (Protocol #3). */
+export const schemaVersionHandshakeFixtures = [
+    versionMatch,
+    versionMismatch,
+];

package/dist/fixtures/schema-version-handshake/version-match.json

@@ -0,0 +1,16 @@
+{
+    "name": "version-match",
+    "description": "Happy-path version handshake: server advertises a schemaVersion the client supports (same as current canonical). Renderer completes the handshake without emitting `ggui:upgrade-required`. Baseline for `version-mismatch`'s negative assertion — proves the handshake path itself is observable.",
+    "skipReason": null,
+    "setup": [{ "type": "create-session", "sessionId": "ck-version-match-1" }],
+    "inputEnvelope": {
+        "type": "handshake",
+        "sessionId": "ck-version-match-1",
+        "clientAccepts": ["1.1"]
+    },
+    "expectedBehavior": {
+        "kind": "bootstrap-success",
+        "observabilitySequence": []
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-version-match-1" }]
+}

package/dist/fixtures/schema-version-handshake/version-mismatch.json

@@ -0,0 +1,26 @@
+{
+    "name": "version-mismatch",
+    "description": "Server advertises a protocol schemaVersion outside the client's accepted set. Renderer emits `{type:'ggui:upgrade-required', server, client}` to the parent host + a matching `ProtocolError{kind:'version'}`. Host SHOULD render an inline upgrade prompt — NOT treat this as a terminal failure.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-version-mismatch-1" },
+        {
+            "type": "server-version-override",
+            "sessionId": "ck-version-mismatch-1",
+            "advertiseVersion": "99.99-unsupported"
+        }
+    ],
+    "inputEnvelope": {
+        "type": "render",
+        "sessionId": "ck-version-mismatch-1",
+        "resource": {
+            "uri": "ui://ggui/session"
+        }
+    },
+    "expectedBehavior": {
+        "kind": "version-mismatch",
+        "serverVersion": "99.99-unsupported",
+        "clientAccepts": ["1.1"]
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-version-mismatch-1" }]
+}

package/dist/fixtures/wired-action-dispatch/index.d.ts

@@ -0,0 +1,5 @@
+import type { TestCase } from '../../types.js';
+/** All fixtures asserting the wired-action-dispatch contract (Contract
+ *  #3 — defined failure modes on `wiredActionRouter`). */
+export declare const wiredActionDispatchFixtures: readonly TestCase[];
+//# sourceMappingURL=index.d.ts.map

package/dist/fixtures/wired-action-dispatch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fixtures/wired-action-dispatch/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;0DAC0D;AAC1D,eAAO,MAAM,2BAA2B,EAAE,SAAS,QAAQ,EAK1D,CAAC"}

package/dist/fixtures/wired-action-dispatch/index.js

@@ -0,0 +1,29 @@
+/**
+ * `wired-action-dispatch` fixture sub-module.
+ *
+ * Exercises the full `wiredActionRouter` dispatch contract — every
+ * `ContractErrorCode` failure path + the happy path:
+ *   - `wired-action-success` — wired action dispatches → tool
+ *     executes → observability event fires.
+ *   - `wired-action-tool-not-found` — `TOOL_NOT_FOUND` error code
+ *     emits on `_ggui:contract-error`.
+ *   - `wired-action-tool-threw` — `TOOL_THREW` with sanitized
+ *     `causedBy` in payload.
+ *   - `wired-action-tool-timeout` — `TOOL_TIMEOUT` after router's
+ *     configured timeout.
+ *
+ * `wired-action-success` + `wired-action-tool-threw` drive against
+ * the current harness; the other two are `ConformanceHost`-gated.
+ */
+import wiredActionSuccess from './wired-action-success.json' with { type: 'json' };
+import wiredActionToolNotFound from './wired-action-tool-not-found.json' with { type: 'json' };
+import wiredActionToolThrew from './wired-action-tool-threw.json' with { type: 'json' };
+import wiredActionToolTimeout from './wired-action-tool-timeout.json' with { type: 'json' };
+/** All fixtures asserting the wired-action-dispatch contract (Contract
+ *  #3 — defined failure modes on `wiredActionRouter`). */
+export const wiredActionDispatchFixtures = [
+    wiredActionSuccess,
+    wiredActionToolNotFound,
+    wiredActionToolThrew,
+    wiredActionToolTimeout,
+];

package/dist/fixtures/wired-action-dispatch/wired-action-success.json

@@ -0,0 +1,36 @@
+{
+    "name": "wired-action-success",
+    "description": "Happy-path wired-action dispatch. A declared action tool fires, the refresh-stream tool follows, and the renderer emits a `wired-tool-invoked` observability event for each invocation. Baseline proof that the protocol's declare+wire+no-agent-code claim works end-to-end.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-wired-success-1" },
+        { "type": "register-tool", "toolName": "tasks_complete", "handler": "echo" },
+        { "type": "register-tool", "toolName": "tasks_list", "handler": "echo" },
+        { "type": "register-actionspec", "name": "toggleTask", "tool": "tasks_complete" }
+    ],
+    "inputEnvelope": {
+        "type": "action",
+        "channel": 0,
+        "sessionId": "ck-wired-success-1",
+        "action": {
+            "name": "toggleTask",
+            "data": { "id": "seed-1" }
+        }
+    },
+    "expectedBehavior": {
+        "kind": "observability-event",
+        "event": {
+            "kind": "wired-tool-invoked",
+            "toolName": "tasks_complete",
+            "actionName": "toggleTask"
+        }
+    },
+    "expectedObservability": [
+        {
+            "kind": "wired-tool-invoked",
+            "toolName": "tasks_complete",
+            "actionName": "toggleTask"
+        }
+    ],
+    "teardown": [{ "type": "close-session", "sessionId": "ck-wired-success-1" }]
+}

package/dist/fixtures/wired-action-dispatch/wired-action-tool-not-found.json

@@ -0,0 +1,31 @@
+{
+    "name": "wired-action-tool-not-found",
+    "description": "Wired-action dispatch names an action whose declared tool is not registered on the session. The router MUST emit a `_ggui:contract-error` envelope with code TOOL_NOT_FOUND and a matching `contract-error-emitted` observability event. Session stays alive.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-tool-not-found-1" },
+        { "type": "register-tool", "toolName": "known-tool", "handler": "echo" }
+    ],
+    "inputEnvelope": {
+        "type": "action",
+        "channel": 0,
+        "sessionId": "ck-tool-not-found-1",
+        "action": {
+            "name": "doesNotExist",
+            "data": {}
+        }
+    },
+    "expectedBehavior": {
+        "kind": "contract-error",
+        "code": "TOOL_NOT_FOUND",
+        "toolName": "doesNotExist",
+        "actionName": "doesNotExist",
+        "sourceAction": "wired-action",
+        "observability": {
+            "kind": "contract-error-emitted",
+            "code": "TOOL_NOT_FOUND",
+            "toolName": "doesNotExist"
+        }
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-tool-not-found-1" }]
+}

package/dist/fixtures/wired-action-dispatch/wired-action-tool-threw.json

@@ -0,0 +1,32 @@
+{
+    "name": "wired-action-tool-threw",
+    "description": "Wired-action tool throws synchronously (or rejects). Router catches, emits `_ggui:contract-error` with code TOOL_THREW + sanitized causedBy. Session survives — the probe UI stays interactive. Matches `runtime-contract.spec.ts::tool-throws`.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-tool-threw-1" },
+        { "type": "register-tool", "toolName": "tasks_broken", "handler": "throw" },
+        { "type": "register-actionspec", "name": "triggerBroken", "tool": "tasks_broken" }
+    ],
+    "inputEnvelope": {
+        "type": "action",
+        "channel": 0,
+        "sessionId": "ck-tool-threw-1",
+        "action": {
+            "name": "triggerBroken",
+            "data": {}
+        }
+    },
+    "expectedBehavior": {
+        "kind": "contract-error",
+        "code": "TOOL_THREW",
+        "toolName": "tasks_broken",
+        "actionName": "triggerBroken",
+        "sourceAction": "wired-action",
+        "observability": {
+            "kind": "contract-error-emitted",
+            "code": "TOOL_THREW",
+            "toolName": "tasks_broken"
+        }
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-tool-threw-1" }]
+}

package/dist/fixtures/wired-action-dispatch/wired-action-tool-timeout.json

@@ -0,0 +1,32 @@
+{
+    "name": "wired-action-tool-timeout",
+    "description": "Wired-action tool exceeds the router's configured timeout. Router emits `_ggui:contract-error` with code TOOL_TIMEOUT + sourceAction `wired-action` + a matching `contract-error-emitted` observability event. Session survives; no stream update fires.",
+    "skipReason": null,
+    "setup": [
+        { "type": "create-session", "sessionId": "ck-tool-timeout-1" },
+        { "type": "register-tool", "toolName": "hanging_tool", "handler": "timeout" },
+        { "type": "register-actionspec", "name": "triggerTimeout", "tool": "hanging_tool" }
+    ],
+    "inputEnvelope": {
+        "type": "action",
+        "channel": 0,
+        "sessionId": "ck-tool-timeout-1",
+        "action": {
+            "name": "triggerTimeout",
+            "data": {}
+        }
+    },
+    "expectedBehavior": {
+        "kind": "contract-error",
+        "code": "TOOL_TIMEOUT",
+        "toolName": "hanging_tool",
+        "actionName": "triggerTimeout",
+        "sourceAction": "wired-action",
+        "observability": {
+            "kind": "contract-error-emitted",
+            "code": "TOOL_TIMEOUT",
+            "toolName": "hanging_tool"
+        }
+    },
+    "teardown": [{ "type": "close-session", "sessionId": "ck-tool-timeout-1" }]
+}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `@ggui-ai/protocol-conformance` — conformance test kit for the
+ * ggui protocol.
+ *
+ * Packages the fixture catalog as a consumable npm artifact, plus a
+ * runner that drives each fixture against a live implementation over
+ * WebSocket and reports a scorecard-style pass / fail / skip summary.
+ *
+ * The kit IS the protocol's conformance surface — any drift between
+ * its assertions and `@ggui-ai/protocol`'s types is the canonical
+ * bug.
+ */
+export type { TransportConfig, WebSocketTransportConfig, UnknownTransportConfig, AuthConfig, TestCase, SetupStep, CreateSessionStep, RegisterToolStep, EmitEnvelopeStep, SeedChannelStep, UnknownSetupStep, TeardownStep, CloseSessionStep, UnregisterToolStep, UnknownTeardownStep, ExpectedBehavior, ContractErrorBehavior, StreamUpdateBehavior, ObservabilityBehavior, BootstrapFailureBehavior, BootstrapSuccessBehavior, VersionMismatchBehavior, PropsUpdateBehavior, NoOpBehavior, UnknownBehavior, ExpectedObservabilityEvent, ProtocolError, BootstrapFailureReason, ContractErrorCode, } from './types.js';
+export type { ConformanceHost, SetupStep as HostSetupStep, CreateSessionSetup, RegisterToolSetup, RegisterActionSpecSetup, EmitEnvelopeSetup, RendererUrlOverrideSetup, UiInitializeResponseOverrideSetup, ServerVersionOverrideSetup, UnknownSetupStep as HostUnknownSetupStep, TeardownStep as HostTeardownStep, CloseSessionTeardown, UnregisterToolTeardown, UnknownTeardownStep as HostUnknownTeardownStep, } from './conformance-host.js';
+export { allFixtures, fixturesByContract, bootstrapProtocolFixtures, canvasModeWireShapesFixtures, observabilityEventsFixtures, refreshSemanticsFixtures, reservedChannelAuthorityFixtures, schemaVersionHandshakeFixtures, wiredActionDispatchFixtures, } from './fixtures/index.js';
+export type { ContractSlug } from './fixtures/index.js';
+export { gadgetWireSchemaCases, runSchemaConformance, } from './schema-conformance/index.js';
+export type { SchemaConformanceCase, SchemaConformanceMismatch, SchemaConformanceResult, } from './schema-conformance/index.js';
+export { gadgetRegistrationCases, runRegistrationConformance, } from './registration-conformance/index.js';
+export type { GadgetGateRejectCode, GateOutcome, RegistrationConformanceCase, RegistrationConformanceMismatch, RegistrationConformanceResult, } from './registration-conformance/index.js';
+export { gadgetResolutionCases, runResolutionConformance, } from './resolution-conformance/index.js';
+export type { GadgetUrlEntry, ResolvedGadgetUrls, ResolutionConformanceCase, ResolutionConformanceMismatch, ResolutionConformanceResult, } from './resolution-conformance/index.js';
+export { loadFixture, listFixtures, loadAllFixtures } from './loader.js';
+export { runConformance } from './run-conformance.js';
+export type { RunConformanceConfig, ConformanceResult, ConformanceFailure, SkippedFixture, ConformanceReporter, } from './run-conformance.js';
+export { createDefaultReporter, formatScorecard, formatSummary, formatFailures, formatSkips, } from './reporter.js';
+export type { DefaultReporterOptions } from './reporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,YAAY,EAEV,eAAe,EACf,wBAAwB,EACxB,sBAAsB,EACtB,UAAU,EAEV,QAAQ,EAER,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAEhB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EAEnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,0BAA0B,EAE1B,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,eAAe,EAEf,SAAS,IAAI,aAAa,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,iCAAiC,EACjC,0BAA0B,EAC1B,gBAAgB,IAAI,oBAAoB,EAExC,YAAY,IAAI,gBAAgB,EAChC,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,IAAI,uBAAuB,GAC/C,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,gCAAgC,EAChC,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASxD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * `@ggui-ai/protocol-conformance` — conformance test kit for the
+ * ggui protocol.
+ *
+ * Packages the fixture catalog as a consumable npm artifact, plus a
+ * runner that drives each fixture against a live implementation over
+ * WebSocket and reports a scorecard-style pass / fail / skip summary.
+ *
+ * The kit IS the protocol's conformance surface — any drift between
+ * its assertions and `@ggui-ai/protocol`'s types is the canonical
+ * bug.
+ */
+// Fixture catalog — every authored conformance case, classified by
+// contract. Third-party runners + the kit's own `runConformance()`
+// consume this surface.
+export { allFixtures, fixturesByContract, bootstrapProtocolFixtures, canvasModeWireShapesFixtures, observabilityEventsFixtures, refreshSemanticsFixtures, reservedChannelAuthorityFixtures, schemaVersionHandshakeFixtures, wiredActionDispatchFixtures, } from './fixtures/index.js';
+// Pure-function conformance catalogs — SPEC §7.7.2's gadget
+// obligations are deterministic validation functions, not transport-
+// observable behaviors. Each catalog grades a caller-supplied function
+// against authored accept/reject cases; no host, session, or wire.
+//
+// Schema-conformance — which `DataContract.clientCapabilities`
+// payloads a conformant parser MUST accept / reject.
+export { gadgetWireSchemaCases, runSchemaConformance, } from './schema-conformance/index.js';
+// Registration-conformance — which `(contract, appGadgets)` pairs the
+// push-time gadget registry gate MUST accept / reject, with which
+// precise reject code.
+export { gadgetRegistrationCases, runRegistrationConformance, } from './registration-conformance/index.js';
+// Resolution-conformance — which bundle + style URLs the server MUST
+// compute for a gadget descriptor's transport fields (`bundleHost`
+// precedence, default host, loopback scheme).
+export { gadgetResolutionCases, runResolutionConformance, } from './resolution-conformance/index.js';
+// Runtime loader — look up a fixture by name from the inlined catalog.
+export { loadFixture, listFixtures, loadAllFixtures } from './loader.js';
+// Runner — drive the catalog against a live implementation.
+export { runConformance } from './run-conformance.js';
+// Default reporter — stdout-based bar-scorecard implementation +
+// formatters programmatic consumers can reuse when building their
+// own reporter (CI annotations, vitest integration, etc.).
+export { createDefaultReporter, formatScorecard, formatSummary, formatFailures, formatSkips, } from './reporter.js';

package/dist/loader.d.ts

@@ -0,0 +1,19 @@
+import type { TestCase } from './types.js';
+/**
+ * Look up one fixture by name. Throws `Error` if the name is not in
+ * the catalog, so callers don't silently drop typos.
+ */
+export declare function loadFixture(name: string): TestCase;
+/**
+ * List every fixture name in the catalog, sorted lexicographically.
+ * Deterministic output across filesystems / imports.
+ */
+export declare function listFixtures(): readonly string[];
+/**
+ * Every fixture in the catalog, flat, in deterministic order.
+ * Convenience wrapper — equivalent to `import { allFixtures } from
+ * '@ggui-ai/protocol-conformance/fixtures'` but available through the
+ * package root.
+ */
+export declare function loadAllFixtures(): readonly TestCase[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAWlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,MAAM,EAAE,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,SAAS,QAAQ,EAAE,CAErD"}

package/dist/loader.js

@@ -0,0 +1,46 @@
+/**
+ * Runtime loader for the fixture catalog.
+ *
+ * Thin wrapper over `./fixtures/index.ts`'s static-imported arrays:
+ * look up a fixture by name, list all names, get every fixture flat.
+ * The JSON data is inlined into `dist/fixtures/` at build time by tsc's
+ * `resolveJsonModule` pass — no filesystem reads, no async, no path
+ * resolution concerns.
+ *
+ * Third-party consumers parsing the raw `.json` files (Python, Go,
+ * Rust) skip this module entirely; it exists for in-process TS
+ * consumers that want the authored JSON without reimplementing name
+ * lookup.
+ */
+import { allFixtures } from './fixtures/index.js';
+const FIXTURES_BY_NAME = new Map(allFixtures.map((fixture) => [fixture.name, fixture]));
+/**
+ * Look up one fixture by name. Throws `Error` if the name is not in
+ * the catalog, so callers don't silently drop typos.
+ */
+export function loadFixture(name) {
+    if (typeof name !== 'string' || name.length === 0) {
+        throw new Error('protocol-conformance: loadFixture requires a non-empty name');
+    }
+    const found = FIXTURES_BY_NAME.get(name);
+    if (found === undefined) {
+        throw new Error(`protocol-conformance: fixture '${name}' not found — list available names via listFixtures()`);
+    }
+    return found;
+}
+/**
+ * List every fixture name in the catalog, sorted lexicographically.
+ * Deterministic output across filesystems / imports.
+ */
+export function listFixtures() {
+    return allFixtures.map((fixture) => fixture.name);
+}
+/**
+ * Every fixture in the catalog, flat, in deterministic order.
+ * Convenience wrapper — equivalent to `import { allFixtures } from
+ * '@ggui-ai/protocol-conformance/fixtures'` but available through the
+ * package root.
+ */
+export function loadAllFixtures() {
+    return allFixtures;
+}