@xopcai/xopc 0.0.358 → 0.0.360

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

@@ -3,31 +3,22 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
 import { getBrowserTabBinding, init_browser_tab_binding_repository } from "../../storage/sqlite/browser-tab-binding-repository.js";
+import { init_request_repository, personalRequestForExecution } from "../../personal-agent/request-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
+import { patchSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
-import "../../../packages/browser-control-contract/src/index.js";
-import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
-import { checkBrowserReadiness } from "../../browser/readiness.js";
-import "../../browser/index.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { createWorkflowCatalog } from "../workflow/catalog.js";
-import { ComputerRuntime } from "../../computer/runtime.js";
-import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
-import { skillEnvironmentId } from "../skills/installer.js";
+import "../../../packages/browser-control-contract/src/index.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
+import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
-import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
-import { createDataBatchTool } from "./dataBatch.js";
-import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
-import { createDelegateTool } from "./delegate-tool.js";
-import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
 import { createReadFileTool } from "./read.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { skillEnvironmentId } from "../skills/installer.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -50,7 +41,14 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
+import "../../browser/index.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
+import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
+import { createWorkflowCatalog } from "../workflow/catalog.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserAutomationTool } from "./browser-automation-tool.js";
@@ -66,17 +64,24 @@ import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
 import { createPersonalTaskTool } from "./personal-task-tool.js";
+import { createPersonalRequestTools } from "./personal-request-tool.js";
+import { createPersonalRequestConnectionTool, createPersonalRequestResultTool } from "./personal-request-result-tool.js";
 import { createPersonalPreferenceTool } from "./personal-preference-tool.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
+import { ComputerRuntime } from "../../computer/runtime.js";
 import { createComputerUseTool } from "./computer-use-tool.js";
 import { createReviewWorkspaceTool } from "./review-workspace.js";
 import { createLanguageDiagnosticsTool } from "./language-diagnostics.js";
+import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
 import { getAgentCapabilityToolNames } from "../capabilities/registry.js";
 import "../capabilities/index.js";
 import { sortToolsForPromptCache } from "./cache-stability.js";
 //#region src/agent/tools/factory.ts
 init_agent_scope();
+init_request_repository();
 init_browser_tab_binding_repository();
 init_logger();
 init_sqlite();
@@ -211,7 +216,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;
 		const getSkillMgr = options?.getSkillManager;
 		const disabled = options?.disabledTools;
-		const allowed = options?.toolAllowlist ? new Set(options.toolAllowlist) : void 0;
+		let allowed = options?.toolAllowlist ? new Set(options.toolAllowlist) : void 0;
 		const personalToolsConfigured = Boolean(allowed?.has("personal_task") || allowed?.has("personal_preference"));
 		const primary = getPrimary?.();
 		const modelHasVision = primary?.input?.includes("image") ?? false;
@@ -231,6 +236,22 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const agentId = options?.agentId;
 		const resolvedAgentId = agentId ?? (cfg ? resolveDefaultAgentId() : "main");
 		const currentConversationId = () => options?.conversationId ?? this.deps.getCurrentContext?.()?.conversationId;
+		const executionConversationId = currentConversationId();
+		const personalExecution = executionConversationId ? personalRequestForExecution(executionConversationId) : void 0;
+		const personalExecutionMarker = executionConversationId && isXopcDatabaseOpen() ? getSessionMetadata(executionConversationId)?.customData?.personalReadRequestId : void 0;
+		if (personalExecution && executionConversationId && personalExecutionMarker !== personalExecution.requestId) patchSessionMetadata(executionConversationId, { customData: {
+			...getSessionMetadata(executionConversationId)?.customData,
+			personalReadRequestId: personalExecution.requestId
+		} });
+		if (personalExecution || personalExecutionMarker) {
+			allowed = new Set([
+				"xopc_tool_search",
+				"xopc_tool_describe",
+				"xopc_tool_execute"
+			].filter((name) => !allowed || allowed.has(name)));
+			allowed.add("personal_request_result");
+			allowed.add("personal_request_connection");
+		}
 		const deliveryContext = () => {
 			if (currentConversationId() && getSessionMetadata(currentConversationId())?.sessionType === "heartbeat") throw new Error("Heartbeat notifications must be returned in the final response for policy-controlled delivery.");
 			return this.deps.getCurrentContext();
@@ -451,10 +472,14 @@ var AgentToolsFactory = class AgentToolsFactory {
 				getProjectService: this.deps.getProjectService
 			})] : [],
 			...browserEnabled && this.deps.getBrowserAutomationService ? [createBrowserAutomationTool({ getBrowserAutomationService: this.deps.getBrowserAutomationService })] : [],
-			...this.deps.getAutomationService || this.deps.getSceneAccess || this.deps.getProjectService || this.deps.getNotesService || this.deps.getLocalAppService || this.deps.getChatPreviewService || this.deps.dispatchTaskEvents || this.deps.dispatchTaskRuns ? [createXopcUseTool(productToolDeps), ...personalToolsConfigured ? [createPersonalTaskTool(productToolDeps), createPersonalPreferenceTool({
-				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
-				onAgentCatalogMutate: this.deps.onAgentCatalogMutate
-			})] : []] : [],
+			...this.deps.getAutomationService || this.deps.getSceneAccess || this.deps.getProjectService || this.deps.getNotesService || this.deps.getLocalAppService || this.deps.getChatPreviewService || this.deps.dispatchTaskEvents || this.deps.dispatchTaskRuns ? [createXopcUseTool(productToolDeps), ...personalToolsConfigured ? [
+				createPersonalTaskTool(productToolDeps),
+				...createPersonalRequestTools(productToolDeps),
+				createPersonalPreferenceTool({
+					getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
+					onAgentCatalogMutate: this.deps.onAgentCatalogMutate
+				})
+			] : []] : [],
 			...cfg?.computer.enabled && this.deps.endpointTools ? [createComputerUseTool({
 				runtime: this.ensureComputerRuntime(),
 				context: () => {
@@ -528,7 +553,8 @@ var AgentToolsFactory = class AgentToolsFactory {
 					});
 				}
 			})] : [],
-			...optionalTools
+			...optionalTools,
+			...personalExecution ? [createPersonalRequestResultTool(currentConversationId), createPersonalRequestConnectionTool(currentConversationId)] : []
 		];
 		if ([
 			"read_file",

package/dist/src/agent/tools/fetch-text.js

@@ -1,6 +1,6 @@
 import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
-import { lookup } from "node:dns";
 import { Agent, fetch } from "undici";
+import { lookup } from "node:dns";
 //#region src/agent/tools/fetch-text.ts
 /** Validate each redirect and the address actually used for the connection. */
 async function fetchPublicText(input, blocklist, signal) {

package/dist/src/agent/tools/image-generate-tool.js

@@ -1,12 +1,12 @@
 import { getAgentDefaultImageGenerationModelConfig, init_schema } from "../../config/schema.js";
+import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
-import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
+import { persistToolMedia } from "./tool-media.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";
 import { applyImageGenerationModelConfigDefaults } from "../image/image-helpers.js";
-import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
-import { persistToolMedia } from "./tool-media.js";
 import { isFailoverError } from "../failover-error.js";
+import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
 import path from "node:path";
 import { randomBytes } from "node:crypto";

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

@@ -1,13 +1,8 @@
-import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
-import "../../browser/index.js";
 import { DEFAULT_TOOL_METADATA, getToolMetadata } from "./metadata.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
-import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
-import { createDataBatchTool } from "./dataBatch.js";
-import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, GREP_MAX_LINE_LENGTH, formatSize, truncateHead, truncateLine, truncateTail } from "./truncate.js";
 import { createReadFileTool } from "./read.js";
+import { createDataBatchTool } from "./dataBatch.js";
 import { createWriteFileTool, writeFileTool } from "./write.js";
 import { createListDirTool, listDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -31,6 +26,11 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import "../../browser/index.js";
+import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
+import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";

package/dist/src/agent/tools/list-dir.js

@@ -1,5 +1,5 @@
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { checkedFilePath } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { readdir } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/list-dir.ts

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

@@ -1,3 +1,4 @@
+import { applyUserProfilePatch } from "../../user-model/profile.js";
 import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { PersonalPreferencesSchema, updatePersonalProfileRecord } from "../../personal-agent/service.js";
 import { Type } from "@sinclair/typebox";
@@ -28,6 +29,16 @@ function createPersonalPreferenceTool(deps) {
 				...personal.preferences,
 				[input.field]: input.value.trim()
 			});
+			if (input.field === "addressAs") {
+				applyUserProfilePatch({ callName: next.addressAs ?? "" });
+				return {
+					content: [{
+						type: "text",
+						text: "Saved the preferred name in the shared user profile. It takes effect on the next reply."
+					}],
+					details: {}
+				};
+			}
 			if (!await updatePersonalProfileRecord(personal.ownerId, personal.revision, personal.displayName, next, personal.appearance)) throw new Error("Preference changed concurrently; read the current profile and try again");
 			deps.onAgentCatalogMutate?.();
 			return {

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

@@ -0,0 +1,22 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+declare const Schema: import("@sinclair/typebox").TObject<{
+    summary: import("@sinclair/typebox").TString;
+    coverage: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        from: import("@sinclair/typebox").TString;
+        to: import("@sinclair/typebox").TString;
+        scannedCount: import("@sinclair/typebox").TInteger;
+        partial: import("@sinclair/typebox").TBoolean;
+    }>>;
+    items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        messageId: import("@sinclair/typebox").TString;
+        subject: import("@sinclair/typebox").TString;
+        sender: import("@sinclair/typebox").TString;
+        receivedAt: import("@sinclair/typebox").TString;
+        importanceReason: import("@sinclair/typebox").TString;
+        suggestedAction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        openUrl: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+}>;
+export declare function createPersonalRequestResultTool(conversationId: () => string | undefined): AgentTool<typeof Schema>;
+export declare function createPersonalRequestConnectionTool(conversationId: () => string | undefined): AgentTool;
+export {};

package/dist/src/agent/tools/personal-request-result-tool.js

@@ -0,0 +1,84 @@
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
+import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
+import { init_request_repository, personalRequestForExecution } from "../../personal-agent/request-repository.js";
+import { PersonalRequestResultSchema } from "../../personal-agent/request-result.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/personal-request-result-tool.ts
+init_transaction();
+init_request_repository();
+init_task_run_repository();
+const Schema = Type.Object({
+	summary: Type.String({
+		minLength: 1,
+		maxLength: 8e3
+	}),
+	coverage: Type.Optional(Type.Object({
+		from: Type.String(),
+		to: Type.String(),
+		scannedCount: Type.Integer({ minimum: 0 }),
+		partial: Type.Boolean()
+	})),
+	items: Type.Array(Type.Object({
+		messageId: Type.String(),
+		subject: Type.String(),
+		sender: Type.String(),
+		receivedAt: Type.String(),
+		importanceReason: Type.String(),
+		suggestedAction: Type.Optional(Type.String()),
+		openUrl: Type.Optional(Type.String())
+	}), { maxItems: 50 })
+});
+function createPersonalRequestResultTool(conversationId) {
+	return {
+		name: "personal_request_result",
+		label: "Publish connected-app result",
+		parameters: Schema,
+		description: "Publish the read-only Personal request result to its originating main chat. For mail, include actual message IDs, senders, dates, importance reasons, Gmail or Outlook links, and query coverage. partial must be true when the requested range was not fully searched. Do not invent messages or claim an empty inbox after an incomplete search.",
+		async execute(_id, params) {
+			const id = conversationId();
+			const request = id ? personalRequestForExecution(id) : void 0;
+			if (!request || [
+				"cancelled",
+				"completed",
+				"failed"
+			].includes(request.state)) throw new Error("No active Personal request");
+			const result = PersonalRequestResultSchema.parse(params);
+			if (["composio-gmail", "composio-outlook"].includes(request.connectorId) && !result.coverage) throw new Error("Mail results require query coverage, including partial failures");
+			if (result.coverage && Date.parse(result.coverage.from) >= Date.parse(result.coverage.to)) throw new Error("Invalid coverage range");
+			if (result.coverage && request.parameters.timeRange && (Date.parse(result.coverage.from) > Date.parse(request.parameters.timeRange.from) || Date.parse(result.coverage.to) < Date.parse(request.parameters.timeRange.to))) result.coverage.partial = true;
+			const run = request.taskId ? new TaskRunRepository().getActiveRoot(request.taskId) : void 0;
+			if (!run || run.conversationId !== id) throw new Error("Task execution changed");
+			getSqliteDatabase().prepare("UPDATE personal_requests SET result_json = ?, result_run_id = ?, updated_at = ? WHERE request_id = ?").run(JSON.stringify(result), run.id, Date.now(), request.requestId);
+			return {
+				content: [{
+					type: "text",
+					text: "Result saved for delivery to the originating chat after this Task completes."
+				}],
+				details: {}
+			};
+		}
+	};
+}
+function createPersonalRequestConnectionTool(conversationId) {
+	return {
+		name: "personal_request_connection",
+		label: "Restore connected-app access",
+		parameters: Type.Object({}),
+		description: "If the selected account is disconnected or expired, pause this Personal request and show reconnection in the originating main chat. Do not use this for missing tool schemas or unsupported operations. Stop work after the connection requirement is saved.",
+		async execute() {
+			const id = conversationId();
+			if (!id) throw new Error("No active conversation");
+			const { requirePersonalWorkerConnection, publishPersonalRequest } = await import("../../personal-agent/request-service.js");
+			publishPersonalRequest(requirePersonalWorkerConnection(id));
+			return {
+				content: [{
+					type: "text",
+					text: "Waiting for the selected app account to be reconnected in the main chat. Stop this turn; the Task will resume automatically."
+				}],
+				details: {}
+			};
+		}
+	};
+}
+//#endregion
+export { createPersonalRequestConnectionTool, createPersonalRequestResultTool };

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

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { XopcUseToolDeps } from './xopc-use-tool.js';
+export declare function createPersonalRequestTools(deps: XopcUseToolDeps): AgentTool[];

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

@@ -0,0 +1,100 @@
+import { getPersonalRequest, init_request_repository, listPersonalRequests } from "../../personal-agent/request-repository.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { personalCapabilities } from "../../personal-agent/capability-service.js";
+import { cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest, submitPersonalRequest } from "../../personal-agent/request-service.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/personal-request-tool.ts
+init_request_repository();
+const CapabilitySchema = Type.Object({
+	query: Type.String({
+		minLength: 1,
+		maxLength: 500
+	}),
+	accountId: Type.Optional(Type.String())
+});
+const RequestSchema = Type.Object({
+	command: Type.Union([
+		"submit",
+		"get",
+		"list",
+		"cancel"
+	].map((command) => Type.Literal(command))),
+	requestId: Type.Optional(Type.String()),
+	connectorId: Type.Optional(Type.String()),
+	agentId: Type.Optional(Type.String()),
+	accountId: Type.Optional(Type.String()),
+	objective: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 4e3
+	})),
+	idempotencyKey: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 200
+	})),
+	timeRange: Type.Optional(Type.Object({
+		from: Type.String(),
+		to: Type.String(),
+		timezone: Type.String(),
+		expression: Type.String()
+	}))
+});
+function createPersonalRequestTools(deps) {
+	const conversation = () => {
+		const id = deps.getCurrentConversationId?.();
+		if (!id || !isPersonalConversation(id)) throw new Error("Personal conversation is required");
+		return id;
+	};
+	const result = (value) => ({
+		content: [{
+			type: "text",
+			text: JSON.stringify(value)
+		}],
+		details: {}
+	});
+	return [{
+		name: "personal_capability",
+		label: "Connected app availability",
+		parameters: CapabilitySchema,
+		description: "Check connected-app capabilities, account connection state and specialist Agents locally. For Gmail or other supported apps, check here before delegating. ready is a local preflight; the worker still validates live tools. No remote search or authorization is performed.",
+		async execute(_id, input) {
+			return result(personalCapabilities(conversation(), input.query, input.accountId));
+		}
+	}, {
+		name: "personal_request",
+		label: "Connected app request",
+		parameters: RequestSchema,
+		description: "Submit a read-only connected-app request using exact connectorId and agentId from personal_capability. Preserves the objective, displays connection or account selection in this main chat, and starts a specialist Task automatically once connected. Return quickly after submission. Never claim data was read until the Task result arrives. Resolve absolute query dates and include timeRange. If mail has no user-specified range, the host returns an explicit last-7-days default; mention that range in your confirmation. Use get/list for status, cancel only when the user requests it.",
+		async execute(toolCallId, input) {
+			const conversationId = conversation();
+			if (input.command === "list") return result(listPersonalRequests(conversationId).map(personalRequestSnapshot));
+			if (input.command === "submit") {
+				if (!input.objective?.trim() || !input.connectorId || !input.agentId) throw new Error("objective, connectorId and agentId are required");
+				const request = submitPersonalRequest({
+					conversationId,
+					connectorId: input.connectorId,
+					agentId: input.agentId,
+					accountId: input.accountId,
+					objective: input.objective.trim(),
+					timeRange: input.timeRange,
+					idempotencyKey: input.idempotencyKey ?? toolCallId
+				});
+				publishPersonalRequest(request);
+				deps.dispatchTaskRuns?.();
+				return result(personalRequestSnapshot(request));
+			}
+			const request = input.requestId ? getPersonalRequest(input.requestId) : void 0;
+			if (!request || request.conversationId !== conversationId) throw new Error("Request does not belong to this conversation");
+			if (input.command === "cancel") {
+				const cancelled = cancelPersonalRequest(request);
+				publishPersonalRequest(cancelled);
+				return result({
+					...cancelled,
+					executionStopConfirmed: false
+				});
+			}
+			return result(personalRequestSnapshot(request));
+		}
+	}];
+}
+//#endregion
+export { createPersonalRequestTools };

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

@@ -1,4 +1,5 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type EffectiveAgentConfig } from '../../agent-config/index.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">]>;
@@ -15,6 +16,11 @@ declare const PersonalTaskSchema: import("@sinclair/typebox").TObject<{
     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 declare function buildPersonalTaskBrief(input: {
     title?: string;
     objective: string;

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

@@ -1,11 +1,12 @@
 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 { init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.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/publish-artifacts.js

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename, isAbsolute, relative, sep } from "node:path";
 import { realpath } from "node:fs/promises";

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

@@ -1,8 +1,8 @@
-import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { checkedFilePath, readWorkspaceFileAsync } from "../sandbox/fileAccess.js";
-import { checkFileSafety } from "../prompt/safety.js";
 import { dataScheduler } from "../data-acquisition/scheduler.js";
+import { checkFileSafety } from "../prompt/safety.js";
 import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { stat } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/read.ts

package/dist/src/agent/tools/review-workspace.js

@@ -1,5 +1,5 @@
-import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
+import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { checkedFilePath, readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { resolve } from "node:path";

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

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { MEDIA_MAX_BYTES } from "../../media/store.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { MEDIA_MAX_BYTES } from "../../media/store.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename } from "node:path";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/skills-tools.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
-import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
 import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
 import { resolveSkillReadablePath } from "../skills/skill-view-path.js";
 import { readFileSync, statSync } from "fs";
 import { Type } from "@sinclair/typebox";

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/agent/tools/tts-tool.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { speak } from "../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { getChannelOutputFormat } from "../../voice/tts/service.js";
-import { speak } from "../../voice/tts/speak-core.js";
 import { compressAudio } from "../../voice/tts/audio.js";
 import { persistOutboundTtsAudio } from "../../channels/attachments/outbound-tts-persist.js";
 import { Type } from "@sinclair/typebox";