@elaraai/e3-cli 0.0.2-beta.11 → 0.0.2-beta.13

package/dist/src/credentials.js

@@ -0,0 +1,213 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Credential storage for e3 CLI.
+ *
+ * Stores access and refresh tokens for authenticated servers
+ * in ~/.e3/credentials.json.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+/**
+ * Get path to credentials file.
+ * Uses E3_CREDENTIALS_PATH env var if set, otherwise ~/.e3/credentials.json.
+ */
+function getCredentialsPath() {
+    return process.env.E3_CREDENTIALS_PATH ?? path.join(os.homedir(), '.e3', 'credentials.json');
+}
+/**
+ * Normalize server URL (remove trailing slash).
+ */
+export function normalizeServerUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+/**
+ * Load credentials file.
+ */
+export function loadCredentials() {
+    try {
+        const content = fs.readFileSync(getCredentialsPath(), 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return { version: 1, credentials: {} };
+    }
+}
+/**
+ * Save credentials file.
+ */
+export function saveCredentials(file) {
+    const credPath = getCredentialsPath();
+    const dir = path.dirname(credPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(credPath, JSON.stringify(file, null, 2), { mode: 0o600 });
+}
+/**
+ * Get credential for a server.
+ */
+export function getCredential(serverUrl) {
+    const file = loadCredentials();
+    return file.credentials[normalizeServerUrl(serverUrl)] ?? null;
+}
+/**
+ * Set credential for a server.
+ */
+export function setCredential(serverUrl, entry) {
+    const file = loadCredentials();
+    file.credentials[normalizeServerUrl(serverUrl)] = entry;
+    saveCredentials(file);
+}
+/**
+ * Remove credential for a server.
+ */
+export function removeCredential(serverUrl) {
+    const file = loadCredentials();
+    const key = normalizeServerUrl(serverUrl);
+    if (key in file.credentials) {
+        delete file.credentials[key];
+        saveCredentials(file);
+        return true;
+    }
+    return false;
+}
+/**
+ * List all saved credentials.
+ */
+export function listCredentials() {
+    const file = loadCredentials();
+    return Object.entries(file.credentials).map(([server, entry]) => ({
+        server,
+        expiresAt: entry.expiresAt,
+    }));
+}
+/**
+ * Check if a token expiration time has passed.
+ */
+export function isExpired(expiresAt) {
+    return new Date(expiresAt).getTime() < Date.now();
+}
+/**
+ * Fetch OIDC discovery document.
+ */
+export async function fetchDiscovery(serverUrl) {
+    const url = `${normalizeServerUrl(serverUrl)}/.well-known/openid-configuration`;
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch OIDC discovery: ${response.status}`);
+    }
+    return response.json();
+}
+/**
+ * Start device authorization flow.
+ */
+export async function startDeviceAuth(discovery) {
+    const response = await fetch(discovery.device_authorization_endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({ client_id: 'e3-cli' }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to start device authorization: ${response.status}`);
+    }
+    return response.json();
+}
+/**
+ * Poll for device code approval.
+ */
+export async function pollForTokens(discovery, deviceCode, interval, expiresIn) {
+    const deadline = Date.now() + expiresIn * 1000;
+    while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, interval * 1000));
+        const response = await fetch(discovery.token_endpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({
+                grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+                device_code: deviceCode,
+                client_id: 'e3-cli',
+            }),
+        });
+        if (response.ok) {
+            return response.json();
+        }
+        const error = await response.json();
+        if (error.error === 'authorization_pending') {
+            continue; // Keep polling
+        }
+        if (error.error === 'slow_down') {
+            interval += 1; // Slow down as requested
+            continue;
+        }
+        throw new Error(`Token exchange failed: ${error.error} - ${error.error_description ?? ''}`);
+    }
+    throw new Error('Device authorization timed out');
+}
+/**
+ * Refresh an access token using a refresh token.
+ */
+export async function refreshAccessToken(serverUrl, refreshToken) {
+    const discovery = await fetchDiscovery(serverUrl);
+    const response = await fetch(discovery.token_endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+            grant_type: 'refresh_token',
+            refresh_token: refreshToken,
+            client_id: 'e3-cli',
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.json();
+        throw new Error(`Token refresh failed: ${error.error} - ${error.error_description ?? ''}`);
+    }
+    return response.json();
+}
+/**
+ * Get a valid access token for a server.
+ *
+ * If the current token is expired, attempts to refresh it.
+ * Throws if not logged in or refresh fails.
+ */
+export async function getValidToken(serverUrl) {
+    const creds = getCredential(serverUrl);
+    if (!creds) {
+        throw new Error(`Not logged in to ${serverUrl}. Run: e3 login ${serverUrl}`);
+    }
+    // Return existing token if not expired
+    if (!isExpired(creds.expiresAt)) {
+        return creds.accessToken;
+    }
+    // Attempt to refresh
+    try {
+        const tokens = await refreshAccessToken(serverUrl, creds.refreshToken);
+        const newEntry = {
+            accessToken: tokens.access_token,
+            refreshToken: tokens.refresh_token,
+            expiresAt: new Date(Date.now() + tokens.expires_in * 1000).toISOString(),
+        };
+        setCredential(serverUrl, newEntry);
+        return tokens.access_token;
+    }
+    catch (err) {
+        // Refresh failed, need to re-login
+        removeCredential(serverUrl);
+        const message = err instanceof Error ? err.message : 'unknown error';
+        throw new Error(`Session expired and refresh failed: ${message}. Run: e3 login ${serverUrl}`);
+    }
+}
+/**
+ * Decode JWT payload without verification (for display purposes only).
+ */
+export function decodeJwtPayload(token) {
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        throw new Error('Invalid JWT format');
+    }
+    return JSON.parse(Buffer.from(parts[1], 'base64url').toString());
+}
+//# sourceMappingURL=credentials.js.map

package/dist/src/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/credentials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAgE9B;;;GAGG;AACH,SAAS,kBAAkB;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;AAC/F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAqB;IACnD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,KAAsB;IACrE,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC;IACxD,eAAe,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB;IACpD,MAAM,GAAG,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,mCAAmC,CAAC;IAChF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAA4B,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAwB;IAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,6BAA6B,EAAE;QACpE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI,EAAE,IAAI,eAAe,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;KACnD,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAiC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAwB,EACxB,UAAkB,EAClB,QAAgB,EAChB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC;IAE/C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC;QAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;YAChE,IAAI,EAAE,IAAI,eAAe,CAAC;gBACxB,UAAU,EAAE,8CAA8C;gBAC1D,WAAW,EAAE,UAAU;gBACvB,SAAS,EAAE,QAAQ;aACpB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,IAAI,EAA4B,CAAC;QACnD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAwB,CAAC;QAC1D,IAAI,KAAK,CAAC,KAAK,KAAK,uBAAuB,EAAE,CAAC;YAC5C,SAAS,CAAC,eAAe;QAC3B,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAChC,QAAQ,IAAI,CAAC,CAAC,CAAC,yBAAyB;YACxC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,YAAoB;IAEpB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI,EAAE,IAAI,eAAe,CAAC;YACxB,UAAU,EAAE,eAAe;YAC3B,aAAa,EAAE,YAAY;YAC3B,SAAS,EAAE,QAAQ;SACpB,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAwB,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAA4B,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,mBAAmB,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAoB;YAChC,WAAW,EAAE,MAAM,CAAC,YAAY;YAChC,YAAY,EAAE,MAAM,CAAC,aAAa;YAClC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;SACzE,CAAC;QACF,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mCAAmC;QACnC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,mBAAmB,SAAS,EAAE,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAA4B,CAAC;AAC9F,CAAC"}

package/dist/src/utils.d.ts

@@ -4,6 +4,54 @@
  */
 import { parseDatasetPath, parsePackageRef } from '@elaraai/e3-types';
 export { parseDatasetPath, parsePackageRef };
+/**
+ * Repository location - either local filesystem or remote URL.
+ */
+export type RepoLocation = {
+    type: 'local';
+    path: string;
+} | {
+    type: 'remote';
+    baseUrl: string;
+    repo: string;
+    token: string;
+};
+/**
+ * Parse a repository location argument.
+ *
+ * Supports:
+ * - Local paths: `.`, `./repo`, `/path/to/repo`
+ * - Remote URLs: `http://...`, `https://...`
+ *
+ * For remote URLs, the URL should be the user-facing "shareable" URL,
+ * e.g., `https://platform.example.com/repos/my_repo`.
+ * The CLI will internally add `/api` when making API calls.
+ *
+ * For remote locations, this function will load and validate the auth token.
+ * If not logged in or token is expired and cannot be refreshed, throws an error.
+ *
+ * @returns For local: { type: 'local', path: '/absolute/path/to/repo' }
+ *          For remote: { type: 'remote', baseUrl: 'https://example.com', repo: 'my_repo', token: '...' }
+ */
+export declare function parseRepoLocation(arg: string): Promise<RepoLocation>;
+/**
+ * Repository location without required token (for sync parsing).
+ */
+export type RepoLocationNoToken = {
+    type: 'local';
+    path: string;
+} | {
+    type: 'remote';
+    baseUrl: string;
+    repo: string;
+};
+/**
+ * Parse a repository location (synchronous, no auth).
+ *
+ * Use this only for operations that don't need authentication (e.g., local repos).
+ * For remote repos, use parseRepoLocation() instead.
+ */
+export declare function parseRepoLocationSync(arg: string): RepoLocationNoToken;
 /**
  * Resolve repository path from CLI argument.
  * Supports `.` for current directory and relative/absolute paths.

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAGhF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAGhD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB1E;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CActE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAGhF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAGhD"}

package/dist/src/utils.js

@@ -8,8 +8,66 @@
 import { resolve } from 'path';
 import { repoGet } from '@elaraai/e3-core';
 import { parseDatasetPath, parsePackageRef } from '@elaraai/e3-types';
+import { getValidToken } from './credentials.js';
 // Re-export for convenience
 export { parseDatasetPath, parsePackageRef };
+/**
+ * Parse a repository location argument.
+ *
+ * Supports:
+ * - Local paths: `.`, `./repo`, `/path/to/repo`
+ * - Remote URLs: `http://...`, `https://...`
+ *
+ * For remote URLs, the URL should be the user-facing "shareable" URL,
+ * e.g., `https://platform.example.com/repos/my_repo`.
+ * The CLI will internally add `/api` when making API calls.
+ *
+ * For remote locations, this function will load and validate the auth token.
+ * If not logged in or token is expired and cannot be refreshed, throws an error.
+ *
+ * @returns For local: { type: 'local', path: '/absolute/path/to/repo' }
+ *          For remote: { type: 'remote', baseUrl: 'https://example.com', repo: 'my_repo', token: '...' }
+ */
+export async function parseRepoLocation(arg) {
+    if (arg.startsWith('https://') || arg.startsWith('http://')) {
+        const url = new URL(arg);
+        // Extract repo name from path: /repos/{repo}[/...]
+        const match = url.pathname.match(/^\/repos\/([^/]+)/);
+        if (!match) {
+            throw new Error(`Invalid remote URL: expected /repos/{repo} in path, got ${url.pathname}`);
+        }
+        // Load and validate token
+        const token = await getValidToken(url.origin);
+        return {
+            type: 'remote',
+            baseUrl: url.origin,
+            repo: match[1],
+            token,
+        };
+    }
+    return { type: 'local', path: resolveRepo(arg) };
+}
+/**
+ * Parse a repository location (synchronous, no auth).
+ *
+ * Use this only for operations that don't need authentication (e.g., local repos).
+ * For remote repos, use parseRepoLocation() instead.
+ */
+export function parseRepoLocationSync(arg) {
+    if (arg.startsWith('https://') || arg.startsWith('http://')) {
+        const url = new URL(arg);
+        const match = url.pathname.match(/^\/repos\/([^/]+)/);
+        if (!match) {
+            throw new Error(`Invalid remote URL: expected /repos/{repo} in path, got ${url.pathname}`);
+        }
+        return {
+            type: 'remote',
+            baseUrl: url.origin,
+            repo: match[1],
+        };
+    }
+    return { type: 'local', path: resolveRepo(arg) };
+}
 /**
  * Resolve repository path from CLI argument.
  * Supports `.` for current directory and relative/absolute paths.

package/dist/src/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtE,4BAA4B;AAC5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/e3-cli",
-  "version": "0.0.2-beta.11",
+  "version": "0.0.2-beta.13",
   "type": "module",
   "description": "East Execution Engine CLI - Command-line tool for managing e3 repositories and tasks",
   "main": "dist/src/index.js",
@@ -34,14 +34,15 @@
     "directory": "packages/e3-cli"
   },
   "dependencies": {
-    "@elaraai/e3": "^0.0.2-beta.11",
-    "@elaraai/e3-core": "^0.0.2-beta.11",
-    "@elaraai/e3-types": "^0.0.2-beta.11",
+    "@elaraai/e3": "^0.0.2-beta.13",
+    "@elaraai/e3-api-client": "^",
+    "@elaraai/e3-core": "^0.0.2-beta.13",
+    "@elaraai/e3-types": "^0.0.2-beta.13",
     "commander": "^12.0.0",
-    "esbuild": "^0.24.0"
+    "esbuild": "^0.27.2"
   },
   "peerDependencies": {
-    "@elaraai/east": "^0.0.1-beta.27"
+    "@elaraai/east": "^0.0.1-beta.29"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

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

@@ -1,12 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Licensed under BSL 1.1. See LICENSE for details.
- */
-/**
- * Run garbage collection.
- */
-export declare function gcCommand(repoArg: string, options: {
-    dryRun?: boolean;
-    minAge?: string;
-}): Promise<void>;
-//# sourceMappingURL=gc.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../../src/commands/gc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/src/commands/gc.js

@@ -1,44 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Licensed under BSL 1.1. See LICENSE for details.
- */
-/**
- * e3 gc command - Garbage collection
- *
- * Usage:
- *   e3 gc .
- *   e3 gc . --dry-run
- */
-import { repoGc } from '@elaraai/e3-core';
-import { resolveRepo, formatError, exitError } from '../utils.js';
-/**
- * Run garbage collection.
- */
-export async function gcCommand(repoArg, options) {
-    try {
-        const repoPath = resolveRepo(repoArg);
-        const minAge = options.minAge ? parseInt(options.minAge, 10) : 60000;
-        if (options.dryRun) {
-            console.log('Dry run - no files will be deleted');
-        }
-        console.log(`Minimum age: ${minAge}ms`);
-        console.log('');
-        const result = await repoGc(repoPath, {
-            dryRun: options.dryRun,
-            minAge,
-        });
-        console.log('Garbage collection complete:');
-        console.log(`  Objects retained: ${result.retainedObjects}`);
-        console.log(`  Objects deleted:  ${result.deletedObjects}`);
-        console.log(`  Partials deleted: ${result.deletedPartials}`);
-        console.log(`  Skipped (young):  ${result.skippedYoung}`);
-        if (result.bytesFreed > 0) {
-            const mb = (result.bytesFreed / 1024 / 1024).toFixed(2);
-            console.log(`  Space reclaimed:  ${mb} MB`);
-        }
-    }
-    catch (err) {
-        exitError(formatError(err));
-    }
-}
-//# sourceMappingURL=gc.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"gc.js","sourceRoot":"","sources":["../../../src/commands/gc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAe,EACf,OAA8C;IAE9C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,IAAI,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM;SACP,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

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

@@ -1,9 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Licensed under BSL 1.1. See LICENSE for details.
- */
-/**
- * Initialize a new e3 repository.
- */
-export declare function initCommand(repoArg: string): void;
-//# sourceMappingURL=init.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAoBjD"}

package/dist/src/commands/init.js

@@ -1,33 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Licensed under BSL 1.1. See LICENSE for details.
- */
-/**
- * e3 init command - Initialize a new e3 repository
- */
-import { resolve } from 'path';
-import { repoInit } from '@elaraai/e3-core';
-import { formatError, exitError } from '../utils.js';
-/**
- * Initialize a new e3 repository.
- */
-export function initCommand(repoArg) {
-    const absolutePath = resolve(repoArg);
-    const result = repoInit(absolutePath);
-    if (!result.success) {
-        if (result.alreadyExists) {
-            exitError(`e3 repository already exists at ${result.e3Dir}`);
-        }
-        else {
-            exitError(`Failed to create repository: ${formatError(result.error)}`);
-        }
-    }
-    console.log(`Initialized e3 repository at ${result.e3Dir}`);
-    console.log('');
-    console.log('Created:');
-    console.log('  objects/      Content-addressable storage');
-    console.log('  packages/     Package references');
-    console.log('  workspaces/   Workspace state');
-    console.log('  executions/   Task execution cache');
-}
-//# sourceMappingURL=init.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,SAAS,CAAC,mCAAmC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,gCAAgC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gCAAgC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AACtD,CAAC"}

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

@@ -1,9 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Licensed under BSL 1.1. See LICENSE for details.
- */
-/**
- * Show repository or workspace status.
- */
-export declare function statusCommand(repoArg: string, workspace?: string): Promise<void>;
-//# sourceMappingURL=status.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtF"}