@elaraai/e3-api-client 0.0.1-beta.0

package/LICENSE.md

@@ -0,0 +1,50 @@
+# Business Source License 1.1
+
+Copyright (c) 2025 Elara AI Pty Ltd
+
+## License
+
+**Licensor:** Elara AI Pty Ltd
+
+**Licensed Work:** @elaraai/e3-api-client
+
+**Change Date:** Four years from the date of each release
+
+**Change License:** AGPL-3.0
+
+## Terms
+
+The Licensed Work is provided under the terms of the Business Source License 1.1 as detailed below.
+
+### Grant of Rights
+
+The Licensor grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work.
+
+### Production Use Limitation
+
+**"Production Use"** means any use by or on behalf of a for-profit entity, other than for evaluation, testing, or development purposes.
+
+Production Use requires a separate commercial license from the Licensor.
+
+### Change Date
+
+On the Change Date (four years after each release), the Licensed Work will be made available under the Change License (AGPL-3.0).
+
+### No Warranty
+
+THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. THE LICENSOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+## Commercial Licensing
+
+To obtain a commercial license for Production Use, contact:
+
+**Email:** support@elara.ai
+**Website:** https://elaraai.com
+
+## Governing Law
+
+This license is governed by the laws of New South Wales, Australia.
+
+---
+
+*Elara AI Pty Ltd*

package/README.md

@@ -0,0 +1,171 @@
+# @elaraai/e3-api-client
+
+TypeScript client library for e3 API servers.
+
+## Installation
+
+```bash
+npm install @elaraai/e3-api-client
+```
+
+## Overview
+
+Stateless functions for interacting with an e3 API server. Uses BEAST2 binary serialization for efficient request/response encoding.
+
+## API
+
+### Repository
+
+```typescript
+import { repoStatus, repoGc } from '@elaraai/e3-api-client';
+
+const status = await repoStatus('http://localhost:3000');
+// { path: '/path/to/.e3', objectCount: 42n, packageCount: 3n, workspaceCount: 2n }
+
+const gcResult = await repoGc(url, { dryRun: true, minAge: variant('none', null) });
+// { deletedObjects: 0n, retainedObjects: 42n, bytesFreed: 0n, ... }
+```
+
+### Packages
+
+```typescript
+import { packageList, packageImport, packageGet, packageExport, packageRemove } from '@elaraai/e3-api-client';
+
+// List all packages
+const packages = await packageList(url);
+// [{ name: 'my-pkg', version: '1.0.0' }, ...]
+
+// Import a package from zip bytes
+const result = await packageImport(url, zipBytes);
+// { name: 'my-pkg', version: '1.0.0', packageHash: 'abc123...', objectCount: 5n }
+
+// Get package object
+const pkg = await packageGet(url, 'my-pkg', '1.0.0');
+
+// Export package as zip
+const zip = await packageExport(url, 'my-pkg', '1.0.0');
+
+// Remove package
+await packageRemove(url, 'my-pkg', '1.0.0');
+```
+
+### Workspaces
+
+```typescript
+import { workspaceList, workspaceCreate, workspaceGet, workspaceStatus, workspaceDeploy, workspaceRemove } from '@elaraai/e3-api-client';
+
+// Create workspace
+const info = await workspaceCreate(url, 'production');
+// { name: 'production', deployed: false, packageName: null, packageVersion: null }
+
+// Deploy package to workspace
+await workspaceDeploy(url, 'production', 'my-pkg@1.0.0');
+
+// Get workspace status
+const status = await workspaceStatus(url, 'production');
+// { workspace: 'production', datasets: [...], tasks: [...], summary: { ... } }
+
+// List workspaces
+const workspaces = await workspaceList(url);
+```
+
+### Datasets
+
+```typescript
+import { datasetList, datasetListAt, datasetGet, datasetSet } from '@elaraai/e3-api-client';
+import { encodeBeast2For, decodeBeast2For, StringType, variant } from '@elaraai/east';
+
+// List root fields
+const fields = await datasetList(url, 'production');
+// ['inputs', 'tasks']
+
+// List nested fields
+const inputFields = await datasetListAt(url, 'production', [variant('field', 'inputs')]);
+// ['config', 'data']
+
+// Get dataset value (raw BEAST2 bytes)
+const path = [variant('field', 'inputs'), variant('field', 'config')];
+const bytes = await datasetGet(url, 'production', path);
+const value = decodeBeast2For(StringType)(bytes);
+
+// Set dataset value
+const encoded = encodeBeast2For(StringType)('new value');
+await datasetSet(url, 'production', path, encoded);
+```
+
+### Tasks
+
+```typescript
+import { taskList, taskGet } from '@elaraai/e3-api-client';
+
+// List tasks
+const tasks = await taskList(url, 'production');
+// [{ name: 'compute', hash: 'abc123...' }, ...]
+
+// Get task details
+const task = await taskGet(url, 'production', 'compute');
+// { name: 'compute', hash: '...', commandIr: '...', inputs: [...], output: [...] }
+```
+
+### Execution
+
+```typescript
+import { dataflowStart, dataflowExecute, dataflowGraph, taskLogs } from '@elaraai/e3-api-client';
+
+// Start execution (non-blocking)
+await dataflowStart(url, 'production', { force: true });
+
+// Execute and wait for result (blocking)
+const result = await dataflowExecute(url, 'production', { force: true });
+// { success: true, executed: 1n, cached: 0n, failed: 0n, tasks: [...], duration: 1.234 }
+
+// Get dependency graph
+const graph = await dataflowGraph(url, 'production');
+// { tasks: [{ name: 'compute', inputs: [...], output: '...', dependsOn: [...] }] }
+
+// Read task logs
+const logs = await taskLogs(url, 'production', 'compute', { stream: 'stdout' });
+// { data: '...', offset: 0n, size: 1024n, totalSize: 2048n, complete: false }
+```
+
+## License
+
+BSL 1.1. See [LICENSE.md](./LICENSE.md).
+
+### Ecosystem
+
+- **[East Node](https://github.com/elaraai/east-node)**: Node.js platform functions for I/O, databases, and system operations. Connect East programs to filesystems, SQL/NoSQL databases, cloud storage, and network services.
+  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Filesystem, console, HTTP fetch, crypto, random distributions, timestamps
+  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, S3, FTP, SFTP
+  - [@elaraai/east-node-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): CLI for running East IR programs in Node.js
+
+- **[East Python](https://github.com/elaraai/east-py)**: Python runtime and platform functions for data science and machine learning. Execute East programs with access to optimization solvers, gradient boosting, neural networks, and model explainability.
+  - [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience): TypeScript types for optimization, gradient boosting, neural networks, explainability
+
+- **[East UI](https://github.com/elaraai/east-ui)**: East types and expressions for building dashboards and interactive layouts. Define UIs as data structures that render consistently across React, web, and other environments.
+  - [@elaraai/east-ui](https://www.npmjs.com/package/@elaraai/east-ui): 50+ typed UI components for layouts, forms, charts, tables, dialogs
+  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI styling
+
+- **[e3 - East Execution Engine](https://github.com/elaraai/e3)**: Durable execution engine for running East pipelines at scale. Features Git-like content-addressable storage, automatic memoization, task queuing, and real-time monitoring.
+  - [@elaraai/e3](https://www.npmjs.com/package/@elaraai/e3): SDK for authoring e3 packages with typed tasks and pipelines
+  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Git-like object store, task queue, result caching
+  - [@elaraai/e3-types](https://www.npmjs.com/package/@elaraai/e3-types): Shared type definitions for e3 packages
+  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 init`, `e3 run`, `e3 logs` commands for managing and monitoring tasks
+  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 servers
+  - [@elaraai/e3-api-server](https://www.npmjs.com/package/@elaraai/e3-api-server): REST API server for e3 repositories
+
+## Links
+
+- [East Language](https://github.com/elaraai/east)
+- [East Python Runtime](https://github.com/elaraai/east-py)
+- [Elara AI](https://elaraai.com/)
+- [Issues](https://github.com/elaraai/e3/issues)
+- support@elara.ai
+
+## About Elara
+
+East is developed by [Elara AI Pty Ltd](https://elaraai.com/), an AI-powered platform that creates economic digital twins of businesses that optimize performance. Elara combines business objectives, decisions and data to help organizations make data-driven decisions across operations, purchasing, sales and customer engagement, and project and investment planning. East powers the computational layer of Elara solutions, enabling the expression of complex business logic and data in a simple, type-safe and portable language.
+
+---
+
+*Developed by [Elara AI Pty Ltd](https://elaraai.com/)*

package/dist/src/datasets.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { TreePath } from '@elaraai/e3-types';
+/**
+ * List field names at root of workspace dataset tree.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @returns Array of field names at root
+ */
+export declare function datasetList(url: string, workspace: string): Promise<string[]>;
+/**
+ * List field names at a path in workspace dataset tree.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param path - Path to the dataset (e.g., ['inputs', 'config'])
+ * @returns Array of field names at path
+ */
+export declare function datasetListAt(url: string, workspace: string, path: TreePath): Promise<string[]>;
+/**
+ * Get a dataset value as raw BEAST2 bytes.
+ *
+ * The returned bytes are raw BEAST2 encoded data from the object store.
+ * Use decodeBeast2 or decodeBeast2For to decode with the appropriate type.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param path - Path to the dataset (e.g., ['inputs', 'config'])
+ * @returns Raw BEAST2 bytes
+ */
+export declare function datasetGet(url: string, workspace: string, path: TreePath): Promise<Uint8Array>;
+/**
+ * Set a dataset value from raw BEAST2 bytes.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param path - Path to the dataset (e.g., ['inputs', 'config'])
+ * @param data - Raw BEAST2 encoded value
+ */
+export declare function datasetSet(url: string, workspace: string, path: TreePath, data: Uint8Array): Promise<void>;
+//# sourceMappingURL=datasets.d.ts.map

package/dist/src/datasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../src/datasets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,UAAU,CAAC,CAkBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/src/datasets.js

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { ArrayType, StringType } from '@elaraai/east';
+import { get, unwrap } from './http.js';
+/**
+ * List field names at root of workspace dataset tree.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @returns Array of field names at root
+ */
+export async function datasetList(url, workspace) {
+    const response = await get(url, `/api/workspaces/${encodeURIComponent(workspace)}/list`, ArrayType(StringType));
+    return unwrap(response);
+}
+/**
+ * List field names at a path in workspace dataset tree.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param path - Path to the dataset (e.g., ['inputs', 'config'])
+ * @returns Array of field names at path
+ */
+export async function datasetListAt(url, workspace, path) {
+    const pathStr = path.map(p => encodeURIComponent(p.value)).join('/');
+    const response = await get(url, `/api/workspaces/${encodeURIComponent(workspace)}/list/${pathStr}`, ArrayType(StringType));
+    return unwrap(response);
+}
+/**
+ * Get a dataset value as raw BEAST2 bytes.
+ *
+ * The returned bytes are raw BEAST2 encoded data from the object store.
+ * Use decodeBeast2 or decodeBeast2For to decode with the appropriate type.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param path - Path to the dataset (e.g., ['inputs', 'config'])
+ * @returns Raw BEAST2 bytes
+ */
+export async function datasetGet(url, workspace, path) {
+    const pathStr = path.map(p => encodeURIComponent(p.value)).join('/');
+    const response = await fetch(`${url}/api/workspaces/${encodeURIComponent(workspace)}/get/${pathStr}`, {
+        method: 'GET',
+        headers: {
+            'Accept': 'application/beast2',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get dataset: ${response.status} ${response.statusText}`);
+    }
+    const buffer = await response.arrayBuffer();
+    return new Uint8Array(buffer);
+}
+/**
+ * Set a dataset value from raw BEAST2 bytes.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param path - Path to the dataset (e.g., ['inputs', 'config'])
+ * @param data - Raw BEAST2 encoded value
+ */
+export async function datasetSet(url, workspace, path, data) {
+    const pathStr = path.map(p => encodeURIComponent(p.value)).join('/');
+    const response = await fetch(`${url}/api/workspaces/${encodeURIComponent(workspace)}/set/${pathStr}`, {
+        method: 'PUT',
+        headers: {
+            'Content-Type': 'application/beast2',
+        },
+        body: data,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to set dataset: ${response.status} ${response.statusText}`);
+    }
+}
+//# sourceMappingURL=datasets.js.map

package/dist/src/datasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.js","sourceRoot":"","sources":["../../src/datasets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,SAAiB;IAC9D,MAAM,QAAQ,GAAG,MAAM,GAAG,CACxB,GAAG,EACH,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,OAAO,EACvD,SAAS,CAAC,UAAU,CAAC,CACtB,CAAC;IACF,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,SAAiB,EACjB,IAAc;IAEd,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,GAAG,CACxB,GAAG,EACH,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,SAAS,OAAO,EAAE,EAClE,SAAS,CAAC,UAAU,CAAC,CACtB,CAAC;IACF,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,SAAiB,EACjB,IAAc;IAEd,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,GAAG,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,OAAO,EAAE,EACvE;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,QAAQ,EAAE,oBAAoB;SAC/B;KACF,CACF,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,SAAiB,EACjB,IAAc,EACd,IAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,GAAG,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,OAAO,EAAE,EACvE;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,cAAc,EAAE,oBAAoB;SACrC;QACD,IAAI,EAAE,IAAI;KACX,CACF,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/src/executions.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { LogChunk, DataflowGraph, DataflowResult } from './types.js';
+/**
+ * Options for starting dataflow execution.
+ */
+export interface DataflowOptions {
+    /** Maximum parallel tasks (default: 4) */
+    concurrency?: number;
+    /** Force re-execution of all tasks */
+    force?: boolean;
+    /** Filter to specific task names */
+    filter?: string;
+}
+/**
+ * Start dataflow execution on a workspace (non-blocking).
+ *
+ * Returns immediately after spawning execution in background.
+ * Use workspaceStatus() to poll for progress.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param options - Execution options
+ */
+export declare function dataflowStart(url: string, workspace: string, options?: DataflowOptions): Promise<void>;
+/**
+ * Execute dataflow on a workspace (blocking).
+ *
+ * Waits for execution to complete and returns the result.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param options - Execution options
+ * @returns Dataflow execution result
+ */
+export declare function dataflowExecute(url: string, workspace: string, options?: DataflowOptions): Promise<DataflowResult>;
+/**
+ * Get the dependency graph for a workspace.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @returns Dataflow graph with tasks and dependencies
+ */
+export declare function dataflowGraph(url: string, workspace: string): Promise<DataflowGraph>;
+/**
+ * Options for reading task logs.
+ */
+export interface LogOptions {
+    /** Which stream to read (default: 'stdout') */
+    stream?: 'stdout' | 'stderr';
+    /** Byte offset to start from (default: 0) */
+    offset?: number;
+    /** Maximum bytes to read (default: 65536) */
+    limit?: number;
+}
+/**
+ * Read task logs from a workspace.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param task - Task name
+ * @param options - Log reading options
+ * @returns Log chunk with data and metadata
+ */
+export declare function taskLogs(url: string, workspace: string, task: string, options?: LogOptions): Promise<LogChunk>;
+//# sourceMappingURL=executions.d.ts.map

package/dist/src/executions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executions.d.ts","sourceRoot":"","sources":["../../src/executions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAS1E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAWnB"}

package/dist/src/executions.js

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { NullType, none, some } from '@elaraai/east';
+import { LogChunkType, DataflowRequestType, DataflowGraphType, DataflowResultType, } from './types.js';
+import { get, post, unwrap } from './http.js';
+/**
+ * Start dataflow execution on a workspace (non-blocking).
+ *
+ * Returns immediately after spawning execution in background.
+ * Use workspaceStatus() to poll for progress.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param options - Execution options
+ */
+export async function dataflowStart(url, workspace, options = {}) {
+    const response = await post(url, `/api/workspaces/${encodeURIComponent(workspace)}/start`, {
+        concurrency: options.concurrency != null ? some(BigInt(options.concurrency)) : none,
+        force: options.force ?? false,
+        filter: options.filter != null ? some(options.filter) : none,
+    }, DataflowRequestType, NullType);
+    unwrap(response);
+}
+/**
+ * Execute dataflow on a workspace (blocking).
+ *
+ * Waits for execution to complete and returns the result.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param options - Execution options
+ * @returns Dataflow execution result
+ */
+export async function dataflowExecute(url, workspace, options = {}) {
+    const response = await post(url, `/api/workspaces/${encodeURIComponent(workspace)}/execute`, {
+        concurrency: options.concurrency != null ? some(BigInt(options.concurrency)) : none,
+        force: options.force ?? false,
+        filter: options.filter != null ? some(options.filter) : none,
+    }, DataflowRequestType, DataflowResultType);
+    return unwrap(response);
+}
+/**
+ * Get the dependency graph for a workspace.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @returns Dataflow graph with tasks and dependencies
+ */
+export async function dataflowGraph(url, workspace) {
+    const response = await get(url, `/api/workspaces/${encodeURIComponent(workspace)}/graph`, DataflowGraphType);
+    return unwrap(response);
+}
+/**
+ * Read task logs from a workspace.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param workspace - Workspace name
+ * @param task - Task name
+ * @param options - Log reading options
+ * @returns Log chunk with data and metadata
+ */
+export async function taskLogs(url, workspace, task, options = {}) {
+    const params = new URLSearchParams();
+    if (options.stream)
+        params.set('stream', options.stream);
+    if (options.offset != null)
+        params.set('offset', String(options.offset));
+    if (options.limit != null)
+        params.set('limit', String(options.limit));
+    const query = params.toString();
+    const path = `/api/workspaces/${encodeURIComponent(workspace)}/logs/${encodeURIComponent(task)}${query ? `?${query}` : ''}`;
+    const response = await get(url, path, LogChunkType);
+    return unwrap(response);
+}
+//# sourceMappingURL=executions.js.map

package/dist/src/executions.js.map

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

package/dist/src/http.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { EastType, ValueTypeOf } from '@elaraai/east';
+import { ErrorType } from './types.js';
+export type Response<T> = {
+    type: 'success';
+    value: T;
+} | {
+    type: 'error';
+    value: ValueTypeOf<typeof ErrorType>;
+};
+/**
+ * Make a GET request and decode BEAST2 response.
+ */
+export declare function get<T extends EastType>(url: string, path: string, successType: T): Promise<Response<ValueTypeOf<T>>>;
+/**
+ * Make a POST request with BEAST2 body and decode BEAST2 response.
+ */
+export declare function post<Req extends EastType, Res extends EastType>(url: string, path: string, body: ValueTypeOf<Req>, requestType: Req, successType: Res): Promise<Response<ValueTypeOf<Res>>>;
+/**
+ * Make a PUT request with BEAST2 body and decode BEAST2 response.
+ */
+export declare function put<Req extends EastType, Res extends EastType>(url: string, path: string, body: ValueTypeOf<Req>, requestType: Req, successType: Res): Promise<Response<ValueTypeOf<Res>>>;
+/**
+ * Make a DELETE request and decode BEAST2 response.
+ */
+export declare function del<T extends EastType>(url: string, path: string, successType: T): Promise<Response<ValueTypeOf<T>>>;
+/**
+ * Unwrap a response, throwing on error.
+ */
+export declare function unwrap<T>(response: Response<T>): T;
+/**
+ * API error with typed error details.
+ */
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly details: unknown;
+    constructor(code: string, details: unknown);
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/src/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAgB,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC,OAAO,SAAS,CAAC,CAAA;CAAE,CAAC;AAE5D;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,SAAS,QAAQ,EAC1C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,CAAC,GACb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CASnC;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,GAAG,SAAS,QAAQ,EAAE,GAAG,SAAS,QAAQ,EACnE,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EACtB,WAAW,EAAE,GAAG,EAChB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAYrC;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,GAAG,SAAS,QAAQ,EAAE,GAAG,SAAS,QAAQ,EAClE,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EACtB,WAAW,EAAE,GAAG,EAChB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAYrC;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,SAAS,QAAQ,EAC1C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,CAAC,GACb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CASnC;AAqBD;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAMlD;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,OAAO;gBADhB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO;CAKnC"}

package/dist/src/http.js

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { encodeBeast2For, decodeBeast2For } from '@elaraai/east';
+import { ResponseType } from './types.js';
+/**
+ * Make a GET request and decode BEAST2 response.
+ */
+export async function get(url, path, successType) {
+    const response = await fetch(`${url}${path}`, {
+        method: 'GET',
+        headers: {
+            'Accept': 'application/beast2',
+        },
+    });
+    return decodeResponse(response, successType);
+}
+/**
+ * Make a POST request with BEAST2 body and decode BEAST2 response.
+ */
+export async function post(url, path, body, requestType, successType) {
+    const encode = encodeBeast2For(requestType);
+    const response = await fetch(`${url}${path}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/beast2',
+            'Accept': 'application/beast2',
+        },
+        body: encode(body),
+    });
+    return decodeResponse(response, successType);
+}
+/**
+ * Make a PUT request with BEAST2 body and decode BEAST2 response.
+ */
+export async function put(url, path, body, requestType, successType) {
+    const encode = encodeBeast2For(requestType);
+    const response = await fetch(`${url}${path}`, {
+        method: 'PUT',
+        headers: {
+            'Content-Type': 'application/beast2',
+            'Accept': 'application/beast2',
+        },
+        body: encode(body),
+    });
+    return decodeResponse(response, successType);
+}
+/**
+ * Make a DELETE request and decode BEAST2 response.
+ */
+export async function del(url, path, successType) {
+    const response = await fetch(`${url}${path}`, {
+        method: 'DELETE',
+        headers: {
+            'Accept': 'application/beast2',
+        },
+    });
+    return decodeResponse(response, successType);
+}
+/**
+ * Decode a BEAST2 response with the Response wrapper type.
+ */
+async function decodeResponse(response, successType) {
+    if (response.status === 400) {
+        throw new Error(`Bad request: ${await response.text()}`);
+    }
+    if (response.status === 415) {
+        throw new Error(`Unsupported media type: expected application/beast2`);
+    }
+    const buffer = await response.arrayBuffer();
+    const decode = decodeBeast2For(ResponseType(successType));
+    return decode(new Uint8Array(buffer));
+}
+/**
+ * Unwrap a response, throwing on error.
+ */
+export function unwrap(response) {
+    if (response.type === 'error') {
+        const err = response.value;
+        throw new ApiError(err.type, err.value);
+    }
+    return response.value;
+}
+/**
+ * API error with typed error details.
+ */
+export class ApiError extends Error {
+    code;
+    details;
+    constructor(code, details) {
+        super(`API error: ${code}`);
+        this.code = code;
+        this.details = details;
+        this.name = 'ApiError';
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/src/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAMrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAW,EACX,IAAY,EACZ,WAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,EAAE;QAC5C,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,QAAQ,EAAE,oBAAoB;SAC/B;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,GAAW,EACX,IAAY,EACZ,IAAsB,EACtB,WAAgB,EAChB,WAAgB;IAEhB,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,EAAE;QAC5C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,oBAAoB;YACpC,QAAQ,EAAE,oBAAoB;SAC/B;QACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;KACnB,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAW,EACX,IAAY,EACZ,IAAsB,EACtB,WAAgB,EAChB,WAAgB;IAEhB,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,EAAE;QAC5C,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,cAAc,EAAE,oBAAoB;YACpC,QAAQ,EAAE,oBAAoB;SAC/B;QACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;KACnB,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAW,EACX,IAAY,EACZ,WAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,EAAE;QAC5C,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE;YACP,QAAQ,EAAE,oBAAoB;SAC/B;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,QAA6B,EAC7B,WAAc;IAEd,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAA6B,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAI,QAAqB;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEf;IACA;IAFlB,YACkB,IAAY,EACZ,OAAgB;QAEhC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QAHZ,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAS;QAGhC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}