@xopcai/xopc 0.0.249 → 0.0.251

package/dist/src/agent/context/execution-context.js

@@ -5,6 +5,8 @@ import "../../knowledge-memory/index.js";
 import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { calculateExecutionValue } from "../../user-model/importance.js";
 import { listUserAssertions } from "../../user-model/repository.js";
+import { getExecutionContextFeedbackScores } from "./audit.js";
+import { buildUserContextBlock } from "../memory/context-fence.js";
 import { randomUUID } from "node:crypto";
 //#region src/agent/context/execution-context.ts
 function scopeVisible(scope, context) {
@@ -16,6 +18,22 @@ function scopeVisible(scope, context) {
 		session: context.sessionId
 	}[scope.type];
 }
+function applicabilityVisible(applicability, context) {
+	const operation = applicability.operation;
+	if (typeof operation === "string" && operation !== "response") return false;
+	if (Array.isArray(operation) && !operation.some((value) => value === "response")) return false;
+	for (const [key, actual] of [
+		["agentId", context.agentId],
+		["workspaceId", context.workspaceId],
+		["projectId", context.projectId],
+		["sessionId", context.sessionId]
+	]) {
+		const expected = applicability[key];
+		if (typeof expected === "string" && expected !== actual) return false;
+		if (Array.isArray(expected) && !expected.some((value) => typeof value === "string" && value === actual)) return false;
+	}
+	return true;
+}
 function urgency(assertion, asOf) {
 	const deadline = assertion.validTo ?? assertion.reviewAt;
 	if (deadline === void 0) return 0;
@@ -23,7 +41,7 @@ function urgency(assertion, asOf) {
 	if (remaining <= 0) return 1;
 	return Math.max(0, 1 - remaining / (720 * 60 * 60 * 1e3));
 }
-function rankAssertion(assertion, query, asOf) {
+function rankAssertion(assertion, query, asOf, feedbackScore) {
 	const taskRelevance = retrievalLexicalSimilarity(query, `${assertion.statement} ${assertion.normalizedValue}`);
 	return {
 		assertion,
@@ -34,12 +52,14 @@ function rankAssertion(assertion, query, asOf) {
 			actionability: assertion.actionability,
 			taskRelevance,
 			urgency: urgency(assertion, asOf)
-		}),
+		}) + feedbackScore,
 		reasons: [
 			taskRelevance >= .35 ? "task_relevant" : "",
 			assertion.declaredImportance !== void 0 ? "user_declared_importance" : "",
 			assertion.consequence === "critical" || assertion.consequence === "high" ? "high_consequence" : "",
-			assertion.kind === "identity" || assertion.kind === "preference" ? "stable_personalization" : ""
+			assertion.kind === "identity" || assertion.kind === "preference" ? "stable_personalization" : "",
+			feedbackScore > 0 ? "historically_helpful" : "",
+			feedbackScore < 0 ? "historically_irrelevant" : ""
 		].filter(Boolean)
 	};
 }
@@ -93,24 +113,33 @@ function loadPriorities(context, asOf) {
 }
 function buildExecutionContext(request) {
 	const asOf = request.asOf ?? Date.now();
-	const assertions = listUserAssertions({
+	const includeUserModel = request.includeUserModel !== false;
+	const feedbackScores = getExecutionContextFeedbackScores();
+	const assertions = includeUserModel ? listUserAssertions({
 		statuses: ["active"],
 		limit: 1e3
-	}).filter((item) => scopeVisible(getAssertionScope(item.slotId), request)).filter((item) => (item.validFrom === void 0 || item.validFrom <= asOf) && (item.validTo === void 0 || item.validTo >= asOf)).filter((item) => item.sensitivity !== "secret" && item.sensitivity !== "regulated" && item.disclosurePolicy !== "ask_before_reference").map((item) => rankAssertion(item, request.query, asOf)).filter((item) => item.score >= .12 || item.reasons.includes("high_consequence")).sort((left, right) => right.score - left.score).slice(0, Math.max(1, Math.min(100, request.maxAssertions ?? 20)));
+	}).filter((item) => scopeVisible(getAssertionScope(item.slotId), request)).filter((item) => applicabilityVisible(item.applicability, request)).filter((item) => (item.validFrom === void 0 || item.validFrom <= asOf) && (item.validTo === void 0 || item.validTo >= asOf)).filter((item) => item.authority !== "external_untrusted").filter((item) => item.sensitivity !== "secret" && item.sensitivity !== "regulated" && item.disclosurePolicy !== "ask_before_reference").map((item) => rankAssertion(item, request.query, asOf, feedbackScores.get(`assertion:${item.id}`) ?? 0)).filter((item) => item.score >= .12 || item.reasons.includes("high_consequence")).sort((left, right) => right.score - left.score).slice(0, Math.max(1, Math.min(100, request.maxAssertions ?? 20))) : [];
+	const maxKnowledge = Math.max(0, Math.min(100, request.maxKnowledge ?? 12));
+	const knowledge = request.includeKnowledge === false || maxKnowledge === 0 ? [] : searchKnowledgeItems({
+		query: request.query,
+		context: request,
+		asOf,
+		trustedOnly: true,
+		sources: request.knowledgeSources,
+		limit: Math.min(100, maxKnowledge * 2)
+	}).map((item) => ({
+		item,
+		score: retrievalLexicalSimilarity(request.query, item.content) * .7 + item.importance * .3 + (feedbackScores.get(`knowledge:${item.id}`) ?? 0)
+	})).sort((left, right) => right.score - left.score).slice(0, maxKnowledge).map(({ item }) => item);
 	return {
 		traceId: randomUUID(),
 		asOf,
 		query: request.query,
-		rules: loadRules(request),
+		rules: includeUserModel ? loadRules(request) : [],
 		assertions,
-		goals: loadGoals(request, asOf),
-		priorities: loadPriorities(request, asOf),
-		knowledge: searchKnowledgeItems({
-			query: request.query,
-			context: request,
-			asOf,
-			limit: request.maxKnowledge ?? 12
-		})
+		goals: includeUserModel ? loadGoals(request, asOf) : [],
+		priorities: includeUserModel ? loadPriorities(request, asOf) : [],
+		knowledge
 	};
 }
 function getAssertionScope(slotId) {
@@ -130,6 +159,41 @@ function renderExecutionContext(context) {
 	if (context.knowledge.length) sections.push(`Relevant knowledge:\n${context.knowledge.map((item) => `- ${item.content}`).join("\n")}`);
 	return sections.join("\n\n");
 }
+function fitExecutionContextToChars(context, maxChars) {
+	const selected = {
+		...context,
+		rules: [],
+		assertions: [],
+		goals: [],
+		priorities: [],
+		knowledge: []
+	};
+	const fits = () => buildUserContextBlock(renderExecutionContext(selected)).length <= maxChars;
+	for (const item of context.rules) {
+		selected.rules.push(item);
+		if (!fits()) selected.rules.pop();
+	}
+	for (const item of context.assertions) {
+		selected.assertions.push(item);
+		if (!fits()) selected.assertions.pop();
+	}
+	for (const item of context.goals) {
+		selected.goals.push(item);
+		if (!fits()) selected.goals.pop();
+	}
+	for (const item of context.priorities) {
+		selected.priorities.push(item);
+		if (!fits()) selected.priorities.pop();
+	}
+	for (const item of context.knowledge) {
+		selected.knowledge.push(item);
+		if (!fits()) selected.knowledge.pop();
+	}
+	return {
+		context: selected,
+		rendered: buildUserContextBlock(renderExecutionContext(selected))
+	};
+}
 function evaluateToolGate(context, operation) {
 	for (const rule of context.rules) {
 		if (rule.enforcementLevel !== "tool_gate") continue;
@@ -144,4 +208,4 @@ function evaluateToolGate(context, operation) {
 	return { allowed: true };
 }
 //#endregion
-export { buildExecutionContext, evaluateToolGate, renderExecutionContext };
+export { buildExecutionContext, evaluateToolGate, fitExecutionContextToChars, renderExecutionContext };

package/dist/src/agent/context/execution-context.types.d.ts

@@ -0,0 +1,50 @@
+import type { KnowledgeItem, KnowledgeSource, KnowledgeVisibilityContext } from '../../knowledge-memory/index.js';
+import type { UserAssertion } from '../../user-model/domain.js';
+export type RuleEnforcementLevel = 'prompt' | 'planner' | 'tool_gate';
+export interface ExecutionRule {
+    id: string;
+    statement: string;
+    priority: number;
+    enforcementLevel: RuleEnforcementLevel;
+    conditions: Record<string, unknown>;
+}
+export interface RankedExecutionAssertion {
+    assertion: UserAssertion;
+    score: number;
+    reasons: string[];
+}
+export interface ExecutionGoal {
+    id: string;
+    title: string;
+    desiredOutcome: string;
+    status: string;
+    declaredImportance?: number;
+    targetAt?: number;
+}
+export interface ExecutionPriority {
+    id: string;
+    targetType: string;
+    targetId: string;
+    rank: 'primary' | 'secondary' | 'background';
+    urgency: number;
+    validTo: number;
+}
+export interface ExecutionContext {
+    traceId: string;
+    asOf: number;
+    query: string;
+    rules: ExecutionRule[];
+    assertions: RankedExecutionAssertion[];
+    goals: ExecutionGoal[];
+    priorities: ExecutionPriority[];
+    knowledge: KnowledgeItem[];
+}
+export interface ExecutionContextRequest extends KnowledgeVisibilityContext {
+    query: string;
+    asOf?: number;
+    maxAssertions?: number;
+    maxKnowledge?: number;
+    includeUserModel?: boolean;
+    includeKnowledge?: boolean;
+    knowledgeSources?: readonly KnowledgeSource[];
+}

package/dist/src/agent/context/execution-context.types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/agent/context/execution-scope.d.ts

@@ -1,3 +1,4 @@
+import type { KnowledgeSource } from '../../knowledge-memory/index.js';
 export type ExecutionObjective = {
     kind: 'task';
     id: string;
@@ -23,4 +24,7 @@ export interface ExecutionScope {
 }
 export declare function resolveExecutionScope(sessionKey: string): ExecutionScope;
 export declare function formatCurrentWorkForPrompt(scope: ExecutionScope): string | undefined;
-export declare function buildExecutionScopeContextForPrompt(sessionKey: string): string | undefined;
+export declare function buildExecutionScopeContextForPrompt(sessionKey: string, options?: {
+    includeKnowledge?: boolean;
+    knowledgeSources?: readonly KnowledgeSource[];
+}): string | undefined;

package/dist/src/agent/context/execution-scope.js

@@ -77,9 +77,13 @@ function formatCurrentWorkForPrompt(scope) {
 	lines.push("", "Keep work inside this objective and its project scope. Treat the acceptance criteria and completion evidence as the definition of done.");
 	return lines.join("\n");
 }
-function buildExecutionScopeContextForPrompt(sessionKey) {
+function buildExecutionScopeContextForPrompt(sessionKey, options = {}) {
 	const scope = resolveExecutionScope(sessionKey);
-	return [buildActiveProjectContextForPrompt(sessionKey, { knowledgeQuery: scope.objective?.objective }), formatCurrentWorkForPrompt(scope)].filter((section) => Boolean(section?.trim())).join("\n\n") || void 0;
+	return [buildActiveProjectContextForPrompt(sessionKey, {
+		knowledgeQuery: scope.objective?.objective,
+		includeKnowledge: options.includeKnowledge,
+		knowledgeSources: options.knowledgeSources
+	}), formatCurrentWorkForPrompt(scope)].filter((section) => Boolean(section?.trim())).join("\n\n") || void 0;
 }
 //#endregion
 export { buildExecutionScopeContextForPrompt, formatCurrentWorkForPrompt, resolveExecutionScope };

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

@@ -1,4 +1,5 @@
 import type { Project } from '../../projects/types.js';
+import { type KnowledgeSource } from '../../knowledge-memory/index.js';
 export interface ProjectTaskContext {
     title: string;
     state: string;
@@ -6,6 +7,8 @@ export interface ProjectTaskContext {
 }
 export declare function buildActiveProjectContextForPrompt(sessionKey: string, options?: {
     knowledgeQuery?: string;
+    includeKnowledge?: boolean;
+    knowledgeSources?: readonly KnowledgeSource[];
 }): string | undefined;
 export declare function formatActiveProjectContextForPrompt(input: {
     project: Project;

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

@@ -4,7 +4,7 @@ import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js
 import { LocalAppStore } from "../../local-apps/store.js";
 import { ProjectStore } from "../../projects/project-store.js";
 import { getProjectForSession, getProjectWorkspacePathForSession } from "../../projects/workspace.js";
-import { listKnowledgeItems, searchKnowledgeItems } from "../../knowledge-memory/repository.js";
+import { knowledgeSourceAllowed, listKnowledgeItems, searchKnowledgeItems } from "../../knowledge-memory/repository.js";
 import "../../knowledge-memory/index.js";
 //#region src/agent/context/project-context.ts
 const MAX_TEXT = 1200;
@@ -49,7 +49,7 @@ function buildActiveProjectContextForPrompt(sessionKey, options = {}) {
 			state: `${task.phase}/${new TaskReadModelProjector().project(task).operationalState}`
 		})),
 		recentSessions: new ProjectStore().getRecentSessions(project.id, MAX_SESSIONS),
-		knowledgeItems: selectProjectKnowledge({
+		knowledgeItems: options.includeKnowledge === false ? [] : selectProjectKnowledge({
 			relevant: options.knowledgeQuery?.trim() ? searchKnowledgeItems({
 				query: options.knowledgeQuery,
 				context: {
@@ -58,12 +58,14 @@ function buildActiveProjectContextForPrompt(sessionKey, options = {}) {
 					projectId: project.id,
 					sessionId: sessionKey
 				},
+				trustedOnly: true,
+				sources: options.knowledgeSources,
 				limit: MAX_RELEVANT_KNOWLEDGE
 			}) : [],
 			recent: listKnowledgeItems({
 				statuses: ["active"],
 				limit: 500
-			}).filter((item) => item.scope.type === "project" && item.scope.id === project.id).slice(0, MAX_RECENT_KNOWLEDGE)
+			}).filter((item) => item.scope.type === "project" && item.scope.id === project.id).filter((item) => item.originClass !== "untrusted").filter((item) => !options.knowledgeSources || knowledgeSourceAllowed(item, options.knowledgeSources)).slice(0, MAX_RECENT_KNOWLEDGE)
 		}),
 		localApp: localApp ? {
 			extensionId: localApp.extensionId,

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

@@ -1,8 +1,8 @@
 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 { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
 import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
 import { evaluateContextBudget } from "../memory/context-budget.js";

package/dist/src/agent/external-tools/index.d.ts

@@ -16,6 +16,7 @@ export interface DefaultExternalToolGatewayDeps {
     hookRunner?: ExtensionHookRunner;
     toolExecutorConfig?: Partial<ToolExecutorConfig>;
     getMemoryManager?: () => MemoryManager;
+    canAccessMemory: () => boolean;
 }
 export declare function createDefaultExternalToolGatewayTools(deps: DefaultExternalToolGatewayDeps): import("@earendil-works/pi-agent-core").AgentTool<import("typebox").TSchema, any>[];
 export { ExternalToolService } from './service.js';

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

@@ -32,6 +32,7 @@ function createDefaultExternalToolGatewayTools(deps) {
 			getMemoryManager: deps.getMemoryManager,
 			disabledTools: deps.disabledTools,
 			getSessionKey: () => deps.getCurrentContext()?.sessionKey,
+			canAccess: deps.canAccessMemory,
 			hookRunner: deps.hookRunner,
 			toolExecutorConfig: deps.toolExecutorConfig
 		})

package/dist/src/agent/external-tools/memory-provider.d.ts

@@ -6,6 +6,7 @@ export interface MemoryToolProviderDeps {
     getMemoryManager?: () => MemoryManager;
     disabledTools?: Set<string>;
     getSessionKey: () => string | undefined;
+    canAccess: () => boolean;
     hookRunner?: ExtensionHookRunner;
     toolExecutorConfig?: Partial<ToolExecutorConfig>;
 }

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

@@ -44,6 +44,7 @@ var MemoryToolProvider = class {
 		return executeToolWithProtection(resolved.tool, context.toolCallId, executionArgs, context.signal, context.onUpdate, this.deps.toolExecutorConfig);
 	}
 	entries() {
+		if (!this.deps.canAccess()) return [];
 		return (this.deps.getMemoryManager?.().getExternalToolEntries() ?? []).filter(({ tool }) => !this.deps.disabledTools?.has(tool.name));
 	}
 	resolve(toolRef) {

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 { 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/inbound/attachment-pipeline.js

@@ -1,3 +1,4 @@
+import { stripRuntimeUserMessageEnvelope } from "../../../packages/gateway-contract/src/user-message-display.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { readMediaReferenceBase64 } from "../../media/media-reference.js";
@@ -134,7 +135,10 @@ function pendingMatchesMessage(pending, message) {
 	const actualText = messageTextForPendingCompare(message);
 	if (!pendingText) return true;
 	if (!actualText) return false;
-	return actualText.includes(pendingText) || pendingText.includes(actualText);
+	if (actualText.includes(pendingText) || pendingText.includes(actualText)) return true;
+	const pendingUserText = stripRuntimeUserMessageEnvelope(pendingText).trim();
+	const actualUserText = stripRuntimeUserMessageEnvelope(actualText).trim();
+	return Boolean(pendingUserText) && (actualUserText === pendingUserText || actualUserText.includes(pendingUserText) || pendingUserText.includes(actualUserText));
 }
 function setPendingTranscriptUserMessage(sessionKey, message) {
 	assertTranscriptUserMessage(message);

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 { createHash } from "node:crypto";
 import { readFile, rm } from "node:fs/promises";
 //#region src/agent/mcp/oauth/mcp-oauth-store.ts

package/dist/src/agent/memory/compaction-promotion.d.ts

@@ -9,6 +9,7 @@ export interface PromoteCompactionLedgerInput {
     handover: CompactionHandover;
     audit: CompactionAudit;
     sourceEntries: readonly TranscriptSourceEntry[];
+    writePolicy: 'deny' | 'confirm' | 'allow';
 }
 export interface PromoteCompactionLedgerResult {
     episodicRecordIds: string[];

package/dist/src/agent/memory/compaction-promotion.js

@@ -84,6 +84,11 @@ function importanceFor(item) {
 	return .5;
 }
 function promoteCompactionLedger(input) {
+	if (input.writePolicy === "deny") return {
+		episodicRecordIds: [],
+		durableRecordIds: [],
+		rejectedRecordIds: []
+	};
 	const sourceById = new Map(input.sourceEntries.map((entry) => [entry.entryId, entry]));
 	const entriesByTurn = /* @__PURE__ */ new Map();
 	const entriesByRound = /* @__PURE__ */ new Map();
@@ -124,7 +129,7 @@ function promoteCompactionLedger(input) {
 			content: item.text,
 			canonicalKey: `compaction:${input.sessionId}:${item.id}`,
 			confidence: input.audit.status === "passed" ? .82 : .65,
-			status: active ? "candidate" : "archived",
+			status: active ? input.writePolicy === "allow" && originClass !== "untrusted" ? "active" : "candidate" : "archived",
 			importance: importanceFor(item),
 			originClass,
 			sourceAgentId: input.sourceAgentId,
@@ -158,7 +163,7 @@ function promoteCompactionLedger(input) {
 			content: item.text,
 			canonicalKey: `durable:${item.kind}:${stableId("fact", item.text)}`,
 			confidence: .82,
-			status: "active",
+			status: input.writePolicy === "allow" ? "active" : "candidate",
 			importance: importanceFor(item),
 			originClass: "agent",
 			sourceSessionId: input.sessionKey,

package/dist/src/agent/memory/index.d.ts

@@ -1,6 +1,6 @@
 export { buildUserContextBlock, sanitizeUserContextFenceEscapes, } from './context-fence.js';
 export { createMemoryManagerFromConfig } from './create-memory-manager.js';
-export { isMemorySubsystemEnabled, shouldPlanUserContextThisTurn, } from './memory-config.js';
+export { isMemorySubsystemEnabled } from './memory-config.js';
 export { MemoryManager } from './manager.js';
 export { discoverMemoryPlugins } from './plugin-discovery.js';
 export type { MemoryPluginMetadata } from './plugin-discovery.js';

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

@@ -1,8 +1,8 @@
-import { isMemorySubsystemEnabled, shouldPlanUserContextThisTurn } from "./memory-config.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";
-import { buildUserContextBlock, sanitizeUserContextFenceEscapes } from "./context-fence.js";
 import { StubMemoryProvider } from "./stub-memory-provider.js";
-export { MemoryManager, StubMemoryProvider, buildUserContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, isMemorySubsystemEnabled, sanitizeUserContextFenceEscapes, shouldPlanUserContextThisTurn };
+export { MemoryManager, StubMemoryProvider, buildUserContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, isMemorySubsystemEnabled, sanitizeUserContextFenceEscapes };

package/dist/src/agent/memory/memory-config.d.ts

@@ -1,8 +1,3 @@
 import type { Config } from '../../config/schema.js';
 /** Whether generic workspace and provider-backed memory is available. */
 export declare function isMemorySubsystemEnabled(config: Config | undefined): boolean;
-/**
- * Whether to prefix the user message with prefetched external memory this turn.
- * `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …
- */
-export declare function shouldPlanUserContextThisTurn(_config: Config | undefined, turnNumber: number): boolean;

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

@@ -4,12 +4,5 @@ function isMemorySubsystemEnabled(config) {
 	if (!config) return true;
 	return config.userContext.enabled && config.userContext.knowledgeMemory.enabled;
 }
-/**
-* Whether to prefix the user message with prefetched external memory this turn.
-* `first-turn` only injects on turn 1. `contextCadence` N injects on turns 1, N+1, 2N+1, …
-*/
-function shouldPlanUserContextThisTurn(_config, turnNumber) {
-	return turnNumber >= 1;
-}
 //#endregion
-export { isMemorySubsystemEnabled, shouldPlanUserContextThisTurn };
+export { isMemorySubsystemEnabled };

package/dist/src/agent/orchestration/context-overflow.js

@@ -1,6 +1,7 @@
 //#region src/agent/orchestration/context-overflow.ts
 const CONTEXT_OVERFLOW_PATTERNS = [
 	/context(?:_|\s|-)*(?:length|window).*(?:exceed|limit|maximum|too (?:large|long))/i,
+	/\bexceed(?:s|ed)?\s+(?:the\s+)?context(?:_|\s|-)*(?:length|window)\b/i,
 	/maximum context length/i,
 	/max(?:imum)? tokens?.*(?:exceed|limit)/i,
 	/too many tokens/i,

package/dist/src/agent/service/direct-turn-helpers.d.ts

@@ -78,7 +78,7 @@ export interface RunDirectAgentTurnResult {
     lastAssistantText?: string;
 }
 /**
- * Convert a user message into an embedded turn, including the standard memory
- * prefetch + background-review nudge wiring used by every direct entry point.
+ * Convert a user message into an embedded turn, including structured context
+ * planning and background-review wiring used by every direct entry point.
  */
 export declare function runDirectAgentTurn(deps: RunDirectAgentTurnDeps, input: RunDirectAgentTurnInput): Promise<RunDirectAgentTurnResult>;

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

@@ -81,8 +81,8 @@ async function tryRunSlashCommand(deps, ctx, content, options) {
 	}
 }
 /**
-* Convert a user message into an embedded turn, including the standard memory
-* prefetch + background-review nudge wiring used by every direct entry point.
+* Convert a user message into an embedded turn, including structured context
+* planning and background-review wiring used by every direct entry point.
 */
 async function runDirectAgentTurn(deps, input) {
 	const turnId = input.runId ?? crypto.randomUUID();

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

@@ -267,8 +267,7 @@ async function* runProcessDirectStreaming(deps, input) {
 			const skillTurn = deps.agentManager.prepareSkillTurn(sessionKey, mergedUserText);
 			const textForAgent = skillTurn.text;
 			const userMessage = await deps.buildTranscriptUserMessage(textForAgent, prepared, sessionKey);
-			const turnSourceContexts = input.sourceContexts ?? [];
-			const sourceContexts = [...turnSourceContexts];
+			const sourceContexts = [...input.sourceContexts ?? []];
 			if (deps.sourceContextResolver) {
 				const metadata = await deps.sessionStore.getMetadata(sessionKey).catch(() => null);
 				const sourceBinding = metadata?.customData && typeof metadata.customData === "object" ? metadata.customData.sourceBinding : void 0;
@@ -283,11 +282,11 @@ async function* runProcessDirectStreaming(deps, input) {
 					timestamp: userMessage.timestamp ?? Date.now(),
 					content: readAgentMessageContent(userMessage),
 					media: userMessage.media,
-					metadata: turnSourceContexts.length > 0 ? { sourceContexts: turnSourceContexts.map(summarizeSourceContext) } : void 0
+					metadata: sourceContexts.length > 0 ? { sourceContexts: sourceContexts.map(summarizeSourceContext) } : void 0
 				});
 				if (textForAgent.trim()) deps.enqueueProvisionalSessionTitle?.(sessionKey, textForAgent);
 			}
-			const pendingUserMessage = turnSourceContexts.length > 0 ? injectSourceContextsIntoUserMessage(userMessage, turnSourceContexts) : userMessage;
+			const pendingUserMessage = sourceContexts.length > 0 ? injectSourceContextsIntoUserMessage(userMessage, sourceContexts) : userMessage;
 			if (!isConnectionResume) setPendingTranscriptUserMessage(sessionKey, pendingUserMessage);
 			try {
 				const result = await deps.agentManager.withSkillCapabilities(sessionKey, skillTurn.activatedCapabilityNames, () => runDirectAgentTurn({

package/dist/src/agent/service.js

@@ -2,10 +2,10 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { 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 { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";

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/skills/hub-lock.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/skills/hub-lock.ts
 /**

package/dist/src/agent/tasks/task-judge-service.js

@@ -1,15 +1,15 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { TaskRunRepository } 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 { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();
 init_providers();

package/dist/src/agent/tools/factory.d.ts

@@ -92,6 +92,7 @@ export interface CreateCoreToolsOptions {
     getPrimaryModel?: () => Model<Api>;
     getMemoryManager?: () => MemoryManager;
     agentId?: string;
+    sessionKey?: string;
     /** When set, registers local skill tools plus marketplace discovery for this workspace. */
     getSkillManager?: () => SkillManager;
 }