@clien-ai/mcp 0.1.0

package/dist/util/exit-codes.js

@@ -0,0 +1,97 @@
+/**
+ * Canonical exit codes for `clien-mcp`.
+ *
+ * Agents that script around the CLI use these to decide retry/branch behavior
+ * (e.g. don't retry on `INVALID_ARGS`, do retry on `NETWORK_FAIL`). Keep the
+ * numbers stable across versions — the README documents them publicly.
+ *
+ * If you add a new code, add a row to the exit-code table in mcp/README.md.
+ */
+export const EXIT_CODES = {
+    /** Success. */
+    SUCCESS: 0,
+    /** Generic / uncategorized failure. */
+    GENERIC_ERROR: 1,
+    /** Authentication failed (refresh token rejected, OAuth flow aborted, etc.). */
+    AUTH_FAIL: 2,
+    /** Filesystem operation failed (permission denied, disk full, ENOTDIR, ...). */
+    FS_FAIL: 3,
+    /** Network operation failed (DNS, connection refused, timeout). */
+    NETWORK_FAIL: 4,
+    /** CLI argument validation failed (unknown flag, missing value, etc.). */
+    INVALID_ARGS: 5,
+};
+/**
+ * Classify a thrown error into one of the canonical exit codes. Falls back to
+ * GENERIC_ERROR when no rule matches. Used by cli.ts's top-level catch so
+ * agents can distinguish failure classes without parsing message strings.
+ */
+/**
+ * Network/transient OAuth codes — these signal "retry or check connectivity",
+ * not "credentials are bad". Includes lock-file contention, port unavailability
+ * during loopback bind (someone else has 7873/7874/7875), and Supabase
+ * server-side failures (5xx replayed as oauth_5NN by postForm).
+ */
+const NETWORK_OAUTH_CODES = new Set([
+    'oauth_network_error',
+    'oauth_timeout',
+    'lock_unavailable',
+    'port_unavailable',
+]);
+/**
+ * Auth-class OAuth codes — credentials are genuinely bad, re-OAuth needed.
+ * Explicit positive list rather than a `startsWith('oauth_')` catch-all so a
+ * future code defaults to GENERIC_ERROR (loud, surfaces the gap) rather than
+ * being silently mis-classified as AUTH_FAIL.
+ */
+const AUTH_OAUTH_CODES = new Set([
+    'invalid_grant',
+    'refresh_token_already_used',
+    'refresh_token_not_found',
+    'access_denied',
+    'oauth_invalid_response',
+    'oauth_400',
+    'oauth_401',
+    'oauth_403',
+    'state_mismatch',
+    'invalid_callback',
+]);
+/** Node fs errno codes that map to FS_FAIL. */
+const FS_ERRNO_CODES = new Set([
+    'ENOENT',
+    'EACCES',
+    'EPERM',
+    'ENOTDIR',
+    'EEXIST',
+    'ENOSPC',
+    'EROFS',
+]);
+export function classifyError(err) {
+    if (!err)
+        return EXIT_CODES.GENERIC_ERROR;
+    // OAuthError exposes a `code` field — see auth/oauth.ts:OAuthError
+    const code = err.code;
+    if (typeof code === 'string') {
+        if (NETWORK_OAUTH_CODES.has(code))
+            return EXIT_CODES.NETWORK_FAIL;
+        if (AUTH_OAUTH_CODES.has(code))
+            return EXIT_CODES.AUTH_FAIL;
+        if (FS_ERRNO_CODES.has(code))
+            return EXIT_CODES.FS_FAIL;
+        // Supabase replays HTTP 5xx as `oauth_5NN`. Treat as transient/network
+        // even though the code namespace is OAuth — the failure mode is a server
+        // hiccup, not a credential problem. Agents should retry, not re-auth.
+        if (/^oauth_5\d{2}$/.test(code))
+            return EXIT_CODES.NETWORK_FAIL;
+    }
+    // Node fetch surfaces network failures as TypeError with cause
+    const name = err.name;
+    if (name === 'AbortError' || name === 'TimeoutError') {
+        return EXIT_CODES.NETWORK_FAIL;
+    }
+    if (err instanceof TypeError && /fetch failed/i.test(err.message)) {
+        return EXIT_CODES.NETWORK_FAIL;
+    }
+    return EXIT_CODES.GENERIC_ERROR;
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/util/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/util/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,eAAe;IACf,OAAO,EAAE,CAAC;IACV,uCAAuC;IACvC,aAAa,EAAE,CAAC;IAChB,gFAAgF;IAChF,SAAS,EAAE,CAAC;IACZ,gFAAgF;IAChF,OAAO,EAAE,CAAC;IACV,mEAAmE;IACnE,YAAY,EAAE,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,CAAC;CACP,CAAA;AAKV;;;;GAIG;AACH;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,qBAAqB;IACrB,eAAe;IACf,kBAAkB;IAClB,kBAAkB;CACnB,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,eAAe;IACf,4BAA4B;IAC5B,yBAAyB;IACzB,eAAe;IACf,wBAAwB;IACxB,WAAW;IACX,WAAW;IACX,WAAW;IACX,gBAAgB;IAChB,kBAAkB;CACnB,CAAC,CAAA;AAEF,+CAA+C;AAC/C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;CACR,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,UAAU,CAAC,aAAa,CAAA;IAEzC,mEAAmE;IACnE,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAA;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC,YAAY,CAAA;QACjE,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC,SAAS,CAAA;QAC3D,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC,OAAO,CAAA;QACvD,uEAAuE;QACvE,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC,YAAY,CAAA;IACjE,CAAC;IAED,+DAA+D;IAC/D,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAA;IAC5C,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QACrD,OAAO,UAAU,CAAC,YAAY,CAAA;IAChC,CAAC;IACD,IAAI,GAAG,YAAY,SAAS,IAAI,eAAe,CAAC,IAAI,CAAE,GAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,OAAO,UAAU,CAAC,YAAY,CAAA;IAChC,CAAC;IAED,OAAO,UAAU,CAAC,aAAa,CAAA;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@clien-ai/mcp",
+  "version": "0.1.0",
+  "description": "Clien.ai MCP server — deep product research from Claude Code.",
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "claude-code",
+    "clien.ai",
+    "product-research"
+  ],
+  "homepage": "https://clien.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AlexOmey/clien-ai.git",
+    "directory": "mcp"
+  },
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/server.js",
+  "bin": {
+    "clien-mcp": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "open": "^10.1.0",
+    "proper-lockfile": "^4.1.2",
+    "zod": "^4.0.5"
+  },
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "@types/proper-lockfile": "^4.1.4",
+    "tsx": "^4.20.4",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}