@interactive-inc/claude-funnel 0.24.0 → 0.25.1

package/dist/index.d.ts

@@ -151,9 +151,6 @@ declare const channelConfigSchema: z.ZodObject<{
     fanout: "fanout";
     exclusive: "exclusive";
   }>>;
-  options: z.ZodDefault<z.ZodArray<z.ZodString>>;
-  env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-  resume: z.ZodDefault<z.ZodBoolean>;
   connectors: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
@@ -201,6 +198,9 @@ declare const profileConfigSchema: z.ZodObject<{
   name: z.ZodString;
   path: z.ZodString;
   channelId: z.ZodString;
+  options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  resume: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type ProfileConfig = z.infer<typeof profileConfigSchema>;
 declare const SETTINGS_VERSION = 1;
@@ -213,9 +213,6 @@ declare const settingsSchema: z.ZodObject<{
       fanout: "fanout";
       exclusive: "exclusive";
     }>>;
-    options: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    resume: z.ZodDefault<z.ZodBoolean>;
     connectors: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
       id: z.ZodString;
       name: z.ZodString;
@@ -262,6 +259,9 @@ declare const settingsSchema: z.ZodObject<{
     name: z.ZodString;
     path: z.ZodString;
     channelId: z.ZodString;
+    options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resume: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 type Settings = z.infer<typeof settingsSchema>;
@@ -324,14 +324,8 @@ declare class FunnelChannels {
   add(input: {
     name: string;
     delivery?: ChannelDeliveryMode;
-    options?: string[];
-    env?: Record<string, string>;
-    resume?: boolean;
   }): ChannelConfig;
   setDelivery(name: string, delivery: ChannelDeliveryMode): void;
-  setResume(name: string, resume: boolean): void;
-  setOptions(name: string, options: string[]): void;
-  setEnv(name: string, env: Record<string, string>): void;
   remove(name: string): void;
   rename(oldName: string, newName: string): void;
   listConnectors(channelName: string): ConnectorConfig[];
@@ -447,7 +441,10 @@ type LaunchOptions = {
   channel: string;
   cwd?: string;
   userArgs?: string[];
-  profileName?: string;
+  profileName?: 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 the (channel, cwd). Defaults to true. */
+  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). */
@@ -497,8 +494,23 @@ declare class FunnelClaude {
    * a freshly minted one. Backs off when the user already passed a
    * session-shaping flag, since combining them would either confuse claude
    * or override the explicit user intent.
+   *
+   * A persisted id is only resumed when its session jsonl still exists on
+   * disk. claude errors out on `--resume <id>` for a missing conversation, and
+   * a persisted id can outlive its jsonl (claude pruned it, or the very first
+   * launch was aborted after `create` wrote the id but before the jsonl
+   * appeared). When the file is gone we mint a fresh session instead, which
+   * overwrites the dangling entry — so the store self-heals.
    */
   private resolveSession;
+  /**
+   * Mirrors claude's session storage path
+   * (`<config-dir>/projects/<cwd-with-slashes-as-dashes>/<id>.jsonl`) to check
+   * whether a recorded session still exists. Reads the same `CLAUDE_CONFIG_DIR`
+   * the child will run under so the check matches reality; a wrong guess can
+   * only ever produce a false negative (start fresh), never a bad resume.
+   */
+  private sessionFileExists;
   private buildEnv;
 }
 //#endregion
@@ -559,9 +571,6 @@ declare const connectorSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 type ConnectorSpec = z.infer<typeof connectorSpecSchema>;
 declare const channelSpecSchema: z.ZodObject<{
   name: z.ZodString;
-  options: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-  resume: z.ZodOptional<z.ZodBoolean>;
   connectors: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"slack">;
     name: z.ZodString;
@@ -589,13 +598,18 @@ declare const channelSpecSchema: z.ZodObject<{
   }, z.core.$strip>], "type">>>;
 }, z.core.$strip>;
 type ChannelSpec = z.infer<typeof channelSpecSchema>;
+declare const profileSpecSchema: z.ZodObject<{
+  name: z.ZodString;
+  channel: z.ZodString;
+  options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  resume: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ProfileSpec = z.infer<typeof profileSpecSchema>;
 declare const localConfigSchema: z.ZodObject<{
   $schema: z.ZodOptional<z.ZodString>;
   channels: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
-    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    resume: z.ZodOptional<z.ZodBoolean>;
     connectors: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"slack">;
       name: z.ZodString;
@@ -622,6 +636,13 @@ declare const localConfigSchema: z.ZodObject<{
       name: z.ZodString;
     }, z.core.$strip>], "type">>>;
   }, z.core.$strip>>;
+  profiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    channel: z.ZodString;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resume: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 type LocalConfig = z.infer<typeof localConfigSchema>;
 declare const LOCAL_CONFIG_FILENAME = "funnel.json";
@@ -714,9 +735,10 @@ type Deps$8 = {
 };
 /**
  * Named launch presets for `fnl claude`. Each profile bundles a working
- * directory, a sub-agent name, and the channel id its Claude instance will
- * subscribe to. Implements ProfileChannelChecker so FunnelChannels can refuse
- * to remove a channel that is still referenced.
+ * directory, the channel id its Claude instance subscribes to, and the launch
+ * recipe (`options` prepended to the claude argv, `env` layered under the
+ * process, `resume` toggling session reuse). Implements ProfileChannelChecker
+ * so FunnelChannels can refuse to remove a channel that is still referenced.
  *
  * The first entry in the persisted array is treated as the default profile;
  * `asDefault` reorders the array to put a named profile first.
@@ -730,7 +752,14 @@ declare class FunnelProfiles {
   list(): ProfileConfig[];
   get(name: string): ProfileConfig | null;
   getDefault(): ProfileConfig | null;
-  add(config: ProfileConfig): void;
+  add(input: {
+    name: string;
+    path: string;
+    channelId: string;
+    options?: string[];
+    env?: Record<string, string>;
+    resume?: boolean;
+  }): void;
   remove(name: string): void;
   rename(oldName: string, newName: string): void;
   asDefault(name: string): void;
@@ -1480,8 +1509,8 @@ declare const startChannelServer: (options?: ChannelServerOptions) => Promise<vo
 /**
  * Generates the JSON Schema (draft 2020-12) for `funnel.json`. Useful for
  * `$schema` references in committed `funnel.json` files so editors can give
- * autocomplete and validation for channel / subAgent / env / connectors[]
- * without anyone hand-maintaining a separate schema.
+ * autocomplete and validation for channels[] (transport) and profiles[]
+ * (launch recipe) without anyone hand-maintaining a separate schema.
  */
 declare const funnelJsonSchema: () => Record<string, unknown>;
 //#endregion
@@ -2537,6 +2566,11 @@ declare const createCliApp: (funnel: Funnel) => _$hono_hono_base0.HonoBase<Env,
         query: {
           path: string;
           channel: string;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: string;
@@ -2551,6 +2585,11 @@ declare const createCliApp: (funnel: Funnel) => _$hono_hono_base0.HonoBase<Env,
         query: {
           path: string;
           channel: string;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: `added profile "${string}"`;
@@ -2578,6 +2617,11 @@ declare const createCliApp: (funnel: Funnel) => _$hono_hono_base0.HonoBase<Env,
         query: {
           path?: string | undefined;
           channel?: string | undefined;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: string;
@@ -2592,6 +2636,11 @@ declare const createCliApp: (funnel: Funnel) => _$hono_hono_base0.HonoBase<Env,
         query: {
           path?: string | undefined;
           channel?: string | undefined;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: `updated profile "${string}"`;
@@ -3818,6 +3867,11 @@ declare const app: _$hono_hono_base0.HonoBase<Env, {
         query: {
           path: string;
           channel: string;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: string;
@@ -3832,6 +3886,11 @@ declare const app: _$hono_hono_base0.HonoBase<Env, {
         query: {
           path: string;
           channel: string;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: `added profile "${string}"`;
@@ -3859,6 +3918,11 @@ declare const app: _$hono_hono_base0.HonoBase<Env, {
         query: {
           path?: string | undefined;
           channel?: string | undefined;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: string;
@@ -3873,6 +3937,11 @@ declare const app: _$hono_hono_base0.HonoBase<Env, {
         query: {
           path?: string | undefined;
           channel?: string | undefined;
+          agent?: string | undefined;
+          options?: string | undefined;
+          env?: string | undefined;
+          resume?: string | undefined;
+          "no-resume"?: string | undefined;
         };
       };
       output: `updated profile "${string}"`;
@@ -4317,4 +4386,4 @@ ${string}`;
 //#region lib/tui/tui.d.ts
 declare function launchTui(funnel: Funnel): Promise<void>;
 //#endregion
-export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelServerOptions, ChannelSpec, ConnectorConfig, ConnectorSpec, ConnectorSyncOutcome, ConnectorType, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiscordConnectorConfig, Env, FUNNEL_DIR, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, FunnelDotenvReader, FunnelEvent, FunnelEventStore, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSessions, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, type GatewayEmitInput, type GatewayRouteDeps, type Env$1 as GatewayServerEnv, GhConnectorConfig, LOCAL_CONFIG_FILENAME, LOCAL_ENV_FILENAME, LaunchOptions, ListListenersResult, ListenerEntry, ListenerOpResult, LocalConfig, LocalConfigSyncResult, LogEntry, MemoryFunnelClock, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, NotifyFn, OnFunnelError, ProcessListStub, ProcessSnapshot, ProfileConfig, PublishRequest, PublishResponse, PublishResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, app as cliApp, connectorConfigSchema, connectorSpecSchema, createCliApp, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, launchTui, localConfigSchema, profileConfigSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };
+export { AliveStub, AttachOptions, BroadcastEvent, BroadcastSubscriber, ChannelConfig, ChannelConnectorView, ChannelDeliveryMode, ChannelServerOptions, ChannelSpec, ConnectorConfig, ConnectorSpec, ConnectorSyncOutcome, ConnectorType, DEFAULT_GATEWAY_TOKEN_PATH, DetachOptions, DiscordConnectorConfig, Env, FUNNEL_DIR, FUNNEL_MCP_COMMAND, FUNNEL_MCP_NAME, FileStat, Funnel, FunnelBroadcaster, FunnelChannelPublisher, FunnelChannels, FunnelClaude, FunnelClock, FunnelConnectorFactory, FunnelConnectorListener, FunnelDotenvReader, FunnelEvent, FunnelEventStore, FunnelFileSystem, FunnelGateway, FunnelGatewayServer, FunnelGatewayToken, FunnelIdGenerator, FunnelListenerSupervisor, FunnelListenersClient, FunnelLocalConfig, FunnelLocalConfigSync, FunnelLogger, FunnelMcp, FunnelProcessRunner, FunnelProfiles, FunnelSessions, FunnelSettingsReader, FunnelSettingsStore, FunnelSlackEventProcessor, FunnelTokenPrompter, type GatewayEmitInput, type GatewayRouteDeps, type Env$1 as GatewayServerEnv, GhConnectorConfig, LOCAL_CONFIG_FILENAME, LOCAL_ENV_FILENAME, LaunchOptions, ListListenersResult, ListenerEntry, ListenerOpResult, LocalConfig, LocalConfigSyncResult, LogEntry, MemoryFunnelClock, MemoryFunnelFileSystem, MemoryFunnelIdGenerator, MemoryFunnelLogger, MemoryFunnelProcessRunner, MemoryFunnelTokenPrompter, MemoryProcessCall, MemoryProcessHandler, MemoryProcessResponse, MemoryProcessSyncHandler, MockFunnelSettingsReader, NodeFunnelClock, NodeFunnelFileSystem, NodeFunnelIdGenerator, NodeFunnelLogger, NodeFunnelProcessRunner, NodeFunnelTokenPrompter, NoopFunnelLogger, NotifyFn, OnFunnelError, ProcessListStub, ProcessSnapshot, ProfileConfig, ProfileSpec, PublishRequest, PublishResponse, PublishResult, ReplayableEvent, RunOptions, RunResult, SETTINGS_PATH, SETTINGS_VERSION, ScheduleCatchupPolicy, ScheduleConnectorConfig, ScheduleEntry, ScheduleListenerOptions, Settings, SlackConnectorConfig, SlackListenerOptions, SlackProcessed, SlackProcessedEmit, SlackProcessedSkip, SlackRawEvent, channelConfigSchema, channelDeliveryModeSchema, channelSpecSchema, app as cliApp, connectorConfigSchema, connectorSpecSchema, createCliApp, createSettings, discordConnectorSchema, factory, funnelEventSchema, funnelJsonSchema, ghConnectorSchema, launchTui, localConfigSchema, profileConfigSchema, profileSpecSchema, publishRequestSchema, publishResponseSchema, queryToCliArgs, scheduleCatchupPolicySchema, scheduleConnectorSchema, scheduleEntrySchema, settingsSchema, slackConnectorSchema, startChannelServer, toRequest };