agent-comms 1.0.0 → 1.0.4

package/dist/core/tool.js

@@ -0,0 +1,210 @@
+/**
+ * Tool handler — processes BusAction objects and returns human-readable results.
+ *
+ * This is the shared logic that every bridge calls into. Bridges just:
+ *   1. Parse the LLM's tool call into a BusAction
+ *   2. Call handleAction(action)
+ *   3. Return the result string to the LLM
+ */
+import { BusError } from "./store.js";
+export class BusTool {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async handle(ctx, action) {
+        try {
+            switch (action.action) {
+                case "register":
+                    return await this.register(ctx, action);
+                case "update":
+                    return await this.update(ctx, action);
+                case "whoami":
+                    return await this.whoami(ctx);
+                case "create_room":
+                    return await this.createRoom(ctx, action);
+                case "list_rooms":
+                    return await this.listRooms(ctx);
+                case "join_room":
+                    return await this.joinRoom(ctx, action);
+                case "leave_room":
+                    return await this.leaveRoom(ctx, action);
+                case "send":
+                    return await this.send(ctx, action);
+                case "dm":
+                    return await this.dm(ctx, action);
+                case "list_agents":
+                    return await this.listAgents(ctx);
+                case "read_room":
+                    return await this.readRoom(ctx, action);
+                case "invite":
+                    return await this.invite(ctx, action);
+                case "kick":
+                    return await this.kick(ctx, action);
+                case "destroy_room":
+                    return await this.destroyRoom(ctx, action);
+                default:
+                    return {
+                        content: `Unknown action: ${JSON.stringify(action).slice(0, 100)}`,
+                        isError: true,
+                    };
+            }
+        }
+        catch (err) {
+            if (err instanceof BusError) {
+                return {
+                    content: `Error: ${err.message} (${err.code})`,
+                    isError: true,
+                };
+            }
+            return {
+                content: `Internal error: ${err instanceof Error ? err.message : String(err)}`,
+                isError: true,
+            };
+        }
+    }
+    async register(ctx, action) {
+        const agent = await this.store.registerAgent({
+            name: action.name,
+            harness: ctx.harness,
+            pid: ctx.pid,
+            visibility: action.visibility,
+            tags: action.tags,
+        });
+        return {
+            content: `Registered as ${agent.name} (${agent.id}) with visibility "${agent.visibility}".`,
+            isError: false,
+        };
+    }
+    async update(ctx, action) {
+        const patch = {};
+        if (action.visibility !== undefined)
+            patch.visibility = action.visibility;
+        if (action.status !== undefined)
+            patch.status = action.status;
+        if (action.name !== undefined)
+            patch.name = action.name;
+        if (action.tags !== undefined)
+            patch.tags = action.tags;
+        const agent = await this.store.updateAgent(ctx.agentId, patch);
+        return {
+            content: `Updated: name=${agent.name}, visibility=${agent.visibility}, status=${agent.status}`,
+            isError: false,
+        };
+    }
+    async whoami(ctx) {
+        const agent = await this.store.getAgent(ctx.agentId);
+        if (!agent)
+            return { content: "Not registered.", isError: true };
+        return {
+            content: [
+                `ID: ${agent.id}`,
+                `Name: ${agent.name}`,
+                `Harness: ${agent.harness}`,
+                `Visibility: ${agent.visibility}`,
+                `Status: ${agent.status}`,
+                `Tags: ${agent.tags.join(", ") || "(none)"}`,
+                `Rooms: ${agent.subscribedRooms.join(", ") || "(none)"}`,
+            ].join("\n"),
+            isError: false,
+        };
+    }
+    async createRoom(ctx, action) {
+        const room = await this.store.createRoom({
+            name: action.name,
+            type: action.type,
+            owner: ctx.agentId,
+            description: action.description,
+        });
+        // Auto-join the creator
+        await this.store.joinRoom(room.id, ctx.agentId);
+        return {
+            content: `Created ${room.type} room "${room.name}" (${room.id}).`,
+            isError: false,
+        };
+    }
+    async listRooms(ctx) {
+        const rooms = await this.store.listRooms(ctx.agentId);
+        if (rooms.length === 0)
+            return { content: "No rooms found.", isError: false };
+        const lines = rooms.map((r) => {
+            const memberFlag = r.members.includes(ctx.agentId) ? "✓" : " ";
+            return `[${memberFlag}] ${r.type.padEnd(7)} ${r.name} (${String(r.members.length)} members) — ${r.description}`;
+        });
+        return {
+            content: `Rooms ([✓] = joined):\n${lines.join("\n")}`,
+            isError: false,
+        };
+    }
+    async joinRoom(ctx, action) {
+        const roomId = action.room;
+        const room = await this.store.joinRoom(roomId, ctx.agentId);
+        return {
+            content: `Joined room "${room.name}" (${String(room.members.length)} members).`,
+            isError: false,
+        };
+    }
+    async leaveRoom(ctx, action) {
+        await this.store.leaveRoom(action.room, ctx.agentId);
+        return { content: `Left room "${action.room}".`, isError: false };
+    }
+    async send(ctx, action) {
+        const roomId = action.target;
+        const msg = await this.store.sendRoomMessage(roomId, ctx.agentId, action.content, action.replyTo);
+        return {
+            content: `Sent to ${action.target}: ${msg.id}`,
+            isError: false,
+        };
+    }
+    async dm(ctx, action) {
+        const targetId = action.target;
+        const msg = await this.store.sendDm(ctx.agentId, targetId, action.content);
+        return {
+            content: `DM sent to ${action.target}: ${msg.id}`,
+            isError: false,
+        };
+    }
+    async listAgents(ctx) {
+        const agents = await this.store.listAgents(ctx.agentId);
+        if (agents.length === 0)
+            return { content: "No other agents online.", isError: false };
+        const lines = agents.map((a) => {
+            const self = a.id === ctx.agentId ? " (you)" : "";
+            return `${a.id}  ${a.name.padEnd(25)} ${a.harness.padEnd(12)} ${a.status.padEnd(7)} ${a.visibility}${self}`;
+        });
+        return {
+            content: `Agents:\n  ID      Name                      Harness      Status  Visibility\n${lines.map((l) => `  ${l}`).join("\n")}`,
+            isError: false,
+        };
+    }
+    async readRoom(ctx, action) {
+        const roomId = action.room;
+        const messages = await this.store.readRoomMessages(roomId, action.since);
+        if (messages.length === 0)
+            return { content: "No messages.", isError: false };
+        const lines = messages.map((m) => {
+            const time = m.timestamp.slice(11, 19);
+            return `[${time}] ${m.from}: ${m.content}`;
+        });
+        return { content: lines.join("\n"), isError: false };
+    }
+    async invite(ctx, action) {
+        await this.store.inviteToRoom(action.room, action.agent, ctx.agentId);
+        return {
+            content: `Invited ${action.agent} to ${action.room}.`,
+            isError: false,
+        };
+    }
+    async kick(ctx, action) {
+        await this.store.kickFromRoom(action.room, action.agent, ctx.agentId);
+        return {
+            content: `Kicked ${action.agent} from ${action.room}.`,
+            isError: false,
+        };
+    }
+    async destroyRoom(ctx, action) {
+        await this.store.destroyRoom(action.room, ctx.agentId);
+        return { content: `Destroyed room "${action.room}".`, isError: false };
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/core/tool.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Agent Comms — shared protocol types and Zod schemas.
+ *
+ * Every type is derived from its Zod schema (single source of truth).
+ * Use `Schema.parse(raw)` at JSON boundaries instead of `JSON.parse(raw) as T`.
+ * Use `Schema.is(value)` for type narrowing.
+ */
+import { z } from "zod";
+export type AgentId = string;
+export type RoomId = string;
+export declare const Visibility: z.ZodUnion<readonly [z.ZodLiteral<"visible">, z.ZodLiteral<"hidden">, z.ZodLiteral<"ghost">]> & {
+    is(value: unknown): value is "visible" | "hidden" | "ghost";
+};
+export type Visibility = z.infer<typeof Visibility>;
+export declare const AgentStatus: z.ZodUnion<readonly [z.ZodLiteral<"active">, z.ZodLiteral<"idle">, z.ZodLiteral<"busy">, z.ZodLiteral<"offline">]> & {
+    is(value: unknown): value is "active" | "idle" | "busy" | "offline";
+};
+export type AgentStatus = z.infer<typeof AgentStatus>;
+export declare const RoomType: z.ZodUnion<readonly [z.ZodLiteral<"public">, z.ZodLiteral<"private">, z.ZodLiteral<"secret">]> & {
+    is(value: unknown): value is "public" | "private" | "secret";
+};
+export type RoomType = z.infer<typeof RoomType>;
+export declare const AgentIdentitySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    harness: z.ZodString;
+    pid: z.ZodNumber;
+    startedAt: z.ZodString;
+    visibility: z.ZodUnion<readonly [z.ZodLiteral<"visible">, z.ZodLiteral<"hidden">, z.ZodLiteral<"ghost">]> & {
+        is(value: unknown): value is "visible" | "hidden" | "ghost";
+    };
+    status: z.ZodUnion<readonly [z.ZodLiteral<"active">, z.ZodLiteral<"idle">, z.ZodLiteral<"busy">, z.ZodLiteral<"offline">]> & {
+        is(value: unknown): value is "active" | "idle" | "busy" | "offline";
+    };
+    tags: z.ZodArray<z.ZodString>;
+    subscribedRooms: z.ZodArray<z.ZodString>;
+}, z.core.$strip> & {
+    is(value: unknown): value is {
+        id: string;
+        name: string;
+        harness: string;
+        pid: number;
+        startedAt: string;
+        visibility: "visible" | "hidden" | "ghost";
+        status: "active" | "idle" | "busy" | "offline";
+        tags: string[];
+        subscribedRooms: string[];
+    };
+};
+export type AgentIdentity = z.infer<typeof AgentIdentitySchema>;
+export declare const RoomSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"public">, z.ZodLiteral<"private">, z.ZodLiteral<"secret">]> & {
+        is(value: unknown): value is "public" | "private" | "secret";
+    };
+    owner: z.ZodString;
+    createdAt: z.ZodString;
+    description: z.ZodString;
+    members: z.ZodArray<z.ZodString>;
+    invited: z.ZodArray<z.ZodString>;
+}, z.core.$strip> & {
+    is(value: unknown): value is {
+        id: string;
+        name: string;
+        type: "public" | "private" | "secret";
+        owner: string;
+        createdAt: string;
+        description: string;
+        members: string[];
+        invited: string[];
+    };
+};
+export type Room = z.infer<typeof RoomSchema>;
+export declare const RoomMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodString;
+    room: z.ZodString;
+    content: z.ZodString;
+    timestamp: z.ZodString;
+    replyTo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip> & {
+    is(value: unknown): value is {
+        id: string;
+        from: string;
+        room: string;
+        content: string;
+        timestamp: string;
+        replyTo?: string | undefined;
+    };
+};
+export type RoomMessage = z.infer<typeof RoomMessageSchema>;
+export declare const DmMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    content: z.ZodString;
+    timestamp: z.ZodString;
+}, z.core.$strip> & {
+    is(value: unknown): value is {
+        id: string;
+        from: string;
+        to: string;
+        content: string;
+        timestamp: string;
+    };
+};
+export type DmMessage = z.infer<typeof DmMessageSchema>;
+export declare const DeliveryEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"room_message">;
+    message: z.ZodObject<{
+        id: z.ZodString;
+        from: z.ZodString;
+        room: z.ZodString;
+        content: z.ZodString;
+        timestamp: z.ZodString;
+        replyTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip> & {
+        is(value: unknown): value is {
+            id: string;
+            from: string;
+            room: string;
+            content: string;
+            timestamp: string;
+            replyTo?: string | undefined;
+        };
+    };
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"dm">;
+    message: z.ZodObject<{
+        id: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodString;
+        content: z.ZodString;
+        timestamp: z.ZodString;
+    }, z.core.$strip> & {
+        is(value: unknown): value is {
+            id: string;
+            from: string;
+            to: string;
+            content: string;
+            timestamp: string;
+        };
+    };
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"room_invite">;
+    room: z.ZodString;
+    from: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"member_joined">;
+    room: z.ZodString;
+    agent: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"member_left">;
+    room: z.ZodString;
+    agent: z.ZodString;
+}, z.core.$strip>], "type"> & {
+    is(value: unknown): value is {
+        type: "room_message";
+        message: {
+            id: string;
+            from: string;
+            room: string;
+            content: string;
+            timestamp: string;
+            replyTo?: string | undefined;
+        };
+    } | {
+        type: "dm";
+        message: {
+            id: string;
+            from: string;
+            to: string;
+            content: string;
+            timestamp: string;
+        };
+    } | {
+        type: "room_invite";
+        room: string;
+        from: string;
+    } | {
+        type: "member_joined";
+        room: string;
+        agent: string;
+    } | {
+        type: "member_left";
+        room: string;
+        agent: string;
+    };
+};
+export type DeliveryEvent = z.infer<typeof DeliveryEventSchema>;
+export declare const BusActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"register">;
+    name: z.ZodString;
+    visibility: z.ZodUnion<readonly [z.ZodLiteral<"visible">, z.ZodLiteral<"hidden">, z.ZodLiteral<"ghost">]> & {
+        is(value: unknown): value is "visible" | "hidden" | "ghost";
+    };
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"update">;
+    visibility: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"visible">, z.ZodLiteral<"hidden">, z.ZodLiteral<"ghost">]> & {
+        is(value: unknown): value is "visible" | "hidden" | "ghost";
+    }>;
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"active">, z.ZodLiteral<"idle">, z.ZodLiteral<"busy">, z.ZodLiteral<"offline">]> & {
+        is(value: unknown): value is "active" | "idle" | "busy" | "offline";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"whoami">;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"create_room">;
+    name: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"public">, z.ZodLiteral<"private">, z.ZodLiteral<"secret">]> & {
+        is(value: unknown): value is "public" | "private" | "secret";
+    };
+    description: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list_rooms">;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"join_room">;
+    room: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"leave_room">;
+    room: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"send">;
+    target: z.ZodString;
+    content: z.ZodString;
+    replyTo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"dm">;
+    target: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list_agents">;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"read_room">;
+    room: z.ZodString;
+    since: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"invite">;
+    room: z.ZodString;
+    agent: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"kick">;
+    room: z.ZodString;
+    agent: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"destroy_room">;
+    room: z.ZodString;
+}, z.core.$strip>], "action"> & {
+    is(value: unknown): value is {
+        action: "register";
+        name: string;
+        visibility: "visible" | "hidden" | "ghost";
+        tags: string[];
+    } | {
+        action: "update";
+        visibility?: "visible" | "hidden" | "ghost" | undefined;
+        status?: "active" | "idle" | "busy" | "offline" | undefined;
+        name?: string | undefined;
+        tags?: string[] | undefined;
+    } | {
+        action: "whoami";
+    } | {
+        action: "create_room";
+        name: string;
+        type: "public" | "private" | "secret";
+        description: string;
+    } | {
+        action: "list_rooms";
+    } | {
+        action: "join_room";
+        room: string;
+    } | {
+        action: "leave_room";
+        room: string;
+    } | {
+        action: "send";
+        target: string;
+        content: string;
+        replyTo?: string | undefined;
+    } | {
+        action: "dm";
+        target: string;
+        content: string;
+    } | {
+        action: "list_agents";
+    } | {
+        action: "read_room";
+        room: string;
+        since?: string | undefined;
+    } | {
+        action: "invite";
+        room: string;
+        agent: string;
+    } | {
+        action: "kick";
+        room: string;
+        agent: string;
+    } | {
+        action: "destroy_room";
+        room: string;
+    };
+};
+export type BusAction = z.infer<typeof BusActionSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAM5B,eAAO,MAAM,UAAU;cApBT,OAAO,GAAG,KAAK,kCAAc;CAsB1C,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,WAAW;cAzBV,OAAO,GAAG,KAAK,0CAAc;CAgC1C,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,QAAQ;cAnCP,OAAO,GAAG,KAAK,mCAAc;CAqC1C,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAMhD,eAAO,MAAM,mBAAmB;;;;;;;kBA5ClB,OAAO,GAAG,KAAK,kCAAc;;;kBAA7B,OAAO,GAAG,KAAK,0CAAc;;;;;cAA7B,OAAO,GAAG,KAAK;;;;;;;;;;KAAc;CAwD1C,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,UAAU;;;;kBA/DT,OAAO,GAAG,KAAK,mCAAc;;;;;;;;cAA7B,OAAO,GAAG,KAAK;;;;;;;;;KAAc;CA0E1C,CAAC;AACF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAM9C,eAAO,MAAM,iBAAiB;;;;;;;;cAjFhB,OAAO,GAAG,KAAK;;;;;;;KAAc;CA0F1C,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;cA7Fd,OAAO,GAAG,KAAK;;;;;;KAAc;CAqG1C,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,mBAAmB;;;;;;;;;;kBA5GlB,OAAO,GAAG,KAAK;;;;;;;SAAc;;;;;;;;;;;kBAA7B,OAAO,GAAG,KAAK;;;;;;SAAc;;;;;;;;;;;;;;;cAA7B,OAAO,GAAG,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAc;CAsI1C,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,eAAe;;;;kBA7Id,OAAO,GAAG,KAAK,kCAAc;;;;;;kBAA7B,OAAO,GAAG,KAAK,kCAAc;;;kBAA7B,OAAO,GAAG,KAAK,0CAAc;;;;;;;;;;kBAA7B,OAAO,GAAG,KAAK,mCAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAA7B,OAAO,GAAG,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAc;CA4M1C,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}