@xopcai/xopc 0.0.105 → 0.0.107

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

@@ -15,6 +15,8 @@ export interface WorkflowDefinition {
     title: string;
     description: string;
     version: string;
+    contentHash?: string;
+    runtimeHash?: string;
     inputSchema?: JsonSchema;
     outputSchema?: JsonSchema;
     phases: WorkflowPhaseDefinition[];

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

@@ -1,5 +1,5 @@
 import type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';
-import type { WorkflowRun, WorkflowRunError } from './run.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 interface WorkflowEventEnvelope<T = WorkflowEventPayload> {
     id: string;
@@ -29,6 +29,7 @@ export interface AgentQueuedPayload {
     phaseId?: string;
     prompt?: string;
     sessionKey: string;
+    invocation?: WorkflowAgentInvocationSnapshot;
 }
 export interface AgentStartedPayload {
     agentId: string;

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

@@ -5,3 +5,4 @@ export * from './result.js';
 export * from './run.js';
 export * from './command.js';
 export * from './validation.js';
+export * from './schema-validation.js';

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

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

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

@@ -1,4 +1,4 @@
-import type { WorkflowDefinitionEstimatedAgents } from './definition.js';
+import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, 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;
@@ -24,12 +24,22 @@ export interface WorkflowRunMetadata {
     triggerSource: WorkflowRunSource['kind'];
     agentId?: string;
     retryOfRunId?: string;
+    replay?: WorkflowRunReplayMetadata;
     definition: WorkflowRunDefinitionSnapshot;
     input?: WorkflowRunInputEnvelope;
     correlation?: WorkflowRunCorrelation;
     origin?: WorkflowRunOrigin;
     schedule?: WorkflowRunScheduleMetadata;
 }
+export type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';
+export interface WorkflowRunReplayMetadata {
+    sourceRunId: string;
+    scope: WorkflowRunReplayScope;
+    phaseIds?: string[];
+    agentIds: string[];
+    targetCount: number;
+    createdAtMs: number;
+}
 export interface WorkflowRunInputEnvelope {
     payload: unknown;
     goal?: string;
@@ -61,9 +71,14 @@ export interface WorkflowRunDefinitionSnapshot {
     name: string;
     title: string;
     version: string;
+    contentHash?: string;
+    runtimeHash?: string;
     source: 'builtin' | 'user';
     tags: string[];
     phaseCount: number;
+    defaults?: WorkflowDefinitionDefaults;
+    permissions?: WorkflowPermissionPolicy;
+    resources?: WorkflowResourceRefs;
     estimatedAgents?: WorkflowDefinitionEstimatedAgents;
 }
 export type WorkflowRunSource = {
@@ -147,6 +162,7 @@ export interface WorkflowAgentView {
     phaseId?: string;
     status: WorkflowAgentStatus;
     prompt?: string;
+    invocation?: WorkflowAgentInvocationSnapshot;
     sessionKey: string;
     transcriptMessageCount: number;
     currentStep?: string;
@@ -156,6 +172,16 @@ export interface WorkflowAgentView {
     completedAtMs?: number;
     steps: WorkflowAgentStepView[];
 }
+export interface WorkflowAgentInvocationSnapshot {
+    prompt: string;
+    label: string;
+    phase?: string;
+    modelRef?: string;
+    resolvedModelRef?: string;
+    schema?: unknown;
+    toolset?: string[];
+    maxIterations?: number;
+}
 export type WorkflowAgentStepStatus = 'running' | 'done' | 'error';
 export interface WorkflowAgentStepView {
     id: 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 { WorkflowDefinitionEstimatedAgents } 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  retryOfRunId?: string;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\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  scheduleId?: string;\n  fireId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  scheduleId: string;\n  fireId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'cron'; scheduleId: string; fireId?: 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  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 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, 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  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\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  scheduleId?: string;\n  fireId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  scheduleId: string;\n  fireId?: 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: 'cron'; scheduleId: string; fireId?: 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"}

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

@@ -0,0 +1,8 @@
+import { type ErrorObject } from 'ajv';
+import type { JsonSchema } from './definition.js';
+export interface WorkflowSchemaValidationResult {
+    ok: boolean;
+    message?: string;
+    errors?: ErrorObject[];
+}
+export declare function validateWorkflowJsonSchema(schema: JsonSchema | undefined, value: unknown): WorkflowSchemaValidationResult;

package/dist/src/workflows/domain/schema-validation.js

@@ -0,0 +1,28 @@
+import Ajv from "ajv";
+//#region src/workflows/domain/schema-validation.ts
+const ajv = new Ajv({
+	allErrors: true,
+	strict: false
+});
+function validateWorkflowJsonSchema(schema, value) {
+	if (!schema) return { ok: true };
+	let validate;
+	try {
+		validate = ajv.compile(schema);
+	} catch (err) {
+		return {
+			ok: false,
+			message: `Invalid workflow schema: ${err instanceof Error ? err.message : String(err)}`
+		};
+	}
+	if (validate(value)) return { ok: true };
+	return {
+		ok: false,
+		message: ajv.errorsText(validate.errors, { separator: "; " }),
+		errors: validate.errors ?? void 0
+	};
+}
+//#endregion
+export { validateWorkflowJsonSchema };
+
+//# sourceMappingURL=schema-validation.js.map

package/dist/src/workflows/domain/schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.js","names":[],"sources":["../../../../src/workflows/domain/schema-validation.ts"],"sourcesContent":["import Ajv, { type ErrorObject } from 'ajv';\n\nimport type { JsonSchema } from './definition.js';\n\nconst ajv = new Ajv({ allErrors: true, strict: false });\n\nexport interface WorkflowSchemaValidationResult {\n  ok: boolean;\n  message?: string;\n  errors?: ErrorObject[];\n}\n\nexport function validateWorkflowJsonSchema(\n  schema: JsonSchema | undefined,\n  value: unknown,\n): WorkflowSchemaValidationResult {\n  if (!schema) {\n    return { ok: true };\n  }\n\n  let validate: ReturnType<typeof ajv.compile>;\n  try {\n    validate = ajv.compile(schema);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    return { ok: false, message: `Invalid workflow schema: ${message}` };\n  }\n\n  if (validate(value)) {\n    return { ok: true };\n  }\n\n  return {\n    ok: false,\n    message: ajv.errorsText(validate.errors, { separator: '; ' }),\n    errors: validate.errors ?? undefined,\n  };\n}\n"],"mappings":";;AAIA,MAAM,MAAM,IAAI,IAAI;CAAE,WAAW;CAAM,QAAQ;CAAO,CAAC;AAQvD,SAAgB,2BACd,QACA,OACgC;AAChC,KAAI,CAAC,OACH,QAAO,EAAE,IAAI,MAAM;CAGrB,IAAI;AACJ,KAAI;AACF,aAAW,IAAI,QAAQ,OAAO;UACvB,KAAK;AAEZ,SAAO;GAAE,IAAI;GAAO,SAAS,4BADb,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GACI;;AAGtE,KAAI,SAAS,MAAM,CACjB,QAAO,EAAE,IAAI,MAAM;AAGrB,QAAO;EACL,IAAI;EACJ,SAAS,IAAI,WAAW,SAAS,QAAQ,EAAE,WAAW,MAAM,CAAC;EAC7D,QAAQ,SAAS,UAAU,KAAA;EAC5B"}

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

@@ -0,0 +1,3 @@
+export * from './workflow-draft-service.js';
+export * from './workflow-draft.types.js';
+export * from './workflow-draft-validator.js';

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

@@ -0,0 +1,3 @@
+import { buildWorkflowDraftResponse, lintWorkflowDraft, parseGeneratedWorkflowDraft } from "./workflow-draft-validator.js";
+import { WorkflowDraftService, resolveDraftModelRef } from "./workflow-draft-service.js";
+export { WorkflowDraftService, buildWorkflowDraftResponse, lintWorkflowDraft, parseGeneratedWorkflowDraft, resolveDraftModelRef };

package/dist/src/workflows/draft/workflow-draft-prompt.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowDraftConstraints, WorkflowDraftMode } from './workflow-draft.types.js';
+export interface WorkflowDraftRepairIssue {
+    source: 'parse' | 'validation' | 'lint';
+    severity: 'error' | 'warning';
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+}
+export declare function buildWorkflowDraftPrompt(params: {
+    prompt: string;
+    language?: 'en' | 'zh';
+    mode: WorkflowDraftMode;
+    existingScript?: string;
+    constraints?: WorkflowDraftConstraints;
+}): string;
+export declare function buildWorkflowDraftRepairPrompt(params: {
+    prompt: string;
+    language?: 'en' | 'zh';
+    constraints?: WorkflowDraftConstraints;
+    previousOutput: string;
+    issues: WorkflowDraftRepairIssue[];
+}): string;

package/dist/src/workflows/draft/workflow-draft-prompt.js

@@ -0,0 +1,98 @@
+//#region src/workflows/draft/workflow-draft-prompt.ts
+function buildWorkflowDraftPrompt(params) {
+	return `You generate xopc workflow drafts. Return ONLY a JSON object, no markdown.
+
+JSON shape:
+{
+  "name": "lowercase_snake_case",
+  "script": "workflow JavaScript DSL",
+  "manifest": {
+    "title": "Human title",
+    "description": "What it does",
+    "version": "1.0.0",
+    "inputSchema": { "type": "object", "properties": {}, "required": [] },
+    "outputSchema": { "type": "object", "properties": { "summary": { "type": "string" } }, "required": ["summary"] },
+    "defaults": { "concurrency": 2, "timeoutSec": 1800, "maxSubagents": 8 },
+    "permissions": { "network": false, "fileSystem": "read", "approvalRequired": false },
+    "tags": ["custom"],
+    "whenToUse": "When to use this workflow"
+  },
+  "explanation": "Short explanation",
+  "assumptions": ["..."],
+  "risks": ["..."]
+}
+
+DSL rules:
+- script MUST start with: export const meta = { name, description, phases, tags, estimatedAgents }
+- The top-level JSON "name" MUST exactly equal script meta.name.
+- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.
+- Read user inputs from args, e.g. args.goal, args.branch, args.audience.
+- Each agent needs a clear label.
+- Keep concurrency conservative; prefer 2-4.
+- Return a WorkflowResultEnvelope-like object: { summary, sections, followUps?, structuredOutput? }.
+- Do not use import, require, eval, Function, process.env, fs, http, fetch.
+- If network/write/destructive behavior is requested, mark manifest.permissions.approvalRequired = true.
+- Keep script self-contained and valid JavaScript.
+
+Mode: ${params.mode}
+Language for user-facing copy: ${params.language ?? "en"}
+Constraints:
+${JSON.stringify(params.constraints ?? {}, null, 2)}
+
+${params.existingScript ? `Existing script to improve:\n${params.existingScript.slice(0, 12e3)}\n` : ""}
+
+User request:
+${params.prompt.slice(0, 8e3)}
+`;
+}
+function buildWorkflowDraftRepairPrompt(params) {
+	return `You must repair an xopc workflow draft so it passes validation. Return ONLY a corrected JSON object, no markdown.
+
+Required JSON shape is unchanged:
+{
+  "name": "lowercase_snake_case",
+  "script": "workflow JavaScript DSL",
+  "manifest": {
+    "title": "Human title",
+    "description": "What it does",
+    "version": "1.0.0",
+    "inputSchema": { "type": "object", "properties": {}, "required": [] },
+    "outputSchema": { "type": "object", "properties": { "summary": { "type": "string" } }, "required": ["summary"] },
+    "defaults": { "concurrency": 2, "timeoutSec": 1800, "maxSubagents": 8 },
+    "permissions": { "network": false, "fileSystem": "read", "approvalRequired": false },
+    "tags": ["custom"],
+    "whenToUse": "When to use this workflow"
+  },
+  "explanation": "Short explanation",
+  "assumptions": ["..."],
+  "risks": ["..."]
+}
+
+Hard requirements:
+- The output MUST be valid JSON.
+- JSON name MUST be lowercase snake_case and MUST exactly equal script meta.name.
+- script MUST be valid JavaScript for the xopc workflow DSL.
+- script MUST start with export const meta = { ... } and include phases, tags, estimatedAgents.
+- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.
+- Do not use import, require, eval, Function, process.env, fs, http, fetch.
+- Respect the constraints exactly. If network is disabled, manifest.permissions.network must be false.
+- Preserve the user's intent while making the smallest change needed to pass validation.
+
+Language for user-facing copy: ${params.language ?? "en"}
+Constraints:
+${JSON.stringify(params.constraints ?? {}, null, 2)}
+
+Validation and lint issues to fix:
+${JSON.stringify(params.issues, null, 2)}
+
+Original user request:
+${params.prompt.slice(0, 8e3)}
+
+Previous model output:
+${params.previousOutput.slice(0, 12e3)}
+`;
+}
+//#endregion
+export { buildWorkflowDraftPrompt, buildWorkflowDraftRepairPrompt };
+
+//# sourceMappingURL=workflow-draft-prompt.js.map

package/dist/src/workflows/draft/workflow-draft-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft-prompt.js","names":[],"sources":["../../../../src/workflows/draft/workflow-draft-prompt.ts"],"sourcesContent":["import type { WorkflowDraftConstraints, WorkflowDraftMode } from './workflow-draft.types.js';\n\nexport interface WorkflowDraftRepairIssue {\n  source: 'parse' | 'validation' | 'lint';\n  severity: 'error' | 'warning';\n  code: string;\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport function buildWorkflowDraftPrompt(params: {\n  prompt: string;\n  language?: 'en' | 'zh';\n  mode: WorkflowDraftMode;\n  existingScript?: string;\n  constraints?: WorkflowDraftConstraints;\n}): string {\n  return `You generate xopc workflow drafts. Return ONLY a JSON object, no markdown.\n\nJSON shape:\n{\n  \"name\": \"lowercase_snake_case\",\n  \"script\": \"workflow JavaScript DSL\",\n  \"manifest\": {\n    \"title\": \"Human title\",\n    \"description\": \"What it does\",\n    \"version\": \"1.0.0\",\n    \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] },\n    \"outputSchema\": { \"type\": \"object\", \"properties\": { \"summary\": { \"type\": \"string\" } }, \"required\": [\"summary\"] },\n    \"defaults\": { \"concurrency\": 2, \"timeoutSec\": 1800, \"maxSubagents\": 8 },\n    \"permissions\": { \"network\": false, \"fileSystem\": \"read\", \"approvalRequired\": false },\n    \"tags\": [\"custom\"],\n    \"whenToUse\": \"When to use this workflow\"\n  },\n  \"explanation\": \"Short explanation\",\n  \"assumptions\": [\"...\"],\n  \"risks\": [\"...\"]\n}\n\nDSL rules:\n- script MUST start with: export const meta = { name, description, phases, tags, estimatedAgents }\n- The top-level JSON \"name\" MUST exactly equal script meta.name.\n- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.\n- Read user inputs from args, e.g. args.goal, args.branch, args.audience.\n- Each agent needs a clear label.\n- Keep concurrency conservative; prefer 2-4.\n- Return a WorkflowResultEnvelope-like object: { summary, sections, followUps?, structuredOutput? }.\n- Do not use import, require, eval, Function, process.env, fs, http, fetch.\n- If network/write/destructive behavior is requested, mark manifest.permissions.approvalRequired = true.\n- Keep script self-contained and valid JavaScript.\n\nMode: ${params.mode}\nLanguage for user-facing copy: ${params.language ?? 'en'}\nConstraints:\n${JSON.stringify(params.constraints ?? {}, null, 2)}\n\n${params.existingScript ? `Existing script to improve:\\n${params.existingScript.slice(0, 12000)}\\n` : ''}\n\nUser request:\n${params.prompt.slice(0, 8000)}\n`;\n}\n\nexport function buildWorkflowDraftRepairPrompt(params: {\n  prompt: string;\n  language?: 'en' | 'zh';\n  constraints?: WorkflowDraftConstraints;\n  previousOutput: string;\n  issues: WorkflowDraftRepairIssue[];\n}): string {\n  return `You must repair an xopc workflow draft so it passes validation. Return ONLY a corrected JSON object, no markdown.\n\nRequired JSON shape is unchanged:\n{\n  \"name\": \"lowercase_snake_case\",\n  \"script\": \"workflow JavaScript DSL\",\n  \"manifest\": {\n    \"title\": \"Human title\",\n    \"description\": \"What it does\",\n    \"version\": \"1.0.0\",\n    \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] },\n    \"outputSchema\": { \"type\": \"object\", \"properties\": { \"summary\": { \"type\": \"string\" } }, \"required\": [\"summary\"] },\n    \"defaults\": { \"concurrency\": 2, \"timeoutSec\": 1800, \"maxSubagents\": 8 },\n    \"permissions\": { \"network\": false, \"fileSystem\": \"read\", \"approvalRequired\": false },\n    \"tags\": [\"custom\"],\n    \"whenToUse\": \"When to use this workflow\"\n  },\n  \"explanation\": \"Short explanation\",\n  \"assumptions\": [\"...\"],\n  \"risks\": [\"...\"]\n}\n\nHard requirements:\n- The output MUST be valid JSON.\n- JSON name MUST be lowercase snake_case and MUST exactly equal script meta.name.\n- script MUST be valid JavaScript for the xopc workflow DSL.\n- script MUST start with export const meta = { ... } and include phases, tags, estimatedAgents.\n- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.\n- Do not use import, require, eval, Function, process.env, fs, http, fetch.\n- Respect the constraints exactly. If network is disabled, manifest.permissions.network must be false.\n- Preserve the user's intent while making the smallest change needed to pass validation.\n\nLanguage for user-facing copy: ${params.language ?? 'en'}\nConstraints:\n${JSON.stringify(params.constraints ?? {}, null, 2)}\n\nValidation and lint issues to fix:\n${JSON.stringify(params.issues, null, 2)}\n\nOriginal user request:\n${params.prompt.slice(0, 8000)}\n\nPrevious model output:\n${params.previousOutput.slice(0, 12000)}\n`;\n}\n"],"mappings":";AAWA,SAAgB,yBAAyB,QAM9B;AACT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkCD,OAAO,KAAK;iCACa,OAAO,YAAY,KAAK;;EAEvD,KAAK,UAAU,OAAO,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC;;EAElD,OAAO,iBAAiB,gCAAgC,OAAO,eAAe,MAAM,GAAG,KAAM,CAAC,MAAM,GAAG;;;EAGvG,OAAO,OAAO,MAAM,GAAG,IAAK,CAAC;;;AAI/B,SAAgB,+BAA+B,QAMpC;AACT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAgCwB,OAAO,YAAY,KAAK;;EAEvD,KAAK,UAAU,OAAO,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC;;;EAGlD,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE,CAAC;;;EAGvC,OAAO,OAAO,MAAM,GAAG,IAAK,CAAC;;;EAG7B,OAAO,eAAe,MAAM,GAAG,KAAM,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { Config } from '../../config/schema.js';
+import type { CreateWorkflowDraftRequest, WorkflowDraftResponse } from './workflow-draft.types.js';
+export interface WorkflowDraftServiceOptions {
+    config: Config;
+    maxRepairAttempts?: number;
+}
+export declare class WorkflowDraftService {
+    private readonly options;
+    constructor(options: WorkflowDraftServiceOptions);
+    createDraft(request: CreateWorkflowDraftRequest, signal?: AbortSignal): Promise<WorkflowDraftResponse>;
+}
+export declare function resolveDraftModelRef(config: Config, agentId: string): string;

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

@@ -0,0 +1,131 @@
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
+import { resolveModelRef } from "../../config/agent-typed-models.js";
+import { buildWorkflowDraftPrompt, buildWorkflowDraftRepairPrompt } from "./workflow-draft-prompt.js";
+import { buildWorkflowDraftResponse, parseGeneratedWorkflowDraft } from "./workflow-draft-validator.js";
+import { complete } from "@earendil-works/pi-ai";
+//#region src/workflows/draft/workflow-draft-service.ts
+init_schema();
+init_providers();
+init_logger();
+const log = createLogger("WorkflowDraft");
+const DEFAULT_MAX_REPAIR_ATTEMPTS = 2;
+var WorkflowDraftService = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async createDraft(request, signal) {
+		const prompt = request.prompt.trim();
+		if (!prompt) throw new Error("prompt is required");
+		const modelRef = resolveDraftModelRef(this.options.config, request.agentId);
+		const model = resolveModel(modelRef);
+		const maxRepairAttempts = this.options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;
+		let messageContent = buildWorkflowDraftPrompt({
+			prompt,
+			language: request.language,
+			mode: request.mode ?? (request.existingScript ? "improve" : "create"),
+			existingScript: request.existingScript,
+			constraints: request.constraints
+		});
+		let lastIssues = [];
+		let lastText = "";
+		for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {
+			lastText = extractText(await complete(model, { messages: [{
+				role: "user",
+				content: messageContent,
+				timestamp: Date.now()
+			}] }, {
+				maxTokens: 4096,
+				temperature: attempt === 0 ? .25 : .1,
+				signal
+			}));
+			try {
+				const response = buildWorkflowDraftResponse(parseGeneratedWorkflowDraft(lastText), request.constraints);
+				const blockingIssues = getBlockingDraftIssues(response);
+				if (blockingIssues.length === 0) return {
+					...response,
+					repairAttempts: attempt
+				};
+				lastIssues = blockingIssues;
+			} catch (err) {
+				lastIssues = [{
+					source: "parse",
+					severity: "error",
+					code: "invalid_model_output",
+					message: err instanceof Error ? err.message : String(err)
+				}];
+			}
+			if (attempt >= maxRepairAttempts) break;
+			log.warn({
+				modelRef,
+				attempt: attempt + 1,
+				issueCount: lastIssues.length,
+				preview: lastText.slice(0, 500)
+			}, "Workflow draft validation failed; asking model to repair");
+			messageContent = buildWorkflowDraftRepairPrompt({
+				prompt,
+				language: request.language,
+				constraints: request.constraints,
+				previousOutput: lastText,
+				issues: lastIssues
+			});
+		}
+		const message = `Unable to generate a valid workflow draft after ${maxRepairAttempts + 1} attempts: ${formatRepairIssues(lastIssues)}`;
+		log.warn({
+			modelRef,
+			issues: lastIssues,
+			preview: lastText.slice(0, 500)
+		}, message);
+		throw new Error(message);
+	}
+};
+function resolveDraftModelRef(config, agentId) {
+	try {
+		return resolveModelRef(config, agentId, "large");
+	} catch {
+		return getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);
+	}
+}
+function extractText(result) {
+	const content = result.content;
+	if (typeof content === "string") return content;
+	if (Array.isArray(content)) return content.map((item) => {
+		if (item && typeof item === "object" && item.type === "text") return String(item.text ?? "");
+		return "";
+	}).join("");
+	return "";
+}
+function getBlockingDraftIssues(response) {
+	const validationIssues = [...response.validation.errors.map((issue) => ({
+		source: "validation",
+		severity: "error",
+		code: issue.code,
+		message: issue.message,
+		line: issue.line,
+		column: issue.column
+	})), ...response.validation.warnings.map((issue) => ({
+		source: "validation",
+		severity: "warning",
+		code: issue.code,
+		message: issue.message,
+		line: issue.line,
+		column: issue.column
+	}))];
+	const lintIssues = response.lint.filter((issue) => issue.severity === "error").map((issue) => ({
+		source: "lint",
+		severity: issue.severity,
+		code: issue.code,
+		message: issue.message
+	}));
+	return [...validationIssues, ...lintIssues];
+}
+function formatRepairIssues(issues) {
+	if (issues.length === 0) return "unknown validation failure";
+	return issues.slice(0, 5).map((issue) => `${issue.source}:${issue.code}: ${issue.message}`).join("; ");
+}
+//#endregion
+export { WorkflowDraftService, resolveDraftModelRef };
+
+//# sourceMappingURL=workflow-draft-service.js.map

package/dist/src/workflows/draft/workflow-draft-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft-service.js","names":[],"sources":["../../../../src/workflows/draft/workflow-draft-service.ts"],"sourcesContent":["import { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport { resolveModelRef } from '../../config/agent-typed-models.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  buildWorkflowDraftPrompt,\n  buildWorkflowDraftRepairPrompt,\n  type WorkflowDraftRepairIssue,\n} from './workflow-draft-prompt.js';\nimport type { CreateWorkflowDraftRequest, WorkflowDraftResponse } from './workflow-draft.types.js';\nimport { buildWorkflowDraftResponse, parseGeneratedWorkflowDraft } from './workflow-draft-validator.js';\n\nconst log = createLogger('WorkflowDraft');\nconst DEFAULT_MAX_REPAIR_ATTEMPTS = 2;\n\nexport interface WorkflowDraftServiceOptions {\n  config: Config;\n  maxRepairAttempts?: number;\n}\n\nexport class WorkflowDraftService {\n  constructor(private readonly options: WorkflowDraftServiceOptions) {}\n\n  async createDraft(request: CreateWorkflowDraftRequest, signal?: AbortSignal): Promise<WorkflowDraftResponse> {\n    const prompt = request.prompt.trim();\n    if (!prompt) throw new Error('prompt is required');\n    const modelRef = resolveDraftModelRef(this.options.config, request.agentId);\n    const model = resolveModel(modelRef);\n    const maxRepairAttempts = this.options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;\n    let messageContent = buildWorkflowDraftPrompt({\n      prompt,\n      language: request.language,\n      mode: request.mode ?? (request.existingScript ? 'improve' : 'create'),\n      existingScript: request.existingScript,\n      constraints: request.constraints,\n    });\n    let lastIssues: WorkflowDraftRepairIssue[] = [];\n    let lastText = '';\n\n    for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {\n      const userMsg: UserMessage = {\n        role: 'user',\n        content: messageContent,\n        timestamp: Date.now(),\n      };\n      const result = await complete(\n        model,\n        { messages: [userMsg] },\n        { maxTokens: 4096, temperature: attempt === 0 ? 0.25 : 0.1, signal: signal as AbortSignal },\n      );\n      lastText = extractText(result);\n      try {\n        const draft = parseGeneratedWorkflowDraft(lastText);\n        const response = buildWorkflowDraftResponse(draft, request.constraints);\n        const blockingIssues = getBlockingDraftIssues(response);\n        if (blockingIssues.length === 0) {\n          return { ...response, repairAttempts: attempt };\n        }\n        lastIssues = blockingIssues;\n      } catch (err) {\n        lastIssues = [{\n          source: 'parse',\n          severity: 'error',\n          code: 'invalid_model_output',\n          message: err instanceof Error ? err.message : String(err),\n        }];\n      }\n\n      if (attempt >= maxRepairAttempts) break;\n      log.warn(\n        { modelRef, attempt: attempt + 1, issueCount: lastIssues.length, preview: lastText.slice(0, 500) },\n        'Workflow draft validation failed; asking model to repair',\n      );\n      messageContent = buildWorkflowDraftRepairPrompt({\n        prompt,\n        language: request.language,\n        constraints: request.constraints,\n        previousOutput: lastText,\n        issues: lastIssues,\n      });\n    }\n\n    const message = `Unable to generate a valid workflow draft after ${maxRepairAttempts + 1} attempts: ${formatRepairIssues(lastIssues)}`;\n    log.warn({ modelRef, issues: lastIssues, preview: lastText.slice(0, 500) }, message);\n    throw new Error(message);\n  }\n}\n\nexport function resolveDraftModelRef(config: Config, agentId: string): string {\n  try {\n    return resolveModelRef(config, agentId, 'large');\n  } catch {\n    return getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);\n  }\n}\n\nfunction extractText(result: unknown): string {\n  const content = (result as { content?: unknown }).content;\n  if (typeof content === 'string') return content;\n  if (Array.isArray(content)) {\n    return content.map((item) => {\n      if (item && typeof item === 'object' && (item as { type?: string }).type === 'text') {\n        return String((item as { text?: string }).text ?? '');\n      }\n      return '';\n    }).join('');\n  }\n  return '';\n}\n\nfunction getBlockingDraftIssues(response: WorkflowDraftResponse): WorkflowDraftRepairIssue[] {\n  const validationIssues: WorkflowDraftRepairIssue[] = [\n    ...response.validation.errors.map((issue) => ({\n      source: 'validation' as const,\n      severity: 'error' as const,\n      code: issue.code,\n      message: issue.message,\n      line: issue.line,\n      column: issue.column,\n    })),\n    ...response.validation.warnings.map((issue) => ({\n      source: 'validation' as const,\n      severity: 'warning' as const,\n      code: issue.code,\n      message: issue.message,\n      line: issue.line,\n      column: issue.column,\n    })),\n  ];\n  const lintIssues = response.lint\n    .filter((issue) => issue.severity === 'error')\n    .map((issue) => ({\n      source: 'lint' as const,\n      severity: issue.severity,\n      code: issue.code,\n      message: issue.message,\n    }));\n  return [...validationIssues, ...lintIssues];\n}\n\nfunction formatRepairIssues(issues: WorkflowDraftRepairIssue[]): string {\n  if (issues.length === 0) return 'unknown validation failure';\n  return issues.slice(0, 5).map((issue) => `${issue.source}:${issue.code}: ${issue.message}`).join('; ');\n}\n"],"mappings":"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"}

package/dist/src/workflows/draft/workflow-draft-validator.d.ts

@@ -0,0 +1,4 @@
+import type { GeneratedWorkflowDraft, WorkflowDraftConstraints, WorkflowDraftLintIssue, WorkflowDraftResponse } from './workflow-draft.types.js';
+export declare function parseGeneratedWorkflowDraft(raw: string): GeneratedWorkflowDraft;
+export declare function buildWorkflowDraftResponse(draft: GeneratedWorkflowDraft, constraints?: WorkflowDraftConstraints): WorkflowDraftResponse;
+export declare function lintWorkflowDraft(draft: GeneratedWorkflowDraft, constraints?: WorkflowDraftConstraints): WorkflowDraftLintIssue[];

package/dist/src/workflows/draft/workflow-draft-validator.js

@@ -0,0 +1,133 @@
+import { validateWorkflowDefinitionInput } from "../domain/validation.js";
+import { randomUUID } from "node:crypto";
+//#region src/workflows/draft/workflow-draft-validator.ts
+function parseGeneratedWorkflowDraft(raw) {
+	const json = extractJsonObject(raw);
+	const parsed = JSON.parse(json);
+	return {
+		name: normalizeWorkflowName(String(parsed.name ?? "custom_workflow")),
+		script: String(parsed.script ?? "").trim(),
+		manifest: normalizeManifest(parsed.manifest),
+		explanation: String(parsed.explanation ?? ""),
+		assumptions: stringArray(parsed.assumptions),
+		risks: stringArray(parsed.risks)
+	};
+}
+function buildWorkflowDraftResponse(draft, constraints) {
+	const validation = validateWorkflowDefinitionInput({
+		name: draft.name,
+		script: draft.script
+	});
+	const lint = lintWorkflowDraft(draft, constraints);
+	return {
+		draftId: randomUUID(),
+		repairAttempts: 0,
+		...draft,
+		permissionsSummary: summarizePermissions(draft.manifest),
+		validation,
+		lint,
+		suggestedInputs: suggestedInputsFromManifest(draft.manifest)
+	};
+}
+function lintWorkflowDraft(draft, constraints) {
+	const issues = [];
+	const { manifest, script } = draft;
+	if (!manifest.inputSchema) issues.push({
+		severity: "warning",
+		code: "missing_input_schema",
+		message: "Draft does not define an input schema."
+	});
+	if (!manifest.outputSchema) issues.push({
+		severity: "warning",
+		code: "missing_output_schema",
+		message: "Draft does not define an output schema."
+	});
+	if (manifest.permissions?.network && constraints?.allowNetwork === false) issues.push({
+		severity: "error",
+		code: "unsafe_permission",
+		message: "Draft requests network access, but network is disabled by constraints."
+	});
+	if (manifest.permissions?.fileSystem === "write" && constraints?.fileSystem !== "write") issues.push({
+		severity: "warning",
+		code: "unsafe_permission",
+		message: "Draft requests filesystem write access."
+	});
+	const phaseCount = (script.match(/\bphase\s*\(/g) ?? []).length;
+	if (constraints?.maxPhases && phaseCount > constraints.maxPhases) issues.push({
+		severity: "warning",
+		code: "too_many_agents",
+		message: `Draft has ${phaseCount} phases, above requested ${constraints.maxPhases}.`
+	});
+	const agentCount = (script.match(/\bagent\s*\(/g) ?? []).length;
+	if (constraints?.maxSubagents && agentCount > constraints.maxSubagents) issues.push({
+		severity: "warning",
+		code: "too_many_agents",
+		message: `Draft starts ${agentCount} agents, above requested ${constraints.maxSubagents}.`
+	});
+	if (/parallel\s*\([^[]/.test(script)) issues.push({
+		severity: "warning",
+		code: "unbounded_parallelism",
+		message: "parallel() should receive a bounded array of thunks."
+	});
+	if (constraints?.allowedTools?.length) {
+		const unknown = collectToolsetNames(script).filter((tool) => !constraints.allowedTools.includes(tool));
+		for (const tool of [...new Set(unknown)]) issues.push({
+			severity: "warning",
+			code: "unknown_tool",
+			message: `Tool '${tool}' is outside the requested allowlist.`
+		});
+	}
+	return issues;
+}
+function extractJsonObject(raw) {
+	const trimmed = raw.trim();
+	if (trimmed.startsWith("{") && trimmed.endsWith("}")) return trimmed;
+	const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i)?.[1]?.trim();
+	if (fenced?.startsWith("{")) return fenced;
+	const start = trimmed.indexOf("{");
+	const end = trimmed.lastIndexOf("}");
+	if (start >= 0 && end > start) return trimmed.slice(start, end + 1);
+	throw new Error("Model did not return a JSON object.");
+}
+function normalizeManifest(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+	return value;
+}
+function stringArray(value) {
+	return Array.isArray(value) ? value.map((item) => String(item)).filter(Boolean) : [];
+}
+function normalizeWorkflowName(value) {
+	const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+	return /^[a-z]/.test(normalized) ? normalized : `workflow_${normalized || "draft"}`;
+}
+function summarizePermissions(manifest) {
+	const permissions = manifest.permissions;
+	if (!permissions) return ["No explicit permissions requested."];
+	const out = [];
+	if (permissions.tools?.length) out.push(`Tools: ${permissions.tools.join(", ")}`);
+	if (permissions.network != null) out.push(`Network: ${permissions.network ? "enabled" : "disabled"}`);
+	if (permissions.fileSystem) out.push(`Filesystem: ${permissions.fileSystem}`);
+	if (permissions.approvalRequired) out.push("Approval required");
+	return out.length > 0 ? out : ["No explicit permissions requested."];
+}
+function suggestedInputsFromManifest(manifest) {
+	const properties = manifest.inputSchema?.properties;
+	if (!properties) return void 0;
+	return Object.entries(properties).slice(0, 8).map(([key, schema]) => ({
+		key,
+		label: typeof schema.title === "string" ? schema.title : key,
+		example: typeof schema.default === "string" ? schema.default : schema.description ?? ""
+	}));
+}
+function collectToolsetNames(script) {
+	const out = [];
+	for (const match of script.matchAll(/toolset\s*:\s*\[([^\]]*)\]/g)) {
+		const body = match[1] ?? "";
+		for (const item of body.matchAll(/['"]([^'"]+)['"]/g)) out.push(item[1] ?? "");
+	}
+	return out.filter(Boolean);
+}
+//#endregion
+export { buildWorkflowDraftResponse, lintWorkflowDraft, parseGeneratedWorkflowDraft };
+
+//# sourceMappingURL=workflow-draft-validator.js.map