@bike4mind/cli 3.0.0 → 3.1.0

package/README.md

@@ -395,7 +395,7 @@ You can also run any MCP server via npx or custom executables:
 
 #### Serve Bike4Mind itself as an MCP server (`b4m mcp serve`)
 
-The reverse of adding a server: `b4m mcp serve` exposes your Bike4Mind backend to any MCP client (Claude Desktop, editors, other agents). It advertises eighteen tools (`list_notebooks`, `get_notebook`, `create_notebook`, `rename_notebook`, `clone_notebook`, `delete_notebook`, `list_projects`, `get_project`, `create_project`, `send_message`, `search_knowledge_base`, `list_lakes`, `list_files`, `get_file`, `generate_sound_effect`, `text_to_speech`, `generate_image`, `publish_artifact`) plus four resource templates (`b4m://notebook/{id}`, `b4m://file/{id}`, `b4m://project/{id}`, `b4m://artifact/{id}`), each listable and readable as JSON, and `b4m://agent-quest` - the credential-free manifest for The Open Door, the onboarding quest for agents.
+The reverse of adding a server: `b4m mcp serve` exposes your Bike4Mind backend to any MCP client (Claude Desktop, editors, other agents). It advertises nineteen tools (`list_notebooks`, `get_notebook`, `create_notebook`, `rename_notebook`, `clone_notebook`, `delete_notebook`, `list_projects`, `get_project`, `create_project`, `send_message`, `search_knowledge_base`, `list_lakes`, `list_files`, `get_file`, `generate_sound_effect`, `text_to_speech`, `generate_image`, `create_artifact`, `publish_artifact`) plus four resource templates (`b4m://notebook/{id}`, `b4m://file/{id}`, `b4m://project/{id}`, `b4m://artifact/{id}`), each listable and readable as JSON, and `b4m://agent-quest` - the credential-free manifest for The Open Door, the onboarding quest for agents.
 
 To get answers grounded in a data lake, call `list_lakes`, then `create_notebook { dataLakeId }` with a lake's id, then `send_message { notebookId }` on that notebook: the result carries the `reply` plus the `citables` it was grounded in. `list_lakes` needs a key with `datalake:read` (and data lakes enabled on the instance).
 

package/dist/{AgentHistoryStore-DVxv1kSO.mjs → AgentHistoryStore-O2gKB5YG.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { Ct as secureParameters, F as ChatModels, H as LOCATION_MAP_LANGUAGE, Ht as WEBSITE_URL, J as OpenAIEmbeddingModel, K as NotFoundError, Nt as withRetry, O as ApiKeyType, Q as SEARCH_RESULT_CARDS_LANGUAGE, S as escapeArtifactBodyJson, Tt as splitEquals, Vt as APP_NAME, W as McpServerName, X as PermissionDeniedError, _ as logger, _t as isRetryableError, a as getToolCategory, at as assertAuthOriginMatchesApiKey, b as htmlErrorTitle, bt as obfuscateApiKey, dt as getMcpProviderMetadata, gt as isPlaceholderImageSigningSecret, i as canTrustTool, it as WORK_ITEM_STATUSES, j as BedrockEmbeddingModel, o as isReadOnlyTool, pt as googleMapsSearchUrl, q as OllamaEmbeddingModel, r as loadContextFiles, rt as VoyageAIEmbeddingModel, tt as SupportedFabFileMimeTypes, v as SESSION_ID_PATTERN, wt as signImageUrl, x as htmlFirstH1, y as isValidSessionId } from "./ConfigStore-51UaP9pJ.mjs";
+import { $ as SEARCH_RESULT_CARDS_LANGUAGE, Et as splitEquals, F as ChatModels, G as McpServerName, Ht as APP_NAME, J as OllamaEmbeddingModel, O as ApiKeyType, Pt as withRetry, S as escapeArtifactBodyJson, Tt as signImageUrl, U as LOCATION_MAP_LANGUAGE, Ut as WEBSITE_URL, Y as OpenAIEmbeddingModel, Z as PermissionDeniedError, _ as logger, _t as isPlaceholderImageSigningSecret, a as getToolCategory, at as WORK_ITEM_STATUSES, b as htmlErrorTitle, ft as getMcpProviderMetadata, i as canTrustTool, it as VoyageAIEmbeddingModel, j as BedrockEmbeddingModel, mt as googleMapsSearchUrl, nt as SupportedFabFileMimeTypes, o as isReadOnlyTool, ot as assertAuthOriginMatchesApiKey, q as NotFoundError, r as loadContextFiles, v as SESSION_ID_PATTERN, vt as isRetryableError, wt as secureParameters, x as htmlFirstH1, xt as obfuscateApiKey, y as isValidSessionId } from "./ConfigStore-RHqyXcSS.mjs";
 import { n as isPathAllowed, t as assertPathAllowed } from "./pathValidation-BRqf4HFX-CHwtwp3O.mjs";
 import { n as isTerminalShellStatus, t as getShellSessionManager } from "./ShellSessionManager-6o8KZzl1-vrbPAUTq.mjs";
-import { n as B4mStreamEndedError, r as createClient, t as B4mApiError } from "./dist-BsG2Hlp-.mjs";
+import { n as B4mStreamEndedError, r as createClient, t as B4mApiError } from "./dist-B1bGf-yn.mjs";
 import { createHash, randomBytes } from "crypto";
 import { existsSync, lstatSync, promises, readdirSync, realpathSync, rmSync, statSync } from "fs";
 import os, { homedir } from "os";
@@ -11361,6 +11361,10 @@ function observationForResult(result) {
 	if (message.toLowerCase().includes("aborted")) return CANCELLED_TOOL_RESULT;
 	return `Error: ${message}`;
 }
+/** True when `observationForResult` reported a real tool failure (not a cancellation). */
+function isFailedResult(result) {
+	return result?.status === "rejected" && observationForResult(result) !== CANCELLED_TOOL_RESULT;
+}
 /**
 * True when an error is an abort/cancellation (user stop or execution timeout)
 * rather than a real failure. Aborts are benign and must NOT be logged at error
@@ -11411,6 +11415,10 @@ var ReActAgent = class extends EventEmitter {
 	confidenceLog = [];
 	/** Confidence scores collected during the current iteration (reset each iteration) */
 	iterationConfidences = [];
+	/** Parallel to `iterationConfidences`: whether that score came from a failed tool call */
+	iterationToolFailed = [];
+	/** Ids of calls `executeToolWithQueueFallback` saw fail; drained by `takeToolFailure`. */
+	failedToolCallIds = /* @__PURE__ */ new Set();
 	/** Conversation history, promoted from run()-local to instance for checkpoint/resume */
 	messages = [];
 	/** Current iteration count, promoted from run()-local to instance for checkpoint/resume */
@@ -11523,7 +11531,7 @@ var ReActAgent = class extends EventEmitter {
 		this.turnUsage = [];
 		this.toolCallCount = 0;
 		this.confidenceLog = [];
-		this.iterationConfidences = [];
+		this.resetIterationConfidences();
 		this.lastStopReason = void 0;
 		this.repeatedCallGuard.reset();
 		this.isReadOnlyToolFn = options.isReadOnlyTool ?? defaultIsReadOnlyTool;
@@ -11681,9 +11689,10 @@ var ReActAgent = class extends EventEmitter {
 									const plan = categorizeTools(unprocessedTools, options.isReadOnlyTool ?? defaultIsReadOnlyTool);
 									const results = await this.runToolBatchAbortTolerant(plan, options.signal);
 									for (const toolUse of unprocessedTools) {
-										const observation = observationForResult(results.get(getToolId(toolUse)));
+										const result = results.get(getToolId(toolUse));
+										const observation = observationForResult(result);
 										this.appendToolMessages(messages, toolUse, observation, thinkingBlocks);
-										this.emitObservationStep(toolUse.name, observation);
+										this.emitObservationStep(toolUse.name, observation, isFailedResult(result) || this.takeToolFailure(toolUse));
 									}
 								} else for (const toolUse of unprocessedTools) {
 									this.emitActionStep(toolUse);
@@ -11698,7 +11707,7 @@ var ReActAgent = class extends EventEmitter {
 										observation = await this.executeToolWithQueueFallback(toolUse);
 										this.appendToolMessages(messages, toolUse, observation, thinkingBlocks);
 									}
-									this.emitObservationStep(toolUse.name, observation);
+									this.emitObservationStep(toolUse.name, observation, this.takeToolFailure(toolUse));
 								}
 							}
 						}
@@ -11775,7 +11784,7 @@ var ReActAgent = class extends EventEmitter {
 						iteration: iterations
 					});
 				}
-				this.iterationConfidences = [];
+				this.resetIterationConfidences();
 				if (!iterationComplete && hadToolCalls) {
 					const feedback = await drainHostFeedback(options.drainFeedback, "turn", this.context.logger);
 					messages.push({
@@ -12087,6 +12096,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		this.toolCallCount = checkpoint.toolCallCount;
 		this.confidenceLog = structuredClone(checkpoint.confidenceLog);
 		this.iterationConfidences = [...checkpoint.iterationConfidences];
+		this.iterationToolFailed = checkpoint.iterationConfidences.map(() => false);
 		this.initialMessageCount = checkpoint.initialMessageCount ?? this.messages.length;
 		this.lastStopReason = checkpoint.finishReason;
 		this.observationQueue = [];
@@ -12139,7 +12149,8 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 			this.turnUsage = [];
 			this.toolCallCount = 0;
 			this.confidenceLog = [];
-			this.iterationConfidences = [];
+			this.resetIterationConfidences();
+			this.failedToolCallIds.clear();
 			this.lastStopReason = void 0;
 			this.iterations = 0;
 			this.repeatedCallGuard.reset();
@@ -12197,7 +12208,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		}
 		const preIterationCheckpoint = this.toCheckpoint();
 		this.iterations++;
-		this.iterationConfidences = [];
+		this.resetIterationConfidences();
 		const iterationSteps = [];
 		try {
 			if (this.iterations > 1 && options.iterationDelayMs && options.iterationDelayMs > 0) await new Promise((resolve) => setTimeout(resolve, options.iterationDelayMs));
@@ -12320,9 +12331,10 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 										this.appendToolMessages(this.messages, toolUse, GATED_TOOL_OBSERVATION, thinkingBlocks);
 										continue;
 									}
-									const observation = observationForResult(results.get(getToolId(toolUse)));
+									const result = results.get(getToolId(toolUse));
+									const observation = observationForResult(result);
 									this.appendToolMessages(this.messages, toolUse, observation, thinkingBlocks);
-									const obsStep = this.buildObservationStep(toolUse.name, observation);
+									const obsStep = this.buildObservationStep(toolUse.name, observation, isFailedResult(result) || this.takeToolFailure(toolUse));
 									iterationSteps.push(obsStep);
 								}
 							} else for (const toolUse of unprocessedTools) {
@@ -12345,7 +12357,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 									observation = await this.executeToolWithQueueFallback(toolUse);
 									this.appendToolMessages(this.messages, toolUse, observation, thinkingBlocks);
 								}
-								const obsStep = this.buildObservationStep(toolUse.name, observation);
+								const obsStep = this.buildObservationStep(toolUse.name, observation, this.takeToolFailure(toolUse));
 								iterationSteps.push(obsStep);
 							}
 						}
@@ -12410,7 +12422,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 					iteration: this.iterations
 				});
 			}
-			this.iterationConfidences = [];
+			this.resetIterationConfidences();
 			if (!iterationComplete && hadToolCalls) {
 				const feedback = await drainHostFeedback(options.drainFeedback, "turn", this.context.logger);
 				this.messages.push({
@@ -12543,7 +12555,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 	* Build an observation step, score confidence, push to steps, and emit.
 	* Returns the step for callers that need to collect iteration steps.
 	*/
-	buildObservationStep(toolName, observation) {
+	buildObservationStep(toolName, observation, toolFailed = false) {
 		const confidence = this.scoreToolResult(toolName, observation);
 		const confidenceSource = observation.startsWith("Error:") ? "deterministic" : "default";
 		this.confidenceLog.push({
@@ -12553,6 +12565,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 			timestamp: Date.now()
 		});
 		this.iterationConfidences.push(confidence);
+		this.iterationToolFailed.push(toolFailed);
 		const observationStep = {
 			type: "observation",
 			content: observation,
@@ -12561,7 +12574,8 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 				timestamp: Date.now(),
 				iteration: this.iterations - 1,
 				confidence,
-				confidenceSource
+				confidenceSource,
+				...toolFailed ? { toolFailed: true } : {}
 			}
 		};
 		this.steps.push(observationStep);
@@ -12571,8 +12585,8 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 	/**
 	* Create and emit an observation step, scoring confidence for the result
 	*/
-	emitObservationStep(toolName, observation) {
-		this.buildObservationStep(toolName, observation);
+	emitObservationStep(toolName, observation, toolFailed = false) {
+		this.buildObservationStep(toolName, observation, toolFailed);
 	}
 	/**
 	* Score the confidence of a tool result.
@@ -12643,13 +12657,14 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 	*/
 	async executeGatedToolCall(call) {
 		if (!this.supportsGatedReplay()) throw new Error(`ReActAgent.executeGatedToolCall: backend (${this.context.llm.currentModel}) cannot record a replayed tool result, so an approval-gated tool cannot be run on it`);
-		const observation = await this.executeToolWithQueueFallback({
+		const toolUse = {
 			id: call.id,
 			name: call.name,
 			arguments: typeof call.input === "string" || call.input === void 0 ? call.input : JSON.stringify(call.input)
-		});
+		};
+		const observation = await this.executeToolWithQueueFallback(toolUse);
 		this.replaceLastToolResultObservation(call.id, observation);
-		this.buildObservationStep(call.name, observation);
+		this.buildObservationStep(call.name, observation, this.takeToolFailure(toolUse));
 		return observation;
 	}
 	/**
@@ -12664,15 +12679,27 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 	* `iterationConfidences` at its own start regardless, discarding the score
 	* before anything reads it. The host calls this right after replaying an
 	* approved batch (see `resumeApprovedPause` / `gateReplayConfidence`) so a
-	* replayed tool that failed still gets the same low-confidence pause a normal
-	* iteration would have gotten - resetting `iterationConfidences` here is a
-	* no-op for the next `runIteration()`, which resets it again anyway.
+	* replayed tool gets the same low-confidence pause a normal iteration would
+	* have gotten - resetting `iterationConfidences` here is a no-op for the next
+	* `runIteration()`, which resets it again anyway.
+	*
+	* Scores from calls that failed to run (`toolFailed`) are left out, matching the
+	* web executor's iteration gate (`evaluateConfidenceGate`); `null` when every
+	* scored call failed.
 	*/
 	takeIterationConfidence() {
-		if (this.iterationConfidences.length === 0) return null;
-		const avg = this.iterationConfidences.reduce((a, b) => a + b, 0) / this.iterationConfidences.length;
+		const scores = this.iterationConfidences.filter((_, i) => !this.iterationToolFailed[i]);
+		this.resetIterationConfidences();
+		if (scores.length === 0) return null;
+		return scores.reduce((a, b) => a + b, 0) / scores.length;
+	}
+	resetIterationConfidences() {
 		this.iterationConfidences = [];
-		return avg;
+		this.iterationToolFailed = [];
+	}
+	/** True (once) when `executeToolWithQueueFallback` recorded this call as failed. */
+	takeToolFailure(toolUse) {
+		return this.failedToolCallIds.delete(getToolId(toolUse));
 	}
 	/**
 	* Execute a tool and return the result as a string.
@@ -12699,6 +12726,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 					})}</function>`;
 				}
 			}
+			this.failedToolCallIds.add(getToolId(toolUse));
 			return `Error: Tool "${toolUse.name}" is not available in this context and cannot be called. Do NOT attempt to call it again. Proceed without it — call other available tools if your plan still needs them, or compose your final answer from the information already gathered if no more tools are needed.`;
 		}
 		const signature = RepeatedCallGuard.signature(toolUse.name, toolUse.arguments);
@@ -12716,6 +12744,7 @@ Remember: You are an autonomous AGENT. Act independently and solve problems proa
 		} catch (error) {
 			observation = `Error: ${error instanceof Error ? error.message : String(error)}`;
 			succeeded = false;
+			this.failedToolCallIds.add(getToolId(toolUse));
 		}
 		const { count, warn } = this.repeatedCallGuard.record(signature, observation, isReadOnly);
 		if (succeeded && !isReadOnly) this.repeatedCallGuard.invalidateReadOnly();

package/dist/{ConfigStore-51UaP9pJ.mjs → ConfigStore-RHqyXcSS.mjs}

@@ -269,6 +269,7 @@ var PermissionDeniedError = class extends Error {
 };
 const UNKNOWN_MODEL_ERROR_CODE = "unknown_model";
 const BILLING_ORGANIZATION_MISMATCH_ERROR_CODE = "billing_organization_mismatch";
+const REQUEST_TIMEOUT_ERROR_CODE = "request_timeout";
 const GROUP_TYPE_CATALOG = Object.freeze([
 	{
 		key: "sales",
@@ -777,6 +778,20 @@ const shareableDocumentSchema = z$1.object({
 	users: z$1.array(userShareSchema),
 	groups: z$1.array(groupShareSchema)
 });
+/** Bedrock's `[<scope>.]anthropic.` id prefix (any region or `global`), as regex source. Shared with isClaudeModelId. */
+const BEDROCK_ANTHROPIC_PREFIX = "(?:(?:[a-z-]+\\.)?anthropic\\.)?";
+const CLAUDE_MODEL_ID = new RegExp(`^${BEDROCK_ANTHROPIC_PREFIX}claude-(opus|sonnet|haiku|fable|mythos)-(\\d+)(?:-(\\d{1,2}))?(?=$|[:@[]|-(?:\\d{8}(?!\\d)|[a-z]))`);
+/** Family and version of a Claude id (native, Bedrock-scoped, dated or aliased); null for any other shape. */
+function parseClaudeModelId(modelId) {
+	const match = CLAUDE_MODEL_ID.exec(modelId);
+	if (!match) return null;
+	const [, family, major, minor] = match;
+	return {
+		family,
+		major: Number(major),
+		minor: minor === void 0 ? null : Number(minor)
+	};
+}
 /**
 * Model backends
 */
@@ -1032,6 +1047,7 @@ let ChatModels = /* @__PURE__ */ function(ChatModels) {
 }({});
 const CHAT_MODELS = Object.values(ChatModels);
 const supportedChatModels = z$1.enum(ChatModels);
+new RegExp(`^${BEDROCK_ANTHROPIC_PREFIX}claude-`);
 /**
 * Models that support OpenAI's `reasoning_effort` request parameter.
 * o1-preview and o1-mini do NOT support reasoning_effort.
@@ -3126,8 +3142,22 @@ z.object({
 	/** Set for job-backed generations; the save is idempotent per job. */
 	jobId: z.string().optional(),
 	prompt: z.string(),
+	/**
+	* Storing caps `prompt` at a prefix of what was generated (sourceMetadata rides every metadata-only
+	* listing). Written on every save, true when it was cut. Absent only on files saved before it existed:
+	* read it through isStoredPromptPossiblyTruncated, which covers those.
+	*/
+	promptTruncated: z.boolean().optional(),
 	lyrics: z.string().optional(),
-	durationSeconds: z.number().positive().optional()
+	durationSeconds: z.number().positive().optional(),
+	/** Speech: the requested voice; absent when the provider default was used or another provider stood in. */
+	voice: z.string().optional(),
+	/** Speech: the output format. */
+	format: z.string().optional(),
+	/** Speech: the requested language; absent when the provider auto-detected it. */
+	languageCode: z.string().optional(),
+	/** Sound effects: how closely the provider followed the prompt, 0-1. */
+	promptInfluence: z.number().min(0).max(1).optional()
 });
 /**
 * Why a generated file was not kept in the user's files. Never fatal: the output was already produced and
@@ -5016,6 +5046,17 @@ const ApiErrorSchema = z$1.object({
 */
 const InsufficientCreditsErrorSchema = ApiErrorSchema.extend({ errorCode: z$1.enum(QUEST_ERROR_CODES).optional() });
 /**
+* 504 for a `wait: true` turn that ran past the request deadline. The turn is already settled
+* (timed out, unused credits refunded) when this is sent; `quest_id` is the quest to poll and
+* `sessionId` is the notebook the turn was recorded in, so a caller that sent no `sessionId` can
+* continue the conversation it just started (same field name as the ACK and the `wait: true` body).
+*/
+const ChatWaitTimeoutErrorSchema = ApiErrorSchema.extend({
+	errorCode: z$1.literal(REQUEST_TIMEOUT_ERROR_CODE),
+	quest_id: z$1.string(),
+	sessionId: z$1.string().optional()
+});
+/**
 * 400 for an upload refused on size or quota. The typed members are optional because the same 400 also
 * covers errors that carry none (an unsupported file type); when `errorCode` is present all five arrive
 * together, which the endpoint's 400 description states for integrators.
@@ -5205,6 +5246,16 @@ const MUSIC_VALIDATION_ERROR_CODES = [
 	"lyrics_with_instrumental",
 	"lyrics_too_long"
 ];
+/**
+* Building blocks for entity response schemas held to an entity's key list (see
+* selfUserResponseSchema in ./user.ts for the full rationale). A passthrough value is
+* `z.unknown()`: the boundary enforces WHICH keys leave the server, not their types, so a
+* legacy value on a long-lived Mongo document can never 500 a read.
+*/
+const passthroughField = z$2.unknown().optional();
+function passthroughShape(fields) {
+	return Object.fromEntries(Object.keys(fields).map((field) => [field, passthroughField]));
+}
 z$2.enum([
 	"",
 	"TFG",
@@ -5352,10 +5403,6 @@ const SELF_VIEW_PASSTHROUGH_FIELDS = {
 	currentCredits: true,
 	lastCreditsPurchasedAt: true
 };
-const passthroughField = z$2.unknown().optional();
-function passthroughShape(fields) {
-	return Object.fromEntries(Object.keys(fields).map((field) => [field, passthroughField]));
-}
 /** A redacted integration object: only the named non-secret subfields survive. */
 function redactedSubdocument(fields) {
 	return z$2.object(passthroughShape(Object.fromEntries(fields.map((field) => [field, true])))).nullable().optional();
@@ -12860,7 +12907,12 @@ const AgentProgressAction = z$1.object({
 	executionId: z$1.string(),
 	status: z$1.string().optional(),
 	creditsUsed: z$1.number().optional(),
-	iteration: z$1.number().optional()
+	iteration: z$1.number().optional(),
+	questId: z$1.string().optional(),
+	generationJobs: z$1.array(z$1.object({
+		id: z$1.string(),
+		kind: z$1.enum(GENERATION_JOB_KINDS)
+	})).optional()
 });
 const AgentCompletedAction = z$1.object({
 	action: z$1.literal("completed"),
@@ -14808,6 +14860,89 @@ const CreateSessionRequestSchema = z$1.object({
 	tags: z$1.array(SessionTagSchema).optional(),
 	lastUsedModel: z$1.string().nullish()
 });
+z$2.object(passthroughShape({
+	id: true,
+	createdAt: true,
+	updatedAt: true,
+	name: true,
+	description: true,
+	type: true,
+	organizationId: true
+})).extend({
+	memberIds: z$2.array(z$2.string()),
+	memberCount: z$2.number()
+});
+z$2.object(passthroughShape({
+	id: true,
+	createdAt: true,
+	updatedAt: true,
+	deletedAt: true,
+	sessionId: true,
+	conversationItemId: true,
+	openaiMessageId: true,
+	claudeMessageId: true,
+	type: true,
+	timestamp: true,
+	prompt: true,
+	fabFileIds: true,
+	agentIds: true,
+	reply: true,
+	replies: true,
+	structuredReplies: true,
+	toolResults: true,
+	questMasterReply: true,
+	images: true,
+	videos: true,
+	videoJobIds: true,
+	generationJobs: true,
+	agentVideoClipsClaimed: true,
+	agentMusicTracksClaimed: true,
+	oob: true,
+	promptMeta: true,
+	status: true,
+	creditsUsed: true,
+	errorCode: true,
+	questMasterPlanId: true,
+	agentExecutionId: true,
+	correctsQuestId: true,
+	clientFirstTokenTime: true,
+	routingSource: true,
+	pinned: true,
+	researchModeResults: true,
+	deepResearchState: true,
+	fallbackInfo: true,
+	promptEnhancement: true,
+	pendingAction: true,
+	attachmentNotices: true,
+	attachmentDelivery: true,
+	navigationIntents: true,
+	suggestedChoices: true,
+	attachmentList: true,
+	uiSideEffects: true,
+	jupyterNotebook: true
+}));
+const questMasterPlanResponseSchema = z$2.object(passthroughShape({
+	id: true,
+	createdAt: true,
+	updatedAt: true,
+	notebookId: true,
+	goal: true,
+	quests: true,
+	userId: true,
+	visibility: true,
+	state: true,
+	lastAccessedAt: true,
+	sessionHistory: true,
+	metrics: true,
+	tags: true,
+	priority: true,
+	parentPlanId: true,
+	sharedWith: true,
+	handoff: true,
+	blockers: true,
+	decisions: true
+}));
+z$2.array(questMasterPlanResponseSchema);
 z$1.preprocess((val) => {
 	if (typeof val === "string") {
 		if (val.toLowerCase() === "true") return true;
@@ -16832,7 +16967,7 @@ defineEndpoint({
 	path: "/api/chat",
 	operationId: "sendChatMessage",
 	summary: "Send a chat message",
-	description: "Sends a message to the AI and creates a quest to process it. By default (async) the call returns immediately with a quest id; poll `GET /api/v1/quests/{id}` for the reply. Send `wait: true` to block until the reply is ready and receive it inline. A tool that produced machine-readable state reports it under `toolPayloads` - an array of `{ type, payload }` entries in emission order, alongside (never instead of) the prose reply - on the `wait: true` body and on the polled quest. A turn can FAIL after the ACK - reported on the polled quest as `type: \"error\"`, since the ACK was already sent. A terminal `status: \"stopped\"` (a missing session, a user-cancelled turn) is ALSO a failure even without `type: \"error\"` - it carries an explanatory string in `reply`/`replies` rather than an answer. `type` is the failure signal for the classified failure classes (an abort, a provider timeout, credit exhaustion); `errorCode` is an optional refinement present only when the failure is a classified billing reason. A recovered stuck quest is NOT in that list: one that still has renderable content resolves as a success by design. `QUEST_ERROR_CODES` has two members, but only `insufficient_credits` is raised as a quest errorCode by any current throw site on this endpoint - `spend_cap_exceeded` is thrown only by the embed chat route's pre-flight, which fires outside the process try/catch that would classify it onto a quest. A caller must treat `type: \"error\"` OR a terminal `status: \"stopped\"` as failure even when `errorCode` is absent, and must not read `reply` as an answer without checking those first. Authenticate with an API key (`b4m_live_`) or a JWT. Session resolution: pass `sessionId` to continue an existing notebook. An API-key caller that omits it gets a BRAND-NEW notebook rather than the notebook the human last had open, and `newConversation: true` forces a new notebook for any auth mode; both return the new id as `sessionId`, so the caller can continue the conversation by passing it back. A first-party JWT caller that omits `sessionId` keeps the last-opened-notebook fallback. Sending `sessionId` and `newConversation` together is a 422.",
+	description: "Sends a message to the AI and creates a quest to process it. By default (async) the call returns immediately with a quest id; poll `GET /api/v1/quests/{id}` for the reply. Send `wait: true` to block until the reply is ready and receive it inline. A `wait: true` turn is bounded at about 45 seconds: one that runs longer is ended (unused credits refunded) and answered with a 504 naming the quest in `quest_id`. Send long or tool-heavy turns (large attachments, tool calls) in the default async mode and poll instead. A tool that produced machine-readable state reports it under `toolPayloads` - an array of `{ type, payload }` entries in emission order, alongside (never instead of) the prose reply - on the `wait: true` body and on the polled quest. A turn can FAIL after the ACK - reported on the polled quest as `type: \"error\"`, since the ACK was already sent. A terminal `status: \"stopped\"` (a missing session, a user-cancelled turn) is ALSO a failure even without `type: \"error\"` - it carries an explanatory string in `reply`/`replies` rather than an answer. `type` is the failure signal for the classified failure classes (an abort, a provider timeout, credit exhaustion); `errorCode` is an optional refinement present only when the failure is a classified billing reason. A recovered stuck quest is NOT in that list: one that still has renderable content resolves as a success by design. `QUEST_ERROR_CODES` has two members, but only `insufficient_credits` is raised as a quest errorCode by any current throw site on this endpoint - `spend_cap_exceeded` is thrown only by the embed chat route's pre-flight, which fires outside the process try/catch that would classify it onto a quest. A caller must treat `type: \"error\"` OR a terminal `status: \"stopped\"` as failure even when `errorCode` is absent, and must not read `reply` as an answer without checking those first. Authenticate with an API key (`b4m_live_`) or a JWT. Session resolution: pass `sessionId` to continue an existing notebook. An API-key caller that omits it gets a BRAND-NEW notebook rather than the notebook the human last had open, and `newConversation: true` forces a new notebook for any auth mode; both return the new id as `sessionId`, so the caller can continue the conversation by passing it back. A first-party JWT caller that omits `sessionId` keeps the last-opened-notebook fallback. Sending `sessionId` and `newConversation` together is a 422.",
 	tags: ["AI"],
 	auth: "apiKeyOrJwt",
 	scopes: ["ai:chat", "ai:generate"],
@@ -16873,6 +17008,10 @@ defineEndpoint({
 		429: {
 			description: "Per-user rate limit exceeded.",
 			schema: ApiErrorSchema
+		},
+		504: {
+			description: "A `wait: true` turn ran past the request deadline. The turn is already ended: its quest (`quest_id`) is settled as timed out with any partial reply kept, and unused reserved credits are refunded. Retry in async mode for a long turn.",
+			schema: ChatWaitTimeoutErrorSchema
 		}
 	},
 	codeSample: {
@@ -21244,7 +21383,11 @@ function stripDeliveredArtifactBlocks(text, deliveredMarkup) {
 */
 const CLAUDE_4_7_PLUS_MULTIPLIER = 1.5;
 const CLAUDE_4_5_MULTIPLIER = 1.09;
-const CLAUDE_FAMILY_VERSION = /(?:^|\.)claude-(?:opus|sonnet|haiku)-(\d+)(?:-(\d{1,2}))?(?=$|[-:])/;
+const MEASURED_FAMILIES = /* @__PURE__ */ new Set([
+	"opus",
+	"sonnet",
+	"haiku"
+]);
 /**
 * Factor to scale a cl100k_base token count by for `modelId`. 1 for anything unmeasured: non-Claude
 * models, Claude before 4.5 (retired on Bedrock, could not be measured), and Fable (Bedrock rejects it
@@ -21252,10 +21395,10 @@ const CLAUDE_FAMILY_VERSION = /(?:^|\.)claude-(?:opus|sonnet|haiku)-(\d+)(?:-(\d
 * assumption they keep its tokenizer; [BILLING_DRIFT] flags it if one does not.
 */
 function tokenEstimateMultiplier(modelId) {
-	const match = modelId?.match(CLAUDE_FAMILY_VERSION);
-	if (!match) return 1;
-	const major = Number(match[1]);
-	const minor = Number(match[2] ?? 0);
+	const parsed = modelId ? parseClaudeModelId(modelId) : null;
+	if (!parsed || !MEASURED_FAMILIES.has(parsed.family)) return 1;
+	const { major } = parsed;
+	const minor = parsed.minor ?? 0;
 	if (major > 4 || major === 4 && minor >= 7) return CLAUDE_4_7_PLUS_MULTIPLIER;
 	if (major === 4 && minor >= 5) return CLAUDE_4_5_MULTIPLIER;
 	return 1;
@@ -25172,4 +25315,4 @@ var ConfigStore = class {
 	}
 };
 //#endregion
-export { SLUG_OWNED_BY_OTHER as $, BRIEFCASE_CATALOG_QUERIES as A, ttsBase64ResponseSchema as At, ImageModels as B, selfClaimedActorKindSchema as Bt, AGENT_QUEST_ID as C, secureParameters as Ct, ARTIFACT_REMOVED_PLACEHOLDER as D, stripToolArtifactMarkup as Dt, ARTIFACT_DELIVERED_PLACEHOLDER as E, stripDeliveredArtifactBlocks as Et, ChatModels as F, DELEGATION_PAYLOAD_SCHEMA_NAME as Ft, ModelBackend as G, LOCATION_MAP_LANGUAGE as H, WEBSITE_URL as Ht, CompletionReasoningEffortSchema as I, actorColorIndex as It, OpenAIEmbeddingModel as J, NotFoundError as K, DEFAULT_TTS_PROVIDER as L, actorKindMarker as Lt, BriefcasePromptIdSchema as M, ttsResponseTooLargeSchema as Mt, CONTEXT_WINDOW_SAFETY_BUFFER_TOKENS as N, withRetry as Nt, ApiKeyType as O, supportedVoiceGenerationVendor as Ot, CREDIT_DEDUCT_TRANSACTION_TYPES as P, ACTOR_COLOR_SLOTS as Pt, SEARCH_RESULT_CARDS_LANGUAGE as Q, DEGENERATE_FINISH_REASON as R, actorKindSchema as Rt, escapeArtifactBodyJson as S, replacePromptVariables as St, AGENT_QUEST_MCP_URI as T, splitEquals as Tt, MODEL_INFO_FIELD_GROUP_OF as U, ImagePromptResolutionSchema as V, APP_NAME as Vt, McpServerName as W, PermissionDeniedError as X, PROMPT_TEXT_MAX as Y, REVIEW_GATE_STATUS_VALUES as Z, logger as _, isRetryableError as _t, getToolCategory as a, assertAuthOriginMatchesApiKey as at, htmlErrorTitle as b, obfuscateApiKey as bt, getCreditsUrl as c, escapeThinkMarkers as ct, resolveApiEndpoint as d, getMcpProviderMetadata as dt, SUBQUEST_STATUS_VALUES as et, AuthenticatedApiClient as f, getQuestErrorCode as ft, parseApiUrl as g, isPlaceholderImageSigningSecret as gt, NotAuthenticatedError as h, isEarlyStop as ht, canTrustTool as i, WORK_ITEM_STATUSES as it, BedrockEmbeddingModel as j, ttsRequestSchema as jt, ArtifactTypeSchema as k, tokenEstimateMultiplier as kt, getEnvironmentName as l, filterToolArtifactMarkup as lt, LOCAL_DEV_URL as m, hasDeliverablePinnedArtifact as mt, extractCompactInstructions as n, VisibilitySchema as nt, isReadOnlyTool as o, buildPromptContext as ot, DeviceFlowClient as p, googleMapsSearchUrl as pt, OllamaEmbeddingModel as q, loadContextFiles as r, VoyageAIEmbeddingModel as rt, ApiEndpointUnconfiguredError as s, createThinkMarkerEscaper as st, ConfigStore as t, SupportedFabFileMimeTypes as tt, requireApiUrl as u, generatedAudioResponseSchema as ut, SESSION_ID_PATTERN as v, isUserInitiatedAbort as vt, AGENT_QUEST_MANIFEST as w, signImageUrl as wt, htmlFirstH1 as x, questReplyText as xt, isValidSessionId as y, joinReplySlots as yt, GENERATED_IMAGE_EXTENSION_RE as z, delegationPayloadSchema as zt };
+export { SEARCH_RESULT_CARDS_LANGUAGE as $, BRIEFCASE_CATALOG_QUERIES as A, tokenEstimateMultiplier as At, GENERATED_IMAGE_EXTENSION_RE as B, delegationPayloadSchema as Bt, AGENT_QUEST_ID as C, replacePromptVariables as Ct, ARTIFACT_REMOVED_PLACEHOLDER as D, stripDeliveredArtifactBlocks as Dt, ARTIFACT_DELIVERED_PLACEHOLDER as E, splitEquals as Et, ChatModels as F, ACTOR_COLOR_SLOTS as Ft, McpServerName as G, ImagePromptResolutionSchema as H, APP_NAME as Ht, CompletionReasoningEffortSchema as I, DELEGATION_PAYLOAD_SCHEMA_NAME as It, OllamaEmbeddingModel as J, ModelBackend as K, CreateArtifactRequestSchema as L, actorColorIndex as Lt, BriefcasePromptIdSchema as M, ttsRequestSchema as Mt, CONTEXT_WINDOW_SAFETY_BUFFER_TOKENS as N, ttsResponseTooLargeSchema as Nt, ApiKeyType as O, stripToolArtifactMarkup as Ot, CREDIT_DEDUCT_TRANSACTION_TYPES as P, withRetry as Pt, REVIEW_GATE_STATUS_VALUES as Q, DEFAULT_TTS_PROVIDER as R, actorKindMarker as Rt, escapeArtifactBodyJson as S, questReplyText as St, AGENT_QUEST_MCP_URI as T, signImageUrl as Tt, LOCATION_MAP_LANGUAGE as U, WEBSITE_URL as Ut, ImageModels as V, selfClaimedActorKindSchema as Vt, MODEL_INFO_FIELD_GROUP_OF as W, PROMPT_TEXT_MAX as X, OpenAIEmbeddingModel as Y, PermissionDeniedError as Z, logger as _, isPlaceholderImageSigningSecret as _t, getToolCategory as a, WORK_ITEM_STATUSES as at, htmlErrorTitle as b, joinReplySlots as bt, getCreditsUrl as c, createThinkMarkerEscaper as ct, resolveApiEndpoint as d, generatedAudioResponseSchema as dt, SLUG_OWNED_BY_OTHER as et, AuthenticatedApiClient as f, getMcpProviderMetadata as ft, parseApiUrl as g, isEarlyStop as gt, NotAuthenticatedError as h, hasDeliverablePinnedArtifact as ht, canTrustTool as i, VoyageAIEmbeddingModel as it, BedrockEmbeddingModel as j, ttsBase64ResponseSchema as jt, ArtifactTypeSchema as k, supportedVoiceGenerationVendor as kt, getEnvironmentName as l, escapeThinkMarkers as lt, LOCAL_DEV_URL as m, googleMapsSearchUrl as mt, extractCompactInstructions as n, SupportedFabFileMimeTypes as nt, isReadOnlyTool as o, assertAuthOriginMatchesApiKey as ot, DeviceFlowClient as p, getQuestErrorCode as pt, NotFoundError as q, loadContextFiles as r, VisibilitySchema as rt, ApiEndpointUnconfiguredError as s, buildPromptContext as st, ConfigStore as t, SUBQUEST_STATUS_VALUES as tt, requireApiUrl as u, filterToolArtifactMarkup as ut, SESSION_ID_PATTERN as v, isRetryableError as vt, AGENT_QUEST_MANIFEST as w, secureParameters as wt, htmlFirstH1 as x, obfuscateApiKey as xt, isValidSessionId as y, isUserInitiatedAbort as yt, DEGENERATE_FINISH_REASON as z, actorKindSchema as zt };

package/dist/{WorkItemsClient-BMY0Qq1s.mjs → WorkItemsClient-cmw7WYBy.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { kt as tokenEstimateMultiplier } from "./ConfigStore-51UaP9pJ.mjs";
+import { At as tokenEstimateMultiplier } from "./ConfigStore-RHqyXcSS.mjs";
 import { v4 } from "uuid";
 import { get_encoding } from "tiktoken";
 //#region ../../b4m-core/utils/dist/calibratedTokenizer.mjs

package/dist/{buildAgent-CrSRKYU_.mjs → buildAgent-C0jmyDL4.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { J as getPlanModeFilePath, L as generateCliTools, N as ReActAgent, R as wrapTools, Y as buildSystemPrompt, a as loadProjectContext, c as createSseBackend, i as buildProjectAgentStore, l as ServerLlmBackend, lt as Logger, n as BackgroundAgentManager, o as McpManager, q as setWebSocketToolExecutor, r as SubagentOrchestrator, t as AgentHistoryStore } from "./AgentHistoryStore-DVxv1kSO.mjs";
-import { D as ARTIFACT_REMOVED_PLACEHOLDER, Dt as stripToolArtifactMarkup, E as ARTIFACT_DELIVERED_PLACEHOLDER, Et as stripDeliveredArtifactBlocks, F as ChatModels, G as ModelBackend, I as CompletionReasoningEffortSchema, N as CONTEXT_WINDOW_SAFETY_BUFFER_TOKENS, U as MODEL_INFO_FIELD_GROUP_OF, X as PermissionDeniedError, _ as logger, ct as escapeThinkMarkers, ft as getQuestErrorCode, lt as filterToolArtifactMarkup, mt as hasDeliverablePinnedArtifact, st as createThinkMarkerEscaper, vt as isUserInitiatedAbort } from "./ConfigStore-51UaP9pJ.mjs";
+import { J as getPlanModeFilePath, L as generateCliTools, N as ReActAgent, R as wrapTools, Y as buildSystemPrompt, a as loadProjectContext, c as createSseBackend, i as buildProjectAgentStore, l as ServerLlmBackend, lt as Logger, n as BackgroundAgentManager, o as McpManager, q as setWebSocketToolExecutor, r as SubagentOrchestrator, t as AgentHistoryStore } from "./AgentHistoryStore-O2gKB5YG.mjs";
+import { D as ARTIFACT_REMOVED_PLACEHOLDER, Dt as stripDeliveredArtifactBlocks, E as ARTIFACT_DELIVERED_PLACEHOLDER, F as ChatModels, I as CompletionReasoningEffortSchema, K as ModelBackend, N as CONTEXT_WINDOW_SAFETY_BUFFER_TOKENS, Ot as stripToolArtifactMarkup, W as MODEL_INFO_FIELD_GROUP_OF, Z as PermissionDeniedError, _ as logger, ct as createThinkMarkerEscaper, ht as hasDeliverablePinnedArtifact, lt as escapeThinkMarkers, pt as getQuestErrorCode, ut as filterToolArtifactMarkup, yt as isUserInitiatedAbort } from "./ConfigStore-RHqyXcSS.mjs";
 import "crypto";
 import { v4 } from "uuid";
 import { z as z$1 } from "zod";

package/dist/commands/acpCommand.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { A as createAgentDelegateTool, C as createTodoStore, D as createCoordinateTaskTool, F as PermissionManager, I as buildCliToolList, O as createResumeAgentTool, Q as CustomCommandStore, S as createFindDefinitionTool, T as createSkillTool, Z as RemoteSkillSource, b as createGetFileStructureTool, j as FallbackLlmBackend, k as createBackgroundAgentTools, nt as SessionStore, q as setWebSocketToolExecutor, s as buildSandbox, tt as CheckpointStore, w as createWriteTodosTool } from "../AgentHistoryStore-DVxv1kSO.mjs";
-import { _ as logger, o as isReadOnlyTool, t as ConfigStore, u as requireApiUrl } from "../ConfigStore-51UaP9pJ.mjs";
-import { a as deferredToolRegistry, i as createToolSearchTool, n as buildSupportingStores, o as NotifyingLlmBackend, r as buildLlmBackend, t as buildAgent } from "../buildAgent-CrSRKYU_.mjs";
-import { a as ApiClient } from "../dist-BsG2Hlp-.mjs";
+import { A as createAgentDelegateTool, C as createTodoStore, D as createCoordinateTaskTool, F as PermissionManager, I as buildCliToolList, O as createResumeAgentTool, Q as CustomCommandStore, S as createFindDefinitionTool, T as createSkillTool, Z as RemoteSkillSource, b as createGetFileStructureTool, j as FallbackLlmBackend, k as createBackgroundAgentTools, nt as SessionStore, q as setWebSocketToolExecutor, s as buildSandbox, tt as CheckpointStore, w as createWriteTodosTool } from "../AgentHistoryStore-O2gKB5YG.mjs";
+import { _ as logger, o as isReadOnlyTool, t as ConfigStore, u as requireApiUrl } from "../ConfigStore-RHqyXcSS.mjs";
+import { a as deferredToolRegistry, i as createToolSearchTool, n as buildSupportingStores, o as NotifyingLlmBackend, r as buildLlmBackend, t as buildAgent } from "../buildAgent-C0jmyDL4.mjs";
+import { a as ApiClient } from "../dist-B1bGf-yn.mjs";
 import { randomUUID } from "crypto";
 import { existsSync, realpathSync, statSync } from "fs";
 import { isAbsolute } from "path";

package/dist/commands/apiCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as resolveApiEndpoint, g as parseApiUrl, t as ConfigStore } from "../ConfigStore-51UaP9pJ.mjs";
+import { d as resolveApiEndpoint, g as parseApiUrl, t as ConfigStore } from "../ConfigStore-RHqyXcSS.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-DEsNSP54.mjs";
+import { t as version } from "../package-DsG8Tgvs.mjs";
 import { c as isNpmPrefixWritable, i as fetchLatestVersion, r as compareSemver } from "../updateChecker-CCLVVdH0.mjs";
 import { t as checkRipgrep } from "../ripgrepCheck-BmkyTK2i.mjs";
 import { existsSync } from "fs";

package/dist/commands/envCommand.mjs

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

package/dist/commands/headlessCommand.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { A as createAgentDelegateTool, B as SHELL_LIKE_TOOL_COMMAND_FIELDS, C as createTodoStore, D as createCoordinateTaskTool, F as PermissionManager, I as buildCliToolList, K as classifyCommandRisk, L as generateCliTools, N as ReActAgent, O as createResumeAgentTool, Q as CustomCommandStore, R as wrapTools, S as createFindDefinitionTool, T as createSkillTool, Y as buildSystemPrompt, Z as RemoteSkillSource, a as loadProjectContext, b as createGetFileStructureTool, c as createSseBackend, i as buildProjectAgentStore, j as FallbackLlmBackend, k as createBackgroundAgentTools, n as BackgroundAgentManager, nt as SessionStore, o as McpManager, q as setWebSocketToolExecutor, r as SubagentOrchestrator, s as buildSandbox, t as AgentHistoryStore, tt as CheckpointStore, w as createWriteTodosTool, x as createWorkItemTools } from "../AgentHistoryStore-DVxv1kSO.mjs";
-import { _ as logger, o as isReadOnlyTool, t as ConfigStore, u as requireApiUrl } from "../ConfigStore-51UaP9pJ.mjs";
-import { r as reconstructTurnBlocks, t as WorkItemsClient } from "../WorkItemsClient-BMY0Qq1s.mjs";
-import { a as ApiClient } from "../dist-BsG2Hlp-.mjs";
+import { A as createAgentDelegateTool, B as SHELL_LIKE_TOOL_COMMAND_FIELDS, C as createTodoStore, D as createCoordinateTaskTool, F as PermissionManager, I as buildCliToolList, K as classifyCommandRisk, L as generateCliTools, N as ReActAgent, O as createResumeAgentTool, Q as CustomCommandStore, R as wrapTools, S as createFindDefinitionTool, T as createSkillTool, Y as buildSystemPrompt, Z as RemoteSkillSource, a as loadProjectContext, b as createGetFileStructureTool, c as createSseBackend, i as buildProjectAgentStore, j as FallbackLlmBackend, k as createBackgroundAgentTools, n as BackgroundAgentManager, nt as SessionStore, o as McpManager, q as setWebSocketToolExecutor, r as SubagentOrchestrator, s as buildSandbox, t as AgentHistoryStore, tt as CheckpointStore, w as createWriteTodosTool, x as createWorkItemTools } from "../AgentHistoryStore-O2gKB5YG.mjs";
+import { _ as logger, o as isReadOnlyTool, t as ConfigStore, u as requireApiUrl } from "../ConfigStore-RHqyXcSS.mjs";
+import { r as reconstructTurnBlocks, t as WorkItemsClient } from "../WorkItemsClient-cmw7WYBy.mjs";
+import { a as ApiClient } from "../dist-B1bGf-yn.mjs";
 import { randomBytes } from "crypto";
 import { v4 } from "uuid";
 import { readFile } from "fs/promises";

package/dist/commands/mcpCommand.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-51UaP9pJ.mjs";
-import { t as version } from "../package-DEsNSP54.mjs";
+import { t as ConfigStore } from "../ConfigStore-RHqyXcSS.mjs";
+import { t as version } from "../package-DsG8Tgvs.mjs";
 //#region src/commands/mcpCommand.ts
 /**
 * External MCP commands (b4m mcp list, b4m mcp add, etc.)
@@ -70,7 +70,7 @@ async function handleMcpCommand(subcommand, argv) {
 			await handleDisable(config, argv.name, configStore);
 			break;
 		case "serve": {
-			const { handleMcpServeCommand } = await import("../serve-BaHzVbcm.mjs");
+			const { handleMcpServeCommand } = await import("../serve-CAfCQose.mjs");
 			await handleMcpServeCommand({
 				http: Boolean(argv.http),
 				port: typeof argv.port === "number" ? argv.port : void 0,

package/dist/commands/pluginCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as ConfigStore } from "../ConfigStore-51UaP9pJ.mjs";
+import { t as ConfigStore } from "../ConfigStore-RHqyXcSS.mjs";
 import { n as getDefaultPluginsDir, r as isFeatureEnabled, t as PluginStore } from "../PluginStore-DwvOJ-G3.mjs";
 import { promises } from "fs";
 import path from "path";

package/dist/commands/updateCommand.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "../package-DEsNSP54.mjs";
+import { t as version } from "../package-DsG8Tgvs.mjs";
 import { a as forceCheckForUpdate, c as isNpmPrefixWritable, d as shouldAttemptAutoUpdate, l as readCachedUpdate, n as REEXEC_GUARD_ENV, o as getAutoUpdatePreference, t as INSTALL_CMD, u as setAutoUpdatePreference } from "../updateChecker-CCLVVdH0.mjs";
 import { t as checkRipgrep } from "../ripgrepCheck-BmkyTK2i.mjs";
 import { execSync, spawnSync } from "child_process";

package/dist/{dist-BsG2Hlp-.mjs → dist-B1bGf-yn.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { _ as logger, f as AuthenticatedApiClient, p as DeviceFlowClient, t as ConfigStore } from "./ConfigStore-51UaP9pJ.mjs";
-import { t as version } from "./package-DEsNSP54.mjs";
+import { _ as logger, f as AuthenticatedApiClient, p as DeviceFlowClient, t as ConfigStore } from "./ConfigStore-RHqyXcSS.mjs";
+import { t as version } from "./package-DsG8Tgvs.mjs";
 import { isAxiosError } from "axios";
 import { Readable } from "node:stream";
 import { createParser } from "eventsource-parser";

package/dist/index.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-import { $ as processFileReferences, A as createAgentDelegateTool, C as createTodoStore, D as createCoordinateTaskTool, E as parseAgentConfig, F as PermissionManager, G as DEFAULT_THOROUGHNESS, H as DEFAULT_AGENT_MODEL, I as buildCliToolList, J as getPlanModeFilePath, M as substituteArguments, O as createResumeAgentTool, P as findIterationBoundary, Q as CustomCommandStore, S as createFindDefinitionTool, T as createSkillTool, U as DEFAULT_MAX_ITERATIONS, V as ALWAYS_DENIED_FOR_AGENTS, W as DEFAULT_RETRY_CONFIG, X as buildSkillsPromptSection, Y as buildSystemPrompt, Z as RemoteSkillSource, _ as createDecisionLogTool, at as rewireReservedNames, b as createGetFileStructureTool, ct as warmFileCache, d as createReviewGateStore, et as hasFileReferences, f as createReviewGateTool, ft as MAX_PASTE_SIZE, g as formatBlockersOutput, h as createBlockerTools, it as mergeCommands, j as FallbackLlmBackend, k as createBackgroundAgentTools, m as createBlockerStore, nt as SessionStore, ot as formatFileSize, p as formatReviewGatesOutput, q as setWebSocketToolExecutor, rt as searchCommands, s as buildSandbox, st as searchFiles, tt as CheckpointStore, u as isConnectionDrop, ut as COMPACTION_SUMMARY_MARKER, v as createDecisionStore, w as createWriteTodosTool, x as createWorkItemTools, y as formatDecisionsOutput, z as getProcessHooks } from "./AgentHistoryStore-DVxv1kSO.mjs";
+import { $ as processFileReferences, A as createAgentDelegateTool, C as createTodoStore, D as createCoordinateTaskTool, E as parseAgentConfig, F as PermissionManager, G as DEFAULT_THOROUGHNESS, H as DEFAULT_AGENT_MODEL, I as buildCliToolList, J as getPlanModeFilePath, M as substituteArguments, O as createResumeAgentTool, P as findIterationBoundary, Q as CustomCommandStore, S as createFindDefinitionTool, T as createSkillTool, U as DEFAULT_MAX_ITERATIONS, V as ALWAYS_DENIED_FOR_AGENTS, W as DEFAULT_RETRY_CONFIG, X as buildSkillsPromptSection, Y as buildSystemPrompt, Z as RemoteSkillSource, _ as createDecisionLogTool, at as rewireReservedNames, b as createGetFileStructureTool, ct as warmFileCache, d as createReviewGateStore, et as hasFileReferences, f as createReviewGateTool, ft as MAX_PASTE_SIZE, g as formatBlockersOutput, h as createBlockerTools, it as mergeCommands, j as FallbackLlmBackend, k as createBackgroundAgentTools, m as createBlockerStore, nt as SessionStore, ot as formatFileSize, p as formatReviewGatesOutput, q as setWebSocketToolExecutor, rt as searchCommands, s as buildSandbox, st as searchFiles, tt as CheckpointStore, u as isConnectionDrop, ut as COMPACTION_SUMMARY_MARKER, v as createDecisionStore, w as createWriteTodosTool, x as createWorkItemTools, y as formatDecisionsOutput, z as getProcessHooks } from "./AgentHistoryStore-O2gKB5YG.mjs";
 import { a as selectLiveSubagentTokens, i as selectLiveSubagentCredits, n as selectActiveBackgroundShells, o as useCliStore, r as selectCompletedBackgroundShells, t as selectActiveBackgroundAgents } from "./store-BxmPEI3v.mjs";
-import { Bt as selfClaimedActorKindSchema, F as ChatModels, Ft as DELEGATION_PAYLOAD_SCHEMA_NAME, It as actorColorIndex, Lt as actorKindMarker, P as CREDIT_DEDUCT_TRANSACTION_TYPES, Pt as ACTOR_COLOR_SLOTS, Rt as actorKindSchema, Z as REVIEW_GATE_STATUS_VALUES, _ as logger, c as getCreditsUrl, d as resolveApiEndpoint, et as SUBQUEST_STATUS_VALUES, g as parseApiUrl, ht as isEarlyStop, kt as tokenEstimateMultiplier, l as getEnvironmentName, m as LOCAL_DEV_URL, n as extractCompactInstructions, o as isReadOnlyTool, s as ApiEndpointUnconfiguredError, t as ConfigStore, u as requireApiUrl, v as SESSION_ID_PATTERN, y as isValidSessionId, zt as delegationPayloadSchema } from "./ConfigStore-51UaP9pJ.mjs";
+import { At as tokenEstimateMultiplier, Bt as delegationPayloadSchema, F as ChatModels, Ft as ACTOR_COLOR_SLOTS, It as DELEGATION_PAYLOAD_SCHEMA_NAME, Lt as actorColorIndex, P as CREDIT_DEDUCT_TRANSACTION_TYPES, Q as REVIEW_GATE_STATUS_VALUES, Rt as actorKindMarker, Vt as selfClaimedActorKindSchema, _ as logger, c as getCreditsUrl, d as resolveApiEndpoint, g as parseApiUrl, gt as isEarlyStop, l as getEnvironmentName, m as LOCAL_DEV_URL, n as extractCompactInstructions, o as isReadOnlyTool, s as ApiEndpointUnconfiguredError, t as ConfigStore, tt as SUBQUEST_STATUS_VALUES, u as requireApiUrl, v as SESSION_ID_PATTERN, y as isValidSessionId, zt as actorKindSchema } from "./ConfigStore-RHqyXcSS.mjs";
 import { r as isFeatureEnabled, t as PluginStore } from "./PluginStore-DwvOJ-G3.mjs";
-import { i as getTokenCounter, n as ConversationContext, r as reconstructTurnBlocks, t as WorkItemsClient } from "./WorkItemsClient-BMY0Qq1s.mjs";
-import { a as deferredToolRegistry, i as createToolSearchTool, n as buildSupportingStores, o as NotifyingLlmBackend, r as buildLlmBackend, t as buildAgent } from "./buildAgent-CrSRKYU_.mjs";
+import { i as getTokenCounter, n as ConversationContext, r as reconstructTurnBlocks, t as WorkItemsClient } from "./WorkItemsClient-cmw7WYBy.mjs";
+import { a as deferredToolRegistry, i as createToolSearchTool, n as buildSupportingStores, o as NotifyingLlmBackend, r as buildLlmBackend, t as buildAgent } from "./buildAgent-C0jmyDL4.mjs";
 import { t as getShellSessionManager } from "./ShellSessionManager-6o8KZzl1-vrbPAUTq.mjs";
-import { a as ApiClient, s as OAuthClient } from "./dist-BsG2Hlp-.mjs";
-import { t as version } from "./package-DEsNSP54.mjs";
+import { a as ApiClient, s as OAuthClient } from "./dist-B1bGf-yn.mjs";
+import { t as version } from "./package-DsG8Tgvs.mjs";
 import { s as getStartupUpdateStatus } from "./updateChecker-CCLVVdH0.mjs";
 import React, { useCallback, useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
 import { Box, Static, Text, measureElement, render, useApp, useInput, usePaste, useStdout } from "ink";

package/dist/{package-DEsNSP54.mjs → package-DsG8Tgvs.mjs}

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

package/dist/{serve-BaHzVbcm.mjs → serve-CAfCQose.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { A as BRIEFCASE_CATALOG_QUERIES, At as ttsBase64ResponseSchema, B as ImageModels, C as AGENT_QUEST_ID, L as DEFAULT_TTS_PROVIDER, M as BriefcasePromptIdSchema, Mt as ttsResponseTooLargeSchema, Ot as supportedVoiceGenerationVendor, St as replacePromptVariables, T as AGENT_QUEST_MCP_URI, V as ImagePromptResolutionSchema, Y as PROMPT_TEXT_MAX, _ as logger, g as parseApiUrl, h as NotAuthenticatedError, jt as ttsRequestSchema, k as ArtifactTypeSchema, nt as VisibilitySchema, ot as buildPromptContext, t as ConfigStore, u as requireApiUrl, ut as generatedAudioResponseSchema, w as AGENT_QUEST_MANIFEST, xt as questReplyText, yt as joinReplySlots, z as GENERATED_IMAGE_EXTENSION_RE } from "./ConfigStore-51UaP9pJ.mjs";
-import { a as ApiClient, i as parseRetryAfterSeconds, o as isProviderKeyFailure, r as createClient, t as B4mApiError } from "./dist-BsG2Hlp-.mjs";
+import { A as BRIEFCASE_CATALOG_QUERIES, B as GENERATED_IMAGE_EXTENSION_RE, C as AGENT_QUEST_ID, Ct as replacePromptVariables, H as ImagePromptResolutionSchema, L as CreateArtifactRequestSchema, M as BriefcasePromptIdSchema, Mt as ttsRequestSchema, Nt as ttsResponseTooLargeSchema, R as DEFAULT_TTS_PROVIDER, St as questReplyText, T as AGENT_QUEST_MCP_URI, V as ImageModels, X as PROMPT_TEXT_MAX, _ as logger, bt as joinReplySlots, dt as generatedAudioResponseSchema, g as parseApiUrl, h as NotAuthenticatedError, jt as ttsBase64ResponseSchema, k as ArtifactTypeSchema, kt as supportedVoiceGenerationVendor, rt as VisibilitySchema, st as buildPromptContext, t as ConfigStore, u as requireApiUrl, w as AGENT_QUEST_MANIFEST } from "./ConfigStore-RHqyXcSS.mjs";
+import { a as ApiClient, i as parseRetryAfterSeconds, o as isProviderKeyFailure, r as createClient, t as B4mApiError } from "./dist-B1bGf-yn.mjs";
 import { z as z$1 } from "zod";
 import { isAxiosError } from "axios";
 import { createHash, randomUUID } from "node:crypto";
@@ -227,6 +227,27 @@ var B4mApiClient = class {
 	async getArtifact(artifactId) {
 		return this.client.get(`/api/artifacts/${encodeURIComponent(artifactId)}`, { params: { includeContent: "true" } });
 	}
+	/** POST /api/v1/artifacts: creates a private artifact at version 1. */
+	async createArtifact(args) {
+		const artifact = await this.sdk.call("createArtifact", { body: {
+			type: args.type,
+			title: args.title,
+			content: args.content,
+			...args.description !== void 0 ? { description: args.description } : {},
+			...args.notebookId ? { session_id: args.notebookId } : {},
+			...args.projectId ? { project_id: args.projectId } : {},
+			...args.tags?.length ? { tags: args.tags } : {}
+		} });
+		return {
+			id: artifact.id,
+			type: artifact.type,
+			title: artifact.title,
+			version: artifact.version,
+			notebookId: artifact.session_id ?? void 0,
+			projectId: artifact.project_id ?? void 0,
+			createdAt: artifact.created_at
+		};
+	}
 	/**
 	* The caller's own most recent publication of an artifact, or null. The route is
 	* owner-scoped for `sourceArtifactId`, so another user's page never matches.
@@ -461,6 +482,12 @@ const TOOL_META = [
 		description: "Generate an image from a text prompt and wait for the render. Returns the quest and notebook ids plus each image's file name and download URL. Image names are not file ids and do not work with get_file.",
 		scope: "ai:generate"
 	},
+	{
+		name: "create_artifact",
+		title: "Create artifact",
+		description: "Create a private artifact (diagram, chart, code, page) and return its id. There is no markdown type: put a written document in type 'html'. Pass the returned id to publish_artifact to share it.",
+		scope: "notebooks:write"
+	},
 	{
 		name: "publish_artifact",
 		title: "Publish artifact",
@@ -544,6 +571,15 @@ const publishArtifactShape = {
 	visibility: publishVisibilitySchema.optional().describe("Who can open the link: 'public' (anyone) or 'private' (only you); omit to keep an existing page's visibility (a first publish is public)"),
 	title: z$1.string().min(1).max(200).optional().describe("Page title; defaults to the artifact's title")
 };
+const createArtifactShape = {
+	type: CreateArtifactRequestSchema.shape.type.describe("Artifact type: 'html' for a written document or web page, 'mermaid' for a diagram, 'recharts' for a chart, 'svg', 'react', 'python' or 'code' for source"),
+	title: CreateArtifactRequestSchema.shape.title.describe("Artifact title"),
+	content: CreateArtifactRequestSchema.shape.content.describe("The artifact's source: HTML, Mermaid, SVG, code and so on, matching type"),
+	description: CreateArtifactRequestSchema.shape.description.describe("Short description"),
+	notebookId: notebookId("A notebook (session) you can edit, to file the artifact under").optional(),
+	projectId: CreateArtifactRequestSchema.shape.project_id.describe("A project you can read, to file the artifact under"),
+	tags: CreateArtifactRequestSchema.shape.tags.describe("Up to 20 tags")
+};
 const textToSpeechShape = {
 	...ttsRequestSchema.omit({ encoding: true }).shape,
 	text: ttsRequestSchema.shape.text.describe("Text to speak"),
@@ -825,6 +861,9 @@ async function openPublishDraft(client, request) {
 		});
 	}
 }
+async function createArtifact(client, args) {
+	return client.createArtifact(args);
+}
 /**
 * Publish an artifact: upload its RAW content and let finalize render it
 * (source.artifactType), so the page matches an in-app publish byte for byte with
@@ -1118,6 +1157,11 @@ function registerTools(server, client) {
 		baseURL,
 		onProgress: progressReporter(extra, () => "rendering image")
 	})));
+	server.registerTool("create_artifact", {
+		title: meta("create_artifact").title,
+		description: meta("create_artifact").description,
+		inputSchema: createArtifactShape
+	}, (args) => run("notebooks:write", () => createArtifact(client, args)));
 	server.registerTool("publish_artifact", {
 		title: meta("publish_artifact").title,
 		description: meta("publish_artifact").description,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "mcpName": "io.github.bike4mind/bike4mind",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
@@ -124,17 +124,17 @@
     "tsx": "^4.23.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@bike4mind/agents": "1.2.0",
+    "@bike4mind/agents": "1.2.1",
     "@bike4mind/client-auth": "0.2.0",
-    "@bike4mind/common": "15.0.0",
-    "@bike4mind/fab-pipeline": "2.1.0",
+    "@bike4mind/common": "15.1.0",
+    "@bike4mind/fab-pipeline": "2.1.1",
+    "@bike4mind/llm-adapters": "1.1.1",
     "@bike4mind/hearth": "0.3.1",
-    "@bike4mind/llm-adapters": "1.1.0",
-    "@bike4mind/mcp": "2.1.0",
+    "@bike4mind/mcp": "2.1.1",
     "@bike4mind/observability": "0.2.3",
-    "@bike4mind/sdk": "1.0.0",
-    "@bike4mind/services": "17.0.0",
-    "@bike4mind/utils": "7.1.0"
+    "@bike4mind/sdk": "1.0.1",
+    "@bike4mind/services": "17.1.0",
+    "@bike4mind/utils": "7.1.1"
   },
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.18.0"