@xopcai/xopc 0.0.352 → 0.0.354

package/dist/src/agent/prompt/sections/project-context.js

@@ -1,15 +1,12 @@
-import { DEFAULT_HEARTBEAT_FILENAME } from "../../context/workspace.js";
 //#region src/agent/prompt/sections/project-context.ts
 const CONTEXT_FILE_ORDER = new Map([
 	["agents.md", 10],
 	["soul.md", 20],
-	["identity.md", 30],
 	["user.md", 40],
 	["tools.md", 50],
 	["bootstrap.md", 60],
 	["memory.md", 70]
 ]);
-const DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK = "Default heartbeat prompt:\n`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`";
 function normalizeContextFilePath(pathValue) {
 	return pathValue.trim().replace(/\\/g, "/");
 }
@@ -18,7 +15,7 @@ function getContextFileBasename(pathValue) {
 	return (normalizedPath.split("/").pop() ?? normalizedPath).toLowerCase();
 }
 function sanitizeContextFileContentForPrompt(content) {
-	return content.replaceAll(DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK, "").replace(/\n{3,}/g, "\n\n");
+	return content.replace(/\n{3,}/g, "\n\n");
 }
 function sortContextFilesForPrompt(contextFiles) {
 	return [...contextFiles].sort((a, b) => {
@@ -41,9 +38,5 @@ function buildProjectContextSection(params) {
 	for (const file of params.files) lines.push(`## ${file.path}`, "", sanitizeContextFileContentForPrompt(file.content), "");
 	return lines;
 }
-/** Heartbeat content belongs to the heartbeat user turn, never the system prompt. */
-function isHeartbeatContextFile(pathValue) {
-	return getContextFileBasename(pathValue) === DEFAULT_HEARTBEAT_FILENAME.toLowerCase();
-}
 //#endregion
-export { CONTEXT_FILE_ORDER, DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK, buildProjectContextSection, getContextFileBasename, isHeartbeatContextFile, normalizeContextFilePath, sanitizeContextFileContentForPrompt, sortContextFilesForPrompt };
+export { CONTEXT_FILE_ORDER, buildProjectContextSection, getContextFileBasename, normalizeContextFilePath, sanitizeContextFileContentForPrompt, sortContextFilesForPrompt };

package/dist/src/agent/prompt/sections/tooling.js

@@ -142,7 +142,7 @@ function buildToolingSection(params) {
 		hasRead ? `Use \`${readToolName}\` for targeted file inspection before editing; do not rely on filenames alone.` : "",
 		hasPatch ? `Use \`${patchToolName}\` for source changes; keep patches focused and inspect failures carefully.` : "",
 		hasWrite ? `Use \`${writeToolName}\` only for new files or intentional complete rewrites.` : "",
-		hasXopcUse && hasRead && hasWrite ? `When the user explicitly asks to change or customize the current agent's name, identity, personality, instructions, working style, tools, workspace, or heartbeat, persist the change instead of only drafting advice. Inspect the current state first; use \`${readToolName}\` and \`${writeToolName}\` for the current agent's profile Markdown, and use \`xopc_use\` mode \`agent\` for structured settings. Target only the current runtime agent unless the user names another one, verify the saved result, and ask before consequential capability or scope expansion when intent is ambiguous.` : "",
+		hasXopcUse && hasRead && hasWrite ? `When the user explicitly asks to change or customize the current agent's name, identity, personality, instructions, working style, tools, or workspace, persist the change instead of only drafting advice. Inspect the current state first; use \`${readToolName}\` and \`${writeToolName}\` for the current agent's profile Markdown, and use \`xopc_use\` mode \`agent\` for structured settings. Target only the current runtime agent unless the user names another one, verify the saved result, and ask before consequential capability or scope expansion when intent is ambiguous.` : "",
 		hasXopcUse ? "When the user explicitly asks to create an Agent, use `xopc_use` mode `agent`: list first, create the Agent without a Project or custom workspace unless the user requests one, verify the result, and clearly identify the created Agent so the user can open its own conversation for further customization." : "",
 		hasGrep || hasFind ? `Use ${[hasGrep ? `\`${grepToolName}\`` : "", hasFind ? `\`${findToolName}\`` : ""].filter(Boolean).join(" and ")} for text/file discovery; use code graph or symbol tools when available for definitions and call relationships.` : "",
 		hasExec ? `Use \`${execToolName}\` for verification and safe inspection, not routine file editing.` : "",

package/dist/src/agent/prompt/service-prompt-builder.d.ts

@@ -4,6 +4,7 @@
  * Combines base system prompt with skill prompts and bootstrap Project Context.
  */
 import type { Config } from '../../config/schema.js';
+import type { AgentProfile } from '../../agent-config/index.js';
 import type { EmbeddedContextFile } from '../bootstrap/types.js';
 import type { SkillManager } from '../skills/skill-manager.js';
 import type { PromptMode, SilentReplyPromptMode } from './types.js';
@@ -13,6 +14,7 @@ export interface SystemPromptBuildOptions {
     workspaceOverride?: string;
     profileMarkdownPathRoot?: string;
     customInstructions?: string;
+    agentProfile?: AgentProfile;
     skillPromptText?: string;
     skillAllowlist?: string[];
     registeredToolNames?: string[];

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -7,13 +7,13 @@ import { DEFAULT_USER_TRUST_LEVEL, init_trust_policy } from "../../user-context/
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { appendStablePromptSection } from "./cache-boundary.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
-import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
 import { getUserTimezone } from "../../user-model/repository.js";
 import "../../user-model/index.js";
 import { resolveSystemPromptBuildParams } from "./system-prompt-params.js";
 import { buildSystemPrompt } from "./system-prompt.js";
 import { resolveResponseLanguageForSession } from "./response-language.js";
+import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 //#region src/agent/prompt/service-prompt-builder.ts
 init_sqlite();
 init_interaction_state();
@@ -34,7 +34,6 @@ var SystemPromptBuilder = class {
 		const actionTrustLevel = isXopcDatabaseOpen() ? getUserTrustPolicy().defaultActionLevel : DEFAULT_USER_TRUST_LEVEL;
 		const interactionState = isXopcDatabaseOpen() && options.conversationId ? getInteractionState(options.conversationId) : void 0;
 		const interactionPrompt = interactionState ? buildInteractionStatePrompt(interactionState) : "";
-		const heartbeatEnabled = this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false;
 		const userTimezone = isXopcDatabaseOpen() ? getUserTimezone() : void 0;
 		const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);
 		const reg = options.registeredToolNames ?? [];
@@ -53,7 +52,6 @@ var SystemPromptBuilder = class {
 			toolSummaries: options.toolSummaries,
 			userTimezone,
 			externalMemoryInstructions: options.externalMemoryInstructions,
-			heartbeatEnabled,
 			ttsSystemHint,
 			extraSystemPrompt: [options.extraSystemPrompt, interactionPrompt].filter(Boolean).join("\n\n"),
 			activeProjectContext: options.activeProjectContext,
@@ -67,8 +65,6 @@ var SystemPromptBuilder = class {
 		const basePrompt = buildSystemPrompt(ws, {
 			contextFiles,
 			promptMode: resolved.promptMode,
-			heartbeatEnabled: resolved.heartbeatEnabled,
-			heartbeatPrompt: resolved.heartbeatPrompt,
 			toolNames: resolved.toolNames,
 			toolSummaries: resolved.toolSummaries,
 			memoryCitationsMode: resolved.memoryCitationsMode,
@@ -87,7 +83,8 @@ var SystemPromptBuilder = class {
 			includeToneSection: resolved.includeToneSection,
 			actionTrustLevel,
 			responseLanguage,
-			customInstructions: options.customInstructions
+			customInstructions: options.customInstructions,
+			agentProfile: options.agentProfile
 		});
 		const skillPrompt = options.skillPromptText !== void 0 ? options.skillPromptText : this.skillManager.getPromptForSkillAllowlist(options.skillAllowlist, options.registeredToolNames);
 		const fullPrompt = skillPrompt ? appendStablePromptSection(basePrompt, skillPrompt) : basePrompt;
@@ -115,13 +112,11 @@ var SystemPromptBuilder = class {
 			conversationId: options?.conversationId,
 			toolNames: options?.registeredToolNames,
 			userTimezone: isXopcDatabaseOpen() ? getUserTimezone() : void 0,
-			externalMemoryInstructions: options?.externalMemoryInstructions,
-			heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false
+			externalMemoryInstructions: options?.externalMemoryInstructions
 		});
 		return buildSystemPrompt(ws, {
 			contextFiles,
 			promptMode: resolved.promptMode,
-			heartbeatEnabled: resolved.heartbeatEnabled,
 			toolNames: resolved.toolNames,
 			userTimezone: resolved.userTimezone,
 			runtime: resolved.runtimeInfo,

package/dist/src/agent/prompt/subagent-context.js

@@ -1,4 +1,4 @@
-import { NO_REPLY } from "../../heartbeat/tokens.js";
+import { NO_REPLY } from "../messaging/no-reply.js";
 import { buildSystemPrompt } from "./system-prompt.js";
 //#region src/agent/prompt/subagent-context.ts
 function buildSubagentContextSection(params) {

package/dist/src/agent/prompt/system-prompt-params.d.ts

@@ -21,8 +21,6 @@ export interface SystemPromptBuildParams {
     channels?: string[];
     memoryCitationsMode?: MemoryCitationsMode;
     includeMemorySection?: boolean;
-    heartbeatEnabled?: boolean;
-    heartbeatPrompt?: string;
     externalMemoryInstructions?: string;
     ttsSystemHint?: string;
     extraSystemPrompt?: string;
@@ -39,8 +37,6 @@ export declare function resolveSystemPromptBuildParams(config: Config, params: {
     toolSummaries?: Record<string, string>;
     userTimezone?: string;
     externalMemoryInstructions?: string;
-    heartbeatEnabled?: boolean;
-    heartbeatPrompt?: string;
     ttsSystemHint?: string;
     extraSystemPrompt?: string;
     activeProjectContext?: string;

package/dist/src/agent/prompt/system-prompt-params.js

@@ -58,8 +58,6 @@ function resolveSystemPromptBuildParams(config, params) {
 		channels: resolveDeliverableChannels(config),
 		memoryCitationsMode: params.memoryCitationsMode,
 		includeMemorySection: params.includeMemorySection,
-		heartbeatEnabled: params.heartbeatEnabled,
-		heartbeatPrompt: params.heartbeatPrompt,
 		externalMemoryInstructions: params.externalMemoryInstructions,
 		ttsSystemHint: params.ttsSystemHint,
 		extraSystemPrompt: params.extraSystemPrompt,

package/dist/src/agent/prompt/system-prompt.d.ts

@@ -6,6 +6,7 @@
  * not to manually reread startup files.
  */
 import type { EmbeddedContextFile } from '../bootstrap/types.js';
+import type { AgentProfile } from '../../agent-config/index.js';
 import type { ResponseLanguage } from '../../i18n/response-language.js';
 import { type UserTrustLevel } from '../../user-context/trust-policy.js';
 import type { ProviderSystemPromptContribution } from './contribution.js';
@@ -16,8 +17,6 @@ export { getContextFileBasename, sortContextFilesForPrompt, } from './sections/p
 export interface SystemPromptOptions {
     contextFiles?: EmbeddedContextFile[];
     promptMode?: PromptMode;
-    heartbeatEnabled?: boolean;
-    heartbeatPrompt?: string;
     /** Registered tool names for Tooling section and memory/skills gating. */
     toolNames?: string[];
     toolSummaries?: Record<string, string>;
@@ -38,6 +37,7 @@ export interface SystemPromptOptions {
     actionTrustLevel?: UserTrustLevel;
     responseLanguage?: ResponseLanguage;
     customInstructions?: string;
+    agentProfile?: AgentProfile;
 }
 /**
  * Build system prompt with bootstrap Project Context integration.

package/dist/src/agent/prompt/system-prompt.js

@@ -2,11 +2,12 @@ import { buildActionTrustPrompt, init_trust_policy } from "../../user-context/tr
 import { PROMPT_CACHE_BOUNDARY, splitPromptCacheBoundary } from "./cache-boundary.js";
 import { buildAestheticSection, buildExecutionBiasSection, buildHumanCollaborationSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection, buildWorkContinuitySection } from "./sections/behavior.js";
 import { buildExternalMemorySection, buildMemorySection, buildSkillsSection } from "./sections/memory-skills.js";
-import { buildHeartbeatBehaviorSection, buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection } from "./sections/messaging-runtime.js";
-import { buildProjectContextSection, getContextFileBasename, isHeartbeatContextFile, sortContextFilesForPrompt } from "./sections/project-context.js";
+import { buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection } from "./sections/messaging-runtime.js";
+import { buildProjectContextSection, getContextFileBasename, sortContextFilesForPrompt } from "./sections/project-context.js";
 import { buildToolingSection, hasSkillsTools } from "./sections/tooling.js";
 import { buildRuntimeSection, buildWorkspaceFilesIntroSection, buildWorkspaceSection } from "./sections/workspace-runtime.js";
 import { buildResponseLanguageSection } from "./sections/response-language.js";
+import { buildAgentIdentitySection } from "./sections/agent-identity.js";
 import { buildOverridablePromptSection } from "./system-prompt-params.js";
 //#region src/agent/prompt/system-prompt.ts
 init_trust_policy();
@@ -17,9 +18,10 @@ function joinSections(sections) {
 * Build system prompt with bootstrap Project Context integration.
 */
 function buildSystemPrompt(workspaceDir, options = {}) {
-	const { contextFiles = [], promptMode = "full", heartbeatEnabled = false, heartbeatPrompt, toolNames = [], toolSummaries, memoryCitationsMode = "on", includeMemorySection, userTimezone, runtime, agentId, channels = [], externalMemoryInstructions, ttsSystemHint, extraSystemPrompt, activeProjectContext, silentReplyPromptMode = "generic", promptContribution, includeProblemSolving = true, includeToneSection = true, actionTrustLevel, responseLanguage = "auto", customInstructions } = options;
+	const { contextFiles = [], promptMode = "full", toolNames = [], toolSummaries, memoryCitationsMode = "on", includeMemorySection, userTimezone, runtime, agentId, channels = [], externalMemoryInstructions, ttsSystemHint, extraSystemPrompt, activeProjectContext, silentReplyPromptMode = "generic", promptContribution, includeProblemSolving = true, includeToneSection = true, actionTrustLevel, responseLanguage = "auto", customInstructions, agentProfile } = options;
 	if (promptMode === "none") return joinSections([
 		"You are a personal AI assistant running inside xopc.",
+		buildAgentIdentitySection(agentProfile),
 		customInstructions?.trim() ? `<custom_instructions>\n${customInstructions.trim()}\n</custom_instructions>` : void 0,
 		buildResponseLanguageSection(responseLanguage),
 		activeProjectContext
@@ -28,10 +30,11 @@ function buildSystemPrompt(workspaceDir, options = {}) {
 	const normalizedTools = new Set(toolNames.map((tool) => tool.toLowerCase()));
 	const effectiveAgentId = agentId ?? runtime?.agentId;
 	const sectionOverrides = promptContribution?.sectionOverrides ?? {};
-	const orderedContextFiles = sortContextFilesForPrompt(contextFiles.filter((file) => file.path.trim().length > 0 && !isHeartbeatContextFile(file.path)));
+	const orderedContextFiles = sortContextFilesForPrompt(contextFiles.filter((file) => file.path.trim().length > 0));
 	const hasProfileMemory = orderedContextFiles.some((file) => getContextFileBasename(file.path) === "memory.md");
 	const stableSections = [
 		"You are a personal AI assistant running inside xopc.",
+		buildAgentIdentitySection(agentProfile) ?? "",
 		...customInstructions?.trim() ? [`<custom_instructions>\n${customInstructions.trim()}\n</custom_instructions>`] : [],
 		buildResponseLanguageSection(responseLanguage),
 		buildToolingSection({
@@ -95,11 +98,7 @@ function buildSystemPrompt(workspaceDir, options = {}) {
 		fallback: ""
 	});
 	if (providerDynamicSuffix) dynamicSections.push(providerDynamicSuffix);
-	dynamicSections.push(buildHeartbeatBehaviorSection({
-		enabled: heartbeatEnabled,
-		customPrompt: heartbeatPrompt,
-		userTimezone
-	}), buildRuntimeSection(runtime));
+	dynamicSections.push(buildRuntimeSection(runtime));
 	const stablePrefix = joinSections(stableSections);
 	const dynamicSuffix = joinSections(dynamicSections);
 	if (!dynamicSuffix.trim()) return `${stablePrefix}\n\n${PROMPT_CACHE_BOUNDARY}`.trim();

package/dist/src/agent/sandbox/exec-policy.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { prepareSafeToolEnv } from "./sanitize-env-vars.js";
 import { validatePath, validateWritePath } from "./path-policy.js";
+import { prepareSafeToolEnv } from "./sanitize-env-vars.js";
 import { auditCommand, validateCommand } from "./command-validator.js";
 import { DEFAULT_SANDBOX_CONFIG } from "./types.js";
 import { resolve } from "node:path";

package/dist/src/agent/service/direct-turn-helpers.js

@@ -1,14 +1,14 @@
 import { getClarificationResumeInput, init_clarification_wait_repository } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
+import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
+import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
+import { buildDelegatedTaskDirective, buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
+import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../chat-commands/command-parse.js";
 import { commandRegistry } from "../../chat-commands/registry.js";
 import "../../chat-commands/index.js";
-import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
-import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
-import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { injectSourceContextsIntoUserMessage } from "../source-context/injector.js";
-import { buildDelegatedTaskDirective, buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
 import { prependAgentContext } from "../context/prepend.js";
 import crypto from "node:crypto";
 //#region src/agent/service/direct-turn-helpers.ts

package/dist/src/agent/service/process-direct-one-shot.js

@@ -1,6 +1,6 @@
+import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
 import { initSessionTurn } from "../../session/init-session-turn.js";
 import "../../session/index.js";
-import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
 import { buildDirectUserMessageContent } from "./build-direct-message-content.js";
 import { hydratePerTurnState, runDirectAgentTurn, tryRunSlashCommand } from "./direct-turn-helpers.js";
 //#region src/agent/service/process-direct-one-shot.ts

package/dist/src/agent/service/process-direct-streaming.js

@@ -5,18 +5,18 @@ import { getClarificationResumeInput, init_clarification_wait_repository } from
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { init_agent_session_key, resolveAgentMainConversationId } from "../../routing/agent-session-key.js";
-import { stripEnvelopeTimestampPrefix } from "../../channels/envelope-timestamp.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
+import { abortEmbeddedRun } from "../embedded/runs.js";
+import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
 import { mergeSttConfigFromAppConfig } from "../../voice/stt/config.js";
 import "../../voice/stt/index.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
+import { formatAgentRunErrorForClient } from "../client-error-format.js";
 import { resolveConfiguredActivityDetailDefault, resolveEffectiveReasoningLevel } from "../../session/thinking-resolve.js";
 import { initSessionTurn } from "../../session/init-session-turn.js";
 import "../../session/index.js";
-import { abortEmbeddedRun } from "../embedded/runs.js";
-import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
+import { stripEnvelopeTimestampPrefix } from "../../channels/envelope-timestamp.js";
 import { isVoiceLikeAttachment, mergeVoiceTranscriptsIntoUserText, requestsOriginalVoiceInspection } from "../../channels/attachments/voice-stt-webchat.js";
 import { applyReasoningVisibility } from "../streaming/reasoning-visibility.js";
-import { formatAgentRunErrorForClient } from "../client-error-format.js";
 import { isSessionSourceBinding, summarizeSourceContext } from "../source-context/types.js";
 import { injectSourceContextsIntoUserMessage } from "../source-context/injector.js";
 import { AsyncQueue, AsyncQueueOverflowError } from "./async-queue.js";

package/dist/src/agent/service/webchat-tts.js

@@ -1,12 +1,12 @@
 import { appendMediaToAssistantTranscriptEntry, findLatestAssistantTranscriptEntryId } from "../../storage/sqlite/transcript-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { isTTSAvailable } from "../../voice/tts/factory.js";
+import { speak } from "../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { getChannelOutputFormat, shouldUseTTS } from "../../voice/tts/service.js";
-import { speak } from "../../voice/tts/speak-core.js";
 import { compressAudio } from "../../voice/tts/audio.js";
-import "../../voice/tts/index.js";
 import { persistOutboundTtsAudio } from "../../channels/attachments/outbound-tts-persist.js";
+import "../../voice/tts/index.js";
 import { deleteMediaUris } from "../../media/session-references.js";
 //#region src/agent/service/webchat-tts.ts
 init_sqlite();

package/dist/src/agent/service.js

@@ -1,34 +1,43 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_attachment_ref, parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
-import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
-import { extractTextContent } from "./context/workspace.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
+import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
-import { removeSkillsLockEntry } from "./skills/hub-lock.js";
-import { installSkillFromZip } from "./skills/managed-store.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
+import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
-import { getUserTimezone } from "../user-model/repository.js";
-import "../user-model/index.js";
-import { initializeCommands } from "../chat-commands/index.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
-import { ExtensionHookRunner } from "../extensions/hooks.js";
-import "../extensions/index.js";
+import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";
+import { removeSkillsLockEntry } from "./skills/hub-lock.js";
+import { installSkillFromZip } from "./skills/managed-store.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./skills/workspace-skills-dir.js";
 import { pullSkillFromSource } from "./skills/hub-pull.js";
+import { getUserTimezone } from "../user-model/repository.js";
+import "../user-model/index.js";
+import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
+import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";
+import { buildTranscriptUserMessage, hydrateUserTurnForLlm } from "./inbound/attachment-pipeline.js";
+import { resolveCompactionPolicy } from "./memory/compaction-policy.js";
+import { getModelThinking } from "../providers/model-thinking.js";
+import { runXopcEmbeddedTurn } from "./embedded/run-turn.js";
+import { resolveResponseLanguageForSession } from "./prompt/response-language.js";
+import { normalizeSkillInstallTarget } from "./skills/install-target.js";
+import { AgentManager } from "./agent-manager.js";
 import { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from "../gateway/chat-limits.js";
 import { maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle } from "../session/session-title.js";
-import { resolveCompactionPolicy } from "./memory/compaction-policy.js";
 import { SessionStore } from "../session/store.js";
-import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { SessionConfigStore } from "../session/config-store.js";
 import "../session/index.js";
+import { ExtensionHookRunner } from "../extensions/hooks.js";
+import "../extensions/index.js";
 import { SessionTracker } from "./session/tracker.js";
 import { ModelManager } from "./models/manager.js";
 import "./models/index.js";
+import { initializeCommands } from "../chat-commands/index.js";
 import { HookHandler } from "./lifecycle/hook-handler.js";
 import { ToolErrorTracker } from "./tools/error-tracker.js";
 import { RequestLimiter } from "./models/request-limiter.js";
@@ -40,11 +49,6 @@ import { ContextMiddleware } from "./middleware/context.js";
 import "./middleware/index.js";
 import { LifecycleManager } from "./lifecycle/manager.js";
 import "./lifecycle/index.js";
-import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
-import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";
-import { buildTranscriptUserMessage, hydrateUserTurnForLlm } from "./inbound/attachment-pipeline.js";
-import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";
-import { runXopcEmbeddedTurn } from "./embedded/run-turn.js";
 import { MessageRouter } from "./messaging/message-router.js";
 import { CommandHandler } from "./messaging/command-handler.js";
 import { StreamManager } from "./messaging/stream-manager.js";
@@ -63,10 +67,7 @@ import { AgentOrchestrator } from "./orchestration/agent-orchestrator.js";
 import { AgentEventHandler } from "./orchestration/agent-event-handler.js";
 import "./orchestration/index.js";
 import { getWorkflowProgressBroker } from "./workflow/progress-broker.js";
-import { resolveResponseLanguageForSession } from "./prompt/response-language.js";
 import "./workflow/index.js";
-import { normalizeSkillInstallTarget } from "./skills/install-target.js";
-import { AgentManager } from "./agent-manager.js";
 import { TaskJudgeService } from "./tasks/task-judge-service.js";
 import { analyzeResponseLanguage } from "../i18n/language-consistency.js";
 import { readFile } from "node:fs/promises";
@@ -355,7 +356,6 @@ var AgentService = class {
 			bus,
 			hookHandler: this.hookHandler,
 			streamManager: this.streamManager,
-			getConfig: () => this.effectiveAppConfig(),
 			getLastAssistantPlainText: (sk) => this.getLastAssistantPlainText(sk),
 			reviewTaskTurn: (payload) => this.taskJudge.reviewTurn(payload)
 		});
@@ -630,6 +630,8 @@ var AgentService = class {
 		}), params.runId);
 	}
 	async switchModelForSession(conversationId, modelId) {
+		const configuredThinking = resolveEffectiveAgentConfigForSession(conversationId).config.runtime.thinkingLevel;
+		if (configuredThinking && !getModelThinking(resolveModel(modelId)).options.includes(configuredThinking)) return false;
 		if (!await this.modelManager.switchModelForSession(conversationId, modelId)) return false;
 		await this.sessionConfigStore.update(conversationId, { modelOverride: modelId });
 		if (this.agentManager.setModelForSession(conversationId, modelId)) this.sessionTracker.touchSession(conversationId);

package/dist/src/agent/session/session-config-service.js

@@ -3,11 +3,12 @@ import { init_logger } from "../../utils/logger.js";
 import { chooseModelThinking } from "../../../packages/gateway-contract/src/model-selection.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { ResponseLanguageSchema, init_response_language } from "../../i18n/response-language.js";
+import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { normalizeWorkingDirectoryInput } from "../../session/session-workspace.js";
 import { getProjectWorkspacePathForSession } from "../../projects/workspace.js";
+import { getModelThinking } from "../../providers/model-thinking.js";
 import { normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel } from "../transcript/thinking-types.js";
 import "../../session/index.js";
-import { getModelThinking } from "../../providers/model-thinking.js";
 import { mkdir } from "node:fs/promises";
 //#region src/agent/session/session-config-service.ts
 init_src();
@@ -25,6 +26,16 @@ var SessionConfigService = class {
 	* invalid field. Model and thinking are validated together and committed in one write.
 	*/
 	async patch(conversationId, partial) {
+		const configuredThinking = resolveEffectiveAgentConfigForSession(conversationId).config.runtime.thinkingLevel;
+		if (configuredThinking && partial.thinkingLevel !== void 0 && partial.thinkingLevel !== configuredThinking) return {
+			ok: false,
+			code: "INVALID_THINKING",
+			error: `This agent uses thinking ${configuredThinking}`
+		};
+		if (configuredThinking && (partial.model !== void 0 || partial.thinkingLevel !== void 0)) partial = {
+			...partial,
+			thinkingLevel: configuredThinking
+		};
 		if (partial.model !== void 0 || partial.thinkingLevel !== void 0 || partial.fixedModel) {
 			const existing = await this.opts.sessionConfigStore.get(conversationId);
 			if (partial.configVersion !== void 0 && partial.configVersion !== (existing?.updatedAt ?? 0)) return {
@@ -134,6 +145,13 @@ var SessionConfigService = class {
 	}
 	/** Materialize a restored/new chat choice; unavailable identities stay visible for repair. */
 	async initializeModelSelection(conversationId, modelRef, thinkingLevel, configVersion) {
+		const configuredThinking = resolveEffectiveAgentConfigForSession(conversationId).config.runtime.thinkingLevel;
+		if (configuredThinking && thinkingLevel !== void 0 && thinkingLevel !== configuredThinking) return {
+			ok: false,
+			code: "INVALID_THINKING",
+			error: `This agent uses thinking ${configuredThinking}`
+		};
+		if (configuredThinking) thinkingLevel = configuredThinking;
 		const existing = await this.opts.sessionConfigStore.get(conversationId);
 		if (configVersion !== void 0 && configVersion !== (existing?.updatedAt ?? 0)) return {
 			ok: false,
@@ -147,6 +165,11 @@ var SessionConfigService = class {
 			fixedModel: true,
 			configVersion
 		});
+		if (configuredThinking) return {
+			ok: false,
+			code: "INVALID_MODEL",
+			error: `Select an available model that supports thinking ${configuredThinking}`
+		};
 		if (!modelRef.trim() || !modelRef.includes("/")) return {
 			ok: false,
 			code: "INVALID_MODEL",
@@ -192,6 +215,9 @@ var SessionConfigService = class {
 	*/
 	async applyAutomationModelOverride(conversationId, model) {
 		const raw = model?.trim();
+		const configuredThinking = resolveEffectiveAgentConfigForSession(conversationId).config.runtime.thinkingLevel;
+		const selectedModel = raw ? this.opts.modelManager.findByRef(raw) : void 0;
+		if (configuredThinking && (!selectedModel || !getModelThinking(selectedModel).options.includes(configuredThinking))) return false;
 		if (!raw) {
 			await this.clearModelOverride(conversationId);
 			return true;

package/dist/src/agent/session/session-hydrator.js

@@ -3,9 +3,9 @@ import { init_logger } from "../../utils/logger.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";
+import { getModelThinking } from "../../providers/model-thinking.js";
 import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import "../../session/index.js";
-import { getModelThinking } from "../../providers/model-thinking.js";
 import { mkdir, stat } from "node:fs/promises";
 //#region src/agent/session/session-hydrator.ts
 /**

package/dist/src/agent/session/session-inspector.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../../config/workspace-defaults.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";

package/dist/src/agent/source-context/index.js

@@ -1,8 +1,8 @@
+import { isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext } from "./types.js";
+import { injectSourceContextsIntoUserMessage } from "./injector.js";
 import { buildFileAgentContext } from "./file-context.js";
 import { buildSessionAgentContext } from "./session-context.js";
 import { buildMcpResourceAgentContext } from "./mcp-resource-context.js";
 import { buildBrowserTabAgentContext } from "./browser-tab.js";
 import { buildUserAssertionAgentContext } from "./user-assertion-context.js";
-import { isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext } from "./types.js";
-import { injectSourceContextsIntoUserMessage } from "./injector.js";
 export { buildBrowserTabAgentContext, buildFileAgentContext, buildMcpResourceAgentContext, buildSessionAgentContext, buildUserAssertionAgentContext, injectSourceContextsIntoUserMessage, isSessionSourceBinding, isTurnContextRef, parseTurnContextRefs, summarizeSourceContext };

package/dist/src/agent/starter-agents.d.ts

@@ -2,10 +2,6 @@ import type { AgentEntry } from '../agent-config/index.js';
 export declare const STARTER_AGENTS_INITIALIZED_VERSION = 1;
 type StarterAgent = {
     id: string;
-    displayName: string;
-    description: string;
-    role: string;
-    emoji: string;
     tools?: AgentEntry['tools'];
     toolAllowlist?: AgentEntry['toolAllowlist'];
     skills?: AgentEntry['skills'];