@interactive-inc/claude-funnel 0.7.1 → 0.8.0

package/lib/routes/claude/claude.ts

@@ -1,76 +0,0 @@
-import { HTTPException } from "hono/http-exception"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { queryToCliArgs } from "@/modules/router/query-to-cli-args"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/claude/claude.help"
-
-const RESERVED_KEYS = ["profile", "channel", "repo", "sub-agent", "env-file"]
-
-const DEFAULT_PROFILE_NAME = "default"
-
-export const claudeHandler = factory.createHandlers(
-  zValidator(
-    "query",
-    z
-      .object({
-        profile: z.string().optional(),
-        channel: z.string().optional(),
-        repo: z.string().optional(),
-        "sub-agent": z.string().optional(),
-        "env-file": z.string().optional(),
-      })
-      .passthrough(),
-    help,
-  ),
-  async (c) => {
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    if (query.profile) {
-      const profile = funnel.profiles.get(query.profile)
-
-      if (!profile) {
-        throw new HTTPException(404, { message: `profile "${query.profile}" not found` })
-      }
-
-      const exitCode = await funnel.claude.launch({
-        channel: query.channel ?? profile.channel,
-        repo: query.repo ?? profile.repo,
-        subAgent: query["sub-agent"] ?? profile.subAgent,
-        envFiles: query["env-file"] ? [query["env-file"]] : profile.envFiles,
-        userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-        profileName: profile.name,
-      })
-
-      process.exit(exitCode)
-    }
-
-    if (query.channel) {
-      const exitCode = await funnel.claude.launch({
-        channel: query.channel,
-        repo: query.repo,
-        subAgent: query["sub-agent"],
-        envFiles: query["env-file"] ? [query["env-file"]] : undefined,
-        userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-      })
-
-      process.exit(exitCode)
-    }
-
-    const defaultProfile = funnel.profiles.get(DEFAULT_PROFILE_NAME) ?? funnel.profiles.list()[0]
-
-    if (!defaultProfile) return c.text(help)
-
-    const exitCode = await funnel.claude.launch({
-      channel: defaultProfile.channel,
-      repo: query.repo ?? defaultProfile.repo,
-      subAgent: query["sub-agent"] ?? defaultProfile.subAgent,
-      envFiles: query["env-file"] ? [query["env-file"]] : defaultProfile.envFiles,
-      userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-      profileName: defaultProfile.name,
-    })
-
-    process.exit(exitCode)
-  },
-)

package/lib/routes/claude/routes.ts

@@ -1,4 +0,0 @@
-import { factory } from "@/factory"
-import { claudeHandler } from "@/routes/claude/claude"
-
-export const claudeRoutes = factory.createApp().get("/", ...claudeHandler)

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

@@ -1,28 +0,0 @@
-export const help = `funnel connectors add — add a connector
-
-usage:
-  funnel connectors add <name> --type slack    --bot-token xoxb-... --app-token xapp-...
-  funnel connectors add <name> --type gh       [--poll-interval <seconds>]
-  funnel connectors add <name> --type discord  --bot-token <discord-bot-token>
-  funnel connectors add <name> --type schedule
-
-slack (Socket Mode):
-  --bot-token             Slack Bot Token (starts with xoxb-)
-  --app-token             Slack App Token (starts with xapp-)
-
-gh (GitHub, gh CLI):
-  --poll-interval         polling interval for /notifications (seconds, default 60)
-  note: uses the gh CLI (must be authenticated via gh auth login); no token required
-
-discord (Discord Gateway):
-  --bot-token             Discord Bot Token
-
-schedule (cron-driven prompts):
-  no extra flags at connector level — add entries with:
-    funnel connectors <name> schedules add --cron "* * * * *" --prompt "..."
-
-examples:
-  funnel connectors add prod-slack --type slack --bot-token xoxb-... --app-token xapp-...
-  funnel connectors add my-gh --type gh --poll-interval 30
-  funnel connectors add my-discord --type discord --bot-token MTI...
-  funnel connectors add my-cron --type schedule`

package/lib/routes/connectors/add.ts

@@ -1,64 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/add.help"
-
-export const connectorsAddHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator(
-    "query",
-    z.discriminatedUnion("type", [
-      z.object({
-        type: z.literal("slack"),
-        "bot-token": z.string().startsWith("xoxb-"),
-        "app-token": z.string().startsWith("xapp-"),
-      }),
-      z.object({
-        type: z.literal("gh"),
-        "poll-interval": z.string().optional(),
-      }),
-      z.object({
-        type: z.literal("discord"),
-        "bot-token": z.string().min(10),
-      }),
-      z.object({
-        type: z.literal("schedule"),
-      }),
-    ]),
-    help,
-  ),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    if (query.type === "slack") {
-      funnel.connectors.add({
-        type: "slack",
-        name: param.name,
-        botToken: query["bot-token"],
-        appToken: query["app-token"],
-      })
-    } else if (query.type === "gh") {
-      funnel.connectors.add({
-        type: "gh",
-        name: param.name,
-        pollInterval: query["poll-interval"] ? Number(query["poll-interval"]) : undefined,
-      })
-    } else if (query.type === "discord") {
-      funnel.connectors.add({
-        type: "discord",
-        name: param.name,
-        botToken: query["bot-token"],
-      })
-    } else {
-      funnel.connectors.add({
-        type: "schedule",
-        name: param.name,
-        entries: [],
-      })
-    }
-
-    return c.text(`added connector "${param.name}"`)
-  },
-)

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

@@ -1,14 +0,0 @@
-export const help = `funnel connectors — manage external connections (Slack, etc.)
-
-usage: funnel connectors [subcommand]
-
-subcommands:
-  (none)                       list
-  add <name> --type slack --bot-token <t> --app-token <t>
-  remove <name>
-  <name>                       show details
-
-examples:
-  funnel connectors add prod-slack --type slack --bot-token xoxb-... --app-token xapp-...
-  funnel connectors
-  funnel connectors remove prod-slack`

package/lib/routes/connectors/group.ts

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

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

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

package/lib/routes/connectors/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/remove.help"
-
-export const connectorsRemoveHandler = 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.connectors.remove(param.name)
-
-    return c.text(`removed connector "${param.name}"`)
-  },
-)

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

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

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`