@interactive-inc/claude-funnel 0.41.0 → 0.49.0

package/dist/index.d.ts

@@ -69,7 +69,7 @@ type SlackListenerOptions = {
 type ScheduleListenerOptions = {
   onFired?: ScheduleOnFired;
 };
-type Deps$15 = {
+type Deps$13 = {
   fs?: FunnelFileSystem;
   process?: FunnelProcessRunner;
   logger?: FunnelLogger;
@@ -98,7 +98,7 @@ declare class FunnelConnectorFactory {
   private readonly dir;
   private readonly slackListenerOptions;
   private readonly scheduleListenerOptions;
-  constructor(deps?: Deps$15);
+  constructor(deps?: Deps$13);
   createListener(channelId: string, config: ConnectorConfig): FunnelConnectorListener;
   createAdapter(config: ConnectorConfig): FunnelConnectorAdapter | null;
   connectorDir(channelId: string, connectorId: string): string;
@@ -290,10 +290,10 @@ declare abstract class FunnelSettingsReader {
 }
 //#endregion
 //#region lib/engine/channels/channels.d.ts
-type Deps$14 = {
+type Deps$12 = {
   store: FunnelSettingsReader;
   factory: FunnelConnectorFactory;
-  profileChecker: ProfileChannelChecker;
+  profileChecker?: ProfileChannelChecker;
   clock?: FunnelClock;
   idGenerator?: FunnelIdGenerator;
 };
@@ -337,7 +337,7 @@ declare class FunnelChannels {
   private readonly profileChecker;
   private readonly clock;
   private readonly idGenerator;
-  constructor(deps: Deps$14);
+  constructor(deps: Deps$12);
   list(): ChannelConfig[];
   get(name: string): ChannelConfig | null;
   getById(id: string): ChannelConfig | null;
@@ -403,9 +403,8 @@ type OnFunnelError = (error: Error, context?: Record<string, unknown>) => void;
 //#region lib/gateway/broadcaster.d.ts
 type ClientData = {
   /** Stable channel id (uuid) that the WS client subscribed to. */channel: string; /** Human-facing channel name resolved at upgrade time, kept for log readability. */
-  channelName?: string | null; /** Connector names belonging to that channel; used by tap-all replay filtering. */
-  connectors: string[];
-  tapAll?: boolean; /** Routing mode resolved from channel config at upgrade time. Defaults to fanout. */
+  channelName?: string | null; /** Connector names belonging to that channel. */
+  connectors: string[]; /** Routing mode resolved from channel config at upgrade time. Defaults to fanout. */
   delivery?: "fanout" | "exclusive";
   /**
    * Opaque per-client id declared at upgrade time (`?id=<subscriberId>`). When an
@@ -433,7 +432,7 @@ type BroadcastSubscriber = (event: ReplayableEvent) => void;
 type ReplaySource = {
   loadSince(since: number): ReplayableEvent[];
 };
-type Deps$13 = {
+type Deps$11 = {
   logger?: FunnelLogger; /** Host hook for surfacing subscriber-throw exceptions. Defaults to no-op. */
   onError?: OnFunnelError;
   maxBufferedBytes?: number;
@@ -485,7 +484,7 @@ declare class FunnelBroadcaster {
   private droppedSlowClients;
   private lastBroadcastAt;
   private latestOffset;
-  constructor(deps?: Deps$13);
+  constructor(deps?: Deps$11);
   getMetrics(): BroadcasterMetrics;
   /**
    * Returns events with offset > since, filtered by the connector subscription
@@ -502,15 +501,12 @@ declare class FunnelBroadcaster {
   replaySince(since: number, data: ClientData): ReplayableEvent[];
   private matchesClient;
   /**
-   * Returns the list of WS clients that should receive `event`. Tap=all clients always
-   * receive (passive observation). For each per-channel group:
+   * Returns the list of WS clients that should receive `event`. For each per-channel group:
    *   - fanout → every matching client receives
    *   - exclusive → exactly one client receives, picked round-robin per channel
    *
-   * `meta.target` narrows the regular (non-tap) recipient set first via
-   * `matchesClient`: only the subscriber whose `subscriberId` equals `target`
-   * stays in the running, so a targeted event reaches one named instance while
-   * still being observable by tap=all clients.
+   * `meta.target` narrows the recipient set via `matchesClient`: only the subscriber
+   * whose `subscriberId` equals `target` receives a targeted event.
    */
   private pickRecipients;
   addClient(ws: ServerWebSocket<unknown>, data: ClientData): void;
@@ -536,7 +532,7 @@ type ConnectorRegistry = {
   } | null;
 };
 type SupervisorNotify = (channelName: string, connectorName: string, content: string, meta?: Record<string, string>) => Promise<void>;
-type Deps$12 = {
+type Deps$10 = {
   channels: ConnectorRegistry;
   notify: SupervisorNotify;
   logger?: FunnelLogger; /** Host hook for surfacing listener lifecycle exceptions. Defaults to no-op. */
@@ -583,7 +579,7 @@ declare class FunnelListenerSupervisor {
   private readonly now;
   private healthCheckTimer;
   private healthCheckInFlight;
-  constructor(deps: Deps$12);
+  constructor(deps: Deps$10);
   static keyOf(channelName: string, connectorName: string): string;
   isRunning(channelName: string, connectorName: string): boolean;
   list(): ListenerEntryStatus[];
@@ -956,6 +952,12 @@ declare function buildGatewayRoutes(): _$hono_hono_base0.HonoBase<Env$1, {
   };
 }, "/", "/channels/:channel/publish">;
 //#endregion
+//#region lib/engine/claude/channel-resolver.d.ts
+type ChannelResolver = {
+  get(name: string): ChannelConfig | null;
+  getById(id: string): ChannelConfig | null;
+};
+//#endregion
 //#region lib/engine/claude/gateway-controller.d.ts
 type GatewayController = {
   isRunning(): boolean;
@@ -964,78 +966,25 @@ type GatewayController = {
   }): Promise<boolean>;
 };
 //#endregion
-//#region lib/engine/mcp/mcp.d.ts
-declare const FUNNEL_MCP_COMMAND = "bun";
-declare const FUNNEL_MCP_ARGS: string[];
-declare const FUNNEL_MCP_NAME = "funnel";
-type Deps$11 = {
-  fs?: FunnelFileSystem;
-};
-/**
- * Installs/uninstalls the funnel MCP entry into a target repository's
- * `.mcp.json`. Detects an existing entry by command match so renaming is
- * preserved across re-installs.
- */
-declare class FunnelMcp {
-  private readonly fs;
-  constructor(deps?: Deps$11);
-  install(repoPath: string): void;
-  uninstall(repoPath: string): void;
+//#region lib/engine/claude/mcp-installer.d.ts
+type McpInstaller = {
   findInstalledName(cwd: string): string | null;
-  private findServerName;
-  private isFunnelEntry;
-  private readConfig;
-  private writeConfig;
-}
+  install(cwd: string): void;
+};
 //#endregion
-//#region lib/engine/profiles/profiles.d.ts
-type Deps$10 = {
-  store: FunnelSettingsReader;
-  idGenerator: FunnelIdGenerator;
+//#region lib/engine/claude/process-guard.d.ts
+type ProcessGuard = {
+  /** Returns true if a live process is already registered for this profile. */isRunning(profileId: string): boolean; /** Writes the PID file and registers an exit hook to clean it up. */
+  acquire(profileId: string): void; /** Removes the PID file. */
+  release(profileId: string): void;
+};
+//#endregion
+//#region lib/engine/claude/session-store.d.ts
+type SessionStore = {
+  getSessionId(profileId: string): string | null;
+  setSessionId(profileId: string, sessionId: string): void; /** Returns true when the session jsonl exists on disk and is non-empty. */
+  sessionFileExists(cwd: string, sessionId: string, env: Record<string, string>): boolean;
 };
-/**
- * Named launch presets for `fnl claude`. Each profile bundles a working
- * directory, the channel id its Claude instance subscribes to, and the launch
- * recipe (`options` prepended to the claude argv, `env` layered under the
- * process, `resume` toggling session reuse). Implements ProfileChannelChecker
- * so FunnelChannels can refuse to remove a channel that is still referenced.
- *
- * 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.
- */
-declare class FunnelProfiles {
-  private readonly store;
-  private readonly idGenerator;
-  constructor(deps: Deps$10);
-  list(): ProfileConfig[];
-  get(name: string): ProfileConfig | null;
-  getById(id: string): ProfileConfig | null;
-  getDefault(): ProfileConfig | null;
-  add(input: {
-    name: string;
-    path: string;
-    channelId: string;
-    options?: string[];
-    env?: Record<string, string>;
-    resume?: boolean;
-  }): void;
-  remove(name: string): void;
-  rename(oldName: string, newName: string): void;
-  asDefault(name: string): void;
-  hasChannelRef(channelId: string): boolean;
-  /** Resumable claude session id last launched by this profile (by id), or null. */
-  getSessionId(id: string): string | null;
-  /** Records the claude session id this profile launched, overwriting any prior one. */
-  setSessionId(id: string, sessionId: string): void;
-  update(name: string, fields: Partial<Omit<ProfileConfig, "name">>): void;
-}
 //#endregion
 //#region lib/engine/claude/claude.d.ts
 type LaunchOptions = {
@@ -1063,41 +1012,32 @@ type LaunchOptions = {
   installMcp?: boolean;
 };
 type Deps$9 = {
-  channels: FunnelChannels;
-  mcp: FunnelMcp;
+  channels: ChannelResolver;
+  mcp: McpInstaller;
   gateway: GatewayController;
-  profiles: FunnelProfiles;
+  sessions: SessionStore;
+  guard: ProcessGuard;
   process?: FunnelProcessRunner;
-  fs?: FunnelFileSystem;
   idGenerator?: FunnelIdGenerator;
   logger?: FunnelLogger;
-  dir?: string;
 };
 /**
  * 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,
- * injects `FUNNEL_CHANNEL_ID` into the child env, and writes a per-profile
- * PID file to enforce singleton launches.
+ * injects `FUNNEL_CHANNEL_ID` into the child env, and delegates singleton
+ * enforcement to a ProcessGuard.
  */
 declare class FunnelClaude {
   private readonly channels;
   private readonly mcp;
   private readonly gateway;
-  private readonly profiles;
+  private readonly sessions;
+  private readonly guard;
   private readonly process;
-  private readonly fs;
   private readonly idGenerator;
   private readonly logger;
-  private readonly pidDir;
   constructor(deps: Deps$9);
   launch(options: LaunchOptions): Promise<number>;
-  isRunning(profileId: string): boolean;
-  private pidPath;
-  private readPid;
-  private writePidFile;
-  private removePidFile;
-  private installCleanup;
-  private isProcessAlive;
   private buildArgs;
   /**
    * Decides whether funnel should resume an existing claude session or start
@@ -1119,35 +1059,10 @@ declare class FunnelClaude {
    * overwrites the dangling entry — so the store self-heals.
    */
   private resolveSession;
-  /**
-   * Mirrors claude's session storage path
-   * (`<config-dir>/projects/<cwd-with-slashes-as-dashes>/<id>.jsonl`) to check
-   * whether a recorded session still exists AND is non-empty. Reads the same
-   * `CLAUDE_CONFIG_DIR` the child will run under so the check matches reality; a
-   * wrong guess can only ever produce a false negative (start fresh), never a
-   * bad resume.
-   */
-  private sessionFileExists;
   private buildEnv;
 }
 //#endregion
 //#region lib/engine/local-config/local-config-schema.d.ts
-declare const connectorSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"slack">;
-  name: z.ZodString;
-  minify: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"discord">;
-  name: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"gh">;
-  name: z.ZodString;
-  pollInterval: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"schedule">;
-  name: z.ZodString;
-}, z.core.$strip>], "type">;
-type ConnectorSpec = z.infer<typeof connectorSpecSchema>;
 declare const channelSpecSchema: z.ZodObject<{
   name: z.ZodString;
   connectors: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1167,14 +1082,6 @@ declare const channelSpecSchema: z.ZodObject<{
   }, z.core.$strip>], "type">>>;
 }, z.core.$strip>;
 type ChannelSpec = z.infer<typeof channelSpecSchema>;
-declare const profileSpecSchema: z.ZodObject<{
-  name: z.ZodString;
-  channel: z.ZodString;
-  options: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-  resume: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-type ProfileSpec = z.infer<typeof profileSpecSchema>;
 declare const localConfigSchema: z.ZodObject<{
   $schema: z.ZodOptional<z.ZodString>;
   id: z.ZodOptional<z.ZodString>;
@@ -1205,7 +1112,6 @@ declare const localConfigSchema: z.ZodObject<{
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 type LocalConfig = z.infer<typeof localConfigSchema>;
-declare const LOCAL_CONFIG_FILENAME = "funnel.json";
 //#endregion
 //#region lib/engine/local-config/local-config.d.ts
 type Deps$8 = {
@@ -1291,21 +1197,64 @@ declare class FunnelLocalConfigSync {
   private resolveSlot;
 }
 //#endregion
-//#region lib/engine/local-config/local-config-writer.d.ts
+//#region lib/engine/profiles/profiles.d.ts
 type Deps$6 = {
-  fs: FunnelFileSystem;
+  store: FunnelSettingsReader;
+  idGenerator: FunnelIdGenerator;
+  fs?: FunnelFileSystem;
 };
 /**
- * The one path that mutates the repo-committed funnel.json, and it only ever
- * inserts `id`. On first launch a repo has no `id`; funnel generates one and
- * writes it back here so future launches resolve the same `~/.funnel/projects/<id>/`.
- * Idempotent — a no-op once `id` is present. Kept separate from the read-only
- * FunnelLocalConfig so reads stay side-effect free.
+ * Named launch presets for `fnl claude`. Each profile bundles a working
+ * directory, the channel id its Claude instance subscribes to, and the launch
+ * recipe (`options` prepended to the claude argv, `env` layered under the
+ * process, `resume` toggling session reuse). Implements ProfileChannelChecker
+ * so FunnelChannels can refuse to remove a channel that is still referenced.
+ *
+ * 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.
  */
-declare class FunnelLocalConfigWriter {
+declare class FunnelProfiles {
+  private readonly store;
+  private readonly idGenerator;
   private readonly fs;
   constructor(deps: Deps$6);
-  ensureId(cwd: string, id: string): void;
+  list(): ProfileConfig[];
+  get(name: string): ProfileConfig | null;
+  getById(id: string): ProfileConfig | null;
+  getDefault(): ProfileConfig | null;
+  add(input: {
+    name: string;
+    path: string;
+    channelId: string;
+    options?: string[];
+    env?: Record<string, string>;
+    resume?: boolean;
+  }): void;
+  remove(name: string): void;
+  rename(oldName: string, newName: string): void;
+  asDefault(name: string): void;
+  hasChannelRef(channelId: string): boolean;
+  /** Resumable claude session id last launched by this profile (by id), or null. */
+  getSessionId(id: string): string | null;
+  /** Records the claude session id this profile launched, overwriting any prior one. */
+  setSessionId(id: string, sessionId: string): void;
+  /**
+   * Mirrors claude's session storage path
+   * (`<config-dir>/projects/<cwd-with-slashes-as-dashes>/<id>.jsonl`) to check
+   * whether a recorded session still exists AND is non-empty. Reads the same
+   * `CLAUDE_CONFIG_DIR` the child will run under so the check matches reality; a
+   * wrong guess can only ever produce a false negative (start fresh), never a
+   * bad resume.
+   */
+  sessionFileExists(cwd: string, sessionId: string, env: Record<string, string>): boolean;
+  update(name: string, fields: Partial<Omit<ProfileConfig, "name">>): void;
 }
 //#endregion
 //#region lib/gateway/publish-schema.d.ts
@@ -1463,7 +1412,6 @@ declare class FunnelGateway {
 //#region lib/gateway/gateway-server.d.ts
 type Deps$3 = {
   channels: FunnelChannels;
-  settings: FunnelSettingsReader;
   port?: number; /** Bind address for `Bun.serve`. Defaults to `127.0.0.1` (loopback only). Set to `0.0.0.0` to expose on the network. */
   hostname?: string; /** SQLite event store file path. Parent directory is created on demand. Defaults to `<os.tmpdir()>/funnel/events.db`. Ignored when `eventLog` is supplied. */
   dbPath?: string; /** Durable replay log. Defaults to a `SqliteFunnelEventLog` at `dbPath`. Inject a `MemoryFunnelEventLog` (or any `FunnelEventLog`) to swap or disable persistence. */
@@ -1485,10 +1433,9 @@ type Deps$3 = {
   extraRoutes?: Hono<Env$1>;
 };
 type WsData = {
-  /** Stable channel id (uuid) the client subscribed to. "" for tap-all clients. */channel: string; /** Resolved channel name (for log readability). null for tap-all or unknown. */
-  channelName: string | null; /** Connector names belonging to that channel; used by tap-all replay filtering. */
-  connectors: string[];
-  tapAll?: boolean; /** Routing mode for this channel; resolved at upgrade time from settings. */
+  /** Stable channel id (uuid) the client subscribed to. */channel: string; /** Resolved channel name (for log readability). null for unknown. */
+  channelName: string | null; /** Connector names belonging to that channel. */
+  connectors: string[]; /** Routing mode for this channel; resolved at upgrade time from settings. */
   delivery: "fanout" | "exclusive"; /** Opaque client id from `?id=<subscriberId>`; lets publishers target this client via `meta.target`. */
   subscriberId?: string; /** Replay any events with offset strictly greater than this on open, then resume the live stream. */
   since?: number;
@@ -1505,7 +1452,6 @@ type WsData = {
  */
 declare class FunnelGatewayServer {
   private readonly channels;
-  private readonly settings;
   private readonly port;
   private readonly hostname;
   private readonly dbPath;
@@ -1691,14 +1637,13 @@ type FunnelDebugReport = {
 };
 //#endregion
 //#region lib/funnel.d.ts
-type Props$8 = {
+type Props$7 = {
   /** Settings persistence (channels with nested connectors / profiles). Defaults to a FunnelSettingsStore rooted at `dir`. */store?: FunnelSettingsReader; /** Filesystem boundary. Replace with MemoryFunnelFileSystem to sandbox all disk I/O. */
   fs?: FunnelFileSystem; /** Process runner used by gateway / claude / gh listener. Replace with MemoryFunnelProcessRunner for tests. */
   process?: FunnelProcessRunner; /** Logger flowed into every facet. Replace with MemoryFunnelLogger or NoopFunnelLogger to silence/inspect. */
   logger?: FunnelLogger; /** Clock used by schedule listener, gh poll watermarks, and gateway timeouts. */
   clock?: FunnelClock; /** ID generator for channel and connector ids. Use MemoryFunnelIdGenerator for deterministic tests. */
-  idGenerator?: FunnelIdGenerator; /** Prompter used by FunnelLocalConfigSync when funnel.json omits a token. Defaults to a TTY-only stdin prompter. */
-  tokenPrompter?: FunnelTokenPrompter; /** Funnel home directory (settings.json + per-channel/per-connector dirs). Defaults to ~/.funnel. */
+  idGenerator?: FunnelIdGenerator; /** Funnel home directory (settings.json + per-channel/per-connector dirs). Defaults to ~/.funnel. */
   dir?: string; /** Temp / runtime directory (gateway logs and PID adjacent files). Defaults to `<os.tmpdir()>/funnel`. */
   tmpDir?: string;
   /**
@@ -1730,17 +1675,21 @@ type Props$8 = {
    * the default (9742) without setting FUNNEL_PORT in the environment.
    */
   port?: number;
+  /**
+   * Token prompter used by FunnelLocalConfigSync when funnel.json omits a token.
+   * Defaults to a TTY-only stdin prompter. Inject MemoryFunnelTokenPrompter in tests.
+   */
+  tokenPrompter?: FunnelTokenPrompter;
 };
 /**
- * Facade exposing every funnel facet as a getter.
+ * Facade that wires every funnel facet together and exposes the public surface.
  *
- * The same `Funnel` is used by the CLI and as a programmable library.
- * All side-effecting boundaries (filesystem, process, logger, clock, id, paths) are
- * injectable via `Props` — passing memory implementations gives a fully sandboxed
+ * All side-effecting boundaries (filesystem, process, logger, clock, id, paths)
+ * are injected via Props — passing memory implementations gives a fully sandboxed
  * Funnel that touches no real disk, processes, or wall-clock time.
  *
- * Connectors live nested inside their owning channel (channels[].connectors[]),
- * so connector CRUD is reached via `funnel.channels.addConnector(...)` etc.
+ * Fully immutable: all fields are resolved in the constructor and frozen.
+ * No lazy initialisation — every dependency is wired at construction time.
  *
  * @example
  * ```ts
@@ -1751,114 +1700,57 @@ type Props$8 = {
  * ```
  */
 declare class Funnel {
-  private readonly props;
-  private readonly memos;
-  constructor(props?: Props$8);
-  /**
-   * Sandboxed Funnel wired with in-memory implementations for every IO boundary.
-   * Touches no real disk, processes, wall-clock time, or UUIDs — safe for tests
-   * and ad-hoc experiments. Override individual fields by passing them in `props`.
-   */
-  static inMemory(props?: Props$8): Funnel;
-  /** Resolved on-disk paths the facade will read/write when methods are called. Pure compute, not memoized. */
-  get paths(): {
+  readonly paths: {
     dir: string;
     tmpDir: string;
     settings: string;
   };
-  /** Filesystem boundary. Defaults to NodeFunnelFileSystem. */
-  get fs(): FunnelFileSystem;
-  /** Process runner boundary. Defaults to NodeFunnelProcessRunner. */
-  get process(): FunnelProcessRunner;
-  /** 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(): FunnelLogger | undefined;
-  /** 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. */
-  get store(): FunnelSettingsReader;
-  /** Pure factory that constructs per-type listeners and adapters from connector configs. */
-  get factory(): FunnelConnectorFactory;
-  /** Channel CRUD + nested connector CRUD + schedule entries + listener/adapter dispatch. */
-  get channels(): FunnelChannels;
-  /** Launch profiles (named presets for `fnl claude`: path + sub-agent + channel id). */
-  get profiles(): FunnelProfiles;
-  /** Reads `funnel.json` from a cwd. `fnl claude` consults it before falling back to the default profile. */
-  get localConfig(): FunnelLocalConfig;
-  /** Writes the stable `id` into funnel.json on first launch so state can be scoped to `~/.funnel/projects/<id>/`. */
-  get localConfigWriter(): FunnelLocalConfigWriter;
-  /** Secret prompter. Defaults to a TTY-only stdin reader; tests inject MemoryFunnelTokenPrompter. */
-  get tokenPrompter(): FunnelTokenPrompter;
-  /** Reconciles funnel.json's channel + connectors with `~/.funnel/settings.json` on launch. */
-  get localConfigSync(): FunnelLocalConfigSync;
-  /** funnel MCP installer (writes/removes `.mcp.json` entries in target repos). */
-  get mcp(): FunnelMcp;
-  /** Launch Claude Code with a channel injected via env, MCP installed, gateway ensured. */
-  get claude(): FunnelClaude;
-  /** Gateway daemon controller (PID-file, start/stop the separate `bun daemon.ts` process). */
-  get gateway(): FunnelGateway;
-  /** Read / generate the daemon's gateway token (mode 0600 file under `dir`). */
-  get gatewayToken(): FunnelGatewayToken;
-  /**
-   * HTTP client for `POST /channels/:channel/publish` on the running gateway
-   * daemon. Use it to push arbitrary content into a channel from outside any
-   * connector. Returns `{ state: "offline" }` if the daemon isn't up.
-   */
-  get publisher(): FunnelChannelPublisher;
+  readonly channels: FunnelChannels;
+  readonly gateway: FunnelGateway;
+  readonly gatewayToken: FunnelGatewayToken;
+  readonly publisher: FunnelChannelPublisher;
+  readonly listeners: FunnelListenersClient;
+  readonly claude: FunnelClaude;
+  readonly profiles: FunnelProfiles;
+  readonly localConfig: FunnelLocalConfig;
+  readonly localConfigSync: FunnelLocalConfigSync;
+  private readonly fs;
+  private readonly process;
+  private readonly logger;
+  private readonly clock;
+  private readonly onError;
+  constructor(props?: Props$7);
   /**
-   * HTTP client for listener operations on the running gateway daemon.
-   * Returns `{ state: "offline" }` when the daemon is offline so hot-reload
-   * paths stay write-only without parsing strings.
+   * Sandboxed Funnel wired with in-memory implementations for every IO boundary.
+   * Touches no real disk, processes, wall-clock time, or UUIDs — safe for tests
+   * and ad-hoc experiments. Override individual fields by passing them in `props`.
    */
-  get listeners(): FunnelListenersClient;
+  static inMemory(props?: Props$7): Funnel;
   /**
    * In-process gateway server. Unlike `gateway.start()` (which spawns a daemon),
    * this returns a class that runs `Bun.serve` + listeners inside the current process —
    * useful for tests, embedding, or custom hosts.
    */
   gatewayServer(options?: {
-    port?: number; /** Bind address. Defaults to `127.0.0.1` (loopback only). Set to `0.0.0.0` to expose on the network. */
+    port?: number;
     hostname?: string;
     dbPath?: string;
-    killCompetingSlack?: boolean; /** Override the auth token. Defaults to the persisted gateway.token. Pass "" to disable auth (tests). */
-    token?: string; /** Durable replay log. Defaults to a SqliteFunnelEventLog at dbPath; inject a MemoryFunnelEventLog (or any FunnelEventLog) to swap or disable persistence. */
+    killCompetingSlack?: boolean;
+    token?: string;
     eventLog?: FunnelEventLog;
-    /**
-     * Additional hono app mounted before the built-in gateway routes.
-     * Use to embed host-specific endpoints (e.g. an MCP route, custom `/api/*`).
-     * Host routes are mounted first; built-in `/listeners`, `/status`,
-     * `/channels`, `/health` are mounted after and take precedence on conflict.
-     */
     extraRoutes?: Hono<Env$1>;
   }): FunnelGatewayServer;
+  /**
+   * Run the gateway daemon in the foreground (tied to this terminal).
+   * For background daemon management, use `funnel.gateway.start()` instead.
+   */
+  runGatewayForeground(options?: {
+    caffeinate?: boolean;
+  }): Promise<number>;
   debug(channelName?: string): Promise<FunnelDebugReport>;
   gatewayClient(): ReturnType<typeof hc<GatewayApp>>;
 }
 //#endregion
-//#region lib/engine/mcp/channel-server.d.ts
-type ChannelServerOptions = {
-  /** Funnel home directory (settings.json + gateway.token). Defaults to ~/.funnel. */dir?: string; /** Gateway base URL. Defaults to `$FUNNEL_GATEWAY_URL` or `http://127.0.0.1:<port>`. */
-  gatewayUrl?: string; /** Channel id to subscribe to. Defaults to `$FUNNEL_CHANNEL_ID`. */
-  channelId?: string; /** Auth token. Defaults to `$FUNNEL_GATEWAY_TOKEN` then `<dir>/gateway.token`. */
-  token?: string;
-};
-declare const startChannelServer: (options?: ChannelServerOptions) => Promise<void>;
-//#endregion
-//#region lib/engine/local-config/local-config-json-schema.d.ts
-/**
- * Generates the JSON Schema (draft 2020-12) for `funnel.json`. Useful for
- * `$schema` references in committed `funnel.json` files so editors can give
- * autocomplete and validation for channels[] (transport) and profiles[]
- * (launch recipe) without anyone hand-maintaining a separate schema.
- */
-declare const funnelJsonSchema: () => Record<string, unknown>;
-//#endregion
 //#region lib/engine/settings/settings-store.d.ts
 /**
  * Resolves the funnel home dir. Defaults to `~/.funnel`, overridable via
@@ -1928,7 +1820,7 @@ declare class NodeFunnelFileSystem extends FunnelFileSystem {
 }
 //#endregion
 //#region lib/engine/fs/memory-file-system.d.ts
-type Props$7 = {
+type Props$6 = {
   dirs?: string[];
   files?: Record<string, string>;
   mtimes?: Record<string, number>;
@@ -1941,7 +1833,7 @@ declare class MemoryFunnelFileSystem extends FunnelFileSystem {
   private readonly mtimes;
   private readonly modes;
   private readonly now;
-  constructor(props?: Props$7);
+  constructor(props?: Props$6);
   existsSync(path: string): boolean;
   readFileSync(path: string): string;
   writeFileSync(path: string, data: string): void;
@@ -2027,14 +1919,14 @@ declare class MemoryFunnelProcessRunner extends FunnelProcessRunner {
 }
 //#endregion
 //#region lib/engine/logger/node-logger.d.ts
-type Props$6 = {
+type Props$5 = {
   file?: string;
   now?: () => Date;
 };
 declare class NodeFunnelLogger extends FunnelLogger {
   readonly file: string;
   private readonly now;
-  constructor(props?: Props$6);
+  constructor(props?: Props$5);
   info(message: string, meta?: Record<string, unknown>): void;
   warn(message: string, meta?: Record<string, unknown>): void;
   error(message: string, meta?: Record<string, unknown>): void;
@@ -2070,12 +1962,12 @@ declare class NodeFunnelClock extends FunnelClock {
 }
 //#endregion
 //#region lib/engine/time/memory-clock.d.ts
-type Props$5 = {
+type Props$4 = {
   start?: Date;
 };
 declare class MemoryFunnelClock extends FunnelClock {
   private current;
-  constructor(props?: Props$5);
+  constructor(props?: Props$4);
   now(): Date;
   set(date: Date): void;
   advance(ms: number): void;
@@ -2087,41 +1979,14 @@ declare class NodeFunnelIdGenerator extends FunnelIdGenerator {
 }
 //#endregion
 //#region lib/engine/id/memory-id-generator.d.ts
-type Props$4 = {
+type Props$3 = {
   prefix?: string;
 };
 declare class MemoryFunnelIdGenerator extends FunnelIdGenerator {
   private counter;
   private readonly prefix;
-  constructor(props?: Props$4);
-  generate(): string;
-}
-//#endregion
-//#region lib/engine/token-prompter/node-token-prompter.d.ts
-/**
- * Reads a secret from stdin in raw mode. Echoes a `*` per byte so the user
- * can see progress without exposing the token. Refuses to prompt when stdin
- * is not a TTY — callers should surface the resulting error with a hint
- * pointing at the corresponding env var or CLI command.
- */
-declare class NodeFunnelTokenPrompter extends FunnelTokenPrompter {
-  promptSecret(label: string): Promise<string>;
-  private readSecret;
-}
-//#endregion
-//#region lib/engine/token-prompter/memory-token-prompter.d.ts
-type Props$3 = {
-  answers?: Record<string, string>;
-};
-/**
- * Pre-seeded answers keyed by prompt label. Tests configure the map up front;
- * unmapped labels throw so the test surfaces unexpected prompts loudly.
- */
-declare class MemoryFunnelTokenPrompter extends FunnelTokenPrompter {
-  private readonly answers;
-  readonly asked: string[];
   constructor(props?: Props$3);
-  promptSecret(label: string): Promise<string>;
+  generate(): string;
 }
 //#endregion
 //#region lib/gateway/sqlite-funnel-event-log.d.ts
@@ -2312,6 +2177,10 @@ declare class ConnectorDiagnosticSqlReader {
 type Env = {
   Bindings: {
     funnel: Funnel;
+    claude: FunnelClaude;
+    profiles: FunnelProfiles;
+    localConfig: FunnelLocalConfig;
+    localConfigSync: FunnelLocalConfigSync;
   };
 };
 declare const factory: _$hono_factory0.Factory<Env, string>;
@@ -2377,7 +2246,7 @@ declare const routes: _$hono_hono_base0.HonoBase<Env, {
         connectors: {
           id: string;
           name: string;
-          type: "discord" | "slack" | "gh" | "schedule";
+          type: "gh" | "discord" | "slack" | "schedule";
         }[];
       }[];
       outputFormat: "json";
@@ -4211,4 +4080,4 @@ ${string}`;
 }, "/", "/update">;
 type CliApp = typeof routes;
 //#endregion
-export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, CONNECTOR_CONNECTION_STATUSES, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelServerOptions, ChannelSpec, type CliApp, ConnectorConfig, ConnectorConnectionEvent, ConnectorConnectionQuery, ConnectorConnectionRecord, ConnectorConnectionStatus, ConnectorDiagnosticLog, ConnectorDiagnosticSqlReader, ConnectorProcessedEvent, ConnectorProcessedQuery, ConnectorProcessedRecord, ConnectorQuery, ConnectorRawEvent, ConnectorRawQuery, ConnectorRawRecord, ConnectorSpec, ConnectorSyncOutcome, ConnectorType, DEFAULT_GATEWAY_PORT, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiscordConnectorConfig, Env, FUNNEL_DIR, FUNNEL_MCP_ARGS, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, type FunnelDebugReport, FunnelEvent, FunnelEventLog, FunnelEventRecord, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLocalConfigWriter, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, type GatewayApp, type GatewayEmitInput, type GatewayRouteDeps, type Env$1 as GatewayServerEnv, GhConnectorConfig, LOCAL_CONFIG_FILENAME, LaunchOptions, ListListenersResult, ListenerEntry, ListenerOpResult, LocalConfig, LocalConfigSyncResult, LogEntry, MemoryConnectorDiagnosticLog, MemoryFunnelClock, MemoryFunnelEventLog, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, NotifyFn, OnFunnelError, ProcessListStub, ProcessSnapshot, ProfileConfig, ProfileSpec, PublishRequest, PublishResponse, PublishResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, SlackSkipReason, SqliteConnectorDiagnosticLog, SqliteFunnelEventLog, StoredConnectionEvent, StoredProcessedEvent, StoredRawEvent, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, routes as cliRoutes, connectorConfigSchema, connectorConnectionEventSchema, connectorProcessedEventSchema, connectorRawEventSchema, connectorSpecSchema, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, localConfigSchema, profileConfigSchema, profileSpecSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, resolveFunnelDir, resolveFunnelPort, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };
+export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, CONNECTOR_CONNECTION_STATUSES, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, type CliApp, ConnectorConfig, ConnectorConnectionEvent, ConnectorConnectionQuery, ConnectorConnectionRecord, ConnectorConnectionStatus, ConnectorDiagnosticLog, ConnectorDiagnosticSqlReader, ConnectorProcessedEvent, ConnectorProcessedQuery, ConnectorProcessedRecord, ConnectorQuery, ConnectorRawEvent, ConnectorRawQuery, ConnectorRawRecord, ConnectorType, DEFAULT_GATEWAY_PORT, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiscordConnectorConfig, Env, FUNNEL_DIR, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, type FunnelDebugReport, FunnelEvent, FunnelEventLog, FunnelEventRecord, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLogger, FunnelProcessRunner, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, type GatewayApp, type GatewayEmitInput, type GatewayRouteDeps, type Env$1 as GatewayServerEnv, GhConnectorConfig, ListListenersResult, ListenerEntry, ListenerOpResult, LogEntry, MemoryConnectorDiagnosticLog, MemoryFunnelClock, MemoryFunnelEventLog, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, 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, SlackSkipReason, SqliteConnectorDiagnosticLog, SqliteFunnelEventLog, StoredConnectionEvent, StoredProcessedEvent, StoredRawEvent, channelConfigSchema, channelDeliveryModeSchema, routes as cliRoutes, connectorConfigSchema, connectorConnectionEventSchema, connectorProcessedEventSchema, connectorRawEventSchema, createSettings, discordConnectorSchema, factory, funnelEventSchema, ghConnectorSchema, profileConfigSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, resolveFunnelDir, resolveFunnelPort, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, toRequest };