@xopcai/xopc 0.0.188 → 0.0.190

package/dist/src/gateway/agent-run-relay.d.ts

@@ -1,19 +0,0 @@
-/**
- * Multicast buffer for a single web agent run so multiple HTTP SSE consumers can
- * attach through POST /api/agent/resume while one
- * background pump drains processDirectStreaming.
- */
-export type RelayEvent = {
-    type: string;
-} & Record<string, unknown>;
-export declare class AgentRunRelay {
-    private readonly maxEvents;
-    private runs;
-    constructor(maxEvents?: number);
-    ensureRun(runId: string, sessionKey: string): void;
-    getSessionKey(runId: string): string | undefined;
-    hasRun(runId: string): boolean;
-    publish(runId: string, event: RelayEvent): RelayEvent | undefined;
-    complete(runId: string): void;
-    subscribe(runId: string): AsyncGenerator<RelayEvent>;
-}

package/dist/src/gateway/agent-run-relay.js

@@ -1,169 +0,0 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
-//#region src/gateway/agent-run-relay.ts
-init_logger();
-const log = createLogger("Gateway:AgentRunRelay");
-const COMPLETE_TTL_MS = 5 * 6e4;
-const MAX_EVENTS = 8e3;
-const COMPACT_TO_RATIO = .75;
-const MAX_MERGED_DELTA_CHARS = 16 * 1024;
-const REPLAY_DELTA_TYPES = new Set([
-	"assistant_delta",
-	"thinking_delta",
-	"command_output_delta",
-	"review_delta"
-]);
-function eventSeq(event) {
-	return typeof event.seq === "number" ? event.seq : void 0;
-}
-function findEventAtOrAfter(events, seq) {
-	let low = 0;
-	let high = events.length;
-	while (low < high) {
-		const middle = low + Math.floor((high - low) / 2);
-		if ((eventSeq(events[middle]) ?? Number.MAX_SAFE_INTEGER) < seq) low = middle + 1;
-		else high = middle;
-	}
-	return events[low];
-}
-function recordValue(value) {
-	return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
-}
-function sameDeltaStream(left, right) {
-	if (left.type !== right.type || !REPLAY_DELTA_TYPES.has(left.type)) return false;
-	const leftPayload = recordValue(left.payload);
-	const rightPayload = recordValue(right.payload);
-	if (!leftPayload || !rightPayload) return false;
-	return [
-		"messageId",
-		"toolCallId",
-		"reviewId",
-		"stream"
-	].every((key) => leftPayload[key] === rightPayload[key]);
-}
-function mergeReplayDelta(events, event) {
-	const previous = events.at(-1);
-	if (!previous || !sameDeltaStream(previous, event)) return false;
-	const previousPayload = recordValue(previous.payload);
-	const payload = recordValue(event.payload);
-	const previousDelta = previousPayload?.delta;
-	const delta = payload?.delta;
-	if (typeof previousDelta !== "string" || typeof delta !== "string") return false;
-	if (previousDelta.length + delta.length > MAX_MERGED_DELTA_CHARS) return false;
-	events[events.length - 1] = {
-		...previous,
-		payload: {
-			...previousPayload,
-			delta: previousDelta + delta
-		}
-	};
-	return true;
-}
-function compactEvents(events, targetSize) {
-	let remaining = Math.max(0, events.length - targetSize);
-	const retained = [];
-	const removedByType = {};
-	for (const event of events) {
-		if (remaining > 0 && REPLAY_DELTA_TYPES.has(event.type)) {
-			remaining -= 1;
-			removedByType[event.type] = (removedByType[event.type] ?? 0) + 1;
-			continue;
-		}
-		retained.push(event);
-	}
-	if (remaining > 0) for (const event of retained.splice(0, remaining)) removedByType[event.type] = (removedByType[event.type] ?? 0) + 1;
-	return {
-		events: retained,
-		removedByType
-	};
-}
-var AgentRunRelay = class {
-	runs = /* @__PURE__ */ new Map();
-	constructor(maxEvents = MAX_EVENTS) {
-		this.maxEvents = maxEvents;
-		if (!Number.isInteger(maxEvents) || maxEvents < 2) throw new Error("AgentRunRelay maxEvents must be an integer greater than 1");
-	}
-	ensureRun(runId, sessionKey) {
-		if (this.runs.has(runId)) return;
-		this.runs.set(runId, {
-			sessionKey,
-			events: [],
-			nextSeq: 1,
-			done: false,
-			waiters: [],
-			subscriberCount: 0,
-			compactionWarned: false
-		});
-	}
-	getSessionKey(runId) {
-		return this.runs.get(runId)?.sessionKey;
-	}
-	hasRun(runId) {
-		return this.runs.has(runId);
-	}
-	publish(runId, event) {
-		const state = this.runs.get(runId);
-		if (!state) return void 0;
-		const relayed = {
-			...event,
-			runId,
-			seq: state.nextSeq++
-		};
-		const merged = state.subscriberCount === 0 && mergeReplayDelta(state.events, relayed);
-		if (!merged && state.events.length >= this.maxEvents) {
-			const targetSize = Math.max(1, Math.floor(this.maxEvents * COMPACT_TO_RATIO));
-			const compacted = compactEvents(state.events, targetSize);
-			state.events = compacted.events;
-			if (!state.compactionWarned) {
-				state.compactionWarned = true;
-				log.warn({
-					runId,
-					max: this.maxEvents,
-					retained: state.events.length,
-					removedByType: compacted.removedByType
-				}, "Relay replay buffer compacted; old delta events are no longer resumable");
-			}
-		}
-		if (!merged) state.events.push(relayed);
-		const waiters = state.waiters.splice(0);
-		for (const w of waiters) w();
-		return relayed;
-	}
-	complete(runId) {
-		const state = this.runs.get(runId);
-		if (!state) return;
-		state.done = true;
-		const waiters = state.waiters.splice(0);
-		for (const w of waiters) w();
-		if (state.cleanupTimer) clearTimeout(state.cleanupTimer);
-		state.cleanupTimer = setTimeout(() => {
-			this.runs.delete(runId);
-		}, COMPLETE_TTL_MS);
-	}
-	async *subscribe(runId) {
-		const state = this.runs.get(runId);
-		if (!state) throw new Error("UNKNOWN_RUN");
-		state.subscriberCount += 1;
-		try {
-			let nextSeq = eventSeq(state.events[0]) ?? state.nextSeq;
-			while (true) {
-				const earliestSeq = eventSeq(state.events[0]);
-				if (earliestSeq !== void 0 && nextSeq < earliestSeq) nextSeq = earliestSeq;
-				const available = findEventAtOrAfter(state.events, nextSeq);
-				if (available) {
-					nextSeq = (eventSeq(available) ?? nextSeq) + 1;
-					yield available;
-					continue;
-				}
-				if (state.done) break;
-				await new Promise((resolve) => {
-					state.waiters.push(resolve);
-				});
-			}
-		} finally {
-			state.subscriberCount -= 1;
-		}
-	}
-};
-//#endregion
-export { AgentRunRelay };

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

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

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

@@ -1,460 +0,0 @@
-import { LOCAL_USER_ID } from "../../../user-context/owner.js";
-import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, upsertMemoryRecord } from "../../../storage/sqlite/memory-records-repository.js";
-import { listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns } from "../../../storage/sqlite/knowledge-repository.js";
-import "../../../storage/sqlite/index.js";
-import { ResponseLanguageSchema, init_response_language } from "../../../i18n/response-language.js";
-import { UserContextConfigSchema, init_config } from "../../../user-context/config.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { discoverMemoryPlugins } from "../../../agent/memory/plugin-discovery.js";
-import { createMemoryManagerFromConfig } from "../../../agent/memory/create-memory-manager.js";
-import { resolveAdaptiveUnderstandingCadence } from "../../../agent/memory/understanding/quality.js";
-import { summarizeMemoryUseAudit } from "../../../user-context/memory-use-audit.js";
-//#region src/gateway/hono/routes/memory.ts
-init_agent_scope();
-init_config();
-init_response_language();
-const MEMORY_KINDS = new Set([
-	"user_profile",
-	"preference",
-	"boundary",
-	"relationship",
-	"project_context",
-	"commitment",
-	"routine",
-	"personal_logistics",
-	"open_question",
-	"milestone",
-	"current_state",
-	"user_note",
-	"workspace_fact",
-	"daily_note",
-	"session_summary",
-	"derived_insight",
-	"task_lesson",
-	"tool_preference",
-	"long_term_goal"
-]);
-const MEMORY_EXPLICITNESS = new Set([
-	"explicit",
-	"observed",
-	"inferred"
-]);
-const MEMORY_DURABILITY = new Set([
-	"ephemeral",
-	"durable",
-	"recurring"
-]);
-const MEMORY_DISCLOSURE_POLICIES = new Set([
-	"silent",
-	"referenceable",
-	"ask_before_reference"
-]);
-const MEMORY_STATUSES = new Set([
-	"candidate",
-	"active",
-	"needs_review",
-	"stale",
-	"archived",
-	"rejected"
-]);
-const MEMORY_SENSITIVITIES = new Set([
-	"normal",
-	"personal",
-	"secret",
-	"regulated"
-]);
-const KNOWLEDGE_SYNTHESIS_STATUSES = new Set([
-	"pending",
-	"processing",
-	"completed",
-	"failed",
-	"ignored"
-]);
-function parseLimit(raw, fallback = 100) {
-	const parsed = raw ? Number.parseInt(raw, 10) : fallback;
-	return Number.isFinite(parsed) ? Math.max(1, Math.min(500, parsed)) : fallback;
-}
-function parseFeedbackSummaryLimit(raw) {
-	const parsed = raw ? Number.parseInt(raw, 10) : 1e3;
-	return Number.isFinite(parsed) ? Math.max(1, Math.min(5e3, parsed)) : 1e3;
-}
-function parseWindowDays(raw) {
-	const parsed = raw ? Number.parseInt(raw, 10) : 30;
-	return Number.isFinite(parsed) ? Math.max(1, Math.min(365, parsed)) : 30;
-}
-function parseKind(raw) {
-	return typeof raw === "string" && MEMORY_KINDS.has(raw) ? raw : void 0;
-}
-function parseStatus(raw) {
-	return typeof raw === "string" && MEMORY_STATUSES.has(raw) ? raw : void 0;
-}
-function parseSensitivity(raw) {
-	return typeof raw === "string" && MEMORY_SENSITIVITIES.has(raw) ? raw : void 0;
-}
-function parseEnum(raw, allowed) {
-	return typeof raw === "string" && allowed.has(raw) ? raw : void 0;
-}
-function registerMemoryRoutes(authenticated, deps) {
-	authenticated.get("/api/you/providers", async (c) => {
-		const cfg = deps.service.currentConfig;
-		const plugins = await discoverMemoryPlugins(cfg);
-		return c.json({ providers: [{
-			id: "local",
-			displayName: "Local Knowledge Store",
-			available: true,
-			configured: true,
-			capabilities: {
-				search: true,
-				read: true,
-				write: true,
-				update: true,
-				delete: true,
-				keywordSearch: true,
-				semanticSearch: false,
-				hybridSearch: false,
-				citations: true,
-				sync: false,
-				local: true
-			}
-		}, ...plugins.map((plugin) => ({
-			id: plugin.manifest?.id ?? plugin.name,
-			displayName: plugin.manifest?.displayName ?? plugin.name,
-			available: plugin.available,
-			configured: false,
-			capabilities: plugin.manifest?.capabilities ?? {}
-		}))] });
-	});
-	authenticated.get("/api/you/config", (c) => {
-		const cfg = deps.service.currentConfig;
-		return c.json({ userContext: cfg.userContext });
-	});
-	authenticated.put("/api/you/config", deps.strictRateLimitMiddleware, async (c) => {
-		const cfg = deps.service.currentConfig;
-		const body = await c.req.json().catch(() => ({}));
-		const parsed = UserContextConfigSchema.safeParse(body);
-		if (!parsed.success) return c.json({ error: `userContext ${parsed.error.issues[0]?.message ?? "is invalid"}` }, 400);
-		const save = await deps.service.saveConfig({
-			...cfg,
-			userContext: parsed.data
-		});
-		if (!save.saved) return c.json({ error: save.error ?? "save failed" }, 500);
-		deps.service.refreshUserProfileContext();
-		return c.json({ userContext: deps.service.currentConfig.userContext });
-	});
-	authenticated.patch("/api/you/preferences", deps.strictRateLimitMiddleware, async (c) => {
-		const cfg = deps.service.currentConfig;
-		const body = await c.req.json().catch(() => ({}));
-		const responseLanguage = ResponseLanguageSchema.safeParse(body.responseLanguage);
-		if (!responseLanguage.success) return c.json({ error: "Invalid responseLanguage" }, 400);
-		const userContext = UserContextConfigSchema.parse({
-			...cfg.userContext,
-			preferences: { responseLanguage: responseLanguage.data }
-		});
-		const save = await deps.service.saveConfig({
-			...cfg,
-			userContext
-		});
-		if (!save.saved) return c.json({ error: save.error ?? "save failed" }, 500);
-		deps.service.refreshUserProfileContext();
-		return c.json({ preferences: userContext.preferences });
-	});
-	authenticated.get("/api/you/memories", (c) => {
-		if (c.req.query("agentId")) return c.json({ error: "agentId is not supported" }, 400);
-		const records = listMemoryRecords({
-			providerId: c.req.query("providerId") || void 0,
-			userId: LOCAL_USER_ID,
-			workspaceId: c.req.query("workspaceId") || void 0,
-			projectId: c.req.query("projectId") || void 0,
-			kind: parseKind(c.req.query("kind")),
-			status: parseStatus(c.req.query("status")),
-			limit: parseLimit(c.req.query("limit")),
-			offset: c.req.query("offset") ? Number.parseInt(c.req.query("offset"), 10) : 0
-		});
-		return c.json({ records });
-	});
-	authenticated.post("/api/you/memories/search", async (c) => {
-		const body = await c.req.json().catch(() => ({}));
-		const query = typeof body.query === "string" ? body.query.trim() : "";
-		if (!query) return c.json({ error: "Missing required field: query" }, 400);
-		if (Object.hasOwn(body, "agentId") || Object.hasOwn(body, "userId")) return c.json({ error: "agentId and userId are not accepted" }, 400);
-		const records = searchMemoryRecords({
-			query,
-			providerId: typeof body.providerId === "string" ? body.providerId : void 0,
-			userId: LOCAL_USER_ID,
-			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : void 0,
-			projectId: typeof body.projectId === "string" ? body.projectId : void 0,
-			kinds: Array.isArray(body.kinds) ? body.kinds.map(parseKind).filter((v) => Boolean(v)) : void 0,
-			statuses: Array.isArray(body.statuses) ? body.statuses.map(parseStatus).filter((v) => Boolean(v)) : void 0,
-			maxResults: typeof body.maxResults === "number" ? body.maxResults : void 0,
-			minScore: typeof body.minScore === "number" ? body.minScore : void 0
-		});
-		return c.json({ results: records });
-	});
-	authenticated.post("/api/you/memories", async (c) => {
-		const body = await c.req.json().catch(() => ({}));
-		const kind = parseKind(body.kind);
-		const content = typeof body.content === "string" ? body.content.trim() : "";
-		if (Object.hasOwn(body, "agentId") || Object.hasOwn(body, "userId")) return c.json({ error: "agentId and userId are not accepted" }, 400);
-		if (!kind || !content) return c.json({ error: "Missing required fields: kind, content" }, 400);
-		const record = upsertMemoryRecord({
-			id: typeof body.id === "string" && body.id.trim() ? body.id.trim() : void 0,
-			providerId: typeof body.providerId === "string" && body.providerId.trim() ? body.providerId.trim() : "local",
-			kind,
-			sourceAgentId: resolveDefaultAgentId(deps.service.currentConfig),
-			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : deps.service.currentWorkspacePath,
-			sessionKey: typeof body.sessionKey === "string" ? body.sessionKey : void 0,
-			projectId: typeof body.projectId === "string" ? body.projectId : void 0,
-			content,
-			source: body.source && typeof body.source === "object" ? body.source : void 0,
-			confidence: typeof body.confidence === "number" ? body.confidence : void 0,
-			tags: Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string") : void 0,
-			status: parseStatus(body.status),
-			sensitivity: parseSensitivity(body.sensitivity),
-			canonicalKey: typeof body.canonicalKey === "string" ? body.canonicalKey : void 0,
-			explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS),
-			durability: parseEnum(body.durability, MEMORY_DURABILITY),
-			importance: typeof body.importance === "number" ? body.importance : void 0,
-			disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES),
-			evidence: Array.isArray(body.evidence) ? body.evidence.filter((item) => Boolean(item) && typeof item === "object") : void 0,
-			reviewAfter: typeof body.reviewAfter === "string" ? body.reviewAfter : void 0,
-			expiresAt: typeof body.expiresAt === "string" ? body.expiresAt : void 0,
-			validFrom: typeof body.validFrom === "string" ? body.validFrom : void 0,
-			validTo: typeof body.validTo === "string" ? body.validTo : void 0,
-			supersedesRecordId: typeof body.supersedesRecordId === "string" ? body.supersedesRecordId : void 0,
-			conflictGroupId: typeof body.conflictGroupId === "string" ? body.conflictGroupId : void 0
-		});
-		return c.json({ record }, 201);
-	});
-	authenticated.put("/api/you/memories/:id", async (c) => {
-		const existing = getMemoryRecord(c.req.param("id"));
-		if (!existing) return c.json({ error: "Memory record not found" }, 404);
-		if (c.req.query("agentId")) return c.json({ error: "agentId is not supported" }, 400);
-		const body = await c.req.json().catch(() => ({}));
-		const record = upsertMemoryRecord({
-			id: existing.id,
-			providerId: existing.source.provider ?? "local",
-			kind: parseKind(body.kind) ?? existing.kind,
-			sourceAgentId: existing.provenance.sourceAgentId,
-			workspaceId: existing.scope.workspaceId,
-			sessionKey: existing.scope.sessionKey,
-			projectId: typeof body.projectId === "string" ? body.projectId : existing.scope.projectId,
-			content: typeof body.content === "string" ? body.content : existing.content,
-			source: body.source && typeof body.source === "object" ? body.source : existing.source,
-			confidence: typeof body.confidence === "number" ? body.confidence : existing.confidence,
-			tags: Array.isArray(body.tags) ? body.tags.filter((tag) => typeof tag === "string") : existing.tags,
-			status: parseStatus(body.status) ?? existing.status,
-			sensitivity: parseSensitivity(body.sensitivity) ?? existing.sensitivity,
-			canonicalKey: typeof body.canonicalKey === "string" ? body.canonicalKey : existing.canonicalKey,
-			explicitness: parseEnum(body.explicitness, MEMORY_EXPLICITNESS) ?? existing.explicitness,
-			durability: parseEnum(body.durability, MEMORY_DURABILITY) ?? existing.durability,
-			importance: typeof body.importance === "number" ? body.importance : existing.importance,
-			disclosurePolicy: parseEnum(body.disclosurePolicy, MEMORY_DISCLOSURE_POLICIES) ?? existing.disclosurePolicy,
-			evidence: Array.isArray(body.evidence) ? body.evidence.filter((item) => Boolean(item) && typeof item === "object") : existing.evidence,
-			reviewAfter: typeof body.reviewAfter === "string" ? body.reviewAfter : existing.reviewAfter,
-			expiresAt: typeof body.expiresAt === "string" ? body.expiresAt : existing.expiresAt,
-			validFrom: typeof body.validFrom === "string" ? body.validFrom : existing.validFrom,
-			validTo: typeof body.validTo === "string" ? body.validTo : existing.validTo,
-			supersedesRecordId: typeof body.supersedesRecordId === "string" ? body.supersedesRecordId : existing.supersedesRecordId,
-			conflictGroupId: typeof body.conflictGroupId === "string" ? body.conflictGroupId : existing.conflictGroupId
-		});
-		return c.json({ record });
-	});
-	authenticated.delete("/api/you/memories/:id", (c) => {
-		const existing = getMemoryRecord(c.req.param("id"));
-		if (c.req.query("agentId")) return c.json({ error: "agentId is not supported" }, 400);
-		if (!existing || existing.scope.userId !== "local-owner") return c.json({ error: "Memory record not found" }, 404);
-		if (!deleteMemoryRecord(c.req.param("id"))) return c.json({ error: "Memory record not found" }, 404);
-		return c.json({ ok: true });
-	});
-	authenticated.get("/api/you/signals", (c) => {
-		if (c.req.query("agentId")) return c.json({ error: "agentId is not supported" }, 400);
-		const signals = listMemorySignals({
-			recordId: c.req.query("recordId") || void 0,
-			providerId: c.req.query("providerId") || void 0,
-			userId: LOCAL_USER_ID,
-			workspaceId: c.req.query("workspaceId") || void 0,
-			limit: parseLimit(c.req.query("limit"))
-		});
-		return c.json({ signals });
-	});
-	authenticated.get("/api/knowledge/source-items", (c) => {
-		const sourceItems = listKnowledgeSourceItems({
-			sourceInstanceId: c.req.query("sourceInstanceId") || void 0,
-			synthesisStatus: parseEnum(c.req.query("synthesisStatus"), KNOWLEDGE_SYNTHESIS_STATUSES),
-			includeDeleted: c.req.query("includeDeleted") === "true",
-			limit: parseLimit(c.req.query("limit")),
-			offset: c.req.query("offset") ? Number.parseInt(c.req.query("offset"), 10) : 0
-		});
-		return c.json({ sourceItems });
-	});
-	authenticated.get("/api/knowledge/source-changes", (c) => {
-		const afterSequenceQuery = c.req.query("afterSequence");
-		const afterSequence = afterSequenceQuery ? Number.parseInt(afterSequenceQuery, 10) : void 0;
-		const sourceChanges = listKnowledgeSourceChanges({
-			sourceInstanceId: c.req.query("sourceInstanceId") || void 0,
-			afterSequence: Number.isFinite(afterSequence) ? afterSequence : void 0,
-			limit: parseLimit(c.req.query("limit"))
-		});
-		return c.json({ sourceChanges });
-	});
-	authenticated.get("/api/knowledge/sync-runs", (c) => {
-		const syncRuns = listKnowledgeSyncRuns({
-			sourceInstanceId: c.req.query("sourceInstanceId") || void 0,
-			limit: parseLimit(c.req.query("limit"))
-		});
-		return c.json({ syncRuns });
-	});
-	authenticated.get("/api/you/traces", (c) => {
-		const traces = listMemoryTraceEvents({
-			providerId: c.req.query("providerId") || void 0,
-			sessionKey: c.req.query("sessionKey") || void 0,
-			phase: c.req.query("phase") || void 0,
-			limit: parseLimit(c.req.query("limit"))
-		});
-		return c.json({ traces });
-	});
-	authenticated.get("/api/you/memory-use-audit", (c) => {
-		const traces = listMemoryTraceEvents({
-			sessionKey: c.req.query("sessionKey") || void 0,
-			limit: parseLimit(c.req.query("limit"))
-		});
-		return c.json({ audit: summarizeMemoryUseAudit(traces) });
-	});
-	authenticated.get("/api/you/feedback-summary", (c) => {
-		const summaries = summarizeMemoryRecallFeedback({
-			recordId: c.req.query("recordId") || void 0,
-			providerId: c.req.query("providerId") || void 0,
-			sessionKey: c.req.query("sessionKey") || void 0,
-			limit: parseFeedbackSummaryLimit(c.req.query("limit"))
-		});
-		return c.json({ summaries });
-	});
-	authenticated.get("/api/you/quality", (c) => {
-		const cfg = deps.service.currentConfig;
-		const metrics = summarizeUserUnderstandingQuality({ windowDays: parseWindowDays(c.req.query("windowDays")) });
-		const baseIntervalTurns = cfg.userContext.understanding.reviewIntervalTurns;
-		const cadence = resolveAdaptiveUnderstandingCadence(baseIntervalTurns, metrics, cfg.userContext.understanding.adaptiveCadence);
-		return c.json({
-			metrics,
-			cadence
-		});
-	});
-	authenticated.post("/api/you/signals", async (c) => {
-		const body = await c.req.json().catch(() => ({}));
-		const source = typeof body.source === "string" ? body.source : "";
-		if (!source) return c.json({ error: "Missing required field: source" }, 400);
-		const signalId = appendMemorySignal({
-			providerId: typeof body.providerId === "string" ? body.providerId : void 0,
-			sourceAgentId: resolveDefaultAgentId(deps.service.currentConfig),
-			workspaceId: typeof body.workspaceId === "string" ? body.workspaceId : void 0,
-			sessionKey: typeof body.sessionKey === "string" ? body.sessionKey : void 0,
-			signal: {
-				source,
-				recordId: typeof body.recordId === "string" ? body.recordId : void 0,
-				score: typeof body.score === "number" ? body.score : void 0,
-				content: typeof body.content === "string" ? body.content : void 0,
-				metadata: body.metadata && typeof body.metadata === "object" ? body.metadata : void 0
-			}
-		});
-		return c.json({ signalId }, 201);
-	});
-	authenticated.post("/api/you/providers/:id/test", deps.strictRateLimitMiddleware, async (c) => {
-		const providerId = c.req.param("id");
-		const cfg = deps.service.currentConfig;
-		const workspace = deps.service.currentWorkspacePath;
-		const manager = createMemoryManagerFromConfig(cfg);
-		await manager.initializeAll(`memory-provider-test-${Date.now()}`, {
-			workspace,
-			agentId: resolveDefaultAgentId(cfg)
-		});
-		const provider = manager.providersList.find((p) => p.id === providerId);
-		if (!provider) return c.json({
-			providerId,
-			available: false,
-			checks: [{
-				name: "load",
-				ok: false,
-				message: "Provider not loaded"
-			}]
-		}, 404);
-		const token = `xopc-memory-smoke-${Date.now()}`;
-		const checks = [{
-			name: "load",
-			ok: true
-		}, {
-			name: "available",
-			ok: provider.isAvailable()
-		}];
-		const started = Date.now();
-		try {
-			const write = await manager.write({
-				kind: "workspace_fact",
-				content: `Smoke test record for ${providerId}: ${token}`,
-				scope: { userId: LOCAL_USER_ID },
-				tags: ["xopc-smoke-test"]
-			});
-			checks.push({
-				name: "write",
-				ok: write.success,
-				message: write.error ?? write.message
-			});
-			const ownResults = (await manager.search({
-				query: token,
-				scope: { userId: LOCAL_USER_ID },
-				maxResults: 10
-			})).filter((result) => result.citation.providerId === providerId);
-			checks.push({
-				name: "search",
-				ok: ownResults.length > 0,
-				resultCount: ownResults.length
-			});
-			const recordId = ownResults[0]?.record.id ?? write.record?.id;
-			if (recordId) {
-				const read = await manager.read({
-					id: recordId,
-					scope: { userId: LOCAL_USER_ID }
-				});
-				checks.push({
-					name: "read",
-					ok: Boolean(read),
-					message: read ? void 0 : "Record was not readable"
-				});
-			} else checks.push({
-				name: "read",
-				ok: false,
-				message: "No record id available"
-			});
-			manager.recordSignal({
-				source: "search_recall",
-				content: `Smoke signal for ${providerId}: ${token}`
-			});
-			checks.push({
-				name: "sync",
-				ok: true
-			});
-		} catch (err) {
-			checks.push({
-				name: "error",
-				ok: false,
-				message: err instanceof Error ? err.message : String(err)
-			});
-		} finally {
-			appendMemoryTraceEvent({
-				phase: "test",
-				providerId,
-				request: { token },
-				resultCount: checks.filter((check) => check.ok).length,
-				error: checks.some((check) => !check.ok) ? "one or more checks failed" : void 0,
-				durationMs: Date.now() - started
-			});
-			await manager.shutdownAll();
-		}
-		return c.json({
-			providerId,
-			available: provider.isAvailable(),
-			checks
-		});
-	});
-}
-//#endregion
-export { registerMemoryRoutes };