@gguf/claw 2026.2.9 → 2026.2.13

package/dist/{agent-scope-Dp8sREli.js → agent-scope-DASgjz2_.js}

@@ -1,13 +1,177 @@
 import { s as resolveStateDir, u as resolveRequiredHomeDir } from "./paths-BZtyHNCi.js";
-import { g as parseAgentSessionKey, h as isSubagentSessionKey, l as normalizeAgentId, n as DEFAULT_AGENT_ID } from "./session-key-nXYQSv-a.js";
-import { g as resolveUserPath, p as pathExists } from "./utils-dp_OM900.js";
-import { t as runCommandWithTimeout } from "./exec-CiH_vkWn.js";
+import { I as pathExists, t as runCommandWithTimeout, z as resolveUserPath } from "./exec-_PSUrMP8.js";
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import fs$1 from "node:fs";
 import { fileURLToPath } from "node:url";
 
+//#region src/sessions/session-key-utils.ts
+function parseAgentSessionKey(sessionKey) {
+	const raw = (sessionKey ?? "").trim();
+	if (!raw) return null;
+	const parts = raw.split(":").filter(Boolean);
+	if (parts.length < 3) return null;
+	if (parts[0] !== "agent") return null;
+	const agentId = parts[1]?.trim();
+	const rest = parts.slice(2).join(":");
+	if (!agentId || !rest) return null;
+	return {
+		agentId,
+		rest
+	};
+}
+function isSubagentSessionKey(sessionKey) {
+	const raw = (sessionKey ?? "").trim();
+	if (!raw) return false;
+	if (raw.toLowerCase().startsWith("subagent:")) return true;
+	const parsed = parseAgentSessionKey(raw);
+	return Boolean((parsed?.rest ?? "").toLowerCase().startsWith("subagent:"));
+}
+function isAcpSessionKey(sessionKey) {
+	const raw = (sessionKey ?? "").trim();
+	if (!raw) return false;
+	if (raw.toLowerCase().startsWith("acp:")) return true;
+	const parsed = parseAgentSessionKey(raw);
+	return Boolean((parsed?.rest ?? "").toLowerCase().startsWith("acp:"));
+}
+const THREAD_SESSION_MARKERS = [":thread:", ":topic:"];
+function resolveThreadParentSessionKey(sessionKey) {
+	const raw = (sessionKey ?? "").trim();
+	if (!raw) return null;
+	const normalized = raw.toLowerCase();
+	let idx = -1;
+	for (const marker of THREAD_SESSION_MARKERS) {
+		const candidate = normalized.lastIndexOf(marker);
+		if (candidate > idx) idx = candidate;
+	}
+	if (idx <= 0) return null;
+	const parent = raw.slice(0, idx).trim();
+	return parent ? parent : null;
+}
+
+//#endregion
+//#region src/routing/session-key.ts
+const DEFAULT_AGENT_ID = "main";
+const DEFAULT_MAIN_KEY = "main";
+const DEFAULT_ACCOUNT_ID = "default";
+const VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;
+const INVALID_CHARS_RE = /[^a-z0-9_-]+/g;
+const LEADING_DASH_RE = /^-+/;
+const TRAILING_DASH_RE = /-+$/;
+function normalizeToken(value) {
+	return (value ?? "").trim().toLowerCase();
+}
+function normalizeMainKey(value) {
+	const trimmed = (value ?? "").trim();
+	return trimmed ? trimmed.toLowerCase() : DEFAULT_MAIN_KEY;
+}
+function resolveAgentIdFromSessionKey(sessionKey) {
+	return normalizeAgentId(parseAgentSessionKey(sessionKey)?.agentId ?? DEFAULT_AGENT_ID);
+}
+function classifySessionKeyShape(sessionKey) {
+	const raw = (sessionKey ?? "").trim();
+	if (!raw) return "missing";
+	if (parseAgentSessionKey(raw)) return "agent";
+	return raw.toLowerCase().startsWith("agent:") ? "malformed_agent" : "legacy_or_alias";
+}
+function normalizeAgentId(value) {
+	const trimmed = (value ?? "").trim();
+	if (!trimmed) return DEFAULT_AGENT_ID;
+	if (VALID_ID_RE.test(trimmed)) return trimmed.toLowerCase();
+	return trimmed.toLowerCase().replace(INVALID_CHARS_RE, "-").replace(LEADING_DASH_RE, "").replace(TRAILING_DASH_RE, "").slice(0, 64) || DEFAULT_AGENT_ID;
+}
+function sanitizeAgentId(value) {
+	const trimmed = (value ?? "").trim();
+	if (!trimmed) return DEFAULT_AGENT_ID;
+	if (VALID_ID_RE.test(trimmed)) return trimmed.toLowerCase();
+	return trimmed.toLowerCase().replace(INVALID_CHARS_RE, "-").replace(LEADING_DASH_RE, "").replace(TRAILING_DASH_RE, "").slice(0, 64) || DEFAULT_AGENT_ID;
+}
+function normalizeAccountId(value) {
+	const trimmed = (value ?? "").trim();
+	if (!trimmed) return DEFAULT_ACCOUNT_ID;
+	if (VALID_ID_RE.test(trimmed)) return trimmed.toLowerCase();
+	return trimmed.toLowerCase().replace(INVALID_CHARS_RE, "-").replace(LEADING_DASH_RE, "").replace(TRAILING_DASH_RE, "").slice(0, 64) || DEFAULT_ACCOUNT_ID;
+}
+function buildAgentMainSessionKey(params) {
+	return `agent:${normalizeAgentId(params.agentId)}:${normalizeMainKey(params.mainKey)}`;
+}
+function buildAgentPeerSessionKey(params) {
+	const peerKind = params.peerKind ?? "direct";
+	if (peerKind === "direct") {
+		const dmScope = params.dmScope ?? "main";
+		let peerId = (params.peerId ?? "").trim();
+		const linkedPeerId = dmScope === "main" ? null : resolveLinkedPeerId({
+			identityLinks: params.identityLinks,
+			channel: params.channel,
+			peerId
+		});
+		if (linkedPeerId) peerId = linkedPeerId;
+		peerId = peerId.toLowerCase();
+		if (dmScope === "per-account-channel-peer" && peerId) {
+			const channel = (params.channel ?? "").trim().toLowerCase() || "unknown";
+			const accountId = normalizeAccountId(params.accountId);
+			return `agent:${normalizeAgentId(params.agentId)}:${channel}:${accountId}:direct:${peerId}`;
+		}
+		if (dmScope === "per-channel-peer" && peerId) {
+			const channel = (params.channel ?? "").trim().toLowerCase() || "unknown";
+			return `agent:${normalizeAgentId(params.agentId)}:${channel}:direct:${peerId}`;
+		}
+		if (dmScope === "per-peer" && peerId) return `agent:${normalizeAgentId(params.agentId)}:direct:${peerId}`;
+		return buildAgentMainSessionKey({
+			agentId: params.agentId,
+			mainKey: params.mainKey
+		});
+	}
+	const channel = (params.channel ?? "").trim().toLowerCase() || "unknown";
+	const peerId = ((params.peerId ?? "").trim() || "unknown").toLowerCase();
+	return `agent:${normalizeAgentId(params.agentId)}:${channel}:${peerKind}:${peerId}`;
+}
+function resolveLinkedPeerId(params) {
+	const identityLinks = params.identityLinks;
+	if (!identityLinks) return null;
+	const peerId = params.peerId.trim();
+	if (!peerId) return null;
+	const candidates = /* @__PURE__ */ new Set();
+	const rawCandidate = normalizeToken(peerId);
+	if (rawCandidate) candidates.add(rawCandidate);
+	const channel = normalizeToken(params.channel);
+	if (channel) {
+		const scopedCandidate = normalizeToken(`${channel}:${peerId}`);
+		if (scopedCandidate) candidates.add(scopedCandidate);
+	}
+	if (candidates.size === 0) return null;
+	for (const [canonical, ids] of Object.entries(identityLinks)) {
+		const canonicalName = canonical.trim();
+		if (!canonicalName) continue;
+		if (!Array.isArray(ids)) continue;
+		for (const id of ids) {
+			const normalized = normalizeToken(id);
+			if (normalized && candidates.has(normalized)) return canonicalName;
+		}
+	}
+	return null;
+}
+function buildGroupHistoryKey(params) {
+	const channel = normalizeToken(params.channel) || "unknown";
+	const accountId = normalizeAccountId(params.accountId);
+	const peerId = params.peerId.trim().toLowerCase() || "unknown";
+	return `${channel}:${accountId}:${params.peerKind}:${peerId}`;
+}
+function resolveThreadSessionKeys(params) {
+	const threadId = (params.threadId ?? "").trim();
+	if (!threadId) return {
+		sessionKey: params.baseSessionKey,
+		parentSessionKey: void 0
+	};
+	const normalizedThreadId = threadId.toLowerCase();
+	return {
+		sessionKey: params.useSuffix ?? true ? `${params.baseSessionKey}:thread:${normalizedThreadId}` : params.baseSessionKey,
+		parentSessionKey: params.parentSessionKey
+	};
+}
+
+//#endregion
 //#region src/infra/openclaw-root.ts
 const CORE_PACKAGE_NAMES = new Set(["openclaw"]);
 async function readPackageName(dir) {
@@ -53,6 +217,10 @@ function findPackageRootSync(startDir, maxDepth = 12) {
 function candidateDirsFromArgv1(argv1) {
 	const normalized = path.resolve(argv1);
 	const candidates = [path.dirname(normalized)];
+	try {
+		const resolved = fs$1.realpathSync(normalized);
+		if (resolved !== normalized) candidates.push(path.dirname(resolved));
+	} catch {}
 	const parts = normalized.split(path.sep);
 	const binIndex = parts.lastIndexOf(".bin");
 	if (binIndex > 0 && parts[binIndex - 1] === "node_modules") {
@@ -139,6 +307,8 @@ const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
 const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
 const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
 const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
+const workspaceTemplateCache = /* @__PURE__ */ new Map();
+let gitAvailabilityPromise = null;
 function stripFrontMatter(content) {
 	if (!content.startsWith("---")) return content;
 	const endIndex = content.indexOf("\n---", 3);
@@ -149,12 +319,23 @@ function stripFrontMatter(content) {
 	return trimmed;
 }
 async function loadTemplate(name) {
-	const templateDir = await resolveWorkspaceTemplateDir();
-	const templatePath = path.join(templateDir, name);
+	const cached = workspaceTemplateCache.get(name);
+	if (cached) return cached;
+	const pending = (async () => {
+		const templateDir = await resolveWorkspaceTemplateDir();
+		const templatePath = path.join(templateDir, name);
+		try {
+			return stripFrontMatter(await fs.readFile(templatePath, "utf-8"));
+		} catch {
+			throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
+		}
+	})();
+	workspaceTemplateCache.set(name, pending);
 	try {
-		return stripFrontMatter(await fs.readFile(templatePath, "utf-8"));
-	} catch {
-		throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
+		return await pending;
+	} catch (error) {
+		workspaceTemplateCache.delete(name);
+		throw error;
 	}
 }
 async function writeFileIfMissing(filePath, content) {
@@ -176,11 +357,15 @@ async function hasGitRepo(dir) {
 	}
 }
 async function isGitAvailable() {
-	try {
-		return (await runCommandWithTimeout(["git", "--version"], { timeoutMs: 2e3 })).code === 0;
-	} catch {
-		return false;
-	}
+	if (gitAvailabilityPromise) return gitAvailabilityPromise;
+	gitAvailabilityPromise = (async () => {
+		try {
+			return (await runCommandWithTimeout(["git", "--version"], { timeoutMs: 2e3 })).code === 0;
+		} catch {
+			return false;
+		}
+	})();
+	return gitAvailabilityPromise;
 }
 async function ensureGitRepo(dir, isBrandNewWorkspace) {
 	if (!isBrandNewWorkspace) return;
@@ -439,4 +624,4 @@ function resolveAgentDir(cfg, agentId) {
 }
 
 //#endregion
-export { resolveOpenClawPackageRootSync as C, resolveOpenClawPackageRoot as S, DEFAULT_TOOLS_FILENAME as _, resolveAgentModelPrimary as a, filterBootstrapFilesForSession as b, resolveDefaultAgentId as c, DEFAULT_AGENTS_FILENAME as d, DEFAULT_AGENT_WORKSPACE_DIR as f, DEFAULT_SOUL_FILENAME as g, DEFAULT_IDENTITY_FILENAME as h, resolveAgentModelFallbacksOverride as i, resolveSessionAgentId as l, DEFAULT_HEARTBEAT_FILENAME as m, resolveAgentConfig as n, resolveAgentSkillsFilter as o, DEFAULT_BOOTSTRAP_FILENAME as p, resolveAgentDir as r, resolveAgentWorkspaceDir as s, listAgentIds as t, resolveSessionAgentIds as u, DEFAULT_USER_FILENAME as v, loadWorkspaceBootstrapFiles as x, ensureAgentWorkspace as y };
+export { classifySessionKeyShape as A, resolveThreadParentSessionKey as B, resolveOpenClawPackageRootSync as C, buildAgentMainSessionKey as D, DEFAULT_MAIN_KEY as E, resolveThreadSessionKeys as F, sanitizeAgentId as I, isAcpSessionKey as L, normalizeAgentId as M, normalizeMainKey as N, buildAgentPeerSessionKey as O, resolveAgentIdFromSessionKey as P, isSubagentSessionKey as R, resolveOpenClawPackageRoot as S, DEFAULT_AGENT_ID as T, DEFAULT_TOOLS_FILENAME as _, resolveAgentModelPrimary as a, filterBootstrapFilesForSession as b, resolveDefaultAgentId as c, DEFAULT_AGENTS_FILENAME as d, DEFAULT_AGENT_WORKSPACE_DIR as f, DEFAULT_SOUL_FILENAME as g, DEFAULT_IDENTITY_FILENAME as h, resolveAgentModelFallbacksOverride as i, normalizeAccountId as j, buildGroupHistoryKey as k, resolveSessionAgentId as l, DEFAULT_HEARTBEAT_FILENAME as m, resolveAgentConfig as n, resolveAgentSkillsFilter as o, DEFAULT_BOOTSTRAP_FILENAME as p, resolveAgentDir as r, resolveAgentWorkspaceDir as s, listAgentIds as t, resolveSessionAgentIds as u, DEFAULT_USER_FILENAME as v, DEFAULT_ACCOUNT_ID as w, loadWorkspaceBootstrapFiles as x, ensureAgentWorkspace as y, parseAgentSessionKey as z };

package/dist/{agent-scope-DnyDZ5RH.js → agent-scope-GYIs5dyU.js}

@@ -1,8 +1,8 @@
 import { g as resolveStateDir, y as resolveRequiredHomeDir } from "./paths-DVBShlw6.js";
-import { b as resolveUserPath, g as pathExists } from "./utils-BTaR--Ln.js";
+import { b as resolveUserPath, g as pathExists } from "./utils-BtIMES3N.js";
 import { l as normalizeAgentId, n as DEFAULT_AGENT_ID, v as isSubagentSessionKey, y as parseAgentSessionKey } from "./session-key-BWxPj0z_.js";
-import { t as runCommandWithTimeout } from "./exec-DFOtZbI0.js";
-import { t as resolveOpenClawPackageRoot } from "./openclaw-root-93W6UrUK.js";
+import { t as runCommandWithTimeout } from "./exec-BPQSKwGa.js";
+import { t as resolveOpenClawPackageRoot } from "./openclaw-root-CEnmuBUN.js";
 import { fileURLToPath } from "node:url";
 import os from "node:os";
 import path from "node:path";
@@ -61,6 +61,8 @@ const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
 const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
 const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
 const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
+const workspaceTemplateCache = /* @__PURE__ */ new Map();
+let gitAvailabilityPromise = null;
 function stripFrontMatter(content) {
 	if (!content.startsWith("---")) return content;
 	const endIndex = content.indexOf("\n---", 3);
@@ -71,12 +73,23 @@ function stripFrontMatter(content) {
 	return trimmed;
 }
 async function loadTemplate(name) {
-	const templateDir = await resolveWorkspaceTemplateDir();
-	const templatePath = path.join(templateDir, name);
+	const cached = workspaceTemplateCache.get(name);
+	if (cached) return cached;
+	const pending = (async () => {
+		const templateDir = await resolveWorkspaceTemplateDir();
+		const templatePath = path.join(templateDir, name);
+		try {
+			return stripFrontMatter(await fs.readFile(templatePath, "utf-8"));
+		} catch {
+			throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
+		}
+	})();
+	workspaceTemplateCache.set(name, pending);
 	try {
-		return stripFrontMatter(await fs.readFile(templatePath, "utf-8"));
-	} catch {
-		throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
+		return await pending;
+	} catch (error) {
+		workspaceTemplateCache.delete(name);
+		throw error;
 	}
 }
 async function writeFileIfMissing(filePath, content) {
@@ -98,11 +111,15 @@ async function hasGitRepo(dir) {
 	}
 }
 async function isGitAvailable() {
-	try {
-		return (await runCommandWithTimeout(["git", "--version"], { timeoutMs: 2e3 })).code === 0;
-	} catch {
-		return false;
-	}
+	if (gitAvailabilityPromise) return gitAvailabilityPromise;
+	gitAvailabilityPromise = (async () => {
+		try {
+			return (await runCommandWithTimeout(["git", "--version"], { timeoutMs: 2e3 })).code === 0;
+		} catch {
+			return false;
+		}
+	})();
+	return gitAvailabilityPromise;
 }
 async function ensureGitRepo(dir, isBrandNewWorkspace) {
 	if (!isBrandNewWorkspace) return;

package/dist/{agent-scope-Dpav7C-i.js → agent-scope-okUOVjE5.js}

@@ -1,5 +1,5 @@
 import { s as resolveStateDir, u as resolveRequiredHomeDir } from "./paths-rb94mUrR.js";
-import { F as pathExists, R as resolveUserPath, t as runCommandWithTimeout } from "./exec-Bas1hoSJ.js";
+import { F as pathExists, R as resolveUserPath, t as runCommandWithTimeout } from "./exec-EKUaAU91.js";
 import path from "node:path";
 import fs from "node:fs";
 import os from "node:os";
@@ -217,6 +217,10 @@ function findPackageRootSync(startDir, maxDepth = 12) {
 function candidateDirsFromArgv1(argv1) {
 	const normalized = path.resolve(argv1);
 	const candidates = [path.dirname(normalized)];
+	try {
+		const resolved = fs.realpathSync(normalized);
+		if (resolved !== normalized) candidates.push(path.dirname(resolved));
+	} catch {}
 	const parts = normalized.split(path.sep);
 	const binIndex = parts.lastIndexOf(".bin");
 	if (binIndex > 0 && parts[binIndex - 1] === "node_modules") {
@@ -303,6 +307,8 @@ const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
 const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
 const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
 const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
+const workspaceTemplateCache = /* @__PURE__ */ new Map();
+let gitAvailabilityPromise = null;
 function stripFrontMatter(content) {
 	if (!content.startsWith("---")) return content;
 	const endIndex = content.indexOf("\n---", 3);
@@ -313,12 +319,23 @@ function stripFrontMatter(content) {
 	return trimmed;
 }
 async function loadTemplate(name) {
-	const templateDir = await resolveWorkspaceTemplateDir();
-	const templatePath = path.join(templateDir, name);
+	const cached = workspaceTemplateCache.get(name);
+	if (cached) return cached;
+	const pending = (async () => {
+		const templateDir = await resolveWorkspaceTemplateDir();
+		const templatePath = path.join(templateDir, name);
+		try {
+			return stripFrontMatter(await fs$1.readFile(templatePath, "utf-8"));
+		} catch {
+			throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
+		}
+	})();
+	workspaceTemplateCache.set(name, pending);
 	try {
-		return stripFrontMatter(await fs$1.readFile(templatePath, "utf-8"));
-	} catch {
-		throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
+		return await pending;
+	} catch (error) {
+		workspaceTemplateCache.delete(name);
+		throw error;
 	}
 }
 async function writeFileIfMissing(filePath, content) {
@@ -340,11 +357,15 @@ async function hasGitRepo(dir) {
 	}
 }
 async function isGitAvailable() {
-	try {
-		return (await runCommandWithTimeout(["git", "--version"], { timeoutMs: 2e3 })).code === 0;
-	} catch {
-		return false;
-	}
+	if (gitAvailabilityPromise) return gitAvailabilityPromise;
+	gitAvailabilityPromise = (async () => {
+		try {
+			return (await runCommandWithTimeout(["git", "--version"], { timeoutMs: 2e3 })).code === 0;
+		} catch {
+			return false;
+		}
+	})();
+	return gitAvailabilityPromise;
 }
 async function ensureGitRepo(dir, isBrandNewWorkspace) {
 	if (!isBrandNewWorkspace) return;

package/dist/audio-preflight-B0kLz-Ma.js

@@ -0,0 +1,60 @@
+import "./paths-BZtyHNCi.js";
+import "./agent-scope-DASgjz2_.js";
+import { Y as logVerbose, Z as shouldLogVerbose } from "./exec-_PSUrMP8.js";
+import "./pi-embedded-helpers-ZI1UCSRM.js";
+import "./model-auth-BvODRbV0.js";
+import "./config-D8pgDSNo.js";
+import "./github-copilot-token-DatTe1w-.js";
+import "./pi-model-discovery-DqgqUyAv.js";
+import "./chrome-n_3rtK2c.js";
+import "./paths-SFzVNGbc.js";
+import "./image-bodq5cUH.js";
+import "./redact-BrXLgslJ.js";
+import "./fetch-Dm-nCwa_.js";
+import { a as runCapability, l as isAudioAttachment, n as createMediaAttachmentCache, r as normalizeMediaAttachments, t as buildProviderRegistry } from "./runner-B7CKBC80.js";
+
+//#region src/media-understanding/audio-preflight.ts
+/**
+* Transcribes the first audio attachment BEFORE mention checking.
+* This allows voice notes to be processed in group chats with requireMention: true.
+* Returns the transcript or undefined if transcription fails or no audio is found.
+*/
+async function transcribeFirstAudio(params) {
+	const { ctx, cfg } = params;
+	const audioConfig = cfg.tools?.media?.audio;
+	if (!audioConfig || audioConfig.enabled === false) return;
+	const attachments = normalizeMediaAttachments(ctx);
+	if (!attachments || attachments.length === 0) return;
+	const firstAudio = attachments.find((att) => att && isAudioAttachment(att) && !att.alreadyTranscribed);
+	if (!firstAudio) return;
+	if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribing attachment ${firstAudio.index} for mention check`);
+	const providerRegistry = buildProviderRegistry(params.providers);
+	const cache = createMediaAttachmentCache(attachments);
+	try {
+		const result = await runCapability({
+			capability: "audio",
+			cfg,
+			ctx,
+			attachments: cache,
+			media: attachments,
+			agentDir: params.agentDir,
+			providerRegistry,
+			config: audioConfig,
+			activeModel: params.activeModel
+		});
+		if (!result || result.outputs.length === 0) return;
+		const audioOutput = result.outputs.find((output) => output.kind === "audio.transcription");
+		if (!audioOutput || !audioOutput.text) return;
+		firstAudio.alreadyTranscribed = true;
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribed ${audioOutput.text.length} chars from attachment ${firstAudio.index}`);
+		return audioOutput.text;
+	} catch (err) {
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcription failed: ${String(err)}`);
+		return;
+	} finally {
+		await cache.cleanup();
+	}
+}
+
+//#endregion
+export { transcribeFirstAudio };

package/dist/audio-preflight-BCs_J33s.js

@@ -0,0 +1,60 @@
+import "./paths-rb94mUrR.js";
+import "./agent-scope-okUOVjE5.js";
+import { J as logVerbose, X as shouldLogVerbose } from "./exec-EKUaAU91.js";
+import "./model-selection-vC82fEiP.js";
+import "./github-copilot-token-c9Igt3ZH.js";
+import "./pi-embedded-helpers-D0mqOwwq.js";
+import "./config-7NCznPmF.js";
+import "./pi-model-discovery-EhM2JAQo.js";
+import "./chrome-Bx24uq7B.js";
+import "./paths-DWYi0R_2.js";
+import "./image-BaJKrmCs.js";
+import "./redact-BIMJ3ntQ.js";
+import "./fetch-Bz1WxfzV.js";
+import { a as runCapability, l as isAudioAttachment, n as createMediaAttachmentCache, r as normalizeMediaAttachments, t as buildProviderRegistry } from "./runner-Bv0BmJPF.js";
+
+//#region src/media-understanding/audio-preflight.ts
+/**
+* Transcribes the first audio attachment BEFORE mention checking.
+* This allows voice notes to be processed in group chats with requireMention: true.
+* Returns the transcript or undefined if transcription fails or no audio is found.
+*/
+async function transcribeFirstAudio(params) {
+	const { ctx, cfg } = params;
+	const audioConfig = cfg.tools?.media?.audio;
+	if (!audioConfig || audioConfig.enabled === false) return;
+	const attachments = normalizeMediaAttachments(ctx);
+	if (!attachments || attachments.length === 0) return;
+	const firstAudio = attachments.find((att) => att && isAudioAttachment(att) && !att.alreadyTranscribed);
+	if (!firstAudio) return;
+	if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribing attachment ${firstAudio.index} for mention check`);
+	const providerRegistry = buildProviderRegistry(params.providers);
+	const cache = createMediaAttachmentCache(attachments);
+	try {
+		const result = await runCapability({
+			capability: "audio",
+			cfg,
+			ctx,
+			attachments: cache,
+			media: attachments,
+			agentDir: params.agentDir,
+			providerRegistry,
+			config: audioConfig,
+			activeModel: params.activeModel
+		});
+		if (!result || result.outputs.length === 0) return;
+		const audioOutput = result.outputs.find((output) => output.kind === "audio.transcription");
+		if (!audioOutput || !audioOutput.text) return;
+		firstAudio.alreadyTranscribed = true;
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribed ${audioOutput.text.length} chars from attachment ${firstAudio.index}`);
+		return audioOutput.text;
+	} catch (err) {
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcription failed: ${String(err)}`);
+		return;
+	} finally {
+		await cache.cleanup();
+	}
+}
+
+//#endregion
+export { transcribeFirstAudio };

package/dist/audio-preflight-CTl2RCyF.js

@@ -0,0 +1,71 @@
+import { S as logVerbose, T as shouldLogVerbose } from "./entry.js";
+import "./auth-profiles-Cp9MtUdM.js";
+import "./utils-BLJAc3ZV.js";
+import "./exec-DqZFMawz.js";
+import "./agent-scope-Bkr9fZtl.js";
+import "./github-copilot-token-C9W4SY9o.js";
+import "./pi-model-discovery-EhM2JAQo.js";
+import "./config-B8v0zg48.js";
+import "./manifest-registry-CVsqjgX0.js";
+import "./server-context-FwqBRH3K.js";
+import "./chrome--Fe8F5Kf.js";
+import "./message-channel-DWcu72r7.js";
+import "./plugins-CxrdL_IZ.js";
+import "./logging-D-Jq2wIo.js";
+import "./accounts-Bvh0DFxS.js";
+import "./paths-BZK4Ct0I.js";
+import "./redact-UvkXqguc.js";
+import "./routes-CaCvio4Q.js";
+import "./pi-embedded-helpers-DpJb0kUk.js";
+import "./fetch-wuOZDzdT.js";
+import "./sandbox-DNHDwHw8.js";
+import "./skills-CE7by2IF.js";
+import "./image-D-5pUELC.js";
+import "./tool-display-DbdMQFZx.js";
+import { a as runCapability, n as createMediaAttachmentCache, o as isAudioAttachment, r as normalizeMediaAttachments, t as buildProviderRegistry } from "./runner-BEy5ZGFv.js";
+
+//#region src/media-understanding/audio-preflight.ts
+/**
+* Transcribes the first audio attachment BEFORE mention checking.
+* This allows voice notes to be processed in group chats with requireMention: true.
+* Returns the transcript or undefined if transcription fails or no audio is found.
+*/
+async function transcribeFirstAudio(params) {
+	const { ctx, cfg } = params;
+	const audioConfig = cfg.tools?.media?.audio;
+	if (!audioConfig || audioConfig.enabled === false) return;
+	const attachments = normalizeMediaAttachments(ctx);
+	if (!attachments || attachments.length === 0) return;
+	const firstAudio = attachments.find((att) => att && isAudioAttachment(att) && !att.alreadyTranscribed);
+	if (!firstAudio) return;
+	if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribing attachment ${firstAudio.index} for mention check`);
+	const providerRegistry = buildProviderRegistry(params.providers);
+	const cache = createMediaAttachmentCache(attachments);
+	try {
+		const result = await runCapability({
+			capability: "audio",
+			cfg,
+			ctx,
+			attachments: cache,
+			media: attachments,
+			agentDir: params.agentDir,
+			providerRegistry,
+			config: audioConfig,
+			activeModel: params.activeModel
+		});
+		if (!result || result.outputs.length === 0) return;
+		const audioOutput = result.outputs.find((output) => output.kind === "audio.transcription");
+		if (!audioOutput || !audioOutput.text) return;
+		firstAudio.alreadyTranscribed = true;
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribed ${audioOutput.text.length} chars from attachment ${firstAudio.index}`);
+		return audioOutput.text;
+	} catch (err) {
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcription failed: ${String(err)}`);
+		return;
+	} finally {
+		await cache.cleanup();
+	}
+}
+
+//#endregion
+export { transcribeFirstAudio };

package/dist/audio-preflight-MhF6YlAY.js

@@ -0,0 +1,74 @@
+import "./paths-DVBShlw6.js";
+import { A as logVerbose, N as shouldLogVerbose } from "./subsystem-DHfJG4gk.js";
+import "./utils-BtIMES3N.js";
+import "./pi-embedded-helpers-BrUBxrE2.js";
+import "./exec-BPQSKwGa.js";
+import "./agent-scope-GYIs5dyU.js";
+import "./model-selection-B53OvWCf.js";
+import "./github-copilot-token-CiF5Iyi2.js";
+import "./boolean-BgXe2hyu.js";
+import "./env-BUuSkE19.js";
+import "./config-CeWMHOiQ.js";
+import "./manifest-registry-jeAPx6AW.js";
+import "./plugins-CTjLu-z-.js";
+import "./sandbox-BAChxjC5.js";
+import { a as runCapability, l as isAudioAttachment, n as createMediaAttachmentCache, r as normalizeMediaAttachments, t as buildProviderRegistry } from "./runner-ChqVEgPx.js";
+import "./image-TvL5YI_W.js";
+import "./pi-model-discovery-EwKVHlZB.js";
+import "./chrome-BWeMtFGf.js";
+import "./skills-Dz15dAM4.js";
+import "./routes-Cpfxk96k.js";
+import "./server-context-RY7lRaxl.js";
+import "./message-channel-CTtrEkmW.js";
+import "./logging-fywhKCmE.js";
+import "./accounts-54zZMYCo.js";
+import "./paths-DdKf4lHp.js";
+import "./redact-BRsnXqwD.js";
+import "./tool-display-kpW5Hg2z.js";
+import "./fetch-D2O8s8I1.js";
+
+//#region src/media-understanding/audio-preflight.ts
+/**
+* Transcribes the first audio attachment BEFORE mention checking.
+* This allows voice notes to be processed in group chats with requireMention: true.
+* Returns the transcript or undefined if transcription fails or no audio is found.
+*/
+async function transcribeFirstAudio(params) {
+	const { ctx, cfg } = params;
+	const audioConfig = cfg.tools?.media?.audio;
+	if (!audioConfig || audioConfig.enabled === false) return;
+	const attachments = normalizeMediaAttachments(ctx);
+	if (!attachments || attachments.length === 0) return;
+	const firstAudio = attachments.find((att) => att && isAudioAttachment(att) && !att.alreadyTranscribed);
+	if (!firstAudio) return;
+	if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribing attachment ${firstAudio.index} for mention check`);
+	const providerRegistry = buildProviderRegistry(params.providers);
+	const cache = createMediaAttachmentCache(attachments);
+	try {
+		const result = await runCapability({
+			capability: "audio",
+			cfg,
+			ctx,
+			attachments: cache,
+			media: attachments,
+			agentDir: params.agentDir,
+			providerRegistry,
+			config: audioConfig,
+			activeModel: params.activeModel
+		});
+		if (!result || result.outputs.length === 0) return;
+		const audioOutput = result.outputs.find((output) => output.kind === "audio.transcription");
+		if (!audioOutput || !audioOutput.text) return;
+		firstAudio.alreadyTranscribed = true;
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcribed ${audioOutput.text.length} chars from attachment ${firstAudio.index}`);
+		return audioOutput.text;
+	} catch (err) {
+		if (shouldLogVerbose()) logVerbose(`audio-preflight: transcription failed: ${String(err)}`);
+		return;
+	} finally {
+		await cache.cleanup();
+	}
+}
+
+//#endregion
+export { transcribeFirstAudio };