@xopcai/xopc 0.0.199 → 0.0.200

package/dist/packages/gateway-contract/src/tasks.js

@@ -26,7 +26,8 @@ const TaskChangedFieldSchema = z.enum([
 	"context",
 	"runs",
 	"receipts",
-	"attention"
+	"attention",
+	"conversation"
 ]);
 z.object({
 	taskId: z.string().min(1),
@@ -278,7 +279,7 @@ const TaskCreateRequestSchema = z.object({
 		phase: z.enum(["backlog", "ready"]).default("backlog")
 	}), z.object({
 		mode: z.literal("start"),
-		executor: TaskExecutorSelectionSchema,
+		executor: TaskExecutorSelectionSchema.optional(),
 		scheduleAt: z.number().int().nonnegative().optional()
 	})])
 }).strict();
@@ -291,8 +292,7 @@ const TaskPatchRequestSchema = z.object({
 	parentTaskId: z.string().trim().min(1).nullable().optional(),
 	priority: TaskPrioritySchema.optional(),
 	dueAt: z.number().int().nonnegative().nullable().optional(),
-	ownerId: z.string().trim().min(1).nullable().optional(),
-	delegateAgentId: z.string().trim().min(1).nullable().optional()
+	ownerId: z.string().trim().min(1).nullable().optional()
 }).strict();
 const TaskWaitInputSchema = z.object({
 	kind: z.enum([
@@ -347,10 +347,6 @@ const TaskCommandSchema = z.discriminatedUnion("type", [
 		waitId: z.string(),
 		resolution: z.unknown().optional()
 	}),
-	z.object({
-		type: z.literal("delegate"),
-		agentId: z.string().optional()
-	}),
 	z.object({
 		type: z.literal("revise_contract"),
 		contract: TaskContractInputSchema
@@ -383,6 +379,50 @@ z.object({
 	operationalState: TaskOperationalStateSchema,
 	run: TaskRunSchema.optional()
 });
+const TaskConversationStateSchema = z.object({
+	taskId: z.string(),
+	activeSessionKey: z.string().optional(),
+	currentExecutorAgentId: z.string().optional(),
+	assignmentEpoch: z.number().int().nonnegative(),
+	status: z.enum(["idle", "active"]),
+	updatedAt: z.number().int().nonnegative()
+});
+const TaskSessionLinkSchema = z.object({
+	id: z.string(),
+	taskId: z.string(),
+	sessionKey: z.string(),
+	role: z.enum([
+		"primary",
+		"discussion",
+		"execution"
+	]),
+	agentId: z.string().optional(),
+	runId: z.string().optional(),
+	assignmentEpoch: z.number().int().nonnegative(),
+	status: z.enum([
+		"active",
+		"completed",
+		"superseded",
+		"failed"
+	]),
+	startedAt: z.number().int().nonnegative(),
+	endedAt: z.number().int().nonnegative().optional(),
+	createdAt: z.number().int().nonnegative()
+});
+const TaskHandoffRequestSchema = z.object({
+	toAgentId: z.string().trim().min(1),
+	expectedVersion: z.number().int().positive(),
+	idempotencyKey: z.string().trim().min(1).max(200)
+}).strict();
+z.object({
+	ok: z.literal(true),
+	task: TaskSchema,
+	conversation: TaskConversationStateSchema,
+	fromAgentId: z.string().optional(),
+	toAgentId: z.string(),
+	activeSessionKey: z.string(),
+	assignmentEpoch: z.number().int().positive()
+});
 z.object({
 	ok: z.literal(true),
 	task: TaskSchema,
@@ -392,6 +432,8 @@ z.object({
 	runs: z.array(TaskRunSchema),
 	receipts: z.array(TaskRunReceiptSchema),
 	context: z.array(TaskContextEdgeSchema),
+	conversation: TaskConversationStateSchema,
+	sessions: z.array(TaskSessionLinkSchema),
 	authorityGrants: z.array(TaskAuthorityGrantSchema),
 	dependencies: z.array(TaskDependencySummarySchema),
 	dependents: z.array(TaskDependencySummarySchema),
@@ -402,4 +444,4 @@ z.object({
 	items: z.array(TaskRunReceiptSchema)
 });
 //#endregion
-export { TaskBoardPositionRequestSchema, TaskCommandRequestSchema, TaskCommandSchema, TaskContextInputSchema, TaskCreateRequestSchema, TaskDependencyUpdateRequestSchema, TaskExecutorSelectionSchema, TaskPatchRequestSchema };
+export { TaskBoardPositionRequestSchema, TaskCommandRequestSchema, TaskCommandSchema, TaskContextInputSchema, TaskCreateRequestSchema, TaskDependencyUpdateRequestSchema, TaskExecutorSelectionSchema, TaskHandoffRequestSchema, TaskPatchRequestSchema };

package/dist/src/agent/context/execution-scope.js

@@ -3,6 +3,7 @@ import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
 import { sanitizeForPromptLiteral } from "../prompt/sanitize-for-prompt.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
+import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { buildActiveProjectContextForPrompt } from "./project-context.js";
 //#region src/agent/context/execution-scope.ts
@@ -14,7 +15,8 @@ function bounded(value, max = MAX_OBJECTIVE_TEXT) {
 	return text.length <= max ? text : `${text.slice(0, max - 1).trimEnd()}…`;
 }
 function taskObjective(sessionKey) {
-	const task = new TaskRepository().getBySession(sessionKey);
+	const taskId = new TaskConversationRepository().resolveActiveExecutionSession(sessionKey)?.taskId;
+	const task = taskId ? new TaskRepository().get(taskId) : void 0;
 	if (!task) return void 0;
 	const contract = task.contract;
 	return {

package/dist/src/agent/tasks/task-judge-service.d.ts

@@ -1,6 +1,6 @@
+import type { TaskJudgment } from '@xopcai/gateway-contract';
 import { type Config } from '../../config/schema.js';
 import type { SessionStore } from '../../session/store.js';
-import type { TaskJudgment } from '@xopcai/gateway-contract';
 import type { ModelManager } from '../models/index.js';
 export interface TaskTurnCompletion {
     sessionKey: string;

package/dist/src/agent/tasks/task-judge-service.js

@@ -4,6 +4,7 @@ import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getApiKey, 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 { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
@@ -61,13 +62,13 @@ var TaskJudgeService = class {
 	#tasks = new TaskRepository();
 	#runs = new TaskRunRepository();
 	#application = new TaskApplicationService();
+	#conversations = new TaskConversationRepository();
 	constructor(options) {
 		this.options = options;
 	}
 	async reviewTurn(payload) {
 		if (payload.skipTaskReview || payload.aborted || payload.streamError) return;
-		const metadata = await this.options.sessionStore.getMetadata(payload.sessionKey);
-		const taskId = typeof metadata?.customData?.taskId === "string" ? metadata.customData.taskId.trim() : "";
+		const taskId = this.#conversations.resolveActiveExecutionSession(payload.sessionKey)?.taskId;
 		if (!taskId) return;
 		const task = this.#tasks.get(taskId);
 		if (!task?.contract) return;

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

@@ -4,6 +4,7 @@ import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
 import { ObjectLinkService } from "../../activity/service.js";
 import "../../activity/index.js";
+import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
@@ -11,7 +12,7 @@ import { TaskCommandSchema, TaskContextInputSchema } from "../../../packages/gat
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
 import "../../automations/index.js";
-import { isValidProjectAgentId, normalizeProjectAgentId } from "../../projects/project-agent.js";
+import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import { TaskContextRepository } from "../../tasks/task-context-repository.js";
 import { enqueueTaskChangedEvent } from "../../tasks/task-change-events.js";
@@ -22,6 +23,7 @@ import "../../tasks/index.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/xopc-use-tool.ts
+init_resolve_route();
 const XopcUseToolSchema = Type.Object({
 	mode: Type.Union([
 		Type.Literal("project"),
@@ -92,7 +94,6 @@ const TASK_COMMANDS = new Set([
 	"reopen",
 	"add_wait",
 	"resolve_wait",
-	"delegate",
 	"revise_contract"
 ]);
 const TASK_CREATE_MODES = new Set(["capture", "start"]);
@@ -1191,13 +1192,22 @@ async function handleTask(command, args, deps, dryRun) {
 			contract[field] = value;
 		}
 		const sessionKey = trimString(args.sessionKey) ?? deps.getCurrentSessionKey?.();
-		const agentId = trimString(args.agentId) ?? deps.getCurrentAgentId?.() ?? "main";
+		const config = deps.getConfig?.();
+		const projectService = deps.getProjectService?.();
+		const explicitAgentId = trimString(args.agentId);
+		const agentId = config && projectService ? resolveProjectAgentId({
+			config,
+			projects: projectService,
+			explicitAgentId,
+			projectId
+		}) : explicitAgentId ?? (config ? getDefaultAgentId(config) : deps.getCurrentAgentId?.() ?? "main");
 		const input = {
 			idempotencyKey: trimString(args.idempotencyKey) ?? randomUUID(),
 			title: trimString(args.title) ?? objective,
 			priority: priority ?? "normal",
 			...dueAt === void 0 ? {} : { dueAt },
 			...projectId ? { projectId } : {},
+			delegateAgentId: agentId,
 			...locale ? { locale } : {},
 			contract: {
 				...contract,

package/dist/src/automations/domain/validation.d.ts

@@ -133,9 +133,6 @@ export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         type: z.ZodLiteral<"resolve_wait">;
         waitId: z.ZodString;
         resolution: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"delegate">;
-        agentId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"revise_contract">;
         contract: z.ZodObject<{
@@ -321,9 +318,6 @@ export declare const AutomationSchema: z.ZodObject<{
             type: z.ZodLiteral<"resolve_wait">;
             waitId: z.ZodString;
             resolution: z.ZodOptional<z.ZodUnknown>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"delegate">;
-            agentId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"revise_contract">;
             contract: z.ZodObject<{
@@ -484,9 +478,6 @@ export declare const CreateAutomationSchema: z.ZodObject<{
             type: z.ZodLiteral<"resolve_wait">;
             waitId: z.ZodString;
             resolution: z.ZodOptional<z.ZodUnknown>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"delegate">;
-            agentId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"revise_contract">;
             contract: z.ZodObject<{
@@ -674,9 +665,6 @@ export declare const UpdateAutomationSchema: z.ZodObject<{
             type: z.ZodLiteral<"resolve_wait">;
             waitId: z.ZodString;
             resolution: z.ZodOptional<z.ZodUnknown>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"delegate">;
-            agentId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"revise_contract">;
             contract: z.ZodObject<{

package/dist/src/automations/draft/automation-draft-validator.d.ts

@@ -86,9 +86,6 @@ export declare function buildAutomationDraftResponse(draft: GeneratedAutomationD
                 type: "resolve_wait";
                 waitId: string;
                 resolution?: unknown;
-            } | {
-                type: "delegate";
-                agentId?: string;
             } | {
                 type: "revise_contract";
                 contract: {

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v119).`,
+		message: `SQLite schema v${status.dbVersion} (current release v120).`,
 		hints: []
 	};
 }

package/dist/src/gateway/hono/app.js

@@ -175,7 +175,7 @@ function createHonoApp(config) {
 	}));
 	app.use("/api/*", async (c, next) => {
 		const contentType = c.req.header("content-type");
-		const maxSize = c.req.method === "POST" && c.req.path === "/api/tasks" || c.req.method === "POST" && /^\/api\/sessions\/[^/]+\/inputs$/.test(c.req.path) || c.req.method === "PATCH" && /^\/api\/sessions\/[^/]+\/inputs\/[^/]+$/.test(c.req.path) ? SESSION_INPUT_BODY_MAX : c.req.path === "/api/skills/upload" ? SKILL_UPLOAD_BODY_MAX : c.req.path === "/api/voice/transcribe" || c.req.path === "/api/voice/transcriptions" ? VOICE_TRANSCRIBE_BODY_MAX : isNoteMediaUploadRequest(c.req.path, c.req.method, contentType) ? NOTE_MEDIA_BODY_MAX : isProjectFileUploadRequest(c.req.path, c.req.method, contentType) ? NOTE_MEDIA_BODY_MAX : discussionUploadBodyMax(c.req.path, c.req.method, contentType) ?? DEFAULT_API_BODY_MAX;
+		const maxSize = c.req.method === "POST" && c.req.path === "/api/tasks" || c.req.method === "POST" && /^\/api\/sessions\/[^/]+\/inputs$/.test(c.req.path) || c.req.method === "POST" && /^\/api\/tasks\/[^/]+\/inputs$/.test(c.req.path) || c.req.method === "PATCH" && /^\/api\/sessions\/[^/]+\/inputs\/[^/]+$/.test(c.req.path) ? SESSION_INPUT_BODY_MAX : c.req.path === "/api/skills/upload" ? SKILL_UPLOAD_BODY_MAX : c.req.path === "/api/voice/transcribe" || c.req.path === "/api/voice/transcriptions" ? VOICE_TRANSCRIBE_BODY_MAX : isNoteMediaUploadRequest(c.req.path, c.req.method, contentType) ? NOTE_MEDIA_BODY_MAX : isProjectFileUploadRequest(c.req.path, c.req.method, contentType) ? NOTE_MEDIA_BODY_MAX : discussionUploadBodyMax(c.req.path, c.req.method, contentType) ?? DEFAULT_API_BODY_MAX;
 		const maxSizeMb = Math.ceil(maxSize / (1024 * 1024));
 		return bodyLimit({
 			maxSize,

package/dist/src/gateway/hono/routes/agent-stream.js

@@ -1,5 +1,5 @@
-import { endpointTurnClaimSchema } from "../../../../packages/endpoint-tools-protocol/src/index.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
+import { submitSessionInput } from "./session-input-handler.js";
 //#region src/gateway/hono/routes/agent-stream.ts
 function registerAgentStreamRoutes(authenticated, deps) {
 	const { service, chatRateLimitMiddleware } = deps;
@@ -34,79 +34,7 @@ function registerAgentStreamRoutes(authenticated, deps) {
 		});
 	});
 	authenticated.post("/api/sessions/:sessionKey/inputs", chatRateLimitMiddleware, async (c) => {
-		const sessionKey = (c.req.param("sessionKey") ?? "").trim();
-		const body = await c.req.json().catch(() => null);
-		if (!body || !sessionKey) return c.json({
-			ok: false,
-			error: {
-				code: "BAD_REQUEST",
-				message: "Invalid request"
-			}
-		}, 400);
-		const attachments = Array.isArray(body.attachments) ? body.attachments : void 0;
-		const content = typeof body.content === "string" ? body.content : "";
-		const contentError = validateWebchatContent(content);
-		if (contentError) return c.json({
-			ok: false,
-			error: {
-				code: "BAD_REQUEST",
-				message: contentError
-			}
-		}, 400);
-		const attachmentError = validateWebchatAttachments(attachments);
-		if (attachmentError) return c.json({
-			ok: false,
-			error: {
-				code: "BAD_REQUEST",
-				message: attachmentError
-			}
-		}, 400);
-		const delivery = body.delivery === "next" || body.delivery === "steer" ? body.delivery : null;
-		if (!delivery) return c.json({
-			ok: false,
-			error: {
-				code: "BAD_REQUEST",
-				message: "Missing delivery"
-			}
-		}, 400);
-		const origin = endpointTurnClaimSchema.safeParse(body.origin);
-		if (!origin.success) return c.json({
-			ok: false,
-			error: {
-				code: "BAD_REQUEST",
-				message: "Invalid endpoint origin"
-			}
-		}, 400);
-		if (!service.endpointTools.registry.verifyTurnClaim(origin.data.endpointId, origin.data.token)) return c.json({
-			ok: false,
-			error: {
-				code: "INVALID_ENDPOINT",
-				message: "Endpoint connection is not active"
-			}
-		}, 401);
-		const result = await service.submitSessionInput({
-			sessionKey,
-			clientMessageId: typeof body.clientMessageId === "string" ? body.clientMessageId : "",
-			delivery,
-			content,
-			attachments,
-			thinking: typeof body.thinking === "string" ? body.thinking : void 0,
-			origin: {
-				type: "endpoint",
-				endpointId: origin.data.endpointId
-			}
-		});
-		if (result.ok === false) return c.json({
-			ok: false,
-			error: {
-				code: result.code,
-				message: "Input was not accepted"
-			}
-		}, result.code === "QUEUE_FULL" ? 409 : 400);
-		return c.json({
-			ok: true,
-			payload: result
-		}, 202);
+		return submitSessionInput(c, deps, (c.req.param("sessionKey") ?? "").trim());
 	});
 	authenticated.patch("/api/sessions/:sessionKey/inputs/:inputId", chatRateLimitMiddleware, async (c) => {
 		const sessionKey = (c.req.param("sessionKey") ?? "").trim();

package/dist/src/gateway/hono/routes/session-input-handler.d.ts

@@ -0,0 +1,62 @@
+import type { Context } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function submitSessionInput(c: Context, deps: AuthenticatedRouteDeps, sessionKey: string): Promise<(Response & import("hono").TypedResponse<{
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}, 400, "json">) | (Response & import("hono").TypedResponse<{
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}, 401, "json">) | (Response & import("hono").TypedResponse<{
+    ok: false;
+    error: {
+        code: "BAD_REQUEST" | "QUEUE_FULL";
+        message: string;
+    };
+}, 400 | 409, "json">) | (Response & import("hono").TypedResponse<{
+    ok: true;
+    payload: {
+        sessionKey: string;
+        ok: true;
+        effectiveDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
+        state: {
+            sessionKey: string;
+            revision: number;
+            activeRunId?: string;
+            activeInputId?: string;
+            inputs: {
+                id: string;
+                sessionKey: string;
+                clientMessageId: string;
+                requestedDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
+                effectiveDelivery: import("../../../storage/sqlite/session-input-repository.js").SessionInputDelivery;
+                status: import("../../../storage/sqlite/session-input-repository.js").SessionInputStatus;
+                content: string;
+                attachments?: import("hono/dist/types/utils/types.js").JSONValue[];
+                thinking?: string;
+                origin: {
+                    type: "endpoint";
+                    endpointId: string;
+                } | {
+                    type: "channel";
+                    channel: string;
+                } | {
+                    type: "system";
+                    source: "cli" | "workflow" | "automation" | "heartbeat" | "internal";
+                };
+                position: number;
+                targetRunId?: string;
+                runId?: string;
+                version: number;
+                error?: string;
+                createdAtMs: number;
+                updatedAtMs: number;
+            }[];
+        };
+    };
+}, 202, "json">)>;

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -0,0 +1,82 @@
+import { endpointTurnClaimSchema } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
+//#region src/gateway/hono/routes/session-input-handler.ts
+async function submitSessionInput(c, deps, sessionKey) {
+	const body = await c.req.json().catch(() => null);
+	if (!body || !sessionKey) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "Invalid request"
+		}
+	}, 400);
+	const attachments = Array.isArray(body.attachments) ? body.attachments : void 0;
+	const content = typeof body.content === "string" ? body.content : "";
+	const contentError = validateWebchatContent(content);
+	if (contentError) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: contentError
+		}
+	}, 400);
+	const attachmentError = validateWebchatAttachments(attachments);
+	if (attachmentError) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: attachmentError
+		}
+	}, 400);
+	const delivery = body.delivery === "next" || body.delivery === "steer" ? body.delivery : null;
+	if (!delivery) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "Missing delivery"
+		}
+	}, 400);
+	const origin = endpointTurnClaimSchema.safeParse(body.origin);
+	if (!origin.success) return c.json({
+		ok: false,
+		error: {
+			code: "BAD_REQUEST",
+			message: "Invalid endpoint origin"
+		}
+	}, 400);
+	if (!deps.service.endpointTools.registry.verifyTurnClaim(origin.data.endpointId, origin.data.token)) return c.json({
+		ok: false,
+		error: {
+			code: "INVALID_ENDPOINT",
+			message: "Endpoint connection is not active"
+		}
+	}, 401);
+	const result = await deps.service.submitSessionInput({
+		sessionKey,
+		clientMessageId: typeof body.clientMessageId === "string" ? body.clientMessageId : "",
+		delivery,
+		content,
+		attachments,
+		thinking: typeof body.thinking === "string" ? body.thinking : void 0,
+		origin: {
+			type: "endpoint",
+			endpointId: origin.data.endpointId
+		}
+	});
+	if (result.ok === false) return c.json({
+		ok: false,
+		error: {
+			code: result.code,
+			message: "Input was not accepted"
+		}
+	}, result.code === "QUEUE_FULL" ? 409 : 400);
+	return c.json({
+		ok: true,
+		payload: {
+			...result,
+			sessionKey
+		}
+	}, 202);
+}
+//#endregion
+export { submitSessionInput };