@interactive-inc/claude-funnel 0.4.1 → 0.8.0

package/lib/routes/profiles/add.ts

@@ -1,33 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/profiles/add.help"
-
-export const profilesAddHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator(
-    "query",
-    z.object({
-      channel: z.string(),
-      repo: z.string().optional(),
-      "sub-agent": z.string().optional(),
-      "env-file": z.string().optional(),
-    }),
-    help,
-  ),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    funnel.profiles.add({
-      name: param.name,
-      channel: query.channel,
-      repo: query.repo,
-      subAgent: query["sub-agent"],
-      envFiles: query["env-file"] ? [query["env-file"]] : undefined,
-    })
-
-    return c.text(`added profile "${param.name}"`)
-  },
-)

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

@@ -1,16 +0,0 @@
-export const help = `funnel profiles — manage launch profiles
-
-usage: funnel profiles [subcommand]
-
-subcommands:
-  (none)                          list
-  add <name> --channel <ch> [--repo <r>] [--sub-agent <s>] [--env-file <f>]
-  <name> set [--channel ...] [--repo ...] [--sub-agent ...] [--env-file ...]
-  rename <old> <new>              rename
-  remove <name>                   remove
-  <name> run                      launch (sugar for fnl claude)
-  <name>                          launch (alias for run)
-
-examples:
-  funnel profiles add cto --channel prod-inbox --repo myapp --sub-agent cto
-  funnel profiles cto run`

package/lib/routes/profiles/group.ts

@@ -1,25 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/profiles/group.help"
-
-export const profilesGroupHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (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) => {
-      const parts = [`channel=${profile.channel}`]
-
-      if (profile.repo) parts.push(`repo=${profile.repo}`)
-      if (profile.subAgent) parts.push(`subAgent=${profile.subAgent}`)
-
-      return `${profile.name}  [${parts.join(", ")}]`
-    })
-
-    return c.text(lines.join("\n"))
-  },
-)

package/lib/routes/profiles/launch.help.ts

@@ -1,4 +0,0 @@
-export const help = `funnel profiles <name> run — launch a profile (sugar for fnl claude)
-
-usage: funnel profiles <name> run [additional claude args...]
-       funnel profiles <name>     (alias)`

package/lib/routes/profiles/launch.ts

@@ -1,36 +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/profiles/launch.help"
-
-const RESERVED_KEYS = ["channel", "repo", "sub-agent", "env-file"]
-
-export const profilesLaunchHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator("query", z.object({}).passthrough(), help),
-  async (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-    const profile = funnel.profiles.get(param.name)
-
-    if (!profile) throw new HTTPException(404, { message: `profile "${param.name}" not found` })
-
-    const overrideChannel = c.req.query("channel")
-    const overrideRepo = c.req.query("repo")
-    const overrideSubAgent = c.req.query("sub-agent")
-    const overrideEnvFile = c.req.query("env-file")
-
-    const exitCode = await funnel.claude.launch({
-      channel: overrideChannel ?? profile.channel,
-      repo: overrideRepo ?? profile.repo,
-      subAgent: overrideSubAgent ?? profile.subAgent,
-      envFiles: overrideEnvFile ? [overrideEnvFile] : profile.envFiles,
-      userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-      profileName: profile.name,
-    })
-
-    process.exit(exitCode)
-  },
-)

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

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

package/lib/routes/profiles/remove.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/profiles/remove.help"
-
-export const profilesRemoveHandler = 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.profiles.remove(param.name)
-
-    return c.text(`removed profile "${param.name}"`)
-  },
-)

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

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

package/lib/routes/profiles/rename.ts

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

package/lib/routes/profiles/routes.ts

@@ -1,18 +0,0 @@
-import { factory } from "@/factory"
-import { profilesAddHandler } from "@/routes/profiles/add"
-import { profilesGroupHandler } from "@/routes/profiles/group"
-import { profilesLaunchHandler } from "@/routes/profiles/launch"
-import { profilesRemoveHandler } from "@/routes/profiles/remove"
-import { profilesRenameHandler } from "@/routes/profiles/rename"
-import { profilesSetHandler } from "@/routes/profiles/set"
-
-export const profilesRoutes = factory
-  .createApp()
-  .get("/", ...profilesGroupHandler)
-  .put("/:name/rename/:newName", ...profilesRenameHandler)
-  .put("/rename/:name/:newName", ...profilesRenameHandler)
-  .post("/:name", ...profilesAddHandler)
-  .put("/:name", ...profilesSetHandler)
-  .delete("/:name", ...profilesRemoveHandler)
-  .get("/:name/run", ...profilesLaunchHandler)
-  .get("/:name", ...profilesLaunchHandler)

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

@@ -1,5 +0,0 @@
-export const help = `funnel profiles <name> set — update a profile
-
-usage: funnel profiles <name> set [--channel <ch>] [--repo <r>] [--sub-agent <s>] [--env-file <f>]
-
-pass an empty string to --repo / --sub-agent to unset them.`

package/lib/routes/profiles/set.ts

@@ -1,32 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/profiles/set.help"
-
-export const profilesSetHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator(
-    "query",
-    z.object({
-      channel: z.string().optional(),
-      repo: z.string().optional(),
-      "sub-agent": z.string().optional(),
-      "env-file": z.string().optional(),
-    }),
-    help,
-  ),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    funnel.profiles.update(param.name, {
-      channel: query.channel,
-      repo: query.repo,
-      subAgent: query["sub-agent"],
-      envFiles: query["env-file"] !== undefined ? [query["env-file"]] : undefined,
-    })
-
-    return c.text(`updated profile "${param.name}"`)
-  },
-)

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

@@ -1,6 +0,0 @@
-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.
-When --path is omitted, the current working directory is used.`

package/lib/routes/repos/add.ts

@@ -1,20 +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/repos/add.help"
-
-export const reposAddHandler = 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
-    const path = resolve(query.path ?? process.cwd())
-
-    funnel.repositories.add({ name: param.name, path })
-
-    return c.text(`added repo "${param.name}"`)
-  },
-)

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

@@ -1,11 +0,0 @@
-export const help = `funnel repos — manage repositories (extra)
-
-usage: funnel repos [subcommand]
-
-subcommands:
-  (none)                   list
-  add <name> [--path <p>]  add (path defaults to cwd; 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

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

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

package/lib/routes/repos/remove.ts

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

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

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

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

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

@@ -1,21 +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/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

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

package/lib/routes/repos/show.ts

@@ -1,19 +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/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/request/discord-help.ts

@@ -1,9 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/request/discord.help"
-
-export const requestDiscordHelpHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (c) => c.text(help),
-)

package/lib/routes/request/discord.help.ts

@@ -1,19 +0,0 @@
-export const help = `funnel request discord — call the Discord REST API via a connector
-
-usage: funnel request discord <method> <path> [<json-body>] --connector <name>
-
-<method> is the HTTP verb (post / put / delete / patch / get).
-<path> is the Discord API path relative to https://discord.com/api/v10 (without leading /).
-<name> must match the connector's name (typically meta.connector on an inbound event).
-
-Reply only when meta.mentioned="true" unless instructed otherwise.
-
-examples (reply):
-  funnel request discord post channels/<meta.channel_id>/messages \\
-    '{"content":"...","message_reference":{"message_id":"<id>"}}' \\
-    --connector <meta.connector>
-
-examples (react / delete / edit):
-  funnel request discord put    channels/<cid>/messages/<mid>/reactions/<emoji>/@me --connector <name>
-  funnel request discord delete channels/<cid>/messages/<mid>                        --connector <name>
-  funnel request discord patch  channels/<cid>/messages/<mid> '{"content":"edit"}'   --connector <name>`

package/lib/routes/request/discord.ts

@@ -1,65 +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/request/discord.help"
-
-const ALLOWED_METHODS = new Set(["get", "post", "put", "patch", "delete"])
-
-const parseBody = (raw: string | undefined): unknown => {
-  if (!raw) return {}
-
-  try {
-    return JSON.parse(raw)
-  } catch (error) {
-    throw new HTTPException(400, {
-      message: `body is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
-    })
-  }
-}
-
-export const requestDiscordHandler = factory.createHandlers(
-  zValidator("param", z.object({ method: z.string() })),
-  zValidator(
-    "query",
-    z.object({
-      connector: z.string(),
-      path: z.string(),
-      body: z.string().optional(),
-    }),
-    help,
-  ),
-  async (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    const method = param.method.toLowerCase()
-
-    if (!ALLOWED_METHODS.has(method)) {
-      throw new HTTPException(400, {
-        message: `unsupported method "${param.method}" (allowed: ${[...ALLOWED_METHODS].join(", ")})`,
-      })
-    }
-
-    const connector = funnel.connectors.get(query.connector)
-
-    if (!connector) {
-      throw new HTTPException(404, { message: `connector "${query.connector}" not found` })
-    }
-
-    if (connector.type !== "discord") {
-      throw new HTTPException(400, {
-        message: `connector "${query.connector}" is type "${connector.type}", not "discord"`,
-      })
-    }
-
-    const result = await funnel.connectors.callDiscord(query.connector, {
-      method: method.toUpperCase(),
-      path: query.path,
-      body: parseBody(query.body),
-    })
-
-    return c.text(JSON.stringify(result, null, 2))
-  },
-)

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

@@ -1,15 +0,0 @@
-export const help = `funnel request — send an outbound API call via a connector
-
-usage: funnel request <platform> <method> <path> [<json-body>] --connector <name>
-
-platforms:
-  slack
-  discord
-
-examples:
-  funnel request slack   post chat.postMessage '{"channel":"...","text":"..."}' --connector my-slack
-  funnel request discord post channels/<cid>/messages '{"content":"..."}' --connector my-discord
-
-more:
-  funnel request slack   --help
-  funnel request discord --help`

package/lib/routes/request/group.ts

@@ -1,9 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/request/group.help"
-
-export const requestGroupHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (c) => c.text(help),
-)

package/lib/routes/request/routes.ts

@@ -1,14 +0,0 @@
-import { factory } from "@/factory"
-import { requestDiscordHandler } from "@/routes/request/discord"
-import { requestDiscordHelpHandler } from "@/routes/request/discord-help"
-import { requestGroupHandler } from "@/routes/request/group"
-import { requestSlackHandler } from "@/routes/request/slack"
-import { requestSlackHelpHandler } from "@/routes/request/slack-help"
-
-export const requestRoutes = factory
-  .createApp()
-  .get("/", ...requestGroupHandler)
-  .get("/slack", ...requestSlackHelpHandler)
-  .get("/slack/:method", ...requestSlackHandler)
-  .get("/discord", ...requestDiscordHelpHandler)
-  .get("/discord/:method", ...requestDiscordHandler)

package/lib/routes/request/slack-help.ts

@@ -1,9 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/request/slack.help"
-
-export const requestSlackHelpHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (c) => c.text(help),
-)

package/lib/routes/request/slack.help.ts

@@ -1,19 +0,0 @@
-export const help = `funnel request slack — call the Slack Web API via a connector
-
-usage: funnel request slack post <path> [<json-body>] --connector <name>
-
-Slack always uses POST. <path> is the Web API method name (e.g. chat.postMessage).
-<name> must match the connector's name (typically meta.connector on an inbound event).
-
-Reply only when meta.mentioned="true" unless instructed otherwise.
-
-examples (reply):
-  funnel request slack post chat.postMessage \\
-    '{"channel":"<meta.channel_id>","text":"...","thread_ts":"<meta.thread_ts>"}' \\
-    --connector <meta.connector>
-
-examples (edit / delete / react / lookup):
-  funnel request slack post chat.update       '{"channel":"...","ts":"...","text":"edit"}' --connector <name>
-  funnel request slack post chat.delete       '{"channel":"...","ts":"..."}' --connector <name>
-  funnel request slack post reactions.add     '{"channel":"...","timestamp":"...","name":"eyes"}' --connector <name>
-  funnel request slack post users.info        '{"user":"U..."}' --connector <name>`

package/lib/routes/request/slack.ts

@@ -1,61 +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/request/slack.help"
-
-const parseBody = (raw: string | undefined): unknown => {
-  if (!raw) return {}
-
-  try {
-    return JSON.parse(raw)
-  } catch (error) {
-    throw new HTTPException(400, {
-      message: `body is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
-    })
-  }
-}
-
-export const requestSlackHandler = factory.createHandlers(
-  zValidator("param", z.object({ method: z.string() })),
-  zValidator(
-    "query",
-    z.object({
-      connector: z.string(),
-      path: z.string(),
-      body: z.string().optional(),
-    }),
-    help,
-  ),
-  async (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    if (param.method.toLowerCase() !== "post") {
-      throw new HTTPException(400, {
-        message: `slack only supports POST (got "${param.method}")`,
-      })
-    }
-
-    const connector = funnel.connectors.get(query.connector)
-
-    if (!connector) {
-      throw new HTTPException(404, { message: `connector "${query.connector}" not found` })
-    }
-
-    if (connector.type !== "slack") {
-      throw new HTTPException(400, {
-        message: `connector "${query.connector}" is type "${connector.type}", not "slack"`,
-      })
-    }
-
-    const result = await funnel.connectors.callSlack(query.connector, {
-      method: "POST",
-      path: query.path,
-      body: parseBody(query.body),
-    })
-
-    return c.text(JSON.stringify(result, null, 2))
-  },
-)

package/lib/routes/status/routes.ts

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