@bastani/atomic 0.8.31-alpha.4 → 0.9.0-alpha.1

package/dist/core/agent-session-models.js

@@ -0,0 +1,368 @@
+import { clampThinkingLevel, getSupportedThinkingLevels, modelsAreEqual } from "@earendil-works/pi-ai";
+import { getModelDefaultContextWindow, getSupportedContextWindows, selectContextWindow } from "./context-window.js";
+import { formatNoApiKeyFoundMessage } from "./auth-guidance.js";
+import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
+import { COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS, THINKING_LEVELS } from "./agent-session-types.js";
+export async function _getRequiredRequestAuth(model) {
+    const result = await this._modelRegistry.getApiKeyAndHeaders(model);
+    if (!result.ok) {
+        if (result.error.startsWith("No API key found")) {
+            throw new Error(formatNoApiKeyFoundMessage(model.provider));
+        }
+        throw new Error(result.error);
+    }
+    if (result.apiKey) {
+        return { apiKey: result.apiKey, headers: result.headers };
+    }
+    const isOAuth = this._modelRegistry.isUsingOAuth(model);
+    if (isOAuth) {
+        throw new Error(`Authentication failed for "${model.provider}". ` +
+            `Credentials may have expired or network is unavailable. ` +
+            `Run '/login ${model.provider}' to re-authenticate.`);
+    }
+    throw new Error(formatNoApiKeyFoundMessage(model.provider));
+}
+/**
+ * Install tool hooks once on the Agent instance.
+ *
+ * The callbacks read `this._extensionRunner` at execution time, so extension reload swaps in the
+ * new runner without reinstalling hooks. Extension-specific tool wrappers are still used to adapt
+ * registered tool execution to the extension context. Tool call and tool result interception now
+ * happens here instead of in wrappers.
+ */
+export function _emitModelChanged(nextModel, previousModel, source) {
+    if (modelsAreEqual(previousModel, nextModel))
+        return;
+    this._emit({
+        type: "model_changed",
+        model: nextModel,
+        previousModel,
+        source,
+    });
+}
+export async function _emitModelSelect(nextModel, previousModel, source) {
+    if (modelsAreEqual(previousModel, nextModel))
+        return;
+    await this._extensionRunner.emit({
+        type: "model_select",
+        model: nextModel,
+        previousModel,
+        source,
+    });
+}
+/**
+ * Set model directly.
+ * Validates that auth is configured, saves to session and settings.
+ * @throws Error if no auth is configured for the model
+ */
+export async function setModel(model) {
+    if (!this._modelRegistry.hasConfiguredAuth(model)) {
+        throw new Error(`No API key for ${model.provider}/${model.id}`);
+    }
+    const previousModel = this.model;
+    const thinkingLevel = this._getThinkingLevelForModelSwitch();
+    const nextModel = this._withContextWindowForModelSwitch(model);
+    this.agent.state.model = nextModel;
+    this.sessionManager.appendModelChange(nextModel.provider, nextModel.id);
+    this._appendContextWindowChangeIfChanged(previousModel, nextModel);
+    this.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);
+    // Re-clamp thinking level for new model's capabilities
+    this.setThinkingLevel(thinkingLevel);
+    this._refreshBaseSystemPromptFromActiveTools();
+    this._emitModelChanged(nextModel, previousModel, "set");
+    await this._emitModelSelect(nextModel, previousModel, "set");
+}
+/**
+ * Cycle to next/previous model.
+ * Uses scoped models (from --models flag) if available, otherwise all available models.
+ * @param direction - "forward" (default) or "backward"
+ * @returns The new model info, or undefined if only one model available
+ */
+export async function cycleModel(direction = "forward") {
+    if (this._scopedModels.length > 0) {
+        return this._cycleScopedModel(direction);
+    }
+    return this._cycleAvailableModel(direction);
+}
+export async function _cycleScopedModel(direction) {
+    const scopedModels = this._scopedModels.filter((scoped) => this._modelRegistry.hasConfiguredAuth(scoped.model));
+    if (scopedModels.length <= 1)
+        return undefined;
+    const currentModel = this.model;
+    let currentIndex = scopedModels.findIndex((sm) => modelsAreEqual(sm.model, currentModel));
+    if (currentIndex === -1)
+        currentIndex = 0;
+    const len = scopedModels.length;
+    const nextIndex = direction === "forward" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;
+    const next = scopedModels[nextIndex];
+    const thinkingLevel = this._getThinkingLevelForModelSwitch(next.thinkingLevel);
+    const nextModel = this._withContextWindowForModelSwitch(next.model);
+    // Apply model
+    this.agent.state.model = nextModel;
+    this.sessionManager.appendModelChange(nextModel.provider, nextModel.id);
+    this._appendContextWindowChangeIfChanged(currentModel, nextModel);
+    this.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);
+    // Apply thinking level.
+    // - Explicit scoped model thinking level overrides current session level
+    // - Undefined scoped model thinking level inherits the current session preference
+    // setThinkingLevel clamps to model capabilities.
+    this.setThinkingLevel(thinkingLevel);
+    this._refreshBaseSystemPromptFromActiveTools();
+    this._emitModelChanged(nextModel, currentModel, "cycle");
+    await this._emitModelSelect(nextModel, currentModel, "cycle");
+    return { model: nextModel, thinkingLevel: this.thinkingLevel, isScoped: true };
+}
+export async function _cycleAvailableModel(direction) {
+    const availableModels = await this._modelRegistry.getAvailable();
+    if (availableModels.length <= 1)
+        return undefined;
+    const currentModel = this.model;
+    let currentIndex = availableModels.findIndex((m) => modelsAreEqual(m, currentModel));
+    if (currentIndex === -1)
+        currentIndex = 0;
+    const len = availableModels.length;
+    const nextIndex = direction === "forward" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;
+    const selectedModel = this._withContextWindowForModelSwitch(availableModels[nextIndex]);
+    const thinkingLevel = this._getThinkingLevelForModelSwitch();
+    this.agent.state.model = selectedModel;
+    this.sessionManager.appendModelChange(selectedModel.provider, selectedModel.id);
+    this._appendContextWindowChangeIfChanged(currentModel, selectedModel);
+    this.settingsManager.setDefaultModelAndProvider(selectedModel.provider, selectedModel.id);
+    // Re-clamp thinking level for new model's capabilities
+    this.setThinkingLevel(thinkingLevel);
+    this._refreshBaseSystemPromptFromActiveTools();
+    this._emitModelChanged(selectedModel, currentModel, "cycle");
+    await this._emitModelSelect(selectedModel, currentModel, "cycle");
+    return { model: selectedModel, thinkingLevel: this.thinkingLevel, isScoped: false };
+}
+// =========================================================================
+// Thinking Level Management
+// =========================================================================
+/**
+ * Set thinking level.
+ * Clamps to model capabilities based on available thinking levels.
+ * Saves to session and settings only if the level actually changes.
+ */
+export function setThinkingLevel(level) {
+    const availableLevels = this.getAvailableThinkingLevels();
+    const effectiveLevel = availableLevels.includes(level) ? level : this._clampThinkingLevel(level, availableLevels);
+    // Only persist if actually changing
+    const previousLevel = this.agent.state.thinkingLevel;
+    const isChanging = effectiveLevel !== previousLevel;
+    this.agent.state.thinkingLevel = effectiveLevel;
+    if (isChanging) {
+        this.sessionManager.appendThinkingLevelChange(effectiveLevel);
+        this._refreshBaseSystemPromptFromActiveTools();
+        if (this.supportsThinking() || effectiveLevel !== "off") {
+            this.settingsManager.setDefaultThinkingLevel(effectiveLevel);
+        }
+        this._emit({ type: "thinking_level_changed", level: effectiveLevel });
+        void this._extensionRunner.emit({
+            type: "thinking_level_select",
+            level: effectiveLevel,
+            previousLevel,
+        });
+    }
+}
+/**
+ * Cycle to next thinking level.
+ * @returns New level, or undefined if model doesn't support thinking
+ */
+export function cycleThinkingLevel() {
+    if (!this.supportsThinking())
+        return undefined;
+    const levels = this.getAvailableThinkingLevels();
+    const currentIndex = levels.indexOf(this.thinkingLevel);
+    const nextIndex = (currentIndex + 1) % levels.length;
+    const nextLevel = levels[nextIndex];
+    this.setThinkingLevel(nextLevel);
+    return nextLevel;
+}
+/**
+ * Get available thinking levels for current model.
+ * The provider will clamp to what the specific model supports internally.
+ */
+export function getAvailableThinkingLevels() {
+    if (!this.model)
+        return THINKING_LEVELS;
+    return getSupportedThinkingLevels(this.model);
+}
+/**
+ * Check if current model supports thinking/reasoning.
+ */
+export function supportsThinking() {
+    return !!this.model?.reasoning;
+}
+export function _getThinkingLevelForModelSwitch(explicitLevel) {
+    if (explicitLevel !== undefined) {
+        return explicitLevel;
+    }
+    if (!this.supportsThinking()) {
+        return this.settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;
+    }
+    return this.thinkingLevel;
+}
+export function _clampThinkingLevel(level, _availableLevels) {
+    return this.model ? clampThinkingLevel(this.model, level) : "off";
+}
+// =========================================================================
+// Context Window Management
+// =========================================================================
+export function getAvailableContextWindows() {
+    return this.model ? getSupportedContextWindows(this.model) : [];
+}
+export function supportsContextWindowSelection() {
+    return this.getAvailableContextWindows().length > 1;
+}
+export function setContextWindow(contextWindow, options = {}) {
+    if (!this.model) {
+        throw new Error("No model selected");
+    }
+    const selected = selectContextWindow(this.model, contextWindow, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);
+    if ("error" in selected) {
+        throw new Error(selected.error);
+    }
+    const previousContextWindow = this.model.contextWindow;
+    const isChanging = previousContextWindow !== selected.contextWindow;
+    this.agent.state.model = selected.model;
+    if (isChanging) {
+        this.sessionManager.appendContextWindowChange(selected.contextWindow);
+        this._emit({ type: "context_window_changed", contextWindow: selected.contextWindow });
+    }
+    if (options.persistDefault === true) {
+        this.settingsManager.setDefaultContextWindowForModel(selected.model.provider, selected.model.id, selected.contextWindow);
+    }
+}
+export function _withContextWindowForModelSwitch(model) {
+    // A source model's scalar contextWindow can be its natural default (for example a 1m-default
+    // model). Do not treat that alone as an opt-in to larger windows on a 400k-default target.
+    const settingsDefaultContextWindow = this._getSettingsContextWindowRequestForModel(model)?.contextWindow;
+    const candidates = [];
+    const targetDefaultContextWindow = getModelDefaultContextWindow(model);
+    if (model.contextWindow !== targetDefaultContextWindow) {
+        // Preserve an explicit context-window selection already applied to the target model
+        // (for example a caller passing selectContextWindow(target, 1m).model).
+        candidates.push(model.contextWindow);
+    }
+    const currentModel = this.model;
+    if (currentModel && this._shouldCarryCurrentContextWindowForModelSwitch(currentModel, settingsDefaultContextWindow)) {
+        candidates.push(currentModel.contextWindow);
+    }
+    if (settingsDefaultContextWindow !== undefined) {
+        candidates.push(settingsDefaultContextWindow);
+    }
+    candidates.push(targetDefaultContextWindow);
+    for (const candidate of candidates) {
+        const selected = selectContextWindow(model, candidate, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);
+        if (!("error" in selected))
+            return selected.model;
+    }
+    return model;
+}
+export function _shouldCarryCurrentContextWindowForModelSwitch(currentModel, settingsDefaultContextWindow) {
+    if (currentModel.contextWindow !== getModelDefaultContextWindow(currentModel)) {
+        return true;
+    }
+    if (this.sessionManager.getBranch().some((entry) => entry.type === "context_window_change")) {
+        return true;
+    }
+    return (settingsDefaultContextWindow !== undefined &&
+        currentModel.contextWindow === settingsDefaultContextWindow &&
+        getSupportedContextWindows(currentModel).includes(settingsDefaultContextWindow));
+}
+export function _getSettingsContextWindowRequestForModel(model) {
+    const modelContextWindow = this.settingsManager.getDefaultContextWindowForModel(model.provider, model.id);
+    if (modelContextWindow !== undefined) {
+        return { contextWindow: modelContextWindow, source: "model-settings" };
+    }
+    const globalContextWindow = this.settingsManager.getDefaultContextWindow();
+    return globalContextWindow === undefined
+        ? undefined
+        : { contextWindow: globalContextWindow, source: "global-settings" };
+}
+export function _getContextWindowReplayForModel(model, requestedContextWindow, source) {
+    if (requestedContextWindow !== undefined) {
+        const selected = selectContextWindow(model, requestedContextWindow, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);
+        if (!("error" in selected)) {
+            return { model: selected.model, contextWindow: selected.contextWindow, wouldWarn: false };
+        }
+        return this._getDefaultContextWindowReplayForModel(model, source !== "global-settings");
+    }
+    return this._getDefaultContextWindowReplayForModel(model, false);
+}
+export function _getDefaultContextWindowReplayForModel(model, wouldWarn) {
+    const defaultContextWindow = getModelDefaultContextWindow(model);
+    const selected = selectContextWindow(model, defaultContextWindow, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);
+    if (!("error" in selected)) {
+        return { model: selected.model, contextWindow: selected.contextWindow, wouldWarn };
+    }
+    return {
+        model: { ...model, contextWindow: defaultContextWindow, defaultContextWindow },
+        contextWindow: defaultContextWindow,
+        wouldWarn,
+    };
+}
+export function _getResumeContextWindowReplayForModel(model) {
+    const sessionContext = this.sessionManager.buildSessionContext();
+    if (sessionContext.contextWindow !== undefined) {
+        return this._getContextWindowReplayForModel(model, sessionContext.contextWindow, "session");
+    }
+    const settingsContextWindow = this._getSettingsContextWindowRequestForModel(model);
+    return this._getContextWindowReplayForModel(model, settingsContextWindow?.contextWindow, settingsContextWindow?.source);
+}
+export function _applyContextWindowReplay(contextWindow) {
+    if (!this.model)
+        return;
+    const previousContextWindow = this.model.contextWindow;
+    const settingsContextWindow = this._getSettingsContextWindowRequestForModel(this.model);
+    const requestedContextWindow = contextWindow ?? settingsContextWindow?.contextWindow;
+    const source = contextWindow !== undefined ? "session" : settingsContextWindow?.source;
+    const replay = this._getContextWindowReplayForModel(this.model, requestedContextWindow, source);
+    this.agent.state.model = replay.model;
+    if (previousContextWindow !== replay.contextWindow) {
+        this._emit({ type: "context_window_changed", contextWindow: replay.contextWindow });
+    }
+}
+export function _appendContextWindowChangeIfChanged(previousModel, nextModel) {
+    const replay = this._getResumeContextWindowReplayForModel(nextModel);
+    if (!replay.wouldWarn && nextModel.contextWindow === replay.contextWindow)
+        return;
+    this.sessionManager.appendContextWindowChange(nextModel.contextWindow);
+    if (previousModel?.contextWindow !== nextModel.contextWindow) {
+        this._emit({ type: "context_window_changed", contextWindow: nextModel.contextWindow });
+    }
+}
+// =========================================================================
+// Queue Mode Management
+// =========================================================================
+/**
+ * Set steering message mode.
+ * Saves to settings.
+ */
+export const agentSessionModelsMethods = {
+    _getRequiredRequestAuth,
+    _emitModelChanged,
+    _emitModelSelect,
+    setModel,
+    cycleModel,
+    _cycleScopedModel,
+    _cycleAvailableModel,
+    setThinkingLevel,
+    cycleThinkingLevel,
+    getAvailableThinkingLevels,
+    supportsThinking,
+    _getThinkingLevelForModelSwitch,
+    _clampThinkingLevel,
+    getAvailableContextWindows,
+    supportsContextWindowSelection,
+    setContextWindow,
+    _withContextWindowForModelSwitch,
+    _shouldCarryCurrentContextWindowForModelSwitch,
+    _getSettingsContextWindowRequestForModel,
+    _getContextWindowReplayForModel,
+    _getDefaultContextWindowReplayForModel,
+    _getResumeContextWindowReplayForModel,
+    _applyContextWindowReplay,
+    _appendContextWindowChangeIfChanged,
+};
+//# sourceMappingURL=agent-session-models.js.map

package/dist/core/agent-session-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-models.js","sourceRoot":"","sources":["../../src/core/agent-session-models.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { clampThinkingLevel, getSupportedThinkingLevels, modelsAreEqual } from \"@earendil-works/pi-ai\";\nimport { getModelDefaultContextWindow, getSupportedContextWindows, selectContextWindow } from \"./context-window.ts\";\nimport { formatNoApiKeyFoundMessage } from \"./auth-guidance.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { AgentSessionInternalSurface as AgentSession } from \"./agent-session-methods.ts\";\nimport { COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS, THINKING_LEVELS, type ContextWindowReplayRequest, type ContextWindowReplaySource, type ModelCycleResult } from \"./agent-session-types.ts\";\n\nexport async function _getRequiredRequestAuth(this: AgentSession, model: Model<Api>): Promise<{\n\tapiKey: string;\n\theaders?: Record<string, string>;\n}> {\n\tconst result = await this._modelRegistry.getApiKeyAndHeaders(model);\n\tif (!result.ok) {\n\t\tif (result.error.startsWith(\"No API key found\")) {\n\t\t\tthrow new Error(formatNoApiKeyFoundMessage(model.provider));\n\t\t}\n\t\tthrow new Error(result.error);\n\t}\n\tif (result.apiKey) {\n\t\treturn { apiKey: result.apiKey, headers: result.headers };\n\t}\n\n\tconst isOAuth = this._modelRegistry.isUsingOAuth(model);\n\tif (isOAuth) {\n\t\tthrow new Error(\n\t\t\t`Authentication failed for \"${model.provider}\". ` +\n\t\t\t\t`Credentials may have expired or network is unavailable. ` +\n\t\t\t\t`Run '/login ${model.provider}' to re-authenticate.`,\n\t\t);\n\t}\n\tthrow new Error(formatNoApiKeyFoundMessage(model.provider));\n}\n\n/**\n * Install tool hooks once on the Agent instance.\n *\n * The callbacks read `this._extensionRunner` at execution time, so extension reload swaps in the\n * new runner without reinstalling hooks. Extension-specific tool wrappers are still used to adapt\n * registered tool execution to the extension context. Tool call and tool result interception now\n * happens here instead of in wrappers.\n */\n\nexport function _emitModelChanged(this: AgentSession, \n\tnextModel: Model<Api>,\n\tpreviousModel: Model<Api> | undefined,\n\tsource: \"set\" | \"cycle\" | \"restore\",\n): void {\n\tif (modelsAreEqual(previousModel, nextModel)) return;\n\tthis._emit({\n\t\ttype: \"model_changed\",\n\t\tmodel: nextModel,\n\t\tpreviousModel,\n\t\tsource,\n\t});\n}\n\n\nexport async function _emitModelSelect(this: AgentSession, \n\tnextModel: Model<Api>,\n\tpreviousModel: Model<Api> | undefined,\n\tsource: \"set\" | \"cycle\" | \"restore\",\n): Promise<void> {\n\tif (modelsAreEqual(previousModel, nextModel)) return;\n\tawait this._extensionRunner.emit({\n\t\ttype: \"model_select\",\n\t\tmodel: nextModel,\n\t\tpreviousModel,\n\t\tsource,\n\t});\n}\n\n/**\n * Set model directly.\n * Validates that auth is configured, saves to session and settings.\n * @throws Error if no auth is configured for the model\n */\n\nexport async function setModel(this: AgentSession, model: Model<Api>): Promise<void> {\n\tif (!this._modelRegistry.hasConfiguredAuth(model)) {\n\t\tthrow new Error(`No API key for ${model.provider}/${model.id}`);\n\t}\n\n\tconst previousModel = this.model;\n\tconst thinkingLevel = this._getThinkingLevelForModelSwitch();\n\tconst nextModel = this._withContextWindowForModelSwitch(model);\n\tthis.agent.state.model = nextModel;\n\tthis.sessionManager.appendModelChange(nextModel.provider, nextModel.id);\n\tthis._appendContextWindowChangeIfChanged(previousModel, nextModel);\n\tthis.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);\n\n\t// Re-clamp thinking level for new model's capabilities\n\tthis.setThinkingLevel(thinkingLevel);\n\tthis._refreshBaseSystemPromptFromActiveTools();\n\n\tthis._emitModelChanged(nextModel, previousModel, \"set\");\n\tawait this._emitModelSelect(nextModel, previousModel, \"set\");\n}\n\n/**\n * Cycle to next/previous model.\n * Uses scoped models (from --models flag) if available, otherwise all available models.\n * @param direction - \"forward\" (default) or \"backward\"\n * @returns The new model info, or undefined if only one model available\n */\n\nexport async function cycleModel(this: AgentSession, direction: \"forward\" | \"backward\" = \"forward\"): Promise<ModelCycleResult | undefined> {\n\tif (this._scopedModels.length > 0) {\n\t\treturn this._cycleScopedModel(direction);\n\t}\n\treturn this._cycleAvailableModel(direction);\n}\n\n\nexport async function _cycleScopedModel(this: AgentSession, direction: \"forward\" | \"backward\"): Promise<ModelCycleResult | undefined> {\n\tconst scopedModels = this._scopedModels.filter((scoped) => this._modelRegistry.hasConfiguredAuth(scoped.model));\n\tif (scopedModels.length <= 1) return undefined;\n\n\tconst currentModel = this.model;\n\tlet currentIndex = scopedModels.findIndex((sm) => modelsAreEqual(sm.model, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = scopedModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst next = scopedModels[nextIndex];\n\tconst thinkingLevel = this._getThinkingLevelForModelSwitch(next.thinkingLevel);\n\tconst nextModel = this._withContextWindowForModelSwitch(next.model);\n\n\t// Apply model\n\tthis.agent.state.model = nextModel;\n\tthis.sessionManager.appendModelChange(nextModel.provider, nextModel.id);\n\tthis._appendContextWindowChangeIfChanged(currentModel, nextModel);\n\tthis.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);\n\n\t// Apply thinking level.\n\t// - Explicit scoped model thinking level overrides current session level\n\t// - Undefined scoped model thinking level inherits the current session preference\n\t// setThinkingLevel clamps to model capabilities.\n\tthis.setThinkingLevel(thinkingLevel);\n\tthis._refreshBaseSystemPromptFromActiveTools();\n\n\tthis._emitModelChanged(nextModel, currentModel, \"cycle\");\n\tawait this._emitModelSelect(nextModel, currentModel, \"cycle\");\n\n\treturn { model: nextModel, thinkingLevel: this.thinkingLevel, isScoped: true };\n}\n\n\nexport async function _cycleAvailableModel(this: AgentSession, direction: \"forward\" | \"backward\"): Promise<ModelCycleResult | undefined> {\n\tconst availableModels = await this._modelRegistry.getAvailable();\n\tif (availableModels.length <= 1) return undefined;\n\n\tconst currentModel = this.model;\n\tlet currentIndex = availableModels.findIndex((m) => modelsAreEqual(m, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = availableModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst selectedModel = this._withContextWindowForModelSwitch(availableModels[nextIndex]);\n\n\tconst thinkingLevel = this._getThinkingLevelForModelSwitch();\n\tthis.agent.state.model = selectedModel;\n\tthis.sessionManager.appendModelChange(selectedModel.provider, selectedModel.id);\n\tthis._appendContextWindowChangeIfChanged(currentModel, selectedModel);\n\tthis.settingsManager.setDefaultModelAndProvider(selectedModel.provider, selectedModel.id);\n\n\t// Re-clamp thinking level for new model's capabilities\n\tthis.setThinkingLevel(thinkingLevel);\n\tthis._refreshBaseSystemPromptFromActiveTools();\n\n\tthis._emitModelChanged(selectedModel, currentModel, \"cycle\");\n\tawait this._emitModelSelect(selectedModel, currentModel, \"cycle\");\n\n\treturn { model: selectedModel, thinkingLevel: this.thinkingLevel, isScoped: false };\n}\n\n// =========================================================================\n// Thinking Level Management\n// =========================================================================\n\n/**\n * Set thinking level.\n * Clamps to model capabilities based on available thinking levels.\n * Saves to session and settings only if the level actually changes.\n */\n\nexport function setThinkingLevel(this: AgentSession, level: ThinkingLevel): void {\n\tconst availableLevels = this.getAvailableThinkingLevels();\n\tconst effectiveLevel = availableLevels.includes(level) ? level : this._clampThinkingLevel(level, availableLevels);\n\n\t// Only persist if actually changing\n\tconst previousLevel = this.agent.state.thinkingLevel;\n\tconst isChanging = effectiveLevel !== previousLevel;\n\n\tthis.agent.state.thinkingLevel = effectiveLevel;\n\n\tif (isChanging) {\n\t\tthis.sessionManager.appendThinkingLevelChange(effectiveLevel);\n\t\tthis._refreshBaseSystemPromptFromActiveTools();\n\t\tif (this.supportsThinking() || effectiveLevel !== \"off\") {\n\t\t\tthis.settingsManager.setDefaultThinkingLevel(effectiveLevel);\n\t\t}\n\t\tthis._emit({ type: \"thinking_level_changed\", level: effectiveLevel });\n\t\tvoid this._extensionRunner.emit({\n\t\t\ttype: \"thinking_level_select\",\n\t\t\tlevel: effectiveLevel,\n\t\t\tpreviousLevel,\n\t\t});\n\t}\n}\n\n/**\n * Cycle to next thinking level.\n * @returns New level, or undefined if model doesn't support thinking\n */\n\nexport function cycleThinkingLevel(this: AgentSession): ThinkingLevel | undefined {\n\tif (!this.supportsThinking()) return undefined;\n\n\tconst levels = this.getAvailableThinkingLevels();\n\tconst currentIndex = levels.indexOf(this.thinkingLevel);\n\tconst nextIndex = (currentIndex + 1) % levels.length;\n\tconst nextLevel = levels[nextIndex];\n\n\tthis.setThinkingLevel(nextLevel);\n\treturn nextLevel;\n}\n\n/**\n * Get available thinking levels for current model.\n * The provider will clamp to what the specific model supports internally.\n */\n\nexport function getAvailableThinkingLevels(this: AgentSession): ThinkingLevel[] {\n\tif (!this.model) return THINKING_LEVELS;\n\treturn getSupportedThinkingLevels(this.model) as ThinkingLevel[];\n}\n\n/**\n * Check if current model supports thinking/reasoning.\n */\n\nexport function supportsThinking(this: AgentSession): boolean {\n\treturn !!this.model?.reasoning;\n}\n\n\nexport function _getThinkingLevelForModelSwitch(this: AgentSession, explicitLevel?: ThinkingLevel): ThinkingLevel {\n\tif (explicitLevel !== undefined) {\n\t\treturn explicitLevel;\n\t}\n\tif (!this.supportsThinking()) {\n\t\treturn this.settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t}\n\treturn this.thinkingLevel;\n}\n\n\nexport function _clampThinkingLevel(this: AgentSession, level: ThinkingLevel, _availableLevels: ThinkingLevel[]): ThinkingLevel {\n\treturn this.model ? (clampThinkingLevel(this.model, level) as ThinkingLevel) : \"off\";\n}\n\n// =========================================================================\n// Context Window Management\n// =========================================================================\n\n\nexport function getAvailableContextWindows(this: AgentSession): number[] {\n\treturn this.model ? getSupportedContextWindows(this.model) : [];\n}\n\n\nexport function supportsContextWindowSelection(this: AgentSession): boolean {\n\treturn this.getAvailableContextWindows().length > 1;\n}\n\n\nexport function setContextWindow(this: AgentSession, contextWindow: number, options: { persistDefault?: boolean } = {}): void {\n\tif (!this.model) {\n\t\tthrow new Error(\"No model selected\");\n\t}\n\tconst selected = selectContextWindow(this.model, contextWindow, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);\n\tif (\"error\" in selected) {\n\t\tthrow new Error(selected.error);\n\t}\n\n\tconst previousContextWindow = this.model.contextWindow;\n\tconst isChanging = previousContextWindow !== selected.contextWindow;\n\tthis.agent.state.model = selected.model;\n\n\tif (isChanging) {\n\t\tthis.sessionManager.appendContextWindowChange(selected.contextWindow);\n\t\tthis._emit({ type: \"context_window_changed\", contextWindow: selected.contextWindow });\n\t}\n\tif (options.persistDefault === true) {\n\t\tthis.settingsManager.setDefaultContextWindowForModel(selected.model.provider, selected.model.id, selected.contextWindow);\n\t}\n}\n\n\nexport function _withContextWindowForModelSwitch(this: AgentSession, model: Model<Api>): Model<Api> {\n\t// A source model's scalar contextWindow can be its natural default (for example a 1m-default\n\t// model). Do not treat that alone as an opt-in to larger windows on a 400k-default target.\n\tconst settingsDefaultContextWindow = this._getSettingsContextWindowRequestForModel(model)?.contextWindow;\n\tconst candidates: number[] = [];\n\tconst targetDefaultContextWindow = getModelDefaultContextWindow(model);\n\tif (model.contextWindow !== targetDefaultContextWindow) {\n\t\t// Preserve an explicit context-window selection already applied to the target model\n\t\t// (for example a caller passing selectContextWindow(target, 1m).model).\n\t\tcandidates.push(model.contextWindow);\n\t}\n\tconst currentModel = this.model;\n\tif (currentModel && this._shouldCarryCurrentContextWindowForModelSwitch(currentModel, settingsDefaultContextWindow)) {\n\t\tcandidates.push(currentModel.contextWindow);\n\t}\n\tif (settingsDefaultContextWindow !== undefined) {\n\t\tcandidates.push(settingsDefaultContextWindow);\n\t}\n\tcandidates.push(targetDefaultContextWindow);\n\n\tfor (const candidate of candidates) {\n\t\tconst selected = selectContextWindow(model, candidate, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);\n\t\tif (!(\"error\" in selected)) return selected.model;\n\t}\n\treturn model;\n}\n\n\nexport function _shouldCarryCurrentContextWindowForModelSwitch(this: AgentSession, \n\tcurrentModel: Model<Api>,\n\tsettingsDefaultContextWindow: number | undefined,\n): boolean {\n\tif (currentModel.contextWindow !== getModelDefaultContextWindow(currentModel)) {\n\t\treturn true;\n\t}\n\tif (this.sessionManager.getBranch().some((entry) => entry.type === \"context_window_change\")) {\n\t\treturn true;\n\t}\n\treturn (\n\t\tsettingsDefaultContextWindow !== undefined &&\n\t\tcurrentModel.contextWindow === settingsDefaultContextWindow &&\n\t\tgetSupportedContextWindows(currentModel).includes(settingsDefaultContextWindow)\n\t);\n}\n\n\nexport function _getSettingsContextWindowRequestForModel(this: AgentSession, model: Model<Api>): ContextWindowReplayRequest | undefined {\n\tconst modelContextWindow = this.settingsManager.getDefaultContextWindowForModel(model.provider, model.id);\n\tif (modelContextWindow !== undefined) {\n\t\treturn { contextWindow: modelContextWindow, source: \"model-settings\" };\n\t}\n\tconst globalContextWindow = this.settingsManager.getDefaultContextWindow();\n\treturn globalContextWindow === undefined\n\t\t? undefined\n\t\t: { contextWindow: globalContextWindow, source: \"global-settings\" };\n}\n\n\nexport function _getContextWindowReplayForModel(this: AgentSession, \n\tmodel: Model<Api>,\n\trequestedContextWindow: number | undefined,\n\tsource: ContextWindowReplaySource | undefined,\n): { model: Model<Api>; contextWindow: number; wouldWarn: boolean } {\n\tif (requestedContextWindow !== undefined) {\n\t\tconst selected = selectContextWindow(model, requestedContextWindow, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);\n\t\tif (!(\"error\" in selected)) {\n\t\t\treturn { model: selected.model, contextWindow: selected.contextWindow, wouldWarn: false };\n\t\t}\n\t\treturn this._getDefaultContextWindowReplayForModel(model, source !== \"global-settings\");\n\t}\n\n\treturn this._getDefaultContextWindowReplayForModel(model, false);\n}\n\n\nexport function _getDefaultContextWindowReplayForModel(this: AgentSession, \n\tmodel: Model<Api>,\n\twouldWarn: boolean,\n): { model: Model<Api>; contextWindow: number; wouldWarn: boolean } {\n\tconst defaultContextWindow = getModelDefaultContextWindow(model);\n\tconst selected = selectContextWindow(model, defaultContextWindow, COPILOT_CONTEXT_WINDOW_SELECTION_OPTIONS);\n\tif (!(\"error\" in selected)) {\n\t\treturn { model: selected.model, contextWindow: selected.contextWindow, wouldWarn };\n\t}\n\treturn {\n\t\tmodel: { ...model, contextWindow: defaultContextWindow, defaultContextWindow },\n\t\tcontextWindow: defaultContextWindow,\n\t\twouldWarn,\n\t};\n}\n\n\nexport function _getResumeContextWindowReplayForModel(this: AgentSession, \n\tmodel: Model<Api>,\n): { model: Model<Api>; contextWindow: number; wouldWarn: boolean } {\n\tconst sessionContext = this.sessionManager.buildSessionContext();\n\tif (sessionContext.contextWindow !== undefined) {\n\t\treturn this._getContextWindowReplayForModel(model, sessionContext.contextWindow, \"session\");\n\t}\n\tconst settingsContextWindow = this._getSettingsContextWindowRequestForModel(model);\n\treturn this._getContextWindowReplayForModel(model, settingsContextWindow?.contextWindow, settingsContextWindow?.source);\n}\n\n\nexport function _applyContextWindowReplay(this: AgentSession, contextWindow: number | undefined): void {\n\tif (!this.model) return;\n\tconst previousContextWindow = this.model.contextWindow;\n\tconst settingsContextWindow = this._getSettingsContextWindowRequestForModel(this.model);\n\tconst requestedContextWindow = contextWindow ?? settingsContextWindow?.contextWindow;\n\tconst source: ContextWindowReplaySource | undefined = contextWindow !== undefined ? \"session\" : settingsContextWindow?.source;\n\tconst replay = this._getContextWindowReplayForModel(this.model, requestedContextWindow, source);\n\tthis.agent.state.model = replay.model;\n\tif (previousContextWindow !== replay.contextWindow) {\n\t\tthis._emit({ type: \"context_window_changed\", contextWindow: replay.contextWindow });\n\t}\n}\n\n\nexport function _appendContextWindowChangeIfChanged(this: AgentSession, \n\tpreviousModel: Model<Api> | undefined,\n\tnextModel: Model<Api>,\n): void {\n\tconst replay = this._getResumeContextWindowReplayForModel(nextModel);\n\tif (!replay.wouldWarn && nextModel.contextWindow === replay.contextWindow) return;\n\tthis.sessionManager.appendContextWindowChange(nextModel.contextWindow);\n\tif (previousModel?.contextWindow !== nextModel.contextWindow) {\n\t\tthis._emit({ type: \"context_window_changed\", contextWindow: nextModel.contextWindow });\n\t}\n}\n\n// =========================================================================\n// Queue Mode Management\n// =========================================================================\n\n/**\n * Set steering message mode.\n * Saves to settings.\n */\n\nexport const agentSessionModelsMethods = {\n\t_getRequiredRequestAuth,\n\t_emitModelChanged,\n\t_emitModelSelect,\n\tsetModel,\n\tcycleModel,\n\t_cycleScopedModel,\n\t_cycleAvailableModel,\n\tsetThinkingLevel,\n\tcycleThinkingLevel,\n\tgetAvailableThinkingLevels,\n\tsupportsThinking,\n\t_getThinkingLevelForModelSwitch,\n\t_clampThinkingLevel,\n\tgetAvailableContextWindows,\n\tsupportsContextWindowSelection,\n\tsetContextWindow,\n\t_withContextWindowForModelSwitch,\n\t_shouldCarryCurrentContextWindowForModelSwitch,\n\t_getSettingsContextWindowRequestForModel,\n\t_getContextWindowReplayForModel,\n\t_getDefaultContextWindowReplayForModel,\n\t_getResumeContextWindowReplayForModel,\n\t_applyContextWindowReplay,\n\t_appendContextWindowChangeIfChanged,\n};\n"]}

package/dist/core/agent-session-prompt.d.ts

@@ -0,0 +1,61 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
+import type { AgentSessionInternalSurface as AgentSession } from "./agent-session-methods.ts";
+import type { PromptOptions } from "./agent-session-types.ts";
+export declare function prompt(this: AgentSession, text: string, options?: PromptOptions): Promise<void>;
+export declare function _runAgentPrompt(this: AgentSession, messages: AgentMessage | AgentMessage[]): Promise<void>;
+export declare function _continueQueuedAgentMessages(this: AgentSession): Promise<void>;
+/**
+ * Try to execute a built-in slash command. Returns true if command was found and executed.
+ */
+export declare function _tryExecuteBuiltinSlashCommand(this: AgentSession, text: string): Promise<boolean>;
+/**
+ * Try to execute an extension command. Returns true if command was found and executed.
+ */
+export declare function _tryExecuteExtensionCommand(this: AgentSession, text: string): Promise<boolean>;
+/**
+ * Expand skill commands (/skill:name args) to their full content.
+ * Returns the expanded text, or the original text if not a skill command or skill not found.
+ * Emits errors via extension runner if file read fails.
+ */
+export declare function _expandSkillCommand(this: AgentSession, text: string): string;
+/**
+ * Queue a steering message while the agent is running.
+ * Delivered after the current assistant turn finishes executing its tool calls,
+ * before the next LLM call.
+ * Expands skill commands and prompt templates. Errors on extension commands.
+ * @param images Optional image attachments to include with the message
+ * @throws Error if text is an extension command
+ */
+export declare function steer(this: AgentSession, text: string, images?: ImageContent[]): Promise<void>;
+/**
+ * Queue a follow-up message to be processed after the agent finishes.
+ * Delivered only when agent has no more tool calls or steering messages.
+ * Expands skill commands and prompt templates. Errors on extension commands.
+ * @param images Optional image attachments to include with the message
+ * @throws Error if text is an extension command
+ */
+export declare function followUp(this: AgentSession, text: string, images?: ImageContent[]): Promise<void>;
+/**
+ * Internal: Queue a steering message (already expanded, no extension command check).
+ */
+export declare function sendUserMessage(this: AgentSession, content: string | (TextContent | ImageContent)[], options?: {
+    deliverAs?: "steer" | "followUp";
+}): Promise<void>;
+/**
+ * Clear all queued messages and return them.
+ * Useful for restoring to editor when user aborts.
+ * @returns Object with steering and followUp arrays
+ */
+export declare const agentSessionPromptMethods: {
+    prompt: typeof prompt;
+    _runAgentPrompt: typeof _runAgentPrompt;
+    _continueQueuedAgentMessages: typeof _continueQueuedAgentMessages;
+    _tryExecuteBuiltinSlashCommand: typeof _tryExecuteBuiltinSlashCommand;
+    _tryExecuteExtensionCommand: typeof _tryExecuteExtensionCommand;
+    _expandSkillCommand: typeof _expandSkillCommand;
+    steer: typeof steer;
+    followUp: typeof followUp;
+    sendUserMessage: typeof sendUserMessage;
+};
+//# sourceMappingURL=agent-session-prompt.d.ts.map

package/dist/core/agent-session-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-prompt.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKvE,OAAO,KAAK,EAAE,2BAA2B,IAAI,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,wBAAsB,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwKrG;AAGD,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhH;AAGD,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF;AAED;;GAEG;AAEH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCvG;AAED;;GAEG;AAEH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBpG;AAED;;;;GAIG;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAwB5E;AAED;;;;;;;GAOG;AAEH,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpG;AAED;;;;;;GAMG;AAEH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvG;AAED;;GAEG;AAEH,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,EACvD,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;CAUrC,CAAC","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ImageContent, TextContent } from \"@earendil-works/pi-ai\";\nimport { ATOMIC_GUIDE_COMMAND_NAME, ATOMIC_GUIDE_HELP_CHOICES, atomicGuideModeForChoice, getAtomicGuideMessage, isAtomicGuideHelpChoice, normalizeAtomicGuideMode } from \"./atomic-guide-command.ts\";\nimport { formatAuthStorageLoadFailedMessage, formatNoApiKeyFoundMessage, formatNoModelSelectedMessage, formatUnresolvedModelMessage } from \"./auth-guidance.ts\";\nimport { expandPromptTemplate } from \"./prompt-templates.ts\";\nimport { stripFrontmatter } from \"../utils/frontmatter.ts\";\nimport type { AgentSessionInternalSurface as AgentSession } from \"./agent-session-methods.ts\";\nimport type { PromptOptions } from \"./agent-session-types.ts\";\n\nexport async function prompt(this: AgentSession, text: string, options?: PromptOptions): Promise<void> {\n\tconst expandPromptTemplates = options?.expandPromptTemplates ?? true;\n\tconst preflightResult = options?.preflightResult;\n\tlet messages: AgentMessage[] | undefined;\n\n\ttry {\n\t\t// Handle slash commands first (execute immediately, even during streaming).\n\t\t// Builtin and extension commands manage their own LLM interaction via custom messages.\n\t\tif (expandPromptTemplates && text.startsWith(\"/\")) {\n\t\t\tconst handledBuiltin = await this._tryExecuteBuiltinSlashCommand(text);\n\t\t\tif (handledBuiltin) {\n\t\t\t\tpreflightResult?.(true);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst handledExtension = await this._tryExecuteExtensionCommand(text);\n\t\t\tif (handledExtension) {\n\t\t\t\tpreflightResult?.(true);\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Emit input event for extension interception (before skill/template expansion)\n\t\tlet currentText = text;\n\t\tlet currentImages = options?.images;\n\t\tif (this._extensionRunner.hasHandlers(\"input\")) {\n\t\t\tconst inputResult = await this._extensionRunner.emitInput(\n\t\t\t\tcurrentText,\n\t\t\t\tcurrentImages,\n\t\t\t\toptions?.source ?? \"interactive\",\n\t\t\t\tthis.isStreaming ? options?.streamingBehavior : undefined,\n\t\t\t);\n\t\t\tif (inputResult.action === \"handled\") {\n\t\t\t\tpreflightResult?.(true);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (inputResult.action === \"transform\") {\n\t\t\t\tcurrentText = inputResult.text;\n\t\t\t\tcurrentImages = inputResult.images ?? currentImages;\n\t\t\t}\n\t\t}\n\n\t\t// Expand skill commands (/skill:name args) and prompt templates (/template args)\n\t\tlet expandedText = currentText;\n\t\tif (expandPromptTemplates) {\n\t\t\texpandedText = this._expandSkillCommand(expandedText);\n\t\t\texpandedText = expandPromptTemplate(expandedText, [...this.promptTemplates]);\n\t\t}\n\n\t\t// If streaming, queue via steer() or followUp() based on option\n\t\tif (this.isStreaming) {\n\t\t\tif (!options?.streamingBehavior) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Agent is already processing. Specify streamingBehavior ('steer' or 'followUp') to queue the message.\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (options.streamingBehavior === \"followUp\") {\n\t\t\t\tawait this._queueFollowUp(expandedText, currentImages);\n\t\t\t} else {\n\t\t\t\tawait this._queueSteer(expandedText, currentImages);\n\t\t\t}\n\t\t\tpreflightResult?.(true);\n\t\t\treturn;\n\t\t}\n\n\t\t// Flush any pending bash messages before the new prompt\n\t\tthis._flushPendingBashMessages();\n\n\t\t// Validate model\n\t\tif (!this.model) {\n\t\t\tthrow new Error(formatNoModelSelectedMessage());\n\t\t}\n\n\t\t// Defensive guard: a model that never resolved to a real provider\n\t\t// (for example an unknown/unresolved model id that reached this path\n\t\t// as a bare string) has no `provider`, which would otherwise fail deep\n\t\t// in auth resolution as the confusing \"No API key found for undefined\".\n\t\t// Surface a clear, accurate \"unknown model\" error instead.\n\t\tconst resolvedProvider = (this.model as { provider?: unknown }).provider;\n\t\tif (typeof resolvedProvider !== \"string\" || resolvedProvider.length === 0) {\n\t\t\tthrow new Error(formatUnresolvedModelMessage(this.model));\n\t\t}\n\n\t\tif (!this._modelRegistry.hasConfiguredAuth(this.model)) {\n\t\t\t// A failed credential-store load (for example auth.json briefly locked\n\t\t\t// by a concurrent process, or invalid JSON) leaves an empty in-memory\n\t\t\t// credential set. That would otherwise be misreported here as\n\t\t\t// \"No API key found\" even though the credentials exist on disk. Surface\n\t\t\t// the real load failure instead so configured providers are not falsely\n\t\t\t// reported as unauthenticated (issue #1431).\n\t\t\tconst authLoadError = this._modelRegistry.authStorage.getLoadError();\n\t\t\tif (authLoadError) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tformatAuthStorageLoadFailedMessage(this.model.provider, authLoadError),\n\t\t\t\t\t{ cause: authLoadError },\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst isOAuth = this._modelRegistry.isUsingOAuth(this.model);\n\t\t\tif (isOAuth) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Authentication failed for \"${this.model.provider}\". ` +\n\t\t\t\t\t\t`Credentials may have expired or network is unavailable. ` +\n\t\t\t\t\t\t`Run '/login ${this.model.provider}' to re-authenticate.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow new Error(formatNoApiKeyFoundMessage(this.model.provider));\n\t\t}\n\n\t\t// Check if we need to compact before sending (catches aborted responses)\n\t\tconst lastAssistant = this._findLastAssistantMessage();\n\t\tif (lastAssistant) {\n\t\t\tawait this._checkCompaction(lastAssistant, false);\n\t\t}\n\n\t\t// Build messages array (custom message if any, then user message)\n\t\tmessages = [];\n\n\t\t// Add user message\n\t\tconst userContent: (TextContent | ImageContent)[] = [{ type: \"text\", text: expandedText }];\n\t\tif (currentImages) {\n\t\t\tuserContent.push(...currentImages);\n\t\t}\n\t\tmessages.push({\n\t\t\trole: \"user\",\n\t\t\tcontent: userContent,\n\t\t\ttimestamp: Date.now(),\n\t\t});\n\n\t\t// Inject any pending \"nextTurn\" messages as context alongside the user message\n\t\tfor (const msg of this._pendingNextTurnMessages) {\n\t\t\tmessages.push(msg);\n\t\t}\n\t\tthis._pendingNextTurnMessages = [];\n\n\t\t// Emit before_agent_start extension event\n\t\tconst result = await this._extensionRunner.emitBeforeAgentStart(\n\t\t\texpandedText,\n\t\t\tcurrentImages,\n\t\t\tthis._baseSystemPrompt,\n\t\t\tthis._baseSystemPromptOptions,\n\t\t);\n\t\t// Add all custom messages from extensions\n\t\tif (result?.messages) {\n\t\t\tfor (const msg of result.messages) {\n\t\t\t\tmessages.push({\n\t\t\t\t\trole: \"custom\",\n\t\t\t\t\tcustomType: msg.customType,\n\t\t\t\t\tcontent: msg.content,\n\t\t\t\t\tdisplay: msg.display,\n\t\t\t\t\tdetails: msg.details,\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\t// Apply extension-modified system prompt, or reset to base\n\t\tif (result?.systemPrompt) {\n\t\t\tthis.agent.state.systemPrompt = result.systemPrompt;\n\t\t} else {\n\t\t\t// Ensure we're using the base prompt (in case previous turn had modifications)\n\t\t\tthis.agent.state.systemPrompt = this._baseSystemPrompt;\n\t\t}\n\t} catch (error) {\n\t\tpreflightResult?.(false);\n\t\tthrow error;\n\t}\n\n\tpreflightResult?.(true);\n\tawait this._runAgentPrompt(messages);\n}\n\n\nexport async function _runAgentPrompt(this: AgentSession, messages: AgentMessage | AgentMessage[]): Promise<void> {\n\tawait this.agent.prompt(messages);\n\tawait this.waitForRetry();\n\tawait this._continueQueuedAgentMessages();\n}\n\n\nexport async function _continueQueuedAgentMessages(this: AgentSession): Promise<void> {\n\tawait this._agentEventQueue;\n\n\twhile (this.agent.hasQueuedMessages()) {\n\t\tawait this.agent.continue();\n\t\tawait this.waitForRetry();\n\t\tawait this._agentEventQueue;\n\t}\n}\n\n/**\n * Try to execute a built-in slash command. Returns true if command was found and executed.\n */\n\nexport async function _tryExecuteBuiltinSlashCommand(this: AgentSession, text: string): Promise<boolean> {\n\tconst spaceIndex = text.indexOf(\" \");\n\tconst commandName = spaceIndex === -1 ? text.slice(1) : text.slice(1, spaceIndex);\n\tif (commandName !== ATOMIC_GUIDE_COMMAND_NAME) return false;\n\n\tconst args = spaceIndex === -1 ? \"\" : text.slice(spaceIndex + 1);\n\tconst mode = normalizeAtomicGuideMode(args);\n\tif (mode === \"help\" && this._extensionUIContext) {\n\t\tconst choice = await this._extensionUIContext.select(\"Atomic. Select where to start:\", [\n\t\t\t...ATOMIC_GUIDE_HELP_CHOICES,\n\t\t]);\n\t\tif (!choice || !isAtomicGuideHelpChoice(choice)) return true;\n\t\tawait this.sendCustomMessage(\n\t\t\t{\n\t\t\t\tcustomType: \"atomic\",\n\t\t\t\tcontent: getAtomicGuideMessage(atomicGuideModeForChoice(choice), this._cwd),\n\t\t\t\tdisplay: true,\n\t\t\t},\n\t\t\t{ triggerTurn: false },\n\t\t);\n\t\treturn true;\n\t}\n\n\tawait this.sendCustomMessage(\n\t\t{\n\t\t\tcustomType: \"atomic\",\n\t\t\tcontent: getAtomicGuideMessage(mode, this._cwd),\n\t\t\tdisplay: true,\n\t\t},\n\t\t{ triggerTurn: false },\n\t);\n\treturn true;\n}\n\n/**\n * Try to execute an extension command. Returns true if command was found and executed.\n */\n\nexport async function _tryExecuteExtensionCommand(this: AgentSession, text: string): Promise<boolean> {\n\t// Parse command name and args\n\tconst spaceIndex = text.indexOf(\" \");\n\tconst commandName = spaceIndex === -1 ? text.slice(1) : text.slice(1, spaceIndex);\n\tconst args = spaceIndex === -1 ? \"\" : text.slice(spaceIndex + 1);\n\n\tconst command = this._extensionRunner.getCommand(commandName);\n\tif (!command) return false;\n\n\t// Get command context from extension runner (includes session control methods)\n\tconst ctx = this._extensionRunner.createCommandContext();\n\n\ttry {\n\t\tawait command.handler(args, ctx);\n\t\treturn true;\n\t} catch (err) {\n\t\t// Emit error via extension runner\n\t\tthis._extensionRunner.emitError({\n\t\t\textensionPath: `command:${commandName}`,\n\t\t\tevent: \"command\",\n\t\t\terror: err instanceof Error ? err.message : String(err),\n\t\t});\n\t\treturn true;\n\t}\n}\n\n/**\n * Expand skill commands (/skill:name args) to their full content.\n * Returns the expanded text, or the original text if not a skill command or skill not found.\n * Emits errors via extension runner if file read fails.\n */\n\nexport function _expandSkillCommand(this: AgentSession, text: string): string {\n\tif (!text.startsWith(\"/skill:\")) return text;\n\n\tconst spaceIndex = text.indexOf(\" \");\n\tconst skillName = spaceIndex === -1 ? text.slice(7) : text.slice(7, spaceIndex);\n\tconst args = spaceIndex === -1 ? \"\" : text.slice(spaceIndex + 1).trim();\n\n\tconst skill = this.resourceLoader.getSkills().skills.find((s) => s.name === skillName);\n\tif (!skill) return text; // Unknown skill, pass through\n\n\ttry {\n\t\tconst content = readFileSync(skill.filePath, \"utf-8\");\n\t\tconst body = stripFrontmatter(content).trim();\n\t\tconst skillBlock = `<skill name=\"${skill.name}\" location=\"${skill.filePath}\">\\nReferences are relative to ${skill.baseDir}.\\n\\n${body}\\n</skill>`;\n\t\treturn args ? `${skillBlock}\\n\\n${args}` : skillBlock;\n\t} catch (err) {\n\t\t// Emit error like extension commands do\n\t\tthis._extensionRunner.emitError({\n\t\t\textensionPath: skill.filePath,\n\t\t\tevent: \"skill_expansion\",\n\t\t\terror: err instanceof Error ? err.message : String(err),\n\t\t});\n\t\treturn text; // Return original on error\n\t}\n}\n\n/**\n * Queue a steering message while the agent is running.\n * Delivered after the current assistant turn finishes executing its tool calls,\n * before the next LLM call.\n * Expands skill commands and prompt templates. Errors on extension commands.\n * @param images Optional image attachments to include with the message\n * @throws Error if text is an extension command\n */\n\nexport async function steer(this: AgentSession, text: string, images?: ImageContent[]): Promise<void> {\n\t// Check for extension commands (cannot be queued)\n\tif (text.startsWith(\"/\")) {\n\t\tthis._throwIfExtensionCommand(text);\n\t}\n\n\t// Expand skill commands and prompt templates\n\tlet expandedText = this._expandSkillCommand(text);\n\texpandedText = expandPromptTemplate(expandedText, [...this.promptTemplates]);\n\n\tawait this._queueSteer(expandedText, images);\n}\n\n/**\n * Queue a follow-up message to be processed after the agent finishes.\n * Delivered only when agent has no more tool calls or steering messages.\n * Expands skill commands and prompt templates. Errors on extension commands.\n * @param images Optional image attachments to include with the message\n * @throws Error if text is an extension command\n */\n\nexport async function followUp(this: AgentSession, text: string, images?: ImageContent[]): Promise<void> {\n\t// Check for extension commands (cannot be queued)\n\tif (text.startsWith(\"/\")) {\n\t\tthis._throwIfExtensionCommand(text);\n\t}\n\n\t// Expand skill commands and prompt templates\n\tlet expandedText = this._expandSkillCommand(text);\n\texpandedText = expandPromptTemplate(expandedText, [...this.promptTemplates]);\n\n\tawait this._queueFollowUp(expandedText, images);\n}\n\n/**\n * Internal: Queue a steering message (already expanded, no extension command check).\n */\n\nexport async function sendUserMessage(this: AgentSession, \n\tcontent: string | (TextContent | ImageContent)[],\n\toptions?: { deliverAs?: \"steer\" | \"followUp\" },\n): Promise<void> {\n\t// Normalize content to text string + optional images\n\tlet text: string;\n\tlet images: ImageContent[] | undefined;\n\n\tif (typeof content === \"string\") {\n\t\ttext = content;\n\t} else {\n\t\tconst textParts: string[] = [];\n\t\timages = [];\n\t\tfor (const part of content) {\n\t\t\tif (part.type === \"text\") {\n\t\t\t\ttextParts.push(part.text);\n\t\t\t} else {\n\t\t\t\timages.push(part);\n\t\t\t}\n\t\t}\n\t\ttext = textParts.join(\"\\n\");\n\t\tif (images.length === 0) images = undefined;\n\t}\n\n\t// Use prompt() with expandPromptTemplates: false to skip command handling and template expansion\n\tawait this.prompt(text, {\n\t\texpandPromptTemplates: false,\n\t\tstreamingBehavior: options?.deliverAs,\n\t\timages,\n\t\tsource: \"extension\",\n\t});\n}\n\n/**\n * Clear all queued messages and return them.\n * Useful for restoring to editor when user aborts.\n * @returns Object with steering and followUp arrays\n */\n\nexport const agentSessionPromptMethods = {\n\tprompt,\n\t_runAgentPrompt,\n\t_continueQueuedAgentMessages,\n\t_tryExecuteBuiltinSlashCommand,\n\t_tryExecuteExtensionCommand,\n\t_expandSkillCommand,\n\tsteer,\n\tfollowUp,\n\tsendUserMessage,\n};\n"]}