npm - @xopcai/xopc - Versions diffs - 0.0.177 → 0.0.179 - Mend

@xopcai/xopc 0.0.177 → 0.0.179

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (353) hide show

package/dist/gateway/static/root/index.html CHANGED Viewed

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260713-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260713-1" />
     <title>XOPC — Turn goals into loops. Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-C1h0zkNo.js"></script>
+    <script type="module" crossorigin src="/assets/index-BDzspHrg.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -22,19 +22,18 @@
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
     <link rel="modulepreload" crossorigin href="/assets/createLucideIcon-DPHK1VkS.js">
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
-    <link rel="modulepreload" crossorigin href="/assets/circle-alert-BEjgurr2.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-r8L6Ur3A.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-DVGhFXRz.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-DYqBwJAK.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-DIVc0AQs.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
-    <link rel="modulepreload" crossorigin href="/assets/schemas-DgQq6Z5S.js">
-    <link rel="modulepreload" crossorigin href="/assets/product-delivery-BTRT9kCS.js">
+    <link rel="modulepreload" crossorigin href="/assets/schemas-C6onAggk.js">
+    <link rel="modulepreload" crossorigin href="/assets/product-delivery-BVG-eWQO.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-WaXTw3fi.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-Wu2ikfbM.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-DQI-HPL-.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-Da36E3WH.css">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-CKKL96r_.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-A5FUMjeV.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-DtwI_VLT.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-B0Tdge_q.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js CHANGED Viewed

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.177";
+var version = "0.0.179";
 //#endregion
 export { version };

package/dist/packages/gateway-contract/src/outcomes.js ADDED Viewed

@@ -0,0 +1,137 @@
+import { z } from "zod";
+//#region packages/gateway-contract/src/outcomes.ts
+const OutcomeUserStatusSchema = z.enum([
+	"running",
+	"needs_user",
+	"completed"
+]);
+const OutcomeInternalStatusSchema = z.enum([
+	"captured",
+	"planning",
+	"running",
+	"verifying",
+	"continuing",
+	"needs_user",
+	"blocked",
+	"paused",
+	"completed",
+	"cancelled"
+]);
+const OutcomeImportanceSchema = z.enum([
+	"low",
+	"normal",
+	"high",
+	"critical"
+]);
+const OutcomeContractSchema = z.object({
+	outcomeId: z.string(),
+	version: z.number().int().positive(),
+	objective: z.string(),
+	deliverables: z.array(z.string()),
+	acceptanceCriteria: z.array(z.string()),
+	constraints: z.array(z.string()),
+	approvalRequired: z.array(z.string()),
+	contextSnapshotId: z.string().optional(),
+	createdBy: z.enum(["user", "system"]),
+	createdAt: z.number()
+});
+const OutcomeSchema = z.object({
+	id: z.string(),
+	objective: z.string(),
+	userStatus: OutcomeUserStatusSchema,
+	internalStatus: OutcomeInternalStatusSchema,
+	importance: OutcomeImportanceSchema,
+	dueAt: z.number().optional(),
+	latestContractVersion: z.number().int().positive(),
+	latestReceiptRunId: z.string().optional(),
+	contract: OutcomeContractSchema.optional(),
+	createdAt: z.number(),
+	updatedAt: z.number()
+});
+z.object({
+	ok: z.literal(true),
+	items: z.array(OutcomeSchema)
+});
+const OutcomeActionSchema = z.enum([
+	"run",
+	"pause",
+	"resume",
+	"cancel"
+]);
+const OutcomeActionRequestSchema = z.object({ action: OutcomeActionSchema });
+const OutcomeReceiptStatusSchema = z.enum([
+	"running",
+	"completed",
+	"partial",
+	"needs_user",
+	"failed",
+	"cancelled"
+]);
+const OutcomeEvidenceSchema = z.object({
+	kind: z.enum([
+		"artifact",
+		"test",
+		"state",
+		"source"
+	]),
+	title: z.string(),
+	summary: z.string(),
+	uri: z.string().optional(),
+	verifies: z.array(z.string()).optional()
+});
+const OutcomeReceiptSchema = z.object({
+	runId: z.string(),
+	outcomeId: z.string().optional(),
+	contractVersion: z.number().int().positive().optional(),
+	sessionKey: z.string(),
+	objective: z.string(),
+	status: OutcomeReceiptStatusSchema,
+	summary: z.string(),
+	projectId: z.string().optional(),
+	goalId: z.string().optional(),
+	workItemId: z.string().optional(),
+	origin: z.string().optional(),
+	triggerKind: z.string().optional(),
+	changes: z.array(OutcomeEvidenceSchema),
+	evidence: z.array(OutcomeEvidenceSchema),
+	verification: z.object({
+		status: z.enum([
+			"passed",
+			"failed",
+			"unverified"
+		]),
+		checks: z.array(z.object({
+			criterion: z.string(),
+			status: z.enum([
+				"passed",
+				"failed",
+				"unverified"
+			]),
+			evidenceTitles: z.array(z.string())
+		}))
+	}),
+	remainingWork: z.array(z.string()),
+	nextAction: z.string().optional(),
+	needsUser: z.boolean(),
+	completionVerdict: z.enum([
+		"achieved",
+		"partial",
+		"not_achieved"
+	]).optional(),
+	correctionText: z.string().optional(),
+	contextTraceId: z.string().optional(),
+	startedAt: z.number(),
+	completedAt: z.number().optional(),
+	feedback: z.object({
+		outcome: z.enum(["helpful", "not_helpful"]),
+		reason: z.string().optional(),
+		needsCorrection: z.boolean().optional(),
+		supportFit: z.boolean().optional()
+	}).optional()
+});
+z.object({
+	ok: z.literal(true),
+	items: z.array(OutcomeReceiptSchema)
+});
+//#endregion
+export { OutcomeActionRequestSchema, OutcomeUserStatusSchema };

package/dist/packages/gateway-contract/src/product-delivery.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { z } from "zod";
 const ProductReferenceKindSchema = z.enum([
+	"outcome",
 	"project",
 	"note",
 	"work_item",

package/dist/packages/gateway-contract/src/work-intake.js ADDED Viewed

@@ -0,0 +1,85 @@
+import { z } from "zod";
+//#region packages/gateway-contract/src/work-intake.ts
+const WorkExecutionModeSchema = z.enum(["create_only", "run_now"]);
+const WorkExecutionStatusSchema = z.enum([
+	"not_started",
+	"queued",
+	"running",
+	"retry_waiting",
+	"succeeded",
+	"failed",
+	"skipped"
+]);
+const MonitoringModeSchema = z.enum([
+	"observe",
+	"ask_before_action",
+	"auto_low_risk"
+]);
+const QuietHoursSchema = z.object({
+	startHour: z.number().int().min(0).max(23),
+	endHour: z.number().int().min(0).max(23),
+	timezone: z.string().min(1)
+});
+z.object({
+	projectId: z.string(),
+	mode: MonitoringModeSchema,
+	quietHours: QuietHoursSchema.optional(),
+	allowedActions: z.array(z.string()),
+	confidenceThreshold: z.number().min(0).max(1),
+	scenarios: z.array(z.string()),
+	configured: z.boolean(),
+	updatedAt: z.number().optional()
+});
+const ProjectMonitoringUpdateSchema = z.object({
+	mode: MonitoringModeSchema.optional(),
+	quietHours: QuietHoursSchema.nullable().optional(),
+	allowedActions: z.array(z.string()).optional(),
+	confidenceThreshold: z.number().min(0).max(1).optional(),
+	scenarios: z.array(z.string()).optional()
+});
+z.object({
+	id: z.string(),
+	objective: z.string(),
+	projectId: z.string().optional(),
+	planningContext: z.object({
+		supportMode: z.enum([
+			"efficient",
+			"coach",
+			"companion",
+			"auto"
+		]),
+		proactiveEnabled: z.boolean()
+	}),
+	outcomeContract: z.object({
+		objective: z.string(),
+		deliverables: z.array(z.string()),
+		acceptanceCriteria: z.array(z.string()),
+		constraints: z.array(z.string()),
+		approvalRequired: z.array(z.string())
+	}),
+	expiresAt: z.number()
+});
+const WorkIntakeCreateRequestSchema = z.object({
+	idempotencyKey: z.string().min(1).max(200),
+	objective: z.string().min(1).max(12e3),
+	projectId: z.string().min(1).optional(),
+	sessionKey: z.string().min(1).optional(),
+	agentId: z.string().min(1).optional()
+});
+const WorkIntakeConfirmRequestSchema = z.object({
+	executionMode: WorkExecutionModeSchema,
+	projectId: z.string().min(1).optional()
+});
+z.object({
+	outcomeId: z.string(),
+	projectId: z.string().optional(),
+	goalId: z.string(),
+	sessionKey: z.string().optional(),
+	execution: z.object({
+		mode: WorkExecutionModeSchema,
+		status: WorkExecutionStatusSchema,
+		queueId: z.string().optional()
+	})
+});
+//#endregion
+export { ProjectMonitoringUpdateSchema, WorkIntakeConfirmRequestSchema, WorkIntakeCreateRequestSchema };

package/dist/src/activity/service.d.ts CHANGED Viewed

@@ -9,4 +9,5 @@ export declare class ActivityService {
 export declare class ObjectLinkService {
     create(input: CreateObjectLinkInput): ObjectLink;
     listForObject(object: ActivityObjectRef): ObjectLink[];
+    delete(id: string): boolean;
 }

package/dist/src/activity/service.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "../storage/sqlite/activity-repository.js";
+import { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "../storage/sqlite/activity-repository.js";
 import "../storage/sqlite/index.js";
 import { randomUUID } from "node:crypto";
 //#region src/activity/service.ts
@@ -52,6 +52,9 @@ var ObjectLinkService = class {
 	listForObject(object) {
 		return listObjectLinkRecords(object);
 	}
+	delete(id) {
+		return deleteObjectLinkRecord(id);
+	}
 };
 //#endregion
 export { ActivityService, ObjectLinkService };

package/dist/src/agent/code-intelligence/binary.js CHANGED Viewed

@@ -9,8 +9,8 @@ import { accessSync, chmodSync, constants, copyFileSync, createReadStream, creat
 import { execFile } from "node:child_process";
 import { createHash, randomBytes } from "node:crypto";
 import { promisify } from "node:util";
-import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
 import lockfile from "proper-lockfile";
 //#region src/agent/code-intelligence/binary.ts
 init_paths();

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

@@ -6,7 +6,7 @@ export type ExecutionObjective = {
     status: string;
     scopeBoundary?: string;
     acceptanceCriteria: string[];
-    evidencePlan: string[];
+    deliverables: string[];
     nextAction?: string;
     blockedReason?: string;
 } | {

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

@@ -2,6 +2,7 @@ import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
 import { GoalService } from "../../goals/goal-service.js";
+import { OutcomeRepository } from "../../work/outcome-repository.js";
 import "../../goals/index.js";
 import { sanitizeForPromptLiteral } from "../prompt/sanitize-for-prompt.js";
 import { buildActiveProjectContextForPrompt } from "./project-context.js";
@@ -14,15 +15,16 @@ function bounded(value, max = MAX_OBJECTIVE_TEXT) {
 	return text.length <= max ? text : `${text.slice(0, max - 1).trimEnd()}…`;
 }
 function goalObjective(goal) {
+	const contract = new OutcomeRepository().getContract(goal.outcomeId, goal.outcomeContractVersion);
 	return {
 		kind: "goal",
 		id: goal.id,
 		title: goal.title,
-		objective: goal.contract?.objective?.trim() || goal.title,
+		objective: contract?.objective.trim() || goal.title,
 		status: goal.status,
-		scopeBoundary: bounded(goal.contract?.scopeBoundary),
+		scopeBoundary: bounded(contract?.constraints.join("\n")),
 		acceptanceCriteria: goal.checklist.slice(0, MAX_CRITERIA).map((item) => item.text),
-		evidencePlan: goal.contract?.evidencePlan.slice(0, MAX_CRITERIA) ?? [],
+		deliverables: contract?.deliverables.slice(0, MAX_CRITERIA) ?? [],
 		nextAction: bounded(goal.nextAction),
 		blockedReason: bounded(goal.blockedReason)
 	};
@@ -69,7 +71,7 @@ function formatCurrentWorkForPrompt(scope) {
 	if (objective.kind === "goal") {
 		if (objective.scopeBoundary) lines.push("", "## Scope Boundary", sanitizeForPromptLiteral(objective.scopeBoundary));
 		if (objective.acceptanceCriteria.length > 0) lines.push("", "## Acceptance Criteria", ...objective.acceptanceCriteria.map((item) => `- ${sanitizeForPromptLiteral(item)}`));
-		if (objective.evidencePlan.length > 0) lines.push("", "## Completion Evidence", ...objective.evidencePlan.map((item) => `- ${sanitizeForPromptLiteral(item)}`));
+		if (objective.deliverables.length > 0) lines.push("", "## Deliverables", ...objective.deliverables.map((item) => `- ${sanitizeForPromptLiteral(item)}`));
 		if (objective.nextAction) lines.push("", "Next action:", sanitizeForPromptLiteral(objective.nextAction));
 		if (objective.blockedReason) lines.push("", "Blocked reason:", sanitizeForPromptLiteral(objective.blockedReason));
 	}

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

@@ -2,6 +2,7 @@ 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 { 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";
 import { getApiKeySync, init_providers } from "../../providers/index.js";
 import { InMemoryModelsStore } from "@earendil-works/pi-ai";
@@ -12,11 +13,13 @@ init_model_credential_store();
 init_sync_provider_auth();
 init_paths();
 init_providers();
+init_register_bundled_oauth_flows();
 init_register_runtime_providers();
 function resolveEmbeddedProviderApiKeySync(providerId) {
 	return resolveProviderApiKeySync(providerId) ?? getApiKeySync(providerId);
 }
 async function createEmbeddedModelRuntime(providerId) {
+	registerBundledOAuthFlows();
 	const resolver = new CredentialResolver();
 	const credentials = new XopcModelCredentialStore(resolver);
 	const modelRuntime = await ModelRuntime.create({

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

@@ -91,13 +91,15 @@ async function runEmbeddedTurnForSession(params) {
 			}, "Agent model fallback candidates resolved");
 			let lastResult;
 			let lastError;
+			let resumeLastUserMessage = false;
 			const primaryModelRef = modelRef;
-			const beforeLen = Array.isArray(agent.state?.messages) ? agent.state.messages.length : void 0;
 			for (let i = 0; i < resolvedCandidates.length; i++) {
 				const candidate = resolvedCandidates[i];
 				const candidateModelRef = candidate.ref;
 				const isFallbackAttempt = i > 0;
 				const candidateModel = candidate.model;
+				const hasNextCandidate = i + 1 < resolvedCandidates.length;
+				const rowsBeforeAttempt = hasNextCandidate ? await sessionStore.loadTranscriptRows(sessionKey) : void 0;
 				if (typeof mm.applyResolvedModel === "function") mm.applyResolvedModel(agent, candidateModel, candidateModelRef);
 				agentManager.setModelForSession(sessionKey, candidateModelRef);
 				if (isFallbackAttempt) log.info({
@@ -123,7 +125,8 @@ async function runEmbeddedTurnForSession(params) {
 						sessionStore,
 						timeoutMs: resolveAgentTurnTimeoutMs(config),
 						abortSignal: params.abortSignal,
-						onEvent: params.onEvent
+						onEvent: params.onEvent,
+						resumeLastUserMessage
 					});
 					if (turnResult.ok) {
 						if (isFallbackAttempt) log.info({
@@ -137,7 +140,6 @@ async function runEmbeddedTurnForSession(params) {
 						return turnResult;
 					}
 					lastResult = turnResult;
-					const hasNextCandidate = i + 1 < resolvedCandidates.length;
 					log.warn({
 						sessionKey,
 						runId,
@@ -150,7 +152,6 @@ async function runEmbeddedTurnForSession(params) {
 				} catch (err) {
 					lastError = err;
 					if (err instanceof DOMException && err.name === "AbortError") throw err;
-					const hasNextCandidate = i + 1 < resolvedCandidates.length;
 					log.warn({
 						err,
 						sessionKey,
@@ -161,7 +162,19 @@ async function runEmbeddedTurnForSession(params) {
 						hasNextCandidate
 					}, hasNextCandidate ? "Agent model call threw, trying fallback" : "Agent model call threw, no fallback remains");
 				}
-				if (beforeLen !== void 0 && Array.isArray(agent.state?.messages)) agent.state.messages = agent.state.messages.slice(0, beforeLen);
+				if (hasNextCandidate && rowsBeforeAttempt) {
+					const preparation = await sessionStore.prepareModelFallback(sessionKey, rowsBeforeAttempt);
+					if (preparation === "unsafe") {
+						log.warn({
+							sessionKey,
+							runId,
+							modelRef: candidateModelRef,
+							attempt: i + 1
+						}, "Agent model fallback skipped because the failed attempt changed the transcript");
+						break;
+					}
+					resumeLastUserMessage = preparation === "resume";
+				}
 			}
 			if (lastResult) return lastResult;
 			if (lastError instanceof Error) throw lastError;

package/dist/src/agent/embedded/run-turn.js CHANGED Viewed

@@ -206,9 +206,12 @@ async function runXopcEmbeddedTurn(params) {
 		}
 		try {
 			await runAgentTurnWithTimeout(session.agent, async () => {
-				const text = userMessageToPromptText(userMessage);
-				const images = params.images ?? [];
-				await session.prompt(text, images.length > 0 ? { images } : void 0);
+				if (params.resumeLastUserMessage) await session.agent.continue();
+				else {
+					const text = userMessageToPromptText(userMessage);
+					const images = params.images ?? [];
+					await session.prompt(text, images.length > 0 ? { images } : void 0);
+				}
 				await session.agent.waitForIdle();
 				await maybeRetryTurnAfterTransientLlmFailure(session.agent, {
 					sessionKey,

package/dist/src/agent/embedded/types.d.ts CHANGED Viewed

@@ -89,6 +89,8 @@ export type RunXopcEmbeddedTurnParams = {
     abortSignal?: AbortSignal;
     onEvent?: (event: EmbeddedStreamEvent) => void;
     images?: ImageContent[];
+    /** Continue from the persisted trailing user row instead of appending it again. */
+    resumeLastUserMessage?: boolean;
 };
 export type RunXopcEmbeddedTurnResult = {
     ok: boolean;

package/dist/src/agent/goals/post-turn.js CHANGED Viewed

@@ -3,6 +3,7 @@ import { init_logger } from "../../utils/logger.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { GoalService } from "../../goals/goal-service.js";
+import { OutcomeRepository } from "../../work/outcome-repository.js";
 import { resolveGoalUiLocale } from "./goal-locale.js";
 import { evaluateAfterTurnHermesLike } from "./evaluate-turn.js";
 import "../../goals/index.js";
@@ -22,9 +23,10 @@ function buildHistoryExcerpt(messages, maxChars) {
 	}
 }
 function buildGoalContextText(goal) {
-	const lines = [`Title: ${goal.contract?.objective || goal.title}`];
-	if (goal.contract?.scopeBoundary) lines.push(`Scope boundary:\n${goal.contract.scopeBoundary}`);
-	if (goal.contract?.evidencePlan.length) lines.push(`Expected completion evidence:\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join("\n")}`);
+	const contract = new OutcomeRepository().getContract(goal.outcomeId, goal.outcomeContractVersion);
+	const lines = [`Outcome: ${contract?.objective ?? goal.title}`];
+	if (contract?.constraints.length) lines.push(`Constraints:\n${contract.constraints.map((item) => `- ${item}`).join("\n")}`);
+	if (contract?.deliverables.length) lines.push(`Deliverables:\n${contract.deliverables.map((item) => `- ${item}`).join("\n")}`);
 	if (goal.contextMessage?.text.trim()) lines.push(`Context:\n${goal.contextMessage.text.trim()}`);
 	if (goal.contextMessage?.attachments.length) lines.push(["Attachments:", ...goal.contextMessage.attachments.map((attachment) => `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`)].join("\n"));
 	return lines.join("\n\n");
@@ -101,8 +103,7 @@ async function handlePersistentGoalPostTurn(opts) {
 		goalContextExcerpt: buildGoalContextText(goal),
 		uiLocale: resolveGoalUiLocale(state)
 	});
-	const completionReadiness = goalService.getCompletionReadiness(goal.id);
-	const executionGaps = completionReadiness ? [...completionReadiness.missingEvidence, ...completionReadiness.pendingOutcome] : [];
+	const executionGaps = goalService.getCompletionReadiness(goal.id)?.pendingCriteria ?? [];
 	if (decision.verdict === "done" && executionGaps.length > 0 && decision.newState) {
 		const reason = `Completion evidence or outcome still needed: ${executionGaps.join("; ")}`;
 		decision = {

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

@@ -1,7 +1,7 @@
 import { killProcessTree } from "../../process/kill-tree.js";
 import { spawn } from "node:child_process";
-import process from "node:process";
 import { PassThrough } from "node:stream";
+import process from "node:process";
 import { getDefaultEnvironment } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { ReadBuffer, serializeMessage } from "@modelcontextprotocol/sdk/shared/stdio.js";
 //#region src/agent/mcp/mcp-stdio-transport.ts

package/dist/src/agent/memory/user-context-coordinator.d.ts CHANGED Viewed

@@ -14,6 +14,7 @@ export declare class UserContextCoordinator {
     private readonly userTurn;
     private readonly correctionTargets;
     private readonly planner;
+    private readonly contextCompiler;
     constructor(options: UserContextCoordinatorOptions);
     forgetSession(sessionKey: string): void;
     clear(): void;

package/dist/src/agent/memory/user-context-coordinator.js CHANGED Viewed

@@ -2,6 +2,7 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { setLatestMemoryInjectFeedback } from "../../storage/sqlite/memory-records-repository.js";
 import "../../storage/sqlite/index.js";
+import { ContextCompiler } from "../../user-context/context-compiler.js";
 import { shouldPlanUserContextThisTurn } from "./memory-config.js";
 import { UserContextPlanner } from "./context/planner.js";
 import { isExplicitUnderstandingCorrection } from "./understanding/correction.js";
@@ -13,6 +14,7 @@ var UserContextCoordinator = class {
 	userTurn = /* @__PURE__ */ new Map();
 	correctionTargets = /* @__PURE__ */ new Map();
 	planner = new UserContextPlanner();
+	contextCompiler = new ContextCompiler();
 	constructor(options) {
 		this.options = options;
 	}
@@ -61,7 +63,7 @@ var UserContextCoordinator = class {
 		const turn = (this.userTurn.get(sessionKey) ?? 0) + 1;
 		this.userTurn.set(sessionKey, turn);
 		if (!shouldPlanUserContextThisTurn(config, turn)) return empty();
-		return this.planner.plan({
+		const plan = await this.planner.plan({
 			memoryManager: this.options.getMemoryManagerForSession(sessionKey),
 			agentId: this.options.getAgentIdForSession(sessionKey),
 			sessionKey,
@@ -69,6 +71,20 @@ var UserContextCoordinator = class {
 			userMessage,
 			excludedRecordIds
 		});
+		if (plan.traceId) try {
+			this.contextCompiler.capture({
+				sessionKey,
+				query,
+				plan
+			});
+		} catch (err) {
+			log.debug({
+				err,
+				sessionKey,
+				traceId: plan.traceId
+			}, "Context snapshot was not persisted");
+		}
+		return plan;
 	}
 	async afterTurn(sessionKey, userPlainText) {
 		if (!this.options.isEnabledForSession(sessionKey)) return void 0;

package/dist/src/agent/outcomes/{task-evaluation.d.ts → execution-evaluation.d.ts} RENAMED Viewed

@@ -1,5 +1,5 @@
-import type { TaskOutcome } from '../../storage/sqlite/task-outcome-repository.js';
-export interface TaskEvaluationReplay {
+import type { ExecutionReceipt } from '../../storage/sqlite/execution-receipt-repository.js';
+export interface ExecutionEvaluationReplay {
     total: number;
     falseCompletions: number;
     verificationDrift: number;
@@ -17,4 +17,4 @@ export interface TaskEvaluationReplay {
         replayedVerification: string;
     }>;
 }
-export declare function replayTaskEvaluation(outcomes: TaskOutcome[]): TaskEvaluationReplay;
+export declare function replayExecutionEvaluation(outcomes: ExecutionReceipt[]): ExecutionEvaluationReplay;

package/dist/src/agent/outcomes/{task-evaluation.js → execution-evaluation.js} RENAMED Viewed

@@ -1,13 +1,13 @@
-import { verifyTaskCompletion } from "./task-verifier.js";
-//#region src/agent/outcomes/task-evaluation.ts
-function replayTaskEvaluation(outcomes) {
+import { verifyExecutionCompletion } from "./execution-verifier.js";
+//#region src/agent/outcomes/execution-evaluation.ts
+function replayExecutionEvaluation(outcomes) {
 	const completed = outcomes.filter((outcome) => outcome.status !== "running");
 	const byChannel = {};
 	const cases = [];
 	let falseCompletions = 0;
 	let supportMismatches = 0;
 	for (const outcome of completed) {
-		const replayed = verifyTaskCompletion({
+		const replayed = verifyExecutionCompletion({
 			status: outcome.status,
 			acceptanceCriteria: outcome.contract?.acceptanceCriteria ?? [],
 			evidence: outcome.evidence
@@ -45,4 +45,4 @@ function replayTaskEvaluation(outcomes) {
 	};
 }
 //#endregion
-export { replayTaskEvaluation };
+export { replayExecutionEvaluation };

package/dist/src/agent/outcomes/execution-verifier.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+export type ExecutionVerificationStatus = 'passed' | 'failed' | 'unverified';
+export type ExecutionFailurePhase = 'planning' | 'execution' | 'verification' | 'approval' | 'runtime';
+export type ExecutionFailureCode = 'cancelled' | 'timeout' | 'tool_failed' | 'verification_failed' | 'approval_required' | 'conflict' | 'model_failed' | 'unknown';
+export type ExecutionRecoveryAction = 'replan' | 'retry_with_changed_strategy' | 'request_user_input' | 'none';
+export interface ExecutionVerification {
+    status: ExecutionVerificationStatus;
+    checks: Array<{
+        criterion: string;
+        status: ExecutionVerificationStatus;
+        evidenceTitles: string[];
+    }>;
+}
+export interface ExecutionFailureDiagnosis {
+    code: ExecutionFailureCode;
+    phase: ExecutionFailurePhase;
+    recoveryAction: ExecutionRecoveryAction;
+}
+export declare function verifyExecutionCompletion(input: {
+    status: 'succeeded' | 'failed' | 'cancelled';
+    acceptanceCriteria: string[];
+    evidence: Array<{
+        title: string;
+        verifies?: string[];
+    }>;
+}): ExecutionVerification;
+export declare function diagnoseExecutionFailure(input: {
+    status: 'failed' | 'cancelled';
+    summary: string;
+}): ExecutionFailureDiagnosis;