@xopcai/xopc 0.0.333 → 0.0.335

package/dist/src/gateway/agents-admin.js

@@ -1,11 +1,11 @@
 import { normalizeAgentId, validateAgentIdForNewAgent } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath } from "../agent/agent-scope.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
-import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { AgentCatalogService } from "../agent-catalog/service.js";
+import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
+import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { join, resolve } from "node:path";
 import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";

package/dist/src/gateway/file-path-classifier.js

@@ -1,7 +1,7 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { isBareProfileMarkdownFileName, resolveProfileMarkdownPathIfBareName } from "../agent/tools/tool-paths.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { basename, isAbsolute, resolve } from "node:path";

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,8 +1,8 @@
 import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
-import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserModelConfigSchema, init_config } from "../../../user-context/config.js";
 import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
+import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserModelConfigSchema, init_config } from "../../../user-context/config.js";
 import { init_models_json, loadModelsJson } from "../../../config/models-json.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";

package/dist/src/gateway/hono/routes/agent-stream.js

@@ -2,7 +2,8 @@ import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packa
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { parseTurnContextRefs } from "../../../agent/source-context/types.js";
-import { replaceLatestSessionTurn, submitSessionInput } from "./session-input-handler.js";
+import { replaceLatestSessionTurn } from "./session-input-handler.js";
+import { handleSessionCommand, handleSessionInputReceipt, handleSessionPreparationRetry } from "./session-command-handler.js";
 //#region src/gateway/hono/routes/agent-stream.ts
 init_src();
 function registerAgentStreamRoutes(authenticated, deps) {
@@ -38,8 +39,11 @@ function registerAgentStreamRoutes(authenticated, deps) {
 		});
 	});
 	authenticated.post("/api/sessions/:conversationId/inputs", chatRateLimitMiddleware, async (c) => {
-		return submitSessionInput(c, deps, (c.req.param("conversationId") ?? "").trim());
+		return handleSessionCommand(c, deps);
 	});
+	authenticated.post("/api/sessions/:conversationId/materialize", chatRateLimitMiddleware, (c) => handleSessionCommand(c, deps, true));
+	authenticated.get("/api/sessions/:conversationId/input-receipts/:clientMessageId", (c) => handleSessionInputReceipt(c, deps));
+	authenticated.post("/api/sessions/:conversationId/preparation/retry", chatRateLimitMiddleware, (c) => handleSessionPreparationRetry(c, deps));
 	authenticated.post("/api/sessions/:conversationId/turns/:turnId/replace", chatRateLimitMiddleware, async (c) => {
 		return replaceLatestSessionTurn(c, deps, (c.req.param("conversationId") ?? "").trim(), (c.req.param("turnId") ?? "").trim());
 	});

package/dist/src/gateway/hono/routes/browser-session.js

@@ -1,12 +1,14 @@
+import { getOrCreateGatewayIdentity, init_gateway_identity_repository } from "../../../storage/sqlite/gateway-identity-repository.js";
 import { BrowserSessionLimitError, createBrowserSession, deleteBrowserSession } from "../../../storage/sqlite/browser-session-repository.js";
 import { browserCookieRequestAllowed, clearBrowserSessionCookie, writeBrowserSessionCookie } from "../../security/browser-session.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 //#region src/gateway/hono/routes/browser-session.ts
+init_gateway_identity_repository();
 function registerBrowserSessionRoutes(app, deps) {
 	app.get("/api/browser-session", (c) => {
 		c.header("Cache-Control", "no-store");
 		const principal = getGatewayPrincipal(c);
-		return c.json({ conversationId: principal.principalId });
+		return c.json({ conversationId: `${getOrCreateGatewayIdentity().id}:${principal.principalId}` });
 	});
 	app.post("/api/browser-session", deps.strictRateLimitMiddleware, (c) => {
 		const principal = getGatewayPrincipal(c);
@@ -24,7 +26,7 @@ function registerBrowserSessionRoutes(app, deps) {
 		}
 		writeBrowserSessionCookie(c, session.token, session.expiresAt);
 		c.header("Cache-Control", "no-store");
-		return c.json({ conversationId: `browser:${session.sessionId}` });
+		return c.json({ conversationId: `${getOrCreateGatewayIdentity().id}:browser:${session.sessionId}` });
 	});
 	app.delete("/api/browser-session", (c) => {
 		if (!browserCookieRequestAllowed(c)) return c.json({ error: "Forbidden" }, 403);

package/dist/src/gateway/hono/routes/commands-skills.js

@@ -1,8 +1,11 @@
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { effectiveWorkspacePathForSession } from "../../../session/session-workspace.js";
+import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
+import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../../session/session-workspace.js";
 import { getProjectForSession } from "../../../projects/workspace.js";
+import { ProjectService } from "../../../projects/project-service.js";
 import { isRegisteredProvider } from "../../../agent/skills/marketplace/registry.js";
 import "../../../agent/skills/skills-marketplace.js";
+import "../../../projects/index.js";
 import { isSkillInstallTarget } from "../../../agent/skills/install-target.js";
 import { commandRegistry } from "../../../chat-commands/registry.js";
 import { buildReviewContext, resolveGitRoot } from "../../../review/review-git.js";
@@ -62,7 +65,11 @@ function registerCommandsSkillsRoutes(authenticated, deps) {
 	authenticated.get("/api/review/context", async (c) => {
 		const conversationId = c.req.query("conversationId")?.trim();
 		try {
-			const payload = await buildReviewContext(await resolveGitRoot(effectiveWorkspacePathForSession(service.getConfig(), conversationId, null, getProjectForSession(conversationId))));
+			const agentId = c.req.query("agentId")?.trim();
+			const projectId = c.req.query("projectId")?.trim();
+			const project = !conversationId && projectId ? new ProjectService().get(projectId) : null;
+			if (!conversationId && projectId && !project) throw new Error("Project not found");
+			const payload = await buildReviewContext(await resolveGitRoot(!conversationId && agentId ? projectWorkspacePath(project) ?? resolveEffectiveAgentProfile(agentId).resolvedWorkspacePath : effectiveWorkspacePathForSession(service.getConfig(), conversationId, null, getProjectForSession(conversationId))));
 			return c.json({
 				ok: true,
 				payload

package/dist/src/gateway/hono/routes/config-patch/misc.js

@@ -1,10 +1,10 @@
-import { ComputerConfigSchema, init_config } from "../../../../computer/config.js";
 import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
+import { AgentCatalogService } from "../../../../agent-catalog/service.js";
+import { ComputerConfigSchema, init_config } from "../../../../computer/config.js";
 import { ContextPlanningConfigSchema, HomeIntelligenceConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config as init_config$1 } from "../../../../user-context/config.js";
 import { BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
 import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
-import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { mergeGatewaySkillsMarketplacePatch, mergeSessionConfigPatch, mergeUpdateConfigPatch } from "../../../../config/web-patch.js";
 import { assertGatewayAuthConfigured, resolveGatewayAuth } from "../../../auth.js";
 import { isMaskedSecretPatchValue } from "../../lib/mask-secret-length.js";

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

@@ -1,5 +1,6 @@
 import { FileServiceError, fileResourceFromPath, parseFileResourceId, resolveFilePath } from "../../../files/file-service.js";
 import { getGatewayFileSpaceService } from "../../file-space-service.js";
+import { getSessionPreparation } from "../../../storage/sqlite/session-creation-repository.js";
 import { fuzzySearchWorkspaceFiles, fuzzySubsequenceScore } from "../../workspace-file-search.js";
 import { registerFileReferenceRoutes } from "./file-references.js";
 import { basename, join } from "node:path";
@@ -55,6 +56,8 @@ function registerFilesRoutes(authenticated, deps) {
 		try {
 			const kind = c.req.param("kind");
 			if (kind !== "agent" && kind !== "project" && kind !== "session") throw new FileServiceError(400, "Invalid context kind");
+			const preparation = kind === "session" ? getSessionPreparation(c.req.param("id")) : void 0;
+			if (preparation && preparation.state !== "ready") throw new FileServiceError(409, "Session environment is not ready");
 			return c.json({ space: publicSpace(await files.forContext(kind, c.req.param("id"))) });
 		} catch (error) {
 			return errorResponse(c, error);

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

@@ -8,6 +8,7 @@ import { CredentialResolver, init_credentials } from "../../../auth/credentials.
 import "../../../providers/constants.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { PROVIDER_META, getAllModels, getAllProviders, getAvailableModels, getProviderAuthState, init_providers, isProviderConfigured, isProviderConfiguredSync } from "../../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../../config/agent-profile.js";
 import { buildCapabilityPlansForConfig } from "../../../capabilities/readiness/from-config.js";
 import "../../../capabilities/readiness/index.js";
 import { getImageGenerationProvider, reloadImageGenerationProviders, resolveImageGenerationCredentialMode } from "../../../agent/image/generation/provider-registry.js";
@@ -325,9 +326,24 @@ function registerModelsRoutes(authenticated, deps) {
 			if (a.provider !== b.provider) return a.provider.localeCompare(b.provider);
 			return a.name.localeCompare(b.name, void 0, { sensitivity: "base" });
 		});
+		const agentId = c.req.query("agentId")?.trim();
+		let defaultId;
+		if (agentId) try {
+			const configured = resolveEffectiveAgentConfigForAgent(agentId).config.models.chat.primary;
+			const matches = models.filter((model) => model.id === configured || model.id.endsWith(`/${configured}`));
+			defaultId = models.find((model) => model.id === configured)?.id ?? (matches.length === 1 ? matches[0].id : configured);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: { message: error instanceof Error ? error.message : "Invalid agent" }
+			}, 400);
+		}
 		return c.json({
 			ok: true,
-			payload: { models }
+			payload: {
+				models,
+				...defaultId ? { defaultId } : {}
+			}
 		});
 	});
 	authenticated.get("/api/image-generation/catalog", (c) => {

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

@@ -1,9 +1,9 @@
 import { NoteDeleteOutputSchema, NoteGetOutputSchema, ProductReadContracts } from "../../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
-import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
-import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.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";
 import { resolveShareUrl } from "../../../share/share-url.js";
@@ -269,7 +269,6 @@ function registerNotesRoutes(authenticated, deps) {
 					...projectId ? { projectId } : {},
 					customData: {
 						...meta?.customData ?? {},
-						genericNewChatShell: false,
 						sourceBinding
 					}
 				});
@@ -310,7 +309,6 @@ function registerNotesRoutes(authenticated, deps) {
 			tags: Array.from(new Set([...meta?.tags ?? [], "note"])),
 			customData: {
 				...meta?.customData ?? {},
-				genericNewChatShell: false,
 				sourceBinding
 			}
 		});

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

@@ -7,12 +7,12 @@ import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript
 import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { ActivityService } from "../../../activity/service.js";
 import "../../../activity/index.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
 import { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.js";
 import { listKnowledgeItems, writeKnowledgeItem } from "../../../knowledge-memory/repository.js";
 import "../../../knowledge-memory/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError } from "../../../projects/workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "../../../projects/project-kind.js";
 import { ProjectDeletionBlockedError, ProjectWorkspaceInUseError } from "../../../projects/project-service.js";

package/dist/src/gateway/hono/routes/session-command-handler.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function handleSessionCommand(c: Context, deps: AuthenticatedRouteDeps, materialize?: boolean): Promise<Response>;
+export declare function handleSessionInputReceipt(c: Context, deps: AuthenticatedRouteDeps): Promise<Response>;
+export declare function handleSessionPreparationRetry(c: Context, deps: AuthenticatedRouteDeps): Promise<Response>;

package/dist/src/gateway/hono/routes/session-command-handler.js

@@ -0,0 +1,189 @@
+import { createLogger } from "../../../utils/logger/index.js";
+import { init_logger } from "../../../utils/logger.js";
+import { conversationIdSchema } from "../../../../packages/gateway-contract/src/conversation-identity.js";
+import { sessionInputCommandSchema, sessionMaterializeCommandSchema } from "../../../../packages/gateway-contract/src/session-input-command.js";
+import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
+import { init_src } from "../../../../packages/gateway-contract/src/index.js";
+import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
+import { parseSlashCommand } from "../../../chat-commands/command-parse.js";
+import { commandRegistry } from "../../../chat-commands/registry.js";
+import "../../../chat-commands/index.js";
+import { isVoiceLikeAttachment } from "../../../channels/attachments/voice-stt-webchat.js";
+import { SessionCommandError, getSessionInputReceipt, isConversationDeleted, retrySessionPreparation } from "../../../storage/sqlite/session-creation-repository.js";
+import { getGatewayPrincipal } from "../../security/gateway-principal.js";
+import { browserPageContextToAgentContext } from "../../../agent/source-context/browser-page.js";
+import { receiveSessionCommand, sessionCommandSnapshot } from "../../service/session-command-service.js";
+import { z } from "zod";
+//#region src/gateway/hono/routes/session-command-handler.ts
+init_src();
+init_src$1();
+init_logger();
+const log = createLogger("Gateway:SessionCommand");
+function commandError(c, error) {
+	if (error instanceof SessionCommandError) {
+		const status = error.code === "BAD_REQUEST" ? 400 : error.code === "SESSION_DELETED" ? 410 : error.code === "FORBIDDEN" ? 403 : error.code === "NOT_FOUND" ? 404 : 409;
+		return c.json({
+			ok: false,
+			error: {
+				code: error.code,
+				message: error.message
+			}
+		}, status);
+	}
+	throw error;
+}
+async function handleSessionCommand(c, deps, materialize = false) {
+	const id = conversationIdSchema.safeParse(c.req.param("conversationId"));
+	const body = await c.req.json().catch(() => null);
+	const parsed = materialize ? sessionMaterializeCommandSchema.safeParse(body) : sessionInputCommandSchema.safeParse(body);
+	if (!id.success || !parsed.success) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "Invalid session command"
+		}
+	}, 400);
+	const command = parsed.data;
+	const principal = getGatewayPrincipal(c);
+	if ("input" in command) {
+		const origin = command.origin.type === "endpoint" ? endpointTurnClaimSchema.safeParse(command.origin) : null;
+		if (origin && (!origin.success || !deps.service.endpointTools.registry.verifyTurnClaim(origin.data.endpointId, origin.data.token))) return c.json({
+			ok: false,
+			error: {
+				code: "INVALID_ENDPOINT",
+				message: "Endpoint connection is not active"
+			}
+		}, 401);
+		if (!origin && principal.kind !== "owner") return c.json({
+			ok: false,
+			error: {
+				code: "FORBIDDEN",
+				message: "CLI input requires owner authentication"
+			}
+		}, 403);
+		if (command.input.browserContexts?.length && (!origin?.success || deps.service.endpointTools.registry.get(origin.data.endpointId)?.kind !== "browser")) return c.json({
+			ok: false,
+			error: {
+				code: "FORBIDDEN",
+				message: "Browser context requires a browser endpoint"
+			}
+		}, 403);
+		const inputError = validateWebchatContent(command.input.content) ?? validateWebchatAttachments(command.input.attachments);
+		if (inputError) return c.json({
+			ok: false,
+			error: {
+				code: "BAD_REQUEST",
+				message: inputError
+			}
+		}, 400);
+		const document = parseUserTurnDocument(command.input.content);
+		const refs = new Set((command.input.contextRefs ?? []).flatMap((ref) => ref.refId ? [ref.refId] : []));
+		if (document && !userTurnDocumentRefIds(document).every((ref) => refs.has(ref))) return c.json({
+			ok: false,
+			error: {
+				code: "BAD_REQUEST",
+				message: "Input contains an unknown context reference"
+			}
+		}, 400);
+		const slash = parseSlashCommand(command.input.content);
+		if (slash && commandRegistry.has(slash.command) && command.input.attachments?.some((attachment) => !isVoiceLikeAttachment(attachment))) return c.json({
+			ok: false,
+			error: {
+				code: "BAD_REQUEST",
+				message: "Slash commands do not accept file or image attachments."
+			}
+		}, 400);
+		if (!command.input.content.trim() && !command.input.attachments?.length && !command.input.contextRefs?.length && !command.input.browserContexts?.length && !command.input.appContext) return c.json({
+			ok: false,
+			error: {
+				code: "BAD_REQUEST",
+				message: "Input is empty"
+			}
+		}, 400);
+	}
+	try {
+		const payload = await receiveSessionCommand(deps.service, id.data, principal.principalId, command, async () => {
+			if (!("input" in command)) return [];
+			const contexts = (command.input.browserContexts ?? []).map(browserPageContextToAgentContext);
+			if (command.input.appContext) contexts.push(await deps.service.prepareSessionAppContext(command.input.appContext, principal, id.data, command.clientMessageId));
+			return contexts;
+		});
+		deps.service.emit("session.input-state", payload.inputState);
+		if ("kind" in command && command.kind === "start") deps.service.emit("session.updated", { key: id.data });
+		if (payload.receipt.lifecycle === "preparing") deps.service.sessionPreparations.wake(id.data);
+		else if (payload.receipt.lifecycle === "ready") deps.service.drainSessionInputs(id.data).catch((err) => {
+			log.error({
+				err,
+				conversationId: id.data
+			}, "Accepted session input drain failed");
+		});
+		return c.json({
+			ok: true,
+			payload
+		}, 202);
+	} catch (error) {
+		return commandError(c, error);
+	}
+}
+async function handleSessionInputReceipt(c, deps) {
+	const id = conversationIdSchema.safeParse(c.req.param("conversationId"));
+	if (!id.success) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "Invalid conversation identity"
+		}
+	}, 400);
+	try {
+		const receipt = getSessionInputReceipt(id.data, c.req.param("clientMessageId"), getGatewayPrincipal(c).principalId);
+		if (!receipt) return c.json({
+			ok: false,
+			error: {
+				code: "NOT_RECEIVED",
+				message: "Input has not been received"
+			}
+		}, 404);
+		if (isConversationDeleted(id.data)) return c.json({
+			ok: false,
+			error: {
+				code: "SESSION_DELETED",
+				message: "Conversation was deleted"
+			}
+		}, 410);
+		return c.json({
+			ok: true,
+			payload: await sessionCommandSnapshot(deps.service, receipt)
+		});
+	} catch (error) {
+		return commandError(c, error);
+	}
+}
+const preparationRetrySchema = z.strictObject({
+	operationId: z.string().uuid(),
+	expectedRevision: z.number().int().positive(),
+	idempotencyKey: z.string().min(1).max(128)
+});
+async function handleSessionPreparationRetry(c, deps) {
+	const id = conversationIdSchema.safeParse(c.req.param("conversationId"));
+	const parsed = preparationRetrySchema.safeParse(await c.req.json().catch(() => null));
+	if (!id.success || !parsed.success) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "Invalid preparation retry"
+		}
+	}, 400);
+	try {
+		const preparation = retrySessionPreparation(id.data, getGatewayPrincipal(c).principalId, parsed.data);
+		deps.service.sessionPreparations.wake(id.data);
+		return c.json({
+			ok: true,
+			payload: { preparation }
+		}, 202);
+	} catch (error) {
+		return commandError(c, error);
+	}
+}
+//#endregion
+export { handleSessionCommand, handleSessionInputReceipt, handleSessionPreparationRetry };

package/dist/src/gateway/hono/routes/session-input-handler.d.ts

@@ -20,13 +20,19 @@ export declare function submitSessionInput(c: Context, deps: AuthenticatedRouteD
         code: string;
         message: string;
     };
-}, 403 | 400 | 409, "json">) | (Response & import("hono").TypedResponse<{
+}, 400 | 409 | 403, "json">) | (Response & import("hono").TypedResponse<{
     ok: true;
     payload: {
         conversationId: string;
         ok: true;
         effectiveDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
         state: {
+            preparation?: {
+                operationId: string;
+                revision: number;
+                state: "ready" | "preparing" | "preparation_failed";
+                lastError?: string;
+            };
             conversationId: string;
             revision: number;
             activeRunId?: string;
@@ -155,7 +161,7 @@ export declare function replaceLatestSessionTurn(c: Context, deps: Authenticated
 }, 409, "json">) | (Response & import("hono").TypedResponse<{
     ok: false;
     error: {
-        code: "TARGET_NOT_FOUND" | "NOT_LATEST" | "SESSION_BUSY" | "BAD_REQUEST" | "CONTEXT_UNAVAILABLE";
+        code: "BAD_REQUEST" | "SESSION_BUSY" | "TARGET_NOT_FOUND" | "NOT_LATEST" | "CONTEXT_UNAVAILABLE";
         message: string;
     };
 }, 404 | 400 | 409, "json">) | (Response & import("hono").TypedResponse<{
@@ -165,6 +171,12 @@ export declare function replaceLatestSessionTurn(c: Context, deps: Authenticated
         ok: true;
         effectiveDelivery: "next";
         state: {
+            preparation?: {
+                operationId: string;
+                revision: number;
+                state: "ready" | "preparing" | "preparation_failed";
+                lastError?: string;
+            };
             conversationId: string;
             revision: number;
             activeRunId?: string;

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -1,12 +1,12 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
-import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { browserPageContextsInputSchema } from "../../../../packages/gateway-contract/src/browser-page-context.js";
+import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
-import { init_providers, resolveModel } from "../../../providers/index.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { isTaskDestructiveCommand } from "../../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../../chat-commands/command-parse.js";