@lumenflow/control-plane-sdk 5.3.2 → 5.5.0

package/dist/a2a/conformance/cases.d.ts

@@ -0,0 +1,47 @@
+import { type A2AReceiptV1 } from '../receipt.js';
+import { type A2ASignalV1 } from '../signal.js';
+export interface A2AConformanceSignalQuery {
+    signal_id?: string;
+    workspace_id?: string;
+    wu_id?: string;
+    initiative?: string;
+    thread_id?: string;
+}
+export interface A2AConformanceVisibilityQuery extends A2AConformanceSignalQuery {
+    reader_identity: string;
+}
+export interface A2AConformanceReceiptQuery {
+    receipt_id?: string;
+    signal_id?: string;
+    reader_identity?: string;
+}
+export interface A2AConformanceDeliveryInput {
+    signal_id: string;
+    reader_identity: string;
+    receipt_id?: string;
+    idempotency_key?: string;
+    read_at?: string;
+}
+export interface A2AConformanceSignalStore {
+    appendSignal(signal: unknown): Promise<A2ASignalV1>;
+    listSignals(query?: A2AConformanceSignalQuery): Promise<A2ASignalV1[]>;
+    listVisibleSignals(query: A2AConformanceVisibilityQuery): Promise<A2ASignalV1[]>;
+}
+export interface A2AConformanceReceiptStore {
+    markDelivered(input: A2AConformanceDeliveryInput): Promise<A2AReceiptV1>;
+    appendReceipt(receipt: unknown): Promise<A2AReceiptV1>;
+    listReceipts(query?: A2AConformanceReceiptQuery): Promise<A2AReceiptV1[]>;
+}
+export interface A2AConformanceStores {
+    signals: A2AConformanceSignalStore;
+    receipts: A2AConformanceReceiptStore;
+}
+export interface A2AConformanceCase {
+    name: string;
+    run(stores: A2AConformanceStores): Promise<void>;
+}
+export declare const A2A_CONFORMANCE_CASES: A2AConformanceCase[];
+export declare function isA2AThreadConverged(signals: A2ASignalV1[], rootSignalId: string): boolean;
+export declare function matchesA2ASignalQuery(signal: A2ASignalV1, query?: A2AConformanceSignalQuery): boolean;
+export declare function matchesA2AReceiptQuery(receipt: A2AReceiptV1, query?: A2AConformanceReceiptQuery): boolean;
+//# sourceMappingURL=cases.d.ts.map

package/dist/a2a/conformance/cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cases.d.ts","sourceRoot":"","sources":["../../../src/a2a/conformance/cases.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAmBnE,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;IAC9E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,WAAW,CAAC,KAAK,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,kBAAkB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzE,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,YAAY,CAAC,KAAK,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,yBAAyB,CAAC;IACnC,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EAgOrD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAa1F;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,KAAK,GAAE,yBAA8B,GACpC,OAAO,CAQT;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,KAAK,GAAE,0BAA+B,GACrC,OAAO,CAMT"}

package/dist/a2a/conformance/cases.js

@@ -0,0 +1,253 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+import assert from 'node:assert/strict';
+import { A2AReceiptV1Schema } from '../receipt.js';
+import { A2ASignalV1Schema } from '../signal.js';
+const SCHEMA_VERSION = 'A2A.V1';
+const WORKSPACE_ONE = 'workspace-one';
+const WORKSPACE_TWO = 'workspace-two';
+const WU_ID = 'WU-2913';
+const INIT_ID = 'INIT-066';
+const THREAD_ID = 'thread-conformance';
+const CREATED_AT = '2026-05-06T12:00:00.000Z';
+const READ_AT = '2026-05-06T12:01:00.000Z';
+const READER_A = 'claude:reviewer:host1';
+const READER_B = 'codex:implementer:pid1';
+const READER_C = 'gemini:observer:pid1';
+const READER_D = 'cursor:outsider:pid1';
+const SENDER = 'codex:architect:pid1';
+const SIGNAL_ID = 'sig-conformance-root';
+const RECEIPT_ID = 'rcpt-conformance';
+const IDEMPOTENCY_KEY = 'idem-conformance';
+export const A2A_CONFORMANCE_CASES = [
+    {
+        name: 'schema round-trip',
+        async run({ signals }) {
+            const signal = buildSignal({
+                signal_id: SIGNAL_ID,
+                recipients: [READER_A, READER_B],
+                requires_ack: true,
+            });
+            const stored = await signals.appendSignal(signal);
+            const [loaded] = await signals.listSignals({ signal_id: signal.signal_id });
+            assert.deepEqual(A2ASignalV1Schema.parse(JSON.parse(JSON.stringify(stored))), signal);
+            assert.deepEqual(loaded, signal);
+        },
+    },
+    {
+        name: 'per-recipient receipts and receipt idempotency',
+        async run({ signals, receipts }) {
+            const signal = await signals.appendSignal(buildSignal({
+                signal_id: 'sig-receipts',
+                recipients: [READER_A, READER_B],
+            }));
+            const deliveredA = await receipts.markDelivered({
+                signal_id: signal.signal_id,
+                reader_identity: READER_A,
+                receipt_id: 'rcpt-reader-a',
+                idempotency_key: 'idem-reader-a',
+                read_at: READ_AT,
+            });
+            await receipts.appendReceipt(deliveredA);
+            const deliveredB = await receipts.markDelivered({
+                signal_id: signal.signal_id,
+                reader_identity: READER_B,
+                receipt_id: 'rcpt-reader-b',
+                idempotency_key: 'idem-reader-b',
+                read_at: READ_AT,
+            });
+            const readerAReceipts = await receipts.listReceipts({
+                signal_id: signal.signal_id,
+                reader_identity: READER_A,
+            });
+            const readerBReceipts = await receipts.listReceipts({
+                signal_id: signal.signal_id,
+                reader_identity: READER_B,
+            });
+            assert.equal(deliveredA.delivery_state, 'delivered');
+            assert.equal(deliveredB.delivery_state, 'delivered');
+            assert.equal(readerAReceipts.length, 1);
+            assert.equal(readerBReceipts.length, 1);
+            assert.equal(readerAReceipts[0]?.reader_identity, READER_A);
+            assert.equal(readerBReceipts[0]?.reader_identity, READER_B);
+        },
+    },
+    {
+        name: 'receipt state machine',
+        async run({ signals, receipts }) {
+            const signal = await signals.appendSignal(buildSignal({
+                signal_id: 'sig-state-machine',
+                recipients: [READER_A, READER_B],
+                requires_ack: true,
+            }));
+            const delivered = await receipts.markDelivered({
+                signal_id: signal.signal_id,
+                reader_identity: READER_A,
+                receipt_id: RECEIPT_ID,
+                idempotency_key: IDEMPOTENCY_KEY,
+                read_at: READ_AT,
+            });
+            const acked = await receipts.appendReceipt({
+                ...delivered,
+                delivery_state: 'acked',
+                read_at: '2026-05-06T12:02:00.000Z',
+            });
+            const regression = await receipts.appendReceipt({
+                ...delivered,
+                delivery_state: 'delivered',
+                read_at: '2026-05-06T12:03:00.000Z',
+            });
+            const deliveredB = await receipts.markDelivered({
+                signal_id: signal.signal_id,
+                reader_identity: READER_B,
+                receipt_id: 'rcpt-rejected',
+                idempotency_key: 'idem-rejected',
+                read_at: '2026-05-06T12:04:00.000Z',
+            });
+            const rejected = await receipts.appendReceipt({
+                ...deliveredB,
+                delivery_state: 'rejected',
+                read_at: '2026-05-06T12:05:00.000Z',
+            });
+            assert.equal(acked.delivery_state, 'acked');
+            assert.equal(regression.delivery_state, 'acked');
+            assert.equal(rejected.delivery_state, 'rejected');
+            assert.equal((await receipts.listReceipts({ receipt_id: delivered.receipt_id }))[0]?.delivery_state, 'acked');
+        },
+    },
+    {
+        name: 'N-recipient routing and workspace isolation',
+        async run({ signals }) {
+            const directed = await signals.appendSignal(buildSignal({
+                signal_id: 'sig-routing',
+                recipients: [READER_A, READER_B],
+                workspace_id: WORKSPACE_ONE,
+                wu_id: WU_ID,
+                initiative: INIT_ID,
+            }));
+            await signals.appendSignal(buildSignal({
+                signal_id: 'sig-other-workspace',
+                recipients: [READER_A],
+                workspace_id: WORKSPACE_TWO,
+                wu_id: 'WU-9999',
+                initiative: 'INIT-999',
+            }));
+            assert.deepEqual(await signalIds(signals.listVisibleSignals({ reader_identity: READER_A, workspace_id: WORKSPACE_ONE })), [directed.signal_id]);
+            assert.deepEqual(await signalIds(signals.listVisibleSignals({ reader_identity: READER_C, workspace_id: WORKSPACE_ONE })), []);
+            assert.deepEqual(await signalIds(signals.listVisibleSignals({
+                reader_identity: READER_C,
+                workspace_id: WORKSPACE_ONE,
+                wu_id: WU_ID,
+            })), [directed.signal_id]);
+            assert.deepEqual(await signalIds(signals.listVisibleSignals({
+                reader_identity: READER_D,
+                workspace_id: WORKSPACE_TWO,
+                wu_id: WU_ID,
+            })), []);
+        },
+    },
+    {
+        name: 'thread integrity and convergence',
+        async run({ signals }) {
+            const root = await signals.appendSignal(buildSignal({
+                signal_id: 'sig-thread-root',
+                recipients: [READER_A, READER_B],
+                thread_id: THREAD_ID,
+                intent: 'PROPOSE',
+                requires_ack: true,
+            }));
+            await signals.appendSignal(buildSignal({
+                signal_id: 'sig-thread-ack-a',
+                recipients: [SENDER],
+                sender_identity: READER_A,
+                thread_id: THREAD_ID,
+                reply_to: root.signal_id,
+                intent: 'AGREE',
+            }));
+            const partialThread = await signals.listSignals({ thread_id: THREAD_ID });
+            await signals.appendSignal(buildSignal({
+                signal_id: 'sig-thread-ack-b',
+                recipients: [SENDER],
+                sender_identity: READER_B,
+                thread_id: THREAD_ID,
+                reply_to: root.signal_id,
+                intent: 'AGREE',
+            }));
+            const fullThread = await signals.listSignals({ thread_id: THREAD_ID });
+            assert.deepEqual(partialThread.map((signal) => signal.reply_to), [undefined, root.signal_id]);
+            assert.equal(isA2AThreadConverged(partialThread, root.signal_id), false);
+            assert.equal(isA2AThreadConverged(fullThread, root.signal_id), true);
+        },
+    },
+    {
+        name: 'schema version enforcement',
+        async run({ signals, receipts }) {
+            await assert.rejects(signals.appendSignal({
+                ...buildSignal({ signal_id: 'sig-invalid-version' }),
+                schema_version: 'A2A.V2',
+            }));
+            await assert.rejects(receipts.appendReceipt({
+                ...buildReceipt({ receipt_id: 'rcpt-invalid-version' }),
+                schema_version: 'A2A.V2',
+            }));
+        },
+    },
+];
+export function isA2AThreadConverged(signals, rootSignalId) {
+    const root = signals.find((signal) => signal.signal_id === rootSignalId);
+    if (!root) {
+        return false;
+    }
+    const agreeingSenders = new Set(signals
+        .filter((signal) => signal.thread_id === root.thread_id)
+        .filter((signal) => signal.reply_to === root.signal_id)
+        .filter((signal) => signal.intent === 'AGREE')
+        .map((signal) => signal.sender_identity));
+    return root.recipients.every((recipient) => agreeingSenders.has(recipient));
+}
+export function matchesA2ASignalQuery(signal, query = {}) {
+    return ((query.signal_id === undefined || signal.signal_id === query.signal_id) &&
+        (query.workspace_id === undefined || signal.workspace_id === query.workspace_id) &&
+        (query.wu_id === undefined || signal.wu_id === query.wu_id) &&
+        (query.initiative === undefined || signal.initiative === query.initiative) &&
+        (query.thread_id === undefined || signal.thread_id === query.thread_id));
+}
+export function matchesA2AReceiptQuery(receipt, query = {}) {
+    return ((query.receipt_id === undefined || receipt.receipt_id === query.receipt_id) &&
+        (query.signal_id === undefined || receipt.signal_id === query.signal_id) &&
+        (query.reader_identity === undefined || receipt.reader_identity === query.reader_identity));
+}
+function buildSignal(overrides = {}) {
+    return A2ASignalV1Schema.parse({
+        schema_version: SCHEMA_VERSION,
+        signal_id: SIGNAL_ID,
+        workspace_id: WORKSPACE_ONE,
+        sender_identity: SENDER,
+        recipients: [READER_A],
+        thread_id: THREAD_ID,
+        message: 'A2A conformance signal',
+        created_at: CREATED_AT,
+        idempotency_key: `idem-${overrides.signal_id ?? SIGNAL_ID}`,
+        origin: 'local',
+        wu_id: WU_ID,
+        initiative: INIT_ID,
+        lane: 'Framework: ControlPlaneSdk',
+        ...overrides,
+    });
+}
+function buildReceipt(overrides = {}) {
+    return A2AReceiptV1Schema.parse({
+        schema_version: SCHEMA_VERSION,
+        receipt_id: RECEIPT_ID,
+        signal_id: SIGNAL_ID,
+        reader_identity: READER_A,
+        read_at: READ_AT,
+        delivery_state: 'delivered',
+        idempotency_key: IDEMPOTENCY_KEY,
+        ...overrides,
+    });
+}
+async function signalIds(signals) {
+    return (await signals).map((signal) => signal.signal_id);
+}
+//# sourceMappingURL=cases.js.map

package/dist/a2a/conformance/cases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cases.js","sourceRoot":"","sources":["../../../src/a2a/conformance/cases.ts"],"names":[],"mappings":"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"}

package/dist/a2a/conformance/index.d.ts

@@ -0,0 +1,5 @@
+export * from '../signal.js';
+export * from '../receipt.js';
+export * from './cases.js';
+export * from './runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/a2a/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/conformance/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/a2a/conformance/index.js

@@ -0,0 +1,7 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+export * from '../signal.js';
+export * from '../receipt.js';
+export * from './cases.js';
+export * from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/a2a/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/conformance/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/a2a/conformance/runner.d.ts

@@ -0,0 +1,23 @@
+import { type A2AConformanceCase, type A2AConformanceStores } from './cases.js';
+export interface A2AConformanceSuiteOptions {
+    createStores: () => A2AConformanceStores | Promise<A2AConformanceStores>;
+    cases?: A2AConformanceCase[];
+}
+export interface A2AConformanceCaseResult {
+    name: string;
+    passed: boolean;
+    error?: string;
+}
+export interface A2AConformanceSuiteResult {
+    passed: boolean;
+    total: number;
+    failed: number;
+    results: A2AConformanceCaseResult[];
+}
+export declare class A2AConformanceError extends Error {
+    readonly result: A2AConformanceSuiteResult;
+    constructor(result: A2AConformanceSuiteResult);
+}
+export declare function runA2AConformanceSuite(options: A2AConformanceSuiteOptions): Promise<A2AConformanceSuiteResult>;
+export declare function createInMemoryA2AConformanceStores(): A2AConformanceStores;
+//# sourceMappingURL=runner.d.ts.map

package/dist/a2a/conformance/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/a2a/conformance/runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,kBAAkB,EAMvB,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzE,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,MAAM,EAAE,yBAAyB;gBAAjC,MAAM,EAAE,yBAAyB;CAQvD;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CA8BpC;AAED,wBAAgB,kCAAkC,IAAI,oBAAoB,CAIzE"}

package/dist/a2a/conformance/runner.js

@@ -0,0 +1,122 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+import { A2A_CONFORMANCE_CASES, matchesA2AReceiptQuery, matchesA2ASignalQuery, } from './cases.js';
+import { A2AReceiptV1Schema } from '../receipt.js';
+import { A2ASignalV1Schema } from '../signal.js';
+export class A2AConformanceError extends Error {
+    result;
+    constructor(result) {
+        const failedNames = result.results
+            .filter((caseResult) => !caseResult.passed)
+            .map((caseResult) => `${caseResult.name}: ${caseResult.error ?? 'failed'}`)
+            .join('; ');
+        super(`A2A conformance suite failed: ${failedNames}`);
+        this.result = result;
+        this.name = 'A2AConformanceError';
+    }
+}
+export async function runA2AConformanceSuite(options) {
+    const cases = options.cases ?? A2A_CONFORMANCE_CASES;
+    const results = [];
+    for (const conformanceCase of cases) {
+        const stores = await options.createStores();
+        try {
+            await conformanceCase.run(stores);
+            results.push({ name: conformanceCase.name, passed: true });
+        }
+        catch (error) {
+            results.push({
+                name: conformanceCase.name,
+                passed: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    const failed = results.filter((caseResult) => !caseResult.passed).length;
+    const result = {
+        passed: failed === 0,
+        total: results.length,
+        failed,
+        results,
+    };
+    if (failed > 0) {
+        throw new A2AConformanceError(result);
+    }
+    return result;
+}
+export function createInMemoryA2AConformanceStores() {
+    const signals = new InMemoryA2ASignalStore();
+    const receipts = new InMemoryA2AReceiptStore();
+    return { signals, receipts };
+}
+class InMemoryA2ASignalStore {
+    signals = [];
+    async appendSignal(signal) {
+        const parsed = A2ASignalV1Schema.parse(signal);
+        const existing = this.signals.find((candidate) => {
+            return (candidate.signal_id === parsed.signal_id ||
+                (parsed.idempotency_key !== undefined &&
+                    candidate.idempotency_key === parsed.idempotency_key));
+        });
+        if (existing) {
+            return existing;
+        }
+        this.signals.push(parsed);
+        return parsed;
+    }
+    async listSignals(query = {}) {
+        return this.signals.filter((signal) => matchesA2ASignalQuery(signal, query));
+    }
+    async listVisibleSignals(query) {
+        return this.signals
+            .filter((signal) => matchesA2ASignalQuery(signal, query))
+            .filter((signal) => isSignalVisibleToReader(signal, query));
+    }
+}
+class InMemoryA2AReceiptStore {
+    receipts = new Map();
+    async markDelivered(input) {
+        return this.appendReceipt({
+            schema_version: 'A2A.V1',
+            receipt_id: input.receipt_id ?? `rcpt-${input.reader_identity}-${input.signal_id}`,
+            signal_id: input.signal_id,
+            reader_identity: input.reader_identity,
+            read_at: input.read_at ?? new Date().toISOString(),
+            delivery_state: 'delivered',
+            idempotency_key: input.idempotency_key,
+        });
+    }
+    async appendReceipt(receipt) {
+        const parsed = A2AReceiptV1Schema.parse(receipt);
+        const key = parsed.idempotency_key ?? parsed.receipt_id;
+        const existing = this.receipts.get(key);
+        const next = existing ? promoteReceipt(existing, parsed) : parsed;
+        this.receipts.set(key, next);
+        return next;
+    }
+    async listReceipts(query = {}) {
+        return Array.from(this.receipts.values()).filter((receipt) => matchesA2AReceiptQuery(receipt, query));
+    }
+}
+function isSignalVisibleToReader(signal, query) {
+    if (signal.recipients.length === 0 || signal.recipients.includes(query.reader_identity)) {
+        return true;
+    }
+    return ((query.wu_id !== undefined && signal.wu_id === query.wu_id) ||
+        (query.initiative !== undefined && signal.initiative === query.initiative));
+}
+function promoteReceipt(current, next) {
+    assertSameReceiptTarget(current, next);
+    if (current.delivery_state !== 'delivered') {
+        return current;
+    }
+    return next.delivery_state === 'delivered' ? current : next;
+}
+function assertSameReceiptTarget(current, next) {
+    if (current.signal_id !== next.signal_id ||
+        current.reader_identity !== next.reader_identity ||
+        current.receipt_id !== next.receipt_id) {
+        throw new Error(`A2A receipt idempotency conflict for ${next.receipt_id}: signal_id, reader_identity, and receipt_id must match existing receipt.`);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/a2a/conformance/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/a2a/conformance/runner.ts"],"names":[],"mappings":"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"}

package/dist/a2a/index.d.ts

@@ -0,0 +1,3 @@
+export * from './signal.js';
+export * from './receipt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/a2a/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/a2a/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+export * from './signal.js';
+export * from './receipt.js';
+//# sourceMappingURL=index.js.map

package/dist/a2a/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/a2a/receipt.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { SignalEntry } from '../signal-sync-port.js';
+import { type A2AOrigin } from './signal.js';
+export declare const A2A_RECEIPT_ENTRY_KIND_V1: "a2a.receipt.v1";
+export declare const A2A_RECEIPT_DELIVERY_STATES: readonly ["delivered", "acked", "rejected"];
+/**
+ * Canonical receipt payload for A2A signal delivery.
+ *
+ * Local adapters use `delivered` when an inbox read marks visibility. ACK and
+ * rejection promotion are transport/lifecycle behaviors layered on the same
+ * receipt identity; timeout policy is intentionally owned by the bus/runtime,
+ * not by this durable payload.
+ */
+export declare const A2AReceiptV1Schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"A2A.V1">;
+    receipt_id: z.ZodString;
+    signal_id: z.ZodString;
+    reader_identity: z.ZodString;
+    read_at: z.ZodString;
+    delivery_state: z.ZodEnum<{
+        rejected: "rejected";
+        acked: "acked";
+        delivered: "delivered";
+    }>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type A2AReceiptV1 = z.infer<typeof A2AReceiptV1Schema>;
+export type A2AReceiptDeliveryState = (typeof A2A_RECEIPT_DELIVERY_STATES)[number];
+export interface A2AReceiptEntryV1 extends SignalEntry {
+    kind: typeof A2A_RECEIPT_ENTRY_KIND_V1;
+    payload: A2AReceiptV1 & Record<string, unknown>;
+    origin?: A2AOrigin;
+}
+//# sourceMappingURL=receipt.d.ts.map

package/dist/a2a/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/a2a/receipt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpE,eAAO,MAAM,yBAAyB,EAAG,gBAAyB,CAAC;AAEnE,eAAO,MAAM,2BAA2B,6CAA8C,CAAC;AAEvF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,IAAI,EAAE,OAAO,yBAAyB,CAAC;IACvC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB"}

package/dist/a2a/receipt.js

@@ -0,0 +1,24 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+import { z } from 'zod';
+import { A2A_SCHEMA_VERSION_V1 } from './signal.js';
+export const A2A_RECEIPT_ENTRY_KIND_V1 = 'a2a.receipt.v1';
+export const A2A_RECEIPT_DELIVERY_STATES = ['delivered', 'acked', 'rejected'];
+/**
+ * Canonical receipt payload for A2A signal delivery.
+ *
+ * Local adapters use `delivered` when an inbox read marks visibility. ACK and
+ * rejection promotion are transport/lifecycle behaviors layered on the same
+ * receipt identity; timeout policy is intentionally owned by the bus/runtime,
+ * not by this durable payload.
+ */
+export const A2AReceiptV1Schema = z.object({
+    schema_version: z.literal(A2A_SCHEMA_VERSION_V1),
+    receipt_id: z.string().min(1),
+    signal_id: z.string().min(1),
+    reader_identity: z.string().min(1),
+    read_at: z.string().datetime(),
+    delivery_state: z.enum(A2A_RECEIPT_DELIVERY_STATES),
+    idempotency_key: z.string().min(1).optional(),
+});
+//# sourceMappingURL=receipt.js.map

package/dist/a2a/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/a2a/receipt.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAkB,MAAM,aAAa,CAAC;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAyB,CAAC;AAEnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC;IACnD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC"}

package/dist/a2a/signal.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import type { SignalEntry } from '../signal-sync-port.js';
+export declare const A2A_SCHEMA_VERSION_V1: "A2A.V1";
+export declare const A2A_SIGNAL_ENTRY_KIND_V1: "a2a.signal.v1";
+export declare const A2A_SIGNAL_INTENTS: readonly ["INFO", "PROPOSE", "COUNTER", "AGREE", "REJECT"];
+export declare const A2A_INTERRUPT_CLASSES: readonly ["advisory", "priority", "urgent", "soon", "immediate"];
+export declare const A2A_INTERRUPT_CLASS_DEFAULTS: {
+    readonly broadcast: "advisory";
+    readonly directed: "priority";
+};
+export declare const A2A_ORIGINS: readonly ["local", "remote"];
+export declare function normalizeA2ARecipients(recipients: readonly string[]): string[];
+/**
+ * Canonical agent-to-agent signal payload.
+ *
+ * `workspace_id is optional for local adapters`; cloud transports must provide workspace_id as
+ * their tenant/workspace routing key. `schema_version` is mandatory on every
+ * payload so local JSONL, package exports, and hosted transports can evolve in
+ * parallel. Breaking changes require parallel A2ASignalV2 support rather than
+ * mutating this schema in place.
+ */
+export declare const A2ASignalV1Schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"A2A.V1">;
+    signal_id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    sender_identity: z.ZodString;
+    recipients: z.ZodArray<z.ZodString>;
+    thread_id: z.ZodOptional<z.ZodString>;
+    reply_to: z.ZodOptional<z.ZodString>;
+    intent: z.ZodOptional<z.ZodEnum<{
+        INFO: "INFO";
+        PROPOSE: "PROPOSE";
+        COUNTER: "COUNTER";
+        AGREE: "AGREE";
+        REJECT: "REJECT";
+    }>>;
+    interrupt_class: z.ZodOptional<z.ZodEnum<{
+        advisory: "advisory";
+        priority: "priority";
+        urgent: "urgent";
+        soon: "soon";
+        immediate: "immediate";
+    }>>;
+    requires_ack: z.ZodOptional<z.ZodBoolean>;
+    message: z.ZodString;
+    created_at: z.ZodString;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        local: "local";
+        remote: "remote";
+    }>>;
+    wu_id: z.ZodOptional<z.ZodString>;
+    initiative: z.ZodOptional<z.ZodString>;
+    lane: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    target_role: z.ZodOptional<z.ZodString>;
+    delegation_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type A2ASignalV1 = z.infer<typeof A2ASignalV1Schema>;
+export type A2AInterruptClass = (typeof A2A_INTERRUPT_CLASSES)[number];
+export type A2AIntent = (typeof A2A_SIGNAL_INTENTS)[number];
+export type A2AOrigin = (typeof A2A_ORIGINS)[number];
+export interface A2ASignalEntryV1 extends SignalEntry {
+    kind: typeof A2A_SIGNAL_ENTRY_KIND_V1;
+    payload: A2ASignalV1 & Record<string, unknown>;
+}
+//# sourceMappingURL=signal.d.ts.map

package/dist/a2a/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/a2a/signal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,eAAO,MAAM,qBAAqB,EAAG,QAAiB,CAAC;AACvD,eAAO,MAAM,wBAAwB,EAAG,eAAwB,CAAC;AAEjE,eAAO,MAAM,kBAAkB,4DAA6D,CAAC;AAE7F,eAAO,MAAM,qBAAqB,kEAMxB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;CAGkC,CAAC;AAE5E,eAAO,MAAM,WAAW,8BAA+B,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAI9E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,EAAE,OAAO,wBAAwB,CAAC;IACtC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD"}

package/dist/a2a/signal.js

@@ -0,0 +1,53 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: LicenseRef-LumenFlow-Proprietary
+import { z } from 'zod';
+export const A2A_SCHEMA_VERSION_V1 = 'A2A.V1';
+export const A2A_SIGNAL_ENTRY_KIND_V1 = 'a2a.signal.v1';
+export const A2A_SIGNAL_INTENTS = ['INFO', 'PROPOSE', 'COUNTER', 'AGREE', 'REJECT'];
+export const A2A_INTERRUPT_CLASSES = [
+    'advisory',
+    'priority',
+    'urgent',
+    'soon',
+    'immediate',
+];
+export const A2A_INTERRUPT_CLASS_DEFAULTS = {
+    broadcast: 'advisory',
+    directed: 'priority',
+};
+export const A2A_ORIGINS = ['local', 'remote'];
+export function normalizeA2ARecipients(recipients) {
+    return Array.from(new Set(recipients.map((recipient) => recipient.trim()).filter((recipient) => recipient)));
+}
+/**
+ * Canonical agent-to-agent signal payload.
+ *
+ * `workspace_id is optional for local adapters`; cloud transports must provide workspace_id as
+ * their tenant/workspace routing key. `schema_version` is mandatory on every
+ * payload so local JSONL, package exports, and hosted transports can evolve in
+ * parallel. Breaking changes require parallel A2ASignalV2 support rather than
+ * mutating this schema in place.
+ */
+export const A2ASignalV1Schema = z.object({
+    schema_version: z.literal(A2A_SCHEMA_VERSION_V1),
+    signal_id: z.string().min(1),
+    workspace_id: z.string().min(1).optional(),
+    sender_identity: z.string().min(1),
+    recipients: z.array(z.string().min(1)),
+    thread_id: z.string().min(1).optional(),
+    reply_to: z.string().min(1).optional(),
+    intent: z.enum(A2A_SIGNAL_INTENTS).optional(),
+    interrupt_class: z.enum(A2A_INTERRUPT_CLASSES).optional(),
+    requires_ack: z.boolean().optional(),
+    message: z.string().min(1),
+    created_at: z.string().datetime(),
+    idempotency_key: z.string().min(1).optional(),
+    origin: z.enum(A2A_ORIGINS).optional(),
+    wu_id: z.string().min(1).optional(),
+    initiative: z.string().min(1).optional(),
+    lane: z.string().min(1).optional(),
+    role: z.string().min(1).optional(),
+    target_role: z.string().min(1).optional(),
+    delegation_id: z.string().min(1).optional(),
+});
+//# sourceMappingURL=signal.js.map

package/dist/a2a/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/a2a/signal.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from './wu-events.js';
 export * from './replay-artifact.js';
 export * from './pack-outcome-descriptor.js';
 export * from './scope-grammar.js';
+export * from './a2a/index.js';
 export * from './http/http-control-plane-sync-port.js';
 export * from './mock/mock-control-plane-sync-port.js';
 export * from './mock/mock-signal-sync-port.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@ export * from './wu-events.js';
 export * from './replay-artifact.js';
 export * from './pack-outcome-descriptor.js';
 export * from './scope-grammar.js';
+export * from './a2a/index.js';
 export * from './http/http-control-plane-sync-port.js';
 export * from './mock/mock-control-plane-sync-port.js';
 export * from './mock/mock-signal-sync-port.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4DAA4D;AAE5D,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/control-plane-sdk",
-  "version": "5.3.2",
+  "version": "5.5.0",
   "description": "Control plane sync contracts and adapters for LumenFlow runtime",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,6 +16,16 @@
       "import": "./dist/scope-grammar.js",
       "default": "./dist/scope-grammar.js"
     },
+    "./a2a": {
+      "types": "./dist/a2a/index.d.ts",
+      "import": "./dist/a2a/index.js",
+      "default": "./dist/a2a/index.js"
+    },
+    "./a2a/conformance": {
+      "types": "./dist/a2a/conformance/index.d.ts",
+      "import": "./dist/a2a/conformance/index.js",
+      "default": "./dist/a2a/conformance/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [