@bike4mind/cli 0.15.2 → 0.16.0

package/README.md

@@ -578,6 +578,55 @@ Coming soon:
 ⏳ Session search and management
 ⏳ Tool execution monitoring
 
+## Running as a `claude` engine inside a host app
+
+The CLI can be driven by a host app (e.g. a kanban-style agent pipeline) as a
+drop-in replacement for `claude` — running a pipeline **stage** or a **board AI /
+YAML** pane with full parity (board tools over HTTP MCP, the 3-layer brief
+injected, the spec auto-fired on turn 1, and the live-card `processing` /
+`action_required` / `ready` signal).
+
+A host that only launches an engine whose executable basename is exactly `claude`
+can be pointed at a **symlink** named `claude`:
+
+```bash
+# Create a claude-named symlink to the CLI entry point somewhere on disk:
+ln -s "$(pwd)/apps/cli/bin/bike4mind-cli.mjs" /usr/local/bin/claude-b4m/claude
+
+# In the host, set the engine's `terminal_command` to that symlink path:
+#   /usr/local/bin/claude-b4m/claude
+```
+
+Use a **direct symlink** whose basename is `claude` — not a `package.json` bin
+alias (it would shadow the real `claude`) and not a wrapper shell script (argv
+gets mangled). No other setup is required; the CLI replicates claude's launch-flag
+and lifecycle-hook contract.
+
+### Supported claude-compatible flags
+
+These are parsed in `bin/bike4mind-cli.mjs` into `B4M_*` env vars consumed by the
+runtime. Unknown flags are tolerated (never hard-error) and the interactive TUI is
+preserved (a positional prompt seeds **and** submits turn 1 without switching to
+headless `-p`):
+
+| Flag | Effect |
+| --- | --- |
+| `--mcp-config <file>` | Inject MCP servers from a claude-shape JSON (`{ "mcpServers": {...} }`). Supports HTTP transport (`type: "http"`, `url`, `headers`) with per-launch Bearer auth. |
+| `--strict-mcp-config` | Use ONLY `--mcp-config` servers; ignore file-config and `.mcp.json` (board YAML pane). |
+| `--append-system-prompt <text>` | Append text verbatim to the end of the system prompt (the 3-layer brief). |
+| `--allowedTools <patterns>` | Auto-approve matching tools without a permission prompt (glob `mcp__manifold__*` or a space-separated explicit list). |
+| `--settings <json>` | Inline JSON; the `hooks` subset drives lifecycle hooks (see below). Malformed JSON is ignored, never fatal. |
+| `--session-id <uuid>` / `--resume <uuid>` | Pin / resume a session (board pane). `/clear` and `/compact` keep the pinned uuid; a bad `--resume` prints `No conversation found with session ID <uuid>` and exits non-zero so the host can self-heal the pane. |
+| `<positional prompt>` | Seeds and auto-fires turn 1 while staying interactive. |
+
+### Lifecycle hooks (`--settings.hooks`)
+
+Mirrors claude's hook contract for the host's `action_required` signal: a
+`Notification`/`permission_prompt` command writes a sentinel file while an
+interactive permission prompt blocks; `PostToolUse` / `Stop` / `UserPromptSubmit`
+commands remove it. Each hook command runs via a real shell with its stdin piped
+then closed (EOF), so a blocking `cat > <file>` hook returns immediately.
+
 ## License
 
 Private - Bike4Mind

package/bin/bike4mind-cli.mjs

@@ -111,6 +111,39 @@ const argv = await yargs(hideBin(process.argv))
     type: 'string',
     description: 'Add local Ollama models to the model picker (e.g. http://localhost:11434)',
   })
+  // ─── claude-compatible flags (host drop-in masquerade) ──────────────────────
+  // Declared so a host's claude launch flags parse into named options instead of
+  // leaking into the positional `argv._` task. See apps/cli README "host app".
+  .option('mcp-config', {
+    type: 'string',
+    description: 'Path to a JSON file of MCP servers to inject ({ "mcpServers": {...} })',
+  })
+  .option('strict-mcp-config', {
+    type: 'boolean',
+    description: 'Use ONLY --mcp-config servers; ignore file-config and .mcp.json',
+    default: false,
+  })
+  .option('append-system-prompt', {
+    type: 'string',
+    description: 'Text appended verbatim to the end of the composed system prompt',
+  })
+  .option('allowedTools', {
+    type: 'array',
+    string: true,
+    description: 'Tool names/globs auto-approved without a permission prompt (e.g. mcp__manifold__*)',
+  })
+  .option('settings', {
+    type: 'string',
+    description: 'Inline JSON settings (currently: lifecycle hooks) merged over user config',
+  })
+  .option('session-id', {
+    type: 'string',
+    description: 'Pin this session to a fixed uuid (first launch of a resumable pane)',
+  })
+  .option('resume', {
+    type: 'string',
+    description: 'Resume an existing session by uuid',
+  })
   .option('api-url', {
     type: 'string',
     description: 'Set a custom API URL (self-hosted instance) and clear auth tokens, then exit',
@@ -197,6 +230,39 @@ if (argv['ollama-host']) {
   process.env.B4M_OLLAMA_HOST = argv['ollama-host'];
 }
 
+// ─── claude-compatible flags → B4M_* env (read by src/index.tsx init) ─────────
+// Mirrors the established bin→env→init channel (cf. --add-dir → B4M_ADDITIONAL_DIRS).
+if (argv['mcp-config']) {
+  process.env.B4M_MCP_CONFIG_FILE = resolve(argv['mcp-config']);
+}
+if (argv['strict-mcp-config']) {
+  process.env.B4M_STRICT_MCP_CONFIG = '1';
+}
+if (argv['append-system-prompt']) {
+  process.env.B4M_APPEND_SYSTEM_PROMPT = argv['append-system-prompt'];
+}
+if (argv.allowedTools && argv.allowedTools.length > 0) {
+  // Each element may itself be a space-separated list (the host's board pane passes
+  // "a b c" as a single argv token); flatten on whitespace into discrete patterns.
+  const patterns = argv.allowedTools.flatMap((s) => String(s).split(/\s+/)).filter(Boolean);
+  process.env.B4M_ALLOWED_TOOLS = JSON.stringify(patterns);
+}
+if (argv.settings) {
+  process.env.B4M_SETTINGS_JSON = argv.settings;
+}
+if (argv['session-id']) {
+  process.env.B4M_SESSION_ID = argv['session-id'];
+}
+if (argv.resume) {
+  process.env.B4M_RESUME_ID = argv.resume;
+}
+// Positional task (claude `<prompt>` form): seeds AND submits turn 1, stays interactive.
+// Only when it's not a known subcommand and headless -p wasn't used.
+const KNOWN_SUBCOMMANDS = new Set(['mcp', 'update', 'doctor']);
+if (argv.prompt === undefined && argv._.length > 0 && !KNOWN_SUBCOMMANDS.has(String(argv._[0]))) {
+  process.env.B4M_INITIAL_PROMPT = String(argv._[0]);
+}
+
 // Auto-detect environment: prefer production mode when dist exists
 const distPath = join(__dirname, '../dist/index.mjs');
 const srcPath = join(__dirname, '../src/index.tsx');

package/dist/{ConfigStore-w0o_0xs0.mjs → ConfigStore-CtGc4fF2.mjs}

@@ -291,9 +291,6 @@ let ImageModels = /* @__PURE__ */ function(ImageModels) {
 	ImageModels["FLUX_PRO_1_1"] = "flux-pro-1.1";
 	ImageModels["FLUX_PRO_ULTRA"] = "flux-pro-1.1-ultra";
 	ImageModels["FLUX_PRO_FILL"] = "flux-pro-1.0-fill";
-	ImageModels["FLUX_PRO_CANNY"] = "flux-pro-1.0-canny";
-	ImageModels["FLUX_PRO_DEPTH"] = "flux-pro-1.0-depth";
-	ImageModels["FLUX_DEV"] = "flux-dev";
 	ImageModels["FLUX_KONTEXT_PRO"] = "flux-kontext-pro";
 	ImageModels["FLUX_KONTEXT_MAX"] = "flux-kontext-max";
 	ImageModels["GROK_IMAGINE_IMAGE_QUALITY"] = "grok-imagine-image-quality";
@@ -2663,7 +2660,8 @@ const AgentCompletedAction = z.object({
 	executionId: z.string(),
 	answer: z.string().optional(),
 	totalIterations: z.number(),
-	totalCreditsUsed: z.number()
+	totalCreditsUsed: z.number(),
+	mementoIds: z.array(z.string()).optional()
 });
 const AgentFailedAction = z.object({
 	action: z.literal("failed"),
@@ -3615,10 +3613,26 @@ const OpenAIImageStyleSchema = z.enum(["vivid", "natural"]);
 /**
 * Maps legacy/removed image model IDs to their current replacements.
 * Prevents Zod validation failures when clients send stale persisted model names.
+*
+* Values are constrained to `ALL_IMAGE_MODELS` so a remap target can never point at
+* a model that the schema would itself reject. If a target model is later retired,
+* re-point its entry to the current replacement rather than deleting it — clients may
+* still hold the legacy key in persisted state. When adding an entry, bump the
+* `llm-settings` persist `version` in LLMContext so existing clients re-run the remap.
+*
+* Only `flux-dev` is aliased among the recently removed Flux ids. It was a general
+* text-to-image model with a confirmed stale client (#8853), so remapping to the
+* current BFL standard is safe and faithful. `flux-pro-1.0-canny` and
+* `flux-pro-1.0-depth` are intentionally left as hard validation errors: they were
+* never UI-selectable (nothing persists them, and no alerts show callers sending them)
+* and they are structural-control models — silently remapping them to a plain
+* text-to-image model would drop the control image and return the wrong kind of result,
+* so a clear "unsupported model" error is the more honest response.
 */
 const LEGACY_IMAGE_MODEL_MAP = {
 	"dall-e-3": "gpt-image-1",
-	"dall-e-2": "gpt-image-1"
+	"dall-e-2": "gpt-image-1",
+	"flux-dev": "flux-pro-1.1"
 };
 const OpenAIImageGenerationInput = z.object({
 	prompt: z.string(),
@@ -3829,6 +3843,8 @@ z.enum([
 	"logoSettings",
 	"enforceCredits",
 	"enableTeamPlan",
+	"allowOpenRegistration",
+	"defaultFreeCredits",
 	"enableGoogleCalendar",
 	"googleCalendarServiceAccountEmail",
 	"googleCalendarServiceAccountSecret",
@@ -3885,6 +3901,22 @@ z.enum([
 	"overwatchRollupSync",
 	"orchestrationDefaults"
 ]);
+/**
+* Intent-classifier sub-config (#8924). Drives the LLM-based silent
+* auto-routing classifier that decides between quest_processor and
+* agent_executor for `contextual` queries. The cascade reuses
+* `getLlmWithFallback()` so a missing primary API key transparently degrades.
+*
+* `shadowMode: true` means the endpoint computes a decision and emits
+* telemetry but no client wires it into routing yet (M3 ships dark-launched;
+* M4 flips clients onto it).
+*/
+const IntentClassifierConfigSchema = z.object({
+	enabled: z.boolean().default(true),
+	shadowMode: z.boolean().default(true),
+	primaryModel: z.string().default("claude-haiku-4-5-20251001"),
+	fallbackModels: z.array(z.string()).default(["gemini-2.5-flash-lite", "gpt-4.1-nano-2025-04-14"])
+});
 const OrchestrationDefaultsSchema = z.object({
 	/** Tool names the synthetic profile is allowed to invoke. */
 	allowedTools: z.array(z.string()).default([
@@ -3922,7 +3954,9 @@ const OrchestrationDefaultsSchema = z.object({
 	* synthetic profiles can decompose multi-step queries; admins can flip off
 	* org-wide if DAG behavior surprises end users.
 	*/
-	dagEnabled: z.boolean().default(true)
+	dagEnabled: z.boolean().default(true),
+	/** LLM intent-classifier configuration (#8924). */
+	intentClassifier: IntentClassifierConfigSchema.default(IntentClassifierConfigSchema.parse({}))
 });
 function makeStringSetting(config) {
 	return {
@@ -5747,6 +5781,22 @@ const settingsMap = {
 		group: API_SERVICE_GROUPS.CREDITS.id,
 		category: "Users"
 	}),
+	allowOpenRegistration: makeBooleanSetting({
+		key: "allowOpenRegistration",
+		name: "Allow Open Registration",
+		defaultValue: false,
+		description: "Master switch for self-serve signup. When OFF (default), a valid invite code is required to register. When ON, users may register without an invite code; the Default Free Credits grant is then applied after they verify their email (anti-spam — see Default Free Credits). Safe to enable: the pre-request credit reservation caps every free user at the credits they are granted.",
+		group: API_SERVICE_GROUPS.CREDITS.id,
+		category: "Users"
+	}),
+	defaultFreeCredits: makeNumberSetting({
+		key: "defaultFreeCredits",
+		name: "Default Free Credits",
+		defaultValue: 0,
+		description: "Credits granted to a user who registers WITHOUT an invite code (only applies when Allow Open Registration is ON). Granted after the user verifies their email, NOT at signup — an unverified throwaway account gets 0 credits (anti-spam). A free user can never spend more than this — their hard ceiling of real model cost is roughly credits ÷ 1500 USD.",
+		group: API_SERVICE_GROUPS.CREDITS.id,
+		category: "Users"
+	}),
 	FacebookLink: makeStringSetting({
 		key: "FacebookLink",
 		name: "Facebook Link",
@@ -8326,7 +8376,25 @@ z.object({
 	/** Persona-based sub-agent filter — only these agent names are available for delegation */
 	allowedAgents: z.array(z.string()).optional(),
 	/** When true, Quest Processor injects Slack-specific tool configs (help, notebooks, curated files) */
-	enableSlackTools: z.boolean().optional()
+	enableSlackTools: z.boolean().optional(),
+	/**
+	* Agent-mode toggle state forwarded from the composer (#8923). The chat
+	* completion path itself does not branch on this — that decision happens
+	* upstream in `routeQuery()` on the client (and, post-M4, on the server).
+	* Plumbed through so telemetry and future per-decision routing logs can
+	* attribute the choice to its source (manual toggle vs. classifier vs.
+	* mention) without re-deriving it.
+	*/
+	agentMode: z.object({
+		enabled: z.boolean(),
+		source: z.enum([
+			"toggle",
+			"classifier",
+			"mention",
+			"user-default",
+			"agent_literal"
+		])
+	}).optional()
 }).extend({
 	/** Notebook session ID */
 	sessionId: z.string().optional(),
@@ -10202,11 +10270,32 @@ const ApiConfigSchema = z.object({ customUrl: z.url().optional() });
 */
 const McpServerSchema = z.object({
 	name: z.string(),
+	type: z.enum(["stdio", "http"]).optional(),
 	command: z.string().optional(),
 	args: z.array(z.string()).optional(),
+	url: z.string().optional(),
+	headers: z.record(z.string(), z.string()).optional(),
 	env: z.record(z.string(), z.string()).prefault({}),
 	enabled: z.boolean().prefault(true)
-});
+}).superRefine(mcpServerTransportRefine);
+/**
+* A valid MCP server is exactly one of:
+*  - stdio: has `command` (spawned child process)
+*  - http:  has `url` (streamable-HTTP endpoint)
+* Rejecting malformed configs at parse time (not connect time) surfaces errors early.
+*/
+function mcpServerTransportRefine(server, ctx) {
+	const hasCommand = typeof server.command === "string" && server.command.trim() !== "";
+	const hasUrl = typeof server.url === "string" && server.url.trim() !== "";
+	if (hasCommand && hasUrl) ctx.addIssue({
+		code: "custom",
+		message: "MCP server cannot set both \"command\" (stdio) and \"url\" (http)"
+	});
+	else if (!hasCommand && !hasUrl) ctx.addIssue({
+		code: "custom",
+		message: "MCP server must set either \"command\" (stdio) or \"url\" (http)"
+	});
+}
 /**
 * MCP Servers can be specified in two formats:
 * 1. Array format (B4M native): [{ "name": "...", "command": "...", ... }]
@@ -10215,11 +10304,14 @@ const McpServerSchema = z.object({
 * Both formats are supported for maximum flexibility and compatibility.
 */
 const McpServersSchema = z.union([z.array(McpServerSchema), z.record(z.string(), z.object({
+	type: z.enum(["stdio", "http"]).optional(),
 	command: z.string().optional(),
 	args: z.array(z.string()).optional(),
+	url: z.string().optional(),
+	headers: z.record(z.string(), z.string()).optional(),
 	env: z.record(z.string(), z.string()).optional(),
 	enabled: z.boolean().optional()
-}))]);
+}).superRefine(mcpServerTransportRefine))]);
 /**
 * Normalize MCP servers to internal array format
 * Accepts both array and object formats
@@ -10227,15 +10319,21 @@ const McpServersSchema = z.union([z.array(McpServerSchema), z.record(z.string(),
 function normalizeMcpServers(servers) {
 	if (Array.isArray(servers)) return servers.map((server) => ({
 		name: server.name,
+		type: server.type,
 		command: server.command,
 		args: server.args,
+		url: server.url,
+		headers: server.headers,
 		env: server.env || {},
 		enabled: server.enabled ?? true
 	}));
 	else return Object.entries(servers).map(([name, config]) => ({
 		name,
+		type: config.type,
 		command: config.command,
 		args: config.args,
+		url: config.url,
+		headers: config.headers,
 		env: config.env || {},
 		enabled: config.enabled ?? true
 	}));
@@ -10467,6 +10565,29 @@ async function loadMcpJsonConfig(projectDir) {
 	}
 }
 /**
+* Load an explicit `--mcp-config <file>` (claude shape: `{ "mcpServers": {...} }`).
+* Unlike `.mcp.json` this is an absolute path passed at launch, not project-relative.
+* Returns null on missing/malformed file (a bad config must not brick the launch).
+*/
+async function loadMcpConfigFile(filePath) {
+	try {
+		const data = await promises.readFile(filePath, "utf-8");
+		const rawConfig = JSON.parse(data);
+		return normalizeMcpServers(McpJsonConfigSchema.parse(rawConfig).mcpServers);
+	} catch (error) {
+		if (error.code === "ENOENT") {
+			console.error(`--mcp-config file not found: ${filePath}`);
+			return null;
+		}
+		if (error instanceof z.ZodError) {
+			console.error("--mcp-config validation error:", error.issues);
+			return null;
+		}
+		console.error("Failed to load --mcp-config file:", error);
+		return null;
+	}
+}
+/**
 * Merge MCP servers from multiple configs
 * Later configs can override earlier ones by name
 */
@@ -10648,6 +10769,12 @@ var ConfigStore = class {
 			} else this.projectConfigDir = null;
 			const mergedConfig = mergeConfigs(globalConfig, projectConfig, projectLocalConfig);
 			if (mcpJsonServers && mcpJsonServers.length > 0) mergedConfig.mcpServers = mergeMcpServers(mcpJsonServers, mergedConfig.mcpServers);
+			const mcpConfigFile = process.env.B4M_MCP_CONFIG_FILE;
+			if (mcpConfigFile) {
+				const injected = await loadMcpConfigFile(mcpConfigFile);
+				if (process.env.B4M_STRICT_MCP_CONFIG === "1") mergedConfig.mcpServers = injected ?? [];
+				else if (injected) mergedConfig.mcpServers = mergeMcpServers(mergedConfig.mcpServers, injected);
+			}
 			this.config = mergedConfig;
 			return this.config;
 		} catch (error) {

package/dist/commands/apiCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-w0o_0xs0.mjs";
+import { t as ConfigStore } from "../ConfigStore-CtGc4fF2.mjs";
 //#region src/commands/apiCommand.ts
 /**
 * External API config command (--api-url / --reset-api)

package/dist/commands/doctorCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "../package-C9MYdYCP.mjs";
+import { t as version } from "../package-3pouvthv.mjs";
 import { a as fetchLatestVersion, c as isNpmPrefixWritable, i as compareSemver } from "../updateChecker-C8xsNY2L.mjs";
 import { t as checkRipgrep } from "../ripgrepCheck-BmkyTK2i.mjs";
 import { execSync } from "child_process";

package/dist/commands/envCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-w0o_0xs0.mjs";
+import { t as ConfigStore } from "../ConfigStore-CtGc4fF2.mjs";
 //#region src/commands/envCommand.ts
 /**
 * Environment switching for the `--dev` / `--prod` launch flags.

package/dist/commands/headlessCommand.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as generateCliTools, G as buildSystemPrompt, J as ReActAgent, N as loadContextFiles, P as PermissionManager, Q as SessionStore, S as ApiClient, T as FallbackLlmBackend, U as setWebSocketToolExecutor, X as CheckpointStore, Y as CustomCommandStore, _ as createAgentDelegateTool, b as createSkillTool, d as createFindDefinitionTool, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, k as McpManager, m as createCoordinateTaskTool, p as createWriteTodosTool, q as isReadOnlyTool, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, y as SubagentOrchestrator } from "../tools-j5oGazTr.mjs";
-import { n as logger, r as getApiUrl, t as ConfigStore } from "../ConfigStore-w0o_0xs0.mjs";
+import { $ as SessionStore, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as generateCliTools, J as isReadOnlyTool, K as buildSystemPrompt, N as loadContextFiles, P as PermissionManager, S as ApiClient, T as FallbackLlmBackend, W as setWebSocketToolExecutor, X as CustomCommandStore, Y as ReActAgent, Z as CheckpointStore, _ as createAgentDelegateTool, b as createSkillTool, d as createFindDefinitionTool, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, k as McpManager, m as createCoordinateTaskTool, p as createWriteTodosTool, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, y as SubagentOrchestrator } from "../tools-D9eSRR7Q.mjs";
+import { n as logger, r as getApiUrl, t as ConfigStore } from "../ConfigStore-CtGc4fF2.mjs";
 import { t as DEFAULT_SANDBOX_CONFIG } from "../types-LyRNHOiS.mjs";
 import { t as createSandboxRuntime } from "../SandboxRuntimeAdapter-ChGlxSGQ.mjs";
 import { t as SandboxOrchestrator } from "../SandboxOrchestrator-BoINxbX4.mjs";

package/dist/commands/mcpCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-w0o_0xs0.mjs";
+import { t as ConfigStore } from "../ConfigStore-CtGc4fF2.mjs";
 //#region src/commands/mcpCommand.ts
 /**
 * External MCP commands (b4m mcp list, b4m mcp add, etc.)

package/dist/commands/updateCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "../package-C9MYdYCP.mjs";
+import { t as version } from "../package-3pouvthv.mjs";
 import { c as isNpmPrefixWritable, l as setAutoUpdatePreference, n as REEXEC_GUARD_ENV, o as forceCheckForUpdate, r as checkForUpdate, s as getAutoUpdatePreference, t as INSTALL_CMD, u as shouldAttemptAutoUpdate } from "../updateChecker-C8xsNY2L.mjs";
 import { t as checkRipgrep } from "../ripgrepCheck-BmkyTK2i.mjs";
 import { execSync, spawnSync } from "child_process";

package/dist/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { $ as OAuthClient, A as substituteArguments, B as DEFAULT_THOROUGHNESS, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as generateCliTools, G as buildSystemPrompt, H as registerFeatureModuleTools, I as ALWAYS_DENIED_FOR_AGENTS, J as ReActAgent, K as buildSkillsPromptSection, L as DEFAULT_AGENT_MODEL, M as extractCompactInstructions, N as loadContextFiles, O as isTransientNetworkError, P as PermissionManager, Q as SessionStore, R as DEFAULT_MAX_ITERATIONS, S as ApiClient, T as FallbackLlmBackend, U as setWebSocketToolExecutor, V as clearFeatureModuleTools, W as getPlanModeFilePath, X as CheckpointStore, Y as CustomCommandStore, Z as CommandHistoryStore, _ as createAgentDelegateTool, a as createBlockerTools, at as searchFiles, b as createSkillTool, c as createDecisionStore, d as createFindDefinitionTool, et as hasFileReferences, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, i as createBlockerStore, it as formatFileSize, j as formatStep, k as McpManager, l as formatDecisionsOutput, m as createCoordinateTaskTool, n as createReviewGateTool, nt as searchCommands, o as formatBlockersOutput, ot as warmFileCache, p as createWriteTodosTool, q as isReadOnlyTool, r as formatReviewGatesOutput, rt as mergeCommands, s as createDecisionLogTool, t as createReviewGateStore, tt as processFileReferences, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, x as parseAgentConfig, y as SubagentOrchestrator, z as DEFAULT_RETRY_CONFIG } from "./tools-j5oGazTr.mjs";
+import { $ as SessionStore, A as substituteArguments, B as DEFAULT_RETRY_CONFIG, C as WebSocketToolExecutor, D as ServerLlmBackend, E as WebSocketLlmBackend, F as generateCliTools, G as getPlanModeFilePath, H as clearFeatureModuleTools, I as getProcessHooks, J as isReadOnlyTool, K as buildSystemPrompt, L as ALWAYS_DENIED_FOR_AGENTS, M as extractCompactInstructions, N as loadContextFiles, O as isTransientNetworkError, P as PermissionManager, Q as CommandHistoryStore, R as DEFAULT_AGENT_MODEL, S as ApiClient, T as FallbackLlmBackend, U as registerFeatureModuleTools, V as DEFAULT_THOROUGHNESS, W as setWebSocketToolExecutor, X as CustomCommandStore, Y as ReActAgent, Z as CheckpointStore, _ as createAgentDelegateTool, a as createBlockerTools, at as formatFileSize, b as createSkillTool, c as createDecisionStore, d as createFindDefinitionTool, et as OAuthClient, f as createTodoStore, g as BackgroundAgentManager, h as createBackgroundAgentTools, i as createBlockerStore, it as mergeCommands, j as formatStep, k as McpManager, l as formatDecisionsOutput, m as createCoordinateTaskTool, n as createReviewGateTool, nt as processFileReferences, o as formatBlockersOutput, ot as searchFiles, p as createWriteTodosTool, q as buildSkillsPromptSection, r as formatReviewGatesOutput, rt as searchCommands, s as createDecisionLogTool, st as warmFileCache, t as createReviewGateStore, tt as hasFileReferences, u as createGetFileStructureTool, v as AgentStore, w as WebSocketConnectionManager, x as parseAgentConfig, y as SubagentOrchestrator, z as DEFAULT_MAX_ITERATIONS } from "./tools-D9eSRR7Q.mjs";
 import { n as useCliStore, t as selectActiveBackgroundAgents } from "./store-DV5s-qni.mjs";
-import { Gt as validateNotebookPath$1, Wt as validateJupyterKernelName, g as CREDIT_DEDUCT_TRANSACTION_TYPES, i as getEnvironmentName, n as logger, r as getApiUrl, t as ConfigStore, v as ChatModels } from "./ConfigStore-w0o_0xs0.mjs";
-import { t as version } from "./package-C9MYdYCP.mjs";
+import { Gt as validateNotebookPath$1, Wt as validateJupyterKernelName, g as CREDIT_DEDUCT_TRANSACTION_TYPES, i as getEnvironmentName, n as logger, r as getApiUrl, t as ConfigStore, v as ChatModels } from "./ConfigStore-CtGc4fF2.mjs";
+import { t as version } from "./package-3pouvthv.mjs";
 import { r as checkForUpdate } from "./updateChecker-C8xsNY2L.mjs";
 import React, { useCallback, useEffect, useMemo, useReducer, useRef, useState } from "react";
 import { Box, Static, Text, render, useApp, useInput, usePaste, useStdout } from "ink";
@@ -3083,7 +3083,7 @@ function buildCompactionPrompt(messages, options = {}) {
 * @param preservedMessages - Recent messages to keep verbatim
 * @returns A new session with compacted context
 */
-function createCompactedSession(originalSession, summary, preservedMessages) {
+function createCompactedSession(originalSession, summary, preservedMessages, preserveId = false) {
 	const summaryMessage = {
 		id: v4(),
 		role: "user",
@@ -3103,7 +3103,7 @@ function createCompactedSession(originalSession, summary, preservedMessages) {
 		...preservedMessages
 	] : [summaryMessage, ...preservedMessages];
 	return {
-		id: v4(),
+		id: preserveId ? originalSession.id : v4(),
 		name: `${originalSession.name} (compacted)`,
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -6327,8 +6327,18 @@ function CliApp() {
 				logger.warn(`🤖 Using fallback model: ${modelInfo.id}`);
 			}
 			llm.currentModel = modelInfo.id;
-			const newSession = {
-				id: v4(),
+			const pinnedSessionId = process.env.B4M_SESSION_ID;
+			const resumeSessionId = process.env.B4M_RESUME_ID;
+			let newSession;
+			if (resumeSessionId) {
+				const resumed = await state.sessionStore.load(resumeSessionId);
+				if (!resumed) {
+					console.error(`No conversation found with session ID ${resumeSessionId}`);
+					process.exit(1);
+				}
+				newSession = resumed;
+			} else newSession = {
+				id: pinnedSessionId || v4(),
 				name: `Session ${(/* @__PURE__ */ new Date()).toLocaleString()}`,
 				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 				updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -6392,6 +6402,7 @@ function CliApp() {
 			let permissionPromptCounter = 0;
 			const promptFn = (toolName, args, preview) => {
 				return new Promise((resolve) => {
+					getProcessHooks()?.fireNotificationPermissionPrompt(toolName);
 					const canBeTrusted = permissionManager.canBeTrusted(toolName);
 					const id = `perm-${++permissionPromptCounter}`;
 					const prompt = {
@@ -6600,6 +6611,7 @@ function CliApp() {
 				additionalDirectories,
 				featureModulePrompts: featureModulePrompts || void 0,
 				planModeFilePath: mode === "plan" ? getPlanModeFilePath(newSession.id) : void 0,
+				appendSystemPrompt: process.env.B4M_APPEND_SYSTEM_PROMPT,
 				deferredToolNames: deferredToolRegistry.getDirectoryNames()
 			});
 			const cliSystemPrompt = buildPromptForMode(useCliStore.getState().interactionMode);
@@ -6778,6 +6790,16 @@ function CliApp() {
 	const handleMessageRef = useRef(null);
 	const abortControllerRef = useRef(state.abortController);
 	abortControllerRef.current = state.abortController;
+	const autoFiredRef = useRef(false);
+	useEffect(() => {
+		if (!isInitialized || autoFiredRef.current) return;
+		const initialPrompt = process.env.B4M_INITIAL_PROMPT;
+		if (!initialPrompt) return;
+		autoFiredRef.current = true;
+		setImmediate(() => {
+			handleMessageRef.current?.(initialPrompt);
+		});
+	}, [isInitialized]);
 	const emitNextAwaitingStatus = () => {
 		const s = useCliStore.getState();
 		if (s.permissionPrompt) {
@@ -7068,6 +7090,7 @@ function CliApp() {
 			console.error("❌ CLI failed to initialize. Try restarting b4m.\n");
 			return;
 		}
+		getProcessHooks()?.fireUserPromptSubmit();
 		bridgePresence.emitEvent({
 			type: "message",
 			role: "user",
@@ -7102,7 +7125,7 @@ function CliApp() {
 					if (compactionPrompt) {
 						const result = await state.agent.run(compactionPrompt, { maxIterations: 1 });
 						await state.sessionStore.save(activeSession);
-						const newSession = createCompactedSession(activeSession, result.finalAnswer, preservedMessages);
+						const newSession = createCompactedSession(activeSession, result.finalAnswer, preservedMessages, !!(process.env.B4M_SESSION_ID || process.env.B4M_RESUME_ID));
 						await logger.initialize(newSession.id);
 						setState((prev) => ({
 							...prev,
@@ -7260,6 +7283,7 @@ function CliApp() {
 				abortController: null
 			}));
 			useCliStore.getState().setIsThinking(false);
+			getProcessHooks()?.fireStop();
 			bridgePresence.emitEvent({
 				type: "status",
 				status: wasAborted ? "idle" : "awaiting_input"
@@ -8118,8 +8142,9 @@ Multi-line Input:
 				console.clear();
 				renderBanner();
 				const model = state.session?.model || state.config?.defaultModel || ChatModels.CLAUDE_4_5_SONNET;
+				const clearPinnedId = process.env.B4M_SESSION_ID || process.env.B4M_RESUME_ID;
 				const newSession = {
-					id: v4(),
+					id: clearPinnedId ? state.session?.id ?? clearPinnedId : v4(),
 					name: `Session ${(/* @__PURE__ */ new Date()).toLocaleString()}`,
 					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 					updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -8458,7 +8483,7 @@ Multi-line Input:
 					const summary = (await state.agent.run(compactionPrompt, { maxIterations: 1 })).finalAnswer;
 					await state.sessionStore.save(state.session);
 					const oldSessionName = state.session.name;
-					const newSession = createCompactedSession(state.session, summary, preservedMessages);
+					const newSession = createCompactedSession(state.session, summary, preservedMessages, !!(process.env.B4M_SESSION_ID || process.env.B4M_RESUME_ID));
 					await logger.initialize(newSession.id);
 					setState((prev) => ({
 						...prev,
@@ -8975,6 +9000,7 @@ Multi-line Input:
 				additionalDirectories: state.additionalDirectories,
 				featureModulePrompts: newFeaturePrompts || void 0,
 				planModeFilePath: planFilePathForRebuild,
+				appendSystemPrompt: process.env.B4M_APPEND_SYSTEM_PROMPT,
 				deferredToolNames: deferredToolRegistry.getDirectoryNames()
 			}));
 			const moduleNames = newFeatureRegistry.getModuleNames();

package/dist/{package-C9MYdYCP.mjs → package-3pouvthv.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 //#region package.json
-var version = "0.15.2";
+var version = "0.16.0";
 //#endregion
 export { version as t };