@xopcai/xopc 0.0.364 → 0.0.367

package/dist/src/files/file-service.js

@@ -1,7 +1,7 @@
 import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { resolveProjectAgentId } from "../projects/project-agent.js";
 import "../projects/index.js";
-import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, parse, relative, resolve, sep } from "node:path";
 import { constants } from "node:fs";
 import { createHash } from "node:crypto";
 import { access, lstat, open, opendir, realpath, stat } from "node:fs/promises";
@@ -469,7 +469,42 @@ var FileSpaceService = class {
 	defaultSpace() {
 		return this.forContext("agent", resolveDefaultAgentId());
 	}
+	/** Host spaces support explicit local file links without adding whole disks to discovery. */
+	async hostSpace(path) {
+		const root = parse(resolve(path)).root;
+		return {
+			id: `host-${Buffer.from(root).toString("base64url")}`,
+			title: "Local files",
+			kind: "workspace",
+			bindings: [],
+			writable: false,
+			root
+		};
+	}
+	async resolveLocalResource(space, candidate) {
+		const absolutePath = await realpath(candidate).catch((error) => {
+			if (error.code === "ENOENT" || error.code === "ENOTDIR") throw new FileServiceError(404, "File not found");
+			if (error.code === "EACCES" || error.code === "EPERM") throw new FileServiceError(403, "File access denied");
+			throw error;
+		});
+		const info = await stat(absolutePath);
+		if (!info.isFile() && !info.isDirectory()) throw new FileServiceError(400, "Not a file or directory");
+		await access(absolutePath, constants.R_OK).catch(() => {
+			throw new FileServiceError(403, "File access denied");
+		});
+		if (isWithin(await realpath(space.root), absolutePath)) return { resource: await fileResourceFromPath(space, absolutePath) };
+		return {
+			resource: await fileResourceFromPath(await this.hostSpace(absolutePath), absolutePath),
+			absolutePath
+		};
+	}
 	async get(id) {
+		if (id.startsWith("host-")) {
+			const root = Buffer.from(id.slice(5), "base64url").toString("utf8");
+			const space = await this.hostSpace(root);
+			if (space.id !== id || space.root !== root) throw new FileServiceError(400, "Invalid host file space");
+			return space;
+		}
 		const hadCache = this.cache !== null;
 		let space = (await this.list()).find((item) => item.id === id);
 		if (!space && hadCache) {
@@ -483,6 +518,8 @@ var FileSpaceService = class {
 		const locator = parseFileResourceId(id);
 		const space = await this.get(locator.spaceId);
 		const absolutePath = await resolveFilePath(space.root, locator.relativePath);
+		const info = await stat(absolutePath);
+		if (!info.isFile() && !info.isDirectory()) throw new FileServiceError(400, "Not a file or directory");
 		return {
 			space,
 			resource: await fileResourceFromPath(space, absolutePath, resolve(space.root, locator.relativePath)),

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -277,4 +277,4 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly zh: "使用已验证的参数执行选定的外部工具。";
     };
 }];
-export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "image" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "user_context_search" | "user_context_get" | "user_context_update" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "clarify" | "xopc_tool_execute" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "session_status" | "memory_maintenance" | "tool_manual" | "skill_install" | "send_message" | "send_media" | "read_media" | "create_share" | "text_to_speech" | "delegate_task" | "execute_code" | "create_desktop_pet" | "xopc_tool_search" | "xopc_tool_describe")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "image" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "user_context_search" | "user_context_get" | "user_context_update" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "clarify" | "xopc_tool_execute" | "web_extract" | "image_generate" | "read_media" | "xopc_tool_search" | "xopc_tool_describe" | "computer_use" | "send_message" | "text_to_speech" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "session_status" | "memory_maintenance" | "tool_manual" | "skill_install" | "send_media" | "create_share" | "delegate_task" | "execute_code" | "create_desktop_pet")[];

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

@@ -1,10 +1,10 @@
 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 { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.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 { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { resolve } from "node:path";
 import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";

package/dist/src/gateway/custom-image-providers.d.ts

@@ -36,9 +36,33 @@ export declare const CustomImageProviderInputSchema: z.ZodObject<{
                 }, z.core.$strict>>;
                 edit: z.ZodOptional<z.ZodObject<{
                     enabled: z.ZodBoolean;
+                    inputFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        png: "png";
+                        jpeg: "jpeg";
+                        webp: "webp";
+                    }>>>;
+                    maxInputBytes: z.ZodOptional<z.ZodNumber>;
                     maxInputImages: z.ZodOptional<z.ZodNumber>;
                     supportsSize: z.ZodOptional<z.ZodBoolean>;
                     supportsAspectRatio: z.ZodOptional<z.ZodBoolean>;
+                    supportsResolution: z.ZodOptional<z.ZodBoolean>;
+                    geometry: z.ZodOptional<z.ZodObject<{
+                        sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        aspectRatios: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        resolutions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                            "1K": "1K";
+                            "2K": "2K";
+                            "4K": "4K";
+                        }>>>;
+                        pixels: z.ZodOptional<z.ZodObject<{
+                            minPixels: z.ZodNumber;
+                            maxPixels: z.ZodNumber;
+                            minEdge: z.ZodNumber;
+                            maxEdge: z.ZodNumber;
+                            step: z.ZodNumber;
+                            maxRatio: z.ZodNumber;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>>;
                 }, z.core.$strict>>;
                 geometry: z.ZodOptional<z.ZodObject<{
                     sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -48,12 +72,22 @@ export declare const CustomImageProviderInputSchema: z.ZodObject<{
                         "2K": "2K";
                         "4K": "4K";
                     }>>>;
+                    pixels: z.ZodOptional<z.ZodObject<{
+                        minPixels: z.ZodNumber;
+                        maxPixels: z.ZodNumber;
+                        minEdge: z.ZodNumber;
+                        maxEdge: z.ZodNumber;
+                        step: z.ZodNumber;
+                        maxRatio: z.ZodNumber;
+                    }, z.core.$strict>>;
                 }, z.core.$strict>>;
                 output: z.ZodOptional<z.ZodObject<{
                     qualities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                         low: "low";
                         high: "high";
                         medium: "medium";
+                        xhigh: "xhigh";
+                        max: "max";
                         auto: "auto";
                     }>>>;
                     formats: z.ZodOptional<z.ZodArray<z.ZodEnum<{

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

@@ -3,7 +3,8 @@ import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.j
 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 { isPathUnderWorkspace } from "./workspace-editor-path.js";
+import { homedir } from "node:os";
 import { basename, isAbsolute, resolve } from "node:path";
 import { stat } from "node:fs/promises";
 //#region src/gateway/file-path-classifier.ts
@@ -72,15 +73,23 @@ async function resolveFileReferenceCandidate(rawPath, workspaceRoot, ctx) {
 		...ctx,
 		workspaceRoot: displayRoot
 	};
+	if (rawPath.includes("\0")) return {
+		candidate: null,
+		invalid: true
+	};
+	if (rawPath === "~" || rawPath.startsWith("~/")) return {
+		candidate: resolve(homedir(), rawPath.slice(2)),
+		invalid: false
+	};
 	if (looksLikeHostAbsolutePath(rawPath)) return {
 		candidate: resolve(rawPath),
 		invalid: false
 	};
-	const wsPath = resolveWorkspaceSafePath(workspaceRoot, rawPath);
-	if (!wsPath) return {
+	if (/^[a-z][a-z0-9+.-]*:/i.test(rawPath)) return {
 		candidate: null,
 		invalid: true
 	};
+	const wsPath = resolve(workspaceRoot, rawPath);
 	try {
 		await stat(wsPath);
 		return {

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

@@ -1,6 +1,6 @@
+import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { AgentEntrySchema, AgentModelsOverrideSchema, AgentProfileSchema, RuntimePolicySchema, SkillOverrideSchema, ToolPoliciesSchema, WorkflowPolicySchema } from "../../../agent-config/schema.js";
 import { init_agent_config } from "../../../agent-config/index.js";
-import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { init_agent_scope } from "../../../agent/agent-scope.js";
 import { createGatewayAgent, deleteAgentAvatarFile, deleteGatewayAgent, getGatewayAgentEffectiveConfig, listAgentProfileFiles, listGatewayAgents, readAgentAvatarFile, readAgentProfileFile, updateGatewayAgent, writeAgentAvatarFromBase64, writeAgentProfileFile } from "../../agents-admin.js";
 import { getVoiceModelsConfig } from "../../../config/voice.js";

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

@@ -1,10 +1,10 @@
 import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
-import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.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 { 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,4 +1,6 @@
+import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
 import { FileServiceError, fileResourceFromPath, parseFileResourceId, resolveFilePath } from "../../../files/file-service.js";
+import { buildFilePathClassifierContext, resolveFileReferenceCandidate } from "../../file-path-classifier.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";
@@ -6,6 +8,7 @@ import { registerFileReferenceRoutes } from "./file-references.js";
 import { basename, join } from "node:path";
 import { readFile, unlink, writeFile } from "node:fs/promises";
 //#region src/gateway/hono/routes/files.ts
+init_task_run_repository();
 const mutationLocks = /* @__PURE__ */ new Map();
 async function withMutationLock(key, action) {
 	const previous = mutationLocks.get(key) ?? Promise.resolve();
@@ -115,8 +118,16 @@ function registerFilesRoutes(authenticated, deps) {
 			const body = await c.req.json();
 			if (!body.spaceId || !body.path) throw new FileServiceError(400, "spaceId and path are required");
 			const space = await files.get(body.spaceId);
-			const absolutePath = await resolveFilePath(space.root, body.path);
-			return c.json({ resource: await fileResourceFromPath(space, absolutePath) });
+			const sourceConversationId = body.taskRunId ? new TaskRunRepository().get(body.taskRunId)?.conversationId : void 0;
+			if (body.taskRunId && !sourceConversationId) throw new FileServiceError(404, "Task file context not found");
+			const sourceSpace = sourceConversationId ? await files.forContext("session", sourceConversationId) : space;
+			const ctx = {
+				...buildFilePathClassifierContext(deps.service.currentConfig, sourceConversationId),
+				workspaceRoot: sourceSpace.root
+			};
+			const { candidate, invalid } = await resolveFileReferenceCandidate(body.path, sourceSpace.root, ctx);
+			if (!candidate || invalid) throw new FileServiceError(400, "Invalid file path");
+			return c.json(await files.resolveLocalResource(space, candidate));
 		} catch (error) {
 			return errorResponse(c, error);
 		}

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 { 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 { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
 import { getShareStore } from "../../../share/share-store.js";
 import { resolveShareUrl } from "../../../share/share-url.js";

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

@@ -71,6 +71,14 @@ function registerObservabilityRoutes(authenticated, { service, strictRateLimitMi
 		await configureTracing(service.currentConfig.observability?.tracing);
 		return c.json({ ok: true });
 	});
+	app.post("/tracing/langfuse/credentials/:field/reveal", strictRateLimitMiddleware, async (c) => {
+		const field = z.enum(["publicKey", "secretKey"]).parse(c.req.param("field"));
+		const environmentKey = field === "publicKey" ? "LANGFUSE_PUBLIC_KEY" : "LANGFUSE_SECRET_KEY";
+		const provider = field === "publicKey" ? "langfuse-public" : "langfuse";
+		const key = process.env[environmentKey] || await new CredentialResolver().revealGatewayStoredApiKey(provider);
+		c.header("Cache-Control", "no-store");
+		return c.json({ key: key || null });
+	});
 	app.delete("/tracing/langfuse/credentials", strictRateLimitMiddleware, async (c) => {
 		const resolver = new CredentialResolver();
 		await resolver.deleteProviderCredential("langfuse");

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

@@ -6,6 +6,8 @@ import { cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest
 import { PersonalOnboardingDraftSchema, PersonalOnboardingStepSchema, finishPersonalWelcome, getPersonalOnboarding, savePersonalOnboarding } from "../../../personal-agent/onboarding.js";
 import { PersonalAppearanceSchema, PersonalPreferencesSchema, createOrResumePersonalAgent, ensurePersonalConversationVisibility, listPersonalModels, patchPersonalProfile, refreshPersonalDelegationGuidance } from "../../../personal-agent/service.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
+import { markPersonalRead, personalUnreadSnapshot } from "../../../personal-agent/unread.js";
+import { registerProactivityRoutes } from "../../../personal-agent/proactivity/routes.js";
 import { z } from "zod";
 //#region src/gateway/hono/routes/personal-agent.ts
 init_device_access_repository();
@@ -51,6 +53,7 @@ function registerPersonalAgentRoutes(authenticated, deps) {
 		const platform = getDevice(principal.deviceId)?.platform;
 		return platform === "harmonyos" || platform === "ios" || platform === "android" ? "local-owner" : null;
 	};
+	registerProactivityRoutes(authenticated, deps, owner);
 	authenticated.get("/api/personal-agent", async (c) => {
 		const ownerId = owner(c);
 		if (!ownerId) return c.json({
@@ -64,6 +67,44 @@ function registerPersonalAgentRoutes(authenticated, deps) {
 			payload: getPersonalAgent(ownerId)
 		});
 	});
+	authenticated.get("/api/personal-agent/unread", (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		const record = getPersonalAgent(ownerId);
+		return c.json({
+			ok: true,
+			payload: record ? personalUnreadSnapshot(record.conversationId) : null
+		});
+	});
+	authenticated.post("/api/personal-agent/read", async (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		const parsed = z.object({
+			transcriptId: z.string().min(1),
+			lastSeq: z.number().int().nonnegative()
+		}).strict().safeParse(await c.req.json().catch(() => null));
+		if (!parsed.success) return c.json({
+			ok: false,
+			error: "Invalid read snapshot"
+		}, 400);
+		const record = getPersonalAgent(ownerId);
+		if (!record) return c.json({
+			ok: false,
+			error: "Personal Agent is unavailable"
+		}, 404);
+		markPersonalRead(record.conversationId, parsed.data.transcriptId, parsed.data.lastSeq);
+		deps.service.emit("personal.unread.updated", { conversationId: record.conversationId });
+		return c.json({
+			ok: true,
+			payload: personalUnreadSnapshot(record.conversationId)
+		});
+	});
 	authenticated.get("/api/personal-agent/models", async (c) => {
 		if (!owner(c)) return c.json({
 			ok: false,

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 { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.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-input-handler.d.ts

@@ -42,6 +42,7 @@ export declare function submitSessionInput(c: Context, deps: AuthenticatedRouteD
                 conversationId: string;
                 clientMessageId: string;
                 expectedTranscriptId?: string;
+                interruptRequested?: boolean;
                 requestedDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
                 effectiveDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
                 status: import("../../../storage/sqlite/session-input-repository.js").SessionInputStatus;
@@ -186,6 +187,7 @@ export declare function replaceLatestSessionTurn(c: Context, deps: Authenticated
                 conversationId: string;
                 clientMessageId: string;
                 expectedTranscriptId?: string;
+                interruptRequested?: boolean;
                 requestedDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
                 effectiveDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
                 status: import("../../../storage/sqlite/session-input-repository.js").SessionInputStatus;

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

@@ -4,9 +4,9 @@ import { browserPageContextsInputSchema } from "../../../../packages/gateway-con
 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 { getModelThinking } from "../../../providers/model-thinking.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { isTaskDestructiveCommand } from "../../../session/reset-triggers.js";
@@ -105,6 +105,13 @@ async function submitSessionInput(c, deps, conversationId, options) {
 			message: "Missing delivery"
 		}
 	}, 400);
+	if (body.interrupt !== void 0 && typeof body.interrupt !== "boolean") return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "interrupt must be a boolean"
+		}
+	}, 400);
 	const origin = endpointTurnClaimSchema.safeParse(body.origin);
 	if (!origin.success) return c.json({
 		ok: false,
@@ -202,6 +209,7 @@ async function submitSessionInput(c, deps, conversationId, options) {
 			conversationId,
 			clientMessageId: typeof body.clientMessageId === "string" ? body.clientMessageId : "",
 			delivery,
+			interrupt: body.interrupt,
 			content,
 			attachments,
 			contextRefs,

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

@@ -4,8 +4,8 @@ import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import "../../../session/types.js";
 import { SidebarLayoutConflictError, getSidebarLayout, init_sidebar_layout_repository, replaceSidebarLayout, sortBySidebarLayout } from "../../../storage/sqlite/sidebar-layout-repository.js";
 import { summarizeAiUsageByConversations } from "../../../storage/sqlite/ai-usage-repository.js";
-import { messagesToClientHistory } from "../../../session/client-history.js";
 import { isPersonalConversation } from "../../../personal-agent/repository.js";
+import { messagesToClientHistory } from "../../../session/client-history.js";
 import { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runner.js";
 import { SessionEnvironmentService } from "../../../execution-environments/session-environment-service.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../../media/session-references.js";

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

@@ -6,9 +6,9 @@ import { hasGatewayScope, init_gateway_scopes } from "../../security/gateway-sco
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
+import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskCriterionReviewRepository } from "../../../tasks/task-criterion-review-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";
 import { TaskDeleteOutputSchema } from "../../../tasks/capabilities/management.js";

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

@@ -1,8 +1,8 @@
 import { voiceSelectionSchema } from "../../../../packages/realtime-protocol/src/voice-catalog.js";
 import { createVoiceSessionRequestSchema, init_voice } from "../../../../packages/realtime-protocol/src/voice.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../../providers/index.js";
-import { completeWithResolvedCredentials } from "../../../providers/model-call.js";
 import { isPersonalConversation } from "../../../personal-agent/repository.js";
+import { completeWithResolvedCredentials } from "../../../providers/model-call.js";
 import { resolveSttProviderConfigSlice } from "../../../voice/stt/config-slice.js";
 import { STTTranscriptionError, transcribe } from "../../../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../../../voice/stt/availability.js";

package/dist/src/gateway/image-generation-setup.js

@@ -1,11 +1,11 @@
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope } from "../agent/agent-scope.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { resolveEffectiveAgentConfigForAgent } from "../config/agent-profile.js";
 import { fetchWithTimeoutGuarded } from "../media-shared/http/provider-http.js";
 import "../media-shared/http/index.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getImageGenerationProvider, listImageGenerationProvidersSummary } from "../agent/image/generation/provider-registry.js";
 //#region src/gateway/image-generation-setup.ts
 init_repository();

package/dist/src/gateway/service/agent-runner.d.ts

@@ -56,6 +56,7 @@ export declare class GatewayAgentRunner {
     unregisterExternalWebchatRun(conversationId: string, runId: string): void;
     cancelClarificationForRun(runId: string): void;
     runAgent(message: string, channel: string, chatId: string, origin: TurnOrigin, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
+        inputReceivedAtMs?: number;
         signal?: AbortSignal;
         runId?: string;
         taskRunId?: string;

package/dist/src/gateway/service/agent-runner.js

@@ -6,6 +6,7 @@ import { TaskRepository, init_task_repository } from "../../tasks/task-repositor
 import { createClarificationWait, getClarification, getClarificationSnapshot, init_clarification_wait_repository, resolveClarification, supersedeActiveClarification } from "../../storage/sqlite/clarification-wait-repository.js";
 import { init_connection_wait_repository, onConnectionWaitChanged } from "../../storage/sqlite/connection-wait-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
@@ -57,9 +58,16 @@ var GatewayAgentRunner = class {
 		});
 		this.inputs = new SessionInputCoordinator({
 			beforeExecute: opts.validateConnectionResume,
+			prioritizeInput: (input) => (input.origin.type !== "system" || input.origin.source === "cli") && isPersonalConversation(input.conversationId),
+			interrupt: async (conversationId, runId) => {
+				const execution = this.activeExecutionBySession.get(conversationId);
+				if (execution && execution.kind !== "chat") return;
+				await this.abortAgentRun(runId);
+			},
 			sessionExists: async (conversationId) => Boolean(await opts.sessionIndex.getSessionMetadata(conversationId)),
 			execute: async (input) => {
 				const generator = this.runAgent(input.content, "webchat", input.conversationId, input.origin, input.attachments, input.thinking, {
+					inputReceivedAtMs: input.inputReceivedAtMs,
 					runId: input.runId,
 					taskRunId: input.taskRunId,
 					sourceContexts: input.sourceContexts,
@@ -110,7 +118,10 @@ var GatewayAgentRunner = class {
 				return fitSourceContextsToBudget(contexts.filter((context) => context !== null));
 			},
 			steer: (conversationId, content) => opts.getAgentService().turnDispatcher.steerWebchatSession(conversationId, content),
-			emit: opts.emit
+			emit: (type, payload) => {
+				opts.emit(type, payload);
+				if (type === "session.input-interrupt") opts.publishRealtime("sessions", type, payload);
+			}
 		});
 	}
 	/** True when a webchat agent run is currently in-flight for `conversationId`. */

package/dist/src/gateway/service/run-gateway-agent.d.ts

@@ -24,6 +24,7 @@ export type RunGatewayAgentDeps = {
  * @param runOptions.signal — When set (e.g. client disconnect), aborts in-flight generation and persists partial output.
  */
 export declare function runGatewayAgent(deps: RunGatewayAgentDeps, message: string, channel: string, chatId: string, origin: TurnOrigin, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
+    inputReceivedAtMs?: number;
     signal?: AbortSignal;
     runId?: string;
     taskRunId?: string;

package/dist/src/gateway/service/run-gateway-agent.js

@@ -32,6 +32,9 @@ const log = createLogger("Gateway:Service");
 * @param runOptions.signal — When set (e.g. client disconnect), aborts in-flight generation and persists partial output.
 */
 async function* runGatewayAgent(deps, message, channel, chatId, origin, attachments, thinking, runOptions) {
+	const runStartedAtMs = Date.now();
+	const inputReceivedAtMs = runOptions?.inputReceivedAtMs ?? runStartedAtMs;
+	let firstTextSeen = false;
 	const cappedAttachments = attachments && attachments.length > 10 ? attachments.slice(0, 10) : attachments;
 	if (attachments && cappedAttachments && attachments.length > cappedAttachments.length) log.debug({
 		dropped: attachments.length - cappedAttachments.length,
@@ -115,6 +118,18 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 	};
 	const emitAndYield = function* (events) {
 		for (const event of events) {
+			if (!firstTextSeen && event.type === "assistant_delta" && event.payload.delta.trim()) {
+				firstTextSeen = true;
+				log.info({
+					conversationId: streamConversationId,
+					runId,
+					channel,
+					phase: "first_response_text",
+					latencyMs: Date.now() - runStartedAtMs,
+					inputToTextMs: Date.now() - inputReceivedAtMs,
+					queueMs: Math.max(0, runStartedAtMs - inputReceivedAtMs)
+				}, "Gateway first response text ready");
+			}
 			if (taskRun) captureTaskEvent(event);
 			if (channel === "webchat") publishRealtime(`run:${runId}`, event.type, event);
 			yield event;

package/dist/src/gateway/service/session-command-service.js

@@ -2,9 +2,9 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { init_session_repository } from "../../storage/sqlite/session-repository.js";
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
-import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { getModelThinking } from "../../providers/model-thinking.js";
 import { withModelConfigLock } from "../../session/model-config-lock.js";
 import { SessionCommandError, acceptSessionCommand, getSessionPreparation, matchSessionInputReceipt, sessionCommandHash } from "../../storage/sqlite/session-creation-repository.js";
@@ -25,7 +25,7 @@ function validateCreation(service, creation) {
 	if (!getModelThinking(resolveModel(creation.model)).options.includes(creation.thinkingLevel)) throw new Error("Unsupported model thinking level");
 }
 async function receiveSessionCommand(service, conversationId, principalId, command, prepareSourceContexts = async () => []) {
-	return withModelConfigLock(conversationId, async () => {
+	const receive = () => withModelConfigLock(conversationId, async () => {
 		const personal = getPersonalAgentByConversation(conversationId);
 		if (personal && "creation" in command && command.creation.agentId !== personal.agentId) throw new SessionCommandError("BAD_REQUEST", "Personal AI identity is fixed");
 		const configuredThinking = ("creation" in command ? resolveEffectiveAgentConfigForAgent(command.creation.agentId) : resolveEffectiveAgentConfigForSession(conversationId)).config.runtime.thinkingLevel;
@@ -52,6 +52,7 @@ async function receiveSessionCommand(service, conversationId, principalId, comma
 				conversationId,
 				clientMessageId,
 				delivery: command.kind === "start" ? "next" : command.delivery,
+				interrupt: command.kind === "append" ? command.interrupt : void 0,
 				content: command.input.content,
 				attachments: command.input.attachments,
 				contextRefs: command.input.contextRefs,
@@ -64,9 +65,10 @@ async function receiveSessionCommand(service, conversationId, principalId, comma
 			}) : void 0,
 			attachProject: (id, projectId) => service.projects.attachSession(id, projectId)
 		});
-		if ("kind" in command && command.kind === "append" && command.delivery === "steer" && receipt.inputId) await service.dispatchAcceptedSessionInput(conversationId, receipt.inputId);
+		if ("kind" in command && command.kind === "append" && receipt.inputId) await service.dispatchAcceptedSessionInput(conversationId, receipt.inputId);
 		return sessionCommandSnapshot(service, receipt);
 	});
+	return service.withSessionInputSubmission(conversationId, receive);
 }
 async function sessionCommandSnapshot(service, receipt) {
 	const { principalId: _principal, requestHash: _hash, ...identity } = receipt;

package/dist/src/gateway/service/session-input-coordinator.d.ts

@@ -8,6 +8,8 @@ export type SubmitSessionInput = {
     conversationId: string;
     clientMessageId: string;
     delivery: SessionInputDelivery;
+    /** False explicitly defers a Personal AI message or requests cooperative steering. */
+    interrupt?: boolean;
     content: string;
     attachments?: UserTurnAttachment[];
     contextRefs?: TurnContextRef[];
@@ -20,13 +22,19 @@ export type ReplaceLatestTurnInput = SubmitSessionInput & {
 };
 export declare class SessionInputCoordinator {
     private readonly deps;
+    private readonly pendingSubmissions;
+    private readonly resumeAfter;
     private readonly draining;
     private readonly submissionTails;
     constructor(deps: {
+        prioritizeInput?: (input: SubmitSessionInput) => boolean;
+        interrupt?: (conversationId: string, runId: string) => Promise<void>;
+        coalesceWindowMs?: number;
         onInputReceived?: (conversationId: string) => void;
         beforeExecute?: (input: SessionInput) => Promise<boolean>;
         sessionExists: (conversationId: string) => Promise<boolean>;
         execute: (input: {
+            inputReceivedAtMs?: number;
             runId: string;
             taskRunId?: string;
             conversationId: string;
@@ -44,6 +52,7 @@ export declare class SessionInputCoordinator {
         steer: (conversationId: string, content: string) => Promise<boolean>;
         emit: (type: string, payload: unknown) => void;
     });
+    isAcceptingInput(conversationId: string): boolean;
     snapshot(conversationId: string): SessionInputState;
     prepareInput(input: SubmitSessionInput): Promise<{
         status: "queued";
@@ -52,6 +61,7 @@ export declare class SessionInputCoordinator {
         content: string;
         attachments: UserTurnAttachment[];
         contextRefs: import("../../agent/source-context/types.js").SourceContextRefSummary[];
+        interruptRequested: boolean;
         contextSnapshots: AgentSourceContext[];
         thinking: string;
         origin: {
@@ -66,8 +76,10 @@ export declare class SessionInputCoordinator {
         };
     }>;
     dispatchAcceptedInput(conversationId: string, inputId: string): Promise<void>;
+    private prioritizeAcceptedInput;
     private publish;
     private runSubmissionExclusive;
+    withSubmission<T>(conversationId: string, operation: () => Promise<T>): Promise<T>;
     submit(input: SubmitSessionInput): Promise<{
         ok: true;
         effectiveDelivery: SessionInputDelivery;