@xopcai/xopc 0.0.352 → 0.0.354

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

@@ -7,27 +7,16 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
-import "../../../packages/browser-control-contract/src/index.js";
-import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
-import { checkBrowserReadiness } from "../../browser/readiness.js";
-import "../../browser/index.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { createWorkflowCatalog } from "../workflow/catalog.js";
-import { ComputerRuntime } from "../../computer/runtime.js";
-import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
-import { skillEnvironmentId } from "../skills/installer.js";
+import "../../../packages/browser-control-contract/src/index.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
+import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
-import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
-import { createDataBatchTool } from "./dataBatch.js";
-import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
-import { createDelegateTool } from "./delegate-tool.js";
-import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
 import { createReadFileTool } from "./read.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { skillEnvironmentId } from "../skills/installer.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -50,7 +39,14 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
+import { checkBrowserReadiness } from "../../browser/readiness.js";
+import "../../browser/index.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
+import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
+import { createWorkflowCatalog } from "../workflow/catalog.js";
 import { createWorkflowManageTool } from "./workflow-manage-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserAutomationTool } from "./browser-automation-tool.js";
@@ -65,10 +61,16 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
+import { createPersonalTaskTool } from "./personal-task-tool.js";
+import { createPersonalPreferenceTool } from "./personal-preference-tool.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
+import { ComputerRuntime } from "../../computer/runtime.js";
 import { createComputerUseTool } from "./computer-use-tool.js";
 import { createReviewWorkspaceTool } from "./review-workspace.js";
 import { createLanguageDiagnosticsTool } from "./language-diagnostics.js";
+import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
 import { getAgentCapabilityToolNames } from "../capabilities/registry.js";
 import "../capabilities/index.js";
@@ -210,6 +212,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const getSkillMgr = options?.getSkillManager;
 		const disabled = options?.disabledTools;
 		const 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;
 		const cfg = this.deps.getConfig?.();
@@ -261,6 +264,22 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const listDir = createListDirTool(workspace);
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
+		const productToolDeps = {
+			getWorkspace: () => this.deps.workspace,
+			getConfig: () => this.deps.getConfig?.(),
+			getCurrentAgentId: () => options?.agentId,
+			getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
+			getAutomationService: this.deps.getAutomationService,
+			getSceneAccess: this.deps.getSceneAccess,
+			getNotesService: this.deps.getNotesService,
+			getProjectService: this.deps.getProjectService,
+			getWorkDiscovery: this.deps.getWorkDiscovery,
+			getLocalAppService: this.deps.getLocalAppService,
+			getChatPreviewService: this.deps.getChatPreviewService,
+			dispatchTaskEvents: this.deps.dispatchTaskEvents,
+			dispatchTaskRuns: this.deps.dispatchTaskRuns,
+			onAgentCatalogMutate: this.deps.onAgentCatalogMutate
+		};
 		const core = [
 			createSessionStatusTool(),
 			createMemoryMaintenanceTool({ getConfig: () => this.deps.getConfig?.() }),
@@ -432,22 +451,10 @@ 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({
-				getWorkspace: () => this.deps.workspace,
-				getConfig: () => this.deps.getConfig?.(),
-				getCurrentAgentId: () => options.agentId,
+			...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,
-				getAutomationService: this.deps.getAutomationService,
-				getSceneAccess: this.deps.getSceneAccess,
-				getNotesService: this.deps.getNotesService,
-				getProjectService: this.deps.getProjectService,
-				getWorkDiscovery: this.deps.getWorkDiscovery,
-				getLocalAppService: this.deps.getLocalAppService,
-				getChatPreviewService: this.deps.getChatPreviewService,
-				dispatchTaskEvents: this.deps.dispatchTaskEvents,
-				dispatchTaskRuns: this.deps.dispatchTaskRuns,
 				onAgentCatalogMutate: this.deps.onAgentCatalogMutate
-			})] : [],
+			})] : []] : [],
 			...cfg?.computer.enabled && this.deps.endpointTools ? [createComputerUseTool({
 				runtime: this.ensureComputerRuntime(),
 				context: () => {

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,10 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+declare const PreferenceSchema: import("@sinclair/typebox").TObject<{
+    field: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"addressAs">, import("@sinclair/typebox").TLiteral<"warmth">, import("@sinclair/typebox").TLiteral<"humor">, import("@sinclair/typebox").TLiteral<"supportMode">, import("@sinclair/typebox").TLiteral<"detailLevel">, import("@sinclair/typebox").TLiteral<"proactivity">]>;
+    value: import("@sinclair/typebox").TString;
+}>;
+export declare function createPersonalPreferenceTool(deps: {
+    getCurrentConversationId: () => string | undefined;
+    onAgentCatalogMutate?: () => void;
+}): AgentTool<typeof PreferenceSchema, Record<string, never>>;
+export {};

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

@@ -0,0 +1,43 @@
+import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
+import { PersonalPreferencesSchema, updatePersonalProfileRecord } from "../../personal-agent/service.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/personal-preference-tool.ts
+const PreferenceSchema = Type.Object({
+	field: Type.Union([
+		Type.Literal("addressAs"),
+		Type.Literal("warmth"),
+		Type.Literal("humor"),
+		Type.Literal("supportMode"),
+		Type.Literal("detailLevel"),
+		Type.Literal("proactivity")
+	]),
+	value: Type.String({ description: "Use the exact enum for the field: warmth=reserved|balanced|gentle; humor=none|occasional|playful; supportMode=listen|untangle|solutions; detailLevel=brief|balanced|detailed; proactivity=decisions|important|open. addressAs is free text. Save only explicitly requested lasting preferences." })
+});
+function createPersonalPreferenceTool(deps) {
+	return {
+		name: "personal_preference",
+		label: "Personal Preference",
+		description: "Save how the user explicitly wants you to respond in future conversations. Do not save guesses, a temporary mood, or a one-time instruction.",
+		parameters: PreferenceSchema,
+		async execute(_toolCallId, input) {
+			const conversationId = deps.getCurrentConversationId();
+			const personal = conversationId ? getPersonalAgentByConversation(conversationId) : null;
+			if (!personal || personal.state !== "ready") throw new Error("Personal AI conversation is unavailable");
+			const next = PersonalPreferencesSchema.parse({
+				...personal.preferences,
+				[input.field]: input.value.trim()
+			});
+			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 {
+				content: [{
+					type: "text",
+					text: `Saved ${input.field} as an explicit preference. It takes effect on the next reply.`
+				}],
+				details: {}
+			};
+		}
+	};
+}
+//#endregion
+export { createPersonalPreferenceTool };

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

@@ -0,0 +1,28 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+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">]>;
+    title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    objective: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    agentId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    instruction: 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>>;
+    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 buildPersonalTaskBrief(input: {
+    title?: string;
+    objective: string;
+    description?: string;
+}): {
+    title: string;
+    objective: string;
+    body?: string;
+};
+/** A narrow Task surface for the fast personal conversation. */
+export declare function createPersonalTaskTool(deps: XopcUseToolDeps): AgentTool<typeof PersonalTaskSchema, Record<string, never>>;
+export {};

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

@@ -0,0 +1,165 @@
+import { resolveEffectiveAgentConfig } from "../../agent-config/resolver.js";
+import { init_agent_config } from "../../agent-config/index.js";
+import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
+import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
+import { createXopcUseTool } from "./xopc-use-tool.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { randomUUID } from "node:crypto";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/personal-task-tool.ts
+init_repository();
+init_agent_config();
+const PersonalTaskSchema = Type.Object({
+	command: Type.Union([
+		Type.Literal("agents"),
+		Type.Literal("create"),
+		Type.Literal("list"),
+		Type.Literal("get"),
+		Type.Literal("instruct")
+	]),
+	title: Type.Optional(Type.String({ description: "Short task title, ideally under 60 characters. Do not put the full instructions here." })),
+	objective: Type.Optional(Type.String({ description: "One-sentence outcome for a new delegated Task." })),
+	description: Type.Optional(Type.String({ description: "Full task brief in Markdown: background, specific requests, source material, and delivery expectations." })),
+	agentId: Type.Optional(Type.String({ description: "Specialist Agent ID. Never use your own ID." })),
+	taskId: Type.Optional(Type.String()),
+	instruction: Type.Optional(Type.String({ description: "The user’s new direction for this delegated Task." })),
+	expectedOutputs: Type.Optional(Type.Array(Type.String())),
+	acceptanceCriteria: Type.Optional(Type.Array(Type.String())),
+	constraints: Type.Optional(Type.Array(Type.String())),
+	requiredTools: Type.Optional(Type.Array(Type.String({ description: "Tool names needed for this Task. Use names returned by agents; omit when matching by role or expertise." }))),
+	idempotencyKey: Type.Optional(Type.String())
+});
+const MAX_PERSONAL_TASK_TITLE = 60;
+const DISCOVERY_TOOLS = [
+	"web_search",
+	"web_fetch",
+	"browser_use",
+	"read_file",
+	"write_file",
+	"exec_command",
+	"image",
+	"image_generate",
+	"read_media",
+	"automation",
+	"workflow",
+	"xopc_use",
+	"xopc_tool_search",
+	"computer_use",
+	"send_message",
+	"text_to_speech"
+];
+function availableAgentTools(config, deps) {
+	return (config.toolAllowlist ? [...new Set([...DISCOVERY_TOOLS, ...config.toolAllowlist])] : DISCOVERY_TOOLS).filter((name) => (name !== "browser_use" || deps.getConfig?.()?.browser?.enabled !== false) && (!config.toolAllowlist || config.toolAllowlist.includes(name)) && config.tools[name]?.mode !== "deny");
+}
+function buildPersonalTaskBrief(input) {
+	const fullObjective = input.objective.trim();
+	const titleSource = (input.title?.trim() || fullObjective).replace(/\s+/g, " ");
+	const firstClause = titleSource.split(/[。！？\n]|(?<=[.!?])\s/)[0]?.trim() || titleSource;
+	const title = firstClause.length > MAX_PERSONAL_TASK_TITLE ? `${firstClause.slice(0, MAX_PERSONAL_TASK_TITLE - 1).trimEnd()}…` : firstClause;
+	const objective = fullObjective.length > 120 ? title : fullObjective;
+	const description = input.description?.trim();
+	const body = fullObjective !== objective ? [fullObjective, description].filter(Boolean).join("\n\n") : description;
+	return {
+		title,
+		objective,
+		...body ? { body } : {}
+	};
+}
+/** A narrow Task surface for the fast personal conversation. */
+function createPersonalTaskTool(deps) {
+	const productTool = createXopcUseTool(deps);
+	return {
+		name: "personal_task",
+		label: "Personal Task",
+		description: "Find specialist Agents by role and availableTools, delegate work they can do, inspect Tasks, or send instructions. Before saying you cannot do a request, use agents to look for another Agent. If a candidate fails, try another suitable Agent or approach before reporting a blocker. agents can filter by requiredTools; if none match, inspect unfiltered Agents for another viable approach. Return to the user quickly after creation.",
+		parameters: PersonalTaskSchema,
+		mutatesWorkspace: true,
+		mutationScope: "external",
+		requiresExclusiveWorkspaceLock: true,
+		finalGuardRelevant: true,
+		async execute(toolCallId, input, signal) {
+			const conversationId = deps.getCurrentConversationId?.();
+			const ownAgentId = deps.getCurrentAgentId?.();
+			if (!conversationId || !ownAgentId || !isPersonalConversation(conversationId)) throw new Error("Personal conversation context is unavailable");
+			if (input.command === "agents") {
+				const requiredTools = input.requiredTools ?? [];
+				const catalog = new AgentCatalogRepository().snapshot();
+				const agents = catalog.agents.filter((agent) => agent.enabled !== false && agent.id !== ownAgentId && !agent.id.startsWith("personal-")).map((agent) => {
+					const config = resolveEffectiveAgentConfig({
+						defaults: catalog.defaults,
+						agent
+					}).config;
+					const availableTools = availableAgentTools(config, deps);
+					return {
+						id: agent.id,
+						name: agent.profile?.name ?? agent.id,
+						description: agent.profile?.description ?? "",
+						availableTools
+					};
+				}).filter((agent) => requiredTools.every((tool) => agent.availableTools.includes(tool)));
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(agents)
+					}],
+					details: {}
+				};
+			}
+			let command = input.command;
+			let args = {};
+			if (command === "create") {
+				const objective = input.objective?.trim();
+				const agentId = input.agentId?.trim();
+				if (!objective || !agentId) throw new Error("objective and specialist agentId are required");
+				if (agentId === ownAgentId || agentId.startsWith("personal-")) throw new Error("Delegate to a specialist Agent, not a personal Agent");
+				const specialist = new AgentCatalogRepository().get(agentId);
+				if (!specialist || specialist.enabled === false || specialist.provisioningState !== "ready") throw new Error(`Specialist Agent is unavailable: ${agentId}`);
+				const availableTools = availableAgentTools(resolveEffectiveAgentConfigForAgent(agentId).config, deps);
+				const missingTools = (input.requiredTools ?? []).filter((tool) => !availableTools.includes(tool));
+				if (missingTools.length > 0) throw new Error(`Agent ${agentId} lacks required tools: ${missingTools.join(", ")}. Find another Agent or approach.`);
+				args = {
+					...buildPersonalTaskBrief({
+						title: input.title,
+						objective,
+						description: input.description
+					}),
+					agentId,
+					createMode: "start",
+					includeConversationContext: false,
+					expectedOutputs: input.expectedOutputs ?? [],
+					acceptanceCriteria: input.acceptanceCriteria ?? [],
+					constraints: input.constraints ?? [],
+					idempotencyKey: input.idempotencyKey?.trim() || randomUUID()
+				};
+			} else if (command === "list") {
+				command = "delegated_tasks";
+				args = { limit: 20 };
+			} else {
+				const taskId = input.taskId?.trim();
+				if (!taskId) throw new Error("taskId is required");
+				if (!new TaskOriginRepository().owns(taskId, conversationId)) throw new Error("Task does not belong to this personal conversation");
+				if (command === "instruct") {
+					const body = input.instruction?.trim();
+					if (!body) throw new Error("instruction is required");
+					command = "collaboration_post";
+					args = {
+						taskId,
+						kind: "instruction",
+						body
+					};
+				} else args = { taskId };
+			}
+			return {
+				content: (await productTool.execute(toolCallId, {
+					mode: "task",
+					command,
+					args
+				}, signal, void 0)).content,
+				details: {}
+			};
+		}
+	};
+}
+//#endregion
+export { buildPersonalTaskBrief, createPersonalTaskTool };

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/src/agent/tools/user-context-tool.js

@@ -1,7 +1,7 @@
+import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { deleteUserAssertion, getAssertionSlot, getUserAssertion, listUserAssertionSources, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../user-model/repository.js";
 import { canUseAssertion } from "../../user-model/usage-policy.js";
 import "../../user-model/index.js";
-import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/user-context-tool.ts
 const SearchSchema = Type.Object({

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

@@ -1,9 +1,9 @@
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
-import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { basename, relative, sep } from "path";
 import { realpath } from "fs/promises";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/xopc-use-tool.js

@@ -10,22 +10,22 @@ import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import "../../activity/index.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import "../../capabilities/runtime/dispatcher.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
-import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
+import "../../capabilities/runtime/dispatcher.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
-import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { TaskDeletionService } from "../../tasks/task-deletion-service.js";
 import { TaskDeleteOutputSchema } from "../../tasks/capabilities/management.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
+import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { AutomationCreateCapabilityInputSchema, AutomationUpdatePatchSchema } from "../../automations/capabilities/write.js";
 import { TaskMutationOutputSchema } from "../../tasks/capabilities/write.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { localAppCapabilities } from "../../local-apps/capabilities/runtime.js";
 import { defineTaskContract } from "../../tasks/task-contract-definition.js";
+import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import "../../tasks/index.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
@@ -1464,6 +1464,7 @@ async function handleTask(command, args, deps, dryRun, capabilities) {
 		const input = {
 			idempotencyKey: trimString(args.idempotencyKey) ?? randomUUID(),
 			title: trimString(args.title) ?? objective,
+			...trimString(args.body) ? { body: trimString(args.body) } : {},
 			priority: priority ?? "normal",
 			...dueAt === void 0 ? {} : { dueAt },
 			...projectId ? { projectId } : {},
@@ -1476,7 +1477,7 @@ async function handleTask(command, args, deps, dryRun, capabilities) {
 				outputDestinations: []
 			},
 			dependencies: dependsOnTaskIds,
-			context: conversationId ? [{
+			context: args.includeConversationContext === false ? [] : conversationId ? [{
 				targetKind: "session",
 				targetId: conversationId,
 				role: "input",
@@ -1889,7 +1890,7 @@ function createXopcUseTool(deps) {
 	return {
 		name: "xopc_use",
 		label: "XOPC Use",
-		description: "Operate first-class xopc objects through one safe entry point. To delegate work for immediate execution: mode task, command create, args {objective, createMode:\"start\", agentId:\"researcher\"}; omitting createMode creates a backlog task only. To start an existing Task: mode task, command command, args {taskId, type:\"start\", expectedVersion, commandArgs:{executor:{kind:\"agent\",agentId:\"main\"}}}. Inspect an existing Task and its run before creating another Task for the same objective. For delegated work, task delegated_tasks lists this conversation's tasks; task collaboration reads the shared board; task collaboration_post writes {taskId, kind, body, causationId?, idempotencyKey?}. Workers report progress or questions; the main Agent writes instructions and answers. Use chat_preview for lightweight UI mockups in the current conversation; do not create a Local App unless the user asks for a durable app. Local App capabilities takes extensionId and discovers already granted bindings. Local App invoke requires extensionId, the discovered manifestDigest, capabilityId and a pinned call {majorVersion, descriptorDigest, input, idempotencyKey for writes}. Never manufacture grants or change a retry key after an uncertain write. Use for Agents, scenes, projects, automations, notes, tasks, TaskRuns, chat previews, local apps, and exact settings jump targets instead of editing storage files directly. For non-trivial object changes, load the built-in manual first with tool_manual({ tool: \"xopc_use\" }).",
+		description: "Operate first-class xopc objects through one safe entry point. To delegate work for immediate execution: mode task, command create, args {title:\"Short task name\", objective:\"One-sentence outcome\", body:\"Full Markdown task brief\", createMode:\"start\", agentId:\"researcher\"}; omitting createMode creates a backlog task only. To start an existing Task: mode task, command command, args {taskId, type:\"start\", expectedVersion, commandArgs:{executor:{kind:\"agent\",agentId:\"main\"}}}. Inspect an existing Task and its run before creating another Task for the same objective. For delegated work, task delegated_tasks lists this conversation's tasks; task collaboration reads the shared board; task collaboration_post writes {taskId, kind, body, causationId?, idempotencyKey?}. Workers report progress or questions; the main Agent writes instructions and answers. Use chat_preview for lightweight UI mockups in the current conversation; do not create a Local App unless the user asks for a durable app. Local App capabilities takes extensionId and discovers already granted bindings. Local App invoke requires extensionId, the discovered manifestDigest, capabilityId and a pinned call {majorVersion, descriptorDigest, input, idempotencyKey for writes}. Never manufacture grants or change a retry key after an uncertain write. Use for Agents, scenes, projects, automations, notes, tasks, TaskRuns, chat previews, local apps, and exact settings jump targets instead of editing storage files directly. For non-trivial object changes, load the built-in manual first with tool_manual({ tool: \"xopc_use\" }).",
 		parameters: XopcUseToolSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",

package/dist/src/agent/workflow/subagent-runner.js

@@ -1,11 +1,11 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { createSqliteTranscriptRuntime } from "../embedded/transcript-runtime.js";
-import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 import { createDelegateChildHandle } from "../child-agent-factory.js";
 import { DELEGATION_TOOL_CAPABILITIES, protectDelegatedTool, resolveDelegationTools } from "../tools/delegation-policy.js";
 import { DELEGATE_BLOCKED_TOOLS } from "../tools/delegate-tool.js";
 import { createDelegationParentPolicy } from "../tools/delegation-parent-policy.js";
+import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 //#region src/agent/workflow/subagent-runner.ts
 init_logger();
 const log = createLogger("Agent:WorkflowSubagent");

package/dist/src/agent-catalog/capabilities.js

@@ -1,10 +1,10 @@
 import { AgentEntrySchema, EffectiveAgentConfigSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
-import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
 import { AgentCatalogRepository, init_repository } from "./repository.js";
 import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
+import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
 import { AgentCatalogService } from "./service.js";
 import { z } from "zod";
 //#region src/agent-catalog/capabilities.ts

package/dist/src/agent-catalog/migrations/identity-markdown-cutover.d.ts

@@ -0,0 +1,5 @@
+import type { AgentProfile } from '../../agent-config/index.js';
+/** Parse only known identity fields. The original document is archived after migration. */
+export declare function parseIdentityFieldsForCutover(content: string): Partial<AgentProfile>;
+/** One-time upgrade. Runtime never reads the retired identity document. */
+export declare function migrateIdentityMarkdownToCatalog(): void;