@cargo-ai/cli 1.0.13 → 1.0.14

package/build/commands/workspaceManagement/workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../../src/commands/workspaceManagement/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAiLN"}

package/build/commands/{workspace → workspaceManagement}/workspaces.js

@@ -5,8 +5,13 @@ export function registerWorkspacesCommands(parent, getApi) {
         .description("Workspace list and management");
     workspaces
         .command("list")
-        .description("List all workspaces")
-        .option("--refresh", "Refresh")
+        .description("List all workspaces accessible to the current user")
+        .option("--refresh", "Bypass any token cache and re-fetch from the server (useful after permission changes)")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai workspaceManagement workspaces list
+  $ cargo-ai workspaceManagement workspaces list --refresh
+  $ cargo-ai workspaceManagement workspaces list | jq -r '.workspaces[].uuid'`)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.workspaceManagement.workspace.all({
@@ -14,12 +19,28 @@ export function registerWorkspacesCommands(parent, getApi) {
         }));
         outputJson(result);
     });
+    workspaces
+        .command("get-current")
+        .description("Get the workspace currently selected via credentials or CARGO_WORKSPACE_UUID")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai workspaceManagement workspaces get-current
+  $ cargo-ai workspaceManagement workspaces get-current | jq -r .workspace.name`)
+        .action(async () => {
+        const api = getApi();
+        const result = await handleApiCall(() => api.workspaceManagement.workspace.getCurrent());
+        outputJson(result);
+    });
     workspaces
         .command("create")
-        .description("Create a workspace")
-        .requiredOption("--name <name>", "Workspace name")
-        .option("--logo-base64 <data>", "Logo as base64 string")
-        .option("--metadata <json>", 'Metadata (JSON object, e.g. {"key":"value"})')
+        .description("Create a new workspace")
+        .requiredOption("--name <name>", "Workspace display name")
+        .option("--logo-base64 <data>", "Logo image encoded as a base64 data string")
+        .option("--metadata <json>", 'Workspace metadata as a JSON object, e.g. {"mainGoal":["enrich"]}')
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai workspaceManagement workspaces create --name "Acme GTM"
+  $ cargo-ai workspaceManagement workspaces create --name "Acme GTM" --metadata '{"mainGoal":["enrich"]}'`)
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.workspaceManagement.workspace.create({
@@ -33,7 +54,15 @@ export function registerWorkspacesCommands(parent, getApi) {
     });
     workspaces
         .command("update")
-        .description("Update a workspace")
+        .description("Update properties of the currently selected workspace")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai workspaceManagement workspaces update --name "New name"
+  $ cargo-ai workspaceManagement workspaces update --allowed-email-domains acme.com,example.org
+  $ cargo-ai workspaceManagement workspaces update --openai-api-key null   # remove the key
+  $ cargo-ai workspaceManagement workspaces update --metadata '{"mainGoal":["enrich","prioritize"]}'
+
+Pass the literal string "null" to remove a nullable value.`)
         .option("--name <name>", "Workspace name")
         .option("--allowed-email-domains <list>", "Allowed email domains (comma-separated)")
         .option("--logo-base64 <data>", "Logo as base64 string (use 'null' to remove)")

package/build/config.d.ts

@@ -1,7 +1,9 @@
+export type ConfigSource = "environment" | "credentials-file" | "none";
 export type Config = {
+    accessToken: string | undefined;
     baseUrl: string;
-    accessToken: string;
     workspaceUuid: string | undefined;
+    source: ConfigSource;
 };
 export declare function getConfig(): Config;
 //# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAIF,wBAAgB,SAAS,IAAI,MAAM,CAmBlC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAEvE,MAAM,MAAM,MAAM,GAAG;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAIF,wBAAgB,SAAS,IAAI,MAAM,CA4BlC"}

package/build/config.js

@@ -2,27 +2,29 @@ import { loadCredentials } from "./credentials.js";
 const DEFAULT_BASE_URL = "https://api.getcargo.io";
 export function getConfig() {
     const credentials = loadCredentials();
-    const accessToken = getAccessToken(credentials);
-    if (accessToken === undefined) {
-        console.error(JSON.stringify({
-            error: 'Not authenticated. Run "cargo-ai login --token <token>" or set CARGO_API_TOKEN.',
-        }));
-        process.exit(1);
-    }
-    const baseUrl = getBaseUrl(credentials);
-    const workspaceUuid = getWorkspaceUuid(credentials);
-    return { baseUrl, accessToken, workspaceUuid };
-}
-const getAccessToken = (credentials) => {
     const envToken = process.env["CARGO_API_TOKEN"];
+    let accessToken;
+    let source;
     if (envToken !== undefined) {
-        return envToken;
+        accessToken = envToken;
+        source = "environment";
     }
-    if (credentials !== undefined) {
-        return credentials.accessToken;
+    else if (credentials !== undefined &&
+        credentials.accessToken !== undefined) {
+        accessToken = credentials.accessToken;
+        source = "credentials-file";
     }
-    return undefined;
-};
+    else {
+        accessToken = undefined;
+        source = "none";
+    }
+    return {
+        accessToken,
+        baseUrl: getBaseUrl(credentials),
+        workspaceUuid: getWorkspaceUuid(credentials),
+        source,
+    };
+}
 const getBaseUrl = (credentials) => {
     const envUrl = process.env["CARGO_BASE_URL"];
     if (envUrl !== undefined) {

package/build/index.js

@@ -3,7 +3,7 @@ import { createRequire } from "node:module";
 import { Command } from "commander";
 import { createApi } from "./api.js";
 import { registerAiCommands } from "./commands/ai/index.js";
-import { registerAuthCommands } from "./commands/auth.js";
+import { registerAuthCommands } from "./commands/auth/index.js";
 import { registerBillingCommands } from "./commands/billing/index.js";
 import { registerConnectionCommands } from "./commands/connection/index.js";
 import { registerContextCommands } from "./commands/context/index.js";
@@ -11,11 +11,13 @@ import { registerExpressionCommands } from "./commands/expression/index.js";
 import { registerInitCommand } from "./commands/init.js";
 import { registerOrchestrationCommands } from "./commands/orchestration/index.js";
 import { registerRevenueOrganizationCommands } from "./commands/revenueOrganization/index.js";
+import { ExitCodes, failWith } from "./commands/runHandler.js";
 import { registerSegmentationCommands } from "./commands/segmentation/index.js";
 import { registerStorageCommands } from "./commands/storage/index.js";
 import { registerSystemOfRecordIntegrationCommands } from "./commands/systemOfRecordIntegration/index.js";
 import { registerUserManagementCommands } from "./commands/userManagement/index.js";
-import { registerWorkspaceCommands } from "./commands/workspace/index.js";
+import { registerWorkspaceManagementCommands } from "./commands/workspaceManagement/index.js";
+import { getConfig } from "./config.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const program = new Command();
@@ -25,19 +27,34 @@ program
     .version(version)
     .addHelpText("after", `
 Authentication:
-  Save credentials:   cargo-ai login --token <your-token>
+  With API token:     cargo-ai login --token <your-token>
+  Browser sign-in:    cargo-ai login --oauth
   Use env variables:  CARGO_API_TOKEN, CARGO_WORKSPACE_UUID, CARGO_BASE_URL
   Check status:       cargo-ai whoami
 
-All commands output JSON to stdout. Errors exit with code 1.
+All commands output JSON to stdout. Status messages, prompts, and errors go to stderr.
+
+Exit codes:
+  0  Success
+  1  Generic error
+  2  Invalid usage (missing/conflicting flags)
+  3  Not authenticated (run \`cargo-ai login\`)
+  4  Permission denied
+  5  Not found
 
 Run "cargo-ai <command> --help" for details on a specific command group.
 Run "cargo-ai <command> <subcommand> --help" for details on a subcommand.`);
-const getApi = () => createApi();
+const getApi = () => {
+    const { baseUrl, accessToken, workspaceUuid } = getConfig();
+    if (accessToken === undefined) {
+        failWith("Not authenticated. Run 'cargo-ai login --token <token>' or 'cargo-ai login --oauth'.", { code: ExitCodes.NotAuthenticated });
+    }
+    return createApi({ baseUrl, accessToken, workspaceUuid });
+};
 registerAuthCommands(program, getApi);
 registerInitCommand(program, getApi);
 registerOrchestrationCommands(program, getApi);
-registerWorkspaceCommands(program, getApi);
+registerWorkspaceManagementCommands(program, getApi);
 registerStorageCommands(program, getApi);
 registerConnectionCommands(program, getApi);
 registerContextCommands(program, getApi);
@@ -49,8 +66,5 @@ registerSystemOfRecordIntegrationCommands(program, getApi);
 registerUserManagementCommands(program, getApi);
 registerAiCommands(program, getApi);
 program.parseAsync().catch((err) => {
-    console.error(JSON.stringify({
-        error: err instanceof Error ? err.message : String(err),
-    }));
-    process.exit(1);
+    failWith(err instanceof Error ? err.message : String(err));
 });

package/build/oauthConfig.d.ts

@@ -0,0 +1,13 @@
+export type OAuthConfig = {
+    domain: string;
+    clientId: string;
+    audience: string;
+    scope: string;
+};
+export type OAuthConfigOverrides = {
+    domain?: string;
+    clientId?: string;
+    audience?: string;
+};
+export declare function getOAuthConfig(overrides: OAuthConfigOverrides): OAuthConfig;
+//# sourceMappingURL=oauthConfig.d.ts.map

package/build/oauthConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthConfig.d.ts","sourceRoot":"","sources":["../src/oauthConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAOF,wBAAgB,cAAc,CAAC,SAAS,EAAE,oBAAoB,GAAG,WAAW,CAO3E"}

package/build/oauthConfig.js

@@ -0,0 +1,17 @@
+const DEFAULT_DOMAIN = "auth.getcargo.io";
+const DEFAULT_AUDIENCE = "https://api.getcargo.io";
+const DEFAULT_SCOPE = "openid profile email offline_access";
+const DEFAULT_CLIENT_ID = "oUc99KlLSMAYUAPgxTUyqazef0sxR93b";
+export function getOAuthConfig(overrides) {
+    return {
+        domain: pickString(overrides.domain, DEFAULT_DOMAIN),
+        audience: pickString(overrides.audience, DEFAULT_AUDIENCE),
+        clientId: pickString(overrides.clientId, DEFAULT_CLIENT_ID),
+        scope: DEFAULT_SCOPE,
+    };
+}
+const pickString = (override, fallback) => {
+    if (override !== undefined && override.length > 0)
+        return override;
+    return fallback;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "private": false,
   "description": "Command-line interface for the Cargo API",
   "engines": {
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "commander": "^12.1.0",
-    "@cargo-ai/api": "^1.0.21"
+    "@cargo-ai/api": "^1.0.22"
   },
   "devDependencies": {
     "@cargo-ai/eslint-config": "*",

package/build/commands/auth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAWrC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuIN"}

package/build/commands/auth.js

@@ -1,104 +0,0 @@
-import { clearCredentials, getCredentialsPath, loadCredentials, saveCredentials, } from "../credentials.js";
-import { handleApiCall, outputJson } from "./runHandler.js";
-const DEFAULT_BASE_URL = "https://api.getcargo.io";
-export function registerAuthCommands(program, getApi) {
-    program
-        .command("login")
-        .description("Save API credentials for future use")
-        .requiredOption("--token <token>", "Cargo API token (string)")
-        .option("--workspace-uuid <uuid>", "Default workspace UUID (string, UUID v4)")
-        .option("--base-url <url>", `API base URL (string, default: ${DEFAULT_BASE_URL})`)
-        .addHelpText("after", `
-Examples:
-  $ cargo-ai login --token sk_live_abc123
-  $ cargo-ai login --token sk_live_abc123 --workspace-uuid 550e8400-e29b-41d4-a716-446655440000
-  $ cargo-ai login --token sk_live_abc123 --base-url https://api.custom.io
-
-Credentials are stored in ~/.config/cargo-ai/credentials.json.
-Environment variables (CARGO_API_TOKEN, CARGO_WORKSPACE_UUID, CARGO_BASE_URL) take precedence over saved credentials.`)
-        .action((opts) => {
-        saveCredentials({
-            accessToken: opts.token,
-            workspaceUuid: opts.workspaceUuid,
-            baseUrl: opts.baseUrl,
-        });
-        outputJson({
-            ok: true,
-            credentialsFile: getCredentialsPath(),
-            baseUrl: opts.baseUrl !== undefined ? opts.baseUrl : DEFAULT_BASE_URL,
-            workspaceUuid: opts.workspaceUuid !== undefined ? opts.workspaceUuid : null,
-        });
-    });
-    program
-        .command("logout")
-        .description("Remove saved API credentials")
-        .action(() => {
-        const removed = clearCredentials();
-        outputJson({
-            ok: true,
-            removed,
-            credentialsFile: getCredentialsPath(),
-        });
-    });
-    program
-        .command("whoami")
-        .description("Show current user and workspace")
-        .addHelpText("after", `
-Returns JSON with: user (uuid, email, name), workspace (uuid, name),
-authentication source ("environment" or "credentials-file"), and base URL.`)
-        .action(async () => {
-        const envToken = process.env["CARGO_API_TOKEN"];
-        const envBaseUrl = process.env["CARGO_BASE_URL"];
-        const envWorkspace = process.env["CARGO_WORKSPACE_UUID"];
-        const creds = loadCredentials();
-        const hasToken = envToken !== undefined ||
-            (creds !== undefined && creds.accessToken !== undefined);
-        const baseUrl = envBaseUrl !== undefined
-            ? envBaseUrl
-            : creds !== undefined && creds.baseUrl !== undefined
-                ? creds.baseUrl
-                : DEFAULT_BASE_URL;
-        const workspaceUuid = envWorkspace !== undefined
-            ? envWorkspace
-            : creds !== undefined
-                ? creds.workspaceUuid
-                : undefined;
-        if (hasToken === false) {
-            outputJson({
-                user: null,
-                workspace: null,
-                source: "none",
-                baseUrl,
-                credentialsFile: getCredentialsPath(),
-                warnings: [
-                    'Not authenticated. Run "cargo-ai login --token <token>" or set CARGO_API_TOKEN.',
-                ],
-            });
-            return;
-        }
-        const source = envToken !== undefined ? "environment" : "credentials-file";
-        const api = getApi();
-        const { user } = await handleApiCall(() => api.userManagement.user.getCurrent());
-        const { workspaces } = await handleApiCall(() => api.workspaceManagement.workspace.all({ refresh: false }));
-        const matchedWorkspace = workspaceUuid !== undefined
-            ? workspaces.find((workspace) => {
-                return workspace.uuid === workspaceUuid;
-            })
-            : workspaces[0];
-        const workspace = matchedWorkspace !== undefined
-            ? { uuid: matchedWorkspace.uuid, name: matchedWorkspace.name }
-            : null;
-        outputJson({
-            user: {
-                uuid: user.uuid,
-                email: user.email,
-                firstName: user.firstName,
-                lastName: user.lastName,
-            },
-            workspace,
-            source,
-            baseUrl,
-            credentialsFile: getCredentialsPath(),
-        });
-    });
-}

package/build/commands/workspace/file.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA+C7E"}

package/build/commands/workspace/folder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/folder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA6FN"}

package/build/commands/workspace/index.d.ts

@@ -1,4 +0,0 @@
-import type { Command } from "commander";
-import type { Api } from "../../api.js";
-export declare function registerWorkspaceCommands(parent: Command, getApi: () => Api): void;
-//# sourceMappingURL=index.d.ts.map

package/build/commands/workspace/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAQxC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAWN"}

package/build/commands/workspace/index.js

@@ -1,17 +0,0 @@
-import { registerFileCommands } from "./file.js";
-import { registerFolderCommands } from "./folder.js";
-import { registerRoleCommands } from "./role.js";
-import { registerTokenCommands } from "./token.js";
-import { registerUserCommands } from "./user.js";
-import { registerWorkspacesCommands } from "./workspaces.js";
-export function registerWorkspaceCommands(parent, getApi) {
-    const workspace = parent
-        .command("workspace")
-        .description("Workspaces, users, tokens, roles, folders");
-    registerWorkspacesCommands(workspace, getApi);
-    registerUserCommands(workspace, getApi);
-    registerTokenCommands(workspace, getApi);
-    registerRoleCommands(workspace, getApi);
-    registerFolderCommands(workspace, getApi);
-    registerFileCommands(workspace, getApi);
-}

package/build/commands/workspace/role.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/role.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAa7E"}

package/build/commands/workspace/token.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAoCN"}

package/build/commands/workspace/user.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAIxC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CA0L7E"}

package/build/commands/workspace/workspaces.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA0HN"}