@xopcai/xopc 0.0.383 → 0.0.385

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";
@@ -46,4 +46,5 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
 import { createPersonalReadTool } from "./personal-read-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, 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 };
+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 };

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-attention-tool.d.ts

@@ -2,6 +2,8 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
 declare const schema: import("@sinclair/typebox").TObject<{
     command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"follow">, import("@sinclair/typebox").TLiteral<"pause">, import("@sinclair/typebox").TLiteral<"end">, import("@sinclair/typebox").TLiteral<"resume">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"interests">, import("@sinclair/typebox").TLiteral<"feedback">, import("@sinclair/typebox").TLiteral<"rollback">]>;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     subject: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;

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

@@ -1,7 +1,8 @@
 import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
-import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
+import { boundedPersonalResult } from "./personal-result-budget.js";
 import { parseLocalCheckTime } from "../../personal-agent/proactivity/follow-up-request.js";
 import { applyThreadFeedback, getAttention, getProactivitySettings, listAttention, listInterestCandidates, patchAttention, patchProactivitySettings, rollbackStrategy, saveAttention, strategyState, userText } from "../../personal-agent/proactivity/repository.js";
 import { Type } from "@sinclair/typebox";
@@ -20,6 +21,11 @@ const schema = Type.Object({
 		Type.Literal("feedback"),
 		Type.Literal("rollback")
 	]),
+	offset: Type.Optional(Type.Integer({ minimum: 0 })),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20
+	})),
 	id: Type.Optional(Type.String()),
 	subject: Type.Optional(Type.String({ maxLength: 160 })),
 	summary: Type.Optional(Type.String({ maxLength: 1600 })),
@@ -39,6 +45,35 @@ const schema = Type.Object({
 	])),
 	preparation: Type.Optional(Type.Union([Type.Literal("brief"), Type.Literal("thorough")])),
 	versionId: Type.Optional(Type.String({ description: "Latest strategy version ID returned by list; required for rollback." }))
+}, {
+	additionalProperties: false,
+	anyOf: [
+		{ properties: { command: { enum: [
+			"list",
+			"settings",
+			"interests"
+		] } } },
+		{
+			properties: { command: { const: "follow" } },
+			required: ["subject"]
+		},
+		{
+			properties: { command: { enum: [
+				"pause",
+				"end",
+				"resume"
+			] } },
+			required: ["id"]
+		},
+		{
+			properties: { command: { const: "feedback" } },
+			required: ["id", "feedback"]
+		},
+		{
+			properties: { command: { const: "rollback" } },
+			required: ["id", "versionId"]
+		}
+	]
 });
 function createPersonalAttentionTool(deps) {
 	return {
@@ -59,30 +94,29 @@ function createPersonalAttentionTool(deps) {
 				}],
 				details: {}
 			};
-			if (input.command === "interests") {
-				if (!resolveUserContextSessionAccess(config, conversationId).userModel) throw new Error("Interest access is unavailable");
+			if (input.command === "interests" || input.command === "list") {
+				if (input.command === "interests" && !resolveUserContextSessionAccess(config, conversationId).userModel) throw new Error("Interest access is unavailable");
+				const rows = input.command === "interests" ? listInterestCandidates(conversationId) : listAttention(conversationId).map((thread) => ({
+					id: thread.id,
+					subject: thread.subject,
+					status: thread.status,
+					nextCheckAt: thread.next_check_at,
+					revision: thread.revision,
+					strategy: strategyState(thread.id)
+				}));
+				const offset = input.offset ?? 0;
 				return {
 					content: [{
 						type: "text",
-						text: JSON.stringify(listInterestCandidates(conversationId))
+						text: JSON.stringify(boundedPersonalResult({
+							items: rows.slice(offset, offset + (input.limit ?? 10)),
+							total: rows.length,
+							offset
+						}))
 					}],
 					details: {}
 				};
 			}
-			if (input.command === "list") return {
-				content: [{
-					type: "text",
-					text: JSON.stringify(listAttention(conversationId).map((thread) => ({
-						id: thread.id,
-						subject: thread.subject,
-						status: thread.status,
-						nextCheckAt: thread.next_check_at,
-						revision: thread.revision,
-						strategy: strategyState(thread.id)
-					})))
-				}],
-				details: {}
-			};
 			const db = getSqliteDatabase();
 			const transcriptId = readCurrentTranscriptId(db, conversationId);
 			const source = db.prepare("SELECT entry_id,payload_json FROM transcript_entries WHERE transcript_id = ? AND role = 'user' ORDER BY seq DESC LIMIT 1").get(transcriptId);

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

@@ -20,6 +20,12 @@ const schema = Type.Object({
 		minimum: 1,
 		maximum: 10
 	}))
+}, {
+	additionalProperties: false,
+	anyOf: [{ properties: { command: { const: "list" } } }, {
+		properties: { command: { const: "get" } },
+		required: ["id"]
+	}]
 });
 const fields = [
 	"id",
@@ -52,11 +58,15 @@ function compact(value, textLimit) {
 			result[key] = entry.slice(0, textLimit);
 			if (entry.length > textLimit) truncatedFields.push(key);
 		} else if (typeof entry === "number" || typeof entry === "boolean" || entry === null) result[key] = entry;
-		else if (entry && typeof entry === "object" && !Array.isArray(entry)) result[key] = Object.fromEntries(Object.entries(entry).slice(0, 12).filter(([, item]) => [
-			"string",
-			"number",
-			"boolean"
-		].includes(typeof item) || item === null).map(([field, item]) => [field, typeof item === "string" ? item.slice(0, 200) : item]));
+		else if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+			const nested = Object.entries(entry);
+			if (nested.length > 12 || nested.some(([, item]) => typeof item === "string" && item.length > 200 || item !== null && typeof item === "object")) truncatedFields.push(key);
+			result[key] = Object.fromEntries(nested.slice(0, 12).filter(([, item]) => [
+				"string",
+				"number",
+				"boolean"
+			].includes(typeof item) || item === null).map(([field, item]) => [field, typeof item === "string" ? item.slice(0, 200) : item]));
+		} else if (Array.isArray(entry)) truncatedFields.push(key);
 	}
 	if (truncatedFields.length) result.truncatedFields = truncatedFields;
 	return result;
@@ -119,7 +129,7 @@ function createPersonalReadTool(deps) {
 					items: selected.map((row) => compact(row, 200)),
 					offset,
 					total: result.total ?? rows.length,
-					nextOffset: selected.length === limit ? offset + selected.length : void 0,
+					nextOffset: offset + selected.length < Number(result.total ?? rows.length) ? offset + selected.length : void 0,
 					excerpts: true
 				};
 			}

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

@@ -1,6 +1,9 @@
-import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } 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 { assertPersonalRequestAccountAccess } from "../../personal-agent/request-access.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
+import { selectionRequestHash } from "../../agent-matching/selection-repository.js";
 import { PersonalRequestResultSchema } from "../../personal-agent/request-result.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-request-result-tool.ts
@@ -47,8 +50,22 @@ function createPersonalRequestResultTool(conversationId) {
 			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);
+			if (!run || run.conversationId !== id || !["running", "verifying"].includes(run.status)) throw new Error("Task execution changed");
+			assertPersonalRequestAccountAccess(request);
+			runSqliteWriteTransaction(() => {
+				const board = new TaskCollaborationRepository();
+				const direction = board.coordination(run.taskId).filter((entry) => ["main_agent", "user"].includes(entry.authorKind) && ["answer", "instruction"].includes(entry.kind)).at(-1)?.sequence ?? 0;
+				board.append({
+					taskId: run.taskId,
+					taskRunId: run.id,
+					authorKind: "worker_agent",
+					authorId: request.executorAgentId,
+					kind: "result",
+					body: result.summary,
+					idempotencyKey: `personal-request-result:${request.requestId}:${run.id}:${direction}:${selectionRequestHash(result)}`
+				});
+				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",

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

@@ -1,10 +1,26 @@
-import { getPersonalRequest, init_request_repository, listPersonalRequests } from "../../personal-agent/request-repository.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
+import { getSessionInputState, init_session_input_repository } from "../../storage/sqlite/session-input-repository.js";
+import { getPersonalRequest, init_request_repository, listPersonalRequests, updatePersonalRequest } from "../../personal-agent/request-repository.js";
+import { getActiveConnectionWait, init_connection_wait_repository, reviseCurrentConnectionObjective, updateConnectionWait } from "../../storage/sqlite/connection-wait-repository.js";
+import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
+import { init_session_repository } from "../../storage/sqlite/session-repository.js";
 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 { cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest, submitPersonalRequest } from "../../personal-agent/request-service.js";
+import { assertPersonalRequestTimeRange, cancelPersonalRequest, personalRequestSnapshot, publishPersonalRequest, submitPersonalRequest } from "../../personal-agent/request-service.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-request-tool.ts
+init_session_input_repository();
+init_session_repository();
+init_session_instance_repository();
+init_connection_wait_repository();
 init_request_repository();
+init_transaction();
 const CapabilitySchema = Type.Object({
 	query: Type.String({
 		minLength: 1,
@@ -17,12 +33,33 @@ const RequestSchema = Type.Object({
 		"submit",
 		"get",
 		"list",
-		"cancel"
+		"cancel",
+		"answer",
+		"instruct",
+		"collaboration",
+		"entry"
 	].map((command) => Type.Literal(command))),
+	instruction: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 8e3
+	})),
+	questionId: Type.Optional(Type.String({ minLength: 1 })),
+	entryId: Type.Optional(Type.String({ minLength: 1 })),
+	afterSequence: Type.Optional(Type.Integer({ minimum: 0 })),
+	bodyOffset: Type.Optional(Type.Integer({ minimum: 0 })),
 	requestId: Type.Optional(Type.String()),
+	offset: Type.Optional(Type.Integer({ minimum: 0 })),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20
+	})),
 	connectorId: Type.Optional(Type.String()),
-	agentId: Type.Optional(Type.String()),
 	accountId: Type.Optional(Type.String()),
+	description: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 16e3,
+		description: "Complete task brief preserving all user requirements, stages, inputs, outputs and constraints. Do not replace exact specifications with a short objective or a reference to an unspecified process."
+	})),
 	objective: Type.Optional(Type.String({
 		minLength: 1,
 		maxLength: 4e3
@@ -31,13 +68,49 @@ const RequestSchema = Type.Object({
 		minLength: 1,
 		maxLength: 200
 	})),
-	selectionReason: Type.Optional(Type.String({ maxLength: 500 })),
 	timeRange: Type.Optional(Type.Object({
 		from: Type.String(),
 		to: Type.String(),
 		timezone: Type.String(),
 		expression: Type.String()
 	}))
+}, {
+	additionalProperties: false,
+	anyOf: [
+		{
+			properties: { command: { const: "submit" } },
+			required: [
+				"objective",
+				"connectorId",
+				"description"
+			]
+		},
+		{ properties: { command: { const: "list" } } },
+		{
+			properties: { command: { enum: [
+				"get",
+				"cancel",
+				"collaboration"
+			] } },
+			required: ["requestId"]
+		},
+		{
+			properties: { command: { const: "entry" } },
+			required: ["requestId", "entryId"]
+		},
+		{
+			properties: { command: { const: "instruct" } },
+			required: ["requestId", "instruction"]
+		},
+		{
+			properties: { command: { const: "answer" } },
+			required: [
+				"requestId",
+				"questionId",
+				"instruction"
+			]
+		}
+	]
 });
 function createPersonalRequestTools(deps) {
 	const conversation = () => {
@@ -45,6 +118,28 @@ function createPersonalRequestTools(deps) {
 		if (!id || !isPersonalConversation(id)) throw new Error("Personal conversation is required");
 		return id;
 	};
+	const snapshot = (request) => {
+		const value = personalRequestSnapshot(request);
+		return {
+			...value,
+			executorAgentId: value.parameters.allocate && value.executorAgentId === "task-router" ? void 0 : value.executorAgentId,
+			...value.taskId ? { allocation: new TaskAllocationRepository().summary(value.taskId) } : {}
+		};
+	};
+	const compactSnapshot = (request) => {
+		const value = snapshot(request);
+		return {
+			requestId: value.requestId,
+			taskId: value.taskId,
+			state: value.state,
+			version: value.version,
+			connectorId: value.connectorId,
+			accountId: value.accountId,
+			executorAgentId: value.executorAgentId,
+			..."allocation" in value ? { allocation: value.allocation } : {},
+			parameters: { timeRange: value.parameters.timeRange }
+		};
+	};
 	const result = (value) => ({
 		content: [{
 			type: "text",
@@ -56,45 +151,149 @@ function createPersonalRequestTools(deps) {
 		name: "personal_capability",
 		label: "Connected app availability",
 		parameters: CapabilitySchema,
-		description: "Check connected-app capabilities, account connection state and specialist Agents locally. Compare executorProfiles for declared expertise; account executorAgentIds constrain eligibility. 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.",
+		description: "Check connected-app capabilities, account connection state and specialist Agents locally. The background Task Router selects an executor within account permissions; do not compare executor profiles in the main conversation. 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));
+			return result(personalCapabilities(conversation(), input.query, input.accountId).map(({ executorProfiles: _profiles, executorAgentIds, accounts, ...capability }) => ({
+				...capability,
+				eligibleExecutorCount: executorAgentIds.length,
+				accounts: accounts.map(({ executorAgentIds: _ids, ...account }) => account)
+			})));
 		}
 	}, {
 		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. Include a short selectionReason explaining the fit. 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.",
+		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.",
 		async execute(toolCallId, input) {
 			const conversationId = conversation();
-			if (input.command === "list") return result(listPersonalRequests(conversationId).map(personalRequestSnapshot));
+			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;
+					return {
+						...summary,
+						parameters: queryParameters
+					};
+				});
+				const total = getSqliteDatabase().prepare("SELECT count(*) AS count FROM personal_requests WHERE conversation_id = ?").get(conversationId).count;
+				return result(boundedPersonalResult({
+					items,
+					total,
+					offset
+				}));
+			}
 			if (input.command === "submit") {
-				if (!input.objective?.trim() || !input.connectorId || !input.agentId) throw new Error("objective, connectorId and agentId are required");
+				if (!input.objective?.trim() || !input.connectorId) throw new Error("objective and connectorId are required");
 				const request = submitPersonalRequest({
 					conversationId,
 					connectorId: input.connectorId,
-					agentId: input.agentId,
 					accountId: input.accountId,
 					objective: input.objective.trim(),
-					selectionReason: input.selectionReason,
+					description: input.description?.trim(),
 					timeRange: input.timeRange,
-					idempotencyKey: input.idempotencyKey ?? toolCallId
+					idempotencyKey: input.idempotencyKey ?? `personal-request-submit:${selectionRequestHash({
+						inputId: getSessionInputState(conversationId).activeInputId ?? toolCallId,
+						objective: input.objective.trim(),
+						description: input.description?.trim(),
+						connectorId: input.connectorId,
+						accountId: input.accountId,
+						timeRange: input.timeRange
+					})}`
 				});
 				publishPersonalRequest(request);
 				deps.dispatchTaskRuns?.();
-				return result(personalRequestSnapshot(request));
+				return result(compactSnapshot(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") {
+				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);
 				publishPersonalRequest(cancelled);
 				return result({
-					...cancelled,
-					executionStopConfirmed: false
+					...compactSnapshot(cancelled),
+					executionStopConfirmed: stop.executionStopConfirmed
+				});
+			}
+			const taskTool = createPersonalTaskTool({
+				...deps,
+				getCurrentAgentId: () => deps.getCurrentAgentId?.() ?? getSessionMetadata(conversationId)?.agentId
+			});
+			if (input.command === "instruct" && input.timeRange) assertPersonalRequestTimeRange(input.timeRange);
+			const instruction = input.command === "instruct" && input.timeRange ? `${input.instruction}\n\nUpdated absolute query range: ${JSON.stringify(input.timeRange)}` : input.instruction;
+			if (input.command === "answer" || input.command === "instruct") {
+				if ([
+					"completed",
+					"failed",
+					"cancelled"
+				].includes(personalRequestSnapshot(request).state)) throw new Error("Request is no longer active");
+				if (readCurrentTranscriptId(getSqliteDatabase(), conversationId) !== request.transcriptId) throw new Error("SESSION_CHANGED");
+				if (!request.taskId && input.command === "instruct" && request.state === "waiting_connection") {
+					const addition = `\n\nSupplemental requirement:\n${instruction.trim()}`;
+					if (!request.objective.endsWith(addition)) runSqliteWriteTransaction(() => {
+						if (getActiveConnectionWait(conversationId)?.id !== request.connectionWaitId) throw new Error("Connection objective changed");
+						reviseCurrentConnectionObjective(conversationId, request.objective + addition);
+						const revised = getActiveConnectionWait(conversationId);
+						updateConnectionWait({
+							...revised,
+							checkpoint: {
+								...revised.checkpoint,
+								timeRange: input.timeRange ?? request.parameters.timeRange
+							}
+						}, revised.version);
+						updatePersonalRequest(request, {
+							objective: request.objective + addition,
+							parameters: {
+								...request.parameters,
+								...input.timeRange ? { timeRange: input.timeRange } : {}
+							}
+						});
+					});
+					return result({
+						...snapshot(getPersonalRequest(request.requestId)),
+						instructionStatus: "saved",
+						guidance: "Account authorization is still required. The existing Request will create its Task with this requirement after authorization."
+					});
+				}
+			}
+			if (input.command !== "get" || request.taskId) {
+				if (!request.taskId) throw new Error("No Task yet; complete account authorization in the main connection UI");
+				const coordinated = await taskTool.execute(toolCallId, {
+					...input,
+					instruction,
+					taskId: request.taskId
+				});
+				if (input.command === "instruct" && input.timeRange && JSON.parse(coordinated.content[0].text).ok === true) runSqliteWriteTransaction(() => {
+					const current = getPersonalRequest(request.requestId);
+					updatePersonalRequest(current, { parameters: {
+						...current.parameters,
+						timeRange: input.timeRange
+					} });
+					const wait = getActiveConnectionWait(conversationId);
+					if (wait && wait.id === current.connectionWaitId) updateConnectionWait({
+						...wait,
+						checkpoint: {
+							...wait.checkpoint,
+							timeRange: input.timeRange
+						}
+					}, wait.version);
+				});
+				if (input.command !== "get") return coordinated;
+				return result({
+					...snapshot(request),
+					coordination: JSON.parse(coordinated.content[0].text)
 				});
 			}
-			return result(personalRequestSnapshot(request));
+			return result(snapshot(request));
 		}
 	}];
 }

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

@@ -0,0 +1,2 @@
+/** Bound model-visible reads and disclose every omitted field or list item. */
+export declare function boundedPersonalResult(value: unknown): unknown;

package/dist/src/agent/tools/personal-result-budget.js

@@ -0,0 +1,57 @@
+import "./local-read-budget.js";
+//#region src/agent/tools/personal-result-budget.ts
+/** Bound model-visible reads and disclose every omitted field or list item. */
+function boundedPersonalResult(value) {
+	let truncated = false;
+	const project = (entry, depth = 0) => {
+		if (typeof entry === "string") {
+			if (entry.length > 600) truncated = true;
+			return entry.slice(0, 600);
+		}
+		if (!entry || typeof entry !== "object") return entry;
+		if (depth > 6) {
+			truncated = true;
+			return "[omitted]";
+		}
+		if (Array.isArray(entry)) {
+			if (entry.length > 20) truncated = true;
+			return entry.slice(0, 20).map((item) => project(item, depth + 1));
+		}
+		return Object.fromEntries(Object.entries(entry).map(([key, item]) => [key, project(item, depth + 1)]));
+	};
+	const result = project(value);
+	if (!result || typeof result !== "object" || Array.isArray(result)) return result;
+	const payload = result;
+	let removedItems = false;
+	const items = payload.items;
+	if (Array.isArray(items)) {
+		while (items.length && JSON.stringify(payload).length > 7900) {
+			items.pop();
+			truncated = true;
+			removedItems = true;
+		}
+		if (!items.length && removedItems) return {
+			...payload,
+			nextOffset: void 0,
+			truncated: true,
+			requiresSpecialist: true,
+			guidance: "A single item exceeds the local read budget."
+		};
+		if (typeof payload.offset === "number" && (removedItems || typeof payload.total === "number" && payload.offset + items.length < payload.total)) payload.nextOffset = payload.offset + items.length;
+	}
+	if (JSON.stringify(payload).length > 7900) return {
+		truncated: true,
+		requiresSpecialist: true,
+		guidance: "Complete details exceed the local read budget."
+	};
+	return {
+		...payload,
+		...truncated ? {
+			truncated: true,
+			excerpts: true,
+			...!Array.isArray(items) ? { requiresSpecialist: true } : {}
+		} : {}
+	};
+}
+//#endregion
+export { boundedPersonalResult };