@bike4mind/cli 1.2.0 → 2.0.0

package/dist/{package-CGZIoxcs.mjs → package-Dl_F2Fah.mjs}

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

package/dist/{serve-CPXqcEZr.mjs → serve-Y2zMbfGs.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { N as PROMPT_TEXT_MAX, _ as AGENT_QUEST_ID, h as requireApiUrl, m as parseApiUrl, n as logger, t as ConfigStore, v as AGENT_QUEST_MANIFEST, y as AGENT_QUEST_MCP_URI } from "./ConfigStore-qV7NrCgZ.mjs";
-import { t as ApiClient } from "./ApiClient-D0fQ2FT6.mjs";
+import { R as PROMPT_TEXT_MAX, Y as generatedAudioResponseSchema, _ as requireApiUrl, b as AGENT_QUEST_MANIFEST, dt as ttsBase64ResponseSchema, ft as ttsRequestSchema, g as parseApiUrl, k as DEFAULT_TTS_PROVIDER, n as logger, pt as ttsResponseTooLargeSchema, t as ConfigStore, ut as supportedVoiceGenerationVendor, x as AGENT_QUEST_MCP_URI, y as AGENT_QUEST_ID } from "./ConfigStore-DIs-K9oD.mjs";
+import { n as NotAuthenticatedError, r as isProviderKeyFailure, t as ApiClient } from "./ApiClient-BTI0-m0g.mjs";
 import { z as z$1 } from "zod";
 import { isAxiosError } from "axios";
 import { Writable } from "node:stream";
@@ -46,12 +46,27 @@ var B4mApiClient = class {
 	async createNotebook(args) {
 		return this.client.post("/api/sessions/create", {
 			...args.name ? { name: args.name } : {},
-			...args.projectId ? { projectId: args.projectId } : {}
+			...args.projectId ? { projectId: args.projectId } : {},
+			...args.dataLakeId ? { dataLakeId: args.dataLakeId } : {}
 		});
 	}
+	/**
+	* GET /api/v1/data-lakes is cursor-paginated (flat `limit`/`cursor` params,
+	* `{ data, next_cursor }` body), so `toList` does not apply.
+	*/
+	async listDataLakes(args) {
+		const result = await this.client.get("/api/v1/data-lakes", { params: {
+			limit: args.limit,
+			...args.cursor ? { cursor: args.cursor } : {}
+		} });
+		return {
+			data: result.data ?? [],
+			nextCursor: result.next_cursor ?? null
+		};
+	}
 	async sendChat(args) {
 		return this.client.post("/api/chat", {
-			...args.notebookId ? { sessionId: args.notebookId } : {},
+			...args.notebookId ? { sessionId: args.notebookId } : { newConversation: true },
 			message: args.message,
 			...args.model ? { model: args.model } : {},
 			...args.systemPrompt ? { systemPrompt: args.systemPrompt } : {},
@@ -81,36 +96,72 @@ var B4mApiClient = class {
 	async getFile(fileId) {
 		return this.client.get(`/api/files/${encodeURIComponent(fileId)}`);
 	}
-	/**
-	* Generate a sound effect. Unlike the JSON routes, this one streams raw audio
-	* bytes, so it goes through the axios instance directly to read the response
-	* headers (content type + the persisted-FabFile side channel). On failure the
-	* error body arrives as bytes; {@link decodeArrayBufferErrorBody} restores the
-	* JSON shape so {@link mapApiError} can surface the server's message.
-	*/
+	/** Generate a sound effect; see {@link postGeneratedAudio} for the normalized response. */
 	async generateSoundEffect(args) {
+		return this.postGeneratedAudio("/api/ai/sound-effects", {
+			provider: args.provider,
+			text: args.text,
+			...args.durationSeconds !== void 0 ? { durationSeconds: args.durationSeconds } : {},
+			...args.promptInfluence !== void 0 ? { promptInfluence: args.promptInfluence } : {},
+			...args.format ? { format: args.format } : {}
+		}, generatedAudioResponseSchema);
+	}
+	async synthesizeSpeech(args) {
 		try {
-			const response = await this.client.getAxiosInstance().post("/api/ai/sound-effects", {
-				provider: args.provider,
-				text: args.text,
-				...args.durationSeconds !== void 0 ? { durationSeconds: args.durationSeconds } : {},
-				...args.promptInfluence !== void 0 ? { promptInfluence: args.promptInfluence } : {},
-				...args.format ? { format: args.format } : {}
-			}, { responseType: "arraybuffer" });
-			const headerString = (value) => typeof value === "string" ? value : void 0;
-			const saved = String(response.headers["x-b4m-audio-saved"] ?? "") === "true";
 			return {
-				audio: Buffer.from(response.data),
-				contentType: String(response.headers["content-type"] ?? "application/octet-stream"),
-				saved,
-				fabFileId: saved ? headerString(response.headers["x-b4m-audio-fab-file-id"]) : void 0,
-				fileName: saved ? headerString(response.headers["x-b4m-audio-file-name"]) : void 0,
-				fileUrl: saved ? headerString(response.headers["x-b4m-audio-file-url"]) : void 0
+				kind: "audio",
+				data: await this.postGeneratedAudio("/api/ai/tts", args, ttsBase64ResponseSchema)
 			};
 		} catch (error) {
-			throw decodeArrayBufferErrorBody(error);
+			if (isAxiosError(error) && error.response?.status === 413) {
+				const oversized = ttsResponseTooLargeSchema.safeParse(error.response.data);
+				if (oversized.success && oversized.data.saved && oversized.data.fabFileId) {
+					const fallbackFrom = supportedVoiceGenerationVendor.safeParse(error.response.headers?.["x-b4m-tts-provider-fallback-from"]);
+					return {
+						kind: "saved-too-large",
+						data: {
+							...oversized.data,
+							fabFileId: oversized.data.fabFileId
+						},
+						...fallbackFrom.success ? { fallbackFrom: fallbackFrom.data } : {}
+					};
+				}
+			}
+			throw error;
 		}
 	}
+	/**
+	* POST a generated-audio request with `encoding: 'base64'` and normalize any
+	* server's answer into the JSON shape `schema` describes. Base64 (never binary)
+	* because an oversized result is a 303 in binary mode, and axios drops the
+	* X-B4M headers when following it. A server predating the `encoding` field
+	* ignores it and streams raw bytes with the save result in X-B4M-Audio-* headers;
+	* those are rebuilt into the inline variant. The request is arraybuffer-typed, so
+	* a failure body arrives as bytes; {@link decodeArrayBufferErrorBody} restores
+	* its JSON shape for {@link mapApiError}.
+	*/
+	async postGeneratedAudio(path, body, schema) {
+		const response = await this.client.getAxiosInstance().post(path, {
+			...body,
+			encoding: "base64"
+		}, { responseType: "arraybuffer" }).catch((error) => {
+			throw decodeArrayBufferErrorBody(error);
+		});
+		const contentType = String(response.headers["content-type"] ?? "application/octet-stream");
+		const bytes = Buffer.from(response.data);
+		if (/json/i.test(contentType)) return schema.parse(JSON.parse(bytes.toString("utf8")));
+		const headerString = (value) => typeof value === "string" ? value : void 0;
+		const saved = String(response.headers["x-b4m-audio-saved"] ?? "") === "true";
+		return schema.parse({
+			delivery: "inline",
+			audio: bytes.toString("base64"),
+			contentType,
+			saved,
+			fabFileId: saved ? headerString(response.headers["x-b4m-audio-fab-file-id"]) : void 0,
+			fileName: saved ? headerString(response.headers["x-b4m-audio-file-name"]) : void 0,
+			fileUrl: saved ? headerString(response.headers["x-b4m-audio-file-url"]) : void 0
+		});
+	}
 	async listProjects(args) {
 		const result = await this.client.get("/api/projects", { params: {
 			...args.search ? { search: args.search } : {},
@@ -152,10 +203,16 @@ var B4mApiClient = class {
 * gap that may not be the cause.
 */
 function mapApiError(error, baseURL, scope) {
+	if (error instanceof NotAuthenticatedError) return "not authenticated: no credential configured (set B4M_API_KEY or run `b4m login`)";
 	if (isAxiosError(error)) {
 		const status = error.response?.status;
-		if (status === 401) return "authentication failed (run `b4m login` or set B4M_API_KEY)";
+		if (status === 401) {
+			const providerKeyMessage = providerKeyFailureMessage(error.response?.data);
+			if (providerKeyMessage) return providerKeyMessage;
+			return "authentication failed (run `b4m login` or set B4M_API_KEY)";
+		}
 		if (status === 403) {
+			if ((error.response?.data)?.code === "FEATURE_DISABLED") return "feature disabled on this Bike4Mind instance (ask an admin to enable it)";
 			const base = "API key forbidden: check the key's scopes and account access";
 			return scope ? `${base} (recommended scope: ${scope})` : base;
 		}
@@ -215,6 +272,10 @@ function extractServerMessage(data) {
 		if (typeof record.message === "string") return record.message;
 	}
 }
+function providerKeyFailureMessage(data) {
+	if (!isProviderKeyFailure(data)) return void 0;
+	return `${extractServerMessage(data) ?? "the AI provider could not be used"} (configure or fix the provider API key in Bike4Mind; this is not a Bike4Mind login problem)`;
+}
 //#endregion
 //#region src/mcp/tools.ts
 const TOOL_META = [
@@ -233,13 +294,13 @@ const TOOL_META = [
 	{
 		name: "create_notebook",
 		title: "Create notebook",
-		description: "Create a new notebook, optionally inside a project. Defaults the name to \"New Notebook\" when omitted.",
+		description: "Create a new notebook, optionally inside a project or grounded in a data lake (dataLakeId, see list_lakes). Defaults the name to \"New Notebook\" when omitted.",
 		scope: "notebooks:write"
 	},
 	{
 		name: "send_message",
 		title: "Send message",
-		description: "Send a chat message and wait for the assistant reply.",
+		description: "Send a chat message and wait for the assistant reply; returns the cited sources (citables) the answer was grounded in.",
 		scope: "ai:chat"
 	},
 	{
@@ -248,6 +309,12 @@ const TOOL_META = [
 		description: "Semantic search across the caller's notebooks.",
 		scope: "notebooks:read"
 	},
+	{
+		name: "list_lakes",
+		title: "List data lakes",
+		description: "List the data lakes the caller can reach. Pass a lake's id as dataLakeId to create_notebook to ground a notebook in it.",
+		scope: "datalake:read"
+	},
 	{
 		name: "list_files",
 		title: "List files",
@@ -265,6 +332,12 @@ const TOOL_META = [
 		title: "Generate sound effect",
 		description: "Generate a sound effect from a text description. Returns the saved audio file (with a signed download URL) when the caller keeps generated audio, otherwise the audio inline.",
 		scope: "ai:generate"
+	},
+	{
+		name: "text_to_speech",
+		title: "Text to speech",
+		description: "Synthesize speech from text. Returns a saved audio file with a signed download URL when available, otherwise audio inline.",
+		scope: "ai:generate"
 	}
 ];
 TOOL_META.map((t) => t.name);
@@ -276,11 +349,12 @@ const listNotebooksShape = {
 const getNotebookShape = { notebookId: z$1.string().describe("The notebook (session) id") };
 const createNotebookShape = {
 	name: z$1.string().optional().describe("Name for the new notebook"),
-	projectId: z$1.string().optional().describe("Project to create the notebook in")
+	projectId: z$1.string().optional().describe("Project to create the notebook in"),
+	dataLakeId: z$1.string().optional().describe("Data lake id or slug to ground the notebook in (see list_lakes); seeds the lake's retrieval defaults")
 };
 const sendMessageShape = {
 	message: z$1.string().describe("The message to send"),
-	notebookId: z$1.string().optional().describe("Notebook to send to; defaults to the most recent"),
+	notebookId: z$1.string().optional().describe("Notebook to send to; omit to start a new notebook (its id is returned as notebookId, pass it back to continue the thread)"),
 	model: z$1.string().optional().describe("Model id to use; defaults to the instance default"),
 	systemPrompt: z$1.string().max(PROMPT_TEXT_MAX).optional().describe("Caller-supplied system-prompt text for this message only; refines but never overrides other guidance")
 };
@@ -289,6 +363,10 @@ const searchKnowledgeBaseShape = {
 	limit: z$1.number().int().min(1).max(100).default(10).describe("Maximum results to return"),
 	minSimilarity: z$1.number().min(0).max(1).optional().describe("Minimum cosine similarity threshold")
 };
+const listLakesShape = {
+	limit: z$1.number().int().min(1).max(100).default(25).describe("Maximum lakes to return"),
+	cursor: z$1.string().optional().describe("Pass back nextCursor from the previous page")
+};
 const listFilesShape = {
 	search: z$1.string().optional().describe("Filter files by name/content"),
 	limit: z$1.number().int().min(1).max(100).default(25).describe("Maximum files to return"),
@@ -302,6 +380,12 @@ const generateSoundEffectShape = {
 	promptInfluence: z$1.number().min(0).max(1).optional().describe("How strictly to follow the prompt (0 = loose, 1 = strict)"),
 	format: z$1.string().optional().describe("Provider output encoding token, e.g. mp3_44100_128")
 };
+const textToSpeechShape = {
+	...ttsRequestSchema.omit({ encoding: true }).shape,
+	text: ttsRequestSchema.shape.text.describe("Text to speak"),
+	provider: ttsRequestSchema.shape.provider.describe(`Speech provider; defaults to ${DEFAULT_TTS_PROVIDER}`),
+	preview: ttsRequestSchema.shape.preview.describe("Skip saving a copy to the file browser")
+};
 function notebookSummary(n) {
 	return {
 		id: n.id,
@@ -311,6 +395,17 @@ function notebookSummary(n) {
 		updatedAt: n.updatedAt ?? n.lastUpdated
 	};
 }
+function lakeSummary(l) {
+	return {
+		id: l.id,
+		name: l.name,
+		slug: l.slug,
+		description: l.description ?? void 0,
+		builtIn: l.built_in,
+		status: l.status,
+		fileCount: l.file_count
+	};
+}
 async function listNotebooks(client, args) {
 	const { data, hasMore } = await client.listNotebooks(args);
 	return {
@@ -330,23 +425,38 @@ async function createNotebook(client, args) {
 async function sendMessage(client, args) {
 	const res = await client.sendChat(args);
 	const questId = res.id;
-	let notebookId = args.notebookId;
-	if (!notebookId) try {
-		notebookId = (await client.getQuest(questId)).sessionId;
+	let quest;
+	try {
+		quest = await client.getQuest(questId);
 	} catch {
-		notebookId = void 0;
+		quest = void 0;
 	}
-	const reply = res.responses && res.responses.length > 0 ? res.responses.join("\n\n") : res.response ?? "";
+	const notebookId = args.notebookId ?? res.sessionId ?? quest?.sessionId;
+	const citables = quest ? (quest.promptMeta?.citables ?? []).map((c) => ({
+		id: c.id,
+		type: c.type,
+		title: c.title,
+		url: c.url,
+		description: c.description
+	})) : void 0;
 	return {
 		notebookId,
 		questId,
-		reply,
-		model: res.model
+		reply: res.responses && res.responses.length > 0 ? res.responses.join("\n\n") : res.response ?? "",
+		model: res.model,
+		citables
 	};
 }
 async function searchKnowledgeBase(client, args) {
 	return { results: await client.searchKnowledgeBase(args) };
 }
+async function listLakes(client, args) {
+	const { data, nextCursor } = await client.listDataLakes(args);
+	return {
+		lakes: data.map(lakeSummary),
+		nextCursor
+	};
+}
 async function listFiles(client, args) {
 	const { data, hasMore } = await client.listFiles(args);
 	return {
@@ -358,26 +468,7 @@ async function getFile(client, args) {
 	return client.getFile(args.fileId);
 }
 async function generateSoundEffect(client, args) {
-	const { audio, contentType, saved, fabFileId, fileName, fileUrl } = await client.generateSoundEffect(args);
-	const base = {
-		provider: args.provider,
-		contentType,
-		byteLength: audio.length
-	};
-	if (saved && fabFileId && fileUrl) return {
-		...base,
-		saved: true,
-		file: {
-			id: fabFileId,
-			fileName,
-			fileUrl
-		}
-	};
-	return {
-		...base,
-		saved: false,
-		audioBase64: audio.toString("base64")
-	};
+	return generatedAudioResult(await client.generateSoundEffect(args), { provider: args.provider });
 }
 function toResult(value) {
 	const structuredContent = value && typeof value === "object" && !Array.isArray(value) ? value : { result: value };
@@ -399,21 +490,57 @@ function errorResult(message) {
 	};
 }
 /**
-* Render a {@link SoundEffectOutcome} as an MCP result. A persisted file becomes
-* a JSON metadata result (carrying the signed URL), exactly like get_file. When
-* the audio was not persisted, it is returned inline as an `audio` content block
-* so the bytes are not lost; the base64 is kept out of structuredContent to avoid
-* duplicating a potentially large payload.
+* Render a generated-audio response as an MCP result, shared by every audio tool.
+* Oversized audio is reported by its signed URL; a saved copy with a usable URL is
+* reported as a file (like get_file) with no inline bytes. Otherwise the audio rides
+* inline as an `audio` block so a billed result is never lost, with any saved copy
+* still named by id and a skipped save explained. The route forwards the signed URL
+* it minted at upload, so no getFile re-fetch is needed (that fails closed until
+* the async moderation scan runs).
 */
-function soundEffectResult(outcome) {
-	if (outcome.saved) return toResult({
+function generatedAudioResult(response, endpointMetadata) {
+	const metadata = {
+		...endpointMetadata,
+		contentType: response.contentType
+	};
+	const saveSkippedReason = response.saveSkippedReason ? { saveSkippedReason: response.saveSkippedReason } : {};
+	const file = response.fabFileId ? {
+		id: response.fabFileId,
+		...response.fileName ? { fileName: response.fileName } : {},
+		...response.fileUrl ? { fileUrl: response.fileUrl } : {}
+	} : void 0;
+	if (response.delivery === "url") return toResult({
+		...metadata,
+		byteLength: response.bytes,
+		url: response.url,
+		saved: response.saved === true,
+		...response.saved && file ? { file } : {},
+		...saveSkippedReason
+	});
+	const byteLength = Buffer.from(response.audio, "base64").length;
+	if (response.saved && file && file.fileUrl) return toResult({
+		...metadata,
+		byteLength,
 		saved: true,
-		provider: outcome.provider,
-		contentType: outcome.contentType,
-		byteLength: outcome.byteLength,
-		file: outcome.file
+		file
 	});
-	const { audioBase64, ...meta } = outcome;
+	return inlineAudioResult(response.saved && file ? {
+		...metadata,
+		byteLength,
+		saved: true,
+		file
+	} : {
+		...metadata,
+		byteLength,
+		saved: false,
+		...saveSkippedReason
+	}, response.audio, response.contentType);
+}
+/**
+* Metadata as JSON text plus the audio as an MCP `audio` block. The base64 stays
+* out of structuredContent so a potentially large payload is not duplicated.
+*/
+function inlineAudioResult(meta, audioBase64, mimeType) {
 	return {
 		content: [{
 			type: "text",
@@ -421,11 +548,32 @@ function soundEffectResult(outcome) {
 		}, {
 			type: "audio",
 			data: audioBase64,
-			mimeType: outcome.contentType
+			mimeType
 		}],
 		structuredContent: meta
 	};
 }
+async function textToSpeech(client, args) {
+	const response = await client.synthesizeSpeech(args);
+	if (response.kind === "saved-too-large") {
+		const { provider, fabFileId, fileUrl } = response.data;
+		return toResult({
+			saved: true,
+			provider,
+			...response.fallbackFrom ? { fallbackFrom: response.fallbackFrom } : {},
+			file: {
+				id: fabFileId,
+				...fileUrl ? { fileUrl } : {}
+			}
+		});
+	}
+	const result = response.data;
+	return generatedAudioResult(result, {
+		provider: result.provider ?? args.provider ?? "openai",
+		...result.fallbackFrom ? { fallbackFrom: result.fallbackFrom } : {},
+		format: result.format
+	});
+}
 /**
 * Register the Bike4Mind MCP tools on `server`. Each handler is wrapped so an
 * API failure becomes a structured `isError` result carrying a friendly message
@@ -466,6 +614,11 @@ function registerTools(server, client) {
 		description: meta("search_knowledge_base").description,
 		inputSchema: searchKnowledgeBaseShape
 	}, (args) => run("notebooks:read", () => searchKnowledgeBase(client, args)));
+	server.registerTool("list_lakes", {
+		title: meta("list_lakes").title,
+		description: meta("list_lakes").description,
+		inputSchema: listLakesShape
+	}, (args) => run("datalake:read", () => listLakes(client, args)));
 	server.registerTool("list_files", {
 		title: meta("list_files").title,
 		description: meta("list_files").description,
@@ -482,7 +635,18 @@ function registerTools(server, client) {
 		inputSchema: generateSoundEffectShape
 	}, async (args) => {
 		try {
-			return soundEffectResult(await generateSoundEffect(client, args));
+			return await generateSoundEffect(client, args);
+		} catch (err) {
+			return errorResult(mapApiError(err, baseURL, "ai:generate"));
+		}
+	});
+	server.registerTool("text_to_speech", {
+		title: meta("text_to_speech").title,
+		description: meta("text_to_speech").description,
+		inputSchema: textToSpeechShape
+	}, async (args) => {
+		try {
+			return await textToSpeech(client, args);
 		} catch (err) {
 			return errorResult(mapApiError(err, baseURL, "ai:generate"));
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "mcpName": "io.github.bike4mind/bike4mind",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
@@ -55,7 +55,7 @@
     "@opensearch-project/opensearch": "2.11.0",
     "@smithy/node-http-handler": "^4.9.3",
     "async-mutex": "^0.5.0",
-    "axios": "1.18.0",
+    "axios": "1.20.0",
     "bcryptjs": "^3.0.3",
     "better-sqlite3": "^13.0.3",
     "cheerio": "1.2.0",
@@ -124,16 +124,16 @@
     "tsdown": "^0.22.3",
     "tsx": "^4.23.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.10",
-    "@bike4mind/agents": "1.0.14",
-    "@bike4mind/common": "12.0.0",
+    "vitest": "^4.1.11",
+    "@bike4mind/agents": "1.1.1",
+    "@bike4mind/common": "13.0.0",
     "@bike4mind/hearth": "0.3.0",
-    "@bike4mind/llm-adapters": "0.15.8",
-    "@bike4mind/mcp": "2.0.14",
-    "@bike4mind/services": "14.0.0",
-    "@bike4mind/observability": "0.2.2",
-    "@bike4mind/utils": "6.3.0",
-    "@bike4mind/fab-pipeline": "1.5.0"
+    "@bike4mind/fab-pipeline": "1.5.3",
+    "@bike4mind/llm-adapters": "0.16.1",
+    "@bike4mind/mcp": "2.0.17",
+    "@bike4mind/observability": "0.2.3",
+    "@bike4mind/utils": "6.5.1",
+    "@bike4mind/services": "15.0.0"
   },
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.18.0"