@xopcai/xopc 0.0.285 → 0.0.291

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

@@ -470,14 +470,14 @@ function registerConnectorRoutes(authenticated, deps) {
 			error: "Invalid approval status."
 		}, 400);
 		const principalId = c.req.query("principalId")?.trim() || "local-owner";
-		const sessionKey = c.req.query("sessionKey")?.trim() || void 0;
-		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "gateway.admin") && (!sessionKey || principalId !== "local-owner")) return c.json({
+		const conversationId = c.req.query("conversationId")?.trim() || void 0;
+		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "gateway.admin") && (!conversationId || principalId !== "local-owner")) return c.json({
 			ok: false,
 			error: "A local-owner session is required to read confirmations."
 		}, 403);
 		const approvals = listConnectorApprovals({
 			principalId,
-			sessionKey,
+			conversationId,
 			status,
 			limit: Number(c.req.query("limit") ?? "100")
 		});
@@ -595,8 +595,8 @@ function registerConnectorRoutes(authenticated, deps) {
 			ok: false,
 			error: "Connector approval not found."
 		}, 404);
-		const sessionKey = typeof record.sessionKey === "string" ? record.sessionKey.trim() : "";
-		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "gateway.admin") && (!sessionKey || current.sessionKey !== sessionKey || current.principalId !== "local-owner")) return c.json({
+		const conversationId = typeof record.conversationId === "string" ? record.conversationId.trim() : "";
+		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "gateway.admin") && (!conversationId || current.conversationId !== conversationId || current.principalId !== "local-owner")) return c.json({
 			ok: false,
 			error: "Confirmation does not belong to the requested local-owner session."
 		}, 403);

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

@@ -1,4 +1,4 @@
-import { getSqliteDatabase } from "../../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../../../storage/sqlite/transaction.js";
 import { countKnowledgeSourceItems, deleteKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
 import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
 import "../../../storage/sqlite/index.js";
@@ -11,6 +11,7 @@ import { listUnderstandingSourceDefinitions } from "../../../user-context/source
 import { randomUUID } from "node:crypto";
 //#region src/gateway/hono/routes/context-sources.ts
 init_agent_scope();
+init_transaction();
 function stringField(value, field) {
 	if (!value || typeof value !== "object") return "";
 	const fieldValue = value[field];

package/dist/src/gateway/hono/routes/device-pairing-approval.js

@@ -1,4 +1,5 @@
 import { devicePairingCompleteSchema, devicePairingProofSchema, devicePairingRequestSchema } from "../../../../packages/gateway-contract/src/device-pairing.js";
+import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { getOrCreateGatewayIdentity, signGatewayPayload } from "../../../storage/sqlite/gateway-identity-repository.js";
 import { resolveClientIpFromRequest } from "../../client-ip.js";
 import { buckets } from "../../rate-limit/buckets.js";
@@ -9,6 +10,7 @@ import { z } from "zod";
 import { bodyLimit } from "hono/body-limit";
 import { getConnInfo } from "@hono/node-server/conninfo";
 //#region src/gateway/hono/routes/device-pairing-approval.ts
+init_src();
 function pairingClientKey(c, options) {
 	let remoteAddress;
 	try {

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

@@ -1,4 +1,5 @@
 import { devicePairingInvitationPayloadSchema, devicePairingTargetKindSchema, formatBrowserPairingInvitation } from "../../../../packages/gateway-contract/src/device-pairing.js";
+import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { listDevices, revokeDevice, rotateDeviceRefreshToken } from "../../../storage/sqlite/device-access-repository.js";
 import { getGatewayIdentityPublicKeyRaw, getOrCreateGatewayIdentity, signGatewayPayload } from "../../../storage/sqlite/gateway-identity-repository.js";
 import { createDevicePairingSetup, isDevicePairingSetupActive } from "../../../storage/sqlite/device-pairing-repository.js";
@@ -11,6 +12,7 @@ import os from "node:os";
 import { z } from "zod";
 import { bodyLimit } from "hono/body-limit";
 //#region src/gateway/hono/routes/devices.ts
+init_src();
 const refreshRequestSchema = z.strictObject({
 	refreshToken: z.string().min(1).max(256),
 	timestamp: z.number().int().positive(),

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

@@ -1,11 +1,11 @@
 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 { convertMeetingAction, meetingActionTasks } from "../../../discussions/action-tasks.js";
-import { exportDiscussion } from "../../../discussions/export.js";
 import { createReadStream } from "node:fs";
 import { stat } from "node:fs/promises";
 import { Readable } from "node:stream";

package/dist/src/gateway/hono/routes/endpoint-tools.js

@@ -1,5 +1,5 @@
 import { getDevice } from "../../../storage/sqlite/device-access-repository.js";
-import { endpointPrincipalRegistrationSchema, endpointSessionBindingRequestSchema } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { endpointPrincipalRegistrationSchema, endpointSessionBindingRequestSchema, init_src } from "../../../../packages/endpoint-tools-protocol/src/index.js";
 import { createEndpointPrincipal, getEndpointPrincipal, listEndpointPrincipals, revokeEndpointPrincipal } from "../../../storage/sqlite/endpoint-principal-repository.js";
 import { listEndpointToolInvocationAudits } from "../../../storage/sqlite/endpoint-tool-invocation-repository.js";
 import "../../../storage/sqlite/index.js";
@@ -7,6 +7,7 @@ import { parseEndpointPublicKey } from "../../../endpoint-tools/auth.js";
 import { ENDPOINT_UPLOAD_MAX_BYTES, EndpointUploadError } from "../../../endpoint-tools/upload-service.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 //#region src/gateway/hono/routes/endpoint-tools.ts
+init_src();
 async function readBoundedBody(body, maxBytes) {
 	if (!body) return new Uint8Array();
 	const reader = body.getReader();
@@ -145,9 +146,9 @@ function registerEndpointToolRoutes(authenticated, deps) {
 			payload: listEndpointToolInvocationAudits(Number.isFinite(limit) ? limit : 100)
 		});
 	});
-	authenticated.get("/api/endpoint-tools/bindings/:sessionKey", (c) => {
+	authenticated.get("/api/endpoint-tools/bindings/:conversationId", (c) => {
 		try {
-			const binding = deps.service.endpointTools.bindings.get(c.req.param("sessionKey"));
+			const binding = deps.service.endpointTools.bindings.get(c.req.param("conversationId"));
 			return binding ? c.json({
 				ok: true,
 				payload: binding
@@ -168,7 +169,7 @@ function registerEndpointToolRoutes(authenticated, deps) {
 			}, 400);
 		}
 	});
-	authenticated.put("/api/endpoint-tools/bindings/:sessionKey", async (c) => {
+	authenticated.put("/api/endpoint-tools/bindings/:conversationId", async (c) => {
 		const parsed = endpointSessionBindingRequestSchema.safeParse(await c.req.json().catch(() => null));
 		if (!parsed.success) return c.json({
 			ok: false,
@@ -187,7 +188,7 @@ function registerEndpointToolRoutes(authenticated, deps) {
 			}
 		}, 403);
 		try {
-			const binding = deps.service.endpointTools.bindings.bind(c.req.param("sessionKey"), parsed.data.endpointId);
+			const binding = deps.service.endpointTools.bindings.bind(c.req.param("conversationId"), parsed.data.endpointId);
 			return c.json({
 				ok: true,
 				payload: binding
@@ -204,9 +205,9 @@ function registerEndpointToolRoutes(authenticated, deps) {
 			}, status);
 		}
 	});
-	authenticated.delete("/api/endpoint-tools/bindings/:sessionKey", (c) => {
+	authenticated.delete("/api/endpoint-tools/bindings/:conversationId", (c) => {
 		try {
-			const removed = deps.service.endpointTools.bindings.unbind(c.req.param("sessionKey"));
+			const removed = deps.service.endpointTools.bindings.unbind(c.req.param("conversationId"));
 			return c.json({
 				ok: true,
 				payload: { removed }
@@ -235,8 +236,9 @@ function registerEndpointToolRoutes(authenticated, deps) {
 			}
 		}, 413);
 		try {
-			const bytes = await readBoundedBody(c.req.raw.body, ENDPOINT_UPLOAD_MAX_BYTES);
-			const file = deps.service.endpointTools.uploads.upload({
+			const limits = deps.service.endpointTools.uploads.getGrantLimits(invocationId, endpointId, token);
+			const bytes = await readBoundedBody(c.req.raw.body, limits.maxBytes);
+			const file = await deps.service.endpointTools.uploads.uploadValidated({
 				invocationId,
 				endpointId,
 				token,

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

@@ -54,8 +54,8 @@ function registerExecutionEnvironmentRoutes(authenticated, deps) {
 			})
 		});
 	});
-	authenticated.get("/api/sessions/:sessionKey/environment", (c) => {
-		const environment = sessions.get(c.req.param("sessionKey"));
+	authenticated.get("/api/sessions/:conversationId/environment", (c) => {
+		const environment = sessions.get(c.req.param("conversationId"));
 		return environment ? c.json({
 			ok: true,
 			environment
@@ -64,13 +64,13 @@ function registerExecutionEnvironmentRoutes(authenticated, deps) {
 			error: "Execution environment not found"
 		}, 404);
 	});
-	authenticated.post("/api/sessions/:sessionKey/environment", async (c) => {
-		const sessionKey = c.req.param("sessionKey");
-		if (deps.service.getActiveWebchatRunId(sessionKey)) return c.json({
+	authenticated.post("/api/sessions/:conversationId/environment", async (c) => {
+		const conversationId = c.req.param("conversationId");
+		if (deps.service.getActiveWebchatRunId(conversationId)) return c.json({
 			ok: false,
 			error: "Stop the active session run before changing its environment"
 		}, 409);
-		const session = await deps.service.sessions.getSession(sessionKey);
+		const session = await deps.service.sessions.getSession(conversationId);
 		if (!session) return c.json({
 			ok: false,
 			error: "Session not found"
@@ -89,7 +89,7 @@ function registerExecutionEnvironmentRoutes(authenticated, deps) {
 		}, 400);
 		try {
 			const environment = await sessions.attach({
-				sessionKey,
+				conversationId,
 				project,
 				mode,
 				baseRef: typeof body.baseRef === "string" ? body.baseRef : void 0
@@ -102,14 +102,14 @@ function registerExecutionEnvironmentRoutes(authenticated, deps) {
 			return c.json(errorResponse(error), 409);
 		}
 	});
-	authenticated.delete("/api/sessions/:sessionKey/environment", async (c) => {
-		const sessionKey = c.req.param("sessionKey");
-		if (deps.service.getActiveWebchatRunId(sessionKey)) return c.json({
+	authenticated.delete("/api/sessions/:conversationId/environment", async (c) => {
+		const conversationId = c.req.param("conversationId");
+		if (deps.service.getActiveWebchatRunId(conversationId)) return c.json({
 			ok: false,
 			error: "Stop the active session run before releasing its environment"
 		}, 409);
 		try {
-			const environment = await sessions.release(sessionKey, c.req.query("keepManaged") !== "true");
+			const environment = await sessions.release(conversationId, c.req.query("keepManaged") !== "true");
 			return c.json({
 				ok: true,
 				environment

package/dist/src/gateway/hono/routes/file-references.js

@@ -1,5 +1,5 @@
 import { FileServiceError } from "../../../files/file-service.js";
-import { buildFilePathClassifierContext, classifyFileLocation, displayNameForPath, fileRefSessionKeysMatch, resolveFileReferenceCandidate } from "../../file-path-classifier.js";
+import { buildFilePathClassifierContext, classifyFileLocation, displayNameForPath, fileRefConversationIdsMatch, resolveFileReferenceCandidate } from "../../file-path-classifier.js";
 import { classifyFileReferenceFsError } from "../../file-reference-errors.js";
 import { FileReferenceRegistry } from "../../file-reference-registry.js";
 import { getGatewayFileSpaceService } from "../../file-space-service.js";
@@ -14,10 +14,10 @@ function registerFileReferenceRoutes(app, deps) {
 		if (!body.spaceId || !body.path?.trim()) return c.json({ error: { message: "spaceId and path are required" } }, 400);
 		try {
 			const space = await files.get(body.spaceId);
-			const sessionKey = body.sessionKey?.trim();
+			const conversationId = body.conversationId?.trim();
 			const agentId = space.bindings.find((binding) => binding.kind === "agent")?.id;
 			const ctx = {
-				...buildFilePathClassifierContext(deps.service.currentConfig, sessionKey || (agentId ? `agent:${agentId}:main` : void 0)),
+				...buildFilePathClassifierContext(deps.service.currentConfig, conversationId, conversationId ? void 0 : agentId),
 				workspaceRoot: space.root
 			};
 			const inputPath = body.path.trim();
@@ -56,7 +56,7 @@ function registerFileReferenceRoutes(app, deps) {
 			] : ["copyPath"];
 			const ref = refs.register({
 				absolutePath,
-				sessionKey,
+				conversationId,
 				...classified,
 				capabilities
 			});
@@ -79,7 +79,7 @@ function registerFileReferenceRoutes(app, deps) {
 		const ref = refs.resolve(c.req.param("id"));
 		if (!ref) return c.json({ error: { message: "File reference expired" } }, 404);
 		const body = await c.req.json();
-		if (!fileRefSessionKeysMatch(ref.sessionKey, body.sessionKey)) return c.json({ error: { message: "File reference forbidden" } }, 403);
+		if (!fileRefConversationIdsMatch(ref.conversationId, body.conversationId)) return c.json({ error: { message: "File reference forbidden" } }, 403);
 		if (body.action !== "openExternal" && body.action !== "revealInFolder" || !ref.capabilities.includes(body.action)) return c.json({ error: { message: "Action not allowed" } }, 403);
 		try {
 			if (await realpath(ref.absolutePath) !== ref.absolutePath) return c.json({ error: { message: "File reference changed" } }, 409);

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

@@ -85,7 +85,7 @@ function registerHomeRoutes(authenticated, deps) {
 		return c.json({
 			ok: true,
 			runId: result.runId,
-			sessionKey: result.sessionKey
+			conversationId: result.conversationId
 		}, 202);
 	});
 }

package/dist/src/gateway/hono/routes/interaction-state.js

@@ -10,9 +10,9 @@ const SUPPORT_NEEDS = new Set([
 ]);
 function registerInteractionStateRoutes(authenticated, deps) {
 	authenticated.get("/api/interaction-state", (c) => {
-		const sessionKey = c.req.query("sessionKey")?.trim() ?? "";
-		if (!sessionKey) return c.json({ error: "sessionKey is required" }, 400);
-		const state = getInteractionState(sessionKey);
+		const conversationId = c.req.query("conversationId")?.trim() ?? "";
+		if (!conversationId) return c.json({ error: "conversationId is required" }, 400);
+		const state = getInteractionState(conversationId);
 		return state ? c.json({
 			ok: true,
 			state
@@ -23,11 +23,11 @@ function registerInteractionStateRoutes(authenticated, deps) {
 	});
 	authenticated.patch("/api/interaction-state", deps.strictRateLimitMiddleware, async (c) => {
 		const body = await c.req.json().catch(() => null);
-		const sessionKey = body && typeof body === "object" && typeof body.sessionKey === "string" ? body.sessionKey.trim() : "";
+		const conversationId = body && typeof body === "object" && typeof body.conversationId === "string" ? body.conversationId.trim() : "";
 		const supportNeed = body && typeof body === "object" && SUPPORT_NEEDS.has(body.supportNeed) ? body.supportNeed : void 0;
-		if (!sessionKey || !supportNeed) return c.json({ error: "sessionKey and a valid supportNeed are required" }, 400);
+		if (!conversationId || !supportNeed) return c.json({ error: "conversationId and a valid supportNeed are required" }, 400);
 		const state = setInteractionState({
-			sessionKey,
+			conversationId,
 			signal: {
 				supportNeed,
 				confidence: 1,

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

@@ -12,8 +12,8 @@ function registerLogsRoutes(authenticated, _deps) {
 			q: query.q,
 			module: query.module,
 			requestId: query.requestId,
-			sessionKey: query.sessionKey,
-			sessionId: query.sessionId,
+			conversationId: query.conversationId,
+			transcriptId: query.transcriptId,
 			limit: query.limit ? parseInt(query.limit) : 100,
 			offset: query.offset ? parseInt(query.offset) : 0
 		});

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

@@ -63,15 +63,15 @@ function registerMediaRoutes(authenticated, deps) {
 			ok: false,
 			error: { message: "Missing uri" }
 		}, 400);
-		const sessionKey = c.req.query("sessionKey");
+		const conversationId = c.req.query("conversationId");
 		const taskId = c.req.query("taskId");
-		if (!sessionKey && !taskId) return c.json({
+		if (!conversationId && !taskId) return c.json({
 			ok: false,
 			error: { message: "Missing media scope" }
 		}, 400);
 		try {
 			const { buffer, path } = await readMediaReference((await resolveScopedMediaReference(deps.service, uriRaw.trim(), {
-				sessionKey,
+				conversationId,
 				taskId
 			})).uri, MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);
 			const contentType = mimeTypeFromMediaPath(path);

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

@@ -1,5 +1,6 @@
-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 { computerModelProfile, init_model_policy } from "../../../computer/model-policy.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";
@@ -22,6 +23,7 @@ import { auditModelReferences } from "../../../providers/model-reference-auditor
 import { getOnboardingFeaturedProviders, getProviderHint, getRecommendedModelsForProvider, isRecommendedModel, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
 import { XopcCloudAccountError, XopcCloudAccountService } from "../../../providers/xopc-cloud-account-service.js";
 //#region src/gateway/hono/routes/models.ts
+init_model_policy();
 init_models_json();
 init_resolve_config_value();
 init_providers();
@@ -118,7 +120,7 @@ function registerModelsRoutes(authenticated, deps) {
 				code: "catalog_stale",
 				capability: null
 			}] : [],
-			...Object.values(capabilities).filter((plan) => authorized && catalog.modelCount > 0 && plan.status === "unavailable").map((plan) => ({
+			...Object.values(capabilities).filter((plan) => authorized && catalog.modelCount > 0 && plan.status === "unavailable" && plan.capability !== "computer-use").map((plan) => ({
 				code: "capability_not_published",
 				capability: plan.capability
 			}))
@@ -298,12 +300,13 @@ function registerModelsRoutes(authenticated, deps) {
 			name: m.name,
 			...catalogDisplayNames(m.provider, m.id),
 			provider: m.provider,
+			...computerModelProfile(m) ? { computerUse: { profile: computerModelProfile(m) } } : {},
 			contextWindow: m.contextWindow ?? 128e3,
 			maxTokens: m.maxTokens ?? 4096,
 			reasoning: m.reasoning ?? false,
 			thinking: getModelThinking(m),
 			vision: m.input?.includes("image") ?? false,
-			recommended: isRecommendedModel(m.provider, m.id),
+			recommended: !computerModelProfile(m) && isRecommendedModel(m.provider, m.id),
 			cost: {
 				input: m.cost?.input ?? 0,
 				output: m.cost?.output ?? 0

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

@@ -1,5 +1,5 @@
 import { ObjectLinkService } from "../../../activity/service.js";
-import { buildSessionKey, init_session_key } from "../../../routing/session-key.js";
+import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
 import { getShareStore } from "../../../share/share-store.js";
@@ -263,7 +263,7 @@ function registerNotesRoutes(authenticated, deps) {
 			attachedAt: Date.now()
 		};
 		const forceNew = body.forceNew === true;
-		const existingKey = note.aiDeep?.catalysis?.sourceSessionKey;
+		const existingKey = note.aiDeep?.catalysis?.sourceConversationId;
 		if (!forceNew && existingKey) {
 			const existingSession = await service.sessions.getSession(existingKey);
 			if (existingSession) {
@@ -278,21 +278,21 @@ function registerNotesRoutes(authenticated, deps) {
 				});
 				return c.json({
 					session: existingSession,
-					sessionKey: existingKey,
+					conversationId: existingKey,
 					reused: true,
 					sourceBinding
 				});
 			}
 		}
 		const peerId = `note_${noteId}_${Date.now()}`;
-		const sessionKey = buildSessionKey({
+		const conversationId = resolveConversationId({
 			agentId,
 			source: "webchat",
 			accountId: "default",
 			peerKind: "direct",
 			peerId
 		});
-		await service.sessionIndexInstance.saveMessages(sessionKey, [], { metadata: {
+		await service.sessionIndexInstance.saveMessages(conversationId, [], { metadata: {
 			...projectId ? { projectId } : {},
 			sourceChannel: "webchat",
 			sourceChatId: `default:direct:${peerId}`,
@@ -306,8 +306,8 @@ function registerNotesRoutes(authenticated, deps) {
 				peerId
 			}
 		} });
-		const meta = await service.sessionIndexInstance.getSessionMetadata(sessionKey);
-		await service.sessionIndexInstance.updateSessionMetadata(sessionKey, {
+		const meta = await service.sessionIndexInstance.getSessionMetadata(conversationId);
+		await service.sessionIndexInstance.updateSessionMetadata(conversationId, {
 			...projectId ? { projectId } : {},
 			name: noteThreadName(note),
 			tags: Array.from(new Set([...meta?.tags ?? [], "note"])),
@@ -317,11 +317,11 @@ function registerNotesRoutes(authenticated, deps) {
 				sourceBinding
 			}
 		});
-		await service.notesServiceInstance.linkNoteThread(noteId, sessionKey);
-		const session = await service.sessions.getSession(sessionKey);
+		await service.notesServiceInstance.linkNoteThread(noteId, conversationId);
+		const session = await service.sessions.getSession(conversationId);
 		return c.json({
 			session,
-			sessionKey,
+			conversationId,
 			reused: false,
 			sourceBinding
 		}, 201);
@@ -606,7 +606,7 @@ function registerNotesRoutes(authenticated, deps) {
 		const note = await service.notesServiceInstance.createTask(title, source, {
 			dueAt: typeof body.dueAt === "number" ? body.dueAt : void 0,
 			priority: body.priority === "high" || body.priority === "medium" || body.priority === "low" ? body.priority : void 0,
-			sourceSessionKey: typeof body.sourceSessionKey === "string" ? body.sourceSessionKey : void 0,
+			sourceConversationId: typeof body.sourceConversationId === "string" ? body.sourceConversationId : void 0,
 			sourceNoteId: typeof body.sourceNoteId === "string" ? body.sourceNoteId : void 0,
 			groupId: typeof body.groupId === "string" ? body.groupId : void 0
 		});

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

@@ -99,10 +99,10 @@ function textFromTranscriptContent(content) {
 		return typeof record.text === "string" ? record.text : "";
 	}).filter(Boolean).join("\n");
 }
-function buildSessionSummaryKnowledgeContent(sessionKey, explicitSummary) {
+function buildSessionSummaryKnowledgeContent(conversationId, explicitSummary) {
 	const summary = explicitSummary?.trim();
 	if (summary) return summary;
-	const lines = loadTranscriptRowsForSession(sessionKey).filter((row) => {
+	const lines = loadTranscriptRowsForSession(conversationId).filter((row) => {
 		if (!row || typeof row !== "object") return false;
 		const role = row.role;
 		return role === "user" || role === "assistant" || role === "compactionSummary" || role === "branchSummary";
@@ -113,7 +113,7 @@ function buildSessionSummaryKnowledgeContent(sessionKey, explicitSummary) {
 		const compact = ((typeof record.summary === "string" ? record.summary : void 0) ?? textFromTranscriptContent(record.content)).trim().replace(/\s+/g, " ").slice(0, 280);
 		return compact ? `- ${role}: ${compact}` : "";
 	}).filter(Boolean);
-	return lines.length > 0 ? [`Session summary for ${sessionKey}:`, ...lines].join("\n") : `Session summary for ${sessionKey}: no transcript content available.`;
+	return lines.length > 0 ? [`Session summary for ${conversationId}:`, ...lines].join("\n") : `Session summary for ${conversationId}: no transcript content available.`;
 }
 function listFailedProjectWorkflowRuns(projectId, limit = 5) {
 	return getSqliteDatabase().prepare(`SELECT run_id, definition_id, status, created_at_ms, error_message
@@ -255,10 +255,10 @@ function registerProjectsRoutes(authenticated, deps) {
 		});
 	});
 	authenticated.get("/api/projects/suggestions", async (c) => {
-		const sessionKey = c.req.query("sessionKey")?.trim();
+		const conversationId = c.req.query("conversationId")?.trim();
 		return c.json({
 			ok: true,
-			suggestions: sessionKey ? service.projects.suggestProjectsForSession(sessionKey) : []
+			suggestions: conversationId ? service.projects.suggestProjectsForSession(conversationId) : []
 		});
 	});
 	authenticated.post("/api/projects/infer-defaults", async (c) => {
@@ -315,13 +315,13 @@ function registerProjectsRoutes(authenticated, deps) {
 			ok: true,
 			project: null
 		});
-		const sessionKey = textField(body, "sessionKey")?.trim();
+		const conversationId = textField(body, "conversationId")?.trim();
 		const projectDefaultAgentId = normalizeProjectAgentId(match.project.defaultAgentId);
 		const shouldBindRequestedSession = !projectDefaultAgentId || projectDefaultAgentId === normalizeProjectAgentId(agentId);
-		if (sessionKey && shouldBindRequestedSession) {
-			if (!getSessionMetadata(sessionKey)) await service.sessionIndexInstance.saveMessages(sessionKey, [], { metadata: {
+		if (conversationId && shouldBindRequestedSession) {
+			if (!getSessionMetadata(conversationId)) await service.sessionIndexInstance.saveMessages(conversationId, [], { metadata: {
 				sourceChannel: "tui",
-				sourceChatId: `default:direct:${sessionKey}`,
+				sourceChatId: `default:direct:${conversationId}`,
 				sessionType: "chat",
 				projectId: match.project.id,
 				routing: {
@@ -329,10 +329,10 @@ function registerProjectsRoutes(authenticated, deps) {
 					source: "tui",
 					accountId: "default",
 					peerKind: "direct",
-					peerId: sessionKey
+					peerId: conversationId
 				}
 			} });
-			service.projects.attachSession(sessionKey, match.project.id);
+			service.projects.attachSession(conversationId, match.project.id);
 		}
 		return c.json({
 			ok: true,
@@ -712,7 +712,7 @@ function registerProjectsRoutes(authenticated, deps) {
 	});
 	authenticated.get("/api/projects/:id/sessions", async (c) => {
 		try {
-			const keys = service.projects.listSessionKeys(c.req.param("id"), parseLimit(c.req.query("limit"), 100));
+			const keys = service.projects.listConversationIds(c.req.param("id"), parseLimit(c.req.query("limit"), 100));
 			const sessions = await Promise.all(keys.map((key) => service.sessions.getSession(key)));
 			return c.json({
 				ok: true,
@@ -725,10 +725,10 @@ function registerProjectsRoutes(authenticated, deps) {
 			}, 404);
 		}
 	});
-	authenticated.post("/api/projects/:id/sessions/:sessionKey", async (c) => {
+	authenticated.post("/api/projects/:id/sessions/:conversationId", async (c) => {
 		try {
-			service.projects.attachSession(c.req.param("sessionKey"), c.req.param("id"));
-			const session = await service.sessions.getSession(c.req.param("sessionKey"));
+			service.projects.attachSession(c.req.param("conversationId"), c.req.param("id"));
+			const session = await service.sessions.getSession(c.req.param("conversationId"));
 			return c.json({
 				ok: true,
 				session
@@ -740,15 +740,15 @@ function registerProjectsRoutes(authenticated, deps) {
 			}, 404);
 		}
 	});
-	authenticated.delete("/api/projects/:id/sessions/:sessionKey", async (c) => {
+	authenticated.delete("/api/projects/:id/sessions/:conversationId", async (c) => {
 		try {
 			const projectId = c.req.param("id");
-			const sessionKey = c.req.param("sessionKey");
+			const conversationId = c.req.param("conversationId");
 			if (!service.projects.get(projectId)) return c.json({
 				ok: false,
 				error: "Project not found"
 			}, 404);
-			const session = await service.sessions.getSession(sessionKey);
+			const session = await service.sessions.getSession(conversationId);
 			if (!session) return c.json({
 				ok: false,
 				error: "Session not found"
@@ -757,7 +757,7 @@ function registerProjectsRoutes(authenticated, deps) {
 				ok: false,
 				error: "Session is not attached to this project"
 			}, 409);
-			service.projects.detachSession(sessionKey);
+			service.projects.detachSession(conversationId);
 			return c.json({ ok: true });
 		} catch (error) {
 			return c.json({
@@ -766,14 +766,14 @@ function registerProjectsRoutes(authenticated, deps) {
 			}, 404);
 		}
 	});
-	authenticated.post("/api/projects/:id/sessions/:sessionKey/summary-knowledge", async (c) => {
+	authenticated.post("/api/projects/:id/sessions/:conversationId/summary-knowledge", async (c) => {
 		const projectId = c.req.param("id");
-		const sessionKey = c.req.param("sessionKey");
+		const conversationId = c.req.param("conversationId");
 		if (!service.projects.get(projectId)) return c.json({
 			ok: false,
 			error: "Project not found"
 		}, 404);
-		const session = getSessionMetadata(sessionKey);
+		const session = getSessionMetadata(conversationId);
 		if (!session) return c.json({
 			ok: false,
 			error: "Session not found"
@@ -783,7 +783,7 @@ function registerProjectsRoutes(authenticated, deps) {
 			error: "Session is not attached to this project"
 		}, 409);
 		const body = await c.req.json().catch(() => ({}));
-		const content = buildSessionSummaryKnowledgeContent(sessionKey, typeof body.summary === "string" ? body.summary : void 0);
+		const content = buildSessionSummaryKnowledgeContent(conversationId, typeof body.summary === "string" ? body.summary : void 0);
 		const record = writeKnowledgeItem({
 			kind: "episode",
 			scope: {
@@ -791,12 +791,12 @@ function registerProjectsRoutes(authenticated, deps) {
 				id: projectId
 			},
 			sourceAgentId: session.routing?.agentId ?? "main",
-			sourceSessionId: sessionKey,
+			sourceConversationId: conversationId,
 			content,
-			canonicalKey: `project-session-summary:${projectId}:${sessionKey}`,
+			canonicalKey: `project-session-summary:${projectId}:${conversationId}`,
 			source: {
 				provider: "project-summary",
-				sessionEntryId: sessionKey
+				sessionEntryId: conversationId
 			},
 			confidence: typeof body.confidence === "number" ? body.confidence : .7,
 			importance: .6,

package/dist/src/gateway/hono/routes/public-gateway.js

@@ -118,9 +118,9 @@ function registerPublicGatewayRoutes(app, service) {
 				"GET  /api/health",
 				"GET  /status",
 				"GET  /api/status",
-				"POST /api/sessions/:sessionKey/inputs",
-				"GET  /api/sessions/:sessionKey/input-state",
-				"PATCH/DELETE /api/sessions/:sessionKey/inputs/:inputId",
+				"POST /api/sessions/:conversationId/inputs",
+				"GET  /api/sessions/:conversationId/input-state",
+				"PATCH/DELETE /api/sessions/:conversationId/inputs/:inputId",
 				"POST /api/agent/abort",
 				"POST /api/send",
 				"POST /api/realtime/tickets",