@xopcai/xopc 0.0.159 → 0.0.161

package/dist/src/gateway/hono/routes/work-discovery.js

@@ -1,6 +1,10 @@
 import { getAgentDefaultModelRef, init_schema } from "../../../config/schema.js";
 import { init_providers, resolveModel } from "../../../providers/index.js";
 import { isLocalModelBaseUrl } from "../../../providers/model-call.js";
+import { listFocusCalendarSignals } from "../../../proactive/calendar-signals.js";
+import { FocusService } from "../../../proactive/focus-service.js";
+import { claimProactiveInsightApproval, getProactiveInsight, setProactiveInsightStatus } from "../../../proactive/insight-repository.js";
+import "../../../proactive/index.js";
 import { previewWorkDiscoveryRoot } from "../../../work-discovery/probe.js";
 import { WorkDiscoveryService } from "../../../work-discovery/service.js";
 //#region src/gateway/hono/routes/work-discovery.ts
@@ -26,6 +30,7 @@ function stringField(body, field) {
 }
 function registerWorkDiscoveryRoutes(authenticated, deps) {
 	const service = workDiscoveryService(deps);
+	const focuses = new FocusService(deps.service.automationServiceInstance);
 	const limited = deps.strictRateLimitMiddleware;
 	authenticated.get("/api/onboarding/work-discovery", (c) => c.json({
 		enabled: service.isEnabled(),
@@ -77,6 +82,178 @@ function registerWorkDiscoveryRoutes(authenticated, deps) {
 			}, 400);
 		}
 	});
+	authenticated.post("/api/work-discovery/candidates", limited, async (c) => {
+		if (!service.isEnabled()) return c.json({
+			ok: false,
+			error: "Work discovery is disabled"
+		}, 404);
+		try {
+			const candidates = await service.discoverCandidates(c.req.raw.signal);
+			return c.json({
+				ok: true,
+				candidates
+			});
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 500);
+		}
+	});
+	authenticated.get("/api/work-discovery/sources/directories", (c) => c.json({
+		ok: true,
+		sources: service.listDirectorySources()
+	}));
+	authenticated.post("/api/work-discovery/sources/directories", limited, async (c) => {
+		const rootPath = stringField(await c.req.json().catch(() => null), "rootPath");
+		if (!rootPath) return c.json({
+			ok: false,
+			error: "Missing rootPath"
+		}, 400);
+		try {
+			const source = await service.grantDirectorySource(rootPath);
+			return c.json({
+				ok: true,
+				source
+			}, 201);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
+	authenticated.delete("/api/work-discovery/sources/directories/:sourceId", limited, (c) => {
+		const source = service.revokeDirectorySource(c.req.param("sourceId"));
+		return source ? c.json({
+			ok: true,
+			source
+		}) : c.json({
+			ok: false,
+			error: "Source not found"
+		}, 404);
+	});
+	authenticated.post("/api/work-discovery/sources/directories/:sourceId/runs", limited, async (c) => {
+		const idempotencyKey = stringField(await c.req.json().catch(() => null), "idempotencyKey");
+		if (!idempotencyKey) return c.json({
+			ok: false,
+			error: "Missing idempotencyKey"
+		}, 400);
+		try {
+			const run = await service.rescanDirectorySource({
+				id: c.req.param("sourceId"),
+				idempotencyKey
+			});
+			return c.json({
+				ok: true,
+				run
+			}, 202);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
+	authenticated.post("/api/work-discovery/sources/directories/check", limited, async (c) => {
+		return c.json({
+			ok: true,
+			checks: await service.checkDirectorySources()
+		});
+	});
+	authenticated.post("/api/work-discovery/sources/directories/:sourceId/refresh-if-changed", limited, async (c) => {
+		const idempotencyKey = stringField(await c.req.json().catch(() => null), "idempotencyKey");
+		if (!idempotencyKey) return c.json({
+			ok: false,
+			error: "Missing idempotencyKey"
+		}, 400);
+		try {
+			const result = await service.refreshDirectorySourceIfChanged({
+				id: c.req.param("sourceId"),
+				idempotencyKey
+			});
+			return c.json({
+				ok: true,
+				...result
+			}, result.changed ? 202 : 200);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
+	authenticated.post("/api/work-discovery/personal-context/import", limited, async (c) => {
+		if (!service.isEnabled()) return c.json({
+			ok: false,
+			error: "Work discovery is disabled"
+		}, 404);
+		const body = await c.req.json().catch(() => null);
+		const items = body && typeof body === "object" && Array.isArray(body.items) ? body.items.slice(0, 150) : [];
+		const runId = stringField(body, "runId");
+		if (!items.length) return c.json({
+			ok: false,
+			error: "No personal context was provided"
+		}, 400);
+		try {
+			const result = await service.importPersonalContext(items, c.req.raw.signal, runId || void 0);
+			return c.json({
+				ok: true,
+				...result
+			}, 201);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
+	authenticated.post("/api/work-discovery/personal-context/profile", limited, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		const decisions = (body && typeof body === "object" && Array.isArray(body.decisions) ? body.decisions : []).flatMap((value) => {
+			if (!value || typeof value !== "object") return [];
+			const item = value;
+			const memoryRecordId = typeof item.memoryRecordId === "string" ? item.memoryRecordId.trim() : "";
+			const status = item.status === "accepted" || item.status === "edited" || item.status === "rejected" ? item.status : void 0;
+			if (!memoryRecordId || !status) return [];
+			return [{
+				memoryRecordId,
+				status,
+				...typeof item.statement === "string" ? { statement: item.statement } : {}
+			}];
+		}).slice(0, 10);
+		if (!decisions.length) return c.json({
+			ok: false,
+			error: "At least one valid decision is required"
+		}, 400);
+		return c.json({
+			ok: true,
+			decisions: service.updatePersonalContextProfile({ decisions })
+		});
+	});
+	authenticated.post("/api/work-discovery/quick-runs", limited, async (c) => {
+		if (!service.isEnabled()) return c.json({
+			ok: false,
+			error: "Work discovery is disabled"
+		}, 404);
+		const idempotencyKey = stringField(await c.req.json().catch(() => null), "idempotencyKey");
+		if (!idempotencyKey) return c.json({
+			ok: false,
+			error: "Missing idempotencyKey"
+		}, 400);
+		try {
+			const run = await service.startQuickRun({ idempotencyKey });
+			return c.json({
+				ok: true,
+				run
+			}, 202);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
 	authenticated.post("/api/work-discovery/runs", limited, async (c) => {
 		if (!service.isEnabled()) return c.json({
 			ok: false,
@@ -117,6 +294,250 @@ function registerWorkDiscoveryRoutes(authenticated, deps) {
 			error: "Run not found"
 		}, 404);
 	});
+	authenticated.get("/api/work-discovery/runs/:runId/investigation", (c) => {
+		const result = service.getInvestigation(c.req.param("runId"));
+		return result ? c.json({
+			ok: true,
+			...result
+		}) : c.json({
+			ok: false,
+			error: "Investigation not found"
+		}, 404);
+	});
+	authenticated.get("/api/work-understanding/threads", (c) => {
+		const projectId = c.req.query("projectId")?.trim();
+		const limit = Number(c.req.query("limit"));
+		return c.json({
+			ok: true,
+			threads: service.listWorkThreads({
+				...projectId ? { projectId } : {},
+				...Number.isFinite(limit) ? { limit } : {}
+			})
+		});
+	});
+	authenticated.get("/api/work-understanding/metrics", (c) => c.json({
+		ok: true,
+		metrics: service.getUnderstandingMetrics()
+	}));
+	authenticated.get("/api/work-understanding/sources/:sourceId/lineage", (c) => {
+		const lineage = service.getSourceLineage(c.req.param("sourceId"));
+		return lineage ? c.json({
+			ok: true,
+			lineage
+		}) : c.json({
+			ok: false,
+			error: "Source not found"
+		}, 404);
+	});
+	authenticated.delete("/api/work-understanding/sources/:sourceId/derived-data", limited, (c) => {
+		const deleted = service.deleteSourceDerivedData(c.req.param("sourceId"));
+		return deleted ? c.json({
+			ok: true,
+			deleted
+		}) : c.json({
+			ok: false,
+			error: "Source not found"
+		}, 404);
+	});
+	authenticated.get("/api/work-understanding/threads/:threadId", (c) => {
+		const thread = service.getWorkThread(c.req.param("threadId"));
+		return thread ? c.json({
+			ok: true,
+			thread
+		}) : c.json({
+			ok: false,
+			error: "Work thread not found"
+		}, 404);
+	});
+	authenticated.patch("/api/work-understanding/threads/:threadId", limited, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		const decision = stringField(body, "decision");
+		if (![
+			"confirmed",
+			"corrected",
+			"rejected",
+			"paused",
+			"completed"
+		].includes(decision)) return c.json({
+			ok: false,
+			error: "Invalid work thread decision"
+		}, 400);
+		const thread = service.updateWorkThread({
+			id: c.req.param("threadId"),
+			decision,
+			...stringField(body, "correctedTitle") ? { correctedTitle: stringField(body, "correctedTitle") } : {},
+			...stringField(body, "correctedSummary") ? { correctedSummary: stringField(body, "correctedSummary") } : {}
+		});
+		return thread ? c.json({
+			ok: true,
+			thread
+		}) : c.json({
+			ok: false,
+			error: "Work thread not found"
+		}, 404);
+	});
+	authenticated.get("/api/focuses", (c) => {
+		return c.json({
+			ok: true,
+			focuses: focuses.list({ includeUnreviewed: c.req.query("includeUnreviewed") === "true" })
+		});
+	});
+	authenticated.post("/api/focuses/:focusId/confirm", limited, (c) => {
+		const focus = focuses.confirm(c.req.param("focusId"));
+		return focus ? c.json({
+			ok: true,
+			focus
+		}) : c.json({
+			ok: false,
+			error: "Focus not found"
+		}, 404);
+	});
+	authenticated.post("/api/focuses/:focusId/watches/trial", limited, async (c) => {
+		const requestedKind = stringField(await c.req.json().catch(() => null), "kind");
+		const kind = [
+			"progress",
+			"staleness",
+			"deadline",
+			"intelligence"
+		].includes(requestedKind) ? requestedKind : void 0;
+		try {
+			const result = await focuses.activateTrial({
+				threadId: c.req.param("focusId"),
+				...kind ? { kind } : {}
+			});
+			return c.json({
+				ok: true,
+				...result
+			}, 201);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 400);
+		}
+	});
+	authenticated.post("/api/focuses/:focusId/watches/:watchId/pause", limited, async (c) => {
+		const watch = focuses.list({ includeUnreviewed: true }).find((item) => item.id === c.req.param("focusId"))?.watches.find((item) => item.id === c.req.param("watchId"));
+		if (!watch) return c.json({
+			ok: false,
+			error: "Watch not found"
+		}, 404);
+		const paused = await focuses.pauseWatch(watch.id);
+		return c.json({
+			ok: true,
+			watch: paused
+		});
+	});
+	authenticated.patch("/api/proactive/insights/:insightId", limited, async (c) => {
+		const requested = stringField(await c.req.json().catch(() => null), "status");
+		const status = requested === "read" || requested === "dismissed" ? requested : void 0;
+		if (!status) return c.json({
+			ok: false,
+			error: "Status must be read or dismissed"
+		}, 400);
+		const insight = setProactiveInsightStatus(c.req.param("insightId"), status, Date.now(), "unread");
+		if (!insight) return c.json({
+			ok: false,
+			error: "Insight was already handled or not found"
+		}, 409);
+		if (status === "dismissed") await focuses.recordInsightFeedback(insight.watchId, false);
+		return c.json({
+			ok: true,
+			insight
+		});
+	});
+	authenticated.post("/api/proactive/insights/:insightId/approve", limited, async (c) => {
+		const insight = getProactiveInsight(c.req.param("insightId"));
+		if (!insight) return c.json({
+			ok: false,
+			error: "Insight not found"
+		}, 404);
+		if (insight.status !== "unread") return c.json({
+			ok: false,
+			error: `Insight is ${insight.status}`
+		}, 409);
+		const focus = focuses.list({ includeUnreviewed: true }).find((item) => item.watches.some((watch) => watch.id === insight.watchId));
+		if (!focus) return c.json({
+			ok: false,
+			error: "Focus not found"
+		}, 404);
+		if (!claimProactiveInsightApproval(insight.id)) return c.json({
+			ok: false,
+			error: "Insight was already handled"
+		}, 409);
+		let automationId;
+		try {
+			const automation = await deps.service.automationServiceInstance.create({
+				name: `Investigate: ${insight.title}`.slice(0, 200),
+				description: `User-approved read-only proposal from proactive insight ${insight.id}.`,
+				...focus.projectIds[0] ? { projectId: focus.projectIds[0] } : {},
+				trigger: { kind: "manual" },
+				action: {
+					kind: "agent",
+					instruction: [
+						"The user approved this evidence-backed proposal for read-only investigation and preparation.",
+						`Focus: ${focus.title}`,
+						`Observed change: ${insight.summary}`,
+						`Why it matters: ${insight.whyItMatters}`,
+						`Approved next step: ${insight.nextAction}`,
+						`Evidence: ${JSON.stringify(insight.evidence)}`,
+						"Investigate or prepare the requested material. Return a concise result with evidence. Do not modify files or external systems."
+					].join("\n"),
+					timeoutSeconds: 300
+				},
+				safety: { mode: "suggest_only" },
+				afterRun: { kind: "none" },
+				reliability: {
+					timeoutSeconds: 300,
+					disableAfterConsecutiveFailures: 1
+				}
+			});
+			automationId = automation.id;
+			const run = await deps.service.automationServiceInstance.runNow(automation.id);
+			await focuses.recordInsightFeedback(insight.watchId, true);
+			return c.json({
+				ok: true,
+				automationId: automation.id,
+				runId: run.id
+			}, 202);
+		} catch (error) {
+			if (automationId) await deps.service.automationServiceInstance.remove(automationId);
+			setProactiveInsightStatus(insight.id, "unread", Date.now(), "approved");
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 500);
+		}
+	});
+	authenticated.post("/api/focuses/:focusId/calendar/:signalId/prepare", limited, async (c) => {
+		const focus = focuses.list().find((item) => item.id === c.req.param("focusId"));
+		if (!focus) return c.json({
+			ok: false,
+			error: "Focus not found"
+		}, 404);
+		const signal = listFocusCalendarSignals([focus]).find((item) => item.id === c.req.param("signalId"));
+		if (!signal) return c.json({
+			ok: false,
+			error: "Calendar event not found"
+		}, 404);
+		const eventContext = `${signal.title} at ${new Date(signal.startsAt).toISOString()}`;
+		try {
+			const result = await focuses.activateTrial({
+				threadId: focus.id,
+				kind: "deadline",
+				eventContext
+			});
+			return c.json({
+				ok: true,
+				...result
+			});
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 500);
+		}
+	});
 	authenticated.post("/api/work-discovery/runs/:runId/cancel", (c) => {
 		const run = service.cancelRun(c.req.param("runId"));
 		return run ? c.json({
@@ -169,6 +590,36 @@ function registerWorkDiscoveryRoutes(authenticated, deps) {
 			}, 400);
 		}
 	});
+	authenticated.post("/api/work-discovery/runs/:runId/profile", limited, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		const decisions = (body && typeof body === "object" && Array.isArray(body.decisions) ? body.decisions : []).flatMap((value) => {
+			if (!value || typeof value !== "object") return [];
+			const item = value;
+			const id = typeof item.id === "string" ? item.id.trim() : "";
+			const status = item.status === "accepted" || item.status === "edited" || item.status === "rejected" ? item.status : void 0;
+			if (!id || !status) return [];
+			return [{
+				id,
+				status,
+				...typeof item.statement === "string" ? { statement: item.statement } : {}
+			}];
+		}).slice(0, 10);
+		if (!decisions.length) return c.json({
+			ok: false,
+			error: "At least one valid decision is required"
+		}, 400);
+		const run = service.updateProfileCandidates({
+			runId: c.req.param("runId"),
+			decisions
+		});
+		return run ? c.json({
+			ok: true,
+			run
+		}) : c.json({
+			ok: false,
+			error: "Profile candidates not found"
+		}, 404);
+	});
 	authenticated.post("/api/work-discovery/runs/:runId/suggestions/:suggestionId/select", (c) => {
 		return service.selectSuggestion(c.req.param("runId"), c.req.param("suggestionId")) ? c.json({ ok: true }) : c.json({
 			ok: false,

package/dist/src/gateway/hono/sse.d.ts

@@ -1,5 +1,7 @@
 import type { Context } from 'hono';
 import type { GatewayService } from '../service.js';
+/** Close long-lived gateway event streams before the HTTP server starts draining. */
+export declare function closeAllEventStreams(): void;
 export interface SSEHandlerConfig {
     service: GatewayService;
     maxSseConnections?: number;

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

@@ -9,6 +9,10 @@ import { streamSSE } from "hono/streaming";
 init_logger();
 const log = createLogger("Gateway:SSE");
 const activeConnections = /* @__PURE__ */ new Map();
+/** Close long-lived gateway event streams before the HTTP server starts draining. */
+function closeAllEventStreams() {
+	for (const controller of activeConnections.values()) controller.abort();
+}
 function isValidAgentRequest(body) {
 	if (!body || typeof body !== "object") return false;
 	const b = body;
@@ -341,17 +345,20 @@ function createEventsSSEHandler(config) {
 				}
 			}, 3e4);
 			await new Promise((resolve) => {
-				stream.onAbort(() => {
+				const finish = () => {
 					aborted = true;
 					clearInterval(keepAlive);
 					cleanup();
 					activeConnections.delete(sessionId);
 					log.debug({ sessionId }, "Event stream disconnected");
 					resolve();
-				});
+				};
+				stream.onAbort(finish);
+				abortController.signal.addEventListener("abort", () => stream.abort(), { once: true });
+				if (abortController.signal.aborted) stream.abort();
 			});
 		});
 	};
 }
 //#endregion
-export { createAgentResumeHandler, createAgentSSEHandler, createEventsSSEHandler, createSendHandler };
+export { closeAllEventStreams, createAgentResumeHandler, createAgentSSEHandler, createEventsSSEHandler, createSendHandler };

package/dist/src/gateway/run-loop.js

@@ -15,7 +15,8 @@ async function runGatewayLoop(opts) {
 	let lock = await acquireGatewayLock(opts.configPath, { port: opts.port });
 	let server = null;
 	let shuttingDown = false;
-	let restartResolver = null;
+	let forceCloseRequested = false;
+	let loopResolver = null;
 	const cleanupSignals = () => {
 		process.removeListener("SIGTERM", onSigterm);
 		process.removeListener("SIGINT", onSigint);
@@ -51,20 +52,27 @@ async function runGatewayLoop(opts) {
 			return;
 		}
 		shuttingDown = false;
-		restartResolver?.();
+		forceCloseRequested = false;
+		loopResolver?.("restart");
 	};
 	const handleStopAfterClose = async () => {
 		await releaseLock();
-		exitProcess(0);
+		loopResolver?.("stop");
 	};
 	const DRAIN_TIMEOUT_MS = 3e4;
 	const SHUTDOWN_TIMEOUT_MS = 15e3;
 	const requestShutdown = (action, signal) => {
-		if (shuttingDown) return;
+		if (shuttingDown) {
+			if (!forceCloseRequested && (signal === "SIGINT" || signal === "SIGTERM")) {
+				forceCloseRequested = true;
+				console.warn(`[GatewayRunLoop] Received ${signal} again; force closing connections`);
+				server?.forceCloseConnections();
+			}
+			return;
+		}
 		shuttingDown = true;
 		const isRestart = action === "restart";
 		console.log(`[GatewayRunLoop] Received ${signal}; ${isRestart ? "restarting" : "shutting down"}`);
-		cleanupSignals();
 		const forceExitMs = isRestart ? DRAIN_TIMEOUT_MS + SHUTDOWN_TIMEOUT_MS : SHUTDOWN_TIMEOUT_MS;
 		const forceExitTimer = setTimeout(() => {
 			console.error("[GatewayRunLoop] Shutdown timed out; force exiting");
@@ -129,9 +137,11 @@ async function runGatewayLoop(opts) {
 				exitProcess(1);
 				return;
 			}
-			await new Promise((resolve) => {
-				restartResolver = resolve;
+			const action = await new Promise((resolve) => {
+				loopResolver = resolve;
 			});
+			loopResolver = null;
+			if (action === "stop") return;
 			console.log("[GatewayRunLoop] Restart signal received, restarting gateway...");
 		}
 	} finally {

package/dist/src/gateway/server.d.ts

@@ -23,6 +23,7 @@ export declare class GatewayServer {
         restartExpectedMs?: number | null;
     }): Promise<void>;
     stop(): Promise<void>;
+    forceCloseConnections(): void;
     get isRunning(): boolean;
     get serviceInstance(): GatewayService;
 }

package/dist/src/gateway/server.js

@@ -2,6 +2,7 @@ import { resolveGatewayBindHost, resolveGatewayListenHosts } from "../config/gat
 import { ensureXopcCliOnPath } from "../infra/path-env.js";
 import { resolveGatewayListenPlan } from "./listen.js";
 import { GatewayService } from "./service.js";
+import { closeAllEventStreams } from "./hono/sse.js";
 import { handleSiteShareUpgrade } from "../share/site-share-router.js";
 import { createHonoApp } from "./hono/app.js";
 import { serve } from "@hono/node-server";
@@ -94,6 +95,7 @@ var GatewayServer = class {
 	}
 	async stop() {
 		console.log("[GatewayServer] Stopping gateway server...");
+		closeAllEventStreams();
 		const closeServer = async (server) => {
 			if (!server) return;
 			const forceClose = setTimeout(() => {
@@ -113,6 +115,13 @@ var GatewayServer = class {
 		await this.service.stop();
 		console.log("[GatewayServer] Gateway server stopped");
 	}
+	forceCloseConnections() {
+		const close = (server) => {
+			server?.closeAllConnections?.();
+		};
+		close(this.server);
+		for (const extra of this.extraServers) close(extra);
+	}
 	get isRunning() {
 		return this.server !== void 0;
 	}

package/dist/src/gateway/service.d.ts

@@ -61,6 +61,7 @@ export declare class GatewayService {
     private connectedKnowledgeCoordinator;
     private stopAutomationProductEventBridge;
     private stopSessionTranscriptAutomationEvents;
+    private stopFocusTrialExpiryReconciler;
     /**
      * Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
      * `submitClarifyResponse`, clarify-bridge dispatch). Owns the
@@ -267,6 +268,7 @@ export declare class GatewayService {
     processDirect(content: string, sessionKey?: string): Promise<string>;
     subscribe(sessionId: string, listener: (event: ServiceEvent) => Promise<void> | void): () => void;
     emit(type: string, payload: unknown): void;
+    private handleAutomationRunCompleted;
     private startAutomationProductEventBridge;
     /** Replay events since `lastEventId` for SSE reconnection. */
     getEventsSince(sessionId: string, lastEventId: string): ServiceEvent[];