@bluefly/openstandardagents 0.2.8 → 0.3.0

package/dist/types/task.d.ts

@@ -0,0 +1,222 @@
+/**
+ * OSSA Task Types
+ * Type definitions for kind: Task - deterministic workflow steps
+ */
+/**
+ * Execution type for tasks
+ */
+export type TaskExecutionType = 'deterministic' | 'idempotent' | 'transactional';
+/**
+ * Backoff strategy for retries
+ */
+export type BackoffStrategy = 'fixed' | 'exponential' | 'linear';
+/**
+ * Error handling action
+ */
+export type ErrorAction = 'fail' | 'retry' | 'fallback' | 'ignore';
+/**
+ * Batch item error handling
+ */
+export type BatchItemErrorAction = 'skip' | 'fail' | 'retry';
+/**
+ * Task execution configuration
+ */
+export interface TaskExecution {
+    /** Execution type: deterministic, idempotent, or transactional */
+    type: TaskExecutionType;
+    /** Target runtime environment (drupal, symfony, node, python, any) */
+    runtime?: string;
+    /** Entry point for execution (class::method, function name, or script path) */
+    entrypoint?: string;
+    /** Maximum execution time in seconds */
+    timeout_seconds?: number;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    max_attempts?: number;
+    /** Backoff strategy between retries */
+    backoff_strategy?: BackoffStrategy;
+    /** Initial delay in milliseconds */
+    initial_delay_ms?: number;
+}
+/**
+ * Batch processing configuration
+ */
+export interface TaskBatchConfig {
+    /** Enable batch processing mode */
+    enabled?: boolean;
+    /** Maximum parallel executions */
+    parallelism?: number;
+    /** Items per batch chunk */
+    chunk_size?: number;
+    /** Retry configuration */
+    retry?: RetryConfig;
+    /** Behavior when individual item fails */
+    on_item_error?: BatchItemErrorAction;
+}
+/**
+ * Task dependency reference
+ */
+export interface TaskDependency {
+    /** Reference to dependency (file path or name) */
+    ref: string;
+    /** Kind of dependency */
+    kind?: 'Task' | 'Agent';
+    /** Whether this dependency is optional */
+    optional?: boolean;
+}
+/**
+ * Condition expression
+ */
+export interface TaskCondition {
+    /** Condition expression (e.g., '${{ input.status == "draft" }}') */
+    expression: string;
+    /** Error message if condition fails */
+    error_message?: string;
+}
+/**
+ * Error handling configuration
+ */
+export interface TaskErrorHandling {
+    /** Action on error */
+    on_error?: ErrorAction;
+    /** Reference to fallback task on failure */
+    fallback_task?: string;
+    /** Map error codes to actions */
+    error_mapping?: Record<string, ErrorAction>;
+}
+/**
+ * Logging configuration
+ */
+export interface TaskLogging {
+    /** Log level */
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    /** Log input data (caution: may contain sensitive data) */
+    include_input?: boolean;
+    /** Log output data */
+    include_output?: boolean;
+}
+/**
+ * Metrics configuration
+ */
+export interface TaskMetrics {
+    /** Enable metrics */
+    enabled?: boolean;
+    /** Custom metric labels */
+    custom_labels?: Record<string, string>;
+}
+/**
+ * Tracing configuration
+ */
+export interface TaskTracing {
+    /** Enable tracing */
+    enabled?: boolean;
+    /** Sample rate (0-1) */
+    sample_rate?: number;
+}
+/**
+ * Task observability configuration
+ */
+export interface TaskObservability {
+    /** Logging configuration */
+    logging?: TaskLogging;
+    /** Metrics configuration */
+    metrics?: TaskMetrics;
+    /** Tracing configuration */
+    tracing?: TaskTracing;
+}
+/**
+ * JSON Schema definition (simplified)
+ */
+export interface JSONSchemaDefinition {
+    type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    properties?: Record<string, unknown>;
+    required?: string[];
+    items?: Record<string, unknown>;
+    additionalProperties?: boolean | Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * TaskSpec - Specification for deterministic workflow steps (kind: Task)
+ */
+export interface TaskSpec {
+    /** Execution configuration */
+    execution: TaskExecution;
+    /** Abstract capabilities this task requires */
+    capabilities?: string[];
+    /** JSON Schema for task input validation */
+    input?: JSONSchemaDefinition;
+    /** JSON Schema for task output validation */
+    output?: JSONSchemaDefinition;
+    /** Batch processing configuration */
+    batch?: TaskBatchConfig;
+    /** Task dependencies */
+    dependencies?: TaskDependency[];
+    /** Conditions that must be true before execution */
+    preconditions?: TaskCondition[];
+    /** Conditions that must be true after execution */
+    postconditions?: TaskCondition[];
+    /** Error handling configuration */
+    error_handling?: TaskErrorHandling;
+    /** Observability configuration */
+    observability?: TaskObservability;
+}
+/**
+ * Runtime capability binding
+ */
+export interface CapabilityBinding {
+    /** Handler class/function */
+    handler?: string;
+    /** MCP server name for MCP-based bindings */
+    mcp_server?: string;
+    /** Tool name within MCP server */
+    tool?: string;
+    /** Additional binding configuration */
+    config?: Record<string, unknown>;
+}
+/**
+ * Runtime binding configuration
+ */
+export interface RuntimeBinding {
+    /** Runtime type identifier */
+    type?: string;
+    /** Message transport for async runtimes */
+    transport?: string;
+    /** Map of capability names to runtime-specific handlers */
+    bindings?: Record<string, CapabilityBinding>;
+}
+/**
+ * OSSA Task manifest (kind: Task)
+ */
+export interface OssaTask {
+    /** OSSA API version */
+    apiVersion: string;
+    /** Resource type - must be 'Task' */
+    kind: 'Task';
+    /** Task metadata */
+    metadata: {
+        name: string;
+        version?: string;
+        description?: string;
+        labels?: Record<string, string>;
+        annotations?: Record<string, string>;
+    };
+    /** Task specification */
+    spec: TaskSpec;
+    /** Framework-specific extensions */
+    extensions?: Record<string, unknown>;
+    /** Runtime capability bindings */
+    runtime?: RuntimeBinding;
+}
+/**
+ * Type guard to check if manifest is a Task
+ */
+export declare function isOssaTask(manifest: unknown): manifest is OssaTask;
+/**
+ * Create an empty Task manifest with defaults
+ */
+export declare function createTaskManifest(name: string, options?: Partial<OssaTask>): OssaTask;
+//# sourceMappingURL=task.d.ts.map

package/dist/types/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,YAAY,GAAG,eAAe,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,IAAI,EAAE,iBAAiB,CAAC;IACxB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5C,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sBAAsB;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,qCAAqC;IACrC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,wBAAwB;IACxB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,oDAAoD;IACpD,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,mDAAmD;IACnD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,mCAAmC;IACnC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,kCAAkC;IAClC,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC,CAAC;IACF,yBAAyB;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,kCAAkC;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAOlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAqBtF"}

package/dist/types/task.js

@@ -0,0 +1,40 @@
+/**
+ * OSSA Task Types
+ * Type definitions for kind: Task - deterministic workflow steps
+ */
+import { getApiVersion } from '../utils/version.js';
+/**
+ * Type guard to check if manifest is a Task
+ */
+export function isOssaTask(manifest) {
+    return (typeof manifest === 'object' &&
+        manifest !== null &&
+        'kind' in manifest &&
+        manifest.kind === 'Task');
+}
+/**
+ * Create an empty Task manifest with defaults
+ */
+export function createTaskManifest(name, options) {
+    return {
+        apiVersion: getApiVersion(),
+        kind: 'Task',
+        metadata: {
+            name,
+            version: '1.0.0',
+            ...options?.metadata,
+        },
+        spec: {
+            execution: {
+                type: 'deterministic',
+                runtime: 'any',
+                timeout_seconds: 300,
+            },
+            capabilities: [],
+            ...options?.spec,
+        },
+        extensions: options?.extensions,
+        runtime: options?.runtime,
+    };
+}
+//# sourceMappingURL=task.js.map

package/dist/types/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsOpD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAiB;IAC1C,OAAO,CACL,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,MAAM,IAAI,QAAQ;QACjB,QAAoC,CAAC,IAAI,KAAK,MAAM,CACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAA2B;IAC1E,OAAO;QACL,UAAU,EAAE,aAAa,EAAE;QAC3B,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE;YACR,IAAI;YACJ,OAAO,EAAE,OAAO;YAChB,GAAG,OAAO,EAAE,QAAQ;SACrB;QACD,IAAI,EAAE;YACJ,SAAS,EAAE;gBACT,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,GAAG;aACrB;YACD,YAAY,EAAE,EAAE;YAChB,GAAG,OAAO,EAAE,IAAI;SACjB;QACD,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,OAAO,EAAE,OAAO,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dist/types/workflow.d.ts

@@ -0,0 +1,283 @@
+/**
+ * OSSA Workflow Types
+ * Type definitions for kind: Workflow - composition of Tasks and Agents
+ */
+import { JSONSchemaDefinition } from './task';
+/**
+ * Trigger types
+ */
+export type TriggerType = 'webhook' | 'cron' | 'event' | 'manual';
+/**
+ * Workflow step kinds
+ */
+export type WorkflowStepKind = 'Task' | 'Agent' | 'Parallel' | 'Conditional' | 'Loop';
+/**
+ * Failure handling actions
+ */
+export type FailureAction = 'halt' | 'continue' | 'rollback' | 'notify' | 'compensate';
+/**
+ * Step error actions
+ */
+export type StepErrorAction = 'fail' | 'continue' | 'goto' | 'compensate';
+/**
+ * Notification channels
+ */
+export type NotificationChannel = 'email' | 'slack' | 'webhook' | 'pagerduty';
+/**
+ * Workflow trigger configuration
+ */
+export interface WorkflowTrigger {
+    /** Trigger type */
+    type: TriggerType;
+    /** Webhook path (for type=webhook) */
+    path?: string;
+    /** Cron expression (for type=cron) */
+    schedule?: string;
+    /** Event source (for type=event) */
+    source?: string;
+    /** Event name (for type=event) */
+    event?: string;
+    /** Event filter conditions */
+    filter?: Record<string, unknown>;
+}
+/**
+ * Secret reference
+ */
+export interface SecretRef {
+    /** Secret name available to steps */
+    name: string;
+    /** Secret reference (e.g., vault://secret/api-key) */
+    ref: string;
+}
+/**
+ * Workflow context configuration
+ */
+export interface WorkflowContext {
+    /** Workflow-level variables */
+    variables?: Record<string, unknown>;
+    /** Secret references available to steps */
+    secrets?: SecretRef[];
+}
+/**
+ * Concurrency control
+ */
+export interface WorkflowConcurrency {
+    /** Concurrency group name */
+    group?: string;
+    /** Cancel running workflow if new one starts in same group */
+    cancel_in_progress?: boolean;
+}
+/**
+ * Retry policy
+ */
+export interface RetryPolicy {
+    /** Maximum retry attempts */
+    max_attempts?: number;
+    /** Backoff strategy */
+    backoff?: 'fixed' | 'exponential' | 'linear';
+    /** Initial delay in milliseconds */
+    initial_delay_ms?: number;
+    /** Maximum delay in milliseconds */
+    max_delay_ms?: number;
+}
+/**
+ * Failure notification configuration
+ */
+export interface FailureNotification {
+    /** Notification channels */
+    channels?: NotificationChannel[];
+    /** Notification template reference */
+    template?: string;
+}
+/**
+ * Workflow error handling configuration
+ */
+export interface WorkflowErrorHandling {
+    /** Action on step failure */
+    on_failure?: FailureAction;
+    /** Steps to run on rollback/compensate */
+    compensation_steps?: WorkflowStep[];
+    /** Notification on failure */
+    notification?: FailureNotification;
+    /** Retry policy */
+    retry_policy?: RetryPolicy;
+}
+/**
+ * Workflow observability configuration
+ */
+export interface WorkflowObservability {
+    /** Tracing configuration */
+    tracing?: {
+        enabled?: boolean;
+        propagate_context?: boolean;
+    };
+    /** Metrics configuration */
+    metrics?: {
+        enabled?: boolean;
+        custom_labels?: Record<string, string>;
+    };
+    /** Logging configuration */
+    logging?: {
+        level?: 'debug' | 'info' | 'warn' | 'error';
+    };
+}
+/**
+ * Step output mapping
+ */
+export interface StepOutputMapping {
+    /** Variable name to store output */
+    to?: string;
+    /** Specific fields to extract from output */
+    fields?: string[];
+}
+/**
+ * Step retry configuration
+ */
+export interface StepRetry {
+    /** Maximum retry attempts */
+    max_attempts?: number;
+    /** Backoff strategy */
+    backoff_strategy?: 'fixed' | 'exponential' | 'linear';
+    /** Initial delay in milliseconds */
+    initial_delay_ms?: number;
+    /** Error codes that should trigger retry */
+    retryable_errors?: string[];
+}
+/**
+ * Step error handling
+ */
+export interface StepErrorHandling {
+    /** Action on error */
+    action?: StepErrorAction;
+    /** Step ID to jump to on error (for action: goto) */
+    goto?: string;
+    /** Compensation step to run on error */
+    compensation?: WorkflowStep;
+}
+/**
+ * Loop configuration
+ */
+export interface LoopConfig {
+    /** Expression returning array to iterate over */
+    over: string;
+    /** Variable name for current item */
+    as?: string;
+    /** Variable name for current index */
+    index?: string;
+    /** Maximum parallel iterations */
+    parallelism?: number;
+}
+/**
+ * Conditional branch
+ */
+export interface ConditionalBranch {
+    /** Branch condition expression */
+    condition: string;
+    /** Steps to run if condition matches */
+    steps: WorkflowStep[];
+}
+/**
+ * Workflow step
+ */
+export interface WorkflowStep {
+    /** Step identifier (unique within workflow) */
+    id: string;
+    /** Human-readable step name */
+    name?: string;
+    /** Step type */
+    kind?: WorkflowStepKind;
+    /** Reference to Task or Agent manifest file */
+    ref?: string;
+    /** Inline Task or Agent specification */
+    inline?: Record<string, unknown>;
+    /** Input mapping using expression syntax */
+    input?: Record<string, unknown>;
+    /** Output mapping to workflow context */
+    output?: StepOutputMapping;
+    /** Condition expression for conditional execution */
+    condition?: string;
+    /** Explicit dependencies on other steps */
+    depends_on?: string[];
+    /** Steps to run in parallel (for kind: Parallel) */
+    parallel?: WorkflowStep[];
+    /** Conditional branches (for kind: Conditional) */
+    branches?: ConditionalBranch[];
+    /** Steps to run if no branch condition matches */
+    else?: WorkflowStep[];
+    /** Loop configuration (for kind: Loop) */
+    loop?: LoopConfig;
+    /** Nested steps (for Loop and Conditional kinds) */
+    steps?: WorkflowStep[];
+    /** Step-specific retry configuration */
+    retry?: StepRetry;
+    /** Step-specific timeout in seconds */
+    timeout_seconds?: number;
+    /** Continue workflow even if this step fails */
+    continue_on_error?: boolean;
+    /** Step-specific error handling */
+    on_error?: StepErrorHandling;
+    /** Step labels for filtering */
+    labels?: Record<string, string>;
+}
+/**
+ * WorkflowSpec - Specification for workflow composition (kind: Workflow)
+ */
+export interface WorkflowSpec {
+    /** Triggers that start the workflow */
+    triggers?: WorkflowTrigger[];
+    /** JSON Schema for workflow input validation */
+    inputs?: JSONSchemaDefinition;
+    /** JSON Schema for workflow output validation */
+    outputs?: JSONSchemaDefinition;
+    /** Workflow steps */
+    steps: WorkflowStep[];
+    /** Shared context available to all steps */
+    context?: WorkflowContext;
+    /** Concurrency control */
+    concurrency?: WorkflowConcurrency;
+    /** Workflow-level error handling */
+    error_handling?: WorkflowErrorHandling;
+    /** Maximum workflow execution time in seconds */
+    timeout_seconds?: number;
+    /** Workflow observability configuration */
+    observability?: WorkflowObservability;
+}
+/**
+ * OSSA Workflow manifest (kind: Workflow)
+ */
+export interface OssaWorkflow {
+    /** OSSA API version */
+    apiVersion: string;
+    /** Resource type - must be 'Workflow' */
+    kind: 'Workflow';
+    /** Workflow metadata */
+    metadata: {
+        name: string;
+        version?: string;
+        description?: string;
+        labels?: Record<string, string>;
+        annotations?: Record<string, string>;
+    };
+    /** Workflow specification */
+    spec: WorkflowSpec;
+    /** Framework-specific extensions */
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Type guard to check if manifest is a Workflow
+ */
+export declare function isOssaWorkflow(manifest: unknown): manifest is OssaWorkflow;
+/**
+ * Create an empty Workflow manifest with defaults
+ */
+export declare function createWorkflowManifest(name: string, options?: Partial<OssaWorkflow>): OssaWorkflow;
+/**
+ * Helper to create a workflow step
+ */
+export declare function createStep(id: string, kind: WorkflowStepKind, options?: Partial<WorkflowStep>): WorkflowStep;
+/**
+ * Helper to create an expression reference
+ * @example expr('steps.fetch.output.content') => '${{ steps.fetch.output.content }}'
+ */
+export declare function expr(path: string): string;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/types/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":"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"}

package/dist/types/workflow.js

@@ -0,0 +1,51 @@
+/**
+ * OSSA Workflow Types
+ * Type definitions for kind: Workflow - composition of Tasks and Agents
+ */
+import { getApiVersion } from '../utils/version.js';
+/**
+ * Type guard to check if manifest is a Workflow
+ */
+export function isOssaWorkflow(manifest) {
+    return (typeof manifest === 'object' &&
+        manifest !== null &&
+        'kind' in manifest &&
+        manifest.kind === 'Workflow');
+}
+/**
+ * Create an empty Workflow manifest with defaults
+ */
+export function createWorkflowManifest(name, options) {
+    return {
+        apiVersion: getApiVersion(),
+        kind: 'Workflow',
+        metadata: {
+            name,
+            version: '1.0.0',
+            ...options?.metadata,
+        },
+        spec: {
+            steps: [],
+            ...options?.spec,
+        },
+        extensions: options?.extensions,
+    };
+}
+/**
+ * Helper to create a workflow step
+ */
+export function createStep(id, kind, options) {
+    return {
+        id,
+        kind,
+        ...options,
+    };
+}
+/**
+ * Helper to create an expression reference
+ * @example expr('steps.fetch.output.content') => '${{ steps.fetch.output.content }}'
+ */
+export function expr(path) {
+    return `\${{ ${path} }}`;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/types/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA2RpD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,OAAO,CACL,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,MAAM,IAAI,QAAQ;QACjB,QAAoC,CAAC,IAAI,KAAK,UAAU,CAC1D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,OAA+B;IAE/B,OAAO;QACL,UAAU,EAAE,aAAa,EAAE;QAC3B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI;YACJ,OAAO,EAAE,OAAO;YAChB,GAAG,OAAO,EAAE,QAAQ;SACrB;QACD,IAAI,EAAE;YACJ,KAAK,EAAE,EAAE;YACT,GAAG,OAAO,EAAE,IAAI;SACjB;QACD,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,EAAU,EACV,IAAsB,EACtB,OAA+B;IAE/B,OAAO;QACL,EAAE;QACF,IAAI;QACJ,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,QAAQ,IAAI,KAAK,CAAC;AAC3B,CAAC"}

package/dist/utils/path-validator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Path Validation Utility
+ * Prevents path traversal attacks and validates file access
+ */
+export declare class PathValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates a file path for security and existence
+ * @param filePath - The file path to validate
+ * @param basePath - Optional base path to restrict access (defaults to null for no restriction)
+ * @returns Absolute, validated file path
+ * @throws PathValidationError if path is invalid or inaccessible
+ */
+export declare function validateFilePath(filePath: string, basePath?: string | null): string;
+/**
+ * Validates a directory path for security and existence
+ * @param dirPath - The directory path to validate
+ * @param basePath - Optional base path to restrict access (defaults to null for no restriction)
+ * @returns Absolute, validated directory path
+ * @throws PathValidationError if path is invalid or inaccessible
+ */
+export declare function validateDirectoryPath(dirPath: string, basePath?: string | null): string;
+//# sourceMappingURL=path-validator.d.ts.map

package/dist/utils/path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-validator.d.ts","sourceRoot":"","sources":["../../src/utils/path-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CA2BzF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CA0B7F"}