@interactive-inc/claude-funnel 0.59.0 → 0.60.0

package/dist/{funnel-docs-ng5K8w4j.js → funnel-docs-BxXZ9Ksx.js}

@@ -1,5 +1,5 @@
 //#endregion
-//#region lib/services/docs/funnel-docs.ts
+//#region lib/engine/docs/funnel-docs.ts
 const DOCS = {
 	architecture: `funnel docs architecture — how Funnel routes events
 
@@ -492,8 +492,12 @@ Hono app over these services.
 ── facade ──────────────────────────────────────────────────────────────────
 
   import { Funnel } from "@interactive-inc/claude-funnel"
+  import { slackConnector } from "@interactive-inc/claude-funnel/connectors/slack"
 
-  const funnel = new Funnel()             // uses ~/.funnel
+  // Connectors are fully DI: pass only the types you use. The core import never
+  // bundles a connector SDK (@slack/bolt, discord.js) — importing the sub-entry
+  // does. With no connectors, the funnel handles zero connector types.
+  const funnel = new Funnel({ connectors: [slackConnector()] })  // uses ~/.funnel
   const sandbox = Funnel.inMemory()        // touches no disk / process / clock
 
   funnel.paths                            // { dir, tmpDir, settings }
@@ -534,6 +538,72 @@ For targeted imports (smaller bundle / clearer dependency footprint):
   import { FunnelGatewayServer } from "@interactive-inc/claude-funnel/gateway"
   import { FunnelProfiles }      from "@interactive-inc/claude-funnel/profiles"
   import { FunnelLocalConfig }   from "@interactive-inc/claude-funnel/local-config"
+  import { slackConnector }      from "@interactive-inc/claude-funnel/connectors/slack"
+  import { ghConnector }         from "@interactive-inc/claude-funnel/connectors/gh"
+  import { discordConnector }    from "@interactive-inc/claude-funnel/connectors/discord"
+  import { scheduleConnector }   from "@interactive-inc/claude-funnel/connectors/schedule"
+
+  // Connector launch hooks are closed over by the descriptor factory:
+  //   slackConnector({ onAppCreated, preprocessEvent })
+  //   scheduleConnector({ onFired })
+
+── in-process gateway: receive events in your own process ──────────────────
+
+The daemon (funnel.gateway.start()) runs in a separate process, so your code
+cannot observe its events directly. To receive events in-process, host the
+gateway yourself with gatewayServer():
+
+  import { Funnel, channelWsUrl } from "@interactive-inc/claude-funnel"
+  import { slackConnector } from "@interactive-inc/claude-funnel/connectors/slack"
+
+  const funnel = new Funnel({ connectors: [slackConnector()] })
+  funnel.channels.add({ name: "inbox" })
+  funnel.channels.addConnector("inbox", {
+    type: "slack", name: "ops",
+    botTokenEnv: "SLACK_BOT_TOKEN", appTokenEnv: "SLACK_APP_TOKEN",
+  })
+
+  const server = funnel.gatewayServer({ port: 9742 })
+  await server.start()                    // boots listeners, binds HTTP + WS
+  server.port                             // resolved port (use port: 0 to auto-assign)
+
+  const unsubscribe = server.onEvent((event) => {
+    console.log(event.content, event.meta, event.offset)
+  })
+
+  await funnel.publisher.publish("inbox", { content: "hello" })
+
+  unsubscribe()
+  await server.stop()                    // stops listeners, closes the socket
+
+To observe a daemon (separate process) instead, connect a WebSocket client:
+
+  const url = channelWsUrl({ base: "ws://127.0.0.1:9743/ws", channel: "inbox" })
+  const ws = new WebSocket(url, channelWsProtocols(token))
+
+── publishing: publisher.publish vs server emit ────────────────────────────
+
+  funnel.publisher.publish(channel, req)  // HTTP hop to the daemon; works from
+                                          // any process; returns { state: "ok" |
+                                          // "offline" | "error" }
+  server.emit(event)                      // direct in-process injection into a
+                                          // gatewayServer() you host yourself;
+                                          // no HTTP, no offline state
+
+Rule of thumb: talking to the shared daemon → publish; hosting the gateway
+in your own process → emit (or publish against your own port).
+
+── error handling: two deliberate styles ───────────────────────────────────
+
+  - Engine CRUD (channels / profiles / localConfig) THROWS. A failure there is
+    a programming or configuration error (duplicate name, unknown channel) —
+    let it surface, or try/catch at your boundary.
+  - Gateway clients (publisher / listeners / gateway / recovery) return result
+    objects like { state: "ok" | "offline" | "error" } or { ok, actions }. A
+    daemon being down is an expected runtime state, not an exception.
+
+If a method talks over HTTP to a daemon that might not be running, expect a
+result object; otherwise expect a throw.
 
 ── building your own CLI ───────────────────────────────────────────────────
 
@@ -541,8 +611,11 @@ The Funnel CLI is a Hono app you can embed:
 
   import { cliRoutes, toRequest } from "@interactive-inc/claude-funnel"
   import { Funnel } from "@interactive-inc/claude-funnel"
+  import { slackConnector } from "@interactive-inc/claude-funnel/connectors/slack"
+  import { ghConnector } from "@interactive-inc/claude-funnel/connectors/gh"
 
-  const funnel = new Funnel()
+  // List every connector type your CLI's "channels ... connectors" commands accept.
+  const funnel = new Funnel({ connectors: [slackConnector(), ghConnector()] })
   const { method, url } = toRequest(process.argv.slice(2))
   const res = await cliRoutes.request(url, { method }, { funnel })
 

package/dist/{funnel-docs-DYBs1-H_.d.ts → funnel-docs-CNklHvbt.d.ts}

@@ -1,4 +1,4 @@
-//#region lib/services/docs/funnel-docs.d.ts
+//#region lib/engine/docs/funnel-docs.d.ts
 type DocsTopicListing = {
   name: string;
   summary: string;

package/dist/{funnel-doctor-vxO96TCA.d.ts → funnel-doctor-CZf_0Luq.d.ts}

@@ -1,5 +1,5 @@
-import { c as FunnelDiagnostics, n as DiagnoseAllReport, t as ChannelDiagnosis } from "./funnel-diagnostics-K-wON25Y.js";
-import { n as RecoveryAction, t as FunnelRecovery } from "./funnel-recovery-COExL9MD.js";
+import { c as FunnelDiagnostics, n as DiagnoseAllReport, t as ChannelDiagnosis } from "./funnel-diagnostics-DpXOsCty.js";
+import { n as RecoveryAction, t as FunnelRecovery } from "./funnel-recovery-DnLrdWO9.js";
 
 //#region lib/services/doctor/funnel-doctor.d.ts
 type Props = {

package/dist/{funnel-recovery-COExL9MD.d.ts → funnel-recovery-DnLrdWO9.d.ts}

@@ -1,4 +1,4 @@
-import { t as ChannelConfig } from "./settings-schema-1hh11jnN.js";
+import { t as ChannelConfig } from "./settings-schema-D1xcOqRu.js";
 
 //#region lib/services/recovery/funnel-recovery.d.ts
 /** Narrow gateway control — start / stop / restart and a probe. */