@xopcai/xopc 0.0.248 → 0.0.250

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

@@ -1,387 +0,0 @@
-import { deleteUnderstanding, listUnderstandingEvidence, listUnderstandings, setUnderstandingStatus } from "../../../storage/sqlite/user-context-repository.js";
-import { countKnowledgeSourceItems, deleteKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
-import { countMemoryRecordsBySourceInstanceId, deleteMemoryRecordsBySourceInstanceId } from "../../../storage/sqlite/memory-records-repository.js";
-import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
-import "../../../storage/sqlite/index.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { deleteUserFocus, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocusEvidence, listUserFocuses, revokeUnderstandingSourceGrant, updateUnderstandingSourceGrantPolicies, updateUserFocus } from "../../../user-context/sources/repository.js";
-import { listConnectedContentCandidates, readConnectedContent } from "../../../connectors/content-enrichment.js";
-import { getWorkDiscoveryService } from "./work-discovery.js";
-import { listUnderstandingSourceDefinitions } from "../../../user-context/sources/catalog.js";
-//#region src/gateway/hono/routes/understanding-sources.ts
-init_agent_scope();
-function stringField(body, field) {
-	if (!body || typeof body !== "object") return "";
-	const value = body[field];
-	return typeof value === "string" ? value.trim() : "";
-}
-function decisionsFrom(body) {
-	return (body && typeof body === "object" && Array.isArray(body.decisions) ? body.decisions : []).flatMap((value) => {
-		if (!value || typeof value !== "object") return [];
-		const item = value;
-		const understandingId = typeof item.understandingId === "string" ? item.understandingId.trim() : "";
-		const status = item.status === "accepted" || item.status === "edited" || item.status === "rejected" ? item.status : null;
-		if (!understandingId || !status) return [];
-		return [{
-			understandingId,
-			status,
-			...typeof item.statement === "string" ? { statement: item.statement } : {}
-		}];
-	}).slice(0, 20);
-}
-function sourceRevocationImpact(grantId) {
-	const grant = getUnderstandingSourceGrant(grantId);
-	if (!grant) return null;
-	const accountId = typeof grant.config.accountId === "string" ? grant.config.accountId : void 0;
-	const connectorId = typeof grant.config.connectorId === "string" ? grant.config.connectorId : void 0;
-	const sourceInstanceId = accountId && connectorId ? `composio:${connectorId}:${accountId}` : void 0;
-	const belongs = (evidence) => evidence.sourceRef.startsWith(`understanding-source-grant:${grantId}:`) || Boolean(sourceInstanceId && evidence.sourceInstanceId === sourceInstanceId);
-	const understandings = listUnderstandings().flatMap((item) => {
-		if (item.explicitness === "explicit") return [];
-		const evidence = listUnderstandingEvidence(item.id);
-		return evidence.some(belongs) && !evidence.some((entry) => !belongs(entry)) ? [item] : [];
-	});
-	const focuses = listUserFocuses().flatMap((focus) => {
-		if (focus.explicitness === "explicit") return [];
-		if ((focus.sourceRunId ? getUnderstandingSourceRun(focus.sourceRunId) : null)?.grantId !== grantId) return [];
-		return listUserFocusEvidence(focus.id).some((entry) => !belongs(entry)) ? [] : [focus];
-	});
-	const memoryRecordCount = sourceInstanceId ? countMemoryRecordsBySourceInstanceId(sourceInstanceId) : 0;
-	const boundedRawCount = sourceInstanceId ? countKnowledgeSourceItems(sourceInstanceId) : 0;
-	return {
-		grant,
-		sourceInstanceId,
-		understandingIds: understandings.map((item) => item.id),
-		focusIds: focuses.map((item) => item.id),
-		derivedCount: understandings.length + focuses.length + memoryRecordCount,
-		understandingCount: understandings.length,
-		focusCount: focuses.length,
-		memoryRecordCount,
-		boundedRawCount
-	};
-}
-function applySourceRevocationChoices(impact, options) {
-	let derivedDeleted = 0;
-	for (const id of impact.focusIds) if (options.derived === "delete") {
-		if (deleteUserFocus(id)) derivedDeleted += 1;
-	} else updateUserFocus(id, { status: "paused" });
-	for (const id of impact.understandingIds) if (options.derived === "delete") {
-		if (deleteUnderstanding(id)) derivedDeleted += 1;
-	} else setUnderstandingStatus(id, "needs_review", {
-		actorType: "runtime",
-		source: "understanding-source-revoked"
-	});
-	if (options.derived === "delete" && impact.sourceInstanceId) derivedDeleted += deleteMemoryRecordsBySourceInstanceId(impact.sourceInstanceId);
-	const rawDeleted = options.raw === "delete" && impact.sourceInstanceId ? deleteKnowledgeSourceItems(impact.sourceInstanceId) : 0;
-	return {
-		derivedDeleted,
-		rawDeleted
-	};
-}
-function registerUnderstandingSourceRoutes(authenticated, deps) {
-	const service = getWorkDiscoveryService(deps);
-	const limited = deps.strictRateLimitMiddleware;
-	authenticated.get("/api/understanding/sources/catalog", (c) => {
-		const requested = c.req.query("platform");
-		const platform = requested === "darwin" || requested === "win32" || requested === "linux" ? requested : process.platform;
-		return c.json({
-			ok: true,
-			sources: listUnderstandingSourceDefinitions(platform)
-		});
-	});
-	authenticated.get("/api/understanding/sources/grants", (c) => {
-		const grants = listUnderstandingSourceGrants({ includeRevoked: c.req.query("includeRevoked") === "true" });
-		return c.json({
-			ok: true,
-			grants,
-			latestRuns: Object.fromEntries(grants.flatMap((grant) => {
-				const run = listUnderstandingSourceRuns(grant.id, 1)[0];
-				return run ? [[grant.id, run]] : [];
-			}))
-		});
-	});
-	authenticated.patch("/api/understanding/sources/grants/:grantId", limited, async (c) => {
-		const body = await c.req.json().catch(() => null);
-		if (!body) return c.json({
-			ok: false,
-			error: "Invalid JSON"
-		}, 400);
-		const accessMode = body.accessMode;
-		const retentionPolicy = body.retentionPolicy;
-		const processingPolicy = body.processingPolicy;
-		if (accessMode !== void 0 && accessMode !== "once" && accessMode !== "continuous") return c.json({
-			ok: false,
-			error: "Invalid access mode"
-		}, 400);
-		if (retentionPolicy !== void 0 && retentionPolicy !== "metadata_only" && retentionPolicy !== "derived_only" && retentionPolicy !== "bounded_raw") return c.json({
-			ok: false,
-			error: "Invalid retention policy"
-		}, 400);
-		if (processingPolicy !== void 0 && processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
-			ok: false,
-			error: "Invalid processing policy"
-		}, 400);
-		if (accessMode === void 0 && retentionPolicy === void 0 && processingPolicy === void 0) return c.json({
-			ok: false,
-			error: "At least one policy change is required"
-		}, 400);
-		const grant = updateUnderstandingSourceGrantPolicies(c.req.param("grantId"), {
-			...accessMode ? { accessMode } : {},
-			...retentionPolicy ? { retentionPolicy } : {},
-			...processingPolicy ? { processingPolicy } : {}
-		});
-		return grant ? c.json({
-			ok: true,
-			grant
-		}) : c.json({
-			ok: false,
-			error: "Source grant not found"
-		}, 404);
-	});
-	authenticated.get("/api/understanding/sources/grants/:grantId/impact", (c) => {
-		const impact = sourceRevocationImpact(c.req.param("grantId"));
-		return impact ? c.json({
-			ok: true,
-			impact
-		}) : c.json({
-			ok: false,
-			error: "Source grant not found"
-		}, 404);
-	});
-	authenticated.get("/api/understanding/sources/content-candidates", (c) => {
-		const agentId = resolveDefaultAgentId(deps.service.currentConfig);
-		return c.json({
-			ok: true,
-			candidates: listConnectedContentCandidates({ agentId })
-		});
-	});
-	authenticated.post("/api/understanding/sources/content-reads", limited, async (c) => {
-		const body = await c.req.json().catch(() => null);
-		const sourceItemIds = body && typeof body === "object" && Array.isArray(body.sourceItemIds) ? body.sourceItemIds.filter((value) => typeof value === "string") : [];
-		try {
-			const agentId = resolveDefaultAgentId(deps.service.currentConfig);
-			return c.json({
-				ok: true,
-				result: await readConnectedContent({
-					sourceItemIds,
-					agentId
-				})
-			});
-		} catch (error) {
-			return c.json({
-				ok: false,
-				error: error instanceof Error ? error.message : String(error)
-			}, 400);
-		}
-	});
-	authenticated.delete("/api/understanding/sources/grants/:grantId", limited, (c) => {
-		const grantId = c.req.param("grantId");
-		const impact = sourceRevocationImpact(grantId);
-		const derived = c.req.query("derived");
-		const raw = c.req.query("raw");
-		if (derived !== "delete" && derived !== "retain") return c.json({
-			ok: false,
-			error: "derived must be delete or retain"
-		}, 400);
-		if (raw !== "delete" && raw !== "retain") return c.json({
-			ok: false,
-			error: "raw must be delete or retain"
-		}, 400);
-		const current = impact?.grant;
-		const accountId = typeof current?.config.accountId === "string" ? current.config.accountId : void 0;
-		const connectionId = accountId ? getConnectorAccount(accountId)?.currentConnectionId : void 0;
-		if (connectionId) deps.service.setConnectorLearningPaused(connectionId, true);
-		const grant = revokeUnderstandingSourceGrant(grantId);
-		const deleted = grant && impact ? applySourceRevocationChoices(impact, {
-			derived,
-			raw
-		}) : {
-			derivedDeleted: 0,
-			rawDeleted: 0
-		};
-		return grant ? c.json({
-			ok: true,
-			grant,
-			impact,
-			...deleted
-		}) : c.json({
-			ok: false,
-			error: "Source grant not found"
-		}, 404);
-	});
-	authenticated.post("/api/understanding/sources/grants/:grantId/refresh", limited, async (c) => {
-		const grant = getUnderstandingSourceGrant(c.req.param("grantId"));
-		if (!grant || grant.status !== "active") return c.json({
-			ok: false,
-			error: "Active source grant not found"
-		}, 404);
-		try {
-			if (grant.adapterId === "local-work-folders") {
-				const result = await service.refreshDirectorySourceIfChanged({
-					id: grant.id,
-					idempotencyKey: crypto.randomUUID()
-				});
-				return c.json({
-					ok: true,
-					result
-				}, result.changed ? 202 : 200);
-			}
-			const accountId = typeof grant.config.accountId === "string" ? grant.config.accountId : "";
-			const connectionId = accountId ? getConnectorAccount(accountId)?.currentConnectionId : void 0;
-			if (connectionId) {
-				const job = deps.service.requestConnectorLearning(connectionId, {
-					mode: "incremental",
-					reason: "manual"
-				});
-				return job ? c.json({
-					ok: true,
-					job
-				}, 202) : c.json({
-					ok: false,
-					error: "Source does not support learning"
-				}, 409);
-			}
-			return c.json({
-				ok: false,
-				error: "This source is collected from the desktop app"
-			}, 409);
-		} catch (error) {
-			return c.json({
-				ok: false,
-				error: error instanceof Error ? error.message : String(error)
-			}, 400);
-		}
-	});
-	authenticated.get("/api/understanding/sources/work-folders", (c) => c.json({
-		ok: true,
-		sources: service.listDirectorySources()
-	}));
-	authenticated.post("/api/understanding/sources/work-folders", limited, async (c) => {
-		const body = await c.req.json().catch(() => null);
-		const rootPath = stringField(body, "rootPath");
-		const processingPolicy = stringField(body, "processingPolicy");
-		if (!rootPath) return c.json({
-			ok: false,
-			error: "Missing rootPath"
-		}, 400);
-		if (processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
-			ok: false,
-			error: "Explicit processingPolicy is required"
-		}, 400);
-		try {
-			return c.json({
-				ok: true,
-				source: await service.grantDirectorySource(rootPath, processingPolicy)
-			}, 201);
-		} catch (error) {
-			return c.json({
-				ok: false,
-				error: error instanceof Error ? error.message : String(error)
-			}, 400);
-		}
-	});
-	authenticated.post("/api/understanding/sources/work-folders/:grantId/runs", limited, async (c) => {
-		try {
-			const run = await service.rescanDirectorySource({
-				id: c.req.param("grantId"),
-				idempotencyKey: crypto.randomUUID()
-			});
-			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/understanding/bootstrap", limited, async (c) => {
-		const body = await c.req.json().catch(() => null);
-		const items = body && typeof body === "object" && Array.isArray(body.items) ? body.items.slice(0, 1200) : [];
-		const processingPolicy = stringField(body, "processingPolicy");
-		if (!items.length) return c.json({
-			ok: false,
-			error: "No understanding source items were provided"
-		}, 400);
-		if (processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
-			ok: false,
-			error: "Explicit processingPolicy is required"
-		}, 400);
-		try {
-			const checkpoints = body && typeof body === "object" && body.sourceCheckpoints && typeof body.sourceCheckpoints === "object" ? body.sourceCheckpoints : void 0;
-			const result = await service.importUnderstandingSources(items, processingPolicy, c.req.raw.signal, stringField(body, "workDiscoveryRunId") || void 0, checkpoints);
-			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/understanding/review", limited, async (c) => {
-		const decisions = decisionsFrom(await c.req.json().catch(() => null));
-		if (!decisions.length) return c.json({
-			ok: false,
-			error: "At least one valid decision is required"
-		}, 400);
-		return c.json({
-			ok: true,
-			decisions: service.updateUnderstandingSourceProfile({ decisions })
-		});
-	});
-	authenticated.get("/api/understanding/focuses", (c) => c.json({
-		ok: true,
-		focuses: listUserFocuses()
-	}));
-	authenticated.patch("/api/understanding/focuses/:focusId", limited, async (c) => {
-		const body = await c.req.json().catch(() => null);
-		const requestedStatus = stringField(body, "status");
-		const title = stringField(body, "title");
-		const summary = stringField(body, "summary");
-		if (requestedStatus && !new Set([
-			"candidate",
-			"active",
-			"paused",
-			"completed",
-			"rejected"
-		]).has(requestedStatus)) return c.json({
-			ok: false,
-			error: "Invalid focus status"
-		}, 400);
-		if (body?.title !== void 0 && !title) return c.json({
-			ok: false,
-			error: "Focus title cannot be empty"
-		}, 400);
-		if (body?.summary !== void 0 && !summary) return c.json({
-			ok: false,
-			error: "Focus summary cannot be empty"
-		}, 400);
-		if (title.length > 300 || summary.length > 2e3) return c.json({
-			ok: false,
-			error: "Focus title or summary is too long"
-		}, 400);
-		if (!requestedStatus && !title && !summary) return c.json({
-			ok: false,
-			error: "At least one focus change is required"
-		}, 400);
-		const focus = updateUserFocus(c.req.param("focusId"), {
-			...requestedStatus ? { status: requestedStatus } : {},
-			...title ? { title } : {},
-			...summary ? { summary } : {}
-		});
-		return focus ? c.json({
-			ok: true,
-			focus
-		}) : c.json({
-			ok: false,
-			error: "Focus not found"
-		}, 404);
-	});
-}
-//#endregion
-export { applySourceRevocationChoices, registerUnderstandingSourceRoutes, sourceRevocationImpact };

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

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