@codemem/server 0.24.0 → 0.25.1

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";
@@ -799,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();
 		{
@@ -1214,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).
@@ -1230,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) => {
@@ -1318,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;
 }
@@ -2238,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: {},