aibroker 0.5.1 → 0.6.2

package/dist/aibp/envelope.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AIBP envelope utilities — create, parse, and validate AIBP messages.
+ */
+import type { AibpMessage, CommandPayload, ImagePayload, StatusPayload, SystemEvent, SystemPayload, TextPayload, TypingPayload, VoicePayload } from "./types.js";
+export declare function text(src: string, dst: string, content: string): AibpMessage<TextPayload>;
+export declare function voice(src: string, dst: string, audioBase64: string, transcript: string, durationMs?: number): AibpMessage<VoicePayload>;
+export declare function image(src: string, dst: string, imageBase64: string, mimeType: string, caption?: string): AibpMessage<ImagePayload>;
+export declare function typing(src: string, dst: string, active: boolean): AibpMessage<TypingPayload>;
+export declare function status(src: string, dst: string, subject: string, state: StatusPayload["state"], summary?: string): AibpMessage<StatusPayload>;
+export declare function command(src: string, dst: string, cmd: string, args?: Record<string, unknown>): AibpMessage<CommandPayload>;
+export declare function system(src: string, dst: string, event: SystemEvent, data?: Record<string, unknown>): AibpMessage<SystemPayload>;
+export declare function parse(raw: string): AibpMessage | null;
+export declare function isAibpMessage(obj: unknown): obj is AibpMessage;
+export declare function serialize(msg: AibpMessage): string;
+/** Extract the address type prefix (e.g., "session" from "session:ABC123") */
+export declare function addressType(address: string): string;
+/** Extract the address value (e.g., "ABC123" from "session:ABC123") */
+export declare function addressValue(address: string): string;
+/** Check if an address is a hub-local address (not a remote hub reference) */
+export declare function isLocal(address: string): boolean;
+/** For mesh addresses like "hub:mac-mini/session:DEF456", extract the hub and local parts */
+export declare function parseMeshAddress(address: string): {
+    hub: string;
+    local: string;
+} | null;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/aibp/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/aibp/envelope.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,WAAW,EAEX,cAAc,EACd,YAAY,EAEZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAyBpB,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,CAExF;AAED,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,CAAC,YAAY,CAAC,CAE3B;AAED,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,YAAY,CAAC,CAE3B;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAE5F;AAED,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,aAAa,CAAC,CAE5B;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,WAAW,CAAC,cAAc,CAAC,CAE7B;AAED,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,WAAW,CAAC,aAAa,CAAC,CAE5B;AAMD,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAQrD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAa9D;AAMD,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAElD;AAMD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOvF"}

package/dist/aibp/envelope.js

@@ -0,0 +1,101 @@
+/**
+ * AIBP envelope utilities — create, parse, and validate AIBP messages.
+ */
+import { randomUUID } from "node:crypto";
+const AIBP_VERSION = "0.1";
+// ---------------------------------------------------------------------------
+// Factory — create typed messages with automatic envelope fields
+// ---------------------------------------------------------------------------
+function envelope(src, dst, type, payload) {
+    return {
+        aibp: AIBP_VERSION,
+        id: randomUUID(),
+        ts: Date.now(),
+        src,
+        dst,
+        type,
+        payload,
+    };
+}
+export function text(src, dst, content) {
+    return envelope(src, dst, "TEXT", { content });
+}
+export function voice(src, dst, audioBase64, transcript, durationMs) {
+    return envelope(src, dst, "VOICE", { audioBase64, transcript, durationMs });
+}
+export function image(src, dst, imageBase64, mimeType, caption) {
+    return envelope(src, dst, "IMAGE", { imageBase64, mimeType, caption });
+}
+export function typing(src, dst, active) {
+    return envelope(src, dst, "TYPING", { active });
+}
+export function status(src, dst, subject, state, summary) {
+    return envelope(src, dst, "STATUS", { subject, state, summary });
+}
+export function command(src, dst, cmd, args = {}) {
+    return envelope(src, dst, "COMMAND", { command: cmd, args });
+}
+export function system(src, dst, event, data = {}) {
+    return envelope(src, dst, "SYSTEM", { event, ...data });
+}
+// ---------------------------------------------------------------------------
+// Parsing — validate incoming JSON
+// ---------------------------------------------------------------------------
+export function parse(raw) {
+    try {
+        const obj = JSON.parse(raw);
+        if (!isAibpMessage(obj))
+            return null;
+        return obj;
+    }
+    catch {
+        return null;
+    }
+}
+export function isAibpMessage(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return false;
+    const m = obj;
+    return (typeof m.aibp === "string" &&
+        typeof m.id === "string" &&
+        typeof m.ts === "number" &&
+        typeof m.src === "string" &&
+        typeof m.dst === "string" &&
+        typeof m.type === "string" &&
+        typeof m.payload === "object" &&
+        m.payload !== null);
+}
+// ---------------------------------------------------------------------------
+// Serialize — NDJSON line
+// ---------------------------------------------------------------------------
+export function serialize(msg) {
+    return JSON.stringify(msg) + "\n";
+}
+// ---------------------------------------------------------------------------
+// Address helpers
+// ---------------------------------------------------------------------------
+/** Extract the address type prefix (e.g., "session" from "session:ABC123") */
+export function addressType(address) {
+    const colon = address.indexOf(":");
+    return colon > 0 ? address.slice(0, colon) : address;
+}
+/** Extract the address value (e.g., "ABC123" from "session:ABC123") */
+export function addressValue(address) {
+    const colon = address.indexOf(":");
+    return colon > 0 ? address.slice(colon + 1) : address;
+}
+/** Check if an address is a hub-local address (not a remote hub reference) */
+export function isLocal(address) {
+    return !address.includes("/");
+}
+/** For mesh addresses like "hub:mac-mini/session:DEF456", extract the hub and local parts */
+export function parseMeshAddress(address) {
+    const slash = address.indexOf("/");
+    if (slash < 0)
+        return null;
+    return {
+        hub: address.slice(0, slash),
+        local: address.slice(slash + 1),
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/aibp/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/aibp/envelope.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAezC,MAAM,YAAY,GAAG,KAAc,CAAC;AAEpC,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,SAAS,QAAQ,CACf,GAAW,EACX,GAAW,EACX,IAAiB,EACjB,OAAU;IAEV,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,UAAU,EAAE;QAChB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,GAAG;QACH,GAAG;QACH,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,GAAW,EAAE,OAAe;IAC5D,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,GAAW,EACX,GAAW,EACX,WAAmB,EACnB,UAAkB,EAClB,UAAmB;IAEnB,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,GAAW,EACX,GAAW,EACX,WAAmB,EACnB,QAAgB,EAChB,OAAgB;IAEhB,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,GAAW,EAAE,MAAe;IAC9D,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,GAAW,EACX,GAAW,EACX,OAAe,EACf,KAA6B,EAC7B,OAAgB;IAEhB,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,GAAW,EACX,GAAW,EACX,GAAW,EACX,OAAgC,EAAE;IAElC,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,GAAW,EACX,GAAW,EACX,KAAkB,EAClB,OAAgC,EAAE;IAElC,OAAO,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;QACzB,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;QACzB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,CAAC,CAAC,OAAO,KAAK,IAAI,CACnB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/aibp/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AIBP — AIBroker Interchange Protocol
+ *
+ * Public API for the protocol layer.
+ */
+export * from "./types.js";
+export * as msg from "./envelope.js";
+export { PluginRegistry } from "./registry.js";
+export type { SendFn } from "./registry.js";
+export { AibpBridge } from "./bridge.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aibp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/aibp/index.js

@@ -0,0 +1,10 @@
+/**
+ * AIBP — AIBroker Interchange Protocol
+ *
+ * Public API for the protocol layer.
+ */
+export * from "./types.js";
+export * as msg from "./envelope.js";
+export { PluginRegistry } from "./registry.js";
+export { AibpBridge } from "./bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/aibp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aibp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/aibp/registry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * AIBP Plugin Registry — manages plugin connections, channels, and routing.
+ *
+ * This is the hub's brain. It knows:
+ * - Which plugins are registered and their capabilities
+ * - Which channels exist and who has joined them
+ * - Where to route each message based on dst address
+ * - What to buffer when a recipient is offline
+ */
+import type { AibpMessage, ChannelMembership, CommandSpec, PluginSpec, RegisteredPlugin } from "./types.js";
+export type SendFn = (msg: AibpMessage) => void;
+export declare class PluginRegistry {
+    /** address → connection */
+    private plugins;
+    /** channel name → membership */
+    private channels;
+    /** command name → plugin address */
+    private commands;
+    /**
+     * Register a plugin. Returns the REGISTER_ACK message to send back,
+     * or an ERROR message if registration fails.
+     */
+    register(spec: PluginSpec, send: SendFn): AibpMessage;
+    /**
+     * Unregister a plugin (graceful disconnect or crash cleanup).
+     */
+    unregister(address: string, reason?: string): void;
+    /**
+     * Join a channel. Creates the channel if it doesn't exist.
+     */
+    join(address: string, channel: string): AibpMessage;
+    /**
+     * Part a channel.
+     */
+    part(address: string, channel: string, reason?: string): AibpMessage;
+    /**
+     * Route a message to its destination.
+     *
+     * Routing rules:
+     * 1. If dst is a direct address (plugin/session/mobile), deliver to that plugin
+     * 2. If dst is a channel, fan out to all members
+     * 3. If dst is "hub:local", handle as a hub command
+     * 4. If dst contains "/" (mesh), forward to bridge plugin
+     * 5. If recipient is offline, buffer in outbox
+     */
+    route(msg: AibpMessage): void;
+    private fanOut;
+    private routeToMesh;
+    private handleHubMessage;
+    private handleBuiltinCommand;
+    private bufferMessage;
+    private drainOutbox;
+    /**
+     * Call periodically (e.g., every 30s) to check plugin health.
+     */
+    heartbeatCheck(): void;
+    getPlugin(address: string): RegisteredPlugin | undefined;
+    getChannel(channel: string): ChannelMembership | undefined;
+    getPluginByType(type: string): RegisteredPlugin[];
+    getCommandOwner(command: string): string | undefined;
+    listPlugins(): RegisteredPlugin[];
+    listChannels(): ChannelMembership[];
+    listCommands(): Array<{
+        name: string;
+        owner: string;
+        spec?: CommandSpec;
+    }>;
+    private sendTo;
+    private resolveAddress;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/aibp/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/aibp/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAOpB,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;AAOhD,qBAAa,cAAc;IACzB,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAuC;IACtD,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAwC;IACxD,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAA6B;IAM7C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IA6CrD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,IAAI;IAoC1D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW;IA6BnD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,WAAW;IA2BpE;;;;;;;;;OASG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IA8C7B,OAAO,CAAC,MAAM;IAsBd,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,oBAAoB;IAiD5B,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;IA+BnB;;OAEG;IACH,cAAc,IAAI,IAAI;IAkBtB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIxD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI1D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMjD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD,WAAW,IAAI,gBAAgB,EAAE;IAIjC,YAAY,IAAI,iBAAiB,EAAE;IAInC,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC;IAY1E,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,cAAc;CAkBvB"}

package/dist/aibp/registry.js

@@ -0,0 +1,408 @@
+/**
+ * AIBP Plugin Registry — manages plugin connections, channels, and routing.
+ *
+ * This is the hub's brain. It knows:
+ * - Which plugins are registered and their capabilities
+ * - Which channels exist and who has joined them
+ * - Where to route each message based on dst address
+ * - What to buffer when a recipient is offline
+ */
+import { log } from "../core/log.js";
+import * as envelope from "./envelope.js";
+const MAX_OUTBOX = 50;
+const HEARTBEAT_INTERVAL_MS = 30_000;
+const HEARTBEAT_MISS_DEGRADED = 3;
+const HEARTBEAT_MISS_DEAD = 5;
+export class PluginRegistry {
+    /** address → connection */
+    plugins = new Map();
+    /** channel name → membership */
+    channels = new Map();
+    /** command name → plugin address */
+    commands = new Map();
+    // -------------------------------------------------------------------------
+    // Plugin lifecycle
+    // -------------------------------------------------------------------------
+    /**
+     * Register a plugin. Returns the REGISTER_ACK message to send back,
+     * or an ERROR message if registration fails.
+     */
+    register(spec, send) {
+        const address = this.resolveAddress(spec);
+        // Reject duplicate
+        if (this.plugins.has(address)) {
+            log(`[AIBP] REGISTER rejected: ${address} already registered`);
+            return envelope.system("hub:local", address, "ERROR", {
+                code: "REGISTER_REJECTED",
+                reason: `Plugin address ${address} already registered`,
+            });
+        }
+        const plugin = {
+            spec,
+            address,
+            connectedAt: Date.now(),
+            missedPings: 0,
+            status: "active",
+            joinedChannels: new Set(),
+        };
+        this.plugins.set(address, { plugin, send });
+        // Register commands
+        if (spec.commands) {
+            for (const cmd of spec.commands) {
+                this.commands.set(cmd.name, address);
+            }
+        }
+        // Auto-join declared channels
+        for (const ch of spec.channels) {
+            this.join(address, ch);
+        }
+        log(`[AIBP] REGISTER ${spec.type}:${spec.id} → ${address}`);
+        const peers = Array.from(this.plugins.keys()).filter((a) => a !== address);
+        return envelope.system("hub:local", address, "REGISTER_ACK", {
+            assignedAddress: address,
+            hubVersion: "0.1",
+            peers,
+        });
+    }
+    /**
+     * Unregister a plugin (graceful disconnect or crash cleanup).
+     */
+    unregister(address, reason = "disconnected") {
+        const conn = this.plugins.get(address);
+        if (!conn)
+            return;
+        // Part all joined channels
+        for (const ch of conn.plugin.joinedChannels) {
+            this.part(address, ch, reason);
+        }
+        // Remove commands
+        if (conn.plugin.spec.commands) {
+            for (const cmd of conn.plugin.spec.commands) {
+                if (this.commands.get(cmd.name) === address) {
+                    this.commands.delete(cmd.name);
+                }
+            }
+        }
+        this.plugins.delete(address);
+        log(`[AIBP] UNREGISTER ${address} (${reason})`);
+        // Notify all remaining plugins
+        for (const [, other] of this.plugins) {
+            other.send(envelope.system("hub:local", other.plugin.address, "PLUGIN_OFFLINE", {
+                plugin: address,
+                reason,
+            }));
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Channel management
+    // -------------------------------------------------------------------------
+    /**
+     * Join a channel. Creates the channel if it doesn't exist.
+     */
+    join(address, channel) {
+        let membership = this.channels.get(channel);
+        if (!membership) {
+            membership = { channel, members: new Set(), outbox: [] };
+            this.channels.set(channel, membership);
+        }
+        membership.members.add(address);
+        const conn = this.plugins.get(address);
+        if (conn) {
+            conn.plugin.joinedChannels.add(channel);
+        }
+        log(`[AIBP] JOIN ${address} → ${channel} (${membership.members.size} members)`);
+        // Drain outbox for this member
+        const buffered = membership.outbox.length;
+        if (buffered > 0) {
+            this.drainOutbox(address, channel);
+        }
+        return envelope.system("hub:local", address, "JOIN_ACK", {
+            channel,
+            members: Array.from(membership.members),
+            unreadCount: buffered,
+        });
+    }
+    /**
+     * Part a channel.
+     */
+    part(address, channel, reason = "left") {
+        const membership = this.channels.get(channel);
+        if (membership) {
+            membership.members.delete(address);
+            // Clean up empty channels (except persistent session channels)
+            if (membership.members.size === 0 && !channel.startsWith("session:")) {
+                this.channels.delete(channel);
+            }
+        }
+        const conn = this.plugins.get(address);
+        if (conn) {
+            conn.plugin.joinedChannels.delete(channel);
+        }
+        log(`[AIBP] PART ${address} ← ${channel} (${reason})`);
+        return envelope.system("hub:local", address, "PART_ACK", {
+            channel,
+            reason,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Message routing — the core of AIBP
+    // -------------------------------------------------------------------------
+    /**
+     * Route a message to its destination.
+     *
+     * Routing rules:
+     * 1. If dst is a direct address (plugin/session/mobile), deliver to that plugin
+     * 2. If dst is a channel, fan out to all members
+     * 3. If dst is "hub:local", handle as a hub command
+     * 4. If dst contains "/" (mesh), forward to bridge plugin
+     * 5. If recipient is offline, buffer in outbox
+     */
+    route(msg) {
+        const { dst } = msg;
+        // Mesh routing — forward to the appropriate bridge
+        const mesh = envelope.parseMeshAddress(dst);
+        if (mesh) {
+            this.routeToMesh(msg, mesh.hub, mesh.local);
+            return;
+        }
+        // Hub command
+        if (dst === "hub:local") {
+            this.handleHubMessage(msg);
+            return;
+        }
+        // Direct plugin address
+        const directConn = this.plugins.get(dst);
+        if (directConn) {
+            directConn.send(msg);
+            return;
+        }
+        // Channel fan-out
+        const membership = this.channels.get(dst);
+        if (membership) {
+            this.fanOut(msg, membership);
+            return;
+        }
+        // Try to match as a session channel
+        if (dst.startsWith("session:")) {
+            // Auto-create the channel and buffer
+            const newMembership = {
+                channel: dst,
+                members: new Set(),
+                outbox: [],
+            };
+            this.channels.set(dst, newMembership);
+            this.bufferMessage(newMembership, msg);
+            return;
+        }
+        log(`[AIBP] ROUTE FAIL: no destination for ${dst} (from ${msg.src})`);
+    }
+    fanOut(msg, membership) {
+        membership.lastMessageId = msg.id;
+        membership.lastMessageTs = msg.ts;
+        let delivered = 0;
+        for (const member of membership.members) {
+            // Don't echo back to sender
+            if (member === msg.src)
+                continue;
+            const conn = this.plugins.get(member);
+            if (conn) {
+                conn.send(msg);
+                delivered++;
+            }
+        }
+        // Buffer for offline members who have joined this channel before
+        if (delivered === 0 && membership.members.size === 0) {
+            this.bufferMessage(membership, msg);
+        }
+    }
+    routeToMesh(msg, hubAddress, localDst) {
+        // Extract the hub ID from hub address (e.g., "hub:mac-mini" → "mac-mini")
+        const hubId = hubAddress.startsWith("hub:") ? hubAddress.slice(4) : hubAddress;
+        // Try to find the specific bridge for this hub first
+        const specificBridge = this.plugins.get(`bridge:${hubId}`);
+        if (specificBridge) {
+            specificBridge.send(msg);
+            return;
+        }
+        // Fallback: find any bridge plugin
+        for (const [, conn] of this.plugins) {
+            if (conn.plugin.spec.type === "bridge") {
+                conn.send(msg);
+                return;
+            }
+        }
+        log(`[AIBP] MESH FAIL: no bridge plugin for ${hubAddress}`);
+    }
+    handleHubMessage(msg) {
+        if (msg.type === "COMMAND") {
+            const payload = msg.payload;
+            const cmdOwner = this.commands.get(payload.command);
+            if (cmdOwner) {
+                const conn = this.plugins.get(cmdOwner);
+                if (conn) {
+                    conn.send(msg);
+                    return;
+                }
+            }
+            // Built-in hub commands
+            this.handleBuiltinCommand(msg, payload.command, payload.args);
+            return;
+        }
+        if (msg.type === "SYSTEM") {
+            const payload = msg.payload;
+            if (payload.event === "PING") {
+                const conn = this.plugins.get(msg.src);
+                if (conn) {
+                    conn.plugin.lastPing = Date.now();
+                    conn.plugin.missedPings = 0;
+                    conn.plugin.status = "active";
+                    conn.send(envelope.system("hub:local", msg.src, "PONG"));
+                }
+            }
+        }
+    }
+    handleBuiltinCommand(msg, cmd, args) {
+        const src = msg.src;
+        switch (cmd) {
+            case "list_channels": {
+                const channels = Array.from(this.channels.entries()).map(([name, m]) => ({
+                    name,
+                    members: m.members.size,
+                    lastActivity: m.lastMessageTs,
+                    outboxSize: m.outbox.length,
+                }));
+                const reply = envelope.system("hub:local", src, "REGISTER_ACK", { channels });
+                this.sendTo(src, reply);
+                break;
+            }
+            case "list_plugins": {
+                const plugins = Array.from(this.plugins.entries()).map(([addr, c]) => ({
+                    address: addr,
+                    type: c.plugin.spec.type,
+                    name: c.plugin.spec.name,
+                    status: c.plugin.status,
+                    channels: Array.from(c.plugin.joinedChannels),
+                }));
+                const reply = envelope.system("hub:local", src, "REGISTER_ACK", { plugins });
+                this.sendTo(src, reply);
+                break;
+            }
+            default:
+                log(`[AIBP] Unknown hub command: ${cmd}`);
+                this.sendTo(src, envelope.system("hub:local", src, "ERROR", {
+                    code: "UNKNOWN_COMMAND",
+                    command: cmd,
+                }));
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Outbox
+    // -------------------------------------------------------------------------
+    bufferMessage(membership, msg) {
+        // Don't buffer typing indicators or pings
+        if (msg.type === "TYPING" || msg.type === "SYSTEM")
+            return;
+        if (membership.outbox.length >= MAX_OUTBOX) {
+            membership.outbox.shift(); // Drop oldest
+        }
+        membership.outbox.push(msg);
+        log(`[AIBP] OUTBOX ${msg.dst}: ${membership.outbox.length} buffered`);
+    }
+    drainOutbox(address, channel) {
+        const membership = this.channels.get(channel);
+        if (!membership || membership.outbox.length === 0)
+            return;
+        const conn = this.plugins.get(address);
+        if (!conn)
+            return;
+        const count = membership.outbox.length;
+        // Send drain header
+        conn.send(envelope.system("hub:local", address, "OUTBOX_DRAIN", {
+            channel,
+            count,
+            summary: `${count} message${count > 1 ? "s" : ""} while offline`,
+        }));
+        // Deliver buffered messages
+        for (const msg of membership.outbox) {
+            conn.send(msg);
+        }
+        membership.outbox = [];
+        log(`[AIBP] OUTBOX DRAIN ${channel} → ${address}: ${count} messages`);
+    }
+    // -------------------------------------------------------------------------
+    // Heartbeat monitoring
+    // -------------------------------------------------------------------------
+    /**
+     * Call periodically (e.g., every 30s) to check plugin health.
+     */
+    heartbeatCheck() {
+        for (const [address, conn] of this.plugins) {
+            conn.plugin.missedPings++;
+            if (conn.plugin.missedPings >= HEARTBEAT_MISS_DEAD) {
+                log(`[AIBP] Plugin dead: ${address} (${conn.plugin.missedPings} missed pings)`);
+                this.unregister(address, "heartbeat timeout");
+            }
+            else if (conn.plugin.missedPings >= HEARTBEAT_MISS_DEGRADED) {
+                conn.plugin.status = "degraded";
+                log(`[AIBP] Plugin degraded: ${address}`);
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Queries
+    // -------------------------------------------------------------------------
+    getPlugin(address) {
+        return this.plugins.get(address)?.plugin;
+    }
+    getChannel(channel) {
+        return this.channels.get(channel);
+    }
+    getPluginByType(type) {
+        return Array.from(this.plugins.values())
+            .filter((c) => c.plugin.spec.type === type)
+            .map((c) => c.plugin);
+    }
+    getCommandOwner(command) {
+        return this.commands.get(command);
+    }
+    listPlugins() {
+        return Array.from(this.plugins.values()).map((c) => c.plugin);
+    }
+    listChannels() {
+        return Array.from(this.channels.values());
+    }
+    listCommands() {
+        return Array.from(this.commands.entries()).map(([name, owner]) => {
+            const conn = this.plugins.get(owner);
+            const spec = conn?.plugin.spec.commands?.find((c) => c.name === name);
+            return { name, owner, spec };
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    sendTo(address, msg) {
+        const conn = this.plugins.get(address);
+        if (conn)
+            conn.send(msg);
+    }
+    resolveAddress(spec) {
+        switch (spec.type) {
+            case "transport":
+                return `transport:${spec.id}`;
+            case "terminal":
+                return `terminal:${spec.id}`;
+            case "mobile":
+                return `mobile:${spec.id}`;
+            case "bridge":
+                return `bridge:${spec.id}`;
+            case "mcp":
+                return `mcp:${spec.id}`;
+            case "hub":
+                return `hub:${spec.id}`;
+            default:
+                return `plugin:${spec.id}`;
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map