@xopcai/xopc 0.0.178 → 0.0.180

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

@@ -1,5 +1,6 @@
 import { listConnectorLearningJobs } from "../../../storage/sqlite/connector-learning-repository.js";
 import { decideConnectorApproval, getConnectorApproval, listConnectorApprovals, listConnectorConnections } from "../../../storage/sqlite/connector-repository.js";
+import { getConnectorSyncPolicy, upsertConnectorSyncPolicy } from "../../../storage/sqlite/connector-sync-policy-repository.js";
 import "../../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveComposioApiKey } from "../../../connectors/composio-sessions.js";
@@ -18,6 +19,7 @@ import { buildConnectedPeopleGraph } from "../../../knowledge/people-graph.js";
 import "../../../knowledge/index.js";
 import { ingestLocalFolderSource } from "../../../connectors/connected-source-ingestion.js";
 import { previewConnectorDefinition, testConnectorInstance } from "../../../connectors/health.js";
+import { getConnectorLearningPlan } from "../../../connectors/learning-recipes.js";
 import { setConnectorEnabled } from "../../../connectors/lifecycle.js";
 import { projectComposioConnectionStatus } from "../../../connectors/runtime-status.js";
 //#region src/gateway/hono/routes/connectors.ts
@@ -25,6 +27,10 @@ init_agent_scope();
 function errorMessage(error) {
 	return error instanceof Error ? error.message : String(error);
 }
+function defaultConnectorSyncInterval(connectorId) {
+	const definition = getConnectorDefinition(connectorId);
+	return definition?.runtime.type === "composio" && definition.runtime.role === "toolkit" ? getConnectorLearningPlan(definition.runtime.toolkit)?.intervalMinutes ?? 30 : 30;
+}
 function registerConnectorRoutes(authenticated, deps) {
 	const { service, strictRateLimitMiddleware } = deps;
 	authenticated.get("/api/connectors/catalog", (c) => {
@@ -92,6 +98,79 @@ function registerConnectorRoutes(authenticated, deps) {
 			payload: { jobs: listConnectorLearningJobs({ limit: 100 }) }
 		});
 	});
+	authenticated.get("/api/connectors/composio/connections/:id/sync-policy", (c) => {
+		const connection = listConnectorConnections({ principalId: "local-owner" }).find((item) => item.id === c.req.param("id"));
+		if (!connection) return c.json({
+			ok: false,
+			error: "Connector connection not found."
+		}, 404);
+		const defaultInterval = defaultConnectorSyncInterval(connection.connectorId);
+		const policy = getConnectorSyncPolicy(connection.id) ?? {
+			connectionId: connection.id,
+			scanEnabled: true,
+			proactiveEnabled: false,
+			intervalMinutes: defaultInterval,
+			allowedScenarioKeys: [],
+			revision: 0,
+			updatedAt: connection.updatedAt
+		};
+		return c.json({
+			ok: true,
+			payload: { policy }
+		});
+	});
+	authenticated.patch("/api/connectors/composio/connections/:id/sync-policy", strictRateLimitMiddleware, async (c) => {
+		const connectionId = c.req.param("id");
+		const connection = listConnectorConnections({ principalId: "local-owner" }).find((item) => item.id === connectionId);
+		if (!connection) return c.json({
+			ok: false,
+			error: "Connector connection not found."
+		}, 404);
+		const body = await c.req.json().catch(() => ({}));
+		const row = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+		if (row.scanEnabled !== void 0 && typeof row.scanEnabled !== "boolean") return c.json({
+			ok: false,
+			error: "scanEnabled must be a boolean."
+		}, 400);
+		if (row.proactiveEnabled !== void 0 && typeof row.proactiveEnabled !== "boolean") return c.json({
+			ok: false,
+			error: "proactiveEnabled must be a boolean."
+		}, 400);
+		if (row.intervalMinutes !== void 0 && (!Number.isInteger(row.intervalMinutes) || Number(row.intervalMinutes) < 5 || Number(row.intervalMinutes) > 1440)) return c.json({
+			ok: false,
+			error: "intervalMinutes must be an integer from 5 to 1440."
+		}, 400);
+		const allowedScenarioKeys = row.allowedScenarioKeys === void 0 ? void 0 : Array.isArray(row.allowedScenarioKeys) ? [...new Set(row.allowedScenarioKeys.filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean))] : null;
+		if (allowedScenarioKeys === null) return c.json({
+			ok: false,
+			error: "allowedScenarioKeys must be an array of strings."
+		}, 400);
+		const knownScenarioKeys = new Set(service.proactiveScenarios.list().map((scenario) => scenario.key));
+		if (allowedScenarioKeys?.some((key) => !knownScenarioKeys.has(key))) return c.json({
+			ok: false,
+			error: "allowedScenarioKeys contains an unknown scenario."
+		}, 400);
+		const previous = getConnectorSyncPolicy(connectionId);
+		const policy = upsertConnectorSyncPolicy({
+			connectionId,
+			defaultIntervalMinutes: defaultConnectorSyncInterval(connection.connectorId),
+			...typeof row.scanEnabled === "boolean" ? { scanEnabled: row.scanEnabled } : {},
+			...typeof row.proactiveEnabled === "boolean" ? { proactiveEnabled: row.proactiveEnabled } : {},
+			...typeof row.intervalMinutes === "number" ? { intervalMinutes: row.intervalMinutes } : {},
+			...allowedScenarioKeys ? { allowedScenarioKeys } : {}
+		});
+		if (!policy.scanEnabled) service.setConnectorLearningPaused(connectionId, true);
+		else if (previous?.scanEnabled === false) {
+			if (service.setConnectorLearningPaused(connectionId, false) === 0) service.requestConnectorLearning(connectionId, {
+				mode: "incremental",
+				reason: "schedule"
+			});
+		}
+		return c.json({
+			ok: true,
+			payload: { policy }
+		});
+	});
 	authenticated.post("/api/connectors/composio/connections/:id/learning", strictRateLimitMiddleware, async (c) => {
 		try {
 			await listComposioConnections();

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

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

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

@@ -0,0 +1,177 @@
+import { DiscussionServiceError } from "../../../discussions/service.js";
+import { DISCUSSION_STATUSES } from "../../../discussions/types.js";
+import "../../../discussions/index.js";
+//#region src/gateway/hono/routes/discussions.ts
+function errorResponse(error) {
+	if (!(error instanceof DiscussionServiceError)) return null;
+	const status = error.code === "not_found" ? 404 : error.code === "conflict" ? 409 : 400;
+	return {
+		body: {
+			error: error.message,
+			code: error.code
+		},
+		status
+	};
+}
+async function multipart(c) {
+	try {
+		return await c.req.parseBody({ all: true });
+	} catch {
+		return null;
+	}
+}
+function registerDiscussionRoutes(authenticated, deps) {
+	const { service, strictRateLimitMiddleware } = deps;
+	authenticated.get("/api/discussion-capture/settings", (c) => c.json(service.discussions.settings()));
+	authenticated.put("/api/discussion-capture/settings", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		if (!Number.isInteger(body.consentPolicyVersion)) return c.json({ error: "consentPolicyVersion must be an integer" }, 400);
+		try {
+			return c.json(service.discussions.acknowledgeConsent(Number(body.consentPolicyVersion)));
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.post("/api/discussions", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		try {
+			const detail = await service.discussions.create({
+				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"
+			});
+			return c.json(detail, 201);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.get("/api/discussions", (c) => {
+		const statusRaw = c.req.query("status");
+		if (statusRaw && statusRaw !== "active" && !DISCUSSION_STATUSES.includes(statusRaw)) return c.json({ error: "Invalid discussion status" }, 400);
+		const status = statusRaw === "active" ? "active" : DISCUSSION_STATUSES.includes(statusRaw) ? statusRaw : void 0;
+		const limit = Number.parseInt(c.req.query("limit") ?? "", 10);
+		const offset = Number.parseInt(c.req.query("offset") ?? "", 10);
+		return c.json(service.discussions.list({
+			status,
+			projectId: c.req.query("projectId")?.trim() || void 0,
+			limit: Number.isFinite(limit) ? limit : void 0,
+			offset: Number.isFinite(offset) ? offset : void 0
+		}));
+	});
+	authenticated.get("/api/discussions/metrics", (c) => c.json(service.discussions.metrics()));
+	authenticated.get("/api/discussions/by-note/:noteId", async (c) => {
+		const detail = await service.discussions.getByNoteId(c.req.param("noteId"));
+		return detail ? c.json(detail) : c.json({ error: "Discussion not found" }, 404);
+	});
+	authenticated.get("/api/discussions/:id", async (c) => {
+		const detail = await service.discussions.get(c.req.param("id"));
+		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"));
+		return transcript ? c.json(transcript) : c.json({ error: "Discussion not found" }, 404);
+	});
+	authenticated.put("/api/discussions/:id/segments/:sequence", 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);
+		const sequence = Number.parseInt(c.req.param("sequence"), 10);
+		const startedAtMs = Number(body.startedAtMs);
+		const endedAtMs = Number(body.endedAtMs);
+		const sha256 = typeof body.sha256 === "string" ? body.sha256 : "";
+		try {
+			return c.json(service.discussions.uploadSegment({
+				discussionId: c.req.param("id"),
+				sequence,
+				file: {
+					buffer: Buffer.from(await file.arrayBuffer()),
+					mimeType: file.type
+				},
+				startedAtMs,
+				endedAtMs,
+				sha256
+			}), 201);
+		} 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);
+		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);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.post("/api/discussions/:id/finish", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		try {
+			const detail = await service.discussions.finish(c.req.param("id"), Number(body.lastSequence), Number(body.durationMs));
+			return detail ? c.json(detail) : c.json({ error: "Discussion 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/retry", strictRateLimitMiddleware, async (c) => {
+		try {
+			const detail = await service.discussions.retry(c.req.param("id"));
+			return detail ? c.json(detail) : c.json({ error: "Discussion 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/cancel", strictRateLimitMiddleware, async (c) => {
+		try {
+			const detail = await service.discussions.cancel(c.req.param("id"));
+			return detail ? c.json(detail) : c.json({ error: "Discussion not found" }, 404);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.delete("/api/discussions/:id/audio", strictRateLimitMiddleware, async (c) => {
+		try {
+			const detail = await service.discussions.deleteAudio(c.req.param("id"));
+			return detail ? c.json(detail) : c.json({ error: "Discussion not found" }, 404);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+	authenticated.delete("/api/discussions/:id/project", strictRateLimitMiddleware, async (c) => {
+		try {
+			const detail = await service.discussions.unlinkInferredProject(c.req.param("id"));
+			return detail ? c.json(detail) : c.json({ error: "Discussion not found" }, 404);
+		} catch (error) {
+			const response = errorResponse(error);
+			if (response) return c.json(response.body, response.status);
+			throw error;
+		}
+	});
+}
+//#endregion
+export { registerDiscussionRoutes };

package/dist/src/gateway/hono/routes/execution-receipts.d.ts

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

package/dist/src/gateway/hono/routes/execution-receipts.js

@@ -0,0 +1,163 @@
+import { findExecutionReceiptForAssistant, listExecutionReceipts, setExecutionReceiptFeedbackByRunId, setExecutionVerdict, summarizeExecutionReceipts, updateExecutionReceipt } from "../../../storage/sqlite/execution-receipt-repository.js";
+import "../../../storage/sqlite/index.js";
+import { OutcomeReceiptService } from "../../../work/outcome-receipt-service.js";
+import { OutcomeProjectionService } from "../../../work/outcome-projection-service.js";
+import { replayExecutionEvaluation } from "../../../agent/outcomes/execution-evaluation.js";
+//#region src/gateway/hono/routes/execution-receipts.ts
+function parseLimit(raw) {
+	if (!raw) return void 0;
+	const value = Number.parseInt(raw, 10);
+	return Number.isFinite(value) ? value : void 0;
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isExecutionContract(value) {
+	if (!value || typeof value !== "object") return false;
+	const contract = value;
+	return typeof contract.objective === "string" && isStringArray(contract.deliverables) && isStringArray(contract.acceptanceCriteria) && isStringArray(contract.constraints) && isStringArray(contract.approvalRequired);
+}
+function isExecutionEvidence(value) {
+	return Array.isArray(value) && value.every((item) => {
+		if (!item || typeof item !== "object") return false;
+		const evidence = item;
+		return (evidence.kind === "artifact" || evidence.kind === "test" || evidence.kind === "state" || evidence.kind === "source") && typeof evidence.title === "string" && typeof evidence.summary === "string" && (evidence.uri === void 0 || typeof evidence.uri === "string") && (evidence.verifies === void 0 || isStringArray(evidence.verifies));
+	});
+}
+function registerExecutionReceiptRoutes(authenticated, _deps) {
+	const receipts = new OutcomeReceiptService();
+	const projections = new OutcomeProjectionService();
+	authenticated.get("/api/execution-receipts", (c) => {
+		const items = receipts.list({
+			sessionKey: c.req.query("sessionKey")?.trim() || void 0,
+			projectId: c.req.query("projectId")?.trim() || void 0,
+			workItemId: c.req.query("workItemId")?.trim() || void 0,
+			limit: parseLimit(c.req.query("limit"))
+		});
+		return c.json({
+			ok: true,
+			items
+		});
+	});
+	authenticated.get("/api/execution-receipts/metrics", (c) => {
+		return c.json({
+			ok: true,
+			metrics: summarizeExecutionReceipts()
+		});
+	});
+	authenticated.get("/api/execution-receipts/evaluation", (c) => {
+		const items = listExecutionReceipts({ limit: parseLimit(c.req.query("limit")) ?? 100 });
+		return c.json({
+			ok: true,
+			evaluation: replayExecutionEvaluation(items)
+		});
+	});
+	authenticated.get("/api/execution-receipts/for-assistant", (c) => {
+		const sessionKey = c.req.query("sessionKey")?.trim() ?? "";
+		const assistantTimestamp = Number(c.req.query("assistantTimestamp"));
+		if (!sessionKey || !Number.isFinite(assistantTimestamp) || assistantTimestamp <= 0) return c.json({
+			ok: false,
+			error: "sessionKey and assistantTimestamp are required"
+		}, 400);
+		const receipt = findExecutionReceiptForAssistant(sessionKey, assistantTimestamp);
+		return receipt ? c.json({
+			ok: true,
+			receipt
+		}) : c.json({
+			ok: false,
+			error: "Execution receipt not found"
+		}, 404);
+	});
+	authenticated.get("/api/execution-receipts/:runId", (c) => {
+		const receipt = receipts.get(c.req.param("runId"));
+		return receipt ? c.json({
+			ok: true,
+			receipt
+		}) : c.json({
+			ok: false,
+			error: "Execution receipt not found"
+		}, 404);
+	});
+	authenticated.patch("/api/execution-receipts/:runId", async (c) => {
+		const body = await c.req.json().catch(() => null);
+		if (!body || typeof body !== "object") return c.json({
+			ok: false,
+			error: "Invalid JSON body"
+		}, 400);
+		if (body.contract !== void 0 && !isExecutionContract(body.contract)) return c.json({
+			ok: false,
+			error: "Invalid execution contract"
+		}, 400);
+		if (body.evidence !== void 0 && !isExecutionEvidence(body.evidence)) return c.json({
+			ok: false,
+			error: "Invalid execution evidence"
+		}, 400);
+		if (body.summary !== void 0 && typeof body.summary !== "string") return c.json({
+			ok: false,
+			error: "Invalid execution summary"
+		}, 400);
+		const receipt = updateExecutionReceipt({
+			runId: c.req.param("runId"),
+			...body.contract === void 0 ? {} : { contract: body.contract },
+			...body.evidence === void 0 ? {} : { evidence: body.evidence },
+			...body.summary === void 0 ? {} : { summary: body.summary }
+		});
+		if (!receipt) return c.json({
+			ok: false,
+			error: "Execution receipt not found"
+		}, 404);
+		const projected = receipt.status === "running" ? receipt : projections.project(receipt);
+		return c.json({
+			ok: true,
+			receipt: receipts.get(projected.runId)
+		});
+	});
+	authenticated.post("/api/execution-receipts/:runId/feedback", _deps.strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		const feedback = body.outcome === "helpful" || body.outcome === "not_helpful" ? body.outcome : void 0;
+		if (!feedback) return c.json({
+			ok: false,
+			error: "outcome must be helpful or not_helpful"
+		}, 400);
+		const reason = typeof body.reason === "string" ? body.reason.trim().slice(0, 160) : void 0;
+		const receipt = setExecutionReceiptFeedbackByRunId({
+			runId: c.req.param("runId"),
+			outcome: feedback,
+			reason: reason || void 0,
+			needsCorrection: feedback === "not_helpful",
+			supportFit: typeof body.supportFit === "boolean" ? body.supportFit : void 0
+		});
+		return receipt ? c.json({
+			ok: true,
+			receipt: receipts.get(receipt.runId)
+		}) : c.json({
+			ok: false,
+			error: "Outcome receipt not found"
+		}, 404);
+	});
+	authenticated.post("/api/execution-receipts/:runId/verdict", _deps.strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		const verdict = body?.verdict;
+		if (verdict !== "achieved" && verdict !== "partial" && verdict !== "not_achieved") return c.json({
+			ok: false,
+			error: "verdict must be achieved, partial, or not_achieved"
+		}, 400);
+		const correctionText = typeof body?.correctionText === "string" ? body.correctionText.trim().slice(0, 2e3) : void 0;
+		const receipt = setExecutionVerdict({
+			runId: c.req.param("runId"),
+			verdict,
+			correctionText: correctionText || void 0
+		});
+		if (!receipt) return c.json({
+			ok: false,
+			error: "Completed execution receipt not found"
+		}, 404);
+		const projected = projections.project(receipt);
+		return c.json({
+			ok: true,
+			receipt: receipts.get(projected.runId)
+		});
+	});
+}
+//#endregion
+export { registerExecutionReceiptRoutes };

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

@@ -1,6 +1,6 @@
+import { consumeTunnelMutationLimit } from "../../../tunnel/tunnel-rate-limit.js";
 import { extractToken } from "../../auth.js";
 import { getExposureManager } from "../../../remote-access/exposure-manager.js";
-import { consumeTunnelMutationLimit } from "../../../tunnel/tunnel-rate-limit.js";
 //#region src/gateway/hono/routes/exposure.ts
 function requireGatewayToken(c) {
 	return extractToken({ authorization: c.req.header("authorization") ?? void 0 }) ?? null;