@xopcai/xopc 0.0.312 → 0.0.314

package/dist/src/tasks/capabilities/write.js

@@ -0,0 +1,107 @@
+import { TaskCommandRequestSchema, TaskCreateRequestSchema, TaskDetailResponseSchema } from "../../../packages/gateway-contract/src/tasks.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { TaskRepository, init_task_repository } from "../task-repository.js";
+import { TaskRunRepository, init_task_run_repository } from "../task-run-repository.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
+import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
+import { resolveProjectAgentId } from "../../projects/project-agent.js";
+import { TaskApplicationService } from "../task-application-service.js";
+import { TaskSignalService } from "../task-signal-service.js";
+import { z } from "zod";
+//#region src/tasks/capabilities/write.ts
+init_src();
+init_task_run_repository();
+init_task_repository();
+const modelSchema = TaskDetailResponseSchema.pick({
+	task: true,
+	operationalState: true,
+	attention: true,
+	allowedCommands: true
+});
+const TaskMutationOutputSchema = z.discriminatedUnion("ok", [z.object({
+	ok: z.literal(true),
+	model: modelSchema,
+	runId: z.string().optional()
+}), z.object({
+	ok: z.literal(false),
+	reason: z.enum([
+		"not_found",
+		"conflict",
+		"invalid_transition",
+		"blocked"
+	]),
+	model: modelSchema.optional()
+})]);
+function registerTaskWriteCapabilities(dispatcher, deps) {
+	dispatcher.register(defineAtomicCapability({
+		id: "xopc.tasks.create",
+		majorVersion: 1,
+		description: "Create a task and atomically persist its operation receipt.",
+		effect: "local-write",
+		surfaces: ["http", "agent"],
+		scopes: ["tasks.write"],
+		input: TaskCreateRequestSchema.omit({ idempotencyKey: true }),
+		output: TaskMutationOutputSchema,
+		execute(input, context) {
+			if (input.activation.mode === "start" && !deps.wake) throw new CapabilityError("UNAVAILABLE", "Task execution service is unavailable");
+			const config = deps.getConfig?.();
+			const projects = deps.getProjects?.();
+			const requestedAgentId = input.delegateAgentId ?? (input.activation.mode === "start" && input.activation.executor?.kind === "agent" ? input.activation.executor.agentId : void 0);
+			const agentId = config && projects ? resolveProjectAgentId({
+				config,
+				projects,
+				explicitAgentId: requestedAgentId,
+				projectId: input.projectId
+			}) : requestedAgentId;
+			const activation = input.activation.mode === "start" && (!input.activation.executor || input.activation.executor.kind === "agent") ? {
+				...input.activation,
+				executor: {
+					kind: "agent",
+					agentId: agentId ?? "main"
+				}
+			} : input.activation;
+			return new TaskApplicationService().create({
+				...input,
+				delegateAgentId: agentId,
+				activation,
+				idempotencyKey: context.idempotencyKey
+			}, context.actor);
+		},
+		afterCommit(result) {
+			if (result.ok) deps.wake?.(Boolean(result.runId));
+		}
+	}));
+	dispatcher.register(defineAtomicCapability({
+		id: "xopc.tasks.command",
+		majorVersion: 1,
+		description: "Apply a versioned task lifecycle command with a durable receipt.",
+		effect: "local-write",
+		surfaces: ["http", "agent"],
+		scopes: ["tasks.write"],
+		input: TaskCommandRequestSchema.omit({ idempotencyKey: true }).extend({ taskId: z.string().min(1) }),
+		output: TaskMutationOutputSchema,
+		execute(input, context) {
+			if (input.command.type === "start" && !deps.wake) throw new CapabilityError("UNAVAILABLE", "Task execution service is unavailable");
+			const result = new TaskApplicationService().execute({
+				...input,
+				command: input.command,
+				idempotencyKey: context.idempotencyKey,
+				actor: context.actor
+			});
+			if (result.ok && input.command.type === "close" && input.command.resolution === "done") new TaskSignalService().dependencyClosed(input.taskId);
+			return result;
+		},
+		async afterCommit(result, input) {
+			if (!result.ok) return;
+			const command = input.command;
+			const denied = command.type === "resolve_wait" && command.resolution?.kind === "task_approval" && command.resolution.decision === "deny";
+			if (command.type === "add_wait" && command.wait.kind === "paused" || command.type === "close" || denied) {
+				const activeRun = new TaskRunRepository().getActiveRoot(input.taskId);
+				if (activeRun?.conversationId && new TaskRepository().get(input.taskId)?.version === result.model.task.version) await deps.abortConversation?.(activeRun.conversationId);
+			}
+			deps.wake?.(Boolean(result.runId) || command.type === "resolve_wait" || command.type === "close");
+		}
+	}));
+}
+//#endregion
+export { TaskMutationOutputSchema, registerTaskWriteCapabilities };

package/dist/src/tasks/home-query-service.js

@@ -1,14 +1,15 @@
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { isHomeAttentionAcknowledged } from "../storage/sqlite/home-attention-repository.js";
 import { listConnectorApprovals } from "../storage/sqlite/connector-repository.js";
 import { getRelationshipSettings } from "../storage/sqlite/relationship-settings-repository.js";
 import "../storage/sqlite/index.js";
-import { TaskRepository } from "./task-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import "../automations/domain/defaults.js";
-import "../automations/index.js";
 import { AttentionGovernor } from "./attention-governor.js";
 import { listGatewayAgents } from "../gateway/agents-admin.js";
+import "../automations/index.js";
 //#region src/tasks/home-query-service.ts
+init_task_repository();
 function toHomeWorkflowRun(run) {
 	return {
 		id: run.id,

package/dist/src/tasks/index.d.ts

@@ -17,7 +17,6 @@ export * from './task-handoff-service.js';
 export * from './task-dependency-service.js';
 export * from './task-deletion-service.js';
 export * from './task-read-model-projector.js';
-export * from './task-outbox-dispatcher.js';
 export * from './task-run-dispatcher.js';
 export * from './task-run-repository.js';
 export * from './task-signal-service.js';

package/dist/src/tasks/index.js

@@ -1,28 +1,28 @@
 import { enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent, init_task_change_events } from "./task-change-events.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskRepository } from "./task-repository.js";
 import { TaskConversationConflictError, TaskConversationRepository } from "./task-conversation-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
-import { resolveExecutionContext } from "./execution-context.js";
-import { AttentionGovernor } from "./attention-governor.js";
-import { HomeQueryService, buildHomeWorkbench, decisionFromTask } from "./home-query-service.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskDependencyError, TaskDependencyService } from "./task-dependency-service.js";
+import { TaskValueMetricsService } from "./task-value-metrics-service.js";
+import { TaskDeletionService } from "./task-deletion-service.js";
 import { TaskApplicationService } from "./task-application-service.js";
+import { TaskSignalService } from "./task-signal-service.js";
+import { resolveExecutionContext } from "./execution-context.js";
+import { AttentionGovernor } from "./attention-governor.js";
+import { HomeQueryService, buildHomeWorkbench, decisionFromTask } from "./home-query-service.js";
 import { TaskWorkflowCoordinator } from "./task-workflow-coordinator.js";
 import { defineTaskContract } from "./task-contract-definition.js";
 import { ModelTaskContractPlanner, parseTaskContractResponse } from "./task-contract-planner.js";
 import { assembleTaskContext, buildTaskExecutionDirective, getTaskContextManifest, getTaskExecutionBrief } from "./task-context-assembler.js";
 import { TaskRunCoordinator } from "./task-run-coordinator.js";
 import { ProjectOperatingViewService, summarizeProjectOperatingView } from "./project-operating-view-service.js";
-import { TaskValueMetricsService } from "./task-value-metrics-service.js";
 import { TaskHandoffService } from "./task-handoff-service.js";
-import { TaskDeletionService } from "./task-deletion-service.js";
-import { TaskOutboxDispatcher } from "./task-outbox-dispatcher.js";
 import { TaskRunDispatcher } from "./task-run-dispatcher.js";
-import { TaskSignalService } from "./task-signal-service.js";
 //#region src/tasks/index.ts
+init_task_repository();
 init_task_change_events();
 init_task_run_repository();
 //#endregion
-export { AttentionGovernor, HomeQueryService, ModelTaskContractPlanner, ProjectOperatingViewService, TaskApplicationService, TaskContextRepository, TaskConversationConflictError, TaskConversationRepository, TaskDeletionService, TaskDependencyError, TaskDependencyService, TaskHandoffService, TaskOutboxDispatcher, TaskReadModelProjector, TaskRepository, TaskRunCoordinator, TaskRunDispatcher, TaskRunRepository, TaskSignalService, TaskValueMetricsService, TaskWorkflowCoordinator, assembleTaskContext, buildHomeWorkbench, buildTaskExecutionDirective, decisionFromTask, defineTaskContract, enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent, getTaskContextManifest, getTaskExecutionBrief, parseTaskContractResponse, resolveExecutionContext, summarizeProjectOperatingView };
+export { AttentionGovernor, HomeQueryService, ModelTaskContractPlanner, ProjectOperatingViewService, TaskApplicationService, TaskContextRepository, TaskConversationConflictError, TaskConversationRepository, TaskDeletionService, TaskDependencyError, TaskDependencyService, TaskHandoffService, TaskReadModelProjector, TaskRepository, TaskRunCoordinator, TaskRunDispatcher, TaskRunRepository, TaskSignalService, TaskValueMetricsService, TaskWorkflowCoordinator, assembleTaskContext, buildHomeWorkbench, buildTaskExecutionDirective, decisionFromTask, defineTaskContract, enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent, getTaskContextManifest, getTaskExecutionBrief, parseTaskContractResponse, resolveExecutionContext, summarizeProjectOperatingView };

package/dist/src/tasks/project-operating-view-service.js

@@ -1,8 +1,9 @@
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskRepository } from "./task-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { TaskDependencyService } from "./task-dependency-service.js";
 //#region src/tasks/project-operating-view-service.ts
+init_task_repository();
 init_task_run_repository();
 function summarizeProjectOperatingView(view) {
 	const counts = {

package/dist/src/tasks/task-application-service.d.ts

@@ -26,6 +26,7 @@ export declare class TaskApplicationService {
         actor?: ActorRef;
         terminalCode?: string;
         terminalMessage?: string;
+        suppressAttention?: boolean;
     }): TaskApplicationResult;
     private start;
     private lifecycle;

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

@@ -2,8 +2,8 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { TaskExecutorSelectionSchema, verifiedTaskCriteria } from "../../packages/gateway-contract/src/tasks.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { enqueueTaskAttentionRequiredEvent, enqueueTaskChangedEvent, init_task_change_events } from "./task-change-events.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskRepository } from "./task-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskDependencyService } from "./task-dependency-service.js";
@@ -12,6 +12,7 @@ import { createHash, randomUUID } from "node:crypto";
 init_src();
 init_transaction();
 init_task_change_events();
+init_task_repository();
 init_task_run_repository();
 function requestHash(value) {
 	return createHash("sha256").update(JSON.stringify(value)).digest("hex");
@@ -468,7 +469,7 @@ var TaskApplicationService = class {
 			}
 			if (input.receipt.status !== "succeeded") {
 				const model = this.#projector.project(task);
-				enqueueTaskAttentionRequiredEvent(db, {
+				if (!input.suppressAttention) enqueueTaskAttentionRequiredEvent(db, {
 					taskId: task.id,
 					taskTitle: task.title,
 					...task.projectId ? { projectId: task.projectId } : {},

package/dist/src/tasks/task-change-events.js

@@ -1,4 +1,5 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { currentOperationId, init_operation_context } from "../infra/operation-context.js";
 import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/tasks/task-change-events.ts
@@ -12,8 +13,8 @@ function enqueueTaskChangedEvent(db, input) {
 	if (changedFields.length === 0) return;
 	db.prepare(`INSERT INTO domain_outbox (
       event_id, event_type, subject_kind, subject_id, correlation_id,
-      payload_json, created_at
-    ) VALUES (?, 'task.changed.v2', 'task', ?, ?, ?, ?)`).run(randomUUID(), input.taskId, randomUUID(), JSON.stringify({
+      payload_json, created_at, operation_id
+    ) VALUES (?, 'task.changed.v2', 'task', ?, ?, ?, ?, ?)`).run(randomUUID(), input.taskId, randomUUID(), JSON.stringify({
 		taskId: input.taskId,
 		...input.projectId ? { projectId: input.projectId } : {},
 		version: input.version,
@@ -21,7 +22,7 @@ function enqueueTaskChangedEvent(db, input) {
 		source: eventSource(input),
 		...input.actor?.id ? { actorId: input.actor.id } : {},
 		occurredAt
-	}), occurredAt);
+	}), occurredAt, currentOperationId() ?? null);
 }
 function enqueueTaskAttentionRequiredEvent(db, input) {
 	const occurredAt = input.occurredAt ?? Date.now();
@@ -44,6 +45,7 @@ function enqueueTaskChanged(input) {
 }
 var init_task_change_events = __esmMin((() => {
 	init_transaction();
+	init_operation_context();
 }));
 //#endregion
 init_task_change_events();

package/dist/src/tasks/task-context-assembler.js

@@ -1,13 +1,14 @@
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { verifiedTaskCriteria } from "../../packages/gateway-contract/src/tasks.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
 import "../storage/sqlite/index.js";
-import { TaskRepository } from "./task-repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 //#region src/tasks/task-context-assembler.ts
 init_src();
+init_task_repository();
 init_task_run_repository();
 const STANDARD = {
 	profile: "standard",

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

@@ -1,6 +1,7 @@
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskRepository } from "./task-repository.js";
 //#region src/tasks/task-deletion-service.ts
+init_task_repository();
 init_task_run_repository();
 var TaskDeletionService = class {
 	constructor(tasks = new TaskRepository(), runs = new TaskRunRepository()) {

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

@@ -1,8 +1,9 @@
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { TaskRepository } from "./task-repository.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 //#region src/tasks/task-dependency-service.ts
 init_transaction();
+init_task_repository();
 var TaskDependencyError = class extends Error {
 	constructor(code, message) {
 		super(message);

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

@@ -1,15 +1,16 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../agent/agent-scope.js";
 import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
-import { TaskRepository } from "./task-repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 //#region src/tasks/task-handoff-service.ts
 init_agent_scope();
 init_session_key();
 init_logger();
+init_task_repository();
 init_task_run_repository();
 const log = createLogger("TaskHandoff");
 var TaskHandoffService = class {

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

@@ -1,8 +1,9 @@
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskRepository } from "./task-repository.js";
 //#region src/tasks/task-read-model-projector.ts
 init_transaction();
+init_task_repository();
 init_task_run_repository();
 var TaskReadModelProjector = class {
 	#tasks = new TaskRepository();

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

@@ -2,6 +2,15 @@ import type { ActorRef, Task, TaskAcceptancePolicy, TaskContract, TaskPhase, Tas
 export type TaskExecutionSource = 'chat' | 'cli' | 'cron' | 'workflow' | 'channel' | 'api';
 export type TaskUiLocale = 'en' | 'zh';
 export type TaskAggregate = Task;
+type TaskListQuery = {
+    search?: string;
+    phase?: TaskPhase;
+    priority?: TaskPriority;
+    projectId?: string;
+    limit?: number;
+    offset?: number;
+    order?: 'recent' | 'board';
+};
 export interface TaskCreateInput {
     id?: string;
     idempotencyKey?: string;
@@ -34,13 +43,8 @@ export declare class TaskRepository {
     get(id: string): TaskAggregate | undefined;
     require(id: string): TaskAggregate;
     getByIdempotencyKey(key: string): TaskAggregate | undefined;
-    list(input?: {
-        search?: string;
-        phase?: TaskPhase;
-        projectId?: string;
-        limit?: number;
-        order?: 'recent' | 'board';
-    }): TaskAggregate[];
+    list(input?: TaskListQuery): TaskAggregate[];
+    count(input?: TaskListQuery): number;
     listByProject(projectId: string, limit?: number): TaskAggregate[];
     getContract(taskId: string, version?: number): TaskContract | undefined;
     update(taskId: string, patch: {
@@ -86,3 +90,4 @@ export declare class TaskRepository {
     delete(taskId: string): boolean;
     private insertContract;
 }
+export {};