@xopcai/xopc 0.0.385 → 0.0.386

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

@@ -1,3 +1,6 @@
+import { init_research_checkpoint, researchResumeContext } from "../orchestration/research-checkpoint.js";
+import { claimResearchCheckpoint, createResearchCheckpoint, finishResearchCheckpoint, getResearchCheckpoint, init_research_checkpoint_repository, recordResearchEvidence, recordResearchSearch, saveResearchCheckpoint } from "../../storage/sqlite/research-checkpoint-repository.js";
+import { resolveAgentAbortReason } from "../orchestration/run-termination.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
 import "../external-tools/index.js";
@@ -8,8 +11,11 @@ import { runGit } from "../../execution-environments/git.js";
 import { LocalWorktreeManager } from "../../execution-environments/local-worktree-manager.js";
 import { SessionEnvironmentService } from "../../execution-environments/session-environment-service.js";
 import { DELEGATION_CAPABILITIES, DELEGATION_TOOL_CAPABILITIES, protectDelegatedTool, resolveDelegationTools } from "./delegation-policy.js";
+import { resolve } from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/delegate-tool.ts
+init_research_checkpoint();
+init_research_checkpoint_repository();
 const DEFAULT_DELEGATE_TOOLS = resolveDelegationTools(Object.keys(DELEGATION_TOOL_CAPABILITIES), "research").granted;
 /** Tools never passed to a delegated sub-agent (even if requested). */
 const DELEGATE_BLOCKED_TOOLS = new Set([
@@ -25,10 +31,23 @@ const DELEGATE_BLOCKED_TOOLS = new Set([
 	"skill_install",
 	EXTERNAL_TOOL_NAMES.requireConnection,
 	EXTERNAL_TOOL_NAMES.updateConnectionObjective,
-	"managed_job"
+	"managed_job",
+	"research_checkpoint"
 ]);
 const DelegateTaskSchema = Type.Object({
-	goal: Type.String({ minLength: 1 }),
+	goal: Type.String({
+		minLength: 1,
+		maxLength: 8e3
+	}),
+	resumeId: Type.Optional(Type.String({
+		format: "uuid",
+		description: "Resume a saved research checkpoint owned by this conversation and workspace; preserve the original goal."
+	})),
+	maxAttempts: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 3,
+		description: "Research attempts in this call, including bounded automatic continuation after budget exhaustion. Default 2; cancellation, permissions and provider failures are not automatically retried."
+	})),
 	context: Type.Optional(Type.String()),
 	mode: Type.Optional(Type.Union([
 		"inspect",
@@ -54,16 +73,48 @@ function createDelegateTool(deps) {
 		name: "delegate_task",
 		label: "Delegate task",
 		parameters: DelegateTaskSchema,
-		description: "Delegate a bounded task with a fresh context; supply relevant facts and constraints in context. Default research inherits the parent's local, web, knowledge, skill and approved external read tools. read/inspect/review are local read-only. toolset and capabilities only narrow parent access; custom requires explicit capabilities. Browser interaction is opt-in. implement requires a project and clean Git workspace and returns changes in a separate worktree for review. No nested delegation, external writes, installation or background jobs. budgetTier selects light, standard (default), or deep; token budgets sum all model requests, not context size. Reports stop reason, budget usage, partial handoff and rejected tools.",
+		description: "Delegate a bounded task with a fresh context; supply relevant facts and constraints in context. Default research inherits the parent's local, web, knowledge, skill and approved external read tools. read/inspect/review are local read-only. toolset and capabilities only narrow parent access; custom requires explicit capabilities. Browser interaction is opt-in. implement requires a project and clean Git workspace and returns changes in a separate worktree for review. No nested delegation, external writes, installation or background jobs. budgetTier selects light, standard (default), or deep; token budgets sum all model requests, not context size. Research saves structured findings and source evidence durably for the current conversation. Use resumeId to continue unfinished work; maxAttempts bounds automatic budget continuation (default 2). Reports stop reason, budget usage, partial handoff and rejected tools.",
 		supportsParallel: false,
 		idempotent: false,
+		timeoutMs: DELEGATION_BUDGETS.deep.timeoutMs * 3 + 3e4,
 		async execute(_id, input, signal) {
 			signal?.throwIfAborted();
 			const mode = input.mode ?? "research";
+			if (input.resumeId && mode !== "research") throw new Error("resumeId is only supported for research");
 			const scope = getDelegationScope();
 			const parentTools = scope?.tools ?? deps.getParentTools();
 			const access = resolveDelegationTools(parentTools.map((tool) => tool.name), mode, input.toolset, input.capabilities);
 			const tools = access.granted;
+			const parentConversationId = deps.getCurrentContext?.()?.conversationId;
+			let workspace = deps.workspace, environmentId;
+			if (mode === "implement") {
+				if (!parentConversationId) throw new Error("Implementation delegation requires a project session");
+				const parent = new SessionEnvironmentService().get(parentConversationId);
+				if (!parent?.projectId) throw new Error("Attach this session to a project before implementation delegation");
+				const environment = await new LocalWorktreeManager().provisionManagedWorktree({
+					projectId: parent.projectId,
+					repositoryPath: workspace
+				});
+				workspace = environment.rootPath;
+				environmentId = environment.id;
+			}
+			const revision = mode === "review" ? await readWorkspaceRevision(workspace) : void 0;
+			const authorizeToolCall = scope?.authorizeToolCall ?? deps.createParentPolicy?.().beforeToolCall;
+			let research = mode === "research" && parentConversationId && (tools.length > 0 || input.resumeId) ? input.resumeId ? getResearchCheckpoint(input.resumeId, parentConversationId, resolve(workspace)) : createResearchCheckpoint(parentConversationId, resolve(workspace), input.goal) : void 0;
+			if (input.resumeId && !research) throw new Error("Research checkpoint not found in this conversation and workspace");
+			if (research && research.goal !== input.goal) throw new Error("Resuming research must preserve the original goal");
+			if (research?.status === "completed") return {
+				content: [{
+					type: "text",
+					text: research.summary + "\n" + JSON.stringify(research.checkpoint)
+				}],
+				details: {
+					status: "success",
+					stopReason: "completed",
+					resumeId: research.id,
+					checkpoint: research.checkpoint
+				}
+			};
 			if (!tools.length) return {
 				content: [{
 					type: "text",
@@ -77,130 +128,174 @@ function createDelegateTool(deps) {
 					stopReason: "parent_policy",
 					mode,
 					grantedTools: tools,
-					rejectedTools: access.rejected
+					rejectedTools: access.rejected,
+					...research ? {
+						resumeId: research.id,
+						checkpoint: research.checkpoint
+					} : {}
 				}
 			};
-			const parentConversationId = deps.getCurrentContext?.()?.conversationId;
 			const model = deps.getSubagentModel();
-			let workspace = deps.workspace, environmentId;
-			if (mode === "implement") {
-				if (!parentConversationId) throw new Error("Implementation delegation requires a project session");
-				const parent = new SessionEnvironmentService().get(parentConversationId);
-				if (!parent?.projectId) throw new Error("Attach this session to a project before implementation delegation");
-				const environment = await new LocalWorktreeManager().provisionManagedWorktree({
-					projectId: parent.projectId,
-					repositoryPath: workspace
-				});
-				workspace = environment.rootPath;
-				environmentId = environment.id;
-			}
-			const revision = mode === "review" ? await readWorkspaceRevision(workspace) : void 0;
-			const authorizeToolCall = scope?.authorizeToolCall ?? deps.createParentPolicy?.().beforeToolCall;
-			const child = createDelegateChildHandle({
-				workspace,
-				goal: mode === "review" ? `Independently review the actual changes. Inspect review_workspace and relevant source/tests. Report actionable defects with file and line evidence, severity and a concrete failure example. If there are no findings, state the checks and remaining uncertainty. Do not treat the parent's completion claim as evidence.\n\n${input.goal}` : input.goal,
-				context: input.context,
-				requesterConversationId: parentConversationId,
-				allowedToolNames: tools,
-				budgetTier: input.budgetTier,
-				maxIterations: input.maxIterations ?? DELEGATION_BUDGETS[input.budgetTier ?? "standard"].maxToolCalls,
-				model,
-				bus: deps.bus,
-				getConfig: deps.getConfig,
-				toolExecutorConfig: deps.toolExecutorConfig,
-				authorizeToolCall,
-				buildChildTools: (opts) => {
-					const local = mode === "implement" ? new Map(deps.buildChildTools(opts).map((tool) => [tool.name, tool])) : void 0;
-					const rebound = new Set([
-						"read_file",
-						"grep",
-						"find",
-						"list_dir",
-						"review_workspace",
-						"write_file",
-						"apply_patch",
-						"exec_command",
-						"language_diagnostics"
-					]);
-					return parentTools.flatMap((tool) => {
-						const candidate = local && rebound.has(tool.name) ? local.get(tool.name) : tool;
-						return candidate ? [protectDelegatedTool(candidate)] : [];
+			const attemptLimit = research ? Math.min(3, Math.max(1, input.maxAttempts ?? 2)) : 1;
+			let attempt = 0;
+			const attemptBudgets = [];
+			let result;
+			do {
+				signal?.throwIfAborted();
+				attempt++;
+				if (research) research = claimResearchCheckpoint(research, DELEGATION_BUDGETS[input.budgetTier ?? "standard"].timeoutMs + 1e4);
+				const claimedResearch = research;
+				const checkpointSink = claimedResearch ? {
+					read: () => getResearchCheckpoint(claimedResearch.id, claimedResearch.conversationId, claimedResearch.workspace).checkpoint,
+					save: (update) => saveResearchCheckpoint(claimedResearch, update),
+					recordEvidence: (evidence) => recordResearchEvidence(claimedResearch, evidence),
+					recordSearch: (entry) => recordResearchSearch(claimedResearch, entry)
+				} : void 0;
+				let child;
+				const abort = () => child?.abort(resolveAgentAbortReason(signal?.reason));
+				try {
+					child = createDelegateChildHandle({
+						workspace,
+						goal: mode === "review" ? `Independently review the actual changes. Inspect review_workspace and relevant source/tests. Report actionable defects with file and line evidence, severity and a concrete failure example. If there are no findings, state the checks and remaining uncertainty. Do not treat the parent's completion claim as evidence.\n\n${input.goal}` : input.goal,
+						context: [input.context, research ? researchResumeContext(research.checkpoint) : void 0].filter(Boolean).join("\n\n") || void 0,
+						researchCheckpoint: checkpointSink,
+						requesterConversationId: parentConversationId,
+						allowedToolNames: tools,
+						budgetTier: input.budgetTier,
+						maxIterations: input.maxIterations ?? DELEGATION_BUDGETS[input.budgetTier ?? "standard"].maxToolCalls,
+						model,
+						bus: deps.bus,
+						getConfig: deps.getConfig,
+						toolExecutorConfig: deps.toolExecutorConfig,
+						authorizeToolCall,
+						buildChildTools: (opts) => {
+							const local = mode === "implement" ? new Map(deps.buildChildTools(opts).map((tool) => [tool.name, tool])) : void 0;
+							const rebound = new Set([
+								"data_batch",
+								"read_file",
+								"grep",
+								"find",
+								"list_dir",
+								"review_workspace",
+								"write_file",
+								"apply_patch",
+								"exec_command",
+								"language_diagnostics"
+							]);
+							return parentTools.flatMap((tool) => {
+								const candidate = local && rebound.has(tool.name) ? local.get(tool.name) : tool;
+								return candidate ? [protectDelegatedTool(candidate)] : [];
+							});
+						},
+						verifyChanges: mode === "implement"
 					});
-				},
-				verifyChanges: mode === "implement"
-			});
-			const abort = () => child.abort();
-			signal?.addEventListener("abort", abort, { once: true });
-			if (signal?.aborted) abort();
-			try {
-				const result = await child.run();
-				const currentRevision = mode === "review" ? await readWorkspaceRevision(workspace) : void 0;
-				const stale = mode === "review" && (!revision || revision !== currentRevision);
-				const patch = mode === "implement" ? await runGit(workspace, [
-					"diff",
-					"--no-ext-diff",
-					"--no-textconv",
-					"--binary",
-					"HEAD"
-				]).catch(() => "") : void 0;
-				return {
-					content: [{
-						type: "text",
-						text: [
-							result.summary,
-							`Budget (${result.budget.tier}): ${JSON.stringify({
-								stopReason: result.stopReason,
-								usage: result.budget.usage,
-								limits: result.budget.limits,
-								handoffRequested: result.handoff.requested
-							})}`,
-							stale ? "Workspace changed or could not be fingerprinted; review findings require revalidation." : "",
-							access.rejected.length ? `Rejected tools: ${JSON.stringify(access.rejected)}` : "",
-							environmentId ? `Changes retained in ${workspace} (environment ${environmentId}). Review and integrate from this workspace, then verify the parent workspace again.` : "",
-							patch ? `Patch preview:\n${patch.slice(0, 3e4)}` : ""
-						].filter(Boolean).join("\n\n")
-					}],
-					details: {
-						status: stale && result.status === "success" ? "partial" : result.status,
-						mode,
-						summary: result.summary,
-						grantedTools: tools,
-						rejectedTools: access.rejected,
-						iterations: result.toolIterations,
-						revision: currentRevision,
-						reviewedRevision: revision,
-						stopReason: result.stopReason,
-						budget: result.budget,
-						handoff: result.handoff,
-						...result.verification ? { childVerification: result.verification } : {},
-						...environmentId ? {
-							environmentId,
-							workspace,
-							patchTruncated: (patch?.length ?? 0) > 3e4
-						} : {}
+					signal?.addEventListener("abort", abort, { once: true });
+					if (signal?.aborted) abort();
+					result = await child.run();
+					attemptBudgets.push(result.budget);
+					if (research && checkpointSink) {
+						const checkpoint = checkpointSink.read();
+						if (result.status === "success" && (!checkpoint.findings.length || checkpoint.nextSteps.length || checkpoint.findings.some((finding) => finding.status === "unverified"))) result = {
+							...result,
+							status: "partial",
+							stopReason: "verification",
+							summary: result.summary + "\nResearch checkpoint still has unfinished work; do not claim completion."
+						};
+						finishResearchCheckpoint(research, result.status === "success" ? "completed" : result.status, result.stopReason, result.summary);
+						research = getResearchCheckpoint(research.id, research.conversationId, research.workspace);
 					}
-				};
-			} catch (error) {
-				return {
-					content: [{
-						type: "text",
-						text: `Delegation failed: ${String(error)}${environmentId ? `; work retained in ${workspace} (${environmentId})` : ""}`
-					}],
-					details: {
-						status: signal?.aborted ? "cancelled" : "failed",
-						stopReason: signal?.aborted ? "cancelled" : "runtime_error",
-						mode,
-						grantedTools: tools,
-						rejectedTools: access.rejected,
-						...environmentId ? {
-							environmentId,
-							workspace
-						} : {}
+				} catch (error) {
+					const stopReason = signal?.aborted ? resolveAgentAbortReason(signal.reason) : "runtime_error";
+					const status = stopReason === "deadline_exceeded" ? "partial" : signal?.aborted ? "cancelled" : "failed";
+					if (research) {
+						if (getResearchCheckpoint(research.id, research.conversationId, research.workspace)?.leaseToken === research.leaseToken) finishResearchCheckpoint(research, status, stopReason, String(error));
+						research = getResearchCheckpoint(research.id, research.conversationId, research.workspace) ?? research;
 					}
-				};
-			} finally {
-				signal?.removeEventListener("abort", abort);
-			}
+					return {
+						content: [{
+							type: "text",
+							text: `Delegation failed: ${String(error)}${environmentId ? `; work retained in ${workspace} (${environmentId})` : ""}`
+						}],
+						details: {
+							status,
+							stopReason,
+							mode,
+							grantedTools: tools,
+							rejectedTools: access.rejected,
+							...research ? {
+								resumeId: research.id,
+								checkpoint: research.checkpoint
+							} : {},
+							...environmentId ? {
+								environmentId,
+								workspace
+							} : {}
+						}
+					};
+				} finally {
+					signal?.removeEventListener("abort", abort);
+				}
+			} while (research && attempt < attemptLimit && !signal?.aborted && result.status === "partial" && [
+				"tool_calls",
+				"total_tokens",
+				"model_turns",
+				"timeout",
+				"deadline_exceeded"
+			].includes(result.stopReason) && research.checkpoint.nextSteps.length > 0);
+			const currentRevision = mode === "review" ? await readWorkspaceRevision(workspace) : void 0;
+			const stale = mode === "review" && (!revision || revision !== currentRevision);
+			const patch = mode === "implement" ? await runGit(workspace, [
+				"diff",
+				"--no-ext-diff",
+				"--no-textconv",
+				"--binary",
+				"HEAD"
+			]).catch(() => "") : void 0;
+			return {
+				content: [{
+					type: "text",
+					text: [
+						result.summary,
+						research ? `Research checkpoint ${research.id}: ${JSON.stringify(research.checkpoint)}. Resume unfinished work with resumeId and the same goal.` : "",
+						`Budget (${result.budget.tier}): ${JSON.stringify({
+							stopReason: result.stopReason,
+							usage: result.budget.usage,
+							limits: result.budget.limits,
+							handoffRequested: result.handoff.requested
+						})}`,
+						stale ? "Workspace changed or could not be fingerprinted; review findings require revalidation." : "",
+						access.rejected.length ? `Rejected tools: ${JSON.stringify(access.rejected)}` : "",
+						environmentId ? `Changes retained in ${workspace} (environment ${environmentId}). Review and integrate from this workspace, then verify the parent workspace again.` : "",
+						patch ? `Patch preview:\n${patch.slice(0, 3e4)}` : ""
+					].filter(Boolean).join("\n\n")
+				}],
+				details: {
+					status: stale && result.status === "success" ? "partial" : result.status,
+					mode,
+					summary: result.summary,
+					grantedTools: tools,
+					rejectedTools: access.rejected,
+					iterations: attemptBudgets.reduce((total, budget) => total + (budget.usage.toolCalls ?? 0), 0),
+					revision: currentRevision,
+					reviewedRevision: revision,
+					stopReason: result.stopReason,
+					budget: result.budget,
+					handoff: result.handoff,
+					...research ? {
+						resumeId: research.id,
+						checkpoint: research.checkpoint,
+						attempts: attempt,
+						totalAttempts: research.attempts,
+						attemptBudgets
+					} : {},
+					...result.verification ? { childVerification: result.verification } : {},
+					...environmentId ? {
+						environmentId,
+						workspace,
+						patchTruncated: (patch?.length ?? 0) > 3e4
+					} : {}
+				}
+			};
 		}
 	};
 }

package/dist/src/agent/tools/delegation-policy.js

@@ -11,6 +11,7 @@ const DELEGATION_CAPABILITIES = [
 ];
 /** Host-owned classifications. New tools fail closed until classified. */
 const DELEGATION_TOOL_CAPABILITIES = {
+	data_batch: "local_read",
 	read_file: "local_read",
 	grep: "local_read",
 	find: "local_read",
@@ -43,6 +44,16 @@ const DELEGATION_TOOL_CAPABILITIES = {
 	language_diagnostics: "command",
 	browser_use: "browser"
 };
+const BATCH_SOURCES = new Set([
+	"read_file",
+	"grep",
+	"exec_command",
+	"knowledge_search",
+	"knowledge_get",
+	"web_search",
+	"web_fetch",
+	"xopc_tool_execute"
+]);
 const RESEARCH = [
 	"local_read",
 	"web_read",
@@ -67,7 +78,8 @@ function resolveDelegationTools(parentNames, mode, requested, capabilities) {
 	const rejected = [];
 	for (const tool of new Set((requested ?? parentNames).map((name) => name.trim()).filter(Boolean))) {
 		const capability = DELEGATION_TOOL_CAPABILITIES[tool];
-		const reason = !parent.has(tool) ? "Unavailable to the parent agent" : !capability ? "Tool has no delegable capability" : !allowed.has(capability) ? `Capability ${capability} is outside this delegation` : void 0;
+		const capabilityAllowed = tool === "data_batch" ? parentNames.some((name) => BATCH_SOURCES.has(name) && allowed.has(DELEGATION_TOOL_CAPABILITIES[name])) : capability !== void 0 && allowed.has(capability);
+		const reason = !parent.has(tool) ? "Unavailable to the parent agent" : !capability ? "Tool has no delegable capability" : !capabilityAllowed ? `Capability ${capability} is outside this delegation` : void 0;
 		if (reason) {
 			if (requested) rejected.push({
 				tool,

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

@@ -40,6 +40,7 @@ import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
+import { createTaskResultTool } from "./task-result-tool.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { createTodoTool } from "./todo-tool.js";
@@ -427,6 +428,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			})] : [],
 			createSendMediaTool(workspace, bus, deliveryContext),
 			createPublishArtifactsTool(workspace),
+			createTaskResultTool(currentConversationId),
 			createReadMediaTool(personalToolsConfigured ? {
 				textOnly: true,
 				maxChars: LOCAL_READ_MAX_CHARS,

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

@@ -17,6 +17,7 @@ export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LEN
 export { createMessageTool } from './communication.js';
 export { createSendMediaTool } from './send-media.js';
 export { createPublishArtifactsTool } from './publish-artifacts.js';
+export { createTaskResultTool } from './task-result-tool.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';
 export { createTodoTool, TodoStore, type TodoItem, type TodoStatus } from './todo-tool.js';

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

@@ -19,6 +19,7 @@ import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
+import { createTaskResultTool } from "./task-result-tool.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { TodoStore, createTodoTool } from "./todo-tool.js";
@@ -47,4 +48,4 @@ import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
 import { createPersonalReadTool } from "./personal-read-tool.js";
 import { createTaskCollaborationTool } from "./task-collaboration-tool.js";
-export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDataBatchTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTaskCollaborationTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowManageTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDataBatchTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTaskCollaborationTool, createTaskResultTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowManageTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/language-diagnostics.js

@@ -1,7 +1,7 @@
 import { createExecCommandTool } from "./exec-command.js";
 import { relative, resolve, sep } from "node:path";
-import { access } from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
+import { access } from "node:fs/promises";
 //#region src/agent/tools/language-diagnostics.ts
 function parseTypeScriptDiagnostics(output) {
 	return [...output.matchAll(/^(.+)\((\d+),(\d+)\): error (TS\d+): (.+)$/gm)].slice(0, 200).map((match) => ({

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

@@ -9,10 +9,9 @@ import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { TaskAllocationRepository } from "../../tasks/task-allocation-repository.js";
 import { boundedPersonalResult } from "./personal-result-budget.js";
 import { selectionRequestHash } from "../../agent-matching/selection-repository.js";
-import { cancelPersonalTask } from "../../personal-agent/task-cancel.js";
 import { createPersonalTaskTool } from "./personal-task-tool.js";
 import { personalCapabilities } from "../../personal-agent/capability-service.js";
-import { assertPersonalRequestTimeRange, cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest, submitPersonalRequest } from "../../personal-agent/request-service.js";
+import { assertPersonalRequestTimeRange, cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest, stopPersonalRequestExecution, submitPersonalRequest } from "../../personal-agent/request-service.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-request-tool.ts
 init_session_input_repository();
@@ -163,14 +162,14 @@ function createPersonalRequestTools(deps) {
 		name: "personal_request",
 		label: "Connected app request",
 		parameters: RequestSchema,
-		description: "Submit a read-only connected-app request with a short objective and complete description using the exact connectorId from personal_capability. The background Task Router chooses an executor after account authorization. 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. get includes complete Task coordination state; collaboration/entry read the same board and full questions. answer forwards the exact questionId; instruct forwards new requirements to the existing Task. Answers and instructions cannot change the connector/account, grant access or allow writes; reconnection stays in the existing connection UI. Saved, delivered, executor-confirmed and verified are distinct states. Use get/list for status without polling; preserve idempotencyKey on uncertain retries; cancel only when the user requests it.",
+		description: "Submit a read-only connected-app request with a short objective and complete description using the exact connectorId from personal_capability. The background Task Router chooses an executor after account authorization. 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; state that range and proceed without asking for confirmation. get includes complete Task coordination state; collaboration/entry read the same board and full questions. answer forwards the exact questionId; instruct forwards new requirements to the existing Task. Answers and instructions cannot change the connector/account, grant access or allow writes; reconnection stays in the existing connection UI. Saved, delivered, executor-confirmed and verified are distinct states. Use get/list for status without polling; preserve idempotencyKey on uncertain retries; cancel only when the user requests it.",
 		async execute(toolCallId, input) {
 			const conversationId = conversation();
 			if (input.command === "list") {
 				const offset = input.offset ?? 0;
 				const items = listPersonalRequests(conversationId, input.limit ?? 10, offset).map((request) => {
 					const { result: _result, parameters, ...summary } = snapshot(request);
-					const { brief: _brief, ...queryParameters } = parameters;
+					const { brief: _brief, taskRunId: _taskRunId, cancellationCleanupCompleted: _cleanup, ...queryParameters } = parameters;
 					return {
 						...summary,
 						parameters: queryParameters
@@ -203,21 +202,17 @@ function createPersonalRequestTools(deps) {
 				});
 				publishPersonalRequest(request);
 				deps.dispatchTaskRuns?.();
-				return result(compactSnapshot(request));
+				return result({
+					...compactSnapshot(request),
+					guidance: request.state === "waiting_connection" ? "The objective is saved. The host presents the required connection or account selection and continues automatically afterward. Stop this turn; do not ask the user to confirm the read or reply continue." : "The request was accepted. No further user confirmation is needed. Report the returned state accurately, do not submit a duplicate, and wait for delivery without polling."
+				});
 			}
 			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") {
 				if (["completed", "failed"].includes(personalRequestSnapshot(request).state)) return result(compactSnapshot(request));
-				if (request.state === "cancelled") {
-					const stop = request.taskId ? await cancelPersonalTask(request.taskId, conversationId, input.idempotencyKey ?? toolCallId) : { executionStopConfirmed: true };
-					return result({
-						...compactSnapshot(request),
-						executionStopConfirmed: stop.executionStopConfirmed
-					});
-				}
-				const stop = request.taskId ? await cancelPersonalTask(request.taskId, conversationId, input.idempotencyKey ?? toolCallId) : { executionStopConfirmed: true };
 				const cancelled = cancelPersonalRequest(request);
+				const stop = stopPersonalRequestExecution(cancelled);
 				publishPersonalRequest(cancelled);
 				return result({
 					...compactSnapshot(cancelled),

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

@@ -14,18 +14,17 @@ declare const PersonalTaskModelSchema: import("@sinclair/typebox").TObject<{
     }>>;
     command: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"get" | "answer" | "retry_allocation" | "selection" | "list" | "cancel" | "entry" | "submit" | "instruct" | "collaboration">[]>;
     requestId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    instruction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     requiredSkills: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     objective: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     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>>;
     description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    instruction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     section: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>>;
     entryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     afterSequence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;

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

@@ -12,12 +12,12 @@ import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { boundedPersonalResult } from "./personal-result-budget.js";
 import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../../personal-agent/specialist-capabilities.js";
 import { assessSpecialist, matchSpecialists } from "../../agent-matching/service.js";
 import { AgentSelectionRepository, selectionRequestHash } from "../../agent-matching/selection-repository.js";
 import { assertSpecialistEligible, createSelectedTask } from "../../agent-matching/delegation-service.js";
-import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
 import { cancelPersonalTask } from "../../personal-agent/task-cancel.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
@@ -122,7 +122,8 @@ const PersonalTaskModelSchema = Type.Object({
 		"previousSelectionId",
 		"matchId",
 		"cursor",
-		"requiredTools"
+		"requiredTools",
+		"acceptanceCriteria"
 	]).properties,
 	requirements: Type.Optional(Type.Omit(PersonalTaskSchema.properties.requirements, ["requiredTools", "requiredSkills"], { additionalProperties: false })),
 	command: Type.Union([
@@ -314,9 +315,9 @@ function createPersonalTaskTool(deps) {
 					createMode: "allocate",
 					requirements,
 					includeConversationContext: false,
-					expectedOutputs: input.expectedOutputs ?? [],
-					acceptanceCriteria: input.acceptanceCriteria ?? [],
-					constraints: input.constraints ?? [],
+					expectedOutputs: input.expectedOutputs,
+					acceptanceCriteria: input.acceptanceCriteria,
+					constraints: input.constraints,
 					idempotencyKey: `personal-submit:${conversationId}:${selectionRequestHash(submissionKey)}`
 				};
 				if (requirements.requiredSkills?.length) args.body = `${brief.body}\n\nRequired Skills: ${requirements.requiredSkills.join(", ")}. Read and follow these Skills before execution.`;
@@ -397,9 +398,9 @@ function createPersonalTaskTool(deps) {
 					agentId,
 					createMode: "start",
 					includeConversationContext: false,
-					expectedOutputs: input.expectedOutputs ?? [],
-					acceptanceCriteria: input.acceptanceCriteria ?? [],
-					constraints: input.constraints ?? [],
+					expectedOutputs: input.expectedOutputs,
+					acceptanceCriteria: input.acceptanceCriteria,
+					constraints: input.constraints,
 					idempotencyKey: key
 				};
 			} else if (command === "list") {

package/dist/src/agent/tools/publish-artifacts.js

@@ -6,8 +6,8 @@ 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";
 import { Type } from "@sinclair/typebox";
+import { realpath } from "node:fs/promises";
 //#region src/agent/tools/publish-artifacts.ts
 init_src();
 const PublishArtifactsSchema = Type.Object({ paths: Type.Array(Type.String({ minLength: 1 }), {

package/dist/src/agent/tools/research-checkpoint-tool.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { ResearchCheckpointUpdateSchema, type ResearchCheckpointSink } from '../orchestration/research-checkpoint.js';
+export declare function createResearchCheckpointTool(sink: ResearchCheckpointSink): AgentTool<typeof ResearchCheckpointUpdateSchema>;