@xopcai/xopc 0.0.277 → 0.0.282

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

@@ -1,6 +1,6 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
+import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { seedAgentProfileMarkdownFiles } from "../agent/context/workspace-seed.js";

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

@@ -442,9 +442,9 @@ function userMessageDisplayMetadata(value) {
 	if (!Array.isArray(rows)) return void 0;
 	const sourceContexts = rows.flatMap((value) => {
 		const row = asRecord(value);
-		if (row?.kind !== "note" || typeof row.sourceId !== "string" || typeof row.version !== "string" || typeof row.title !== "string") return [];
+		if (row?.kind !== "note" && row?.kind !== "task" || typeof row.sourceId !== "string" || typeof row.version !== "string" || typeof row.title !== "string") return [];
 		return [{
-			kind: "note",
+			kind: row.kind,
 			sourceId: row.sourceId,
 			version: row.version,
 			title: row.title,

package/dist/src/gateway/file-path-classifier.js

@@ -1,7 +1,7 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { isBareProfileMarkdownFileName, resolveProfileMarkdownPathIfBareName } from "../agent/tools/tool-paths.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { basename, isAbsolute, resolve } from "node:path";

package/dist/src/gateway/hono/app.js

@@ -180,8 +180,9 @@ function createHonoApp(config) {
 	};
 	const isFileUploadRequest = (path, method, contentType) => method === "POST" && /^\/api\/files\/spaces\/[^/]+\/upload$/.test(path) && contentType?.includes("multipart/form-data") === true;
 	const discussionUploadBodyMax = (path, method, contentType) => {
-		if (method !== "PUT" || contentType?.includes("multipart/form-data") !== true) return void 0;
-		if (/^\/api\/discussions\/[^/]+\/recording$/.test(path)) return NOTE_MEDIA_BODY_MAX;
+		if (method !== "PUT") return void 0;
+		if (/^\/api\/discussions\/[^/]+\/recording\/chunks\/\d+$/.test(path)) return 8 * 1024 * 1024;
+		if (contentType?.includes("multipart/form-data") !== true) return void 0;
 		if (/^\/api\/discussions\/[^/]+\/segments\/\d+$/.test(path)) return 2 * 1024 * 1024;
 	};
 	app.use("/api/skills/upload", bodyLimit({

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -105,6 +105,7 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                     mode: "docker";
                     image: string;
                     network: boolean;
+                    workspaceAccess: "read-only" | "read-write";
                 };
                 maxTurns?: number;
                 timeoutMs?: number;

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,9 +1,9 @@
 import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserModelConfigSchema, init_config } from "../../../user-context/config.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
-import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, getChannelSetupStatus, init_channel_catalog_service } from "../../../channels/catalog/channel-catalog-service.js";
 import { init_models_json, loadModelsJson } from "../../../config/models-json.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
+import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, getChannelSetupStatus, init_channel_catalog_service } from "../../../channels/catalog/channel-catalog-service.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { getAllProviders, init_providers, isProviderConfigured } from "../../../providers/index.js";
 import { normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";

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

@@ -20,6 +20,7 @@ function resolveUiStaticRoot() {
 const UI_STATIC_ROOT = resolveUiStaticRoot();
 const MIME_TYPES = {
 	js: "application/javascript",
+	mjs: "application/javascript",
 	css: "text/css",
 	json: "application/json",
 	html: "text/html",

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

@@ -7,7 +7,6 @@ import { setAssertionStatus } from "../../../user-model/repository.js";
 import "../../../user-model/index.js";
 import { listConnectedContentCandidates, readConnectedContent } from "../../../connectors/content-enrichment.js";
 import { getUnderstandingSourceGrant, listUnderstandingSourceGrants, listUnderstandingSourceRuns, revokeUnderstandingSourceGrant, updateUnderstandingSourceGrantPolicies } from "../../../user-context/sources/repository.js";
-import { getWorkDiscoveryService } from "./work-discovery.js";
 import { listUnderstandingSourceDefinitions } from "../../../user-context/sources/catalog.js";
 import { randomUUID } from "node:crypto";
 //#region src/gateway/hono/routes/context-sources.ts
@@ -38,7 +37,7 @@ function markContextSourceAssertionsForReview(grantId) {
 	return ids.length;
 }
 function registerContextSourceRoutes(authenticated, deps) {
-	const service = getWorkDiscoveryService(deps);
+	const service = deps.service.workDiscovery;
 	const limited = deps.strictRateLimitMiddleware;
 	authenticated.get("/api/context-sources/catalog", (c) => {
 		const requested = c.req.query("platform");

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

@@ -1,6 +1,14 @@
-import { DISCUSSION_STATUSES } from "../../../discussions/types.js";
-import { DiscussionServiceError } from "../../../discussions/service.js";
+import { DISCUSSION_STATUSES } from "../../../../packages/gateway-contract/src/discussions.js";
+import { hasGatewayScope } from "../../security/gateway-scopes.js";
+import { DiscussionServiceError } from "../../../discussions/errors.js";
+import { convertMeetingAction, meetingActionTasks } from "../../../discussions/action-tasks.js";
+import { MeetingEditSchema } from "../../../discussions/edits.js";
+import { exportDiscussion } from "../../../discussions/export.js";
 import "../../../discussions/index.js";
+import { getGatewayPrincipal } from "../../security/gateway-principal.js";
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+import { Readable } from "node:stream";
 //#region src/gateway/hono/routes/discussions.ts
 function errorResponse(error) {
 	if (!(error instanceof DiscussionServiceError)) return null;
@@ -42,7 +50,8 @@ function registerDiscussionRoutes(authenticated, deps) {
 				clientRequestId: typeof body.clientRequestId === "string" ? body.clientRequestId : "",
 				...typeof body.contextProjectId === "string" && body.contextProjectId.trim() ? { contextProjectId: body.contextProjectId.trim() } : {},
 				consentPolicyVersion: Number(body.consentPolicyVersion),
-				source: body.source === "electron" ? "electron" : "web"
+				source: body.source === "mobile" ? "mobile" : body.source === "electron" ? "electron" : "web",
+				...body.recordedAt !== void 0 ? { recordedAt: typeof body.recordedAt === "number" ? body.recordedAt : NaN } : {}
 			});
 			return c.json(detail, 201);
 		} catch (error) {
@@ -74,7 +83,7 @@ function registerDiscussionRoutes(authenticated, deps) {
 		return detail ? c.json(detail) : c.json({ error: "Discussion not found" }, 404);
 	});
 	authenticated.get("/api/discussions/:id/transcript", (c) => {
-		const transcript = service.discussions.transcript(c.req.param("id"));
+		const transcript = service.discussions.transcript(c.req.param("id"), c.req.query("revision") === void 0 ? void 0 : Number(c.req.query("revision")));
 		return transcript ? c.json(transcript) : c.json({ error: "Discussion not found" }, 404);
 	});
 	authenticated.put("/api/discussions/:id/segments/:sequence", mediaRateLimitMiddleware, async (c) => {
@@ -107,36 +116,134 @@ function registerDiscussionRoutes(authenticated, deps) {
 	authenticated.patch("/api/discussions/:id/segments/:sequence", strictRateLimitMiddleware, async (c) => {
 		const body = await c.req.json().catch(() => ({}));
 		try {
-			return c.json(service.discussions.correctSegment(c.req.param("id"), Number.parseInt(c.req.param("sequence"), 10), typeof body.displayText === "string" ? body.displayText : "", Number(body.expectedRevision)));
+			return c.json(service.discussions.correctSegment(c.req.param("id"), Number.parseInt(c.req.param("sequence"), 10), typeof body.displayText === "string" ? body.displayText : "", Number(body.expectedRevision), typeof body.speakerLabel === "string" ? body.speakerLabel : void 0, body.applyToSpeakerGroup === true, typeof body.expectedTranscriptRevision === "number" ? body.expectedTranscriptRevision : void 0));
 		} catch (error) {
 			const response = errorResponse(error);
 			if (response) return c.json(response.body, response.status);
 			throw error;
 		}
 	});
-	authenticated.put("/api/discussions/:id/recording", strictRateLimitMiddleware, async (c) => {
-		const body = await multipart(c);
-		if (!body) return c.json({ error: "Invalid multipart body" }, 400);
-		const file = body.file;
-		if (!(file instanceof File)) return c.json({ error: "Missing file field" }, 400);
+	authenticated.post("/api/discussions/:id/organize", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		try {
+			return c.json(await service.discussions.reorganize(c.req.param("id"), typeof body.template === "string" ? body.template : "general"), 202);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.patch("/api/discussions/:id/summary", strictRateLimitMiddleware, async (c) => {
+		const parsed = MeetingEditSchema.safeParse(await c.req.json().catch(() => null));
+		if (!parsed.success) return c.json({ error: "Invalid meeting edit" }, 400);
 		try {
-			const detail = await service.discussions.uploadRecording(c.req.param("id"), {
-				name: file.name,
-				buffer: Buffer.from(await file.arrayBuffer()),
-				mimeType: file.type
-			}, Number(body.durationMs));
-			return detail ? c.json(detail, 201) : c.json({ error: "Discussion not found" }, 404);
+			return c.json(service.discussions.editSummary(c.req.param("id"), parsed.data));
 		} catch (error) {
 			const response = errorResponse(error);
 			if (response) return c.json(response.body, response.status);
 			throw error;
 		}
 	});
-	authenticated.post("/api/discussions/:id/stop", strictRateLimitMiddleware, async (c) => {
+	authenticated.get("/api/discussions/:id/actions", async (c) => {
+		if (!await service.discussions.get(c.req.param("id"))) return c.json({ error: "Discussion not found" }, 404);
+		return c.json(meetingActionTasks(c.req.param("id")));
+	});
+	authenticated.post("/api/discussions/:id/actions/:actionId/convert", strictRateLimitMiddleware, async (c) => {
+		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "tasks.write")) return c.json({ error: "Task write permission required" }, 403);
 		const body = await c.req.json().catch(() => ({}));
 		try {
-			const detail = await service.discussions.stop(c.req.param("id"), Number(body.lastSequence), Number(body.durationMs));
-			return detail ? c.json(detail) : c.json({ error: "Discussion not found" }, 404);
+			return c.json(convertMeetingAction(c.req.param("id"), c.req.param("actionId"), Number(body.organizationRevision)));
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.get("/api/discussions/:id/export", async (c) => {
+		const detail = await service.discussions.get(c.req.param("id"));
+		if (!detail) return c.json({ error: "Discussion not found" }, 404);
+		const format = c.req.query("format") ?? "md";
+		try {
+			const text = exportDiscussion(detail, format);
+			c.header("Content-Disposition", `attachment; filename="meeting.${format}"`);
+			c.header("Cache-Control", "no-store");
+			return c.text(text);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.get("/api/discussions/:id/audio", async (c) => {
+		const detail = await service.discussions.get(c.req.param("id"));
+		if (!detail?.discussion.audioAttachmentId || detail.discussion.audioDeletedAt) return c.json({ error: "Recording unavailable" }, 404);
+		const attachment = await service.notesServiceInstance.getAttachmentPath(detail.note.id, detail.discussion.audioAttachmentId);
+		if (!attachment) return c.json({ error: "Recording unavailable" }, 404);
+		const info = await stat(attachment.filePath).catch(() => null);
+		if (!info) return c.json({ error: "Recording unavailable" }, 404);
+		let start = 0;
+		let end = info.size - 1;
+		const range = c.req.header("range");
+		if (range) {
+			const match = /^bytes=(\d*)-(\d*)$/.exec(range);
+			if (!match || !match[1] && !match[2]) return c.body(null, 416, { "Content-Range": `bytes */${info.size}` });
+			if (!match[1]) start = Math.max(0, info.size - Number(match[2]));
+			else {
+				start = Number(match[1]);
+				if (match[2]) end = Math.min(end, Number(match[2]));
+			}
+			if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start > end || start >= info.size) return c.body(null, 416, { "Content-Range": `bytes */${info.size}` });
+			c.header("Content-Range", `bytes ${start}-${end}/${info.size}`);
+		}
+		c.header("Content-Type", attachment.mimeType);
+		c.header("Accept-Ranges", "bytes");
+		c.header("Content-Length", String(end - start + 1));
+		c.header("Cache-Control", "no-store");
+		return c.body(Readable.toWeb(createReadStream(attachment.filePath, {
+			start,
+			end
+		})), range ? 206 : 200);
+	});
+	authenticated.get("/api/discussions/:id/recording/chunks", (c) => {
+		try {
+			return c.json(service.discussions.recordingChunks(c.req.param("id")));
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.put("/api/discussions/:id/recording/chunks/:sequence", mediaRateLimitMiddleware, async (c) => {
+		if (!c.req.raw.body) return c.json({ error: "Missing audio body" }, 400);
+		try {
+			return c.json(await service.discussions.uploadRecordingChunk(c.req.param("id"), Number(c.req.param("sequence")), c.req.header("x-audio-sha256") ?? "", c.req.raw.body), 201);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.get("/api/discussions/:id/recording/job", (c) => {
+		try {
+			const job = service.discussions.recordingJob(c.req.param("id"));
+			return job ? c.json(job) : c.json({ error: "Recording job not found" }, 404);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.post("/api/discussions/:id/capture/seal", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		if (body.containerMode !== void 0 && body.containerMode !== "independent_wav") return c.json({ error: "Unsupported container mode" }, 400);
+		try {
+			return c.json(await service.discussions.sealRecording(c.req.param("id"), {
+				lastSequence: Number(body.lastSequence),
+				chunkCount: Number(body.chunkCount),
+				mimeType: typeof body.mimeType === "string" ? body.mimeType : "",
+				fileName: typeof body.fileName === "string" ? body.fileName : "",
+				...body.containerMode === "independent_wav" ? { containerMode: "independent_wav" } : {}
+			}), 202);
 		} catch (error) {
 			const response = errorResponse(error);
 			if (response) return c.json(response.body, response.status);

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

@@ -34,25 +34,6 @@ function contentDisposition(disposition, fileName) {
 	const sanitized = fileName.replace(/[\u0000-\u001f\u007f]/g, "_");
 	return `${disposition}; filename="${sanitized.replace(/[^\x20-\x7e]/g, "_").replace(/["\\]/g, "_")}"; filename*=UTF-8''${encodeURIComponent(sanitized).replace(/['()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`)}`;
 }
-async function collectFiles(files, spaceId, max) {
-	const output = [];
-	const directories = [""];
-	const visited = /* @__PURE__ */ new Set();
-	const space = await files.get(spaceId);
-	while (directories.length && output.length < max) {
-		const directory = directories.shift();
-		const canonical = await resolveFilePath(space.root, directory).catch(() => null);
-		if (!canonical || visited.has(canonical)) continue;
-		visited.add(canonical);
-		const children = await files.children(spaceId, directory);
-		for (const child of children) {
-			if (child.kind === "directory") directories.push(child.relativePath);
-			else output.push(child);
-			if (output.length >= max) break;
-		}
-	}
-	return output;
-}
 function registerFilesRoutes(authenticated, deps) {
 	const files = getGatewayFileSpaceService(deps.service);
 	registerFileReferenceRoutes(authenticated, deps);
@@ -96,9 +77,7 @@ function registerFilesRoutes(authenticated, deps) {
 	authenticated.get("/api/files/recent", async (c) => {
 		try {
 			const limit = Math.min(100, Math.max(1, Number(c.req.query("limit")) || 50));
-			const spaces = await files.list();
-			const items = (await Promise.all(spaces.map((space) => collectFiles(files, space.id, 5e3)))).flat().sort((a, b) => b.modifiedAt - a.modifiedAt).slice(0, limit);
-			return c.json({ items });
+			return c.json({ items: await files.recent(limit) });
 		} catch (error) {
 			return errorResponse(c, error);
 		}

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

@@ -1,7 +1,6 @@
 import { registerConnectionWaitRoutes } from "./connection-waits.js";
 import { registerActivityRoutes } from "./activity.js";
 import { registerAgentStreamRoutes } from "./agent-stream.js";
-import { registerDiscussionRoutes } from "./discussions.js";
 import { registerSessionsRoutes } from "./sessions.js";
 import { registerExecutionEnvironmentRoutes } from "./execution-environments.js";
 import { registerSideChatRoutes } from "./side-chats.js";
@@ -32,7 +31,6 @@ function registerCoreAuthenticatedRoutes(authenticated, deps) {
 	registerExecutionEnvironmentRoutes(authenticated, deps);
 	registerSideChatRoutes(authenticated, deps);
 	registerActivityRoutes(authenticated, deps);
-	registerDiscussionRoutes(authenticated, deps);
 	registerProjectsRoutes(authenticated, deps);
 	registerProjectSkillRoutes(authenticated, deps);
 	registerLocalAppsRoutes(authenticated, deps);

package/dist/src/gateway/hono/routes/lazy-bundles.js

@@ -3,6 +3,14 @@ function startsWithAny(path, prefixes) {
 	return prefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
 }
 const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
+	{
+		id: "project-understanding",
+		match: (path) => /^\/api\/projects\/[^/]+\/understanding$/.test(path),
+		load: async () => {
+			const { registerProjectUnderstandingRoutes } = await import("./project-understanding.js");
+			return { register: registerProjectUnderstandingRoutes };
+		}
+	},
 	{
 		id: "browser-session",
 		match: (path) => path === "/api/browser-session",
@@ -210,6 +218,14 @@ const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
 			return { register: registerAutomationRoutes };
 		}
 	},
+	{
+		id: "discussions",
+		match: (path) => path === "/api/discussions" || path.startsWith("/api/discussions/") || path === "/api/discussion-capture/settings",
+		load: async () => {
+			const { registerDiscussionRoutes } = await import("./discussions.js");
+			return { register: registerDiscussionRoutes };
+		}
+	},
 	{
 		id: "notes",
 		match: (path) => startsWithAny(path, ["/api/notes"]) && !/^\/api\/notes\/[^/]+\/hosted-publications(?:\/.*)?$/.test(path),

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

@@ -1,5 +1,5 @@
-import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_resolve_config_value, testApiKeyResolution } from "../../../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_models_json, loadModelsJson, saveModelsJson, validateModelsConfig } from "../../../config/models-json.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../../../providers/model-catalog-store.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";

package/dist/src/gateway/hono/routes/proactive-control.js

@@ -1,15 +1,12 @@
-import { getSqliteDatabase } from "../../../storage/sqlite/transaction.js";
 import { ProactiveConflict, proactivePreferences, updateProactivePreferences } from "../../../proactive/policy/service.js";
-import { controlledSubscriptions, createControlledSubscription, requireSubscription, templateCatalog, updateControlledSubscription } from "../../../proactive/scenarios/control.js";
+import { updateControlledSubscription } from "../../../proactive/scenarios/control.js";
 import { listMailFollowUps, mailFollowUpSources, startMailFollowUp, updateMailFollowUp } from "../../../proactive/follow-ups.js";
-import { cardChanges, getCard, listCards, performCardAction } from "../../../proactive/inbox/cards.js";
+import { cardChanges, getCard, performCardAction } from "../../../proactive/inbox/cards.js";
 import { checkDelegation, delegationOverview, startDelegation } from "../../../proactive/experience.js";
 import { recordProactivePresence } from "../../../proactive/policy/presence.js";
 import { digestCards } from "../../../proactive/inbox/digest.js";
 import { acknowledgeBrowserProbe, listBrowserProbes, prepareBrowserPush, registerBrowserPush, testBrowserPush, unregisterBrowserPush } from "../../../notifications/web-push.js";
-import { ReadonlyProactiveAgentExecutor } from "../../../proactive/execution/agent-executor.js";
 import { proactiveMetrics } from "../../../proactive/metrics.js";
-import { previewSubscription } from "../../../proactive/scenarios/preview.js";
 import { ZodError } from "zod";
 //#region src/gateway/hono/routes/proactive-control.ts
 function registerProactiveControlRoutes(app, deps) {
@@ -94,14 +91,6 @@ function registerProactiveControlRoutes(app, deps) {
 		ok: true,
 		cards: digestCards(c.req.param("id"), workspace())
 	}));
-	app.post("/api/proactive/subscriptions/:id/preview", deps.strictRateLimitMiddleware, async (c) => c.json({
-		ok: true,
-		...await previewSubscription(workspace(), c.req.param("id"), new ReadonlyProactiveAgentExecutor(() => deps.service.getConfig()), c.req.raw.signal)
-	}));
-	app.get("/api/proactive/templates", (c) => c.json({
-		ok: true,
-		templates: templateCatalog(workspace())
-	}));
 	app.get("/api/proactive/preferences", (c) => c.json({
 		ok: true,
 		preferences: proactivePreferences(workspace())
@@ -110,33 +99,10 @@ function registerProactiveControlRoutes(app, deps) {
 		ok: true,
 		preferences: updateProactivePreferences(workspace(), await c.req.json())
 	}));
-	app.get("/api/proactive/subscriptions", (c) => c.json({
-		ok: true,
-		subscriptions: controlledSubscriptions(workspace())
-	}));
-	app.post("/api/proactive/subscriptions", deps.strictRateLimitMiddleware, async (c) => c.json({
-		ok: true,
-		subscription: createControlledSubscription(workspace(), await c.req.json())
-	}, 201));
 	app.patch("/api/proactive/subscriptions/:id", deps.strictRateLimitMiddleware, async (c) => c.json({
 		ok: true,
 		subscription: updateControlledSubscription(workspace(), c.req.param("id"), await c.req.json())
 	}));
-	app.get("/api/proactive/subscriptions/:id/runs", (c) => {
-		requireSubscription(c.req.param("id"), workspace());
-		return c.json({
-			ok: true,
-			runs: getSqliteDatabase().prepare(`SELECT run_id AS id, status, outcome_reason AS reason,
-      started_at AS startedAt, completed_at AS completedAt, error_message AS error FROM proactive_runs WHERE subscription_id = ? ORDER BY started_at DESC LIMIT 30`).all(c.req.param("id"))
-		});
-	});
-	app.get("/api/proactive/cards", (c) => c.json({
-		ok: true,
-		...listCards(workspace(), {
-			status: c.req.query("status"),
-			before: c.req.query("before")
-		})
-	}));
 	app.get("/api/inbox/judgments/changes", (c) => {
 		const cursor = Number(c.req.query("cursor") ?? 0);
 		if (!Number.isSafeInteger(cursor) || cursor < 0) return c.json({

package/dist/src/gateway/hono/routes/project-understanding.d.ts

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

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

@@ -0,0 +1,65 @@
+import { getProjectUnderstandingRun } from "../../../work-discovery/repository.js";
+import { getProjectUnderstandingOverview, saveProjectUnderstandingOverview } from "../../../work-discovery/project-understanding.js";
+//#region src/gateway/hono/routes/project-understanding.ts
+function registerProjectUnderstandingRoutes(authenticated, deps) {
+	const { service } = deps;
+	authenticated.get("/api/projects/:id/understanding", (c) => {
+		const projectId = c.req.param("id");
+		if (!service.projects.get(projectId)) return c.json({
+			ok: false,
+			error: "Project not found"
+		}, 404);
+		const run = getProjectUnderstandingRun(projectId);
+		const overview = getProjectUnderstandingOverview(projectId);
+		return c.json({
+			ok: true,
+			status: run?.status ?? "not_started",
+			overview: overview?.content ?? null,
+			updatedAt: overview?.updatedAt ?? null
+		});
+	});
+	authenticated.post("/api/projects/:id/understanding", (c) => {
+		const projectId = c.req.param("id");
+		if (!service.projects.get(projectId)) return c.json({
+			ok: false,
+			error: "Project not found"
+		}, 404);
+		try {
+			const run = deps.service.workDiscovery.startProjectUnderstanding(projectId);
+			return c.json({
+				ok: true,
+				status: run.status
+			}, 202);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
+	authenticated.patch("/api/projects/:id/understanding", async (c) => {
+		const projectId = c.req.param("id");
+		if (!service.projects.get(projectId)) return c.json({
+			ok: false,
+			error: "Project not found"
+		}, 404);
+		const body = await c.req.json().catch(() => ({}));
+		const content = body && typeof body.content === "string" ? body.content.trim() : void 0;
+		if (!content || content.length > 6e3) return c.json({
+			ok: false,
+			error: "Overview must contain 1–6000 characters"
+		}, 400);
+		const overview = saveProjectUnderstandingOverview({
+			projectId,
+			content,
+			correctedByUser: true
+		});
+		return c.json({
+			ok: true,
+			overview: overview.content,
+			updatedAt: overview.updatedAt
+		});
+	});
+}
+//#endregion
+export { registerProjectUnderstandingRoutes };

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

@@ -1,3 +1,5 @@
+import { createLogger } from "../../../utils/logger/index.js";
+import { init_logger } from "../../../utils/logger.js";
 import { getSqliteDatabase } from "../../../storage/sqlite/transaction.js";
 import { getSessionMetadata } from "../../../storage/sqlite/session-repository.js";
 import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript-repository.js";
@@ -20,9 +22,12 @@ import { TaskApplicationService } from "../../../tasks/task-application-service.
 import { defineTaskContract } from "../../../tasks/task-contract-definition.js";
 import { ProjectOperatingViewService, summarizeProjectOperatingView } from "../../../tasks/project-operating-view-service.js";
 import "../../../tasks/index.js";
+import { getProjectUnderstandingRun } from "../../../work-discovery/repository.js";
 import { parseActivityIncludeRelated, parseActivityQuery } from "./activity.js";
 import { randomUUID } from "node:crypto";
 //#region src/gateway/hono/routes/projects.ts
+init_logger();
+const log = createLogger("Projects");
 function parseProjectStatus(raw) {
 	return raw === "planned" || raw === "active" || raw === "paused" || raw === "completed" || raw === "cancelled" || raw === "archived" ? raw : void 0;
 }
@@ -34,9 +39,6 @@ function parseLimit(raw, fallback = 50) {
 	const n = Number.parseInt(raw, 10);
 	return Number.isFinite(n) ? Math.min(500, Math.max(1, n)) : fallback;
 }
-function isHiddenEmptyProjectChatShell(session) {
-	return session.hiddenFromSessionList === true && session.messageCount === 0 && (session.customData?.origin === "automation" || session.customData?.genericNewChatShell !== false && Boolean(session.routing?.peerId?.startsWith("chat_")));
-}
 function textField(body, key) {
 	const value = body[key];
 	return typeof value === "string" ? value : void 0;
@@ -151,6 +153,10 @@ function registerProjectsRoutes(authenticated, deps) {
 		const body = await c.req.json().catch(() => ({}));
 		const name = textField(body, "name")?.trim();
 		const workspaceRoot = textField(body, "workspaceRoot")?.trim();
+		if (body.autoUnderstand !== void 0 && typeof body.autoUnderstand !== "boolean") return c.json({
+			ok: false,
+			error: "autoUnderstand must be a boolean"
+		}, 400);
 		if (!name && !workspaceRoot) return c.json({
 			ok: false,
 			error: "Missing name"
@@ -192,6 +198,14 @@ function registerProjectsRoutes(authenticated, deps) {
 				ownerId: textField(body, "ownerId"),
 				targetAt: optionalNumberField(body, "targetAt") ?? void 0
 			});
+			if (body.autoUnderstand === true) try {
+				deps.service.workDiscovery.startProjectUnderstanding(project.id);
+			} catch (err) {
+				log.warn({
+					err,
+					projectId: project.id
+				}, "Project created but understanding could not be queued");
+			}
 			return c.json({
 				ok: true,
 				project: enrichProjectWorkspace(service, project)
@@ -691,6 +705,8 @@ function registerProjectsRoutes(authenticated, deps) {
 			code: "execution_environments_exist",
 			error: "Delete the project execution environments before deleting the project"
 		}, 409);
+		const understandingRun = getProjectUnderstandingRun(projectId);
+		if (understandingRun) deps.service.workDiscovery.cancelRun(understandingRun.id);
 		service.projects.delete(projectId);
 		return c.json({ ok: true });
 	});
@@ -700,7 +716,7 @@ function registerProjectsRoutes(authenticated, deps) {
 			const sessions = await Promise.all(keys.map((key) => service.sessions.getSession(key)));
 			return c.json({
 				ok: true,
-				sessions: sessions.filter((session) => session && !isHiddenEmptyProjectChatShell(session))
+				sessions: sessions.filter((session) => session && !session.hiddenFromSessionList)
 			});
 		} catch (error) {
 			return c.json({

package/dist/src/gateway/hono/routes/session-input-handler.d.ts

@@ -74,7 +74,7 @@ export declare function submitSessionInput(c: Context, deps: AuthenticatedRouteD
                     documentId?: string;
                 }[];
                 contextSnapshots?: {
-                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "browser_page";
+                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "task" | "browser_page";
                     sourceId: string;
                     version: string;
                     title: string;
@@ -180,7 +180,7 @@ export declare function replaceLatestSessionTurn(c: Context, deps: Authenticated
                     documentId?: string;
                 }[];
                 contextSnapshots?: {
-                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "browser_page";
+                    kind: import("../../../agent/source-context/types.js").SessionSourceBinding["kind"] | "task" | "browser_page";
                     sourceId: string;
                     version: string;
                     title: string;

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -24,7 +24,7 @@ async function submitSessionInput(c, deps, sessionKey) {
 		ok: false,
 		error: {
 			code: "BAD_REQUEST",
-			message: `contextRefs must contain at most ${MAX_TURN_CONTEXTS} valid notes`
+			message: `contextRefs must contain at most ${MAX_TURN_CONTEXTS} valid note or task references`
 		}
 	}, 400);
 	const browserContexts = browserPageContextsInputSchema.safeParse(body.browserContexts ?? []);
@@ -170,7 +170,7 @@ async function replaceLatestSessionTurn(c, deps, sessionKey, targetTurnId) {
 		ok: false,
 		error: {
 			code: "BAD_REQUEST",
-			message: `contextRefs must contain at most ${MAX_TURN_CONTEXTS} valid notes`
+			message: `contextRefs must contain at most ${MAX_TURN_CONTEXTS} valid note or task references`
 		}
 	}, 400);
 	const content = typeof body.content === "string" ? body.content : "";