@xopcai/xopc 0.0.359 → 0.0.361

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

@@ -3,9 +3,10 @@ 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 { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-task-tool.ts
@@ -49,14 +50,16 @@ const DISCOVERY_TOOLS = [
 	"workflow",
 	"xopc_use",
 	"xopc_tool_search",
+	"xopc_tool_describe",
+	"xopc_tool_execute",
 	"computer_use",
 	"send_message",
 	"text_to_speech"
 ];
-function availableAgentTools(config, deps) {
+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 agentModelAvailability(config) {
+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 {}
@@ -72,11 +75,10 @@ function buildPersonalTaskBrief(input) {
 	const title = firstClause.length > MAX_PERSONAL_TASK_TITLE ? `${firstClause.slice(0, MAX_PERSONAL_TASK_TITLE - 1).trimEnd()}…` : firstClause;
 	const objective = fullObjective.length > 120 ? title : fullObjective;
 	const description = input.description?.trim();
-	const body = fullObjective !== objective ? [fullObjective, description].filter(Boolean).join("\n\n") : description;
 	return {
 		title,
 		objective,
-		...body ? { body } : {}
+		body: [fullObjective !== objective ? [fullObjective, description].filter(Boolean).join("\n\n") : description, PERSONAL_WORKER_RESULT_GUIDANCE].filter(Boolean).join("\n\n")
 	};
 }
 /** A narrow Task surface for the fast personal conversation. */
@@ -89,7 +91,7 @@ function createPersonalTaskTool(deps) {
 		parameters: PersonalTaskSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
-		requiresExclusiveWorkspaceLock: true,
+		requiresExclusiveWorkspaceLock: false,
 		finalGuardRelevant: true,
 		async execute(toolCallId, input, signal) {
 			const conversationId = deps.getCurrentConversationId?.();
@@ -103,13 +105,13 @@ function createPersonalTaskTool(deps) {
 						defaults: catalog.defaults,
 						agent
 					}).config;
-					const availableTools = availableAgentTools(config, deps);
+					const availableTools = getAvailablePersonalAgentTools(config, deps);
 					return {
 						id: agent.id,
 						name: agent.profile?.name ?? agent.id,
 						description: agent.profile?.description ?? "",
 						availableTools,
-						model: agentModelAvailability(config)
+						model: personalAgentModelAvailability(config)
 					};
 				}).filter((agent) => requiredTools.every((tool) => agent.availableTools.includes(tool)));
 				return {
@@ -130,9 +132,9 @@ function createPersonalTaskTool(deps) {
 				const specialist = new AgentCatalogRepository().get(agentId);
 				if (!specialist || specialist.enabled === false || specialist.provisioningState !== "ready") throw new Error(`Specialist Agent is unavailable: ${agentId}`);
 				const config = resolveEffectiveAgentConfigForAgent(agentId).config;
-				const model = agentModelAvailability(config);
+				const model = personalAgentModelAvailability(config);
 				if (!model.available) throw new Error(`Agent ${agentId} cannot start: ${model.reason}. Find another available Agent.`);
-				const availableTools = availableAgentTools(config, 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.`);
 				args = {
@@ -181,4 +183,4 @@ function createPersonalTaskTool(deps) {
 	};
 }
 //#endregion
-export { buildPersonalTaskBrief, createPersonalTaskTool };
+export { buildPersonalTaskBrief, createPersonalTaskTool, getAvailablePersonalAgentTools, personalAgentModelAvailability };

package/dist/src/agent/tools/read.d.ts

@@ -2,5 +2,8 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 export interface CreateReadFileToolOptions {
     /** When set and the path is a bare profile filename (e.g. SOUL.md), try this root if not in workspace. */
     profileMarkdownRoot?: string;
+    defaultMaxLines?: number;
+    maxOutputBytes?: number;
+    maxReadBytes?: number;
 }
 export declare function createReadFileTool(workspace: string, options?: CreateReadFileToolOptions): AgentTool;

package/dist/src/agent/tools/read.js

@@ -1,7 +1,7 @@
 import { checkedFilePath, readWorkspaceFileAsync } from "../sandbox/fileAccess.js";
 import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { checkFileSafety } from "../prompt/safety.js";
-import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+import { formatSize, truncateHead } from "./truncate.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { stat } from "fs/promises";
 import { Type } from "@sinclair/typebox";
@@ -29,11 +29,13 @@ function createReadFileTool(workspace, options) {
 		supportsParallel: true,
 		idempotent: true,
 		async execute(_toolCallId, params, signal) {
-			return dataScheduler.run(workspace, signal, () => executeReadFile(workspace, options?.profileMarkdownRoot, params, signal));
+			return dataScheduler.run(workspace, signal, () => executeReadFile(workspace, options, params, signal));
 		}
 	};
 }
-async function executeReadFile(workspace, profileMarkdownRoot, params, signal) {
+async function executeReadFile(workspace, options, params, signal) {
+	const profileMarkdownRoot = options?.profileMarkdownRoot;
+	const maxOutputBytes = options?.maxOutputBytes ?? 51200;
 	try {
 		const safety = checkFileSafety("read", params.path);
 		if (!safety.allowed) return {
@@ -60,6 +62,18 @@ async function executeReadFile(workspace, profileMarkdownRoot, params, signal) {
 				}
 			} else throw e;
 		}
+		if (options?.maxReadBytes && stats.size > options.maxReadBytes) return {
+			content: [{
+				type: "text",
+				text: `File is large (${formatSize(stats.size)}; local read limit ${formatSize(options.maxReadBytes)}). Tell the user briefly, then delegate reading and processing. Path: ${normalized}`
+			}],
+			details: {
+				path: normalized,
+				size: stats.size,
+				requiresSpecialist: true,
+				reason: "large_file"
+			}
+		};
 		if (stats.size > MAX_FILE_SIZE) return {
 			content: [{
 				type: "text",
@@ -72,12 +86,12 @@ async function executeReadFile(workspace, profileMarkdownRoot, params, signal) {
 		const lines = content.split("\n");
 		if (offset > lines.length) throw new Error(`Offset ${offset} exceeds ${lines.length} lines`);
 		const truncation = truncateHead(lines.slice(offset - 1).join("\n"), {
-			maxLines: params.limit || DEFAULT_MAX_LINES,
-			maxBytes: DEFAULT_MAX_BYTES
+			maxLines: params.limit || options?.defaultMaxLines || DEFAULT_MAX_LINES,
+			maxBytes: maxOutputBytes
 		});
 		let outputText = truncation.content;
-		if (truncation.truncated) if (truncation.firstLineExceedsLimit) outputText = `(Line exceeds ${formatSize(DEFAULT_MAX_BYTES)})`;
-		else outputText += `\n\n[Lines ${offset}-${offset + truncation.outputLines - 1} of ${lines.length}; continue with offset=${offset + truncation.outputLines}]`;
+		if (truncation.truncated) if (truncation.firstLineExceedsLimit) outputText = `(Line exceeds ${formatSize(maxOutputBytes)})`;
+		else outputText += options?.maxReadBytes ? `\n\n[File excerpt only. Tell the user briefly and delegate full reading and processing. Path: ${normalized}]` : `\n\n[Lines ${offset}-${offset + truncation.outputLines - 1} of ${lines.length}; continue with offset=${offset + truncation.outputLines}]`;
 		return {
 			content: [{
 				type: "text",
@@ -87,7 +101,11 @@ async function executeReadFile(workspace, profileMarkdownRoot, params, signal) {
 				path: normalized,
 				offset,
 				totalLines: lines.length,
-				truncated: truncation.truncated
+				truncated: truncation.truncated,
+				...options?.maxReadBytes && truncation.truncated ? {
+					requiresSpecialist: true,
+					reason: "large_file"
+				} : {}
 			}
 		};
 	} catch (error) {

package/dist/src/agent/tools/session-search-tool.d.ts

@@ -6,5 +6,6 @@ export interface SessionSearchToolDeps {
     getPrimaryModel: () => Model<Api>;
     getCurrentConversationId?: () => string | undefined;
     canAccess?: () => boolean;
+    localOnly?: boolean;
 }
 export declare function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool;

package/dist/src/agent/tools/session-search-tool.js

@@ -91,8 +91,10 @@ function createSessionSearchTool(deps) {
 	return {
 		name: "session_search",
 		label: "Session search",
-		description: "Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.",
+		description: deps.localOnly ? "Search other chats locally and return short matching transcript excerpts. Omit query to list recent chats. No model or network calls." : "Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.",
 		parameters: SessionSearchSchema,
+		supportsParallel: true,
+		idempotent: true,
 		async execute(_toolCallId, params, signal) {
 			if (deps.canAccess && !deps.canAccess()) return {
 				content: [{
@@ -103,7 +105,7 @@ function createSessionSearchTool(deps) {
 			};
 			const p = params;
 			const store = deps.getSessionStore();
-			const limit = Math.min(15, Math.max(1, p.limit ?? 5));
+			const limit = Math.min(deps.localOnly ? 5 : 15, Math.max(1, p.limit ?? (deps.localOnly ? 3 : 5)));
 			const query = p.query?.trim() ?? "";
 			try {
 				if (!query) {
@@ -114,7 +116,7 @@ function createSessionSearchTool(deps) {
 					});
 					const items = listed.items.slice(0, limit).map((s) => ({
 						key: s.key,
-						name: s.name,
+						name: deps.localOnly ? s.name?.slice(0, 200) : s.name,
 						updatedAt: s.updatedAt,
 						messageCount: s.messageCount,
 						sourceChannel: s.sourceChannel
@@ -135,18 +137,50 @@ function createSessionSearchTool(deps) {
 						}
 					};
 				}
-				let matches = (await store.list({
+				const listed = await store.list({
 					search: query,
 					limit: limit + 10,
 					sortBy: "updatedAt",
 					sortOrder: "desc"
-				})).items.map((item) => ({
+				});
+				let matches = listed.items.map((item) => ({
 					key: item.key,
 					score: 1
 				}));
 				const exclude = p.excludeConversationId?.trim() || deps.getCurrentConversationId?.() || "";
 				if (exclude) matches = matches.filter((m) => m.key !== exclude);
 				const top = matches.slice(0, limit);
+				if (deps.localOnly) {
+					const results = top.map(({ key }) => ({
+						conversationId: key,
+						name: listed.items.find((item) => item.key === key)?.name?.slice(0, 200),
+						excerpts: store.recallSession(key, query, { limit: 2 }).filter((match) => !p.roleFilter || match.role === p.roleFilter).map((match) => {
+							const at = match.content.toLowerCase().indexOf(query.toLowerCase());
+							const start = Math.max(0, at - 200);
+							return {
+								seq: match.seq,
+								role: match.role,
+								content: match.content.slice(start, start + 800),
+								truncated: start > 0 || match.content.length > start + 800
+							};
+						})
+					}));
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify({
+								success: true,
+								mode: "keyword",
+								query,
+								results
+							})
+						}],
+						details: {
+							localOnly: true,
+							count: results.length
+						}
+					};
+				}
 				const summaries = await Promise.all(top.map(async ({ key, score }) => {
 					let messages = await store.load(key);
 					if (p.roleFilter) messages = messages.filter((m) => m.role === p.roleFilter);

package/dist/src/agent/tools/tool-media.js

@@ -1,8 +1,7 @@
 import { sniffImageMimeType } from "../image/generation/image-assets.js";
-import { mimeTypeFromMediaPath, saveMediaBuffer } from "../../media/store.js";
+import { MEDIA_ARTIFACT_MAX_BYTES, mimeTypeFromMediaPath, saveMediaBuffer } from "../../media/store.js";
 import { basename } from "node:path";
 //#region src/agent/tools/tool-media.ts
-const MAX_TOOL_MEDIA_BYTES = 50 * 1024 * 1024;
 function hasImageMagic(buffer) {
 	if (buffer.length >= 8 && buffer.subarray(0, 8).equals(Buffer.from([
 		137,
@@ -41,7 +40,7 @@ async function persistToolMedia(params) {
 		bucket: "outbound",
 		contentType: mimeType,
 		originalFilename: name,
-		maxBytes: MAX_TOOL_MEDIA_BYTES
+		maxBytes: MEDIA_ARTIFACT_MAX_BYTES
 	});
 	return {
 		id: saved.id,

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 v230).`,
+		message: `SQLite schema v${status.dbVersion} (current release v232).`,
 		hints: []
 	};
 }

package/dist/src/cli/templates.js

@@ -97,6 +97,10 @@ _You're not a chatbot. You're becoming someone._
 - Earn trust through competence
 - Remember you're a guest
 
+## Vibe
+
+Speak like an attentive, reliable collaborator who understands the conversation. Use your own judgment and say what is useful now. Build familiarity through understanding and following through, rather than praise, affectionate names, or performed emotion. Explain when explanation helps; keep simple exchanges simple. Follow the user's language and communication preferences.
+
 ## Boundaries
 
 - Private things stay private

package/dist/src/config/schema.d.ts

@@ -1309,6 +1309,16 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
             maxKnowledge: z.ZodDefault<z.ZodNumber>;
             maxChars: z.ZodDefault<z.ZodNumber>;
             compaction: z.ZodDefault<z.ZodObject<{
+                personalIdle: z.ZodDefault<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    idleMs: z.ZodDefault<z.ZodNumber>;
+                    triggerThreshold: z.ZodDefault<z.ZodNumber>;
+                    cooldownMs: z.ZodDefault<z.ZodNumber>;
+                    timeoutMs: z.ZodDefault<z.ZodNumber>;
+                    keepRecentTokens: z.ZodDefault<z.ZodNumber>;
+                    summaryMaxTokens: z.ZodDefault<z.ZodNumber>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 triggerThreshold: z.ZodDefault<z.ZodNumber>;
                 reserveTokens: z.ZodDefault<z.ZodNumber>;

package/dist/src/connectors/connection-recovery-service.d.ts

@@ -20,6 +20,7 @@ export declare class ConnectionRecoveryService {
     private readonly deps;
     private readonly busy;
     private timer?;
+    private deliveryTimer?;
     private polling;
     start(): void;
     stop(): void;
@@ -31,6 +32,7 @@ export declare class ConnectionRecoveryService {
             error?: string;
         }>;
         drain: (conversationId: string) => void;
+        onPersonalRequestDelivered?: (conversationId: string, requestId: string) => void;
         adapter?: ComposioSessionsAdapter;
         pluginMcp?: PluginMcpRecovery;
     });

package/dist/src/connectors/connection-recovery-service.js

@@ -3,6 +3,7 @@ import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { readCurrentTranscriptId } from "../storage/sqlite/session-instance-repository.js";
 import { getSessionInputState, init_session_input_repository } from "../storage/sqlite/session-input-repository.js";
+import { init_request_repository, personalRequestForWait } from "../personal-agent/request-repository.js";
 import { getConnectorAccount, init_connector_account_repository } from "../storage/sqlite/connector-account-repository.js";
 import { getConnectorConnection, getConnectorInstallation, init_connector_repository, listConnectorConnections, upsertConnectorInstallation } from "../storage/sqlite/connector-repository.js";
 import { cancelConnectionObjective, getActiveConnectionWait, getConnectionWait, init_connection_wait_repository, listConnectionWaitsToCheck, publishConnectionWait, queueConnectionResolution, updateConnectionWait } from "../storage/sqlite/connection-wait-repository.js";
@@ -18,7 +19,9 @@ import { connectorPrincipalForSession } from "./principal.js";
 import { capabilityActions, isToolInputSchema, missingConnectionCapabilities } from "./connection-capabilities.js";
 import { installConnector } from "./install.js";
 import { resolveConnectionCandidate } from "./connection-candidates.js";
+import { cancelPersonalRequest, resolvePersonalRequestConnection } from "../personal-agent/request-service.js";
 import { persistConfigMutation } from "../config/config-mutation.js";
+import { drainPersonalRequestContinuations, drainPersonalRequestResults } from "../personal-agent/request-delivery.js";
 import { HostPluginMcpRecovery } from "./plugin-mcp-recovery.js";
 import { randomUUID } from "node:crypto";
 //#region src/connectors/connection-recovery-service.ts
@@ -29,6 +32,7 @@ init_connection_wait_repository();
 init_connector_repository();
 init_connector_account_repository();
 init_logger();
+init_request_repository();
 const log = createLogger("Connectors:Recovery");
 const SCOPE_ORDER = {
 	read: 1,
@@ -44,6 +48,7 @@ function isConnectorNeed(need) {
 var ConnectionRecoveryService = class {
 	busy = /* @__PURE__ */ new Set();
 	timer;
+	deliveryTimer;
 	polling = false;
 	start() {
 		if (this.timer) return;
@@ -51,16 +56,25 @@ var ConnectionRecoveryService = class {
 			this.poll();
 		}, 5e3);
 		this.timer.unref();
+		this.deliveryTimer = setInterval(() => {
+			drainPersonalRequestContinuations(this.deps.onPersonalRequestDelivered);
+			drainPersonalRequestResults(this.deps.onPersonalRequestDelivered);
+		}, 1e3);
+		this.deliveryTimer.unref();
 		this.poll();
 	}
 	stop() {
 		clearInterval(this.timer);
 		this.timer = void 0;
+		clearInterval(this.deliveryTimer);
+		this.deliveryTimer = void 0;
 	}
 	async poll() {
 		if (this.polling) return;
 		this.polling = true;
 		try {
+			drainPersonalRequestContinuations(this.deps.onPersonalRequestDelivered);
+			drainPersonalRequestResults(this.deps.onPersonalRequestDelivered);
 			for (const wait of listConnectionWaitsToCheck()) {
 				if (this.busy.has(wait.conversationId)) continue;
 				await this.act(wait.conversationId, {
@@ -383,8 +397,11 @@ var ConnectionRecoveryService = class {
 					action: action.action
 				}
 			};
-			if (action.action === "cancel") cancelConnectionObjective(conversationId);
-			else if (action.action === "replace_source") {
+			if (action.action === "cancel") {
+				const request = personalRequestForWait(wait.id);
+				if (request) cancelPersonalRequest(request);
+				else cancelConnectionObjective(conversationId);
+			} else if (action.action === "replace_source") {
 				const need = wait.needs.find((need) => need.key === action.needKey);
 				if (!need || !this.view(wait).needs.find((item) => item.key === need.key)?.alternatives?.some((item) => item.candidateRef === action.candidateRef)) throw new Error("Unsupported replacement.");
 				const replacement = resolveConnectionCandidate(action.candidateRef);
@@ -399,7 +416,7 @@ var ConnectionRecoveryService = class {
 				queueConnectionResolution({
 					...wait,
 					intent: void 0
-				}, "skipped");
+				}, "skipped", resolvePersonalRequestConnection);
 				this.deps.drain(conversationId);
 			} else if (action.action === "install_complete") {
 				const need = wait.needs.find((need) => need.key === action.needKey);
@@ -436,7 +453,7 @@ var ConnectionRecoveryService = class {
 					queueConnectionResolution({
 						...wait,
 						needs: view.needs.map(({ phase: _phase, accounts: _accounts, reason: _reason, alternatives: _alternatives, ...item }) => item)
-					}, "continued");
+					}, "continued", resolvePersonalRequestConnection);
 					log.info({
 						conversationId,
 						waitId: wait.id,
@@ -648,7 +665,7 @@ var ConnectionRecoveryService = class {
 					wait = queueConnectionResolution({
 						...wait,
 						needs: view.needs.map(({ phase: _phase, accounts: _accounts, reason: _reason, alternatives: _alternatives, ...need }) => need)
-					}, "continued");
+					}, "continued", resolvePersonalRequestConnection);
 					log.info({
 						conversationId,
 						waitId: wait.id,
@@ -658,6 +675,7 @@ var ConnectionRecoveryService = class {
 					this.deps.drain(conversationId);
 				}
 			}
+			drainPersonalRequestContinuations(this.deps.onPersonalRequestDelivered);
 			publishConnectionWait(conversationId);
 			return { snapshot: this.snapshot(conversationId) };
 		} catch (error) {

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" | "xopc_tool_search" | "xopc_tool_describe" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "memory_maintenance" | "computer_use" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];
+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")[];

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -252,6 +252,16 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
             maxKnowledge: number;
             maxChars: number;
             compaction: {
+                personalIdle: {
+                    enabled: boolean;
+                    idleMs: number;
+                    triggerThreshold: number;
+                    cooldownMs: number;
+                    timeoutMs: number;
+                    keepRecentTokens: number;
+                    summaryMaxTokens: number;
+                    model?: string;
+                };
                 enabled: boolean;
                 triggerThreshold: number;
                 reserveTokens: number;

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

@@ -1,4 +1,4 @@
-import { mimeTypeFromMediaPath, saveMediaBuffer } from "../../../media/store.js";
+import { MEDIA_ARTIFACT_MAX_BYTES, mimeTypeFromMediaPath, saveMediaBuffer } from "../../../media/store.js";
 import { readMediaReference } from "../../../media/media-reference.js";
 import { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from "../../chat-limits.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
@@ -70,10 +70,11 @@ function registerMediaRoutes(authenticated, deps) {
 			error: { message: "Missing media scope" }
 		}, 400);
 		try {
-			const { buffer, path } = await readMediaReference((await resolveScopedMediaReference(deps.service, uriRaw.trim(), {
+			const parsed = await resolveScopedMediaReference(deps.service, uriRaw.trim(), {
 				conversationId,
 				taskId
-			})).uri, MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);
+			});
+			const { buffer, path } = await readMediaReference(parsed.uri, parsed.bucket === "outbound" ? MEDIA_ARTIFACT_MAX_BYTES : MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);
 			const contentType = mimeTypeFromMediaPath(path);
 			const range = parseByteRange(c.req.header("Range"), buffer.byteLength);
 			const commonHeaders = {

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

@@ -1,12 +1,15 @@
 import { getDevice, init_device_access_repository } from "../../../storage/sqlite/device-access-repository.js";
-import { TaskOriginRepository } from "../../../tasks/task-origin-repository.js";
+import { getPersonalRequest, init_request_repository, listPersonalRequests } from "../../../personal-agent/request-repository.js";
 import { getPersonalAgent } from "../../../personal-agent/repository.js";
+import { TaskOriginRepository } from "../../../tasks/task-origin-repository.js";
+import { cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest } from "../../../personal-agent/request-service.js";
 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 { z } from "zod";
 //#region src/gateway/hono/routes/personal-agent.ts
 init_device_access_repository();
+init_request_repository();
 const CreateSchema = z.object({
 	model: z.string().trim().min(3).optional(),
 	displayName: z.string().trim().min(1).max(60).optional(),
@@ -71,6 +74,71 @@ function registerPersonalAgentRoutes(authenticated, deps) {
 			payload: await listPersonalModels()
 		});
 	});
+	authenticated.get("/api/personal-agent/requests", (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 ? listPersonalRequests(record.conversationId).map(personalRequestSnapshot) : []
+		});
+	});
+	authenticated.get("/api/personal-agent/requests/:requestId", (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		const request = getPersonalRequest(c.req.param("requestId"));
+		if (!request || request.conversationId !== getPersonalAgent(ownerId)?.conversationId) return c.json({
+			ok: false,
+			error: "Request not found"
+		}, 404);
+		return c.json({
+			ok: true,
+			payload: personalRequestSnapshot(request)
+		});
+	});
+	authenticated.post("/api/personal-agent/requests/:requestId/cancel", deps.strictRateLimitMiddleware, async (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		const request = getPersonalRequest(c.req.param("requestId"));
+		if (!request || request.conversationId !== getPersonalAgent(ownerId)?.conversationId) return c.json({
+			ok: false,
+			error: "Request not found"
+		}, 404);
+		const body = z.object({ expectedVersion: z.number().int().positive() }).strict().safeParse(await c.req.json().catch(() => null));
+		if (!body.success) return c.json({
+			ok: false,
+			error: "expectedVersion is required"
+		}, 400);
+		if (body.data.expectedVersion !== request.version) return c.json({
+			ok: false,
+			error: "Request changed"
+		}, 409);
+		try {
+			const cancelled = cancelPersonalRequest(request);
+			publishPersonalRequest(cancelled);
+			return c.json({
+				ok: true,
+				payload: {
+					...cancelled,
+					executionStopConfirmed: false
+				}
+			});
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 409);
+		}
+	});
 	authenticated.get("/api/personal-agent/onboarding", (c) => {
 		const ownerId = owner(c);
 		if (!ownerId) return c.json({

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

@@ -5,9 +5,9 @@ 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 { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runner.js";
 import { SessionEnvironmentService } from "../../../execution-environments/session-environment-service.js";
-import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../../media/session-references.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { createGatewayRouteLogger, logRouteError } from "../lib/route-logger.js";

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

@@ -2,12 +2,12 @@ import { voiceSelectionSchema } from "../../../../packages/realtime-protocol/src
 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 { resolveSttProviderConfigSlice } from "../../../voice/stt/config-slice.js";
 import { STTTranscriptionError, transcribe } from "../../../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../../../voice/stt/availability.js";
 import { mergeSttConfigFromAppConfig } from "../../../voice/stt/config.js";
 import "../../../voice/stt/index.js";
-import { isPersonalConversation } from "../../../personal-agent/repository.js";
 import { resolveTtsProviderConfigSlice } from "../../../voice/tts/config-slice.js";
 import { isTTSAvailable, resolveSpeechProvider } from "../../../voice/tts/factory.js";
 import { speak, speakStream } from "../../../voice/tts/speak-core.js";

package/dist/src/gateway/media-access.js

@@ -3,7 +3,7 @@ import { FileServiceError } from "../files/file-service.js";
 import { resolveMediaReference } from "../media/media-reference.js";
 import { pendingTranscriptReferencesMediaUri } from "../agent/inbound/attachment-pipeline.js";
 import { TaskContextRepository } from "../tasks/task-context-repository.js";
-import { messagesReferenceMediaUri } from "../media/session-references.js";
+import { messagesReferenceMediaUri, taskResultReferencesMediaUri } from "../media/session-references.js";
 //#region src/gateway/media-access.ts
 init_task_repository();
 /** Resolve media only when the supplied session or task references it. */
@@ -11,7 +11,7 @@ async function resolveScopedMediaReference(service, uri, scope) {
 	const { conversationId, taskId } = scope;
 	if (!conversationId && !taskId) throw new FileServiceError(400, "Missing media scope");
 	const media = await resolveMediaReference(uri);
-	const sessionReferencesUri = conversationId ? messagesReferenceMediaUri(await service.sessionIndexInstance.loadMessages(conversationId), media.uri) || pendingTranscriptReferencesMediaUri(conversationId, media.uri) : false;
+	const sessionReferencesUri = conversationId ? messagesReferenceMediaUri(await service.sessionIndexInstance.loadMessages(conversationId), media.uri) || pendingTranscriptReferencesMediaUri(conversationId, media.uri) || taskResultReferencesMediaUri(conversationId, media.uri) : false;
 	const taskReferencesUri = taskId && new TaskRepository().get(taskId) ? new TaskContextRepository().list(taskId).some((edge) => edge.targetKind === "file" && edge.targetId === media.uri) : false;
 	if (!sessionReferencesUri && !taskReferencesUri) throw new FileServiceError(404, "Not found");
 	return media;

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

@@ -75,6 +75,7 @@ var GatewayAgentRunner = class {
 				}
 				return result;
 			},
+			onInputReceived: (conversationId) => opts.getAgentService().sessionStore.idleCompaction.interrupt(conversationId),
 			prepareAttachments: async (conversationId, attachments) => {
 				const media = await opts.getAgentService().prepareInboundAttachments(conversationId, attachments);
 				if (!media?.length) return void 0;