@xopcai/xopc 0.0.381 → 0.0.383

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

@@ -8,23 +8,33 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 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 { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { createPersonalAttentionTool } from "./personal-attention-tool.js";
-import { markCodemodeCoreRead } from "./codemode-permissions.js";
-import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
-import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
-import { PERSONAL_REQUEST_TOOL_IDS, filterExecutionTools, resolveExecutionToolPolicy } from "../embedded/execution-tool-policy.js";
+import { createWorkflowCatalog } from "../workflow/catalog.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 { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
+import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
+import { ComputerRuntime } from "../../computer/runtime.js";
+import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
+import { skillEnvironmentId } from "../skills/installer.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { createReadFileTool } from "./read.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { getPendingTranscriptUserText } from "../inbound/attachment-pipeline.js";
 import { createDataBatchTool } from "./dataBatch.js";
-import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
-import { skillEnvironmentId } from "../skills/installer.js";
+import { markCodemodeCoreRead } from "./codemode-permissions.js";
+import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
+import { PERSONAL_REQUEST_TOOL_IDS, filterExecutionTools, resolveExecutionToolPolicy } from "../embedded/execution-tool-policy.js";
+import { createDelegateTool } from "./delegate-tool.js";
+import { createDelegationParentPolicy } from "./delegation-parent-policy.js";
+import { createPersonalAttentionTool } from "./personal-attention-tool.js";
+import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
+import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -47,14 +57,7 @@ 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";
@@ -75,12 +78,9 @@ import { createPersonalRequestTools } from "./personal-request-tool.js";
 import { createPersonalRequestConnectionTool, createPersonalRequestResultTool } from "./personal-request-result-tool.js";
 import { createPersonalPreferenceTool } from "./personal-preference-tool.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";
@@ -296,6 +296,24 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
 		const productToolDeps = {
+			getAgentToolAvailability: this.deps.getAgentToolAvailability ?? ((candidateId, name) => {
+				const candidate = resolveEffectiveAgentConfigForAgent(candidateId).config;
+				const denied = new Set(Object.entries(candidate.tools).filter(([, policy]) => policy.mode === "deny").map(([tool]) => tool));
+				const registered = this.createAllTools({
+					agentId: candidateId,
+					workspace: candidate.workspace,
+					conversationId: "",
+					disabledTools: denied,
+					toolAllowlist: candidate.toolAllowlist
+				}).some((tool) => tool.name === name);
+				const activatable = this.getLazyCapabilityToolNames().includes(name);
+				return {
+					condition: `tool:${name}`,
+					state: registered || activatable ? "verified" : "blocked",
+					reasonCode: registered ? "tool_registered" : activatable ? "tool_activatable" : "tool_not_registered",
+					detail: candidate.tools[name]?.mode === "ask" ? "Runtime approval is still required" : "Registration checked; execution environment is checked by the tool"
+				};
+			}),
 			getAgentSkillAvailability: this.deps.getAgentSkillAvailability,
 			getWorkspace: () => this.deps.workspace,
 			getConfig: () => this.deps.getConfig?.(),

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

@@ -1,6 +1,6 @@
 import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
-import { Agent, fetch } from "undici";
 import { lookup } from "node:dns";
+import { Agent, fetch } from "undici";
 //#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 { persistToolMedia } from "./tool-media.js";
+import { getImageGenerationProvider } from "../image/generation/provider-registry.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,8 +1,13 @@
+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";
@@ -26,11 +31,6 @@ 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 { checkedFilePath } from "../sandbox/fileAccess.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { checkedFilePath } from "../sandbox/fileAccess.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.js

@@ -1,7 +1,7 @@
 import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.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";

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

@@ -1,5 +1,5 @@
-import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
 import { CapabilityDispatcher } from "../../capabilities/runtime/dispatcher.js";
+import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
 import { registerNoteReadCapabilities } from "../../notes/capabilities/read.js";
 import { registerProjectReadCapabilities } from "../../projects/capabilities/read.js";
 import { registerAutomationReadCapabilities } from "../../automations/capabilities/read.js";

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

@@ -31,6 +31,7 @@ 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(),
@@ -55,7 +56,7 @@ function createPersonalRequestTools(deps) {
 		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.",
+		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.",
 		async execute(_id, input) {
 			return result(personalCapabilities(conversation(), input.query, input.accountId));
 		}
@@ -63,7 +64,7 @@ function createPersonalRequestTools(deps) {
 		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.",
+		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.",
 		async execute(toolCallId, input) {
 			const conversationId = conversation();
 			if (input.command === "list") return result(listPersonalRequests(conversationId).map(personalRequestSnapshot));
@@ -75,6 +76,7 @@ function createPersonalRequestTools(deps) {
 					agentId: input.agentId,
 					accountId: input.accountId,
 					objective: input.objective.trim(),
+					selectionReason: input.selectionReason,
 					timeRange: input.timeRange,
 					idempotencyKey: input.idempotencyKey ?? toolCallId
 				});

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

@@ -1,8 +1,27 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type MatchingContext } from '../../agent-matching/service.js';
 export { getAvailablePersonalAgentTools, personalAgentModelAvailability } from '../../personal-agent/specialist-capabilities.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">]>;
+    command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"agents">, import("@sinclair/typebox").TLiteral<"match">, import("@sinclair/typebox").TLiteral<"selection">, 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">]>;
+    requirements: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        version: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TLiteral<1>>;
+        summary: import("@sinclair/typebox").TString;
+        domain: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        taskType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        inputKinds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        outputKinds: 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>>;
+        requiredSkills: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        requestedAgentId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+    selectionReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    selectionSource: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"snapshot">, import("@sinclair/typebox").TLiteral<"match">, import("@sinclair/typebox").TLiteral<"explicit">]>>;
+    previousSelectionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    matchId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    requestId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    cursor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     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>;
@@ -18,6 +37,7 @@ declare const PersonalTaskSchema: import("@sinclair/typebox").TObject<{
     idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
 export interface PersonalTaskToolDeps extends XopcUseToolDeps {
+    getAgentToolAvailability?: MatchingContext['getAgentToolAvailability'];
     getAgentSkillAvailability?: (agentId: string) => {
         skills: Array<{
             name: string;

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

@@ -1,26 +1,53 @@
-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 { isPersonalConversation } from "../../personal-agent/repository.js";
+import { normalizeSpecialistRequirements } from "../../../packages/gateway-contract/src/specialists.js";
+import { getPersonalRequest, init_request_repository } from "../../personal-agent/request-repository.js";
+import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
+import { init_sqlite } from "../../storage/sqlite/index.js";
+import { AgentSelectionRepository, selectionRequestHash } from "../../agent-matching/selection-repository.js";
 import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../../personal-agent/specialist-capabilities.js";
+import { assessSpecialist, matchSpecialists } from "../../agent-matching/service.js";
+import { assertSpecialistEligible, createSelectedTask } from "../../agent-matching/delegation-service.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
-import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-task-tool.ts
-init_repository();
-init_agent_config();
+init_sqlite();
+init_request_repository();
 const PersonalTaskSchema = Type.Object({
 	command: Type.Union([
 		Type.Literal("agents"),
+		Type.Literal("match"),
+		Type.Literal("selection"),
 		Type.Literal("create"),
 		Type.Literal("list"),
 		Type.Literal("get"),
 		Type.Literal("instruct"),
 		Type.Literal("answer")
 	]),
+	requirements: Type.Optional(Type.Object({
+		version: Type.Optional(Type.Literal(1)),
+		summary: Type.String({ maxLength: 300 }),
+		domain: Type.Optional(Type.String()),
+		taskType: Type.Optional(Type.String()),
+		inputKinds: Type.Optional(Type.Array(Type.String())),
+		outputKinds: Type.Optional(Type.Array(Type.String())),
+		requiredTools: Type.Optional(Type.Array(Type.String())),
+		requiredSkills: Type.Optional(Type.Array(Type.String())),
+		requestedAgentId: Type.Optional(Type.String())
+	})),
+	selectionReason: Type.Optional(Type.String({ maxLength: 500 })),
+	selectionSource: Type.Optional(Type.Union([
+		Type.Literal("snapshot"),
+		Type.Literal("match"),
+		Type.Literal("explicit")
+	])),
+	previousSelectionId: Type.Optional(Type.String()),
+	matchId: Type.Optional(Type.String()),
+	requestId: Type.Optional(Type.String()),
+	cursor: Type.Optional(Type.String()),
+	offset: Type.Optional(Type.Integer({ minimum: 0 })),
 	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." })),
@@ -38,17 +65,6 @@ const PersonalTaskSchema = Type.Object({
 	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())
 });
-var PersonalSkillUnavailableError = class extends Error {};
-function resolveRequiredSkills(deps, agentId, requested) {
-	if (requested.length === 0) return [];
-	if (!deps.getAgentSkillAvailability) throw new Error("Specialist Skill availability cannot be verified");
-	const skills = deps.getAgentSkillAvailability(agentId).skills;
-	return [...new Set(requested.map((name) => name.trim().toLowerCase()))].map((name) => {
-		const skill = skills.find((item) => item.name.toLowerCase() === name);
-		if (!skill?.availableForCurrentAgent) throw new PersonalSkillUnavailableError(`Agent ${agentId} cannot use required Skill ${name}: ${skill?.unavailableReason ?? "not-installed"}. Do not substitute the requested Skill without the user’s direction.`);
-		return skill.name;
-	});
-}
 const MAX_PERSONAL_TASK_TITLE = 60;
 function buildPersonalTaskBrief(input) {
 	const fullObjective = input.objective.trim();
@@ -66,10 +82,11 @@ function buildPersonalTaskBrief(input) {
 /** A narrow Task surface for the fast personal conversation. */
 function createPersonalTaskTool(deps) {
 	const productTool = createXopcUseTool(deps);
+	const matches = /* @__PURE__ */ new Map();
 	return {
 		name: "personal_task",
 		label: "Personal Task",
-		description: "Find specialist Agents by role, availableTools, and model.available; delegate work, inspect Tasks, send instructions, or answer worker questions. Choose an Agent whose model.available is true. Before saying you cannot do a request, inspect another Agent. If a candidate fails, retry alternatives within the user’s authorization only when the user has not required a particular Agent or Skill. For explicitly requested Skills, use requiredSkills in agents and create; creation validates availability and includes them in the worker brief. agents can filter by requiredTools or requiredSkills; if none match, inspect unfiltered Agents. Return to the user quickly after creation.",
+		description: "Use match with structured requirements to compare specialist profiles and eligibility evidence. Profiles declare expertise; they never grant access. When the snapshot suffices, create directly with requirements, selectionReason and selectionSource. selection reads a Task’s allocation history. Preserve idempotencyKey on uncertain retries; link alternatives with previousSelectionId. Find specialist Agents by role, availableTools, and model.available; delegate work, inspect Tasks, send instructions, or answer worker questions. Choose an Agent whose model.available is true. Before saying you cannot do a request, inspect another Agent. If a candidate fails, retry alternatives within the user’s authorization only when the user has not required a particular Agent or Skill. For explicitly requested Skills, use requiredSkills in agents and create; creation validates availability and includes them in the worker brief. agents can filter by requiredTools or requiredSkills; if none match, inspect unfiltered Agents. Return to the user quickly after creation.",
 		parameters: PersonalTaskSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
@@ -79,40 +96,74 @@ function createPersonalTaskTool(deps) {
 			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 ?? [];
-				if (input.requiredSkills?.length && !deps.getAgentSkillAvailability) throw new Error("Specialist Skill availability cannot be verified");
-				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 = getAvailablePersonalAgentTools(config, deps);
-					let requiredSkills;
-					try {
-						requiredSkills = resolveRequiredSkills(deps, agent.id, input.requiredSkills ?? []);
-					} catch (error) {
-						if (error instanceof PersonalSkillUnavailableError) return null;
-						throw error;
+			const requirements = normalizeSpecialistRequirements({
+				...input.requirements,
+				version: 1,
+				summary: input.requirements?.summary ?? (input.objective?.trim() || "Specialist discovery").slice(0, 300),
+				requiredTools: [...input.requirements?.requiredTools ?? [], ...input.requiredTools ?? []],
+				requiredSkills: [...input.requirements?.requiredSkills ?? [], ...input.requiredSkills ?? []]
+			});
+			const context = {
+				ownAgentId,
+				getConfig: deps.getConfig,
+				getAgentSkillAvailability: deps.getAgentSkillAvailability,
+				getAgentToolAvailability: deps.getAgentToolAvailability,
+				legacyToolPolicyOnly: !input.requirements
+			};
+			if (input.command === "match" || input.command === "agents") {
+				if (input.command === "agents" && requirements.requiredSkills?.length && !deps.getAgentSkillAvailability) throw new Error("Specialist Skill availability cannot be verified");
+				const result = matchSpecialists(requirements, context, {
+					cursor: input.cursor,
+					limit: input.command === "agents" ? 50 : 10
+				});
+				if (input.command === "agents") {
+					let cursor = result.nextCursor;
+					while (cursor) {
+						const page = matchSpecialists(requirements, context, {
+							cursor,
+							limit: 50
+						});
+						result.candidates.push(...page.candidates);
+						cursor = page.nextCursor;
 					}
-					return {
-						...requiredSkills.length ? { verifiedSkills: requiredSkills } : {},
-						id: agent.id,
-						name: agent.profile?.name ?? agent.id,
-						description: agent.profile?.description ?? "",
-						availableTools,
-						model: personalAgentModelAvailability(config)
-					};
-				}).filter((agent) => agent !== null && requiredTools.every((tool) => agent.availableTools.includes(tool)));
+				}
+				const matchId = input.command === "match" ? randomUUID() : void 0;
+				if (matchId) {
+					if (matches.size >= 20) matches.delete(matches.keys().next().value);
+					matches.set(matchId, {
+						conversationId,
+						requirements,
+						result
+					});
+				}
+				const payload = input.command === "agents" ? result.candidates.filter((agent) => !agent.checks.some((check) => check.condition === "identity" && check.state === "blocked") && (requirements.requiredTools ?? []).every((tool) => agent.availableTools.includes(tool)) && (requirements.requiredSkills?.length ?? 0) === agent.verifiedSkills.length) : {
+					...result,
+					matchId
+				};
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(payload)
+					}],
+					details: {}
+				};
+			}
+			if (input.command === "selection") {
+				if (!(input.taskId ? new TaskOriginRepository().owns(input.taskId, conversationId) : input.requestId ? getPersonalRequest(input.requestId)?.conversationId === conversationId : true)) throw new Error("Task or Request does not belong to this personal conversation");
 				return {
 					content: [{
 						type: "text",
-						text: JSON.stringify(agents)
+						text: JSON.stringify(new AgentSelectionRepository().list(conversationId, {
+							taskId: input.taskId,
+							requestId: input.requestId,
+							offset: input.offset
+						}))
 					}],
 					details: {}
 				};
 			}
+			let selectedProductTool = productTool;
+			let pendingSelection;
 			let command = input.command;
 			let args = {};
 			if (command === "create") {
@@ -120,15 +171,67 @@ function createPersonalTaskTool(deps) {
 				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 config = resolveEffectiveAgentConfigForAgent(agentId).config;
-				const model = personalAgentModelAvailability(config);
-				if (!model.available) throw new Error(`Agent ${agentId} cannot start: ${model.reason}. Find another available Agent.`);
-				const availableTools = getAvailablePersonalAgentTools(config, deps);
-				const missingTools = (input.requiredTools ?? []).filter((tool) => !availableTools.includes(tool));
-				if (missingTools.length > 0) throw new Error(`Agent ${agentId} lacks required tools: ${missingTools.join(", ")}. Find another Agent or approach.`);
-				const requiredSkills = resolveRequiredSkills(deps, agentId, input.requiredSkills ?? []);
+				const key = input.idempotencyKey?.trim() || randomUUID();
+				const { requiredTools: _tools, requiredSkills: _skills, requirements: _requirements, ...requestInput } = input;
+				const requestHash = selectionRequestHash({
+					...requestInput,
+					idempotencyKey: key,
+					requirements
+				});
+				const previous = new AgentSelectionRepository().find(conversationId, key);
+				if (previous && previous.requestHash !== requestHash) throw new Error("Idempotency key was reused with different input");
+				if (previous?.status === "rejected") assertSpecialistEligible(previous.assessment);
+				const matched = input.matchId ? matches.get(input.matchId) : void 0;
+				if (!previous && input.matchId && (!matched || matched.conversationId !== conversationId)) throw new Error("Matching snapshot expired; match again");
+				if (!previous && matched && (selectionRequestHash(matched.requirements) !== selectionRequestHash(requirements) || !matched.result.candidates.some((candidate) => candidate.id === agentId))) throw new Error("Selection must preserve matched requirements and select a displayed candidate");
+				let assessment = previous?.assessment;
+				if (!assessment) {
+					assessment = assessSpecialist(agentId, requirements, context);
+					if (assessment.eligibility !== "eligible" && getSessionMetadata(conversationId)) new AgentSelectionRepository().create({
+						conversationId,
+						key,
+						requestHash,
+						requirements,
+						assessment,
+						source: input.selectionSource ?? "legacy",
+						reason: input.selectionReason,
+						previousSelectionId: input.previousSelectionId,
+						status: "rejected"
+					});
+					assertSpecialistEligible(assessment);
+				}
+				const requiredSkills = assessment.verifiedSkills;
+				if (!previous) pendingSelection = {
+					conversationId,
+					key,
+					requestHash,
+					requirements,
+					assessment,
+					source: requirements.requestedAgentId ? "explicit" : matched ? "match" : input.selectionSource === "match" ? "snapshot" : input.selectionSource ?? "legacy",
+					reason: input.selectionReason,
+					previousSelectionId: input.previousSelectionId,
+					status: "start_failed"
+				};
+				selectedProductTool = createXopcUseTool({
+					...deps,
+					createTask: (taskInput, actor) => createSelectedTask(taskInput, actor, {
+						conversationId,
+						requirements,
+						context,
+						requestHash,
+						candidates: matched?.result.candidates.map(({ id, revision, eligibility, checks, matched: tags, missing }) => ({
+							id,
+							revision,
+							eligibility,
+							checks,
+							matched: tags,
+							missing
+						})),
+						reason: input.selectionReason,
+						source: requirements.requestedAgentId ? "explicit" : matched ? "match" : input.selectionSource === "match" ? "snapshot" : input.selectionSource ?? (input.requirements ? "snapshot" : "legacy"),
+						previousSelectionId: input.previousSelectionId
+					})
+				});
 				const brief = buildPersonalTaskBrief({
 					title: input.title,
 					objective,
@@ -143,7 +246,7 @@ function createPersonalTaskTool(deps) {
 					expectedOutputs: input.expectedOutputs ?? [],
 					acceptanceCriteria: input.acceptanceCriteria ?? [],
 					constraints: input.constraints ?? [],
-					idempotencyKey: input.idempotencyKey?.trim() || randomUUID()
+					idempotencyKey: key
 				};
 			} else if (command === "list") {
 				command = "delegated_tasks";
@@ -165,14 +268,26 @@ function createPersonalTaskTool(deps) {
 					};
 				} else args = { taskId };
 			}
-			return {
-				content: (await productTool.execute(toolCallId, {
-					mode: "task",
-					command,
-					args
-				}, signal, void 0)).content,
-				details: {}
-			};
+			try {
+				return {
+					content: (await selectedProductTool.execute(toolCallId, {
+						mode: "task",
+						command,
+						args
+					}, signal, void 0)).content,
+					details: {}
+				};
+			} catch (error) {
+				if (pendingSelection && !new AgentSelectionRepository().find(conversationId, pendingSelection.key)) {
+					const repository = new AgentSelectionRepository();
+					const record = repository.create(pendingSelection);
+					repository.link(record.id, {
+						status: "start_failed",
+						reasonCode: "creation_exception"
+					});
+				}
+				throw error;
+			}
 		}
 	};
 }

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 { dataScheduler } from "../data-acquisition/scheduler.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { 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 { readWorkspaceRevision } from "../coding/workspace-revision.js";
 import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
+import { readWorkspaceRevision } from "../coding/workspace-revision.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 { 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 { readWorkspaceFile } from "../sandbox/fileAccess.js";
+import { checkFileSafety } from "../prompt/safety.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 { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
 import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
 import { resolveSkillReadablePath } from "../skills/skill-view-path.js";
 import { readFileSync, statSync } from "fs";
 import { Type } from "@sinclair/typebox";