@xopcai/xopc 0.0.142 → 0.0.143

package/dist/src/agent/tools/workflow-tool.js

@@ -1,8 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
-import { parseWorkflowScript } from "../workflow/parser.js";
-import "../workflow/index.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/workflow-tool.ts
 /**
@@ -11,8 +9,7 @@ import { Type } from "@sinclair/typebox";
 init_logger();
 const log = createLogger("Agent:WorkflowTool");
 const WorkflowToolSchema = Type.Object({
-	name: Type.Optional(Type.String({ description: "Name of a saved workflow to run. Either `name` or `script` is required. Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/)." })),
-	script: Type.Optional(Type.String({ description: ["Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.", "First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }."].join(" ") })),
+	name: Type.Optional(Type.String({ description: "Name of a saved visual workflow to run." })),
 	args: Type.Optional(Type.Any({ description: "Optional JSON value passed as workflow input payload." })),
 	goal: Type.Optional(Type.String({ description: "Optional goal or task description for this workflow run (defaults to user intent in chat)." })),
 	goalId: Type.Optional(Type.String({ description: "Optional durable Goal id. When set, terminal workflow output is archived to that Goal." }))
@@ -23,7 +20,7 @@ function createWorkflowTool(deps) {
 		label: "◆ Workflow",
 		description: [
 			"Start a multi-agent workflow run in its own chat session.",
-			"Use `name` for catalog workflows, or `script` for an inline workflow (saved under meta.name before run).",
+			"Use `name` for a workflow from the visual workflow catalog.",
 			"Returns immediately with runId + sessionKey — track progress in the linked chat session."
 		].join(" "),
 		parameters: WorkflowToolSchema,
@@ -115,17 +112,7 @@ function resolveDefinitionId(params, catalog) {
 		catalog.load(name);
 		return name;
 	}
-	if (!params.script?.trim()) throw new Error("either `name` or `script` is required.");
-	const script = normalizeScript(params.script);
-	const meta = parseWorkflowScript(script).meta;
-	catalog.save(meta.name, script);
-	return meta.name;
-}
-function normalizeScript(script) {
-	let text = script.trim();
-	const fence = text.match(/^```(?:js|javascript)?\s*\n([\s\S]*?)\n```$/i);
-	if (fence) text = fence[1].trim();
-	return text;
+	throw new Error("`name` is required. Create workflows in the visual workflow studio.");
 }
 //#endregion
 export { createWorkflowTool };

package/dist/src/agent/tools/workflow-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-tool.js","names":[],"sources":["../../../../src/agent/tools/workflow-tool.ts"],"sourcesContent":["/**\n * `workflow` — starts a persisted workflow run in a dedicated chat session.\n */\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseWorkflowScript } from '../workflow/index.js';\nimport type { WorkflowCatalog } from '../workflow/catalog.js';\nimport type {\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('Agent:WorkflowTool');\n\nconst WorkflowToolSchema = Type.Object({\n  name: Type.Optional(\n    Type.String({\n      description:\n        'Name of a saved workflow to run. Either `name` or `script` is required. ' +\n        'Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/).',\n    }),\n  ),\n  script: Type.Optional(\n    Type.String({\n      description: [\n        'Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.',\n        \"First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }.\",\n      ].join(' '),\n    }),\n  ),\n  args: Type.Optional(\n    Type.Any({\n      description: 'Optional JSON value passed as workflow input payload.',\n    }),\n  ),\n  goal: Type.Optional(\n    Type.String({\n      description: 'Optional goal or task description for this workflow run (defaults to user intent in chat).',\n    }),\n  ),\n  goalId: Type.Optional(\n    Type.String({\n      description: 'Optional durable Goal id. When set, terminal workflow output is archived to that Goal.',\n    }),\n  ),\n});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  script?: string;\n  args?: unknown;\n  goal?: string;\n  goalId?: string;\n};\n\nexport interface WorkflowToolDeps {\n  catalog: WorkflowCatalog;\n  getCurrentSessionKey?: () => string | undefined;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;\n}\n\nexport function createWorkflowTool(deps: WorkflowToolDeps): AgentTool {\n  return {\n    name: 'workflow',\n    label: '◆ Workflow',\n    description: [\n      'Start a multi-agent workflow run in its own chat session.',\n      'Use `name` for catalog workflows, or `script` for an inline workflow (saved under meta.name before run).',\n      'Returns immediately with runId + sessionKey — track progress in the linked chat session.',\n    ].join(' '),\n    parameters: WorkflowToolSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: WorkflowToolInput,\n    ): Promise<AgentToolResult<{ runId: string; sessionKey: string } | { error: string }>> {\n      if (!deps.startWorkflowRun) {\n        return {\n          content: [{ type: 'text', text: 'workflow: gateway workflow runs are not available in this context' }],\n          details: { error: 'workflow_run_unavailable' },\n        };\n      }\n\n      let definitionId: string;\n      try {\n        definitionId = resolveDefinitionId(params, deps.catalog);\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n\n      const config = deps.getConfig();\n      const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();\n      const agentId = extractProfileAgentId(parentSessionKey, config);\n\n      const goal = params.goal?.trim() || '';\n      const goalId = params.goalId?.trim();\n      const source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n      const inputEnvelope = goalId\n        ? {\n            payload: params.args ?? {},\n            ...(goal ? { goal } : {}),\n          }\n        : undefined;\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          goalId,\n          input: inputEnvelope ? undefined : params.args,\n          inputEnvelope,\n          parentSessionKey,\n          source,\n        });\n\n        if (result.ok === false) {\n          return {\n            content: [{ type: 'text', text: `workflow: ${result.message}` }],\n            details: { error: result.message },\n          };\n        }\n\n        const summary = goal\n          ? `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open chat session to track progress and continue.`\n          : `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open the workflow chat session to track progress.`;\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `${summary}\\n\\nsessionKey: ${result.sessionKey}`,\n            },\n          ],\n          details: {\n            runId: result.runId,\n            sessionKey: result.sessionKey,\n            definitionId,\n            parentSessionKey: parentSessionKey ?? null,\n          } as { runId: string; sessionKey: string },\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        log.warn({ err: e, errorMessage: message, workflow: definitionId }, `workflow start failed: ${message}`);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as unknown as AgentTool;\n}\n\nfunction resolveDefinitionId(params: WorkflowToolInput, catalog: WorkflowCatalog): string {\n  const name = params.name?.trim();\n  if (name) {\n    catalog.load(name);\n    return name;\n  }\n  if (!params.script?.trim()) {\n    throw new Error('either `name` or `script` is required.');\n  }\n  const script = normalizeScript(params.script);\n  const meta = parseWorkflowScript(script).meta;\n  catalog.save(meta.name, script);\n  return meta.name;\n}\n\nfunction normalizeScript(script: string): string {\n  let text = script.trim();\n  const fence = text.match(/^```(?:js|javascript)?\\s*\\n([\\s\\S]*?)\\n```$/i);\n  if (fence) text = fence[1].trim();\n  return text;\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-tool.js","names":[],"sources":["../../../../src/agent/tools/workflow-tool.ts"],"sourcesContent":["/**\n * `workflow` — starts a persisted workflow run in a dedicated chat session.\n */\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { WorkflowCatalog } from '../workflow/catalog.js';\nimport type {\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('Agent:WorkflowTool');\n\nconst WorkflowToolSchema = Type.Object({\n  name: Type.Optional(\n    Type.String({\n      description:\n        'Name of a saved visual workflow to run.',\n    }),\n  ),\n  args: Type.Optional(\n    Type.Any({\n      description: 'Optional JSON value passed as workflow input payload.',\n    }),\n  ),\n  goal: Type.Optional(\n    Type.String({\n      description: 'Optional goal or task description for this workflow run (defaults to user intent in chat).',\n    }),\n  ),\n  goalId: Type.Optional(\n    Type.String({\n      description: 'Optional durable Goal id. When set, terminal workflow output is archived to that Goal.',\n    }),\n  ),\n});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  args?: unknown;\n  goal?: string;\n  goalId?: string;\n};\n\nexport interface WorkflowToolDeps {\n  catalog: WorkflowCatalog;\n  getCurrentSessionKey?: () => string | undefined;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;\n}\n\nexport function createWorkflowTool(deps: WorkflowToolDeps): AgentTool {\n  return {\n    name: 'workflow',\n    label: '◆ Workflow',\n    description: [\n      'Start a multi-agent workflow run in its own chat session.',\n      'Use `name` for a workflow from the visual workflow catalog.',\n      'Returns immediately with runId + sessionKey — track progress in the linked chat session.',\n    ].join(' '),\n    parameters: WorkflowToolSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: WorkflowToolInput,\n    ): Promise<AgentToolResult<{ runId: string; sessionKey: string } | { error: string }>> {\n      if (!deps.startWorkflowRun) {\n        return {\n          content: [{ type: 'text', text: 'workflow: gateway workflow runs are not available in this context' }],\n          details: { error: 'workflow_run_unavailable' },\n        };\n      }\n\n      let definitionId: string;\n      try {\n        definitionId = resolveDefinitionId(params, deps.catalog);\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n\n      const config = deps.getConfig();\n      const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();\n      const agentId = extractProfileAgentId(parentSessionKey, config);\n\n      const goal = params.goal?.trim() || '';\n      const goalId = params.goalId?.trim();\n      const source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n      const inputEnvelope = goalId\n        ? {\n            payload: params.args ?? {},\n            ...(goal ? { goal } : {}),\n          }\n        : undefined;\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          goalId,\n          input: inputEnvelope ? undefined : params.args,\n          inputEnvelope,\n          parentSessionKey,\n          source,\n        });\n\n        if (result.ok === false) {\n          return {\n            content: [{ type: 'text', text: `workflow: ${result.message}` }],\n            details: { error: result.message },\n          };\n        }\n\n        const summary = goal\n          ? `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open chat session to track progress and continue.`\n          : `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open the workflow chat session to track progress.`;\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `${summary}\\n\\nsessionKey: ${result.sessionKey}`,\n            },\n          ],\n          details: {\n            runId: result.runId,\n            sessionKey: result.sessionKey,\n            definitionId,\n            parentSessionKey: parentSessionKey ?? null,\n          } as { runId: string; sessionKey: string },\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        log.warn({ err: e, errorMessage: message, workflow: definitionId }, `workflow start failed: ${message}`);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as unknown as AgentTool;\n}\n\nfunction resolveDefinitionId(params: WorkflowToolInput, catalog: WorkflowCatalog): string {\n  const name = params.name?.trim();\n  if (name) {\n    catalog.load(name);\n    return name;\n  }\n  throw new Error('`name` is required. Create workflows in the visual workflow studio.');\n}\n"],"mappings":";;;;;;;;aAQqD;AAOrD,MAAM,MAAM,aAAa,qBAAqB;AAE9C,MAAM,qBAAqB,KAAK,OAAO;CACrC,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aACE,2CACH,CAAC,CACH;CACD,MAAM,KAAK,SACT,KAAK,IAAI,EACP,aAAa,yDACd,CAAC,CACH;CACD,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aAAa,8FACd,CAAC,CACH;CACD,QAAQ,KAAK,SACX,KAAK,OAAO,EACV,aAAa,0FACd,CAAC,CACH;CACF,CAAC;AAgBF,SAAgB,mBAAmB,MAAmC;AACpE,QAAO;EACL,MAAM;EACN,OAAO;EACP,aAAa;GACX;GACA;GACA;GACD,CAAC,KAAK,IAAI;EACX,YAAY;EAEZ,MAAM,QACJ,aACA,QACqF;AACrF,OAAI,CAAC,KAAK,iBACR,QAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM;KAAqE,CAAC;IACtG,SAAS,EAAE,OAAO,4BAA4B;IAC/C;GAGH,IAAI;AACJ,OAAI;AACF,mBAAe,oBAAoB,QAAQ,KAAK,QAAQ;YACjD,GAAG;IACV,MAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AAC1D,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,aAAa;MAAW,CAAC;KACzD,SAAS,EAAE,OAAO,SAAS;KAC5B;;GAGH,MAAM,SAAS,KAAK,WAAW;GAC/B,MAAM,mBAAmB,KAAK,wBAAwB,EAAE,MAAM;GAC9D,MAAM,UAAU,sBAAsB,kBAAkB,OAAO;GAE/D,MAAM,OAAO,OAAO,MAAM,MAAM,IAAI;GACpC,MAAM,SAAS,OAAO,QAAQ,MAAM;GACpC,MAAM,SAAS,mBACV;IAAE,MAAM;IAAiB,YAAY;IAAkB,GACvD,EAAE,MAAM,OAAgB;GAC7B,MAAM,gBAAgB,SAClB;IACE,SAAS,OAAO,QAAQ,EAAE;IAC1B,GAAI,OAAO,EAAE,MAAM,GAAG,EAAE;IACzB,GACD,KAAA;AAEJ,OAAI;IACF,MAAM,SAAS,MAAM,KAAK,iBAAiB;KACzC;KACA;KACA;KACA;KACA,OAAO,gBAAgB,KAAA,IAAY,OAAO;KAC1C;KACA;KACA;KACD,CAAC;AAEF,QAAI,OAAO,OAAO,MAChB,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,aAAa,OAAO;MAAW,CAAC;KAChE,SAAS,EAAE,OAAO,OAAO,SAAS;KACnC;AAOH,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,GARI,OACZ,sBAAsB,aAAa,UAAU,OAAO,MAAM,wDAC1D,sBAAsB,aAAa,UAAU,OAAO,MAAM,sDAMvC,kBAAkB,OAAO;MAC3C,CACF;KACD,SAAS;MACP,OAAO,OAAO;MACd,YAAY,OAAO;MACnB;MACA,kBAAkB,oBAAoB;MACvC;KACF;YACM,GAAG;IACV,MAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AAC1D,QAAI,KAAK;KAAE,KAAK;KAAG,cAAc;KAAS,UAAU;KAAc,EAAE,0BAA0B,UAAU;AACxG,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,aAAa;MAAW,CAAC;KACzD,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN;;AAGH,SAAS,oBAAoB,QAA2B,SAAkC;CACxF,MAAM,OAAO,OAAO,MAAM,MAAM;AAChC,KAAI,MAAM;AACR,UAAQ,KAAK,KAAK;AAClB,SAAO;;AAET,OAAM,IAAI,MAAM,sEAAsE"}

package/dist/src/agent/workflow/builtins/index.d.ts

@@ -1,28 +1,2 @@
-/**
- * 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.
- */
-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';
-export interface BuiltinWorkflow {
-    name: string;
-    script: string;
-}
-export declare const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[];
-export { AUDIT_REPO_SCRIPT, 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, };
+import type { WorkflowDefinition } from '../../../workflows/domain/definition.js';
+export declare const BUILTIN_WORKFLOWS: readonly WorkflowDefinition[];

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;