@paintenzero/orchestra-bus 0.1.0

package/dist/bus.d.ts

@@ -0,0 +1,120 @@
+import { type Envelope, type ObservabilityEvent, type ControlMessage, type AgentRegistration, type AgentStatus, type PresenceEvent, type SessionEvent } from "@paintenzero/orchestra-protocol";
+import type { BusOptions, RequestOptions, RequestHandler, Unsubscribe } from "./types.js";
+export declare class RequestTimeoutError extends Error {
+    target: string;
+    correlationId: string;
+    constructor(target: string, correlationId: string);
+}
+export declare class RemoteError extends Error {
+    target: string;
+    constructor(target: string, message: string);
+}
+/**
+ * One bus client per participant. Every agent, the orchestrator, and each UI
+ * session constructs one of these. The transport (Redis) is fully hidden behind
+ * publishEvent / subscribeEvents / request / onRequest / control / presence.
+ */
+export declare class Bus {
+    readonly clientId: string;
+    private readonly url;
+    private readonly redis;
+    private readonly auxConns;
+    private running;
+    private heartbeat?;
+    private registration?;
+    private readonly redisOpts;
+    constructor(opts: BusOptions);
+    private aux;
+    /** Append an event to a session's replayable stream. */
+    publishEvent(sessionId: string, event: ObservabilityEvent, opts?: {
+        causationId?: string;
+    }): Promise<void>;
+    /**
+     * Tail a session's event stream. `from`: "now" (default, only new), "start"
+     * (replay full history then tail), or a specific stream id to resume from.
+     */
+    subscribeEvents(sessionId: string, handler: (event: ObservabilityEvent, env: Envelope<ObservabilityEvent>) => void, opts?: {
+        from?: "now" | "start" | string;
+    }): Unsubscribe;
+    /**
+     * One-shot read of a session's full event history (XRANGE - +). Used by
+     * persisters to archive the trace and by the orchestrator to serve a durable
+     * transcript when the S3 archive isn't there yet. Returns full envelopes so
+     * callers keep messageId / ts / source.
+     */
+    readEvents(sessionId: string): Promise<Envelope<ObservabilityEvent>[]>;
+    /**
+     * Claim a message id exactly once (Phase 6, WS3). Returns true the first time a
+     * key is seen, false on every repeat within the TTL window — so a redelivered
+     * request/control message executes at most once. Namespaced per client.
+     */
+    dedupe(key: string, ttlMs?: number): Promise<boolean>;
+    /**
+     * Snapshot a task's working memory (e.g. an agent's per-task conversation) so the
+     * task survives idle-eviction and process restarts. Keyed per client + task and
+     * TTL'd. `messages` is opaque JSON to the bus (the agent owns its shape).
+     */
+    saveTaskContext(taskId: string, messages: unknown[]): Promise<void>;
+    /** Load a previously snapshotted task working memory, or undefined if none. */
+    loadTaskContext(taskId: string): Promise<unknown[] | undefined>;
+    /** Liveness check for the Redis connection (Phase 6, WS8 /readyz). */
+    ping(): Promise<boolean>;
+    /** Length of a stream (e.g. a DLQ depth), 0 if it doesn't exist. */
+    streamLen(key: string): Promise<number>;
+    /** Count of pending (delivered, un-acked) requests for an agent's worker group. */
+    pendingCount(agentId: string, group?: string): Promise<number>;
+    /** Announce a newly allocated session so recorders can persist + tail it. */
+    announceSession(ev: SessionEvent): Promise<void>;
+    /** React to sessions being opened in real time (mirrors watchPresence). */
+    watchSessions(handler: (event: SessionEvent) => void): Unsubscribe;
+    /** Send a directed request to an agent and await its correlated reply. */
+    request<R = unknown>(target: string, payload: unknown, opts?: RequestOptions): Promise<R>;
+    /**
+     * Register a handler for inbound requests addressed to this client. Uses a
+     * consumer group so multiple instances of the same agent load-balance work.
+     * NOTE: delivery is at-least-once — make handlers idempotent or dedupe on
+     * meta.messageId.
+     */
+    onRequest(handler: RequestHandler, opts?: {
+        group?: string;
+        consumer?: string;
+    }): Unsubscribe;
+    private reclaimStuck;
+    private handleRequest;
+    /** Write a correlated reply onto the request's replyTo stream. */
+    private sendReply;
+    /**
+     * Fire a control signal at an agent's current run (chat / steer / cancel / …).
+     * `opts.sessionId` rides on the envelope so the agent knows which conversation
+     * the message belongs to. WS5: this goes to a **durable, replayable stream**, not
+     * fire-and-forget pub/sub — so a message sent while the agent is briefly offline
+     * is delivered when it reconnects (a blocking XREAD is still instant when live).
+     */
+    publishControl(agentId: string, msg: ControlMessage, opts?: {
+        sessionId?: string;
+    }): Promise<void>;
+    /**
+     * Listen for control signals addressed to this client (WS5). Tails the durable
+     * control stream with a blocking XREAD, resuming from the last id this client
+     * processed (persisted in Redis), so a process that was briefly down catches up on
+     * messages it missed. Incompatible-schema envelopes are dropped with a warning.
+     */
+    subscribeControl(handler: (msg: ControlMessage, env: Envelope<ControlMessage>) => void): Unsubscribe;
+    /** Announce this agent and start the heartbeat that keeps it "online". */
+    register(reg: Omit<AgentRegistration, "startedAt"> & {
+        startedAt?: number;
+    }): Promise<void>;
+    updateStatus(status: AgentStatus): Promise<void>;
+    deregister(): Promise<void>;
+    /** Snapshot of all agents currently online. */
+    listAgents(): Promise<AgentRegistration[]>;
+    /** Agents currently online that advertise a given capability. */
+    findAgents(capability: string): Promise<AgentRegistration[]>;
+    /** React to agents coming and going in real time. */
+    watchPresence(handler: (event: PresenceEvent) => void): Unsubscribe;
+    private writePresence;
+    private announce;
+    private dropAux;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

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

package/dist/bus.js

@@ -0,0 +1,535 @@
+import { Redis } from "ioredis";
+import { readFileSync } from "node:fs";
+import { channels, makeEnvelope, uuidv7, isSchemaCompatible, SCHEMA_VERSION, } from "@paintenzero/orchestra-protocol";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const PRESENCE_TTL_S = 15;
+const HEARTBEAT_MS = 5_000;
+const OBS_MAXLEN = Number(process.env.OBS_MAXLEN ?? 10_000); // cap on a session's live stream
+const REPLY_TTL_S = 60; // safety net so abandoned reply streams self-clean
+const CONTROL_MAXLEN = 1_000; // cap on a durable control stream
+const DEDUPE_TTL_MS = Number(process.env.DEDUPE_TTL_MS ?? 86_400_000); // 24h idempotency window
+const RECLAIM_IDLE_MS = Number(process.env.RECLAIM_IDLE_MS ?? 30_000); // reclaim pending idle this long
+const RECLAIM_EVERY_MS = Number(process.env.RECLAIM_EVERY_MS ?? 10_000); // how often to sweep for stuck requests
+const MAX_DELIVERIES = Number(process.env.MAX_DELIVERIES ?? 5); // attempts before dead-lettering
+const TASK_CONTEXT_TTL_MS = Number(process.env.TASK_CONTEXT_TTL_MS ?? 7 * 86_400_000); // task snapshot retention
+export class RequestTimeoutError extends Error {
+    target;
+    correlationId;
+    constructor(target, correlationId) {
+        super(`request to "${target}" timed out (correlationId=${correlationId})`);
+        this.target = target;
+        this.correlationId = correlationId;
+        this.name = "RequestTimeoutError";
+    }
+}
+export class RemoteError extends Error {
+    target;
+    constructor(target, message) {
+        super(message);
+        this.target = target;
+        this.name = "RemoteError";
+    }
+}
+function safeJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Extract the JSON envelope from a stream entry's field array (["e", "<json>"]). */
+function parseEntry(fields) {
+    const i = fields.indexOf("e");
+    if (i < 0 || i + 1 >= fields.length)
+        return undefined;
+    return safeJson(fields[i + 1]);
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * One bus client per participant. Every agent, the orchestrator, and each UI
+ * session constructs one of these. The transport (Redis) is fully hidden behind
+ * publishEvent / subscribeEvents / request / onRequest / control / presence.
+ */
+export class Bus {
+    clientId;
+    url;
+    redis; // command connection (non-blocking)
+    auxConns = new Set(); // blocking reads + pub/sub
+    running = true;
+    heartbeat;
+    registration;
+    redisOpts;
+    constructor(opts) {
+        this.clientId = opts.clientId;
+        this.url = opts.redisUrl ?? process.env.REDIS_URL ?? "redis://localhost:6379";
+        // Phase 6: authenticate to Redis. A dev user keeps the local stack runnable;
+        // a deployment sets REDIS_USERNAME/REDIS_PASSWORD per role (and per agent, so a
+        // compromised agent's ACL can't touch another's keys/channels). Options are kept
+        // so every duplicate() (blocking reads, pub/sub) inherits the same credentials.
+        this.redisOpts = {
+            maxRetriesPerRequest: null,
+            lazyConnect: false,
+            // Our ACL intentionally withholds INFO; skip ioredis's INFO-based ready check
+            // (the connection is ready after AUTH/HELLO) so least-privilege users are quiet.
+            enableReadyCheck: false,
+            username: opts.username ?? process.env.REDIS_USERNAME ?? "dev",
+            password: opts.password ?? process.env.REDIS_PASSWORD ?? "orchestra-dev",
+        };
+        // TLS to Redis: enable via rediss:// or REDIS_TLS=1; REDIS_TLS_CA points at a
+        // CA bundle for a self-signed dev cert (else system roots / rejectUnauthorized).
+        if (this.url.startsWith("rediss://") || process.env.REDIS_TLS === "1") {
+            const ca = process.env.REDIS_TLS_CA;
+            this.redisOpts.tls = ca ? { ca: readFileSync(ca) } : {};
+        }
+        this.redis = new Redis(this.url, this.redisOpts);
+        // WS6: ioredis auto-reconnects the socket and the blocking loops resume from
+        // their last id; on every (re)connect re-assert our presence so a Redis restart
+        // (which drops the TTL'd key) or a blip doesn't make us vanish from the roster.
+        this.redis.on("ready", () => {
+            if (!this.registration)
+                return;
+            void this.writePresence().catch(() => { });
+            void this.announce({ event: "register", registration: this.registration }).catch(() => { });
+        });
+    }
+    aux() {
+        const c = this.redis.duplicate();
+        this.auxConns.add(c);
+        return c;
+    }
+    // ---- observability ------------------------------------------------------
+    /** Append an event to a session's replayable stream. */
+    async publishEvent(sessionId, event, opts = {}) {
+        const env = makeEnvelope({
+            type: "event",
+            source: this.clientId,
+            sessionId,
+            causationId: opts.causationId,
+            payload: event,
+        });
+        await this.redis.xadd(channels.observability(sessionId), "MAXLEN", "~", String(OBS_MAXLEN), "*", "e", JSON.stringify(env));
+    }
+    /**
+     * Tail a session's event stream. `from`: "now" (default, only new), "start"
+     * (replay full history then tail), or a specific stream id to resume from.
+     */
+    subscribeEvents(sessionId, handler, opts = {}) {
+        const conn = this.aux();
+        let lastId = opts.from === "start" ? "0" : opts.from && opts.from !== "now" ? opts.from : "$";
+        let active = true;
+        void (async () => {
+            while (active && this.running) {
+                try {
+                    const res = (await conn.xread("BLOCK", 0, "COUNT", 100, "STREAMS", channels.observability(sessionId), lastId));
+                    if (!res)
+                        continue;
+                    for (const [, entries] of res) {
+                        for (const [id, fields] of entries) {
+                            lastId = id;
+                            const env = parseEntry(fields);
+                            if (env)
+                                handler(env.payload, env);
+                        }
+                    }
+                }
+                catch {
+                    if (active)
+                        await sleep(200);
+                }
+            }
+        })();
+        return () => {
+            active = false;
+            this.dropAux(conn);
+        };
+    }
+    /**
+     * One-shot read of a session's full event history (XRANGE - +). Used by
+     * persisters to archive the trace and by the orchestrator to serve a durable
+     * transcript when the S3 archive isn't there yet. Returns full envelopes so
+     * callers keep messageId / ts / source.
+     */
+    async readEvents(sessionId) {
+        const entries = (await this.redis.xrange(channels.observability(sessionId), "-", "+"));
+        const out = [];
+        for (const [, fields] of entries) {
+            const env = parseEntry(fields);
+            if (env)
+                out.push(env);
+        }
+        return out;
+    }
+    // ---- idempotency & introspection ---------------------------------------
+    /**
+     * Claim a message id exactly once (Phase 6, WS3). Returns true the first time a
+     * key is seen, false on every repeat within the TTL window — so a redelivered
+     * request/control message executes at most once. Namespaced per client.
+     */
+    async dedupe(key, ttlMs = DEDUPE_TTL_MS) {
+        const res = await this.redis.set(channels.dedupe(this.clientId, key), "1", "PX", ttlMs, "NX");
+        return res === "OK";
+    }
+    /**
+     * Snapshot a task's working memory (e.g. an agent's per-task conversation) so the
+     * task survives idle-eviction and process restarts. Keyed per client + task and
+     * TTL'd. `messages` is opaque JSON to the bus (the agent owns its shape).
+     */
+    async saveTaskContext(taskId, messages) {
+        await this.redis.set(channels.taskContext(this.clientId, taskId), JSON.stringify(messages), "PX", TASK_CONTEXT_TTL_MS);
+    }
+    /** Load a previously snapshotted task working memory, or undefined if none. */
+    async loadTaskContext(taskId) {
+        const raw = await this.redis.get(channels.taskContext(this.clientId, taskId));
+        if (!raw)
+            return undefined;
+        return safeJson(raw);
+    }
+    /** Liveness check for the Redis connection (Phase 6, WS8 /readyz). */
+    async ping() {
+        try {
+            return (await this.redis.ping()) === "PONG";
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Length of a stream (e.g. a DLQ depth), 0 if it doesn't exist. */
+    async streamLen(key) {
+        return (await this.redis.xlen(key).catch(() => 0));
+    }
+    /** Count of pending (delivered, un-acked) requests for an agent's worker group. */
+    async pendingCount(agentId, group = "workers") {
+        try {
+            const summary = (await this.redis.xpending(channels.request(agentId), group));
+            return Array.isArray(summary) ? Number(summary[0] ?? 0) : 0;
+        }
+        catch {
+            return 0; // no group yet
+        }
+    }
+    // ---- sessions -----------------------------------------------------------
+    /** Announce a newly allocated session so recorders can persist + tail it. */
+    async announceSession(ev) {
+        await this.redis.publish(channels.sessionEvents, JSON.stringify(ev));
+    }
+    /** React to sessions being opened in real time (mirrors watchPresence). */
+    watchSessions(handler) {
+        const conn = this.aux();
+        void conn.subscribe(channels.sessionEvents);
+        conn.on("message", (_ch, raw) => {
+            const e = safeJson(raw);
+            if (e)
+                handler(e);
+        });
+        return () => this.dropAux(conn);
+    }
+    // ---- request / reply ----------------------------------------------------
+    /** Send a directed request to an agent and await its correlated reply. */
+    async request(target, payload, opts = {}) {
+        const correlationId = uuidv7();
+        const replyTo = channels.reply(this.clientId, correlationId);
+        const env = makeEnvelope({
+            type: "request",
+            source: this.clientId,
+            target,
+            correlationId,
+            replyTo,
+            sessionId: opts.sessionId,
+            causationId: opts.causationId,
+            payload,
+        });
+        await this.redis.xadd(channels.request(target), "*", "e", JSON.stringify(env));
+        const conn = this.aux();
+        try {
+            // Read from "0": if the reply already landed we get it immediately,
+            // otherwise BLOCK waits for the first entry on this unique stream.
+            const res = (await conn.xread("BLOCK", opts.timeoutMs ?? DEFAULT_TIMEOUT_MS, "COUNT", 1, "STREAMS", replyTo, "0"));
+            if (!res)
+                throw new RequestTimeoutError(target, correlationId);
+            const env2 = parseEntry(res[0][1][0][1]);
+            if (!env2)
+                throw new RemoteError(target, "malformed reply");
+            if (!env2.payload.ok)
+                throw new RemoteError(target, env2.payload.error);
+            return env2.payload.result;
+        }
+        finally {
+            this.dropAux(conn);
+            await this.redis.del(replyTo).catch(() => { });
+        }
+    }
+    /**
+     * Register a handler for inbound requests addressed to this client. Uses a
+     * consumer group so multiple instances of the same agent load-balance work.
+     * NOTE: delivery is at-least-once — make handlers idempotent or dedupe on
+     * meta.messageId.
+     */
+    onRequest(handler, opts = {}) {
+        const stream = channels.request(this.clientId);
+        const group = opts.group ?? "workers";
+        const consumer = opts.consumer ?? `${this.clientId}#${process.pid}`;
+        const conn = this.aux();
+        let active = true;
+        void (async () => {
+            try {
+                await conn.xgroup("CREATE", stream, group, "$", "MKSTREAM");
+            }
+            catch {
+                /* BUSYGROUP: group already exists */
+            }
+            while (active && this.running) {
+                try {
+                    const res = (await conn.xreadgroup("GROUP", group, consumer, "BLOCK", 5000, "COUNT", 10, "STREAMS", stream, ">"));
+                    if (!res)
+                        continue;
+                    for (const [, entries] of res) {
+                        for (const [id, fields] of entries) {
+                            await this.handleRequest(stream, group, id, fields, handler);
+                        }
+                    }
+                }
+                catch {
+                    if (active)
+                        await sleep(200);
+                }
+            }
+        })();
+        // WS4: sweep for requests a dead worker left pending — reclaim them to this
+        // consumer (re-process; the dedupe guard prevents a double run), or after too
+        // many delivery attempts dead-letter the poison message rather than loop forever.
+        const reclaim = setInterval(() => {
+            if (active && this.running)
+                void this.reclaimStuck(stream, group, consumer, handler);
+        }, RECLAIM_EVERY_MS);
+        reclaim.unref?.(); // a background sweep must not keep the process alive on its own
+        return () => {
+            active = false;
+            clearInterval(reclaim);
+            this.dropAux(conn);
+        };
+    }
+    async reclaimStuck(stream, group, consumer, handler) {
+        try {
+            // [count, [[id, consumer, idleMs, deliveries], ...]] — pending entries idle long enough.
+            const pending = (await this.redis.xpending(stream, group, "IDLE", RECLAIM_IDLE_MS, "-", "+", 50));
+            if (!Array.isArray(pending))
+                return;
+            for (const [id, , , deliveries] of pending) {
+                const claimed = (await this.redis.xclaim(stream, group, consumer, RECLAIM_IDLE_MS, id));
+                if (!claimed?.length)
+                    continue; // someone else got it, or it was acked
+                const [, fields] = claimed[0];
+                if (Number(deliveries) > MAX_DELIVERIES) {
+                    await this.redis.xadd(channels.requestDlq(this.clientId), "*", ...fields);
+                    await this.redis.xack(stream, group, id).catch(() => { });
+                    console.warn(`[bus] dead-lettered ${id} after ${deliveries} attempts → ${channels.requestDlq(this.clientId)}`);
+                }
+                else {
+                    await this.handleRequest(stream, group, id, fields, handler);
+                }
+            }
+        }
+        catch {
+            /* transient; the next sweep retries */
+        }
+    }
+    async handleRequest(stream, group, id, fields, handler) {
+        const env = parseEntry(fields);
+        if (!env || !env.correlationId) {
+            await this.redis.xack(stream, group, id).catch(() => { });
+            return;
+        }
+        // WS7: reject an envelope from an incompatible schema rather than mis-parsing —
+        // reply with a clear error so the caller isn't left hanging, then ack.
+        if (!isSchemaCompatible(env)) {
+            const error = `unsupported schemaVersion ${env.schemaVersion} (expected ${SCHEMA_VERSION})`;
+            if (env.replyTo)
+                await this.sendReply(env, { ok: false, error });
+            await this.redis.xack(stream, group, id).catch(() => { });
+            return;
+        }
+        // WS3: claim this messageId once. A redelivery (e.g. after a worker died before
+        // acking) is skipped here so an expensive handler never runs twice.
+        if (!(await this.dedupe(`req:${env.messageId}`))) {
+            await this.redis.xack(stream, group, id).catch(() => { });
+            return;
+        }
+        let body;
+        try {
+            const result = await handler(env.payload, {
+                messageId: env.messageId,
+                source: env.source,
+                correlationId: env.correlationId,
+                sessionId: env.sessionId,
+                causationId: env.causationId,
+            });
+            body = { ok: true, result };
+        }
+        catch (err) {
+            body = { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+        if (env.replyTo)
+            await this.sendReply(env, body);
+        await this.redis.xack(stream, group, id);
+    }
+    /** Write a correlated reply onto the request's replyTo stream. */
+    async sendReply(env, body) {
+        if (!env.replyTo)
+            return;
+        const reply = makeEnvelope({
+            type: "response",
+            source: this.clientId,
+            target: env.source,
+            correlationId: env.correlationId,
+            causationId: env.messageId,
+            sessionId: env.sessionId,
+            payload: body,
+        });
+        await this.redis.xadd(env.replyTo, "*", "e", JSON.stringify(reply));
+        await this.redis.expire(env.replyTo, REPLY_TTL_S);
+    }
+    // ---- control ------------------------------------------------------------
+    /**
+     * Fire a control signal at an agent's current run (chat / steer / cancel / …).
+     * `opts.sessionId` rides on the envelope so the agent knows which conversation
+     * the message belongs to. WS5: this goes to a **durable, replayable stream**, not
+     * fire-and-forget pub/sub — so a message sent while the agent is briefly offline
+     * is delivered when it reconnects (a blocking XREAD is still instant when live).
+     */
+    async publishControl(agentId, msg, opts = {}) {
+        const env = makeEnvelope({
+            type: "control",
+            source: this.clientId,
+            target: agentId,
+            sessionId: opts.sessionId,
+            payload: msg,
+        });
+        await this.redis.xadd(channels.controlStream(agentId), "MAXLEN", "~", String(CONTROL_MAXLEN), "*", "e", JSON.stringify(env));
+    }
+    /**
+     * Listen for control signals addressed to this client (WS5). Tails the durable
+     * control stream with a blocking XREAD, resuming from the last id this client
+     * processed (persisted in Redis), so a process that was briefly down catches up on
+     * messages it missed. Incompatible-schema envelopes are dropped with a warning.
+     */
+    subscribeControl(handler) {
+        const conn = this.aux();
+        const stream = channels.controlStream(this.clientId);
+        const posKey = channels.controlPos(this.clientId);
+        let active = true;
+        void (async () => {
+            // Resume from the persisted position; first-ever start tails only new ("$").
+            let lastId = (await this.redis.get(posKey).catch(() => null)) ?? "$";
+            while (active && this.running) {
+                try {
+                    const res = (await conn.xread("BLOCK", 0, "COUNT", 50, "STREAMS", stream, lastId));
+                    if (!res)
+                        continue;
+                    for (const [, entries] of res) {
+                        for (const [id, fields] of entries) {
+                            lastId = id;
+                            const env = parseEntry(fields);
+                            if (env && !isSchemaCompatible(env)) {
+                                console.warn(`[bus] dropped control with schemaVersion ${env.schemaVersion}`);
+                            }
+                            else if (env) {
+                                handler(env.payload, env);
+                            }
+                            await this.redis.set(posKey, id).catch(() => { });
+                        }
+                    }
+                }
+                catch {
+                    if (active)
+                        await sleep(200);
+                }
+            }
+        })();
+        return () => {
+            active = false;
+            this.dropAux(conn);
+        };
+    }
+    // ---- presence -----------------------------------------------------------
+    /** Announce this agent and start the heartbeat that keeps it "online". */
+    async register(reg) {
+        this.registration = { startedAt: Date.now(), ...reg };
+        await this.writePresence();
+        this.heartbeat = setInterval(() => void this.writePresence().catch(() => { }), HEARTBEAT_MS);
+        await this.announce({ event: "register", registration: this.registration });
+    }
+    async updateStatus(status) {
+        if (!this.registration)
+            return;
+        this.registration.status = status;
+        await this.writePresence();
+        await this.announce({ event: "update", registration: this.registration });
+    }
+    async deregister() {
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        if (!this.registration)
+            return;
+        const id = this.registration.id;
+        await this.redis.del(channels.presenceKey(id)).catch(() => { });
+        await this.announce({ event: "deregister", id });
+        this.registration = undefined;
+    }
+    /** Snapshot of all agents currently online. */
+    async listAgents() {
+        const keys = [];
+        let cursor = "0";
+        do {
+            const [next, batch] = await this.redis.scan(cursor, "MATCH", channels.presenceScan, "COUNT", 100);
+            cursor = next;
+            keys.push(...batch);
+        } while (cursor !== "0");
+        if (keys.length === 0)
+            return [];
+        const vals = (await this.redis.mget(keys));
+        return vals
+            .filter((v) => Boolean(v))
+            .map((v) => safeJson(v))
+            .filter((r) => Boolean(r));
+    }
+    /** Agents currently online that advertise a given capability. */
+    async findAgents(capability) {
+        const all = await this.listAgents();
+        return all.filter((a) => a.capabilities.includes(capability));
+    }
+    /** React to agents coming and going in real time. */
+    watchPresence(handler) {
+        const conn = this.aux();
+        void conn.subscribe(channels.presenceEvents);
+        conn.on("message", (_ch, raw) => {
+            const e = safeJson(raw);
+            if (e)
+                handler(e);
+        });
+        return () => this.dropAux(conn);
+    }
+    async writePresence() {
+        if (!this.registration)
+            return;
+        await this.redis.set(channels.presenceKey(this.registration.id), JSON.stringify(this.registration), "EX", PRESENCE_TTL_S);
+    }
+    async announce(event) {
+        await this.redis.publish(channels.presenceEvents, JSON.stringify(event));
+    }
+    // ---- lifecycle ----------------------------------------------------------
+    dropAux(conn) {
+        this.auxConns.delete(conn);
+        conn.disconnect();
+    }
+    async close() {
+        this.running = false;
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        for (const c of this.auxConns)
+            c.disconnect();
+        this.auxConns.clear();
+        this.redis.disconnect();
+    }
+}
+//# sourceMappingURL=bus.js.map

package/dist/bus.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./bus.js";
+export * from "./types.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,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./bus.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+import type { Envelope } from "@paintenzero/orchestra-protocol";
+export interface BusOptions {
+    /** This participant's stable id (agent id, "orchestrator", "ui:<session>"). */
+    clientId: string;
+    /** Defaults to env REDIS_URL or redis://localhost:6379. */
+    redisUrl?: string;
+    /** Redis ACL user (Phase 6). Defaults to env REDIS_USERNAME, else the dev user. */
+    username?: string;
+    /** Redis ACL password (Phase 6). Defaults to env REDIS_PASSWORD, else the dev password. */
+    password?: string;
+}
+export interface RequestOptions {
+    timeoutMs?: number;
+    sessionId?: string;
+    causationId?: string;
+}
+export interface RequestMeta {
+    messageId: string;
+    source: string;
+    correlationId: string;
+    sessionId?: string;
+    causationId?: string;
+}
+export type RequestHandler = (payload: unknown, meta: RequestMeta) => Promise<unknown> | unknown;
+export type Unsubscribe = () => void;
+export type EnvelopeOf<P> = Envelope<P>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEjG,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@paintenzero/orchestra-bus",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@paintenzero/orchestra-protocol": "workspace:^",
+    "ioredis": "^5.4.0"
+  }
+}