@relayflows/sdk 2.0.22 → 2.0.23

package/dist/communication/projection.js

@@ -0,0 +1,23 @@
+/** Observer publication never participates in delivery, acknowledgement, or completion. */
+export function createProjection(messaging, channel, runId, diagnostic = (value) => { process.stderr.write(`${JSON.stringify(value)}\n`); }) {
+    let ready;
+    return (message) => {
+        const publish = async () => {
+            ready ??= (async () => {
+                try {
+                    await messaging.channels.create({ name: channel });
+                }
+                catch {
+                    await messaging.channels.get(channel);
+                    await messaging.channels.join(channel);
+                }
+            })().catch(error => { ready = undefined; throw error; });
+            await ready;
+            await messaging.messages.send({ channel, ...message });
+        };
+        void publish().catch(() => diagnostic({ kind: 'communication_projection_failed', run_id: runId,
+            channel, idempotency_key: message.idempotencyKey,
+            message: 'Observer publication failed; the durable conversation continues.' }));
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/communication/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/communication/projection.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,SAAyB,EAAE,OAAe,EAAE,KAAa,EACxF,aAAa,CAAC,KAAa,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvF,IAAI,KAAgC,CAAC;IACrC,OAAO,CAAC,OAAoF,EAAQ,EAAE;QACpG,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,KAAK,KAAK,CAAC,KAAK,IAAI,EAAE;gBACpB,IAAI,CAAC;oBAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAAC,CAAC;gBAC3D,MAAM,CAAC;oBACL,MAAM,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACtC,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,MAAM,KAAK,CAAC;YACZ,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,KAAK,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,MAAM,EAAE,KAAK;YAC5F,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,cAAc;YAChD,OAAO,EAAE,kEAAkE,EAAE,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC;AACJ,CAAC"}

package/dist/communication/relay.d.ts

@@ -0,0 +1,78 @@
+import { createProjection } from './projection.js';
+export interface RelayEvent {
+    kind: string;
+    name?: string;
+    event_id?: string;
+    delivery_id?: string;
+    verification?: string;
+    [key: string]: unknown;
+}
+export interface RelayHandle {
+    name: string;
+    generation?: string;
+    waitForReady(timeout?: number): Promise<{
+        reason: string;
+    }>;
+    release(reason?: string, options?: {
+        deleteIdentity?: boolean;
+    }): Promise<unknown>;
+}
+export interface RelayBroker {
+    spawnPty(input: Record<string, unknown>): Promise<RelayHandle>;
+    onEvent(callback: (event: RelayEvent) => void): () => void;
+    shutdown(): Promise<void>;
+}
+export interface RelayMessaging {
+    agents: {
+        register(input: {
+            name: string;
+            type: string;
+        }): Promise<{
+            token: string;
+        }>;
+        delete(name: string): Promise<void>;
+    };
+    channels: {
+        create(input: {
+            name: string;
+        }): Promise<unknown>;
+        get(name: string): Promise<unknown>;
+        join(name: string): Promise<void>;
+    };
+    messages: {
+        direct(input: {
+            to: string;
+            text: string;
+            idempotencyKey: string;
+            metadata: Record<string, unknown>;
+            mode: 'wait';
+        }): Promise<{
+            id: string;
+        }>;
+        send(input: {
+            channel: string;
+            text: string;
+            idempotencyKey: string;
+            metadata: Record<string, unknown>;
+        }): Promise<unknown>;
+    };
+}
+interface RelayModules {
+    HarnessDriverClient: {
+        spawn(options: Record<string, unknown>): Promise<RelayBroker>;
+    };
+    RelaycastMessagingClient: new (options: Record<string, unknown>) => RelayMessaging;
+}
+export declare function loadRelayModules(): Promise<RelayModules>;
+export declare function relayWorkspaceKey(env?: NodeJS.ProcessEnv): string;
+export interface RelayRuntime {
+    broker: RelayBroker;
+    messaging: RelayMessaging;
+    prefix: string;
+    channel: string;
+    project: ReturnType<typeof createProjection>;
+    close(): Promise<void>;
+}
+export declare function acquireRelayRuntime(dataDir: string, runId: string): Promise<RelayRuntime>;
+export {};
+//# sourceMappingURL=relay.d.ts.map

package/dist/communication/relay.d.ts.map

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

package/dist/communication/relay.js

@@ -0,0 +1,89 @@
+import { randomUUID, createHash } from 'node:crypto';
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createProjection } from './projection.js';
+import { brokerEnvironment } from './environment.js';
+export async function loadRelayModules() {
+    // Variable imports keep optional packages out of ordinary execution and bundles.
+    const driver = '@agent-relay/harness-driver';
+    const sdk = '@agent-relay/sdk';
+    try {
+        const [harness, messaging] = await Promise.all([import(driver), import(sdk)]);
+        return { HarnessDriverClient: harness.HarnessDriverClient, RelaycastMessagingClient: messaging.RelaycastMessagingClient };
+    }
+    catch {
+        throw new Error('Agent communication requires optional @agent-relay/harness-driver and @agent-relay/sdk packages (>=12.3.1).');
+    }
+}
+export function relayWorkspaceKey(env = process.env) {
+    const key = env.RELAY_API_KEY?.trim();
+    if (!key?.startsWith('rk_live_'))
+        throw new Error('Agent communication requires RELAY_API_KEY for an existing workspace.');
+    return key;
+}
+const runtimes = new Map();
+export async function acquireRelayRuntime(dataDir, runId) {
+    const key = `${dataDir}\0${runId}`;
+    let entry = runtimes.get(key);
+    if (!entry) {
+        entry = { references: 0, runtime: createRuntime(dataDir, runId) };
+        runtimes.set(key, entry);
+    }
+    entry.references++;
+    try {
+        const runtime = await entry.runtime;
+        let closed = false;
+        return { ...runtime, close: async () => {
+                if (closed)
+                    return;
+                closed = true;
+                if (--entry.references === 0) {
+                    runtimes.delete(key);
+                    await runtime.close();
+                }
+            } };
+    }
+    catch (error) {
+        if (--entry.references === 0)
+            runtimes.delete(key);
+        throw error;
+    }
+}
+async function createRuntime(dataDir, runId) {
+    const workspaceKey = relayWorkspaceKey();
+    const { HarnessDriverClient, RelaycastMessagingClient } = await loadRelayModules();
+    const hash = createHash('sha256').update(runId).digest('hex').slice(0, 12);
+    const prefix = `flow-${hash}-${randomUUID().slice(0, 8)}`;
+    const channel = `wf-${runId.toLowerCase()}`;
+    const options = { workspaceKey, ...(process.env.RELAY_BASE_URL ? { baseUrl: process.env.RELAY_BASE_URL } : {}) };
+    const workspace = new RelaycastMessagingClient(options);
+    const publisher = `${prefix}-journal`;
+    const registration = await workspace.agents.register({ name: publisher, type: 'agent' });
+    let broker;
+    try {
+        const messaging = new RelaycastMessagingClient({ ...options, agentToken: registration.token });
+        const cwd = join(dataDir, 'communication', prefix);
+        await mkdir(cwd, { recursive: true, mode: 0o700 });
+        broker = await HarnessDriverClient.spawn({ workspaceKey, brokerName: prefix, cwd, channels: [],
+            ...(process.env.RELAYFLOW_RELAY_BROKER_BIN ? { binaryPath: process.env.RELAYFLOW_RELAY_BROKER_BIN } : {}),
+            env: brokerEnvironment(process.env) });
+        return { broker, messaging, prefix, channel, project: createProjection(messaging, channel, runId), close: async () => {
+                try {
+                    await broker.shutdown();
+                }
+                finally {
+                    await workspace.agents.delete(publisher);
+                }
+            } };
+    }
+    catch (error) {
+        try {
+            await broker?.shutdown();
+        }
+        finally {
+            await workspace.agents.delete(publisher);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/communication/relay.js.map

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

package/dist/communication/session.d.ts

@@ -0,0 +1,24 @@
+import type { JournalClient } from '../journal-client.js';
+import type { StepDispatchEvent } from '../protocol.js';
+import type { CommunicationInstruction } from './spec.js';
+import type { RelayRuntime } from './relay.js';
+import type { CommunicationToolRequest } from './tools.js';
+/** Journal operations belong to the dispatched worker connection, never the broker. */
+export declare class CommunicationSession {
+    private readonly client;
+    private readonly dispatch;
+    private readonly spec;
+    private readonly relay;
+    private readonly complete;
+    private readonly fatal;
+    private readonly pending;
+    private finished;
+    private serial;
+    constructor(client: JournalClient, dispatch: StepDispatchEvent, spec: CommunicationInstruction, relay: RelayRuntime, complete: (summary: string) => void, fatal?: (error: unknown) => void);
+    private identity;
+    private lock;
+    private journal;
+    invoke(request: CommunicationToolRequest): Promise<unknown>;
+    pump(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/communication/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/communication/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,uFAAuF;AACvF,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAiB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAC3E,OAAO,CAAC,QAAQ,CAAC,IAAI;IAA4B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAuC;gBACxB,MAAM,EAAE,aAAa,EAAmB,QAAQ,EAAE,iBAAiB,EAC7E,IAAI,EAAE,wBAAwB,EAAmB,KAAK,EAAE,YAAY,EACpE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACnC,KAAK,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAe;IAE7D,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,IAAI;YAKE,OAAO;IAIrB,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8B3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAsBtB"}

package/dist/communication/session.js

@@ -0,0 +1,100 @@
+import { createHash } from 'node:crypto';
+import { channelName } from './spec.js';
+/** Journal operations belong to the dispatched worker connection, never the broker. */
+export class CommunicationSession {
+    client;
+    dispatch;
+    spec;
+    relay;
+    complete;
+    fatal;
+    pending = new Map();
+    finished = false;
+    serial = Promise.resolve();
+    constructor(client, dispatch, spec, relay, complete, fatal = () => { }) {
+        this.client = client;
+        this.dispatch = dispatch;
+        this.spec = spec;
+        this.relay = relay;
+        this.complete = complete;
+        this.fatal = fatal;
+    }
+    identity(from, to) {
+        const { run_id, step_id, attempt, idempotency_key } = this.dispatch;
+        return { run_id, step_id, attempt, idempotency_key, channel: channelName(from, to) };
+    }
+    lock(work) {
+        const next = this.serial.then(work);
+        this.serial = next.catch(() => { });
+        return next;
+    }
+    async journal(write) {
+        try {
+            return await write();
+        }
+        catch (error) {
+            this.fatal(error);
+            throw error;
+        }
+    }
+    invoke(request) {
+        return this.lock(async () => {
+            if (this.finished)
+                throw new Error('Communication session has completed');
+            const { operation, values } = request;
+            const [peer, id, text] = values;
+            if (operation === 'send') {
+                if (values.length !== 3 || !peer || !this.spec.outgoing.includes(peer) || !id || !text)
+                    throw new Error('Use send DECLARED_PEER STABLE_MESSAGE_ID TEXT');
+                // Only the kernel deduplicates sends across worker attempts.
+                return this.journal(() => this.client.channelAppend({ ...this.identity(this.dispatch.step_id, peer), message_id: id, message: text }));
+            }
+            if (operation === 'ack') {
+                if (values.length !== 2 || !peer || !this.spec.incoming.includes(peer)
+                    || !Number.isSafeInteger(Number(id)) || this.pending.get(peer) !== Number(id))
+                    throw new Error('Use ack PEER DELIVERY_SEQ from a received message');
+                const result = await this.journal(() => this.client.channelAck({ ...this.identity(peer, this.dispatch.step_id), delivery_seq: Number(id) }));
+                this.pending.delete(peer);
+                return result;
+            }
+            if (operation === 'complete') {
+                if (values.length !== 1 || !peer)
+                    throw new Error('Use complete SUMMARY');
+                if (this.pending.size)
+                    throw new Error('Acknowledge processed messages before completing');
+                this.finished = true;
+                // Let the tool response flush before releasing its managed process.
+                setTimeout(() => this.complete(peer), 100);
+                return { completed: true };
+            }
+            throw new Error('Unknown communication operation');
+        });
+    }
+    pump() {
+        return this.lock(async () => {
+            if (this.finished)
+                return;
+            for (const peer of this.spec.incoming) {
+                if (this.pending.has(peer))
+                    continue;
+                const entry = await this.client.channelReceive(this.identity(peer, this.dispatch.step_id));
+                if (!entry)
+                    continue;
+                const key = createHash('sha256').update(JSON.stringify([
+                    this.dispatch.run_id, this.dispatch.step_id, this.dispatch.attempt, entry.seq,
+                ])).digest('hex');
+                const text = `Flow message from ${peer}; delivery_seq=${entry.seq}.\n${JSON.stringify(entry.payload.message)}\nAfter processing, use the flow helper: ack ${peer} ${entry.seq}.`;
+                const metadata = { run_id: this.dispatch.run_id, step_id: this.dispatch.step_id, delivery_seq: entry.seq };
+                // A successful injection is not a processing acknowledgement.
+                await this.relay.messaging.messages.direct({ to: `${this.relay.prefix}-${this.dispatch.step_id}`,
+                    text, metadata, idempotencyKey: key, mode: 'wait' });
+                this.pending.set(peer, entry.seq);
+                this.relay.project({
+                    text: `${peer} -> ${this.dispatch.step_id}: ${JSON.stringify(entry.payload.message)}`,
+                    metadata, idempotencyKey: `${key}-projection`
+                });
+            }
+        });
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/communication/session.js.map

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

package/dist/communication/spec.d.ts

@@ -0,0 +1,20 @@
+import type { StepSpec } from '../spec.js';
+export declare const COMMUNICATION_TYPE = "relayflows.communication.v1";
+export interface CommunicationEdge {
+    from: string;
+    to: string;
+}
+export interface CommunicationInstruction {
+    type: typeof COMMUNICATION_TYPE;
+    instruction: string;
+    incoming: string[];
+    outgoing: string[];
+    timeoutMs: number;
+}
+export declare function channelName(from: string, to: string): string;
+export declare function communicationInstruction(instruction: unknown): CommunicationInstruction | undefined;
+/** Authoring sugar only: kernel vocabulary remains agent + declared streams. */
+export declare function expandCommunication(value: unknown): unknown;
+/** Check normalized dependencies too, including implicit input bindings. */
+export declare function validateCommunicationTopology(steps: StepSpec[]): void;
+//# sourceMappingURL=spec.d.ts.map

package/dist/communication/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/communication/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAChE,MAAM,WAAW,iBAAiB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAC/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,kBAAkB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D;AACD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAanG;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqD3D;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAgBrE"}

package/dist/communication/spec.js

@@ -0,0 +1,113 @@
+import { createHash } from 'node:crypto';
+export const COMMUNICATION_TYPE = 'relayflows.communication.v1';
+const record = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const name = (v) => typeof v === 'string' && /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(v);
+export function channelName(from, to) {
+    return `a2a-${createHash('sha256').update(JSON.stringify([from, to])).digest('hex').slice(0, 24)}`;
+}
+export function communicationInstruction(instruction) {
+    if (typeof instruction !== 'string' || !instruction.startsWith('{'))
+        return;
+    let value;
+    try {
+        value = JSON.parse(instruction);
+    }
+    catch {
+        return;
+    }
+    if (!record(value) || value.type !== COMMUNICATION_TYPE)
+        return;
+    if (Object.keys(value).some(k => !['type', 'instruction', 'incoming', 'outgoing', 'timeoutMs'].includes(k))
+        || typeof value.instruction !== 'string' || !Array.isArray(value.incoming) || !value.incoming.every(name)
+        || !Array.isArray(value.outgoing) || !value.outgoing.every(name)
+        || value.incoming.length + value.outgoing.length === 0
+        || !Number.isSafeInteger(value.timeoutMs) || Number(value.timeoutMs) < 1 || Number(value.timeoutMs) > 900_000) {
+        throw new Error('Invalid agent communication instruction');
+    }
+    return value;
+}
+/** Authoring sugar only: kernel vocabulary remains agent + declared streams. */
+export function expandCommunication(value) {
+    if (!record(value) || !('communication' in value))
+        return value;
+    const { communication, ...flow } = value;
+    if (!record(communication) || Object.keys(communication).some(k => !['links', 'timeoutMs'].includes(k))
+        || !Array.isArray(communication.links) || !Array.isArray(flow.steps)) {
+        throw new Error('communication requires links: [{ from, to }] and optional timeoutMs');
+    }
+    const timeoutMs = communication.timeoutMs ?? 300_000;
+    if (!Number.isSafeInteger(timeoutMs) || Number(timeoutMs) < 1 || Number(timeoutMs) > 900_000) {
+        throw new Error('communication.timeoutMs must be between 1 and 900000');
+    }
+    const steps = flow.steps;
+    const byId = new Map(steps.filter(record).map(step => [step.id, step]));
+    const edges = [];
+    for (const link of communication.links) {
+        if (!record(link) || Object.keys(link).some(k => !['from', 'to'].includes(k))
+            || !name(link.from) || !name(link.to) || link.from === link.to
+            || byId.get(link.from)?.type !== 'agent' || byId.get(link.to)?.type !== 'agent') {
+            throw new Error('communication links must name two different agent step ids');
+        }
+        if (edges.some(e => e.from === link.from && e.to === link.to))
+            throw new Error('Duplicate communication link');
+        edges.push({ from: link.from, to: link.to });
+    }
+    const ancestors = (id, visited = new Set()) => {
+        if (visited.has(id))
+            return visited;
+        visited.add(id);
+        const step = byId.get(id);
+        for (const dependency of Array.isArray(step?.dependsOn) ? step.dependsOn : []) {
+            if (typeof dependency === 'string')
+                ancestors(dependency, visited);
+        }
+        return visited;
+    };
+    for (const edge of edges) {
+        if (ancestors(edge.from).has(edge.to) || ancestors(edge.to).has(edge.from)) {
+            throw new Error('Communicating agents must be concurrent, not dependency ancestors');
+        }
+    }
+    return { ...flow, steps: steps.map(step => {
+            const incoming = edges.filter(e => e.to === step.id).map(e => e.from);
+            const outgoing = edges.filter(e => e.from === step.id).map(e => e.to);
+            if (!incoming.length && !outgoing.length)
+                return step;
+            if (step.transport === 'relay')
+                throw new Error('communication cannot be combined with task transport: relay');
+            if (typeof step.instruction !== 'string')
+                throw new Error('Communicating agents require an instruction');
+            const surfaces = record(step.surfaces) ? step.surfaces : {};
+            const streams = Array.isArray(surfaces.streams) ? surfaces.streams : [];
+            return { ...step,
+                instruction: JSON.stringify({ type: COMMUNICATION_TYPE, instruction: step.instruction, incoming, outgoing, timeoutMs }),
+                // One writer per directed channel; shared writable channels serialize agents.
+                surfaces: { ...surfaces, streams: [...streams,
+                        { stream: channelName(String(step.id), '$receipts') },
+                        ...outgoing.map(to => ({ stream: channelName(String(step.id), to) }))] },
+            };
+        }) };
+}
+/** Check normalized dependencies too, including implicit input bindings. */
+export function validateCommunicationTopology(steps) {
+    const byId = new Map(steps.map(step => [step.id, step]));
+    const communicating = steps.filter(step => step.type === 'agent' && communicationInstruction(step.instruction));
+    const depends = (id, target, visited = new Set()) => {
+        if (visited.has(id))
+            return false;
+        visited.add(id);
+        return byId.get(id)?.dependsOn?.some(parent => parent === target || depends(parent, target, visited)) ?? false;
+    };
+    for (const a of communicating)
+        for (const b of communicating) {
+            if (a.id === b.id || a.type !== 'agent' || b.type !== 'agent')
+                continue;
+            if (depends(a.id, b.id))
+                throw new Error('Communicating agents must be concurrent, not dependency ancestors');
+            if (a.surfaces?.streams?.some(s => b.surfaces?.streams?.some(t => s.stream === t.stream))
+                || a.surfaces?.workspace?.some(s => b.surfaces?.workspace?.some(t => s.surface === t.surface))) {
+                throw new Error('Communicating agents cannot share writable surfaces: the kernel would serialize them');
+            }
+        }
+}
+//# sourceMappingURL=spec.js.map

package/dist/communication/spec.js.map

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

package/dist/communication/tool.d.ts

@@ -0,0 +1,3 @@
+/** Standalone helper source also works when the SDK is bundled into a binary. */
+export declare const toolSource: string;
+//# sourceMappingURL=tool.d.ts.map

package/dist/communication/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/communication/tool.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,UAAU,QAoBtB,CAAC"}

package/dist/communication/tool.js

@@ -0,0 +1,23 @@
+/** Standalone helper source also works when the SDK is bundled into a binary. */
+export const toolSource = String.raw `
+import { createConnection } from 'node:net';
+import { once } from 'node:events';
+async function main() {
+  const path = process.env.RELAYFLOW_COMMUNICATION_SOCKET;
+  const token = process.env.RELAYFLOW_COMMUNICATION_TOKEN;
+  if (!path || !token) throw new Error('No communication session attached to this agent');
+  const [operation, ...values] = process.argv.slice(2);
+  if (!['send', 'ack', 'complete'].includes(operation)) throw new Error('Use send PEER ID TEXT, ack PEER SEQ, or complete SUMMARY');
+  const socket = createConnection(path);
+  await once(socket, 'connect');
+  socket.setTimeout(30_000, () => socket.destroy(new Error('Communication tool timed out')));
+  socket.end(JSON.stringify({ token, operation, values }) + '\n');
+  let text = '';
+  for await (const chunk of socket) text += chunk;
+  const result = JSON.parse(text);
+  if (typeof result.error === 'string') throw new Error(result.error);
+  process.stdout.write(JSON.stringify(result.result) + '\n');
+}
+void main().catch(error => { console.error(error.message); process.exitCode = 1; });
+`;
+//# sourceMappingURL=tool.js.map

package/dist/communication/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/communication/tool.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;CAoBnC,CAAC"}

package/dist/communication/tools.d.ts

@@ -0,0 +1,11 @@
+export interface CommunicationToolRequest {
+    operation: string;
+    values: string[];
+}
+export declare function openCommunicationTools(invoke: (request: CommunicationToolRequest) => Promise<unknown>): Promise<{
+    path: string;
+    helperPath: string;
+    token: string;
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/communication/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/communication/tools.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE;AACjF,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,OAAO,CAAC;;;;;GAyC3G"}

package/dist/communication/tools.js

@@ -0,0 +1,65 @@
+import { toolSource } from './tool.js';
+import { createServer } from 'node:net';
+import { chmod, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomBytes, timingSafeEqual } from 'node:crypto';
+export async function openCommunicationTools(invoke) {
+    const directory = await mkdtemp(join(tmpdir(), 'flows-comm-'));
+    const path = join(directory, 'agent.sock');
+    const helperPath = join(directory, 'tool.mjs');
+    const token = randomBytes(32).toString('hex');
+    const sockets = new Set();
+    let busy = false;
+    const server = createServer({ allowHalfOpen: true }, socket => {
+        sockets.add(socket);
+        socket.on('close', () => sockets.delete(socket));
+        socket.on('error', () => { });
+        socket.setTimeout(30_000, () => socket.destroy());
+        let text = '';
+        socket.on('data', chunk => {
+            text += chunk;
+            if (Buffer.byteLength(text) > 32_768)
+                socket.destroy();
+        });
+        socket.on('end', async () => {
+            if (busy) {
+                socket.end(JSON.stringify({ error: 'Call communication tools sequentially' }));
+                return;
+            }
+            busy = true;
+            try {
+                const input = JSON.parse(text);
+                if (typeof input.token !== 'string' || Buffer.byteLength(input.token) !== Buffer.byteLength(token)
+                    || !timingSafeEqual(Buffer.from(input.token), Buffer.from(token)))
+                    throw new Error('Unauthorized communication session');
+                if (typeof input.operation !== 'string' || !Array.isArray(input.values)
+                    || !input.values.every((value) => typeof value === 'string'))
+                    throw new Error('Invalid communication tool request');
+                socket.end(JSON.stringify({ result: await invoke({ operation: input.operation, values: input.values }) }));
+            }
+            catch (error) {
+                socket.end(JSON.stringify({ error: error instanceof Error ? error.message : 'Communication tool failed' }));
+            }
+            finally {
+                busy = false;
+            }
+        });
+    });
+    try {
+        await new Promise((resolve, reject) => { server.once('error', reject); server.listen(path, resolve); });
+        await chmod(path, 0o600);
+        await writeFile(helperPath, toolSource, { mode: 0o600 });
+    }
+    catch (error) {
+        await rm(directory, { recursive: true, force: true });
+        throw error;
+    }
+    return { path, helperPath, token, close: async () => {
+            for (const socket of sockets)
+                socket.destroy();
+            await new Promise((resolve, reject) => server.close(error => error ? reject(error) : resolve()));
+            await rm(directory, { recursive: true, force: true });
+        } };
+}
+//# sourceMappingURL=tools.js.map

package/dist/communication/tools.js.map

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