@adea-ai/runtime-sdk 3.1.0 → 3.2.0

package/README.md

@@ -1,24 +1,23 @@
 # @control-plane/runtime-sdk
 
 SDK for building runtimes that plug into the Control Plane: implement the
-adapter interface, declare capabilities, and pass conformance — without
+adapter interface, declare capabilities, and pass conformance, without
 touching Control Plane internals.
 
-Depends only on [`@adea-ai/contracts`](https://www.npmjs.com/package/@adea-ai/contracts)
-and Zod. Pair it with [`@adea-ai/contracts`](https://www.npmjs.com/package/@adea-ai/contracts)
-for the service boundary.
+Depends only on [`@adea-ai/contracts`](https://www.npmjs.com/package/@adea-ai/contracts),
+which also carries the service boundary, and Zod.
 
 ## What's inside
 
-- **Adapter** — the runtime adapter contract and registration types.
-- **Capabilities & eligibility** — declare what a runtime supports and let
+- **Adapter**: the runtime adapter contract and registration types.
+- **Capabilities & eligibility**: declare what a runtime supports and let
   the Control Plane route accordingly.
-- **Discovery & inventory** — runtime discovery records, health, and
+- **Discovery & inventory**: runtime discovery records, health, and
   eligibility evaluation.
-- **Conformance & compatibility** — versioned conformance suites and
+- **Conformance & compatibility**: versioned conformance suites and
   compatibility checks for runtime implementations.
-- **Sessions & routing** — external session types and routing decisions.
-- **Transport** — the co-located transport port with deterministic in-memory
+- **Sessions & routing**: external session types and routing decisions.
+- **Transport**: the co-located transport port with deterministic in-memory
   doubles (`mock.ts`, `fixtures.ts`) for testing adapters.
 
 Runtime usage accounting distinguishes HQ-funded API usage (`hq_managed`),
@@ -46,12 +45,8 @@ import {
 const metadata = RuntimeAdapterMetadataSchema.parse(raw)
 ```
 
-Run the compatibility check against your adapter implementation before
-registering it (repository development):
-
-```sh
-bun scripts/compatibility.ts --check
-```
+In this repository, `bun run compatibility:check` (from the root) validates the
+runtime certification matrix and its generated schema.
 
 ## License
 

package/dist/fixtures.d.ts

@@ -1,5 +1,5 @@
 export declare const RuntimeFixtures: Readonly<{
-    mock: {
+    readonly mock: {
         runtimeDefinitionId: import("@adea-ai/contracts").OpaqueIdentifier<"runtime-definition ID">;
         family: string;
         adapterVersion: string;
@@ -28,7 +28,7 @@ export declare const RuntimeFixtures: Readonly<{
             reason?: string | undefined;
         };
     };
-    futurePi: {
+    readonly futurePi: {
         runtimeDefinitionId: import("@adea-ai/contracts").OpaqueIdentifier<"runtime-definition ID">;
         family: string;
         adapterVersion: string;
@@ -57,7 +57,7 @@ export declare const RuntimeFixtures: Readonly<{
             reason?: string | undefined;
         };
     };
-    futureAcp: {
+    readonly futureAcp: {
         runtimeDefinitionId: import("@adea-ai/contracts").OpaqueIdentifier<"runtime-definition ID">;
         family: string;
         adapterVersion: string;

package/dist/fixtures.js

@@ -5,7 +5,7 @@ const testedVersions = {
     driverVersion: '1.0.0',
     harnessVersion: '1.0.0',
 };
-export const RuntimeFixtures = Object.freeze({
+const buildFixtures = () => ({
     mock: runtime('rtd_01JABCDEF0123456789ABCDEFG', 'mock', [
         capability('stream.output'),
         capability('output.structured'),
@@ -28,6 +28,19 @@ export const RuntimeFixtures = Object.freeze({
         capability('session.load'),
     ]),
 });
+let built;
+const fixtures = () => (built ??= buildFixtures());
+export const RuntimeFixtures = Object.freeze({
+    get mock() {
+        return fixtures().mock;
+    },
+    get futurePi() {
+        return fixtures().futurePi;
+    },
+    get futureAcp() {
+        return fixtures().futureAcp;
+    },
+});
 function runtime(runtimeDefinitionId, family, capabilities) {
     return RuntimeDefinitionSchema.parse({
         runtimeDefinitionId,

package/dist/pi-durable-approvals.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { canonicalJsonStringify, IdentifierSchemas, Sha256DigestSchema, TimestampSchema, } from '@adea-ai/contracts';
+import { canonicalJsonEqual, IdentifierSchemas, Sha256DigestSchema, TimestampSchema, } from '@adea-ai/contracts';
 import { PiDurableDispatchIdSchema } from './pi-durable-ids.js';
 export const PiDurableApprovalEffectDigestSchema = Sha256DigestSchema;
 export const PiDurableApprovalDecisionIdSchema = z.string().regex(/^pi-decision:[a-f0-9]{32}$/);
@@ -37,5 +37,5 @@ export const PiDurableApprovalDecisionSchema = z.strictObject({
 export function samePiDurableApprovalDecision(left, right) {
     const { decidedAt: _left, ...a } = left;
     const { decidedAt: _right, ...b } = right;
-    return canonicalJsonStringify(a) === canonicalJsonStringify(b);
+    return canonicalJsonEqual(a, b);
 }

package/dist/registry.js

@@ -220,7 +220,7 @@ export class InMemoryRuntimeConnectionRepository {
         return true;
     }
     async get(runtimeConnectionId) {
-        return cloneOptional(this.#connections.get(runtimeConnectionId));
+        return structuredClone(this.#connections.get(runtimeConnectionId));
     }
     async getByIdentityDigest(identityDigest) {
         const runtimeConnectionId = this.#identities.get(identityDigest);
@@ -303,6 +303,3 @@ function latest(...timestamps) {
 function fail(code) {
     throw new RuntimeConnectionRegistryError(code);
 }
-function cloneOptional(value) {
-    return value === undefined ? undefined : structuredClone(value);
-}

package/dist/sessions.js

@@ -128,10 +128,10 @@ export class InMemoryExternalSessionRepository {
         return true;
     }
     async get(externalSessionId) {
-        return cloneOptional(this.#sessions.get(externalSessionId));
+        return structuredClone(this.#sessions.get(externalSessionId));
     }
     async findByNativeIdentity(runtimeConnectionId, opaqueNativeSessionId) {
-        return cloneOptional([...this.#sessions.values()].find((session) => session.runtimeConnectionId === runtimeConnectionId &&
+        return structuredClone([...this.#sessions.values()].find((session) => session.runtimeConnectionId === runtimeConnectionId &&
             session.opaqueNativeSessionId === opaqueNativeSessionId));
     }
     async list(scope) {
@@ -400,6 +400,3 @@ function sameRegistration(session, input) {
 function fail(code, currentVersion) {
     throw new ExternalSessionRegistryError(code, currentVersion);
 }
-function cloneOptional(value) {
-    return value === undefined ? undefined : structuredClone(value);
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adea-ai/runtime-sdk",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "SDK for building Control Plane runtimes: adapters, capabilities, conformance, discovery, eligibility, health, sessions, transport, and routing.",
   "keywords": [
     "adapter",
@@ -21,6 +21,7 @@
     "dist"
   ],
   "type": "module",
+  "sideEffects": false,
   "browser": false,
   "types": "./dist/index.d.ts",
   "exports": {
@@ -42,8 +43,8 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@adea-ai/contracts": "^5.0.3",
-    "zod": "4.6.6"
+    "@adea-ai/contracts": "^5.1.0",
+    "zod": "4.6.7"
   },
   "engines": {
     "node": "24.21.0"