@marktoflow/core 2.0.0-alpha.3

package/dist/models.d.ts

@@ -0,0 +1,419 @@
+/**
+ * Core data models for marktoflow v2.0
+ *
+ * These models define the structure of workflows, steps, and execution context.
+ * Uses Zod for runtime validation.
+ */
+import { z } from 'zod';
+export declare const StepStatus: {
+    readonly PENDING: "pending";
+    readonly RUNNING: "running";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+    readonly SKIPPED: "skipped";
+};
+export type StepStatus = (typeof StepStatus)[keyof typeof StepStatus];
+export declare const WorkflowStatus: {
+    readonly PENDING: "pending";
+    readonly RUNNING: "running";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+    readonly CANCELLED: "cancelled";
+};
+export type WorkflowStatus = (typeof WorkflowStatus)[keyof typeof WorkflowStatus];
+export declare const TriggerType: {
+    readonly MANUAL: "manual";
+    readonly SCHEDULE: "schedule";
+    readonly WEBHOOK: "webhook";
+    readonly EVENT: "event";
+};
+export type TriggerType = (typeof TriggerType)[keyof typeof TriggerType];
+export declare const WorkflowMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    version: string;
+    description?: string | undefined;
+    author?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    id: string;
+    name: string;
+    version?: string | undefined;
+    description?: string | undefined;
+    author?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+export declare const ToolConfigSchema: z.ZodObject<{
+    sdk: z.ZodString;
+    auth: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    sdk: string;
+    options?: Record<string, unknown> | undefined;
+    auth?: Record<string, string> | undefined;
+}, {
+    sdk: string;
+    options?: Record<string, unknown> | undefined;
+    auth?: Record<string, string> | undefined;
+}>;
+export declare const ErrorHandlingSchema: z.ZodObject<{
+    action: z.ZodDefault<z.ZodEnum<["continue", "stop", "rollback"]>>;
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+    retryDelaySeconds: z.ZodDefault<z.ZodNumber>;
+    fallbackAction: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "continue" | "stop" | "rollback";
+    maxRetries: number;
+    retryDelaySeconds: number;
+    fallbackAction?: string | undefined;
+}, {
+    action?: "continue" | "stop" | "rollback" | undefined;
+    maxRetries?: number | undefined;
+    retryDelaySeconds?: number | undefined;
+    fallbackAction?: string | undefined;
+}>;
+export declare const WorkflowStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    action: z.ZodString;
+    inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    outputVariable: z.ZodOptional<z.ZodString>;
+    conditions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    errorHandling: z.ZodOptional<z.ZodObject<{
+        action: z.ZodDefault<z.ZodEnum<["continue", "stop", "rollback"]>>;
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+        retryDelaySeconds: z.ZodDefault<z.ZodNumber>;
+        fallbackAction: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        action: "continue" | "stop" | "rollback";
+        maxRetries: number;
+        retryDelaySeconds: number;
+        fallbackAction?: string | undefined;
+    }, {
+        action?: "continue" | "stop" | "rollback" | undefined;
+        maxRetries?: number | undefined;
+        retryDelaySeconds?: number | undefined;
+        fallbackAction?: string | undefined;
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: string;
+    inputs: Record<string, unknown>;
+    name?: string | undefined;
+    outputVariable?: string | undefined;
+    conditions?: string[] | undefined;
+    errorHandling?: {
+        action: "continue" | "stop" | "rollback";
+        maxRetries: number;
+        retryDelaySeconds: number;
+        fallbackAction?: string | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+}, {
+    id: string;
+    action: string;
+    name?: string | undefined;
+    inputs?: Record<string, unknown> | undefined;
+    outputVariable?: string | undefined;
+    conditions?: string[] | undefined;
+    errorHandling?: {
+        action?: "continue" | "stop" | "rollback" | undefined;
+        maxRetries?: number | undefined;
+        retryDelaySeconds?: number | undefined;
+        fallbackAction?: string | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+}>;
+export declare const TriggerSchema: z.ZodObject<{
+    type: z.ZodEnum<["manual", "schedule", "webhook", "event"]>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "manual" | "schedule" | "webhook" | "event";
+    enabled: boolean;
+    config: Record<string, unknown>;
+}, {
+    type: "manual" | "schedule" | "webhook" | "event";
+    enabled?: boolean | undefined;
+    config?: Record<string, unknown> | undefined;
+}>;
+export declare const WorkflowInputSchema: z.ZodObject<{
+    type: z.ZodEnum<["string", "number", "boolean", "array", "object"]>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    description: z.ZodOptional<z.ZodString>;
+    validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    required: boolean;
+    description?: string | undefined;
+    validation?: Record<string, unknown> | undefined;
+    default?: unknown;
+}, {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    description?: string | undefined;
+    validation?: Record<string, unknown> | undefined;
+    required?: boolean | undefined;
+    default?: unknown;
+}>;
+export declare const WorkflowSchema: z.ZodObject<{
+    metadata: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodDefault<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        version: string;
+        description?: string | undefined;
+        author?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        id: string;
+        name: string;
+        version?: string | undefined;
+        description?: string | undefined;
+        author?: string | undefined;
+        tags?: string[] | undefined;
+    }>;
+    tools: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        sdk: z.ZodString;
+        auth: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        sdk: string;
+        options?: Record<string, unknown> | undefined;
+        auth?: Record<string, string> | undefined;
+    }, {
+        sdk: string;
+        options?: Record<string, unknown> | undefined;
+        auth?: Record<string, string> | undefined;
+    }>>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<["string", "number", "boolean", "array", "object"]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        description: z.ZodOptional<z.ZodString>;
+        validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        required: boolean;
+        description?: string | undefined;
+        validation?: Record<string, unknown> | undefined;
+        default?: unknown;
+    }, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        description?: string | undefined;
+        validation?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        default?: unknown;
+    }>>>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["manual", "schedule", "webhook", "event"]>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "manual" | "schedule" | "webhook" | "event";
+        enabled: boolean;
+        config: Record<string, unknown>;
+    }, {
+        type: "manual" | "schedule" | "webhook" | "event";
+        enabled?: boolean | undefined;
+        config?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        action: z.ZodString;
+        inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        outputVariable: z.ZodOptional<z.ZodString>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        errorHandling: z.ZodOptional<z.ZodObject<{
+            action: z.ZodDefault<z.ZodEnum<["continue", "stop", "rollback"]>>;
+            maxRetries: z.ZodDefault<z.ZodNumber>;
+            retryDelaySeconds: z.ZodDefault<z.ZodNumber>;
+            fallbackAction: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            action: "continue" | "stop" | "rollback";
+            maxRetries: number;
+            retryDelaySeconds: number;
+            fallbackAction?: string | undefined;
+        }, {
+            action?: "continue" | "stop" | "rollback" | undefined;
+            maxRetries?: number | undefined;
+            retryDelaySeconds?: number | undefined;
+            fallbackAction?: string | undefined;
+        }>>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        action: string;
+        inputs: Record<string, unknown>;
+        name?: string | undefined;
+        outputVariable?: string | undefined;
+        conditions?: string[] | undefined;
+        errorHandling?: {
+            action: "continue" | "stop" | "rollback";
+            maxRetries: number;
+            retryDelaySeconds: number;
+            fallbackAction?: string | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+    }, {
+        id: string;
+        action: string;
+        name?: string | undefined;
+        inputs?: Record<string, unknown> | undefined;
+        outputVariable?: string | undefined;
+        conditions?: string[] | undefined;
+        errorHandling?: {
+            action?: "continue" | "stop" | "rollback" | undefined;
+            maxRetries?: number | undefined;
+            retryDelaySeconds?: number | undefined;
+            fallbackAction?: string | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+    }>, "many">;
+    rawContent: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    metadata: {
+        id: string;
+        name: string;
+        version: string;
+        description?: string | undefined;
+        author?: string | undefined;
+        tags?: string[] | undefined;
+    };
+    tools: Record<string, {
+        sdk: string;
+        options?: Record<string, unknown> | undefined;
+        auth?: Record<string, string> | undefined;
+    }>;
+    steps: {
+        id: string;
+        action: string;
+        inputs: Record<string, unknown>;
+        name?: string | undefined;
+        outputVariable?: string | undefined;
+        conditions?: string[] | undefined;
+        errorHandling?: {
+            action: "continue" | "stop" | "rollback";
+            maxRetries: number;
+            retryDelaySeconds: number;
+            fallbackAction?: string | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+    }[];
+    inputs?: Record<string, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        required: boolean;
+        description?: string | undefined;
+        validation?: Record<string, unknown> | undefined;
+        default?: unknown;
+    }> | undefined;
+    triggers?: {
+        type: "manual" | "schedule" | "webhook" | "event";
+        enabled: boolean;
+        config: Record<string, unknown>;
+    }[] | undefined;
+    rawContent?: string | undefined;
+}, {
+    metadata: {
+        id: string;
+        name: string;
+        version?: string | undefined;
+        description?: string | undefined;
+        author?: string | undefined;
+        tags?: string[] | undefined;
+    };
+    steps: {
+        id: string;
+        action: string;
+        name?: string | undefined;
+        inputs?: Record<string, unknown> | undefined;
+        outputVariable?: string | undefined;
+        conditions?: string[] | undefined;
+        errorHandling?: {
+            action?: "continue" | "stop" | "rollback" | undefined;
+            maxRetries?: number | undefined;
+            retryDelaySeconds?: number | undefined;
+            fallbackAction?: string | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+    }[];
+    inputs?: Record<string, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        description?: string | undefined;
+        validation?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        default?: unknown;
+    }> | undefined;
+    tools?: Record<string, {
+        sdk: string;
+        options?: Record<string, unknown> | undefined;
+        auth?: Record<string, string> | undefined;
+    }> | undefined;
+    triggers?: {
+        type: "manual" | "schedule" | "webhook" | "event";
+        enabled?: boolean | undefined;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    rawContent?: string | undefined;
+}>;
+export type WorkflowMetadata = z.infer<typeof WorkflowMetadataSchema>;
+export type ToolConfig = z.infer<typeof ToolConfigSchema>;
+export type ErrorHandling = z.infer<typeof ErrorHandlingSchema>;
+export type WorkflowStep = z.infer<typeof WorkflowStepSchema>;
+export type Trigger = z.infer<typeof TriggerSchema>;
+export type WorkflowInput = z.infer<typeof WorkflowInputSchema>;
+export type Workflow = z.infer<typeof WorkflowSchema>;
+export interface ExecutionContext {
+    workflowId: string;
+    runId: string;
+    variables: Record<string, unknown>;
+    inputs: Record<string, unknown>;
+    startedAt: Date;
+    currentStepIndex: number;
+    status: WorkflowStatus;
+    stepMetadata: Record<string, {
+        status: string;
+        error?: string;
+        retryCount: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface StepResult {
+    stepId: string;
+    status: StepStatus;
+    output: unknown;
+    error: string | undefined;
+    startedAt: Date;
+    completedAt: Date;
+    duration: number;
+    retryCount: number;
+}
+export interface WorkflowResult {
+    workflowId: string;
+    runId: string;
+    status: WorkflowStatus;
+    stepResults: StepResult[];
+    output: Record<string, unknown>;
+    error: string | undefined;
+    startedAt: Date;
+    completedAt: Date;
+    duration: number;
+}
+export declare function createExecutionContext(workflow: Workflow, inputs?: Record<string, unknown>): ExecutionContext;
+export declare function createStepResult(stepId: string, status: StepStatus, output: unknown, startedAt: Date, retryCount?: number, error?: string): StepResult;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

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

package/dist/models.js

@@ -0,0 +1,111 @@
+/**
+ * Core data models for marktoflow v2.0
+ *
+ * These models define the structure of workflows, steps, and execution context.
+ * Uses Zod for runtime validation.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Enums
+// ============================================================================
+export const StepStatus = {
+    PENDING: 'pending',
+    RUNNING: 'running',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+    SKIPPED: 'skipped',
+};
+export const WorkflowStatus = {
+    PENDING: 'pending',
+    RUNNING: 'running',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+    CANCELLED: 'cancelled',
+};
+export const TriggerType = {
+    MANUAL: 'manual',
+    SCHEDULE: 'schedule',
+    WEBHOOK: 'webhook',
+    EVENT: 'event',
+};
+// ============================================================================
+// Zod Schemas
+// ============================================================================
+export const WorkflowMetadataSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string().default('1.0.0'),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+});
+export const ToolConfigSchema = z.object({
+    sdk: z.string(), // e.g., "@slack/web-api"
+    auth: z.record(z.string()).optional(), // e.g., { token: "${SLACK_TOKEN}" }
+    options: z.record(z.unknown()).optional(),
+});
+export const ErrorHandlingSchema = z.object({
+    action: z.enum(['continue', 'stop', 'rollback']).default('stop'),
+    maxRetries: z.number().default(3),
+    retryDelaySeconds: z.number().default(1.0),
+    fallbackAction: z.string().optional(),
+});
+export const WorkflowStepSchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    action: z.string(), // e.g., "slack.chat.postMessage"
+    inputs: z.record(z.unknown()).default({}),
+    outputVariable: z.string().optional(),
+    conditions: z.array(z.string()).optional(),
+    errorHandling: ErrorHandlingSchema.optional(),
+    timeout: z.number().optional(), // seconds
+});
+export const TriggerSchema = z.object({
+    type: z.enum(['manual', 'schedule', 'webhook', 'event']),
+    enabled: z.boolean().default(true),
+    config: z.record(z.unknown()).default({}),
+});
+export const WorkflowInputSchema = z.object({
+    type: z.enum(['string', 'number', 'boolean', 'array', 'object']),
+    required: z.boolean().default(false),
+    default: z.unknown().optional(),
+    description: z.string().optional(),
+    validation: z.record(z.unknown()).optional(),
+});
+export const WorkflowSchema = z.object({
+    metadata: WorkflowMetadataSchema,
+    tools: z.record(ToolConfigSchema).default({}),
+    inputs: z.record(WorkflowInputSchema).optional(),
+    triggers: z.array(TriggerSchema).optional(),
+    steps: z.array(WorkflowStepSchema),
+    rawContent: z.string().optional(), // Original markdown content
+});
+// ============================================================================
+// Helper Functions
+// ============================================================================
+export function createExecutionContext(workflow, inputs = {}) {
+    return {
+        workflowId: workflow.metadata.id,
+        runId: crypto.randomUUID(),
+        variables: {},
+        inputs,
+        startedAt: new Date(),
+        currentStepIndex: 0,
+        status: WorkflowStatus.PENDING,
+        stepMetadata: {},
+    };
+}
+export function createStepResult(stepId, status, output, startedAt, retryCount = 0, error) {
+    const completedAt = new Date();
+    return {
+        stepId,
+        status,
+        output,
+        error,
+        startedAt,
+        completedAt,
+        duration: completedAt.getTime() - startedAt.getTime(),
+        retryCount,
+    };
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Workflow Parser for marktoflow v2.0
+ *
+ * Parses markdown workflow files with YAML frontmatter.
+ * Extracts workflow metadata, tool configurations, and step definitions.
+ */
+import { Workflow } from './models.js';
+export interface ParseResult {
+    workflow: Workflow;
+    warnings: string[];
+}
+export interface ParseOptions {
+    /** Validate the workflow after parsing */
+    validate?: boolean;
+    /** Resolve environment variables in the workflow */
+    resolveEnv?: boolean;
+}
+export declare class ParseError extends Error {
+    readonly line?: number | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, line?: number | undefined, details?: unknown | undefined);
+}
+/**
+ * Parse a workflow from a markdown file.
+ */
+export declare function parseFile(path: string, options?: ParseOptions): Promise<ParseResult>;
+/**
+ * Parse a workflow from markdown content.
+ */
+export declare function parseContent(content: string, options?: ParseOptions): ParseResult;
+/**
+ * Extract variable references from a template string.
+ * Returns list of variable names like ["var1", "var2"].
+ */
+export declare function extractVariableReferences(template: string): string[];
+/**
+ * Validate that all variable references in steps are defined.
+ */
+export declare function validateVariableReferences(workflow: Workflow): string[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,QAAQ,EAOT,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,CAAC,EAAE,MAAM;aACb,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AASD;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAG9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAwCrF;AAgND;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CA8BvE"}