@interactive-inc/claude-funnel 0.67.0 → 0.68.1

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

@@ -3,7 +3,7 @@ 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-5ERhytIA.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/docs.js

@@ -1,2 +1,2 @@
-import { t as FunnelDocs } from "./funnel-docs-BFcqITFA.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-CviUTINw.js";
+import { n as DoctorReport, r as FunnelDoctor, t as DoctorFixMode } from "./funnel-doctor-CY4S5cnz.js";
 export { DoctorFixMode, DoctorReport, 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-DAYe9Ndt.d.ts → file-process-guard-D-QatrwL.d.ts}

@@ -2,7 +2,7 @@ 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 { z as FunnelProcessRunner } from "./connector-descriptor-F75ZI8Fh.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;

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

@@ -1,5 +1,6 @@
 import { t as FunnelLogger } from "./logger-mMZvblTx.js";
-import { A as FunnelConnectorListener, g as ConnectorDiagnosticLog, h as ConnectorConnectionStatus } from "./connector-descriptor-F75ZI8Fh.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 = {

package/dist/{funnel-diagnostics-B-PCuv_E.js → funnel-diagnostics-7rV3HxY3.js}

@@ -1,58 +1,8 @@
 import { n as gatewayLoopbackUrl, t as loopbackFetch } from "./loopback-fetch-HP-bo9Kv.js";
 import { t as errorMessageOf } from "./error-message-of-BG4ezZ_s.js";
-import { t as ConnectorDiagnosticSqlReader } from "./diagnostic-sql-reader-CoBk_EFF.js";
+import { n as diagnosticEventOfProcessed, r as diagnosticEventOfRaw, t as diagnosticConnectionEventOf } from "./diagnostic-event-CxMM5Bl2.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
-//#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 queryRows = (reader, sql, params) => {
-	try {
-		return reader.query(sql, params);
-	} finally {
-		reader.close();
-	}
-};
-//#endregion
 //#region lib/services/diagnostics/funnel-diagnostics.ts
 const isGatewayStatusResponse = (value) => {
 	if (value === null || typeof value !== "object") return false;
@@ -65,8 +15,20 @@ const connectorOf = (channel, connectorId) => {
 	return channel.connectors?.find((connector) => connector.id === connectorId)?.name;
 };
 const FLAPPING_ERROR_THRESHOLD = 3;
-const buildDiagnosis = (report) => {
-	const rootCause = (report.connectionErrors[report.connectionErrors.length - 1] ?? null)?.detail ?? null;
+const CONNECTION_DIAGNOSIS_WINDOW = 100;
+const connectionKeyOf = (event) => `${event.type}\u0000${event.connectorId ?? ""}`;
+const unresolvedConnectionFailures = (timeline) => {
+	const lastConnectedIndex = /* @__PURE__ */ new Map();
+	timeline.forEach((event, index) => {
+		if (event.status === "connected") lastConnectedIndex.set(connectionKeyOf(event), index);
+	});
+	return timeline.filter((event, index) => {
+		if (event.status !== "auth-failed" && event.status !== "error") return false;
+		return (lastConnectedIndex.get(connectionKeyOf(event)) ?? -1) < index;
+	});
+};
+const buildDiagnosis = (report, unresolvedErrors = report.connectionErrors) => {
+	const rootCause = (unresolvedErrors[unresolvedErrors.length - 1] ?? null)?.detail ?? null;
 	const channel = report.channel;
 	if (!report.gateway.running) return {
 		status: "error",
@@ -92,7 +54,7 @@ const buildDiagnosis = (report) => {
 		nextActions: [`fnl channels ${channel} connectors add <name> --type=slack ...`],
 		rootCause: null
 	};
-	const authFailed = report.connectionErrors.filter((e) => e.status === "auth-failed");
+	const authFailed = unresolvedErrors.filter((e) => e.status === "auth-failed");
 	if (authFailed.length > 0) {
 		const detail = authFailed[authFailed.length - 1]?.detail ?? null;
 		return {
@@ -174,14 +136,12 @@ var FunnelDiagnostics = class {
 		const target = channelName ? channels.find((ch) => ch.name === channelName) ?? null : channels[0] ?? null;
 		if (!target) return null;
 		const gatewayProbe = await this.fetchGatewayStatus();
-		const store = this.resolveStore();
-		return this.buildChannelDiagnosis(target, gatewayProbe, store, 5);
+		return this.buildChannelDiagnosis(target, gatewayProbe, 5);
 	}
 	async diagnoseAll() {
 		const channels = this.props.channels.list();
 		const gatewayProbe = await this.fetchGatewayStatus();
-		const store = this.resolveStore();
-		const reports = await Promise.all(channels.map((ch) => this.buildChannelDiagnosis(ch, gatewayProbe, store, 5)));
+		const reports = await Promise.all(channels.map((ch) => this.buildChannelDiagnosis(ch, gatewayProbe, 5)));
 		const errorChannels = reports.filter((r) => r.diagnosis.status === "error").map((r) => r.channel);
 		const warnChannels = reports.filter((r) => r.diagnosis.status === "warn").map((r) => r.channel);
 		const okChannels = reports.filter((r) => r.diagnosis.status === "ok").map((r) => r.channel);
@@ -201,20 +161,22 @@ var FunnelDiagnostics = class {
 	}
 	async recentEvents(channelName, options = {}) {
 		const limit = options.limit ?? 20;
-		const ids = this.resolveScope(channelName, options.connector);
-		if (ids === null) return [];
-		const rows = queryRows(new ConnectorDiagnosticSqlReader(ids.store), `SELECT seq, ts, type, outcome, payload, event_id FROM processed ${ids.whereClause} ORDER BY seq DESC LIMIT ?`, [...ids.params, limit]);
-		if (rows instanceof Error) return [];
-		return rows.reverse().map(toDiagnosticEvent);
+		const scope = this.resolveScope(channelName, options.connector);
+		if (scope === null) return [];
+		return this.queryLog((log) => log.queryProcessed({
+			...scope,
+			limit
+		})).map(diagnosticEventOfProcessed);
 	}
 	async droppedEvents(channelName, options = {}) {
 		const limit = options.limit ?? 20;
-		const ids = this.resolveScope(channelName, options.connector);
-		if (ids === null) return [];
-		const where = ids.whereClause ? `${ids.whereClause} AND outcome LIKE 'skip:%'` : "WHERE outcome LIKE 'skip:%'";
-		const rows = queryRows(new ConnectorDiagnosticSqlReader(ids.store), `SELECT seq, ts, type, outcome, payload, event_id FROM processed ${where} ORDER BY seq DESC LIMIT ?`, [...ids.params, limit]);
-		if (rows instanceof Error) return [];
-		return rows.reverse().map(toDiagnosticEvent);
+		const scope = this.resolveScope(channelName, options.connector);
+		if (scope === null) return [];
+		return this.queryLog((log) => log.queryProcessed({
+			...scope,
+			outcomePrefix: "skip:",
+			limit
+		})).map(diagnosticEventOfProcessed);
 	}
 	/**
 	* Raw inbound rows the connector recorded before any processing. The most
@@ -224,20 +186,22 @@ var FunnelDiagnostics = class {
 	*/
 	async rawEvents(channelName, options = {}) {
 		const limit = options.limit ?? 20;
-		const ids = this.resolveScope(channelName, options.connector);
-		if (ids === null) return [];
-		const rows = queryRows(new ConnectorDiagnosticSqlReader(ids.store), `SELECT seq, ts, type, '' AS outcome, payload, event_id FROM raw ${ids.whereClause} ORDER BY seq DESC LIMIT ?`, [...ids.params, limit]);
-		if (rows instanceof Error) return [];
-		return rows.reverse().map(toDiagnosticEvent);
+		const scope = this.resolveScope(channelName, options.connector);
+		if (scope === null) return [];
+		return this.queryLog((log) => log.queryRaw({
+			...scope,
+			limit
+		})).map(diagnosticEventOfRaw);
 	}
 	async connectionErrors(channelName, options = {}) {
 		const limit = options.limit ?? 20;
-		const ids = this.resolveScope(channelName, options.connector);
-		if (ids === null) return [];
-		const where = ids.whereClause ? `${ids.whereClause} AND status IN ('auth-failed','error')` : "WHERE status IN ('auth-failed','error')";
-		const rows = queryRows(new ConnectorDiagnosticSqlReader(ids.store), `SELECT seq, ts, type, status, detail FROM connection ${where} ORDER BY seq DESC LIMIT ?`, [...ids.params, limit]);
-		if (rows instanceof Error) return [];
-		return rows.reverse().map(toDiagnosticConnectionError);
+		const scope = this.resolveScope(channelName, options.connector);
+		if (scope === null) return [];
+		return this.queryLog((log) => log.queryConnection({
+			...scope,
+			statuses: ["auth-failed", "error"],
+			limit
+		})).map(diagnosticConnectionEventOf);
 	}
 	/**
 	* Full connection lifecycle for one channel/connector — started, connected,
@@ -248,11 +212,12 @@ var FunnelDiagnostics = class {
 	*/
 	async connectionTimeline(channelName, options = {}) {
 		const limit = options.limit ?? 20;
-		const ids = this.resolveScope(channelName, options.connector);
-		if (ids === null) return [];
-		const rows = queryRows(new ConnectorDiagnosticSqlReader(ids.store), `SELECT seq, ts, type, status, detail FROM connection ${ids.whereClause} ORDER BY seq DESC LIMIT ?`, [...ids.params, limit]);
-		if (rows instanceof Error) return [];
-		return rows.reverse().map(toDiagnosticConnectionError);
+		const scope = this.resolveScope(channelName, options.connector);
+		if (scope === null) return [];
+		return this.queryLog((log) => log.queryConnection({
+			...scope,
+			limit
+		})).map(diagnosticConnectionEventOf);
 	}
 	/**
 	* Tail of `~/.funnel/.../funnel.log`. Use when a flume internal log (e.g.
@@ -293,28 +258,30 @@ var FunnelDiagnostics = class {
 	async replay(channelName, seq) {
 		const channel = this.props.channels.list().find((ch) => ch.name === channelName);
 		if (!channel) return { state: "not-found" };
-		const store = this.resolveStore();
-		if (!store) return {
+		if (!this.props.diagnosticLog) return {
 			state: "error",
-			reason: "no diagnostic store yet"
+			reason: "no diagnostic log configured"
 		};
-		const reader = new ConnectorDiagnosticSqlReader(store);
-		const rows = seq !== void 0 ? queryRows(reader, "SELECT seq, event_id, type, payload, connector_id, channel_id FROM processed WHERE channel_id = ? AND seq = ? LIMIT 1", [channel.id, seq]) : queryRows(reader, "SELECT seq, event_id, type, payload, connector_id, channel_id FROM processed WHERE channel_id = ? AND outcome LIKE 'emitted%' ORDER BY seq DESC LIMIT 1", [channel.id]);
+		const rows = this.queryLogResult((log) => log.queryProcessed({
+			channelId: channel.id,
+			...seq !== void 0 ? { seq } : { outcomePrefix: "emitted" },
+			limit: 1
+		}));
 		if (rows instanceof Error) return {
 			state: "error",
 			reason: rows.message
 		};
 		const firstRow = rows[0];
 		if (!firstRow) return { state: "not-found" };
-		const replaySeq = typeof firstRow.seq === "number" ? firstRow.seq : null;
-		const eventId = typeof firstRow.event_id === "string" ? firstRow.event_id : null;
-		const connectorId = typeof firstRow.connector_id === "string" ? firstRow.connector_id : null;
-		let content = typeof firstRow.payload === "string" ? firstRow.payload : null;
-		if ((!content || content.length === 0) && eventId) {
-			const rawRows = queryRows(new ConnectorDiagnosticSqlReader(store), "SELECT payload FROM raw WHERE event_id = ? LIMIT 1", [eventId]);
-			const rawRow = rawRows instanceof Error ? null : rawRows[0];
-			if (rawRow) content = typeof rawRow.payload === "string" ? rawRow.payload : null;
-		}
+		const replaySeq = firstRow.seq;
+		const eventId = firstRow.eventId;
+		const connectorId = firstRow.connectorId;
+		const processedContent = firstRow.payload.length > 0 ? firstRow.payload : null;
+		const rawContent = processedContent === null ? this.queryLog((log) => log.queryRaw({
+			eventId,
+			limit: 1
+		}))[0]?.payload ?? null : null;
+		const content = processedContent ?? rawContent;
 		if (!content) return {
 			state: "error",
 			reason: "event has no payload to replay"
@@ -336,52 +303,35 @@ var FunnelDiagnostics = class {
 			preview: content.slice(0, 60)
 		};
 	}
-	resolveStore() {
-		const tmpDir = this.props.tmpDir;
-		const rawPath = join(tmpDir, "connector-raw.db");
-		const processedPath = join(tmpDir, "connector-processed.db");
-		const connectionPath = join(tmpDir, "connector-connection.db");
-		if (!existsSync(rawPath) || !existsSync(processedPath) || !existsSync(connectionPath)) return null;
-		return {
-			rawPath,
-			processedPath,
-			connectionPath
-		};
-	}
-	resolveChannelId(channelName) {
-		if (!channelName) return null;
-		return this.props.channels.list().find((ch) => ch.name === channelName)?.id ?? null;
-	}
 	/**
-	* Resolves a (channel, connector) filter into the SQL where-clause + the
-	* positional params, or returns `null` when the requested scope cannot be
-	* resolved (channel not found, connector not found in that channel, no
-	* store on disk yet). Centralises the channel/connector → id mapping so
-	* each read method does not redo the lookup.
+	* Resolves human-facing channel/connector names into the stable ids stored
+	* by the diagnostic log. Connector names are only unique inside a channel.
 	*/
 	resolveScope(channelName, connectorName) {
-		const store = this.resolveStore();
-		if (!store) return null;
-		if (!channelName) return {
-			store,
-			whereClause: "",
-			params: []
-		};
+		if (!channelName) return {};
 		const channel = this.props.channels.list().find((ch) => ch.name === channelName) ?? null;
 		if (!channel) return null;
-		if (!connectorName) return {
-			store,
-			whereClause: "WHERE channel_id = ?",
-			params: [channel.id]
-		};
+		if (!connectorName) return { channelId: channel.id };
 		const connectorId = channel.connectors?.find((c) => c.name === connectorName)?.id ?? null;
 		if (!connectorId) return null;
 		return {
-			store,
-			whereClause: "WHERE channel_id = ? AND connector_id = ?",
-			params: [channel.id, connectorId]
+			channelId: channel.id,
+			connectorId
 		};
 	}
+	queryLog(query) {
+		const result = this.queryLogResult(query);
+		return result instanceof Error ? [] : result;
+	}
+	queryLogResult(query) {
+		const log = this.props.diagnosticLog;
+		if (!log) return /* @__PURE__ */ new Error("no diagnostic log configured");
+		try {
+			return query(log);
+		} catch (error) {
+			return new Error(errorMessageOf(error));
+		}
+	}
 	async fetchGatewayStatus() {
 		const gatewayStatus = this.props.gateway.getStatus();
 		if (!gatewayStatus.running) return {
@@ -421,7 +371,7 @@ var FunnelDiagnostics = class {
 			error: null
 		};
 	}
-	async buildChannelDiagnosis(target, gatewayProbe, store, eventLimit) {
+	async buildChannelDiagnosis(target, gatewayProbe, eventLimit) {
 		const gatewayStatus = this.props.gateway.getStatus();
 		const targetName = target.name;
 		const gatewayBody = gatewayProbe.body;
@@ -452,17 +402,24 @@ var FunnelDiagnostics = class {
 			}));
 			baseReport.claudeClients = gatewayBody.clients.filter((cl) => cl.channelName === targetName).length;
 		}
-		if (store) {
-			const evRows = queryRows(new ConnectorDiagnosticSqlReader(store), "SELECT seq, ts, type, outcome, payload FROM processed WHERE channel_id = ? ORDER BY seq DESC LIMIT ?", [target.id, eventLimit]);
-			if (!(evRows instanceof Error)) baseReport.recentEvents = evRows.reverse().map(toDiagnosticEvent);
-			const errRows = queryRows(new ConnectorDiagnosticSqlReader(store), "SELECT ts, type, status, detail FROM connection WHERE channel_id = ? AND status IN ('auth-failed','error') ORDER BY seq DESC LIMIT 3", [target.id]);
-			if (!(errRows instanceof Error)) baseReport.connectionErrors = errRows.reverse().map(toDiagnosticConnectionError);
+		let unresolvedErrors = [];
+		if (this.props.diagnosticLog) {
+			baseReport.recentEvents = this.queryLog((log) => log.queryProcessed({
+				channelId: target.id,
+				limit: eventLimit
+			})).map(diagnosticEventOfProcessed);
+			const connectionRows = this.queryLog((log) => log.queryConnection({
+				channelId: target.id,
+				limit: CONNECTION_DIAGNOSIS_WINDOW
+			}));
+			baseReport.connectionErrors = connectionRows.filter((row) => row.status === "auth-failed" || row.status === "error").slice(-3).map(diagnosticConnectionEventOf);
+			unresolvedErrors = unresolvedConnectionFailures(connectionRows).map(diagnosticConnectionEventOf);
 		}
 		return {
 			...baseReport,
-			diagnosis: buildDiagnosis(baseReport)
+			diagnosis: buildDiagnosis(baseReport, unresolvedErrors)
 		};
 	}
 };
 //#endregion
-export { toDiagnosticEvent as a, toDiagnosticConnectionError as i, previewOf as n, queryRows as r, FunnelDiagnostics as t };
+export { FunnelDiagnostics as t };

package/dist/{funnel-diagnostics-CnKus3Jg.d.ts → funnel-diagnostics-CDrZznTB.d.ts}

@@ -1,4 +1,5 @@
 import { t as ChannelConfig } from "./settings-schema-B-CKLuST.js";
+import { g as StoredRawEvent, h as StoredProcessedEvent, m as StoredConnectionEvent, o as ConnectorDiagnosticLog } from "./diagnostic-log-BsAg5qZK.js";
 //#region lib/engine/diagnostic-log/diagnostic-sql-reader.d.ts
 type Props$1 = {
   /** SQLite file holding the raw (pre-filter) table. */
@@ -56,6 +57,9 @@ type DiagnosticConnectionError = {
 declare const previewOf: (payload: unknown) => string | null;
 declare const toDiagnosticEvent: (row: Record<string, unknown>) => DiagnosticEvent;
 declare const toDiagnosticConnectionError: (row: Record<string, unknown>) => DiagnosticConnectionError;
+declare const diagnosticEventOfProcessed: (event: StoredProcessedEvent) => DiagnosticEvent;
+declare const diagnosticEventOfRaw: (event: StoredRawEvent) => DiagnosticEvent;
+declare const diagnosticConnectionEventOf: (event: StoredConnectionEvent) => DiagnosticConnectionError;
 declare const queryRows: (reader: ConnectorDiagnosticSqlReader, sql: string, params: (string | number | null)[]) => Record<string, unknown>[] | Error;
 //#endregion
 //#region lib/services/diagnostics/funnel-diagnostics.d.ts
@@ -95,6 +99,7 @@ type Props = {
   gatewayToken: DiagnosticsTokenReader;
   channels: DiagnosticsChannelSource;
   publisher: DiagnosticsPublisher;
+  diagnosticLog?: ConnectorDiagnosticLog;
   tmpDir: string;
 };
 type DiagnosisStatus = "ok" | "warn" | "error";
@@ -159,11 +164,6 @@ type ReplayResult = {
 } | {
   state: "not-found";
 };
-type StorePaths = {
-  rawPath: string;
-  processedPath: string;
-  connectionPath: string;
-};
 /**
  * Programmable diagnostics surface — used by both the CLI (fnl debug …) and
  * the MCP tools (fnl_debug, fnl_recent_events, …). Pure read-side, no
@@ -224,18 +224,15 @@ declare class FunnelDiagnostics {
     truncated: boolean;
   }>;
   replay(channelName: string, seq?: number): Promise<ReplayResult>;
-  resolveStore(): StorePaths | null;
-  private resolveChannelId;
   /**
-   * Resolves a (channel, connector) filter into the SQL where-clause + the
-   * positional params, or returns `null` when the requested scope cannot be
-   * resolved (channel not found, connector not found in that channel, no
-   * store on disk yet). Centralises the channel/connector → id mapping so
-   * each read method does not redo the lookup.
+   * Resolves human-facing channel/connector names into the stable ids stored
+   * by the diagnostic log. Connector names are only unique inside a channel.
    */
   private resolveScope;
+  private queryLog;
+  private queryLogResult;
   private fetchGatewayStatus;
   private buildChannelDiagnosis;
 }
 //#endregion
-export { DiagnosticsGatewayProbe as a, FunnelDiagnostics as c, DiagnosticEvent as d, previewOf as f, ConnectorDiagnosticSqlReader as g, toDiagnosticEvent as h, DiagnosticsChannelSource as i, ReplayResult as l, toDiagnosticConnectionError as m, DiagnoseAllReport as n, DiagnosticsPublisher as o, queryRows as p, DiagnosisStatus as r, DiagnosticsTokenReader as s, ChannelDiagnosis as t, DiagnosticConnectionError as u };
+export { toDiagnosticConnectionError as _, DiagnosticsGatewayProbe as a, FunnelDiagnostics as c, DiagnosticEvent as d, diagnosticConnectionEventOf as f, queryRows as g, previewOf as h, DiagnosticsChannelSource as i, ReplayResult as l, diagnosticEventOfRaw as m, DiagnoseAllReport as n, DiagnosticsPublisher as o, diagnosticEventOfProcessed as p, DiagnosisStatus as r, DiagnosticsTokenReader as s, ChannelDiagnosis as t, DiagnosticConnectionError as u, toDiagnosticEvent as v, ConnectorDiagnosticSqlReader as y };

package/dist/{funnel-docs-BFcqITFA.js → funnel-docs-CI4hMkhq.js}

@@ -124,7 +124,7 @@ types:
   slack      Socket Mode listener + REST adapter
   gh         GitHub polling listener + REST adapter
   discord    Discord listener + REST adapter
-  schedule   cron-style tick listener (no adapter — schedule does not send out)
+  schedule   cron + one-shot tick listener (no adapter — schedule does not send out)
 
 per-type parts:
 
@@ -145,8 +145,8 @@ operations (all nested under a channel):
   fnl channels <ch> connectors <name> request …      proxy an HTTP call to the
                                                      adapter (e.g. send a Slack
                                                      message via Claude path)
-  fnl channels <ch> connectors <name> schedules …    manage cron entries on a
-                                                     schedule connector
+  fnl channels <ch> connectors <name> schedules …    manage cron / one-shot
+                                                     schedule entries
 
 tokens:
 
@@ -708,6 +708,11 @@ related: fnl docs architecture, fnl docs debugging, fnl docs mcp`,
   fnl channels daily connectors cron schedules add morning \\
     --cron="0 9 * * *" --prompt="summarize yesterday's PRs"
 
+— schedule a one-shot prompt —
+
+  fnl channels daily connectors cron schedules add release \\
+    --run-at="2026-08-01T09:00:00+09:00" --prompt="run the release check"
+
 — diagnose "events stopped arriving" —
 
   fnl debug --all --json

package/dist/{funnel-doctor-CviUTINw.d.ts → funnel-doctor-CY4S5cnz.d.ts}

@@ -1,4 +1,4 @@
-import { c as FunnelDiagnostics, n as DiagnoseAllReport, t as ChannelDiagnosis } from "./funnel-diagnostics-CnKus3Jg.js";
+import { c as FunnelDiagnostics, n as DiagnoseAllReport, t as ChannelDiagnosis } from "./funnel-diagnostics-CDrZznTB.js";
 import { n as RecoveryAction, t as FunnelRecovery } from "./funnel-recovery-BwcSNNSN.js";
 //#region lib/services/doctor/funnel-doctor.d.ts
 type Props = {