@interactive-inc/claude-funnel 0.22.0 → 0.23.0

package/dist/index.d.ts

@@ -405,10 +405,15 @@ type Deps$13 = {
 /**
  * Per-channel persistent Claude Code session IDs, keyed by the cwd the
  * channel was launched from. The whole point is to give each (channel, cwd)
- * its own stable conversation: relaunching from the same path picks up the
- * previous claude session via `--session-id <uuid>`, while a different cwd
- * (or a different channel) gets an independent one — so sessions never
- * silently bleed across workspaces the way claude's `-c` does.
+ * its own stable conversation: relaunching from the same path resumes the
+ * previous claude session via `--resume <uuid>`, while a different cwd (or
+ * a different channel) gets an independent one — so sessions never silently
+ * bleed across workspaces the way claude's `-c` does.
+ *
+ * `get` and `create` are intentionally separate: claude's `--session-id`
+ * only accepts a fresh UUID (it errors if the session jsonl already
+ * exists), so callers must check `get` first and fall back to `create`
+ * only when there is nothing to resume.
  *
  * Storage lives under `<dir>/channels/<channel-id>/sessions.json` (channel
  * id, not name, so renames don't lose history). The file is a flat
@@ -419,10 +424,10 @@ declare class FunnelSessions {
   private readonly idGenerator;
   private readonly dir;
   constructor(deps: Deps$13);
-  /** Returns the existing session id for (channelId, cwd) or generates and persists a new one. */
-  getOrCreate(channelId: string, cwd: string): string;
   /** Returns the existing session id for (channelId, cwd) or null. */
   get(channelId: string, cwd: string): string | null;
+  /** Generates a new session id for (channelId, cwd) and persists it, overwriting any prior entry. */
+  create(channelId: string, cwd: string): string;
   /** Drops the recorded session id for (channelId, cwd). No-op if absent. */
   clear(channelId: string, cwd: string): void;
   /** Drops the whole session map for the channel (e.g. when the channel is deleted). */
@@ -484,14 +489,27 @@ declare class FunnelClaude {
   private isProcessAlive;
   private buildArgs;
   /**
-   * Decides whether funnel should inject `--session-id`. We back off when
-   * the user already passed a session-shaping flag, since combining them
-   * would either confuse claude or override the explicit user intent.
+   * Decides whether funnel should resume an existing claude session or start
+   * a freshly minted one. Backs off when the user already passed a
+   * session-shaping flag, since combining them would either confuse claude
+   * or override the explicit user intent.
    */
-  private resolveSessionId;
+  private resolveSession;
   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;
@@ -787,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. */
@@ -825,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;
@@ -886,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>;
@@ -919,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;
@@ -1119,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). */
@@ -1157,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;
@@ -1321,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.
@@ -1365,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. */
@@ -4275,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

@@ -597,8 +597,8 @@ var FunnelClaude = class {
 			this.writePidFile(options.profileName);
 			this.installCleanup(options.profileName);
 		}
-		const sessionId = channel.resume ? this.resolveSessionId(channel.id, cwd, options.userArgs ?? []) : null;
-		const claudeArgs = this.buildArgs(channel.options, options.userArgs ?? [], cwd, sessionId);
+		const session = channel.resume ? this.resolveSession(channel.id, cwd, options.userArgs ?? []) : null;
+		const claudeArgs = this.buildArgs(channel.options, options.userArgs ?? [], cwd, session);
 		const env = this.buildEnv(channel.id, channel.env);
 		this.logger.info(`claude launch`, {
 			channel: options.channel,
@@ -649,25 +649,35 @@ var FunnelClaude = class {
 	isProcessAlive(pid) {
 		return this.process.isAlive(pid);
 	}
-	buildArgs(channelOptions, userArgs, cwd, sessionId) {
+	buildArgs(channelOptions, userArgs, cwd, session) {
 		const result = [...channelOptions, ...userArgs];
-		if (sessionId !== null) result.push("--session-id", sessionId);
+		if (session !== null) if (session.mode === "resume") result.push("--resume", session.id);
+		else result.push("--session-id", session.id);
 		const mcpName = this.mcp.findInstalledName(cwd);
 		if (mcpName && !result.includes("--dangerously-load-development-channels") && !result.includes("--channels")) result.push("--dangerously-load-development-channels", `server:${mcpName}`);
 		return result;
 	}
 	/**
-	* Decides whether funnel should inject `--session-id`. We back off when
-	* the user already passed a session-shaping flag, since combining them
-	* would either confuse claude or override the explicit user intent.
+	* Decides whether funnel should resume an existing claude session or start
+	* a freshly minted one. Backs off when the user already passed a
+	* session-shaping flag, since combining them would either confuse claude
+	* or override the explicit user intent.
 	*/
-	resolveSessionId(channelId, cwd, userArgs) {
+	resolveSession(channelId, cwd, userArgs) {
 		for (const arg of userArgs) {
 			if (arg === "-c" || arg === "--continue") return null;
 			if (arg === "--resume" || arg.startsWith("--resume=")) return null;
 			if (arg === "--session-id" || arg.startsWith("--session-id=")) return null;
 		}
-		return this.sessions.getOrCreate(channelId, cwd);
+		const existing = this.sessions.get(channelId, cwd);
+		if (existing !== null) return {
+			id: existing,
+			mode: "resume"
+		};
+		return {
+			id: this.sessions.create(channelId, cwd),
+			mode: "new"
+		};
 	}
 	buildEnv(channelId, channelEnv) {
 		const env = {};
@@ -1492,10 +1502,15 @@ const sessionsMapSchema = z.record(z.string(), z.string());
 /**
 * Per-channel persistent Claude Code session IDs, keyed by the cwd the
 * channel was launched from. The whole point is to give each (channel, cwd)
-* its own stable conversation: relaunching from the same path picks up the
-* previous claude session via `--session-id <uuid>`, while a different cwd
-* (or a different channel) gets an independent one — so sessions never
-* silently bleed across workspaces the way claude's `-c` does.
+* its own stable conversation: relaunching from the same path resumes the
+* previous claude session via `--resume <uuid>`, while a different cwd (or
+* a different channel) gets an independent one — so sessions never silently
+* bleed across workspaces the way claude's `-c` does.
+*
+* `get` and `create` are intentionally separate: claude's `--session-id`
+* only accepts a fresh UUID (it errors if the session jsonl already
+* exists), so callers must check `get` first and fall back to `create`
+* only when there is nothing to resume.
 *
 * Storage lives under `<dir>/channels/<channel-id>/sessions.json` (channel
 * id, not name, so renames don't lose history). The file is a flat
@@ -1511,20 +1526,18 @@ var FunnelSessions = class {
 		this.dir = deps.dir;
 		Object.freeze(this);
 	}
-	/** Returns the existing session id for (channelId, cwd) or generates and persists a new one. */
-	getOrCreate(channelId, cwd) {
+	/** Returns the existing session id for (channelId, cwd) or null. */
+	get(channelId, cwd) {
+		return this.readMap(channelId)[cwd] ?? null;
+	}
+	/** Generates a new session id for (channelId, cwd) and persists it, overwriting any prior entry. */
+	create(channelId, cwd) {
 		const map = this.readMap(channelId);
-		const existing = map[cwd];
-		if (existing) return existing;
 		const sessionId = this.idGenerator.generate();
 		map[cwd] = sessionId;
 		this.writeMap(channelId, map);
 		return sessionId;
 	}
-	/** Returns the existing session id for (channelId, cwd) or null. */
-	get(channelId, cwd) {
-		return this.readMap(channelId)[cwd] ?? null;
-	}
 	/** Drops the recorded session id for (channelId, cwd). No-op if absent. */
 	clear(channelId, cwd) {
 		const map = this.readMap(channelId);
@@ -1969,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.
 *
@@ -1991,6 +2005,7 @@ var FunnelBroadcaster = class {
 	clients = /* @__PURE__ */ new Map();
 	subscribers = /* @__PURE__ */ new Set();
 	logger;
+	onError;
 	maxBufferedBytes;
 	now;
 	replayBufferSize;
@@ -2005,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);
@@ -2143,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;
 	}
@@ -2514,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) => {
@@ -2535,6 +2559,7 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 	channels;
 	notify;
 	logger;
+	onError;
 	running = /* @__PURE__ */ new Map();
 	failureCounts = /* @__PURE__ */ new Map();
 	stats = /* @__PURE__ */ new Map();
@@ -2548,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;
@@ -2610,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
 			};
 		}
 	}
@@ -2638,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
 			};
 		}
 	}
@@ -2926,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
@@ -2943,6 +2984,7 @@ var FunnelGatewayServer = class {
 	dbPath;
 	process;
 	logger;
+	onError;
 	selfPid;
 	dir;
 	killCompetingSlack;
@@ -2961,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;
@@ -2976,6 +3019,7 @@ var FunnelGatewayServer = class {
 		});
 		this.broadcaster = new FunnelBroadcaster({
 			logger: this.logger,
+			onError: this.onError,
 			now: this.nowMs,
 			persistentReplay: this.eventStore
 		});
@@ -2983,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,
@@ -3364,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.
 *
@@ -3435,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();
@@ -3595,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.0",
+  "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",
@@ -90,5 +90,8 @@
   },
   "engines": {
     "bun": ">=1.3.0"
+  },
+  "scripts": {
+    "prepack": "make build"
   }
 }