flow-lang 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+import { readFileSync } from "fs";
+import { config as loadDotenv } from "dotenv";
+import { Command } from "commander";
+import chalk from "chalk";
+import { tokenize } from "../lexer/index.js";
+import { parse } from "../parser/index.js";
+import { analyze } from "../analyzer/index.js";
+import { execute, toDisplay, flowValueToJson, HTTPAPIConnector, WebhookConnector, PluginStubConnector, AnthropicConnector, OpenAIConnector, createMockConnector, } from "../runtime/index.js";
+import { formatErrors } from "../errors/index.js";
+function runPipeline(filePath) {
+    let source;
+    try {
+        source = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        console.error(chalk.red(`Error: Could not read file "${filePath}"`));
+        return { success: false, errors: [] };
+    }
+    // Tokenize
+    let tokens;
+    try {
+        tokens = tokenize(source, filePath);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk.red(`Lexer error: ${message}`));
+        return { success: false, errors: [] };
+    }
+    // Parse
+    const { program, errors: parseErrors } = parse(tokens, source, filePath);
+    // Analyze
+    const analysisErrors = analyze(program, source, filePath);
+    const allErrors = [...parseErrors, ...analysisErrors];
+    if (allErrors.length > 0) {
+        return { success: false, errors: allErrors, program, source };
+    }
+    return { success: true, errors: [], program, source };
+}
+// ============================================================
+// Output helpers
+// ============================================================
+function printErrors(errors) {
+    console.error(formatErrors(errors));
+    const errorCount = errors.filter(e => e.severity === "error").length;
+    const warnCount = errors.filter(e => e.severity === "warning").length;
+    const parts = [];
+    if (errorCount > 0)
+        parts.push(chalk.red(`${errorCount} error${errorCount !== 1 ? "s" : ""}`));
+    if (warnCount > 0)
+        parts.push(chalk.yellow(`${warnCount} warning${warnCount !== 1 ? "s" : ""}`));
+    console.error("\n" + parts.join(", ") + " found.");
+}
+function printLog(log, verbose) {
+    if (!verbose)
+        return;
+    if (log.length === 0)
+        return;
+    console.log(chalk.gray("\n--- Execution Log ---"));
+    for (const entry of log) {
+        const stepLabel = entry.step ? chalk.cyan(`[${entry.step}]`) + " " : "";
+        const resultColor = entry.result === "success" ? chalk.green : entry.result === "failure" ? chalk.red : chalk.yellow;
+        const resultLabel = resultColor(entry.result);
+        let detail = "";
+        if (entry.details["message"]) {
+            detail = ` ${entry.details["message"]}`;
+        }
+        console.log(chalk.gray(`  ${stepLabel}${entry.action} ${resultLabel}${detail}`));
+    }
+    console.log(chalk.gray("--- End Log ---"));
+}
+function buildConnectors(declarations) {
+    const connectors = new Map();
+    for (const decl of declarations) {
+        switch (decl.serviceType) {
+            case "api":
+                connectors.set(decl.name, new HTTPAPIConnector(decl.target));
+                break;
+            case "webhook":
+                connectors.set(decl.name, new WebhookConnector(decl.target));
+                break;
+            case "plugin":
+                connectors.set(decl.name, new PluginStubConnector());
+                break;
+            case "ai":
+                if (decl.target.startsWith("anthropic/")) {
+                    connectors.set(decl.name, new AnthropicConnector(decl.target, process.env.ANTHROPIC_API_KEY));
+                }
+                else if (decl.target.startsWith("openai/")) {
+                    connectors.set(decl.name, new OpenAIConnector(decl.target, process.env.OPENAI_API_KEY));
+                }
+                else {
+                    connectors.set(decl.name, createMockConnector("ai"));
+                }
+                break;
+        }
+    }
+    return connectors;
+}
+// ============================================================
+// Commands
+// ============================================================
+function checkCommand(filePath) {
+    const { success, errors } = runPipeline(filePath);
+    if (!success && errors.length === 0) {
+        process.exitCode = 1;
+        return;
+    }
+    if (errors.length > 0) {
+        printErrors(errors);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(chalk.green(`No errors found in ${filePath}`));
+}
+async function runCommand(filePath, options) {
+    // Load .env file into process.env
+    loadDotenv();
+    const pipeline = runPipeline(filePath);
+    if (!pipeline.success) {
+        if (pipeline.errors.length > 0)
+            printErrors(pipeline.errors);
+        process.exitCode = 1;
+        return;
+    }
+    // Parse input
+    let input = {};
+    if (options.input) {
+        try {
+            input = JSON.parse(options.input);
+        }
+        catch {
+            console.error(chalk.red(`Error: Invalid JSON input: ${options.input}`));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // Build connectors: real by default, mock with --mock flag
+    let connectors;
+    if (!options.mock && pipeline.program.services) {
+        connectors = buildConnectors(pipeline.program.services.declarations);
+    }
+    // Execute
+    const result = await execute(pipeline.program, pipeline.source, {
+        input,
+        connectors,
+        envVars: process.env,
+        verbose: options.verbose,
+        strictEnv: options.strictEnv,
+    });
+    // Print log
+    printLog(result.log, options.verbose ?? false);
+    // Print result
+    switch (result.result.status) {
+        case "completed": {
+            console.log(chalk.green("\nWorkflow completed successfully."));
+            const keys = Object.keys(result.result.outputs);
+            if (keys.length > 0) {
+                console.log(chalk.white("\nOutputs:"));
+                for (const [key, value] of Object.entries(result.result.outputs)) {
+                    console.log(`  ${chalk.cyan(key)}: ${toDisplay(value)}`);
+                }
+            }
+            break;
+        }
+        case "rejected":
+            console.log(chalk.red(`\nWorkflow rejected: ${result.result.message}`));
+            process.exitCode = 1;
+            break;
+        case "error":
+            console.error(chalk.red(`\nRuntime error:`));
+            console.error(formatErrors([result.result.error]));
+            process.exitCode = 1;
+            break;
+    }
+}
+async function testCommand(filePath, options) {
+    const pipeline = runPipeline(filePath);
+    if (!pipeline.success) {
+        if (pipeline.errors.length > 0)
+            printErrors(pipeline.errors);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(chalk.blue(`Testing ${filePath} with mock services...\n`));
+    const result = await execute(pipeline.program, pipeline.source, {
+        input: {},
+        envVars: { API_KEY: "mock-api-key", SECRET: "mock-secret" },
+        verbose: options.verbose,
+    });
+    printLog(result.log, options.verbose ?? false);
+    switch (result.result.status) {
+        case "completed": {
+            console.log(chalk.green("\nTest passed — workflow completed successfully."));
+            const keys = Object.keys(result.result.outputs);
+            if (keys.length > 0) {
+                console.log(chalk.white("\nOutputs:"));
+                for (const [key, value] of Object.entries(result.result.outputs)) {
+                    console.log(`  ${chalk.cyan(key)}: ${JSON.stringify(flowValueToJson(value))}`);
+                }
+            }
+            break;
+        }
+        case "rejected":
+            console.log(chalk.yellow(`\nTest result — workflow rejected: ${result.result.message}`));
+            break;
+        case "error":
+            console.log(chalk.red(`\nTest failed — runtime error:`));
+            console.error(formatErrors([result.result.error]));
+            process.exitCode = 1;
+            break;
+    }
+}
+// ============================================================
+// CLI setup
+// ============================================================
+const program = new Command();
+program
+    .name("flow")
+    .description("Flow — a language for AI agent and workflow orchestration")
+    .version("0.1.0");
+program
+    .command("check <file>")
+    .description("Check a .flow file for errors without running it")
+    .action(checkCommand);
+program
+    .command("run <file>")
+    .description("Execute a .flow file")
+    .option("--input <json>", "JSON string with input data for the workflow")
+    .option("--verbose", "Show detailed execution log")
+    .option("--strict-env", "Error on missing environment variables instead of using empty")
+    .option("--mock", "Use mock services instead of real HTTP calls")
+    .action(runCommand);
+program
+    .command("test <file>")
+    .description("Test a .flow file with mock services")
+    .option("--dry-run", "Use mock services (default)")
+    .option("--verbose", "Show detailed execution log")
+    .action(testCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,40 @@
+import type { FlowError } from "../types/index.js";
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ * Used for "did you mean?" suggestions.
+ */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * Find the closest match to `target` from a list of `candidates`.
+ * Returns null if no candidate is close enough (threshold: 60% of target length, minimum 3).
+ */
+export declare function findClosestMatch(target: string, candidates: readonly string[]): string | null;
+/**
+ * Format a FlowError into the standard user-facing error message.
+ *
+ * Output format:
+ *
+ *     Error in <file>, line <n>:
+ *
+ *         <the offending source line>
+ *
+ *         <plain English explanation>
+ *
+ *         <suggestion>
+ *
+ *         <hint>
+ */
+export declare function formatError(error: FlowError): string;
+/**
+ * Format multiple errors into a single output string.
+ */
+export declare function formatErrors(errors: readonly FlowError[]): string;
+/**
+ * Create a FlowError with all required fields.
+ */
+export declare function createError(file: string, line: number, column: number, message: string, source: string, options?: {
+    suggestion?: string;
+    hint?: string;
+    severity?: FlowError["severity"];
+}): FlowError;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAoB7F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA2BpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;CAAE,GACnF,SAAS,CAcX"}

package/dist/errors/index.js

@@ -0,0 +1,110 @@
+/**
+ * Compute the Levenshtein edit distance between two strings.
+ * Used for "did you mean?" suggestions.
+ */
+export function levenshtein(a, b) {
+    const aLower = a.toLowerCase();
+    const bLower = b.toLowerCase();
+    const aLen = aLower.length;
+    const bLen = bLower.length;
+    // Previous and current row of distances
+    let prev = Array.from({ length: bLen + 1 }, (_, i) => i);
+    let curr = new Array(bLen + 1);
+    for (let i = 1; i <= aLen; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= bLen; j++) {
+            const cost = aLower[i - 1] === bLower[j - 1] ? 0 : 1;
+            curr[j] = Math.min((prev[j] ?? 0) + 1, // deletion
+            (curr[j - 1] ?? 0) + 1, // insertion
+            (prev[j - 1] ?? 0) + cost // substitution
+            );
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[bLen] ?? aLen;
+}
+/**
+ * Find the closest match to `target` from a list of `candidates`.
+ * Returns null if no candidate is close enough (threshold: 60% of target length, minimum 3).
+ */
+export function findClosestMatch(target, candidates) {
+    if (candidates.length === 0)
+        return null;
+    const maxDistance = Math.max(3, Math.floor(target.length * 0.6));
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    for (const candidate of candidates) {
+        const distance = levenshtein(target, candidate);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestMatch = candidate;
+        }
+    }
+    if (bestDistance <= maxDistance && bestMatch !== null) {
+        return bestMatch;
+    }
+    return null;
+}
+/**
+ * Format a FlowError into the standard user-facing error message.
+ *
+ * Output format:
+ *
+ *     Error in <file>, line <n>:
+ *
+ *         <the offending source line>
+ *
+ *         <plain English explanation>
+ *
+ *         <suggestion>
+ *
+ *         <hint>
+ */
+export function formatError(error) {
+    const label = error.severity === "warning" ? "Warning" : "Error";
+    const lines = [];
+    lines.push(`${label} in ${error.file}, line ${error.line}:`);
+    lines.push("");
+    if (error.sourceLine) {
+        lines.push(`    ${error.sourceLine.trimEnd()}`);
+        lines.push("");
+    }
+    lines.push(`    ${error.message}`);
+    if (error.suggestion) {
+        lines.push("");
+        lines.push(`    ${error.suggestion}`);
+    }
+    if (error.hint) {
+        lines.push("");
+        for (const hintLine of error.hint.split("\n")) {
+            lines.push(`    ${hintLine}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format multiple errors into a single output string.
+ */
+export function formatErrors(errors) {
+    if (errors.length === 0)
+        return "";
+    return errors.map(formatError).join("\n\n");
+}
+/**
+ * Create a FlowError with all required fields.
+ */
+export function createError(file, line, column, message, source, options) {
+    const sourceLines = source.split("\n");
+    const sourceLine = sourceLines[line - 1] ?? "";
+    return {
+        severity: options?.severity ?? "error",
+        file,
+        line,
+        column,
+        message,
+        sourceLine,
+        suggestion: options?.suggestion ?? null,
+        hint: options?.hint ?? null,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/lexer/index.d.ts

@@ -0,0 +1,7 @@
+import { Token, FlowError } from "../types/index.js";
+export declare class LexerError extends Error {
+    readonly flowError: FlowError;
+    constructor(flowError: FlowError);
+}
+export declare function tokenize(source: string, fileName?: string): Token[];
+//# sourceMappingURL=index.d.ts.map

package/dist/lexer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lexer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAa,SAAS,EAAE,MAAM,mBAAmB,CAAC;AA4EhE,qBAAa,UAAW,SAAQ,KAAK;IACjC,SAAgB,SAAS,EAAE,SAAS,CAAC;gBAEzB,SAAS,EAAE,SAAS;CAKnC;AAMD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkB,GAAG,KAAK,EAAE,CAkc9E"}