@interactive-inc/claude-funnel 0.7.1 → 0.8.0

package/lib/cli/routes/index.ts

@@ -0,0 +1,202 @@
+import { HTTPException } from "hono/http-exception"
+import { factory } from "@/cli/factory"
+import {
+  addHelp as channelsAddHelp,
+  channelsAddHandler,
+} from "@/cli/routes/channels.add.$channel"
+import { channelsConnectorsGroupHandler } from "@/cli/routes/channels.$channel.connectors"
+import {
+  addHelp as channelsConnectorsAddHelp,
+  channelsConnectorsAddHandler,
+} from "@/cli/routes/channels.$channel.connectors.add.$connector"
+import {
+  channelsConnectorsRemoveHandler,
+  removeHelp as channelsConnectorsRemoveHelp,
+} from "@/cli/routes/channels.$channel.connectors.remove.$connector"
+import {
+  channelsConnectorsSetHandler,
+  setHelp as channelsConnectorsSetHelp,
+} from "@/cli/routes/channels.$channel.connectors.set.$connector"
+import { channelsConnectorsShowHandler } from "@/cli/routes/channels.$channel.connectors.$connector"
+import {
+  channelsConnectorsRenameHandler,
+  renameHelp as channelsConnectorsRenameHelp,
+} from "@/cli/routes/channels.$channel.connectors.$connector.rename.$newName"
+import { channelsConnectorsRequestHandler } from "@/cli/routes/channels.$channel.connectors.$connector.request"
+import { channelsConnectorsSchedulesGroupHandler } from "@/cli/routes/channels.$channel.connectors.$connector.schedules"
+import {
+  addHelp as channelsConnectorsSchedulesAddHelp,
+  channelsConnectorsSchedulesAddHandler,
+} from "@/cli/routes/channels.$channel.connectors.$connector.schedules.add.$id"
+import {
+  channelsConnectorsSchedulesRemoveHandler,
+  removeHelp as channelsConnectorsSchedulesRemoveHelp,
+} from "@/cli/routes/channels.$channel.connectors.$connector.schedules.remove.$id"
+import {
+  channelsRemoveHandler,
+  removeHelp as channelsRemoveHelp,
+} from "@/cli/routes/channels.remove.$channel"
+import {
+  channelsRenameHandler,
+  renameHelp as channelsRenameHelp,
+} from "@/cli/routes/channels.$channel.rename.$newName"
+import { channelsSetDeliveryHandler } from "@/cli/routes/channels.$channel.set.delivery.$mode"
+import { channelsShowHandler } from "@/cli/routes/channels.$channel"
+import { channelsGroupHandler } from "@/cli/routes/channels"
+import { claudeHandler } from "@/cli/routes/claude"
+import { gatewayGroupHandler } from "@/cli/routes/gateway"
+import { gatewayListenersHandler } from "@/cli/routes/gateway.listeners"
+import { gatewayLogsHandler } from "@/cli/routes/gateway.logs"
+import { gatewayRestartHandler } from "@/cli/routes/gateway.restart"
+import { gatewayRunHandler } from "@/cli/routes/gateway.run"
+import { gatewayStartHandler } from "@/cli/routes/gateway.start"
+import { gatewayStatusHandler } from "@/cli/routes/gateway.status"
+import { gatewayStopHandler } from "@/cli/routes/gateway.stop"
+import {
+  addHelp as profilesAddHelp,
+  profilesAddHandler,
+} from "@/cli/routes/profiles.add.$profile"
+import { profilesAsDefaultHandler } from "@/cli/routes/profiles.$profile.as-default"
+import {
+  profilesRenameHandler,
+  renameHelp as profilesRenameHelp,
+} from "@/cli/routes/profiles.$profile.rename.$newName"
+import { profilesLaunchHandler } from "@/cli/routes/profiles.$profile.run"
+import {
+  profilesRemoveHandler,
+  removeHelp as profilesRemoveHelp,
+} from "@/cli/routes/profiles.remove.$profile"
+import {
+  profilesSetHandler,
+  setHelp as profilesSetHelp,
+} from "@/cli/routes/profiles.set.$profile"
+import { profilesGroupHandler } from "@/cli/routes/profiles"
+import { statusHandler } from "@/cli/routes/status"
+import { updateHandler } from "@/cli/routes/update"
+import { Funnel } from "@/funnel"
+
+const base = factory.createApp()
+
+base.use((c, next) => {
+  c.set("funnel", new Funnel())
+
+  return next()
+})
+
+base.onError((error, c) => {
+  if (error instanceof HTTPException) {
+    return c.text(`error: ${error.message}`, error.status)
+  }
+
+  return c.text(`error: ${error instanceof Error ? error.message : String(error)}`, 400)
+})
+
+const helpRoute = (text: string) => factory.createHandlers((c) => c.text(text))
+
+// All CLI verbs (`add` / `remove` / `set` / `rename` / `as-default` / `request`) map to POST in
+// to-request.ts and stay in the URL as a literal segment. Read paths (list / show / launch) keep GET.
+// Help shortcuts at parameterless URLs return the help text directly so `funnel <verb>` (no args) is
+// informative instead of 404.
+export const app = base
+  .get("/claude", ...claudeHandler)
+  .get("/channels", ...channelsGroupHandler)
+  .post("/channels/add", ...helpRoute(channelsAddHelp))
+  .post("/channels/add/:channel", ...channelsAddHandler)
+  .post("/channels/remove", ...helpRoute(channelsRemoveHelp))
+  .post("/channels/remove/:channel", ...channelsRemoveHandler)
+  .post("/channels/rename/:channel/:newName", ...channelsRenameHandler)
+  .post("/channels/:channel/rename/:newName", ...channelsRenameHandler)
+  .post("/channels/rename", ...helpRoute(channelsRenameHelp))
+  .post("/channels/:channel/rename", ...helpRoute(channelsRenameHelp))
+  .post("/channels/:channel/set/delivery/:mode", ...channelsSetDeliveryHandler)
+  .get("/channels/:channel", ...channelsShowHandler)
+  .get("/channels/:channel/connectors", ...channelsConnectorsGroupHandler)
+  .post(
+    "/channels/:channel/connectors/add",
+    ...helpRoute(channelsConnectorsAddHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/add/:connector",
+    ...channelsConnectorsAddHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/remove",
+    ...helpRoute(channelsConnectorsRemoveHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/remove/:connector",
+    ...channelsConnectorsRemoveHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/set",
+    ...helpRoute(channelsConnectorsSetHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/set/:connector",
+    ...channelsConnectorsSetHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/rename/:connector/:newName",
+    ...channelsConnectorsRenameHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/rename/:newName",
+    ...channelsConnectorsRenameHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/rename",
+    ...helpRoute(channelsConnectorsRenameHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/rename",
+    ...helpRoute(channelsConnectorsRenameHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/request",
+    ...channelsConnectorsRequestHandler,
+  )
+  .get("/channels/:channel/connectors/:connector", ...channelsConnectorsShowHandler)
+  .get(
+    "/channels/:channel/connectors/:connector/schedules",
+    ...channelsConnectorsSchedulesGroupHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/schedules/add",
+    ...helpRoute(channelsConnectorsSchedulesAddHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/schedules/add/:id",
+    ...channelsConnectorsSchedulesAddHandler,
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/schedules/remove",
+    ...helpRoute(channelsConnectorsSchedulesRemoveHelp),
+  )
+  .post(
+    "/channels/:channel/connectors/:connector/schedules/remove/:id",
+    ...channelsConnectorsSchedulesRemoveHandler,
+  )
+  .get("/profiles", ...profilesGroupHandler)
+  .post("/profiles/add", ...helpRoute(profilesAddHelp))
+  .post("/profiles/add/:profile", ...profilesAddHandler)
+  .post("/profiles/set", ...helpRoute(profilesSetHelp))
+  .post("/profiles/set/:profile", ...profilesSetHandler)
+  .post("/profiles/remove", ...helpRoute(profilesRemoveHelp))
+  .post("/profiles/remove/:profile", ...profilesRemoveHandler)
+  .post("/profiles/rename/:profile/:newName", ...profilesRenameHandler)
+  .post("/profiles/:profile/rename/:newName", ...profilesRenameHandler)
+  .post("/profiles/rename", ...helpRoute(profilesRenameHelp))
+  .post("/profiles/:profile/rename", ...helpRoute(profilesRenameHelp))
+  .post("/profiles/:profile/as-default", ...profilesAsDefaultHandler)
+  .get("/profiles/:profile/run", ...profilesLaunchHandler)
+  .get("/profiles/:profile", ...profilesLaunchHandler)
+  .get("/gateway", ...gatewayGroupHandler)
+  .get("/gateway/status", ...gatewayStatusHandler)
+  .get("/gateway/start", ...gatewayStartHandler)
+  .get("/gateway/stop", ...gatewayStopHandler)
+  .get("/gateway/restart", ...gatewayRestartHandler)
+  .get("/gateway/run", ...gatewayRunHandler)
+  .get("/gateway/logs", ...gatewayLogsHandler)
+  .get("/gateway/listeners", ...gatewayListenersHandler)
+  .get("/status", ...statusHandler)
+  .get("/update", ...updateHandler)

package/lib/cli/routes/profiles.$profile.as-default.ts

@@ -0,0 +1,22 @@
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const asDefaultHelp = `funnel profiles <name> as-default — move profile to the front of the list
+
+usage: funnel profiles <name> as-default
+
+the first profile in the list is treated as the default for fnl claude.`
+
+export const profilesAsDefaultHandler = factory.createHandlers(
+  zValidator("param", z.object({ profile: z.string() })),
+  zValidator("query", z.object({}), asDefaultHelp),
+  (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+
+    funnel.profiles.asDefault(param.profile)
+
+    return c.text(`profile "${param.profile}" is now the default`)
+  },
+)

package/lib/cli/routes/profiles.$profile.rename.$newName.ts

@@ -0,0 +1,22 @@
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const renameHelp = `funnel profiles rename — rename a profile
+
+usage:
+  funnel profiles rename <old> <new>
+  funnel profiles <old> rename <new>`
+
+export const profilesRenameHandler = factory.createHandlers(
+  zValidator("param", z.object({ profile: z.string(), newName: z.string() })),
+  zValidator("query", z.object({}), renameHelp),
+  (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+
+    funnel.profiles.rename(param.profile, param.newName)
+
+    return c.text(`renamed profile "${param.profile}" to "${param.newName}"`)
+  },
+)

package/lib/cli/routes/profiles.$profile.run.ts

@@ -0,0 +1,36 @@
+import { HTTPException } from "hono/http-exception"
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { queryToCliArgs } from "@/cli/router/query-to-cli-args"
+import { zValidator } from "@/cli/router/validator"
+
+export const launchHelp = `funnel profiles <name> run — launch a profile (sugar for fnl claude)
+
+usage: funnel profiles <name> run [additional claude args...]
+       funnel profiles <name>     (alias)`
+
+const RESERVED_KEYS: string[] = []
+
+export const profilesLaunchHandler = factory.createHandlers(
+  zValidator("param", z.object({ profile: z.string() })),
+  zValidator("query", z.object({}).passthrough(), launchHelp),
+  async (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+    const profile = funnel.profiles.get(param.profile)
+
+    if (!profile) {
+      throw new HTTPException(404, { message: `profile "${param.profile}" not found` })
+    }
+
+    const exitCode = await funnel.claude.launch({
+      channel: profile.channelId,
+      cwd: profile.path,
+      subAgent: profile.subAgent,
+      userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
+      profileName: profile.name,
+    })
+
+    process.exit(exitCode)
+  },
+)

package/lib/cli/routes/profiles.add.$profile.ts

@@ -0,0 +1,46 @@
+import { HTTPException } from "hono/http-exception"
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const addHelp = `funnel profiles add — add a profile
+
+usage: funnel profiles add <name> --path <path> --sub-agent <agent> --channel <channel-name>
+
+options:
+  --path        working directory passed to claude as cwd
+  --sub-agent   sub-agent name passed to claude --agent
+  --channel     channel name (resolved to channel id internally)`
+
+export const profilesAddHandler = factory.createHandlers(
+  zValidator("param", z.object({ profile: z.string() })),
+  zValidator(
+    "query",
+    z.object({
+      path: z.string(),
+      "sub-agent": z.string(),
+      channel: z.string(),
+    }),
+    addHelp,
+  ),
+  (c) => {
+    const param = c.req.valid("param")
+    const query = c.req.valid("query")
+    const funnel = c.var.funnel
+
+    const channel = funnel.channels.get(query.channel)
+
+    if (!channel) {
+      throw new HTTPException(400, { message: `channel "${query.channel}" not found` })
+    }
+
+    funnel.profiles.add({
+      name: param.profile,
+      path: query.path,
+      subAgent: query["sub-agent"],
+      channelId: channel.id,
+    })
+
+    return c.text(`added profile "${param.profile}"`)
+  },
+)

package/lib/cli/routes/profiles.remove.$profile.ts

@@ -0,0 +1,20 @@
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const removeHelp = `funnel profiles remove — remove a profile
+
+usage: funnel profiles remove <name>`
+
+export const profilesRemoveHandler = factory.createHandlers(
+  zValidator("param", z.object({ profile: z.string() })),
+  zValidator("query", z.object({}), removeHelp),
+  (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+
+    funnel.profiles.remove(param.profile)
+
+    return c.text(`removed profile "${param.profile}"`)
+  },
+)

package/lib/cli/routes/profiles.set.$profile.ts

@@ -0,0 +1,46 @@
+import { HTTPException } from "hono/http-exception"
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const setHelp = `funnel profiles <name> set — update a profile
+
+usage: funnel profiles <name> set [--path <path>] [--sub-agent <agent>] [--channel <channel-name>]`
+
+export const profilesSetHandler = factory.createHandlers(
+  zValidator("param", z.object({ profile: z.string() })),
+  zValidator(
+    "query",
+    z.object({
+      path: z.string().optional(),
+      "sub-agent": z.string().optional(),
+      channel: z.string().optional(),
+    }),
+    setHelp,
+  ),
+  (c) => {
+    const param = c.req.valid("param")
+    const query = c.req.valid("query")
+    const funnel = c.var.funnel
+
+    let channelId: string | undefined
+
+    if (query.channel !== undefined) {
+      const channel = funnel.channels.get(query.channel)
+
+      if (!channel) {
+        throw new HTTPException(400, { message: `channel "${query.channel}" not found` })
+      }
+
+      channelId = channel.id
+    }
+
+    funnel.profiles.update(param.profile, {
+      path: query.path,
+      subAgent: query["sub-agent"],
+      channelId,
+    })
+
+    return c.text(`updated profile "${param.profile}"`)
+  },
+)

package/lib/cli/routes/profiles.ts

@@ -0,0 +1,40 @@
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const groupHelp = `funnel profiles — manage launch profiles
+
+usage: funnel profiles [subcommand]
+
+subcommands:
+  (none)                          list (first entry is the default)
+  add <name> --path <path> --sub-agent <agent> --channel <channel>
+  <name> set [--path ...] [--sub-agent ...] [--channel ...]
+  <name> as-default               move profile to the front (becomes default)
+  rename <old> <new>              rename
+  remove <name>                   remove
+  <name> run                      launch (sugar for fnl claude -p <name>)
+  <name>                          launch (alias for run)
+
+examples:
+  funnel profiles add cto --path /repo/myapp --sub-agent cto --channel prod-inbox
+  funnel profiles cto as-default
+  funnel profiles cto run`
+
+export const profilesGroupHandler = factory.createHandlers(
+  zValidator("query", z.object({}), groupHelp),
+  (c) => {
+    const funnel = c.var.funnel
+    const profiles = funnel.profiles.list()
+
+    if (profiles.length === 0) return c.text("no profiles")
+
+    const lines = profiles.map((profile, index) => {
+      const tag = index === 0 ? " (default)" : ""
+
+      return `${profile.name}${tag}  [path=${profile.path}, sub-agent=${profile.subAgent}, channel=${profile.channelId}]`
+    })
+
+    return c.text(lines.join("\n"))
+  },
+)

package/lib/cli/routes/status.ts

@@ -0,0 +1,93 @@
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { zValidator } from "@/cli/router/validator"
+
+export const statusHelp = `funnel status — show overall connection status
+
+usage: funnel status
+
+Lists configured connectors / channels / profiles, gateway running status,
+and active MCP WebSocket clients.`
+
+type GatewayClient = { channel: string; connectors: string[] }
+
+type GatewayStatus = {
+  ok: boolean
+  clients: GatewayClient[]
+}
+
+const isGatewayStatus = (value: unknown): value is GatewayStatus => {
+  if (value === null || typeof value !== "object") return false
+  if (!("clients" in value) || !Array.isArray(value.clients)) return false
+
+  return value.clients.every(
+    (client: unknown) =>
+      typeof client === "object" &&
+      client !== null &&
+      "channel" in client &&
+      typeof client.channel === "string" &&
+      "connectors" in client &&
+      Array.isArray(client.connectors),
+  )
+}
+
+export const statusHandler = factory.createHandlers(
+  zValidator("query", z.object({}), statusHelp),
+  async (c) => {
+    const funnel = c.var.funnel
+    const channels = funnel.channels.list()
+    const profiles = funnel.profiles.list()
+    const gatewayStatus = funnel.gateway.getStatus()
+
+    const lines: string[] = []
+
+    lines.push("= funnel status =")
+    lines.push("")
+
+    lines.push(`channels: ${channels.length}`)
+    for (const ch of channels) {
+      const attached =
+        ch.connectors.length > 0
+          ? ch.connectors.map((c) => `${c.name}:${c.type}`).join(", ")
+          : "(none)"
+      lines.push(`  - ${ch.name} [${attached}]`)
+    }
+    lines.push("")
+
+    lines.push(`profiles: ${profiles.length}`)
+    for (const [index, profile] of profiles.entries()) {
+      const tag = index === 0 ? " (default)" : ""
+      const channel = funnel.channels.getById(profile.channelId)
+      const channelLabel = channel ? channel.name : `id:${profile.channelId}`
+
+      lines.push(
+        `  - ${profile.name}${tag} [path=${profile.path}, sub-agent=${profile.subAgent}, channel=${channelLabel}]`,
+      )
+    }
+    lines.push("")
+
+    if (!gatewayStatus.running) {
+      lines.push("gateway: not running")
+    } else {
+      lines.push(`gateway: running (pid ${gatewayStatus.pid}, port ${gatewayStatus.port})`)
+
+      const res = await fetch(`http://localhost:${gatewayStatus.port}/status`).catch(() => null)
+
+      if (res && res.ok) {
+        const body: unknown = await res.json()
+
+        if (isGatewayStatus(body)) {
+          lines.push(`  clients: ${body.clients.length}`)
+
+          for (const client of body.clients) {
+            const connectorList =
+              client.connectors.length > 0 ? client.connectors.join(", ") : "(none)"
+            lines.push(`    - channel=${client.channel || "(unset)"} [${connectorList}]`)
+          }
+        }
+      }
+    }
+
+    return c.text(lines.join("\n"))
+  },
+)

package/lib/cli/routes/update.ts

@@ -0,0 +1,27 @@
+import { HTTPException } from "hono/http-exception"
+import { z } from "zod"
+import { factory } from "@/cli/factory"
+import { NodeFunnelProcessRunner } from "@/engine/process/node-process-runner"
+import { zValidator } from "@/cli/router/validator"
+
+export const updateHelp = `funnel update — update funnel to the latest version
+
+usage: funnel update
+
+Runs "bun i -g @interactive-inc/claude-funnel".`
+
+const PACKAGE = "@interactive-inc/claude-funnel"
+
+export const updateHandler = factory.createHandlers(
+  zValidator("query", z.object({}), updateHelp),
+  async (c) => {
+    const runner = new NodeFunnelProcessRunner()
+    const exitCode = await runner.attach(["bun", "i", "-g", PACKAGE])
+
+    if (exitCode !== 0) {
+      throw new HTTPException(500, { message: `update failed (exit ${exitCode})` })
+    }
+
+    return c.text(`updated ${PACKAGE}`)
+  },
+)

package/lib/connectors/connector-config-schema.ts

@@ -0,0 +1,16 @@
+import { z } from "zod"
+import { discordConnectorSchema } from "@/connectors/discord-connector-schema"
+import { ghConnectorSchema } from "@/connectors/gh-connector-schema"
+import { scheduleConnectorSchema } from "@/connectors/schedule-connector-schema"
+import { slackConnectorSchema } from "@/connectors/slack-connector-schema"
+
+export const connectorConfigSchema = z.discriminatedUnion("type", [
+  slackConnectorSchema,
+  ghConnectorSchema,
+  discordConnectorSchema,
+  scheduleConnectorSchema,
+])
+
+export type ConnectorConfig = z.infer<typeof connectorConfigSchema>
+
+export type ConnectorType = ConnectorConfig["type"]

package/lib/connectors/connector-factory.ts

@@ -0,0 +1,94 @@
+import type { FunnelConnectorAdapter } from "@/connectors/connector-adapter"
+import type { ConnectorConfig } from "@/connectors/connector-config-schema"
+import type { FunnelConnectorListener } from "@/connectors/connector-listener"
+import { FunnelDiscordAdapter } from "@/connectors/discord-adapter"
+import { FunnelDiscordListener } from "@/connectors/discord-listener"
+import { FunnelGhAdapter } from "@/connectors/gh-adapter"
+import { FunnelGhListener } from "@/connectors/gh-listener"
+import { FunnelScheduleListener } from "@/connectors/schedule-listener"
+import { ScheduleStateStore } from "@/connectors/schedule-state-store"
+import { FunnelSlackAdapter } from "@/connectors/slack-adapter"
+import { FunnelSlackListener } from "@/connectors/slack-listener"
+import { FunnelFileSystem } from "@/engine/fs/file-system"
+import { NodeFunnelFileSystem } from "@/engine/fs/node-file-system"
+import { FunnelLogger } from "@/engine/logger/logger"
+import { NodeFunnelLogger } from "@/engine/logger/node-logger"
+import { FunnelProcessRunner } from "@/engine/process/process-runner"
+import { NodeFunnelProcessRunner } from "@/engine/process/node-process-runner"
+import { FUNNEL_DIR } from "@/engine/settings/settings-store"
+import { join } from "node:path"
+
+type Deps = {
+  fs?: FunnelFileSystem
+  process?: FunnelProcessRunner
+  logger?: FunnelLogger
+  dir?: string
+}
+
+const defaultFs = new NodeFunnelFileSystem()
+const defaultProcess = new NodeFunnelProcessRunner()
+const defaultLogger = new NodeFunnelLogger()
+
+/**
+ * Pure factory for per-type listeners and adapters. The factory has no CRUD
+ * responsibility — connector configs live inside settings.json under their
+ * channel, and FunnelChannels passes them in by value.
+ *
+ * `dir` is the funnel home (defaults to ~/.funnel); per-connector state files
+ * land at `<dir>/channels/<channel-id>/connectors/<connector-id>/state.json`.
+ */
+export class FunnelConnectorFactory {
+  private readonly fs: FunnelFileSystem
+  private readonly process: FunnelProcessRunner
+  private readonly logger: FunnelLogger
+  private readonly dir: string
+
+  constructor(deps: Deps = {}) {
+    this.fs = deps.fs ?? defaultFs
+    this.process = deps.process ?? defaultProcess
+    this.logger = deps.logger ?? defaultLogger
+    this.dir = deps.dir ?? FUNNEL_DIR
+    Object.freeze(this)
+  }
+
+  createListener(channelId: string, config: ConnectorConfig): FunnelConnectorListener {
+    if (config.type === "slack") {
+      return new FunnelSlackListener({ config, logger: this.logger })
+    }
+
+    if (config.type === "gh") {
+      return new FunnelGhListener({ config, process: this.process, logger: this.logger })
+    }
+
+    if (config.type === "discord") {
+      return new FunnelDiscordListener({ config, logger: this.logger })
+    }
+
+    const lastFiredStore = new ScheduleStateStore({
+      path: join(this.connectorDir(channelId, config.id), "state.json"),
+      fs: this.fs,
+    })
+
+    return new FunnelScheduleListener({
+      config,
+      lastFiredStore,
+      logger: this.logger,
+    })
+  }
+
+  createAdapter(config: ConnectorConfig): FunnelConnectorAdapter | null {
+    if (config.type === "slack") return new FunnelSlackAdapter({ config })
+    if (config.type === "gh") return new FunnelGhAdapter({ process: this.process })
+    if (config.type === "discord") return new FunnelDiscordAdapter({ config })
+
+    return null
+  }
+
+  connectorDir(channelId: string, connectorId: string): string {
+    return join(this.dir, "channels", channelId, "connectors", connectorId)
+  }
+
+  channelDir(channelId: string): string {
+    return join(this.dir, "channels", channelId)
+  }
+}