@interactive-inc/claude-funnel 0.4.1 → 0.8.0

package/lib/routes/connectors/rename.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/rename.help"
-
-export const connectorsRenameHandler = 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.connectors.rename(param.name, param["newName"])
-
-    return c.text(`renamed connector "${param.name}" to "${param["newName"]}"`)
-  },
-)

package/lib/routes/connectors/routes.ts

@@ -1,23 +0,0 @@
-import { factory } from "@/factory"
-import { connectorsAddHandler } from "@/routes/connectors/add"
-import { connectorsGroupHandler } from "@/routes/connectors/group"
-import { connectorsRemoveHandler } from "@/routes/connectors/remove"
-import { connectorsRenameHandler } from "@/routes/connectors/rename"
-import { connectorsSchedulesAddHandler } from "@/routes/connectors/schedules-add"
-import { connectorsSchedulesGroupHandler } from "@/routes/connectors/schedules-group"
-import { connectorsSchedulesRemoveHandler } from "@/routes/connectors/schedules-remove"
-import { connectorsSetHandler } from "@/routes/connectors/set"
-import { connectorsShowHandler } from "@/routes/connectors/show"
-
-export const connectorsRoutes = factory
-  .createApp()
-  .get("/", ...connectorsGroupHandler)
-  .put("/:name/rename/:newName", ...connectorsRenameHandler)
-  .put("/rename/:name/:newName", ...connectorsRenameHandler)
-  .post("/:name/schedules", ...connectorsSchedulesAddHandler)
-  .get("/:name/schedules", ...connectorsSchedulesGroupHandler)
-  .delete("/:name/schedules/:id", ...connectorsSchedulesRemoveHandler)
-  .post("/:name", ...connectorsAddHandler)
-  .put("/:name", ...connectorsSetHandler)
-  .delete("/:name", ...connectorsRemoveHandler)
-  .get("/:name", ...connectorsShowHandler)

package/lib/routes/connectors/schedules-add.help.ts

@@ -1,11 +0,0 @@
-export const help = `funnel connectors <name> schedules add — add a schedule entry
-
-usage: funnel connectors <name> schedules add --cron "<expr>" --prompt "<text>" [--disabled]
-
-options:
-  --cron        5-field cron expression (min hour dom month dow)
-  --prompt      prompt text delivered to subscribing channels when the cron fires
-  --disabled    create the entry in disabled state
-
-example:
-  funnel connectors my-cron schedules add --cron "*/5 * * * *" --prompt "status check"`

package/lib/routes/connectors/schedules-add.ts

@@ -1,33 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { matchCron } from "@/modules/connectors/match-cron"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/schedules-add.help"
-
-export const connectorsSchedulesAddHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator(
-    "query",
-    z.object({
-      cron: z.string(),
-      prompt: z.string(),
-      disabled: z.string().optional(),
-    }),
-    help,
-  ),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    matchCron(query.cron, new Date())
-
-    const entry = funnel.schedule.addEntry(param.name, {
-      cron: query.cron,
-      prompt: query.prompt,
-      enabled: query.disabled !== "true",
-    })
-
-    return c.text(`added schedule entry "${entry.id}" to connector "${param.name}"`)
-  },
-)

package/lib/routes/connectors/schedules-group.help.ts

@@ -1 +0,0 @@
-export const help = `funnel connectors <name> schedules — list schedule entries`

package/lib/routes/connectors/schedules-group.ts

@@ -1,38 +0,0 @@
-import { HTTPException } from "hono/http-exception"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/schedules-group.help"
-
-export const connectorsSchedulesGroupHandler = 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 connector = funnel.connectors.get(param.name)
-
-    if (!connector) {
-      throw new HTTPException(404, { message: `connector "${param.name}" not found` })
-    }
-
-    if (connector.type !== "schedule") {
-      throw new HTTPException(400, {
-        message: `connector "${param.name}" is type "${connector.type}", not "schedule"`,
-      })
-    }
-
-    const entries = funnel.schedule.listEntries(param.name)
-
-    if (entries.length === 0) return c.text("no schedule entries")
-
-    const lines: string[] = []
-
-    for (const entry of entries) {
-      const status = entry.enabled ? "" : " (disabled)"
-      lines.push(`${entry.id}${status}  ${entry.cron}  ${entry.prompt}`)
-    }
-
-    return c.text(lines.join("\n"))
-  },
-)

package/lib/routes/connectors/schedules-remove.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel connectors <name> schedules remove — remove a schedule entry
-
-usage: funnel connectors <name> schedules remove <id>`

package/lib/routes/connectors/schedules-remove.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/schedules-remove.help"
-
-export const connectorsSchedulesRemoveHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string(), id: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.schedule.removeEntry(param.name, param.id)
-
-    return c.text(`removed schedule entry "${param.id}" from connector "${param.name}"`)
-  },
-)

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

@@ -1,8 +0,0 @@
-export const help = `funnel connectors <name> set — update a connector
-
-usage: funnel connectors <name> set [--bot-token ...] [--app-token ...] [--poll-interval ...]
-
-fields available per type:
-  slack   : --bot-token / --app-token
-  gh      : --poll-interval
-  discord : --bot-token`

package/lib/routes/connectors/set.ts

@@ -1,72 +0,0 @@
-import { HTTPException } from "hono/http-exception"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/set.help"
-
-const SLACK_FIELDS = ["bot-token", "app-token"] as const
-const GH_FIELDS = ["poll-interval"] as const
-const DISCORD_FIELDS = ["bot-token"] as const
-
-const rejectExtraneous = (
-  query: Record<string, string | undefined>,
-  allowed: ReadonlyArray<string>,
-  type: string,
-): void => {
-  for (const key of ["bot-token", "app-token", "poll-interval"]) {
-    if (query[key] === undefined) continue
-    if (allowed.includes(key)) continue
-
-    throw new HTTPException(400, {
-      message: `connector type "${type}" does not accept --${key}`,
-    })
-  }
-}
-
-export const connectorsSetHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator(
-    "query",
-    z.object({
-      "bot-token": z.string().optional(),
-      "app-token": z.string().optional(),
-      "poll-interval": z.string().optional(),
-    }),
-    help,
-  ),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    const current = funnel.connectors.get(param.name)
-
-    if (!current) {
-      throw new HTTPException(404, { message: `connector "${param.name}" not found` })
-    }
-
-    if (current.type === "slack") {
-      rejectExtraneous(query, SLACK_FIELDS, "slack")
-      funnel.connectors.updateSlack(param.name, {
-        botToken: query["bot-token"],
-        appToken: query["app-token"],
-      })
-    } else if (current.type === "gh") {
-      rejectExtraneous(query, GH_FIELDS, "gh")
-      funnel.connectors.updateGh(param.name, {
-        pollInterval: query["poll-interval"] ? Number(query["poll-interval"]) : undefined,
-      })
-    } else if (current.type === "discord") {
-      rejectExtraneous(query, DISCORD_FIELDS, "discord")
-      funnel.connectors.updateDiscord(param.name, {
-        botToken: query["bot-token"],
-      })
-    } else {
-      throw new HTTPException(400, {
-        message: `schedule connectors have no top-level fields — use schedules add/remove`,
-      })
-    }
-
-    return c.text(`updated connector "${param.name}"`)
-  },
-)

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

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

package/lib/routes/connectors/show.ts

@@ -1,41 +0,0 @@
-import { HTTPException } from "hono/http-exception"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/show.help"
-
-export const connectorsShowHandler = 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 connector = funnel.connectors.get(param.name)
-
-    if (!connector) {
-      throw new HTTPException(404, { message: `connector "${param.name}" not found` })
-    }
-
-    const lines: string[] = [`name: ${connector.name}`, `type: ${connector.type}`]
-
-    if (connector.type === "slack") {
-      lines.push(`botToken: ${connector.botToken.slice(0, 8)}...`)
-      lines.push(`appToken: ${connector.appToken.slice(0, 8)}...`)
-    } else if (connector.type === "gh") {
-      lines.push(`pollInterval: ${connector.pollInterval ?? 60}s`)
-    } else if (connector.type === "discord") {
-      lines.push(`botToken: ${connector.botToken.slice(0, 8)}...`)
-    } else if (connector.type === "schedule") {
-      lines.push(`entries: ${connector.entries.length}`)
-
-      for (const entry of connector.entries) {
-        const status = entry.enabled ? "" : " (disabled)"
-        lines.push(`  - ${entry.id}${status}`)
-        lines.push(`      cron:   ${entry.cron}`)
-        lines.push(`      prompt: ${entry.prompt}`)
-      }
-    }
-
-    return c.text(lines.join("\n"))
-  },
-)

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

@@ -1,15 +0,0 @@
-export const help = `funnel gateway — manage the gateway
-
-usage: funnel gateway [subcommand]
-
-subcommands:
-  status              show running status (default)
-  start               start in background
-  stop                stop
-  restart             stop then start
-  run                 start in foreground (for developers)
-  logs [-n <N>]       show event logs
-
-examples:
-  funnel gateway                check status
-  funnel gateway restart        restart`

package/lib/routes/gateway/group.ts

@@ -1,28 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/gateway/group.help"
-
-export const gatewayGroupHandler = 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/logs.help.ts

@@ -1,13 +0,0 @@
-export const help = `funnel gateway logs — tail event logs
-
-usage: funnel gateway logs [-n <N>]
-
-options:
-  -n <N>                number of trailing lines to show (default: 20)
-
-Tails the latest /tmp/funnel/events/*.jsonl file. Exit with SIGINT.
-Output is formatted as YAML.
-
-examples:
-  funnel gateway logs
-  funnel gateway logs -n 100`

package/lib/routes/gateway/logs.ts

@@ -1,100 +0,0 @@
-import { readdirSync } from "node:fs"
-import { join } from "node:path"
-import { stringify } from "yaml"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { logger } from "@/modules/logger"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/gateway/logs.help"
-
-const tryParseJson = (s: string): unknown => {
-  try {
-    return JSON.parse(s)
-  } catch {
-    return null
-  }
-}
-
-export const gatewayLogsHandler = factory.createHandlers(
-  zValidator(
-    "query",
-    z.object({
-      n: z.string().optional(),
-    }),
-    help,
-  ),
-  async (c) => {
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-    const logDir = funnel.gateway.getLogDir()
-
-    const files = readdirSync(logDir)
-      .filter((name) => name.endsWith(".jsonl"))
-      .sort()
-
-    if (files.length === 0) {
-      return c.text("no logs")
-    }
-
-    const latestFile = join(logDir, files[files.length - 1]!)
-    const lineCount = query.n ? Number(query.n) : 20
-
-    const tail = Bun.spawn(["tail", "-f", "-n", String(lineCount), latestFile], {
-      stdout: "pipe",
-      stderr: "inherit",
-    })
-
-    const forward = (signal: "SIGINT" | "SIGTERM") => {
-      tail.kill(signal)
-    }
-
-    process.on("SIGINT", () => forward("SIGINT"))
-    process.on("SIGTERM", () => forward("SIGTERM"))
-
-    const reader = tail.stdout.getReader()
-    const decoder = new TextDecoder()
-    let buffer = ""
-
-    logger.info("gateway.logs tail start", { file: latestFile })
-
-    while (true) {
-      const result = await reader.read()
-
-      if (result.done) break
-
-      buffer += decoder.decode(result.value, { stream: true })
-
-      const lines = buffer.split("\n")
-      buffer = lines.pop() ?? ""
-
-      for (const line of lines) {
-        if (!line.trim()) continue
-
-        const entry = tryParseJson(line) as {
-          timestamp: string
-          eventType: string
-          meta?: unknown
-          content: string
-        } | null
-
-        if (!entry) {
-          process.stdout.write(`${line}\n`)
-          continue
-        }
-
-        const parsedContent = tryParseJson(entry.content) ?? entry.content
-        const output = {
-          time: entry.timestamp,
-          type: entry.eventType,
-          ...(entry.meta ? { meta: entry.meta } : {}),
-          content: parsedContent,
-        }
-
-        process.stdout.write(`---\n${stringify(output)}`)
-      }
-    }
-
-    await tail.exited
-    process.exit(0)
-  },
-)

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

@@ -1,10 +0,0 @@
-export const help = `funnel gateway restart — restart the gateway
-
-usage: funnel gateway restart [--no-caffeine]
-
-Stops the running process then starts it again in background.
-On macOS wraps with caffeinate -i by default. Use --no-caffeine to disable.
-
-examples:
-  funnel gateway restart
-  funnel gateway restart --no-caffeine`

package/lib/routes/gateway/routes.ts

@@ -1,18 +0,0 @@
-import { factory } from "@/factory"
-import { gatewayGroupHandler } from "@/routes/gateway/group"
-import { gatewayLogsHandler } from "@/routes/gateway/logs"
-import { gatewayRestartHandler } from "@/routes/gateway/restart"
-import { gatewayRunHandler } from "@/routes/gateway/run"
-import { gatewayStartHandler } from "@/routes/gateway/start"
-import { gatewayStatusHandler } from "@/routes/gateway/status"
-import { gatewayStopHandler } from "@/routes/gateway/stop"
-
-export const gatewayRoutes = factory
-  .createApp()
-  .get("/", ...gatewayGroupHandler)
-  .get("/status", ...gatewayStatusHandler)
-  .get("/start", ...gatewayStartHandler)
-  .get("/stop", ...gatewayStopHandler)
-  .get("/restart", ...gatewayRestartHandler)
-  .get("/run", ...gatewayRunHandler)
-  .get("/logs", ...gatewayLogsHandler)

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

@@ -1,12 +0,0 @@
-export const help = `funnel gateway run — run the gateway in foreground
-
-usage: funnel gateway run [--no-caffeine]
-
-For developers. The process is tied to the current terminal and exits on SIGINT / SIGTERM.
-On macOS wraps with caffeinate -i by default. Use --no-caffeine to disable.
-
-For normal usage prefer funnel gateway start.
-
-examples:
-  funnel gateway run
-  funnel gateway run --no-caffeine`

package/lib/routes/gateway/run.ts

@@ -1,35 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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

@@ -1,32 +0,0 @@
-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

@@ -1,9 +0,0 @@
-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

@@ -1,28 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,21 +0,0 @@
-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/profiles/add.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel profiles add — add a profile
-
-usage: funnel profiles add <name> --channel <ch> [--repo <r>] [--sub-agent <s>] [--env-file <f>]`