@interactive-inc/claude-funnel 0.7.1 → 0.8.1

package/lib/modules/mcp/channel-server.ts

@@ -1,76 +0,0 @@
-import { Server } from "@modelcontextprotocol/sdk/server/index.js"
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
-import { FUNNEL_MCP_NAME } from "@/modules/mcp/funnel-mcp"
-
-const GATEWAY_WS_URL = process.env.FUNNEL_GATEWAY_URL ?? "ws://localhost:9742/ws"
-const RECONNECT_DELAY = 1000
-const MAX_RECONNECT_DELAY = 10000
-
-export const startChannelServer = async (): Promise<void> => {
-  const server = new Server(
-    { name: FUNNEL_MCP_NAME, version: "1.0.0" },
-    {
-      capabilities: {
-        experimental: { "claude/channel": {} },
-      },
-      instructions: [
-        `Events arrive inside <channel source="${FUNNEL_MCP_NAME}"> tags. Use meta.event_type to discriminate.`,
-        "",
-        "To reply or act on an event, run `funnel request <platform> --help` via the Bash tool (e.g. `funnel request slack --help`). For general CLI usage, run `funnel --help`.",
-      ].join("\n"),
-    },
-  )
-
-  const transport = new StdioServerTransport()
-
-  await server.connect(transport)
-
-  const channelId = process.env.FUNNEL_CHANNEL_ID
-
-  if (!channelId) return
-
-  const wsUrl = `${GATEWAY_WS_URL}?channel=${encodeURIComponent(channelId)}`
-  let reconnectDelay = RECONNECT_DELAY
-
-  const connect = () => {
-    const ws = new WebSocket(wsUrl)
-
-    ws.addEventListener("open", () => {
-      reconnectDelay = RECONNECT_DELAY
-      process.stderr.write(`funnel: connected (${wsUrl})\n`)
-    })
-
-    ws.addEventListener("message", async (event) => {
-      try {
-        const payload = JSON.parse(String(event.data))
-        const eventType = payload.meta?.event_type ?? "unknown"
-
-        process.stderr.write(`funnel: received event (${eventType})\n`)
-
-        await server.notification({
-          method: "notifications/claude/channel",
-          params: {
-            content: payload.content,
-            meta: payload.meta,
-          },
-        })
-      } catch (error) {
-        process.stderr.write(
-          `funnel: error: ${error instanceof Error ? error.message : String(error)}\n`,
-        )
-      }
-    })
-
-    ws.addEventListener("close", () => {
-      process.stderr.write(`funnel: disconnected, reconnecting in ${reconnectDelay}ms\n`)
-      setTimeout(connect, reconnectDelay)
-      reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY)
-    })
-
-    ws.addEventListener("error", () => {
-      // close handler will reconnect
-    })
-  }
-
-  connect()
-}

package/lib/modules/profiles/profile-channel-checker.ts

@@ -1,3 +0,0 @@
-export type ProfileChannelChecker = {
-  hasChannelRef(channelName: string): boolean
-}

package/lib/modules/profiles/profile-channel-ref-updater.ts

@@ -1,3 +0,0 @@
-export type ProfileChannelRefUpdater = {
-  renameChannelRef(oldName: string, newName: string): void
-}

package/lib/modules/repos/funnel-repositories.ts

@@ -1,112 +0,0 @@
-import type { FunnelMcp } from "@/modules/mcp/funnel-mcp"
-import { FunnelSettingsReader } from "@/modules/settings/funnel-settings-reader"
-import type { RepositoryConfig } from "@/modules/settings/settings-schema"
-
-type Deps = {
-  store: FunnelSettingsReader
-  mcp: FunnelMcp
-}
-
-/**
- * Repository registry. Each entry has a name + filesystem path; add/remove
- * also writes/removes the funnel MCP entry in `<path>/.mcp.json` so Claude Code
- * picks it up automatically when launched in that directory.
- */
-export class FunnelRepositories {
-  private readonly store: FunnelSettingsReader
-  private readonly mcp: FunnelMcp
-
-  constructor(deps: Deps) {
-    this.store = deps.store
-    this.mcp = deps.mcp
-    Object.freeze(this)
-  }
-
-  list(): RepositoryConfig[] {
-    return this.store.read().repositories
-  }
-
-  get(name: string): RepositoryConfig | null {
-    return this.list().find((r) => r.name === name) ?? null
-  }
-
-  add(config: RepositoryConfig): void {
-    const settings = this.store.read()
-
-    if (settings.repositories.some((r) => r.name === config.name)) {
-      throw new Error(`repo "${config.name}" already exists`)
-    }
-
-    this.mcp.install(config.path)
-
-    settings.repositories.push(config)
-
-    this.store.write(settings)
-  }
-
-  remove(name: string): void {
-    const settings = this.store.read()
-
-    const index = settings.repositories.findIndex((r) => r.name === name)
-
-    if (index < 0) throw new Error(`repo "${name}" not found`)
-
-    if (settings.profiles.some((p) => p.repo === name)) {
-      throw new Error(`repo "${name}" is referenced by a profile`)
-    }
-
-    const repo = settings.repositories[index]!
-
-    this.mcp.uninstall(repo.path)
-
-    settings.repositories.splice(index, 1)
-
-    this.store.write(settings)
-  }
-
-  rename(oldName: string, newName: string): void {
-    const settings = this.store.read()
-
-    const repo = settings.repositories.find((r) => r.name === oldName)
-
-    if (!repo) throw new Error(`repo "${oldName}" not found`)
-
-    if (settings.repositories.some((r) => r.name === newName)) {
-      throw new Error(`repo "${newName}" already exists`)
-    }
-
-    repo.name = newName
-
-    for (const profile of settings.profiles) {
-      if (profile.repo === oldName) profile.repo = newName
-    }
-
-    this.store.write(settings)
-  }
-
-  update(name: string, fields: Partial<Pick<RepositoryConfig, "path">>): void {
-    const settings = this.store.read()
-
-    const repo = settings.repositories.find((r) => r.name === name)
-
-    if (!repo) throw new Error(`repo "${name}" not found`)
-
-    if (fields.path !== undefined && fields.path !== repo.path) {
-      this.mcp.uninstall(repo.path)
-
-      this.mcp.install(fields.path)
-
-      repo.path = fields.path
-    }
-
-    this.store.write(settings)
-  }
-
-  resolvePath(name: string): string {
-    const repo = this.get(name)
-
-    if (!repo) throw new Error(`repo "${name}" not found`)
-
-    return repo.path
-  }
-}

package/lib/modules/schedule/funnel-schedule.ts

@@ -1,39 +0,0 @@
-import type { FunnelScheduleStore } from "@/modules/connectors/funnel-schedule-store"
-import type { ScheduleEntry } from "@/modules/connectors/schedule-connector-schema"
-
-type Deps = {
-  store: FunnelScheduleStore
-}
-
-/**
- * Cron entry CRUD for a schedule connector. The schedule connector itself
- * is created via `connectors.add({ type: "schedule", ... })`; this class
- * manages the JSONL entries inside it.
- */
-export class FunnelSchedule {
-  private readonly store: FunnelScheduleStore
-
-  constructor(deps: Deps) {
-    this.store = deps.store
-    Object.freeze(this)
-  }
-
-  listEntries(connector: string): ScheduleEntry[] {
-    const config = this.store.get(connector)
-
-    if (!config) throw new Error(`connector "${connector}" not found`)
-
-    return config.entries
-  }
-
-  addEntry(
-    connector: string,
-    entry: Omit<ScheduleEntry, "id"> & { id?: string },
-  ): ScheduleEntry {
-    return this.store.addEntry(connector, entry)
-  }
-
-  removeEntry(connector: string, id: string): void {
-    this.store.removeEntry(connector, id)
-  }
-}

package/lib/modules/settings/funnel-settings-store.ts

@@ -1,56 +0,0 @@
-import { homedir } from "node:os"
-import { dirname, join } from "node:path"
-import { FunnelFileSystem } from "@/modules/fs/funnel-file-system"
-import { NodeFunnelFileSystem } from "@/modules/fs/node-funnel-file-system"
-import { FunnelSettingsReader } from "@/modules/settings/funnel-settings-reader"
-import { settingsSchema } from "@/modules/settings/settings-schema"
-import type { Settings } from "@/modules/settings/settings-schema"
-
-export const FUNNEL_DIR = join(homedir(), ".funnel")
-export const SETTINGS_PATH = join(FUNNEL_DIR, "settings.json")
-
-type Deps = {
-  path?: string
-  fs?: FunnelFileSystem
-}
-
-const defaultFs = new NodeFunnelFileSystem()
-
-export class FunnelSettingsStore extends FunnelSettingsReader {
-  private readonly path: string
-  private readonly fs: FunnelFileSystem
-
-  constructor(deps: Deps = {}) {
-    super()
-    this.path = deps.path ?? SETTINGS_PATH
-    this.fs = deps.fs ?? defaultFs
-    Object.freeze(this)
-  }
-
-  read(): Settings {
-    if (!this.fs.existsSync(this.path)) {
-      return {
-        channels: [],
-        repositories: [],
-        profiles: [],
-      }
-    }
-
-    const content = this.fs.readFileSync(this.path)
-    const parsed = JSON.parse(content)
-    const result = settingsSchema.safeParse(parsed)
-
-    if (!result.success) {
-      throw new Error(
-        `invalid settings.json (${this.path}): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ")}`,
-      )
-    }
-
-    return result.data
-  }
-
-  write(settings: Settings): void {
-    this.fs.mkdirSync(dirname(this.path), { recursive: true })
-    this.fs.writeFileSync(this.path, `${JSON.stringify(settings, null, 2)}\n`)
-  }
-}

package/lib/modules/settings/settings-schema.ts

@@ -1,33 +0,0 @@
-import { z } from "zod"
-
-export const channelConfigSchema = z.object({
-  name: z.string(),
-  connectors: z.array(z.string()).default([]),
-})
-
-export type ChannelConfig = z.infer<typeof channelConfigSchema>
-
-export const repositoryConfigSchema = z.object({
-  name: z.string(),
-  path: z.string(),
-})
-
-export type RepositoryConfig = z.infer<typeof repositoryConfigSchema>
-
-export const profileConfigSchema = z.object({
-  name: z.string(),
-  channel: z.string(),
-  repo: z.string().optional(),
-  subAgent: z.string().optional(),
-  envFiles: z.array(z.string()).optional(),
-})
-
-export type ProfileConfig = z.infer<typeof profileConfigSchema>
-
-export const settingsSchema = z.object({
-  channels: z.array(channelConfigSchema).default([]),
-  repositories: z.array(repositoryConfigSchema).default([]),
-  profiles: z.array(profileConfigSchema).default([]),
-})
-
-export type Settings = z.infer<typeof settingsSchema>

package/lib/modules/tui/app.tsx

@@ -1,44 +0,0 @@
-import { useKeyboard, useRenderer, useTerminalDimensions } from "@opentui/react"
-
-const zinc = {
-  50: "#fafafa",
-  600: "#52525b",
-  950: "#09090b",
-} as const
-
-const LABEL = "funnel"
-
-export function App() {
-  const renderer = useRenderer()
-
-  const dimensions = useTerminalDimensions()
-
-  useKeyboard((key) => {
-    if (key.name === "q" || key.name === "escape" || (key.ctrl && key.name === "c")) {
-      renderer.destroy()
-    }
-  })
-
-  const marginLeft = Math.max(0, Math.floor((dimensions.width - LABEL.length) / 2))
-
-  const marginTop = Math.max(0, Math.floor(dimensions.height / 2) - 1)
-
-  return (
-    <box
-      style={{
-        width: "100%",
-        height: "100%",
-        flexDirection: "column",
-        backgroundColor: zinc[950],
-      }}
-    >
-      <box style={{ height: marginTop, backgroundColor: zinc[950] }} />
-      <text fg={zinc[50]} bg={zinc[950]} style={{ marginLeft }}>
-        {LABEL}
-      </text>
-      <text fg={zinc[600]} bg={zinc[950]} position="absolute" bottom={0}>
-        press q to quit
-      </text>
-    </box>
-  )
-}

package/lib/modules/tui/tui.tsx

@@ -1,13 +0,0 @@
-import { createCliRenderer } from "@opentui/core"
-import { createRoot } from "@opentui/react"
-import { App } from "@/modules/tui/app"
-
-export async function launchTui(): Promise<void> {
-  const renderer = await createCliRenderer()
-
-  createRoot(renderer).render(<App />)
-
-  await new Promise<void>((resolve) => {
-    renderer.once("destroy", () => resolve())
-  })
-}

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

@@ -1,3 +0,0 @@
-export const help = `funnel channels add — add a channel
-
-usage: funnel channels add <name> [--connector <c>]...`

package/lib/routes/channels/add.ts

@@ -1,21 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/add.help"
-
-export const channelsAddHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator("query", z.object({ connector: z.string().optional() }), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    funnel.channels.add({
-      name: param.name,
-      connectors: query.connector ? [query.connector] : [],
-    })
-
-    return c.text(`added channel "${param.name}"`)
-  },
-)

package/lib/routes/channels/connectors-attach.help.ts

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

package/lib/routes/channels/connectors-attach.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/connectors-attach.help"
-
-export const channelsConnectorsAttachHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string(), connector: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.channels.attachConnector(param.name, param.connector)
-
-    return c.text(`attached connector "${param.connector}" to channel "${param.name}"`)
-  },
-)

package/lib/routes/channels/connectors-detach.help.ts

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

package/lib/routes/channels/connectors-detach.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/connectors-detach.help"
-
-export const channelsConnectorsDetachHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string(), connector: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.channels.detachConnector(param.name, param.connector)
-
-    return c.text(`detached connector "${param.connector}" from channel "${param.name}"`)
-  },
-)

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

@@ -1,16 +0,0 @@
-export const help = `funnel channels — manage subscription boxes
-
-usage: funnel channels [subcommand]
-
-subcommands:
-  (none)                          list
-  add <name>                      add
-  remove <name>                   remove
-  <name>                          show details
-  <name> connectors attach <c>    subscribe to a connector
-  <name> connectors detach <c>    unsubscribe from a connector
-
-examples:
-  funnel channels add prod-inbox
-  funnel channels prod-inbox connectors attach prod-slack
-  funnel channels prod-inbox`

package/lib/routes/channels/group.ts

@@ -1,22 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/group.help"
-
-export const channelsGroupHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const funnel = c.var.funnel
-    const channels = funnel.channels.list()
-
-    if (channels.length === 0) return c.text("no channels")
-
-    const lines = channels.map((ch) => {
-      const connectors = ch.connectors.length > 0 ? ch.connectors.join(", ") : "(none)"
-
-      return `${ch.name} [${connectors}]`
-    })
-
-    return c.text(lines.join("\n"))
-  },
-)

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

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

package/lib/routes/channels/remove.ts

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

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

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

package/lib/routes/channels/rename.ts

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

package/lib/routes/channels/routes.ts

@@ -1,19 +0,0 @@
-import { factory } from "@/factory"
-import { channelsAddHandler } from "@/routes/channels/add"
-import { channelsConnectorsAttachHandler } from "@/routes/channels/connectors-attach"
-import { channelsConnectorsDetachHandler } from "@/routes/channels/connectors-detach"
-import { channelsGroupHandler } from "@/routes/channels/group"
-import { channelsRemoveHandler } from "@/routes/channels/remove"
-import { channelsRenameHandler } from "@/routes/channels/rename"
-import { channelsShowHandler } from "@/routes/channels/show"
-
-export const channelsRoutes = factory
-  .createApp()
-  .get("/", ...channelsGroupHandler)
-  .put("/:name/rename/:newName", ...channelsRenameHandler)
-  .put("/rename/:name/:newName", ...channelsRenameHandler)
-  .put("/:name/connectors/attach/:connector", ...channelsConnectorsAttachHandler)
-  .delete("/:name/connectors/detach/:connector", ...channelsConnectorsDetachHandler)
-  .post("/:name", ...channelsAddHandler)
-  .delete("/:name", ...channelsRemoveHandler)
-  .get("/:name", ...channelsShowHandler)

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

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

package/lib/routes/channels/show.ts

@@ -1,26 +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/channels/show.help"
-
-export const channelsShowHandler = 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 channel = funnel.channels.get(param.name)
-
-    if (!channel) {
-      throw new HTTPException(404, { message: `channel "${param.name}" not found` })
-    }
-
-    const lines = [
-      `name: ${channel.name}`,
-      `connectors: ${channel.connectors.length > 0 ? channel.connectors.join(", ") : "(none)"}`,
-    ]
-
-    return c.text(lines.join("\n"))
-  },
-)

package/lib/routes/claude/claude.help.ts

@@ -1,16 +0,0 @@
-export const help = `funnel claude — launch Claude Code
-
-usage:
-  funnel claude                          launch "default" profile (or the first profile)
-  funnel claude --profile <name>         launch a named profile
-  funnel claude --channel <name> [opts]  raw launch (no profile)
-
-options (override profile / raw):
-  --profile        profile name to launch
-  --channel        channel name to subscribe to
-  --repo           switch working directory to the named repo
-  --sub-agent      sub-agent name (passed to claude --agent)
-  --env-file       additional env file to load (relative path)
-
-Any other arguments are forwarded to the claude CLI.
-On launch the FUNNEL_CHANNEL_ID env var is set and MCP connects to the gateway.`