openagentflow 0.1.0

package/examples/support-triage-input.json

@@ -0,0 +1,3 @@
+{
+    "customer_email": "Subject: URGENT: Extremely disappointed with Order #48291 - Damaged Items and Poor Service\n\nTo Whom It May Concern,\n\nI am writing to express my immense frustration regarding my recent order (#48291), placed on July 5th. \n\nNot only did the package arrive a full week past your guaranteed delivery date, but when I finally opened it today, two of the three items I ordered were completely shattered. The box had barely any bubble wrap or protective packaging, which is frankly unacceptable for fragile goods. \n\nI ordered these specifically for an important event happening tomorrow, and now I am left scrambling for a last-minute replacement because of your shipping department's negligence. Furthermore, I tried calling your customer support line three times today, only to be left on hold for over 30 minutes each time before being disconnected.\n\nI expect a full refund for this order immediately. I have attached photos of the damaged items and the inadequate packaging to this email. \n\nI look forward to your prompt response. If I do not hear back within 24 hours to resolve this issue, I will be forced to dispute the charge with my credit card company.\n\nRegretfully,\n\nAlex Mercer\nalex.mercer@email.com\n(555) 123-4567"
+}

package/examples/support-triage.oaf

@@ -0,0 +1,49 @@
+// A linear workflow that triages inbound messages and drafts replies.
+workflow "SupportTriage" {
+
+    state {
+        customer_email: string @required
+        categories: list[string]
+        urgency: int
+        draft_response: string
+    }
+
+    flow {
+        start -> Classifier
+        Classifier -> Drafter
+        Drafter -> end
+    }
+
+    config {
+        version: "1.0"
+        runtime: "langgraph"
+    }
+
+    agent Classifier {
+        model: "gemini-3.1-flash-lite"
+        temperature: 0.1
+        instructions: """
+        Analyze the inbound customer_email.
+        Determine the issue category (e.g., Billing, TechSupport, FeatureRequest).
+        Assign an urgency score from 1 (routine) to 5 (critical escalation).    
+        """
+        inputs: [customer_email]
+        outputs: [categories, urgency]
+    }
+
+    agent Drafter {
+        model: "gemma-4-26b-a4b-it"
+        temperature: 0.7
+        instructions: """
+        Write a polite, empathetic response addressing the customer's issue.
+        Tailor the tone based on the categories and urgency.
+        If urgency is 4 or 5, assure them a senior human agent is being alerted.
+        Leave placeholders like [Your Name] for account details.
+        """
+        inputs: [customer_email, categories, urgency]
+        outputs: [draft_response]
+    }
+
+
+
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "openagentflow",
+  "version": "0.1.0",
+  "description": "An open, portable specification for describing AI agent workflows using a human-readable text language.",
+  "type": "module",
+  "main": "compiler/index.js",
+  "bin": {
+    "oaf": "cli/index.js"
+  },
+  "exports": {
+    ".": "./compiler/index.js",
+    "./parser": "./parser/index.js",
+    "./adapters/langgraph": "./adapters/langgraph/index.js",
+    "./cli": "./cli/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "cli",
+    "compiler",
+    "parser",
+    "adapters",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test tests/**/*.test.js",
+    "oaf": "node cli/index.js"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "workflow",
+    "dsl",
+    "langgraph",
+    "autogen",
+    "crewai",
+    "openagentflow"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/parser/ast.js

@@ -0,0 +1,240 @@
+/**
+ * OpenAgentFlow AST Node Definitions
+ *
+ * Defines all node types produced by the parser.
+ * Each node captures its source location for diagnostic reporting.
+ */
+
+// ─── Base Node ─────────────────────────────────────────────────────────────────
+
+export class ASTNode {
+  /**
+   * @param {string} type - Node type identifier
+   * @param {number} line - Source line
+   * @param {number} column - Source column
+   */
+  constructor(type, line, column) {
+    this.type = type;
+    this.line = line;
+    this.column = column;
+  }
+}
+
+// ─── Program ───────────────────────────────────────────────────────────────────
+
+export class Program extends ASTNode {
+  /**
+   * @param {WorkflowDecl} workflow
+   */
+  constructor(workflow) {
+    super('Program', workflow.line, workflow.column);
+    this.workflow = workflow;
+  }
+}
+
+// ─── Workflow Declaration ──────────────────────────────────────────────────────
+
+export class WorkflowDecl extends ASTNode {
+  /**
+   * @param {string} name - Workflow name
+   * @param {StateBlock|null} state
+   * @param {AgentBlock[]} agents
+   * @param {FlowBlock} flow
+   * @param {ConfigBlock|null} config
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(name, state, agents, flow, config, line, column) {
+    super('WorkflowDecl', line, column);
+    this.name = name;
+    this.state = state;
+    this.agents = agents;
+    this.flow = flow;
+    this.config = config;
+  }
+}
+
+// ─── State Block ───────────────────────────────────────────────────────────────
+
+export class StateBlock extends ASTNode {
+  /**
+   * @param {StateField[]} fields
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(fields, line, column) {
+    super('StateBlock', line, column);
+    this.fields = fields;
+  }
+}
+
+export class StateField extends ASTNode {
+  /**
+   * @param {string} name - Variable name
+   * @param {TypeExpr} typeExpr - Type expression
+   * @param {StateOption[]} options - State field options
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(name, typeExpr, options = [], line, column) {
+    if (typeof options === 'number') {
+      column = line;
+      line = options;
+      options = [];
+    }
+    super('StateField', line, column);
+    this.name = name;
+    this.typeExpr = typeExpr;
+    this.options = options;
+  }
+}
+
+export class StateOption extends ASTNode {
+  /**
+   * @param {string} name - Option name (without @)
+   * @param {Array<*>} args - Option arguments
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(name, args = [], line, column) {
+    super('StateOption', line, column);
+    this.name = name;
+    this.args = args;
+  }
+}
+
+// ─── Type Expressions ──────────────────────────────────────────────────────────
+
+export class TypeExpr extends ASTNode {
+  /**
+   * @param {string} kind - 'primitive' | 'list' | 'map'
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(kind, line, column) {
+    super('TypeExpr', line, column);
+    this.kind = kind;
+  }
+}
+
+export class PrimitiveType extends TypeExpr {
+  /**
+   * @param {string} name - 'string' | 'int' | 'float' | 'bool'
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(name, line, column) {
+    super('primitive', line, column);
+    this.name = name;
+  }
+}
+
+export class ListType extends TypeExpr {
+  /**
+   * @param {TypeExpr} elementType
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(elementType, line, column) {
+    super('list', line, column);
+    this.elementType = elementType;
+  }
+}
+
+export class MapType extends TypeExpr {
+  /**
+   * @param {TypeExpr} keyType
+   * @param {TypeExpr} valueType
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(keyType, valueType, line, column) {
+    super('map', line, column);
+    this.keyType = keyType;
+    this.valueType = valueType;
+  }
+}
+
+// ─── Agent Block ───────────────────────────────────────────────────────────────
+
+export class AgentBlock extends ASTNode {
+  /**
+   * @param {string} id - Agent identifier
+   * @param {Object} properties - Parsed properties
+   * @param {string} properties.instructions - Required instructions
+   * @param {string|null} properties.model
+   * @param {number|null} properties.temperature
+   * @param {string[]} properties.tools
+   * @param {string[]} properties.inputs
+   * @param {string[]} properties.outputs
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(id, properties, line, column) {
+    super('AgentBlock', line, column);
+    this.id = id;
+    this.instructions = properties.instructions;
+    this.model = properties.model ?? null;
+    this.provider = properties.provider ?? null;
+    this.temperature = properties.temperature ?? null;
+    this.tools = properties.tools ?? [];
+    this.inputs = properties.inputs ?? [];
+    this.outputs = properties.outputs ?? [];
+  }
+}
+
+// ─── Flow Block ────────────────────────────────────────────────────────────────
+
+export class FlowBlock extends ASTNode {
+  /**
+   * @param {Edge[]} edges
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(edges, line, column) {
+    super('FlowBlock', line, column);
+    this.edges = edges;
+  }
+}
+
+export class Edge extends ASTNode {
+  /**
+   * @param {string} source
+   * @param {string} target
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(source, target, line, column) {
+    super('Edge', line, column);
+    this.source = source;
+    this.target = target;
+  }
+}
+
+// ─── Config Block ──────────────────────────────────────────────────────────────
+
+export class ConfigBlock extends ASTNode {
+  /**
+   * @param {ConfigEntry[]} entries
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(entries, line, column) {
+    super('ConfigBlock', line, column);
+    this.entries = entries;
+  }
+}
+
+export class ConfigEntry extends ASTNode {
+  /**
+   * @param {string} key
+   * @param {*} value
+   * @param {number} line
+   * @param {number} column
+   */
+  constructor(key, value, line, column) {
+    super('ConfigEntry', line, column);
+    this.key = key;
+    this.value = value;
+  }
+}

package/parser/index.js

@@ -0,0 +1,9 @@
+/**
+ * OpenAgentFlow Parser — Public API
+ *
+ * Re-exports the lexer, parser, and AST for external consumers.
+ */
+
+export { Lexer, Token, TokenType, LexerError } from './lexer.js';
+export { Parser, ParseError } from './parser.js';
+export * from './ast.js';