raptor-aios 0.1.0

package/dist/_core/dist/workflows/expressions.js

@@ -0,0 +1,336 @@
+/**
+ * Workflow Expression Evaluator — safe, no eval().
+ *
+ * Evaluates {{ expr }} expressions within workflow definitions.
+ * Supports dot-path resolution, filters, comparison operators,
+ * logical operators, and literals — all without arbitrary code execution.
+ *
+ * Blueprint ref: 05 §4 — "Linguagem de expressões {{ }}".
+ *
+ * Security invariants:
+ *   - No Function constructor, no eval(), no new Function().
+ *   - No side effects — expressions are pure reads.
+ *   - All evaluations are auditable (returns resolution trace).
+ */
+const TOKEN_PATTERNS = [
+    ["STRING", /^"([^"\\]*(?:\\.[^"\\]*)*)"/],
+    ["STRING", /^'([^'\\]*(?:\\.[^'\\]*)*)'/],
+    ["NUMBER", /^-?\d+(?:\.\d+)?/],
+    ["BOOLEAN", /^(?:true|false)\b/],
+    ["NULL", /^null\b/],
+    ["OP_EQ", /^==/],
+    ["OP_NEQ", /^!=/],
+    ["OP_LTE", /^<=/],
+    ["OP_GTE", /^>=/],
+    ["OP_LT", /^</],
+    ["OP_GT", /^>/],
+    ["OP_AND", /^&&/],
+    ["OP_OR", /^\|\|/],
+    ["OP_NOT", /^!/],
+    ["OP_IN", /^in\b/],
+    ["PIPE", /^\|(?!\|)/],
+    ["LPAREN", /^\(/],
+    ["RPAREN", /^\)/],
+    ["COMMA", /^,/],
+    ["DOT_PATH", /^[a-zA-Z_][\w]*(?:\.[a-zA-Z_][\w]*)*/],
+];
+function tokenize(expr) {
+    const tokens = [];
+    let pos = 0;
+    const src = expr.trim();
+    while (pos < src.length) {
+        // Skip whitespace
+        if (/\s/.test(src[pos])) {
+            pos++;
+            continue;
+        }
+        let matched = false;
+        for (const [type, regex] of TOKEN_PATTERNS) {
+            const match = src.slice(pos).match(regex);
+            if (match) {
+                const raw = match[0];
+                let value = raw;
+                if (type === "STRING") {
+                    value = match[1] ?? raw.slice(1, -1);
+                }
+                tokens.push({ type, value, raw });
+                pos += raw.length;
+                matched = true;
+                break;
+            }
+        }
+        if (!matched) {
+            throw new ExpressionError(`Unexpected character '${src[pos]}' at position ${pos} in expression: "${expr}"`);
+        }
+    }
+    return tokens;
+}
+const BUILTIN_FILTERS = {
+    upper: (v) => String(v ?? "").toUpperCase(),
+    lower: (v) => String(v ?? "").toLowerCase(),
+    trim: (v) => String(v ?? "").trim(),
+    length: (v) => {
+        if (Array.isArray(v))
+            return v.length;
+        if (typeof v === "string")
+            return v.length;
+        if (v && typeof v === "object")
+            return Object.keys(v).length;
+        return 0;
+    },
+    default: (v, fallback) => v === undefined || v === null || v === "" ? fallback : v,
+    json: (v) => JSON.stringify(v),
+    keys: (v) => (v && typeof v === "object" ? Object.keys(v) : []),
+    values: (v) => (v && typeof v === "object" ? Object.values(v) : []),
+    first: (v) => (Array.isArray(v) ? v[0] : v),
+    last: (v) => (Array.isArray(v) ? v[v.length - 1] : v),
+    join: (v, sep) => Array.isArray(v) ? v.join(String(sep ?? ", ")) : String(v ?? ""),
+    split: (v, sep) => String(v ?? "").split(String(sep ?? ",")),
+    replace: (v, search, replacement) => String(v ?? "").replace(String(search ?? ""), String(replacement ?? "")),
+    slice: (v, start, end) => {
+        if (Array.isArray(v))
+            return v.slice(Number(start ?? 0), end !== undefined ? Number(end) : undefined);
+        return String(v ?? "").slice(Number(start ?? 0), end !== undefined ? Number(end) : undefined);
+    },
+    not: (v) => !v,
+    type: (v) => typeof v,
+};
+// ---------------------------------------------------------------------------
+// Context resolution
+// ---------------------------------------------------------------------------
+function resolveDotPath(ctx, path) {
+    const segments = path.split(".");
+    let current = ctx;
+    for (const segment of segments) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== "object")
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+// ---------------------------------------------------------------------------
+// Expression evaluator (recursive descent)
+// ---------------------------------------------------------------------------
+export class ExpressionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ExpressionError";
+    }
+}
+class Parser {
+    tokens;
+    pos;
+    ctx;
+    filters;
+    constructor(tokens, ctx, filters) {
+        this.tokens = tokens;
+        this.pos = 0;
+        this.ctx = ctx;
+        this.filters = filters;
+    }
+    peek() {
+        return this.tokens[this.pos];
+    }
+    advance() {
+        const t = this.tokens[this.pos];
+        if (!t)
+            throw new ExpressionError("Unexpected end of expression");
+        this.pos++;
+        return t;
+    }
+    match(type) {
+        if (this.peek()?.type === type)
+            return this.advance();
+        return undefined;
+    }
+    // expr := or_expr ( PIPE filter )*
+    parseExpr() {
+        let value = this.parseOr();
+        while (this.match("PIPE")) {
+            const filterToken = this.advance();
+            if (filterToken.type !== "DOT_PATH") {
+                throw new ExpressionError(`Expected filter name after |, got ${filterToken.type}`);
+            }
+            const filterName = filterToken.value;
+            const fn = this.filters[filterName];
+            if (!fn) {
+                throw new ExpressionError(`Unknown filter: "${filterName}"`);
+            }
+            // Optional arguments: filter(arg1, arg2)
+            const args = [];
+            if (this.match("LPAREN")) {
+                if (this.peek()?.type !== "RPAREN") {
+                    args.push(this.parsePrimary());
+                    while (this.match("COMMA")) {
+                        args.push(this.parsePrimary());
+                    }
+                }
+                if (!this.match("RPAREN")) {
+                    throw new ExpressionError(`Missing closing ) in filter "${filterName}"`);
+                }
+            }
+            value = fn(value, ...args);
+        }
+        return value;
+    }
+    // or_expr := and_expr ( || and_expr )*
+    parseOr() {
+        let left = this.parseAnd();
+        while (this.match("OP_OR")) {
+            const right = this.parseAnd();
+            left = left || right;
+        }
+        return left;
+    }
+    // and_expr := not_expr ( && not_expr )*
+    parseAnd() {
+        let left = this.parseNot();
+        while (this.match("OP_AND")) {
+            const right = this.parseNot();
+            left = left && right;
+        }
+        return left;
+    }
+    // not_expr := !? comparison
+    parseNot() {
+        if (this.match("OP_NOT")) {
+            return !this.parseNot();
+        }
+        return this.parseComparison();
+    }
+    // comparison := primary ( (== | != | < | <= | > | >= | in) primary )?
+    parseComparison() {
+        const left = this.parsePrimary();
+        const op = this.peek();
+        if (!op)
+            return left;
+        switch (op.type) {
+            case "OP_EQ":
+                this.advance();
+                return left === this.parsePrimary();
+            case "OP_NEQ":
+                this.advance();
+                return left !== this.parsePrimary();
+            case "OP_LT":
+                this.advance();
+                return left < this.parsePrimary();
+            case "OP_LTE":
+                this.advance();
+                return left <= this.parsePrimary();
+            case "OP_GT":
+                this.advance();
+                return left > this.parsePrimary();
+            case "OP_GTE":
+                this.advance();
+                return left >= this.parsePrimary();
+            case "OP_IN": {
+                this.advance();
+                const right = this.parsePrimary();
+                if (Array.isArray(right))
+                    return right.includes(left);
+                if (typeof right === "string")
+                    return right.includes(String(left));
+                if (right && typeof right === "object")
+                    return String(left) in right;
+                return false;
+            }
+            default:
+                return left;
+        }
+    }
+    // primary := STRING | NUMBER | BOOLEAN | NULL | DOT_PATH | ( expr )
+    parsePrimary() {
+        const tok = this.peek();
+        if (!tok)
+            throw new ExpressionError("Unexpected end of expression");
+        switch (tok.type) {
+            case "STRING":
+                this.advance();
+                return tok.value;
+            case "NUMBER":
+                this.advance();
+                return Number(tok.value);
+            case "BOOLEAN":
+                this.advance();
+                return tok.value === "true";
+            case "NULL":
+                this.advance();
+                return null;
+            case "DOT_PATH":
+                this.advance();
+                return resolveDotPath(this.ctx, tok.value);
+            case "LPAREN": {
+                this.advance();
+                const value = this.parseOr();
+                if (!this.match("RPAREN"))
+                    throw new ExpressionError("Missing closing )");
+                return value;
+            }
+            default:
+                throw new ExpressionError(`Unexpected token: ${tok.raw} (${tok.type})`);
+        }
+    }
+}
+/**
+ * Evaluate a single expression string against a context.
+ *
+ * @example
+ * evalExpr("inputs.name", { inputs: { name: "FastBoy" } }) // "FastBoy"
+ * evalExpr("inputs.name | upper", ctx) // "FASTBOY"
+ * evalExpr("steps.plan.status == 'completed'", ctx) // true
+ */
+export function evalExpr(expr, ctx, opts = {}) {
+    const filters = { ...BUILTIN_FILTERS, ...(opts.filters ?? {}) };
+    const tokens = tokenize(expr);
+    if (tokens.length === 0)
+        return undefined;
+    const parser = new Parser(tokens, ctx, filters);
+    return parser.parseExpr();
+}
+/**
+ * Resolve all {{ expr }} placeholders in a template string.
+ *
+ * @example
+ * resolveTemplate("Hello {{ inputs.name }}!", ctx) // "Hello FastBoy!"
+ */
+export function resolveTemplate(template, ctx, opts = {}) {
+    return template.replace(/\{\{\s*(.+?)\s*\}\}/g, (_match, expr) => {
+        const value = evalExpr(expr, ctx, opts);
+        if (value === undefined || value === null)
+            return "";
+        return String(value);
+    });
+}
+/**
+ * Evaluate a condition expression and return a boolean.
+ * Used for step `when` conditions, `if` conditions, etc.
+ */
+export function evalCondition(expr, ctx, opts = {}) {
+    const value = evalExpr(expr, ctx, opts);
+    return isTruthy(value);
+}
+/**
+ * List all available filter names.
+ */
+export function listFilters() {
+    return Object.keys(BUILTIN_FILTERS);
+}
+// ---------------------------------------------------------------------------
+// Truthiness (same semantics as the template engine)
+// ---------------------------------------------------------------------------
+function isTruthy(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value !== 0;
+    if (typeof value === "string")
+        return value.length > 0;
+    if (Array.isArray(value))
+        return value.length > 0;
+    return true;
+}
+//# sourceMappingURL=expressions.js.map

package/dist/_core/dist/workflows/expressions.js.map

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

package/dist/_core/dist/workflows/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Workflow Engine — barrel export.
+ */
+export type { WorkflowMeta, WorkflowRequires, WorkflowInput, WorkflowInputType, WorkflowStep, WorkflowDefinition, WorkflowRunState, WorkflowContext, WorkflowEvent, WorkflowEventType, WorkflowEventHandler, StepState, StepStatus, StepType, BaseStep, CommandStep, PromptStep, ShellStep, GateStep, IfStep, SwitchStep, WhileStep, DoWhileStep, FanOutStep, FanInStep, SwitchCase, } from "./types.js";
+export { WORKFLOW_SCHEMA_V1 } from "./types.js";
+export { evalExpr, resolveTemplate, evalCondition, listFilters, ExpressionError, } from "./expressions.js";
+export type { FilterFn, EvalOptions } from "./expressions.js";
+export { parseWorkflow, loadWorkflow, discoverWorkflows, validateWorkflow, WorkflowParseError, } from "./parser.js";
+export type { WorkflowValidationError } from "./parser.js";
+export { executeWorkflow, resumeWorkflow, loadRunState, listRunStates, } from "./engine.js";
+export type { EngineOptions, CommandExecutor, GateResponder, ShellExecutor, } from "./engine.js";
+export { SDD_CYCLE, SDD_CYCLE_QUICK, getBundledWorkflows } from "./bundled.js";
+export type { CommandExecutorResult, ShellExecOptions, ShellExecResult, } from "./types.js";
+export { parseSDDWorkflow, loadDefaultWorkflow, validateStepPrerequisites, executeStep, } from "./sdd-flow.js";
+export type { SDDPhase, SDDWorkflowStep, SDDWorkflowDefinition, StepResult, } from "./sdd-flow.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/_core/dist/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACL,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE/E,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC"}

package/dist/_core/dist/workflows/index.js

@@ -0,0 +1,15 @@
+/**
+ * Workflow Engine — barrel export.
+ */
+export { WORKFLOW_SCHEMA_V1 } from "./types.js";
+// Expression evaluator
+export { evalExpr, resolveTemplate, evalCondition, listFilters, ExpressionError, } from "./expressions.js";
+// Parser
+export { parseWorkflow, loadWorkflow, discoverWorkflows, validateWorkflow, WorkflowParseError, } from "./parser.js";
+// Engine
+export { executeWorkflow, resumeWorkflow, loadRunState, listRunStates, } from "./engine.js";
+// Bundled workflows
+export { SDD_CYCLE, SDD_CYCLE_QUICK, getBundledWorkflows } from "./bundled.js";
+// SDD Flow Runtime
+export { parseSDDWorkflow, loadDefaultWorkflow, validateStepPrerequisites, executeStep, } from "./sdd-flow.js";
+//# sourceMappingURL=index.js.map

package/dist/_core/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+BH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,uBAAuB;AACvB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,SAAS;AACT,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,SAAS;AACT,OAAO,EACL,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAQrB,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQ/E,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,GACZ,MAAM,eAAe,CAAC"}

package/dist/_core/dist/workflows/parser.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Workflow Parser — loads and validates workflow.yml files.
+ *
+ * Parses the declarative YAML into a strongly-typed WorkflowDefinition.
+ * Uses the same minimal YAML approach as agents.yml (no external deps).
+ *
+ * Blueprint ref: 05 §2 — "Forma canônica: workflow.yml".
+ */
+import type { WorkflowDefinition } from "./types.js";
+export declare class WorkflowParseError extends Error {
+    readonly path?: string | undefined;
+    constructor(message: string, path?: string | undefined);
+}
+/**
+ * Parse a workflow YAML string into a WorkflowDefinition.
+ */
+export declare function parseWorkflow(raw: string, sourcePath?: string): WorkflowDefinition;
+/**
+ * Load a workflow from disk.
+ */
+export declare function loadWorkflow(path: string): WorkflowDefinition;
+/**
+ * Discover all workflows in a directory.
+ * Scans for `workflow.yml` files in subdirectories.
+ */
+export declare function discoverWorkflows(dir: string): Array<{
+    id: string;
+    path: string;
+}>;
+export interface WorkflowValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * Validate a parsed WorkflowDefinition for semantic correctness.
+ */
+export declare function validateWorkflow(def: WorkflowDefinition): WorkflowValidationError[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/_core/dist/workflows/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/workflows/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAYnB,MAAM,YAAY,CAAC;AAOpB,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAmOD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,CAgEpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAM7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BrC;AAMD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,GACtB,uBAAuB,EAAE,CAuE3B"}