agent-comms 1.1.0 → 1.2.0

package/dist/core/index.d.ts

@@ -1,12 +1,14 @@
 /**
  * Agent Comms — cross-harness LLM agent communication.
  *
- * Core protocol: types, filesystem store, tool handler.
+ * Core protocol: types, store interface, tool handler.
  * Bridges (pi extension, Claude Code channel) are in ../bridges/.
  */
-export { BusStore, BusError } from "./store.js";
-export { BusTool } from "./tool.js";
-export type { ToolContext, ToolResult } from "./tool.js";
+export type { CommsStore } from "./comms-store.js";
+export { FileStore, CommsError } from "./store.js";
+export { MeshStore } from "./mesh-store.js";
+export { CommsTool } from "./tool.js";
+export type { CommsContext, CommsResult } from "./tool.js";
 export { buildAction, formatDeliveryEvent, ensureRegistered, drainAndFormat, MCP_TOOL_PARAMS, } from "./bridge.js";
 export type { RegistrationResult } from "./bridge.js";
 export * from "./types.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,cAAc,YAAY,CAAC"}

package/dist/core/index.js

@@ -1,11 +1,12 @@
 /**
  * Agent Comms — cross-harness LLM agent communication.
  *
- * Core protocol: types, filesystem store, tool handler.
+ * Core protocol: types, store interface, tool handler.
  * Bridges (pi extension, Claude Code channel) are in ../bridges/.
  */
-export { BusStore, BusError } from "./store.js";
-export { BusTool } from "./tool.js";
+export { FileStore, CommsError } from "./store.js";
+export { MeshStore } from "./mesh-store.js";
+export { CommsTool } from "./tool.js";
 export { buildAction, formatDeliveryEvent, ensureRegistered, drainAndFormat, MCP_TOOL_PARAMS, } from "./bridge.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,cAAc,YAAY,CAAC"}

package/dist/core/mesh-store.d.ts

@@ -0,0 +1,88 @@
+/**
+ * MeshStore — TCP localhost peer mesh for agent communication.
+ *
+ * Each bridge instance is a peer in the mesh. Peers discover each other
+ * via a coordinator (the first instance to bind the well-known port).
+ * All state is held in memory and synchronised between peers.
+ * Delivery events are pushed directly over TCP — no polling, no filesystem.
+ *
+ * Falls back to FileStore if the mesh is unavailable.
+ */
+import type { CommsStore } from "./comms-store.js";
+import type { AgentIdentity, DeliveryEvent, DmMessage, Room, RoomMessage, RoomType, Visibility } from "./types.js";
+export declare class MeshStore implements CommsStore {
+    readonly peerId: string;
+    readonly startedAt: string;
+    readonly coordinatorPort: number;
+    private agents;
+    private rooms;
+    private messages;
+    private dms;
+    private deliveryQueues;
+    private identityCache;
+    private dataServer;
+    private dataPort;
+    private coordinatorServer;
+    private isCoordinator;
+    private peerConnections;
+    private peerInfo;
+    private staleCheckTimer;
+    onDelivery: ((agentId: string, event: DeliveryEvent) => void | Promise<void>) | undefined;
+    constructor(coordinatorPort?: number);
+    init(): Promise<void>;
+    private startDataServer;
+    private tryJoinMesh;
+    private connectToCoordinator;
+    private handleCoordinatorResponse;
+    private becomeCoordinator;
+    private handleCoordinatorConnection;
+    private handleIntroduction;
+    private handleDataConnection;
+    private handleDataMessage;
+    private applyPatch;
+    private connectToPeerData;
+    private broadcastToDataConnections;
+    private broadcastPatch;
+    private deliverLocallyAndBroadcast;
+    readIdentity(harness: string, cwd: string): Promise<{
+        id: string;
+    } | undefined>;
+    writeIdentity(harness: string, cwd: string, id: string): Promise<void>;
+    registerAgent(opts: {
+        name: string;
+        harness: string;
+        cwd: string;
+        pid: number;
+        visibility: Visibility;
+        tags: string[];
+    }): Promise<AgentIdentity>;
+    getAgent(id: string): Promise<AgentIdentity | undefined>;
+    updateAgent(id: string, patch: Partial<Pick<AgentIdentity, "name" | "visibility" | "status" | "tags" | "pid">>): Promise<AgentIdentity>;
+    listAgents(requesterId: string): Promise<AgentIdentity[]>;
+    setAgentOffline(id: string): Promise<void>;
+    createRoom(opts: {
+        name: string;
+        type: RoomType;
+        owner: string;
+        description: string;
+    }): Promise<Room>;
+    getRoom(id: string): Promise<Room | undefined>;
+    listRooms(requesterId: string): Promise<Room[]>;
+    joinRoom(roomId: string, agentId: string): Promise<Room>;
+    leaveRoom(roomId: string, agentId: string): Promise<void>;
+    inviteToRoom(roomId: string, targetId: string, inviterId: string): Promise<void>;
+    kickFromRoom(roomId: string, targetId: string, kickerId: string): Promise<void>;
+    destroyRoom(roomId: string, agentId: string): Promise<void>;
+    sendRoomMessage(roomId: string, from: string, content: string, replyTo?: string): Promise<RoomMessage>;
+    readRoomMessages(roomId: string, since?: string): Promise<RoomMessage[]>;
+    sendDm(from: string, to: string, content: string): Promise<DmMessage>;
+    deliver(agentId: string, event: DeliveryEvent): Promise<void>;
+    drainDelivery(agentId: string): Promise<DeliveryEvent[]>;
+    private startStaleCheck;
+    private stopStaleCheck;
+    private probeStaleAgents;
+    private isProcessAlive;
+    private handoverCoordinator;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=mesh-store.d.ts.map

package/dist/core/mesh-store.d.ts.map

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