@xopcai/xopc 0.0.199 → 0.0.201

package/dist/src/tasks/task-handoff-service.js

@@ -0,0 +1,143 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../agent/agent-scope.js";
+import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
+import { TaskRepository } from "./task-repository.js";
+import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskRunRepository } from "./task-run-repository.js";
+import { TaskContextRepository } from "./task-context-repository.js";
+//#region src/tasks/task-handoff-service.ts
+init_agent_scope();
+init_session_key();
+init_logger();
+const log = createLogger("TaskHandoff");
+var TaskHandoffService = class {
+	#inflight = /* @__PURE__ */ new Map();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	handoff(input) {
+		const previous = this.#inflight.get(input.taskId);
+		const pending = (previous ? previous.catch(() => void 0) : Promise.resolve()).then(() => this.performHandoff(input));
+		this.#inflight.set(input.taskId, pending);
+		pending.finally(() => {
+			if (this.#inflight.get(input.taskId) === pending) this.#inflight.delete(input.taskId);
+		});
+		return pending;
+	}
+	async performHandoff(input) {
+		const config = this.deps.getConfig();
+		const toAgentId = normalizeAgentId(input.toAgentId);
+		if (!listAgentEntries(config).find((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === toAgentId)) throw new Error(`Agent not found: ${toAgentId}`);
+		const tasks = new TaskRepository();
+		const task = tasks.require(input.taskId);
+		const conversations = new TaskConversationRepository();
+		const duplicate = conversations.findHandoffByIdempotencyKey({
+			taskId: task.id,
+			expectedTaskVersion: input.expectedVersion,
+			toAgentId,
+			idempotencyKey: input.idempotencyKey
+		});
+		if (duplicate) {
+			await this.abortPreviousSession(duplicate.fromSessionKey);
+			return {
+				task,
+				conversation: conversations.requireState(task.id),
+				snapshot: duplicate,
+				...duplicate.fromAgentId ? { fromAgentId: duplicate.fromAgentId } : {},
+				toAgentId,
+				activeSessionKey: duplicate.toSessionKey,
+				assignmentEpoch: duplicate.assignmentEpoch
+			};
+		}
+		if (task.version !== input.expectedVersion) throw new Error("Task changed");
+		const previousState = conversations.requireState(task.id);
+		if (previousState.currentExecutorAgentId === toAgentId) throw new Error("Executor is already active");
+		const assignmentEpoch = previousState.assignmentEpoch + 1;
+		const peerId = sanitizeSegment(`task-${task.id}-assignment-${assignmentEpoch}`);
+		const sessionKey = buildSessionKey({
+			agentId: toAgentId,
+			source: "webchat",
+			accountId: "default",
+			peerKind: "direct",
+			peerId
+		});
+		const runs = new TaskRunRepository();
+		const latestRun = runs.getLatestRoot(task.id);
+		const latestReceipt = latestRun ? runs.getReceipt(latestRun.id) : void 0;
+		const remainingCriteria = latestReceipt?.verification.checks.length ? latestReceipt.verification.checks.filter((check) => check.status !== "passed").map((check) => check.criterion) : task.contract?.acceptanceCriteria ?? [];
+		const payload = {
+			objective: task.contract?.objective ?? task.title,
+			expectedOutputs: task.contract?.expectedOutputs ?? [],
+			remainingCriteria,
+			constraints: task.contract?.constraints ?? [],
+			risks: task.contract?.risks ?? [],
+			approvalRequired: task.contract?.approvalRequired ?? [],
+			context: new TaskContextRepository().list(task.id),
+			...latestReceipt ? {
+				latestReceipt,
+				completedWork: latestReceipt.changes,
+				remainingWork: latestReceipt.remainingWork
+			} : {}
+		};
+		await this.deps.sessionIndex.saveMessages(sessionKey, [], { metadata: {
+			sourceChannel: "webchat",
+			sourceChatId: `default:direct:${peerId}`,
+			sessionType: "chat",
+			routing: {
+				agentId: toAgentId,
+				source: "webchat",
+				accountId: "default",
+				peerKind: "direct",
+				peerId
+			},
+			projectId: task.projectId,
+			customData: {
+				origin: "task",
+				triggerKind: "user",
+				assignmentEpoch
+			}
+		} });
+		let completed;
+		try {
+			completed = conversations.completeHandoff({
+				taskId: task.id,
+				expectedTaskVersion: input.expectedVersion,
+				toSessionKey: sessionKey,
+				toAgentId,
+				idempotencyKey: input.idempotencyKey,
+				payload
+			});
+		} catch (error) {
+			await this.deps.sessionIndex.delete(sessionKey);
+			throw error;
+		}
+		const oldSessionKey = completed.snapshot.fromSessionKey;
+		await this.abortPreviousSession(oldSessionKey);
+		return {
+			task: tasks.require(task.id),
+			conversation: completed.state,
+			snapshot: completed.snapshot,
+			...completed.snapshot.fromAgentId ? { fromAgentId: completed.snapshot.fromAgentId } : {},
+			toAgentId,
+			activeSessionKey: sessionKey,
+			assignmentEpoch: completed.state.assignmentEpoch
+		};
+	}
+	async abortPreviousSession(sessionKey) {
+		if (!sessionKey) return;
+		const activeRunId = this.deps.getActiveRunId(sessionKey);
+		if (!activeRunId) return;
+		try {
+			await this.deps.abortRun(activeRunId);
+		} catch (error) {
+			log.warn({
+				err: error,
+				sessionKey,
+				runId: activeRunId
+			}, "Previous task executor did not stop cleanly");
+		}
+	}
+};
+//#endregion
+export { TaskHandoffService };

package/dist/src/tasks/task-read-model-projector.js

@@ -76,11 +76,7 @@ var TaskReadModelProjector = class {
 	}
 	allowedCommands(task, activeRunStatus, hasWaits) {
 		if (task.phase === "closed") return ["reopen"];
-		const commands = [
-			"revise_contract",
-			"delegate",
-			"close"
-		];
+		const commands = ["revise_contract", "close"];
 		if (!activeRunStatus && !hasWaits) commands.unshift("move");
 		if (hasWaits) commands.unshift("resolve_wait");
 		else if (activeRunStatus === "running" || activeRunStatus === "verifying") commands.unshift("add_wait");

package/dist/src/tasks/task-repository.d.ts

@@ -34,7 +34,6 @@ export declare class TaskRepository {
     get(id: string): TaskAggregate | undefined;
     require(id: string): TaskAggregate;
     getByIdempotencyKey(key: string): TaskAggregate | undefined;
-    getBySession(sessionKey: string): TaskAggregate | undefined;
     list(input?: {
         phase?: TaskPhase;
         projectId?: string;
@@ -53,7 +52,6 @@ export declare class TaskRepository {
         priority?: TaskPriority;
         dueAt?: number | null;
         ownerId?: string | null;
-        delegateAgentId?: string | null;
         now?: number;
     }): TaskAggregate | undefined;
     setLifecycle(input: {

package/dist/src/tasks/task-repository.js

@@ -93,13 +93,6 @@ var TaskRepository = class {
 		const row = getSqliteDatabase().prepare("SELECT * FROM tasks WHERE creation_idempotency_key = ?").get(key);
 		return row ? taskFromRow(row, this.getContract(row.task_id, row.latest_contract_version)) : void 0;
 	}
-	getBySession(sessionKey) {
-		const row = getSqliteDatabase().prepare(`SELECT tasks.* FROM tasks
-       JOIN task_sessions ON task_sessions.task_id = tasks.task_id
-       WHERE task_sessions.session_key = ?
-       ORDER BY task_sessions.created_at DESC LIMIT 1`).get(sessionKey);
-		return row ? taskFromRow(row, this.getContract(row.task_id, row.latest_contract_version)) : void 0;
-	}
 	list(input = {}) {
 		const clauses = [];
 		const params = [];
@@ -134,9 +127,9 @@ var TaskRepository = class {
 		if (!title) throw new Error("Task title is required");
 		const now = Math.max(patch.now ?? Date.now(), current.updatedAt + 1);
 		return getSqliteDatabase().prepare(`UPDATE tasks SET title = ?, body = ?, project_id = ?, milestone_id = ?,
-       parent_task_id = ?, priority = ?, due_at = ?, owner_id = ?, delegate_agent_id = ?,
+       parent_task_id = ?, priority = ?, due_at = ?, owner_id = ?,
        version = version + 1, updated_at = ?
-       WHERE task_id = ? AND version = ?`).run(title, patch.body === void 0 ? current.body ?? null : patch.body?.trim() || null, patch.projectId === void 0 ? current.projectId ?? null : patch.projectId, patch.milestoneId === void 0 ? current.milestoneId ?? null : patch.milestoneId, patch.parentTaskId === void 0 ? current.parentTaskId ?? null : patch.parentTaskId, patch.priority ?? current.priority, patch.dueAt === void 0 ? current.dueAt ?? null : patch.dueAt, patch.ownerId === void 0 ? current.ownerId ?? null : patch.ownerId, patch.delegateAgentId === void 0 ? current.delegateAgentId ?? null : patch.delegateAgentId, now, taskId, patch.expectedVersion).changes === 0 ? void 0 : this.get(taskId);
+       WHERE task_id = ? AND version = ?`).run(title, patch.body === void 0 ? current.body ?? null : patch.body?.trim() || null, patch.projectId === void 0 ? current.projectId ?? null : patch.projectId, patch.milestoneId === void 0 ? current.milestoneId ?? null : patch.milestoneId, patch.parentTaskId === void 0 ? current.parentTaskId ?? null : patch.parentTaskId, patch.priority ?? current.priority, patch.dueAt === void 0 ? current.dueAt ?? null : patch.dueAt, patch.ownerId === void 0 ? current.ownerId ?? null : patch.ownerId, now, taskId, patch.expectedVersion).changes === 0 ? void 0 : this.get(taskId);
 	}
 	setLifecycle(input) {
 		if (input.phase === "closed" !== Boolean(input.resolution)) throw new Error("Closed tasks require a resolution and open tasks cannot have one");

package/dist/src/tasks/task-run-coordinator.js

@@ -19,11 +19,13 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 		let run = runs.get(input.runId);
 		if (!run) {
 			if (runs.getActiveRoot(task.id)) return void 0;
+			const agentId = task.delegateAgentId ?? input.context.agentId;
+			if (!agentId) return void 0;
 			run = runs.create({
 				id: input.runId,
 				taskId: task.id,
 				executorKind: "agent",
-				executorRef: { agentId: input.context.agentId ?? task.delegateAgentId ?? "main" },
+				executorRef: { agentId },
 				trigger: { kind: input.context.triggerKind },
 				correlationId: input.runId,
 				idempotencyKey: input.runId,

package/dist/src/workflows/service/workflow-run-service.js

@@ -2,6 +2,7 @@ import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-rou
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getProjectWorkspacePathForSession } from "../../projects/workspace.js";
 import { publishAutomationProductEvent } from "../../automations/product-events.js";
@@ -161,10 +162,11 @@ var WorkflowRunService = class {
 				},
 				sessionKey
 			})) throw new Error("TaskRun changed before workflow execution started");
-			context.linkSession({
+			new TaskConversationRepository().activateExecutionSession({
 				taskId: task.id,
 				sessionKey,
-				role: "execution"
+				agentId: params.agentId,
+				runId: linkedTaskRun.id
 			});
 		}
 		const source = normalizeWorkflowRunSourceForSession(params.source, sessionKey, params.parentSessionKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.199",
+  "version": "0.0.201",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -162,8 +162,8 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
     "@xopcai/realtime-client": "0.0.0"
   },