@xopcai/xopc 0.0.333 → 0.0.335

package/dist/packages/gateway-contract/src/session-command-rejection.js

@@ -0,0 +1,19 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+//#region packages/gateway-contract/src/session-command-rejection.ts
+/** Only explicit pre-acceptance failures allow a client to replace its frozen command. */
+function isSessionCommandRejected(status, body) {
+	if (status !== 400 && status !== 409 && status !== 410) return false;
+	const code = body?.error?.code;
+	return typeof code === "string" && [
+		"BAD_REQUEST",
+		"CONFIG_CHANGED",
+		"SESSION_CHANGED",
+		"SESSION_DELETED",
+		"SESSION_BUSY",
+		"QUEUE_FULL"
+	].includes(code);
+}
+var init_session_command_rejection = __esmMin((() => {}));
+//#endregion
+init_session_command_rejection();
+export { init_session_command_rejection, isSessionCommandRejected };

package/dist/packages/gateway-contract/src/session-input-command.js

@@ -0,0 +1,109 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { AppContextEnvelopeSchema, init_app_context } from "./app-context.js";
+import { browserPageContextsInputSchema, init_browser_page_context } from "./browser-page-context.js";
+import { z } from "zod";
+//#region packages/gateway-contract/src/session-input-command.ts
+/** Stable JSON representation; object insertion order and transport credentials are not identities. */
+function canonicalSessionCommand(value) {
+	if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
+	if (Array.isArray(value)) return `[${value.map(canonicalSessionCommand).join(",")}]`;
+	const object = value;
+	return `{${Object.keys(object).filter((key) => object[key] !== void 0).sort().map((key) => `${JSON.stringify(key)}:${canonicalSessionCommand(object[key])}`).join(",")}}`;
+}
+function sessionCommandIdentity(command) {
+	if ("origin" in command) {
+		const { origin: _origin, ...identity } = command;
+		return canonicalSessionCommand(identity);
+	}
+	return canonicalSessionCommand(command);
+}
+var sessionCreationSchema, attachmentSchema, sessionInputContentSchema, originSchema, sessionInputCommandSchema, sessionMaterializeCommandSchema;
+var init_session_input_command = __esmMin((() => {
+	init_app_context();
+	init_browser_page_context();
+	sessionCreationSchema = z.strictObject({
+		agentId: z.string().trim().min(1),
+		projectId: z.string().trim().min(1).nullable(),
+		execution: z.strictObject({
+			mode: z.enum(["local_checkout", "managed_worktree"]),
+			baseRef: z.string().trim().min(1).optional()
+		}).nullable(),
+		temporary: z.boolean(),
+		model: z.string().trim().min(1),
+		thinkingLevel: z.string().min(1)
+	}).refine((value) => value.projectId !== null || value.execution === null, {
+		message: "An execution environment requires a project",
+		path: ["execution"]
+	});
+	attachmentSchema = z.strictObject({
+		id: z.string().optional(),
+		type: z.string().min(1),
+		mimeType: z.string().optional(),
+		data: z.string().optional(),
+		uri: z.string().optional(),
+		name: z.string().optional(),
+		size: z.number().nonnegative().optional(),
+		workspaceRelativePath: z.string().optional(),
+		durationSeconds: z.number().nonnegative().optional()
+	});
+	sessionInputContentSchema = z.strictObject({
+		content: z.string(),
+		attachments: z.array(attachmentSchema).optional(),
+		contextRefs: z.array(z.strictObject({
+			kind: z.enum([
+				"note",
+				"task",
+				"file",
+				"session",
+				"browser_tab",
+				"mcp_resource"
+			]),
+			sourceId: z.string().trim().min(1),
+			refId: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/).optional(),
+			expectedVersion: z.string().optional()
+		})).max(5).optional(),
+		browserContexts: browserPageContextsInputSchema.optional(),
+		appContext: AppContextEnvelopeSchema.optional()
+	});
+	originSchema = z.discriminatedUnion("type", [z.strictObject({
+		type: z.literal("endpoint"),
+		endpointId: z.string().min(1),
+		token: z.string().min(1)
+	}), z.strictObject({
+		type: z.literal("system"),
+		source: z.literal("cli")
+	})]);
+	sessionInputCommandSchema = z.discriminatedUnion("kind", [z.strictObject({
+		kind: z.literal("start"),
+		clientMessageId: z.string().min(1).max(128),
+		creation: sessionCreationSchema,
+		input: sessionInputContentSchema,
+		origin: originSchema
+	}), z.strictObject({
+		kind: z.literal("append"),
+		clientMessageId: z.string().min(1).max(128),
+		expectedTranscriptId: z.string().min(1).max(128),
+		configVersion: z.number().int().nonnegative(),
+		delivery: z.enum(["next", "steer"]),
+		input: sessionInputContentSchema,
+		origin: originSchema
+	})]);
+	sessionMaterializeCommandSchema = z.strictObject({
+		commandId: z.string().min(1).max(128),
+		creation: sessionCreationSchema,
+		purpose: z.enum(["voice", "session_resources"])
+	});
+	z.object({
+		operationId: z.string(),
+		revision: z.number().int(),
+		state: z.enum([
+			"preparing",
+			"ready",
+			"preparation_failed"
+		]),
+		lastError: z.string().nullable()
+	});
+}));
+//#endregion
+init_session_input_command();
+export { canonicalSessionCommand, init_session_input_command, sessionCommandIdentity, sessionCreationSchema, sessionInputCommandSchema, sessionInputContentSchema, sessionMaterializeCommandSchema };

package/dist/packages/gateway-contract/src/sessions.js

@@ -32,6 +32,17 @@ var init_sessions = __esmMin((() => {
 		updatedAt: z.string(),
 		sourceChannel: z.string().optional(),
 		status: sessionStatusSchema.optional(),
+		usage: z.object({
+			calls: z.number().int().nonnegative(),
+			unknownCostCalls: z.number().int().nonnegative(),
+			totalTokens: z.number().int().nonnegative(),
+			knownCostUsd: z.string(),
+			costCompleteness: z.enum([
+				"complete",
+				"partial",
+				"unknown"
+			])
+		}).optional(),
 		routing: sessionRoutingMetaSchema.optional()
 	}).passthrough();
 	sessionsListResponseSchema = z.object({
@@ -74,12 +85,6 @@ var init_sessions = __esmMin((() => {
 			revision: z.number().int().nonnegative().optional()
 		}).passthrough()
 	}).passthrough();
-	z.object({ session: z.object({
-		key: z.string(),
-		transcriptId: transcriptIdSchema.optional(),
-		projectId: z.string().optional(),
-		routing: sessionRoutingMetaSchema.optional()
-	}).passthrough() }).passthrough();
 	z.object({
 		ok: z.literal(true),
 		conversationId: z.uuid(),

package/dist/src/agent/agent-instance-gateway.d.ts

@@ -47,8 +47,6 @@ export interface AgentInstanceGateway {
     getLastAssistantContent(conversationId: string): string | null;
     /** Build the bounded, policy-filtered context used for this model turn. */
     prepareUserTurnContext(userMessage: AgentMessage, conversationId: string, turnId: string): Promise<import('./context/coordinator.js').ExecutionContextPlan>;
-    /** Fire-and-forget maintenance of durable user understanding after a completed turn. */
-    scheduleUserUnderstandingMaintenance(conversationId: string, userPlainText: string, turnId: string): void;
     /** Bump the per-session "turns since memory review" counter. */
     beginBackgroundReviewUserTurn(conversationId: string): void;
     /** Fire-and-forget review (memory + skill nudges) once the main turn finishes. */

package/dist/src/agent/agent-manager.d.ts

@@ -203,8 +203,6 @@ export declare class AgentManager implements AgentInstanceGateway {
     ensureMemoryReadyForSession(conversationId: string): Promise<void>;
     /** Build the bounded, policy-filtered context used for this model turn. */
     prepareUserTurnContext(userMessage: AgentMessage, conversationId: string, turnId: string): Promise<ExecutionContextPlan>;
-    /** Maintain durable user understanding without delaying the user-visible turn. */
-    scheduleUserUnderstandingMaintenance(conversationId: string, userPlainText: string, turnId: string): void;
     /**
      * Call once per user turn before the main embedded agent turn.
      * Delegates to {@link BackgroundReviewCoordinator}.

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

@@ -6,20 +6,18 @@ import { consumeClarificationApproval, init_clarification_wait_repository } from
 import { getInteractionState } from "../storage/sqlite/interaction-state-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
-import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir } from "./agent-scope.js";
-import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
-import { init_session_key } from "../routing/session-key.js";
-import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
+import { extractTextContent } from "./context/workspace.js";
+import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { continuesAfterTool, trackAiUsageStream } from "../usage/recorder.js";
-import { extractTextContent } from "./context/workspace.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { buildExecutionScopeContextForPrompt } from "./context/execution-scope.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
 import { resolveBootstrapContextSync } from "./bootstrap/bootstrap-files.js";
@@ -46,7 +44,6 @@ import { isMemorySubsystemEnabled } from "./memory/memory-config.js";
 import { evaluateToolGate } from "./context/execution-context.js";
 import { ExecutionContextCoordinator } from "./context/coordinator.js";
 import { WorkspaceRuntimeRegistry } from "./workspace-runtime/registry.js";
-import { createTurnUserModelMaintenanceTask } from "./background-review/run-background-review.js";
 import { BackgroundReviewCoordinator } from "./background-review/coordinator.js";
 import { maybeRequestChannelExecApproval } from "../channels/exec-approval-runtime.js";
 import { SkillFilesystemWatcher } from "./skills/filesystem-watcher.js";
@@ -71,7 +68,6 @@ init_credentials();
 init_paths();
 init_clarification_wait_repository();
 init_sqlite();
-init_session_key();
 const log = createLogger("AgentManager");
 var AgentManager = class {
 	agents = /* @__PURE__ */ new Map();
@@ -337,33 +333,6 @@ var AgentManager = class {
 	async prepareUserTurnContext(userMessage, conversationId, turnId) {
 		return this.executionContext.prepare(userMessage, conversationId, turnId);
 	}
-	/** Maintain durable user understanding without delaying the user-visible turn. */
-	scheduleUserUnderstandingMaintenance(conversationId, userPlainText, turnId) {
-		if (!this.isUserContextEnabledForSession(conversationId)) return;
-		const parsed = getConversationRouting(conversationId);
-		if (parsed && parsed.peerKind !== "direct") return;
-		const instance = this.agents.get(conversationId);
-		if (!instance) return;
-		let task;
-		try {
-			task = createTurnUserModelMaintenanceTask({
-				conversationId,
-				turnId,
-				userText: userPlainText,
-				mainAgent: instance.agent,
-				workspaceId: this.getResolvedWorkspaceForSession(conversationId),
-				getConfig: () => this.mergedConfig()
-			});
-		} catch (err) {
-			log.warn({
-				err,
-				conversationId,
-				turnId
-			}, "User-understanding maintenance could not be scheduled");
-			return;
-		}
-		this.enqueueUserUnderstandingMaintenance(conversationId, "turn", task);
-	}
 	/**
 	* Call once per user turn before the main embedded agent turn.
 	* Delegates to {@link BackgroundReviewCoordinator}.

package/dist/src/agent/background-review/run-background-review.d.ts

@@ -1,6 +1,5 @@
 import { Agent } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
-import { type UserModelCaptureResult } from '../../user-model/capture/index.js';
 import type { BackgroundReviewSettings } from './settings.js';
 export interface RunUserModelReviewParams {
     conversationId: string;
@@ -9,10 +8,4 @@ export interface RunUserModelReviewParams {
     workspaceId: string;
     getConfig: () => Config | undefined;
 }
-export interface RunTurnUserModelMaintenanceParams extends Omit<RunUserModelReviewParams, 'settings'> {
-    turnId: string;
-    userText: string;
-    maxHistoryMessages?: number;
-}
-export declare function createTurnUserModelMaintenanceTask(params: RunTurnUserModelMaintenanceParams): () => Promise<UserModelCaptureResult>;
 export declare function createBackgroundUserModelReviewTask(params: RunUserModelReviewParams): () => Promise<void>;

package/dist/src/agent/background-review/run-background-review.js

@@ -4,12 +4,12 @@ import { finishContextExtractionRun } from "../../storage/sqlite/context-extract
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { loadCompactionSourceSnapshot } from "../../storage/sqlite/transcript-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
+import { extractTextContent } from "../context/workspace.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers, resolveModel } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
 import { trackAiUsageStream } from "../../usage/recorder.js";
-import { extractTextContent } from "../context/workspace.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { getAssertionSlot, listUserAssertions } from "../../user-model/repository.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";
@@ -232,26 +232,6 @@ async function executeReview(params) {
 		throw err;
 	}
 }
-function createTurnUserModelMaintenanceTask(params) {
-	const evidence = loadEvidenceMessages(params.conversationId, params.maxHistoryMessages ?? 12);
-	return async () => {
-		if (!evidence.length) return emptyUserModelCaptureResult();
-		return executeReview({
-			conversationId: params.conversationId,
-			mainAgent: params.mainAgent,
-			workspaceId: params.workspaceId,
-			getConfig: params.getConfig,
-			evidence,
-			mode: "turn",
-			extractorId: "turn-semantics",
-			sourceRef: `session:${params.conversationId}:turn:${params.turnId}`,
-			contentForHash: params.userText,
-			availableAssertions: listAvailableAssertions(),
-			timeoutMs: 3e4,
-			turnId: params.turnId
-		});
-	};
-}
 function createBackgroundUserModelReviewTask(params) {
 	const evidence = loadEvidenceMessages(params.conversationId, params.settings.maxHistoryMessages);
 	return async () => {
@@ -289,4 +269,4 @@ function listAvailableAssertions() {
 	});
 }
 //#endregion
-export { createBackgroundUserModelReviewTask, createTurnUserModelMaintenanceTask };
+export { createBackgroundUserModelReviewTask };

package/dist/src/agent/bootstrap/filter-bootstrap-files.js

@@ -1,6 +1,6 @@
+import { DEFAULT_AGENTS_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME } from "../context/workspace.js";
 import { isCronConversationId, isSubagentConversationId } from "../../routing/agent-session-key.js";
 import { init_session_key } from "../../routing/session-key.js";
-import { DEFAULT_AGENTS_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME } from "../context/workspace.js";
 //#region src/agent/bootstrap/filter-bootstrap-files.ts
 init_session_key();
 const MINIMAL_BOOTSTRAP_ALLOWLIST = new Set([

package/dist/src/agent/embedded/model-runtime.js

@@ -1,6 +1,6 @@
 import { init_paths, resolveModelsJsonPath } from "../../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { XopcModelCredentialStore, init_model_credential_store } from "../../auth/model-credential-store.js";
 import { init_register_bundled_oauth_flows, registerBundledOAuthFlows } from "../../providers/register-bundled-oauth-flows.js";
 import { init_register_runtime_providers, registerRuntimeProviders } from "../../providers/register-runtime-providers.js";

package/dist/src/agent/embedded/run-for-session.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseTurnOutcome } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { appendDynamicPromptSection } from "../prompt/cache-boundary.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
 import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";

package/dist/src/agent/external-tools/endpoint-provider.js

@@ -1,7 +1,7 @@
-import { COMPUTER_CONTROL_TOOL, init_src } from "../../../packages/computer-control-contract/src/index.js";
-import { BROWSER_CONTROL_ENDPOINT_TOOL_NAME } from "../../../packages/browser-control-contract/src/index.js";
 import { executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
 import { canonicalCapabilityJson } from "../../capabilities/runtime/dispatcher.js";
+import { COMPUTER_CONTROL_TOOL, init_src } from "../../../packages/computer-control-contract/src/index.js";
+import { BROWSER_CONTROL_ENDPOINT_TOOL_NAME } from "../../../packages/browser-control-contract/src/index.js";
 import { externalToolRef, parseExternalToolRef } from "./refs.js";
 import { createHash } from "node:crypto";
 //#region src/agent/external-tools/endpoint-provider.ts

package/dist/src/agent/external-tools/gateway-tools.js

@@ -54,7 +54,7 @@ function createExternalToolGatewayTools(providers, getContext, getConfig) {
 	const searchTool = {
 		name: EXTERNAL_TOOL_NAMES.search,
 		label: "🔎 External Tool Search",
-		description: `Search external tools from these sources: ${EXTERNAL_TOOL_SOURCES.join(", ")}. CLI connectors include Feishu/Lark, WeCom and WPS 365. Omit sources unless intentionally restricting the search; do not guess a source list. Use concise English capability keywords, e.g. "wecom doc.search". Returns executable tools, connection candidates, or reviewed Store install candidates. Call xopc_tool_describe before executing a tool. If a source-filtered search finds no relevant tools, retry without sources before concluding a capability is unavailable.`,
+		description: `Search external tools from these sources: ${EXTERNAL_TOOL_SOURCES.join(", ")}. CLI connectors include Feishu/Lark, WeCom and WPS 365. Omit sources unless intentionally restricting the search; do not guess a source list. Use concise English capability keywords, e.g. "wecom doc.search". Returns executable tools, connection candidates, or reviewed Store install candidates. Call xopc_tool_describe before executing a tool. When no executable tool exists but a connection or install candidate is returned, use xopc_require_connection instead of falling back to browser automation. If a source-filtered search finds no relevant tools, retry without sources before concluding a capability is unavailable.`,
 		parameters: ToolSearchSchema,
 		async execute(_toolCallId, params) {
 			const selectedSources = new Set(params.sources ?? []);
@@ -73,6 +73,7 @@ function createExternalToolGatewayTools(providers, getContext, getConfig) {
 				...result,
 				connectionCandidates: candidates,
 				installCandidates,
+				...result.tools.length === 0 && (candidates.length > 0 || installCandidates.length > 0) ? { instruction: "The requested app is available but is not connected. Explain that connection is required, then call xopc_require_connection with an exact candidateRef from this result. Do not fall back to browser automation unless the user explicitly asked for browser use or skips the connection." } : {},
 				...installCatalogError ? { installCatalogError } : {},
 				...excludedSources.length ? { searchScope: {
 					excludedSources,

package/dist/src/agent/image/tool-model-config.js

@@ -1,7 +1,7 @@
-import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
+import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

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

@@ -3,7 +3,6 @@ import { init_logger } from "../../utils/logger.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 { extractAgentUserPlainText } from "../memory/user-message-text.js";
 import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { randomUUID } from "node:crypto";
@@ -68,7 +67,6 @@ var AgentOrchestrator = class {
 				agentManager: this.agentManager
 			});
 			setPendingTranscriptUserMessage(conversationId, userMessage);
-			const userPlainForMemory = extractAgentUserPlainText(userMessage);
 			const turnId = randomUUID();
 			const userContext = await this.agentManager.prepareUserTurnContext(userMessage, conversationId, turnId);
 			const userMessageForModel = userMessage;
@@ -96,7 +94,6 @@ var AgentOrchestrator = class {
 					clearPendingTranscriptUserMessage(conversationId, userMessage);
 				}
 			})();
-			this.agentManager.scheduleUserUnderstandingMaintenance(conversationId, userPlainForMemory, turnId);
 			this.agentManager.scheduleBackgroundReviewAfterUserTurn(conversationId);
 			if (turnResult.ok) {
 				this.onEmbeddedTurnComplete?.(conversationId, turnResult.lastAssistantText);

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

@@ -3,7 +3,6 @@ import { getConnectionResumeInput, init_connection_wait_repository } from "../..
 import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
 import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
 import { buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
-import { extractAgentUserPlainText } from "../memory/user-message-text.js";
 import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../chat-commands/command-parse.js";
 import { commandRegistry } from "../../chat-commands/registry.js";
@@ -99,7 +98,6 @@ async function runDirectAgentTurn(deps, input) {
 	const isConnectionResume = Boolean(getConnectionResumeInput(input.conversationId, turnId));
 	const isClarificationResume = Boolean(getClarificationResumeInput(input.conversationId, turnId));
 	const isResume = isConnectionResume || isClarificationResume;
-	const userPlain = extractAgentUserPlainText(input.userMessage);
 	const userContext = await deps.agentManager.prepareUserTurnContext(input.userMessage, input.conversationId, turnId);
 	const sourceContexts = input.sourceContexts ?? [];
 	const userMessageForModel = prependAgentContext(injectSourceContextsIntoUserMessage(input.userMessage, sourceContexts), buildTaskExecutionDirective(input.conversationId));
@@ -127,7 +125,6 @@ async function runDirectAgentTurn(deps, input) {
 		beforeTurn: isResume ? void 0 : () => deps.agentManager.beginBackgroundReviewUserTurn(input.conversationId),
 		onEvent: input.onEvent
 	});
-	if (!isResume) deps.agentManager.scheduleUserUnderstandingMaintenance(input.conversationId, userPlain, turnId);
 	if (!isResume && result.stopReason !== "connection_required" && result.stopReason !== "clarification_required") deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.conversationId);
 	return result;
 }

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

@@ -13,6 +13,7 @@ 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 { 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 { isSessionSourceBinding, summarizeSourceContext } from "../source-context/types.js";
@@ -248,8 +249,9 @@ async function* runProcessDirectStreaming(deps, input) {
 					if (sourceContext && !sourceContexts.some((context) => context.kind === sourceContext.kind && context.sourceId === sourceContext.sourceId)) sourceContexts.push(sourceContext);
 				}
 			}
-			const userTurnDocument = parseUserTurnDocument(mergedUserText);
-			const authoredText = userTurnDocument ? renderUserTurnDocument(userTurnDocument, (refId) => sourceContexts.find((context) => context.refId === refId)?.title ?? null) : mergedUserText;
+			const modelUserTurnDocument = parseUserTurnDocument(mergedUserText);
+			const userTurnDocument = parseUserTurnDocument(stripEnvelopeTimestampPrefix(mergedUserText));
+			const authoredText = modelUserTurnDocument ? renderUserTurnDocument(modelUserTurnDocument, (refId) => sourceContexts.find((context) => context.refId === refId)?.title ?? null) : mergedUserText;
 			const slash = await tryRunSlashCommand(deps, {
 				conversationId,
 				channel,

package/dist/src/agent/service.js

@@ -1,13 +1,13 @@
 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 { 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 { extractTextContent } from "./context/workspace.js";
+import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
-import { extractTextContent } from "./context/workspace.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
 import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";

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 { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.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/tasks/task-judge-service.js

@@ -2,13 +2,13 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();

package/dist/src/agent/tools/xopc-use-tool.js

@@ -9,9 +9,9 @@ import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import "../../activity/index.js";
-import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import "../../capabilities/runtime/dispatcher.js";
+import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import { TaskDeletionService } from "../../tasks/task-deletion-service.js";

package/dist/src/agent-catalog/capabilities.js

@@ -1,10 +1,10 @@
 import { AgentEntrySchema, EffectiveAgentConfigSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { AgentCatalogRepository, init_repository } from "./repository.js";
-import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
+import { AgentCatalogRepository, init_repository } from "./repository.js";
+import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { AgentCatalogService } from "./service.js";
 import { z } from "zod";
 //#region src/agent-catalog/capabilities.ts

package/dist/src/ai-assist/text-assist.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { trackAiUsageStream } from "../usage/recorder.js";
 import { isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions } from "../providers/model-call.js";
-import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { normalizeContext } from "@earendil-works/pi-ai";
 //#region src/ai-assist/text-assist.ts
 init_providers();

package/dist/src/auth/credentials.js

@@ -2,9 +2,9 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
-import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
+import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
 import { init_oauth_provider_lock, withOAuthProviderLock } from "./oauth-provider-lock.js";
 import { dirname, join } from "path";
 import { mkdir, readFile, readdir, rm } from "fs/promises";

package/dist/src/auth/oauth-provider-lock.js

@@ -3,8 +3,8 @@ import { init_paths, resolveOAuthPath } from "../config/paths.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { dirname } from "node:path";
 import { randomUUID } from "node:crypto";
-import { setTimeout } from "node:timers/promises";
 import { mkdir, open, readFile, rm, stat } from "node:fs/promises";
+import { setTimeout } from "node:timers/promises";
 //#region src/auth/oauth-provider-lock.ts
 function lockPath(providerId) {
 	return `${resolveOAuthPath(providerId.toLowerCase())}.lock`;

package/dist/src/auth/sync-provider-auth.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
 import { init_registry, isOAuthOnlyProvider } from "./oauth/registry.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/automations/capabilities/drafts.js

@@ -3,10 +3,10 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_trust_policy, resolveAutomationSafetyForTrust } from "../../user-context/trust-policy.js";
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError } from "../../capabilities/runtime/external-operations.js";
 import { defineExternalCapability, defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { AutomationCreateCapabilityInputSchema } from "./write.js";
 import { simulateAutomation } from "../draft/automation-draft-validator.js";
 import { AutomationDraftService } from "../draft/automation-draft-service.js";