@xopcai/xopc 0.0.383 → 0.0.385

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

@@ -2,39 +2,35 @@ 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" | "entry" | "submit" | "instruct" | "collaboration">[]>;
     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>;
+    section: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>>;
+    entryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    afterSequence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    bodyOffset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    questionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;
 export interface PersonalTaskToolDeps extends XopcUseToolDeps {
     getAgentToolAvailability?: MatchingContext['getAgentToolAvailability'];
@@ -56,4 +52,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,30 +1,47 @@
 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 { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.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"),
 		Type.Literal("create"),
 		Type.Literal("list"),
 		Type.Literal("get"),
+		Type.Literal("collaboration"),
+		Type.Literal("entry"),
 		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 +52,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,23 +68,110 @@ 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." })),
+	entryId: Type.Optional(Type.String({ description: "Read one complete collaboration entry, including its question or instruction body." })),
+	afterSequence: Type.Optional(Type.Integer({ minimum: 0 })),
+	bodyOffset: Type.Optional(Type.Integer({
+		minimum: 0,
+		description: "Character offset for an entry body; follow nextBodyOffset until absent."
+	})),
+	section: Type.Optional(Type.Union([
+		"task",
+		"waits",
+		"runs",
+		"receipts",
+		"context",
+		"conversation",
+		"sessions",
+		"authorityGrants",
+		"dependencies",
+		"dependents",
+		"criterionReviews"
+	].map((value) => Type.Literal(value)))),
 	questionId: Type.Optional(Type.String({ description: "Collaboration question ID to answer." })),
 	expectedOutputs: Type.Optional(Type.Array(Type.String())),
 	acceptanceCriteria: Type.Optional(Type.Array(Type.String())),
 	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",
+		"collaboration",
+		"entry",
+		"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",
+				"collaboration",
+				"retry_allocation",
+				"cancel"
+			] } },
+			required: ["taskId"]
+		},
+		{
+			properties: { command: { const: "entry" } },
+			required: ["taskId", "entryId"]
+		},
+		{
+			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 +193,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 reads Task state, waits, runs, receipts and context; use section and limit/offset for complete paginated details. collaboration reads ordered message previews with afterSequence; entry reads exact message bodies using entryId and nextBodyOffset. Read full questions before answering. Delivery pending means saved, delivered means sent, confirmed means the executor acknowledged it; confirmation alone is not verified completion. 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 +259,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 +290,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 +404,81 @@ 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 === "collaboration" || command === "entry") {
+					const board = new TaskCollaborationRepository();
+					if (command === "entry") {
+						const entry = input.entryId ? board.get(input.entryId) : void 0;
+						if (!entry || entry.taskId !== taskId) throw new Error("Entry does not belong to this Task");
+						const offset = input.bodyOffset ?? 0;
+						const body = entry.body.slice(offset, offset + 4e3);
+						const payload = {
+							ok: true,
+							entry: {
+								...entry,
+								body
+							},
+							bodyOffset: offset,
+							bodyLength: entry.body.length,
+							...offset + body.length < entry.body.length ? { nextBodyOffset: offset + body.length } : {}
+						};
+						return {
+							content: [{
+								type: "text",
+								text: JSON.stringify(payload)
+							}],
+							details: {}
+						};
+					}
+					const limit = input.limit ?? 10;
+					const entries = board.list(taskId, input.afterSequence ?? 0, limit + 1);
+					const items = entries.slice(0, limit).map((entry) => ({
+						...entry,
+						body: entry.body.slice(0, 600),
+						bodyLength: entry.body.length,
+						...entry.body.length > 600 ? {
+							excerpt: true,
+							readEntryId: entry.id
+						} : {}
+					}));
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify({
+								ok: true,
+								items,
+								...entries.length > limit ? { nextAfterSequence: items.at(-1)?.sequence } : {}
+							})
+						}],
+						details: {}
+					};
+				}
+				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");
@@ -264,17 +487,126 @@ function createPersonalTaskTool(deps) {
 						taskId,
 						kind: input.command === "answer" ? "answer" : "instruction",
 						body,
+						idempotencyKey: input.idempotencyKey?.trim() || `personal-collaboration:${selectionRequestHash({
+							inputId: getSessionInputState(conversationId).activeInputId ?? toolCallId,
+							taskId,
+							kind: input.command,
+							body,
+							questionId: input.questionId
+						})}`,
 						...input.command === "answer" ? { causationId: input.questionId.trim() } : {}
 					};
 				} 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") {
+					const offset = input.offset ?? 0;
+					const limit = input.limit ?? 10;
+					const read = input.section ? {
+						ok: payload.ok,
+						[input.section]: payload[input.section]
+					} : { ...payload };
+					const pagination = {};
+					for (const key of [
+						"waits",
+						"runs",
+						"receipts",
+						"context",
+						"sessions",
+						"authorityGrants",
+						"dependencies",
+						"dependents",
+						"criterionReviews"
+					]) {
+						const value = read[key];
+						if (!Array.isArray(value)) continue;
+						read[key] = value.slice(offset, offset + limit);
+						pagination[key] = {
+							total: value.length,
+							offset,
+							...offset + limit < value.length ? { nextOffset: offset + limit } : {}
+						};
+					}
+					if (!input.section) {
+						read.collaboration = new TaskCollaborationRepository().recent(input.taskId, void 0, 10).map((entry) => ({
+							...entry,
+							body: entry.body.slice(0, 600),
+							bodyLength: entry.body.length,
+							...entry.body.length > 600 ? {
+								excerpt: true,
+								readEntryId: entry.id
+							} : {}
+						}));
+						read.allocation = new TaskAllocationRepository().summary(input.taskId);
+						read.guidance = "Read entry for complete question/instruction bodies; collaboration with afterSequence pages the whole board. get(section, offset) pages state details. pending is saved, delivered is sent, confirmed is acknowledged; verification and Task acceptance are separate.";
+					}
+					return {
+						content: [{
+							type: "text",
+							text: JSON.stringify({
+								...read,
+								pagination
+							})
+						}],
+						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";

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 { 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/task-collaboration-tool.d.ts

@@ -0,0 +1,16 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type XopcUseToolDeps } from './xopc-use-tool.js';
+declare const Schema: import("@sinclair/typebox").TObject<{
+    command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"post">]>;
+    section: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"collaboration">, import("@sinclair/typebox").TLiteral<"task">]>>;
+    kind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"progress">, import("@sinclair/typebox").TLiteral<"question">, import("@sinclair/typebox").TLiteral<"ack">]>>;
+    body: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    causationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    entryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    afterSequence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/** Collaboration only: no product mutations, connection selection or external operations. */
+export declare function createTaskCollaborationTool(deps: XopcUseToolDeps): AgentTool<typeof Schema>;
+export {};