@xopcai/xopc 0.0.142 → 0.0.144

package/dist/src/agent/workflow/builtins/index.js

@@ -1,93 +1,278 @@
-import { AUDIT_REPO_SCRIPT } from "./audit-repo.js";
-import { CLIENT_PROPOSAL_SCRIPT } from "./client-proposal.js";
-import { COMPETITOR_SCAN_SCRIPT } from "./competitor-scan.js";
-import { CONTENT_DRAFT_SCRIPT } from "./content-draft.js";
-import { CONTENT_REPURPOSE_SCRIPT } from "./content-repurpose.js";
-import { DEBUG_INCIDENT_SCRIPT } from "./debug-incident.js";
-import { DECISION_COMPARE_SCRIPT } from "./decision-compare.js";
-import { IMPLEMENTATION_PLAN_SCRIPT } from "./implementation-plan.js";
-import { INBOX_TRIAGE_SCRIPT } from "./inbox-triage.js";
-import { MEETING_PREP_SCRIPT } from "./meeting-prep.js";
-import { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from "./multi-perspective-review.js";
-import { OFFER_DESIGN_SCRIPT } from "./offer-design.js";
-import { PR_REVIEW_SCRIPT } from "./pr-review.js";
-import { RELEASE_CHECK_SCRIPT } from "./release-check.js";
-import { RESEARCH_SCRIPT } from "./research.js";
-import { WEEKLY_REVIEW_SCRIPT } from "./weekly-review.js";
+import { buildWorkflowDefinition } from "../../../workflows/domain/definition-utils.js";
 //#region src/agent/workflow/builtins/index.ts
-/**
-* Bundled workflow templates. These are shipped with xopc and discoverable
-* via the catalog alongside user workflows in `~/.xopc/workflows/`. A user
-* workflow with the same `name` always wins — built-ins are starting points,
-* not authority.
-*/
-const BUILTIN_WORKFLOWS = Object.freeze([
+const BUILTIN_SPECS = [
 	{
 		name: "audit_repo",
-		script: AUDIT_REPO_SCRIPT
+		description: "Audit a repository across architecture, quality, security, and operations, then produce a prioritized report.",
+		whenToUse: "Use for a thorough review of a repository or major subsystem.",
+		tags: ["code-review", "audit"],
+		perspectives: perspectives("Architecture and boundaries", "Correctness and maintainability", "Security and operations")
 	},
 	{
 		name: "client_proposal",
-		script: CLIENT_PROPOSAL_SCRIPT
+		description: "Turn a client brief into a clear proposal covering scope, delivery, pricing logic, and risks.",
+		whenToUse: "Use when preparing a client-ready proposal or statement of work.",
+		tags: [
+			"writing",
+			"content",
+			"document"
+		],
+		perspectives: perspectives("Client goals and value", "Scope and delivery plan", "Commercial terms and risks")
 	},
 	{
 		name: "competitor_scan",
-		script: COMPETITOR_SCAN_SCRIPT
+		description: "Compare competitors and identify positioning, pricing, and differentiation opportunities.",
+		whenToUse: "Use before positioning, pricing, or go-to-market decisions.",
+		tags: ["research", "investigation"],
+		perspectives: perspectives("Product and audience", "Pricing and distribution", "Differentiation and gaps")
 	},
 	{
 		name: "content_draft",
-		script: CONTENT_DRAFT_SCRIPT
+		description: "Draft polished content from multiple audience and tone perspectives, then select the strongest version.",
+		whenToUse: "Use for emails, posts, announcements, documentation, or other non-code writing.",
+		tags: [
+			"writing",
+			"content",
+			"communication"
+		],
+		perspectives: perspectives("Audience clarity", "Narrative and tone", "Conversion and call to action")
 	},
 	{
 		name: "content_repurpose",
-		script: CONTENT_REPURPOSE_SCRIPT
+		description: "Turn one source into channel-specific content without losing the core message.",
+		whenToUse: "Use when adapting existing material for multiple platforms.",
+		tags: ["writing", "content"],
+		perspectives: perspectives("Short social format", "Professional long-form format", "Video or newsletter format")
 	},
 	{
 		name: "debug_incident",
-		script: DEBUG_INCIDENT_SCRIPT
+		description: "Triage an incident using independent hypotheses and produce ranked causes and verification steps.",
+		whenToUse: "Use for bugs, crashes, error messages, and unexpected behavior.",
+		tags: [
+			"debug",
+			"incident",
+			"troubleshooting"
+		],
+		perspectives: perspectives("Application behavior", "Data and dependencies", "Infrastructure and observability")
 	},
 	{
 		name: "decision_compare",
-		script: DECISION_COMPARE_SCRIPT
+		description: "Compare options through independent criteria and recommend with explicit trade-offs.",
+		whenToUse: "Use for decisions with multiple viable choices.",
+		tags: [
+			"decision-making",
+			"comparison",
+			"productivity"
+		],
+		perspectives: perspectives("Benefits and upside", "Risks and hidden cost", "Fit with constraints")
 	},
 	{
 		name: "implementation_plan",
-		script: IMPLEMENTATION_PLAN_SCRIPT
+		description: "Convert a feature, refactor, or bugfix request into an actionable implementation plan.",
+		whenToUse: "Use before multi-file or unfamiliar code changes.",
+		tags: [
+			"planning",
+			"implementation",
+			"architecture"
+		],
+		perspectives: perspectives("Existing architecture", "Implementation sequence", "Testing and rollout risks")
 	},
 	{
 		name: "inbox_triage",
-		script: INBOX_TRIAGE_SCRIPT
+		description: "Sort messy inbox input into do, delegate, defer, and drop with clear priorities.",
+		whenToUse: "Use to plan a day from mixed messages and tasks.",
+		tags: ["productivity", "brainstorm"],
+		perspectives: perspectives("Urgency and impact", "Delegation and automation", "Scheduling and elimination")
 	},
 	{
 		name: "meeting_prep",
-		script: MEETING_PREP_SCRIPT
+		description: "Build meeting context, a focused agenda, and prioritized talking points.",
+		whenToUse: "Use before an important meeting.",
+		tags: ["meeting", "productivity"],
+		perspectives: perspectives("Context and stakeholders", "Agenda and decisions", "Questions and key messages")
 	},
 	{
 		name: "multi_perspective_review",
-		script: MULTI_PERSPECTIVE_REVIEW_SCRIPT
+		description: "Stress-test a target from user, operator, and maintainer perspectives.",
+		whenToUse: "Use before committing to a design, plan, pull request, or proposal.",
+		tags: [
+			"review",
+			"planning",
+			"decision"
+		],
+		perspectives: perspectives("User experience and accessibility", "Operational failure modes", "Maintainability and hidden assumptions")
 	},
 	{
 		name: "offer_design",
-		script: OFFER_DESIGN_SCRIPT
+		description: "Package expertise into sellable offers with tiers, pricing, boundaries, and positioning.",
+		whenToUse: "Use when productizing a service or subscription.",
+		tags: ["planning", "architecture"],
+		perspectives: perspectives("Customer problem and outcome", "Packaging and delivery boundaries", "Pricing and positioning")
 	},
 	{
 		name: "pr_review",
-		script: PR_REVIEW_SCRIPT
+		description: "Review a change set with focused reviewers and produce a ship or block verdict.",
+		whenToUse: "Use for a pull request, diff, or commit range.",
+		tags: ["code-review", "pr"],
+		perspectives: perspectives("Correctness and regressions", "Security and performance", "Tests and maintainability")
 	},
 	{
 		name: "release_check",
-		script: RELEASE_CHECK_SCRIPT
+		description: "Assess release readiness through parallel risk checks and a go or no-go verdict.",
+		whenToUse: "Use before shipping a completed change.",
+		tags: [
+			"release",
+			"quality",
+			"validation"
+		],
+		perspectives: perspectives("Product behavior", "Quality and regression risk", "Operations and rollback")
 	},
 	{
 		name: "research",
-		script: RESEARCH_SCRIPT
+		description: "Research a question from multiple angles and produce a source-conscious synthesis.",
+		whenToUse: "Use for non-trivial questions that benefit from independent investigation.",
+		tags: ["research", "investigation"],
+		perspectives: perspectives("Primary evidence and facts", "Alternative explanations", "Practical implications")
 	},
 	{
 		name: "weekly_review",
-		script: WEEKLY_REVIEW_SCRIPT
+		description: "Review the week and produce a short, prioritized action plan for next week.",
+		whenToUse: "Use for a weekly retrospective and planning session.",
+		tags: ["productivity", "brainstorm"],
+		perspectives: perspectives("Outcomes and progress", "Friction and unfinished work", "Priorities and capacity")
 	}
-]);
+];
+const BUILTIN_WORKFLOWS = Object.freeze(BUILTIN_SPECS.map((spec) => createBuiltinWorkflow(spec)));
+function createBuiltinWorkflow(spec) {
+	const graph = createParallelGraph(spec);
+	const estimatedAgents = {
+		min: spec.perspectives.length + 1,
+		max: spec.perspectives.length + 1
+	};
+	return buildWorkflowDefinition({
+		name: spec.name,
+		source: "builtin",
+		graph,
+		manifest: {
+			description: spec.description,
+			whenToUse: spec.whenToUse,
+			tags: spec.tags,
+			estimatedAgents,
+			inputSchema: {
+				type: "object",
+				additionalProperties: true
+			}
+		},
+		phases: [{
+			id: "explore",
+			title: "Explore"
+		}, {
+			id: "synthesize",
+			title: "Synthesize"
+		}]
+	});
+}
+function createParallelGraph(spec) {
+	const analystNodes = spec.perspectives.map((perspective, index) => ({
+		id: `perspective-${index + 1}`,
+		kind: "agent",
+		title: perspective.title,
+		description: perspective.focus,
+		phaseId: "explore",
+		position: {
+			x: 360,
+			y: 80 + index * 180
+		},
+		config: {
+			prompt: `Goal: {{goal}}\nInput: {{input}}\n\nAnalyze this from the following perspective: ${perspective.focus}\nReturn concrete findings, evidence, risks, and recommended actions.`,
+			maxIterations: 12
+		}
+	}));
+	return {
+		schemaVersion: 1,
+		nodes: [
+			{
+				id: "input",
+				kind: "input",
+				title: "User input",
+				position: {
+					x: 40,
+					y: 260
+				},
+				config: {}
+			},
+			...analystNodes,
+			{
+				id: "merge",
+				kind: "merge",
+				title: "Combine findings",
+				phaseId: "synthesize",
+				position: {
+					x: 700,
+					y: 260
+				},
+				config: { mode: "object" }
+			},
+			{
+				id: "synthesis",
+				kind: "agent",
+				title: "Create final answer",
+				phaseId: "synthesize",
+				position: {
+					x: 980,
+					y: 260
+				},
+				config: {
+					prompt: `Goal: {{goal}}\n\nIndependent findings:\n{{predecessors.merge}}\n\nSynthesize a decision-ready answer. Resolve conflicts, prioritize the most important points, and end with specific next actions.`,
+					maxIterations: 12
+				}
+			},
+			{
+				id: "output",
+				kind: "output",
+				title: "Result",
+				position: {
+					x: 1280,
+					y: 260
+				},
+				config: { title: "Final result" }
+			}
+		],
+		edges: [
+			...analystNodes.map((node, index) => ({
+				id: `input-${index + 1}`,
+				source: "input",
+				target: node.id
+			})),
+			...analystNodes.map((node, index) => ({
+				id: `perspective-${index + 1}-merge`,
+				source: node.id,
+				target: "merge"
+			})),
+			{
+				id: "merge-synthesis",
+				source: "merge",
+				target: "synthesis"
+			},
+			{
+				id: "synthesis-output",
+				source: "synthesis",
+				target: "output"
+			}
+		]
+	};
+}
+function perspectives(first, second, third) {
+	return [
+		first,
+		second,
+		third
+	].map((title) => ({
+		title,
+		focus: title
+	}));
+}
 //#endregion
-export { AUDIT_REPO_SCRIPT, BUILTIN_WORKFLOWS, CLIENT_PROPOSAL_SCRIPT, COMPETITOR_SCAN_SCRIPT, CONTENT_DRAFT_SCRIPT, CONTENT_REPURPOSE_SCRIPT, DEBUG_INCIDENT_SCRIPT, DECISION_COMPARE_SCRIPT, IMPLEMENTATION_PLAN_SCRIPT, INBOX_TRIAGE_SCRIPT, MEETING_PREP_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, OFFER_DESIGN_SCRIPT, PR_REVIEW_SCRIPT, RELEASE_CHECK_SCRIPT, RESEARCH_SCRIPT, WEEKLY_REVIEW_SCRIPT };
+export { BUILTIN_WORKFLOWS };
 
 //# sourceMappingURL=index.js.map

package/dist/src/agent/workflow/builtins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/index.ts"],"sourcesContent":["/**\n * Bundled workflow templates. These are shipped with xopc and discoverable\n * via the catalog alongside user workflows in `~/.xopc/workflows/`. A user\n * workflow with the same `name` always wins — built-ins are starting points,\n * not authority.\n */\n\nimport { AUDIT_REPO_SCRIPT } from './audit-repo.js';\nimport { CLIENT_PROPOSAL_SCRIPT } from './client-proposal.js';\nimport { COMPETITOR_SCAN_SCRIPT } from './competitor-scan.js';\nimport { CONTENT_DRAFT_SCRIPT } from './content-draft.js';\nimport { CONTENT_REPURPOSE_SCRIPT } from './content-repurpose.js';\nimport { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';\nimport { DECISION_COMPARE_SCRIPT } from './decision-compare.js';\nimport { IMPLEMENTATION_PLAN_SCRIPT } from './implementation-plan.js';\nimport { INBOX_TRIAGE_SCRIPT } from './inbox-triage.js';\nimport { MEETING_PREP_SCRIPT } from './meeting-prep.js';\nimport { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';\nimport { OFFER_DESIGN_SCRIPT } from './offer-design.js';\nimport { PR_REVIEW_SCRIPT } from './pr-review.js';\nimport { RELEASE_CHECK_SCRIPT } from './release-check.js';\nimport { RESEARCH_SCRIPT } from './research.js';\nimport { WEEKLY_REVIEW_SCRIPT } from './weekly-review.js';\n\nexport interface BuiltinWorkflow {\n  name: string;\n  script: string;\n}\n\nexport const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[] = Object.freeze([\n  { name: 'audit_repo', script: AUDIT_REPO_SCRIPT },\n  { name: 'client_proposal', script: CLIENT_PROPOSAL_SCRIPT },\n  { name: 'competitor_scan', script: COMPETITOR_SCAN_SCRIPT },\n  { name: 'content_draft', script: CONTENT_DRAFT_SCRIPT },\n  { name: 'content_repurpose', script: CONTENT_REPURPOSE_SCRIPT },\n  { name: 'debug_incident', script: DEBUG_INCIDENT_SCRIPT },\n  { name: 'decision_compare', script: DECISION_COMPARE_SCRIPT },\n  { name: 'implementation_plan', script: IMPLEMENTATION_PLAN_SCRIPT },\n  { name: 'inbox_triage', script: INBOX_TRIAGE_SCRIPT },\n  { name: 'meeting_prep', script: MEETING_PREP_SCRIPT },\n  { name: 'multi_perspective_review', script: MULTI_PERSPECTIVE_REVIEW_SCRIPT },\n  { name: 'offer_design', script: OFFER_DESIGN_SCRIPT },\n  { name: 'pr_review', script: PR_REVIEW_SCRIPT },\n  { name: 'release_check', script: RELEASE_CHECK_SCRIPT },\n  { name: 'research', script: RESEARCH_SCRIPT },\n  { name: 'weekly_review', script: WEEKLY_REVIEW_SCRIPT },\n]);\n\nexport {\n  AUDIT_REPO_SCRIPT,\n  CLIENT_PROPOSAL_SCRIPT,\n  COMPETITOR_SCAN_SCRIPT,\n  CONTENT_DRAFT_SCRIPT,\n  CONTENT_REPURPOSE_SCRIPT,\n  DEBUG_INCIDENT_SCRIPT,\n  DECISION_COMPARE_SCRIPT,\n  IMPLEMENTATION_PLAN_SCRIPT,\n  INBOX_TRIAGE_SCRIPT,\n  MEETING_PREP_SCRIPT,\n  MULTI_PERSPECTIVE_REVIEW_SCRIPT,\n  OFFER_DESIGN_SCRIPT,\n  PR_REVIEW_SCRIPT,\n  RELEASE_CHECK_SCRIPT,\n  RESEARCH_SCRIPT,\n  WEEKLY_REVIEW_SCRIPT,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,oBAAgD,OAAO,OAAO;CACzE;EAAE,MAAM;EAAc,QAAQ;EAAmB;CACjD;EAAE,MAAM;EAAmB,QAAQ;EAAwB;CAC3D;EAAE,MAAM;EAAmB,QAAQ;EAAwB;CAC3D;EAAE,MAAM;EAAiB,QAAQ;EAAsB;CACvD;EAAE,MAAM;EAAqB,QAAQ;EAA0B;CAC/D;EAAE,MAAM;EAAkB,QAAQ;EAAuB;CACzD;EAAE,MAAM;EAAoB,QAAQ;EAAyB;CAC7D;EAAE,MAAM;EAAuB,QAAQ;EAA4B;CACnE;EAAE,MAAM;EAAgB,QAAQ;EAAqB;CACrD;EAAE,MAAM;EAAgB,QAAQ;EAAqB;CACrD;EAAE,MAAM;EAA4B,QAAQ;EAAiC;CAC7E;EAAE,MAAM;EAAgB,QAAQ;EAAqB;CACrD;EAAE,MAAM;EAAa,QAAQ;EAAkB;CAC/C;EAAE,MAAM;EAAiB,QAAQ;EAAsB;CACvD;EAAE,MAAM;EAAY,QAAQ;EAAiB;CAC7C;EAAE,MAAM;EAAiB,QAAQ;EAAsB;CACxD,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/index.ts"],"sourcesContent":["import type { WorkflowDefinition, WorkflowDefinitionEstimatedAgents, WorkflowGraph } from '../../../workflows/domain/definition.js';\nimport { buildWorkflowDefinition } from '../../../workflows/domain/definition-utils.js';\n\ninterface BuiltinWorkflowSpec {\n  name: string;\n  description: string;\n  whenToUse: string;\n  tags: string[];\n  perspectives: Array<{ title: string; focus: string }>;\n}\n\nconst BUILTIN_SPECS: BuiltinWorkflowSpec[] = [\n  { name: 'audit_repo', description: 'Audit a repository across architecture, quality, security, and operations, then produce a prioritized report.', whenToUse: 'Use for a thorough review of a repository or major subsystem.', tags: ['code-review', 'audit'], perspectives: perspectives('Architecture and boundaries', 'Correctness and maintainability', 'Security and operations') },\n  { name: 'client_proposal', description: 'Turn a client brief into a clear proposal covering scope, delivery, pricing logic, and risks.', whenToUse: 'Use when preparing a client-ready proposal or statement of work.', tags: ['writing', 'content', 'document'], perspectives: perspectives('Client goals and value', 'Scope and delivery plan', 'Commercial terms and risks') },\n  { name: 'competitor_scan', description: 'Compare competitors and identify positioning, pricing, and differentiation opportunities.', whenToUse: 'Use before positioning, pricing, or go-to-market decisions.', tags: ['research', 'investigation'], perspectives: perspectives('Product and audience', 'Pricing and distribution', 'Differentiation and gaps') },\n  { name: 'content_draft', description: 'Draft polished content from multiple audience and tone perspectives, then select the strongest version.', whenToUse: 'Use for emails, posts, announcements, documentation, or other non-code writing.', tags: ['writing', 'content', 'communication'], perspectives: perspectives('Audience clarity', 'Narrative and tone', 'Conversion and call to action') },\n  { name: 'content_repurpose', description: 'Turn one source into channel-specific content without losing the core message.', whenToUse: 'Use when adapting existing material for multiple platforms.', tags: ['writing', 'content'], perspectives: perspectives('Short social format', 'Professional long-form format', 'Video or newsletter format') },\n  { name: 'debug_incident', description: 'Triage an incident using independent hypotheses and produce ranked causes and verification steps.', whenToUse: 'Use for bugs, crashes, error messages, and unexpected behavior.', tags: ['debug', 'incident', 'troubleshooting'], perspectives: perspectives('Application behavior', 'Data and dependencies', 'Infrastructure and observability') },\n  { name: 'decision_compare', description: 'Compare options through independent criteria and recommend with explicit trade-offs.', whenToUse: 'Use for decisions with multiple viable choices.', tags: ['decision-making', 'comparison', 'productivity'], perspectives: perspectives('Benefits and upside', 'Risks and hidden cost', 'Fit with constraints') },\n  { name: 'implementation_plan', description: 'Convert a feature, refactor, or bugfix request into an actionable implementation plan.', whenToUse: 'Use before multi-file or unfamiliar code changes.', tags: ['planning', 'implementation', 'architecture'], perspectives: perspectives('Existing architecture', 'Implementation sequence', 'Testing and rollout risks') },\n  { name: 'inbox_triage', description: 'Sort messy inbox input into do, delegate, defer, and drop with clear priorities.', whenToUse: 'Use to plan a day from mixed messages and tasks.', tags: ['productivity', 'brainstorm'], perspectives: perspectives('Urgency and impact', 'Delegation and automation', 'Scheduling and elimination') },\n  { name: 'meeting_prep', description: 'Build meeting context, a focused agenda, and prioritized talking points.', whenToUse: 'Use before an important meeting.', tags: ['meeting', 'productivity'], perspectives: perspectives('Context and stakeholders', 'Agenda and decisions', 'Questions and key messages') },\n  { name: 'multi_perspective_review', description: 'Stress-test a target from user, operator, and maintainer perspectives.', whenToUse: 'Use before committing to a design, plan, pull request, or proposal.', tags: ['review', 'planning', 'decision'], perspectives: perspectives('User experience and accessibility', 'Operational failure modes', 'Maintainability and hidden assumptions') },\n  { name: 'offer_design', description: 'Package expertise into sellable offers with tiers, pricing, boundaries, and positioning.', whenToUse: 'Use when productizing a service or subscription.', tags: ['planning', 'architecture'], perspectives: perspectives('Customer problem and outcome', 'Packaging and delivery boundaries', 'Pricing and positioning') },\n  { name: 'pr_review', description: 'Review a change set with focused reviewers and produce a ship or block verdict.', whenToUse: 'Use for a pull request, diff, or commit range.', tags: ['code-review', 'pr'], perspectives: perspectives('Correctness and regressions', 'Security and performance', 'Tests and maintainability') },\n  { name: 'release_check', description: 'Assess release readiness through parallel risk checks and a go or no-go verdict.', whenToUse: 'Use before shipping a completed change.', tags: ['release', 'quality', 'validation'], perspectives: perspectives('Product behavior', 'Quality and regression risk', 'Operations and rollback') },\n  { name: 'research', description: 'Research a question from multiple angles and produce a source-conscious synthesis.', whenToUse: 'Use for non-trivial questions that benefit from independent investigation.', tags: ['research', 'investigation'], perspectives: perspectives('Primary evidence and facts', 'Alternative explanations', 'Practical implications') },\n  { name: 'weekly_review', description: 'Review the week and produce a short, prioritized action plan for next week.', whenToUse: 'Use for a weekly retrospective and planning session.', tags: ['productivity', 'brainstorm'], perspectives: perspectives('Outcomes and progress', 'Friction and unfinished work', 'Priorities and capacity') },\n];\n\nexport const BUILTIN_WORKFLOWS: readonly WorkflowDefinition[] = Object.freeze(\n  BUILTIN_SPECS.map((spec) => createBuiltinWorkflow(spec)),\n);\n\nfunction createBuiltinWorkflow(spec: BuiltinWorkflowSpec): WorkflowDefinition {\n  const graph = createParallelGraph(spec);\n  const estimatedAgents: WorkflowDefinitionEstimatedAgents = {\n    min: spec.perspectives.length + 1,\n    max: spec.perspectives.length + 1,\n  };\n  return buildWorkflowDefinition({\n    name: spec.name,\n    source: 'builtin',\n    graph,\n    manifest: {\n      description: spec.description,\n      whenToUse: spec.whenToUse,\n      tags: spec.tags,\n      estimatedAgents,\n      inputSchema: { type: 'object', additionalProperties: true },\n    },\n    phases: [\n      { id: 'explore', title: 'Explore' },\n      { id: 'synthesize', title: 'Synthesize' },\n    ],\n  });\n}\n\nfunction createParallelGraph(spec: BuiltinWorkflowSpec): WorkflowGraph {\n  const analystNodes = spec.perspectives.map((perspective, index) => ({\n    id: `perspective-${index + 1}`,\n    kind: 'agent' as const,\n    title: perspective.title,\n    description: perspective.focus,\n    phaseId: 'explore',\n    position: { x: 360, y: 80 + index * 180 },\n    config: {\n      prompt: `Goal: {{goal}}\\nInput: {{input}}\\n\\nAnalyze this from the following perspective: ${perspective.focus}\\nReturn concrete findings, evidence, risks, and recommended actions.`,\n      maxIterations: 12,\n    },\n  }));\n  return {\n    schemaVersion: 1,\n    nodes: [\n      { id: 'input', kind: 'input', title: 'User input', position: { x: 40, y: 260 }, config: {} },\n      ...analystNodes,\n      { id: 'merge', kind: 'merge', title: 'Combine findings', phaseId: 'synthesize', position: { x: 700, y: 260 }, config: { mode: 'object' } },\n      {\n        id: 'synthesis',\n        kind: 'agent',\n        title: 'Create final answer',\n        phaseId: 'synthesize',\n        position: { x: 980, y: 260 },\n        config: {\n          prompt: `Goal: {{goal}}\\n\\nIndependent findings:\\n{{predecessors.merge}}\\n\\nSynthesize a decision-ready answer. Resolve conflicts, prioritize the most important points, and end with specific next actions.`,\n          maxIterations: 12,\n        },\n      },\n      { id: 'output', kind: 'output', title: 'Result', position: { x: 1280, y: 260 }, config: { title: 'Final result' } },\n    ],\n    edges: [\n      ...analystNodes.map((node, index) => ({ id: `input-${index + 1}`, source: 'input', target: node.id })),\n      ...analystNodes.map((node, index) => ({ id: `perspective-${index + 1}-merge`, source: node.id, target: 'merge' })),\n      { id: 'merge-synthesis', source: 'merge', target: 'synthesis' },\n      { id: 'synthesis-output', source: 'synthesis', target: 'output' },\n    ],\n  };\n}\n\nfunction perspectives(first: string, second: string, third: string): Array<{ title: string; focus: string }> {\n  return [first, second, third].map((title) => ({ title, focus: title }));\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/catalog.d.ts

@@ -1,32 +1,13 @@
-/**
- * Catalog for named workflows.
- *
- * Resolution order (built-ins are starting points, user workflows win):
- *   1. `~/.xopc/workflows/<name>/workflow.js` (+ optional `manifest.json`)
- *   2. `~/.xopc/workflows/<name>.js` (or `<name>.workflow.js`)
- *   3. {@link BUILTIN_WORKFLOWS}
- *
- * The user dir is discovered via {@link resolveStateDir}, so `XOPC_STATE_DIR`
- * overrides apply automatically (matches how skills / extensions are wired).
- *
- * Listing is filesystem-cheap (single `readdir`) and runs synchronously — the
- * `/workflows` slash command is interactive and should return immediately.
- *
- * Validation: on load we re-parse the script to make sure `meta.name` matches
- * the filename. This prevents copy-pasted scripts from being silently
- * mis-addressed when invoked by name.
- */
-import type { WorkflowDefinitionManifest } from '../../workflows/domain/definition.js';
-import type { WorkflowMeta } from './types.js';
+import type { WorkflowDefinition, WorkflowDefinitionManifest, WorkflowGraph } from '../../workflows/domain/definition.js';
 export type WorkflowSource = 'user' | 'builtin';
 export interface CatalogEntry {
     name: string;
     source: WorkflowSource;
-    /** Absolute path for user entries; null for built-ins (in-memory). */
     path: string | null;
     description: string;
-    title?: string;
-    version?: string;
+    title: string;
+    version: string;
+    revision: number;
     whenToUse?: string;
     tags?: string[];
     estimatedAgents?: {
@@ -34,28 +15,45 @@ export interface CatalogEntry {
         max: number;
     };
 }
-export interface LoadedWorkflow {
+export interface SaveWorkflowInput {
     name: string;
-    source: WorkflowSource;
-    script: string;
-    meta: WorkflowMeta;
-    path: string | null;
+    graph: WorkflowGraph;
     manifest?: WorkflowDefinitionManifest;
+    expectedRevision?: number;
+    intent?: 'create' | 'update';
+}
+export interface WorkflowRevisionSummary {
+    revision: number;
+    title: string;
+    contentHash?: string;
+    createdAtMs: number;
 }
 export interface WorkflowCatalog {
     list(): CatalogEntry[];
-    /** Load a named workflow. Throws if missing or meta.name disagrees with filename. */
-    load(name: string): LoadedWorkflow;
-    /** Save a script as a user workflow. Throws if the script fails to parse. */
-    save(name: string, script: string): {
+    load(name: string): WorkflowDefinition;
+    save(input: SaveWorkflowInput): {
         path: string;
+        definition: WorkflowDefinition;
+    };
+    listRevisions(name: string): WorkflowRevisionSummary[];
+    loadRevision(name: string, revision: number): WorkflowDefinition;
+    restore(name: string, revision: number, expectedRevision: number): {
+        path: string;
+        definition: WorkflowDefinition;
     };
-    /** Remove a user workflow. No-op if absent. Built-ins are never removed. */
     remove(name: string): boolean;
-    /** Absolute path to the user workflows directory (created lazily on save). */
     userDir: string;
 }
 export declare function createWorkflowCatalog(opts?: {
     userDir?: string;
 }): WorkflowCatalog;
+export declare class WorkflowRevisionConflictError extends Error {
+    readonly currentRevision: number;
+    constructor(currentRevision: number);
+}
+export declare class WorkflowNameConflictError extends Error {
+    readonly workflowName: string;
+    readonly currentRevision: number;
+    constructor(workflowName: string, currentRevision: number);
+}
 export declare function defaultUserDir(): string;