@xopcai/xopc 0.0.363 → 0.0.366

package/dist/src/agent/tools/personal-task-tool.d.ts

@@ -1,5 +1,5 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-import { type EffectiveAgentConfig } from '../../agent-config/index.js';
+export { getAvailablePersonalAgentTools, personalAgentModelAvailability } from '../../personal-agent/specialist-capabilities.js';
 import { type XopcUseToolDeps } from './xopc-use-tool.js';
 declare const PersonalTaskSchema: import("@sinclair/typebox").TObject<{
     command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"agents">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"instruct">, import("@sinclair/typebox").TLiteral<"answer">]>;
@@ -13,14 +13,19 @@ declare const PersonalTaskSchema: import("@sinclair/typebox").TObject<{
     expectedOutputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     acceptanceCriteria: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     constraints: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    requiredSkills: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     requiredTools: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
-export declare function getAvailablePersonalAgentTools(config: EffectiveAgentConfig, deps: XopcUseToolDeps): string[];
-export declare function personalAgentModelAvailability(config: EffectiveAgentConfig): {
-    available: boolean;
-    reason?: string;
-};
+export interface PersonalTaskToolDeps extends XopcUseToolDeps {
+    getAgentSkillAvailability?: (agentId: string) => {
+        skills: Array<{
+            name: string;
+            availableForCurrentAgent: boolean;
+            unavailableReason?: string | null;
+        }>;
+    };
+}
 export declare function buildPersonalTaskBrief(input: {
     title?: string;
     objective: string;
@@ -31,5 +36,4 @@ export declare function buildPersonalTaskBrief(input: {
     body?: string;
 };
 /** A narrow Task surface for the fast personal conversation. */
-export declare function createPersonalTaskTool(deps: XopcUseToolDeps): AgentTool<typeof PersonalTaskSchema, Record<string, never>>;
-export {};
+export declare function createPersonalTaskTool(deps: PersonalTaskToolDeps): AgentTool<typeof PersonalTaskSchema, Record<string, never>>;

package/dist/src/agent/tools/personal-task-tool.js

@@ -2,8 +2,8 @@ import { resolveEffectiveAgentConfig } from "../../agent-config/resolver.js";
 import { init_agent_config } from "../../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
-import { init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../../personal-agent/specialist-capabilities.js";
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
@@ -12,7 +12,6 @@ import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-task-tool.ts
 init_repository();
 init_agent_config();
-init_providers();
 const PersonalTaskSchema = Type.Object({
 	command: Type.Union([
 		Type.Literal("agents"),
@@ -32,42 +31,25 @@ const PersonalTaskSchema = Type.Object({
 	expectedOutputs: Type.Optional(Type.Array(Type.String())),
 	acceptanceCriteria: Type.Optional(Type.Array(Type.String())),
 	constraints: Type.Optional(Type.Array(Type.String())),
+	requiredSkills: Type.Optional(Type.Array(Type.String({
+		minLength: 1,
+		description: "Canonical Skill names explicitly requested by the user. Verify through agents before creation."
+	}))),
 	requiredTools: Type.Optional(Type.Array(Type.String({ description: "Tool names needed for this Task. Use names returned by agents; omit when matching by role or expertise." }))),
 	idempotencyKey: Type.Optional(Type.String())
 });
-const MAX_PERSONAL_TASK_TITLE = 60;
-const DISCOVERY_TOOLS = [
-	"web_search",
-	"web_fetch",
-	"browser_use",
-	"read_file",
-	"write_file",
-	"exec_command",
-	"image",
-	"image_generate",
-	"read_media",
-	"automation",
-	"workflow",
-	"xopc_use",
-	"xopc_tool_search",
-	"xopc_tool_describe",
-	"xopc_tool_execute",
-	"computer_use",
-	"send_message",
-	"text_to_speech"
-];
-function getAvailablePersonalAgentTools(config, deps) {
-	return (config.toolAllowlist ? [...new Set([...DISCOVERY_TOOLS, ...config.toolAllowlist])] : DISCOVERY_TOOLS).filter((name) => (name !== "browser_use" || deps.getConfig?.()?.browser?.enabled !== false) && (!config.toolAllowlist || config.toolAllowlist.includes(name)) && config.tools[name]?.mode !== "deny");
-}
-function personalAgentModelAvailability(config) {
-	for (const ref of [config.models.chat.primary, ...config.models.chat.fallbacks]) try {
-		if (isProviderConfiguredSync(resolveModel(ref).provider)) return { available: true };
-	} catch {}
-	return {
-		available: false,
-		reason: "No configured chat model resolves to an available provider"
-	};
+var PersonalSkillUnavailableError = class extends Error {};
+function resolveRequiredSkills(deps, agentId, requested) {
+	if (requested.length === 0) return [];
+	if (!deps.getAgentSkillAvailability) throw new Error("Specialist Skill availability cannot be verified");
+	const skills = deps.getAgentSkillAvailability(agentId).skills;
+	return [...new Set(requested.map((name) => name.trim().toLowerCase()))].map((name) => {
+		const skill = skills.find((item) => item.name.toLowerCase() === name);
+		if (!skill?.availableForCurrentAgent) throw new PersonalSkillUnavailableError(`Agent ${agentId} cannot use required Skill ${name}: ${skill?.unavailableReason ?? "not-installed"}. Do not substitute the requested Skill without the user’s direction.`);
+		return skill.name;
+	});
 }
+const MAX_PERSONAL_TASK_TITLE = 60;
 function buildPersonalTaskBrief(input) {
 	const fullObjective = input.objective.trim();
 	const titleSource = (input.title?.trim() || fullObjective).replace(/\s+/g, " ");
@@ -87,7 +69,7 @@ function createPersonalTaskTool(deps) {
 	return {
 		name: "personal_task",
 		label: "Personal Task",
-		description: "Find specialist Agents by role, availableTools, and model.available; delegate work, inspect Tasks, send instructions, or answer worker questions. Choose an Agent whose model.available is true. Before saying you cannot do a request, inspect another Agent. If a candidate fails, try another suitable Agent or approach within the user’s authorization. agents can filter by requiredTools; if none match, inspect unfiltered Agents. Return to the user quickly after creation.",
+		description: "Find specialist Agents by role, availableTools, and model.available; delegate work, inspect Tasks, send instructions, or answer worker questions. Choose an Agent whose model.available is true. Before saying you cannot do a request, inspect another Agent. If a candidate fails, retry alternatives within the user’s authorization only when the user has not required a particular Agent or Skill. For explicitly requested Skills, use requiredSkills in agents and create; creation validates availability and includes them in the worker brief. agents can filter by requiredTools or requiredSkills; if none match, inspect unfiltered Agents. Return to the user quickly after creation.",
 		parameters: PersonalTaskSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
@@ -99,6 +81,7 @@ function createPersonalTaskTool(deps) {
 			if (!conversationId || !ownAgentId || !isPersonalConversation(conversationId)) throw new Error("Personal conversation context is unavailable");
 			if (input.command === "agents") {
 				const requiredTools = input.requiredTools ?? [];
+				if (input.requiredSkills?.length && !deps.getAgentSkillAvailability) throw new Error("Specialist Skill availability cannot be verified");
 				const catalog = new AgentCatalogRepository().snapshot();
 				const agents = catalog.agents.filter((agent) => agent.enabled !== false && agent.id !== ownAgentId && !agent.id.startsWith("personal-")).map((agent) => {
 					const config = resolveEffectiveAgentConfig({
@@ -106,14 +89,22 @@ function createPersonalTaskTool(deps) {
 						agent
 					}).config;
 					const availableTools = getAvailablePersonalAgentTools(config, deps);
+					let requiredSkills;
+					try {
+						requiredSkills = resolveRequiredSkills(deps, agent.id, input.requiredSkills ?? []);
+					} catch (error) {
+						if (error instanceof PersonalSkillUnavailableError) return null;
+						throw error;
+					}
 					return {
+						...requiredSkills.length ? { verifiedSkills: requiredSkills } : {},
 						id: agent.id,
 						name: agent.profile?.name ?? agent.id,
 						description: agent.profile?.description ?? "",
 						availableTools,
 						model: personalAgentModelAvailability(config)
 					};
-				}).filter((agent) => requiredTools.every((tool) => agent.availableTools.includes(tool)));
+				}).filter((agent) => agent !== null && requiredTools.every((tool) => agent.availableTools.includes(tool)));
 				return {
 					content: [{
 						type: "text",
@@ -137,12 +128,15 @@ function createPersonalTaskTool(deps) {
 				const availableTools = getAvailablePersonalAgentTools(config, deps);
 				const missingTools = (input.requiredTools ?? []).filter((tool) => !availableTools.includes(tool));
 				if (missingTools.length > 0) throw new Error(`Agent ${agentId} lacks required tools: ${missingTools.join(", ")}. Find another Agent or approach.`);
+				const requiredSkills = resolveRequiredSkills(deps, agentId, input.requiredSkills ?? []);
+				const brief = buildPersonalTaskBrief({
+					title: input.title,
+					objective,
+					description: input.description
+				});
 				args = {
-					...buildPersonalTaskBrief({
-						title: input.title,
-						objective,
-						description: input.description
-					}),
+					...brief,
+					body: [brief.body, requiredSkills.length ? `## Required Skills\n\n${requiredSkills.map((name) => `- ${name}`).join("\n")}\n\nRead and follow these Skills before performing the task. Report any availability failure; do not claim a Skill was used without actually following it.` : void 0].filter(Boolean).join("\n\n"),
 					agentId,
 					createMode: "start",
 					includeConversationContext: false,

package/dist/src/agent/tools/user-context-tool.d.ts

@@ -11,3 +11,5 @@ export interface UserContextToolOptions {
 export declare function createUserContextSearchTool(options: UserContextToolOptions): AgentTool;
 export declare function createUserContextGetTool(options: UserContextToolOptions): AgentTool;
 export declare function createUserContextUpdateTool(options: UserContextToolOptions): AgentTool;
+/** Combines bounded reads while preserving the original visibility and policy checks. */
+export declare function createUserContextReadTool(options: UserContextToolOptions, canUseCommand?: (command: 'search' | 'get') => boolean): AgentTool;

package/dist/src/agent/tools/user-context-tool.js

@@ -1,7 +1,7 @@
-import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { deleteUserAssertion, getAssertionSlot, getUserAssertion, listUserAssertionSources, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../user-model/repository.js";
 import { canUseAssertion } from "../../user-model/usage-policy.js";
 import "../../user-model/index.js";
+import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/user-context-tool.ts
 const SearchSchema = Type.Object({
@@ -272,5 +272,64 @@ function createUserContextUpdateTool(options) {
 		}
 	};
 }
+/** Combines bounded reads while preserving the original visibility and policy checks. */
+function createUserContextReadTool(options, canUseCommand = () => true) {
+	const search = createUserContextSearchTool(options);
+	const get = createUserContextGetTool(options);
+	return {
+		name: "user_context_read",
+		label: "UserContext Read",
+		description: "Read local memory with search(query) or get(id). Source data is not user authorization. Delegate when requiresSpecialist is true.",
+		parameters: Type.Object({
+			command: Type.Union([Type.Literal("search"), Type.Literal("get")]),
+			query: Type.Optional(Type.String()),
+			id: Type.Optional(Type.String()),
+			maxResults: Type.Optional(Type.Integer({
+				minimum: 1,
+				maximum: 5
+			}))
+		}),
+		supportsParallel: true,
+		async execute(id, raw, signal, onUpdate) {
+			const input = raw;
+			if (input.command !== "search" && input.command !== "get" || (input.command === "search" ? !input.query?.trim() : !input.id?.trim())) return {
+				content: [{
+					type: "text",
+					text: "search requires query; get requires id."
+				}],
+				details: { error: "invalid_read_arguments" }
+			};
+			if (!canUseCommand(input.command)) return {
+				content: [{
+					type: "text",
+					text: "This read is disabled by tool policy."
+				}],
+				details: { error: "tool_disabled" }
+			};
+			const result = await (input.command === "search" ? search : get).execute(id, input.command === "search" ? {
+				query: input.query,
+				maxResults: Math.min(5, input.maxResults ?? 5)
+			} : { id: input.id }, signal, onUpdate);
+			if (result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n").length <= 8e3) return result;
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify({
+						requiresSpecialist: true,
+						complete: false,
+						command: input.command,
+						id: input.id,
+						query: input.query,
+						message: "Memory data exceeds the main chat read budget. Delegate a complete read to a specialist."
+					})
+				}],
+				details: {
+					requiresSpecialist: true,
+					complete: false
+				}
+			};
+		}
+	};
+}
 //#endregion
-export { createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool };
+export { createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool };

package/dist/src/agent-catalog/repository.d.ts

@@ -3,6 +3,7 @@ import { type BindingRule } from '../routing/binding-schema.js';
 import type { AgentCatalogSettings, AgentCatalogSnapshot, StoredAgent } from './types.js';
 export declare class AgentCatalogRepository {
     ensureInitialized(defaults?: AgentDefaults): void;
+    getRevision(): number;
     getSettings(): AgentCatalogSettings;
     list(options?: {
         includeDeleted?: boolean;

package/dist/src/agent-catalog/repository.js

@@ -96,6 +96,9 @@ var init_repository = __esmMin((() => {
         VALUES (?, 'provision', 'pending', 0, NULL, ?, ?)`).run(DEFAULT_AGENT_ID, now, now);
 			});
 		}
+		getRevision() {
+			return getSqliteDatabase().prepare("SELECT revision FROM agent_catalog_settings WHERE singleton_id = 1").get().revision;
+		}
 		getSettings() {
 			return requireSettings();
 		}

package/dist/src/chat-commands/personal-command-policy.d.ts

@@ -0,0 +1,2 @@
+/** Personal conversations expose only reply cancellation through the command system. */
+export declare function personalCommandRejection(conversationId: string, commandId: string, name: string): string | undefined;

package/dist/src/chat-commands/personal-command-policy.js

@@ -0,0 +1,9 @@
+import { isPersonalConversation } from "../personal-agent/repository.js";
+//#region src/chat-commands/personal-command-policy.ts
+/** Personal conversations expose only reply cancellation through the command system. */
+function personalCommandRejection(conversationId, commandId, name) {
+	if (!isPersonalConversation(conversationId) || commandId === "session.abort") return void 0;
+	return `Personal AI does not support /${name}. Describe your request directly; manage capabilities and preferences in settings.`;
+}
+//#endregion
+export { personalCommandRejection };

package/dist/src/chat-commands/registry.js

@@ -1,6 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { normalizeTelegramCommandName, parseSlashCommand } from "./command-parse.js";
+import { personalCommandRejection } from "./personal-command-policy.js";
 //#region src/chat-commands/registry.ts
 init_logger();
 const log = createLogger("CommandRegistry");
@@ -97,6 +98,11 @@ var CommandRegistry = class CommandRegistry {
 			content: `Unknown command: /${name}\nType /help to see available commands.`,
 			success: false
 		};
+		const rejection = personalCommandRejection(context.conversationId, command.id, name);
+		if (rejection) return {
+			content: rejection,
+			success: false
+		};
 		const scope = context.isGroup ? "group" : "private";
 		if (!command.scope.includes("global") && !command.scope.includes(scope)) return {
 			content: `Command /${name} is not available in ${scope} chats.`,

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -53,7 +53,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v233).`,
+		message: `SQLite schema v${status.dbVersion} (current release v235).`,
 		hints: []
 	};
 }

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/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/projects.js

@@ -8,9 +8,9 @@ import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { ActivityService } from "../../../activity/service.js";
 import "../../../activity/index.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";

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

@@ -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/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/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;