@xopcai/xopc 0.0.211 → 0.0.213

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

@@ -15,10 +15,12 @@ import { CatalogWorkflowDefinitionRegistry } from "../registry/catalog-workflow-
 import { validateWorkflowJsonSchema } from "../domain/schema-validation.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";
 import "../domain/index.js";
+import { resolveWorkflowContext } from "../context/workflow-context.js";
 import { WorkflowEngine } from "../engine/workflow-engine.js";
 import "../engine/index.js";
 import { WorkflowEventStore } from "../store/event-store.js";
 import { WorkflowRunStore } from "../store/run-store.js";
+import { WorkflowWritebackService, resolveWorkflowWritebackPolicy } from "./workflow-writeback-service.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/service/workflow-run-service.ts
 init_resolve_route();
@@ -131,7 +133,59 @@ var WorkflowRunService = class {
 		const runId = randomUUID();
 		const goal = params.goal ?? "";
 		const linkedTaskRun = params.taskRunId ? new TaskRunRepository().get(params.taskRunId) : void 0;
-		const projectId = params.projectId?.trim() || (linkedTaskRun ? new TaskRepository().get(linkedTaskRun.taskId)?.projectId : void 0) || (params.parentSessionKey?.trim() ? (await this.options.service.sessionIndexInstance.getStore().getMetadata(params.parentSessionKey.trim()))?.projectId : void 0);
+		const inheritedProjectId = params.projectId?.trim() || (linkedTaskRun ? new TaskRepository().get(linkedTaskRun.taskId)?.projectId : void 0) || (params.parentSessionKey?.trim() ? (await this.options.service.sessionIndexInstance.getStore().getMetadata(params.parentSessionKey.trim()))?.projectId : void 0);
+		const taskId = linkedTaskRun?.taskId;
+		const requestedContextRefs = params.contextRefs ? [...inheritedProjectId && !params.contextRefs.some((ref) => ref.kind === "project" && ref.id === inheritedProjectId) ? [{
+			kind: "project",
+			id: inheritedProjectId,
+			role: "scope"
+		}] : [], ...params.contextRefs] : buildDefaultWorkflowContextRefs({
+			projectId: inheritedProjectId,
+			taskId,
+			source: params.source
+		});
+		const passiveContextRefs = requestedContextRefs.filter((ref) => ![
+			"project",
+			"task",
+			"note"
+		].includes(ref.kind));
+		let resolvedContext;
+		try {
+			resolvedContext = await resolveWorkflowContext({
+				runId,
+				projectId: inheritedProjectId,
+				refs: requestedContextRefs.filter((ref) => [
+					"project",
+					"task",
+					"note"
+				].includes(ref.kind)),
+				config: this.options.service.currentConfig,
+				reuseSnapshotId: params.contextSnapshotId
+			});
+		} catch (cause) {
+			return {
+				ok: false,
+				code: "invalid_input",
+				message: cause instanceof Error ? cause.message : "Workflow context could not be resolved",
+				httpStatus: 400
+			};
+		}
+		const projectId = resolvedContext?.projectId ?? inheritedProjectId;
+		const contextRefs = resolvedContext ? [...resolvedContext.refs, ...passiveContextRefs] : requestedContextRefs;
+		let writebackPolicy;
+		try {
+			writebackPolicy = resolveWorkflowWritebackPolicy(params.writebackPolicy, {
+				projectId,
+				taskId
+			});
+		} catch (cause) {
+			return {
+				ok: false,
+				code: "invalid_input",
+				message: cause instanceof Error ? cause.message : "Invalid workflow writeback policy",
+				httpStatus: 400
+			};
+		}
 		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
 			runId,
 			agentId: params.agentId,
@@ -177,7 +231,8 @@ var WorkflowRunService = class {
 			eventStore,
 			runStore,
 			sessionKey,
-			projectId
+			projectId,
+			contextInstructions: resolvedContext?.instructions
 		});
 		const limits = resolveWorkflowRunLimits({
 			config: this.options.service.currentConfig,
@@ -200,8 +255,9 @@ var WorkflowRunService = class {
 				agentId: params.agentId,
 				taskRunId: params.taskRunId,
 				projectId,
-				contextRefs: params.contextRefs,
-				writebackPolicy: params.writebackPolicy,
+				contextRefs,
+				contextSnapshot: resolvedContext?.snapshot,
+				writebackPolicy,
 				sessionKey,
 				source,
 				input: inputEnvelope,
@@ -246,6 +302,7 @@ var WorkflowRunService = class {
 			taskRunId: existing.run.metadata?.taskRunId,
 			projectId,
 			contextRefs: existing.run.metadata?.contextRefs,
+			contextSnapshotId: existing.run.metadata?.contextSnapshot?.id,
 			writebackPolicy: existing.run.metadata?.writebackPolicy,
 			input: existing.run.metadata?.input ? void 0 : existing.run.input,
 			inputEnvelope: existing.run.metadata?.input,
@@ -281,6 +338,43 @@ var WorkflowRunService = class {
 		const goal = buildReplayGoal(existing, params.scope, targets.targets.length);
 		const parentSessionKey = existing.run.source.kind === "chat" ? existing.run.source.sessionKey : void 0;
 		const projectId = existing.run.metadata?.projectId;
+		const taskRunId = existing.run.metadata?.taskRunId;
+		const taskId = taskRunId ? new TaskRunRepository().get(taskRunId)?.taskId : void 0;
+		let writebackPolicy;
+		try {
+			writebackPolicy = resolveWorkflowWritebackPolicy(existing.run.metadata?.writebackPolicy, {
+				projectId,
+				taskId
+			});
+		} catch (cause) {
+			return {
+				ok: false,
+				code: "invalid_input",
+				message: cause instanceof Error ? cause.message : "Invalid workflow writeback policy",
+				httpStatus: 400
+			};
+		}
+		let resolvedContext;
+		try {
+			resolvedContext = await resolveWorkflowContext({
+				runId: replayRunId,
+				projectId,
+				refs: existing.run.metadata?.contextRefs?.filter((ref) => [
+					"project",
+					"task",
+					"note"
+				].includes(ref.kind)) ?? [],
+				config: this.options.service.currentConfig,
+				reuseSnapshotId: existing.run.metadata?.contextSnapshot?.id
+			});
+		} catch (cause) {
+			return {
+				ok: false,
+				code: "invalid_input",
+				message: cause instanceof Error ? cause.message : "Workflow context snapshot could not be loaded",
+				httpStatus: 400
+			};
+		}
 		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
 			runId: replayRunId,
 			agentId: params.agentId,
@@ -298,7 +392,8 @@ var WorkflowRunService = class {
 			eventStore,
 			runStore: replayRunStore,
 			sessionKey,
-			projectId
+			projectId,
+			contextInstructions: resolvedContext?.instructions
 		});
 		const limits = resolveWorkflowRunLimits({
 			config: this.options.service.currentConfig,
@@ -318,10 +413,11 @@ var WorkflowRunService = class {
 			metadata: buildWorkflowRunMetadata({
 				definition,
 				agentId: params.agentId,
-				taskRunId: existing.run.metadata?.taskRunId,
+				taskRunId,
 				projectId,
 				contextRefs: existing.run.metadata?.contextRefs,
-				writebackPolicy: existing.run.metadata?.writebackPolicy,
+				contextSnapshot: resolvedContext?.snapshot,
+				writebackPolicy,
 				sessionKey,
 				source,
 				input: inputEnvelope,
@@ -466,9 +562,11 @@ var WorkflowRunService = class {
 		return new WorkflowEngine({
 			cwd: workspace,
 			projectId: params.projectId,
+			contextInstructions: params.contextInstructions,
 			eventStore: params.eventStore,
 			runStore: params.runStore,
 			runner,
+			hooks: [{ afterRun: ({ runId, status }) => new WorkflowWritebackService().apply(params.runStore, runId, status) }],
 			resolveModelId: (modelId) => {
 				return resolveModel(resolveModelRef(gatewayService.currentConfig, profileAgentId, modelId));
 			},
@@ -539,7 +637,7 @@ function buildWorkflowRunMetadata(params) {
 		taskId,
 		source: params.source
 	});
-	const writebackPolicy = params.writebackPolicy ?? buildDefaultWorkflowWritebackPolicy({
+	const writebackPolicy = resolveWorkflowWritebackPolicy(params.writebackPolicy, {
 		projectId,
 		taskId
 	});
@@ -549,6 +647,7 @@ function buildWorkflowRunMetadata(params) {
 		agentId: params.agentId,
 		projectId,
 		contextRefs,
+		contextSnapshot: params.contextSnapshot,
 		writebackPolicy,
 		retryOfRunId: params.retryOfRunId,
 		replay: params.replay,
@@ -583,20 +682,6 @@ function buildDefaultWorkflowContextRefs(params) {
 	});
 	return refs;
 }
-function buildDefaultWorkflowWritebackPolicy(params) {
-	const targets = [];
-	if (params.projectId) targets.push({
-		kind: "project",
-		id: params.projectId,
-		mode: "record"
-	});
-	if (params.taskId) targets.push({
-		kind: "task",
-		id: params.taskId,
-		mode: "evaluate"
-	});
-	return { targets };
-}
 function resolveWorkflowReplayTargets(view, scope) {
 	const phaseTitleById = new Map(view.phases.map((phase) => [phase.id, phase.title]));
 	const failedStatuses = new Set(["error", "skipped"]);

package/dist/src/workflows/service/workflow-run-service.types.d.ts

@@ -6,6 +6,7 @@ export interface StartWorkflowRunServiceParams {
     parentSessionKey?: string;
     projectId?: string;
     contextRefs?: WorkflowRunContextRef[];
+    contextSnapshotId?: string;
     writebackPolicy?: WorkflowRunWritebackPolicy;
     input?: unknown;
     inputEnvelope?: WorkflowRunInputEnvelope;

package/dist/src/workflows/service/workflow-writeback-service.d.ts

@@ -0,0 +1,9 @@
+import type { WorkflowRunMetadata } from '../domain/index.js';
+import type { WorkflowRunStore } from '../store/run-store.js';
+export declare class WorkflowWritebackService {
+    apply(runStore: WorkflowRunStore, runId: string, status: 'succeeded' | 'failed' | 'cancelled'): Promise<void>;
+}
+export declare function resolveWorkflowWritebackPolicy(requested: WorkflowRunMetadata['writebackPolicy'] | undefined, scope: {
+    projectId?: string;
+    taskId?: string;
+}): NonNullable<WorkflowRunMetadata['writebackPolicy']>;

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

@@ -0,0 +1,106 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { ProjectService } from "../../projects/project-service.js";
+//#region src/workflows/service/workflow-writeback-service.ts
+init_logger();
+const log = createLogger("WorkflowWriteback");
+var WorkflowWritebackService = class {
+	async apply(runStore, runId, status) {
+		try {
+			const view = await runStore.readRunView(runId);
+			if (!view) return;
+			const summary = view.run.result?.summary?.trim() || view.run.error?.message?.trim() || `Workflow ${status}`;
+			const taskRunId = view.run.metadata?.taskRunId;
+			const linkedTaskRun = taskRunId ? new TaskRunRepository().get(taskRunId) : void 0;
+			for (const target of view.run.metadata?.writebackPolicy?.targets ?? []) {
+				if (target.kind === "project") {
+					if (target.id !== view.run.metadata?.projectId || !["record", "suggest"].includes(target.mode)) continue;
+					const projects = new ProjectService();
+					const project = projects.get(target.id);
+					if (!project) continue;
+					const risks = view.run.result?.sections?.filter((section) => section.kind === "risks").flatMap((section) => section.items.map((item) => item.title)) ?? [];
+					projects.createUpdate(target.id, {
+						health: project.health,
+						summary: target.mode === "suggest" ? `Workflow suggestion: ${summary}` : summary,
+						risks,
+						nextSteps: view.run.result?.followUps?.map((item) => item.title) ?? [],
+						actor: {
+							kind: "workflow",
+							runId,
+							definitionId: view.run.definitionId,
+							status
+						}
+					});
+					continue;
+				}
+				if (target.mode !== "evaluate" || !linkedTaskRun || linkedTaskRun.taskId !== target.id) continue;
+				new TaskRunRepository().finalize({
+					runId: linkedTaskRun.id,
+					expectedVersion: linkedTaskRun.version,
+					receipt: {
+						status,
+						summary,
+						changes: [],
+						evidence: (view.run.result?.artifacts ?? []).map((artifact) => ({
+							kind: "artifact",
+							title: artifact.title ?? artifact.name,
+							summary: artifact.name,
+							provenance: "tool",
+							strength: "observed",
+							observedAt: artifact.createdAtMs
+						})),
+						verification: {
+							status: "unverified",
+							checks: []
+						},
+						remainingWork: status === "succeeded" ? [] : [view.run.error?.message ?? "Workflow did not complete"],
+						...view.run.result?.followUps?.[0]?.title ? { nextAction: view.run.result.followUps[0].title } : {},
+						needsUser: true,
+						completionVerdict: status === "succeeded" ? "partial" : "not_achieved",
+						...status === "failed" ? { failure: {
+							code: view.run.error?.code ?? "runtime_error",
+							phase: "workflow",
+							recoveryAction: "Review the workflow result and retry when ready."
+						} } : {},
+						contextTraceId: view.run.metadata?.contextSnapshot?.traceId
+					},
+					actor: {
+						kind: "agent",
+						id: view.run.metadata?.agentId
+					}
+				});
+			}
+		} catch (err) {
+			log.warn({
+				err,
+				runId,
+				phase: "writeback"
+			}, "Workflow result writeback failed");
+		}
+	}
+};
+function resolveWorkflowWritebackPolicy(requested, scope) {
+	const targets = (requested?.targets ?? defaultTargets(scope)).filter((target, index, all) => all.findIndex((candidate) => candidate.kind === target.kind && candidate.id === target.id && candidate.mode === target.mode) === index);
+	for (const target of targets) {
+		if (target.kind === "project") {
+			if (!scope.projectId || target.id !== scope.projectId || !["record", "suggest"].includes(target.mode)) throw new Error("Workflow project writeback must target the bound project");
+			continue;
+		}
+		if (!scope.taskId || target.id !== scope.taskId || target.mode !== "evaluate") throw new Error("Workflow task writeback must evaluate the linked task");
+	}
+	return { targets };
+}
+function defaultTargets(scope) {
+	return [...scope.projectId ? [{
+		kind: "project",
+		id: scope.projectId,
+		mode: "record"
+	}] : [], ...scope.taskId ? [{
+		kind: "task",
+		id: scope.taskId,
+		mode: "evaluate"
+	}] : []];
+}
+//#endregion
+export { WorkflowWritebackService, resolveWorkflowWritebackPolicy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.211",
+  "version": "0.0.213",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -67,10 +67,10 @@
   "dependencies": {
     "@composio/core": "0.14.1",
     "@composio/experimental": "0.2.0",
-    "@earendil-works/pi-agent-core": "0.84.2",
-    "@earendil-works/pi-ai": "0.84.2",
-    "@earendil-works/pi-coding-agent": "0.84.2",
-    "@earendil-works/pi-tui": "0.84.2",
+    "@earendil-works/pi-agent-core": "0.84.4",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
     "@grammyjs/runner": "^2.0.3",
     "@hono/node-server": "^2.0.4",
     "@inquirer/prompts": "^8.5.0",
@@ -163,9 +163,9 @@
     "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/realtime-protocol": "0.0.0",
+    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {