@interactive-inc/claude-funnel 0.67.0 → 0.68.0

package/dist/{channels-BBA3GTAa.d.ts → channels-B0cifCfw.d.ts}

@@ -2,7 +2,8 @@ import { n as FunnelClock, t as FunnelLogger } from "./logger-mMZvblTx.js";
 import { n as FunnelFileSystem } from "./file-system-BNtl997T.js";
 import { n as ChannelDeliveryMode, t as ChannelConfig } from "./settings-schema-B-CKLuST.js";
 import { n as FunnelIdGenerator, t as FunnelSettingsReader } from "./settings-reader-CyTpbAre.js";
-import { A as FunnelConnectorListener, F as BaseConnectorConfig, M as CallInput, N as FunnelConnectorAdapter, c as FunnelHttpClient, g as ConnectorDiagnosticLog, n as ConnectorBuildContext, o as ConnectorOperationContext, r as ConnectorDescriptor, s as ConnectorUpdateContext, z as FunnelProcessRunner } from "./connector-descriptor-F75ZI8Fh.js";
+import { b as FunnelProcessRunner, c as FunnelHttpClient, d as FunnelConnectorListener, g as BaseConnectorConfig, m as FunnelConnectorAdapter, n as ConnectorBuildContext, o as ConnectorOperationContext, p as CallInput, r as ConnectorDescriptor, s as ConnectorUpdateContext } from "./connector-descriptor-D4XtEsH8.js";
+import { o as ConnectorDiagnosticLog } from "./diagnostic-log-BsAg5qZK.js";
 //#region lib/engine/connectors/connector-registry.d.ts
 type Deps$1 = {
   /** Connector types this funnel handles. Each is a self-describing descriptor;

package/dist/claude.d.ts

@@ -1,6 +1,6 @@
 import { n as FunnelFileSystem } from "./file-system-BNtl997T.js";
-import { a as ProcessGuard, c as ChannelResolver, i as SessionStore, n as FunnelClaude, o as McpInstaller, r as LaunchOptions, s as GatewayController, t as FunnelFileProcessGuard } from "./file-process-guard-DAYe9Ndt.js";
-import { r as ConnectorDescriptor } from "./connector-descriptor-F75ZI8Fh.js";
+import { a as ProcessGuard, c as ChannelResolver, i as SessionStore, n as FunnelClaude, o as McpInstaller, r as LaunchOptions, s as GatewayController, t as FunnelFileProcessGuard } from "./file-process-guard-D-QatrwL.js";
+import { r as ConnectorDescriptor } from "./connector-descriptor-D4XtEsH8.js";
 import { t as FunnelProfiles } from "./profiles-CePRnv3F.js";
 //#region lib/engine/mcp/mcp.d.ts
 declare const FUNNEL_MCP_COMMAND = "bun";

package/dist/claude.js

@@ -3,11 +3,11 @@ import { f as settingsSchema, s as resolveFunnelPort } from "./settings-store-ZF
 import { a as FunnelMcp, i as FUNNEL_MCP_NAME, n as FUNNEL_MCP_ARGS, o as FunnelFileProcessGuard, r as FUNNEL_MCP_COMMAND, s as FunnelClaude, t as renderYaml } from "./yaml-render-DxxRQT-V.js";
 import { t as FunnelProfiles } from "./profiles-KpN7_gBw.js";
 import { t as errorMessageOf } from "./error-message-of-BG4ezZ_s.js";
-import { t as FunnelDocs } from "./funnel-docs-BFcqITFA.js";
-import { t as discordConnector } from "./discord-connector-CdjwPoty.js";
-import { t as ghConnector } from "./gh-connector-D-iyjl-d.js";
-import { t as scheduleConnector } from "./schedule-connector-teeDMHUe.js";
-import { t as slackConnector } from "./slack-connector-BE0KAjCs.js";
+import { t as FunnelDocs } from "./funnel-docs-CI4hMkhq.js";
+import { t as discordConnector } from "./discord-connector-CAcWifJn.js";
+import { t as ghConnector } from "./gh-connector-DMwI6zJA.js";
+import { t as scheduleConnector } from "./schedule-connector-BXUOYgwZ.js";
+import { t as slackConnector } from "./slack-connector-CC3V2VXQ.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/connector-descriptor-D4XtEsH8.d.ts

@@ -0,0 +1,215 @@
+import { n as FunnelClock, t as FunnelLogger } from "./logger-mMZvblTx.js";
+import { n as FunnelFileSystem } from "./file-system-BNtl997T.js";
+import { o as ConnectorDiagnosticLog } from "./diagnostic-log-BsAg5qZK.js";
+import { z } from "zod";
+//#region lib/engine/process/process-runner.d.ts
+type RunOptions = {
+  cwd?: string;
+  env?: Record<string, string>;
+  input?: string;
+};
+type RunResult = {
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+};
+type AttachOptions = {
+  cwd?: string;
+  env?: Record<string, string>;
+  /** Invoked synchronously after the child process has been spawned, with its PID.
+   *  Useful for hosts that need to register the spawned process before it exits. */
+  onSpawned?: (pid: number) => void;
+};
+type DetachOptions = {
+  env?: Record<string, string>;
+  /** Append stdout to this file. Parent dir is the caller's responsibility. */
+  stdoutFile?: string;
+  /** Append stderr to this file. Parent dir is the caller's responsibility. */
+  stderrFile?: string;
+};
+type ProcessSnapshot = {
+  pid: number;
+  command: string;
+};
+/**
+ * Process boundary covering one-shot runs, sync runs, foreground attach, and
+ * detached background spawns. Default is NodeFunnelProcessRunner (Bun.spawn);
+ * MemoryFunnelProcessRunner records calls and lets tests stub responses.
+ *
+ * Liveness and process-listing helpers absorb POSIX/Windows differences so
+ * callers do not branch on `process.platform`. `isAlive` checks whether a PID
+ * names a live (non-zombie) process; `listProcessesContaining` enumerates
+ * processes whose command line includes `marker`, used for funnel-gateway tag
+ * matching across daemons that share a home dir. `getStartTime` returns a
+ * stable string identifying when a PID was started, used to detect PID reuse
+ * after the original process died abnormally (no exit hook fired).
+ */
+declare abstract class FunnelProcessRunner {
+  abstract run(command: string[], options?: RunOptions): Promise<RunResult>;
+  abstract runSync(command: string[]): RunResult;
+  abstract attach(command: string[], options?: AttachOptions): Promise<number>;
+  abstract detach(command: string[], options?: DetachOptions): void;
+  abstract kill(pid: number, signal?: string): void;
+  abstract isAlive(pid: number): boolean;
+  abstract listProcessesContaining(marker: string): ProcessSnapshot[];
+  abstract getStartTime(pid: number): string | null;
+}
+//#endregion
+//#region lib/engine/connectors/base-connector-config.d.ts
+/**
+ * Fields every connector config carries, regardless of type. The discriminated
+ * union of concrete connector configs no longer lives in core: each connector
+ * type owns its full schema inside its descriptor, and core handles connectors
+ * through this base shape plus the injected registry. `type` is an open string
+ * here on purpose — core does not enumerate the known connector types.
+ */
+declare const baseConnectorConfigSchema: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  type: z.ZodString;
+  createdAt: z.ZodOptional<z.ZodString>;
+  updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BaseConnectorConfig = z.infer<typeof baseConnectorConfigSchema>;
+//#endregion
+//#region lib/engine/connectors/connector-adapter.d.ts
+/**
+ * A JSON-serializable value. Connector call bodies are sent to external APIs as
+ * JSON, so the body must be representable as JSON — `JsonValue` says exactly
+ * that, replacing a bare `unknown` that let non-serializable values (functions,
+ * symbols, class instances) slip through to `JSON.stringify`.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+type CallInput = {
+  method: string;
+  path: string;
+  /** JSON request body. Omit for GET-like calls. */
+  body?: JsonValue;
+};
+declare abstract class FunnelConnectorAdapter {
+  /**
+   * Dispatches one Claude → external call. The response is the external API's
+   * raw payload, typed `unknown` because its shape is the provider's concern —
+   * the caller (Claude, via MCP) interprets it.
+   */
+  abstract call(input: CallInput): Promise<unknown>;
+}
+//#endregion
+//#region lib/engine/connectors/connector-listener.d.ts
+type NotifyFn = (content: string, meta?: Record<string, string>) => Promise<void>;
+/**
+ * Long-lived event source for one connector.
+ *
+ * `start()` opens the underlying connection (Slack Socket Mode, Discord
+ * Gateway, GH polling, schedule tick) and pushes events through `notify`.
+ * `stop()` releases the resources so the supervisor can recreate the listener
+ * with new config without restarting the whole gateway. `isAlive()` lets the
+ * supervisor periodically health-check and auto-restart dead listeners; the
+ * default optimistic implementation is fine for poll/tick-based listeners
+ * that self-heal.
+ */
+declare abstract class FunnelConnectorListener {
+  abstract start(notify: NotifyFn): Promise<void>;
+  abstract stop(): Promise<void>;
+  isAlive(): boolean;
+}
+//#endregion
+//#region lib/engine/http/http-client.d.ts
+type HttpRequest = {
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  body?: string;
+};
+type HttpResponse = {
+  status: number;
+  ok: boolean;
+  text(): Promise<string>;
+  json(): Promise<unknown>;
+};
+declare abstract class FunnelHttpClient {
+  abstract fetch(request: HttpRequest): Promise<HttpResponse>;
+}
+//#endregion
+//#region lib/engine/connectors/connector-descriptor.d.ts
+/** Boundaries a listener needs, supplied by the registry at build time. */
+type ConnectorListenerDeps = {
+  channelId: string;
+  fs: FunnelFileSystem;
+  process: FunnelProcessRunner;
+  /** HTTP client for self-detection (Slack auth.test), reactions, and other listener-side REST calls. */
+  http: FunnelHttpClient;
+  /** Wall clock — listeners that own a timer (schedule) read it from here so tests can inject a fake. */
+  clock: FunnelClock;
+  logger?: FunnelLogger;
+  diagnosticLog?: ConnectorDiagnosticLog;
+  /**
+   * Optional shutdown signal forwarded to flume-backed listeners. When the
+   * host aborts the signal, the listener's Flume tears down its WebSocket /
+   * fetch loop without waiting for the supervisor's `stop()`. Hosts that want
+   * a clean SIGTERM story wire `controller.signal` here and call
+   * `controller.abort()` in their shutdown handler.
+   */
+  signal?: AbortSignal;
+  /** Resolves the per-connector state directory (`<dir>/channels/<id>/connectors/<id>`). */
+  connectorDir: (channelId: string, connectorId: string) => string;
+};
+/** Boundaries an adapter needs. Adapters are channel-agnostic. */
+type ConnectorAdapterDeps = {
+  fs: FunnelFileSystem;
+  process: FunnelProcessRunner;
+  /** HTTP client for outbound calls. Used by the Slack adapter, future REST adapters. */
+  http: FunnelHttpClient;
+  logger?: FunnelLogger;
+};
+type ConnectorBuildContext = {
+  id: string;
+  now: string;
+};
+type ConnectorUpdateContext = {
+  now: string;
+};
+type ConnectorOperationContext = {
+  generateId: () => string;
+  now: string;
+};
+/**
+ * One named operation a connector type exposes beyond plain CRUD (e.g. schedule
+ * entry add/remove/list). Returns the next config and an arbitrary result; when
+ * the returned config is reference-equal to the input, the channels layer treats
+ * the call as a read and skips persistence.
+ */
+type ConnectorOperation = (props: {
+  config: BaseConnectorConfig;
+  args: unknown;
+  context: ConnectorOperationContext;
+}) => {
+  config: BaseConnectorConfig;
+  result: unknown;
+};
+/**
+ * Everything core needs to handle one connector type, without importing it. A
+ * descriptor accepts/returns `BaseConnectorConfig` at every boundary and parses
+ * to its concrete config internally (via `schema`), so the registry can hold a
+ * homogeneous `ConnectorDescriptor[]` with no variance gymnastics. Type-specific
+ * launch hooks (e.g. Schedule `onFired`) are closed over by the descriptor
+ * factory, not threaded through here. Each descriptor parses configs to its
+ * concrete shape internally (it owns its zod schema), so no schema is exposed
+ * here — that also sidesteps the variance trap of a `ZodType<Slack>` field
+ * declared as `ZodType<BaseConnectorConfig>`.
+ */
+type ConnectorDescriptor = {
+  type: string;
+  createListener: (config: BaseConnectorConfig, deps: ConnectorListenerDeps) => FunnelConnectorListener;
+  createAdapter: ((config: BaseConnectorConfig, deps: ConnectorAdapterDeps) => FunnelConnectorAdapter) | null;
+  /** Whether the MCP channel server exposes this type as a callable tool. */
+  toolExposed: boolean;
+  secretTokens: (config: BaseConnectorConfig) => string[];
+  buildConfig: (input: Record<string, unknown>, context: ConnectorBuildContext) => BaseConnectorConfig;
+  applyUpdate: (config: BaseConnectorConfig, fields: Record<string, unknown>, context: ConnectorUpdateContext) => BaseConnectorConfig;
+  operations: Record<string, ConnectorOperation>;
+};
+//#endregion
+export { RunResult as C, RunOptions as S, baseConnectorConfigSchema as _, ConnectorOperation as a, FunnelProcessRunner as b, FunnelHttpClient as c, FunnelConnectorListener as d, NotifyFn as f, BaseConnectorConfig as g, JsonValue as h, ConnectorListenerDeps as i, HttpRequest as l, FunnelConnectorAdapter as m, ConnectorBuildContext as n, ConnectorOperationContext as o, CallInput as p, ConnectorDescriptor as r, ConnectorUpdateContext as s, ConnectorAdapterDeps as t, HttpResponse as u, AttachOptions as v, ProcessSnapshot as x, DetachOptions as y };

package/dist/connectors/discord.d.ts

@@ -1,7 +1,8 @@
 import { t as FunnelLogger } from "../logger-mMZvblTx.js";
-import { M as CallInput, N as FunnelConnectorAdapter, c as FunnelHttpClient, g as ConnectorDiagnosticLog, j as NotifyFn, r as ConnectorDescriptor } from "../connector-descriptor-F75ZI8Fh.js";
+import { c as FunnelHttpClient, f as NotifyFn, m as FunnelConnectorAdapter, p as CallInput, r as ConnectorDescriptor } from "../connector-descriptor-D4XtEsH8.js";
+import { o as ConnectorDiagnosticLog } from "../diagnostic-log-BsAg5qZK.js";
 import { n as discordConnectorSchema, t as DiscordConnectorConfig } from "../discord-connector-schema-BaBZYHxK.js";
-import { t as FunnelFlumeSourceListener } from "../flume-source-listener-CLtsdcT2.js";
+import { t as FunnelFlumeSourceListener } from "../flume-source-listener-Ba8_1Mg-.js";
 import { FlumeRuntimeDeps } from "@interactive-inc/flume";
 //#region lib/engine/connectors/discord-adapter.d.ts
 type Deps$1 = {

package/dist/connectors/discord.js

@@ -1,3 +1,3 @@
 import { t as discordConnectorSchema } from "../discord-connector-schema-saAGuPmJ.js";
-import { i as FunnelDiscordAdapter, n as FunnelFlumeDiscordListener, r as FunnelDiscordEventProcessor, t as discordConnector } from "../discord-connector-CdjwPoty.js";
+import { i as FunnelDiscordAdapter, n as FunnelFlumeDiscordListener, r as FunnelDiscordEventProcessor, t as discordConnector } from "../discord-connector-CAcWifJn.js";
 export { FunnelDiscordAdapter, FunnelDiscordEventProcessor, FunnelFlumeDiscordListener, discordConnector, discordConnectorSchema };

package/dist/connectors/gh.d.ts

@@ -1,6 +1,7 @@
 import { t as FunnelLogger } from "../logger-mMZvblTx.js";
-import { M as CallInput, N as FunnelConnectorAdapter, g as ConnectorDiagnosticLog, j as NotifyFn, r as ConnectorDescriptor, z as FunnelProcessRunner } from "../connector-descriptor-F75ZI8Fh.js";
-import { t as FunnelFlumeSourceListener } from "../flume-source-listener-CLtsdcT2.js";
+import { b as FunnelProcessRunner, f as NotifyFn, m as FunnelConnectorAdapter, p as CallInput, r as ConnectorDescriptor } from "../connector-descriptor-D4XtEsH8.js";
+import { o as ConnectorDiagnosticLog } from "../diagnostic-log-BsAg5qZK.js";
+import { t as FunnelFlumeSourceListener } from "../flume-source-listener-Ba8_1Mg-.js";
 import { n as ghConnectorSchema, t as GhConnectorConfig } from "../gh-connector-schema-BrNsCl1T.js";
 import { FlumeRuntimeDeps } from "@interactive-inc/flume";
 //#region lib/engine/connectors/gh-adapter.d.ts

package/dist/connectors/gh.js

@@ -1,3 +1,3 @@
 import { t as ghConnectorSchema } from "../gh-connector-schema-DmZTrzUu.js";
-import { n as FunnelFlumeGhListener, r as FunnelGhAdapter, t as ghConnector } from "../gh-connector-D-iyjl-d.js";
+import { n as FunnelFlumeGhListener, r as FunnelGhAdapter, t as ghConnector } from "../gh-connector-DMwI6zJA.js";
 export { FunnelFlumeGhListener, FunnelGhAdapter, ghConnector, ghConnectorSchema };

package/dist/connectors/schedule.d.ts

@@ -1,17 +1,15 @@
 import { t as FunnelLogger } from "../logger-mMZvblTx.js";
 import { n as FunnelFileSystem } from "../file-system-BNtl997T.js";
-import { A as FunnelConnectorListener, g as ConnectorDiagnosticLog, j as NotifyFn, r as ConnectorDescriptor } from "../connector-descriptor-F75ZI8Fh.js";
-import { a as scheduleConnectorSchema, i as scheduleCatchupPolicySchema, n as ScheduleConnectorConfig, o as scheduleEntrySchema, r as ScheduleEntry, t as ScheduleCatchupPolicy } from "../schedule-connector-schema-DBko_Bf7.js";
+import { d as FunnelConnectorListener, f as NotifyFn, r as ConnectorDescriptor } from "../connector-descriptor-D4XtEsH8.js";
+import { o as ConnectorDiagnosticLog } from "../diagnostic-log-BsAg5qZK.js";
+import { a as ScheduleEntry, c as cronScheduleEntrySchema, d as scheduleConnectorSchema, f as scheduleEntryInputSchema, i as ScheduleConnectorConfig, l as onceScheduleEntrySchema, n as OnceScheduleEntry, o as ScheduleEntryInput, p as scheduleEntrySchema, r as ScheduleCatchupPolicy, s as cronExpressionSchema, t as CronScheduleEntry, u as scheduleCatchupPolicySchema } from "../schedule-connector-schema-Tq5kJul-.js";
 //#region lib/engine/connectors/match-cron.d.ts
+/** Throws with a user-facing reason when `expr` is not a supported cron expression. */
+declare const validateCronExpression: (expr: string) => void;
 /**
- * Returns true when `date` (local time) satisfies a 5-field cron expression.
- *
- * Two deliberate deviations from Vixie cron, called out so schedules are not
- * written expecting the other behavior:
- *   - Day-of-month and day-of-week are ANDed, not ORed. Vixie cron fires when
- *     EITHER matches once both are restricted; here every field must match.
- *   - Day-of-week is 0-6 (Sunday=0). `7` for Sunday is NOT accepted (it throws
- *     as out-of-range); use `0`.
+ * Returns true when `date` (local time) satisfies a standard 5-field cron
+ * expression. Sunday accepts both 0 and 7. When day-of-month and day-of-week
+ * are both restricted, either field matching is sufficient (Vixie cron).
  */
 declare const matchCron: (expr: string, date: Date) => boolean;
 //#endregion
@@ -69,11 +67,15 @@ declare class FunnelScheduleListener extends FunnelConnectorListener {
   isAlive(): boolean;
   tick(notify: NotifyFn): Promise<void>;
   private fireEntry;
+  private fireOnceEntry;
+  private fireCronEntry;
+  private seedSearchWatermark;
   private notifyOne;
   private findMostRecentMatch;
   private findAllMatches;
   private logInvalidCron;
   private truncateToMinute;
+  private pruneRemovedEntries;
 }
 //#endregion
 //#region lib/engine/connectors/schedule-connector.d.ts
@@ -90,4 +92,4 @@ type ScheduleConnectorOptions = {
  */
 declare const scheduleConnector: (options?: ScheduleConnectorOptions) => ConnectorDescriptor;
 //#endregion
-export { FunnelScheduleListener, FunnelScheduleStateStore, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleConnectorOptions, ScheduleEntry, ScheduleOnFired, matchCron, scheduleCatchupPolicySchema, scheduleConnector, scheduleConnectorSchema, scheduleEntrySchema };
+export { CronScheduleEntry, FunnelScheduleListener, FunnelScheduleStateStore, OnceScheduleEntry, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleConnectorOptions, ScheduleEntry, ScheduleEntryInput, ScheduleOnFired, cronExpressionSchema, cronScheduleEntrySchema, matchCron, onceScheduleEntrySchema, scheduleCatchupPolicySchema, scheduleConnector, scheduleConnectorSchema, scheduleEntryInputSchema, scheduleEntrySchema, validateCronExpression };

package/dist/connectors/schedule.js

@@ -1,3 +1,3 @@
-import { n as scheduleConnectorSchema, r as scheduleEntrySchema, t as scheduleCatchupPolicySchema } from "../schedule-connector-schema-C2AChpwX.js";
-import { i as matchCron, n as FunnelScheduleListener, r as FunnelScheduleStateStore, t as scheduleConnector } from "../schedule-connector-teeDMHUe.js";
-export { FunnelScheduleListener, FunnelScheduleStateStore, matchCron, scheduleCatchupPolicySchema, scheduleConnector, scheduleConnectorSchema, scheduleEntrySchema };
+import { a as scheduleConnectorSchema, c as matchCron, i as scheduleCatchupPolicySchema, l as validateCronExpression, n as cronScheduleEntrySchema, o as scheduleEntryInputSchema, r as onceScheduleEntrySchema, s as scheduleEntrySchema, t as cronExpressionSchema } from "../schedule-connector-schema-CNV8PgWX.js";
+import { n as FunnelScheduleListener, r as FunnelScheduleStateStore, t as scheduleConnector } from "../schedule-connector-BXUOYgwZ.js";
+export { FunnelScheduleListener, FunnelScheduleStateStore, cronExpressionSchema, cronScheduleEntrySchema, matchCron, onceScheduleEntrySchema, scheduleCatchupPolicySchema, scheduleConnector, scheduleConnectorSchema, scheduleEntryInputSchema, scheduleEntrySchema, validateCronExpression };

package/dist/connectors/slack.d.ts

@@ -1,6 +1,7 @@
 import { t as FunnelLogger } from "../logger-mMZvblTx.js";
-import { M as CallInput, N as FunnelConnectorAdapter, c as FunnelHttpClient, g as ConnectorDiagnosticLog, j as NotifyFn, r as ConnectorDescriptor } from "../connector-descriptor-F75ZI8Fh.js";
-import { t as FunnelFlumeSourceListener } from "../flume-source-listener-CLtsdcT2.js";
+import { c as FunnelHttpClient, f as NotifyFn, m as FunnelConnectorAdapter, p as CallInput, r as ConnectorDescriptor } from "../connector-descriptor-D4XtEsH8.js";
+import { o as ConnectorDiagnosticLog } from "../diagnostic-log-BsAg5qZK.js";
+import { t as FunnelFlumeSourceListener } from "../flume-source-listener-Ba8_1Mg-.js";
 import { a as SlackRawEvent, c as SlackMessageEvent, d as slackConnectorSchema, i as SlackProcessedSkip, l as SlackReactionEvent, n as SlackProcessed, o as SlackSkipReason, r as SlackProcessedEmit, s as SlackEvent, t as FunnelSlackEventProcessor, u as SlackConnectorConfig } from "../slack-event-processor-DmAlq4cV.js";
 import { FlumeRuntimeDeps } from "@interactive-inc/flume";
 //#region lib/engine/connectors/slack-adapter.d.ts

package/dist/connectors/slack.js

@@ -1,4 +1,4 @@
 import { t as slackConnectorSchema } from "../slack-connector-schema-EGVuuqSX.js";
 import { t as FunnelSlackEventProcessor } from "../slack-event-processor-Cs_YuI3w.js";
-import { n as FunnelFlumeSlackListener, r as FunnelSlackAdapter, t as slackConnector } from "../slack-connector-BE0KAjCs.js";
+import { n as FunnelFlumeSlackListener, r as FunnelSlackAdapter, t as slackConnector } from "../slack-connector-CC3V2VXQ.js";
 export { FunnelFlumeSlackListener, FunnelSlackAdapter, FunnelSlackEventProcessor, slackConnector, slackConnectorSchema };

package/dist/diagnostic-event-CxMM5Bl2.js

@@ -0,0 +1,78 @@
+//#region lib/services/diagnostics/diagnostic-event.ts
+const stringOrNull = (value) => typeof value === "string" && value.length > 0 ? value : null;
+const numberOrNull = (value) => typeof value === "number" ? value : null;
+const stringOr = (value, fallback) => typeof value === "string" ? value : fallback;
+const isStringKeyedObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const parsePayloadObject = (payload) => {
+	if (payload === null) return null;
+	try {
+		const parsed = JSON.parse(payload);
+		if (isStringKeyedObject(parsed)) return parsed;
+	} catch {
+		return null;
+	}
+	return null;
+};
+const truncate = (text, max) => text.length <= max ? text : `${text.slice(0, max)}…`;
+const previewOf = (payload) => {
+	if (typeof payload !== "string" || payload.length === 0) return null;
+	const parsed = parsePayloadObject(payload);
+	if (parsed !== null && "text" in parsed) return truncate(String(parsed.text), 60);
+	return truncate(payload, 60);
+};
+const toDiagnosticEvent = (row) => {
+	const payload = stringOrNull(row.payload);
+	return {
+		seq: numberOrNull(row.seq),
+		ts: numberOrNull(row.ts),
+		type: stringOr(row.type, "?"),
+		outcome: stringOr(row.outcome, "?"),
+		eventId: stringOrNull(row.event_id),
+		payload,
+		payloadParsed: parsePayloadObject(payload),
+		preview: previewOf(row.payload)
+	};
+};
+const toDiagnosticConnectionError = (row) => ({
+	seq: numberOrNull(row.seq),
+	ts: numberOrNull(row.ts),
+	type: stringOr(row.type, "?"),
+	status: stringOr(row.status, "?"),
+	detail: stringOrNull(row.detail)
+});
+const diagnosticEventOfProcessed = (event) => ({
+	seq: event.seq,
+	ts: event.ts,
+	type: event.type,
+	outcome: event.outcome,
+	eventId: event.eventId,
+	payload: stringOrNull(event.payload),
+	payloadParsed: parsePayloadObject(stringOrNull(event.payload)),
+	preview: previewOf(event.payload)
+});
+const diagnosticEventOfRaw = (event) => ({
+	seq: event.seq,
+	ts: event.ts,
+	type: event.type,
+	outcome: "",
+	eventId: event.eventId,
+	payload: stringOrNull(event.payload),
+	payloadParsed: parsePayloadObject(stringOrNull(event.payload)),
+	preview: previewOf(event.payload)
+});
+const diagnosticConnectionEventOf = (event) => ({
+	seq: event.seq,
+	ts: event.ts,
+	type: event.type,
+	status: event.status,
+	detail: stringOrNull(event.detail)
+});
+const queryRows = (reader, sql, params) => {
+	try {
+		return reader.query(sql, params);
+	} finally {
+		reader.close();
+	}
+};
+//#endregion
+export { queryRows as a, previewOf as i, diagnosticEventOfProcessed as n, toDiagnosticConnectionError as o, diagnosticEventOfRaw as r, toDiagnosticEvent as s, diagnosticConnectionEventOf as t };

package/dist/diagnostic-log-BsAg5qZK.d.ts

@@ -0,0 +1,186 @@
+import { z } from "zod";
+//#region lib/engine/diagnostic-log/diagnostic-log.d.ts
+/**
+ * Points in the listener's connection lifecycle. The single source of truth
+ * for the value set: the `status` column schema, the `ConnectorConnectionStatus`
+ * union, and the runtime Set used to narrow on read-back all derive from this
+ * array, so adding a status is a one-line change that cannot drift out of sync.
+ *
+ *   started       start() was called
+ *   connected     the socket opened and events can flow
+ *   disconnected  the socket was closed by a stop() call (a clean teardown)
+ *   auth-failed   the token was rejected before the socket opened
+ *   stopped       the listener was fully torn down (always follows a stop(),
+ *                 paired with the disconnected/error that preceded it)
+ *   error         start/stop threw, or Bolt surfaced an error frame — this is
+ *                 also where an unsolicited socket drop shows up when Bolt
+ *                 reports it (an `error` with no following `stopped` means the
+ *                 supervisor recycled the listener, not a clean stop)
+ *
+ * A connection row is independent of any single inbound event, so it carries
+ * no `eventId`. This is how "no notification arrived because the listener
+ * never connected (or dropped, or failed auth)" becomes visible: the
+ * raw/processed tables only hold events that *did* arrive.
+ */
+declare const CONNECTOR_CONNECTION_STATUSES: readonly ["started", "connected", "disconnected", "auth-failed", "stopped", "error"];
+type ConnectorConnectionStatus = (typeof CONNECTOR_CONNECTION_STATUSES)[number];
+/**
+ * Rows stored in the diagnostic tables. Connector-agnostic on purpose: `type`
+ * carries the listener kind ("slack" | "discord" | "gh" | "schedule") so new
+ * connectors land in the same tables without a schema change. `event_id` is
+ * the correlation key the listener mints once per inbound event and stamps
+ * onto both the raw and processed rows, so the two are joinable even though
+ * they live in separate tables with independent `seq` counters.
+ *
+ * These schemas mirror the stored shape (snake_case columns) the way
+ * `FunnelEvent` does for the replay log; they exist for `z.infer` and to
+ * document the column set, not as a parse boundary.
+ */
+declare const connectorRawEventSchema: z.ZodObject<{
+  event_id: z.ZodString;
+  type: z.ZodString;
+  connector_id: z.ZodNullable<z.ZodString>;
+  channel_id: z.ZodNullable<z.ZodString>;
+  payload: z.ZodString;
+}, z.core.$strip>;
+type ConnectorRawEvent = z.infer<typeof connectorRawEventSchema>;
+declare const connectorProcessedEventSchema: z.ZodObject<{
+  event_id: z.ZodString;
+  type: z.ZodString;
+  connector_id: z.ZodNullable<z.ZodString>;
+  channel_id: z.ZodNullable<z.ZodString>;
+  outcome: z.ZodString;
+  payload: z.ZodString;
+}, z.core.$strip>;
+type ConnectorProcessedEvent = z.infer<typeof connectorProcessedEventSchema>;
+declare const connectorConnectionEventSchema: z.ZodObject<{
+  type: z.ZodString;
+  connector_id: z.ZodNullable<z.ZodString>;
+  channel_id: z.ZodNullable<z.ZodString>;
+  status: z.ZodEnum<{
+    error: "error";
+    started: "started";
+    connected: "connected";
+    disconnected: "disconnected";
+    "auth-failed": "auth-failed";
+    stopped: "stopped";
+  }>;
+  detail: z.ZodString;
+}, z.core.$strip>;
+type ConnectorConnectionEvent = z.infer<typeof connectorConnectionEventSchema>;
+/** The connector a row belongs to — the axis every diagnostic table shares. */
+type ConnectorRef = {
+  type: string;
+  connectorId: string | null;
+  channelId: string | null;
+};
+/** A row tied to one inbound event, joinable to its twin by `eventId`. */
+type ConnectorEventKeys = ConnectorRef & {
+  /** Correlation id shared by the raw and processed rows of the same inbound event. */
+  eventId: string;
+};
+/** One untouched inbound event to persist, before any processing. */
+type ConnectorRawRecord = ConnectorEventKeys & {
+  /** The listener's untouched payload, already JSON-stringified by the caller. */
+  payload: string;
+};
+/** The processor's verdict for one inbound event. */
+type ConnectorProcessedRecord = ConnectorEventKeys & {
+  /**
+   * "emitted" on successful delivery, "emitted:delivery-failed" when the
+   * downstream notify threw, or "skip:<reason>" when the processor dropped it.
+   */
+  outcome: string;
+  /**
+   * The delivered body (content + meta) for an emitted event. For a skipped
+   * event there is no body, so the listener records the event JSON here
+   * instead — keeping a skipped row self-describing rather than blank.
+   */
+  payload: string;
+};
+type ConnectorConnectionRecord = ConnectorRef & {
+  status: ConnectorConnectionStatus;
+  /** Free-form context (an error message, a reason) or "" when none. */
+  detail: string;
+};
+/**
+ * Filters every table query accepts — the read-side mirror of `ConnectorRef`.
+ * Each per-table query extends this with its own table's column, the same way
+ * each record extends `ConnectorRef`, so neither half of the file treats one
+ * table's shape as the base for the others.
+ */
+type ConnectorQuery = {
+  type?: string;
+  connectorId?: string | null;
+  channelId?: string | null;
+  /** Match one table-local sequence number exactly. */
+  seq?: number;
+  /** Cap on returned rows. The most recent matching rows are returned, oldest first. */
+  limit?: number;
+};
+type ConnectorRawQuery = ConnectorQuery & {
+  eventId?: string;
+};
+type ConnectorProcessedQuery = ConnectorQuery & {
+  eventId?: string;
+  outcome?: string;
+  outcomePrefix?: string;
+};
+type ConnectorConnectionQuery = ConnectorQuery & {
+  status?: ConnectorConnectionStatus;
+  statuses?: ReadonlyArray<ConnectorConnectionStatus>;
+};
+/**
+ * A stored row, ascending by `seq`. `seq` is per-table (each table counts
+ * independently) and is for ordering within one table, not for correlating
+ * across them — use `eventId` to join raw and processed.
+ */
+type StoredRawEvent = ConnectorRawRecord & {
+  seq: number;
+  ts: number;
+};
+type StoredProcessedEvent = ConnectorProcessedRecord & {
+  seq: number;
+  ts: number;
+};
+type StoredConnectionEvent = ConnectorConnectionRecord & {
+  seq: number;
+  ts: number;
+};
+/**
+ * Three-table diagnostic log of everything a connector listener does, so
+ * "why was there no notification?" is answerable whichever way it failed:
+ *   - `raw` — every inbound event, before any filtering, with the listener's
+ *     untouched payload (the Slack Bolt event, the GH webhook, …)
+ *   - `processed` — the verdict for that event: `outcome` (emitted, or the
+ *     reason it was dropped) and, when emitted, the body that was delivered.
+ *     Shares an `eventId` with its raw row, so the two join into one story.
+ *   - `connection` — the listener's lifecycle (started, connected, dropped,
+ *     auth-failed, stopped, errored). This is the half the event tables can't
+ *     show: an event that never arrived leaves no raw row, but a listener that
+ *     never connected leaves a `connection` trail that says so.
+ *
+ * The three are physically separate (independent retention and payload-size
+ * policy) so a query never crosses them by accident and a huge raw payload
+ * never bloats the verdict or lifecycle trails. None flow to WS clients or the
+ * MCP channel — this is a separate store from `FunnelEventLog` (replay) and
+ * exists solely for debugging.
+ *
+ * Implementations:
+ *   - `SqliteConnectorDiagnosticLog` — the default; survives daemon restarts,
+ *     bounded by per-table row/age caps.
+ *   - `MemoryConnectorDiagnosticLog` — an in-process double for tests.
+ */
+declare abstract class ConnectorDiagnosticLog {
+  abstract recordRaw(record: ConnectorRawRecord): void;
+  abstract recordProcessed(record: ConnectorProcessedRecord): void;
+  abstract recordConnection(record: ConnectorConnectionRecord): void;
+  abstract queryRaw(query: ConnectorRawQuery): StoredRawEvent[];
+  abstract queryProcessed(query: ConnectorProcessedQuery): StoredProcessedEvent[];
+  abstract queryConnection(query: ConnectorConnectionQuery): StoredConnectionEvent[];
+  /** Drop every diagnostic row across all three tables and reclaim the files. */
+  abstract clear(): void;
+  abstract close(): void;
+}
+//#endregion
+export { connectorConnectionEventSchema as _, ConnectorConnectionStatus as a, ConnectorProcessedQuery as c, ConnectorRawEvent as d, ConnectorRawQuery as f, StoredRawEvent as g, StoredProcessedEvent as h, ConnectorConnectionRecord as i, ConnectorProcessedRecord as l, StoredConnectionEvent as m, ConnectorConnectionEvent as n, ConnectorDiagnosticLog as o, ConnectorRawRecord as p, ConnectorConnectionQuery as r, ConnectorProcessedEvent as s, CONNECTOR_CONNECTION_STATUSES as t, ConnectorQuery as u, connectorProcessedEventSchema as v, connectorRawEventSchema as y };

package/dist/diagnostics.d.ts

@@ -1,2 +1,2 @@
-import { a as DiagnosticsGatewayProbe, c as FunnelDiagnostics, d as DiagnosticEvent, f as previewOf, h as toDiagnosticEvent, i as DiagnosticsChannelSource, l as ReplayResult, m as toDiagnosticConnectionError, n as DiagnoseAllReport, o as DiagnosticsPublisher, p as queryRows, r as DiagnosisStatus, s as DiagnosticsTokenReader, t as ChannelDiagnosis, u as DiagnosticConnectionError } from "./funnel-diagnostics-CnKus3Jg.js";
-export { ChannelDiagnosis, DiagnoseAllReport, DiagnosisStatus, DiagnosticConnectionError, DiagnosticEvent, DiagnosticsChannelSource, DiagnosticsGatewayProbe, DiagnosticsPublisher, DiagnosticsTokenReader, FunnelDiagnostics, ReplayResult, previewOf, queryRows, toDiagnosticConnectionError, toDiagnosticEvent };
+import { _ as toDiagnosticConnectionError, a as DiagnosticsGatewayProbe, c as FunnelDiagnostics, d as DiagnosticEvent, f as diagnosticConnectionEventOf, g as queryRows, h as previewOf, i as DiagnosticsChannelSource, l as ReplayResult, m as diagnosticEventOfRaw, n as DiagnoseAllReport, o as DiagnosticsPublisher, p as diagnosticEventOfProcessed, r as DiagnosisStatus, s as DiagnosticsTokenReader, t as ChannelDiagnosis, u as DiagnosticConnectionError, v as toDiagnosticEvent } from "./funnel-diagnostics-CDrZznTB.js";
+export { ChannelDiagnosis, DiagnoseAllReport, DiagnosisStatus, DiagnosticConnectionError, DiagnosticEvent, DiagnosticsChannelSource, DiagnosticsGatewayProbe, DiagnosticsPublisher, DiagnosticsTokenReader, FunnelDiagnostics, ReplayResult, diagnosticConnectionEventOf, diagnosticEventOfProcessed, diagnosticEventOfRaw, previewOf, queryRows, toDiagnosticConnectionError, toDiagnosticEvent };

package/dist/diagnostics.js

@@ -1,2 +1,3 @@
-import { a as toDiagnosticEvent, i as toDiagnosticConnectionError, n as previewOf, r as queryRows, t as FunnelDiagnostics } from "./funnel-diagnostics-B-PCuv_E.js";
-export { FunnelDiagnostics, previewOf, queryRows, toDiagnosticConnectionError, toDiagnosticEvent };
+import { a as queryRows, i as previewOf, n as diagnosticEventOfProcessed, o as toDiagnosticConnectionError, r as diagnosticEventOfRaw, s as toDiagnosticEvent, t as diagnosticConnectionEventOf } from "./diagnostic-event-CxMM5Bl2.js";
+import { t as FunnelDiagnostics } from "./funnel-diagnostics-CAG7hJP0.js";
+export { FunnelDiagnostics, diagnosticConnectionEventOf, diagnosticEventOfProcessed, diagnosticEventOfRaw, previewOf, queryRows, toDiagnosticConnectionError, toDiagnosticEvent };