@xopcai/xopc 0.0.87 → 0.0.89

package/dist/src/voice/stt/list-providers.js

@@ -1,19 +1,54 @@
 import { listMediaUnderstandingProviders } from "../../media-understanding/registry.js";
 import { resolveSTTProviderConfig } from "./factory.js";
 import { mergeSttConfigFromAppConfig } from "../../channels/attachments/voice-stt-webchat.js";
+import { getVoiceProviderMetadata } from "../metadata/registry.js";
+import "../metadata/index.js";
 //#region src/voice/stt/list-providers.ts
+function fallbackMetadata(providerId, aliases) {
+	return {
+		id: providerId,
+		capability: "stt",
+		displayName: providerId,
+		aliases: [...aliases],
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "string"
+			},
+			{
+				key: "baseUrl",
+				label: "Base URL",
+				type: "string"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			configPath: `tools.media.audio.providers.${providerId}`
+		}
+	};
+}
 function isSttProviderConfigured(providerId, config) {
 	return resolveSTTProviderConfig(providerId, config) !== null;
 }
-/** List registered audio STT providers with configured state for the current app config. */
+/** List registered audio STT providers with configured state and UI metadata. */
 function listSttProvidersForApi(config) {
 	const sttConfig = mergeSttConfigFromAppConfig(config?.tools?.media?.audio, config?.tools?.media);
 	return {
-		providers: listMediaUnderstandingProviders().filter((plugin) => plugin.capabilities?.includes("audio") && typeof plugin.transcribeAudio === "function").map((plugin) => ({
-			id: plugin.id,
-			aliases: [...plugin.aliases ?? []],
-			configured: isSttProviderConfigured(plugin.id, sttConfig)
-		})),
+		providers: listMediaUnderstandingProviders().filter((plugin) => plugin.capabilities?.includes("audio") && typeof plugin.transcribeAudio === "function").map((plugin) => {
+			const metadata = getVoiceProviderMetadata("stt", plugin.id) ?? fallbackMetadata(plugin.id, plugin.aliases ?? []);
+			return {
+				...metadata,
+				aliases: [...metadata.aliases ?? plugin.aliases ?? []],
+				configured: isSttProviderConfigured(plugin.id, sttConfig)
+			};
+		}),
 		active: sttConfig.provider
 	};
 }

package/dist/src/voice/stt/list-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-providers.js","names":[],"sources":["../../../../src/voice/stt/list-providers.ts"],"sourcesContent":["/**\n * Registry-driven STT provider listing for gateway / Web UI discovery.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { mergeSttConfigFromAppConfig } from '../../channels/attachments/voice-stt-webchat.js';\n\nimport { resolveSTTProviderConfig } from './factory.js';\nimport type { STTConfig } from './types.js';\nimport { listMediaUnderstandingProviders } from '../../media-understanding/registry.js';\n\nexport interface SttProviderListEntry {\n  id: string;\n  aliases: string[];\n  configured: boolean;\n}\n\nexport interface SttProvidersPayload {\n  providers: SttProviderListEntry[];\n  active: string;\n}\n\nexport function isSttProviderConfigured(providerId: string, config: STTConfig): boolean {\n  return resolveSTTProviderConfig(providerId, config) !== null;\n}\n\n/** List registered audio STT providers with configured state for the current app config. */\nexport function listSttProvidersForApi(config: Config | undefined): SttProvidersPayload {\n  const sttConfig = mergeSttConfigFromAppConfig(config?.tools?.media?.audio, config?.tools?.media);\n  const providers: SttProviderListEntry[] = listMediaUnderstandingProviders()\n    .filter(\n      (plugin) =>\n        plugin.capabilities?.includes('audio') && typeof plugin.transcribeAudio === 'function',\n    )\n    .map((plugin) => ({\n      id: plugin.id,\n      aliases: [...(plugin.aliases ?? [])],\n      configured: isSttProviderConfigured(plugin.id, sttConfig),\n    }));\n\n  return {\n    providers,\n    active: sttConfig.provider,\n  };\n}\n"],"mappings":";;;;AAsBA,SAAgB,wBAAwB,YAAoB,QAA4B;AACtF,QAAO,yBAAyB,YAAY,OAAO,KAAK;;;AAI1D,SAAgB,uBAAuB,QAAiD;CACtF,MAAM,YAAY,4BAA4B,QAAQ,OAAO,OAAO,OAAO,QAAQ,OAAO,MAAM;AAYhG,QAAO;EACL,WAZwC,iCAAiC,CACxE,QACE,WACC,OAAO,cAAc,SAAS,QAAQ,IAAI,OAAO,OAAO,oBAAoB,WAC/E,CACA,KAAK,YAAY;GAChB,IAAI,OAAO;GACX,SAAS,CAAC,GAAI,OAAO,WAAW,EAAE,CAAE;GACpC,YAAY,wBAAwB,OAAO,IAAI,UAAU;GAC1D,EAGQ;EACT,QAAQ,UAAU;EACnB"}
+{"version":3,"file":"list-providers.js","names":[],"sources":["../../../../src/voice/stt/list-providers.ts"],"sourcesContent":["/**\n * Registry-driven STT provider listing for gateway / Web UI discovery.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { mergeSttConfigFromAppConfig } from '../../channels/attachments/voice-stt-webchat.js';\nimport { listMediaUnderstandingProviders } from '../../media-understanding/registry.js';\nimport { getVoiceProviderMetadata, type VoiceProviderMetadata } from '../metadata/index.js';\n\nimport { resolveSTTProviderConfig } from './factory.js';\nimport type { STTConfig } from './types.js';\n\nexport interface SttProviderListEntry extends VoiceProviderMetadata {\n  aliases: string[];\n  configured: boolean;\n}\n\nexport interface SttProvidersPayload {\n  providers: SttProviderListEntry[];\n  active: string;\n}\n\nfunction fallbackMetadata(providerId: string, aliases: readonly string[]): VoiceProviderMetadata {\n  return {\n    id: providerId,\n    capability: 'stt',\n    displayName: providerId,\n    aliases: [...aliases],\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true },\n      { key: 'model', label: 'Model', type: 'string' },\n      { key: 'baseUrl', label: 'Base URL', type: 'string' },\n    ],\n    diagnostics: {\n      requiresApiKey: true,\n      configPath: `tools.media.audio.providers.${providerId}`,\n    },\n  };\n}\n\nexport function isSttProviderConfigured(providerId: string, config: STTConfig): boolean {\n  return resolveSTTProviderConfig(providerId, config) !== null;\n}\n\n/** List registered audio STT providers with configured state and UI metadata. */\nexport function listSttProvidersForApi(config: Config | undefined): SttProvidersPayload {\n  const sttConfig = mergeSttConfigFromAppConfig(config?.tools?.media?.audio, config?.tools?.media);\n  const providers: SttProviderListEntry[] = listMediaUnderstandingProviders()\n    .filter(\n      (plugin) =>\n        plugin.capabilities?.includes('audio') && typeof plugin.transcribeAudio === 'function',\n    )\n    .map((plugin) => {\n      const metadata = getVoiceProviderMetadata('stt', plugin.id) ?? fallbackMetadata(plugin.id, plugin.aliases ?? []);\n      return {\n        ...metadata,\n        aliases: [...(metadata.aliases ?? plugin.aliases ?? [])],\n        configured: isSttProviderConfigured(plugin.id, sttConfig),\n      };\n    });\n\n  return {\n    providers,\n    active: sttConfig.provider,\n  };\n}\n"],"mappings":";;;;;;AAsBA,SAAS,iBAAiB,YAAoB,SAAmD;AAC/F,QAAO;EACL,IAAI;EACJ,YAAY;EACZ,aAAa;EACb,SAAS,CAAC,GAAG,QAAQ;EACrB,QAAQ;GACN;IAAE,KAAK;IAAU,OAAO;IAAW,MAAM;IAAY,QAAQ;IAAM;GACnE;IAAE,KAAK;IAAS,OAAO;IAAS,MAAM;IAAU;GAChD;IAAE,KAAK;IAAW,OAAO;IAAY,MAAM;IAAU;GACtD;EACD,aAAa;GACX,gBAAgB;GAChB,YAAY,+BAA+B;GAC5C;EACF;;AAGH,SAAgB,wBAAwB,YAAoB,QAA4B;AACtF,QAAO,yBAAyB,YAAY,OAAO,KAAK;;;AAI1D,SAAgB,uBAAuB,QAAiD;CACtF,MAAM,YAAY,4BAA4B,QAAQ,OAAO,OAAO,OAAO,QAAQ,OAAO,MAAM;AAehG,QAAO;EACL,WAfwC,iCAAiC,CACxE,QACE,WACC,OAAO,cAAc,SAAS,QAAQ,IAAI,OAAO,OAAO,oBAAoB,WAC/E,CACA,KAAK,WAAW;GACf,MAAM,WAAW,yBAAyB,OAAO,OAAO,GAAG,IAAI,iBAAiB,OAAO,IAAI,OAAO,WAAW,EAAE,CAAC;AAChH,UAAO;IACL,GAAG;IACH,SAAS,CAAC,GAAI,SAAS,WAAW,OAAO,WAAW,EAAE,CAAE;IACxD,YAAY,wBAAwB,OAAO,IAAI,UAAU;IAC1D;IAIM;EACT,QAAQ,UAAU;EACnB"}

package/dist/src/voice/tts/list-providers.d.ts

@@ -2,8 +2,8 @@
  * Registry-driven TTS provider listing for gateway / Web UI discovery.
  */
 import type { Config } from '../../config/schema.js';
-export interface TtsProviderListEntry {
-    id: string;
+import { type VoiceProviderMetadata } from '../metadata/index.js';
+export interface TtsProviderListEntry extends VoiceProviderMetadata {
     aliases: string[];
     configured: boolean;
 }
@@ -11,5 +11,5 @@ export interface TtsProvidersPayload {
     providers: TtsProviderListEntry[];
     active: string;
 }
-/** List registered speech providers with configured state for the current app config. */
+/** List registered speech providers with configured state and UI metadata. */
 export declare function listTtsProvidersForApi(config: Config | undefined): TtsProvidersPayload;

package/dist/src/voice/tts/list-providers.js

@@ -1,16 +1,51 @@
 import { listSpeechProviders } from "./speech-registry.js";
 import { resolveSpeechProvider } from "./factory.js";
 import { mergeTtsConfigFromAppConfig } from "./merge-config.js";
+import { getVoiceProviderMetadata } from "../metadata/registry.js";
+import "../metadata/index.js";
 //#region src/voice/tts/list-providers.ts
-/** List registered speech providers with configured state for the current app config. */
+function fallbackMetadata(providerId, aliases) {
+	return {
+		id: providerId,
+		capability: "tts",
+		displayName: providerId,
+		aliases: [...aliases],
+		fields: [
+			{
+				key: "apiKey",
+				label: "API Key",
+				type: "password",
+				secret: true
+			},
+			{
+				key: "model",
+				label: "Model",
+				type: "string"
+			},
+			{
+				key: "voice",
+				label: "Voice",
+				type: "string"
+			}
+		],
+		diagnostics: {
+			requiresApiKey: true,
+			configPath: `messages.tts.providers.${providerId}`
+		}
+	};
+}
+/** List registered speech providers with configured state and UI metadata. */
 function listTtsProvidersForApi(config) {
 	const ttsConfig = mergeTtsConfigFromAppConfig(config?.messages?.tts);
 	return {
-		providers: listSpeechProviders().map((plugin) => ({
-			id: plugin.id,
-			aliases: [...plugin.aliases ?? []],
-			configured: resolveSpeechProvider(plugin.id, ttsConfig) !== null
-		})),
+		providers: listSpeechProviders().map((plugin) => {
+			const metadata = getVoiceProviderMetadata("tts", plugin.id) ?? fallbackMetadata(plugin.id, plugin.aliases ?? []);
+			return {
+				...metadata,
+				aliases: [...metadata.aliases ?? plugin.aliases ?? []],
+				configured: resolveSpeechProvider(plugin.id, ttsConfig) !== null
+			};
+		}),
 		active: ttsConfig.provider
 	};
 }

package/dist/src/voice/tts/list-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-providers.js","names":[],"sources":["../../../../src/voice/tts/list-providers.ts"],"sourcesContent":["/**\n * Registry-driven TTS provider listing for gateway / Web UI discovery.\n */\n\nimport type { Config } from '../../config/schema.js';\n\nimport { resolveSpeechProvider } from './factory.js';\nimport { mergeTtsConfigFromAppConfig } from './merge-config.js';\nimport { listSpeechProviders } from './speech-registry.js';\n\nexport interface TtsProviderListEntry {\n  id: string;\n  aliases: string[];\n  configured: boolean;\n}\n\nexport interface TtsProvidersPayload {\n  providers: TtsProviderListEntry[];\n  active: string;\n}\n\n/** List registered speech providers with configured state for the current app config. */\nexport function listTtsProvidersForApi(config: Config | undefined): TtsProvidersPayload {\n  const ttsConfig = mergeTtsConfigFromAppConfig(config?.messages?.tts);\n  const providers: TtsProviderListEntry[] = listSpeechProviders().map((plugin) => ({\n    id: plugin.id,\n    aliases: [...(plugin.aliases ?? [])],\n    configured: resolveSpeechProvider(plugin.id, ttsConfig) !== null,\n  }));\n\n  return {\n    providers,\n    active: ttsConfig.provider,\n  };\n}\n"],"mappings":";;;;;AAsBA,SAAgB,uBAAuB,QAAiD;CACtF,MAAM,YAAY,4BAA4B,QAAQ,UAAU,IAAI;AAOpE,QAAO;EACL,WAPwC,qBAAqB,CAAC,KAAK,YAAY;GAC/E,IAAI,OAAO;GACX,SAAS,CAAC,GAAI,OAAO,WAAW,EAAE,CAAE;GACpC,YAAY,sBAAsB,OAAO,IAAI,UAAU,KAAK;GAC7D,EAGU;EACT,QAAQ,UAAU;EACnB"}
+{"version":3,"file":"list-providers.js","names":[],"sources":["../../../../src/voice/tts/list-providers.ts"],"sourcesContent":["/**\n * Registry-driven TTS provider listing for gateway / Web UI discovery.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { getVoiceProviderMetadata, type VoiceProviderMetadata } from '../metadata/index.js';\n\nimport { resolveSpeechProvider } from './factory.js';\nimport { mergeTtsConfigFromAppConfig } from './merge-config.js';\nimport { listSpeechProviders } from './speech-registry.js';\n\nexport interface TtsProviderListEntry extends VoiceProviderMetadata {\n  aliases: string[];\n  configured: boolean;\n}\n\nexport interface TtsProvidersPayload {\n  providers: TtsProviderListEntry[];\n  active: string;\n}\n\nfunction fallbackMetadata(providerId: string, aliases: readonly string[]): VoiceProviderMetadata {\n  return {\n    id: providerId,\n    capability: 'tts',\n    displayName: providerId,\n    aliases: [...aliases],\n    fields: [\n      { key: 'apiKey', label: 'API Key', type: 'password', secret: true },\n      { key: 'model', label: 'Model', type: 'string' },\n      { key: 'voice', label: 'Voice', type: 'string' },\n    ],\n    diagnostics: {\n      requiresApiKey: true,\n      configPath: `messages.tts.providers.${providerId}`,\n    },\n  };\n}\n\n/** List registered speech providers with configured state and UI metadata. */\nexport function listTtsProvidersForApi(config: Config | undefined): TtsProvidersPayload {\n  const ttsConfig = mergeTtsConfigFromAppConfig(config?.messages?.tts);\n  const providers: TtsProviderListEntry[] = listSpeechProviders().map((plugin) => {\n    const metadata = getVoiceProviderMetadata('tts', plugin.id) ?? fallbackMetadata(plugin.id, plugin.aliases ?? []);\n    return {\n      ...metadata,\n      aliases: [...(metadata.aliases ?? plugin.aliases ?? [])],\n      configured: resolveSpeechProvider(plugin.id, ttsConfig) !== null,\n    };\n  });\n\n  return {\n    providers,\n    active: ttsConfig.provider,\n  };\n}\n"],"mappings":";;;;;;AAqBA,SAAS,iBAAiB,YAAoB,SAAmD;AAC/F,QAAO;EACL,IAAI;EACJ,YAAY;EACZ,aAAa;EACb,SAAS,CAAC,GAAG,QAAQ;EACrB,QAAQ;GACN;IAAE,KAAK;IAAU,OAAO;IAAW,MAAM;IAAY,QAAQ;IAAM;GACnE;IAAE,KAAK;IAAS,OAAO;IAAS,MAAM;IAAU;GAChD;IAAE,KAAK;IAAS,OAAO;IAAS,MAAM;IAAU;GACjD;EACD,aAAa;GACX,gBAAgB;GAChB,YAAY,0BAA0B;GACvC;EACF;;;AAIH,SAAgB,uBAAuB,QAAiD;CACtF,MAAM,YAAY,4BAA4B,QAAQ,UAAU,IAAI;AAUpE,QAAO;EACL,WAVwC,qBAAqB,CAAC,KAAK,WAAW;GAC9E,MAAM,WAAW,yBAAyB,OAAO,OAAO,GAAG,IAAI,iBAAiB,OAAO,IAAI,OAAO,WAAW,EAAE,CAAC;AAChH,UAAO;IACL,GAAG;IACH,SAAS,CAAC,GAAI,SAAS,WAAW,OAAO,WAAW,EAAE,CAAE;IACxD,YAAY,sBAAsB,OAAO,IAAI,UAAU,KAAK;IAC7D;IAIQ;EACT,QAAQ,UAAU;EACnB"}

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

@@ -0,0 +1,19 @@
+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;
+}
+export interface CancelWorkflowRunCommand {
+    type: 'cancel_run';
+    runId: string;
+    reason?: string;
+}
+export interface ArchiveWorkflowRunCommand {
+    type: 'archive_run';
+    runId: string;
+}

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

@@ -0,0 +1 @@
+export {};

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/definition.d.ts

@@ -0,0 +1,62 @@
+export interface JsonSchema {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema | JsonSchema[];
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+    enum?: unknown[];
+    const?: unknown;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface WorkflowDefinition {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    version: string;
+    inputSchema?: JsonSchema;
+    outputSchema?: JsonSchema;
+    phases: WorkflowPhaseDefinition[];
+    runtime: WorkflowRuntimeDefinition;
+    defaults: WorkflowDefinitionDefaults;
+    metadata: WorkflowDefinitionMetadata;
+}
+export interface WorkflowPhaseDefinition {
+    id: string;
+    title: string;
+    description?: string;
+}
+export interface WorkflowRuntimeDefinition {
+    kind: 'script';
+    source: string;
+}
+export interface WorkflowDefinitionDefaults {
+    concurrency: number;
+    timeoutSec: number;
+    maxSubagents: number;
+}
+export interface WorkflowDefinitionEstimatedAgents {
+    min: number;
+    max: number;
+}
+export interface WorkflowDefinitionExamplePrompt {
+    field: string;
+    text: string;
+}
+export interface WorkflowDefinitionLocale {
+    description?: string;
+    whenToUse?: string;
+    examplePrompts?: WorkflowDefinitionExamplePrompt[];
+}
+export interface WorkflowDefinitionMetadata {
+    tags: string[];
+    builtIn: boolean;
+    source: 'builtin' | 'user';
+    whenToUse?: string;
+    estimatedAgents?: WorkflowDefinitionEstimatedAgents;
+    examplePrompts?: WorkflowDefinitionExamplePrompt[];
+    i18n?: Record<string, WorkflowDefinitionLocale>;
+    createdAtMs: number;
+    updatedAtMs: number;
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,67 @@
+import type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';
+import type { 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;
+    runId: string;
+    sequence: number;
+    type: WorkflowEventType;
+    payload: T;
+    createdAtMs: number;
+}
+export type WorkflowEventPayload = RunQueuedPayload | RunStartedPayload | PhaseStartedPayload | PhaseCompletedPayload | AgentQueuedPayload | AgentStartedPayload | AgentStepStartedPayload | AgentStepCompletedPayload | AgentCompletedPayload | LogAppendedPayload | ArtifactCreatedPayload | RunCompletedPayload | RunFailedPayload | RunCancelledPayload;
+export interface RunQueuedPayload {
+    run: WorkflowRun;
+}
+export interface RunStartedPayload {
+    startedAtMs: number;
+}
+export interface PhaseStartedPayload {
+    phaseId: string;
+    title: string;
+}
+export interface PhaseCompletedPayload {
+    phaseId: string;
+}
+export interface AgentQueuedPayload {
+    agentId: string;
+    label: string;
+    phaseId?: string;
+    prompt?: string;
+}
+export interface AgentStartedPayload {
+    agentId: string;
+}
+export interface AgentStepStartedPayload {
+    agentId: string;
+    stepId: string;
+    label: string;
+    kind: 'tool' | 'llm' | 'thinking';
+    detail?: string;
+}
+export interface AgentStepCompletedPayload {
+    agentId: string;
+    stepId: string;
+    status: 'done' | 'error';
+}
+export interface AgentCompletedPayload {
+    agentId: string;
+    status: 'done' | 'error' | 'skipped';
+    resultPreview?: string;
+    error?: string;
+}
+export interface LogAppendedPayload {
+    message: string;
+}
+export interface ArtifactCreatedPayload {
+    artifact: WorkflowArtifactRef;
+}
+export interface RunCompletedPayload {
+    result: WorkflowResultEnvelope;
+}
+export interface RunFailedPayload {
+    error: WorkflowRunError;
+}
+export interface RunCancelledPayload {
+    reason?: string;
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +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

@@ -0,0 +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";
+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/result.d.ts

@@ -0,0 +1,65 @@
+export interface WorkflowResultEnvelope {
+    title?: string;
+    summary: string;
+    sections: WorkflowResultSection[];
+    actions?: WorkflowNextAction[];
+    artifacts?: WorkflowArtifactRef[];
+    raw?: unknown;
+}
+export type WorkflowResultSection = WorkflowTextSection | WorkflowFindingsSection | WorkflowRisksSection | WorkflowQuestionsSection | WorkflowJsonSection;
+export interface WorkflowTextSection {
+    kind: 'text';
+    title: string;
+    content: string;
+}
+export interface WorkflowFindingsSection {
+    kind: 'findings';
+    title: string;
+    items: WorkflowFinding[];
+}
+export interface WorkflowRisksSection {
+    kind: 'risks';
+    title: string;
+    items: WorkflowRisk[];
+}
+export interface WorkflowQuestionsSection {
+    kind: 'questions';
+    title: string;
+    items: string[];
+}
+export interface WorkflowJsonSection {
+    kind: 'json';
+    title: string;
+    value: unknown;
+}
+export interface WorkflowFinding {
+    title: string;
+    severity?: WorkflowSeverity;
+    file?: string;
+    line?: number;
+    detail?: string;
+    recommendation?: string;
+}
+export interface WorkflowRisk {
+    title: string;
+    severity?: WorkflowSeverity;
+    likelihood?: 'low' | 'medium' | 'high';
+    impact?: string;
+    mitigation?: string;
+}
+export interface WorkflowNextAction {
+    id: string;
+    label: string;
+    kind: 'open_artifact' | 'copy_result' | 'start_followup' | 'custom';
+    payload?: unknown;
+}
+export interface WorkflowArtifactRef {
+    id: string;
+    runId: string;
+    name: string;
+    title?: string;
+    mimeType: string;
+    sizeBytes: number;
+    createdAtMs: number;
+}
+export type WorkflowSeverity = 'low' | 'medium' | 'high' | 'critical';

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,177 @@
+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;
+export interface WorkflowRun {
+    id: string;
+    definitionId: string;
+    definitionVersion: string;
+    title: string;
+    goal: string;
+    input: unknown;
+    status: WorkflowRunStatus;
+    source: WorkflowRunSource;
+    metadata?: WorkflowRunMetadata;
+    result?: WorkflowResultEnvelope;
+    error?: WorkflowRunError;
+    metrics: WorkflowRunMetrics;
+    createdAtMs: number;
+    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;
+    doneAgentCount: number;
+    errorAgentCount: number;
+    skippedAgentCount: number;
+    artifactCount: number;
+    durationMs?: number;
+}
+export interface WorkflowRunError {
+    code: WorkflowRunErrorCode;
+    message: string;
+    detail?: string;
+    recoverable: boolean;
+}
+export type WorkflowRunErrorCode = 'definition_not_found' | 'invalid_input' | 'runtime_error' | 'timeout' | 'cancelled' | 'result_validation_failed' | 'agent_quota_exceeded';
+export interface WorkflowRunControls {
+    canCancel: boolean;
+    canRetry: boolean;
+    canArchive: boolean;
+}
+export interface WorkflowRunSummary {
+    id: string;
+    definitionId: string;
+    title: string;
+    status: WorkflowRunStatus;
+    source: WorkflowRunSource;
+    metadata?: WorkflowRunMetadata;
+    createdAtMs: number;
+    startedAtMs?: number;
+    completedAtMs?: number;
+    metrics: WorkflowRunMetrics;
+}
+export interface WorkflowRunView {
+    run: WorkflowRun;
+    phases: WorkflowPhaseView[];
+    agents: WorkflowAgentView[];
+    logs: WorkflowLogEntry[];
+    artifacts: WorkflowArtifactRef[];
+    timeline: WorkflowTimelineItem[];
+    controls: WorkflowRunControls;
+}
+export type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface WorkflowPhaseView {
+    id: string;
+    title: string;
+    status: WorkflowPhaseStatus;
+    startedAtMs?: number;
+    completedAtMs?: number;
+    agentIds: string[];
+}
+export type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';
+export interface WorkflowAgentView {
+    id: string;
+    label: string;
+    phaseId?: string;
+    status: WorkflowAgentStatus;
+    prompt?: string;
+    currentStep?: string;
+    resultPreview?: string;
+    error?: string;
+    startedAtMs?: number;
+    completedAtMs?: number;
+    steps: WorkflowAgentStepView[];
+}
+export type WorkflowAgentStepStatus = 'running' | 'done' | 'error';
+export interface WorkflowAgentStepView {
+    id: string;
+    label: string;
+    kind: 'tool' | 'llm' | 'thinking';
+    detail?: string;
+    status: WorkflowAgentStepStatus;
+    startedAtMs?: number;
+    completedAtMs?: number;
+}
+export interface WorkflowLogEntry {
+    sequence: number;
+    message: string;
+    createdAtMs: number;
+}
+export interface WorkflowTimelineItem {
+    sequence: number;
+    type: string;
+    title: string;
+    createdAtMs: number;
+}