@xopcai/xopc 0.0.352 → 0.0.353

package/dist/src/agent/inbound/attachment-pipeline.js

@@ -1,8 +1,8 @@
 import { stripRuntimeUserMessageEnvelope } from "../../../packages/gateway-contract/src/user-message-display.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { mimeTypeFromMediaPath } from "../../media/store.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { readMediaReference } from "../../media/media-reference.js";
 import { isImageInboundAttachment } from "../../channels/attachments/attachment-classifiers.js";
 import "../../channels/attachments/inbound-persist.js";

package/dist/src/agent/inbound/inbound-loop.js

@@ -1,9 +1,9 @@
 import { runWithLogContext, updateAsyncLogContext } from "../../utils/logger/context.js";
 import { init_logger } from "../../utils/logger.js";
-import { MessageBusShutdownError } from "../../infra/bus/queue.js";
-import "../../infra/bus/index.js";
 import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { initSessionTurn } from "../../session/init-session-turn.js";
+import { MessageBusShutdownError } from "../../infra/bus/queue.js";
+import "../../infra/bus/index.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { inboundMessageLogRequestId } from "../service-inbound-utils.js";
 //#region src/agent/inbound/inbound-loop.ts

package/dist/src/agent/index.js

@@ -3,12 +3,12 @@ import { dropThinkingBlocks } from "./transcript/thinking.js";
 import { extractToolCallsFromAssistant, extractToolResultId, sanitizeToolCallId, sanitizeToolCallIdsForCloudCodeAssist } from "./transcript/tool-call-id.js";
 import { makeMissingToolResult, repairToolUseResultPairing, sanitizeToolCallInputs, sanitizeToolUseResultPairing, stripToolResultDetails } from "./transcript/session-transcript-repair.js";
 import { applySessionTranscriptHygiene, applySessionTranscriptHygieneForPersistence, applySessionTranscriptHygieneWithPolicy, resolvePolicyForModel, tryApplySessionTranscriptHygiene, tryApplySessionTranscriptHygieneForPersistence } from "./transcript/transcript-hygiene.js";
-import { AgentService } from "./service.js";
 import { createResponseMessage, createSignalMessage, createTaskMessage, isValidIPCMessage } from "./ipc/types.js";
 import { AgentInbox } from "./ipc/inbox.js";
 import { AgentBus } from "./ipc/bus.js";
 import { AgentSocketClient, AgentSocketServer, isSocketAvailable } from "./ipc/socket.js";
 import "./ipc/index.js";
+import { AgentService } from "./service.js";
 import { stripToolMessages } from "./transcript/strip-tool-messages.js";
 import "./transcript/index.js";
 export { AgentBus, AgentInbox, AgentService, AgentSocketClient, AgentSocketServer, applySessionTranscriptHygiene, applySessionTranscriptHygieneForPersistence, applySessionTranscriptHygieneWithPolicy, createResponseMessage, createSignalMessage, createTaskMessage, dropThinkingBlocks, extractToolCallsFromAssistant, extractToolResultId, isSocketAvailable, isValidIPCMessage, makeMissingToolResult, repairToolUseResultPairing, resolvePolicyForModel, resolveTranscriptPolicy, sanitizeToolCallId, sanitizeToolCallIdsForCloudCodeAssist, sanitizeToolCallInputs, sanitizeToolUseResultPairing, stripToolMessages, stripToolResultDetails, tryApplySessionTranscriptHygiene, tryApplySessionTranscriptHygieneForPersistence };

package/dist/src/agent/mcp/bundle-mcp-config.js

@@ -1,6 +1,6 @@
+import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
 import { normalizeConfiguredMcpServers } from "../../config/mcp-config-normalize.js";
 import { inspectExtensionConnectorDependencies } from "../../extensions/connector-dependencies.js";
-import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
 import { materializePluginServers } from "../../extensions/agent-plugins/mcp-adapter.js";
 //#region src/agent/mcp/bundle-mcp-config.ts
 function listConfiguredMcpServers(params) {

package/dist/src/agent/mcp/bundle-mcp-gateway.js

@@ -1,5 +1,5 @@
-import { createSessionMcpRuntime } from "./bundle-mcp-runtime.js";
 import { mcpToolPolicyId } from "./bundle-mcp-policy.js";
+import { createSessionMcpRuntime } from "./bundle-mcp-runtime.js";
 import { decodeMcpResourceId, encodeMcpResourceId } from "./mcp-resource-id.js";
 import crypto from "node:crypto";
 //#region src/agent/mcp/bundle-mcp-gateway.ts

package/dist/src/agent/mcp/bundle-mcp-runtime.js

@@ -3,16 +3,16 @@ import { init_logger } from "../../utils/logger.js";
 import { init_global_singleton, resolveGlobalSingleton } from "../../utils/global-singleton.js";
 import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { resolveConnectorSecretReferences } from "../../connectors/secret-store.js";
-import { redactSensitiveUrlLikeString } from "../../utils/redact-sensitive-url.js";
 import { recordPluginMcpHealth } from "../../extensions/agent-plugins/health.js";
+import { redactSensitiveUrlLikeString } from "../../utils/redact-sensitive-url.js";
 import { loadEmbeddedMcpConfig } from "./embedded-mcp.js";
 import { isMcpConfigRecord } from "./mcp-config-shared.js";
 import { isMcpAuthorizationError } from "./oauth/mcp-oauth-errors.js";
 import { resolveMcpTransport } from "./mcp-transport.js";
 import { sanitizeServerName } from "./bundle-mcp-names.js";
 import crypto from "node:crypto";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import Ajv2020 from "ajv/dist/2020.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { AjvJsonSchemaValidator } from "@modelcontextprotocol/sdk/validation/ajv-provider.js";
 //#region src/agent/mcp/bundle-mcp-runtime.ts
 init_logger();

package/dist/src/agent/mcp/index.js

@@ -1,12 +1,12 @@
+import { mcpToolPolicyId } from "./bundle-mcp-policy.js";
 import { loadMergedBundleMcpConfig } from "./bundle-mcp-config.js";
 import { loadEmbeddedMcpConfig } from "./embedded-mcp.js";
 import { McpAuthorizationRequiredError, isMcpAuthorizationError } from "./oauth/mcp-oauth-errors.js";
 import { McpOAuthStore, canonicalMcpServerUrl, mcpOAuthServerKey } from "./oauth/mcp-oauth-store.js";
 import { XopcMcpOAuthClientProvider } from "./oauth/mcp-oauth-provider.js";
 import { __testing, createSessionMcpRuntime, disposeAllSessionMcpRuntimes, disposeSessionMcpRuntime, getOrCreateSessionMcpRuntime, getSessionMcpRuntimeManager, retireSessionMcpRuntime, retireSessionMcpRuntimeForConversationId } from "./bundle-mcp-runtime.js";
+import "./bundle-mcp-tools.js";
 import { McpOAuthSession } from "./oauth/mcp-oauth-session.js";
 import { McpOAuthManager, getMcpOAuthManager } from "./oauth/mcp-oauth-manager.js";
-import { mcpToolPolicyId } from "./bundle-mcp-policy.js";
-import "./bundle-mcp-tools.js";
 import "./oauth/index.js";
 export { McpAuthorizationRequiredError, McpOAuthManager, McpOAuthSession, McpOAuthStore, XopcMcpOAuthClientProvider, __testing, canonicalMcpServerUrl, createSessionMcpRuntime, disposeAllSessionMcpRuntimes, disposeSessionMcpRuntime, getMcpOAuthManager, getOrCreateSessionMcpRuntime, getSessionMcpRuntimeManager, isMcpAuthorizationError, loadEmbeddedMcpConfig, loadMergedBundleMcpConfig, mcpOAuthServerKey, mcpToolPolicyId, retireSessionMcpRuntime, retireSessionMcpRuntimeForConversationId };

package/dist/src/agent/mcp/mcp-stdio-transport.js

@@ -2,9 +2,9 @@ import { terminateProcess } from "../../process/kill-tree.js";
 import { containedPath } from "../../extensions/agent-plugins/validation.js";
 import { spawn } from "node:child_process";
 import { mkdir } from "node:fs/promises";
-import { PassThrough } from "node:stream";
 import { getDefaultEnvironment } from "@modelcontextprotocol/sdk/client/stdio.js";
 import process from "node:process";
+import { PassThrough } from "node:stream";
 import { ReadBuffer, serializeMessage } from "@modelcontextprotocol/sdk/shared/stdio.js";
 //#region src/agent/mcp/mcp-stdio-transport.ts
 const CLOSE_TIMEOUT_MS = 2e3;

package/dist/src/agent/mcp/mcp-transport.js

@@ -9,10 +9,10 @@ import { McpOAuthStore } from "./oauth/mcp-oauth-store.js";
 import { XopcMcpOAuthClientProvider } from "./oauth/mcp-oauth-provider.js";
 import { createPluginHttpFetch } from "./plugin-http-fetch.js";
 import { pluginOAuthScope } from "../../extensions/agent-plugins/plugin-oauth-scope.js";
-import { fetch } from "undici";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { getDefaultEnvironment } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { fetch } from "undici";
 //#region src/agent/mcp/mcp-transport.ts
 init_paths_state();
 init_logger();

package/dist/src/agent/mcp/oauth/mcp-oauth-manager.js

@@ -2,8 +2,8 @@ import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { init_global_singleton, resolveGlobalSingleton } from "../../../utils/global-singleton.js";
 import { resolveConnectorSecretReferences } from "../../../connectors/secret-store.js";
-import { redactSensitiveUrlLikeString } from "../../../utils/redact-sensitive-url.js";
 import { recordPluginMcpHealth } from "../../../extensions/agent-plugins/health.js";
+import { redactSensitiveUrlLikeString } from "../../../utils/redact-sensitive-url.js";
 import { resolveMcpTransportConfig } from "../mcp-transport-config.js";
 import { isMcpAuthorizationError } from "./mcp-oauth-errors.js";
 import { McpOAuthStore, canonicalMcpServerUrl } from "./mcp-oauth-store.js";

package/dist/src/agent/mcp/oauth/mcp-oauth-store.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveMcpOAuthPath } from "../../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../../../infra/write-file-atomic.js";
+import { init_paths, resolveMcpOAuthPath } from "../../../config/paths.js";
 import { dirname, join } from "node:path";
 import { createHash } from "node:crypto";
 import { readFile, rm } from "node:fs/promises";

package/dist/src/agent/mcp/plugin-http-fetch.js

@@ -1,6 +1,6 @@
 import { BlockList, isIP } from "node:net";
-import { lookup } from "node:dns";
 import { Agent, fetch } from "undici";
+import { lookup } from "node:dns";
 //#region src/agent/mcp/plugin-http-fetch.ts
 const blocked = new BlockList();
 for (const [network, prefix] of [

package/dist/src/agent/memory/context-recovery.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { evaluateContextBudget, projectContextForModel, stringifyMessagesForBudget } from "./context-budget.js";
 import { stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
+import { evaluateContextBudget, projectContextForModel, stringifyMessagesForBudget } from "./context-budget.js";
 //#region src/agent/memory/context-recovery.ts
 init_logger();
 const log = createLogger("ContextRecovery");

package/dist/src/agent/memory/index.js

@@ -1,6 +1,6 @@
-import { buildUserContextBlock, sanitizeUserContextFenceEscapes } from "./context-fence.js";
 import { isMemorySubsystemEnabled } from "./memory-config.js";
 import { extractAgentUserPlainText } from "./user-message-text.js";
+import { buildUserContextBlock, sanitizeUserContextFenceEscapes } from "./context-fence.js";
 import { MemoryManager } from "./manager.js";
 import { discoverMemoryPlugins } from "./plugin-discovery.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";

package/dist/src/agent/messaging/no-reply.d.ts

@@ -0,0 +1 @@
+export declare const NO_REPLY = "NO_REPLY";

package/dist/src/agent/messaging/no-reply.js

@@ -0,0 +1,4 @@
+//#region src/agent/messaging/no-reply.ts
+const NO_REPLY = "NO_REPLY";
+//#endregion
+export { NO_REPLY };

package/dist/src/agent/messaging/outbound-coordinator.d.ts

@@ -13,7 +13,6 @@
  * unit-testable and lets the parent `AgentService` shrink to a coordinator.
  */
 import type { MessageBus, InboundMessage } from '../../infra/bus/index.js';
-import type { Config } from '../../config/schema.js';
 import type { HookHandler } from '../lifecycle/hook-handler.js';
 import type { SessionContext } from '../session/index.js';
 import { type TypingController } from '../lifecycle/typing.js';
@@ -22,8 +21,6 @@ export interface OutboundCoordinatorConfig {
     bus: MessageBus;
     hookHandler: HookHandler;
     streamManager: StreamManager;
-    /** Reads the effective config snapshot (honours runtime overrides). */
-    getConfig: () => Config | undefined;
     /** Resolves the last visible assistant text for a session (in-memory + agent fallback). */
     getLastAssistantPlainText: (conversationId: string) => string;
     reviewTaskTurn: (payload: SessionTurnCompletePayload) => Promise<void>;
@@ -43,7 +40,6 @@ export declare class OutboundCoordinator {
     private readonly bus;
     private readonly hookHandler;
     private readonly streamManager;
-    private readonly getConfig;
     private readonly getLastAssistantPlainText;
     private readonly reviewTaskTurn;
     constructor(config: OutboundCoordinatorConfig);

package/dist/src/agent/messaging/outbound-coordinator.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import "./no-reply.js";
 import { createTypingController } from "../lifecycle/typing.js";
-import { shouldSilence } from "../../heartbeat/tokens.js";
 //#region src/agent/messaging/outbound-coordinator.ts
 init_logger();
 const log = createLogger("OutboundCoordinator");
@@ -9,14 +9,12 @@ var OutboundCoordinator = class {
 	bus;
 	hookHandler;
 	streamManager;
-	getConfig;
 	getLastAssistantPlainText;
 	reviewTaskTurn;
 	constructor(config) {
 		this.bus = config.bus;
 		this.hookHandler = config.hookHandler;
 		this.streamManager = config.streamManager;
-		this.getConfig = config.getConfig;
 		this.getLastAssistantPlainText = config.getLastAssistantPlainText;
 		this.reviewTaskTurn = config.reviewTaskTurn;
 	}
@@ -70,7 +68,7 @@ var OutboundCoordinator = class {
 		if (this.streamManager.consumeSkipFinalOutbound()) return;
 		const finalContent = this.getLastAssistantPlainText(sessionContext.conversationId);
 		if (!finalContent?.trim()) return;
-		if (shouldSilence(finalContent, this.getConfig()?.gateway?.heartbeat?.ackMaxChars ?? 300) || finalContent.trim() === "NO_REPLY") {
+		if (finalContent.trim() === "NO_REPLY") {
 			log.debug({ conversationId: sessionContext.conversationId }, "Silent reply — skipping outbound");
 			return;
 		}

package/dist/src/agent/orchestration/agent-orchestrator.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
 import { persistInboundAttachments } from "../../channels/attachments/inbound-persist.js";
 import { buildTranscriptUserMessage, clearPendingTranscriptUserMessage, hydrateUserTurnForLlm, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
+import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { randomUUID } from "node:crypto";
 //#region src/agent/orchestration/agent-orchestrator.ts

package/dist/src/agent/prompt/sections/agent-identity.d.ts

@@ -0,0 +1,3 @@
+import type { AgentProfile } from '../../../agent-config/index.js';
+/** Identity comes from the Agent catalog, never from workspace Markdown. */
+export declare function buildAgentIdentitySection(profile: AgentProfile | undefined): string | undefined;

package/dist/src/agent/prompt/sections/agent-identity.js

@@ -0,0 +1,13 @@
+//#region src/agent/prompt/sections/agent-identity.ts
+/** Identity comes from the Agent catalog, never from workspace Markdown. */
+function buildAgentIdentitySection(profile) {
+	if (!profile) return;
+	const lines = [`Name: ${profile.name}`];
+	if (profile.description) lines.push(`Description: ${profile.description}`);
+	if (profile.creature) lines.push(`Type: ${profile.creature}`);
+	if (profile.style) lines.push(`Style: ${profile.style}`);
+	if (profile.language) lines.push(`Primary language: ${profile.language}`);
+	return `## Agent identity\n\n${lines.join("\n")}`;
+}
+//#endregion
+export { buildAgentIdentitySection };

package/dist/src/agent/prompt/sections/messaging-runtime.d.ts

@@ -9,8 +9,3 @@ export declare function buildSilentRepliesSection(params: {
 }): string;
 export declare function buildOutputDirectivesSection(isMinimal: boolean): string;
 export declare function buildTimeSection(timezone?: string): string;
-export declare function buildHeartbeatBehaviorSection(params: {
-    enabled: boolean;
-    customPrompt?: string;
-    userTimezone?: string;
-}): string;

package/dist/src/agent/prompt/sections/messaging-runtime.js

@@ -1,4 +1,4 @@
-import { NO_REPLY } from "../../../heartbeat/tokens.js";
+import { NO_REPLY } from "../../messaging/no-reply.js";
 //#region src/agent/prompt/sections/messaging-runtime.ts
 function buildMessagingSection(params) {
 	if (params.isMinimal || params.channels.length === 0) return "";
@@ -49,19 +49,5 @@ function buildTimeSection(timezone) {
 		"If you need the current date/time/day-of-week, use the `session_status` tool or the inbound message timestamp envelope (when present)."
 	].join("\n");
 }
-function buildHeartbeatBehaviorSection(params) {
-	if (!params.enabled) return "";
-	if (params.customPrompt?.trim()) return `## Heartbeats\n\n${params.customPrompt.trim()}`;
-	let quietHoursNote = "";
-	if (params.userTimezone) quietHoursNote = `\n\n> Quiet hours: The user is in **${params.userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;
-	return [
-		"## Heartbeats",
-		"",
-		"If the current user message is a heartbeat poll and nothing needs attention, reply exactly: HEARTBEAT_OK",
-		"",
-		"If something needs attention, do NOT include \"HEARTBEAT_OK\"; reply with the alert text instead.",
-		quietHoursNote.trim()
-	].filter(Boolean).join("\n");
-}
 //#endregion
-export { buildHeartbeatBehaviorSection, buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection };
+export { buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection };

package/dist/src/agent/prompt/sections/project-context.d.ts

@@ -1,6 +1,5 @@
 import type { EmbeddedContextFile } from '../../bootstrap/types.js';
 export declare const CONTEXT_FILE_ORDER: Map<string, number>;
-export declare 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.`";
 export declare function normalizeContextFilePath(pathValue: string): string;
 export declare function getContextFileBasename(pathValue: string): string;
 export declare function sanitizeContextFileContentForPrompt(content: string): string;
@@ -9,5 +8,3 @@ export declare function buildProjectContextSection(params: {
     files: EmbeddedContextFile[];
     heading: string;
 }): string[];
-/** Heartbeat content belongs to the heartbeat user turn, never the system prompt. */
-export declare function isHeartbeatContextFile(pathValue: string): boolean;

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