@ekairos/dataset

Dataset domain library.

Runtime-first dataset materialization for domain rows, query snapshots, file/text sources, transforms, and sandbox-backed analysis.

install @ekairos/dataset@betaroot dataset_datasetssurface dataset_records

Schema

dataset_datasets

Dataset metadata, source analysis, output mode, sandbox id, and linked data files.

dataset_records

Materialized rows linked to a dataset and optional source files.

Actions

dataset(runtime)

Builder entry point for source selection, output mode, sandbox, reactor, and build.

fromQuery

Snapshots domain query results into a dataset without requiring a reactor.

from / fromDataset / fromText

Adds file, dataset, and text sources for materialization.

asRows / first

Controls whether output is row-oriented or a single structured object.

materializeDataset

Action-level wrapper for agents that need to produce datasets.

Materialize a domain query into rows.

Direct query snapshots stay lightweight; richer parsing and transforms can opt into sandbox/reactor execution.

import { dataset } from "@ekairos/dataset";

const result = await dataset(runtime)
  .fromQuery(tenderDomain, {
    query: {
      tenders: {
        $: {
          where: { status: "open" },
          fields: ["title", "deadline", "buyerName"],
          limit: 50,
        },
      },
    },
    title: "open-tenders",
    explanation: "Open tender snapshot for analysis.",
  })
  .build({ datasetId: "open_tenders_v1" });

console.log(result.datasetId);