@interactive-inc/claude-funnel 0.25.1 → 0.26.0

package/dist/index.js

@@ -1,12 +1,12 @@
-import { i as FunnelDiscordAdapter, n as FunnelDiscordListener, t as discordConnectorSchema } from "./discord-connector-schema-CR8RJ08_.js";
-import { i as FunnelConnectorListener, n as funnelTmpDir, r as FunnelLogger, t as NodeFunnelLogger } from "./node-logger-B97ZiGwj.js";
-import { a as FunnelProcessRunner, i as NodeFunnelProcessRunner, n as FunnelGhListener, r as FunnelGhAdapter, t as ghConnectorSchema } from "./gh-connector-schema-CAC24s0r.js";
-import { a as ScheduleStateStore, i as FunnelScheduleListener, n as scheduleConnectorSchema, o as NodeFunnelFileSystem, r as scheduleEntrySchema, s as FunnelFileSystem, t as scheduleCatchupPolicySchema } from "./schedule-connector-schema-BZpH6ZmR.js";
-import { i as FunnelSlackAdapter, n as FunnelSlackListener, r as FunnelSlackEventProcessor, t as slackConnectorSchema } from "./slack-connector-schema-B0NyhxqQ.js";
+import { i as FunnelDiscordAdapter, n as FunnelDiscordListener, t as discordConnectorSchema } from "./discord-connector-schema-CpuI6rmE.js";
+import { n as FunnelConnectorListener, t as FunnelLogger } from "./logger-D1A3_JXV.js";
+import { a as FunnelProcessRunner, i as NodeFunnelProcessRunner, n as FunnelGhListener, r as FunnelGhAdapter, t as ghConnectorSchema } from "./gh-connector-schema-CQRIvPpz.js";
+import { a as ScheduleStateStore, i as FunnelScheduleListener, n as scheduleConnectorSchema, o as NodeFunnelFileSystem, r as scheduleEntrySchema, s as FunnelFileSystem, t as scheduleCatchupPolicySchema } from "./schedule-connector-schema-CuCjP7z4.js";
+import { i as FunnelSlackAdapter, n as FunnelSlackListener, r as FunnelSlackEventProcessor, t as slackConnectorSchema } from "./slack-connector-schema-BWL7dWlY.js";
 import { dirname, join, resolve } from "node:path";
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { z } from "zod";
+import { homedir, tmpdir } from "node:os";
 import { stderr, stdin } from "node:process";
 import { fileURLToPath } from "node:url";
 import { timingSafeEqual } from "node:crypto";
@@ -22,6 +22,20 @@ import { TextAttributes, createCliRenderer } from "@opentui/core";
 import { createRoot, useKeyboard, useRenderer } from "@opentui/react";
 import { createContext, useContext, useEffect, useId, useState } from "react";
 import { Fragment, jsx, jsxs } from "@opentui/react/jsx-runtime";
+//#region lib/engine/id/id-generator.ts
+/**
+* ID generator boundary. Default NodeFunnelIdGenerator wraps `crypto.randomUUID()`;
+* MemoryFunnelIdGenerator emits `<prefix>-1, <prefix>-2, ...` for deterministic tests.
+*/
+var FunnelIdGenerator = class {};
+//#endregion
+//#region lib/engine/id/node-id-generator.ts
+var NodeFunnelIdGenerator = class extends FunnelIdGenerator {
+	generate() {
+		return crypto.randomUUID();
+	}
+};
+//#endregion
 //#region lib/engine/settings/settings-reader.ts
 var FunnelSettingsReader = class {};
 //#endregion
@@ -53,6 +67,11 @@ const channelConfigSchema = z.object({
 	connectors: z.array(connectorConfigSchema).default([])
 });
 const profileConfigSchema = z.object({
+	/** Stable identity (uuid). The primary key everything internal resolves to;
+	*  survives renames. CLI surfaces still address profiles by `name`. */
+	id: z.string(),
+	/** Human-facing label used only at the CLI/TUI surface (`--profile <name>`).
+	*  Renameable; never used as a storage key. */
 	name: z.string(),
 	path: z.string(),
 	channelId: z.string(),
@@ -61,11 +80,20 @@ const profileConfigSchema = z.object({
 	/** Env vars layered under the launched claude process. process.env wins on collision. */
 	env: z.record(z.string(), z.string()).default({}),
 	/**
-	* When true (the default), funnel injects `--session-id <uuid>` so that
-	* relaunching from the same cwd resumes the previous claude session.
-	* Set to false for profiles that should always start a fresh session.
+	* When true (the default), funnel resumes this profile's previous claude
+	* session via `--session-id`/`--resume`. The id lives in `sessionId` below,
+	* scoped to this profile so an unrelated session in the same repo can't bleed
+	* in. Set to false for profiles that should always start fresh.
+	*/
+	resume: z.boolean().default(true),
+	/**
+	* Execution state, not config: the claude session id this profile last
+	* launched. Written by the launcher, read on the next resume. Absent until
+	* the first launch; kept inside the profile (rather than a separate file) so
+	* the session belongs to the profile by identity and the transport layer
+	* (channels) never has to know profiles exist.
 	*/
-	resume: z.boolean().default(true)
+	sessionId: z.string().optional()
 });
 const SETTINGS_VERSION = 1;
 const settingsSchema = z.object({
@@ -79,13 +107,16 @@ const settingsSchema = z.object({
 const FUNNEL_DIR = join(homedir(), ".funnel");
 const SETTINGS_PATH = join(FUNNEL_DIR, "settings.json");
 const defaultFs$5 = new NodeFunnelFileSystem();
+const defaultIdGenerator$2 = new NodeFunnelIdGenerator();
 var FunnelSettingsStore = class extends FunnelSettingsReader {
 	path;
 	fs;
+	idGenerator;
 	constructor(deps = {}) {
 		super();
 		this.path = deps.path ?? SETTINGS_PATH;
 		this.fs = deps.fs ?? defaultFs$5;
+		this.idGenerator = deps.idGenerator ?? defaultIdGenerator$2;
 		Object.freeze(this);
 	}
 	read() {
@@ -98,6 +129,7 @@ var FunnelSettingsStore = class extends FunnelSettingsReader {
 		const parsed = JSON.parse(content);
 		if (this.looksLikeLegacy(parsed)) throw new Error(`legacy settings.json detected at ${this.path}. The schema changed (channel.connectors are now nested objects with ids; profile fields renamed). Migration is intentionally not provided. Back up and remove the old file:\n  mv ${this.path} ${this.path}.bak`);
 		if (parsed && typeof parsed === "object" && "version" in parsed && parsed.version !== 1) throw new Error(`unsupported settings.json version (${this.path}): expected 1, got ${String(parsed.version)}`);
+		this.backfillProfileIds(parsed);
 		const result = settingsSchema.safeParse(parsed);
 		if (!result.success) throw new Error(`invalid settings.json (${this.path}): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ")}`);
 		return result.data;
@@ -120,6 +152,23 @@ var FunnelSettingsStore = class extends FunnelSettingsReader {
 		}
 		return false;
 	}
+	/**
+	* Non-destructive migration for profiles written before `id` existed. The id
+	* is a later addition to an otherwise-compatible schema, so rather than
+	* rejecting the file we mint a uuid for each profile that lacks one; the next
+	* `write` persists it. Mutates `parsed` in place (it is freshly JSON-parsed
+	* and discarded after the schema parse, so no shared state is touched).
+	*/
+	backfillProfileIds(parsed) {
+		if (!parsed || typeof parsed !== "object") return;
+		const obj = parsed;
+		if (!Array.isArray(obj.profiles)) return;
+		for (const profile of obj.profiles) {
+			if (!profile || typeof profile !== "object") continue;
+			const p = profile;
+			if (typeof p.id !== "string") p.id = this.idGenerator.generate();
+		}
+	}
 	write(settings) {
 		this.fs.mkdirSync(dirname(this.path), { recursive: true });
 		const versioned = {
@@ -133,7 +182,6 @@ var FunnelSettingsStore = class extends FunnelSettingsReader {
 //#region lib/connectors/connector-factory.ts
 const defaultFs$4 = new NodeFunnelFileSystem();
 const defaultProcess$3 = new NodeFunnelProcessRunner();
-const defaultLogger$5 = new NodeFunnelLogger();
 /**
 * Pure factory for per-type listeners and adapters. The factory has no CRUD
 * responsibility — connector configs live inside settings.json under their
@@ -156,7 +204,7 @@ var FunnelConnectorFactory = class {
 	constructor(deps = {}) {
 		this.fs = deps.fs ?? defaultFs$4;
 		this.process = deps.process ?? defaultProcess$3;
-		this.logger = deps.logger ?? defaultLogger$5;
+		this.logger = deps.logger;
 		this.dir = deps.dir ?? FUNNEL_DIR;
 		this.slackListenerOptions = deps.slackListenerOptions ?? {};
 		this.scheduleListenerOptions = deps.scheduleListenerOptions ?? {};
@@ -257,23 +305,9 @@ var NodeFunnelClock = class extends FunnelClock {
 	}
 };
 //#endregion
-//#region lib/engine/id/id-generator.ts
-/**
-* ID generator boundary. Default NodeFunnelIdGenerator wraps `crypto.randomUUID()`;
-* MemoryFunnelIdGenerator emits `<prefix>-1, <prefix>-2, ...` for deterministic tests.
-*/
-var FunnelIdGenerator = class {};
-//#endregion
-//#region lib/engine/id/node-id-generator.ts
-var NodeFunnelIdGenerator = class extends FunnelIdGenerator {
-	generate() {
-		return crypto.randomUUID();
-	}
-};
-//#endregion
 //#region lib/engine/channels/channels.ts
 const defaultClock$1 = new NodeFunnelClock();
-const defaultIdGenerator = new NodeFunnelIdGenerator();
+const defaultIdGenerator$1 = new NodeFunnelIdGenerator();
 /**
 * Channels own their connectors. Each channel has a stable id (UUID); the
 * `name` is the human-facing label used by the CLI. Connectors live nested
@@ -293,7 +327,7 @@ var FunnelChannels = class {
 		this.factory = deps.factory;
 		this.profileChecker = deps.profileChecker;
 		this.clock = deps.clock ?? defaultClock$1;
-		this.idGenerator = deps.idGenerator ?? defaultIdGenerator;
+		this.idGenerator = deps.idGenerator ?? defaultIdGenerator$1;
 		Object.freeze(this);
 	}
 	list() {
@@ -533,7 +567,7 @@ var FunnelChannels = class {
 //#region lib/engine/claude/claude.ts
 const defaultProcess$2 = new NodeFunnelProcessRunner();
 const defaultFs$3 = new NodeFunnelFileSystem();
-const defaultLogger$4 = new NodeFunnelLogger();
+const defaultIdGenerator = new NodeFunnelIdGenerator();
 /**
 * Launches Claude Code with funnel pre-wired: ensures the gateway is running,
 * installs the funnel MCP into the target repo's `.mcp.json` if missing,
@@ -544,43 +578,45 @@ var FunnelClaude = class {
 	channels;
 	mcp;
 	gateway;
-	sessions;
+	profiles;
 	process;
 	fs;
+	idGenerator;
 	logger;
 	pidDir;
 	constructor(deps) {
 		this.channels = deps.channels;
 		this.mcp = deps.mcp;
 		this.gateway = deps.gateway;
-		this.sessions = deps.sessions;
+		this.profiles = deps.profiles;
 		this.process = deps.process ?? defaultProcess$2;
 		this.fs = deps.fs ?? defaultFs$3;
-		this.logger = deps.logger ?? defaultLogger$4;
+		this.idGenerator = deps.idGenerator ?? defaultIdGenerator;
+		this.logger = deps.logger;
 		this.pidDir = join(deps.dir ?? FUNNEL_DIR, "claude");
 		Object.freeze(this);
 	}
 	async launch(options) {
 		const channel = this.channels.get(options.channel) ?? this.channels.getById(options.channel);
 		if (!channel) throw new Error(`channel "${options.channel}" not found`);
-		if (options.profileName && this.isRunning(options.profileName)) throw new Error(`profile "${options.profileName}" is already running`);
+		if (options.profileId && this.isRunning(options.profileId)) throw new Error(`profile "${options.profileId}" is already running`);
 		const cwd = options.cwd ?? globalThis.process.cwd();
 		if ((options.installMcp ?? true) && !this.mcp.findInstalledName(cwd)) {
 			this.mcp.install(cwd);
-			this.logger.info(`added funnel MCP to .mcp.json`, { cwd });
+			this.logger?.info(`added funnel MCP to .mcp.json`, { cwd });
 		}
 		if (!this.gateway.isRunning()) {
-			this.logger.info(`starting gateway automatically`);
+			this.logger?.info(`starting gateway automatically`);
 			await this.gateway.start();
 		}
-		if (options.profileName) {
-			this.writePidFile(options.profileName);
-			this.installCleanup(options.profileName);
+		if (options.profileId) {
+			this.writePidFile(options.profileId);
+			this.installCleanup(options.profileId);
 		}
-		const session = options.resume ?? true ? this.resolveSession(channel.id, cwd, options.userArgs ?? [], options.env ?? {}) : null;
+		const session = (options.resume ?? false) && options.profileId ? this.resolveSession(options.profileId, cwd, options.userArgs ?? [], options.env ?? {}) : null;
 		const claudeArgs = this.buildArgs(options.options ?? [], options.userArgs ?? [], cwd, session);
 		const env = this.buildEnv(channel.id, options.env ?? {});
-		this.logger.info(`claude launch`, {
+		this.logger?.info(`claude launch`, {
 			channel: options.channel,
 			channelId: channel.id,
 			cwd
@@ -592,19 +628,19 @@ var FunnelClaude = class {
 				onSpawned: options.onSpawned
 			});
 		} finally {
-			if (options.profileName) this.removePidFile(options.profileName);
+			if (options.profileId) this.removePidFile(options.profileId);
 		}
 	}
-	isRunning(profileName) {
-		const pid = this.readPid(profileName);
+	isRunning(profileId) {
+		const pid = this.readPid(profileId);
 		if (!pid) return false;
 		return this.isProcessAlive(pid);
 	}
-	pidPath(profileName) {
-		return join(this.pidDir, `${profileName}.pid`);
+	pidPath(profileId) {
+		return join(this.pidDir, `${profileId}.pid`);
 	}
-	readPid(profileName) {
-		const path = this.pidPath(profileName);
+	readPid(profileId) {
+		const path = this.pidPath(profileId);
 		if (!this.fs.existsSync(path)) return null;
 		try {
 			const content = this.fs.readFileSync(path).trim();
@@ -615,16 +651,16 @@ var FunnelClaude = class {
 			return null;
 		}
 	}
-	writePidFile(profileName) {
+	writePidFile(profileId) {
 		this.fs.mkdirSync(this.pidDir, { recursive: true });
-		this.fs.writeFileSync(this.pidPath(profileName), String(globalThis.process.pid));
+		this.fs.writeFileSync(this.pidPath(profileId), String(globalThis.process.pid));
 	}
-	removePidFile(profileName) {
-		const path = this.pidPath(profileName);
+	removePidFile(profileId) {
+		const path = this.pidPath(profileId);
 		if (this.fs.existsSync(path)) this.fs.unlink(path);
 	}
-	installCleanup(profileName) {
-		globalThis.process.once("exit", () => this.removePidFile(profileName));
+	installCleanup(profileId) {
+		globalThis.process.once("exit", () => this.removePidFile(profileId));
 	}
 	isProcessAlive(pid) {
 		return this.process.isAlive(pid);
@@ -643,26 +679,34 @@ var FunnelClaude = class {
 	* session-shaping flag, since combining them would either confuse claude
 	* or override the explicit user intent.
 	*
+	* The session is owned by the profile (by id), not by cwd: two profiles
+	* pointing at the same repo each keep their own conversation, and a launch
+	* with no profile never resumes — so an unrelated session in the same repo
+	* can't bleed in. The channel never enters into it; sessions belong to the
+	* launch layer (profiles), keeping the transport layer ignorant of them.
+	*
 	* A persisted id is only resumed when its session jsonl still exists on
 	* disk. claude errors out on `--resume <id>` for a missing conversation, and
 	* a persisted id can outlive its jsonl (claude pruned it, or the very first
-	* launch was aborted after `create` wrote the id but before the jsonl
+	* launch was aborted after the id was written but before the jsonl
 	* appeared). When the file is gone we mint a fresh session instead, which
 	* overwrites the dangling entry — so the store self-heals.
 	*/
-	resolveSession(channelId, cwd, userArgs, recipeEnv) {
+	resolveSession(profileId, cwd, userArgs, recipeEnv) {
 		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;
 		}
-		const existing = this.sessions.get(channelId, cwd);
+		const existing = this.profiles.getSessionId(profileId);
 		if (existing !== null && this.sessionFileExists(cwd, existing, recipeEnv)) return {
 			id: existing,
 			mode: "resume"
 		};
+		const fresh = this.idGenerator.generate();
+		this.profiles.setSessionId(profileId, fresh);
 		return {
-			id: this.sessions.create(channelId, cwd),
+			id: fresh,
 			mode: "new"
 		};
 	}
@@ -787,9 +831,9 @@ var MemoryFunnelIdGenerator = class extends FunnelIdGenerator {
 *
 * The launch recipe (`options` / `env` / `resume`) lives on `profiles[]`, not on
 * the channel: a channel only describes where events come from. `fnl claude`
-* applies the first profile bound to the chosen channel (or `--profile <name>`
-* to pick another); the recipe is passed straight to the launcher and is not
-* persisted into the global profile list.
+* applies the first profile bound to the chosen channel; the recipe is passed
+* straight to the launcher and is not persisted into the global profile list.
+* These profiles are selected by their `channel` binding, not by name.
 */
 const slackEnvSchema = z.object({
 	botToken: z.string().optional(),
@@ -831,7 +875,6 @@ const channelSpecSchema = z.object({
 	connectors: z.array(connectorSpecSchema).optional()
 });
 const profileSpecSchema = z.object({
-	name: z.string(),
 	/** Name of the channel (declared in `channels[]`) this profile subscribes to. */
 	channel: z.string(),
 	/** Args prepended to the claude argv on every launch through this profile. */
@@ -924,8 +967,20 @@ var FunnelLocalConfig = class {
 		})();
 		const result = localConfigSchema.safeParse(parsed);
 		if (!result.success) throw new Error(`${LOCAL_CONFIG_FILENAME} is invalid: ${result.error.message}`);
+		this.assertProfilesValid(result.data);
 		return result.data;
 	}
+	assertProfilesValid(config) {
+		const profiles = config.profiles ?? [];
+		if (profiles.length === 0) return;
+		const channelNames = new Set(config.channels.map((channel) => channel.name));
+		const boundChannels = /* @__PURE__ */ new Set();
+		for (const profile of profiles) {
+			if (!channelNames.has(profile.channel)) throw new Error(`${LOCAL_CONFIG_FILENAME} is invalid: a profile binds channel "${profile.channel}", which is not declared in channels[]`);
+			if (boundChannels.has(profile.channel)) throw new Error(`${LOCAL_CONFIG_FILENAME} is invalid: channel "${profile.channel}" has more than one profile; only the first is applied — remove the extras`);
+			boundChannels.add(profile.channel);
+		}
+	}
 };
 //#endregion
 //#region lib/engine/token-prompter/token-prompter.ts
@@ -1414,16 +1469,22 @@ var MemoryFunnelProcessRunner = class extends FunnelProcessRunner {
 * process, `resume` toggling session reuse). Implements ProfileChannelChecker
 * so FunnelChannels can refuse to remove a channel that is still referenced.
 *
-* The first entry in the persisted array is treated as the default profile;
-* `asDefault` reorders the array to put a named profile first.
+* Each profile has a stable `id` (uuid) minted at `add`. That id is the unit
+* everything internal keys on — the PID file, the resumable session id — so a
+* rename never strands either. `name` is purely the CLI/TUI handle; the CRUD
+* methods here take it because that is what the user types, but resolve to the
+* id before touching id-keyed state. The first array entry is the default
+* profile; `asDefault` reorders to put one first.
 *
 * `channelId` always stores the channel's stable id (uuid). CLI surfaces
 * resolve channel name → id before calling `add`/`update` here.
 */
 var FunnelProfiles = class {
 	store;
+	idGenerator;
 	constructor(deps) {
 		this.store = deps.store;
+		this.idGenerator = deps.idGenerator;
 		Object.freeze(this);
 	}
 	list() {
@@ -1432,6 +1493,9 @@ var FunnelProfiles = class {
 	get(name) {
 		return this.list().find((p) => p.name === name) ?? null;
 	}
+	getById(id) {
+		return this.list().find((p) => p.id === id) ?? null;
+	}
 	getDefault() {
 		return this.list()[0] ?? null;
 	}
@@ -1440,6 +1504,7 @@ var FunnelProfiles = class {
 		if (settings.profiles.some((p) => p.name === input.name)) throw new Error(`profile "${input.name}" already exists`);
 		if (!settings.channels.some((c) => c.id === input.channelId)) throw new Error(`channel id "${input.channelId}" not found`);
 		settings.profiles.push({
+			id: this.idGenerator.generate(),
 			name: input.name,
 			path: input.path,
 			channelId: input.channelId,
@@ -1477,6 +1542,18 @@ var FunnelProfiles = class {
 	hasChannelRef(channelId) {
 		return this.store.read().profiles.some((p) => p.channelId === channelId);
 	}
+	/** Resumable claude session id last launched by this profile (by id), or null. */
+	getSessionId(id) {
+		return this.getById(id)?.sessionId ?? null;
+	}
+	/** Records the claude session id this profile launched, overwriting any prior one. */
+	setSessionId(id, sessionId) {
+		const settings = this.store.read();
+		const profile = settings.profiles.find((p) => p.id === id);
+		if (!profile) throw new Error(`profile id "${id}" not found`);
+		profile.sessionId = sessionId;
+		this.store.write(settings);
+	}
 	update(name, fields) {
 		const settings = this.store.read();
 		const profile = settings.profiles.find((p) => p.name === name);
@@ -1493,84 +1570,6 @@ var FunnelProfiles = class {
 	}
 };
 //#endregion
-//#region lib/engine/sessions/sessions.ts
-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 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
-* `{ cwd: uuid }` map; the channel directory itself is created lazily.
-*/
-var FunnelSessions = class {
-	fs;
-	idGenerator;
-	dir;
-	constructor(deps) {
-		this.fs = deps.fs;
-		this.idGenerator = deps.idGenerator;
-		this.dir = deps.dir;
-		Object.freeze(this);
-	}
-	/** 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 sessionId = this.idGenerator.generate();
-		map[cwd] = sessionId;
-		this.writeMap(channelId, map);
-		return sessionId;
-	}
-	/** Drops the recorded session id for (channelId, cwd). No-op if absent. */
-	clear(channelId, cwd) {
-		const map = this.readMap(channelId);
-		if (!(cwd in map)) return;
-		delete map[cwd];
-		this.writeMap(channelId, map);
-	}
-	/** Drops the whole session map for the channel (e.g. when the channel is deleted). */
-	clearAll(channelId) {
-		const path = this.pathFor(channelId);
-		if (this.fs.existsSync(path)) this.fs.unlink(path);
-	}
-	readMap(channelId) {
-		const path = this.pathFor(channelId);
-		if (!this.fs.existsSync(path)) return {};
-		const raw = this.fs.readFileSync(path);
-		try {
-			const parsed = sessionsMapSchema.safeParse(JSON.parse(raw));
-			return parsed.success ? parsed.data : {};
-		} catch {
-			return {};
-		}
-	}
-	writeMap(channelId, map) {
-		const path = this.pathFor(channelId);
-		const channelDir = this.channelDir(channelId);
-		if (!this.fs.existsSync(channelDir)) this.fs.mkdirSync(channelDir, { recursive: true });
-		this.fs.writeFileSync(path, `${JSON.stringify(map, null, 2)}\n`);
-	}
-	channelDir(channelId) {
-		return join(this.dir, "channels", channelId);
-	}
-	pathFor(channelId) {
-		return join(this.channelDir(channelId), "sessions.json");
-	}
-};
-//#endregion
 //#region lib/engine/token-prompter/node-token-prompter.ts
 const STAR = "*";
 const CR = "\r";
@@ -1659,6 +1658,18 @@ var MockFunnelSettingsReader = class extends FunnelSettingsReader {
 	}
 };
 //#endregion
+//#region lib/engine/settings/tmp-dir.ts
+/**
+* Resolves the funnel temp/log root for the current OS. Defaults to
+* `<os.tmpdir()>/funnel` so Windows lands under `%TEMP%\funnel` and POSIX
+* lands under `/tmp/funnel`. Callers may override via `FUNNEL_TMP_DIR`.
+*/
+function funnelTmpDir() {
+	const override = process.env.FUNNEL_TMP_DIR;
+	if (override && override.length > 0) return override;
+	return join(tmpdir(), "funnel");
+}
+//#endregion
 //#region lib/engine/time/memory-clock.ts
 var MemoryFunnelClock = class extends FunnelClock {
 	current;
@@ -1760,8 +1771,9 @@ var FunnelChannelPublisher = class {
 *  3. bundled: when this helper is inlined into dist/bin.js, the helper's dir is dist/,
 *     and daemon.js lives at dist/gateway/daemon.js
 *
-* `import.meta.url` works in both Bun and Node test runners; `import.meta.dir`
-* is Bun-only and breaks vitest.
+* Uses `fileURLToPath(import.meta.url)` rather than `import.meta.dir` so the
+* same helper resolves correctly whether run from source, the built sibling,
+* or inlined into the bundle.
 */
 const resolveDaemonScript = () => {
 	const here = dirname(fileURLToPath(import.meta.url));
@@ -1960,14 +1972,6 @@ const constantTimeEqual = (a, b) => {
 //#region lib/gateway/factory.ts
 const factory$1 = createFactory();
 //#endregion
-//#region lib/engine/logger/noop-logger.ts
-var NoopFunnelLogger = class extends FunnelLogger {
-	file = null;
-	info() {}
-	warn() {}
-	error() {}
-};
-//#endregion
 //#region lib/gateway/broadcaster.ts
 const byteLengthOf = (event) => {
 	let bytes = Buffer.byteLength(event.content, "utf-8");
@@ -1977,7 +1981,6 @@ const byteLengthOf = (event) => {
 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.
@@ -1994,8 +1997,7 @@ const defaultOnError$2 = () => {};
 * `replayBufferSize` events are kept in memory; reconnecting WS clients can
 * pass `?since=<offset>` and the broadcaster resends matching events before
 * resuming the live stream. The in-memory ring covers short reconnects;
-* older history is served from the SQLite event store wired in as
-* `persistentReplay`.
+* older history is served from the event log wired in as `persistentReplay`.
 */
 var FunnelBroadcaster = class {
 	clients = /* @__PURE__ */ new Map();
@@ -2015,7 +2017,7 @@ var FunnelBroadcaster = class {
 	lastBroadcastAt = null;
 	latestOffset = 0;
 	constructor(deps = {}) {
-		this.logger = deps.logger ?? defaultLogger$3;
+		this.logger = deps.logger;
 		this.onError = deps.onError ?? defaultOnError$2;
 		this.maxBufferedBytes = deps.maxBufferedBytes ?? DEFAULT_MAX_BUFFERED_BYTES;
 		this.now = deps.now ?? (() => Date.now());
@@ -2041,8 +2043,8 @@ var FunnelBroadcaster = class {
 	* Two-tier lookup:
 	*   1. The in-memory ring buffer (covers short reconnects, last `replayBufferSize` events).
 	*   2. If `since` predates the oldest in-memory entry and a persistent replay source
-	*      is wired in (SQLite), the gap is filled from disk. This covers reconnects across
-	*      daemon restarts where the in-memory buffer was lost.
+	*      is wired in (SQLite by default), the gap is filled from it. This covers reconnects
+	*      across daemon restarts where the in-memory buffer was lost.
 	*
 	* Result is sorted ascending by offset and de-duplicated against the in-memory buffer.
 	*/
@@ -2138,7 +2140,7 @@ var FunnelBroadcaster = class {
 			const buffered = ws.getBufferedAmount();
 			if (buffered > this.maxBufferedBytes) {
 				const data = this.clients.get(ws);
-				this.logger.warn("dropping slow WS client (backpressure)", {
+				this.logger?.warn("dropping slow WS client (backpressure)", {
 					channel: data?.channel,
 					buffered,
 					max: this.maxBufferedBytes
@@ -2156,7 +2158,7 @@ var FunnelBroadcaster = class {
 			handler(event);
 		} catch (error) {
 			const err = error instanceof Error ? error : new Error(String(error));
-			this.logger.error("broadcast subscriber threw", { error: err.message });
+			this.logger?.error("broadcast subscriber threw", { error: err.message });
 			this.onError(err, {
 				component: "broadcaster.subscriber",
 				offset: event.offset,
@@ -2172,6 +2174,37 @@ var FunnelBroadcaster = class {
 	}
 };
 //#endregion
+//#region lib/gateway/funnel-event-log.ts
+/**
+* Replayable event payload persisted by the gateway. Domain events the
+* broadcaster emits to WS clients land here so reconnects across daemon
+* restarts can be served from disk. System events (gateway start, channel
+* connected, etc.) are routed to `FunnelLogger` instead — they never go
+* through this log, which keeps the offset space clean for replay.
+*/
+const funnelEventSchema = z.object({
+	type: z.string(),
+	content: z.string(),
+	channel_id: z.string().nullable(),
+	connector_id: z.string().nullable(),
+	meta: z.record(z.string(), z.string()).nullable()
+});
+/**
+* Durable, append-only log of broadcaster events keyed by the offset the
+* broadcaster assigns. The gateway persists every domain event here, and
+* across restarts it both seeds the broadcaster's offset counter
+* (`findMaxOffset`) and serves reconnect replay (`loadSince`) from it.
+*
+* `loadSince` is the only method the broadcaster itself needs, which makes
+* any implementation assignable to the broadcaster's narrow `ReplaySource`.
+*
+* Implementations:
+*   - `SqliteFunnelEventLog` — the default; durable across daemon restarts.
+*   - `MemoryFunnelEventLog` — an in-process double for tests and embedders
+*     that do not need durability (replay is lost when the process exits).
+*/
+var FunnelEventLog = class {};
+//#endregion
 //#region lib/logger/leuco-logger-sqlite-sink.ts
 /** Conservative whitelist for column names interpolated into SQL. */
 const COLUMN_NAME_RE = /^[a-z_][a-z0-9_]*$/;
@@ -2414,24 +2447,10 @@ function toRecord(row) {
 	};
 }
 //#endregion
-//#region lib/gateway/funnel-event-store.ts
+//#region lib/gateway/sqlite-funnel-event-log.ts
 const MAX_CONTENT_CHARS = 2e3;
 /**
-* Replayable event payload persisted by the gateway. Domain events the
-* broadcaster emits to WS clients land here so reconnects across daemon
-* restarts can be served from disk. System events (gateway start, channel
-* connected, etc.) are routed to `FunnelLogger` instead — they never go
-* through this store, which keeps the seq space clean for replay.
-*/
-const funnelEventSchema = z.object({
-	type: z.string(),
-	content: z.string(),
-	channel_id: z.string().nullable(),
-	connector_id: z.string().nullable(),
-	meta: z.record(z.string(), z.string()).nullable()
-});
-/**
-* SQLite-backed event store. One indexed table holds every broadcaster
+* SQLite-backed `FunnelEventLog`. One indexed table holds every broadcaster
 * event with `channel_id` and `connector_id` as dedicated columns, so
 * per-channel and per-connector replay is an indexed range scan.
 *
@@ -2447,10 +2466,11 @@ const funnelEventSchema = z.object({
 * broadcaster traffic. This is what makes the broadcaster's seq seeding
 * (`getMaxSeq()` at startup) correct without per-event coordination.
 */
-var FunnelEventStore = class {
+var SqliteFunnelEventLog = class extends FunnelEventLog {
 	sink;
 	now;
 	constructor(props) {
+		super();
 		this.now = props.now ?? (() => Date.now());
 		this.sink = new LeucoLoggerSqliteSink({
 			path: props.path,
@@ -2469,16 +2489,16 @@ var FunnelEventStore = class {
 	* (the gateway-server) supplies the offset from `broadcaster.broadcast()`
 	* so this store and the broadcaster's in-memory ring stay aligned.
 	*/
-	record(props) {
+	record(record) {
 		const event = {
-			type: props.meta?.event_type ?? "unknown",
-			content: truncate$1(props.content),
-			channel_id: props.channelId,
-			connector_id: props.connectorId,
-			meta: props.meta
+			type: record.meta?.event_type ?? "unknown",
+			content: truncate$1(record.content),
+			channel_id: record.channelId,
+			connector_id: record.connectorId,
+			meta: record.meta
 		};
 		this.sink.write({
-			seq: props.offset,
+			seq: record.offset,
 			ts: this.now(),
 			event
 		});
@@ -2532,7 +2552,6 @@ 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;
@@ -2568,7 +2587,7 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 	constructor(deps) {
 		this.channels = deps.channels;
 		this.notify = deps.notify;
-		this.logger = deps.logger ?? defaultLogger$2;
+		this.logger = deps.logger;
 		this.onError = deps.onError ?? defaultOnError$1;
 		this.healthCheckIntervalMs = deps.healthCheckIntervalMs ?? DEFAULT_HEALTH_INTERVAL_MS;
 		this.maxBackoffMs = deps.maxBackoffMs ?? DEFAULT_MAX_BACKOFF_MS;
@@ -2626,14 +2645,14 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 				listener: created.listener
 			});
 			this.ensureStats(key);
-			this.logger.info(`${created.config.type} listener started`, {
+			this.logger?.info(`${created.config.type} listener started`, {
 				channel: channelName,
 				connector: connectorName
 			});
 			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`, {
+			this.logger?.error(`${created.config.type} listener failed to start`, {
 				channel: channelName,
 				connector: connectorName,
 				error: err.message
@@ -2661,14 +2680,14 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 			await entry.listener.stop();
 			this.running.delete(key);
 			this.failureCounts.delete(key);
-			this.logger.info(`${entry.config.type} listener stopped`, {
+			this.logger?.info(`${entry.config.type} listener stopped`, {
 				channel: channelName,
 				connector: connectorName
 			});
 			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`, {
+			this.logger?.error(`${entry.config.type} listener failed to stop`, {
 				channel: channelName,
 				connector: connectorName,
 				error: err.message
@@ -2750,7 +2769,7 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 		const key = FunnelListenerSupervisor.keyOf(channelName, connectorName);
 		const failureCount = this.failureCounts.get(key) ?? 0;
 		const backoffMs = Math.min(1e3 * 2 ** failureCount, this.maxBackoffMs);
-		this.logger.warn(`${type} listener unhealthy, restarting`, {
+		this.logger?.warn(`${type} listener unhealthy, restarting`, {
 			channel: channelName,
 			connector: connectorName,
 			attempt: failureCount + 1,
@@ -2760,7 +2779,7 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 		await this.sleep(backoffMs);
 		if ((await this.start(channelName, connectorName)).ok) {
 			this.failureCounts.delete(key);
-			this.logger.info(`${type} listener recovered`, {
+			this.logger?.info(`${type} listener recovered`, {
 				channel: channelName,
 				connector: connectorName
 			});
@@ -2770,7 +2789,6 @@ var FunnelListenerSupervisor = class FunnelListenerSupervisor {
 //#endregion
 //#region lib/gateway/kill-competing-slack-gateways.ts
 const defaultProcess = new NodeFunnelProcessRunner();
-const defaultLogger$1 = new NodeFunnelLogger();
 const titleFor = (dir) => `funnel-gateway[${dir}]`;
 /**
 * Kills other funnel daemon processes that share the SAME funnel home dir,
@@ -2784,7 +2802,7 @@ const titleFor = (dir) => `funnel-gateway[${dir}]`;
 */
 const killCompetingSlackGateways = async (props) => {
 	const runner = props.process ?? defaultProcess;
-	const logger = props.logger ?? defaultLogger$1;
+	const logger = props.logger;
 	const expectedTitle = titleFor(props.dir);
 	const snapshots = runner.listProcessesContaining(expectedTitle);
 	const killed = [];
@@ -2792,7 +2810,7 @@ const killCompetingSlackGateways = async (props) => {
 		if (snapshot.pid === props.selfPid) continue;
 		runner.kill(snapshot.pid, "SIGTERM");
 		killed.push(snapshot.pid);
-		logger.info("killed competing Slack gateway process", {
+		logger?.info("killed competing Slack gateway process", {
 			pid: snapshot.pid,
 			args: snapshot.command.slice(0, 160)
 		});
@@ -2854,7 +2872,7 @@ const channelsConnectorsCallHandler = factory$1.createHandlers(zParam(z.object({
 * POST /channels/:channel/publish
 *
 * Inject arbitrary content into a channel. Mirrors the connector-driven `notify`
-* path: events go through `broadcaster.broadcast` + `eventStore.record`, so
+* path: events go through `broadcaster.broadcast` + `eventLog.record`, so
 * subscribers see them exactly as if a listener had produced them.
 *
 * Body validation is Zod-shared with the client (`publishRequestSchema`); the
@@ -2961,12 +2979,11 @@ const gatewayRoutes = factory$1.createApp().get("/health", ...healthHandler).get
 //#region lib/gateway/gateway-server.ts
 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
-* `FunnelBroadcaster`, and persists them via `FunnelEventStore` (SQLite).
+* `FunnelBroadcaster`, and persists them via a `FunnelEventLog` (SQLite by default).
 * System events (gateway lifecycle, connect/disconnect) flow to `FunnelLogger`
 * instead — keeping the SQLite seq space exclusive to broadcaster traffic so
 * the broadcaster's offset counter and `getMaxSeq()` stay aligned without
@@ -2986,7 +3003,7 @@ var FunnelGatewayServer = class {
 	killCompetingSlack;
 	token;
 	broadcaster;
-	eventStore;
+	eventLog;
 	supervisor;
 	nowMs;
 	extraRoutes;
@@ -2998,7 +3015,7 @@ var FunnelGatewayServer = class {
 		this.port = deps.port ?? DEFAULT_PORT;
 		this.dbPath = deps.dbPath ?? defaultDbPath();
 		this.process = deps.process;
-		this.logger = deps.logger ?? defaultLogger;
+		this.logger = deps.logger;
 		this.onError = deps.onError ?? defaultOnError;
 		this.selfPid = deps.selfPid ?? globalThis.process.pid;
 		this.dir = deps.dir ?? FUNNEL_DIR;
@@ -3007,19 +3024,22 @@ var FunnelGatewayServer = class {
 		this.extraRoutes = deps.extraRoutes ?? null;
 		const clock = deps.clock;
 		this.nowMs = clock ? () => clock.millis() : () => Date.now();
-		const dbDir = dirname(this.dbPath);
-		if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
-		this.eventStore = new FunnelEventStore({
-			path: this.dbPath,
-			now: this.nowMs
-		});
+		if (deps.eventLog) this.eventLog = deps.eventLog;
+		else {
+			const dbDir = dirname(this.dbPath);
+			if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
+			this.eventLog = new SqliteFunnelEventLog({
+				path: this.dbPath,
+				now: this.nowMs
+			});
+		}
 		this.broadcaster = new FunnelBroadcaster({
 			logger: this.logger,
 			onError: this.onError,
 			now: this.nowMs,
-			persistentReplay: this.eventStore
+			persistentReplay: this.eventLog
 		});
-		this.broadcaster.seedLatestOffset(this.eventStore.findMaxOffset());
+		this.broadcaster.seedLatestOffset(this.eventLog.findMaxOffset());
 		this.supervisor = new FunnelListenerSupervisor({
 			channels: this.channels,
 			logger: this.logger,
@@ -3072,8 +3092,18 @@ var FunnelGatewayServer = class {
 	getSupervisor() {
 		return this.supervisor;
 	}
-	getEventStore() {
-		return this.eventStore;
+	getEventLog() {
+		return this.eventLog;
+	}
+	/**
+	* Register an in-process observer for every broadcast event. Fires after
+	* the event is fanned out to WS clients and recorded in the event log.
+	* Returns an unsubscribe function. Only meaningful in-process (embedded
+	* hosts / `new Funnel(...)` running their own gateway-server); a separate
+	* daemon process cannot be observed this way — use a WS client for that.
+	*/
+	onEvent(handler) {
+		return this.broadcaster.subscribe(handler);
 	}
 	handleFetch(request, server, app) {
 		const url = new URL(request.url);
@@ -3116,8 +3146,8 @@ var FunnelGatewayServer = class {
 				connectors: ws.data.connectors.join(","),
 				total: String(this.broadcaster.getClientCount())
 			};
-			this.logger.info("channel connected", meta);
-		} else this.logger.info("tap-all client connected", {
+			this.logger?.info("channel connected", meta);
+		} else this.logger?.info("tap-all client connected", {
 			event_type: "system",
 			action: "tap_connect",
 			total: String(this.broadcaster.getClientCount())
@@ -3125,27 +3155,27 @@ var FunnelGatewayServer = class {
 	}
 	handleWsClose(ws) {
 		this.broadcaster.removeClient(ws);
-		if (ws.data.channelName) this.logger.info("channel disconnected", {
+		if (ws.data.channelName) this.logger?.info("channel disconnected", {
 			event_type: "system",
 			action: "channel_disconnect",
 			channel: ws.data.channelName,
 			channelId: ws.data.channel,
 			total: String(this.broadcaster.getClientCount())
 		});
-		else this.logger.info("tap-all client disconnected", {
+		else this.logger?.info("tap-all client disconnected", {
 			event_type: "system",
 			action: "tap_disconnect",
 			total: String(this.broadcaster.getClientCount())
 		});
 	}
 	logServerStarted() {
-		this.logger.info("gateway started", {
+		this.logger?.info("gateway started", {
 			event_type: "system",
 			action: "gateway_start",
 			port: String(this.port),
 			pid: String(this.selfPid)
 		});
-		this.logger.info("funnel gateway listening", {
+		this.logger?.info("funnel gateway listening", {
 			url: `http://localhost:${this.port}`,
 			websocket: `ws://localhost:${this.port}/ws`,
 			health: `http://localhost:${this.port}/health`
@@ -3203,21 +3233,21 @@ var FunnelGatewayServer = class {
 				process: this.process,
 				logger: this.logger
 			});
-			if (killed.length > 0) this.logger.info("killed competing Slack gateway processes", {
+			if (killed.length > 0) this.logger?.info("killed competing Slack gateway processes", {
 				event_type: "system",
 				action: "kill_competing",
 				pids: killed.join(",")
 			});
 		}
 		await this.supervisor.startAll();
-		for (const entry of this.supervisor.list()) this.logger.info(`${entry.type} listener started: ${entry.name}`, {
+		for (const entry of this.supervisor.list()) this.logger?.info(`${entry.type} listener started: ${entry.name}`, {
 			event_type: "system",
 			action: `${entry.type}_connect`,
 			channel: entry.channelName,
 			connector: entry.name
 		});
-		this.logger.info(`event store: ${this.dbPath}`);
-		this.logger.info("funnel gateway running");
+		this.logger?.info(`event store: ${this.dbPath}`);
+		this.logger?.info("funnel gateway running");
 	}
 	/**
 	* Broadcast `content` to subscribers of `channel`, persisting the event in
@@ -3237,7 +3267,7 @@ var FunnelGatewayServer = class {
 		if (channelId) enriched.channelId = channelId;
 		if (connectorId) enriched.connectorId = connectorId;
 		const event = this.broadcaster.broadcast(input.content, enriched);
-		this.eventStore.record({
+		this.eventLog.record({
 			content: input.content,
 			channelId: channelId ?? null,
 			connectorId: connectorId ?? null,
@@ -3467,10 +3497,9 @@ var Funnel = class Funnel {
 		if (!this.memos.process) this.memos.process = this.props.process ?? new NodeFunnelProcessRunner();
 		return this.memos.process;
 	}
-	/** Logger boundary. Defaults to NodeFunnelLogger. */
+	/** Logger boundary. Optional — when no logger is injected, every facet's `this.logger?.x` call is a silent no-op. Production entry points (cli, daemon) inject a NodeFunnelLogger. */
 	get logger() {
-		if (!this.memos.logger) this.memos.logger = this.props.logger ?? new NodeFunnelLogger();
-		return this.memos.logger;
+		return this.props.logger;
 	}
 	/** Clock boundary. Defaults to NodeFunnelClock. */
 	get clock() {
@@ -3493,7 +3522,8 @@ var Funnel = class Funnel {
 	get store() {
 		if (!this.memos.store) this.memos.store = this.props.store ?? new FunnelSettingsStore({
 			path: this.paths.settings,
-			fs: this.fs
+			fs: this.fs,
+			idGenerator: this.idGenerator
 		});
 		return this.memos.store;
 	}
@@ -3522,17 +3552,11 @@ var Funnel = class Funnel {
 	}
 	/** Launch profiles (named presets for `fnl claude`: path + sub-agent + channel id). */
 	get profiles() {
-		if (!this.memos.profiles) this.memos.profiles = new FunnelProfiles({ store: this.store });
-		return this.memos.profiles;
-	}
-	/** Per-(channel, cwd) claude session-id store. Backs `--session-id` injection on launch. */
-	get sessions() {
-		if (!this.memos.sessions) this.memos.sessions = new FunnelSessions({
-			fs: this.fs,
-			idGenerator: this.idGenerator,
-			dir: this.paths.dir
+		if (!this.memos.profiles) this.memos.profiles = new FunnelProfiles({
+			store: this.store,
+			idGenerator: this.idGenerator
 		});
-		return this.memos.sessions;
+		return this.memos.profiles;
 	}
 	/** Reads `funnel.json` from a cwd. `fnl claude` consults it before falling back to the default profile. */
 	get localConfig() {
@@ -3569,9 +3593,10 @@ var Funnel = class Funnel {
 			channels: this.channels,
 			mcp: this.mcp,
 			gateway: this.gateway,
-			sessions: this.sessions,
+			profiles: this.profiles,
 			fs: this.fs,
 			process: this.process,
+			idGenerator: this.idGenerator,
 			logger: this.logger,
 			dir: this.paths.dir
 		});
@@ -3641,6 +3666,7 @@ var Funnel = class Funnel {
 			settings: this.store,
 			port: options.port,
 			dbPath: options.dbPath,
+			eventLog: options.eventLog,
 			process: this.process,
 			clock: this.clock,
 			logger: this.logger,
@@ -3850,6 +3876,46 @@ const funnelJsonSchema = () => {
 	};
 };
 //#endregion
+//#region lib/engine/logger/node-logger.ts
+const defaultLogFile = () => join(funnelTmpDir(), "funnel.log");
+var NodeFunnelLogger = class extends FunnelLogger {
+	file;
+	now;
+	constructor(props = {}) {
+		super();
+		this.file = props.file ?? defaultLogFile();
+		this.now = props.now ?? (() => /* @__PURE__ */ new Date());
+		Object.freeze(this);
+	}
+	info(message, meta) {
+		this.write("info", message, meta);
+	}
+	warn(message, meta) {
+		this.write("warn", message, meta);
+	}
+	error(message, meta) {
+		this.write("error", message, meta);
+	}
+	write(level, message, meta) {
+		mkdirSync(dirname(this.file), { recursive: true });
+		const entry = {
+			time: this.now().toISOString(),
+			level,
+			message,
+			...meta ? { meta } : {}
+		};
+		appendFileSync(this.file, `${JSON.stringify(entry)}\n`);
+	}
+};
+//#endregion
+//#region lib/engine/logger/noop-logger.ts
+var NoopFunnelLogger = class extends FunnelLogger {
+	file = null;
+	info() {}
+	warn() {}
+	error() {}
+};
+//#endregion
 //#region lib/engine/token-prompter/memory-token-prompter.ts
 /**
 * Pre-seeded answers keyed by prompt label. Tests configure the map up front;
@@ -3870,6 +3936,46 @@ var MemoryFunnelTokenPrompter = class extends FunnelTokenPrompter {
 	}
 };
 //#endregion
+//#region lib/gateway/memory-funnel-event-log.ts
+/**
+* In-process `FunnelEventLog` backed by a plain array. Used by tests and by
+* embedders that do not need durability — replay works within the process
+* lifetime but is lost when the process exits. Unlike the SQLite log it does
+* not truncate content or prune, so it is not meant for unbounded production
+* traffic.
+*/
+var MemoryFunnelEventLog = class extends FunnelEventLog {
+	events = [];
+	constructor() {
+		super();
+		Object.freeze(this);
+	}
+	record(record) {
+		this.events.push({
+			offset: record.offset,
+			content: record.content,
+			meta: record.meta ?? void 0,
+			channelId: record.channelId,
+			connectorId: record.connectorId
+		});
+	}
+	loadSince(since) {
+		const out = [];
+		for (const event of this.events) if (event.offset > since) out.push({
+			content: event.content,
+			meta: event.meta,
+			offset: event.offset
+		});
+		return out;
+	}
+	findMaxOffset() {
+		let max = 0;
+		for (const event of this.events) if (event.offset > max) max = event.offset;
+		return max;
+	}
+	close() {}
+};
+//#endregion
 //#region lib/cli/factory.ts
 const factory = createFactory();
 //#endregion
@@ -4407,7 +4513,10 @@ const claudeHandler = factory.createHandlers(zValidator$1("query", z.object({
 			channel: profile.channelId,
 			cwd: profile.path,
 			userArgs,
-			profileName: profile.name
+			profileId: profile.id,
+			options: profile.options,
+			env: profile.env,
+			resume: profile.resume
 		});
 		process.exit(exitCode);
 	}
@@ -4433,7 +4542,10 @@ const claudeHandler = factory.createHandlers(zValidator$1("query", z.object({
 		channel: defaultProfile.channelId,
 		cwd: defaultProfile.path,
 		userArgs,
-		profileName: defaultProfile.name
+		profileId: defaultProfile.id,
+		options: defaultProfile.options,
+		env: defaultProfile.env,
+		resume: defaultProfile.resume
 	});
 	process.exit(exitCode);
 });
@@ -4778,7 +4890,7 @@ const profilesLaunchHandler = factory.createHandlers(zValidator$1("param", z.obj
 		channel: profile.channelId,
 		cwd: profile.path,
 		userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-		profileName: profile.name,
+		profileId: profile.id,
 		options: profile.options,
 		env: profile.env,
 		resume: profile.resume
@@ -6319,7 +6431,7 @@ function ChannelsView(props) {
 				if (next && next !== channel.name) props.funnel.channels.rename(channel.name, next);
 			}
 		} catch (error) {
-			props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+			props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 		}
 		props.setFocusedKey(null);
 		props.refresh();
@@ -6328,7 +6440,7 @@ function ChannelsView(props) {
 		try {
 			props.funnel.channels.remove(name);
 		} catch (error) {
-			props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+			props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 		}
 		props.setFocusedKey(null);
 		props.refresh();
@@ -6339,7 +6451,7 @@ function ChannelsView(props) {
 			const created = props.funnel.channels.add({ name });
 			props.setFocusedKey(fieldKey$1(created.name, "name"));
 		} catch (error) {
-			props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+			props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 		}
 		props.refresh();
 	};
@@ -6400,7 +6512,7 @@ function ConnectorsView(props) {
 	const connectors = props.snapshot.connectors;
 	const targetChannel = props.snapshot.channels[0] ?? null;
 	const logError = (error) => {
-		props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+		props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 	};
 	const removeConnector = (connector) => {
 		props.funnel.listeners.stop(connector.channelName, connector.name).catch(logError);
@@ -6812,7 +6924,7 @@ function ProfilesView(props) {
 				if (next) props.funnel.profiles.update(profile.name, { path: next });
 			}
 		} catch (error) {
-			props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+			props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 		}
 		props.setFocusedKey(null);
 		props.refresh();
@@ -6821,7 +6933,7 @@ function ProfilesView(props) {
 		try {
 			props.funnel.profiles.remove(name);
 		} catch (error) {
-			props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+			props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 		}
 		props.setFocusedKey(null);
 		props.refresh();
@@ -6837,7 +6949,7 @@ function ProfilesView(props) {
 			});
 			props.setFocusedKey(fieldKey(name, "name"));
 		} catch (error) {
-			props.funnel.logger.error(error instanceof Error ? error.message : String(error));
+			props.funnel.logger?.error(error instanceof Error ? error.message : String(error));
 		}
 		props.refresh();
 	};
@@ -6991,7 +7103,10 @@ function App(props) {
 			await props.funnel.claude.launch({
 				channel: profile.channelId,
 				cwd: profile.path,
-				profileName: profile.name
+				profileId: profile.id,
+				options: profile.options,
+				env: profile.env,
+				resume: profile.resume
 			});
 		} catch (error) {
 			process.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\n`);
@@ -7180,4 +7295,4 @@ async function launchTui(funnel) {
 	});
 }
 //#endregion
-export { DEFAULT_GATEWAY_TOKEN_PATH, FUNNEL_DIR, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, FunnelDotenvReader, FunnelEventStore, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSessions, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, LOCAL_CONFIG_FILENAME, LOCAL_ENV_FILENAME, MemoryFunnelClock, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, SETTINGS_PATH, SETTINGS_VERSION, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, app as cliApp, connectorConfigSchema, connectorSpecSchema, createCliApp, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, launchTui, localConfigSchema, profileConfigSchema, profileSpecSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };
+export { DEFAULT_GATEWAY_TOKEN_PATH, FUNNEL_DIR, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, FunnelDotenvReader, FunnelEventLog, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, LOCAL_CONFIG_FILENAME, LOCAL_ENV_FILENAME, MemoryFunnelClock, MemoryFunnelEventLog, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, SETTINGS_PATH, SETTINGS_VERSION, SqliteFunnelEventLog, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, app as cliApp, connectorConfigSchema, connectorSpecSchema, createCliApp, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, launchTui, localConfigSchema, profileConfigSchema, profileSpecSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };