@xopcai/xopc 0.0.88 → 0.0.90

package/dist/src/share/site-share-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"site-share-config.js","names":[],"sources":["../../../src/share/site-share-config.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Config } from '../config/schema.js';\nimport type { GatewayService } from '../gateway/service.js';\nimport {\n  SITE_SHARE_CONFIG_DEFAULTS,\n  type SiteShareConfig,\n} from './site-share-types.js';\n\nconst SiteShareStaticPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  maxRootDirSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  maxFileCount: z.number().int().min(1).max(100_000).optional(),\n  rewriteEnabledByDefault: z.boolean().optional(),\n});\n\nconst SiteShareProxyPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  allowedUpstreamHosts: z.array(z.string().min(1)).optional(),\n  allowedUpstreamPorts: z.array(z.number().int().min(1).max(65535)).optional(),\n  forwardWebSocket: z.boolean().optional(),\n  bodySizeLimit: z.number().int().min(0).max(1_073_741_824).optional(),\n  requestTimeoutMs: z.number().int().min(1_000).max(600_000).optional(),\n  wsIdleTimeoutMs: z.number().int().min(10_000).max(3_600_000).optional(),\n  rewriteSetCookiePath: z.boolean().optional(),\n});\n\nconst SiteSharePatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  publicHostSuffix: z.string().min(1).optional(),\n  defaultTtlMs: z.number().int().min(60_000).max(604_800_000).optional(),\n  maxTtlMs: z.number().int().min(60_000).max(2_592_000_000).optional(),\n  maxActiveSites: z.number().int().min(1).max(1_000).optional(),\n  static: SiteShareStaticPatchSchema.optional(),\n  proxy: SiteShareProxyPatchSchema.optional(),\n});\n\nexport function resolveSiteShareConfig(service: GatewayService): SiteShareConfig {\n  const raw = (service.currentConfig.gateway as Record<string, unknown> | undefined)?.siteShare;\n  return mergeWithDefaults(raw);\n}\n\nexport function mergeWithDefaults(raw: unknown): SiteShareConfig {\n  const base = SITE_SHARE_CONFIG_DEFAULTS;\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n    return JSON.parse(JSON.stringify(base)) as SiteShareConfig;\n  }\n  const r = raw as Partial<SiteShareConfig> & {\n    static?: Partial<SiteShareConfig['static']>;\n    proxy?: Partial<SiteShareConfig['proxy']>;\n  };\n  return {\n    enabled: r.enabled ?? base.enabled,\n    publicHostSuffix: r.publicHostSuffix ?? base.publicHostSuffix,\n    defaultTtlMs: r.defaultTtlMs ?? base.defaultTtlMs,\n    maxTtlMs: r.maxTtlMs ?? base.maxTtlMs,\n    maxActiveSites: r.maxActiveSites ?? base.maxActiveSites,\n    static: {\n      enabled: r.static?.enabled ?? base.static.enabled,\n      maxRootDirSize: r.static?.maxRootDirSize ?? base.static.maxRootDirSize,\n      maxFileCount: r.static?.maxFileCount ?? base.static.maxFileCount,\n      rewriteEnabledByDefault: r.static?.rewriteEnabledByDefault ?? base.static.rewriteEnabledByDefault,\n    },\n    proxy: {\n      enabled: r.proxy?.enabled ?? base.proxy.enabled,\n      allowedUpstreamHosts: r.proxy?.allowedUpstreamHosts ?? [...base.proxy.allowedUpstreamHosts],\n      allowedUpstreamPorts: r.proxy?.allowedUpstreamPorts ?? [...base.proxy.allowedUpstreamPorts],\n      forwardWebSocket: r.proxy?.forwardWebSocket ?? base.proxy.forwardWebSocket,\n      bodySizeLimit: r.proxy?.bodySizeLimit ?? base.proxy.bodySizeLimit,\n      requestTimeoutMs: r.proxy?.requestTimeoutMs ?? base.proxy.requestTimeoutMs,\n      wsIdleTimeoutMs: r.proxy?.wsIdleTimeoutMs ?? base.proxy.wsIdleTimeoutMs,\n      rewriteSetCookiePath: r.proxy?.rewriteSetCookiePath ?? base.proxy.rewriteSetCookiePath,\n    },\n  };\n}\n\nexport function mergeSiteShareConfigPatch(\n  config: Config,\n  patch: Record<string, unknown>,\n): { ok: true } | { ok: false; message: string } {\n  const parsed = SiteSharePatchSchema.safeParse(patch);\n  if (!parsed.success) {\n    return { ok: false, message: parsed.error.issues.map((i) => i.message).join('; ') };\n  }\n  if (!config.gateway) {\n    config.gateway = {\n      bind: 'loopback',\n      port: 18790,\n      auth: { mode: 'token' },\n      heartbeat: { enabled: true, intervalMs: 1_800_000, includeSystemPromptSection: false },\n      maxSseConnections: 100,\n      corsOrigins: [],\n    };\n  }\n\n  const cfg = config.gateway as Record<string, unknown>;\n  const current = mergeWithDefaults(cfg.siteShare);\n  const next: SiteShareConfig = {\n    ...current,\n    ...parsed.data,\n    static: parsed.data.static ? { ...current.static, ...parsed.data.static } : current.static,\n    proxy: parsed.data.proxy ? { ...current.proxy, ...parsed.data.proxy } : current.proxy,\n  };\n  if (next.defaultTtlMs > next.maxTtlMs) {\n    return { ok: false, message: 'siteShare.defaultTtlMs must not exceed siteShare.maxTtlMs' };\n  }\n  cfg.siteShare = next as unknown as Record<string, unknown>;\n  return { ok: true };\n}\n"],"mappings":"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"}
+{"version":3,"file":"site-share-config.js","names":[],"sources":["../../../src/share/site-share-config.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  SITE_SHARE_CONFIG_DEFAULTS,\n  type SiteShareConfig,\n} from './site-share-types.js';\n\nconst SiteShareStaticPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  maxRootDirSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  maxFileCount: z.number().int().min(1).max(100_000).optional(),\n  rewriteEnabledByDefault: z.boolean().optional(),\n});\n\nconst SiteShareProxyPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  allowedUpstreamHosts: z.array(z.string().min(1)).optional(),\n  allowedUpstreamPorts: z.array(z.number().int().min(1).max(65535)).optional(),\n  forwardWebSocket: z.boolean().optional(),\n  bodySizeLimit: z.number().int().min(0).max(1_073_741_824).optional(),\n  requestTimeoutMs: z.number().int().min(1_000).max(600_000).optional(),\n  wsIdleTimeoutMs: z.number().int().min(10_000).max(3_600_000).optional(),\n  rewriteSetCookiePath: z.boolean().optional(),\n});\n\nconst SiteSharePatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  publicHostSuffix: z.string().min(1).optional(),\n  defaultTtlMs: z.number().int().min(60_000).max(604_800_000).optional(),\n  maxTtlMs: z.number().int().min(60_000).max(2_592_000_000).optional(),\n  maxActiveSites: z.number().int().min(1).max(1_000).optional(),\n  static: SiteShareStaticPatchSchema.optional(),\n  proxy: SiteShareProxyPatchSchema.optional(),\n});\n\nexport function resolveSiteShareConfig(service: { currentConfig: Config }): SiteShareConfig {\n  const raw = (service.currentConfig.gateway as Record<string, unknown> | undefined)?.siteShare;\n  return mergeWithDefaults(raw);\n}\n\nexport function mergeWithDefaults(raw: unknown): SiteShareConfig {\n  const base = SITE_SHARE_CONFIG_DEFAULTS;\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n    return JSON.parse(JSON.stringify(base)) as SiteShareConfig;\n  }\n  const r = raw as Partial<SiteShareConfig> & {\n    static?: Partial<SiteShareConfig['static']>;\n    proxy?: Partial<SiteShareConfig['proxy']>;\n  };\n  return {\n    enabled: r.enabled ?? base.enabled,\n    publicHostSuffix: r.publicHostSuffix ?? base.publicHostSuffix,\n    defaultTtlMs: r.defaultTtlMs ?? base.defaultTtlMs,\n    maxTtlMs: r.maxTtlMs ?? base.maxTtlMs,\n    maxActiveSites: r.maxActiveSites ?? base.maxActiveSites,\n    static: {\n      enabled: r.static?.enabled ?? base.static.enabled,\n      maxRootDirSize: r.static?.maxRootDirSize ?? base.static.maxRootDirSize,\n      maxFileCount: r.static?.maxFileCount ?? base.static.maxFileCount,\n      rewriteEnabledByDefault: r.static?.rewriteEnabledByDefault ?? base.static.rewriteEnabledByDefault,\n    },\n    proxy: {\n      enabled: r.proxy?.enabled ?? base.proxy.enabled,\n      allowedUpstreamHosts: r.proxy?.allowedUpstreamHosts ?? [...base.proxy.allowedUpstreamHosts],\n      allowedUpstreamPorts: r.proxy?.allowedUpstreamPorts ?? [...base.proxy.allowedUpstreamPorts],\n      forwardWebSocket: r.proxy?.forwardWebSocket ?? base.proxy.forwardWebSocket,\n      bodySizeLimit: r.proxy?.bodySizeLimit ?? base.proxy.bodySizeLimit,\n      requestTimeoutMs: r.proxy?.requestTimeoutMs ?? base.proxy.requestTimeoutMs,\n      wsIdleTimeoutMs: r.proxy?.wsIdleTimeoutMs ?? base.proxy.wsIdleTimeoutMs,\n      rewriteSetCookiePath: r.proxy?.rewriteSetCookiePath ?? base.proxy.rewriteSetCookiePath,\n    },\n  };\n}\n\nexport function mergeSiteShareConfigPatch(\n  config: Config,\n  patch: Record<string, unknown>,\n): { ok: true } | { ok: false; message: string } {\n  const parsed = SiteSharePatchSchema.safeParse(patch);\n  if (!parsed.success) {\n    return { ok: false, message: parsed.error.issues.map((i) => i.message).join('; ') };\n  }\n  if (!config.gateway) {\n    config.gateway = {\n      bind: 'loopback',\n      port: 18790,\n      auth: { mode: 'token' },\n      heartbeat: { enabled: true, intervalMs: 1_800_000, includeSystemPromptSection: false },\n      maxSseConnections: 100,\n      corsOrigins: [],\n    };\n  }\n\n  const cfg = config.gateway as Record<string, unknown>;\n  const current = mergeWithDefaults(cfg.siteShare);\n  const next: SiteShareConfig = {\n    ...current,\n    ...parsed.data,\n    static: parsed.data.static ? { ...current.static, ...parsed.data.static } : current.static,\n    proxy: parsed.data.proxy ? { ...current.proxy, ...parsed.data.proxy } : current.proxy,\n  };\n  if (next.defaultTtlMs > next.maxTtlMs) {\n    return { ok: false, message: 'siteShare.defaultTtlMs must not exceed siteShare.maxTtlMs' };\n  }\n  cfg.siteShare = next as unknown as Record<string, unknown>;\n  return { ok: true };\n}\n"],"mappings":"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"}

package/dist/src/utils/logger/stats.d.ts

@@ -12,8 +12,8 @@ export declare function incrementStats(level: LogLevel, module?: string): void;
  */
 export declare function getLogStats(): {
     byLevel: {
-        debug: number;
         error: number;
+        debug: number;
         trace: number;
         info: number;
         warn: number;

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

@@ -1,9 +1,10 @@
-import type { WorkflowRunSource } from './run.js';
+import type { WorkflowRunInputEnvelope, WorkflowRunSource } from './run.js';
 export type WorkflowCommand = StartWorkflowRunCommand | CancelWorkflowRunCommand | ArchiveWorkflowRunCommand;
 export interface StartWorkflowRunCommand {
     type: 'start_run';
     definitionId: string;
     input?: unknown;
+    inputEnvelope?: WorkflowRunInputEnvelope;
     source: WorkflowRunSource;
     goal?: string;
 }

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

@@ -0,0 +1,14 @@
+import type { WorkflowMeta } from '../../agent/workflow/types.js';
+import type { WorkflowDefinition } from './definition.js';
+export declare const DEFAULT_WORKFLOW_CONCURRENCY = 4;
+export declare const DEFAULT_WORKFLOW_TIMEOUT_SEC: number;
+export declare const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;
+export interface WorkflowDefinitionBuildInput {
+    name: string;
+    source: 'builtin' | 'user';
+    script: string;
+    meta: WorkflowMeta;
+}
+export declare function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition;
+export declare function normalizeWorkflowDefinitionId(value: string): string;
+export declare function toWorkflowDefinitionTitle(value: string): string;

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

@@ -0,0 +1,50 @@
+//#region src/workflows/domain/definition-utils.ts
+const DEFAULT_WORKFLOW_CONCURRENCY = 4;
+const DEFAULT_WORKFLOW_TIMEOUT_SEC = 1800;
+const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;
+function buildWorkflowDefinition(input) {
+	const nowMs = Date.now();
+	const phases = input.meta.phases?.map((phase, index) => ({
+		id: normalizeWorkflowDefinitionId(phase.title) || `phase-${index + 1}`,
+		title: phase.title,
+		description: phase.detail
+	})) ?? [];
+	return {
+		id: input.name,
+		name: input.name,
+		title: toWorkflowDefinitionTitle(input.name),
+		description: input.meta.description,
+		version: "1.0.0",
+		phases,
+		runtime: {
+			kind: "script",
+			source: input.script
+		},
+		defaults: {
+			concurrency: 4,
+			timeoutSec: DEFAULT_WORKFLOW_TIMEOUT_SEC,
+			maxSubagents: input.meta.estimatedAgents?.max ?? 100
+		},
+		metadata: {
+			tags: input.meta.tags ?? [],
+			builtIn: input.source === "builtin",
+			source: input.source,
+			whenToUse: input.meta.whenToUse,
+			estimatedAgents: input.meta.estimatedAgents,
+			examplePrompts: input.meta.examplePrompts,
+			i18n: input.meta.i18n,
+			createdAtMs: nowMs,
+			updatedAtMs: nowMs
+		}
+	};
+}
+function normalizeWorkflowDefinitionId(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function toWorkflowDefinitionTitle(value) {
+	return value.split(/[_-]+/g).filter(Boolean).map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
+}
+//#endregion
+export { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle };
+
+//# sourceMappingURL=definition-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-utils.js","names":[],"sources":["../../../../src/workflows/domain/definition-utils.ts"],"sourcesContent":["import type { WorkflowMeta } from '../../agent/workflow/types.js';\n\nimport type { WorkflowDefinition } from './definition.js';\n\nexport const DEFAULT_WORKFLOW_CONCURRENCY = 4;\nexport const DEFAULT_WORKFLOW_TIMEOUT_SEC = 30 * 60;\nexport const DEFAULT_WORKFLOW_MAX_SUBAGENTS = 100;\n\nexport interface WorkflowDefinitionBuildInput {\n  name: string;\n  source: 'builtin' | 'user';\n  script: string;\n  meta: WorkflowMeta;\n}\n\nexport function buildWorkflowDefinition(input: WorkflowDefinitionBuildInput): WorkflowDefinition {\n  const nowMs = Date.now();\n  const phases = input.meta.phases?.map((phase, index) => ({\n    id: normalizeWorkflowDefinitionId(phase.title) || `phase-${index + 1}`,\n    title: phase.title,\n    description: phase.detail,\n  })) ?? [];\n\n  return {\n    id: input.name,\n    name: input.name,\n    title: toWorkflowDefinitionTitle(input.name),\n    description: input.meta.description,\n    version: '1.0.0',\n    phases,\n    runtime: {\n      kind: 'script',\n      source: input.script,\n    },\n    defaults: {\n      concurrency: DEFAULT_WORKFLOW_CONCURRENCY,\n      timeoutSec: DEFAULT_WORKFLOW_TIMEOUT_SEC,\n      maxSubagents: input.meta.estimatedAgents?.max ?? DEFAULT_WORKFLOW_MAX_SUBAGENTS,\n    },\n    metadata: {\n      tags: input.meta.tags ?? [],\n      builtIn: input.source === 'builtin',\n      source: input.source,\n      whenToUse: input.meta.whenToUse,\n      estimatedAgents: input.meta.estimatedAgents,\n      examplePrompts: input.meta.examplePrompts,\n      i18n: input.meta.i18n,\n      createdAtMs: nowMs,\n      updatedAtMs: nowMs,\n    },\n  };\n}\n\nexport function normalizeWorkflowDefinitionId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nexport function toWorkflowDefinitionTitle(value: string): string {\n  return value\n    .split(/[_-]+/g)\n    .filter(Boolean)\n    .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)\n    .join(' ');\n}\n"],"mappings":";AAIA,MAAa,+BAA+B;AAC5C,MAAa,+BAA+B;AAC5C,MAAa,iCAAiC;AAS9C,SAAgB,wBAAwB,OAAyD;CAC/F,MAAM,QAAQ,KAAK,KAAK;CACxB,MAAM,SAAS,MAAM,KAAK,QAAQ,KAAK,OAAO,WAAW;EACvD,IAAI,8BAA8B,MAAM,MAAM,IAAI,SAAS,QAAQ;EACnE,OAAO,MAAM;EACb,aAAa,MAAM;EACpB,EAAE,IAAI,EAAE;AAET,QAAO;EACL,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,OAAO,0BAA0B,MAAM,KAAK;EAC5C,aAAa,MAAM,KAAK;EACxB,SAAS;EACT;EACA,SAAS;GACP,MAAM;GACN,QAAQ,MAAM;GACf;EACD,UAAU;GACR,aAAA;GACA,YAAY;GACZ,cAAc,MAAM,KAAK,iBAAiB,OAAA;GAC3C;EACD,UAAU;GACR,MAAM,MAAM,KAAK,QAAQ,EAAE;GAC3B,SAAS,MAAM,WAAW;GAC1B,QAAQ,MAAM;GACd,WAAW,MAAM,KAAK;GACtB,iBAAiB,MAAM,KAAK;GAC5B,gBAAgB,MAAM,KAAK;GAC3B,MAAM,MAAM,KAAK;GACjB,aAAa;GACb,aAAa;GACd;EACF;;AAGH,SAAgB,8BAA8B,OAAuB;AACnE,QAAO,MACJ,MAAM,CACN,aAAa,CACb,QAAQ,eAAe,IAAI,CAC3B,QAAQ,YAAY,GAAG;;AAG5B,SAAgB,0BAA0B,OAAuB;AAC/D,QAAO,MACJ,MAAM,SAAS,CACf,OAAO,QAAQ,CACf,KAAK,SAAS,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,GAAG,CAClE,KAAK,IAAI"}

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

@@ -37,12 +37,15 @@ export interface AgentStepStartedPayload {
     stepId: string;
     label: string;
     kind: 'tool' | 'llm' | 'thinking';
+    toolName?: string;
     detail?: string;
 }
 export interface AgentStepCompletedPayload {
     agentId: string;
     stepId: string;
     status: 'done' | 'error';
+    resultPreview?: string;
+    error?: string;
 }
 export interface AgentCompletedPayload {
     agentId: string;

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

@@ -1,5 +1,7 @@
 export * from './definition.js';
+export * from './definition-utils.js';
 export * from './event.js';
 export * from './result.js';
 export * from './run.js';
 export * from './command.js';
+export * from './validation.js';

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

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

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

@@ -1,3 +1,4 @@
+import type { WorkflowDefinitionEstimatedAgents } 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;
@@ -10,6 +11,7 @@ export interface WorkflowRun {
     input: unknown;
     status: WorkflowRunStatus;
     source: WorkflowRunSource;
+    metadata?: WorkflowRunMetadata;
     result?: WorkflowResultEnvelope;
     error?: WorkflowRunError;
     metrics: WorkflowRunMetrics;
@@ -17,22 +19,76 @@ export interface WorkflowRun {
     startedAtMs?: number;
     completedAtMs?: number;
 }
+export interface WorkflowRunMetadata {
+    sessionKey: string;
+    triggerSource: WorkflowRunSource['kind'];
+    agentId?: string;
+    retryOfRunId?: string;
+    definition: WorkflowRunDefinitionSnapshot;
+    input?: WorkflowRunInputEnvelope;
+    correlation?: WorkflowRunCorrelation;
+    origin?: WorkflowRunOrigin;
+    schedule?: WorkflowRunScheduleMetadata;
+}
+export interface WorkflowRunInputEnvelope {
+    payload: unknown;
+    goal?: string;
+    variables?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+}
+export interface WorkflowRunCorrelation {
+    idempotencyKey?: string;
+    requestId?: string;
+    traceId?: string;
+    parentRunId?: string;
+}
+export interface WorkflowRunOrigin {
+    channel: string;
+    sessionKey?: string;
+    chatId?: string;
+    messageId?: string;
+    scheduleId?: string;
+    fireId?: string;
+    requestId?: string;
+}
+export interface WorkflowRunScheduleMetadata {
+    scheduleId: string;
+    fireId?: string;
+    scheduledAtMs?: number;
+}
+export interface WorkflowRunDefinitionSnapshot {
+    id: string;
+    name: string;
+    title: string;
+    version: string;
+    source: 'builtin' | 'user';
+    tags: string[];
+    phaseCount: number;
+    estimatedAgents?: WorkflowDefinitionEstimatedAgents;
+}
 export type WorkflowRunSource = {
     kind: 'chat';
     sessionKey: string;
     messageId?: string;
 } | {
     kind: 'webui';
+    sessionKey?: string;
+    requestId?: string;
 } | {
     kind: 'cron';
     scheduleId: string;
+    fireId?: string;
+    scheduledAtMs?: number;
 } | {
     kind: 'api';
     requestId?: string;
+    idempotencyKey?: string;
 } | {
     kind: 'im';
     channel: string;
     chatId: string;
+    messageId?: string;
+    userId?: string;
 };
 export interface WorkflowRunMetrics {
     agentCount: number;
@@ -60,6 +116,7 @@ export interface WorkflowRunSummary {
     title: string;
     status: WorkflowRunStatus;
     source: WorkflowRunSource;
+    metadata?: WorkflowRunMetadata;
     createdAtMs: number;
     startedAtMs?: number;
     completedAtMs?: number;
@@ -102,8 +159,11 @@ export interface WorkflowAgentStepView {
     id: string;
     label: string;
     kind: 'tool' | 'llm' | 'thinking';
+    toolName?: string;
     detail?: string;
     status: WorkflowAgentStepStatus;
+    resultPreview?: string;
+    error?: string;
     startedAtMs?: number;
     completedAtMs?: number;
 }

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 { 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  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui' }\n  | { kind: 'cron'; scheduleId: string }\n  | { kind: 'api'; requestId?: string }\n  | { kind: 'im'; channel: string; chatId: 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  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  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  detail?: string;\n  status: WorkflowAgentStepStatus;\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":";AAUA,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 { 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  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"}

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

@@ -0,0 +1,19 @@
+import type { WorkflowDefinition } from './definition.js';
+export type WorkflowDefinitionValidationIssueCode = 'name_required' | 'script_required' | 'parse_failed' | 'meta_name_mismatch' | 'unknown_error';
+export interface WorkflowDefinitionValidationIssue {
+    code: WorkflowDefinitionValidationIssueCode;
+    message: string;
+    line?: number;
+    column?: number;
+}
+export interface WorkflowDefinitionValidationResult {
+    valid: boolean;
+    errors: WorkflowDefinitionValidationIssue[];
+    warnings: WorkflowDefinitionValidationIssue[];
+    definition?: WorkflowDefinition;
+}
+export interface ValidateWorkflowDefinitionInput {
+    name?: string;
+    script?: string;
+}
+export declare function validateWorkflowDefinitionInput(input: ValidateWorkflowDefinitionInput): WorkflowDefinitionValidationResult;

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

@@ -0,0 +1,66 @@
+import { parseWorkflowScript } from "../../agent/workflow/parser.js";
+import { buildWorkflowDefinition } from "./definition-utils.js";
+//#region src/workflows/domain/validation.ts
+const NAME_RE = /^[a-z][a-z0-9_-]*$/;
+function validateWorkflowDefinitionInput(input) {
+	const name = input.name?.trim() ?? "";
+	const script = input.script ?? "";
+	const errors = [];
+	const warnings = [];
+	if (!name) errors.push({
+		code: "name_required",
+		message: "Workflow name is required."
+	});
+	else if (!NAME_RE.test(name)) errors.push({
+		code: "parse_failed",
+		message: `Invalid workflow name "${name}". Use lowercase snake_case, e.g. "audit_repo".`
+	});
+	if (!script.trim()) errors.push({
+		code: "script_required",
+		message: "Workflow script is required."
+	});
+	if (errors.length > 0) return {
+		valid: false,
+		errors,
+		warnings
+	};
+	try {
+		const { meta } = parseWorkflowScript(script);
+		if (meta.name !== name) {
+			errors.push({
+				code: "meta_name_mismatch",
+				message: `meta.name "${meta.name}" does not match workflow name "${name}".`
+			});
+			return {
+				valid: false,
+				errors,
+				warnings
+			};
+		}
+		return {
+			valid: true,
+			errors,
+			warnings,
+			definition: buildWorkflowDefinition({
+				name,
+				source: "user",
+				script,
+				meta
+			})
+		};
+	} catch (err) {
+		errors.push({
+			code: "parse_failed",
+			message: err instanceof Error ? err.message : String(err)
+		});
+		return {
+			valid: false,
+			errors,
+			warnings
+		};
+	}
+}
+//#endregion
+export { validateWorkflowDefinitionInput };
+
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","names":[],"sources":["../../../../src/workflows/domain/validation.ts"],"sourcesContent":["import { parseWorkflowScript } from '../../agent/workflow/parser.js';\n\nimport type { WorkflowDefinition } from './definition.js';\nimport { buildWorkflowDefinition } from './definition-utils.js';\n\nexport type WorkflowDefinitionValidationIssueCode =\n  | 'name_required'\n  | 'script_required'\n  | 'parse_failed'\n  | 'meta_name_mismatch'\n  | 'unknown_error';\n\nexport interface WorkflowDefinitionValidationIssue {\n  code: WorkflowDefinitionValidationIssueCode;\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface WorkflowDefinitionValidationResult {\n  valid: boolean;\n  errors: WorkflowDefinitionValidationIssue[];\n  warnings: WorkflowDefinitionValidationIssue[];\n  definition?: WorkflowDefinition;\n}\n\nexport interface ValidateWorkflowDefinitionInput {\n  name?: string;\n  script?: string;\n}\n\nconst NAME_RE = /^[a-z][a-z0-9_-]*$/;\n\nexport function validateWorkflowDefinitionInput(\n  input: ValidateWorkflowDefinitionInput,\n): WorkflowDefinitionValidationResult {\n  const name = input.name?.trim() ?? '';\n  const script = input.script ?? '';\n  const errors: WorkflowDefinitionValidationIssue[] = [];\n  const warnings: WorkflowDefinitionValidationIssue[] = [];\n\n  if (!name) {\n    errors.push({ code: 'name_required', message: 'Workflow name is required.' });\n  } else if (!NAME_RE.test(name)) {\n    errors.push({\n      code: 'parse_failed',\n      message: `Invalid workflow name \"${name}\". Use lowercase snake_case, e.g. \"audit_repo\".`,\n    });\n  }\n\n  if (!script.trim()) {\n    errors.push({ code: 'script_required', message: 'Workflow script is required.' });\n  }\n\n  if (errors.length > 0) {\n    return { valid: false, errors, warnings };\n  }\n\n  try {\n    const { meta } = parseWorkflowScript(script);\n    if (meta.name !== name) {\n      errors.push({\n        code: 'meta_name_mismatch',\n        message: `meta.name \"${meta.name}\" does not match workflow name \"${name}\".`,\n      });\n      return { valid: false, errors, warnings };\n    }\n\n    return {\n      valid: true,\n      errors,\n      warnings,\n      definition: buildWorkflowDefinition({\n        name,\n        source: 'user',\n        script,\n        meta,\n      }),\n    };\n  } catch (err) {\n    errors.push({\n      code: 'parse_failed',\n      message: err instanceof Error ? err.message : String(err),\n    });\n    return { valid: false, errors, warnings };\n  }\n}\n"],"mappings":";;;AA+BA,MAAM,UAAU;AAEhB,SAAgB,gCACd,OACoC;CACpC,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI;CACnC,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,SAA8C,EAAE;CACtD,MAAM,WAAgD,EAAE;AAExD,KAAI,CAAC,KACH,QAAO,KAAK;EAAE,MAAM;EAAiB,SAAS;EAA8B,CAAC;UACpE,CAAC,QAAQ,KAAK,KAAK,CAC5B,QAAO,KAAK;EACV,MAAM;EACN,SAAS,0BAA0B,KAAK;EACzC,CAAC;AAGJ,KAAI,CAAC,OAAO,MAAM,CAChB,QAAO,KAAK;EAAE,MAAM;EAAmB,SAAS;EAAgC,CAAC;AAGnF,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,OAAO;EAAO;EAAQ;EAAU;AAG3C,KAAI;EACF,MAAM,EAAE,SAAS,oBAAoB,OAAO;AAC5C,MAAI,KAAK,SAAS,MAAM;AACtB,UAAO,KAAK;IACV,MAAM;IACN,SAAS,cAAc,KAAK,KAAK,kCAAkC,KAAK;IACzE,CAAC;AACF,UAAO;IAAE,OAAO;IAAO;IAAQ;IAAU;;AAG3C,SAAO;GACL,OAAO;GACP;GACA;GACA,YAAY,wBAAwB;IAClC;IACA,QAAQ;IACR;IACA;IACD,CAAC;GACH;UACM,KAAK;AACZ,SAAO,KAAK;GACV,MAAM;GACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;GAC1D,CAAC;AACF,SAAO;GAAE,OAAO;GAAO;GAAQ;GAAU"}

package/dist/src/workflows/engine/projector.js

@@ -102,6 +102,7 @@ function projectWorkflowRunView(events) {
 						id: payload.stepId,
 						label: payload.label,
 						kind: payload.kind,
+						toolName: payload.toolName,
 						detail: payload.detail,
 						status: "running",
 						startedAtMs: event.createdAtMs
@@ -117,6 +118,8 @@ function projectWorkflowRunView(events) {
 					steps: existing.steps.map((step) => step.id === payload.stepId ? {
 						...step,
 						status: payload.status,
+						resultPreview: payload.resultPreview,
+						error: payload.error,
 						completedAtMs: event.createdAtMs
 					} : step)
 				});
@@ -167,6 +170,20 @@ function projectWorkflowRunView(events) {
 			case "run_cancelled":
 				run.status = "cancelled";
 				run.completedAtMs = event.createdAtMs;
+				for (const [agentId, agent] of agentIdToAgent) {
+					if (agent.status !== "queued" && agent.status !== "running") continue;
+					agentIdToAgent.set(agentId, {
+						...agent,
+						status: "skipped",
+						currentStep: void 0,
+						completedAtMs: event.createdAtMs,
+						steps: agent.steps.map((step) => step.status === "running" ? {
+							...step,
+							status: "error",
+							completedAtMs: event.createdAtMs
+						} : step)
+					});
+				}
 				break;
 			default: break;
 		}

package/dist/src/workflows/engine/projector.js.map

@@ -1 +1 @@
-{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as { agentId: string; label: string; phaseId?: string; prompt?: string };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as { agentId: string; stepId: string; status: 'done' | 'error' };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as { agentId: string; label: string; phaseId?: string; prompt?: string };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/workflows/engine/workflow-engine.d.ts

@@ -1,6 +1,6 @@
 import type { WorkflowDefinition } from '../domain/definition.js';
 import type { WorkflowEventEnvelope } from '../domain/event.js';
-import type { WorkflowRunSource, WorkflowRunView } from '../domain/run.js';
+import type { WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';
 import { WorkflowEventStore } from '../store/event-store.js';
 import { WorkflowRunStore } from '../store/run-store.js';
 import type { Api, Model } from '@earendil-works/pi-ai';
@@ -17,6 +17,7 @@ export interface WorkflowEngineOptions {
 export interface StartWorkflowRunOptions {
     input?: unknown;
     source: WorkflowRunSource;
+    metadata?: WorkflowRunMetadata;
     goal?: string;
     runId?: string;
     signal?: AbortSignal;