@interactive-inc/claude-funnel 0.22.1 → 0.23.0

package/dist/index.d.ts

@@ -498,6 +498,18 @@ declare class FunnelClaude {
   private buildEnv;
 }
 //#endregion
+//#region lib/engine/error/on-funnel-error.d.ts
+/**
+ * Host integration hook called when Funnel catches an exception that would
+ * otherwise be silently swallowed (subscriber throw, listener start failure,
+ * MCP forward failure, etc.). Pass `Sentry.captureException` from the host to
+ * pipe these into your error reporter. Defaults to a no-op when omitted.
+ *
+ * `context` carries the component name and any extra metadata the caller had
+ * at the catch site (channel / connector / subscriber id when available).
+ */
+type OnFunnelError = (error: Error, context?: Record<string, unknown>) => void;
+//#endregion
 //#region lib/engine/local-config/dotenv-reader.d.ts
 type Deps$11 = {
   fs: FunnelFileSystem;
@@ -793,7 +805,8 @@ type ReplaySource = {
   loadSince(since: number): ReplayableEvent[];
 };
 type Deps$6 = {
-  logger?: FunnelLogger;
+  logger?: FunnelLogger; /** Host hook for surfacing subscriber-throw exceptions. Defaults to no-op. */
+  onError?: OnFunnelError;
   maxBufferedBytes?: number;
   now?: () => number; /** Number of recent events kept in the in-memory replay buffer. */
   replayBufferSize?: number; /** Hard byte cap on replay buffer payloads. Older events are evicted FIFO until under this cap. */
@@ -831,6 +844,7 @@ declare class FunnelBroadcaster {
   private readonly clients;
   private readonly subscribers;
   private readonly logger;
+  private readonly onError;
   private readonly maxBufferedBytes;
   private readonly now;
   private readonly replayBufferSize;
@@ -892,7 +906,8 @@ type SupervisorNotify = (channelName: string, connectorName: string, content: st
 type Deps$5 = {
   channels: ConnectorRegistry;
   notify: SupervisorNotify;
-  logger?: FunnelLogger;
+  logger?: FunnelLogger; /** Host hook for surfacing listener lifecycle exceptions. Defaults to no-op. */
+  onError?: OnFunnelError;
   healthCheckIntervalMs?: number;
   maxBackoffMs?: number;
   sleep?: (ms: number) => Promise<void>;
@@ -925,6 +940,7 @@ declare class FunnelListenerSupervisor {
   private readonly channels;
   private readonly notify;
   private readonly logger;
+  private readonly onError;
   private readonly running;
   private readonly failureCounts;
   private readonly stats;
@@ -1125,7 +1141,8 @@ type Deps$3 = {
   dbPath?: string;
   process?: FunnelProcessRunner;
   clock?: FunnelClock;
-  logger?: FunnelLogger;
+  logger?: FunnelLogger; /** Host hook for surfacing internal exceptions (broadcaster / supervisor). Defaults to no-op. */
+  onError?: OnFunnelError;
   selfPid?: number; /** Funnel home dir, used to scope kill-competing to daemons rooted at the same dir. Defaults to FUNNEL_DIR. */
   dir?: string;
   killCompetingSlack?: boolean; /** Bearer token required for `/listeners*`, `/status`, and `/ws`. Empty string disables auth (tests only). */
@@ -1163,6 +1180,7 @@ declare class FunnelGatewayServer {
   private readonly dbPath;
   private readonly process?;
   private readonly logger;
+  private readonly onError;
   private readonly selfPid;
   private readonly dir;
   private readonly killCompetingSlack;
@@ -1327,6 +1345,12 @@ type Props$5 = {
    * each successful fire, useful for dropping one-shot entries.
    */
   scheduleListenerOptions?: ScheduleListenerOptions;
+  /**
+   * Called when Funnel catches an exception that would otherwise be silently
+   * swallowed (subscriber throw, listener start/stop failure, etc.). Pass
+   * `Sentry.captureException` from the host to surface these. Defaults to no-op.
+   */
+  onError?: OnFunnelError;
 };
 /**
  * Facade exposing every funnel facet as a getter.
@@ -1371,6 +1395,11 @@ declare class Funnel {
   get logger(): FunnelLogger;
   /** Clock boundary. Defaults to NodeFunnelClock. */
   get clock(): FunnelClock;
+  /**
+   * Error hook. Forwards Funnel-internal exceptions that would otherwise be
+   * swallowed. Defaults to a no-op when no host hook was passed.
+   */
+  get onError(): OnFunnelError;
   /** ID generator boundary. Defaults to NodeFunnelIdGenerator. */
   get idGenerator(): FunnelIdGenerator;
   /** Settings reader. If not injected, a FunnelSettingsStore rooted at `dir` is created. */
@@ -4281,4 +4310,4 @@ ${string}`;
 //#region lib/tui/tui.d.ts
 declare function launchTui(funnel: Funnel): Promise<void>;
 //#endregion
-export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelServerOptions, ChannelSpec, ConnectorConfig, ConnectorSpec, ConnectorSyncOutcome, ConnectorType, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiscordConnectorConfig, Env, FUNNEL_DIR, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, FunnelDotenvReader, FunnelEvent, FunnelEventStore, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSessions, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, type GatewayEmitInput, type GatewayRouteDeps, type Env$1 as GatewayServerEnv, GhConnectorConfig, LOCAL_CONFIG_FILENAME, LOCAL_ENV_FILENAME, LaunchOptions, ListListenersResult, ListenerEntry, ListenerOpResult, LocalConfig, LocalConfigSyncResult, LogEntry, MemoryFunnelClock, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, NotifyFn, ProcessListStub, ProcessSnapshot, ProfileConfig, PublishRequest, PublishResponse, PublishResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, app as cliApp, connectorConfigSchema, connectorSpecSchema, createCliApp, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, launchTui, localConfigSchema, profileConfigSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };
+export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelServerOptions, ChannelSpec, ConnectorConfig, ConnectorSpec, ConnectorSyncOutcome, ConnectorType, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiscordConnectorConfig, Env, FUNNEL_DIR, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, FunnelDotenvReader, FunnelEvent, FunnelEventStore, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSessions, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, type GatewayEmitInput, type GatewayRouteDeps, type Env$1 as GatewayServerEnv, GhConnectorConfig, LOCAL_CONFIG_FILENAME, LOCAL_ENV_FILENAME, LaunchOptions, ListListenersResult, ListenerEntry, ListenerOpResult, LocalConfig, LocalConfigSyncResult, LogEntry, MemoryFunnelClock, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, NotifyFn, OnFunnelError, ProcessListStub, ProcessSnapshot, ProfileConfig, PublishRequest, PublishResponse, PublishResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, app as cliApp, connectorConfigSchema, connectorSpecSchema, createCliApp, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, launchTui, localConfigSchema, profileConfigSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };

package/dist/index.js

@@ -1982,6 +1982,7 @@ const DEFAULT_MAX_BUFFERED_BYTES = 1024 * 1024;
 const DEFAULT_REPLAY_BUFFER_SIZE = 200;
 const DEFAULT_REPLAY_BUFFER_MAX_BYTES = 4 * 1024 * 1024;
 const defaultLogger$3 = new NoopFunnelLogger();
+const defaultOnError$2 = () => {};
 /**
 * In-process pub/sub for connector events.
 *
@@ -2004,6 +2005,7 @@ var FunnelBroadcaster = class {
 	clients = /* @__PURE__ */ new Map();
 	subscribers = /* @__PURE__ */ new Set();
 	logger;
+	onError;
 	maxBufferedBytes;
 	now;
 	replayBufferSize;
@@ -2018,6 +2020,7 @@ var FunnelBroadcaster = class {
 	latestOffset = 0;
 	constructor(deps = {}) {
 		this.logger = deps.logger ?? defaultLogger$3;
+		this.onError = deps.onError ?? defaultOnError$2;
 		this.maxBufferedBytes = deps.maxBufferedBytes ?? DEFAULT_MAX_BUFFERED_BYTES;
 		this.now = deps.now ?? (() => Date.now());
 		this.replayBufferSize = Math.max(0, deps.replayBufferSize ?? DEFAULT_REPLAY_BUFFER_SIZE);
@@ -2156,7 +2159,14 @@ var FunnelBroadcaster = class {
 		for (const handler of this.subscribers) try {
 			handler(event);
 		} catch (error) {
-			this.logger.error("broadcast subscriber threw", { error: error instanceof Error ? error.message : String(error) });
+			const err = error instanceof Error ? error : new Error(String(error));
+			this.logger.error("broadcast subscriber threw", { error: err.message });
+			this.onError(err, {
+				component: "broadcaster.subscriber",
+				offset: event.offset,
+				connector: event.meta?.connector ?? null,
+				channel: event.meta?.channel ?? null
+			});
 		}
 		return event;
 	}
@@ -2527,6 +2537,7 @@ function truncate$1(content) {
 //#endregion
 //#region lib/gateway/listener-supervisor.ts
 const defaultLogger$2 = new NodeFunnelLogger();
+const defaultOnError$1 = () => {};
 const DEFAULT_HEALTH_INTERVAL_MS = 3e4;
 const DEFAULT_MAX_BACKOFF_MS = 6e4;
 const defaultSleep = (ms) => new Promise((r) => {
@@ -2548,6 +2559,7 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 	channels;
 	notify;
 	logger;
+	onError;
 	running = /* @__PURE__ */ new Map();
 	failureCounts = /* @__PURE__ */ new Map();
 	stats = /* @__PURE__ */ new Map();
@@ -2561,6 +2573,7 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 		this.channels = deps.channels;
 		this.notify = deps.notify;
 		this.logger = deps.logger ?? defaultLogger$2;
+		this.onError = deps.onError ?? defaultOnError$1;
 		this.healthCheckIntervalMs = deps.healthCheckIntervalMs ?? DEFAULT_HEALTH_INTERVAL_MS;
 		this.maxBackoffMs = deps.maxBackoffMs ?? DEFAULT_MAX_BACKOFF_MS;
 		this.sleep = deps.sleep ?? defaultSleep;
@@ -2623,14 +2636,21 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 			});
 			return { ok: true };
 		} catch (error) {
+			const err = error instanceof Error ? error : new Error(String(error));
 			this.logger.error(`${created.config.type} listener failed to start`, {
 				channel: channelName,
 				connector: connectorName,
-				error: error instanceof Error ? error.message : String(error)
+				error: err.message
+			});
+			this.onError(err, {
+				component: "listener-supervisor.start",
+				channel: channelName,
+				connector: connectorName,
+				type: created.config.type
 			});
 			return {
 				ok: false,
-				reason: error instanceof Error ? error.message : String(error)
+				reason: err.message
 			};
 		}
 	}
@@ -2651,14 +2671,21 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 			});
 			return { ok: true };
 		} catch (error) {
+			const err = error instanceof Error ? error : new Error(String(error));
 			this.logger.error(`${entry.config.type} listener failed to stop`, {
 				channel: channelName,
 				connector: connectorName,
-				error: error instanceof Error ? error.message : String(error)
+				error: err.message
+			});
+			this.onError(err, {
+				component: "listener-supervisor.stop",
+				channel: channelName,
+				connector: connectorName,
+				type: entry.config.type
 			});
 			return {
 				ok: false,
-				reason: error instanceof Error ? error.message : String(error)
+				reason: err.message
 			};
 		}
 	}
@@ -2939,6 +2966,7 @@ const gatewayRoutes = factory$1.createApp().get("/health", ...healthHandler).get
 const DEFAULT_PORT = 9742;
 const defaultDbPath = () => join(funnelTmpDir(), "events.db");
 const defaultLogger = new NodeFunnelLogger();
+const defaultOnError = () => {};
 /**
 * In-process gateway: runs `Bun.serve` (HTTP + WebSocket /ws), boots connector
 * listeners through `FunnelListenerSupervisor`, fans events out via
@@ -2956,6 +2984,7 @@ var FunnelGatewayServer = class {
 	dbPath;
 	process;
 	logger;
+	onError;
 	selfPid;
 	dir;
 	killCompetingSlack;
@@ -2974,6 +3003,7 @@ var FunnelGatewayServer = class {
 		this.dbPath = deps.dbPath ?? defaultDbPath();
 		this.process = deps.process;
 		this.logger = deps.logger ?? defaultLogger;
+		this.onError = deps.onError ?? defaultOnError;
 		this.selfPid = deps.selfPid ?? globalThis.process.pid;
 		this.dir = deps.dir ?? FUNNEL_DIR;
 		this.killCompetingSlack = deps.killCompetingSlack ?? true;
@@ -2989,6 +3019,7 @@ var FunnelGatewayServer = class {
 		});
 		this.broadcaster = new FunnelBroadcaster({
 			logger: this.logger,
+			onError: this.onError,
 			now: this.nowMs,
 			persistentReplay: this.eventStore
 		});
@@ -2996,6 +3027,7 @@ var FunnelGatewayServer = class {
 		this.supervisor = new FunnelListenerSupervisor({
 			channels: this.channels,
 			logger: this.logger,
+			onError: this.onError,
 			notify: async (channelName, connectorName, content, meta) => {
 				this.emit({
 					channel: channelName,
@@ -3377,6 +3409,7 @@ var FunnelListenersClient = class {
 //#region lib/funnel.ts
 const SANDBOX_DIR = "/sandbox/.funnel";
 const SANDBOX_TMP_DIR = "/sandbox/tmp";
+const noopOnError = () => {};
 /**
 * Facade exposing every funnel facet as a getter.
 *
@@ -3448,6 +3481,13 @@ var Funnel = class Funnel {
 		if (!this.memos.clock) this.memos.clock = this.props.clock ?? new NodeFunnelClock();
 		return this.memos.clock;
 	}
+	/**
+	* Error hook. Forwards Funnel-internal exceptions that would otherwise be
+	* swallowed. Defaults to a no-op when no host hook was passed.
+	*/
+	get onError() {
+		return this.props.onError ?? noopOnError;
+	}
 	/** ID generator boundary. Defaults to NodeFunnelIdGenerator. */
 	get idGenerator() {
 		if (!this.memos.idGenerator) this.memos.idGenerator = this.props.idGenerator ?? new NodeFunnelIdGenerator();
@@ -3608,6 +3648,7 @@ var Funnel = class Funnel {
 			process: this.process,
 			clock: this.clock,
 			logger: this.logger,
+			onError: this.onError,
 			dir: this.paths.dir,
 			killCompetingSlack: options.killCompetingSlack,
 			token: options.token ?? this.gatewayToken.ensure(),

package/package.json

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