@xopcai/xopc 0.0.142 → 0.0.144

package/dist/src/workflows/authoring/index.d.ts

@@ -0,0 +1 @@
+export * from './workflow-draft-store.js';

package/dist/src/workflows/authoring/index.js

@@ -0,0 +1,2 @@
+import { WorkflowDraftConflictError, WorkflowDraftStore } from "./workflow-draft-store.js";
+export { WorkflowDraftConflictError, WorkflowDraftStore };

package/dist/src/workflows/authoring/workflow-draft-store.d.ts

@@ -0,0 +1,33 @@
+import type { WorkflowDefinitionManifest, WorkflowGraph } from '../domain/definition.js';
+export interface WorkflowAuthoringDraft {
+    id: string;
+    workflowName: string;
+    graph: WorkflowGraph;
+    manifest: WorkflowDefinitionManifest;
+    baseRevision: number;
+    createdAtMs: number;
+    updatedAtMs: number;
+}
+export interface SaveWorkflowAuthoringDraftInput {
+    id?: string;
+    workflowName: string;
+    graph: WorkflowGraph;
+    manifest?: WorkflowDefinitionManifest;
+    baseRevision?: number;
+    expectedUpdatedAtMs?: number;
+}
+export declare class WorkflowDraftStore {
+    private readonly draftsDir;
+    constructor(options?: {
+        userDir?: string;
+    });
+    list(workflowName?: string): WorkflowAuthoringDraft[];
+    get(id: string): WorkflowAuthoringDraft | null;
+    save(input: SaveWorkflowAuthoringDraftInput): WorkflowAuthoringDraft;
+    remove(id: string): boolean;
+    private readFile;
+}
+export declare class WorkflowDraftConflictError extends Error {
+    readonly currentUpdatedAtMs?: number;
+    constructor(currentUpdatedAtMs?: number);
+}

package/dist/src/workflows/authoring/workflow-draft-store.js

@@ -0,0 +1,74 @@
+import { defaultUserDir } from "../../agent/workflow/catalog.js";
+import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+//#region src/workflows/authoring/workflow-draft-store.ts
+var WorkflowDraftStore = class {
+	draftsDir;
+	constructor(options = {}) {
+		this.draftsDir = join(options.userDir ?? defaultUserDir(), ".drafts");
+	}
+	list(workflowName) {
+		if (!existsSync(this.draftsDir)) return [];
+		return readdirSync(this.draftsDir).filter((file) => file.endsWith(".json")).map((file) => this.readFile(join(this.draftsDir, file))).filter((draft) => Boolean(draft) && (!workflowName || draft.workflowName === workflowName)).sort((left, right) => right.updatedAtMs - left.updatedAtMs);
+	}
+	get(id) {
+		requireDraftId(id);
+		return this.readFile(join(this.draftsDir, `${id}.json`));
+	}
+	save(input) {
+		if (!input.graph || input.graph.schemaVersion !== 1 || !Array.isArray(input.graph.nodes) || !Array.isArray(input.graph.edges)) throw new Error("workflow draft graph is invalid");
+		const id = input.id ?? randomUUID();
+		requireDraftId(id);
+		const existing = this.get(id);
+		if (input.expectedUpdatedAtMs !== void 0 && input.expectedUpdatedAtMs !== existing?.updatedAtMs) throw new WorkflowDraftConflictError(existing?.updatedAtMs);
+		const now = Math.max(Date.now(), (existing?.updatedAtMs ?? 0) + 1);
+		const draft = {
+			id,
+			workflowName: input.workflowName.trim(),
+			graph: structuredClone(input.graph),
+			manifest: structuredClone(input.manifest ?? {}),
+			baseRevision: input.baseRevision ?? existing?.baseRevision ?? 0,
+			createdAtMs: existing?.createdAtMs ?? now,
+			updatedAtMs: now
+		};
+		if (!draft.workflowName) throw new Error("workflowName is required");
+		mkdirSync(this.draftsDir, { recursive: true });
+		writeJsonAtomic(join(this.draftsDir, `${id}.json`), draft);
+		return draft;
+	}
+	remove(id) {
+		requireDraftId(id);
+		const path = join(this.draftsDir, `${id}.json`);
+		if (!existsSync(path)) return false;
+		unlinkSync(path);
+		return true;
+	}
+	readFile(path) {
+		try {
+			const value = JSON.parse(readFileSync(path, "utf-8"));
+			return value && typeof value.id === "string" && value.graph?.schemaVersion === 1 ? value : null;
+		} catch {
+			return null;
+		}
+	}
+};
+var WorkflowDraftConflictError = class extends Error {
+	constructor(currentUpdatedAtMs) {
+		super("workflow draft was changed by another editor");
+		this.currentUpdatedAtMs = currentUpdatedAtMs;
+		this.name = "WorkflowDraftConflictError";
+	}
+};
+function requireDraftId(id) {
+	if (!/^[a-zA-Z0-9_-]+$/.test(id)) throw new Error("invalid workflow draft id");
+}
+function writeJsonAtomic(path, value) {
+	const temporaryPath = `${path}.${randomUUID()}.tmp`;
+	writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
+	renameSync(temporaryPath, path);
+}
+//#endregion
+export { WorkflowDraftConflictError, WorkflowDraftStore };
+
+//# sourceMappingURL=workflow-draft-store.js.map

package/dist/src/workflows/authoring/workflow-draft-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft-store.js","names":[],"sources":["../../../../src/workflows/authoring/workflow-draft-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { defaultUserDir } from '../../agent/workflow/catalog.js';\nimport type { WorkflowDefinitionManifest, WorkflowGraph } from '../domain/definition.js';\n\nexport interface WorkflowAuthoringDraft {\n  id: string;\n  workflowName: string;\n  graph: WorkflowGraph;\n  manifest: WorkflowDefinitionManifest;\n  baseRevision: number;\n  createdAtMs: number;\n  updatedAtMs: number;\n}\n\nexport interface SaveWorkflowAuthoringDraftInput {\n  id?: string;\n  workflowName: string;\n  graph: WorkflowGraph;\n  manifest?: WorkflowDefinitionManifest;\n  baseRevision?: number;\n  expectedUpdatedAtMs?: number;\n}\n\nexport class WorkflowDraftStore {\n  private readonly draftsDir: string;\n\n  constructor(options: { userDir?: string } = {}) {\n    this.draftsDir = join(options.userDir ?? defaultUserDir(), '.drafts');\n  }\n\n  list(workflowName?: string): WorkflowAuthoringDraft[] {\n    if (!existsSync(this.draftsDir)) return [];\n    return readdirSync(this.draftsDir)\n      .filter((file) => file.endsWith('.json'))\n      .map((file) => this.readFile(join(this.draftsDir, file)))\n      .filter((draft): draft is WorkflowAuthoringDraft => Boolean(draft) && (!workflowName || draft.workflowName === workflowName))\n      .sort((left, right) => right.updatedAtMs - left.updatedAtMs);\n  }\n\n  get(id: string): WorkflowAuthoringDraft | null {\n    requireDraftId(id);\n    return this.readFile(join(this.draftsDir, `${id}.json`));\n  }\n\n  save(input: SaveWorkflowAuthoringDraftInput): WorkflowAuthoringDraft {\n    if (!input.graph || input.graph.schemaVersion !== 1 || !Array.isArray(input.graph.nodes) || !Array.isArray(input.graph.edges)) {\n      throw new Error('workflow draft graph is invalid');\n    }\n    const id = input.id ?? randomUUID();\n    requireDraftId(id);\n    const existing = this.get(id);\n    if (input.expectedUpdatedAtMs !== undefined && input.expectedUpdatedAtMs !== existing?.updatedAtMs) {\n      throw new WorkflowDraftConflictError(existing?.updatedAtMs);\n    }\n    const now = Math.max(Date.now(), (existing?.updatedAtMs ?? 0) + 1);\n    const draft: WorkflowAuthoringDraft = {\n      id,\n      workflowName: input.workflowName.trim(),\n      graph: structuredClone(input.graph),\n      manifest: structuredClone(input.manifest ?? {}),\n      baseRevision: input.baseRevision ?? existing?.baseRevision ?? 0,\n      createdAtMs: existing?.createdAtMs ?? now,\n      updatedAtMs: now,\n    };\n    if (!draft.workflowName) throw new Error('workflowName is required');\n    mkdirSync(this.draftsDir, { recursive: true });\n    writeJsonAtomic(join(this.draftsDir, `${id}.json`), draft);\n    return draft;\n  }\n\n  remove(id: string): boolean {\n    requireDraftId(id);\n    const path = join(this.draftsDir, `${id}.json`);\n    if (!existsSync(path)) return false;\n    unlinkSync(path);\n    return true;\n  }\n\n  private readFile(path: string): WorkflowAuthoringDraft | null {\n    try {\n      const value = JSON.parse(readFileSync(path, 'utf-8')) as WorkflowAuthoringDraft;\n      return value && typeof value.id === 'string' && value.graph?.schemaVersion === 1 ? value : null;\n    } catch {\n      return null;\n    }\n  }\n}\n\nexport class WorkflowDraftConflictError extends Error {\n  constructor(readonly currentUpdatedAtMs?: number) {\n    super('workflow draft was changed by another editor');\n    this.name = 'WorkflowDraftConflictError';\n  }\n}\n\nfunction requireDraftId(id: string): void {\n  if (!/^[a-zA-Z0-9_-]+$/.test(id)) throw new Error('invalid workflow draft id');\n}\n\nfunction writeJsonAtomic(path: string, value: unknown): void {\n  const temporaryPath = `${path}.${randomUUID()}.tmp`;\n  writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\\n`, 'utf-8');\n  renameSync(temporaryPath, path);\n}\n"],"mappings":";;;;;AA0BA,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YAAY,UAAgC,EAAE,EAAE;AAC9C,OAAK,YAAY,KAAK,QAAQ,WAAW,gBAAgB,EAAE,UAAU;;CAGvE,KAAK,cAAiD;AACpD,MAAI,CAAC,WAAW,KAAK,UAAU,CAAE,QAAO,EAAE;AAC1C,SAAO,YAAY,KAAK,UAAU,CAC/B,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,CACxC,KAAK,SAAS,KAAK,SAAS,KAAK,KAAK,WAAW,KAAK,CAAC,CAAC,CACxD,QAAQ,UAA2C,QAAQ,MAAM,KAAK,CAAC,gBAAgB,MAAM,iBAAiB,cAAc,CAC5H,MAAM,MAAM,UAAU,MAAM,cAAc,KAAK,YAAY;;CAGhE,IAAI,IAA2C;AAC7C,iBAAe,GAAG;AAClB,SAAO,KAAK,SAAS,KAAK,KAAK,WAAW,GAAG,GAAG,OAAO,CAAC;;CAG1D,KAAK,OAAgE;AACnE,MAAI,CAAC,MAAM,SAAS,MAAM,MAAM,kBAAkB,KAAK,CAAC,MAAM,QAAQ,MAAM,MAAM,MAAM,IAAI,CAAC,MAAM,QAAQ,MAAM,MAAM,MAAM,CAC3H,OAAM,IAAI,MAAM,kCAAkC;EAEpD,MAAM,KAAK,MAAM,MAAM,YAAY;AACnC,iBAAe,GAAG;EAClB,MAAM,WAAW,KAAK,IAAI,GAAG;AAC7B,MAAI,MAAM,wBAAwB,KAAA,KAAa,MAAM,wBAAwB,UAAU,YACrF,OAAM,IAAI,2BAA2B,UAAU,YAAY;EAE7D,MAAM,MAAM,KAAK,IAAI,KAAK,KAAK,GAAG,UAAU,eAAe,KAAK,EAAE;EAClE,MAAM,QAAgC;GACpC;GACA,cAAc,MAAM,aAAa,MAAM;GACvC,OAAO,gBAAgB,MAAM,MAAM;GACnC,UAAU,gBAAgB,MAAM,YAAY,EAAE,CAAC;GAC/C,cAAc,MAAM,gBAAgB,UAAU,gBAAgB;GAC9D,aAAa,UAAU,eAAe;GACtC,aAAa;GACd;AACD,MAAI,CAAC,MAAM,aAAc,OAAM,IAAI,MAAM,2BAA2B;AACpE,YAAU,KAAK,WAAW,EAAE,WAAW,MAAM,CAAC;AAC9C,kBAAgB,KAAK,KAAK,WAAW,GAAG,GAAG,OAAO,EAAE,MAAM;AAC1D,SAAO;;CAGT,OAAO,IAAqB;AAC1B,iBAAe,GAAG;EAClB,MAAM,OAAO,KAAK,KAAK,WAAW,GAAG,GAAG,OAAO;AAC/C,MAAI,CAAC,WAAW,KAAK,CAAE,QAAO;AAC9B,aAAW,KAAK;AAChB,SAAO;;CAGT,SAAiB,MAA6C;AAC5D,MAAI;GACF,MAAM,QAAQ,KAAK,MAAM,aAAa,MAAM,QAAQ,CAAC;AACrD,UAAO,SAAS,OAAO,MAAM,OAAO,YAAY,MAAM,OAAO,kBAAkB,IAAI,QAAQ;UACrF;AACN,UAAO;;;;AAKb,IAAa,6BAAb,cAAgD,MAAM;CACpD,YAAY,oBAAsC;AAChD,QAAM,+CAA+C;AADlC,OAAA,qBAAA;AAEnB,OAAK,OAAO;;;AAIhB,SAAS,eAAe,IAAkB;AACxC,KAAI,CAAC,mBAAmB,KAAK,GAAG,CAAE,OAAM,IAAI,MAAM,4BAA4B;;AAGhF,SAAS,gBAAgB,MAAc,OAAsB;CAC3D,MAAM,gBAAgB,GAAG,KAAK,GAAG,YAAY,CAAC;AAC9C,eAAc,eAAe,GAAG,KAAK,UAAU,OAAO,MAAM,EAAE,CAAC,KAAK,QAAQ;AAC5E,YAAW,eAAe,KAAK"}

package/dist/src/workflows/domain/definition-utils.d.ts

@@ -1,16 +1,18 @@
-import type { WorkflowMeta } from '../../agent/workflow/types.js';
-import type { WorkflowDefinition, WorkflowDefinitionManifest } from './definition.js';
+import type { WorkflowDefinition, WorkflowDefinitionManifest, WorkflowGraph, WorkflowPhaseDefinition } from './definition.js';
 export declare const DEFAULT_WORKFLOW_CONCURRENCY = 4;
 export declare const DEFAULT_WORKFLOW_TIMEOUT_SEC: number;
 export declare const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;
 export interface WorkflowDefinitionBuildInput {
     name: string;
     source: 'builtin' | 'user';
-    script: string;
-    meta: WorkflowMeta;
+    graph: WorkflowGraph;
     manifest?: WorkflowDefinitionManifest;
+    phases?: WorkflowPhaseDefinition[];
+    revision?: number;
+    createdAtMs?: number;
 }
 export declare function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition;
+export declare function deriveWorkflowPhases(graph: WorkflowGraph): WorkflowPhaseDefinition[];
 export declare function hashWorkflowStableValue(value: unknown): string;
 export declare function normalizeWorkflowDefinitionId(value: string): string;
 export declare function toWorkflowDefinitionTitle(value: string): string;

package/dist/src/workflows/domain/definition-utils.js

@@ -5,66 +5,68 @@ const DEFAULT_WORKFLOW_TIMEOUT_SEC = 1800;
 const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;
 function buildWorkflowDefinition(input) {
 	const nowMs = Date.now();
-	const phases = input.meta.phases?.map((phase, index) => ({
-		id: normalizeWorkflowDefinitionId(phase.title) || `phase-${index + 1}`,
-		title: phase.title,
-		description: phase.detail
-	})) ?? [];
 	const manifest = input.manifest;
 	const manifestDefaults = manifest?.defaults ?? {};
-	const runtimeHash = hashWorkflowStableValue(input.script);
+	const phases = input.phases ?? deriveWorkflowPhases(input.graph);
+	const graphHash = hashWorkflowStableValue(input.graph);
 	const base = {
 		id: input.name,
 		name: input.name,
 		title: manifest?.title ?? toWorkflowDefinitionTitle(input.name),
-		description: manifest?.description ?? input.meta.description,
+		description: manifest?.description ?? "",
 		version: manifest?.version ?? "1.0.0",
+		revision: input.revision ?? 1,
 		inputSchema: manifest?.inputSchema,
 		outputSchema: manifest?.outputSchema,
 		phases,
-		runtime: {
-			kind: "script",
-			source: input.script
-		},
+		graph: structuredClone(input.graph),
 		defaults: {
 			concurrency: normalizePositiveInt(manifestDefaults.concurrency, 4),
 			timeoutSec: normalizePositiveInt(manifestDefaults.timeoutSec, DEFAULT_WORKFLOW_TIMEOUT_SEC),
-			maxSubagents: normalizePositiveInt(manifestDefaults.maxSubagents, input.meta.estimatedAgents?.max ?? 100)
+			maxSubagents: normalizePositiveInt(manifestDefaults.maxSubagents, 100)
 		},
 		permissions: manifest?.permissions,
 		resources: manifest?.resources,
+		connectors: manifest?.connectors,
 		metadata: {
-			tags: manifest?.tags ?? input.meta.tags ?? [],
+			tags: manifest?.tags ?? [],
 			builtIn: input.source === "builtin",
 			source: input.source,
-			whenToUse: manifest?.whenToUse ?? input.meta.whenToUse,
-			estimatedAgents: input.meta.estimatedAgents,
-			examplePrompts: input.meta.examplePrompts,
-			i18n: input.meta.i18n,
-			createdAtMs: nowMs,
+			whenToUse: manifest?.whenToUse,
+			estimatedAgents: manifest?.estimatedAgents,
+			examplePrompts: manifest?.examplePrompts,
+			i18n: manifest?.i18n,
+			createdAtMs: input.createdAtMs ?? nowMs,
 			updatedAtMs: nowMs
 		}
 	};
 	return {
 		...base,
-		runtimeHash,
 		contentHash: hashWorkflowStableValue({
-			id: base.id,
 			name: base.name,
 			title: base.title,
 			description: base.description,
 			version: base.version,
-			inputSchema: base.inputSchema,
-			outputSchema: base.outputSchema,
-			phases: base.phases,
-			runtimeHash,
+			revision: base.revision,
+			graphHash,
 			defaults: base.defaults,
 			permissions: base.permissions,
 			resources: base.resources,
-			tags: base.metadata.tags
+			connectors: base.connectors
 		})
 	};
 }
+function deriveWorkflowPhases(graph) {
+	const phases = /* @__PURE__ */ new Map();
+	for (const node of graph.nodes) {
+		if (!node.phaseId || phases.has(node.phaseId)) continue;
+		phases.set(node.phaseId, {
+			id: node.phaseId,
+			title: toWorkflowDefinitionTitle(node.phaseId)
+		});
+	}
+	return [...phases.values()];
+}
 function hashWorkflowStableValue(value) {
 	return createHash("sha256").update(stableStringify(value)).digest("hex");
 }
@@ -85,6 +87,6 @@ function toWorkflowDefinitionTitle(value) {
 	return value.split(/[_-]+/g).filter(Boolean).map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
 }
 //#endregion
-export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle };
+export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, deriveWorkflowPhases, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle };
 
 //# sourceMappingURL=definition-utils.js.map

package/dist/src/workflows/domain/definition-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition-utils.js","names":[],"sources":["../../../../src/workflows/domain/definition-utils.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport type { WorkflowMeta } from '../../agent/workflow/types.js';\n\nimport type { WorkflowDefinition, WorkflowDefinitionManifest } from './definition.js';\n\nexport const DEFAULT_WORKFLOW_CONCURRENCY = 4;\nexport const DEFAULT_WORKFLOW_TIMEOUT_SEC = 30 * 60;\nexport const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;\n\nexport interface WorkflowDefinitionBuildInput {\n  name: string;\n  source: 'builtin' | 'user';\n  script: string;\n  meta: WorkflowMeta;\n  manifest?: WorkflowDefinitionManifest;\n}\n\nexport function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition {\n  const nowMs = Date.now();\n  const phases = input.meta.phases?.map((phase, index) => ({\n    id: normalizeWorkflowDefinitionId(phase.title) || `phase-${index + 1}`,\n    title: phase.title,\n    description: phase.detail,\n  })) ?? [];\n\n  const manifest = input.manifest;\n  const manifestDefaults = manifest?.defaults ?? {};\n\n  const runtimeHash = hashWorkflowStableValue(input.script);\n  const base = {\n    id: input.name,\n    name: input.name,\n    title: manifest?.title ?? toWorkflowDefinitionTitle(input.name),\n    description: manifest?.description ?? input.meta.description,\n    version: manifest?.version ?? '1.0.0',\n    inputSchema: manifest?.inputSchema,\n    outputSchema: manifest?.outputSchema,\n    phases,\n    runtime: {\n      kind: 'script' as const,\n      source: input.script,\n    },\n    defaults: {\n      concurrency: normalizePositiveInt(manifestDefaults.concurrency, DEFAULT_WORKFLOW_CONCURRENCY),\n      timeoutSec: normalizePositiveInt(manifestDefaults.timeoutSec, DEFAULT_WORKFLOW_TIMEOUT_SEC),\n      maxSubagents: normalizePositiveInt(\n        manifestDefaults.maxSubagents,\n        input.meta.estimatedAgents?.max ?? DEFAULT_WORKFLOW_MAX_SUBAGENTS,\n      ),\n    },\n    permissions: manifest?.permissions,\n    resources: manifest?.resources,\n    metadata: {\n      tags: manifest?.tags ?? input.meta.tags ?? [],\n      builtIn: input.source === 'builtin',\n      source: input.source,\n      whenToUse: manifest?.whenToUse ?? input.meta.whenToUse,\n      estimatedAgents: input.meta.estimatedAgents,\n      examplePrompts: input.meta.examplePrompts,\n      i18n: input.meta.i18n,\n      createdAtMs: nowMs,\n      updatedAtMs: nowMs,\n    },\n  };\n\n  return {\n    ...base,\n    runtimeHash,\n    contentHash: hashWorkflowStableValue({\n      id: base.id,\n      name: base.name,\n      title: base.title,\n      description: base.description,\n      version: base.version,\n      inputSchema: base.inputSchema,\n      outputSchema: base.outputSchema,\n      phases: base.phases,\n      runtimeHash,\n      defaults: base.defaults,\n      permissions: base.permissions,\n      resources: base.resources,\n      tags: base.metadata.tags,\n    }),\n  };\n}\n\nexport function hashWorkflowStableValue(value: unknown): string {\n  return createHash('sha256').update(stableStringify(value)).digest('hex');\n}\n\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value);\n  if (Array.isArray(value)) return `[${value.map((item) => stableStringify(item)).join(',')}]`;\n  const record = value as Record<string, unknown>;\n  return `{${Object.keys(record)\n    .filter((key) => record[key] !== undefined)\n    .sort()\n    .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)\n    .join(',')}}`;\n}\n\nfunction normalizePositiveInt(value: number | undefined, fallback: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) {\n    return fallback;\n  }\n  return Math.floor(value);\n}\n\nexport function normalizeWorkflowDefinitionId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nexport function toWorkflowDefinitionTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":"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"}
+{"version":3,"file":"definition-utils.js","names":[],"sources":["../../../../src/workflows/domain/definition-utils.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport type {\n  WorkflowDefinition,\n  WorkflowDefinitionManifest,\n  WorkflowGraph,\n  WorkflowPhaseDefinition,\n} from './definition.js';\n\nexport const DEFAULT_WORKFLOW_CONCURRENCY = 4;\nexport const DEFAULT_WORKFLOW_TIMEOUT_SEC = 30 * 60;\nexport const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;\n\nexport interface WorkflowDefinitionBuildInput {\n  name: string;\n  source: 'builtin' | 'user';\n  graph: WorkflowGraph;\n  manifest?: WorkflowDefinitionManifest;\n  phases?: WorkflowPhaseDefinition[];\n  revision?: number;\n  createdAtMs?: number;\n}\n\nexport function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition {\n  const nowMs = Date.now();\n  const manifest = input.manifest;\n  const manifestDefaults = manifest?.defaults ?? {};\n  const phases = input.phases ?? deriveWorkflowPhases(input.graph);\n  const graphHash = hashWorkflowStableValue(input.graph);\n  const base = {\n    id: input.name,\n    name: input.name,\n    title: manifest?.title ?? toWorkflowDefinitionTitle(input.name),\n    description: manifest?.description ?? '',\n    version: manifest?.version ?? '1.0.0',\n    revision: input.revision ?? 1,\n    inputSchema: manifest?.inputSchema,\n    outputSchema: manifest?.outputSchema,\n    phases,\n    graph: structuredClone(input.graph),\n    defaults: {\n      concurrency: normalizePositiveInt(manifestDefaults.concurrency, DEFAULT_WORKFLOW_CONCURRENCY),\n      timeoutSec: normalizePositiveInt(manifestDefaults.timeoutSec, DEFAULT_WORKFLOW_TIMEOUT_SEC),\n      maxSubagents: normalizePositiveInt(manifestDefaults.maxSubagents, DEFAULT_WORKFLOW_MAX_SUBAGENTS),\n    },\n    permissions: manifest?.permissions,\n    resources: manifest?.resources,\n    connectors: manifest?.connectors,\n    metadata: {\n      tags: manifest?.tags ?? [],\n      builtIn: input.source === 'builtin',\n      source: input.source,\n      whenToUse: manifest?.whenToUse,\n      estimatedAgents: manifest?.estimatedAgents,\n      examplePrompts: manifest?.examplePrompts,\n      i18n: manifest?.i18n,\n      createdAtMs: input.createdAtMs ?? nowMs,\n      updatedAtMs: nowMs,\n    },\n  } satisfies Omit<WorkflowDefinition, 'contentHash'>;\n\n  return {\n    ...base,\n    contentHash: hashWorkflowStableValue({\n      name: base.name,\n      title: base.title,\n      description: base.description,\n      version: base.version,\n      revision: base.revision,\n      graphHash,\n      defaults: base.defaults,\n      permissions: base.permissions,\n      resources: base.resources,\n      connectors: base.connectors,\n    }),\n  };\n}\n\nexport function deriveWorkflowPhases(graph: WorkflowGraph): WorkflowPhaseDefinition[] {\n  const phases = new Map<string, WorkflowPhaseDefinition>();\n  for (const node of graph.nodes) {\n    if (!node.phaseId || phases.has(node.phaseId)) continue;\n    phases.set(node.phaseId, {\n      id: node.phaseId,\n      title: toWorkflowDefinitionTitle(node.phaseId),\n    });\n  }\n  return [...phases.values()];\n}\n\nexport function hashWorkflowStableValue(value: unknown): string {\n  return createHash('sha256').update(stableStringify(value)).digest('hex');\n}\n\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value);\n  if (Array.isArray(value)) return `[${value.map((item) => stableStringify(item)).join(',')}]`;\n  const record = value as Record<string, unknown>;\n  return `{${Object.keys(record)\n    .filter((key) => record[key] !== undefined)\n    .sort()\n    .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)\n    .join(',')}}`;\n}\n\nfunction normalizePositiveInt(value: number | undefined, fallback: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 1) return fallback;\n  return Math.floor(value);\n}\n\nexport function normalizeWorkflowDefinitionId(value: string): string {\n  return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');\n}\n\nexport function toWorkflowDefinitionTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":"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"}

package/dist/src/workflows/domain/definition.d.ts

@@ -9,21 +9,87 @@ export interface JsonSchema {
     description?: string;
     [key: string]: unknown;
 }
+export type WorkflowNodeKind = 'input' | 'agent' | 'decision' | 'merge' | 'output';
+export interface WorkflowCanvasPosition {
+    x: number;
+    y: number;
+}
+export interface WorkflowGraphNodeBase {
+    id: string;
+    kind: WorkflowNodeKind;
+    title: string;
+    description?: string;
+    phaseId?: string;
+    position: WorkflowCanvasPosition;
+}
+export interface WorkflowInputNode extends WorkflowGraphNodeBase {
+    kind: 'input';
+    config: {
+        schema?: JsonSchema;
+    };
+}
+export interface WorkflowAgentNode extends WorkflowGraphNodeBase {
+    kind: 'agent';
+    config: {
+        prompt: string;
+        model?: string;
+        toolset?: string[];
+        maxIterations?: number;
+        outputSchema?: JsonSchema;
+    };
+}
+export interface WorkflowDecisionRule {
+    path: string;
+    operator: 'exists' | 'equals' | 'not_equals' | 'contains';
+    value?: unknown;
+}
+export interface WorkflowDecisionNode extends WorkflowGraphNodeBase {
+    kind: 'decision';
+    config: {
+        rule: WorkflowDecisionRule;
+    };
+}
+export interface WorkflowMergeNode extends WorkflowGraphNodeBase {
+    kind: 'merge';
+    config: {
+        mode: 'array' | 'object';
+    };
+}
+export interface WorkflowOutputNode extends WorkflowGraphNodeBase {
+    kind: 'output';
+    config: {
+        summary?: string;
+        title?: string;
+    };
+}
+export type WorkflowGraphNode = WorkflowInputNode | WorkflowAgentNode | WorkflowDecisionNode | WorkflowMergeNode | WorkflowOutputNode;
+export interface WorkflowGraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    sourcePort?: 'true' | 'false' | 'default';
+}
+export interface WorkflowGraph {
+    schemaVersion: 1;
+    nodes: WorkflowGraphNode[];
+    edges: WorkflowGraphEdge[];
+}
 export interface WorkflowDefinition {
     id: string;
     name: string;
     title: string;
     description: string;
     version: string;
+    revision: number;
     contentHash?: string;
-    runtimeHash?: string;
     inputSchema?: JsonSchema;
     outputSchema?: JsonSchema;
     phases: WorkflowPhaseDefinition[];
-    runtime: WorkflowRuntimeDefinition;
+    graph: WorkflowGraph;
     defaults: WorkflowDefinitionDefaults;
     permissions?: WorkflowPermissionPolicy;
     resources?: WorkflowResourceRefs;
+    connectors?: WorkflowConnectorRequirement[];
     metadata: WorkflowDefinitionMetadata;
 }
 export interface WorkflowDefinitionManifest {
@@ -35,8 +101,19 @@ export interface WorkflowDefinitionManifest {
     defaults?: Partial<WorkflowDefinitionDefaults>;
     tags?: string[];
     whenToUse?: string;
+    estimatedAgents?: WorkflowDefinitionEstimatedAgents;
+    examplePrompts?: WorkflowDefinitionExamplePrompt[];
+    i18n?: Record<string, WorkflowDefinitionLocale>;
     permissions?: WorkflowPermissionPolicy;
     resources?: WorkflowResourceRefs;
+    connectors?: WorkflowConnectorRequirement[];
+}
+export interface WorkflowConnectorRequirement {
+    connectorId: string;
+    scope?: 'read' | 'write' | 'admin';
+    connectionRequired?: boolean;
+    optional?: boolean;
+    reason?: string;
 }
 export interface WorkflowPermissionPolicy {
     tools?: string[];
@@ -54,10 +131,6 @@ export interface WorkflowPhaseDefinition {
     title: string;
     description?: string;
 }
-export interface WorkflowRuntimeDefinition {
-    kind: 'script';
-    source: string;
-}
 export interface WorkflowDefinitionDefaults {
     concurrency: number;
     timeoutSec: number;

package/dist/src/workflows/domain/event.d.ts

@@ -1,6 +1,6 @@
 import type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';
 import type { WorkflowAgentInvocationSnapshot, WorkflowRun, WorkflowRunError } from './run.js';
-export type WorkflowEventType = 'run_queued' | 'run_started' | 'phase_started' | 'phase_completed' | 'agent_queued' | 'agent_started' | 'agent_step_started' | 'agent_step_completed' | 'agent_completed' | 'log_appended' | 'artifact_created' | 'run_completed' | 'run_failed' | 'run_cancelled';
+export type WorkflowEventType = 'run_queued' | 'run_started' | 'phase_started' | 'phase_completed' | 'node_started' | 'node_completed' | 'agent_queued' | 'agent_started' | 'agent_step_started' | 'agent_step_completed' | 'agent_completed' | 'log_appended' | 'artifact_created' | 'run_completed' | 'run_failed' | 'run_cancelled';
 export interface WorkflowEventEnvelope<T = WorkflowEventPayload> {
     id: string;
     runId: string;
@@ -9,7 +9,7 @@ export interface WorkflowEventEnvelope<T = WorkflowEventPayload> {
     payload: T;
     createdAtMs: number;
 }
-export type WorkflowEventPayload = RunQueuedPayload | RunStartedPayload | PhaseStartedPayload | PhaseCompletedPayload | AgentQueuedPayload | AgentStartedPayload | AgentStepStartedPayload | AgentStepCompletedPayload | AgentCompletedPayload | LogAppendedPayload | ArtifactCreatedPayload | RunCompletedPayload | RunFailedPayload | RunCancelledPayload;
+export type WorkflowEventPayload = RunQueuedPayload | RunStartedPayload | PhaseStartedPayload | PhaseCompletedPayload | NodeStartedPayload | NodeCompletedPayload | AgentQueuedPayload | AgentStartedPayload | AgentStepStartedPayload | AgentStepCompletedPayload | AgentCompletedPayload | LogAppendedPayload | ArtifactCreatedPayload | RunCompletedPayload | RunFailedPayload | RunCancelledPayload;
 export interface RunQueuedPayload {
     run: WorkflowRun;
 }
@@ -23,8 +23,22 @@ export interface PhaseStartedPayload {
 export interface PhaseCompletedPayload {
     phaseId: string;
 }
+export interface NodeStartedPayload {
+    nodeId: string;
+    kind: string;
+    title: string;
+}
+export interface NodeCompletedPayload {
+    nodeId: string;
+    kind: string;
+    title: string;
+    status: 'done' | 'error' | 'skipped';
+    resultPreview?: string;
+    error?: string;
+}
 export interface AgentQueuedPayload {
     agentId: string;
+    nodeId: string;
     label: string;
     phaseId?: string;
     prompt?: string;
@@ -33,6 +47,7 @@ export interface AgentQueuedPayload {
 }
 export interface AgentStartedPayload {
     agentId: string;
+    nodeId?: string;
 }
 export interface AgentStepStartedPayload {
     agentId: string;
@@ -51,6 +66,7 @@ export interface AgentStepCompletedPayload {
 }
 export interface AgentCompletedPayload {
     agentId: string;
+    nodeId?: string;
     status: 'done' | 'error' | 'skipped';
     resultPreview?: string;
     error?: string;

package/dist/src/workflows/domain/index.js

@@ -1,5 +1,5 @@
-import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./definition-utils.js";
+import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, deriveWorkflowPhases, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./definition-utils.js";
+import { validateWorkflowDefinitionInput, validateWorkflowGraph } from "./validation.js";
 import { validateWorkflowJsonSchema } from "./schema-validation.js";
 import { isTerminalWorkflowRunStatus } from "./run.js";
-import { validateWorkflowDefinitionInput } from "./validation.js";
-export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, hashWorkflowStableValue, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput, validateWorkflowJsonSchema };
+export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, deriveWorkflowPhases, hashWorkflowStableValue, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput, validateWorkflowGraph, validateWorkflowJsonSchema };

package/dist/src/workflows/domain/run.d.ts

@@ -1,4 +1,4 @@
-import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';
+import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowGraph, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';
 import type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';
 export type WorkflowRunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'timeout';
 export declare function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean;
@@ -91,7 +91,8 @@ export interface WorkflowRunDefinitionSnapshot {
     title: string;
     version: string;
     contentHash?: string;
-    runtimeHash?: string;
+    revision: number;
+    graph: WorkflowGraph;
     source: 'builtin' | 'user';
     tags: string[];
     phaseCount: number;
@@ -160,11 +161,22 @@ export interface WorkflowRunView {
     run: WorkflowRun;
     phases: WorkflowPhaseView[];
     agents: WorkflowAgentView[];
+    nodes: WorkflowNodeView[];
     logs: WorkflowLogEntry[];
     artifacts: WorkflowArtifactRef[];
     timeline: WorkflowTimelineItem[];
     controls: WorkflowRunControls;
 }
+export interface WorkflowNodeView {
+    id: string;
+    kind: string;
+    title: string;
+    status: 'pending' | 'running' | 'done' | 'error' | 'skipped';
+    resultPreview?: string;
+    error?: string;
+    startedAtMs?: number;
+    completedAtMs?: number;
+}
 export type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';
 export interface WorkflowPhaseView {
     id: string;
@@ -177,6 +189,7 @@ export interface WorkflowPhaseView {
 export type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';
 export interface WorkflowAgentView {
     id: string;
+    nodeId?: string;
     label: string;
     phaseId?: string;
     status: WorkflowAgentStatus;
@@ -192,6 +205,7 @@ export interface WorkflowAgentView {
     steps: WorkflowAgentStepView[];
 }
 export interface WorkflowAgentInvocationSnapshot {
+    nodeId?: string;
     prompt: string;
     label: string;
     phase?: string;

package/dist/src/workflows/domain/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  projectId?: string;\n  workItemId?: string;\n  contextRefs?: WorkflowRunContextRef[];\n  writebackPolicy?: WorkflowRunWritebackPolicy;\n  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n  goalId?: string;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\n\nexport interface WorkflowRunContextRef {\n  kind: 'project' | 'goal' | 'work_item' | 'session' | 'attachment' | 'memory';\n  id: string;\n  role?: string;\n  title?: string;\n}\n\nexport interface WorkflowRunWritebackPolicy {\n  targets: WorkflowRunWritebackTarget[];\n}\n\nexport interface WorkflowRunWritebackTarget {\n  kind: 'project' | 'goal' | 'work_item';\n  id: string;\n  mode: 'record' | 'suggest' | 'evaluate';\n}\n\nexport interface WorkflowRunReplayMetadata {\n  sourceRunId: string;\n  scope: WorkflowRunReplayScope;\n  phaseIds?: string[];\n  agentIds: string[];\n  targetCount: number;\n  createdAtMs: number;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  automationId?: string;\n  runId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  automationId: string;\n  runId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  contentHash?: string;\n  runtimeHash?: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  defaults?: WorkflowDefinitionDefaults;\n  permissions?: WorkflowPermissionPolicy;\n  resources?: WorkflowResourceRefs;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'automation'; automationId: string; runId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport interface WorkflowAgentInvocationSnapshot {\n  prompt: string;\n  label: string;\n  phase?: string;\n  modelRef?: string;\n  resolvedModelRef?: string;\n  schema?: unknown;\n  toolset?: string[];\n  maxIterations?: number;\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}
+{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowGraph, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  projectId?: string;\n  workItemId?: string;\n  contextRefs?: WorkflowRunContextRef[];\n  writebackPolicy?: WorkflowRunWritebackPolicy;\n  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n  goalId?: string;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\n\nexport interface WorkflowRunContextRef {\n  kind: 'project' | 'goal' | 'work_item' | 'session' | 'attachment' | 'memory';\n  id: string;\n  role?: string;\n  title?: string;\n}\n\nexport interface WorkflowRunWritebackPolicy {\n  targets: WorkflowRunWritebackTarget[];\n}\n\nexport interface WorkflowRunWritebackTarget {\n  kind: 'project' | 'goal' | 'work_item';\n  id: string;\n  mode: 'record' | 'suggest' | 'evaluate';\n}\n\nexport interface WorkflowRunReplayMetadata {\n  sourceRunId: string;\n  scope: WorkflowRunReplayScope;\n  phaseIds?: string[];\n  agentIds: string[];\n  targetCount: number;\n  createdAtMs: number;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  automationId?: string;\n  runId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  automationId: string;\n  runId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  contentHash?: string;\n  revision: number;\n  graph: WorkflowGraph;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  defaults?: WorkflowDefinitionDefaults;\n  permissions?: WorkflowPermissionPolicy;\n  resources?: WorkflowResourceRefs;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'automation'; automationId: string; runId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  nodes: WorkflowNodeView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport interface WorkflowNodeView {\n  id: string;\n  kind: string;\n  title: string;\n  status: 'pending' | 'running' | 'done' | 'error' | 'skipped';\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  nodeId?: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport interface WorkflowAgentInvocationSnapshot {\n  nodeId?: string;\n  prompt: string;\n  label: string;\n  phase?: string;\n  modelRef?: string;\n  resolvedModelRef?: string;\n  schema?: unknown;\n  toolset?: string[];\n  maxIterations?: number;\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}

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

@@ -1,10 +1,11 @@
-import type { WorkflowDefinition } from './definition.js';
-export type WorkflowDefinitionValidationIssueCode = 'name_required' | 'script_required' | 'parse_failed' | 'meta_name_mismatch' | 'unknown_error';
+import type { WorkflowDefinition, WorkflowGraph } from './definition.js';
+export type WorkflowDefinitionValidationIssueCode = 'name_required' | 'invalid_name' | 'graph_required' | 'invalid_schema_version' | 'duplicate_node' | 'missing_input' | 'multiple_inputs' | 'missing_output' | 'multiple_outputs' | 'unknown_edge_node' | 'duplicate_edge' | 'self_edge' | 'cycle_detected' | 'unreachable_node' | 'dead_end_node' | 'missing_prompt' | 'invalid_node_config';
 export interface WorkflowDefinitionValidationIssue {
     code: WorkflowDefinitionValidationIssueCode;
     message: string;
-    line?: number;
-    column?: number;
+    nodeId?: string;
+    edgeId?: string;
+    field?: string;
 }
 export interface WorkflowDefinitionValidationResult {
     valid: boolean;
@@ -14,6 +15,9 @@ export interface WorkflowDefinitionValidationResult {
 }
 export interface ValidateWorkflowDefinitionInput {
     name?: string;
-    script?: string;
+    graph?: WorkflowGraph;
+    title?: string;
+    description?: string;
 }
 export declare function validateWorkflowDefinitionInput(input: ValidateWorkflowDefinitionInput): WorkflowDefinitionValidationResult;
+export declare function validateWorkflowGraph(graph: WorkflowGraph, errors?: WorkflowDefinitionValidationIssue[], warnings?: WorkflowDefinitionValidationIssue[]): WorkflowDefinitionValidationResult;