fengming 0.3.8 → 0.3.10

package/dist/agent-command-iLD_nsVY.js

@@ -1,1435 +0,0 @@
-import { c as normalizeOptionalString } from "./string-coerce-DKw2K5wM.js";
-import { g as parseStrictNonNegativeInteger } from "./number-coercion-D1aDmIZp.js";
-import "./parse-finite-number-CpgOyjPq.js";
-import { t as sanitizeForLog } from "./ansi-BCVkJ8zW.js";
-import { i as formatErrorMessage } from "./errors-C_Wa6a5T.js";
-import { t as formatCliCommand } from "./command-format-Jv8eeOPe.js";
-import { t as createLazyImportLoader } from "./lazy-promise-Djskx0qC.js";
-import { p as resolveUserPath } from "./utils-v5zGdVpj.js";
-import { c as isSecretRef } from "./types.secrets-Z7uJY7vF.js";
-import { n as defaultRuntime } from "./runtime-BkTkFkXs.js";
-import { t as createSubsystemLogger } from "./subsystem-B7U-DPv3.js";
-import { C as hasSessionAutoModelFallbackProvenance, _ as resolveSessionAgentId, i as markAutoFallbackPrimaryProbe, m as resolveEffectiveModelFallbacks, n as entryMatchesAutoFallbackPrimaryProbe, p as resolveAutoFallbackPrimaryProbe, t as clearAutoFallbackPrimaryProbeSelection } from "./agent-scope-EEbMCF2I.js";
-import { a as isSubagentSessionKey } from "./session-key-utils-CdfsDYvz.js";
-import { d as resolveAgentIdFromSessionKey, h as scopeLegacySessionKeyToAgent, l as normalizeAgentId, o as classifySessionKeyShape, s as isUnscopedSessionKeySentinel } from "./session-key-CJf5_zWs.js";
-import { t as resolveEffectiveAgentSkillFilter } from "./agent-filter-CWvnIMtD.js";
-import { a as resolveAgentDir, c as resolveDefaultAgentId, n as listAgentIds, o as resolveAgentWorkspaceDir, r as resolveAgentConfig } from "./agent-scope-config-BHdZonI2.js";
-import { d as readConfigFileSnapshotForWrite, i as getRuntimeConfig } from "./io-T1CV3Z1L.js";
-import { r as resolveProviderIdForAuth } from "./provider-auth-aliases-hXKyFMus.js";
-import { n as DEFAULT_MODEL, r as DEFAULT_PROVIDER } from "./defaults-DNFU4TYx.js";
-import { g as normalizeVerboseLevel, n as isThinkingLevelSupported, o as resolveSupportedThinkingLevel, p as normalizeThinkLevel, t as formatThinkingLevels } from "./thinking-BmfCvr5O.js";
-import { v as setRuntimeConfigSnapshot } from "./runtime-snapshot-D93_HOsR.js";
-import { o as resolveMessageChannel } from "./message-channel-normalize-CaOaCinb.js";
-import "./message-channel-DcN_7tYD.js";
-import { s as loadManifestMetadataSnapshot } from "./manifest-contract-eligibility-DDEIQ3ba.js";
-import { a as listOpenAIAuthProfileProvidersForAgentRuntime } from "./openai-codex-routing-CJw0IxWE.js";
-import { i as emitAgentEvent, t as clearAgentRunContext, u as registerAgentRunContext } from "./agent-events-Dl8p_DjC.js";
-import { n as withPluginRuntimeGatewayRequestScope, t as getPluginRuntimeGatewayRequestScope } from "./gateway-request-scope-BHnIDss1.js";
-import { n as ensureAuthProfileStore } from "./store-5z-UIEBD.js";
-import { n as isStoredCredentialCompatibleWithAuthProvider } from "./order-D-KKkXpx.js";
-import { r as buildConfiguredModelCatalog, v as resolveConfiguredModelRef } from "./model-selection-shared-vfQyPxy6.js";
-import { i as parseModelRef, n as modelKey, r as normalizeModelRef } from "./model-selection-normalize-aLGuxVEp.js";
-import { t as resolveThinkingDefault } from "./model-thinking-default-BmexX9ZQ.js";
-import { s as resolveDefaultModelForAgent } from "./model-selection-C4gJ7iHA.js";
-import { t as loadManifestModelCatalog } from "./model-catalog-D3tObR7K.js";
-import { l as ensureAgentWorkspace } from "./workspace-BMesC2Eb.js";
-import { r as resolveAgentTimeoutMs } from "./task-completion-contract-BqW0VJsk.js";
-import { t as sanitizePendingFinalDeliveryText } from "./pending-final-delivery-BuIOe_p2.js";
-import { At as createTrajectoryRuntimeRecorder, n as resolveAvailableAgentHarnessPolicy } from "./selection-COhr7g82.js";
-import { r as normalizeSpawnedRunMetadata } from "./spawn-requester-origin-Cx8MeOy5.js";
-import { t as buildOutboundSessionContext } from "./session-context-DpJcitx8.js";
-import { f as LiveSessionModelSwitchError, o as runWithModelFallback } from "./model-fallback-GPUPtVYe.js";
-import { n as resolveSession } from "./session-DonHCoxx.js";
-import { t as getAgentRuntimeCommandSecretTargetIds } from "./command-secret-targets-CTlfcRw0.js";
-import { n as repairProviderWrappedModelOverride, t as applyModelOverrideToSessionEntry } from "./model-overrides-jsF3RKPy.js";
-import { n as createModelVisibilityPolicy } from "./model-visibility-policy-CCe5yAtA.js";
-import { t as AGENT_LANE_SUBAGENT } from "./lanes-ReZ09_e4.js";
-import { t as prepareInternalSessionEffectsTranscript } from "./internal-session-effects-8p4s6m-x.js";
-import { n as resolveSendPolicy } from "./send-policy-C6dhXszH.js";
-import { t as ensureSelectedAgentHarnessPlugin } from "./runtime-plugin-DjkEv91V.js";
-import "./live-model-switch-CDlNv1FV.js";
-import { t as classifyEmbeddedAgentRunResultForModelFallback } from "./result-fallback-classifier-CX4iLD1G.js";
-import { r as resolveInlineAgentImageAttachments } from "./agent-turn-attachments-CC7ip3lu.js";
-import { t as resolveFastModeState } from "./fast-mode-Y-awBHW0.js";
-import { t as clearSessionAuthProfileOverride } from "./session-override-CXkNIuiK.js";
-import { t as NodeRegistry } from "./node-registry-DG-YIP_Y.js";
-import { n as applyVerboseOverride } from "./level-overrides-CiUQwg6P.js";
-import { a as resolveInternalEventTranscriptBody, i as resolveAcpPromptBody, n as persistSessionEntry$1, r as prependInternalEventContext, t as resolveAgentRunContext } from "./run-context-C7im9ICg.js";
-//#region src/gateway/local-request-context.ts
-function cronUnavailable() {
-	throw new Error("定时任务在本地嵌入式网关上下文中不可用");
-}
-const unavailableCron = {
-	start: async () => {
-		cronUnavailable();
-	},
-	stop: () => {},
-	status: async () => cronUnavailable(),
-	list: async () => cronUnavailable(),
-	listPage: async () => cronUnavailable(),
-	add: async () => cronUnavailable(),
-	update: async () => cronUnavailable(),
-	remove: async () => cronUnavailable(),
-	run: async () => cronUnavailable(),
-	enqueueRun: async () => cronUnavailable(),
-	getJob: () => void 0,
-	readJob: async () => void 0,
-	getDefaultAgentId: () => void 0,
-	wake: () => ({
-		ok: false,
-		reason: "unwakeable-session-key"
-	})
-};
-function createLocalGatewayRequestContext(params) {
-	const logGateway = createSubsystemLogger("gateway/local");
-	const sessionEvents = /* @__PURE__ */ new Set();
-	const chatRuns = /* @__PURE__ */ new Map();
-	const chatRunBuffers = /* @__PURE__ */ new Map();
-	const chatDeltaSentAt = /* @__PURE__ */ new Map();
-	const chatDeltaLastBroadcastLen = /* @__PURE__ */ new Map();
-	const chatDeltaLastBroadcastText = /* @__PURE__ */ new Map();
-	const agentDeltaSentAt = /* @__PURE__ */ new Map();
-	const bufferedAgentEvents = /* @__PURE__ */ new Map();
-	const clearChatRunState = (runId) => {
-		chatRunBuffers.delete(runId);
-		chatDeltaSentAt.delete(runId);
-		chatDeltaLastBroadcastLen.delete(runId);
-		chatDeltaLastBroadcastText.delete(runId);
-		for (const key of [
-			runId,
-			`${runId}:assistant`,
-			`${runId}:thinking`
-		]) {
-			agentDeltaSentAt.delete(key);
-			bufferedAgentEvents.delete(key);
-		}
-	};
-	return {
-		deps: params.deps,
-		cron: unavailableCron,
-		cronStorePath: "",
-		getRuntimeConfig: params.getRuntimeConfig,
-		loadGatewayModelCatalog: async () => loadManifestModelCatalog({ config: params.getRuntimeConfig() }),
-		getHealthCache: () => null,
-		refreshHealthSnapshot: async () => ({}),
-		logHealth: { error: (message) => logGateway.error(message) },
-		logGateway,
-		incrementPresenceVersion: () => 0,
-		getHealthVersion: () => 0,
-		broadcast: () => {},
-		broadcastToConnIds: () => {},
-		nodeSendToSession: () => {},
-		nodeSendToAllSubscribed: () => {},
-		nodeSubscribe: () => {},
-		nodeUnsubscribe: () => {},
-		nodeUnsubscribeAll: () => {},
-		hasConnectedTalkNode: () => false,
-		nodeRegistry: new NodeRegistry(),
-		agentRunSeq: /* @__PURE__ */ new Map(),
-		chatAbortControllers: /* @__PURE__ */ new Map(),
-		chatAbortedRuns: /* @__PURE__ */ new Map(),
-		chatRunBuffers,
-		chatDeltaSentAt,
-		chatDeltaLastBroadcastLen,
-		chatDeltaLastBroadcastText,
-		agentDeltaSentAt,
-		bufferedAgentEvents,
-		clearChatRunState,
-		addChatRun: (sessionId, entry) => {
-			chatRuns.set(sessionId, entry);
-		},
-		removeChatRun: (sessionId, clientRunId, sessionKey) => {
-			const entry = chatRuns.get(sessionId);
-			if (!entry || entry.clientRunId !== clientRunId) return;
-			if (sessionKey !== void 0 && entry.sessionKey !== sessionKey) return;
-			chatRuns.delete(sessionId);
-			return entry;
-		},
-		subscribeSessionEvents: (connId) => {
-			sessionEvents.add(connId);
-		},
-		unsubscribeSessionEvents: (connId) => {
-			sessionEvents.delete(connId);
-		},
-		subscribeSessionMessageEvents: () => {},
-		unsubscribeSessionMessageEvents: () => {},
-		unsubscribeAllSessionEvents: (connId) => {
-			sessionEvents.delete(connId);
-		},
-		getSessionEventSubscriberConnIds: () => sessionEvents,
-		registerToolEventRecipient: () => {},
-		dedupe: /* @__PURE__ */ new Map(),
-		wizardSessions: /* @__PURE__ */ new Map(),
-		findRunningWizard: () => null,
-		purgeWizardSession: () => {},
-		getRuntimeSnapshot: () => ({}),
-		startChannel: async () => {
-			throw new Error("通道启动在本地嵌入式 agent 网关上下文中不可用");
-		},
-		stopChannel: async () => {
-			throw new Error("通道停止在本地嵌入式 agent 网关上下文中不可用");
-		},
-		markChannelLoggedOut: () => {},
-		wizardRunner: async () => {
-			throw new Error("引导向导在本地嵌入式 agent 网关上下文中不可用");
-		},
-		broadcastVoiceWakeChanged: () => {},
-		broadcastVoiceWakeRoutingChanged: () => {},
-		unavailableGatewayMethods: /* @__PURE__ */ new Set()
-	};
-}
-function withLocalGatewayRequestScope(params, run) {
-	const existing = getPluginRuntimeGatewayRequestScope();
-	if (existing?.context) return run();
-	const context = createLocalGatewayRequestContext(params);
-	return withPluginRuntimeGatewayRequestScope({
-		...existing,
-		context,
-		isWebchatConnect: existing?.isWebchatConnect ?? (() => false)
-	}, run);
-}
-//#endregion
-//#region src/agents/agent-runtime-config.ts
-async function resolveAgentRuntimeConfig(runtime, params) {
-	const loadedRaw = getRuntimeConfig();
-	const includeChannelTargets = params?.runtimeTargetsChannelSecrets === true;
-	const hasRuntimeSecretRefs = hasAgentRuntimeSecretRefs({
-		config: loadedRaw,
-		includeChannelTargets
-	});
-	const sourceConfig = await (async () => {
-		try {
-			const { snapshot } = await readConfigFileSnapshotForWrite();
-			if (snapshot.valid) return snapshot.resolved;
-		} catch {}
-		return loadedRaw;
-	})();
-	const cfg = hasRuntimeSecretRefs ? (await (await import("./command-config-resolution.runtime.js")).resolveCommandConfigWithSecrets({
-		config: loadedRaw,
-		commandName: "agent",
-		targetIds: getAgentRuntimeCommandSecretTargetIds({ includeChannelTargets }),
-		runtime
-	})).resolvedConfig : loadedRaw;
-	setRuntimeConfigSnapshot(cfg, sourceConfig);
-	return {
-		loadedRaw,
-		sourceConfig,
-		cfg
-	};
-}
-function hasNestedSecretRef(value) {
-	if (isSecretRef(value)) return true;
-	if (Array.isArray(value)) return value.some((entry) => hasNestedSecretRef(entry));
-	if (!value || typeof value !== "object") return false;
-	return Object.values(value).some((entry) => hasNestedSecretRef(entry));
-}
-function hasAgentRuntimeSecretRefs(params) {
-	const { config } = params;
-	if (hasNestedSecretRef(config.models?.providers)) return true;
-	if (hasNestedSecretRef(config.agents?.defaults?.memorySearch?.remote?.apiKey)) return true;
-	if (Array.isArray(config.agents?.list) && config.agents.list.some((agent) => hasNestedSecretRef(agent?.memorySearch?.remote?.apiKey))) return true;
-	if (hasNestedSecretRef(config.messages?.tts?.providers)) return true;
-	if (hasNestedSecretRef(config.skills?.entries)) return true;
-	if (hasNestedSecretRef(config.tools?.web?.search)) return true;
-	if (config.plugins?.entries && Object.values(config.plugins.entries).some((entry) => hasNestedSecretRef({
-		webSearch: entry?.config?.webSearch,
-		webFetch: entry?.config?.webFetch
-	}))) return true;
-	return params.includeChannelTargets ? hasNestedSecretRef(config.channels) : false;
-}
-//#endregion
-//#region src/agents/command/attempt-callbacks.ts
-function createAgentAttemptLifecycleCallbacks(state) {
-	return {
-		onUserMessagePersisted: () => {
-			state.currentTurnUserMessagePersisted = true;
-		},
-		onAgentEvent: (evt) => {
-			if (evt.stream !== "lifecycle" || typeof evt.data?.phase !== "string") return;
-			if (evt.data.phase === "finishing") {
-				state.lifecycleFinishing = true;
-				return;
-			}
-			if (evt.data.phase === "end" || evt.data.phase === "error") state.lifecycleEnded = true;
-		}
-	};
-}
-//#endregion
-//#region src/agents/agent-command.ts
-const log = createSubsystemLogger("agents/agent-command");
-const attemptExecutionRuntimeLoader = createLazyImportLoader(() => import("./attempt-execution.runtime.js"));
-const acpManagerRuntimeLoader = createLazyImportLoader(() => import("./acp/control-plane/manager.js"));
-const acpPolicyRuntimeLoader = createLazyImportLoader(() => import("./policy-DWXE0Hco.js"));
-const acpRuntimeErrorsRuntimeLoader = createLazyImportLoader(() => import("./errors-BmxyC5ae.js"));
-const acpSessionIdentifiersRuntimeLoader = createLazyImportLoader(() => import("./session-identifiers-DoZlH9hS.js"));
-const deliveryRuntimeLoader = createLazyImportLoader(() => import("./delivery.runtime.js"));
-const sessionStoreRuntimeLoader = createLazyImportLoader(() => import("./session-store.runtime.js"));
-const cliCompactionRuntimeLoader = createLazyImportLoader(() => import("./cli-compaction-YZpssARf.js"));
-const transcriptResolveRuntimeLoader = createLazyImportLoader(() => import("./transcript-resolve.runtime.js"));
-const cliDepsRuntimeLoader = createLazyImportLoader(() => import("./deps-E1HVodxC.js"));
-const execDefaultsRuntimeLoader = createLazyImportLoader(() => import("./exec-defaults-DoruZ64y.js"));
-const skillsRuntimeLoader = createLazyImportLoader(async () => {
-	const [remote, sessionSnapshot] = await Promise.all([import("./remote-D1R1sJU5.js"), import("./session-snapshot-CiD1zBwL.js")]);
-	return {
-		getRemoteSkillEligibility: remote.getRemoteSkillEligibility,
-		resolveReusableWorkspaceSkillSnapshot: sessionSnapshot.resolveReusableWorkspaceSkillSnapshot
-	};
-});
-function loadAttemptExecutionRuntime() {
-	return attemptExecutionRuntimeLoader.load();
-}
-function loadAcpManagerRuntime() {
-	return acpManagerRuntimeLoader.load();
-}
-function loadAcpPolicyRuntime() {
-	return acpPolicyRuntimeLoader.load();
-}
-function loadAcpRuntimeErrorsRuntime() {
-	return acpRuntimeErrorsRuntimeLoader.load();
-}
-function loadAcpSessionIdentifiersRuntime() {
-	return acpSessionIdentifiersRuntimeLoader.load();
-}
-function loadDeliveryRuntime() {
-	return deliveryRuntimeLoader.load();
-}
-function loadSessionStoreRuntime() {
-	return sessionStoreRuntimeLoader.load();
-}
-function loadCliCompactionRuntime() {
-	return cliCompactionRuntimeLoader.load();
-}
-function loadTranscriptResolveRuntime() {
-	return transcriptResolveRuntimeLoader.load();
-}
-function loadCliDepsRuntime() {
-	return cliDepsRuntimeLoader.load();
-}
-function loadExecDefaultsRuntime() {
-	return execDefaultsRuntimeLoader.load();
-}
-function loadSkillsRuntime() {
-	return skillsRuntimeLoader.load();
-}
-async function resolveAgentCommandDeps(deps) {
-	if (deps) return deps;
-	const { createDefaultDeps } = await loadCliDepsRuntime();
-	return createDefaultDeps();
-}
-const OVERRIDE_FIELDS_CLEARED_BY_DELETE = [
-	"providerOverride",
-	"modelOverride",
-	"modelOverrideSource",
-	"modelOverrideFallbackOriginProvider",
-	"modelOverrideFallbackOriginModel",
-	"authProfileOverride",
-	"authProfileOverrideSource",
-	"authProfileOverrideCompactionCount",
-	"fallbackNoticeSelectedModel",
-	"fallbackNoticeActiveModel",
-	"fallbackNoticeReason",
-	"claudeCliSessionId"
-];
-const OVERRIDE_VALUE_MAX_LENGTH = 256;
-async function persistSessionEntry(params) {
-	return await persistSessionEntry$1({
-		...params,
-		clearedFields: OVERRIDE_FIELDS_CLEARED_BY_DELETE
-	});
-}
-function clearPendingFinalDeliveryFields(entry, updatedAt) {
-	return {
-		...entry,
-		pendingFinalDelivery: void 0,
-		pendingFinalDeliveryText: void 0,
-		pendingFinalDeliveryCreatedAt: void 0,
-		pendingFinalDeliveryLastAttemptAt: void 0,
-		pendingFinalDeliveryAttemptCount: void 0,
-		pendingFinalDeliveryLastError: void 0,
-		pendingFinalDeliveryContext: void 0,
-		pendingFinalDeliveryIntentId: void 0,
-		updatedAt
-	};
-}
-function containsControlCharacters(value) {
-	for (const char of value) {
-		const code = char.codePointAt(0);
-		if (code === void 0) continue;
-		if (code <= 31 || code >= 127 && code <= 159) return true;
-	}
-	return false;
-}
-function normalizeExplicitOverrideInput(raw, kind) {
-	const trimmed = raw.trim();
-	const label = kind === "provider" ? "Provider" : "Model";
-	if (!trimmed) throw new Error(`${label} override must be non-empty.`);
-	if (trimmed.length > OVERRIDE_VALUE_MAX_LENGTH) throw new Error(`${label} override exceeds ${String(OVERRIDE_VALUE_MAX_LENGTH)} characters.`);
-	if (containsControlCharacters(trimmed)) throw new Error(`${label} override contains invalid control characters.`);
-	return trimmed;
-}
-function createAgentCommandSessionWorkingCopy(params) {
-	const result = {};
-	if (params.sessionEntry) result.sessionEntry = { ...params.sessionEntry };
-	if (params.sessionStore || params.sessionKey) result.sessionStore = {};
-	if (params.sessionKey && result.sessionEntry && result.sessionStore) result.sessionStore[params.sessionKey] = result.sessionEntry;
-	return result;
-}
-function resolveExplicitAgentCommandSessionKey(params) {
-	if (isUnscopedSessionKeySentinel(params.rawExplicitSessionKey) && !params.shouldScopeDefaultAgentKey) return params.rawExplicitSessionKey;
-	return scopeLegacySessionKeyToAgent({
-		agentId: params.agentIdOverride ?? (params.shouldScopeDefaultAgentKey ? resolveDefaultAgentId(params.cfg) : void 0),
-		sessionKey: params.rawExplicitSessionKey,
-		mainKey: params.cfg.session?.mainKey
-	});
-}
-async function prepareAgentCommandExecution(opts, runtime) {
-	const isRawModelRun = opts.modelRun === true || opts.promptMode === "none";
-	const message = opts.message ?? "";
-	if (!message.trim()) throw new Error("缺少必需参数：--message");
-	const rawExplicitSessionKey = opts.sessionKey?.trim();
-	if (!opts.to && !opts.sessionId && !rawExplicitSessionKey && !opts.agentId) throw new Error("Pass --to <E.164>, --session-key, --session-id, or --agent to choose a session");
-	const { cfg } = await resolveAgentRuntimeConfig(runtime, { runtimeTargetsChannelSecrets: opts.deliver === true });
-	const normalizedSpawned = normalizeSpawnedRunMetadata({
-		spawnedBy: opts.spawnedBy,
-		groupId: opts.groupId,
-		groupChannel: opts.groupChannel,
-		groupSpace: opts.groupSpace,
-		workspaceDir: opts.workspaceDir
-	});
-	const agentIdOverrideRaw = opts.agentId?.trim();
-	const agentIdOverride = agentIdOverrideRaw ? normalizeAgentId(agentIdOverrideRaw) : void 0;
-	if (agentIdOverride) {
-		if (!listAgentIds(cfg).includes(agentIdOverride)) throw new Error(`Unknown agent id "${agentIdOverrideRaw}". Use "${formatCliCommand("fengming agents list")}" to see configured agents.`);
-	}
-	const explicitSessionKey = resolveExplicitAgentCommandSessionKey({
-		rawExplicitSessionKey,
-		agentIdOverride,
-		shouldScopeDefaultAgentKey: Boolean(rawExplicitSessionKey && !agentIdOverride && classifySessionKeyShape(rawExplicitSessionKey) === "legacy_or_alias" && !isUnscopedSessionKeySentinel(rawExplicitSessionKey)),
-		cfg
-	});
-	if (explicitSessionKey && classifySessionKeyShape(explicitSessionKey) === "malformed_agent") throw new Error(`Invalid --session-key "${explicitSessionKey}". Agent-prefixed session keys must use agent:<agent-id>:<session-key>.`);
-	if (agentIdOverride && explicitSessionKey && classifySessionKeyShape(explicitSessionKey) === "agent") {
-		const sessionAgentId = resolveAgentIdFromSessionKey(explicitSessionKey);
-		if (sessionAgentId !== agentIdOverride) throw new Error(`Agent id "${agentIdOverrideRaw}" does not match session key agent "${sessionAgentId}".`);
-	}
-	const agentCfg = cfg.agents?.defaults;
-	const verboseOverride = normalizeVerboseLevel(opts.verbose);
-	if (opts.verbose && !verboseOverride) throw new Error("Invalid verbose level. Use \"on\", \"full\", or \"off\".");
-	const isSubagentLane = (normalizeOptionalString(opts.lane) ?? "") === AGENT_LANE_SUBAGENT;
-	const timeoutSecondsRaw = opts.timeout !== void 0 ? parseStrictNonNegativeInteger(opts.timeout) ?? NaN : isSubagentLane ? 0 : void 0;
-	if (timeoutSecondsRaw !== void 0 && (Number.isNaN(timeoutSecondsRaw) || timeoutSecondsRaw < 0)) throw new Error("--timeout 必须为非负整数（秒；0 表示无超时）");
-	const timeoutMs = resolveAgentTimeoutMs({
-		cfg,
-		overrideSeconds: timeoutSecondsRaw
-	});
-	const sessionResolution = resolveSession({
-		cfg,
-		to: opts.to,
-		sessionId: opts.sessionId,
-		sessionKey: explicitSessionKey,
-		agentId: agentIdOverride,
-		clone: false
-	});
-	const { sessionId, sessionKey, storePath, isNewSession, persistedThinking, persistedVerbose } = sessionResolution;
-	const { sessionEntry: sessionEntryRaw, sessionStore } = createAgentCommandSessionWorkingCopy({
-		sessionKey,
-		sessionEntry: sessionResolution.sessionEntry,
-		sessionStore: sessionResolution.sessionStore
-	});
-	const sessionAgentId = agentIdOverride ?? resolveSessionAgentId({
-		sessionKey: sessionKey ?? explicitSessionKey,
-		config: cfg
-	});
-	const outboundSession = buildOutboundSessionContext({
-		cfg,
-		agentId: sessionAgentId,
-		sessionKey
-	});
-	const workspaceDirRaw = normalizedSpawned.workspaceDir ?? resolveAgentWorkspaceDir(cfg, sessionAgentId);
-	const workspaceDir = resolveUserPath(workspaceDirRaw);
-	const cwd = normalizeOptionalString(opts.cwd) ?? normalizeOptionalString(sessionEntryRaw?.spawnedCwd);
-	const agentDir = resolveAgentDir(cfg, sessionAgentId);
-	const modelManifestContext = { manifestPlugins: loadManifestMetadataSnapshot({
-		config: cfg,
-		workspaceDir,
-		env: process.env
-	}).plugins };
-	const configuredModel = resolveConfiguredModelRef({
-		cfg,
-		defaultProvider: DEFAULT_PROVIDER,
-		defaultModel: DEFAULT_MODEL,
-		...modelManifestContext
-	});
-	const configuredThinkingCatalog = buildConfiguredModelCatalog({
-		cfg,
-		workspaceDir,
-		...modelManifestContext
-	});
-	const thinkingLevelsHint = formatThinkingLevels(configuredModel.provider, configuredModel.model, ", ", configuredThinkingCatalog.length > 0 ? configuredThinkingCatalog : void 0);
-	const thinkOverride = normalizeThinkLevel(opts.thinking);
-	const thinkOnce = normalizeThinkLevel(opts.thinkingOnce);
-	if (opts.thinking && !thinkOverride) throw new Error(`Invalid thinking level. Use one of: ${thinkingLevelsHint}.`);
-	if (opts.thinkingOnce && !thinkOnce) throw new Error(`Invalid one-shot thinking level. Use one of: ${thinkingLevelsHint}.`);
-	await ensureAgentWorkspace({
-		dir: workspaceDirRaw,
-		ensureBootstrapFiles: !agentCfg?.skipBootstrap,
-		skipOptionalBootstrapFiles: agentCfg?.skipOptionalBootstrapFiles
-	});
-	const runId = opts.runId?.trim() || sessionId;
-	const { getAcpSessionManager } = await loadAcpManagerRuntime();
-	const acpManager = getAcpSessionManager();
-	const acpResolution = sessionKey ? acpManager.resolveSession({
-		cfg,
-		sessionKey
-	}) : null;
-	return {
-		body: !isRawModelRun && acpResolution?.kind === "ready" ? resolveAcpPromptBody(message, opts.internalEvents) : prependInternalEventContext(message, opts.internalEvents),
-		transcriptBody: opts.transcriptMessage ?? resolveInternalEventTranscriptBody(message, opts.internalEvents),
-		cfg,
-		configuredThinkingCatalog,
-		normalizedSpawned,
-		agentCfg,
-		thinkOverride,
-		thinkOnce,
-		verboseOverride,
-		timeoutMs,
-		sessionId,
-		sessionKey,
-		sessionEntry: sessionEntryRaw,
-		sessionStore,
-		storePath,
-		isNewSession,
-		persistedThinking,
-		persistedVerbose,
-		sessionAgentId,
-		outboundSession,
-		workspaceDir,
-		cwd: cwd ? resolveUserPath(cwd) : void 0,
-		agentDir,
-		modelManifestContext,
-		runId,
-		acpManager,
-		acpResolution
-	};
-}
-async function agentCommandInternal(opts, runtime = defaultRuntime, deps) {
-	const resolvedDeps = await resolveAgentCommandDeps(deps);
-	const isRawModelRun = opts.modelRun === true || opts.promptMode === "none";
-	const suppressVisibleSessionEffects = opts.sessionEffects === "internal";
-	const preserveUserFacingSessionModelState = opts.preserveUserFacingSessionModelState === true;
-	const prepared = await prepareAgentCommandExecution(opts, runtime);
-	const { body, transcriptBody, cfg, configuredThinkingCatalog, normalizedSpawned, agentCfg, thinkOverride, thinkOnce, verboseOverride, timeoutMs, sessionId, sessionKey, sessionStore, storePath, isNewSession, persistedThinking, persistedVerbose, sessionAgentId, outboundSession, workspaceDir, cwd, agentDir, runId, acpManager, acpResolution, modelManifestContext } = prepared;
-	const effectiveCwd = cwd ? resolveUserPath(cwd) : workspaceDir;
-	let sessionEntry = prepared.sessionEntry;
-	try {
-		if (opts.deliver === true) {
-			if (resolveSendPolicy({
-				cfg,
-				entry: sessionEntry,
-				sessionKey,
-				channel: sessionEntry?.channel,
-				chatType: sessionEntry?.chatType
-			}) === "deny") throw new Error("send blocked by session policy");
-		}
-		if (!isRawModelRun && acpResolution?.kind === "stale") throw acpResolution.error;
-		if (!isRawModelRun && acpResolution?.kind === "ready" && sessionKey) {
-			const attemptExecutionRuntime = await loadAttemptExecutionRuntime();
-			const startedAt = Date.now();
-			registerAgentRunContext(runId, suppressVisibleSessionEffects ? { isControlUiVisible: false } : { sessionKey });
-			attemptExecutionRuntime.emitAcpLifecycleStart({
-				runId,
-				startedAt
-			});
-			const visibleTextAccumulator = attemptExecutionRuntime.createAcpVisibleTextAccumulator();
-			let stopReason;
-			try {
-				const { resolveAcpAgentPolicyError, resolveAcpDispatchPolicyError, resolveAcpExplicitTurnPolicyError } = await loadAcpPolicyRuntime();
-				const turnPolicyError = opts.acpTurnSource === "manual_spawn" ? resolveAcpExplicitTurnPolicyError(cfg) : resolveAcpDispatchPolicyError(cfg);
-				if (turnPolicyError) throw turnPolicyError;
-				const agentPolicyError = resolveAcpAgentPolicyError(cfg, normalizeAgentId(acpResolution.meta.agent || resolveAgentIdFromSessionKey(sessionKey)));
-				if (agentPolicyError) throw agentPolicyError;
-				const acpImageAttachments = resolveInlineAgentImageAttachments(opts.images);
-				await acpManager.runTurn({
-					cfg,
-					sessionKey,
-					text: body,
-					attachments: acpImageAttachments.length > 0 ? acpImageAttachments : void 0,
-					mode: "prompt",
-					requestId: runId,
-					signal: opts.abortSignal,
-					onLifecycle: (event) => {
-						if (event.type === "prompt_submitted") attemptExecutionRuntime.emitAcpPromptSubmitted({
-							runId,
-							sessionKey,
-							at: event.at
-						});
-					},
-					onEvent: (event) => {
-						if (event.type !== "text_delta") attemptExecutionRuntime.emitAcpRuntimeEvent({
-							runId,
-							sessionKey,
-							event
-						});
-						if (event.type === "done") {
-							stopReason = event.stopReason;
-							return;
-						}
-						if (event.type !== "text_delta") return;
-						if (event.stream && event.stream !== "output") return;
-						if (!event.text) return;
-						const visibleUpdate = visibleTextAccumulator.consume(event.text);
-						if (!visibleUpdate) return;
-						attemptExecutionRuntime.emitAcpAssistantDelta({
-							runId,
-							text: visibleUpdate.text,
-							delta: visibleUpdate.delta
-						});
-					}
-				});
-			} catch (error) {
-				const { toAcpRuntimeError } = await loadAcpRuntimeErrorsRuntime();
-				const acpError = toAcpRuntimeError({
-					error,
-					fallbackCode: "ACP_TURN_FAILED",
-					fallbackMessage: "ACP turn failed before completion."
-				});
-				attemptExecutionRuntime.emitAcpLifecycleError({
-					runId,
-					error: acpError,
-					sessionKey
-				});
-				throw acpError;
-			}
-			attemptExecutionRuntime.emitAcpLifecycleEnd({ runId });
-			const finalTextRaw = visibleTextAccumulator.finalizeRaw();
-			const finalText = visibleTextAccumulator.finalize();
-			try {
-				const [{ resolveAcpSessionCwd }, { resolveSessionTranscriptFile }] = await Promise.all([loadAcpSessionIdentifiersRuntime(), loadTranscriptResolveRuntime()]);
-				const internalSource = suppressVisibleSessionEffects ? await resolveSessionTranscriptFile({
-					sessionId,
-					sessionKey,
-					sessionEntry,
-					agentId: sessionAgentId,
-					threadId: opts.threadId
-				}) : void 0;
-				const internalSessionFile = suppressVisibleSessionEffects ? await prepareInternalSessionEffectsTranscript({
-					sessionFile: internalSource?.sessionFile,
-					runId
-				}) : void 0;
-				const transcriptSessionEntry = internalSessionFile ? {
-					...sessionEntry ?? {
-						sessionId,
-						updatedAt: Date.now(),
-						sessionStartedAt: Date.now()
-					},
-					sessionId,
-					sessionFile: internalSessionFile
-				} : sessionEntry;
-				sessionEntry = await attemptExecutionRuntime.persistAcpTurnTranscript({
-					body,
-					transcriptBody,
-					finalText: finalTextRaw,
-					sessionId,
-					sessionKey,
-					sessionEntry: transcriptSessionEntry,
-					sessionStore: suppressVisibleSessionEffects ? void 0 : sessionStore,
-					storePath: suppressVisibleSessionEffects ? void 0 : storePath,
-					sessionAgentId,
-					threadId: opts.threadId,
-					sessionCwd: resolveAcpSessionCwd(acpResolution.meta) ?? workspaceDir,
-					config: cfg
-				});
-				if (internalSessionFile) sessionEntry = prepared.sessionEntry;
-			} catch (error) {
-				log.warn(`ACP transcript persistence failed for ${sessionKey}: ${formatErrorMessage(error)}`);
-			}
-			const result = attemptExecutionRuntime.buildAcpResult({
-				payloadText: finalText,
-				startedAt,
-				stopReason,
-				abortSignal: opts.abortSignal
-			});
-			const payloads = result.payloads;
-			const { deliverAgentCommandResult } = await loadDeliveryRuntime();
-			return await deliverAgentCommandResult({
-				cfg,
-				deps: resolvedDeps,
-				runtime,
-				opts,
-				outboundSession,
-				sessionEntry,
-				result,
-				payloads
-			});
-		}
-		let resolvedThinkLevel = thinkOnce ?? thinkOverride ?? persistedThinking;
-		const resolvedVerboseLevel = verboseOverride ?? persistedVerbose ?? agentCfg?.verboseDefault;
-		if (sessionKey || suppressVisibleSessionEffects) registerAgentRunContext(runId, {
-			...sessionKey && !suppressVisibleSessionEffects ? { sessionKey } : {},
-			verboseLevel: resolvedVerboseLevel,
-			isControlUiVisible: !suppressVisibleSessionEffects
-		});
-		const skillFilter = resolveEffectiveAgentSkillFilter(cfg, sessionAgentId);
-		const currentSkillsSnapshot = sessionEntry?.skillsSnapshot;
-		const [{ getRemoteSkillEligibility, resolveReusableWorkspaceSkillSnapshot }, { canExecRequestNode }] = await Promise.all([loadSkillsRuntime(), loadExecDefaultsRuntime()]);
-		const skillSnapshotState = resolveReusableWorkspaceSkillSnapshot({
-			workspaceDir,
-			config: cfg,
-			agentId: sessionAgentId,
-			existingSnapshot: isNewSession ? void 0 : currentSkillsSnapshot,
-			skillFilter,
-			eligibility: { remote: getRemoteSkillEligibility({ advertiseExecNode: canExecRequestNode({
-				cfg,
-				sessionEntry,
-				sessionKey,
-				agentId: sessionAgentId
-			}) }) },
-			watch: false
-		});
-		const needsSkillsSnapshot = isNewSession || !currentSkillsSnapshot || skillSnapshotState.shouldRefresh;
-		const skillsSnapshot = skillSnapshotState.snapshot;
-		if (skillsSnapshot && sessionStore && sessionKey && needsSkillsSnapshot && !suppressVisibleSessionEffects) {
-			const now = Date.now();
-			const current = sessionEntry ?? {
-				sessionId,
-				updatedAt: now,
-				sessionStartedAt: now
-			};
-			const next = {
-				...current,
-				sessionId,
-				updatedAt: now,
-				sessionStartedAt: current.sessionStartedAt ?? now,
-				skillsSnapshot
-			};
-			await persistSessionEntry({
-				sessionStore,
-				sessionKey,
-				storePath,
-				entry: next
-			});
-			sessionEntry = next;
-		}
-		const hasInitialSessionOverrides = Boolean(thinkOverride || verboseOverride);
-		const shouldPersistInitialSessionTouch = opts.skipInitialSessionTouch !== true || hasInitialSessionOverrides;
-		if (sessionStore && sessionKey && !suppressVisibleSessionEffects && shouldPersistInitialSessionTouch) {
-			const now = Date.now();
-			const entry = sessionStore[sessionKey] ?? sessionEntry ?? {
-				sessionId,
-				updatedAt: now,
-				sessionStartedAt: now
-			};
-			const next = {
-				...entry,
-				sessionId,
-				updatedAt: now,
-				sessionStartedAt: entry.sessionStartedAt ?? now,
-				lastInteractionAt: now
-			};
-			if (thinkOverride) next.thinkingLevel = thinkOverride;
-			applyVerboseOverride(next, verboseOverride);
-			await persistSessionEntry({
-				sessionStore,
-				sessionKey,
-				storePath,
-				entry: next
-			});
-			sessionEntry = next;
-		}
-		const configuredDefaultRef = resolveDefaultModelForAgent({
-			cfg,
-			agentId: sessionAgentId,
-			...modelManifestContext
-		});
-		const { provider: defaultProvider, model: defaultModel } = normalizeModelRef(configuredDefaultRef.provider, configuredDefaultRef.model, modelManifestContext);
-		let provider = defaultProvider;
-		let model = defaultModel;
-		const hasAllowlist = agentCfg?.models && Object.keys(agentCfg.models).length > 0;
-		const hasStoredOverride = Boolean(sessionEntry?.modelOverride || sessionEntry?.providerOverride);
-		let storedModelOverrideSource = hasStoredOverride ? sessionEntry?.modelOverrideSource : void 0;
-		const hasStoredAutoFallbackProvenance = hasStoredOverride && hasSessionAutoModelFallbackProvenance(sessionEntry);
-		const explicitProviderOverride = typeof opts.provider === "string" ? normalizeExplicitOverrideInput(opts.provider, "provider") : void 0;
-		const explicitModelOverride = typeof opts.model === "string" ? normalizeExplicitOverrideInput(opts.model, "model") : void 0;
-		const hasExplicitRunOverride = Boolean(explicitProviderOverride || explicitModelOverride);
-		if (hasExplicitRunOverride && opts.allowModelOverride !== true) throw new Error("当前调用方无权覆盖模型设置。");
-		const needsModelCatalog = Boolean(hasAllowlist);
-		let allowedModelCatalog = [];
-		let modelCatalog = null;
-		let visibilityPolicy = createModelVisibilityPolicy({
-			cfg,
-			catalog: [],
-			defaultProvider,
-			defaultModel,
-			allowManifestNormalization: true,
-			allowPluginNormalization: true,
-			...modelManifestContext
-		});
-		if (needsModelCatalog) {
-			modelCatalog = loadManifestModelCatalog({
-				config: cfg,
-				workspaceDir
-			});
-			visibilityPolicy = createModelVisibilityPolicy({
-				cfg,
-				catalog: modelCatalog,
-				defaultProvider,
-				defaultModel,
-				agentId: sessionAgentId,
-				allowManifestNormalization: true,
-				allowPluginNormalization: true,
-				...modelManifestContext
-			});
-			allowedModelCatalog = visibilityPolicy.allowedCatalog;
-		}
-		if (sessionEntry && sessionStore && sessionKey && hasStoredOverride && !suppressVisibleSessionEffects) {
-			const entry = sessionEntry;
-			if (repairProviderWrappedModelOverride({
-				entry,
-				defaultProvider,
-				defaultModel
-			}).updated) await persistSessionEntry({
-				sessionStore,
-				sessionKey,
-				storePath,
-				entry
-			});
-			const overrideProvider = sessionEntry.providerOverride?.trim() || defaultProvider;
-			const overrideModel = sessionEntry.modelOverride?.trim();
-			if (overrideModel) {
-				const normalizedOverride = normalizeModelRef(overrideProvider, overrideModel, modelManifestContext);
-				const key = modelKey(normalizedOverride.provider, normalizedOverride.model);
-				if (!visibilityPolicy.allowsKey(key)) {
-					const { updated } = applyModelOverrideToSessionEntry({
-						entry,
-						selection: {
-							provider: defaultProvider,
-							model: defaultModel,
-							isDefault: true
-						}
-					});
-					if (updated) await persistSessionEntry({
-						sessionStore,
-						sessionKey,
-						storePath,
-						entry
-					});
-				}
-			}
-		}
-		const storedProviderOverride = sessionEntry?.providerOverride?.trim();
-		let storedModelOverride = sessionEntry?.modelOverride?.trim();
-		if (storedModelOverride) {
-			const normalizedStored = normalizeModelRef(storedProviderOverride || defaultProvider, storedModelOverride, modelManifestContext);
-			const key = modelKey(normalizedStored.provider, normalizedStored.model);
-			if (visibilityPolicy.allowsKey(key)) {
-				provider = normalizedStored.provider;
-				model = normalizedStored.model;
-			}
-		}
-		const autoFallbackPrimaryProbe = !hasExplicitRunOverride ? resolveAutoFallbackPrimaryProbe({
-			entry: sessionEntry,
-			sessionKey,
-			primaryProvider: defaultProvider,
-			primaryModel: defaultModel
-		}) : void 0;
-		let autoFallbackPrimaryProbeSessionEntry;
-		if (autoFallbackPrimaryProbe && sessionEntry) {
-			provider = autoFallbackPrimaryProbe.provider;
-			model = autoFallbackPrimaryProbe.model;
-			autoFallbackPrimaryProbeSessionEntry = { ...sessionEntry };
-			clearAutoFallbackPrimaryProbeSelection(autoFallbackPrimaryProbeSessionEntry);
-		}
-		let providerForAuthProfileValidation = provider;
-		if (hasExplicitRunOverride) {
-			const explicitRef = explicitModelOverride ? explicitProviderOverride ? normalizeModelRef(explicitProviderOverride, explicitModelOverride, modelManifestContext) : parseModelRef(explicitModelOverride, provider, modelManifestContext) : explicitProviderOverride ? normalizeModelRef(explicitProviderOverride, model, modelManifestContext) : null;
-			if (!explicitRef) throw new Error("无效的模型覆盖设置。");
-			const explicitKey = modelKey(explicitRef.provider, explicitRef.model);
-			if (!visibilityPolicy.allowsKey(explicitKey)) throw new Error(`Model override "${sanitizeForLog(explicitRef.provider)}/${sanitizeForLog(explicitRef.model)}" is not allowed for agent "${sessionAgentId}".`);
-			provider = explicitRef.provider;
-			model = explicitRef.model;
-		}
-		const allowedInitialSelection = visibilityPolicy.resolveSelection({
-			provider,
-			model
-		});
-		if (!allowedInitialSelection) throw new Error(`Configured default model "${modelKey(provider, model)}" is not allowed by agents.defaults.models, and no allowed model is available.`);
-		provider = allowedInitialSelection.provider;
-		model = allowedInitialSelection.model;
-		providerForAuthProfileValidation = provider;
-		await ensureSelectedAgentHarnessPlugin({
-			config: cfg,
-			provider,
-			modelId: model,
-			agentId: sessionAgentId,
-			sessionKey,
-			workspaceDir
-		});
-		let sessionEntryForAttempt = autoFallbackPrimaryProbeSessionEntry ?? sessionEntry;
-		if (sessionEntryForAttempt) {
-			const authProfileId = sessionEntryForAttempt.authProfileOverride;
-			if (authProfileId) {
-				const entry = sessionEntryForAttempt;
-				const profile = ensureAuthProfileStore().profiles[authProfileId];
-				const validationHarnessPolicy = resolveAvailableAgentHarnessPolicy({
-					provider: providerForAuthProfileValidation,
-					modelId: model,
-					config: cfg,
-					agentId: sessionAgentId,
-					sessionKey
-				});
-				const acceptedAuthProviders = listOpenAIAuthProfileProvidersForAgentRuntime({
-					provider: providerForAuthProfileValidation,
-					harnessRuntime: validationHarnessPolicy.runtime,
-					config: cfg
-				}).map((candidateProvider) => resolveProviderIdForAuth(candidateProvider, {
-					config: cfg,
-					workspaceDir
-				}));
-				if (!(profile && acceptedAuthProviders.some((candidateProvider) => isStoredCredentialCompatibleWithAuthProvider({
-					cfg,
-					provider: candidateProvider,
-					credential: profile
-				})))) {
-					if (hasExplicitRunOverride || autoFallbackPrimaryProbe) sessionEntryForAttempt = {
-						...entry,
-						authProfileOverride: void 0,
-						authProfileOverrideSource: void 0,
-						authProfileOverrideCompactionCount: void 0
-					};
-					else if (sessionStore && sessionKey && !suppressVisibleSessionEffects) await clearSessionAuthProfileOverride({
-						sessionEntry: entry,
-						sessionStore,
-						sessionKey,
-						storePath
-					});
-				}
-			}
-		}
-		const catalogForThinking = allowedModelCatalog.length > 0 ? allowedModelCatalog : modelCatalog && modelCatalog.length > 0 ? modelCatalog : configuredThinkingCatalog;
-		const thinkingCatalog = catalogForThinking.length > 0 ? catalogForThinking : void 0;
-		if (!resolvedThinkLevel) resolvedThinkLevel = normalizeThinkLevel(resolveAgentConfig(cfg, sessionAgentId)?.thinkingDefault) ?? resolveThinkingDefault({
-			cfg,
-			provider,
-			model,
-			catalog: thinkingCatalog
-		});
-		if (!isThinkingLevelSupported({
-			provider,
-			model,
-			level: resolvedThinkLevel,
-			catalog: thinkingCatalog
-		})) {
-			if (Boolean(thinkOnce || thinkOverride)) throw new Error(`Thinking level "${resolvedThinkLevel}" is not supported for ${provider}/${model}. Use one of: ${formatThinkingLevels(provider, model, ", ", thinkingCatalog)}.`);
-			const fallbackThinkLevel = resolveSupportedThinkingLevel({
-				provider,
-				model,
-				level: resolvedThinkLevel,
-				catalog: thinkingCatalog
-			});
-			if (fallbackThinkLevel !== resolvedThinkLevel) {
-				const previousThinkLevel = resolvedThinkLevel;
-				resolvedThinkLevel = fallbackThinkLevel;
-				if (sessionEntry && sessionStore && sessionKey && sessionEntry.thinkingLevel === previousThinkLevel && !suppressVisibleSessionEffects) {
-					const entry = sessionEntry;
-					entry.thinkingLevel = fallbackThinkLevel;
-					entry.updatedAt = Date.now();
-					await persistSessionEntry({
-						sessionStore,
-						sessionKey,
-						storePath,
-						entry
-					});
-				}
-			}
-		}
-		const { resolveSessionTranscriptFile } = await loadTranscriptResolveRuntime();
-		let sessionFile;
-		if (sessionStore && sessionKey) {
-			const resolvedSessionFile = await resolveSessionTranscriptFile({
-				sessionId,
-				sessionKey,
-				sessionStore: suppressVisibleSessionEffects ? void 0 : sessionStore,
-				storePath: suppressVisibleSessionEffects ? void 0 : storePath,
-				sessionEntry,
-				agentId: sessionAgentId,
-				threadId: opts.threadId
-			});
-			sessionFile = resolvedSessionFile.sessionFile;
-			sessionEntry = resolvedSessionFile.sessionEntry;
-		}
-		if (!sessionFile) {
-			const resolvedSessionFile = await resolveSessionTranscriptFile({
-				sessionId,
-				sessionKey: sessionKey ?? sessionId,
-				storePath,
-				sessionEntry,
-				agentId: sessionAgentId,
-				threadId: opts.threadId
-			});
-			sessionFile = resolvedSessionFile.sessionFile;
-			sessionEntry = resolvedSessionFile.sessionEntry;
-		}
-		const attemptSessionFile = suppressVisibleSessionEffects ? await prepareInternalSessionEffectsTranscript({
-			sessionFile,
-			runId
-		}) : sessionFile;
-		const startedAt = Date.now();
-		const attemptLifecycleState = {
-			currentTurnUserMessagePersisted: false,
-			lifecycleFinishing: false,
-			lifecycleEnded: false
-		};
-		const attemptLifecycleCallbacks = createAgentAttemptLifecycleCallbacks(attemptLifecycleState);
-		let lifecycleFinishingEmitted = false;
-		const emitLifecycleFinishing = (runResult) => {
-			if (attemptLifecycleState.lifecycleEnded || attemptLifecycleState.lifecycleFinishing || lifecycleFinishingEmitted) return;
-			lifecycleFinishingEmitted = true;
-			attemptLifecycleState.lifecycleFinishing = true;
-			emitAgentEvent({
-				runId,
-				stream: "lifecycle",
-				data: {
-					phase: "finishing",
-					startedAt,
-					endedAt: Date.now(),
-					aborted: runResult.meta.aborted ?? false,
-					stopReason: runResult.meta.stopReason
-				}
-			});
-		};
-		const emitLifecycleEnd = (runResult) => {
-			if (attemptLifecycleState.lifecycleEnded) return;
-			attemptLifecycleState.lifecycleEnded = true;
-			const stopReason = runResult.meta.stopReason;
-			if (stopReason && stopReason !== "end_turn") console.error(`[agent] run ${runId} ended with stopReason=${stopReason}`);
-			emitAgentEvent({
-				runId,
-				stream: "lifecycle",
-				data: {
-					phase: "end",
-					startedAt,
-					endedAt: Date.now(),
-					aborted: runResult.meta.aborted ?? false,
-					stopReason
-				}
-			});
-		};
-		const emitLifecyclePostTurnError = (error) => {
-			if (attemptLifecycleState.lifecycleEnded) return;
-			attemptLifecycleState.lifecycleEnded = true;
-			emitAgentEvent({
-				runId,
-				stream: "lifecycle",
-				data: {
-					phase: "error",
-					startedAt,
-					endedAt: Date.now(),
-					error: error instanceof Error ? error.message : "Agent run failed"
-				}
-			});
-		};
-		const attemptExecutionRuntime = await loadAttemptExecutionRuntime();
-		const runContext = resolveAgentRunContext(opts);
-		const messageChannel = resolveMessageChannel(runContext.messageChannel, opts.replyChannel ?? opts.channel);
-		let result;
-		let fallbackProvider = provider;
-		let fallbackModel = model;
-		const MAX_LIVE_SWITCH_RETRIES = 5;
-		let liveSwitchRetries = 0;
-		let autoFallbackPrimaryProbeInterruptedByLiveSwitch = false;
-		const fallbackTrajectoryRecorder = createTrajectoryRuntimeRecorder({
-			cfg,
-			runId,
-			sessionId,
-			sessionKey,
-			sessionFile,
-			provider,
-			modelId: model,
-			workspaceDir
-		});
-		for (;;) try {
-			const spawnedBy = normalizedSpawned.spawnedBy ?? sessionEntry?.spawnedBy;
-			const effectiveFallbacksOverride = resolveEffectiveModelFallbacks({
-				cfg,
-				agentId: sessionAgentId,
-				sessionKey,
-				hasSessionModelOverride: hasExplicitRunOverride || Boolean(storedProviderOverride || storedModelOverride),
-				modelOverrideSource: hasExplicitRunOverride ? "user" : storedModelOverrideSource,
-				hasAutoFallbackProvenance: hasExplicitRunOverride ? false : hasStoredAutoFallbackProvenance
-			});
-			let fallbackAttemptIndex = 0;
-			attemptLifecycleState.currentTurnUserMessagePersisted = false;
-			const fallbackResult = await runWithModelFallback({
-				cfg,
-				provider,
-				model,
-				...modelManifestContext,
-				runId,
-				agentDir,
-				agentId: sessionAgentId,
-				sessionKey: sessionKey ?? sessionId,
-				prepareAgentHarnessRuntime: async ({ provider, model, agentHarnessRuntimeOverride }) => {
-					await ensureSelectedAgentHarnessPlugin({
-						config: cfg,
-						provider,
-						modelId: model,
-						agentId: sessionAgentId,
-						sessionKey,
-						agentHarnessRuntimeOverride,
-						workspaceDir
-					});
-				},
-				fallbacksOverride: effectiveFallbacksOverride,
-				onFallbackStep: (step) => {
-					fallbackTrajectoryRecorder?.recordEvent("model.fallback_step", step);
-				},
-				classifyResult: ({ provider, model, result }) => classifyEmbeddedAgentRunResultForModelFallback({
-					provider,
-					model,
-					result
-				}),
-				abortSignal: opts.abortSignal,
-				run: async (providerOverride, modelOverride, runOptions) => {
-					const isAutoFallbackPrimaryProbeCandidate = autoFallbackPrimaryProbe && providerOverride === autoFallbackPrimaryProbe.provider && modelOverride === autoFallbackPrimaryProbe.model;
-					const attemptSessionEntry = autoFallbackPrimaryProbe && providerOverride === autoFallbackPrimaryProbe.fallbackProvider && !isAutoFallbackPrimaryProbeCandidate ? sessionEntry : sessionEntryForAttempt;
-					if (isAutoFallbackPrimaryProbeCandidate) markAutoFallbackPrimaryProbe({
-						probe: autoFallbackPrimaryProbe,
-						sessionKey
-					});
-					const isFallbackRetry = fallbackAttemptIndex > 0;
-					fallbackAttemptIndex += 1;
-					opts.onActiveModelSelected?.({
-						provider: providerOverride,
-						model: modelOverride
-					});
-					return attemptExecutionRuntime.runAgentAttempt({
-						providerOverride,
-						modelOverride,
-						modelFallbacksOverride: effectiveFallbacksOverride,
-						originalProvider: provider,
-						cfg,
-						sessionEntry: attemptSessionEntry,
-						sessionId,
-						sessionKey,
-						sessionAgentId,
-						sessionFile: attemptSessionFile,
-						workspaceDir,
-						cwd,
-						body,
-						isFallbackRetry,
-						resolvedThinkLevel,
-						fastMode: resolveFastModeState({
-							cfg,
-							provider: providerOverride,
-							model: modelOverride,
-							agentId: sessionAgentId,
-							sessionEntry
-						}).enabled,
-						timeoutMs,
-						runId,
-						opts,
-						runContext,
-						spawnedBy,
-						messageChannel,
-						skillsSnapshot,
-						resolvedVerboseLevel,
-						agentDir,
-						authProfileProvider: providerForAuthProfileValidation,
-						sessionStore: suppressVisibleSessionEffects ? void 0 : sessionStore,
-						storePath: suppressVisibleSessionEffects ? void 0 : storePath,
-						allowTransientCooldownProbe: runOptions?.allowTransientCooldownProbe,
-						sessionHasHistory: !isNewSession || await attemptExecutionRuntime.sessionFileHasContent(attemptSessionFile),
-						suppressPromptPersistenceOnRetry: opts.suppressPromptPersistence === true || isFallbackRetry && attemptLifecycleState.currentTurnUserMessagePersisted,
-						onUserMessagePersisted: attemptLifecycleCallbacks.onUserMessagePersisted,
-						onAgentEvent: attemptLifecycleCallbacks.onAgentEvent,
-						deferTerminalLifecycleEnd: true
-					});
-				}
-			});
-			result = fallbackResult.result;
-			fallbackProvider = fallbackResult.provider;
-			fallbackModel = fallbackResult.model;
-			if (autoFallbackPrimaryProbe && !autoFallbackPrimaryProbeInterruptedByLiveSwitch && sessionEntry && sessionStore && sessionKey && !suppressVisibleSessionEffects && !preserveUserFacingSessionModelState && entryMatchesAutoFallbackPrimaryProbe(sessionEntry, autoFallbackPrimaryProbe)) {
-				const nextSessionEntry = { ...sessionEntry };
-				if (fallbackProvider === autoFallbackPrimaryProbe.provider && fallbackModel === autoFallbackPrimaryProbe.model) clearAutoFallbackPrimaryProbeSelection(nextSessionEntry);
-				else {
-					nextSessionEntry.providerOverride = fallbackProvider;
-					nextSessionEntry.modelOverride = fallbackModel;
-					nextSessionEntry.modelOverrideSource = "auto";
-					nextSessionEntry.modelOverrideFallbackOriginProvider = autoFallbackPrimaryProbe.provider;
-					nextSessionEntry.modelOverrideFallbackOriginModel = autoFallbackPrimaryProbe.model;
-					if (nextSessionEntry.authProfileOverrideSource === "auto" && fallbackProvider !== autoFallbackPrimaryProbe.fallbackProvider) {
-						delete nextSessionEntry.authProfileOverride;
-						delete nextSessionEntry.authProfileOverrideSource;
-						delete nextSessionEntry.authProfileOverrideCompactionCount;
-					}
-					nextSessionEntry.updatedAt = Date.now();
-				}
-				sessionEntry = await persistSessionEntry({
-					sessionStore,
-					sessionKey,
-					storePath,
-					entry: nextSessionEntry,
-					shouldPersist: (current) => Boolean(current && entryMatchesAutoFallbackPrimaryProbe(current, autoFallbackPrimaryProbe))
-				}) ?? sessionEntry;
-			}
-			if (fallbackResult.attempts.length > 0 && result.meta.agentMeta) result = {
-				...result,
-				meta: {
-					...result.meta,
-					agentMeta: {
-						...result.meta.agentMeta,
-						fallbackAttempts: fallbackResult.attempts
-					}
-				}
-			};
-			emitLifecycleFinishing(result);
-			break;
-		} catch (err) {
-			if (err instanceof LiveSessionModelSwitchError) {
-				liveSwitchRetries++;
-				if (liveSwitchRetries > MAX_LIVE_SWITCH_RETRIES) {
-					log.error(`Live session model switch in subagent run ${runId}: exceeded maximum retries (${MAX_LIVE_SWITCH_RETRIES})`);
-					if (!attemptLifecycleState.lifecycleEnded) emitAgentEvent({
-						runId,
-						stream: "lifecycle",
-						data: {
-							phase: "error",
-							startedAt,
-							endedAt: Date.now(),
-							error: "Agent run failed"
-						}
-					});
-					await fallbackTrajectoryRecorder?.flush();
-					throw new Error(`Exceeded maximum live model switch retries (${MAX_LIVE_SWITCH_RETRIES})`, { cause: err });
-				}
-				const switchRef = normalizeModelRef(err.provider, err.model, modelManifestContext);
-				const switchKey = modelKey(switchRef.provider, switchRef.model);
-				if (!visibilityPolicy.allowsKey(switchKey)) {
-					log.info(`Live session model switch in subagent run ${runId}: rejected ${sanitizeForLog(err.provider)}/${sanitizeForLog(err.model)} (not in allowlist)`);
-					if (!attemptLifecycleState.lifecycleEnded) emitAgentEvent({
-						runId,
-						stream: "lifecycle",
-						data: {
-							phase: "error",
-							startedAt,
-							endedAt: Date.now(),
-							error: "Agent run failed"
-						}
-					});
-					await fallbackTrajectoryRecorder?.flush();
-					throw new Error(`Live model switch rejected: ${sanitizeForLog(err.provider)}/${sanitizeForLog(err.model)} is not in the agent allowlist`, { cause: err });
-				}
-				const previousProvider = provider;
-				const previousModel = model;
-				if (autoFallbackPrimaryProbe) autoFallbackPrimaryProbeInterruptedByLiveSwitch = true;
-				provider = err.provider;
-				model = err.model;
-				fallbackProvider = err.provider;
-				fallbackModel = err.model;
-				providerForAuthProfileValidation = err.provider;
-				if (sessionEntry) {
-					sessionEntry = { ...sessionEntry };
-					sessionEntry.authProfileOverride = err.authProfileId;
-					sessionEntry.authProfileOverrideSource = err.authProfileId ? err.authProfileIdSource : void 0;
-					sessionEntry.authProfileOverrideCompactionCount = void 0;
-				}
-				if (storedModelOverride || err.model !== previousModel || err.provider !== previousProvider) {
-					storedModelOverride = err.model;
-					storedModelOverrideSource = "user";
-				}
-				attemptLifecycleState.lifecycleEnded = false;
-				log.info(`Live session model switch in subagent run ${runId}: switching to ${sanitizeForLog(err.provider)}/${sanitizeForLog(err.model)}`);
-				continue;
-			}
-			if (!attemptLifecycleState.lifecycleEnded) emitAgentEvent({
-				runId,
-				stream: "lifecycle",
-				data: {
-					phase: "error",
-					startedAt,
-					endedAt: Date.now(),
-					error: err instanceof Error ? err.message : "Agent run failed"
-				}
-			});
-			await fallbackTrajectoryRecorder?.flush();
-			throw err;
-		}
-		try {
-			await fallbackTrajectoryRecorder?.flush();
-			const rotatedSessionFile = result.meta.agentMeta?.sessionFile;
-			const effectiveSessionId = rotatedSessionFile ? result.meta.agentMeta?.sessionId ?? sessionId : sessionId;
-			const effectiveSessionFile = rotatedSessionFile ?? attemptSessionFile;
-			if (sessionStore && sessionKey && !suppressVisibleSessionEffects) {
-				const { updateSessionStoreAfterAgentRun } = await loadSessionStoreRuntime();
-				await updateSessionStoreAfterAgentRun({
-					cfg,
-					contextTokensOverride: agentCfg?.contextTokens,
-					sessionId: effectiveSessionId,
-					sessionKey,
-					storePath,
-					sessionStore,
-					defaultProvider: provider,
-					defaultModel: model,
-					fallbackProvider,
-					fallbackModel,
-					result,
-					touchInteraction: opts.bootstrapContextRunKind !== "cron" && opts.bootstrapContextRunKind !== "heartbeat" && !opts.internalEvents?.length,
-					preserveRuntimeModel: opts.bootstrapContextRunKind === "heartbeat" || preserveUserFacingSessionModelState,
-					preserveUserFacingSessionModelState
-				});
-				sessionEntry = sessionStore[sessionKey] ?? sessionEntry;
-			}
-			const transcriptPersistenceRunner = result.meta.executionTrace?.runner;
-			const embeddedAssistantGapFill = transcriptPersistenceRunner === "embedded" || transcriptPersistenceRunner === void 0 && Boolean(result.meta.finalAssistantVisibleText?.trim());
-			if (transcriptPersistenceRunner === "cli" || embeddedAssistantGapFill) {
-				let persistedCliTurnTranscript = false;
-				try {
-					const transcriptSessionEntry = suppressVisibleSessionEffects ? {
-						...sessionEntry ?? {
-							sessionId: effectiveSessionId,
-							updatedAt: Date.now(),
-							sessionStartedAt: Date.now()
-						},
-						sessionId: effectiveSessionId,
-						sessionFile: effectiveSessionFile
-					} : sessionEntry;
-					sessionEntry = await attemptExecutionRuntime.persistCliTurnTranscript({
-						body,
-						transcriptBody,
-						result,
-						sessionId: effectiveSessionId,
-						sessionKey: sessionKey ?? effectiveSessionId,
-						sessionEntry: transcriptSessionEntry,
-						sessionStore: suppressVisibleSessionEffects ? void 0 : sessionStore,
-						storePath: suppressVisibleSessionEffects ? void 0 : storePath,
-						sessionAgentId,
-						threadId: opts.threadId,
-						sessionCwd: effectiveCwd,
-						config: cfg,
-						embeddedAssistantGapFill
-					});
-					if (suppressVisibleSessionEffects) sessionEntry = prepared.sessionEntry;
-					persistedCliTurnTranscript = true;
-				} catch (error) {
-					log.warn(`Turn transcript persistence failed for ${sessionKey ?? sessionId}: ${error instanceof Error ? error.message : String(error)}`);
-				}
-				if (persistedCliTurnTranscript && !suppressVisibleSessionEffects) sessionEntry = await (await loadCliCompactionRuntime()).runCliTurnCompactionLifecycle({
-					cfg,
-					sessionId: effectiveSessionId,
-					sessionKey: sessionKey ?? effectiveSessionId,
-					sessionEntry,
-					sessionStore,
-					storePath,
-					sessionAgentId,
-					workspaceDir,
-					cwd: effectiveCwd,
-					agentDir,
-					provider: result.meta.agentMeta?.provider ?? provider,
-					model: result.meta.agentMeta?.model ?? model,
-					skillsSnapshot,
-					messageChannel,
-					agentAccountId: runContext.accountId,
-					senderIsOwner: opts.senderIsOwner,
-					thinkLevel: resolvedThinkLevel,
-					extraSystemPrompt: opts.extraSystemPrompt
-				});
-			}
-			const payloads = result.payloads ?? [];
-			let pendingFinalDeliveryTextForThisRun;
-			if (opts.deliver === true && sessionStore && sessionKey && !suppressVisibleSessionEffects && payloads.length > 0 && !isSubagentSessionKey(sessionKey)) {
-				const now = Date.now();
-				const combinedPayload = sanitizePendingFinalDeliveryText(payloads.map((p) => typeof p.text === "string" ? p.text : "").filter(Boolean).join("\n\n"));
-				pendingFinalDeliveryTextForThisRun = combinedPayload || void 0;
-				if (combinedPayload) {
-					const next = {
-						...sessionStore[sessionKey] ?? sessionEntry,
-						pendingFinalDelivery: true,
-						pendingFinalDeliveryText: combinedPayload,
-						pendingFinalDeliveryCreatedAt: now,
-						updatedAt: now
-					};
-					await persistSessionEntry({
-						sessionStore,
-						sessionKey,
-						storePath,
-						entry: next
-					});
-					sessionEntry = next;
-				}
-			}
-			const { deliverAgentCommandResult } = await loadDeliveryRuntime();
-			const resolveFreshSessionEntryForDelivery = sessionStore && sessionKey && !suppressVisibleSessionEffects ? async () => {
-				const { loadSessionStore } = await loadSessionStoreRuntime();
-				const freshEntry = loadSessionStore(storePath, {
-					skipCache: true,
-					clone: false
-				})[sessionKey];
-				if (!freshEntry || freshEntry.sessionId !== effectiveSessionId) return;
-				sessionStore[sessionKey] = freshEntry;
-				return freshEntry;
-			} : void 0;
-			const deliveryParams = {
-				cfg,
-				deps: resolvedDeps,
-				runtime,
-				opts,
-				outboundSession,
-				sessionEntry,
-				result,
-				payloads
-			};
-			const deliveryResult = await deliverAgentCommandResult(resolveFreshSessionEntryForDelivery ? {
-				...deliveryParams,
-				expectedSessionIdForFreshDelivery: effectiveSessionId,
-				resolveFreshSessionEntryForDelivery
-			} : deliveryParams);
-			if (sessionStore && sessionKey && !isSubagentSessionKey(sessionKey) && !suppressVisibleSessionEffects) {
-				const entry = sessionStore[sessionKey] ?? sessionEntry;
-				const noPendingTextForThisRun = opts.deliver === true && pendingFinalDeliveryTextForThisRun === void 0 && entry.pendingFinalDelivery === true && !entry.pendingFinalDeliveryText;
-				if (deliveryResult?.deliverySucceeded === true || noPendingTextForThisRun) {
-					const next = clearPendingFinalDeliveryFields(entry, Date.now());
-					await persistSessionEntry({
-						sessionStore,
-						sessionKey,
-						storePath,
-						entry: next
-					});
-					sessionEntry = next;
-				}
-			}
-			emitLifecycleEnd(result);
-			return deliveryResult;
-		} catch (error) {
-			emitLifecyclePostTurnError(error);
-			throw error;
-		}
-	} finally {
-		clearAgentRunContext(runId);
-	}
-}
-async function agentCommand(opts, runtime = defaultRuntime, deps) {
-	const resolvedDeps = await resolveAgentCommandDeps(deps);
-	return await withLocalGatewayRequestScope({
-		deps: resolvedDeps,
-		getRuntimeConfig
-	}, async () => await agentCommandInternal({
-		...opts,
-		senderIsOwner: opts.senderIsOwner ?? true,
-		allowModelOverride: opts.allowModelOverride ?? true
-	}, runtime, resolvedDeps));
-}
-async function agentCommandFromIngress(opts, runtime = defaultRuntime, deps) {
-	if (typeof opts.allowModelOverride !== "boolean") throw new Error("入口 Agent 运行时必须显式设置 allowModelOverride。");
-	return await agentCommandInternal({
-		...opts,
-		senderIsOwner: opts.senderIsOwner === true
-	}, runtime, deps);
-}
-const testing = {
-	resolveAgentRuntimeConfig,
-	prepareAgentCommandExecution,
-	resolveExplicitAgentCommandSessionKey
-};
-//#endregion
-export { agentCommandFromIngress as n, testing as r, agentCommand as t };