@ogment-ai/cli 0.3.0 → 0.3.2

package/README.md

@@ -2,19 +2,32 @@
 
 **Secure your AI agents' SaaS credentials.**
 
+Package: `@ogment-ai/cli`  
+Binary: `ogment`
+
 Ogment sits between your AI agent and your SaaS tools. Your agent gets a scoped, revocable API key — your real credentials never leave Ogment.
 
+## Install
+
+```bash
+# Global install (recommended)
+npm install -g @ogment-ai/cli
+
+# One-off usage without installing globally
+npx @ogment-ai/cli --help
+```
+
 ## Quick Start
 
 ```bash
 # Log in (opens browser for OAuth + agent selection)
-npx ogment login
+ogment login
 
 # List available servers
-npx ogment servers
+ogment servers
 
 # Call a tool
-npx ogment call <server> <tool> '{"param": "value"}'
+ogment call <server> <tool> '{"param": "value"}'
 ```
 
 ## Development
@@ -22,12 +35,12 @@ npx ogment call <server> <tool> '{"param": "value"}'
 ### Run Tests
 
 ```bash
-pnpm run test          # Watch mode
-pnpm run test:run      # Single run
-pnpm run test:coverage # Coverage (text + html + lcov)
-pnpm run test:ui       # Vitest UI
-pnpm run test:changed  # Run tests related to changed files
-pnpm run test:ci       # CI profile (coverage + CI reporters)
+npm run test          # Watch mode
+npm run test:run      # Single run
+npm run test:coverage # Coverage (text + html + lcov)
+npm run test:ui       # Vitest UI
+npm run test:changed  # Run tests related to changed files
+npm run test:ci       # CI profile (coverage + CI reporters)
 ```
 
 ## Commands
@@ -37,7 +50,7 @@ pnpm run test:ci       # CI profile (coverage + CI reporters)
 Authenticate with the Ogment platform. Opens your browser for OAuth sign-in, then shows an agent picker where you create or select an agent. The resulting API key is stored locally.
 
 ```bash
-npx ogment login
+ogment login
 ```
 
 ### `ogment login --device`
@@ -45,7 +58,7 @@ npx ogment login
 For headless or remote environments (VMs, CI servers) where a browser isn't available. Displays a short code that you enter on the Ogment dashboard from any device.
 
 ```bash
-npx ogment login --device
+ogment login --device
 
 # Shows:
 #   Enter this code on the Ogment dashboard:
@@ -58,9 +71,9 @@ npx ogment login --device
 List configured servers or inspect a server's tools.
 
 ```bash
-npx ogment servers                # List all servers
-npx ogment servers <path>         # Inspect tools
-npx ogment servers --json         # Machine-readable output
+ogment servers                # List all servers
+ogment servers <path>         # Inspect tools
+ogment servers --json         # Machine-readable output
 ```
 
 ### `ogment call <server> <tool> [args]`
@@ -68,8 +81,8 @@ npx ogment servers --json         # Machine-readable output
 Call a tool on an Ogment server. Always outputs JSON.
 
 ```bash
-npx ogment call ecommerce-api get__health
-npx ogment call ecommerce-api get__api_products_ '{"limit":2}'
+ogment call ecommerce-api get__health
+ogment call ecommerce-api get__api_products_ '{"limit":2}'
 ```
 
 ### `ogment logout`
@@ -77,7 +90,7 @@ npx ogment call ecommerce-api get__api_products_ '{"limit":2}'
 Delete local credentials. To revoke the API key (prevent all access), use the Ogment dashboard.
 
 ```bash
-npx ogment logout
+ogment logout
 ```
 
 ## Authentication Model

package/dist/cli.d.ts

@@ -15,5 +15,6 @@ interface Runtime {
 }
 export declare const runCli: (argv?: readonly string[], runtime?: Runtime) => Promise<ExitCode>;
 export declare const executeCli: () => Promise<void>;
+export declare const shouldExecuteCli: (importMetaUrl: string, argv1: string | undefined) => boolean;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAQA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAO7E,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAK5E,OAAO,EAAa,KAAK,QAAQ,EAAoB,MAAM,wBAAwB,CAAC;AAIpF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1B;AAED,UAAU,OAAO;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;CACvB;AA4XD,eAAO,MAAM,MAAM,GACjB,OAAM,SAAS,MAAM,EAA0B,EAC/C,UAAS,OAAyB,KACjC,OAAO,CAAC,QAAQ,CAmBlB,CAAC;AAEF,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAG/C,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AASA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAO7E,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAK5E,OAAO,EAAa,KAAK,QAAQ,EAAoB,MAAM,wBAAwB,CAAC;AAIpF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1B;AAED,UAAU,OAAO;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;CACvB;AA4XD,eAAO,MAAM,MAAM,GACjB,OAAM,SAAS,MAAM,EAA0B,EAC/C,UAAS,OAAyB,KACjC,OAAO,CAAC,QAAQ,CAmBlB,CAAC;AAEF,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAG/C,CAAC;AAMF,eAAO,MAAM,gBAAgB,GAAI,eAAe,MAAM,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,OAanF,CAAC"}

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { pathToFileURL } from "node:url";
+import { realpathSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command, CommanderError } from "commander";
 import { runCallCommand } from "./commands/call.js";
 import { runDescribeCommand } from "./commands/describe.js";
@@ -332,6 +333,22 @@ export const executeCli = async () => {
     const code = await runCli();
     process.exitCode = code;
 };
-if (process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href) {
+const toCanonicalFileHref = (path) => {
+    return pathToFileURL(realpathSync(path)).href;
+};
+export const shouldExecuteCli = (importMetaUrl, argv1) => {
+    if (argv1 === undefined) {
+        return false;
+    }
+    try {
+        const invokedFileHref = toCanonicalFileHref(argv1);
+        const moduleFileHref = toCanonicalFileHref(fileURLToPath(importMetaUrl));
+        return invokedFileHref === moduleFileHref;
+    }
+    catch {
+        return false;
+    }
+};
+if (shouldExecuteCli(import.meta.url, process.argv[1])) {
     await executeCli();
 }

package/dist/postinstall.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":""}

package/dist/postinstall.js

@@ -0,0 +1,12 @@
+const installGreetingLines = [
+    "Thanks for installing @ogment-ai/cli.",
+    "",
+    "Next steps:",
+    "  1. ogment login",
+    "  2. ogment servers",
+    "  3. ogment --help",
+    "",
+    "Docs: https://github.com/ogment-ai/ogment-cli/tree/main/packages/ogment#quick-start",
+];
+process.stdout.write(`${installGreetingLines.join("\n")}\n`);
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogment-ai/cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Ogment Vault CLI — secure your AI agents' SaaS credentials",
   "type": "module",
   "bin": {
@@ -11,14 +11,17 @@
     "build": "npm run clean && tsc -p tsconfig.build.json",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
+    "postinstall": "node -e \"import('./dist/postinstall.js').catch(() => undefined)\"",
     "check-types": "tsc -p tsconfig.json --noEmit",
-    "lint": "oxlint -c oxlint.config.ts --type-aware --type-check --tsconfig tsconfig.json src test/src vitest.config.ts",
+    "lint": "oxlint -c oxlint.config.ts --type-aware --type-check --tsconfig tsconfig.json src test/src test/e2e vitest.config.ts vitest.e2e.config.ts",
     "lint:fix": "npm run lint -- --fix",
-    "format": "oxfmt --write src test/src",
-    "format:check": "oxfmt --check src test/src",
+    "format": "oxfmt --write src test/src test/e2e",
+    "format:check": "oxfmt --check src test/src test/e2e",
     "test": "vitest -c vitest.config.ts",
     "test:run": "vitest run -c vitest.config.ts",
     "test:coverage": "npm run test:run -- --coverage",
+    "test:e2e": "npm run build && vitest run -c vitest.e2e.config.ts",
+    "test:e2e:live": "npm run build && OGMENT_E2E_LIVE=1 vitest run -c vitest.e2e.config.ts test/e2e/live.local.test.ts",
     "test:ui": "npm run test -- --ui",
     "test:changed": "npm run test:run -- --changed",
     "test:ci": "npm run test:coverage",
@@ -59,7 +62,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@ogment-ai/cli-contract": "0.3.0",
+    "@ogment-ai/cli-contract": "0.3.2",
     "better-result": "^2.7.0",
     "commander": "^13.1.0",
     "open": "^10.2.0",