@interactive-inc/claude-funnel 0.66.0 → 0.68.0

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-kbd27d7I.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-Cvk6Sk4x.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 };

package/dist/{discord-connector-DXARcO6w.js → discord-connector-CAcWifJn.js}

@@ -1,9 +1,9 @@
-import { t as NodeFunnelHttpClient } from "./node-http-client-u00atiKx.js";
-import { t as errorMessageOf } from "./error-message-of-ColuYmAk.js";
-import { t as discordConnectorSchema } from "./discord-connector-schema-B4YpWpR3.js";
-import { t as FunnelConnectorAdapter } from "./connector-adapter-Dvs8N7ew.js";
-import { t as resolveConnectorToken } from "./resolve-connector-token-DxDG9mhf.js";
-import { i as resolveFlumeDeps, n as FunnelFlumeSourceListener, r as flumeLogHandler, t as slotFields } from "./slot-fields-D-pvMgTK.js";
+import { t as NodeFunnelHttpClient } from "./node-http-client-SX3xFh4h.js";
+import { t as errorMessageOf } from "./error-message-of-BG4ezZ_s.js";
+import { t as discordConnectorSchema } from "./discord-connector-schema-saAGuPmJ.js";
+import { t as FunnelConnectorAdapter } from "./connector-adapter-BL2ehMej.js";
+import { t as resolveConnectorToken } from "./resolve-connector-token-BwiJCu82.js";
+import { i as resolveFlumeDeps, n as FunnelFlumeSourceListener, r as flumeLogHandler, t as slotFields } from "./slot-fields-eCWizJqS.js";
 import { FlumeDiscordGatewayIntents, FlumeDiscordSource } from "@interactive-inc/flume/discord";
 //#region lib/engine/connectors/discord-adapter.ts
 const DISCORD_API_BASE = "https://discord.com/api/v10";

package/dist/{discord-connector-schema-D1dyxhXk.d.ts → discord-connector-schema-BaBZYHxK.d.ts}

@@ -1,5 +1,4 @@
 import { z } from "zod";
-
 //#region lib/engine/connectors/discord-connector-schema.d.ts
 /**
  * Like slack, a discord connector holds either a literal `botToken` or a

package/dist/docs.d.ts

@@ -1,2 +1,2 @@
-import { n as FunnelDocs, t as DocsTopicListing } from "./funnel-docs-Cd66sKyV.js";
+import { n as FunnelDocs, t as DocsTopicListing } from "./funnel-docs-BJWawfWI.js";
 export { DocsTopicListing, FunnelDocs };

package/dist/docs.js

@@ -1,2 +1,2 @@
-import { t as FunnelDocs } from "./funnel-docs-C-ge0MuB.js";
+import { t as FunnelDocs } from "./funnel-docs-CI4hMkhq.js";
 export { FunnelDocs };

package/dist/doctor.d.ts

@@ -1,2 +1,2 @@
-import { n as DoctorReport, r as FunnelDoctor, t as DoctorFixMode } from "./funnel-doctor-CVTNUtDn.js";
+import { n as DoctorReport, r as FunnelDoctor, t as DoctorFixMode } from "./funnel-doctor-CY4S5cnz.js";
 export { DoctorFixMode, DoctorReport, FunnelDoctor };

package/dist/doctor.js

@@ -1,2 +1,2 @@
-import { t as FunnelDoctor } from "./funnel-doctor-XrI2GBH8.js";
+import { t as FunnelDoctor } from "./funnel-doctor-Csw5qjcH.js";
 export { FunnelDoctor };

package/dist/event-log.d.ts

@@ -0,0 +1,2 @@
+import { a as MemoryEventLogProps, c as EventLogValidator, d as EventLogEntry, i as MemoryEventLog, l as EventLogRelay, n as SqliteEventLogProps, o as EventLog, r as SqliteEventLogQuery, s as EventLogProps, t as SqliteEventLog, u as EventLogStore } from "./sqlite-event-log-BYgCFMxC.js";
+export { EventLog, EventLogEntry, EventLogProps, EventLogRelay, EventLogStore, EventLogValidator, MemoryEventLog, MemoryEventLogProps, SqliteEventLog, SqliteEventLogProps, SqliteEventLogQuery };

package/dist/event-log.js

@@ -0,0 +1,3 @@
+import { t as SqliteEventLog } from "./sqlite-event-log-eZuXKszJ.js";
+import { n as EventLog, t as MemoryEventLog } from "./memory-event-log-BY8XjFzi.js";
+export { EventLog, MemoryEventLog, SqliteEventLog };

package/dist/{file-process-guard-CiBwXjzm.d.ts → file-process-guard-D-QatrwL.d.ts}

@@ -1,9 +1,8 @@
-import { t as FunnelLogger } from "./logger-Bc_Ooypb.js";
-import { n as FunnelFileSystem } from "./file-system-DHgbuTFb.js";
-import { t as ChannelConfig } from "./settings-schema-IShSMm5G.js";
-import { n as FunnelIdGenerator } from "./settings-reader-BnKIbmsD.js";
-import { z as FunnelProcessRunner } from "./connector-descriptor-CmyHlEiT.js";
-
+import { t as FunnelLogger } from "./logger-mMZvblTx.js";
+import { n as FunnelFileSystem } from "./file-system-BNtl997T.js";
+import { t as ChannelConfig } from "./settings-schema-B-CKLuST.js";
+import { n as FunnelIdGenerator } from "./settings-reader-CyTpbAre.js";
+import { b as FunnelProcessRunner } from "./connector-descriptor-D4XtEsH8.js";
 //#region lib/engine/claude/channel-resolver.d.ts
 type ChannelResolver = {
   get(name: string): ChannelConfig | null;
@@ -26,15 +25,19 @@ type McpInstaller = {
 //#endregion
 //#region lib/engine/claude/process-guard.d.ts
 type ProcessGuard = {
-  /** Returns true if a live process is already registered for this profile. */isRunning(profileId: string): boolean; /** Writes the PID file and registers an exit hook to clean it up. */
-  acquire(profileId: string): void; /** Removes the PID file. */
+  /** Returns true if a live process is already registered for this profile. */
+  isRunning(profileId: string): boolean;
+  /** Writes the PID file and registers an exit hook to clean it up. */
+  acquire(profileId: string): void;
+  /** Removes the PID file. */
   release(profileId: string): void;
 };
 //#endregion
 //#region lib/engine/claude/session-store.d.ts
 type SessionStore = {
   getSessionId(profileId: string): string | null;
-  setSessionId(profileId: string, sessionId: string): void; /** Returns true when the session jsonl exists on disk and is non-empty. */
+  setSessionId(profileId: string, sessionId: string): void;
+  /** Returns true when the session jsonl exists on disk and is non-empty. */
   sessionFileExists(cwd: string, sessionId: string, env: Record<string, string>): boolean;
 };
 //#endregion
@@ -42,8 +45,10 @@ type SessionStore = {
 type LaunchCommon = {
   channel: string;
   cwd?: string;
-  userArgs?: string[]; /** Args prepended to the claude argv (typically a profile's recipe). Defaults to none. */
-  options?: string[]; /** Env vars layered under the launched claude process. process.env wins on collision. */
+  userArgs?: string[];
+  /** Args prepended to the claude argv (typically a profile's recipe). Defaults to none. */
+  options?: string[];
+  /** Env vars layered under the launched claude process. process.env wins on collision. */
   env?: Record<string, string>;
   /** Invoked synchronously after the child claude process has been spawned, with its PID.
    *  Useful for hosts that need to register the spawned process before it exits
@@ -57,18 +62,17 @@ type LaunchCommon = {
 /**
  * A launch carries one of two targets, distinguished by `profileId`.
  *
- * - **profile launch** — has a stable `profileId` (uuid). Enforces singleton-ness
- *   via the PID file and may opt into `resume` to reuse the profile's session.
+ * - **profile launch** — has a stable `profileId` (a global uuid or a
+ *   deterministic repo-local id). Enforces singleton-ness via the PID file and
+ *   may opt into `resume` to reuse the profile's session.
  * - **profile-less launch** — raw `--channel`. Never enforces singleton-ness and
  *   always starts a fresh session, so `resume` is meaningless and disallowed.
  *
- * Modeling these as a union (rather than two independent optional fields) makes
- * `resume` without a `profileId` a compile error — previously it was silently
- * ignored, which masked real bugs (a profile resume that never took effect).
+ * Modeling these as a union makes `resume` without a profile id a compile error.
  */
 type LaunchTarget = {
-  /** Stable id of the launching profile (uuid). Keys the singleton PID file
-   *  and the resumable session. */
+  /** Stable id of the launching profile. Keys the singleton PID file and
+   *  the resumable session. */
   profileId: string;
   /** Inject `--session-id`/`--resume` for this profile (opt-in, default false).
    *  The persisted session is owned by the profile (by id). */

package/dist/{file-system-DHgbuTFb.d.ts → file-system-BNtl997T.d.ts}

@@ -1,6 +1,7 @@
 //#region lib/engine/fs/file-system.d.ts
 type FileStat = {
-  mtimeMs: number; /** POSIX mode bits (e.g. 0o600). `null` when the underlying FS does not expose mode. */
+  mtimeMs: number;
+  /** POSIX mode bits (e.g. 0o600). `null` when the underlying FS does not expose mode. */
   mode: number | null;
 };
 /**

package/dist/{flume-source-listener-FzR5lGpL.d.ts → flume-source-listener-Ba8_1Mg-.d.ts}

@@ -1,7 +1,7 @@
-import { t as FunnelLogger } from "./logger-Bc_Ooypb.js";
-import { A as FunnelConnectorListener, g as ConnectorDiagnosticLog, h as ConnectorConnectionStatus } from "./connector-descriptor-CmyHlEiT.js";
+import { t as FunnelLogger } from "./logger-mMZvblTx.js";
+import { d as FunnelConnectorListener } from "./connector-descriptor-D4XtEsH8.js";
+import { a as ConnectorConnectionStatus, o as ConnectorDiagnosticLog } from "./diagnostic-log-BsAg5qZK.js";
 import { FlumeEventHandler, FlumeLogHandler, FlumeReconnectOptions, FlumeRunning, FlumeRuntimeDeps, FlumeSource, FlumeStatus } from "@interactive-inc/flume";
-
 //#region lib/engine/connectors/connector-diagnostics-recorder.d.ts
 type Props$1 = {
   type: string;
@@ -24,15 +24,18 @@ declare class FunnelConnectorDiagnosticsRecorder {
 //#endregion
 //#region lib/engine/connectors/flume-source-listener.d.ts
 type Props = {
-  /** Funnel connector type ("slack" / "discord" / "gh") — stamped onto diagnostic rows. */type: string;
+  /** Funnel connector type ("slack" / "discord" / "gh") — stamped onto diagnostic rows. */
+  type: string;
   connectorId: string;
   channelId: string | null;
   logger?: FunnelLogger;
   diagnosticLog?: ConnectorDiagnosticLog;
 };
 type RunStartOptions = {
-  source: FlumeSource; /** Typed event handler — receives the source's events only (logs are routed separately). */
-  onEvent: FlumeEventHandler; /** Optional log handler for everything the firehose emits (including status transitions). */
+  source: FlumeSource;
+  /** Typed event handler — receives the source's events only (logs are routed separately). */
+  onEvent: FlumeEventHandler;
+  /** Optional log handler for everything the firehose emits (including status transitions). */
   onLog?: FlumeLogHandler;
   deps?: FlumeRuntimeDeps;
   /**