remoteclaw 0.1.0-next.2abd2fa → 0.1.0-next.2e9a6cd

package/dist/agent-helpers-KHUla1K7.js

@@ -0,0 +1,400 @@
+import { t as createSubsystemLogger } from "./subsystem-BgxIzx7w.js";
+
+//#region src/agents/stable-stringify.ts
+function stableStringify(value) {
+	if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
+	if (Array.isArray(value)) return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
+	const record = value;
+	return `{${Object.keys(record).toSorted().map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+}
+
+//#endregion
+//#region src/agents/agent-helpers/errors.ts
+const log = createSubsystemLogger("errors");
+function formatBillingErrorMessage(provider, model) {
+	const providerName = provider?.trim();
+	const modelName = model?.trim();
+	const providerLabel = providerName && modelName ? `${providerName} (${modelName})` : providerName || void 0;
+	if (providerLabel) return `⚠️ ${providerLabel} returned a billing error — your API key has run out of credits or has an insufficient balance. Check your ${providerName} billing dashboard and top up or switch to a different API key.`;
+	return "⚠️ API provider returned a billing error — your API key has run out of credits or has an insufficient balance. Check your provider's billing dashboard and top up or switch to a different API key.";
+}
+const BILLING_ERROR_USER_MESSAGE = formatBillingErrorMessage();
+const RATE_LIMIT_ERROR_USER_MESSAGE = "⚠️ API rate limit reached. Please try again later.";
+const OVERLOADED_ERROR_USER_MESSAGE = "The AI service is temporarily overloaded. Please try again in a moment.";
+function formatRateLimitOrOverloadedErrorCopy(raw) {
+	if (isRateLimitErrorMessage(raw)) return RATE_LIMIT_ERROR_USER_MESSAGE;
+	if (isOverloadedErrorMessage(raw)) return OVERLOADED_ERROR_USER_MESSAGE;
+}
+function isReasoningConstraintErrorMessage(raw) {
+	if (!raw) return false;
+	const lower = raw.toLowerCase();
+	return lower.includes("reasoning is mandatory") || lower.includes("reasoning is required") || lower.includes("requires reasoning") || lower.includes("reasoning") && lower.includes("cannot be disabled");
+}
+function isContextOverflowError(errorMessage) {
+	if (!errorMessage) return false;
+	const lower = errorMessage.toLowerCase();
+	if (lower.includes("tpm") || lower.includes("tokens per minute")) return false;
+	if (isReasoningConstraintErrorMessage(errorMessage)) return false;
+	const hasRequestSizeExceeds = lower.includes("request size exceeds");
+	const hasContextWindow = lower.includes("context window") || lower.includes("context length") || lower.includes("maximum context length");
+	return lower.includes("request_too_large") || lower.includes("request exceeds the maximum size") || lower.includes("context length exceeded") || lower.includes("maximum context length") || lower.includes("prompt is too long") || lower.includes("exceeds model context window") || lower.includes("model token limit") || hasRequestSizeExceeds && hasContextWindow || lower.includes("context overflow:") || lower.includes("exceed context limit") || lower.includes("exceeds the model's maximum context") || lower.includes("max_tokens") && lower.includes("exceed") && lower.includes("context") || lower.includes("input length") && lower.includes("exceed") && lower.includes("context") || lower.includes("413") && lower.includes("too large") || errorMessage.includes("上下文过长") || errorMessage.includes("上下文超出") || errorMessage.includes("上下文长度超") || errorMessage.includes("超出最大上下文") || errorMessage.includes("请压缩上下文");
+}
+const CONTEXT_WINDOW_TOO_SMALL_RE = /context window.*(too small|minimum is)/i;
+const CONTEXT_OVERFLOW_HINT_RE = /context.*overflow|context window.*(too (?:large|long)|exceed|over|limit|max(?:imum)?|requested|sent|tokens)|prompt.*(too (?:large|long)|exceed|over|limit|max(?:imum)?)|(?:request|input).*(?:context|window|length|token).*(too (?:large|long)|exceed|over|limit|max(?:imum)?)/i;
+const RATE_LIMIT_HINT_RE = /rate limit|too many requests|requests per (?:minute|hour|day)|quota|throttl|429\b/i;
+function isLikelyContextOverflowError(errorMessage) {
+	if (!errorMessage) return false;
+	const lower = errorMessage.toLowerCase();
+	if (lower.includes("tpm") || lower.includes("tokens per minute")) return false;
+	if (isReasoningConstraintErrorMessage(errorMessage)) return false;
+	if (CONTEXT_WINDOW_TOO_SMALL_RE.test(errorMessage)) return false;
+	if (isRateLimitErrorMessage(errorMessage)) return false;
+	if (isContextOverflowError(errorMessage)) return true;
+	if (RATE_LIMIT_HINT_RE.test(errorMessage)) return false;
+	return CONTEXT_OVERFLOW_HINT_RE.test(errorMessage);
+}
+function isCompactionFailureError(errorMessage) {
+	if (!errorMessage) return false;
+	const lower = errorMessage.toLowerCase();
+	if (!(lower.includes("summarization failed") || lower.includes("auto-compaction") || lower.includes("compaction failed") || lower.includes("compaction"))) return false;
+	if (isLikelyContextOverflowError(errorMessage)) return true;
+	return lower.includes("context overflow");
+}
+const ERROR_PAYLOAD_PREFIX_RE = /^(?:error|api\s*error|apierror|openai\s*error|anthropic\s*error|gateway\s*error)[:\s-]+/i;
+const FINAL_TAG_RE = /<\s*\/?\s*final\s*>/gi;
+const ERROR_PREFIX_RE = /^(?:error|api\s*error|openai\s*error|anthropic\s*error|gateway\s*error|request failed|failed|exception)[:\s-]+/i;
+const CONTEXT_OVERFLOW_ERROR_HEAD_RE = /^(?:context overflow:|request_too_large\b|request size exceeds\b|request exceeds the maximum size\b|context length exceeded\b|maximum context length\b|prompt is too long\b|exceeds model context window\b)/i;
+const BILLING_ERROR_HEAD_RE = /^(?:error[:\s-]+)?billing(?:\s+error)?(?:[:\s-]+|$)|^(?:error[:\s-]+)?(?:credit balance|insufficient credits?|payment required|http\s*402\b)/i;
+const BILLING_ERROR_HARD_402_RE = /["']?(?:status|code)["']?\s*[:=]\s*402\b|\bhttp\s*402\b|\berror(?:\s+code)?\s*[:=]?\s*402\b|^\s*402\s+payment/i;
+const HTTP_STATUS_PREFIX_RE = /^(?:http\s*)?(\d{3})\s+(.+)$/i;
+const HTTP_STATUS_CODE_PREFIX_RE = /^(?:http\s*)?(\d{3})(?:\s+([\s\S]+))?$/i;
+const HTML_ERROR_PREFIX_RE = /^\s*(?:<!doctype\s+html\b|<html\b)/i;
+const CLOUDFLARE_HTML_ERROR_CODES = new Set([
+	521,
+	522,
+	523,
+	524,
+	525,
+	526,
+	530
+]);
+const TRANSIENT_HTTP_ERROR_CODES = new Set([
+	500,
+	502,
+	503,
+	504,
+	521,
+	522,
+	523,
+	524,
+	529
+]);
+const HTTP_ERROR_HINTS = [
+	"error",
+	"bad request",
+	"not found",
+	"unauthorized",
+	"forbidden",
+	"internal server",
+	"service unavailable",
+	"gateway",
+	"rate limit",
+	"overloaded",
+	"timeout",
+	"timed out",
+	"invalid",
+	"too many requests",
+	"permission"
+];
+function extractLeadingHttpStatus(raw) {
+	const match = raw.match(HTTP_STATUS_CODE_PREFIX_RE);
+	if (!match) return null;
+	const code = Number(match[1]);
+	if (!Number.isFinite(code)) return null;
+	return {
+		code,
+		rest: (match[2] ?? "").trim()
+	};
+}
+function isCloudflareOrHtmlErrorPage(raw) {
+	const trimmed = raw.trim();
+	if (!trimmed) return false;
+	const status = extractLeadingHttpStatus(trimmed);
+	if (!status || status.code < 500) return false;
+	if (CLOUDFLARE_HTML_ERROR_CODES.has(status.code)) return true;
+	return status.code < 600 && HTML_ERROR_PREFIX_RE.test(status.rest) && /<\/html>/i.test(status.rest);
+}
+function isTransientHttpError(raw) {
+	const trimmed = raw.trim();
+	if (!trimmed) return false;
+	const status = extractLeadingHttpStatus(trimmed);
+	if (!status) return false;
+	return TRANSIENT_HTTP_ERROR_CODES.has(status.code);
+}
+function stripFinalTagsFromText(text) {
+	if (!text) return text;
+	return text.replace(FINAL_TAG_RE, "");
+}
+function collapseConsecutiveDuplicateBlocks(text) {
+	const trimmed = text.trim();
+	if (!trimmed) return text;
+	const blocks = trimmed.split(/\n{2,}/);
+	if (blocks.length < 2) return text;
+	const normalizeBlock = (value) => value.trim().replace(/\s+/g, " ");
+	const result = [];
+	let lastNormalized = null;
+	for (const block of blocks) {
+		const normalized = normalizeBlock(block);
+		if (lastNormalized && normalized === lastNormalized) continue;
+		result.push(block.trim());
+		lastNormalized = normalized;
+	}
+	if (result.length === blocks.length) return text;
+	return result.join("\n\n");
+}
+function isLikelyHttpErrorText(raw) {
+	if (isCloudflareOrHtmlErrorPage(raw)) return true;
+	const match = raw.match(HTTP_STATUS_PREFIX_RE);
+	if (!match) return false;
+	const code = Number(match[1]);
+	if (!Number.isFinite(code) || code < 400) return false;
+	const message = match[2].toLowerCase();
+	return HTTP_ERROR_HINTS.some((hint) => message.includes(hint));
+}
+function shouldRewriteContextOverflowText(raw) {
+	if (!isContextOverflowError(raw)) return false;
+	return isRawApiErrorPayload(raw) || isLikelyHttpErrorText(raw) || ERROR_PREFIX_RE.test(raw) || CONTEXT_OVERFLOW_ERROR_HEAD_RE.test(raw);
+}
+function isErrorPayloadObject(payload) {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return false;
+	const record = payload;
+	if (record.type === "error") return true;
+	if (typeof record.request_id === "string" || typeof record.requestId === "string") return true;
+	if ("error" in record) {
+		const err = record.error;
+		if (err && typeof err === "object" && !Array.isArray(err)) {
+			const errRecord = err;
+			if (typeof errRecord.message === "string" || typeof errRecord.type === "string" || typeof errRecord.code === "string") return true;
+		}
+	}
+	return false;
+}
+function parseApiErrorPayload(raw) {
+	if (!raw) return null;
+	const trimmed = raw.trim();
+	if (!trimmed) return null;
+	const candidates = [trimmed];
+	if (ERROR_PAYLOAD_PREFIX_RE.test(trimmed)) candidates.push(trimmed.replace(ERROR_PAYLOAD_PREFIX_RE, "").trim());
+	for (const candidate of candidates) {
+		if (!candidate.startsWith("{") || !candidate.endsWith("}")) continue;
+		try {
+			const parsed = JSON.parse(candidate);
+			if (isErrorPayloadObject(parsed)) return parsed;
+		} catch {}
+	}
+	return null;
+}
+function getApiErrorPayloadFingerprint(raw) {
+	if (!raw) return null;
+	const payload = parseApiErrorPayload(raw);
+	if (!payload) return null;
+	return stableStringify(payload);
+}
+function isRawApiErrorPayload(raw) {
+	return getApiErrorPayloadFingerprint(raw) !== null;
+}
+function parseApiErrorInfo(raw) {
+	if (!raw) return null;
+	const trimmed = raw.trim();
+	if (!trimmed) return null;
+	let httpCode;
+	let candidate = trimmed;
+	const httpPrefixMatch = candidate.match(/^(\d{3})\s+(.+)$/s);
+	if (httpPrefixMatch) {
+		httpCode = httpPrefixMatch[1];
+		candidate = httpPrefixMatch[2].trim();
+	}
+	const payload = parseApiErrorPayload(candidate);
+	if (!payload) return null;
+	const requestId = typeof payload.request_id === "string" ? payload.request_id : typeof payload.requestId === "string" ? payload.requestId : void 0;
+	const topType = typeof payload.type === "string" ? payload.type : void 0;
+	const topMessage = typeof payload.message === "string" ? payload.message : void 0;
+	let errType;
+	let errMessage;
+	if (payload.error && typeof payload.error === "object" && !Array.isArray(payload.error)) {
+		const err = payload.error;
+		if (typeof err.type === "string") errType = err.type;
+		if (typeof err.code === "string" && !errType) errType = err.code;
+		if (typeof err.message === "string") errMessage = err.message;
+	}
+	return {
+		httpCode,
+		type: errType ?? topType,
+		message: errMessage ?? topMessage,
+		requestId
+	};
+}
+function formatRawAssistantErrorForUi(raw) {
+	const trimmed = (raw ?? "").trim();
+	if (!trimmed) return "LLM request failed with an unknown error.";
+	const leadingStatus = extractLeadingHttpStatus(trimmed);
+	if (leadingStatus && isCloudflareOrHtmlErrorPage(trimmed)) return `The AI service is temporarily unavailable (HTTP ${leadingStatus.code}). Please try again in a moment.`;
+	const httpMatch = trimmed.match(HTTP_STATUS_PREFIX_RE);
+	if (httpMatch) {
+		const rest = httpMatch[2].trim();
+		if (!rest.startsWith("{")) return `HTTP ${httpMatch[1]}: ${rest}`;
+	}
+	const info = parseApiErrorInfo(trimmed);
+	if (info?.message) {
+		const prefix = info.httpCode ? `HTTP ${info.httpCode}` : "LLM error";
+		const type = info.type ? ` ${info.type}` : "";
+		const requestId = info.requestId ? ` (request_id: ${info.requestId})` : "";
+		return `${prefix}${type}: ${info.message}${requestId}`;
+	}
+	return trimmed.length > 600 ? `${trimmed.slice(0, 600)}…` : trimmed;
+}
+function sanitizeUserFacingText(text, opts) {
+	if (!text) return text;
+	const errorContext = opts?.errorContext ?? false;
+	const stripped = stripFinalTagsFromText(text);
+	const trimmed = stripped.trim();
+	if (!trimmed) return "";
+	if (errorContext) {
+		if (/incorrect role information|roles must alternate/i.test(trimmed)) return "Message ordering conflict - please try again. If this persists, use /new to start a fresh session.";
+		if (shouldRewriteContextOverflowText(trimmed)) return "Context overflow: prompt too large for the model. Try /reset (or /new) to start a fresh session, or use a larger-context model.";
+		if (isBillingErrorMessage(trimmed)) return BILLING_ERROR_USER_MESSAGE;
+		if (isRawApiErrorPayload(trimmed) || isLikelyHttpErrorText(trimmed)) return formatRawAssistantErrorForUi(trimmed);
+		if (ERROR_PREFIX_RE.test(trimmed)) {
+			const prefixedCopy = formatRateLimitOrOverloadedErrorCopy(trimmed);
+			if (prefixedCopy) return prefixedCopy;
+			if (isTimeoutErrorMessage(trimmed)) return "LLM request timed out.";
+			return formatRawAssistantErrorForUi(trimmed);
+		}
+	}
+	return collapseConsecutiveDuplicateBlocks(stripped.replace(/^(?:[ \t]*\r?\n)+/, ""));
+}
+const ERROR_PATTERNS = {
+	rateLimit: [
+		/rate[_ ]limit|too many requests|429/,
+		"model_cooldown",
+		"cooling down",
+		"exceeded your current quota",
+		"resource has been exhausted",
+		"quota exceeded",
+		"resource_exhausted",
+		"usage limit",
+		"tpm",
+		"tokens per minute"
+	],
+	overloaded: [
+		/overloaded_error|"type"\s*:\s*"overloaded_error"/i,
+		"overloaded",
+		"service unavailable",
+		"high demand"
+	],
+	timeout: [
+		"timeout",
+		"timed out",
+		"deadline exceeded",
+		"context deadline exceeded",
+		/without sending (?:any )?chunks?/i,
+		/\bstop reason:\s*abort\b/i,
+		/\breason:\s*abort\b/i,
+		/\bunhandled stop reason:\s*abort\b/i
+	],
+	billing: [
+		/["']?(?:status|code)["']?\s*[:=]\s*402\b|\bhttp\s*402\b|\berror(?:\s+code)?\s*[:=]?\s*402\b|\b(?:got|returned|received)\s+(?:a\s+)?402\b|^\s*402\s+payment/i,
+		"payment required",
+		"insufficient credits",
+		"credit balance",
+		"plans & billing",
+		"insufficient balance"
+	],
+	auth: [
+		/invalid[_ ]?api[_ ]?key/,
+		"incorrect api key",
+		"invalid token",
+		"authentication",
+		"re-authenticate",
+		"oauth token refresh failed",
+		"unauthorized",
+		"forbidden",
+		"access denied",
+		"insufficient permissions",
+		"insufficient permission",
+		/missing scopes?:/i,
+		"expired",
+		"token has expired",
+		/\b401\b/,
+		/\b403\b/,
+		"no credentials found",
+		"no api key found"
+	],
+	format: [
+		"string should match pattern",
+		"tool_use.id",
+		"tool_use_id",
+		"messages.1.content.1.tool_use.id",
+		"invalid request format",
+		/tool call id was.*must be/i
+	]
+};
+function matchesErrorPatterns(raw, patterns) {
+	if (!raw) return false;
+	const value = raw.toLowerCase();
+	return patterns.some((pattern) => pattern instanceof RegExp ? pattern.test(value) : value.includes(pattern));
+}
+function isRateLimitErrorMessage(raw) {
+	return matchesErrorPatterns(raw, ERROR_PATTERNS.rateLimit);
+}
+function isTimeoutErrorMessage(raw) {
+	return matchesErrorPatterns(raw, ERROR_PATTERNS.timeout);
+}
+/**
+* Maximum character length for a string to be considered a billing error message.
+* Real API billing errors are short, structured messages (typically under 300 chars).
+* Longer text is almost certainly assistant content that happens to mention billing keywords.
+*/
+const BILLING_ERROR_MAX_LENGTH = 512;
+function isBillingErrorMessage(raw) {
+	const value = raw.toLowerCase();
+	if (!value) return false;
+	if (raw.length > BILLING_ERROR_MAX_LENGTH) return BILLING_ERROR_HARD_402_RE.test(value);
+	if (matchesErrorPatterns(value, ERROR_PATTERNS.billing)) return true;
+	if (!BILLING_ERROR_HEAD_RE.test(raw)) return false;
+	return value.includes("upgrade") || value.includes("credits") || value.includes("payment") || value.includes("plan");
+}
+function isOverloadedErrorMessage(raw) {
+	return matchesErrorPatterns(raw, ERROR_PATTERNS.overloaded);
+}
+
+//#endregion
+//#region src/agents/agent-helpers/messaging-dedupe.ts
+const MIN_DUPLICATE_TEXT_LENGTH = 10;
+/**
+* Normalize text for duplicate comparison.
+* - Trims whitespace
+* - Lowercases
+* - Strips emoji (Emoji_Presentation and Extended_Pictographic)
+* - Collapses multiple spaces to single space
+*/
+function normalizeTextForComparison(text) {
+	return text.trim().toLowerCase().replace(/\p{Emoji_Presentation}|\p{Extended_Pictographic}/gu, "").replace(/\s+/g, " ").trim();
+}
+function isMessagingToolDuplicateNormalized(normalized, normalizedSentTexts) {
+	if (normalizedSentTexts.length === 0) return false;
+	if (!normalized || normalized.length < MIN_DUPLICATE_TEXT_LENGTH) return false;
+	return normalizedSentTexts.some((normalizedSent) => {
+		if (!normalizedSent || normalizedSent.length < MIN_DUPLICATE_TEXT_LENGTH) return false;
+		return normalized.includes(normalizedSent) || normalizedSent.includes(normalized);
+	});
+}
+function isMessagingToolDuplicate(text, sentTexts) {
+	if (sentTexts.length === 0) return false;
+	const normalized = normalizeTextForComparison(text);
+	if (!normalized || normalized.length < MIN_DUPLICATE_TEXT_LENGTH) return false;
+	return isMessagingToolDuplicateNormalized(normalized, sentTexts.map(normalizeTextForComparison));
+}
+
+//#endregion
+export { isLikelyContextOverflowError as a, isContextOverflowError as i, formatRawAssistantErrorForUi as n, isTransientHttpError as o, isCompactionFailureError as r, sanitizeUserFacingText as s, isMessagingToolDuplicate as t };

package/dist/agent-scope-BrDeaWWf.js

@@ -0,0 +1,116 @@
+import { h as resolveStateDir } from "./paths-BTaH3rLn.js";
+import { _ as resolveUserPath } from "./utils-C5daYcFn.js";
+import { t as createSubsystemLogger } from "./subsystem-BgxIzx7w.js";
+import { C as parseAgentSessionKey, s as normalizeAgentId, t as DEFAULT_AGENT_ID } from "./session-key-C2n-VILA.js";
+import path from "node:path";
+
+//#region src/agents/agent-scope.ts
+const log = createSubsystemLogger("agent-scope");
+/** Strip null bytes from paths to prevent ENOTDIR errors. */
+function stripNullBytes(s) {
+	return s.replace(/\0/g, "");
+}
+let defaultAgentWarned = false;
+function listAgentEntries(cfg) {
+	const list = cfg.agents?.list;
+	if (!Array.isArray(list)) return [];
+	return list.filter((entry) => Boolean(entry && typeof entry === "object"));
+}
+function listAgentIds(cfg) {
+	const agents = listAgentEntries(cfg);
+	if (agents.length === 0) return [DEFAULT_AGENT_ID];
+	const seen = /* @__PURE__ */ new Set();
+	const ids = [];
+	for (const entry of agents) {
+		const id = normalizeAgentId(entry?.id);
+		if (seen.has(id)) continue;
+		seen.add(id);
+		ids.push(id);
+	}
+	return ids.length > 0 ? ids : [DEFAULT_AGENT_ID];
+}
+function resolveDefaultAgentId(cfg) {
+	const agents = listAgentEntries(cfg);
+	if (agents.length === 0) return DEFAULT_AGENT_ID;
+	const defaults = agents.filter((agent) => agent?.default);
+	if (defaults.length > 1 && !defaultAgentWarned) {
+		defaultAgentWarned = true;
+		log.warn("Multiple agents marked default=true; using the first entry as default.");
+	}
+	const chosen = (defaults[0] ?? agents[0])?.id?.trim();
+	return normalizeAgentId(chosen || DEFAULT_AGENT_ID);
+}
+function resolveSessionAgentIds(params) {
+	const defaultAgentId = resolveDefaultAgentId(params.config ?? {});
+	const explicitAgentIdRaw = typeof params.agentId === "string" ? params.agentId.trim().toLowerCase() : "";
+	const explicitAgentId = explicitAgentIdRaw ? normalizeAgentId(explicitAgentIdRaw) : null;
+	const sessionKey = params.sessionKey?.trim();
+	const normalizedSessionKey = sessionKey ? sessionKey.toLowerCase() : void 0;
+	const parsed = normalizedSessionKey ? parseAgentSessionKey(normalizedSessionKey) : null;
+	return {
+		defaultAgentId,
+		sessionAgentId: explicitAgentId ?? (parsed?.agentId ? normalizeAgentId(parsed.agentId) : defaultAgentId)
+	};
+}
+function resolveSessionAgentId(params) {
+	return resolveSessionAgentIds(params).sessionAgentId;
+}
+function resolveAgentEntry(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	return listAgentEntries(cfg).find((entry) => normalizeAgentId(entry.id) === id);
+}
+function resolveAgentConfig(cfg, agentId) {
+	const entry = resolveAgentEntry(cfg, normalizeAgentId(agentId));
+	if (!entry) return;
+	return {
+		name: typeof entry.name === "string" ? entry.name : void 0,
+		workspace: typeof entry.workspace === "string" ? entry.workspace : void 0,
+		agentDir: typeof entry.agentDir === "string" ? entry.agentDir : void 0,
+		model: typeof entry.model === "string" || entry.model && typeof entry.model === "object" ? entry.model : void 0,
+		skills: Array.isArray(entry.skills) ? entry.skills : void 0,
+		humanDelay: entry.humanDelay,
+		heartbeat: entry.heartbeat,
+		boot: entry.boot,
+		identity: entry.identity,
+		groupChat: entry.groupChat,
+		subagents: typeof entry.subagents === "object" && entry.subagents ? entry.subagents : void 0,
+		sandbox: entry.sandbox,
+		tools: entry.tools,
+		auth: entry.auth
+	};
+}
+/**
+* Resolve the effective auth setting for an agent.
+*
+* Resolution: agent entry `auth` overrides `agents.defaults.auth`.
+* - Explicit `auth: false` on the entry is an opt-out (not the same as undefined).
+* - `undefined` (missing) on the entry inherits from defaults.
+* - Returns `undefined` when neither the entry nor defaults define auth.
+*/
+function resolveAgentAuth(cfg, agentId) {
+	const entry = resolveAgentEntry(cfg, normalizeAgentId(agentId));
+	if (entry && entry.auth !== void 0) return entry.auth;
+	const defaultsAuth = cfg.agents?.defaults?.auth;
+	return defaultsAuth !== void 0 ? defaultsAuth : void 0;
+}
+function resolveAgentWorkspaceDir(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	const configured = resolveAgentConfig(cfg, id)?.workspace?.trim();
+	if (configured) return stripNullBytes(resolveUserPath(configured));
+	throw new Error(`agent '${id}' has no workspace configured — set agents.list[].workspace in remoteclaw.json`);
+}
+function resolveAgentWorkspaceDirOrNull(cfg, agentId) {
+	const configured = resolveAgentConfig(cfg, normalizeAgentId(agentId))?.workspace?.trim();
+	if (configured) return stripNullBytes(resolveUserPath(configured));
+	return null;
+}
+function resolveAgentDir(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	const configured = resolveAgentConfig(cfg, id)?.agentDir?.trim();
+	if (configured) return resolveUserPath(configured);
+	const root = resolveStateDir(process.env);
+	return path.join(root, "agents", id, "agent");
+}
+
+//#endregion
+export { resolveAgentDir as a, resolveDefaultAgentId as c, resolveAgentConfig as i, resolveSessionAgentId as l, listAgentIds as n, resolveAgentWorkspaceDir as o, resolveAgentAuth as r, resolveAgentWorkspaceDirOrNull as s, listAgentEntries as t };

package/dist/agent-scope-DxqtYjuJ.js

@@ -0,0 +1,114 @@
+import { o as createSubsystemLogger, qt as resolveStateDir, rt as resolveUserPath } from "./entry.js";
+import { C as parseAgentSessionKey, s as normalizeAgentId, t as DEFAULT_AGENT_ID } from "./session-key-BF-9YzxC.js";
+import path from "node:path";
+
+//#region src/agents/agent-scope.ts
+const log = createSubsystemLogger("agent-scope");
+/** Strip null bytes from paths to prevent ENOTDIR errors. */
+function stripNullBytes(s) {
+	return s.replace(/\0/g, "");
+}
+let defaultAgentWarned = false;
+function listAgentEntries(cfg) {
+	const list = cfg.agents?.list;
+	if (!Array.isArray(list)) return [];
+	return list.filter((entry) => Boolean(entry && typeof entry === "object"));
+}
+function listAgentIds(cfg) {
+	const agents = listAgentEntries(cfg);
+	if (agents.length === 0) return [DEFAULT_AGENT_ID];
+	const seen = /* @__PURE__ */ new Set();
+	const ids = [];
+	for (const entry of agents) {
+		const id = normalizeAgentId(entry?.id);
+		if (seen.has(id)) continue;
+		seen.add(id);
+		ids.push(id);
+	}
+	return ids.length > 0 ? ids : [DEFAULT_AGENT_ID];
+}
+function resolveDefaultAgentId(cfg) {
+	const agents = listAgentEntries(cfg);
+	if (agents.length === 0) return DEFAULT_AGENT_ID;
+	const defaults = agents.filter((agent) => agent?.default);
+	if (defaults.length > 1 && !defaultAgentWarned) {
+		defaultAgentWarned = true;
+		log.warn("Multiple agents marked default=true; using the first entry as default.");
+	}
+	const chosen = (defaults[0] ?? agents[0])?.id?.trim();
+	return normalizeAgentId(chosen || DEFAULT_AGENT_ID);
+}
+function resolveSessionAgentIds(params) {
+	const defaultAgentId = resolveDefaultAgentId(params.config ?? {});
+	const explicitAgentIdRaw = typeof params.agentId === "string" ? params.agentId.trim().toLowerCase() : "";
+	const explicitAgentId = explicitAgentIdRaw ? normalizeAgentId(explicitAgentIdRaw) : null;
+	const sessionKey = params.sessionKey?.trim();
+	const normalizedSessionKey = sessionKey ? sessionKey.toLowerCase() : void 0;
+	const parsed = normalizedSessionKey ? parseAgentSessionKey(normalizedSessionKey) : null;
+	return {
+		defaultAgentId,
+		sessionAgentId: explicitAgentId ?? (parsed?.agentId ? normalizeAgentId(parsed.agentId) : defaultAgentId)
+	};
+}
+function resolveSessionAgentId(params) {
+	return resolveSessionAgentIds(params).sessionAgentId;
+}
+function resolveAgentEntry(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	return listAgentEntries(cfg).find((entry) => normalizeAgentId(entry.id) === id);
+}
+function resolveAgentConfig(cfg, agentId) {
+	const entry = resolveAgentEntry(cfg, normalizeAgentId(agentId));
+	if (!entry) return;
+	return {
+		name: typeof entry.name === "string" ? entry.name : void 0,
+		workspace: typeof entry.workspace === "string" ? entry.workspace : void 0,
+		agentDir: typeof entry.agentDir === "string" ? entry.agentDir : void 0,
+		model: typeof entry.model === "string" || entry.model && typeof entry.model === "object" ? entry.model : void 0,
+		skills: Array.isArray(entry.skills) ? entry.skills : void 0,
+		humanDelay: entry.humanDelay,
+		heartbeat: entry.heartbeat,
+		boot: entry.boot,
+		identity: entry.identity,
+		groupChat: entry.groupChat,
+		subagents: typeof entry.subagents === "object" && entry.subagents ? entry.subagents : void 0,
+		sandbox: entry.sandbox,
+		tools: entry.tools,
+		auth: entry.auth
+	};
+}
+/**
+* Resolve the effective auth setting for an agent.
+*
+* Resolution: agent entry `auth` overrides `agents.defaults.auth`.
+* - Explicit `auth: false` on the entry is an opt-out (not the same as undefined).
+* - `undefined` (missing) on the entry inherits from defaults.
+* - Returns `undefined` when neither the entry nor defaults define auth.
+*/
+function resolveAgentAuth(cfg, agentId) {
+	const entry = resolveAgentEntry(cfg, normalizeAgentId(agentId));
+	if (entry && entry.auth !== void 0) return entry.auth;
+	const defaultsAuth = cfg.agents?.defaults?.auth;
+	return defaultsAuth !== void 0 ? defaultsAuth : void 0;
+}
+function resolveAgentWorkspaceDir(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	const configured = resolveAgentConfig(cfg, id)?.workspace?.trim();
+	if (configured) return stripNullBytes(resolveUserPath(configured));
+	throw new Error(`agent '${id}' has no workspace configured — set agents.list[].workspace in remoteclaw.json`);
+}
+function resolveAgentWorkspaceDirOrNull(cfg, agentId) {
+	const configured = resolveAgentConfig(cfg, normalizeAgentId(agentId))?.workspace?.trim();
+	if (configured) return stripNullBytes(resolveUserPath(configured));
+	return null;
+}
+function resolveAgentDir(cfg, agentId) {
+	const id = normalizeAgentId(agentId);
+	const configured = resolveAgentConfig(cfg, id)?.agentDir?.trim();
+	if (configured) return resolveUserPath(configured);
+	const root = resolveStateDir(process.env);
+	return path.join(root, "agents", id, "agent");
+}
+
+//#endregion
+export { resolveAgentDir as a, resolveDefaultAgentId as c, resolveAgentConfig as i, resolveSessionAgentId as l, listAgentIds as n, resolveAgentWorkspaceDir as o, resolveAgentAuth as r, resolveAgentWorkspaceDirOrNull as s, listAgentEntries as t };