@xopcai/xopc 0.0.383 → 0.0.384

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

@@ -1,10 +1,15 @@
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { getPersonalRequest, init_request_repository, listPersonalRequests } from "../../personal-agent/request-repository.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
+import { TaskAllocationRepository } from "../../tasks/task-allocation-repository.js";
+import { boundedPersonalResult } from "./personal-result-budget.js";
+import { cancelPersonalTask } from "../../personal-agent/task-cancel.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();
+init_transaction();
 const CapabilitySchema = Type.Object({
 	query: Type.String({
 		minLength: 1,
@@ -20,8 +25,12 @@ const RequestSchema = Type.Object({
 		"cancel"
 	].map((command) => Type.Literal(command))),
 	requestId: Type.Optional(Type.String()),
+	offset: Type.Optional(Type.Integer({ minimum: 0 })),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20
+	})),
 	connectorId: Type.Optional(Type.String()),
-	agentId: Type.Optional(Type.String()),
 	accountId: Type.Optional(Type.String()),
 	objective: Type.Optional(Type.String({
 		minLength: 1,
@@ -31,13 +40,25 @@ const RequestSchema = Type.Object({
 		minLength: 1,
 		maxLength: 200
 	})),
-	selectionReason: Type.Optional(Type.String({ maxLength: 500 })),
 	timeRange: Type.Optional(Type.Object({
 		from: Type.String(),
 		to: Type.String(),
 		timezone: Type.String(),
 		expression: Type.String()
 	}))
+}, {
+	additionalProperties: false,
+	anyOf: [
+		{
+			properties: { command: { const: "submit" } },
+			required: ["objective", "connectorId"]
+		},
+		{ properties: { command: { const: "list" } } },
+		{
+			properties: { command: { enum: ["get", "cancel"] } },
+			required: ["requestId"]
+		}
+	]
 });
 function createPersonalRequestTools(deps) {
 	const conversation = () => {
@@ -45,6 +66,14 @@ function createPersonalRequestTools(deps) {
 		if (!id || !isPersonalConversation(id)) throw new Error("Personal conversation is required");
 		return id;
 	};
+	const snapshot = (request) => {
+		const value = personalRequestSnapshot(request);
+		return {
+			...value,
+			executorAgentId: value.parameters.allocate && value.executorAgentId === "task-router" ? void 0 : value.executorAgentId,
+			...value.taskId ? { allocation: new TaskAllocationRepository().summary(value.taskId) } : {}
+		};
+	};
 	const result = (value) => ({
 		content: [{
 			type: "text",
@@ -56,45 +85,68 @@ function createPersonalRequestTools(deps) {
 		name: "personal_capability",
 		label: "Connected app availability",
 		parameters: CapabilitySchema,
-		description: "Check connected-app capabilities, account connection state and specialist Agents locally. Compare executorProfiles for declared expertise; account executorAgentIds constrain eligibility. For Gmail or other supported apps, check here before delegating. ready is a local preflight; the worker still validates live tools. No remote search or authorization is performed.",
+		description: "Check connected-app capabilities, account connection state and specialist Agents locally. The background Task Router selects an executor within account permissions; do not compare executor profiles in the main conversation. For Gmail or other supported apps, check here before delegating. ready is a local preflight; the worker still validates live tools. No remote search or authorization is performed.",
 		async execute(_id, input) {
-			return result(personalCapabilities(conversation(), input.query, input.accountId));
+			return result(personalCapabilities(conversation(), input.query, input.accountId).map(({ executorProfiles: _profiles, executorAgentIds, accounts, ...capability }) => ({
+				...capability,
+				eligibleExecutorCount: executorAgentIds.length,
+				accounts: accounts.map(({ executorAgentIds: _ids, ...account }) => account)
+			})));
 		}
 	}, {
 		name: "personal_request",
 		label: "Connected app request",
 		parameters: RequestSchema,
-		description: "Submit a read-only connected-app request using exact connectorId and agentId from personal_capability. Include a short selectionReason explaining the fit. Preserves the objective, displays connection or account selection in this main chat, and starts a specialist Task automatically once connected. Return quickly after submission. Never claim data was read until the Task result arrives. Resolve absolute query dates and include timeRange. If mail has no user-specified range, the host returns an explicit last-7-days default; mention that range in your confirmation. Use get/list for status, cancel only when the user requests it.",
+		description: "Submit a read-only connected-app request using the exact connectorId from personal_capability. The background Task Router chooses an executor after account authorization. Preserves the objective, displays connection or account selection in this main chat, and starts a specialist Task automatically once connected. Return quickly after submission. Never claim data was read until the Task result arrives. Resolve absolute query dates and include timeRange. If mail has no user-specified range, the host returns an explicit last-7-days default; mention that range in your confirmation. Use paginated get/list for status without polling; preserve idempotencyKey on uncertain retries; cancel only when the user requests it.",
 		async execute(toolCallId, input) {
 			const conversationId = conversation();
-			if (input.command === "list") return result(listPersonalRequests(conversationId).map(personalRequestSnapshot));
+			if (input.command === "list") {
+				const offset = input.offset ?? 0;
+				const items = listPersonalRequests(conversationId, input.limit ?? 10, offset).map((request) => {
+					const { result: _result, ...summary } = snapshot(request);
+					return summary;
+				});
+				const total = getSqliteDatabase().prepare("SELECT count(*) AS count FROM personal_requests WHERE conversation_id = ?").get(conversationId).count;
+				return result(boundedPersonalResult({
+					items,
+					total,
+					offset
+				}));
+			}
 			if (input.command === "submit") {
-				if (!input.objective?.trim() || !input.connectorId || !input.agentId) throw new Error("objective, connectorId and agentId are required");
+				if (!input.objective?.trim() || !input.connectorId) throw new Error("objective and connectorId are required");
 				const request = submitPersonalRequest({
 					conversationId,
 					connectorId: input.connectorId,
-					agentId: input.agentId,
 					accountId: input.accountId,
 					objective: input.objective.trim(),
-					selectionReason: input.selectionReason,
 					timeRange: input.timeRange,
 					idempotencyKey: input.idempotencyKey ?? toolCallId
 				});
 				publishPersonalRequest(request);
 				deps.dispatchTaskRuns?.();
-				return result(personalRequestSnapshot(request));
+				return result(boundedPersonalResult(snapshot(request)));
 			}
 			const request = input.requestId ? getPersonalRequest(input.requestId) : void 0;
 			if (!request || request.conversationId !== conversationId) throw new Error("Request does not belong to this conversation");
 			if (input.command === "cancel") {
+				if (["completed", "failed"].includes(personalRequestSnapshot(request).state)) return result(boundedPersonalResult(snapshot(request)));
+				if (request.state === "cancelled") {
+					const stop = request.taskId ? await cancelPersonalTask(request.taskId, conversationId, input.idempotencyKey ?? toolCallId) : { executionStopConfirmed: true };
+					return result({
+						...snapshot(request),
+						executionStopConfirmed: stop.executionStopConfirmed
+					});
+				}
+				const stop = request.taskId ? await cancelPersonalTask(request.taskId, conversationId, input.idempotencyKey ?? toolCallId) : { executionStopConfirmed: true };
 				const cancelled = cancelPersonalRequest(request);
 				publishPersonalRequest(cancelled);
 				return result({
 					...cancelled,
-					executionStopConfirmed: false
+					executionStopConfirmed: stop.executionStopConfirmed
 				});
 			}
-			return result(personalRequestSnapshot(request));
+			return result(boundedPersonalResult(snapshot(request)));
 		}
 	}];
 }

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

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

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

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

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

@@ -2,39 +2,31 @@ 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<"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">]>;
+declare const PersonalTaskModelSchema: import("@sinclair/typebox").TObject<{
     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>>;
+        domain: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        taskType: import("@sinclair/typebox").TOptional<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>;
+    command: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"get" | "answer" | "retry_allocation" | "selection" | "list" | "cancel" | "submit" | "instruct">[]>;
     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>;
-    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>;
-    questionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    requiredSkills: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    objective: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     expectedOutputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     acceptanceCriteria: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     constraints: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
-    requiredSkills: 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>;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    instruction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    questionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
 export interface PersonalTaskToolDeps extends XopcUseToolDeps {
     getAgentToolAvailability?: MatchingContext['getAgentToolAvailability'];
@@ -56,4 +48,4 @@ export declare function buildPersonalTaskBrief(input: {
     body?: string;
 };
 /** A narrow Task surface for the fast personal conversation. */
-export declare function createPersonalTaskTool(deps: PersonalTaskToolDeps): AgentTool<typeof PersonalTaskSchema, Record<string, never>>;
+export declare function createPersonalTaskTool(deps: PersonalTaskToolDeps): AgentTool<typeof PersonalTaskModelSchema, Record<string, never>>;

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

@@ -1,22 +1,35 @@
 import { normalizeSpecialistRequirements } from "../../../packages/gateway-contract/src/specialists.js";
+import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { getSessionInputState, init_session_input_repository } from "../../storage/sqlite/session-input-repository.js";
+import { TaskRepository, init_task_repository } from "../../tasks/task-repository.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 { isPersonalConversation } from "../../personal-agent/repository.js";
+import { TaskAllocationRepository } from "../../tasks/task-allocation-repository.js";
+import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
+import { boundedPersonalResult } from "./personal-result-budget.js";
+import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { createXopcUseTool } from "./xopc-use-tool.js";
 import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../../personal-agent/specialist-capabilities.js";
 import { assessSpecialist, matchSpecialists } from "../../agent-matching/service.js";
+import { AgentSelectionRepository, selectionRequestHash } from "../../agent-matching/selection-repository.js";
 import { assertSpecialistEligible, createSelectedTask } from "../../agent-matching/delegation-service.js";
-import { 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 { cancelPersonalTask } from "../../personal-agent/task-cancel.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/personal-task-tool.ts
+init_src();
 init_sqlite();
+init_session_input_repository();
 init_request_repository();
+init_task_repository();
 const PersonalTaskSchema = Type.Object({
 	command: Type.Union([
+		Type.Literal("retry_allocation"),
+		Type.Literal("submit"),
 		Type.Literal("agents"),
 		Type.Literal("match"),
 		Type.Literal("selection"),
@@ -24,7 +37,8 @@ const PersonalTaskSchema = Type.Object({
 		Type.Literal("list"),
 		Type.Literal("get"),
 		Type.Literal("instruct"),
-		Type.Literal("answer")
+		Type.Literal("answer"),
+		Type.Literal("cancel")
 	]),
 	requirements: Type.Optional(Type.Object({
 		version: Type.Optional(Type.Literal(1)),
@@ -35,7 +49,10 @@ const PersonalTaskSchema = Type.Object({
 		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())
+		requestedAgentId: Type.Optional(Type.String({
+			minLength: 1,
+			description: "Only an executor explicitly named by the human user. Omit this field when the background router should choose; never infer it from the specialist directory."
+		}))
 	})),
 	selectionReason: Type.Optional(Type.String({ maxLength: 500 })),
 	selectionSource: Type.Optional(Type.Union([
@@ -48,9 +65,19 @@ const PersonalTaskSchema = Type.Object({
 	requestId: Type.Optional(Type.String()),
 	cursor: Type.Optional(Type.String()),
 	offset: Type.Optional(Type.Integer({ minimum: 0 })),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20
+	})),
 	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." })),
+	objective: Type.Optional(Type.String({
+		minLength: 1,
+		description: "One-sentence outcome for a new delegated Task."
+	})),
+	description: Type.Optional(Type.String({
+		minLength: 1,
+		description: "Complete Markdown brief preserving the user request, input references, and delivery expectations. Optional structured fields need not repeat it."
+	})),
 	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." })),
@@ -60,11 +87,62 @@ const PersonalTaskSchema = Type.Object({
 	constraints: Type.Optional(Type.Array(Type.String())),
 	requiredSkills: Type.Optional(Type.Array(Type.String({
 		minLength: 1,
-		description: "Canonical Skill names explicitly requested by the user. Verify through agents before creation."
+		description: "Only Skill names explicitly requested by the user. Forward them to the background router for validation; omit otherwise."
 	}))),
 	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 PersonalTaskModelSchema = Type.Object({
+	...Type.Omit(PersonalTaskSchema, [
+		"agentId",
+		"selectionReason",
+		"selectionSource",
+		"previousSelectionId",
+		"matchId",
+		"cursor",
+		"requiredTools"
+	]).properties,
+	requirements: Type.Optional(Type.Omit(PersonalTaskSchema.properties.requirements, ["requiredTools", "requiredSkills"], { additionalProperties: false })),
+	command: Type.Union([
+		"submit",
+		"list",
+		"get",
+		"instruct",
+		"answer",
+		"retry_allocation",
+		"selection",
+		"cancel"
+	].map((command) => Type.Literal(command)))
+}, {
+	additionalProperties: false,
+	anyOf: [
+		{
+			properties: { command: { const: "submit" } },
+			required: ["objective", "description"]
+		},
+		{ properties: { command: { enum: ["list", "selection"] } } },
+		{
+			properties: { command: { enum: [
+				"get",
+				"retry_allocation",
+				"cancel"
+			] } },
+			required: ["taskId"]
+		},
+		{
+			properties: { command: { const: "instruct" } },
+			required: ["taskId", "instruction"]
+		},
+		{
+			properties: { command: { const: "answer" } },
+			required: [
+				"taskId",
+				"instruction",
+				"questionId"
+			]
+		}
+	]
+});
 const MAX_PERSONAL_TASK_TITLE = 60;
 function buildPersonalTaskBrief(input) {
 	const fullObjective = input.objective.trim();
@@ -86,18 +164,20 @@ function createPersonalTaskTool(deps) {
 	return {
 		name: "personal_task",
 		label: "Personal Task",
-		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,
+		description: "Submit objective and a concise complete description, then return after local persistence. Preserve the user request and source references without inventing an execution plan or extra requirements. Omit optional structured fields when they merely repeat the description. Describe required capabilities in the brief; the background Task Router selects one executor and checks its tools. Do not read input files, select Agents or invent tool names before submit. Set requirements.requestedAgentId only for an executor explicitly named by the user, using their ID or display name; preserve explicitly requested requiredSkills. get/list inspect existing Tasks with limit/offset; cancel stops a Task on explicit user instruction and reports execution stop confirmation; instruct/answer send context; retry_allocation retries selection before execution; selection explains assignment. Status and results return automatically. Preserve idempotencyKey on uncertain retries. Report only confirmed states.",
+		parameters: PersonalTaskModelSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
 		requiresExclusiveWorkspaceLock: false,
 		finalGuardRelevant: true,
-		async execute(toolCallId, input, signal) {
+		async execute(toolCallId, modelInput, signal) {
+			const input = modelInput;
 			const conversationId = deps.getCurrentConversationId?.();
 			const ownAgentId = deps.getCurrentAgentId?.();
 			if (!conversationId || !ownAgentId || !isPersonalConversation(conversationId)) throw new Error("Personal conversation context is unavailable");
 			const requirements = normalizeSpecialistRequirements({
 				...input.requirements,
+				requestedAgentId: input.requirements?.requestedAgentId?.trim() || void 0,
 				version: 1,
 				summary: input.requirements?.summary ?? (input.objective?.trim() || "Specialist discovery").slice(0, 300),
 				requiredTools: [...input.requirements?.requiredTools ?? [], ...input.requiredTools ?? []],
@@ -150,13 +230,28 @@ function createPersonalTaskTool(deps) {
 			}
 			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");
+				const offset = input.offset ?? 0;
+				const limit = input.limit ?? 10;
+				const rows = new AgentSelectionRepository().list(conversationId, {
+					taskId: input.taskId,
+					requestId: input.requestId,
+					offset,
+					limit: limit + 1
+				});
+				const items = rows.slice(0, limit).map(({ candidates: _candidates, assessment, ...record }) => ({
+					...record,
+					executor: {
+						id: assessment.id,
+						name: assessment.name
+					}
+				}));
 				return {
 					content: [{
 						type: "text",
-						text: JSON.stringify(new AgentSelectionRepository().list(conversationId, {
-							taskId: input.taskId,
-							requestId: input.requestId,
-							offset: input.offset
+						text: JSON.stringify(boundedPersonalResult({
+							items,
+							offset,
+							...rows.length > limit ? { nextOffset: offset + items.length } : {}
 						}))
 					}],
 					details: {}
@@ -166,7 +261,37 @@ function createPersonalTaskTool(deps) {
 			let pendingSelection;
 			let command = input.command;
 			let args = {};
-			if (command === "create") {
+			if (command === "submit") {
+				const objective = input.objective?.trim();
+				if (!objective || !input.description?.trim()) throw new Error("objective and a complete description are required");
+				if (input.agentId) throw new Error("Use requirements.requestedAgentId for an explicitly requested executor");
+				const brief = buildPersonalTaskBrief({
+					title: input.title,
+					objective,
+					description: input.description
+				});
+				const inputId = getSessionInputState(conversationId).activeInputId;
+				const submissionKey = input.idempotencyKey?.trim() || selectionRequestHash({
+					sourceInput: inputId ?? toolCallId,
+					brief,
+					requirements,
+					expectedOutputs: input.expectedOutputs,
+					acceptanceCriteria: input.acceptanceCriteria,
+					constraints: input.constraints
+				});
+				command = "create";
+				args = {
+					...brief,
+					createMode: "allocate",
+					requirements,
+					includeConversationContext: false,
+					expectedOutputs: input.expectedOutputs ?? [],
+					acceptanceCriteria: input.acceptanceCriteria ?? [],
+					constraints: input.constraints ?? [],
+					idempotencyKey: `personal-submit:${conversationId}:${selectionRequestHash(submissionKey)}`
+				};
+				if (requirements.requiredSkills?.length) args.body = `${brief.body}\n\nRequired Skills: ${requirements.requiredSkills.join(", ")}. Read and follow these Skills before execution.`;
+			} else 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");
@@ -250,12 +375,33 @@ function createPersonalTaskTool(deps) {
 				};
 			} else if (command === "list") {
 				command = "delegated_tasks";
-				args = { limit: 20 };
+				args = {
+					limit: input.limit ?? 10,
+					offset: input.offset ?? 0
+				};
 			} 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" || command === "answer") {
+				if (command === "cancel") {
+					const result = await cancelPersonalTask(taskId, conversationId, input.idempotencyKey ?? toolCallId);
+					deps.dispatchTaskRuns?.();
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify(result)
+						}],
+						details: {}
+					};
+				}
+				if (command === "retry_allocation") {
+					command = "command";
+					args = {
+						taskId,
+						type: "retry_allocation",
+						expectedVersion: new TaskRepository().require(taskId).version
+					};
+				} else if (command === "instruct" || command === "answer") {
 					const body = input.instruction?.trim();
 					if (!body) throw new Error("instruction is required");
 					if (command === "answer" && !input.questionId?.trim()) throw new Error("questionId is required");
@@ -269,12 +415,76 @@ function createPersonalTaskTool(deps) {
 				} else args = { taskId };
 			}
 			try {
+				const result = await selectedProductTool.execute(toolCallId, {
+					mode: "task",
+					command,
+					args
+				}, signal, void 0);
+				if ((input.command === "answer" || input.command === "instruct") && input.taskId && result.details.result && result.details.result.ok !== false) {
+					const allocation = new TaskAllocationRepository().get(input.taskId);
+					if (allocation && ["blocked", "failed"].includes(allocation.status)) {
+						new TaskApplicationService().execute({
+							taskId: input.taskId,
+							expectedVersion: new TaskRepository().require(input.taskId).version,
+							idempotencyKey: `allocation-answer:${toolCallId}`,
+							command: { type: "retry_allocation" },
+							actor: {
+								kind: "agent",
+								id: ownAgentId
+							}
+						});
+						deps.dispatchTaskRuns?.();
+					}
+				}
+				const payload = result.details.result;
+				if (payload?.ok === true && input.command === "submit") {
+					const task = payload.task;
+					const confirmation = {
+						ok: true,
+						task: {
+							id: task.id,
+							title: task.title,
+							phase: task.phase,
+							version: task.version
+						},
+						operationalState: payload.operationalState,
+						allocation: payload.allocation,
+						runId: payload.runId
+					};
+					return {
+						content: [{
+							type: "text",
+							text: appendProductDeliveryText(JSON.stringify(confirmation, null, 2), result.details.delivery)
+						}],
+						details: {}
+					};
+				}
+				if (payload && input.command === "get") return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(boundedPersonalResult({
+							ok: payload.ok,
+							task: payload.task,
+							allocation: new TaskAllocationRepository().summary(input.taskId),
+							operationalState: payload.operationalState,
+							attention: payload.attention,
+							allowedCommands: payload.allowedCommands
+						}))
+					}],
+					details: {}
+				};
+				if (payload && input.command === "list") return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(boundedPersonalResult({
+							...payload,
+							offset: input.offset ?? 0
+						}))
+					}],
+					details: {}
+				};
 				return {
-					content: (await selectedProductTool.execute(toolCallId, {
-						mode: "task",
-						command,
-						args
-					}, signal, void 0)).content,
+					content: result.content,
 					details: {}
 				};
 			} catch (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";