@xopcai/xopc 0.0.227 → 0.0.229

package/dist/src/connectors/connected-source-understanding.js

@@ -6,7 +6,6 @@ import { upsertUserFocus } from "../user-context/sources/repository.js";
 import { claimRegisteredExtraction } from "../user-context/extraction/registry.js";
 import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources } from "../work-discovery/analyzer.js";
-import { createHash } from "node:crypto";
 //#region src/connectors/connected-source-understanding.ts
 const MAX_CONNECTED_ITEMS = 150;
 function normalizedValue(item) {
@@ -60,17 +59,14 @@ function connectedItemsForUnderstanding(items) {
 		}];
 	});
 }
-function understandingKind(category) {
-	if (category === "preference") return "preference";
-	if (category === "routine") return "routine";
-	return "project_context";
+function isConnectedPortraitCandidate(candidate) {
+	return candidate.category === "preference" || candidate.category === "routine";
 }
 function understandingCandidate(candidate) {
-	const normalized = candidate.statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
 	return {
-		kind: understandingKind(candidate.category),
+		kind: candidate.category,
 		content: candidate.statement,
-		canonicalKey: `connected-semantic:${candidate.category}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`,
+		canonicalKey: `understanding:${candidate.category}:${candidate.factKey}`,
 		confidence: candidate.confidence === "high" ? .9 : candidate.confidence === "medium" ? .72 : .55,
 		importance: .68,
 		explicitness: "inferred",
@@ -84,6 +80,18 @@ function hasLongVerbatimOverlap(value, sourceTexts, minimumLength = 32) {
 	if (normalized.length < minimumLength) return false;
 	return sourceTexts.some((source) => source.replace(/\s+/g, " ").includes(normalized));
 }
+function evidenceDate(item) {
+	const timestamp = item.occurredAt ?? item.modifiedAt;
+	return timestamp == null ? void 0 : new Date(timestamp).toISOString().slice(0, 10);
+}
+function durableConnectedEvidence(candidate, itemsByRef) {
+	if (candidate.confidence !== "high") return [];
+	const items = [...new Set(candidate.evidenceRefs ?? [])].flatMap((ref) => itemsByRef.get(ref) ?? []);
+	if (items.some((item) => item.ownerAttribution !== "user")) return [];
+	const required = candidate.category === "routine" ? 3 : 2;
+	const dates = new Set(items.map(evidenceDate).filter((value) => Boolean(value)));
+	return items.length >= required && dates.size >= required ? items : [];
+}
 async function deriveConnectedSourceUnderstanding(input) {
 	const knowledgeItems = listKnowledgeSourceItems({
 		agentId: input.agentId,
@@ -115,22 +123,28 @@ async function deriveConnectedSourceUnderstanding(input) {
 			items
 		});
 		const rawTexts = items.flatMap((item) => item.text ? [item.text] : []);
-		const profileCandidates = analysis.profileCandidates.filter((candidate) => !hasLongVerbatimOverlap(candidate.statement, rawTexts));
-		const sourceItemIds = [...new Set([...profileCandidates.flatMap((candidate) => candidate.evidenceRefs ?? []), ...analysis.workThreadCandidates.flatMap((candidate) => candidate.evidenceRefs)].map((ref) => ref.startsWith("knowledge-source://") ? ref.slice(19) : ""))].filter(Boolean).slice(0, 20);
-		const reviewed = profileCandidates.length ? await input.memoryManager.applyUnderstandingCandidates(profileCandidates.map(understandingCandidate), {
-			agentId: input.agentId,
-			sourceItemIds,
-			sourceText: "Bounded semantic synthesis from explicitly connected work sources.",
-			source: {
-				provider: "connected-sources",
-				sourceInstanceId: input.sourceInstanceId
-			},
-			reviewSource: "background",
-			extractionRunId: extraction.run.id
-		}) : {
+		const itemsByRef = new Map(items.map((item) => [item.evidenceRef, item]));
+		const profileCandidates = analysis.profileCandidates.filter(isConnectedPortraitCandidate).filter((candidate) => !hasLongVerbatimOverlap(candidate.statement, rawTexts) && durableConnectedEvidence(candidate, itemsByRef).length > 0);
+		const reviewed = {
 			created: 0,
 			writeOutputs: []
 		};
+		for (const candidate of profileCandidates) {
+			const evidenceItems = durableConnectedEvidence(candidate, itemsByRef);
+			const applied = await input.memoryManager.applyUnderstandingCandidates([understandingCandidate(candidate)], {
+				agentId: input.agentId,
+				sourceItemIds: evidenceItems.map((item) => item.id).slice(0, 20),
+				sourceText: "Bounded semantic synthesis from explicitly connected work sources.",
+				source: {
+					provider: "connected-sources",
+					sourceInstanceId: input.sourceInstanceId
+				},
+				reviewSource: "background",
+				extractionRunId: extraction.run.id
+			});
+			reviewed.created += applied.created;
+			reviewed.writeOutputs.push(...applied.writeOutputs ?? []);
+		}
 		const focuses = analysis.workThreadCandidates.filter((candidate) => !hasLongVerbatimOverlap(candidate.title, rawTexts) && !hasLongVerbatimOverlap(candidate.summary, rawTexts)).map((candidate) => upsertUserFocus({
 			canonicalKey: `connected-focus:${candidate.topicKey}`,
 			title: candidate.title,

package/dist/src/connectors/learning-coordinator.js

@@ -1,6 +1,5 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { finishContextExtractionRun } from "../storage/sqlite/context-extraction-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "../storage/sqlite/connector-learning-repository.js";
 import { getConnectorInstallation, listConnectorConnections, upsertConnectorConnection } from "../storage/sqlite/connector-repository.js";
 import { getConnectorAccount, reconcileConnectorAccount } from "../storage/sqlite/connector-account-repository.js";
@@ -11,10 +10,8 @@ import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { buildConnectorLearningArguments, getConnectorLearningPlan } from "./learning-recipes.js";
 import { getConnectorDefinition } from "./catalog.js";
 import { createUnderstandingSourceRun, getUnderstandingSourceGrant, listUnderstandingSourceRuns, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
-import { claimRegisteredExtraction } from "../user-context/extraction/registry.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
-import { ConnectedUnderstandingPipeline } from "../knowledge/connected-understanding-pipeline.js";
 import "../knowledge/index.js";
 import { ingestComposioConnectedSource } from "./connected-source-ingestion.js";
 import { deriveConnectedSourceUnderstanding } from "./connected-source-understanding.js";
@@ -210,44 +207,6 @@ function startConnectorLearningCoordinator(options) {
 			itemsIndexed
 		}));
 		publish(updateConnectorLearningJob(job.id, { phase: "deriving" }));
-		const structuralExtraction = claimRegisteredExtraction({
-			extractorId: "connector-structural",
-			sourceRef: `understanding-source-run:${sourceRun.id}`,
-			contentForHash: `${job.sourceInstanceId}:${itemsSeen}:${itemsIndexed}`,
-			processingPolicy: "local_only",
-			destination: "deterministic"
-		});
-		let understanding = {
-			proposed: 0,
-			created: 0,
-			deduplicated: 0,
-			rejected: 0,
-			createdRecords: [],
-			writeOutputs: []
-		};
-		if (structuralExtraction.shouldExecute) try {
-			understanding = await new ConnectedUnderstandingPipeline(options.getMemoryManager()).process(job.agentId, structuralExtraction.run.id);
-			finishContextExtractionRun({
-				runId: structuralExtraction.run.id,
-				status: "completed",
-				outputs: (understanding.writeOutputs ?? []).map((output) => ({
-					candidateKey: output.candidateKey,
-					...output.objectId ? {
-						objectType: "understanding",
-						objectId: output.objectId
-					} : {},
-					...output.versionId ? { versionId: output.versionId } : {},
-					outcome: output.outcome
-				}))
-			});
-		} catch (error) {
-			finishContextExtractionRun({
-				runId: structuralExtraction.run.id,
-				status: "failed",
-				errorCode: "extractor_failed"
-			});
-			throw error;
-		}
 		let semantic = {
 			created: 0,
 			focusCount: 0,
@@ -276,7 +235,7 @@ function startConnectorLearningCoordinator(options) {
 				connectorId: job.connectorId
 			}, `Connected source semantic analysis failed: ${errorMessage}`);
 		}
-		const candidatesCreated = understanding.created + semantic.created + semantic.focusCount;
+		const candidatesCreated = semantic.created + semantic.focusCount;
 		const incomplete = enrichmentErrors.length > 0 || semantic.status !== "completed";
 		const completed = updateConnectorLearningJob(job.id, {
 			status: "completed",

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

@@ -1,5 +1,5 @@
-import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
+import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } 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/chat-stream/mapper.d.ts

@@ -15,6 +15,7 @@ export declare class ChatStreamMapper {
     private currentAssistantMessageId;
     private lastAssistantMessageId;
     private currentAssistantText;
+    private lastAssistantText;
     private currentAssistantReviewEmitted;
     private toolCallToMessageId;
     private turnDiffs;
@@ -28,6 +29,7 @@ export declare class ChatStreamMapper {
     start(): ChatStreamEvent[];
     end(status: ChatStreamStatus, summary?: string): ChatStreamEvent[];
     error(message: string, code?: string): ChatStreamEvent[];
+    getLastAssistantText(): string;
     private mapMessageStart;
     private mapMessageUpdate;
     private mapAssistantSnapshot;

package/dist/src/gateway/chat-stream/mapper.js

@@ -14,6 +14,7 @@ var ChatStreamMapper = class {
 	currentAssistantMessageId;
 	lastAssistantMessageId;
 	currentAssistantText = "";
+	lastAssistantText = "";
 	currentAssistantReviewEmitted = false;
 	toolCallToMessageId = /* @__PURE__ */ new Map();
 	turnDiffs = [];
@@ -154,6 +155,9 @@ var ChatStreamMapper = class {
 			petFeedback: createPetFeedback("error", { recoverable: false })
 		})];
 	}
+	getLastAssistantText() {
+		return this.currentAssistantText || this.lastAssistantText;
+	}
 	mapMessageStart(raw) {
 		if (raw?.role !== "assistant") return [];
 		const messageId = this.nextAssistantMessageId();
@@ -260,6 +264,7 @@ var ChatStreamMapper = class {
 			presentation: hasToolCall(message) ? "narration" : "answer",
 			usage: extractUsage(message)
 		}));
+		if (this.currentAssistantText) this.lastAssistantText = this.currentAssistantText;
 		this.lastAssistantMessageId = messageId;
 		this.currentAssistantMessageId = void 0;
 		this.currentAssistantText = "";

package/dist/src/gateway/chat-stream/protocol.d.ts

@@ -1,4 +1,4 @@
-import type { ToolActivity } from '@xopcai/gateway-contract';
+import type { ToolActivity, TurnOutcome } from '@xopcai/gateway-contract';
 export type ChatStreamStatus = 'success' | 'error' | 'cancelled';
 export type PetFeedbackTaskState = 'working' | 'waiting' | 'success' | 'error';
 export type PetFeedbackSensitivity = 'public' | 'private';
@@ -142,6 +142,7 @@ export type TurnDiffEvent = ChatStreamEnvelope<'turn_diff', {
     added: number;
     removed: number;
 }>;
+export type TurnOutcomeEvent = ChatStreamEnvelope<'turn_outcome', TurnOutcome>;
 export type ReviewStartEvent = ChatStreamEnvelope<'review_start', {
     messageId: string;
     reviewId: string;
@@ -237,4 +238,4 @@ export type StreamErrorEvent = ChatStreamEnvelope<'error', {
     recoverable?: boolean;
     petFeedback: PetFeedback;
 }>;
-export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | CommandStartedEvent | CommandOutputDeltaEvent | CommandCompletedEvent | PatchAppliedEvent | TurnPlanUpdatedEvent | TaskPlanUpdatedEvent | TurnDiffEvent | ReviewStartEvent | ReviewDeltaEvent | ReviewEndEvent | ReviewEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | MemoryConsentRequiredEvent | MemoryCapturedEvent | MemoryCandidateEvent | RunEndEvent | StreamErrorEvent;
+export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | CommandStartedEvent | CommandOutputDeltaEvent | CommandCompletedEvent | PatchAppliedEvent | TurnPlanUpdatedEvent | TaskPlanUpdatedEvent | TurnDiffEvent | TurnOutcomeEvent | ReviewStartEvent | ReviewDeltaEvent | ReviewEndEvent | ReviewEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | MemoryConsentRequiredEvent | MemoryCapturedEvent | MemoryCandidateEvent | RunEndEvent | StreamErrorEvent;

package/dist/src/gateway/chat-stream/turn-outcome-collector.d.ts

@@ -0,0 +1,16 @@
+import type { AgentStreamRunStatus, TurnOutcome } from '@xopcai/gateway-contract';
+import type { ChatStreamEvent } from './protocol.js';
+export declare class TurnOutcomeCollector {
+    private readonly runId;
+    private readonly environment;
+    private readonly deliverables;
+    private readonly evidence;
+    private readonly files;
+    private readonly diffs;
+    private added;
+    private removed;
+    private failedToolCount;
+    constructor(runId: string, environment?: 'workspace' | 'worktree' | 'remote_runtime');
+    capture(event: ChatStreamEvent): void;
+    finalize(status: AgentStreamRunStatus, summary?: string): TurnOutcome;
+}

package/dist/src/gateway/chat-stream/turn-outcome-collector.js

@@ -0,0 +1,111 @@
+import { TurnOutcomeDeliverableSchema } from "../../../packages/gateway-contract/src/turn-outcome.js";
+//#region src/gateway/chat-stream/turn-outcome-collector.ts
+const VERIFICATION_COMMAND = /(^|[\s:/_-])(test|vitest|jest|pytest|lint|typecheck|type-check|build)([\s:/_-]|$)/i;
+const MAX_OUTCOME_DIFF_CHARS = 2e5;
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function optionalString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function fileStatus(kind) {
+	if (kind === "add") return "added";
+	if (kind === "delete") return "deleted";
+	if (kind === "move") return "renamed";
+	if (kind === "update") return "modified";
+}
+function changedFiles(changes) {
+	return changes.flatMap((value) => {
+		const row = asRecord(value);
+		const path = optionalString(row?.moveTo) ?? optionalString(row?.path);
+		if (!path) return [];
+		return [{
+			path,
+			...fileStatus(row?.kind) ? { status: fileStatus(row?.kind) } : {},
+			...typeof row?.added === "number" ? { added: Math.max(0, row.added) } : {},
+			...typeof row?.removed === "number" ? { removed: Math.max(0, row.removed) } : {}
+		}];
+	});
+}
+function structuredDeliverables(details) {
+	if (!Array.isArray(details.artifacts)) return [];
+	return details.artifacts.flatMap((value) => {
+		const parsed = TurnOutcomeDeliverableSchema.safeParse(value);
+		return parsed.success ? [parsed.data] : [];
+	});
+}
+var TurnOutcomeCollector = class {
+	deliverables = /* @__PURE__ */ new Map();
+	evidence = /* @__PURE__ */ new Map();
+	files = /* @__PURE__ */ new Map();
+	diffs = [];
+	added = 0;
+	removed = 0;
+	failedToolCount = 0;
+	constructor(runId, environment = "workspace") {
+		this.runId = runId;
+		this.environment = environment;
+	}
+	capture(event) {
+		if (event.type === "tool_end") {
+			if (event.payload.status !== "success") {
+				this.failedToolCount += 1;
+				return;
+			}
+			const details = asRecord(event.payload.result?.details);
+			if (!details) return;
+			for (const artifact of structuredDeliverables(details)) this.deliverables.set(artifact.artifactId, artifact);
+			return;
+		}
+		if (event.type === "patch_applied") {
+			for (const file of changedFiles(event.payload.changes)) this.files.set(file.path, file);
+			return;
+		}
+		if (event.type === "turn_diff") {
+			for (const path of event.payload.files) if (!this.files.has(path)) this.files.set(path, { path });
+			if (event.payload.diff.trim()) this.diffs.push(event.payload.diff);
+			this.added += Math.max(0, event.payload.added);
+			this.removed += Math.max(0, event.payload.removed);
+			return;
+		}
+		if (event.type === "command_completed" && VERIFICATION_COMMAND.test(event.payload.command)) {
+			const status = event.payload.exitCode === 0 && !event.payload.timedOut ? "passed" : "failed";
+			this.evidence.set(event.payload.toolCallId, {
+				evidenceId: `${this.runId}:${event.payload.toolCallId}:check`,
+				kind: "check",
+				label: event.payload.command,
+				status,
+				command: event.payload.command,
+				...event.payload.durationMs !== void 0 ? { durationMs: event.payload.durationMs } : {}
+			});
+		}
+	}
+	finalize(status, summary) {
+		const evidence = [...this.evidence.values()];
+		const partial = this.failedToolCount > 0 || evidence.some((item) => item.status === "failed");
+		const fullDiff = this.diffs.join("\n");
+		const diffTruncated = fullDiff.length > MAX_OUTCOME_DIFF_CHARS;
+		return {
+			version: 1,
+			outcomeId: `${this.runId}:outcome`,
+			runId: this.runId,
+			turnId: this.runId,
+			status: status === "error" ? "failed" : status === "cancelled" || partial ? "partial" : "succeeded",
+			...summary?.trim() ? { summary: summary.trim() } : {},
+			deliverables: [...this.deliverables.values()],
+			...this.files.size > 0 || this.diffs.length > 0 ? { changeSet: {
+				changeSetId: `${this.runId}:changes`,
+				files: [...this.files.values()],
+				added: this.added,
+				removed: this.removed,
+				diff: diffTruncated ? fullDiff.slice(0, MAX_OUTCOME_DIFF_CHARS) : fullDiff,
+				...diffTruncated ? { diffTruncated: true } : {},
+				environment: this.environment
+			} } : {},
+			evidence,
+			createdAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
+};
+//#endregion
+export { TurnOutcomeCollector };

package/dist/src/gateway/hono/lib/static-ui.js

@@ -52,7 +52,7 @@ function resolveCacheControl(relativePath) {
 function resolveContentType(relativePath) {
 	return MIME_TYPES[relativePath.split(".").pop()?.toLowerCase() || ""] || "application/octet-stream";
 }
-function loadIntoCache(relativePath) {
+function readStaticFile(relativePath, cache) {
 	const filePath = resolve(UI_STATIC_ROOT, relativePath);
 	try {
 		const content = readFileSync(filePath);
@@ -62,8 +62,10 @@ function loadIntoCache(relativePath) {
 			etag: computeEtag(content),
 			cacheControl: resolveCacheControl(relativePath)
 		};
-		fileCache.set(relativePath, cached);
-		stats.entries = fileCache.size;
+		if (cache) {
+			fileCache.set(relativePath, cached);
+			stats.entries = fileCache.size;
+		}
 		stats.misses += 1;
 		return cached;
 	} catch {
@@ -71,12 +73,13 @@ function loadIntoCache(relativePath) {
 	}
 }
 function getCachedFile(relativePath) {
+	if (relativePath === "index.html") return readStaticFile(relativePath, false);
 	const cached = fileCache.get(relativePath);
 	if (cached) {
 		stats.hits += 1;
 		return cached;
 	}
-	return loadIntoCache(relativePath);
+	return readStaticFile(relativePath, true);
 }
 function getStaticUiCacheStats() {
 	return { ...stats };
@@ -92,7 +95,6 @@ function resolveStaticUiRootForTests() {
 	return UI_STATIC_ROOT;
 }
 const DEFAULT_PREWARM_PATHS = [
-	"index.html",
 	"favicon.ico",
 	"logo.svg",
 	"logo-dark.svg"

package/dist/src/gateway/hono/routes/index.js

@@ -8,6 +8,7 @@ import { registerProjectsRoutes } from "./projects.js";
 import { registerProjectSkillRoutes } from "./project-skills.js";
 import { registerSearchRoutes } from "./search.js";
 import { registerMobileRoutes } from "./mobile.js";
+import { registerNotificationRoutes } from "./notifications.js";
 import { registerInteractionStateRoutes } from "./interaction-state.js";
 import { registerComposerHistoryRoutes } from "./composer-history.js";
 import { registerEndpointToolRoutes } from "./endpoint-tools.js";
@@ -35,6 +36,7 @@ function registerCoreAuthenticatedRoutes(authenticated, deps) {
 	registerProactiveRoutes(authenticated, deps);
 	registerSearchRoutes(authenticated, deps);
 	registerMobileRoutes(authenticated, deps);
+	registerNotificationRoutes(authenticated, deps);
 	registerInteractionStateRoutes(authenticated, deps);
 	registerComposerHistoryRoutes(authenticated, deps);
 	registerEndpointToolRoutes(authenticated, deps);

package/dist/src/gateway/hono/routes/mobile.js

@@ -1,4 +1,4 @@
-import { acknowledgeMobileActivityEvent, listMobileActivityEvents, registerMobileDevice, removeMobileDevice, updateMobileDevicePreferences } from "../../../mobile/notification-store.js";
+import { registerNotificationDevice, removeNotificationDevice, updateNotificationDevicePreferences } from "../../../notifications/device-store.js";
 //#region src/gateway/hono/routes/mobile.ts
 function stringField(value, maxLength) {
 	return typeof value === "string" && value.trim().length > 0 && value.trim().length <= maxLength ? value.trim() : null;
@@ -9,10 +9,15 @@ function parsePreferences(value) {
 	const source = value;
 	const result = {};
 	for (const key of [
-		"needsInput",
-		"failed",
-		"completed",
-		"automationFailed"
+		"chatCompleted",
+		"chatFailed",
+		"taskNeedsInput",
+		"taskBlocked",
+		"taskFailed",
+		"taskCompleted",
+		"automationCompleted",
+		"automationFailed",
+		"proactiveInsight"
 	]) {
 		if (source[key] === void 0) continue;
 		if (typeof source[key] !== "boolean") return null;
@@ -26,15 +31,8 @@ function parsePlatform(value) {
 function parsePermission(value) {
 	return value === "granted" || value === "denied" || value === "unknown" ? value : null;
 }
-function parseCursor(value) {
-	if (!value) return void 0;
-	const parsed = Number.parseInt(value, 10);
-	return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
-}
-function parseLimit(value) {
-	if (!value) return void 0;
-	const parsed = Number.parseInt(value, 10);
-	return Number.isFinite(parsed) ? Math.max(1, Math.min(100, parsed)) : void 0;
+function parseLocale(value) {
+	return value === "en" || value === "zh" ? value : null;
 }
 function registerMobileRoutes(authenticated, _deps) {
 	authenticated.post("/api/mobile/devices/register", async (c) => {
@@ -44,17 +42,19 @@ function registerMobileRoutes(authenticated, _deps) {
 		const platform = parsePlatform(body?.platform);
 		const permissions = parsePermission(body?.permissions);
 		const preferences = parsePreferences(body?.preferences);
+		const locale = parseLocale(body?.locale);
 		const appVersion = body?.appVersion === void 0 ? void 0 : stringField(body.appVersion, 128);
-		if (!id || !pushToken || !platform || !permissions || preferences === null || appVersion === null) return c.json({
+		if (!id || !pushToken || !platform || !permissions || !locale || preferences === null || appVersion === null) return c.json({
 			ok: false,
 			error: "Invalid mobile device registration"
 		}, 400);
-		const device = registerMobileDevice({
+		const device = registerNotificationDevice({
 			id,
 			pushToken,
 			platform,
 			permissions,
 			preferences,
+			locale,
 			appVersion
 		});
 		return c.json({
@@ -68,7 +68,7 @@ function registerMobileRoutes(authenticated, _deps) {
 			ok: false,
 			error: "Invalid notification preferences"
 		}, 400);
-		const device = updateMobileDevicePreferences(c.req.param("id"), preferences);
+		const device = updateNotificationDevicePreferences(c.req.param("id"), preferences);
 		if (!device) return c.json({
 			ok: false,
 			error: "Mobile device not found"
@@ -81,31 +81,9 @@ function registerMobileRoutes(authenticated, _deps) {
 	authenticated.delete("/api/mobile/devices/:id", (c) => {
 		return c.json({
 			ok: true,
-			removed: removeMobileDevice(c.req.param("id"))
-		});
-	});
-	authenticated.get("/api/mobile/activity", (c) => {
-		const result = listMobileActivityEvents({
-			cursor: parseCursor(c.req.query("cursor")),
-			limit: parseLimit(c.req.query("limit"))
-		});
-		return c.json({
-			ok: true,
-			...result
+			removed: removeNotificationDevice(c.req.param("id"))
 		});
 	});
-	authenticated.post("/api/mobile/activity/:id/ack", async (c) => {
-		const deviceId = stringField((await c.req.json().catch(() => null))?.deviceId, 160);
-		if (!deviceId) return c.json({
-			ok: false,
-			error: "deviceId is required"
-		}, 400);
-		if (!acknowledgeMobileActivityEvent(c.req.param("id"), deviceId)) return c.json({
-			ok: false,
-			error: "Activity event or mobile device not found"
-		}, 404);
-		return c.json({ ok: true });
-	});
 }
 //#endregion
 export { registerMobileRoutes };

package/dist/src/gateway/hono/routes/notifications.d.ts

@@ -0,0 +1,3 @@
+import type { Hono } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerNotificationRoutes(authenticated: Hono, _deps: AuthenticatedRouteDeps): void;

package/dist/src/gateway/hono/routes/notifications.js

@@ -0,0 +1,45 @@
+import { acknowledgeNotification, listNotificationEvents, notificationDeliveryMetrics } from "../../../notifications/store.js";
+//#region src/gateway/hono/routes/notifications.ts
+function integerQuery(value, min, max) {
+	if (!value) return void 0;
+	const parsed = Number.parseInt(value, 10);
+	return Number.isFinite(parsed) ? Math.max(min, Math.min(max, parsed)) : void 0;
+}
+function stringField(value, maxLength) {
+	return typeof value === "string" && value.trim().length > 0 && value.trim().length <= maxLength ? value.trim() : null;
+}
+function registerNotificationRoutes(authenticated, _deps) {
+	authenticated.get("/api/notifications", (c) => {
+		const result = listNotificationEvents({
+			afterId: c.req.query("after")?.trim() || void 0,
+			since: integerQuery(c.req.query("since"), 0, Number.MAX_SAFE_INTEGER),
+			limit: integerQuery(c.req.query("limit"), 1, 100)
+		});
+		return c.json({
+			ok: true,
+			...result
+		});
+	});
+	authenticated.post("/api/notifications/:id/ack", async (c) => {
+		const body = await c.req.json().catch(() => null);
+		const consumerId = stringField(body?.consumerId, 160);
+		const surface = body?.surface;
+		if (!consumerId || surface !== "web" && surface !== "electron" && surface !== "mobile") return c.json({
+			ok: false,
+			error: "Invalid notification acknowledgement"
+		}, 400);
+		if (!acknowledgeNotification(c.req.param("id"), consumerId, surface)) return c.json({
+			ok: false,
+			error: "Notification not found"
+		}, 404);
+		return c.json({ ok: true });
+	});
+	authenticated.get("/api/notifications/metrics", (c) => {
+		return c.json({
+			ok: true,
+			deliveries: notificationDeliveryMetrics()
+		});
+	});
+}
+//#endregion
+export { registerNotificationRoutes };

package/dist/src/gateway/hono/routes/sessions.js

@@ -60,6 +60,14 @@ function buildDirectSessionMetadata(params) {
 }
 function registerSessionsRoutes(authenticated, deps) {
 	const { service } = deps;
+	authenticated.get("/api/session-runs", (c) => {
+		const blocked = ensureGatewayReadyForSessions(c, service, "sessions.list");
+		if (blocked) return blocked;
+		return c.json({
+			ok: true,
+			payload: { runs: service.sessions.listActiveRuns() }
+		});
+	});
 	authenticated.get("/api/sidebar/chat-list", async (c) => {
 		const blocked = ensureGatewayReadyForSessions(c, service, "sessions.list");
 		if (blocked) return blocked;
@@ -648,6 +656,29 @@ function registerSessionsRoutes(authenticated, deps) {
 			}, 400);
 		}
 	});
+	authenticated.post("/api/sessions/:key/fork-at-turn", async (c) => {
+		const key = c.req.param("key");
+		const body = await c.req.json().catch(() => ({}));
+		const lastTurnId = typeof body.lastTurnId === "string" ? body.lastTurnId.trim() : "";
+		if (!lastTurnId) return c.json({
+			ok: false,
+			error: "lastTurnId is required"
+		}, 400);
+		try {
+			const result = await service.sessions.forkAtTurn(key, lastTurnId);
+			return c.json({
+				ok: true,
+				...result
+			}, 201);
+		} catch (err) {
+			const errorMessage = err instanceof Error ? err.message : String(err);
+			const status = errorMessage.startsWith("Session not found:") ? 404 : 409;
+			return c.json({
+				ok: false,
+				error: errorMessage
+			}, status);
+		}
+	});
 	authenticated.post("/api/sessions/:key/fork-row", async (c) => {
 		const key = c.req.param("key");
 		const body = await c.req.json().catch(() => ({}));

package/dist/src/gateway/hono/routes/tasks.js

@@ -1,6 +1,7 @@
 import { runSqliteWriteTransaction } from "../../../storage/sqlite/transaction.js";
 import { TaskRepository } from "../../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
+import { enqueueTaskChangedEvent } from "../../../tasks/task-change-events.js";
 import { TaskRunRepository } from "../../../tasks/task-run-repository.js";
 import { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.js";
 import { TaskPhaseSchema } from "../../../../packages/gateway-contract/src/task-lifecycle.js";
@@ -8,7 +9,6 @@ import { TaskBoardPositionRequestSchema, TaskCommandRequestSchema, TaskContextIn
 import { ProjectMonitoringUpdateSchema } from "../../../../packages/gateway-contract/src/project-monitoring.js";
 import { resolveProjectAgentId } from "../../../projects/project-agent.js";
 import { TaskContextRepository } from "../../../tasks/task-context-repository.js";
-import { enqueueTaskChangedEvent } from "../../../tasks/task-change-events.js";
 import { TaskDependencyError, TaskDependencyService } from "../../../tasks/task-dependency-service.js";
 import { TaskApplicationService } from "../../../tasks/task-application-service.js";
 import { ProjectMonitoringService } from "../../../tasks/project-monitoring-service.js";

package/dist/src/gateway/hono/routes/understanding-sources.js

@@ -67,7 +67,10 @@ function applySourceRevocationChoices(impact, options) {
 	} else updateUserFocus(id, { status: "paused" });
 	for (const id of impact.understandingIds) if (options.derived === "delete") {
 		if (deleteUnderstanding(id)) derivedDeleted += 1;
-	} else setUnderstandingStatus(id, "needs_review");
+	} else setUnderstandingStatus(id, "needs_review", {
+		actorType: "runtime",
+		source: "understanding-source-revoked"
+	});
 	if (options.derived === "delete" && impact.sourceInstanceId) derivedDeleted += deleteMemoryRecordsBySourceInstanceId(impact.sourceInstanceId);
 	const rawDeleted = options.raw === "delete" && impact.sourceInstanceId ? deleteKnowledgeSourceItems(impact.sourceInstanceId) : 0;
 	return {