@symerian/symi 2.6.9 → 2.6.11

package/dist/{skills-Bs0AW1g3.js → skills-CGHRETGF.js}

@@ -1,13 +1,13 @@
-import { I as resolveUserPath, S as CONFIG_DIR } from "./registry-DYq1AYOv.js";
-import { f as normalizeSkillFilter } from "./agent-scope-CpEJ0B88.js";
-import { t as createSubsystemLogger } from "./subsystem-BjyjJF-d.js";
-import { h as resolveSymiPackageRootSync } from "./workspace-DscDraUb.js";
-import { c as resolveMemorySlotDecision, d as isDangerousHostEnvVarName, o as normalizePluginsConfig, s as resolveEnableState, t as loadPluginManifestRegistry } from "./manifest-registry-yb7sAlu4.js";
-import { a as resolveSymiManifestBlock, c as resolveSymiManifestRequires, d as hasBinary, f as isConfigPathTruthyWithDefaults, i as parseSymiManifestInstallBase, l as parseFrontmatterBlock, n as normalizeStringList, o as resolveSymiManifestInstall, p as resolveRuntimePlatform, r as parseFrontmatterBool, s as resolveSymiManifestOs, t as getFrontmatterString, u as evaluateRuntimeRequires } from "./frontmatter-CTR5f_Ez.js";
+import { I as resolveUserPath, S as CONFIG_DIR } from "./registry-UkL38jvt.js";
+import { f as normalizeSkillFilter } from "./agent-scope-D68_xfTL.js";
+import { t as createSubsystemLogger } from "./subsystem-DN75fnEF.js";
+import { h as resolveSymiPackageRootSync } from "./workspace-DqJ5h-ZB.js";
+import { c as resolveMemorySlotDecision, d as isDangerousHostEnvVarName, o as normalizePluginsConfig, s as resolveEnableState, t as loadPluginManifestRegistry } from "./manifest-registry-0J48biqr.js";
+import { a as resolveSymiManifestBlock, c as resolveSymiManifestRequires, d as hasBinary, f as isConfigPathTruthyWithDefaults, i as parseSymiManifestInstallBase, l as parseFrontmatterBlock, n as normalizeStringList, o as resolveSymiManifestInstall, p as resolveRuntimePlatform, r as parseFrontmatterBool, s as resolveSymiManifestOs, t as getFrontmatterString, u as evaluateRuntimeRequires } from "./frontmatter-CV0YkjoY.js";
 import path from "node:path";
-import fs from "node:fs";
+import fsSync from "node:fs";
 import os from "node:os";
-import fs$1 from "node:fs/promises";
+import fs from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { formatSkillsForPrompt, loadSkillsFromDir } from "@mariozechner/pi-coding-agent";
 
@@ -391,7 +391,7 @@ async function assertNoSymlinkEscape(relative, root, options) {
 		const isLast = idx === parts.length - 1;
 		current = path.join(current, part);
 		try {
-			if ((await fs$1.lstat(current)).isSymbolicLink()) {
+			if ((await fs.lstat(current)).isSymbolicLink()) {
 				if (options?.allowFinalSymlink && isLast) return;
 				const target = await tryRealpath(current);
 				if (!isPathInside(rootReal, target)) throw new Error(`Symlink escapes sandbox root (${shortPath(rootReal)}): ${shortPath(current)}`);
@@ -405,7 +405,7 @@ async function assertNoSymlinkEscape(relative, root, options) {
 }
 async function tryRealpath(value) {
 	try {
-		return await fs$1.realpath(value);
+		return await fs.realpath(value);
 	} catch {
 		return path.resolve(value);
 	}
@@ -424,13 +424,13 @@ function shortPath(value) {
 //#region src/agents/skills/bundled-dir.ts
 function looksLikeSkillsDir(dir) {
 	try {
-		const entries = fs.readdirSync(dir, { withFileTypes: true });
+		const entries = fsSync.readdirSync(dir, { withFileTypes: true });
 		for (const entry of entries) {
 			if (entry.name.startsWith(".")) continue;
 			const fullPath = path.join(dir, entry.name);
 			if (entry.isFile() && entry.name.endsWith(".md")) return true;
 			if (entry.isDirectory()) {
-				if (fs.existsSync(path.join(fullPath, "SKILL.md"))) return true;
+				if (fsSync.existsSync(path.join(fullPath, "SKILL.md"))) return true;
 			}
 		}
 	} catch {
@@ -445,7 +445,7 @@ function resolveBundledSkillsDir(opts = {}) {
 		const execPath = opts.execPath ?? process.execPath;
 		const execDir = path.dirname(execPath);
 		const sibling = path.join(execDir, "skills");
-		if (fs.existsSync(sibling)) return sibling;
+		if (fsSync.existsSync(sibling)) return sibling;
 	} catch {}
 	try {
 		const moduleUrl = opts.moduleUrl ?? import.meta.url;
@@ -501,7 +501,7 @@ function resolvePluginSkillDirs(params) {
 			const trimmed = raw.trim();
 			if (!trimmed) continue;
 			const candidate = path.resolve(record.rootDir, trimmed);
-			if (!fs.existsSync(candidate)) {
+			if (!fsSync.existsSync(candidate)) {
 				log.warn(`plugin skill path not found (${record.id}): ${candidate}`);
 				continue;
 			}
@@ -528,7 +528,7 @@ async function serializeByKey(key, task) {
 
 //#endregion
 //#region src/agents/skills/workspace.ts
-const fsp = fs.promises;
+const fsp = fsSync.promises;
 const skillsLogger = createSubsystemLogger("skills");
 const skillCommandDebugOnce = /* @__PURE__ */ new Set();
 /**
@@ -605,7 +605,7 @@ function resolveSkillsLimits(config) {
 }
 function listChildDirectories(dir) {
 	try {
-		const entries = fs.readdirSync(dir, { withFileTypes: true });
+		const entries = fsSync.readdirSync(dir, { withFileTypes: true });
 		const dirs = [];
 		for (const entry of entries) {
 			if (entry.name.startsWith(".")) continue;
@@ -616,7 +616,7 @@ function listChildDirectories(dir) {
 				continue;
 			}
 			if (entry.isSymbolicLink()) try {
-				if (fs.statSync(fullPath).isDirectory()) dirs.push(entry.name);
+				if (fsSync.statSync(fullPath).isDirectory()) dirs.push(entry.name);
 			} catch {}
 		}
 		return dirs;
@@ -627,7 +627,7 @@ function listChildDirectories(dir) {
 function resolveNestedSkillsRoot(dir, opts) {
 	const nested = path.join(dir, "skills");
 	try {
-		if (!fs.existsSync(nested) || !fs.statSync(nested).isDirectory()) return { baseDir: dir };
+		if (!fsSync.existsSync(nested) || !fsSync.statSync(nested).isDirectory()) return { baseDir: dir };
 	} catch {
 		return { baseDir: dir };
 	}
@@ -636,7 +636,7 @@ function resolveNestedSkillsRoot(dir, opts) {
 	const toScan = scanLimit === 0 ? [] : nestedDirs.slice(0, Math.min(nestedDirs.length, scanLimit));
 	for (const name of toScan) {
 		const skillMd = path.join(nested, name, "SKILL.md");
-		if (fs.existsSync(skillMd)) return {
+		if (fsSync.existsSync(skillMd)) return {
 			baseDir: nested,
 			note: `Detected nested skills root at ${nested}`
 		};
@@ -656,9 +656,9 @@ function loadSkillEntries(workspaceDir, opts) {
 	const loadSkills = (params) => {
 		const baseDir = resolveNestedSkillsRoot(params.dir, { maxEntriesToScan: limits.maxCandidatesPerRoot }).baseDir;
 		const rootSkillMd = path.join(baseDir, "SKILL.md");
-		if (fs.existsSync(rootSkillMd)) {
+		if (fsSync.existsSync(rootSkillMd)) {
 			try {
-				const size = fs.statSync(rootSkillMd).size;
+				const size = fsSync.statSync(rootSkillMd).size;
 				if (size > limits.maxSkillFileBytes) {
 					skillsLogger.warn("Skipping skills root due to oversized SKILL.md.", {
 						dir: baseDir,
@@ -697,9 +697,9 @@ function loadSkillEntries(workspaceDir, opts) {
 		for (const name of limitedChildren) {
 			const skillDir = path.join(baseDir, name);
 			const skillMd = path.join(skillDir, "SKILL.md");
-			if (!fs.existsSync(skillMd)) continue;
+			if (!fsSync.existsSync(skillMd)) continue;
 			try {
-				const size = fs.statSync(skillMd).size;
+				const size = fsSync.statSync(skillMd).size;
 				if (size > limits.maxSkillFileBytes) {
 					skillsLogger.warn("Skipping skill due to oversized SKILL.md.", {
 						skill: name,
@@ -767,7 +767,7 @@ function loadSkillEntries(workspaceDir, opts) {
 	return Array.from(merged.values()).map((skill) => {
 		let frontmatter = {};
 		try {
-			frontmatter = parseFrontmatter(fs.readFileSync(skill.filePath, "utf-8"));
+			frontmatter = parseFrontmatter(fsSync.readFileSync(skill.filePath, "utf-8"));
 		} catch {}
 		return {
 			skill,

package/dist/{sqlite-D_mz1_-y.js → sqlite-Bv87EXeg.js}

@@ -1,10 +1,10 @@
-import { t as createSubsystemLogger } from "./subsystem-BjyjJF-d.js";
-import { o as resolveSessionTranscriptsDirForAgent } from "./paths-CbQV9WEg.js";
+import { t as createSubsystemLogger } from "./subsystem-DN75fnEF.js";
+import { o as resolveSessionTranscriptsDirForAgent } from "./paths-DEuVuViW.js";
 import { t as redactSensitiveText } from "./redact-BDMXB06K.js";
 import { createRequire } from "node:module";
 import path from "node:path";
-import fs from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsSync from "node:fs";
+import fs from "node:fs/promises";
 import crypto from "node:crypto";
 
 //#region src/memory/fs-utils.ts
@@ -14,7 +14,7 @@ function isFileMissingError(err) {
 async function statRegularFile(absPath) {
 	let stat;
 	try {
-		stat = await fs$1.lstat(absPath);
+		stat = await fs.lstat(absPath);
 	} catch (err) {
 		if (isFileMissingError(err)) return { missing: true };
 		throw err;
@@ -71,7 +71,7 @@ async function runTasksWithConcurrency(params) {
 //#region src/memory/internal.ts
 function ensureDir(dir) {
 	try {
-		fs.mkdirSync(dir, { recursive: true });
+		fsSync.mkdirSync(dir, { recursive: true });
 	} catch {}
 	return dir;
 }
@@ -90,7 +90,7 @@ function isMemoryPath(relPath) {
 	return normalized.startsWith("memory/");
 }
 async function walkDir(dir, files) {
-	const entries = await fs$1.readdir(dir, { withFileTypes: true });
+	const entries = await fs.readdir(dir, { withFileTypes: true });
 	for (const entry of entries) {
 		const full = path.join(dir, entry.name);
 		if (entry.isSymbolicLink()) continue;
@@ -110,7 +110,7 @@ async function listMemoryFiles(workspaceDir, extraPaths) {
 	const memoryDir = path.join(workspaceDir, "memory");
 	const addMarkdownFile = async (absPath) => {
 		try {
-			const stat = await fs$1.lstat(absPath);
+			const stat = await fs.lstat(absPath);
 			if (stat.isSymbolicLink() || !stat.isFile()) return;
 			if (!absPath.endsWith(".md")) return;
 			result.push(absPath);
@@ -119,12 +119,12 @@ async function listMemoryFiles(workspaceDir, extraPaths) {
 	await addMarkdownFile(memoryFile);
 	await addMarkdownFile(altMemoryFile);
 	try {
-		const dirStat = await fs$1.lstat(memoryDir);
+		const dirStat = await fs.lstat(memoryDir);
 		if (!dirStat.isSymbolicLink() && dirStat.isDirectory()) await walkDir(memoryDir, result);
 	} catch {}
 	const normalizedExtraPaths = normalizeExtraMemoryPaths(workspaceDir, extraPaths);
 	if (normalizedExtraPaths.length > 0) for (const inputPath of normalizedExtraPaths) try {
-		const stat = await fs$1.lstat(inputPath);
+		const stat = await fs.lstat(inputPath);
 		if (stat.isSymbolicLink()) continue;
 		if (stat.isDirectory()) {
 			await walkDir(inputPath, result);
@@ -138,7 +138,7 @@ async function listMemoryFiles(workspaceDir, extraPaths) {
 	for (const entry of result) {
 		let key = entry;
 		try {
-			key = await fs$1.realpath(entry);
+			key = await fs.realpath(entry);
 		} catch {}
 		if (seen.has(key)) continue;
 		seen.add(key);
@@ -152,14 +152,14 @@ function hashText(value) {
 async function buildFileEntry(absPath, workspaceDir) {
 	let stat;
 	try {
-		stat = await fs$1.stat(absPath);
+		stat = await fs.stat(absPath);
 	} catch (err) {
 		if (isFileMissingError(err)) return null;
 		throw err;
 	}
 	let content;
 	try {
-		content = await fs$1.readFile(absPath, "utf-8");
+		content = await fs.readFile(absPath, "utf-8");
 	} catch (err) {
 		if (isFileMissingError(err)) return null;
 		throw err;
@@ -293,7 +293,7 @@ const log = createSubsystemLogger("memory");
 async function listSessionFilesForAgent(agentId) {
 	const dir = resolveSessionTranscriptsDirForAgent(agentId);
 	try {
-		return (await fs$1.readdir(dir, { withFileTypes: true })).filter((entry) => entry.isFile()).map((entry) => entry.name).filter((name) => name.endsWith(".jsonl")).map((name) => path.join(dir, name));
+		return (await fs.readdir(dir, { withFileTypes: true })).filter((entry) => entry.isFile()).map((entry) => entry.name).filter((name) => name.endsWith(".jsonl")).map((name) => path.join(dir, name));
 	} catch {
 		return [];
 	}
@@ -323,8 +323,8 @@ function extractSessionText(content) {
 }
 async function buildSessionEntry(absPath) {
 	try {
-		const stat = await fs$1.stat(absPath);
-		const lines = (await fs$1.readFile(absPath, "utf-8")).split("\n");
+		const stat = await fs.stat(absPath);
+		const lines = (await fs.readFile(absPath, "utf-8")).split("\n");
 		const collected = [];
 		const lineMap = [];
 		for (let jsonlIdx = 0; jsonlIdx < lines.length; jsonlIdx++) {

package/dist/{status-BV22IA25.js → status-BxNHXm7T.js}

@@ -1,4 +1,4 @@
-import { dt as createPluginLoaderLogger, ft as loadSymiPlugins } from "./reply-dzRBlsmK.js";
+import { dt as createPluginLoaderLogger, ft as loadSymiPlugins } from "./reply-4ilKYVzu.js";
 import { t as createSubsystemLogger } from "./subsystem-D9vIQve0.js";
 import { D as resolveDefaultAgentWorkspaceDir, c as resolveAgentWorkspaceDir, l as resolveDefaultAgentId } from "./agent-scope-CgUHAtCo.js";
 import { i as loadConfig } from "./config-CHwyw6l5.js";

package/dist/{status-DOB2UmDg.js → status-CRCD2RpZ.js}

@@ -9,7 +9,7 @@ import { c as resolveAgentWorkspaceDir } from "./agent-scope-D-jRCY0d.js";
 import { t as buildWorkspaceSkillStatus } from "./skills-status-DKXJ-tbi.js";
 import { H as VERSION, i as loadConfig, o as readConfigFileSnapshot } from "./config-DHBLS1Hl.js";
 import { n as callGateway, t as buildGatewayConnectionDetails } from "./call-BcE47FtD.js";
-import { En as peekSystemEvents, St as summarizeRestartSentinel, cn as buildChannelAccountSnapshot, in as formatUsageReportLines, ln as formatChannelAllowFrom, nt as sha256HexPrefix, rn as loadProviderUsageSummary, sn as buildChannelSummary, xt as readRestartSentinel } from "./subagent-registry-DEdqc42m.js";
+import { En as peekSystemEvents, St as summarizeRestartSentinel, cn as buildChannelAccountSnapshot, in as formatUsageReportLines, ln as formatChannelAllowFrom, nt as sha256HexPrefix, rn as loadProviderUsageSummary, sn as buildChannelSummary, xt as readRestartSentinel } from "./subagent-registry-7wPEZQKK.js";
 import { F as resolveMainSessionKey, j as resolveFreshSessionTotalTokens, o as loadSessionStore } from "./sessions-CJXnZVjR.js";
 import { n as listChannelPlugins } from "./plugins-CwSlLxM8.js";
 import { o as getTailnetHostname, s as readTailscaleStatusJson } from "./tailscale-CbbvYNVw.js";
@@ -29,7 +29,7 @@ import { t as formatRuntimeStatusWithDetails } from "./runtime-status-hFVEC3wO.j
 import { t as readLastGatewayErrorLine } from "./diagnostics-CS1ov_hH.js";
 import { t as renderTable } from "./table-D01d2GuY.js";
 import { a as resolveGatewayProbeAuth$1, c as probeGateway, t as runSecurityAudit } from "./audit-Byo5jCLN.js";
-import { o as resolveHeartbeatSummaryForAgent, t as formatHealthChannelLines } from "./health-BxPSqsO6.js";
+import { o as resolveHeartbeatSummaryForAgent, t as formatHealthChannelLines } from "./health-BiipZUOd.js";
 import { g as resolveUpdateChannelDisplay, i as formatGitInstallLabel, m as normalizeUpdateChannel, t as checkUpdateStatus } from "./update-check-ZdimP1aU.js";
 import { t as resolveNodeService } from "./node-service-fcZExd22.js";
 import { n as redactSecrets, t as formatGatewayAuthUsed } from "./format-DVLB9DNB.js";

package/dist/{status-Bxkdy4Dq.js → status-DNJBoKuu.js}

@@ -1,7 +1,7 @@
 import { o as createSubsystemLogger } from "./entry.js";
 import { D as resolveDefaultAgentWorkspaceDir, c as resolveAgentWorkspaceDir, l as resolveDefaultAgentId } from "./agent-scope-D-jRCY0d.js";
 import { i as loadConfig } from "./config-DHBLS1Hl.js";
-import { m as loadSymiPlugins, p as createPluginLoaderLogger } from "./subagent-registry-DEdqc42m.js";
+import { m as loadSymiPlugins, p as createPluginLoaderLogger } from "./subagent-registry-7wPEZQKK.js";
 
 //#region src/plugins/status.ts
 const log = createSubsystemLogger("plugins");

package/dist/{status-BxfE61b4.js → status-DOCg6R55.js}

@@ -1,6 +1,6 @@
 import { u as resolveGatewayPort } from "./paths-Cqn-zk3M.js";
 import { B as theme, k as info, z as isRich } from "./utils-B-0b9bGM.js";
-import { B as summarizeRestartSentinel, Jt as sha256HexPrefix, _t as formatUsageReportLines, a as buildChannelSummary, gt as loadProviderUsageSummary, h as listAgentsForGateway, m as classifySessionKey, o as buildChannelAccountSnapshot, pr as lookupContextTokens, s as formatChannelAllowFrom, wr as peekSystemEvents, x as resolveSessionModelRef, z as readRestartSentinel } from "./reply-dzRBlsmK.js";
+import { B as summarizeRestartSentinel, Jt as sha256HexPrefix, _t as formatUsageReportLines, a as buildChannelSummary, gt as loadProviderUsageSummary, h as listAgentsForGateway, m as classifySessionKey, o as buildChannelAccountSnapshot, pr as lookupContextTokens, s as formatChannelAllowFrom, wr as peekSystemEvents, x as resolveSessionModelRef, z as readRestartSentinel } from "./reply-4ilKYVzu.js";
 import { S as parseAgentSessionKey } from "./session-key-DCt45XZa.js";
 import { t as resolveSymiPackageRoot } from "./symi-root-CrGJbkzf.js";
 import { n as runExec } from "./exec-CWkblSrI.js";
@@ -28,7 +28,7 @@ import { t as formatRuntimeStatusWithDetails } from "./runtime-status-CR9445g5.j
 import { t as readLastGatewayErrorLine } from "./diagnostics-BAMlsVVX.js";
 import { t as renderTable } from "./table-BTgkRafz.js";
 import { a as resolveGatewayProbeAuth$1, c as probeGateway, t as runSecurityAudit } from "./audit-CrITRV6w.js";
-import { a as resolveHeartbeatSummaryForAgent, t as formatHealthChannelLines } from "./health-CJ7Y6Rln.js";
+import { a as resolveHeartbeatSummaryForAgent, t as formatHealthChannelLines } from "./health-Dzi6letr.js";
 import { g as resolveUpdateChannelDisplay, i as formatGitInstallLabel, m as normalizeUpdateChannel, t as checkUpdateStatus } from "./update-check-CtckACbb.js";
 import { t as resolveNodeService } from "./node-service-Cxz4e-Qd.js";
 import { n as redactSecrets, t as formatGatewayAuthUsed } from "./format-yQZNwAF2.js";

package/dist/{store-01F_JM7O.js → store-Ea3zM6xK.js}

@@ -1,7 +1,7 @@
-import { P as resolveConfigDir } from "./registry-DYq1AYOv.js";
-import { c as detectMime, l as extensionForMime } from "./image-ops-C7CauEK8.js";
+import { P as resolveConfigDir } from "./registry-UkL38jvt.js";
+import { c as detectMime, l as extensionForMime } from "./image-ops-M5agStZn.js";
 import path from "node:path";
-import fs$1 from "node:fs/promises";
+import fs from "node:fs/promises";
 import crypto from "node:crypto";
 
 //#region src/media/store.ts
@@ -24,7 +24,7 @@ function getMediaDir() {
 }
 async function ensureMediaDir() {
 	const mediaDir = resolveMediaDir();
-	await fs$1.mkdir(mediaDir, {
+	await fs.mkdir(mediaDir, {
 		recursive: true,
 		mode: 448
 	});
@@ -33,7 +33,7 @@ async function ensureMediaDir() {
 async function saveMediaBuffer(buffer, contentType, subdir = "inbound", maxBytes = MAX_BYTES, originalFilename) {
 	if (buffer.byteLength > maxBytes) throw new Error(`Media exceeds ${(maxBytes / (1024 * 1024)).toFixed(0)}MB limit`);
 	const dir = path.join(resolveMediaDir(), subdir);
-	await fs$1.mkdir(dir, {
+	await fs.mkdir(dir, {
 		recursive: true,
 		mode: 448
 	});
@@ -51,7 +51,7 @@ async function saveMediaBuffer(buffer, contentType, subdir = "inbound", maxBytes
 		id = sanitized ? `${sanitized}---${uuid}${ext}` : `${uuid}${ext}`;
 	} else id = ext ? `${uuid}${ext}` : uuid;
 	const dest = path.join(dir, id);
-	await fs$1.writeFile(dest, buffer, { mode: 384 });
+	await fs.writeFile(dest, buffer, { mode: 384 });
 	return {
 		id,
 		path: dest,

package/dist/{subagent-registry-DEdqc42m.js → subagent-registry-7wPEZQKK.js}

@@ -32878,7 +32878,9 @@ function stripModelTokensAggressive(text, modelId) {
 */
 function cleanResidualTokenFragments(text) {
 	if (!text) return text;
-	return text.replace(/^[<"|]+(?!<[A-Z_])(?=[a-zA-Z0-9/~$.(])/gm, "").replace(/[<"|]+$/gm, "").trim();
+	let result = text.replace(/^[<"|]+(?!<[A-Z_])(?=[a-zA-Z0-9/~$.(])/gm, "").replace(/[<"|]+$/gm, "").trim();
+	if (result.length >= 2 && result.length < 20 && !result.includes(" ") && !result.includes("-") && !result.includes("/") && !result.includes(".") && result[0] === result[1]) result = result.slice(1);
+	return result;
 }
 
 //#endregion
@@ -35669,15 +35671,56 @@ function sanitizeParams(params) {
 	};
 }
 /**
+* Build a usage example string from a tool's JSON schema for helpful error messages.
+* Returns something like: web_search({ query: "<search terms>" })
+*/
+function buildToolUsageExample(toolName, schema) {
+	const props = schema?.properties;
+	if (!props || typeof props !== "object") return `${toolName}({ ... })`;
+	return `${toolName}({ ${Object.entries(props).slice(0, 4).map(([key, def]) => {
+		const typeDef = def;
+		if (Array.isArray(typeDef?.enum)) return `${key}: "${typeDef.enum[0]}"`;
+		if (typeDef?.type === "string") return `${key}: "<${typeof typeDef.description === "string" ? typeDef.description.slice(0, 30) : key}>"`;
+		return `${key}: ...`;
+	}).join(", ")} })`;
+}
+/**
+* Extract required fields from a tool's JSON schema.
+*/
+function getRequiredFields(schema) {
+	const required = schema?.required;
+	return Array.isArray(required) ? required.filter((r) => typeof r === "string") : [];
+}
+/**
+* Create a relaxed copy of a tool schema with required fields removed.
+* This allows args with missing fields to pass pi-agent-core's schema
+* validation, reaching our execute() wrapper where we can return a
+* helpful error message with a usage example.
+*/
+function relaxSchema(schema) {
+	if (!schema || typeof schema !== "object") return schema;
+	const copy = { ...schema };
+	delete copy.required;
+	return copy;
+}
+/**
 * Wrap a single tool with universal argument sanitization.
 */
 function wrapToolWithArgValidation(tool) {
 	const toolName = (tool.name ?? "").toLowerCase().trim();
 	const isExecTool = EXEC_TOOL_NAMES.has(toolName);
+	const originalRequired = getRequiredFields(tool.parameters);
+	const usageExample = buildToolUsageExample(toolName, tool.parameters);
 	const originalExecute = tool.execute;
 	return {
 		...tool,
+		parameters: relaxSchema(tool.parameters),
 		execute(toolCallId, params, ...rest) {
+			const missingFields = originalRequired.filter((field) => params[field] === void 0 || params[field] === null);
+			if (missingFields.length > 0) {
+				log$1.warn(`[validate] ${toolName} missing required fields: ${missingFields.join(", ")}`);
+				return Promise.resolve({ output: `Error: Missing required argument${missingFields.length > 1 ? "s" : ""}: ${missingFields.join(", ")}. Please try again with all required arguments.\nExample: ${usageExample}` });
+			}
 			const { cleaned, changed } = sanitizeParams(params);
 			if (changed) log$1.debug(`[validate] sanitized args for ${toolName}: ${Object.keys(params).filter((k) => cleaned[k] !== params[k]).join(",")}`);
 			const effectiveParams = changed ? cleaned : params;
@@ -53026,7 +53069,7 @@ function isVoiceChannelType(type) {
 function createDefaultDeps() {
 	return {
 		sendMessageWhatsApp: async (...args) => {
-			const { sendMessageWhatsApp } = await import("./web-DUi3cu-p.js");
+			const { sendMessageWhatsApp } = await import("./web-CuNZExQK.js");
 			return await sendMessageWhatsApp(...args);
 		},
 		sendMessageTelegram: async (...args) => {
@@ -68340,7 +68383,7 @@ function loadWebLoginQr() {
 	return webLoginQrPromise;
 }
 function loadWebChannel() {
-	webChannelPromise ??= import("./web-DUi3cu-p.js");
+	webChannelPromise ??= import("./web-CuNZExQK.js");
 	return webChannelPromise;
 }
 function loadWhatsAppActions() {

package/dist/{subsystem-BjyjJF-d.js → subsystem-DN75fnEF.js}

@@ -1,4 +1,4 @@
-import { at as isFileLogLevelEnabled, ct as levelToMinLevel, lt as normalizeLogLevel, n as CHAT_CHANNEL_ORDER, q as isVerbose, rt as getChildLogger, st as loggingState, ut as readLoggingConfig } from "./registry-DYq1AYOv.js";
+import { at as isFileLogLevelEnabled, ct as levelToMinLevel, lt as normalizeLogLevel, n as CHAT_CHANNEL_ORDER, q as isVerbose, rt as getChildLogger, st as loggingState, ut as readLoggingConfig } from "./registry-UkL38jvt.js";
 import { Chalk } from "chalk";
 
 //#region src/terminal/progress-line.ts

package/dist/{tables-qMwbq29u.js → tables-BX7_aBvN.js}

@@ -1,4 +1,4 @@
-import { r as markdownToIRWithMeta } from "./ir-CTiz95Vb.js";
+import { r as markdownToIRWithMeta } from "./ir-B-XXcYFe.js";
 import { t as renderMarkdownWithMarkers } from "./render-CDCvpfhh.js";
 
 //#region src/markdown/tables.ts

package/dist/{target-errors-Bbr9rlzN.js → target-errors-7KhTCTdS.js}

@@ -1,5 +1,5 @@
-import { c as detectMime } from "./image-ops-C7CauEK8.js";
-import { r as sanitizeToolResultImages } from "./tool-images-SqqWIT22.js";
+import { c as detectMime } from "./image-ops-M5agStZn.js";
+import { r as sanitizeToolResultImages } from "./tool-images-B1qVCntj.js";
 import fs from "node:fs/promises";
 
 //#region src/agents/tools/common.ts

package/dist/{thinking-BprCy23Z.js → thinking-C9-JAUzD.js}

@@ -1,9 +1,9 @@
 import { p as normalizeAccountId } from "./session-key-BCzIW1Y2.js";
-import { D as escapeRegExp, M as normalizeE164, i as getChatChannelMeta, l as requireActivePluginRegistry, n as CHAT_CHANNEL_ORDER } from "./registry-DYq1AYOv.js";
-import { _ as resolveDiscordAccount, a as normalizeWhatsAppTarget, d as resolveSlackAccount, f as resolveSlackReplyToMode, l as resolveTelegramAccount } from "./plugins-BzmbgY7s.js";
-import { t as resolveWhatsAppAccount } from "./accounts-BRw8yhIW.js";
-import { t as resolveIMessageAccount } from "./accounts-3dCrO3oZ.js";
-import { n as resolveSignalAccount } from "./accounts-BuZxOb3B.js";
+import { D as escapeRegExp, M as normalizeE164, i as getChatChannelMeta, l as requireActivePluginRegistry, n as CHAT_CHANNEL_ORDER } from "./registry-UkL38jvt.js";
+import { _ as resolveDiscordAccount, a as normalizeWhatsAppTarget, d as resolveSlackAccount, f as resolveSlackReplyToMode, l as resolveTelegramAccount } from "./plugins-Bkr5ZdYs.js";
+import { t as resolveWhatsAppAccount } from "./accounts-D1r2dq1t.js";
+import { t as resolveIMessageAccount } from "./accounts-dRUMQQrB.js";
+import { n as resolveSignalAccount } from "./accounts-wSphH5gv.js";
 
 //#region src/shared/string-normalization.ts
 function normalizeStringEntries(list) {

package/dist/{tokens-Bux9Y_xD.js → tokens-BZGy4v--.js}

@@ -1,4 +1,4 @@
-import { D as escapeRegExp } from "./registry-DYq1AYOv.js";
+import { D as escapeRegExp } from "./registry-UkL38jvt.js";
 
 //#region src/auto-reply/tokens.ts
 const SYMIPULSE_TOKEN = "SYMIPULSE_OK";

package/dist/{tool-images-SqqWIT22.js → tool-images-B1qVCntj.js}

@@ -1,5 +1,5 @@
-import { t as createSubsystemLogger } from "./subsystem-BjyjJF-d.js";
-import { i as getImageMetadata, n as buildImageResizeSideGrid, s as resizeToJpeg, t as IMAGE_REDUCE_QUALITY_STEPS } from "./image-ops-C7CauEK8.js";
+import { t as createSubsystemLogger } from "./subsystem-DN75fnEF.js";
+import { i as getImageMetadata, n as buildImageResizeSideGrid, s as resizeToJpeg, t as IMAGE_REDUCE_QUALITY_STEPS } from "./image-ops-M5agStZn.js";
 
 //#region src/agents/image-sanitization.ts
 const DEFAULT_IMAGE_MAX_DIMENSION_PX = 1200;

package/dist/{tool-loop-detection-DR_rrIA1.js → tool-loop-detection-C8FBZVVx.js}

@@ -1,6 +1,6 @@
-import "./paths-CE7eVGHg.js";
-import { W as isPlainObject } from "./registry-DYq1AYOv.js";
-import { t as createSubsystemLogger } from "./subsystem-BjyjJF-d.js";
+import "./paths-CYmyCDsE.js";
+import { W as isPlainObject } from "./registry-UkL38jvt.js";
+import { t as createSubsystemLogger } from "./subsystem-DN75fnEF.js";
 import { createHash } from "node:crypto";
 
 //#region src/agents/tool-loop-detection.ts