@mnemonik/shared 7.111.2 → 7.111.4

package/dist/grantHost.d.ts

@@ -0,0 +1,25 @@
+import type { HostName } from './hostAdapter.js';
+export interface GrantClient {
+    clientId: string;
+    clientName?: string | null;
+    softwareId?: string | null;
+}
+export declare function hostForGrantClient(client: GrantClient): HostName | undefined;
+/** The coding tools' own names, as a person reads them. */
+export declare const CODING_TOOL_NAMES: Readonly<Record<HostName, string>>;
+/**
+ * How each launch coding tool signs in to Mnemonik's MCP. `connect`:
+ * `mnemonik connect <tool>` drives the tool's own headless login (Codex:
+ * `codex mcp login mnemonik`), prints the approval link and waits, so an agent
+ * with a terminal runs it and hands the person the link. `in_tool`: only the
+ * person can, inside the coding tool (Claude Code refuses OAuth login on piped
+ * stdin; Cursor has no login command); `step` is that step in plain words.
+ */
+export type CodingToolSignIn = {
+    kind: 'connect';
+} | {
+    kind: 'in_tool';
+    step: string;
+};
+export declare const CODING_TOOL_SIGN_IN: Readonly<Record<'claude-code' | 'codex' | 'cursor', CodingToolSignIn>>;
+//# sourceMappingURL=grantHost.d.ts.map

package/dist/grantHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grantHost.d.ts","sourceRoot":"","sources":["../src/grantHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA0BjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAM5E;AAED,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAMhE,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACvF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CACxC,MAAM,CAAC,aAAa,GAAG,OAAO,GAAG,QAAQ,EAAE,gBAAgB,CAAC,CAW7D,CAAC"}

package/dist/grantHost.js

@@ -0,0 +1,48 @@
+/**
+ * Which coding tool an MCP sign-in (an OAuth grant) belongs to. The one mapping
+ * read by the server's machine health, the console's device card and the CLI:
+ * the registered software id first, then the client name, then the host of a
+ * metadata-document client id. Display metadata is self-asserted, so this names
+ * a tool for reporting only; it is never evidence of account ownership.
+ */
+const BY_NAME = {
+    'claude code': 'claude-code',
+    'claude-code': 'claude-code',
+    codex: 'codex',
+    'codex cli': 'codex',
+    cursor: 'cursor',
+    grok: 'grok',
+    'grok build': 'grok',
+    'github copilot': 'vscode-copilot',
+    'vs code copilot': 'vscode-copilot',
+    'vscode-copilot': 'vscode-copilot',
+};
+const BY_CLIENT_HOST = {
+    'claude.ai': 'claude-code',
+    'chatgpt.com': 'codex',
+};
+export function hostForGrantClient(client) {
+    return (BY_NAME[client.softwareId?.toLowerCase() ?? ''] ??
+        BY_NAME[client.clientName?.toLowerCase() ?? ''] ??
+        BY_CLIENT_HOST[URL.canParse(client.clientId) ? new URL(client.clientId).hostname : '']);
+}
+/** The coding tools' own names, as a person reads them. */
+export const CODING_TOOL_NAMES = {
+    'claude-code': 'Claude Code',
+    codex: 'Codex',
+    cursor: 'Cursor',
+    grok: 'Grok',
+    'vscode-copilot': 'VS Code Copilot',
+};
+export const CODING_TOOL_SIGN_IN = {
+    'claude-code': {
+        kind: 'in_tool',
+        step: 'In Claude Code, type /mcp, choose mnemonik, then Authenticate.',
+    },
+    codex: { kind: 'connect' },
+    cursor: {
+        kind: 'in_tool',
+        step: 'In Cursor, open Cursor Settings, Customize, MCPs, then Authenticate.',
+    },
+};
+//# sourceMappingURL=grantHost.js.map

package/dist/grantHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grantHost.js","sourceRoot":"","sources":["../src/grantHost.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,GAAuC;IAClD,aAAa,EAAE,aAAa;IAC5B,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,OAAO;IACpB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,MAAM;IACpB,gBAAgB,EAAE,gBAAgB;IAClC,iBAAiB,EAAE,gBAAgB;IACnC,gBAAgB,EAAE,gBAAgB;CACnC,CAAC;AACF,MAAM,cAAc,GAAuC;IACzD,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,OAAO;CACvB,CAAC;AAQF,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,CACL,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/C,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/C,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CACvF,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAuC;IACnE,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,gBAAgB,EAAE,iBAAiB;CACpC,CAAC;AAWF,MAAM,CAAC,MAAM,mBAAmB,GAE5B;IACF,aAAa,EAAE;QACb,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,gEAAgE;KACvE;IACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1B,MAAM,EAAE;QACN,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,sEAAsE;KAC7E;CACF,CAAC"}

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './repositoryRoot.js';
 export * from './protectedPaths.js';
 export * from './readiness.js';
 export * from './hostAdapter.js';
+export * from './grantHost.js';
 export * from './hostBinary.js';
 export type { ServiceDefinition, SupervisorStatus, ServiceOperation, ServiceResult, } from './scannerSupervisor.js';
 export { apiOrigin } from './apiOrigin.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,eAAO,MAAM,6BAA6B,SAAU,CAAC;AACrD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,YAAY,EACZ,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAEhC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,eAAO,MAAM,6BAA6B,SAAU,CAAC;AACrD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,YAAY,EACZ,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAEhC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -21,6 +21,7 @@ export * from './repositoryRoot.js';
 export * from './protectedPaths.js';
 export * from './readiness.js';
 export * from './hostAdapter.js';
+export * from './grantHost.js';
 export * from './hostBinary.js';
 export { apiOrigin } from './apiOrigin.js';
 export { WINDOWS_SERVICE_BUDGET_MS, SCANNER_STARTUP_BUDGET_MS, SCANNER_RAPID_FAILURE_LIMIT, SCANNER_HANDOFF_BUDGET_MS, SCANNER_RECEIPT_STALE_MS, SCANNER_MAC_COMMAND_BUDGET_MS, SCANNER_STOP_BUDGET_MS, SCANNER_REMOVAL_BUDGET_MS, scannerAttemptHealthy, } from './scannerSupervisor.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC;AACrD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GAKnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,YAAY,GAGb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,YAAY,EACZ,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,GAIxB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAShC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC;AACrD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GAKnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,YAAY,GAGb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,YAAY,EACZ,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,GAIxB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAShC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemonik/shared",
-  "version": "7.111.2",
+  "version": "7.111.4",
   "description": "Shared constants and utilities for Mnemonik packages",
   "repository": {
     "type": "git",
@@ -45,7 +45,7 @@
     }
   },
   "scripts": {
-    "test": "tsx --test --test-concurrency=2 tests/repositoryFingerprint.test.ts tests/projectIdentity.test.ts tests/readiness.test.ts tests/hookRuntime.test.ts",
+    "test": "tsx --test --test-concurrency=2 tests/repositoryFingerprint.test.ts tests/projectIdentity.test.ts tests/readiness.test.ts tests/hookRuntime.test.ts tests/grantHost.test.ts",
     "build": "node ../../node_modules/@typescript/native/bin/tsc",
     "typecheck": "node ../../node_modules/@typescript/native/bin/tsc --noEmit -p tsconfig.test.json",
     "prepublishOnly": "npm run build"

package/src/grantHost.ts

@@ -0,0 +1,71 @@
+import type { HostName } from './hostAdapter.js';
+
+/**
+ * Which coding tool an MCP sign-in (an OAuth grant) belongs to. The one mapping
+ * read by the server's machine health, the console's device card and the CLI:
+ * the registered software id first, then the client name, then the host of a
+ * metadata-document client id. Display metadata is self-asserted, so this names
+ * a tool for reporting only; it is never evidence of account ownership.
+ */
+const BY_NAME: Readonly<Record<string, HostName>> = {
+  'claude code': 'claude-code',
+  'claude-code': 'claude-code',
+  codex: 'codex',
+  'codex cli': 'codex',
+  cursor: 'cursor',
+  grok: 'grok',
+  'grok build': 'grok',
+  'github copilot': 'vscode-copilot',
+  'vs code copilot': 'vscode-copilot',
+  'vscode-copilot': 'vscode-copilot',
+};
+const BY_CLIENT_HOST: Readonly<Record<string, HostName>> = {
+  'claude.ai': 'claude-code',
+  'chatgpt.com': 'codex',
+};
+
+export interface GrantClient {
+  clientId: string;
+  clientName?: string | null;
+  softwareId?: string | null;
+}
+
+export function hostForGrantClient(client: GrantClient): HostName | undefined {
+  return (
+    BY_NAME[client.softwareId?.toLowerCase() ?? ''] ??
+    BY_NAME[client.clientName?.toLowerCase() ?? ''] ??
+    BY_CLIENT_HOST[URL.canParse(client.clientId) ? new URL(client.clientId).hostname : '']
+  );
+}
+
+/** The coding tools' own names, as a person reads them. */
+export const CODING_TOOL_NAMES: Readonly<Record<HostName, string>> = {
+  'claude-code': 'Claude Code',
+  codex: 'Codex',
+  cursor: 'Cursor',
+  grok: 'Grok',
+  'vscode-copilot': 'VS Code Copilot',
+};
+
+/**
+ * How each launch coding tool signs in to Mnemonik's MCP. `connect`:
+ * `mnemonik connect <tool>` drives the tool's own headless login (Codex:
+ * `codex mcp login mnemonik`), prints the approval link and waits, so an agent
+ * with a terminal runs it and hands the person the link. `in_tool`: only the
+ * person can, inside the coding tool (Claude Code refuses OAuth login on piped
+ * stdin; Cursor has no login command); `step` is that step in plain words.
+ */
+export type CodingToolSignIn = { kind: 'connect' } | { kind: 'in_tool'; step: string };
+export const CODING_TOOL_SIGN_IN: Readonly<
+  Record<'claude-code' | 'codex' | 'cursor', CodingToolSignIn>
+> = {
+  'claude-code': {
+    kind: 'in_tool',
+    step: 'In Claude Code, type /mcp, choose mnemonik, then Authenticate.',
+  },
+  codex: { kind: 'connect' },
+  cursor: {
+    kind: 'in_tool',
+    step: 'In Cursor, open Cursor Settings, Customize, MCPs, then Authenticate.',
+  },
+};

package/src/index.ts

@@ -81,6 +81,7 @@ export * from './protectedPaths.js';
 export * from './readiness.js';
 
 export * from './hostAdapter.js';
+export * from './grantHost.js';
 export * from './hostBinary.js';
 
 export type {

package/tests/grantHost.test.ts

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { CODING_TOOL_SIGN_IN, hostForGrantClient } from '../src/grantHost.js';
+
+test('names the coding tool from software id, then client name, then client id host', () => {
+  assert.equal(
+    hostForGrantClient({ clientId: 'https://claude.ai/oauth/claude-code' }),
+    'claude-code'
+  );
+  assert.equal(hostForGrantClient({ clientId: 'https://chatgpt.com/codex' }), 'codex');
+  assert.equal(hostForGrantClient({ clientId: 'x', clientName: 'Cursor' }), 'cursor');
+  assert.equal(hostForGrantClient({ clientId: 'x', clientName: 'Codex CLI' }), 'codex');
+  assert.equal(
+    hostForGrantClient({
+      clientId: 'https://claude.ai/x',
+      softwareId: 'cursor',
+      clientName: 'Codex',
+    }),
+    'cursor'
+  );
+  assert.equal(hostForGrantClient({ clientId: 'mnemonik-cli' }), undefined);
+  assert.equal(
+    hostForGrantClient({ clientId: 'https://example.com/x', clientName: 'Other' }),
+    undefined
+  );
+});
+
+test('Codex signs in through mnemonik connect; Claude Code and Cursor only inside the tool', () => {
+  assert.deepEqual(CODING_TOOL_SIGN_IN.codex, { kind: 'connect' });
+  assert.equal(CODING_TOOL_SIGN_IN['claude-code'].kind, 'in_tool');
+  assert.equal(CODING_TOOL_SIGN_IN.cursor.kind, 'in_tool');
+});