@xopcai/xopc 0.0.169 → 0.0.171

package/dist/src/agent/orchestration/loop-guard.js

@@ -11,12 +11,16 @@ const DEFAULT_CONFIG = {
 * Stable fingerprint for tool call comparison.
 * Recursively sorts object keys; truncates long string values.
 */
-function fingerprint(toolName, params) {
-	return `${toolName}::${JSON.stringify(params, (_key, value) => {
-		if (typeof value === "object" && value !== null && !Array.isArray(value)) return Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)));
-		if (typeof value === "string" && value.length > 200) return `${value.slice(0, 80)}…[${value.length}]`;
-		return value;
-	})}`;
+function stableJson(value) {
+	return JSON.stringify(value, (_key, item) => {
+		if (typeof item === "object" && item !== null && !Array.isArray(item)) return Object.fromEntries(Object.entries(item).sort(([a], [b]) => a.localeCompare(b)));
+		if (typeof item === "string" && item.length > 200) return `${item.slice(0, 80)}…[${item.length}]`;
+		return item;
+	});
+}
+function fingerprint(call) {
+	const result = call.resultPreview === void 0 ? "" : `::result=${stableJson(call.resultPreview)}`;
+	return `${call.name}::${stableJson(call.params)}${result}`;
 }
 /**
 * Analyze recent tool calls and produce loop guard result.
@@ -70,11 +74,11 @@ function findConsecutiveRepeats(calls) {
 	let index = calls.length - 1;
 	while (index >= 0) {
 		const current = calls[index];
-		const fp = fingerprint(current.name, current.params);
+		const fp = fingerprint(current);
 		let count = 1;
 		while (index - count >= 0) {
 			const prev = calls[index - count];
-			if (fingerprint(prev.name, prev.params) !== fp) break;
+			if (fingerprint(prev) !== fp) break;
 			count++;
 		}
 		if (count >= 2) groups.push({
@@ -92,7 +96,7 @@ function findConsecutiveRepeats(calls) {
 function countFrequency(calls) {
 	const map = /* @__PURE__ */ new Map();
 	for (const call of calls) {
-		const fp = fingerprint(call.name, call.params);
+		const fp = fingerprint(call);
 		map.set(fp, (map.get(fp) ?? 0) + 1);
 	}
 	return map;

package/dist/src/agent/reply/post-compaction-context.d.ts

@@ -5,6 +5,8 @@ export type PostCompactionContextOptions = {
     agentId?: string;
     nowMs?: number;
     userTimezone?: string;
+    sectionNames?: string[];
+    maxContextChars?: number;
 };
 export declare function readPostCompactionContextFromAgentsMd(agentsMdContent: string, options?: PostCompactionContextOptions): string | null;
 export declare function readPostCompactionContext(params: {
@@ -13,4 +15,6 @@ export declare function readPostCompactionContext(params: {
     agentId?: string;
     nowMs?: number;
     userTimezone?: string;
+    sectionNames?: string[];
+    maxContextChars?: number;
 }): string | null;

package/dist/src/agent/reply/post-compaction-context.js

@@ -53,7 +53,7 @@ function extractSections(content, sectionNames, foundNames) {
 	return results;
 }
 function readPostCompactionContextFromAgentsMd(agentsMdContent, options) {
-	const sectionNames = DEFAULT_POST_COMPACTION_SECTIONS;
+	const sectionNames = options?.sectionNames ?? DEFAULT_POST_COMPACTION_SECTIONS;
 	if (sectionNames.length === 0) return null;
 	const foundSectionNames = [];
 	const sections = extractSections(agentsMdContent, sectionNames, foundSectionNames);
@@ -62,7 +62,7 @@ function readPostCompactionContextFromAgentsMd(agentsMdContent, options) {
 	const timezone = options?.userTimezone?.trim() || Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
 	const nowMs = options?.nowMs ?? Date.now();
 	const dateStamp = new Intl.DateTimeFormat("en-CA", { timeZone: timezone }).format(new Date(nowMs));
-	const maxContextChars = MAX_CONTEXT_CHARS;
+	const maxContextChars = Math.max(1, options?.maxContextChars ?? MAX_CONTEXT_CHARS);
 	const combined = sections.join("\n\n").replaceAll("YYYY-MM-DD", dateStamp);
 	const safeContent = combined.length > maxContextChars ? `${combined.slice(0, maxContextChars)}\n...[truncated]...` : combined;
 	const isDefaultSections = sectionNames.length === DEFAULT_POST_COMPACTION_SECTIONS.length && sectionNames.every((name, index) => normalizeHeading(name) === normalizeHeading(DEFAULT_POST_COMPACTION_SECTIONS[index] ?? ""));
@@ -84,7 +84,9 @@ function readPostCompactionContext(params) {
 			cfg,
 			agentId,
 			nowMs: params.nowMs,
-			userTimezone: params.userTimezone
+			userTimezone: params.userTimezone,
+			sectionNames: params.sectionNames,
+			maxContextChars: params.maxContextChars
 		});
 	} catch {
 		return null;

package/dist/src/agent/service.d.ts

@@ -102,7 +102,6 @@ export declare class AgentService {
     private createHookRunner;
     private createProgressManager;
     private initializeReliabilityModules;
-    private initializeLifecycleHandlers;
     setChannelManager(channelManager: ChannelManager): void;
     /**
      * Apply config after save or hot reload so the default model updates without restarting the gateway.
@@ -191,7 +190,6 @@ export declare class AgentService {
      * Handle events from a specific session's agent
      */
     private handleSessionEvent;
-    private checkAndCompact;
     private getContextWindowForSession;
     private dispose;
 }

package/dist/src/agent/service.js

@@ -15,6 +15,7 @@ import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";
 import { AgentManager } from "./agent-manager.js";
 import { maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle } from "../session/session-title.js";
+import { resolveCompactionPolicy } from "./memory/compaction-policy.js";
 import { SessionStore } from "../session/store.js";
 import { SessionConfigStore } from "../session/config-store.js";
 import "../session/index.js";
@@ -38,7 +39,6 @@ import "./middleware/index.js";
 import { TurnDiffTracker } from "./coding/turn-diff-tracker.js";
 import { LifecycleManager } from "./lifecycle/manager.js";
 import "./lifecycle/index.js";
-import { CompactionLifecycleHandler } from "./lifecycle/handlers/compaction.js";
 import { MessageRouter } from "./messaging/message-router.js";
 import { CommandHandler } from "./messaging/command-handler.js";
 import { StreamManager } from "./messaging/stream-manager.js";
@@ -203,10 +203,20 @@ var AgentService = class {
 				return this.currentContext?.sessionKey;
 			}
 		});
+		this.sessionStore.setCompactionHooks({
+			before: ({ sessionKey, messageCount, tokenCount }) => this.hookHandler.triggerWithSessionKey(sessionKey, "before_compaction", {
+				messageCount,
+				tokenCount
+			}),
+			after: ({ sessionKey, messageCount, tokenCount, compactedCount }) => this.hookHandler.triggerWithSessionKey(sessionKey, "after_compaction", {
+				messageCount,
+				tokenCount,
+				compactedCount
+			})
+		});
 		this.progressManager = this.createProgressManager();
 		this.initializeReliabilityModules();
 		this.lifecycleManager = new LifecycleManager();
-		this.initializeLifecycleHandlers();
 		this.streamManager = new StreamManager();
 		this.sessionContextManager = new SessionContextManager();
 		this.feedbackCoordinator = new FeedbackCoordinator({
@@ -400,7 +410,6 @@ var AgentService = class {
 			setupSessionEventHandling: (sk) => this.setupSessionEventHandling(sk),
 			sessionHydrator: this.sessionHydrator,
 			getLastAssistantPlainText: (sk) => this.getLastAssistantPlainText(sk),
-			checkAndCompact: (sk, msgs) => this.checkAndCompact(sk, msgs),
 			enqueueMaybeAutoTitleAfterPersist: (sk) => this.enqueueMaybeAutoTitleAfterPersist(sk),
 			getConfig: () => this.effectiveAppConfig(),
 			resetSession: (sk) => this.resetSession(sk),
@@ -418,19 +427,9 @@ var AgentService = class {
 			keepRecentMessages: 20,
 			preserveSystemMessages: true
 		};
-		const compactionConfig = {
-			enabled: true,
-			mode: "abstractive",
-			reserveTokens: 8e3,
-			triggerThreshold: .8,
-			minMessagesBeforeCompact: 10,
-			keepRecentMessages: 10,
-			evictionWindow: .2,
-			retentionWindow: 6
-		};
 		const appCfg = this.config.config;
 		if (!appCfg) throw new Error("AgentService requires config.config for session store paths");
-		return new SessionStore({ config: appCfg }, windowConfig, compactionConfig);
+		return new SessionStore({ config: appCfg }, windowConfig, resolveCompactionPolicy(appCfg));
 	}
 	createHookRunner() {
 		if (!this.config.extensionRegistry) return void 0;
@@ -498,15 +497,6 @@ var AgentService = class {
 		});
 		this.contextMiddleware = new ContextMiddleware();
 	}
-	initializeLifecycleHandlers() {
-		this.lifecycleManager.on("llm_response", new CompactionLifecycleHandler({
-			minMessages: 20,
-			maxTokens: 8e3,
-			preserveReasoning: true,
-			accumulateUsage: true
-		}));
-		log.debug({ handlers: this.lifecycleManager.getRegisteredHandlers() }, "Lifecycle handlers initialized");
-	}
 	setChannelManager(channelManager) {
 		this.inboundLoop.setChannelManager(channelManager);
 	}
@@ -809,27 +799,6 @@ var AgentService = class {
 		}
 		this.agentEventHandler.handle(event, currentContext);
 	}
-	async checkAndCompact(sessionKey, messages) {
-		const contextWindow = this.getContextWindowForSession(sessionKey);
-		const prep = this.sessionStore.prepareCompaction(sessionKey, messages, contextWindow);
-		if (!prep.needsCompaction) return;
-		log.info({
-			sessionKey,
-			reason: prep.stats?.reason,
-			usagePercent: prep.stats?.usagePercent
-		}, "Session needs compaction");
-		const result = await this.sessionStore.compact(sessionKey, messages, contextWindow, void 0, false);
-		await this.hookHandler.trigger("after_compaction", {
-			messageCount: messages.length,
-			tokenCount: result.tokensBefore,
-			compactedCount: messages.length - result.firstKeptIndex
-		});
-		log.info({
-			sessionKey,
-			tokensBefore: result.tokensBefore,
-			tokensAfter: result.tokensAfter
-		}, "Session compacted");
-	}
 	getContextWindowForSession(sessionKey) {
 		try {
 			return this.modelManager.getResolvedModelForSession(sessionKey).contextWindow ?? 128e3;

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

@@ -2,8 +2,10 @@ 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 { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";
+import { resolveCompactionPolicy } from "../memory/compaction-policy.js";
 import { resolveVerboseLevel } from "../../session/config-store.js";
 import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import "../../session/index.js";
@@ -12,6 +14,7 @@ import { formatSessionContextReport } from "../service/session-context-report.js
 //#region src/agent/session/session-inspector.ts
 init_workspace_defaults();
 init_logger();
+init_providers();
 const log = createLogger("SessionInspector");
 var SessionInspector = class {
 	opts;
@@ -37,8 +40,13 @@ var SessionInspector = class {
 	*/
 	async compact(sessionKey, options) {
 		const messages = await this.opts.sessionStore.load(sessionKey);
-		const contextWindow = await this.contextWindowForSession(sessionKey);
-		const result = await this.opts.sessionStore.compact(sessionKey, messages, contextWindow, options?.instructions, options?.force ?? true);
+		await this.ensureEffectiveSessionModel(sessionKey);
+		const policy = resolveCompactionPolicy(this.opts.getConfig());
+		const sessionModel = this.opts.modelManager.getResolvedModelForSession(sessionKey);
+		const model = policy.model ? resolveModel(policy.model) : sessionModel;
+		const primaryRef = `${model.provider}/${model.id}`;
+		const fallbackModels = this.opts.modelManager.getFallbackCandidatesForSession(sessionKey).map((candidate) => resolveModel(`${candidate.provider}/${candidate.model}`)).filter((candidate) => `${candidate.provider}/${candidate.id}` !== primaryRef);
+		const result = await this.opts.sessionStore.compact(sessionKey, messages, model, options?.instructions, options?.force ?? true, { fallbackModels });
 		if (result.compacted) this.opts.agentManager.removeAgent(sessionKey);
 		log.info({
 			sessionKey,

package/dist/src/agent/workflow/builtins/index.js

@@ -230,12 +230,12 @@ function createParallelGraph(spec) {
 			{
 				id: "output",
 				kind: "output",
-				title: "Result",
+				title: "Deliverable",
 				position: {
 					x: 1280,
 					y: 260
 				},
-				config: { title: "Final result" }
+				config: {}
 			}
 		],
 		edges: [

package/dist/src/agent-runtime/index.js

@@ -1,7 +1,7 @@
+import { buildMemoryRuntime } from "./memory-runtime.js";
 import { checkBoundary } from "./boundary-guard.js";
 import { resolveModelRole } from "./model-router.js";
 import { buildRuntimeToolRegistry } from "./tool-registry.js";
-import { buildMemoryRuntime } from "./memory-runtime.js";
 import { resolveWorkflow, validateWorkflowForRuntime } from "./workflow-runtime.js";
 import { buildAgentRuntimeProfile } from "./runtime-profile.js";
 import { appendAgentRunEvent, createAgentRunTrace, finishAgentRunTrace, hashEffectiveManifest } from "./run-trace.js";

package/dist/src/agent-runtime/runtime-profile.js

@@ -1,9 +1,9 @@
 import { buildAgentManifestPromptSection } from "../agent-manifest/prompt.js";
 import "../agent-manifest/index.js";
+import { buildMemoryRuntime } from "./memory-runtime.js";
 import { checkBoundary } from "./boundary-guard.js";
 import { resolveModelRole } from "./model-router.js";
 import { buildRuntimeToolRegistry } from "./tool-registry.js";
-import { buildMemoryRuntime } from "./memory-runtime.js";
 import { resolveWorkflow, validateWorkflowForRuntime } from "./workflow-runtime.js";
 //#region src/agent-runtime/runtime-profile.ts
 function buildAgentRuntimeProfile(params) {

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v59).`,
+		message: `SQLite schema v${status.dbVersion} (current release v61).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/onboard/model.d.ts

@@ -2,5 +2,7 @@
  * Catalog-driven model configuration for onboarding.
  */
 import type { Config } from '../../../config/schema.js';
+import { XopcCloudModelSource } from '../../../providers/xopc-cloud-model-source.js';
 import type { CLIContext } from '../../registry.js';
+export declare function refreshOnboardModelCatalogIfNeeded(provider: string, hasCatalogModels: boolean, source?: Pick<XopcCloudModelSource, 'refresh'>): Promise<void>;
 export declare function setupModel(existingConfig: Config | null, ctx: CLIContext): Promise<Config>;

package/dist/src/cli/commands/onboard/model.js

@@ -9,6 +9,7 @@ import { getDomesticProviderBaseUrl, getDomesticProviderPreset, getDomesticProvi
 import { getProviderHint, getRecommendedModelsForProvider, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
 import { prepareUpdateGlobalDefaults } from "../../../gateway/global-defaults-admin.js";
 import { discoverProviderModels, isProviderApiDiscoverable } from "../../../providers/model-discovery.js";
+import { XopcCloudModelSource } from "../../../providers/xopc-cloud-model-source.js";
 import { listProfilesForProvider } from "../../../auth/profiles/profiles.js";
 import { getOAuthProvider } from "../../utils/oauth-providers.js";
 import { colors } from "../../utils/colors.js";
@@ -89,6 +90,13 @@ function getModelsForProvider(provider) {
 		};
 	});
 }
+async function refreshOnboardModelCatalogIfNeeded(provider, hasCatalogModels, source) {
+	if (provider !== "xopc-cloud" || hasCatalogModels) return;
+	console.log("\n→ Loading models from XOPC Model Service...");
+	const result = await (source ?? new XopcCloudModelSource()).refresh();
+	if (result.status === "skipped") throw new Error("XOPC Model Service credentials are unavailable after OAuth login. Please sign in again.");
+	console.log(colors.green(`✓ Loaded ${result.modelCount} models`));
+}
 function discoveredModelsToChoices(provider, models) {
 	return models.filter((model) => !model.id.includes("/")).map((model) => ({
 		value: `${provider}/${model.id}`,
@@ -445,8 +453,13 @@ async function setupModel(existingConfig, ctx) {
 		console.error(`\n❌ Could not configure credentials for ${providerName}.`);
 		return config;
 	}
-	const modelChoices = getModelsForProvider(provider);
-	if (modelChoices.length === 0) throw new Error(`No catalog models found for ${providerName}. Add a Custom API provider instead.`);
+	let modelChoices = getModelsForProvider(provider);
+	await refreshOnboardModelCatalogIfNeeded(provider, modelChoices.length > 0);
+	modelChoices = getModelsForProvider(provider);
+	if (modelChoices.length === 0) {
+		if (provider === "xopc-cloud") throw new Error(`No models are currently available for ${providerName}.`);
+		throw new Error(`No catalog models found for ${providerName}. Add a Custom API provider instead.`);
+	}
 	console.log(`\n📋 Models for ${providerName}:`);
 	const model = await select({
 		message: "Model:",
@@ -459,4 +472,4 @@ async function setupModel(existingConfig, ctx) {
 	return setPrimaryModel(config, ctx.workspacePath, model);
 }
 //#endregion
-export { setupModel };
+export { refreshOnboardModelCatalogIfNeeded, setupModel };

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/config/schema.d.ts

@@ -460,7 +460,6 @@ export declare const SessionConfigSchema: z.ZodDefault<z.ZodObject<{
     }>>;
     identityLinks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     resetTriggers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    idleMinutes: z.ZodOptional<z.ZodNumber>;
     reset: z.ZodOptional<z.ZodObject<{
         mode: z.ZodOptional<z.ZodEnum<{
             idle: "idle";
@@ -507,7 +506,7 @@ export declare const SessionConfigSchema: z.ZodDefault<z.ZodObject<{
         pruneAfterMs: z.ZodOptional<z.ZodNumber>;
         maxEntries: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-}, z.core.$strip>>;
+}, z.core.$strict>>;
 /** Channel buckets — shapes validated post-parse by registered channel plugins. */
 export declare const ChannelsConfigSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 export declare const SearchProviderEntrySchema: z.ZodObject<{
@@ -1553,7 +1552,23 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
             retention: z.ZodOptional<z.ZodObject<{
-                compaction: z.ZodDefault<z.ZodBoolean>;
+                compaction: z.ZodDefault<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    triggerThreshold: z.ZodDefault<z.ZodNumber>;
+                    reserveTokens: z.ZodDefault<z.ZodNumber>;
+                    minMessagesBeforeCompact: z.ZodDefault<z.ZodNumber>;
+                    keepRecentTokens: z.ZodDefault<z.ZodNumber>;
+                    recentTurnsPreserve: z.ZodDefault<z.ZodNumber>;
+                    summaryMaxTokens: z.ZodDefault<z.ZodNumber>;
+                    summaryChunkTokens: z.ZodDefault<z.ZodNumber>;
+                    summaryTimeoutMs: z.ZodDefault<z.ZodNumber>;
+                    summaryRetries: z.ZodDefault<z.ZodNumber>;
+                    qualityGuard: z.ZodDefault<z.ZodBoolean>;
+                    model: z.ZodOptional<z.ZodString>;
+                    minToolResultKeepChars: z.ZodDefault<z.ZodNumber>;
+                    maxActiveTranscriptBytes: z.ZodDefault<z.ZodNumber>;
+                    postCompactionSections: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
                 maxAgeDays: z.ZodOptional<z.ZodNumber>;
                 maxItems: z.ZodOptional<z.ZodNumber>;
                 maxChars: z.ZodOptional<z.ZodNumber>;
@@ -1905,7 +1920,6 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
         }>>;
         identityLinks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         resetTriggers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        idleMinutes: z.ZodOptional<z.ZodNumber>;
         reset: z.ZodOptional<z.ZodObject<{
             mode: z.ZodOptional<z.ZodEnum<{
                 idle: "idle";
@@ -1952,7 +1966,7 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
             pruneAfterMs: z.ZodOptional<z.ZodNumber>;
             maxEntries: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     channels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     gateway: z.ZodDefault<z.ZodObject<{
         bind: z.ZodOptional<z.ZodEnum<{

package/dist/src/config/schema.js

@@ -263,12 +263,11 @@ var init_schema = __esmMin((() => {
 		dmScope: SessionDmScopeSchema.default("main"),
 		identityLinks: z.record(z.string(), z.array(z.string())).optional(),
 		resetTriggers: z.array(z.string()).optional(),
-		idleMinutes: z.number().int().positive().optional(),
 		reset: SessionResetConfigSchema.optional(),
 		resetByType: SessionResetByTypeSchema.optional(),
 		resetByChannel: z.record(z.string(), SessionResetConfigSchema).optional(),
 		storage: SessionStorageConfigSchema.optional()
-	}).default({
+	}).strict().default({
 		scope: "per-sender",
 		mainKey: "main",
 		dmScope: "main"

package/dist/src/gateway/agents-admin.js

@@ -1,5 +1,5 @@
-import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
+import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths, resolveUserProfilePath } from "../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -307,6 +307,29 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
             maxEntries: number;
         };
     };
+    userContext: {
+        memory: {
+            retention: {
+                compaction: {
+                    enabled: boolean;
+                    triggerThreshold: number;
+                    reserveTokens: number;
+                    minMessagesBeforeCompact: number;
+                    keepRecentTokens: number;
+                    recentTurnsPreserve: number;
+                    summaryMaxTokens: number;
+                    summaryChunkTokens: number;
+                    summaryTimeoutMs: number;
+                    summaryRetries: number;
+                    qualityGuard: boolean;
+                    minToolResultKeepChars: number;
+                    maxActiveTranscriptBytes: number;
+                    postCompactionSections: string[];
+                    model?: string;
+                };
+            };
+        };
+    };
     tui: {
         defaultAgent: string;
     };

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,3 +1,4 @@
+import { ContextCompactionPolicySchema, init_config } from "../../../user-context/config.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, getChannelSetupStatus, init_channel_catalog_service } from "../../../channels/catalog/channel-catalog-service.js";
@@ -20,6 +21,7 @@ init_credentials();
 init_models_json();
 init_providers();
 init_plugin_registry();
+init_config();
 function readModelsJsonProviderApiKey(providerId) {
 	const { config } = loadModelsJson(resolveModelsJsonPath());
 	const key = (config.providers?.[providerId])?.apiKey;
@@ -175,6 +177,7 @@ async function buildSafeWebConfigPayload(service, options = {}) {
 		browser: buildSafeBrowserConfigForWeb(config.browser),
 		goals: resolveGoalsConfigForWeb(config),
 		session: resolveSessionConfigForWeb(config),
+		userContext: { memory: { retention: { compaction: ContextCompactionPolicySchema.parse(config.userContext?.memory.retention?.compaction) } } },
 		tui: { defaultAgent: config.tui?.defaultAgent ?? "coder" },
 		tunnel: {
 			enabled: config.tunnel?.enabled === true,

package/dist/src/gateway/hono/routes/config-patch/misc.d.ts

@@ -2,7 +2,7 @@
  * `PATCH /api/config` — tail sections that are each <50 lines:
  *   update / goals / session / gateway.{skillsMarketplaceProvider,
  *   skillsStoreBaseUrl} / providers / providersConfig / stt / tts / tools /
- *   tunnel / bindings / mcp.
+ *   userContext.memory.retention.compaction / tunnel / bindings / mcp.
  *
  * Most of these delegate to a `mergeXxxConfigPatch(config, body) → { ok,
  * message? }` helper that lives next to the schema, so this file is mostly

package/dist/src/gateway/hono/routes/config-patch/misc.js

@@ -1,3 +1,4 @@
+import { ContextCompactionPolicySchema, init_config } from "../../../../user-context/config.js";
 import { BindingsConfigSchema, BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
 import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
@@ -13,6 +14,7 @@ import { PATCH_OK, patchError } from "./result.js";
 //#region src/gateway/hono/routes/config-patch/misc.ts
 init_schema();
 init_credentials();
+init_config();
 async function applyMiscPatch(config, body) {
 	if (body.update !== void 0 && typeof body.update === "object" && body.update !== null) {
 		const updateResult = mergeUpdateConfigPatch(config, body.update);
@@ -28,6 +30,32 @@ async function applyMiscPatch(config, body) {
 		const sessionResult = mergeSessionConfigPatch(config, body.session);
 		if (sessionResult.ok === false) return patchError(sessionResult.message);
 	}
+	if (body.userContext !== void 0) {
+		if (typeof body.userContext !== "object" || body.userContext === null || Array.isArray(body.userContext)) return patchError("userContext must be an object");
+		const userContextPatch = body.userContext;
+		if (userContextPatch.memory !== void 0) {
+			if (typeof userContextPatch.memory !== "object" || userContextPatch.memory === null || Array.isArray(userContextPatch.memory)) return patchError("userContext.memory must be an object");
+			const memoryPatch = userContextPatch.memory;
+			if (memoryPatch.retention !== void 0) {
+				if (typeof memoryPatch.retention !== "object" || memoryPatch.retention === null || Array.isArray(memoryPatch.retention)) return patchError("userContext.memory.retention must be an object");
+				const retentionPatch = memoryPatch.retention;
+				if (retentionPatch.compaction !== void 0) {
+					const parsed = ContextCompactionPolicySchema.safeParse(retentionPatch.compaction);
+					if (!parsed.success) return patchError(parsed.error.issues.map((issue) => issue.message).join("; "));
+					config.userContext = {
+						...config.userContext,
+						memory: {
+							...config.userContext?.memory,
+							retention: {
+								...config.userContext?.memory?.retention,
+								compaction: parsed.data
+							}
+						}
+					};
+				}
+			}
+		}
+	}
 	if (body.tui !== void 0) {
 		if (typeof body.tui !== "object" || body.tui === null || Array.isArray(body.tui)) return patchError("tui must be an object");
 		const tuiPatch = body.tui;