@elaraai/e3-cli 0.0.2-beta.5 → 0.0.2-beta.50

package/README.md

@@ -13,18 +13,19 @@ npm install -g @elaraai/e3-cli
 ### Repository
 
 ```bash
-e3 init <repo>                    # Initialize a new repository
-e3 status <repo>                  # Show repository status
-e3 gc <repo> [--dry-run]          # Remove unreferenced objects
+e3 repo create <repo>             # Create a new repository
+e3 repo status <repo>             # Show repository status
+e3 repo remove <repo>             # Remove a repository
+e3 repo gc <repo> [--dry-run]     # Remove unreferenced objects
 ```
 
 ### Packages
 
 ```bash
-e3 package import <repo> <zip>    # Import package from .zip
+e3 package import <repo> <zip>        # Import package from .zip
 e3 package export <repo> <pkg> <zip>  # Export package to .zip
-e3 package list <repo>            # List installed packages
-e3 package remove <repo> <pkg>    # Remove a package
+e3 package list <repo>                # List installed packages
+e3 package remove <repo> <pkg>        # Remove a package
 ```
 
 ### Workspaces
@@ -33,7 +34,9 @@ e3 package remove <repo> <pkg>    # Remove a package
 e3 workspace create <repo> <name>     # Create empty workspace
 e3 workspace deploy <repo> <ws> <pkg> # Deploy package to workspace
 e3 workspace export <repo> <ws> <zip> # Export workspace as package
+e3 workspace import <repo> <ws> <zip> # Import package zip into workspace
 e3 workspace list <repo>              # List workspaces
+e3 workspace status <repo> <ws>       # Show workspace status
 e3 workspace remove <repo> <ws>       # Remove workspace
 ```
 
@@ -41,6 +44,9 @@ e3 workspace remove <repo> <ws>       # Remove workspace
 
 ```bash
 e3 list <repo> [path]             # List workspaces or tree contents
+e3 list <repo> <path> -r          # List all dataset paths recursively
+e3 list <repo> <path> -l          # List immediate children with type/status/size
+e3 list <repo> <path> -r -l       # List all datasets with type/status/size
 e3 get <repo> <path> [-f format]  # Get dataset value (east/json/beast2)
 e3 set <repo> <path> <file>       # Set dataset value from file
 ```
@@ -48,8 +54,9 @@ e3 set <repo> <path> <file>       # Set dataset value from file
 ### Execution
 
 ```bash
-e3 run <repo> <task> [inputs...]  # Run task ad-hoc
 e3 start <repo> <ws>              # Execute tasks in workspace
+e3 run <repo> <task> [inputs...]  # Run task ad-hoc
+e3 watch <repo> <ws> <source.ts>  # Watch and auto-deploy on changes
 e3 logs <repo> <path> [--follow]  # View task logs
 ```
 
@@ -59,11 +66,28 @@ e3 logs <repo> <path> [--follow]  # View task logs
 e3 convert [input] --to <format>  # Convert between .east/.json/.beast2
 ```
 
+### Authentication (for remote servers)
+
+```bash
+e3 login <server>                 # Log in using OAuth2 Device Flow
+e3 logout <server>                # Log out and clear credentials
+e3 auth status                    # List all saved credentials
+e3 auth token <server>            # Print access token (for curl/debugging)
+e3 auth whoami [server]           # Show current identity
+```
+
+The `e3 auth token` command is useful for debugging API calls:
+
+```bash
+curl -H "Authorization: Bearer $(e3 auth token https://example.com)" \
+  https://example.com/api/repos/my-repo/status
+```
+
 ## Example
 
 ```bash
-# Initialize repository and import a package
-e3 init ./my-project
+# Create repository and import a package
+e3 repo create ./my-project
 e3 package import ./my-project ./greeting-pkg-1.0.0.zip
 
 # Create workspace and deploy package

package/dist/src/cli.js

@@ -8,8 +8,11 @@
  *
  * All commands take a repository path as the first argument (`.` for current directory).
  */
+import { createRequire } from 'node:module';
 import { Command } from 'commander';
-import { initCommand } from './commands/init.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../../package.json');
+import { repoCommand } from './commands/repo.js';
 import { packageCommand } from './commands/package.js';
 import { workspaceCommand } from './commands/workspace.js';
 import { listCommand } from './commands/list.js';
@@ -18,30 +21,41 @@ import { setCommand } from './commands/set.js';
 import { startCommand } from './commands/start.js';
 import { runCommand } from './commands/run.js';
 import { logsCommand } from './commands/logs.js';
-import { statusCommand } from './commands/status.js';
-import { gcCommand } from './commands/gc.js';
+import { datasetStatusCommand } from './commands/dataset-status.js';
 import { convertCommand } from './commands/convert.js';
 import { watchCommand } from './commands/watch.js';
+import { createAuthCommand, createLoginCommand, createLogoutCommand } from './commands/auth.js';
 const program = new Command();
 program
     .name('e3')
     .description('East Execution Engine - Execute tasks across multiple runtimes')
-    .version('0.0.1-alpha.0');
+    .version(packageJson.version);
 // Repository commands
 program
-    .command('init <repo>')
-    .description('Initialize a new e3 repository')
-    .action(initCommand);
-program
-    .command('status <repo> [workspace]')
-    .description('Show repository status, or detailed workspace status if workspace provided')
-    .action(statusCommand);
-program
-    .command('gc <repo>')
+    .command('repo')
+    .description('Repository operations')
+    .addCommand(new Command('create')
+    .description('Create a new repository')
+    .argument('<repo>', 'Repository path or URL')
+    .action(repoCommand.create))
+    .addCommand(new Command('remove')
+    .description('Remove a repository')
+    .argument('<repo>', 'Repository path or URL')
+    .action(repoCommand.remove))
+    .addCommand(new Command('status')
+    .description('Show repository status')
+    .argument('<repo>', 'Repository path or URL')
+    .action(repoCommand.status))
+    .addCommand(new Command('gc')
     .description('Remove unreferenced objects')
+    .argument('<repo>', 'Repository path or URL')
     .option('--dry-run', 'Report what would be deleted without deleting')
     .option('--min-age <ms>', 'Minimum file age in ms before deletion', '60000')
-    .action(gcCommand);
+    .action(repoCommand.gc))
+    .addCommand(new Command('list')
+    .description('List repositories on a server')
+    .argument('<server>', 'Server URL (e.g., http://localhost:3000)')
+    .action(repoCommand.list));
 // Package commands
 program
     .command('package')
@@ -89,6 +103,12 @@ program
     .option('--name <name>', 'Package name (default: deployed package name)')
     .option('--version <version>', 'Package version (default: auto-generated)')
     .action(workspaceCommand.export))
+    .addCommand(new Command('import')
+    .description('Import a package zip into a workspace (creates workspace if needed)')
+    .argument('<repo>', 'Repository path or URL')
+    .argument('<ws>', 'Workspace name')
+    .argument('<zipPath>', 'Input .zip path')
+    .action(workspaceCommand.import))
     .addCommand(new Command('list')
     .description('List workspaces')
     .argument('<repo>', 'Repository path')
@@ -97,11 +117,18 @@ program
     .description('Remove a workspace')
     .argument('<repo>', 'Repository path')
     .argument('<ws>', 'Workspace name')
-    .action(workspaceCommand.remove));
+    .action(workspaceCommand.remove))
+    .addCommand(new Command('status')
+    .description('Show detailed workspace status (tasks, datasets, locks)')
+    .argument('<repo>', 'Repository path')
+    .argument('<ws>', 'Workspace name')
+    .action(workspaceCommand.status));
 // Dataset commands
 program
     .command('list <repo> [path]')
     .description('List workspaces or tree contents at path (ws.path.to.tree)')
+    .option('-r, --recursive', 'List all datasets recursively')
+    .option('-l, --long', 'Show detailed information (type, status, size)')
     .action(listCommand);
 program
     .command('get <repo> <path>')
@@ -113,6 +140,10 @@ program
     .description('Set dataset value from file (ws.path.to.dataset)')
     .option('--type <typespec>', 'Type specification in .east format (required for .json/.csv files)')
     .action(setCommand);
+program
+    .command('status <repo> <path>')
+    .description('Show dataset status at path (ws.path.to.dataset)')
+    .action(datasetStatusCommand);
 // Execution commands
 program
     .command('run <repo> <task> [inputs...]')
@@ -148,5 +179,9 @@ program
     .option('-o, --output <path>', 'Output file path (default: stdout)')
     .option('--type <typespec>', 'Type specification in .east format')
     .action(convertCommand);
+// Authentication commands
+program.addCommand(createLoginCommand());
+program.addCommand(createLogoutCommand());
+program.addCommand(createAuthCommand());
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/commands/auth.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Authentication commands for e3 CLI.
+ */
+import { Command } from 'commander';
+/**
+ * Create the auth command group.
+ */
+export declare function createAuthCommand(): Command;
+/**
+ * Create the login command.
+ */
+export declare function createLoginCommand(): Command;
+/**
+ * Create the logout command.
+ */
+export declare function createLogoutCommand(): Command;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA+E3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAsE5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAa7C"}

package/dist/src/commands/auth.js

@@ -0,0 +1,196 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Authentication commands for e3 CLI.
+ */
+import { Command } from 'commander';
+import { fetchDiscovery, startDeviceAuth, pollForTokens, setCredential, removeCredential, listCredentials, getCredential, getValidToken, isExpired, decodeJwtPayload, normalizeServerUrl, } from '../credentials.js';
+import { formatError, exitError } from '../utils.js';
+/**
+ * Try to open a URL in the default browser.
+ */
+async function openBrowser(url) {
+    const { exec } = await import('node:child_process');
+    const { platform } = await import('node:os');
+    return new Promise((resolve) => {
+        let command;
+        switch (platform()) {
+            case 'darwin':
+                command = `open "${url}"`;
+                break;
+            case 'win32':
+                command = `start "" "${url}"`;
+                break;
+            default:
+                command = `xdg-open "${url}"`;
+        }
+        exec(command, (error) => {
+            resolve(!error);
+        });
+    });
+}
+/**
+ * Create the auth command group.
+ */
+export function createAuthCommand() {
+    const auth = new Command('auth')
+        .description('Authentication commands');
+    // e3 auth status - List all saved credentials
+    auth
+        .command('status')
+        .description('List saved credentials')
+        .action(() => {
+        const creds = listCredentials();
+        if (creds.length === 0) {
+            console.log('No saved credentials.');
+            console.log('Run: e3 login <server>');
+            return;
+        }
+        console.log('Saved credentials:\n');
+        for (const { server, expiresAt } of creds) {
+            const expired = isExpired(expiresAt);
+            const status = expired ? '(expired)' : '(valid)';
+            console.log(`  ${server} ${status}`);
+            console.log(`    Token expires: ${expiresAt}`);
+        }
+    });
+    // e3 auth token <server> - Print access token for use with curl
+    auth
+        .command('token')
+        .description('Print access token for a server (for curl/debugging)')
+        .argument('<server>', 'Server URL')
+        .action(async (server) => {
+        const serverUrl = normalizeServerUrl(server);
+        try {
+            // getValidToken handles refresh automatically if token is expired
+            const token = await getValidToken(serverUrl);
+            // Print just the token, suitable for: curl -H "Authorization: Bearer $(e3 auth token <server>)"
+            console.log(token);
+        }
+        catch (err) {
+            exitError(formatError(err));
+        }
+    });
+    // e3 auth whoami [server] - Show current identity
+    auth
+        .command('whoami')
+        .description('Show current identity')
+        .argument('[server]', 'Server URL')
+        .action((server) => {
+        const creds = listCredentials();
+        if (creds.length === 0) {
+            console.log('Not logged in to any servers.');
+            return;
+        }
+        const servers = server ? [server] : creds.map((c) => c.server);
+        for (const serverUrl of servers) {
+            const credential = getCredential(serverUrl);
+            if (!credential) {
+                console.log(`${serverUrl}: Not logged in`);
+                continue;
+            }
+            try {
+                const payload = decodeJwtPayload(credential.accessToken);
+                const expired = isExpired(credential.expiresAt);
+                const status = expired ? '(token expired)' : '';
+                console.log(`${serverUrl}: ${status}`);
+                console.log(`  Subject: ${payload.sub ?? 'unknown'}`);
+                if (payload.email) {
+                    console.log(`  Email: ${payload.email}`);
+                }
+                console.log(`  Issuer: ${payload.iss ?? 'unknown'}`);
+            }
+            catch {
+                console.log(`${serverUrl}: Invalid token`);
+            }
+        }
+    });
+    return auth;
+}
+/**
+ * Create the login command.
+ */
+export function createLoginCommand() {
+    return new Command('login')
+        .description('Log in to a server using OAuth2 Device Flow')
+        .argument('<server>', 'Server URL (e.g., http://localhost:3000)')
+        .option('--no-browser', 'Do not open browser (for CI/headless environments)')
+        .action(async (server, options) => {
+        const serverUrl = normalizeServerUrl(server);
+        console.log(`Logging in to ${serverUrl}...`);
+        // Fetch OIDC discovery document
+        let discovery;
+        try {
+            discovery = await fetchDiscovery(serverUrl);
+        }
+        catch (err) {
+            exitError(`Failed to connect to server: ${formatError(err)}\nMake sure the server is running with --oidc enabled.`);
+        }
+        // Start device authorization
+        let deviceAuth;
+        try {
+            deviceAuth = await startDeviceAuth(discovery);
+        }
+        catch (err) {
+            exitError(`Failed to start login: ${formatError(err)}`);
+        }
+        // Display user code and URL (unless in quiet CI mode)
+        if (options.browser) {
+            console.log('\nTo complete login:');
+            console.log(`  1. Open: ${deviceAuth.verification_uri}`);
+            console.log(`  2. Enter code: ${deviceAuth.user_code}`);
+            console.log(`\nOr visit this URL directly:`);
+            console.log(`  ${deviceAuth.verification_uri_complete}`);
+            // Try to open browser
+            const opened = await openBrowser(deviceAuth.verification_uri_complete);
+            if (opened) {
+                console.log('\nBrowser opened. Waiting for approval...');
+            }
+            else {
+                console.log('\nWaiting for approval...');
+            }
+        }
+        else {
+            console.log('Waiting for server approval (--no-browser mode)...');
+        }
+        // Poll for tokens
+        try {
+            const tokens = await pollForTokens(discovery, deviceAuth.device_code, deviceAuth.interval, deviceAuth.expires_in);
+            // Save credentials
+            const entry = {
+                accessToken: tokens.access_token,
+                refreshToken: tokens.refresh_token,
+                expiresAt: new Date(Date.now() + tokens.expires_in * 1000).toISOString(),
+            };
+            setCredential(serverUrl, entry);
+            // Show identity
+            const payload = decodeJwtPayload(tokens.access_token);
+            console.log(`\nSuccessfully logged in as: ${payload.sub ?? 'unknown'}`);
+            console.log(`Token expires: ${entry.expiresAt}`);
+        }
+        catch (err) {
+            exitError(`Login failed: ${formatError(err)}`);
+        }
+    });
+}
+/**
+ * Create the logout command.
+ */
+export function createLogoutCommand() {
+    return new Command('logout')
+        .description('Log out from a server')
+        .argument('<server>', 'Server URL')
+        .action((server) => {
+        const serverUrl = normalizeServerUrl(server);
+        const removed = removeCredential(serverUrl);
+        if (removed) {
+            console.log(`Logged out from ${serverUrl}`);
+        }
+        else {
+            console.log(`Not logged in to ${serverUrl}`);
+        }
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/commands/auth.js.map

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

package/dist/src/commands/dataset-status.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Show status detail for a single dataset at a path.
+ */
+export declare function datasetStatusCommand(repoArg: string, pathSpec: string): Promise<void>;
+//# sourceMappingURL=dataset-status.d.ts.map

package/dist/src/commands/dataset-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-status.d.ts","sourceRoot":"","sources":["../../../src/commands/dataset-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAgEf"}

package/dist/src/commands/dataset-status.js

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3 status command - Show dataset status detail
+ *
+ * Usage:
+ *   e3 status . ws.path.to.dataset
+ *   e3 status https://server/repos/myrepo ws.path.to.dataset
+ */
+import { workspaceGetDatasetStatus, LocalStorage } from '@elaraai/e3-core';
+import { datasetGetStatus as datasetGetStatusRemote } from '@elaraai/e3-api-client';
+import { printFor, EastTypeType, isVariant, toEastTypeValue } from '@elaraai/east';
+import { parseRepoLocation, parseDatasetPath, formatError, exitError } from '../utils.js';
+import { formatSize } from '../format.js';
+/**
+ * Show status detail for a single dataset at a path.
+ */
+export async function datasetStatusCommand(repoArg, pathSpec) {
+    try {
+        const location = await parseRepoLocation(repoArg);
+        const { ws, path } = parseDatasetPath(pathSpec);
+        if (path.length === 0) {
+            exitError('Path must include at least one field (e.g., ws.field)');
+        }
+        const pathStr = '.' + path.map(s => s.value).join('.');
+        const printType = printFor(EastTypeType);
+        if (location.type === 'local') {
+            const storage = new LocalStorage();
+            const result = await workspaceGetDatasetStatus(storage, location.path, ws, path);
+            // Convert type to EastTypeValue if needed
+            const typeValue = isVariant(result.datasetType)
+                ? result.datasetType
+                : toEastTypeValue(result.datasetType);
+            console.log(`Path:   ${pathStr}`);
+            console.log(`Type:   ${printType(typeValue)}`);
+            if (result.refType === 'unassigned') {
+                console.log('Status: unset');
+            }
+            else if (result.refType === 'null') {
+                console.log('Status: set');
+                console.log('Hash:   (null)');
+                console.log('Size:   0 B');
+            }
+            else {
+                console.log('Status: set');
+                console.log(`Hash:   ${result.hash}`);
+                console.log(`Size:   ${formatSize(result.size)}`);
+            }
+        }
+        else {
+            const detail = await datasetGetStatusRemote(location.baseUrl, location.repo, ws, path, { token: location.token });
+            console.log(`Path:   ${detail.path}`);
+            console.log(`Type:   ${printType(detail.type)}`);
+            if (detail.hash.type === 'none' && detail.size.type === 'none') {
+                console.log('Status: unset');
+            }
+            else {
+                console.log('Status: set');
+                if (detail.hash.type === 'some') {
+                    console.log(`Hash:   ${detail.hash.value}`);
+                }
+                else {
+                    console.log('Hash:   (null)');
+                }
+                if (detail.size.type === 'some') {
+                    console.log(`Size:   ${formatSize(Number(detail.size.value))}`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        exitError(formatError(err));
+    }
+}
+//# sourceMappingURL=dataset-status.js.map

package/dist/src/commands/dataset-status.js.map

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

package/dist/src/commands/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/get.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CA+Cf"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/get.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/src/commands/get.js

@@ -8,32 +8,50 @@
  * Usage:
  *   e3 get . ws.path.to.dataset
  *   e3 get . ws.path.to.dataset -f json
+ *   e3 get https://server/repos/myrepo ws.path.to.dataset
  */
-import { workspaceGetDatasetHash, datasetRead } from '@elaraai/e3-core';
-import { printFor, toJSONFor } from '@elaraai/east';
-import { resolveRepo, parseDatasetPath, formatError, exitError } from '../utils.js';
+import { workspaceGetDatasetHash, datasetRead, LocalStorage } from '@elaraai/e3-core';
+import { datasetGet as datasetGetRemote } from '@elaraai/e3-api-client';
+import { printFor, toJSONFor, decodeBeast2, toEastTypeValue, isVariant } from '@elaraai/east';
+import { parseRepoLocation, parseDatasetPath, formatError, exitError } from '../utils.js';
 /**
  * Get dataset value at a path.
  */
 export async function getCommand(repoArg, pathSpec, options) {
     try {
-        const repoPath = resolveRepo(repoArg);
+        const location = await parseRepoLocation(repoArg);
         const { ws, path } = parseDatasetPath(pathSpec);
         if (path.length === 0) {
             exitError('Path must include at least one field (e.g., ws.field)');
         }
-        // Get the hash first, then read with type info
-        const { refType, hash } = await workspaceGetDatasetHash(repoPath, ws, path);
-        if (refType === 'unassigned') {
-            exitError('Dataset is unassigned (pending task output)');
+        const format = options.format ?? 'east';
+        let type;
+        let value;
+        if (location.type === 'local') {
+            const storage = new LocalStorage();
+            // Get the hash first, then read with type info
+            const { refType, hash } = await workspaceGetDatasetHash(storage, location.path, ws, path);
+            if (refType === 'unassigned') {
+                exitError('Dataset is unassigned (pending task output)');
+            }
+            if (refType === 'null' || hash === null) {
+                console.log('null');
+                return;
+            }
+            // Read the dataset to get both value and type
+            const dataset = await datasetRead(storage, location.path, hash);
+            // Convert EastType to EastTypeValue if necessary
+            type = isVariant(dataset.type) ? dataset.type : toEastTypeValue(dataset.type);
+            value = dataset.value;
         }
-        if (refType === 'null' || hash === null) {
-            console.log('null');
-            return;
+        else {
+            // Remote: get raw BEAST2 bytes and decode
+            const { data: beast2Data } = await datasetGetRemote(location.baseUrl, location.repo, ws, path, { token: location.token });
+            // Decode BEAST2 to get type and value
+            const decoded = decodeBeast2(beast2Data);
+            type = decoded.type;
+            value = decoded.value;
         }
-        // Read the dataset to get both value and type
-        const { type, value } = await datasetRead(repoPath, hash);
-        const format = options.format ?? 'east';
         switch (format) {
             case 'east': {
                 const printer = printFor(type);