@interactive-inc/claude-funnel 0.38.0 → 0.39.0

package/dist/index.d.ts

@@ -407,6 +407,14 @@ type ClientData = {
   connectors: string[];
   tapAll?: boolean; /** Routing mode resolved from channel config at upgrade time. Defaults to fanout. */
   delivery?: "fanout" | "exclusive";
+  /**
+   * Opaque per-client id declared at upgrade time (`?id=<subscriberId>`). When an
+   * event carries `meta.target`, only the client whose `subscriberId` equals it
+   * receives the event among that channel's regular subscribers. Targeted delivery
+   * is how a publisher addresses one specific instance (e.g. a single agent
+   * session) without every subscriber having to receive and discard it.
+   */
+  subscriberId?: string;
 };
 type BroadcastEvent = {
   content: string;
@@ -498,6 +506,11 @@ declare class FunnelBroadcaster {
    * receive (passive observation). For each per-channel group:
    *   - fanout → every matching client receives
    *   - exclusive → exactly one client receives, picked round-robin per channel
+   *
+   * `meta.target` narrows the regular (non-tap) recipient set first via
+   * `matchesClient`: only the subscriber whose `subscriberId` equals `target`
+   * stays in the running, so a targeted event reaches one named instance while
+   * still being observable by tap=all clients.
    */
   private pickRecipients;
   addClient(ws: ServerWebSocket<unknown>, data: ClientData): void;
@@ -892,6 +905,7 @@ declare function buildGatewayRoutes(): _$hono_hono_base0.HonoBase<Env$1, {
           content: string;
           meta?: Record<string, string> | undefined;
           connector?: string | undefined;
+          target?: string | undefined;
         };
       };
       output: {
@@ -910,6 +924,7 @@ declare function buildGatewayRoutes(): _$hono_hono_base0.HonoBase<Env$1, {
           content: string;
           meta?: Record<string, string> | undefined;
           connector?: string | undefined;
+          target?: string | undefined;
         };
       };
       output: {
@@ -928,6 +943,7 @@ declare function buildGatewayRoutes(): _$hono_hono_base0.HonoBase<Env$1, {
           content: string;
           meta?: Record<string, string> | undefined;
           connector?: string | undefined;
+          target?: string | undefined;
         };
       };
       output: {
@@ -1303,6 +1319,7 @@ declare const publishRequestSchema: z.ZodObject<{
   content: z.ZodString;
   meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   connector: z.ZodOptional<z.ZodString>;
+  target: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type PublishRequest = z.infer<typeof publishRequestSchema>;
 declare const publishResponseSchema: z.ZodObject<{
@@ -1472,7 +1489,8 @@ type WsData = {
   channelName: string | null; /** Connector names belonging to that channel; used by tap-all replay filtering. */
   connectors: string[];
   tapAll?: boolean; /** Routing mode for this channel; resolved at upgrade time from settings. */
-  delivery: "fanout" | "exclusive"; /** Replay any events with offset strictly greater than this on open, then resume the live stream. */
+  delivery: "fanout" | "exclusive"; /** Opaque client id from `?id=<subscriberId>`; lets publishers target this client via `meta.target`. */
+  subscriberId?: string; /** Replay any events with offset strictly greater than this on open, then resume the live stream. */
   since?: number;
 };
 /**
@@ -2354,7 +2372,7 @@ declare const routes: _$hono_hono_base0.HonoBase<Env, {
         connectors: {
           id: string;
           name: string;
-          type: "schedule" | "slack" | "gh" | "discord";
+          type: "discord" | "gh" | "slack" | "schedule";
         }[];
       }[];
       outputFormat: "json";

package/dist/index.js

@@ -1740,7 +1740,14 @@ var MemoryFunnelClock = class extends FunnelClock {
 const publishRequestSchema = z.object({
 	content: z.string().min(1),
 	meta: z.record(z.string(), z.string()).optional(),
-	connector: z.string().min(1).optional()
+	connector: z.string().min(1).optional(),
+	/**
+	* Address the event to a single subscriber. When set, only the WS client that
+	* declared this id at upgrade time (`?id=<subscriberId>`) receives it among the
+	* channel's regular subscribers; tap=all observers still see it. Omit for the
+	* default fanout. The route surfaces it to subscribers as `meta.target`.
+	*/
+	target: z.string().min(1).optional()
 });
 const publishResponseSchema = z.object({
 	ok: z.literal(true),
@@ -2101,6 +2108,8 @@ var FunnelBroadcaster = class {
 	}
 	matchesClient(event, data) {
 		if (data.tapAll) return true;
+		const target = event.meta?.target;
+		if (target && target !== data.subscriberId) return false;
 		const channelId = event.meta?.channelId;
 		if (channelId && channelId !== data.channel) return false;
 		const connector = event.meta?.connector;
@@ -2112,6 +2121,11 @@ var FunnelBroadcaster = class {
 	* receive (passive observation). For each per-channel group:
 	*   - fanout → every matching client receives
 	*   - exclusive → exactly one client receives, picked round-robin per channel
+	*
+	* `meta.target` narrows the regular (non-tap) recipient set first via
+	* `matchesClient`: only the subscriber whose `subscriberId` equals `target`
+	* stays in the running, so a targeted event reaches one named instance while
+	* still being observable by tap=all clients.
 	*/
 	pickRecipients(event) {
 		const exclusiveByChannel = /* @__PURE__ */ new Map();
@@ -2983,13 +2997,17 @@ const channelsPublishHandler$1 = factory$1.createHandlers(zParam(z.object({ chan
 }), (c) => {
 	const param = c.req.valid("param");
 	const body = c.req.valid("json");
+	const meta = body.target ? {
+		...body.meta,
+		target: body.target
+	} : body.meta;
 	const response = {
 		ok: true,
 		offset: c.var.deps.emit({
 			channel: param.channel,
 			connector: body.connector,
 			content: body.content,
-			meta: body.meta
+			meta
 		}).offset
 	};
 	return c.json(response);
@@ -3453,12 +3471,14 @@ var FunnelGatewayServer = class {
 			const sinceRaw = url.searchParams.get("since");
 			const sinceParsed = sinceRaw === null ? NaN : Number.parseInt(sinceRaw, 10);
 			const since = Number.isFinite(sinceParsed) && sinceParsed >= 0 ? sinceParsed : void 0;
+			const subscriberId = url.searchParams.get("id") ?? void 0;
 			if (server.upgrade(request, { data: {
 				channel: channelId,
 				channelName,
 				connectors,
 				tapAll,
 				delivery,
+				subscriberId,
 				since
 			} })) return void 0;
 			return new Response("WebSocket upgrade failed", { status: 400 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interactive-inc/claude-funnel",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Hub CLI that routes external events (Slack / GitHub / Discord) to Claude Code agents through subscription channels over MCP.",
   "keywords": [
     "bun",