@interactive-inc/claude-funnel 0.2.0

package/lib/routes/gateway/run.ts

@@ -0,0 +1,35 @@
+import { resolve } from "node:path"
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/gateway/run.help"
+
+export const gatewayRunHandler = factory.createHandlers(
+  zValidator(
+    "query",
+    z.object({
+      "no-caffeine": z.string().optional(),
+    }),
+    help,
+  ),
+  async (c) => {
+    const query = c.req.valid("query")
+    const gatewayScript = resolve(import.meta.dir, "../../modules/gateway/daemon.ts")
+
+    const useCaffeinate = query["no-caffeine"] !== "true" && process.platform === "darwin"
+    const command = useCaffeinate
+      ? ["caffeinate", "-i", "bun", gatewayScript]
+      : ["bun", gatewayScript]
+
+    const proc = Bun.spawn(command, {
+      stdio: ["inherit", "inherit", "inherit"],
+    })
+
+    process.on("SIGINT", () => proc.kill("SIGINT"))
+    process.on("SIGTERM", () => proc.kill("SIGTERM"))
+
+    const exitCode = await proc.exited
+
+    process.exit(exitCode)
+  },
+)

package/lib/routes/gateway/start.help.ts

@@ -0,0 +1,15 @@
+export const help = `funnel gateway start — start the gateway in background
+
+usage: funnel gateway start [--no-caffeine]
+
+Daemonized with nohup, so it keeps running after the terminal is closed.
+On macOS wraps the process with caffeinate -i by default to prevent idle sleep.
+Use --no-caffeine to disable caffeinate.
+
+port: 9742 (override via FUNNEL_PORT)
+pid:  ~/.funnel/gateway.pid
+log:  /tmp/funnel/gateway.log
+
+examples:
+  funnel gateway start
+  funnel gateway start --no-caffeine`

package/lib/routes/gateway/start.ts

@@ -0,0 +1,32 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/gateway/start.help"
+
+export const gatewayStartHandler = factory.createHandlers(
+  zValidator(
+    "query",
+    z.object({
+      "no-caffeine": z.string().optional(),
+    }),
+    help,
+  ),
+  async (c) => {
+    const query = c.req.valid("query")
+    const funnel = c.var.funnel
+
+    if (funnel.gateway.isRunning()) {
+      const status = funnel.gateway.getStatus()
+
+      return c.text(`funnel gateway: already running (pid ${status.pid})`)
+    }
+
+    const started = await funnel.gateway.start({
+      caffeinate: query["no-caffeine"] !== "true",
+    })
+
+    return started
+      ? c.text("funnel gateway: started")
+      : c.text("funnel gateway: failed to start", 500)
+  },
+)

package/lib/routes/gateway/status.help.ts

@@ -0,0 +1,9 @@
+export const help = `funnel gateway status — show gateway running status
+
+usage: funnel gateway status
+
+When running, prints PID, port, and connected channel count. When not running, exits with 503.
+
+examples:
+  funnel gateway status
+  funnel gateway`

package/lib/routes/gateway/status.ts

@@ -0,0 +1,28 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/gateway/status.help"
+
+export const gatewayStatusHandler = factory.createHandlers(
+  zValidator("query", z.object({}), help),
+  async (c) => {
+    const funnel = c.var.funnel
+    const status = funnel.gateway.getStatus()
+
+    if (!status.running) {
+      return c.text("funnel gateway: not running", 503)
+    }
+
+    const res = await fetch(`http://localhost:${status.port}/health`).catch(() => null)
+
+    if (!res) {
+      return c.text(`funnel gateway: running (pid ${status.pid}) — health check failed`)
+    }
+
+    const health = (await res.json()) as Record<string, unknown>
+
+    return c.text(
+      `funnel gateway: running (pid ${status.pid})\n  port: ${status.port}\n  clients: ${health.clients ?? 0}`,
+    )
+  },
+)

package/lib/routes/gateway/stop.help.ts

@@ -0,0 +1,8 @@
+export const help = `funnel gateway stop — stop the gateway
+
+usage: funnel gateway stop
+
+Terminates the process whose PID is stored in ~/.funnel/gateway.pid.
+
+examples:
+  funnel gateway stop`

package/lib/routes/gateway/stop.ts

@@ -0,0 +1,21 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/gateway/stop.help"
+
+export const gatewayStopHandler = factory.createHandlers(
+  zValidator("query", z.object({}), help),
+  async (c) => {
+    const funnel = c.var.funnel
+
+    if (!funnel.gateway.isRunning()) {
+      return c.text("funnel gateway: no running process")
+    }
+
+    const stopped = await funnel.gateway.stop()
+
+    return stopped
+      ? c.text("funnel gateway: stopped")
+      : c.text("funnel gateway: failed to stop", 500)
+  },
+)

package/lib/routes/repos/add.help.ts

@@ -0,0 +1,5 @@
+export const help = `funnel repos add — add a repo
+
+usage: funnel repos add <name> --path <path>
+
+Writes the funnel MCP server into the .mcp.json of the given directory.`

package/lib/routes/repos/add.ts

@@ -0,0 +1,19 @@
+import { resolve } from "node:path"
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/repos/add.help"
+
+export const reposAddHandler = factory.createHandlers(
+  zValidator("param", z.object({ name: z.string() })),
+  zValidator("query", z.object({ path: z.string() }), help),
+  (c) => {
+    const param = c.req.valid("param")
+    const query = c.req.valid("query")
+    const funnel = c.var.funnel
+
+    funnel.repositories.add({ name: param.name, path: resolve(query.path) })
+
+    return c.text(`added repo "${param.name}"`)
+  },
+)

package/lib/routes/repos/group.help.ts

@@ -0,0 +1,11 @@
+export const help = `funnel repos — manage repositories (extra)
+
+usage: funnel repos [subcommand]
+
+subcommands:
+  (none)                   list
+  add <name> --path <p>    add (writes funnel into .mcp.json)
+  <name> set --path <p>    change path
+  rename <old> <new>       rename
+  remove <name>            remove
+  <name>                   show details`

package/lib/routes/repos/group.ts

@@ -0,0 +1,18 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/repos/group.help"
+
+export const reposGroupHandler = factory.createHandlers(
+  zValidator("query", z.object({}), help),
+  (c) => {
+    const funnel = c.var.funnel
+    const repos = funnel.repositories.list()
+
+    if (repos.length === 0) return c.text("no repos")
+
+    const lines = repos.map((repo) => `${repo.name}  ${repo.path}`)
+
+    return c.text(lines.join("\n"))
+  },
+)

package/lib/routes/repos/remove.help.ts

@@ -0,0 +1,3 @@
+export const help = `funnel repos remove — remove a repo
+
+usage: funnel repos remove <name>`

package/lib/routes/repos/remove.ts

@@ -0,0 +1,17 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/repos/remove.help"
+
+export const reposRemoveHandler = factory.createHandlers(
+  zValidator("param", z.object({ name: z.string() })),
+  zValidator("query", z.object({}), help),
+  (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+
+    funnel.repositories.remove(param.name)
+
+    return c.text(`removed repo "${param.name}"`)
+  },
+)

package/lib/routes/repos/rename.help.ts

@@ -0,0 +1,5 @@
+export const help = `funnel repos rename — rename a repo
+
+usage:
+  funnel repos rename <old> <new>
+  funnel repos <old> rename <new>`

package/lib/routes/repos/rename.ts

@@ -0,0 +1,17 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/repos/rename.help"
+
+export const reposRenameHandler = factory.createHandlers(
+  zValidator("param", z.object({ name: z.string(), newName: z.string() })),
+  zValidator("query", z.object({}), help),
+  (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+
+    funnel.repositories.rename(param.name, param["newName"])
+
+    return c.text(`renamed repo "${param.name}" to "${param["newName"]}"`)
+  },
+)

package/lib/routes/repos/routes.ts

@@ -0,0 +1,17 @@
+import { factory } from "@/factory"
+import { reposAddHandler } from "@/routes/repos/add"
+import { reposGroupHandler } from "@/routes/repos/group"
+import { reposRemoveHandler } from "@/routes/repos/remove"
+import { reposRenameHandler } from "@/routes/repos/rename"
+import { reposSetHandler } from "@/routes/repos/set"
+import { reposShowHandler } from "@/routes/repos/show"
+
+export const reposRoutes = factory
+  .createApp()
+  .get("/", ...reposGroupHandler)
+  .put("/:name/rename/:newName", ...reposRenameHandler)
+  .put("/rename/:name/:newName", ...reposRenameHandler)
+  .post("/:name", ...reposAddHandler)
+  .put("/:name", ...reposSetHandler)
+  .delete("/:name", ...reposRemoveHandler)
+  .get("/:name", ...reposShowHandler)

package/lib/routes/repos/set.help.ts

@@ -0,0 +1,5 @@
+export const help = `funnel repos <name> set — update a repo
+
+usage: funnel repos <name> set --path <path>
+
+When the path changes, the old path's .mcp.json has funnel MCP removed and the new path has it written.`

package/lib/routes/repos/set.ts

@@ -0,0 +1,21 @@
+import { resolve } from "node:path"
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/repos/set.help"
+
+export const reposSetHandler = factory.createHandlers(
+  zValidator("param", z.object({ name: z.string() })),
+  zValidator("query", z.object({ path: z.string().optional() }), help),
+  (c) => {
+    const param = c.req.valid("param")
+    const query = c.req.valid("query")
+    const funnel = c.var.funnel
+
+    funnel.repositories.update(param.name, {
+      path: query.path !== undefined ? resolve(query.path) : undefined,
+    })
+
+    return c.text(`updated repo "${param.name}"`)
+  },
+)

package/lib/routes/repos/show.help.ts

@@ -0,0 +1 @@
+export const help = `funnel repos <name> — show repo details`

package/lib/routes/repos/show.ts

@@ -0,0 +1,19 @@
+import { HTTPException } from "hono/http-exception"
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/repos/show.help"
+
+export const reposShowHandler = factory.createHandlers(
+  zValidator("param", z.object({ name: z.string() })),
+  zValidator("query", z.object({}), help),
+  (c) => {
+    const param = c.req.valid("param")
+    const funnel = c.var.funnel
+    const repo = funnel.repositories.get(param.name)
+
+    if (!repo) throw new HTTPException(404, { message: `repo "${param.name}" not found` })
+
+    return c.text(`name: ${repo.name}\npath: ${repo.path}`)
+  },
+)

package/lib/routes/status/routes.ts

@@ -0,0 +1,4 @@
+import { factory } from "@/factory"
+import { statusHandler } from "@/routes/status/status"
+
+export const statusRoutes = factory.createApp().get("/", ...statusHandler)

package/lib/routes/status/status.help.ts

@@ -0,0 +1,6 @@
+export const help = `funnel status — show overall connection status
+
+usage: funnel status
+
+Lists configured connectors / channels / agents / repos, gateway running status,
+and active MCP WebSocket clients.`

package/lib/routes/status/status.ts

@@ -0,0 +1,77 @@
+import { z } from "zod"
+import { factory } from "@/factory"
+import { zValidator } from "@/modules/router/validator"
+import { help } from "@/routes/status/status.help"
+
+type GatewayStatus = {
+  ok: boolean
+  clients: { channel: string; connectors: string[] }[]
+}
+
+export const statusHandler = factory.createHandlers(
+  zValidator("query", z.object({}), help),
+  async (c) => {
+    const funnel = c.var.funnel
+    const connectors = funnel.connectors.list()
+    const channels = funnel.channels.list()
+    const agents = funnel.agents.list()
+    const repos = funnel.repositories.list()
+    const gatewayStatus = funnel.gateway.getStatus()
+
+    const lines: string[] = []
+
+    lines.push("= funnel status =")
+    lines.push("")
+
+    lines.push(`connectors: ${connectors.length}`)
+    for (const con of connectors) {
+      lines.push(`  - ${con.name} (${con.type})`)
+    }
+    lines.push("")
+
+    lines.push(`channels: ${channels.length}`)
+    for (const ch of channels) {
+      const attached = ch.connectors.length > 0 ? ch.connectors.join(", ") : "(none)"
+      lines.push(`  - ${ch.name} [${attached}]`)
+    }
+    lines.push("")
+
+    lines.push(`agents: ${agents.length}`)
+    for (const agent of agents) {
+      const parts = [`channel=${agent.channel}`]
+
+      if (agent.repo) parts.push(`repo=${agent.repo}`)
+      if (agent.subAgent) parts.push(`subAgent=${agent.subAgent}`)
+
+      lines.push(`  - ${agent.name} [${parts.join(", ")}]`)
+    }
+    lines.push("")
+
+    lines.push(`repos: ${repos.length}`)
+    for (const repo of repos) {
+      lines.push(`  - ${repo.name}  ${repo.path}`)
+    }
+    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 = (await res.json()) as GatewayStatus
+        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/routes.ts

@@ -0,0 +1,36 @@
+import { HTTPException } from "hono/http-exception"
+import { factory } from "@/factory"
+import { Funnel } from "@/funnel"
+import { FunnelSettingsStore } from "@/modules/settings/funnel-settings-store"
+import { agentsRoutes } from "@/routes/agents/routes"
+import { channelsRoutes } from "@/routes/channels/routes"
+import { claudeRoutes } from "@/routes/claude/routes"
+import { connectorsRoutes } from "@/routes/connectors/routes"
+import { gatewayRoutes } from "@/routes/gateway/routes"
+import { reposRoutes } from "@/routes/repos/routes"
+import { statusRoutes } from "@/routes/status/routes"
+
+const base = factory.createApp()
+
+base.use((c, next) => {
+  c.set("funnel", new Funnel({ store: new FunnelSettingsStore() }))
+
+  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)
+})
+
+export const app = base
+  .route("/claude", claudeRoutes)
+  .route("/connectors", connectorsRoutes)
+  .route("/channels", channelsRoutes)
+  .route("/repos", reposRoutes)
+  .route("/agents", agentsRoutes)
+  .route("/gateway", gatewayRoutes)
+  .route("/status", statusRoutes)

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@interactive-inc/claude-funnel",
+  "version": "0.2.0",
+  "description": "Hub CLI that routes external events (Slack / GitHub / Discord) to Claude Code agents through subscription channels over MCP.",
+  "license": "MIT",
+  "author": "Interactive Inc.",
+  "homepage": "https://github.com/interactive-inc/claude-funnel#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/interactive-inc/claude-funnel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/interactive-inc/claude-funnel/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "slack",
+    "discord",
+    "github",
+    "cli",
+    "bun"
+  ],
+  "type": "module",
+  "module": "lib/index.ts",
+  "bin": {
+    "fnl": "./lib/index.ts",
+    "funnel": "./lib/index.ts"
+  },
+  "files": [
+    "lib/**/*.ts",
+    "lib/**/*.tsx",
+    "!lib/**/*.test.ts",
+    "!lib/**/*.test.tsx",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "dependencies": {
+    "@hono/zod-validator": "^0.7.6",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@opentui/core": "^0.1.97",
+    "@opentui/react": "^0.1.97",
+    "@slack/bolt": "^4.7.0",
+    "@slack/web-api": "^7.15.0",
+    "@tanstack/react-query": "^5.99.0",
+    "@types/react": "^19.2.14",
+    "discord.js": "^14.26.3",
+    "hono": "^4.12.12",
+    "react": "^19.2.5",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.12",
+    "@typescript/native-preview": "^7.0.0-dev.20260411.1",
+    "vite-plus": "^0.1.18"
+  }
+}