@execlave/cli 1.0.2 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,26 +1,132 @@
1
1
  import Conf from 'conf';
2
+ import { chmodSync } from 'node:fs';
3
+ import { spawnSync } from 'node:child_process';
2
4
  const config = new Conf({
3
5
  projectName: 'execlave-cli',
4
6
  });
5
- export const getStoredToken = () => config.get('token') ||
6
- process.env.EXECLAVE_API_KEY ||
7
- process.env.AGENTGUARD_API_KEY ||
8
- undefined;
9
- export const setStoredToken = (token) => config.set('token', token);
7
+ // Best-effort hardening of the on-disk config so a stored API token isn't readable
8
+ // by other local users (03-cli-009). Failures are non-fatal — we surface a warning
9
+ // once and let the user continue. POSIX gets 0o600; Windows gets ACL inheritance
10
+ // stripped via icacls so only the current user retains access.
11
+ let permsHardened = false;
12
+ function hardenConfigPerms() {
13
+ if (permsHardened)
14
+ return;
15
+ permsHardened = true;
16
+ const path = config.path;
17
+ try {
18
+ if (process.platform === 'win32') {
19
+ const user = process.env.USERNAME || process.env.USER;
20
+ if (!user)
21
+ return;
22
+ const r = spawnSync('icacls', [path, '/inheritance:r', '/grant:r', `${user}:F`], {
23
+ stdio: 'ignore',
24
+ windowsHide: true,
25
+ });
26
+ if (r.status !== 0) {
27
+ console.warn(`[execlave] could not harden ACL on ${path}; the file may be readable by other local users.`);
28
+ }
29
+ }
30
+ else {
31
+ chmodSync(path, 0o600);
32
+ }
33
+ }
34
+ catch (err) {
35
+ console.warn(`[execlave] could not tighten permissions on ${path}: ${err?.message || err}`);
36
+ }
37
+ }
38
+ // Per-invocation API-version override (set by --api-version CLI flag).
39
+ // Kept in-process only — never persisted, so a typo can't corrupt the stored config.
40
+ let runtimeApiVersion;
41
+ export const setRuntimeApiVersion = (version) => {
42
+ runtimeApiVersion = version;
43
+ };
44
+ let deprecationWarned = false;
45
+ function warnLegacyEnvOnce(name, replacement) {
46
+ if (deprecationWarned)
47
+ return;
48
+ if (process.env[name]) {
49
+ deprecationWarned = true;
50
+ // eslint-disable-next-line no-console
51
+ console.warn(`[execlave] ${name} is deprecated; please switch to ${replacement}.`);
52
+ }
53
+ }
54
+ // Env vars take precedence over the stored token so CI runners can swap identities
55
+ // without hand-editing config.json (03-cli-003). Stored token is the fallback.
56
+ export const getStoredToken = () => {
57
+ if (process.env.AGENTGUARD_API_KEY)
58
+ warnLegacyEnvOnce('AGENTGUARD_API_KEY', 'EXECLAVE_API_KEY');
59
+ return (process.env.EXECLAVE_API_KEY ||
60
+ process.env.AGENTGUARD_API_KEY ||
61
+ config.get('token') ||
62
+ undefined);
63
+ };
64
+ export const setStoredToken = (token) => {
65
+ config.set('token', token);
66
+ hardenConfigPerms();
67
+ };
10
68
  export const clearStoredToken = () => config.delete('token');
11
- export const getApiVersion = () => config.get('apiVersion') || 'v1';
12
- export const setApiVersion = (version) => config.set('apiVersion', version);
13
- export const getBaseUrl = () => {
14
- const base = config.get('baseUrl') ||
15
- process.env.EXECLAVE_BASE_URL ||
69
+ const VALID_API_VERSIONS = new Set(['v0', 'v1']);
70
+ export const isValidApiVersion = (v) => VALID_API_VERSIONS.has(v);
71
+ export const getApiVersion = () => runtimeApiVersion ?? config.get('apiVersion') ?? 'v1';
72
+ export const setApiVersion = (version) => {
73
+ if (!VALID_API_VERSIONS.has(version)) {
74
+ throw new Error(`Invalid API version "${version}". Allowed: ${Array.from(VALID_API_VERSIONS).join(', ')}.`);
75
+ }
76
+ config.set('apiVersion', version);
77
+ };
78
+ export const isBaseUrlExplicit = () => Boolean(process.env.EXECLAVE_BASE_URL ||
79
+ process.env.AGENTGUARD_BASE_URL ||
80
+ config.get('baseUrl'));
81
+ const getRawBaseHost = () => {
82
+ if (process.env.AGENTGUARD_BASE_URL)
83
+ warnLegacyEnvOnce('AGENTGUARD_BASE_URL', 'EXECLAVE_BASE_URL');
84
+ return (process.env.EXECLAVE_BASE_URL ||
16
85
  process.env.AGENTGUARD_BASE_URL ||
17
- 'https://api.execlave.com';
86
+ config.get('baseUrl') ||
87
+ 'https://api.execlave.com');
88
+ };
89
+ export const getBaseUrl = () => {
90
+ const base = getRawBaseHost();
18
91
  const version = getApiVersion();
19
92
  if (version && version !== 'v0') {
20
93
  return `${base.replace(/\/+$/, '')}/api/${version}`;
21
94
  }
22
95
  return `${base.replace(/\/+$/, '')}/api`;
23
96
  };
97
+ /**
98
+ * Return the raw base URL host (e.g. `https://api.execlave.com`) without the
99
+ * `/api` or `/api/v1` suffix that {@link getBaseUrl} appends. Use this for
100
+ * infrastructure endpoints like `/health` and `/ready` which live outside the
101
+ * versioned API.
102
+ */
103
+ export const getRawBaseUrl = () => {
104
+ const base = getRawBaseHost();
105
+ try {
106
+ const url = new URL(base);
107
+ url.pathname = '/';
108
+ return url.origin;
109
+ }
110
+ catch {
111
+ return base.replace(/\/+$/, '').replace(/\/api(?:\/v\d+)?$/, '');
112
+ }
113
+ };
114
+ let implicitProdWarned = false;
115
+ /**
116
+ * Warn (once per process) when a network call is about to use the default
117
+ * production base URL because neither EXECLAVE_BASE_URL/AGENTGUARD_BASE_URL nor
118
+ * a stored config baseUrl was set. Surfaced from the API client interceptor so
119
+ * every mutating/networked command shares the same notice (B2).
120
+ */
121
+ export const warnImplicitProductionBaseUrlOnce = () => {
122
+ if (implicitProdWarned)
123
+ return;
124
+ if (isBaseUrlExplicit())
125
+ return;
126
+ implicitProdWarned = true;
127
+ // eslint-disable-next-line no-console
128
+ console.warn('[execlave] Using default API endpoint: https://api.execlave.com (set EXECLAVE_BASE_URL or run `execlave login` to override).');
129
+ };
24
130
  export const setBaseUrl = (url) => config.set('baseUrl', url);
25
131
  export const getOrgId = () => config.get('organizationId');
26
132
  export const setOrgId = (id) => config.set('organizationId', id);
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAe;IAClC,WAAW,EAAE,cAAc;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAC/B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC5B,OAAO,CAAC,GAAG,CAAC,kBAAkB;IAC9B,SAAS,CAAC;AACd,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAEpF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE;IAC3B,MAAM,IAAI,GACN,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC/B,0BAA0B,CAAC;IAC/B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,IAAI,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,OAAO,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC;AAC7C,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAEzE,eAAe,MAAM,CAAC"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@execlave/cli",
3
- "version": "1.0.2",
3
+ "version": "1.0.5",
4
4
  "type": "module",
5
5
  "description": "CLI for the Execlave AI agent governance platform",
6
6
  "main": "dist/index.js",
@@ -27,12 +27,15 @@
27
27
  "author": "Execlave",
28
28
  "license": "MIT",
29
29
  "dependencies": {
30
- "axios": "^1.13.5",
30
+ "axios": "^1.16.0",
31
31
  "chalk": "^5.6.2",
32
32
  "commander": "^14.0.3",
33
33
  "conf": "^15.1.0",
34
34
  "inquirer": "^13.3.0"
35
35
  },
36
+ "overrides": {
37
+ "fast-uri": "^3.1.2"
38
+ },
36
39
  "devDependencies": {
37
40
  "@types/chalk": "^0.4.31",
38
41
  "@types/inquirer": "^9.0.9",