@xemahq/dsl 0.6.1 → 0.8.0

package/src/workflow/lib/types.ts

@@ -1,4 +1,7 @@
-import type { ConcurrencyMode, PermissionScope } from '@xemahq/kernel-contracts/workflow';
+import type {
+  ConcurrencyMode,
+  PermissionScope,
+} from '@xemahq/kernel-contracts/workflow';
 
 /**
  * Authored-shape TypeScript types for a Xema workflow document. These match
@@ -90,7 +93,8 @@ export interface WorkflowStructuredOutputDeclaration
   readonly schemaRef?: string;
 }
 
-export interface WorkflowTextOutputDeclaration extends WorkflowOutputDeclarationBase {
+export interface WorkflowTextOutputDeclaration
+  extends WorkflowOutputDeclarationBase {
   readonly kind: 'text';
 }
 
@@ -119,7 +123,12 @@ export interface WorkflowConnectorRequirement {
 
 export interface WorkflowMetadata {
   readonly name: string;
-  readonly version: string;
+  /**
+   * Compatibility version for an explicitly reusable public workflow API.
+   * Ordinary workflows omit this; their immutable revision is generated by
+   * the workflow registry.
+   */
+  readonly contractVersion?: string;
   readonly title?: string;
   readonly description?: string;
   readonly category?: string;
@@ -155,7 +164,13 @@ export interface WorkflowCallDeclaration {
 }
 
 export interface WorkflowInputDeclaration {
-  readonly type: 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array';
+  readonly type:
+    | 'string'
+    | 'number'
+    | 'integer'
+    | 'boolean'
+    | 'object'
+    | 'array';
   readonly required?: boolean;
   readonly default?: unknown;
   readonly description?: string;
@@ -207,7 +222,12 @@ export interface WorkflowRetryDeclaration {
   readonly nonRetryableErrorTypes?: readonly string[];
 }
 
-export type WorkflowPermissions = Partial<Record<'repos' | 'kb' | 'backlog' | 'connectors' | 'artifacts' | 'memory', PermissionScope>>;
+export type WorkflowPermissions = Partial<
+  Record<
+    'repos' | 'kb' | 'backlog' | 'connectors' | 'artifacts' | 'memory',
+    PermissionScope
+  >
+>;
 
 export interface WorkflowJobDeclaration {
   readonly title?: string;
@@ -224,8 +244,14 @@ export interface WorkflowJobDeclaration {
 }
 
 export type WorkflowStrategyDeclaration =
-  | { readonly matrix: Readonly<Record<string, readonly unknown[]>>; readonly maxParallel?: number }
-  | { readonly dynamic: WorkflowDynamicStrategyDeclaration; readonly maxParallel?: number };
+  | {
+      readonly matrix: Readonly<Record<string, readonly unknown[]>>;
+      readonly maxParallel?: number;
+    }
+  | {
+      readonly dynamic: WorkflowDynamicStrategyDeclaration;
+      readonly maxParallel?: number;
+    };
 
 export interface WorkflowDynamicStrategyDeclaration {
   readonly from: string;
@@ -307,7 +333,11 @@ export interface ActionManifestSpec {
   readonly allowedMounts?: readonly string[];
   readonly retryDefaults: ActionManifestRetryDefaults;
   readonly timeoutDefaults: ActionManifestTimeoutDefaults;
-  readonly auditEventMapping?: Partial<{ started: string; succeeded: string; failed: string }>;
+  readonly auditEventMapping?: Partial<{
+    started: string;
+    succeeded: string;
+    failed: string;
+  }>;
   /**
    * Declarative contracts the action opts into. The DSL compiler reads
    * this list to decide which validation lanes apply — e.g. the