@codemem/server 0.23.0 → 0.25.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { CODEMEM_CONFIG_ENV_OVERRIDES, DEFAULT_TIME_WINDOW_S, MemoryStore, VERSION, VERSION as VERSION$1, applyReplicationOps, buildBaseUrl, buildFilterClausesWithContext, buildRawEventEnvelopeFromHook, canonicalMemoryKind, cleanupNonces, coordinatorCreateInviteAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, coordinatorStatusSnapshot, createCoordinatorReciprocalApproval, ensureDeviceIdentity, extractReplicationOps, fingerprintPublicKey, fromJson, getCodememConfigPath, getCodememEnvOverrides, getSyncResetState, isSummaryLikeMemory, listCoordinatorJoinRequests, listObserverProviderOptions, loadMemorySnapshotPageForPeer, loadReplicationOpsForPeer, lookupCoordinatorPeers, mergeAddresses, parseStrictInteger, probeAvailableCredentials, readCodememConfigFile, readCoordinatorSyncConfig, recordNonce, requestJson, resolveDbPath, runSyncPass, schema, stripJsonComments, stripPrivateObj, stripTrailingCommas, verifySignature, writeCodememConfigFile } from "@codemem/core";
+import { CODEMEM_CONFIG_ENV_OVERRIDES, DEFAULT_TIME_WINDOW_S, MemoryStore, VERSION, VERSION as VERSION$1, applyReplicationOps, buildBaseUrl, buildFilterClausesWithContext, buildRawEventEnvelopeFromHook, canonicalMemoryKind, cleanupNonces, coordinatorCreateInviteAction, coordinatorImportInviteAction, coordinatorListBootstrapGrantsAction, coordinatorReviewJoinRequestAction, coordinatorRevokeBootstrapGrantAction, coordinatorStatusSnapshot, createCoordinatorReciprocalApproval, ensureDeviceIdentity, extractReplicationOps, fingerprintPublicKey, fromJson, getCodememConfigPath, getCodememEnvOverrides, getSyncResetState, isSummaryLikeMemory, listCoordinatorJoinRequests, listMaintenanceJobs, listObserverProviderOptions, loadMemorySnapshotPageForPeer, loadReplicationOpsForPeer, lookupCoordinatorPeers, mergeAddresses, parseStrictInteger, probeAvailableCredentials, readCodememConfigFile, readCoordinatorSyncConfig, recordNonce, requestJson, resolveDbPath, runSyncPass, schema, stripJsonComments, stripPrivateObj, stripTrailingCommas, verifySignature, writeCodememConfigFile } from "@codemem/core";
 import { serveStatic } from "@hono/node-server/serve-static";
 import { Hono } from "hono";
 import { createMiddleware } from "hono/factory";
@@ -193,6 +193,15 @@ var ALLOWED_KEYS = [
 	"observer_base_url",
 	"observer_provider",
 	"observer_model",
+	"observer_tier_routing_enabled",
+	"observer_simple_model",
+	"observer_simple_temperature",
+	"observer_rich_model",
+	"observer_rich_temperature",
+	"observer_rich_openai_use_responses",
+	"observer_rich_reasoning_effort",
+	"observer_rich_reasoning_summary",
+	"observer_rich_max_output_tokens",
 	"observer_runtime",
 	"observer_auth_source",
 	"observer_auth_file",
@@ -221,6 +230,8 @@ var DEFAULTS = {
 	claude_command: ["claude"],
 	observer_runtime: "api_http",
 	observer_auth_source: "auto",
+	observer_tier_routing_enabled: false,
+	observer_rich_openai_use_responses: false,
 	observer_auth_command: [],
 	observer_auth_timeout_ms: 1500,
 	observer_auth_cache_ttl_s: 300,
@@ -319,6 +330,13 @@ function parsePositiveInt(value, allowZero = false) {
 	if (allowZero) return parsed >= 0 ? parsed : null;
 	return parsed > 0 ? parsed : null;
 }
+function parseFiniteNumber(value, allowZero = true) {
+	if (typeof value === "boolean") return null;
+	const parsed = typeof value === "number" ? value : typeof value === "string" && value.trim().length > 0 ? Number(value.trim()) : NaN;
+	if (!Number.isFinite(parsed)) return null;
+	if (allowZero) return parsed >= 0 ? parsed : null;
+	return parsed > 0 ? parsed : null;
+}
 function asStringMap(value) {
 	if (value == null || typeof value !== "object" || Array.isArray(value)) return null;
 	const parsed = {};
@@ -388,13 +406,24 @@ function validateAndApplyUpdate(configData, key, value, providers) {
 		configData[key] = value;
 		return null;
 	}
-	if (key === "observer_base_url" || key === "observer_model" || key === "observer_auth_file" || key === "sync_host" || key === "sync_coordinator_url" || key === "sync_coordinator_group") {
+	if (key === "observer_tier_routing_enabled" || key === "observer_rich_openai_use_responses") {
+		if (typeof value !== "boolean") return `${key} must be boolean`;
+		configData[key] = value;
+		return null;
+	}
+	if (key === "observer_base_url" || key === "observer_model" || key === "observer_simple_model" || key === "observer_rich_model" || key === "observer_rich_reasoning_effort" || key === "observer_rich_reasoning_summary" || key === "observer_auth_file" || key === "sync_host" || key === "sync_coordinator_url" || key === "sync_coordinator_group") {
 		if (typeof value !== "string") return `${key} must be string`;
 		const trimmed = value.trim();
 		if (!trimmed) delete configData[key];
 		else configData[key] = trimmed;
 		return null;
 	}
+	if (key === "observer_simple_temperature" || key === "observer_rich_temperature") {
+		const parsed = parseFiniteNumber(value, true);
+		if (parsed == null) return `${key} must be non-negative number`;
+		configData[key] = parsed;
+		return null;
+	}
 	const allowZero = key === "observer_auth_cache_ttl_s";
 	const parsed = parsePositiveInt(value, allowZero);
 	if (parsed == null) return `${key} must be ${allowZero ? "non-negative int" : "int"}`;
@@ -770,6 +799,30 @@ function memoryRoutes(getStore) {
 			return c.json(pack);
 		}
 	});
+	app.post("/api/pack/trace", async (c) => {
+		const store = getStore();
+		const parsed = await c.req.json().catch(() => Symbol.for("invalid-json"));
+		if (parsed === Symbol.for("invalid-json")) return c.json({ error: "invalid json body" }, 400);
+		const body = parsed;
+		const context = typeof body?.context === "string" ? body.context.trim() : "";
+		if (!context) return c.json({ error: "context required" }, 400);
+		const limit = body?.limit == null ? 10 : typeof body.limit === "number" && Number.isInteger(body.limit) && body.limit >= 1 ? body.limit : null;
+		if (limit == null) return c.json({ error: "limit must be a positive int" }, 400);
+		let tokenBudget = null;
+		if (body?.token_budget != null) {
+			if (typeof body.token_budget !== "number" || !Number.isInteger(body.token_budget) || body.token_budget < 0) return c.json({ error: "token_budget must be int" }, 400);
+			tokenBudget = body.token_budget;
+		}
+		const project = typeof body?.project === "string" && body.project.trim() ? body.project : null;
+		if (body?.working_set_files != null && !Array.isArray(body.working_set_files)) return c.json({ error: "working_set_files must be an array of strings" }, 400);
+		if (Array.isArray(body?.working_set_files) && body.working_set_files.some((value) => typeof value !== "string")) return c.json({ error: "working_set_files must be an array of strings" }, 400);
+		const workingSetFiles = Array.isArray(body?.working_set_files) ? body.working_set_files : [];
+		const filters = {};
+		if (project) filters.project = project;
+		if (workingSetFiles.length > 0) filters.working_set_paths = workingSetFiles;
+		const trace = await store.buildMemoryPackTraceAsync(context, limit, tokenBudget, filters);
+		return c.json(trace);
+	});
 	app.get("/api/memory", (c) => {
 		const store = getStore();
 		{
@@ -1185,6 +1238,17 @@ function rawEventsRoutes(getStore, sweeper) {
 *
 * Ports Python's viewer_routes/stats.py.
 */
+function maintenanceJobSortKey(job) {
+	return [job.started_at ?? job.updated_at, job.kind];
+}
+function sortActiveMaintenanceJobs$1(jobs) {
+	return [...jobs].sort((a, b) => {
+		const [aTime, aKind] = maintenanceJobSortKey(a);
+		const [bTime, bKind] = maintenanceJobSortKey(b);
+		if (aTime !== bTime) return aTime.localeCompare(bTime);
+		return aKind.localeCompare(bKind);
+	});
+}
 /**
 * Create stats routes. The store factory is called per-request to get a
 * fresh connection (matching the Python viewer pattern).
@@ -1201,9 +1265,18 @@ function statsRoutes(getStore) {
 	};
 	app.get("/api/stats", (c) => {
 		const store = getStore();
+		const activeJobs = sortActiveMaintenanceJobs$1(listMaintenanceJobs(store.db).filter((job) => job.status === "pending" || job.status === "running" || job.status === "failed")).map((job) => ({
+			kind: job.kind,
+			title: job.title,
+			status: job.status,
+			message: job.message,
+			progress: job.progress,
+			error: job.error
+		}));
 		return c.json({
 			...store.stats(),
-			viewer_pid: process.pid
+			viewer_pid: process.pid,
+			maintenance_jobs: activeJobs
 		});
 	});
 	app.get("/api/runtime", (c) => {
@@ -1289,6 +1362,31 @@ var SYNC_STALE_AFTER_SECONDS = 600;
 var SYNC_PROTOCOL_VERSION = "2";
 var LEGACY_SYNC_ACTOR_DISPLAY_NAME = "Legacy synced peer";
 var LEGACY_SHARED_WORKSPACE_ID = "shared:legacy";
+function sortActiveMaintenanceJobs(jobs) {
+	return [...jobs].sort((a, b) => {
+		const aTime = a.started_at ?? a.updated_at;
+		const bTime = b.started_at ?? b.updated_at;
+		if (aTime !== bTime) return aTime.localeCompare(bTime);
+		return a.kind.localeCompare(b.kind);
+	});
+}
+function summarizeMaintenanceJobs(jobs, showDiagnostics) {
+	return sortActiveMaintenanceJobs(jobs.filter((job) => [
+		"pending",
+		"running",
+		"failed"
+	].includes(String(job.status ?? "")))).map((job) => ({
+		kind: job.kind,
+		title: job.title,
+		status: job.status,
+		progress: job.progress,
+		...showDiagnostics ? {
+			message: job.message,
+			error: job.error,
+			metadata: job.metadata
+		} : {}
+	}));
+}
 function syncKeysDir() {
 	return process.env.CODEMEM_KEYS_DIR?.trim() || void 0;
 }
@@ -2209,6 +2307,7 @@ function syncRoutes(getStore, getSyncRuntimeStatus) {
 			const latestAttemptError = String(attemptsItems[0]?.error || "").trim();
 			const statusBlock = {
 				...statusPayload,
+				background_maintenance: summarizeMaintenanceJobs(listMaintenanceJobs(store.db), showDiag),
 				peers: peersMap,
 				pending: 0,
 				sync: {},