@epistemicdb/eql

Parser, type checker, formatter, and CLI for EQL (Epistemic Query Language) — the query language for EpistemicDB.

Install

npm install @epistemicdb/eql

Usage

import { parse, typeCheck, format } from '@epistemicdb/eql'

const ast = parse(`
  FETCH KO
    WHERE decay_score > 0.35
    AND confidence > 0.60
    ORDER BY K DESC
`)

const result = typeCheck(ast)
if (!result.valid) {
  console.error(result.errors)
}

console.log(format(ast))

CLI

# Validate an EQL file
eql validate queries/my-query.eql

# Format an EQL file
eql format queries/my-query.eql --write

# Execute against a running server
EDB_KEY=edb_sk_... eql query queries/my-query.eql

# Interactive REPL
eql repl

Statement types

| Statement | Description | |------------------|--------------------------------------| | FETCH | Retrieve KOs, D-KOs, or Molecules | | OPEN GAPS | Find blocking unknowns | | PROJECT DECAY | Predict staleness over time | | COMPOSE | Synthesize derived knowledge (D-KOs) | | WATCH | Live subscriptions |

Documentation

Full EQL specification at epistemicdb.com/eql-spec