@interactive-inc/claude-funnel 0.52.0 → 0.55.0

package/dist/connector-adapter-1PxjN-Uk.d.ts

@@ -0,0 +1,25 @@
+//#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
+export { FunnelConnectorAdapter as n, CallInput as t };

package/dist/{connector-adapter-D5Utumgz.js → connector-adapter-qwXLjQId.js}

@@ -1,4 +1,4 @@
-//#region lib/connectors/connector-adapter.ts
+//#region lib/engine/connectors/connector-adapter.ts
 var FunnelConnectorAdapter = class {};
 //#endregion
 export { FunnelConnectorAdapter as t };

package/dist/{connector-listener-DU54DN-f.js → connector-listener-CpHBecCj.js}

@@ -1,4 +1,4 @@
-//#region lib/connectors/connector-listener.ts
+//#region lib/engine/connectors/connector-listener.ts
 /**
 * Long-lived event source for one connector.
 *

package/dist/connectors/discord.d.ts

@@ -1,6 +1,6 @@
-import { S as FunnelLogger, b as FunnelConnectorListener, o as ConnectorDiagnosticLog, x as NotifyFn } from "../connector-diagnostic-log-yTOojKUR.js";
-import { n as FunnelConnectorAdapter, t as CallInput } from "../connector-adapter-DKgsVuMH.js";
-import { n as discordConnectorSchema, t as DiscordConnectorConfig } from "../discord-connector-schema-R0Uu-3ns.js";
+import { S as FunnelLogger, b as FunnelConnectorListener, o as ConnectorDiagnosticLog, x as NotifyFn } from "../diagnostic-log-Bxe7Bbvw.js";
+import { n as FunnelConnectorAdapter, t as CallInput } from "../connector-adapter-1PxjN-Uk.js";
+import { n as discordConnectorSchema, t as DiscordConnectorConfig } from "../discord-connector-schema-CPgcZkXh.js";
 
 //#region lib/engine/http/http-client.d.ts
 type HttpRequest = {
@@ -19,7 +19,7 @@ declare abstract class FunnelHttpClient {
   abstract fetch(request: HttpRequest): Promise<HttpResponse>;
 }
 //#endregion
-//#region lib/connectors/discord-adapter.d.ts
+//#region lib/engine/connectors/discord-adapter.d.ts
 type Deps$1 = {
   config: DiscordConnectorConfig; /** Environment used to resolve a `botTokenEnv` reference. Defaults to process.env. */
   env?: NodeJS.ProcessEnv;
@@ -32,7 +32,7 @@ declare class FunnelDiscordAdapter extends FunnelConnectorAdapter {
   call(input: CallInput): Promise<unknown>;
 }
 //#endregion
-//#region lib/connectors/discord-event-processor.d.ts
+//#region lib/engine/connectors/discord-event-processor.d.ts
 type DiscordInboundMessage = {
   authorId: string;
   authorIsBot: boolean;
@@ -59,7 +59,7 @@ declare class FunnelDiscordEventProcessor {
   process(message: DiscordInboundMessage): DiscordProcessed;
 }
 //#endregion
-//#region lib/connectors/discord-listener.d.ts
+//#region lib/engine/connectors/discord-listener.d.ts
 type Deps = {
   config: DiscordConnectorConfig; /** Funnel channel uuid this connector lives under; stamped onto diagnostic-log rows. */
   channelId?: string; /** Environment used to resolve a `botTokenEnv` reference. Defaults to process.env. */

package/dist/connectors/discord.js

@@ -1,3 +1,3 @@
-import { n as FunnelDiscordEventProcessor, r as FunnelDiscordAdapter, t as FunnelDiscordListener } from "../discord-listener-_jSE3HsQ.js";
-import { t as discordConnectorSchema } from "../discord-connector-schema-CBDyGdOI.js";
+import { n as FunnelDiscordEventProcessor, r as FunnelDiscordAdapter, t as FunnelDiscordListener } from "../discord-listener-C0MoKdQO.js";
+import { t as discordConnectorSchema } from "../discord-connector-schema-B_N6IXLz.js";
 export { FunnelDiscordAdapter, FunnelDiscordEventProcessor, FunnelDiscordListener, discordConnectorSchema };

package/dist/connectors/gh.d.ts

@@ -1,9 +1,9 @@
-import { S as FunnelLogger, b as FunnelConnectorListener, o as ConnectorDiagnosticLog, x as NotifyFn } from "../connector-diagnostic-log-yTOojKUR.js";
-import { r as FunnelProcessRunner } from "../process-runner-DfniuWVU.js";
-import { n as FunnelConnectorAdapter, t as CallInput } from "../connector-adapter-DKgsVuMH.js";
-import { n as ghConnectorSchema, t as GhConnectorConfig } from "../gh-connector-schema-eoTtHbY6.js";
+import { S as FunnelLogger, b as FunnelConnectorListener, o as ConnectorDiagnosticLog, x as NotifyFn } from "../diagnostic-log-Bxe7Bbvw.js";
+import { r as FunnelProcessRunner } from "../process-runner-D5I_jhYQ.js";
+import { n as FunnelConnectorAdapter, t as CallInput } from "../connector-adapter-1PxjN-Uk.js";
+import { n as ghConnectorSchema, t as GhConnectorConfig } from "../gh-connector-schema-CU1ojfIF.js";
 
-//#region lib/connectors/gh-adapter.d.ts
+//#region lib/engine/connectors/gh-adapter.d.ts
 type Deps$1 = {
   process?: FunnelProcessRunner;
 };
@@ -13,7 +13,7 @@ declare class FunnelGhAdapter extends FunnelConnectorAdapter {
   call(input: CallInput): Promise<unknown>;
 }
 //#endregion
-//#region lib/connectors/gh-listener.d.ts
+//#region lib/engine/connectors/gh-listener.d.ts
 type Deps = {
   config: GhConnectorConfig; /** Funnel channel uuid this connector lives under; stamped onto diagnostic-log rows. */
   channelId?: string;

package/dist/connectors/gh.js

@@ -1,3 +1,3 @@
-import { t as ghConnectorSchema } from "../gh-connector-schema-o3Q1-ojL.js";
-import { n as FunnelGhAdapter, t as FunnelGhListener } from "../gh-listener-DH-fClQm.js";
+import { t as ghConnectorSchema } from "../gh-connector-schema-DUcZgN2Q.js";
+import { n as FunnelGhAdapter, t as FunnelGhListener } from "../gh-listener-Dsx6AmhH.js";
 export { FunnelGhAdapter, FunnelGhListener, ghConnectorSchema };

package/dist/connectors/schedule.d.ts

@@ -1,6 +1,16 @@
-import { a as ScheduleEntry, c as scheduleEntrySchema, i as ScheduleConnectorConfig, l as ScheduleStateStore, n as ScheduleOnFired, o as scheduleCatchupPolicySchema, r as ScheduleCatchupPolicy, s as scheduleConnectorSchema, t as FunnelScheduleListener } from "../schedule-listener-CUyUFFR1.js";
+import { a as ScheduleEntry, c as scheduleEntrySchema, i as ScheduleConnectorConfig, l as ScheduleStateStore, n as ScheduleOnFired, o as scheduleCatchupPolicySchema, r as ScheduleCatchupPolicy, s as scheduleConnectorSchema, t as FunnelScheduleListener } from "../schedule-listener-DKh0hnkK.js";
 
-//#region lib/connectors/match-cron.d.ts
+//#region lib/engine/connectors/match-cron.d.ts
+/**
+ * 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`.
+ */
 declare const matchCron: (expr: string, date: Date) => boolean;
 //#endregion
 export { FunnelScheduleListener, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleOnFired, ScheduleStateStore, matchCron, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema };

package/dist/connectors/schedule.js

@@ -1,3 +1,3 @@
-import { n as ScheduleStateStore, r as matchCron, t as FunnelScheduleListener } from "../schedule-listener-ePAjians.js";
-import { n as scheduleConnectorSchema, r as scheduleEntrySchema, t as scheduleCatchupPolicySchema } from "../schedule-connector-schema-iCI61gzU.js";
+import { n as ScheduleStateStore, r as matchCron, t as FunnelScheduleListener } from "../schedule-listener-DP9Jhc6U.js";
+import { n as scheduleConnectorSchema, r as scheduleEntrySchema, t as scheduleCatchupPolicySchema } from "../schedule-connector-schema-B_xO5z5B.js";
 export { FunnelScheduleListener, ScheduleStateStore, matchCron, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema };

package/dist/connectors/slack.d.ts

@@ -1,7 +1,7 @@
-import { n as FunnelConnectorAdapter, t as CallInput } from "../connector-adapter-DKgsVuMH.js";
-import { a as slackConnectorSchema, c as SlackProcessedEmit, d as SlackSkipReason, i as SlackConnectorConfig, l as SlackProcessedSkip, n as SlackOnAppCreated, o as FunnelSlackEventProcessor, r as SlackPreprocessEvent, s as SlackProcessed, t as FunnelSlackListener, u as SlackRawEvent } from "../slack-listener-Bv5xI9gC.js";
+import { n as FunnelConnectorAdapter, t as CallInput } from "../connector-adapter-1PxjN-Uk.js";
+import { a as slackConnectorSchema, c as SlackProcessedEmit, d as SlackSkipReason, i as SlackConnectorConfig, l as SlackProcessedSkip, n as SlackOnAppCreated, o as FunnelSlackEventProcessor, r as SlackPreprocessEvent, s as SlackProcessed, t as FunnelSlackListener, u as SlackRawEvent } from "../slack-listener-COQA8wAZ.js";
 
-//#region lib/connectors/slack-adapter.d.ts
+//#region lib/engine/connectors/slack-adapter.d.ts
 type SlackWebClientLike = {
   apiCall: (method: string, options?: Record<string, unknown>) => Promise<unknown>;
 };

package/dist/connectors/slack.js

@@ -1,3 +1,3 @@
-import { n as FunnelSlackEventProcessor, r as FunnelSlackAdapter, t as FunnelSlackListener } from "../slack-listener-ClQuHhEF.js";
-import { t as slackConnectorSchema } from "../slack-connector-schema-BCNWluHM.js";
+import { n as FunnelSlackEventProcessor, r as FunnelSlackAdapter, t as FunnelSlackListener } from "../slack-listener-DUKPcpJH.js";
+import { t as slackConnectorSchema } from "../slack-connector-schema-C1zEf4TG.js";
 export { FunnelSlackAdapter, FunnelSlackEventProcessor, FunnelSlackListener, slackConnectorSchema };

package/dist/{connector-diagnostic-log-yTOojKUR.d.ts → diagnostic-log-Bxe7Bbvw.d.ts}

@@ -13,7 +13,7 @@ declare abstract class FunnelLogger {
   abstract readonly file: string | null;
 }
 //#endregion
-//#region lib/connectors/connector-listener.d.ts
+//#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.
@@ -32,7 +32,7 @@ declare abstract class FunnelConnectorListener {
   isAlive(): boolean;
 }
 //#endregion
-//#region lib/gateway/connector-diagnostic-log.d.ts
+//#region lib/gateway/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`

package/dist/diagnostic-sql-reader-CzYgZpq2.js

@@ -0,0 +1,83 @@
+import { Database } from "bun:sqlite";
+//#region lib/gateway/diagnostic-log/diagnostic-sql-reader.ts
+/**
+* Read-only SQL surface over the three diagnostic tables, for Claude to query
+* the log with arbitrary `SELECT`s. It opens all files read-only and exposes
+* three views — `raw`, `processed`, `connection` — that hide the storage
+* details (the physical table is `leuco_log` and each row's columns live
+* inside a JSON `event` blob): the views surface the columns as plain fields,
+* with `payload` already pulled out of the nested JSON.
+*
+* The tables are separate files. `raw` and `processed` share an `event_id`,
+* so a `JOIN` answers "the event arrived, but what verdict did it get?";
+* `connection` answers the other half — "did the listener ever connect at
+* all?". Writes are impossible: the connection is read-only and `query`
+* rejects anything but a single `SELECT`.
+*/
+var ConnectorDiagnosticSqlReader = class {
+	db;
+	constructor(props) {
+		const db = new Database(props.rawPath, { readonly: true });
+		try {
+			db.run("PRAGMA busy_timeout = 500");
+			db.prepare("ATTACH DATABASE ? AS processeddb").run(props.processedPath);
+			db.prepare("ATTACH DATABASE ? AS connectiondb").run(props.connectionPath);
+			db.run(rawViewSql);
+			db.run(processedViewSql);
+			db.run(connectionViewSql);
+		} catch (error) {
+			db.close();
+			throw error;
+		}
+		this.db = db;
+		Object.freeze(this);
+	}
+	/**
+	* Run one read-only `SELECT` and return the rows. Returns an `Error` (rather
+	* than throwing) for a non-SELECT statement or a SQL error, so the caller
+	* can surface the message without a stack trace.
+	*/
+	query(sql, params = []) {
+		const trimmed = sql.trim().replace(/;$/, "").trim();
+		if (!/^select\b/i.test(trimmed)) return /* @__PURE__ */ new Error("only a single SELECT statement is allowed");
+		if (trimmed.includes(";")) return /* @__PURE__ */ new Error("only a single statement is allowed (remove the ';')");
+		try {
+			return this.db.prepare(trimmed).all(...params);
+		} catch (error) {
+			return error instanceof Error ? error : new Error(String(error));
+		}
+	}
+	close() {
+		this.db.close();
+	}
+};
+const rawViewSql = `CREATE TEMP VIEW raw AS SELECT
+  seq,
+  ts,
+  json_extract(event, '$.event_id')     AS event_id,
+  json_extract(event, '$.type')         AS type,
+  json_extract(event, '$.connector_id') AS connector_id,
+  json_extract(event, '$.channel_id')   AS channel_id,
+  json_extract(event, '$.payload')      AS payload
+FROM main.leuco_log`;
+const processedViewSql = `CREATE TEMP VIEW processed AS SELECT
+  seq,
+  ts,
+  json_extract(event, '$.event_id')     AS event_id,
+  json_extract(event, '$.type')         AS type,
+  json_extract(event, '$.connector_id') AS connector_id,
+  json_extract(event, '$.channel_id')   AS channel_id,
+  json_extract(event, '$.outcome')      AS outcome,
+  json_extract(event, '$.payload')      AS payload
+FROM processeddb.leuco_log`;
+const connectionViewSql = `CREATE TEMP VIEW connection AS SELECT
+  seq,
+  ts,
+  json_extract(event, '$.type')         AS type,
+  json_extract(event, '$.connector_id') AS connector_id,
+  json_extract(event, '$.channel_id')   AS channel_id,
+  json_extract(event, '$.status')       AS status,
+  json_extract(event, '$.detail')       AS detail
+FROM connectiondb.leuco_log`;
+//#endregion
+export { ConnectorDiagnosticSqlReader as t };

package/dist/diagnostics.d.ts

@@ -0,0 +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-qWy5tPSq.js";
+export { ChannelDiagnosis, DiagnoseAllReport, DiagnosisStatus, DiagnosticConnectionError, DiagnosticEvent, DiagnosticsChannelSource, DiagnosticsGatewayProbe, DiagnosticsPublisher, DiagnosticsTokenReader, FunnelDiagnostics, ReplayResult, previewOf, queryRows, toDiagnosticConnectionError, toDiagnosticEvent };

package/dist/diagnostics.js

@@ -0,0 +1,2 @@
+import { a as toDiagnosticEvent, i as toDiagnosticConnectionError, n as previewOf, r as queryRows, t as FunnelDiagnostics } from "./funnel-diagnostics-BpKYrMSu.js";
+export { FunnelDiagnostics, previewOf, queryRows, toDiagnosticConnectionError, toDiagnosticEvent };

package/dist/{discord-connector-schema-CBDyGdOI.js → discord-connector-schema-B_N6IXLz.js}

@@ -1,5 +1,5 @@
 import { z } from "zod";
-//#region lib/connectors/discord-connector-schema.ts
+//#region lib/engine/connectors/discord-connector-schema.ts
 /**
 * Like slack, a discord connector holds either a literal `botToken` or a
 * `botTokenEnv` reference resolved from `process.env` at listener start. The

package/dist/{discord-connector-schema-R0Uu-3ns.d.ts → discord-connector-schema-CPgcZkXh.d.ts}

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-//#region lib/connectors/discord-connector-schema.d.ts
+//#region lib/engine/connectors/discord-connector-schema.d.ts
 /**
  * Like slack, a discord connector holds either a literal `botToken` or a
  * `botTokenEnv` reference resolved from `process.env` at listener start. The

package/dist/{discord-listener-_jSE3HsQ.js → discord-listener-C0MoKdQO.js}

@@ -1,6 +1,6 @@
-import { t as FunnelConnectorAdapter } from "./connector-adapter-D5Utumgz.js";
-import { t as resolveConnectorToken } from "./resolve-connector-token-BHmZLRrV.js";
-import { t as FunnelConnectorListener } from "./connector-listener-DU54DN-f.js";
+import { t as FunnelConnectorAdapter } from "./connector-adapter-qwXLjQId.js";
+import { t as resolveConnectorToken } from "./resolve-connector-token-CczqG_Ig.js";
+import { t as FunnelConnectorListener } from "./connector-listener-CpHBecCj.js";
 import { Client, GatewayIntentBits, Partials } from "discord.js";
 //#region lib/engine/http/http-client.ts
 var FunnelHttpClient = class {};
@@ -26,7 +26,7 @@ var NodeFunnelHttpClient = class extends FunnelHttpClient {
 	}
 };
 //#endregion
-//#region lib/connectors/discord-adapter.ts
+//#region lib/engine/connectors/discord-adapter.ts
 const DISCORD_API_BASE = "https://discord.com/api/v10";
 const defaultHttp = new NodeFunnelHttpClient();
 var FunnelDiscordAdapter = class extends FunnelConnectorAdapter {
@@ -63,7 +63,7 @@ var FunnelDiscordAdapter = class extends FunnelConnectorAdapter {
 	}
 };
 //#endregion
-//#region lib/connectors/discord-event-processor.ts
+//#region lib/engine/connectors/discord-event-processor.ts
 var FunnelDiscordEventProcessor = class {
 	ownUserId;
 	constructor(props) {
@@ -86,7 +86,7 @@ var FunnelDiscordEventProcessor = class {
 	}
 };
 //#endregion
-//#region lib/connectors/discord-listener.ts
+//#region lib/engine/connectors/discord-listener.ts
 var FunnelDiscordListener = class extends FunnelConnectorListener {
 	config;
 	channelId;

package/dist/docs.d.ts

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

package/dist/docs.js

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

package/dist/doctor.d.ts

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

package/dist/doctor.js

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

package/dist/{file-process-guard-BgrVHe9I.d.ts → file-process-guard-DI1742H5.d.ts}

@@ -1,7 +1,8 @@
-import { n as FunnelIdGenerator, r as ChannelConfig } from "./settings-reader-BSU6JyvM.js";
-import { S as FunnelLogger } from "./connector-diagnostic-log-yTOojKUR.js";
-import { r as FunnelProcessRunner } from "./process-runner-DfniuWVU.js";
-import { n as FunnelFileSystem } from "./file-system-BeOKXjlV.js";
+import { t as ChannelConfig } from "./settings-schema-zhnMIa8I.js";
+import { n as FunnelIdGenerator } from "./settings-reader-CBrgz01o.js";
+import { S as FunnelLogger } from "./diagnostic-log-Bxe7Bbvw.js";
+import { r as FunnelProcessRunner } from "./process-runner-D5I_jhYQ.js";
+import { n as FunnelFileSystem } from "./file-system-Wub9Nto4.js";
 
 //#region lib/engine/claude/channel-resolver.d.ts
 type ChannelResolver = {
@@ -38,21 +39,12 @@ type SessionStore = {
 };
 //#endregion
 //#region lib/engine/claude/claude.d.ts
-type LaunchOptions = {
+type LaunchCommon = {
   channel: string;
   cwd?: string;
-  userArgs?: string[];
-  /** Stable id of the launching profile (uuid). Keys the singleton PID file and
-   *  the resumable session. Absent for a profile-less launch (raw `--channel`),
-   *  which never enforces singleton-ness and never resumes. */
-  profileId?: string; /** Args prepended to the claude argv (typically a profile's recipe). Defaults to none. */
+  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>;
-  /** Whether to inject a `--session-id`/`--resume` for this profile.
-   *  Defaults to false: resuming is opt-in and only meaningful for a profile,
-   *  since the persisted session is owned by the profile (by id). A launch
-   *  without a profile always starts a fresh session regardless of this flag. */
-  resume?: boolean;
   /** 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
    *  (e.g. multi-session registries that track per-claude liveness). */
@@ -62,6 +54,30 @@ type LaunchOptions = {
    *  does not need the funnel binary as an MCP endpoint. */
   installMcp?: boolean;
 };
+/**
+ * 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-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).
+ */
+type LaunchTarget = {
+  /** Stable id of the launching profile (uuid). 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). */
+  resume?: boolean;
+} | {
+  profileId?: undefined;
+  resume?: undefined;
+};
+type LaunchOptions = LaunchCommon & LaunchTarget;
 type Deps$1 = {
   channels: ChannelResolver;
   mcp: McpInstaller;