@xopcai/xopc 0.0.359 → 0.0.361

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

@@ -3,7 +3,9 @@ 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";
@@ -60,8 +62,11 @@ import { createDesktopPetTool } from "./desktop-pet-tool.js";
 import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool } from "./image-generate-tool.js";
+import { createPersonalReadTool } from "./personal-read-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";
@@ -77,6 +82,7 @@ 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 +217,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 +237,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();
@@ -258,7 +280,14 @@ var AgentToolsFactory = class AgentToolsFactory {
 			canAccessMemory: () => currentAccess().knowledge
 		});
 		const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null);
-		const readTool = createReadFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
+		const readTool = createReadFileTool(workspace, {
+			profileMarkdownRoot: options?.profileMarkdownRoot,
+			...personalToolsConfigured ? {
+				defaultMaxLines: 150,
+				maxOutputBytes: 8e3,
+				maxReadBytes: 12e3
+			} : {}
+		});
 		const writeTool = createWriteFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
 		const applyPatchTool = createApplyPatchTool(workspace);
 		const listDir = createListDirTool(workspace);
@@ -374,7 +403,11 @@ var AgentToolsFactory = class AgentToolsFactory {
 			})] : [],
 			createSendMediaTool(workspace, bus, deliveryContext),
 			createPublishArtifactsTool(workspace),
-			createReadMediaTool(),
+			createReadMediaTool(personalToolsConfigured ? {
+				textOnly: true,
+				maxChars: 8e3,
+				maxReadBytes: 12e3
+			} : void 0),
 			...isShareToolAvailable(cfg) ? [createCreateShareTool({
 				workspace,
 				getConfig: () => this.deps.getConfig?.()
@@ -440,6 +473,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId
 			})] : [],
 			...this.deps.getSessionStore && getPrimary ? [createSessionSearchTool({
+				localOnly: personalToolsConfigured,
 				getSessionStore: this.deps.getSessionStore,
 				getPrimaryModel: getPrimary,
 				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
@@ -451,10 +485,15 @@ 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),
+				createPersonalReadTool(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 +567,8 @@ var AgentToolsFactory = class AgentToolsFactory {
 					});
 				}
 			})] : [],
-			...optionalTools
+			...optionalTools,
+			...personalExecution ? [createPersonalRequestResultTool(currentConversationId), createPersonalRequestConnectionTool(currentConversationId)] : []
 		];
 		if ([
 			"read_file",

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

@@ -42,3 +42,4 @@ export { createImageTool, resolveImageModelConfigForTool } from './image-tool.js
 export { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from './image-generate-tool.js';
 export { truncateHead, truncateTail, truncateLine, formatSize, type TruncationResult, type TruncationOptions, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES, GREP_MAX_LINE_LENGTH, } from './truncate.js';
 export { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString, type FuzzyMatchResult, } from './edit-diff.js';
+export { createPersonalReadTool } from './personal-read-tool.js';

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

@@ -45,4 +45,5 @@ import { createDesktopPetTool } from "./desktop-pet-tool.js";
 import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-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, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, 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 { 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, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, 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/media-read-tool.d.ts

@@ -1,2 +1,6 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-export declare function createReadMediaTool(): AgentTool;
+export declare function createReadMediaTool(options?: {
+    textOnly?: boolean;
+    maxChars?: number;
+    maxReadBytes?: number;
+}): AgentTool;

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

@@ -15,12 +15,14 @@ function clampMaxBytes(raw) {
 	if (typeof raw !== "number" || !Number.isFinite(raw) || raw <= 0) return DEFAULT_MAX_BYTES;
 	return Math.min(Math.floor(raw), HARD_MAX_BYTES);
 }
-function createReadMediaTool() {
+function createReadMediaTool(options) {
 	return {
 		name: "read_media",
 		label: "Read Media Attachment",
 		description: "Read an attachment by media:// URI. Use this for xopc-media-uri attachments in user messages.",
 		parameters: ReadMediaSchema,
+		supportsParallel: true,
+		idempotent: true,
 		async execute(_toolCallId, params, _signal) {
 			const uri = typeof params.uri === "string" ? params.uri.trim() : "";
 			if (!uri) return {
@@ -34,7 +36,7 @@ function createReadMediaTool() {
 				}
 			};
 			try {
-				const { buffer, path } = await readMediaReference(uri, clampMaxBytes(params.maxBytes));
+				const { buffer, path } = await readMediaReference(uri, Math.min(clampMaxBytes(params.maxBytes), options?.maxReadBytes ?? HARD_MAX_BYTES));
 				const mimeType = mimeTypeFromMediaPath(path);
 				const metadata = {
 					ok: true,
@@ -43,14 +45,35 @@ function createReadMediaTool() {
 					size: buffer.byteLength,
 					path
 				};
-				if (isLikelyText(mimeType)) return {
+				if (isLikelyText(mimeType)) {
+					const fullText = buffer.toString("utf8");
+					const maxChars = options?.maxChars ?? fullText.length;
+					const truncated = fullText.length > maxChars;
+					return {
+						content: [{
+							type: "text",
+							text: fullText.slice(0, maxChars) + (truncated ? "\n[Attachment truncated; delegate full analysis to a specialist.]" : "")
+						}],
+						details: {
+							...metadata,
+							kind: "text",
+							truncated,
+							...truncated && options?.textOnly ? {
+								requiresSpecialist: true,
+								reason: "large_attachment"
+							} : {}
+						}
+					};
+				}
+				if (options?.textOnly) return {
 					content: [{
 						type: "text",
-						text: buffer.toString("utf8")
+						text: "Binary attachment: delegate document parsing or media analysis to a specialist."
 					}],
 					details: {
 						...metadata,
-						kind: "text"
+						kind: "binary",
+						requiresSpecialist: true
 					}
 				};
 				return {
@@ -68,6 +91,22 @@ function createReadMediaTool() {
 					}
 				};
 			} catch (err) {
+				if (options?.textOnly && err?.code === "MEDIA_READ_LIMIT") {
+					const size = err.size;
+					return {
+						content: [{
+							type: "text",
+							text: `Attachment is large (${size} bytes; local read limit ${options.maxReadBytes ?? HARD_MAX_BYTES} bytes). Tell the user briefly, then delegate reading and processing with this URI: ${uri}`
+						}],
+						details: {
+							ok: true,
+							uri,
+							size,
+							requiresSpecialist: true,
+							reason: "large_attachment"
+						}
+					};
+				}
 				const message = err instanceof Error ? err.message : String(err);
 				return {
 					content: [{

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-read-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 createPersonalReadTool(deps: XopcUseToolDeps): AgentTool;

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

@@ -0,0 +1,155 @@
+import { CapabilityDispatcher } from "../../capabilities/runtime/dispatcher.js";
+import { registerNoteReadCapabilities } from "../../notes/capabilities/read.js";
+import { registerProjectReadCapabilities } from "../../projects/capabilities/read.js";
+import { registerAutomationReadCapabilities } from "../../automations/capabilities/read.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/personal-read-tool.ts
+const schema = Type.Object({
+	kind: Type.Union([
+		Type.Literal("note"),
+		Type.Literal("project"),
+		Type.Literal("automation")
+	]),
+	command: Type.Union([Type.Literal("list"), Type.Literal("get")]),
+	id: Type.Optional(Type.String()),
+	search: Type.Optional(Type.String({ maxLength: 500 })),
+	projectId: Type.Optional(Type.String()),
+	offset: Type.Optional(Type.Integer({ minimum: 0 })),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 10
+	}))
+});
+const fields = [
+	"id",
+	"name",
+	"title",
+	"status",
+	"kind",
+	"projectId",
+	"description",
+	"markdown",
+	"objective",
+	"enabled",
+	"createdAt",
+	"updatedAt",
+	"createdAtMs",
+	"updatedAtMs",
+	"trigger",
+	"action",
+	"state"
+];
+/** Small projections keep local reads from expanding the next model request. */
+function compact(value, textLimit) {
+	if (!value || typeof value !== "object") return {};
+	const source = value;
+	const result = {};
+	const truncatedFields = [];
+	for (const key of fields) {
+		const entry = source[key];
+		if (typeof entry === "string") {
+			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]));
+	}
+	if (truncatedFields.length) result.truncatedFields = truncatedFields;
+	return result;
+}
+function createPersonalReadTool(deps) {
+	const dispatcher = new CapabilityDispatcher();
+	if (deps.getNotesService) registerNoteReadCapabilities(dispatcher, () => {
+		const notes = deps.getNotesService();
+		if (!notes) throw new Error("Notes service unavailable");
+		return notes;
+	});
+	const projects = deps.getProjectService?.();
+	if (projects) registerProjectReadCapabilities(dispatcher, projects);
+	const automations = deps.getAutomationService?.();
+	if (automations) registerAutomationReadCapabilities(dispatcher, automations, projects);
+	return {
+		name: "personal_read",
+		label: "Read local objects",
+		description: "Read local notes, projects or automation state. Only list/get; bounded excerpts, no network or model calls. Use personal_task for delegated tasks.",
+		parameters: schema,
+		supportsParallel: true,
+		idempotent: true,
+		async execute(_id, raw, signal) {
+			const input = raw;
+			if (![
+				"note",
+				"project",
+				"automation"
+			].includes(input.kind) || !["list", "get"].includes(input.command)) throw new Error("Only local note/project/automation list/get is supported");
+			if (input.command === "get" && !input.id?.trim()) throw new Error("id is required");
+			if (input.kind === "automation" && input.search) throw new Error("Automation search is unsupported; use list");
+			const operation = `xopc.${input.kind === "note" ? "notes" : input.kind === "project" ? "projects" : "automations"}.${input.command}`;
+			const limit = Math.min(10, Math.max(1, input.limit ?? 5));
+			const offset = Math.max(0, input.offset ?? 0);
+			const args = input.command === "get" ? { id: input.id } : input.kind === "automation" ? { ...input.projectId ? { projectId: input.projectId } : {} } : {
+				limit,
+				offset,
+				...input.search ? { search: input.search } : {},
+				...input.kind === "note" && input.projectId ? { projectId: input.projectId } : {}
+			};
+			const result = await dispatcher.call(operation, args, {
+				principalId: `agent:${deps.getCurrentAgentId?.() ?? "main"}`,
+				surface: "agent",
+				scopes: ["workspace.read", "automations.read"],
+				allowedCapabilities: [operation],
+				authorize: deps.authorizeCapability ?? (() => true),
+				signal
+			});
+			let payload;
+			if (input.command === "get") payload = {
+				kind: input.kind,
+				item: compact(result[input.kind], 6e3),
+				excerpts: true
+			};
+			else {
+				const rows = result.items ?? [];
+				const selected = input.kind === "automation" ? rows.slice(offset, offset + limit) : rows;
+				payload = {
+					kind: input.kind,
+					items: selected.map((row) => compact(row, 200)),
+					offset,
+					total: result.total ?? rows.length,
+					nextOffset: selected.length === limit ? offset + selected.length : void 0,
+					excerpts: true
+				};
+			}
+			const serialized = JSON.stringify(payload);
+			const requiresSpecialist = input.command === "get" && (serialized.length > 12e3 || Boolean(payload.item?.truncatedFields));
+			if (requiresSpecialist) payload = {
+				...payload,
+				requiresSpecialist: true,
+				reason: "large_object",
+				id: input.id,
+				guidance: "Briefly tell the user the material is large, then delegate full reading and processing using this object kind and ID."
+			};
+			const output = JSON.stringify(payload);
+			return {
+				content: [{
+					type: "text",
+					text: output.length <= 12e3 ? output : JSON.stringify({
+						kind: input.kind,
+						excerpt: output.slice(0, 1e4),
+						truncated: true,
+						requiresSpecialist: true,
+						id: input.id
+					})
+				}],
+				details: {
+					localOnly: true,
+					requiresSpecialist: requiresSpecialist || output.length > 12e3
+				}
+			};
+		}
+	};
+}
+//#endregion
+export { createPersonalReadTool };

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;