@xopcai/xopc 0.0.178 → 0.0.179

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;