linkedin-toolkit-mcp 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominic Gonsalves
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# linkedin-toolkit-mcp
+
+The MCP server, localhost bridge, HTTP action API, SQLite mirror and `lit` CLI for
+[LinkedIn Toolkit](https://github.com/FormatixAI/linkedin-toolkit).
+
+This package is the half that agents talk to. The other half is a Chrome extension that drives
+**your own logged-in LinkedIn session** — there is no headless browser, no hosted service, no
+account and no telemetry. This server does not touch LinkedIn itself; it hands actions to the
+extension over a WebSocket on loopback and passes the answers back.
+
+```bash
+npx linkedin-toolkit-mcp
+```
+
+## Pairing
+
+1. Install the extension: download the `linkedin-toolkit-extension-*.zip` from
+   [Releases](https://github.com/FormatixAI/linkedin-toolkit/releases), unzip it, then
+   `chrome://extensions` → **Developer mode** → **Load unpacked** → pick the folder.
+2. Run `npx linkedin-toolkit-mcp`. The first run prints a pairing token and stores it in
+   `~/.linkedin-toolkit/config.json` (owner-only).
+3. Paste that token into the extension popup → **Settings → Local bridge**, and enable the bridge.
+   The badge turns to "connected".
+
+Point your agent at the server. Claude Code, `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "linkedin-toolkit": { "command": "npx", "args": ["-y", "linkedin-toolkit-mcp"] }
+  }
+}
+```
+
+`lit serve --http` additionally exposes `POST /actions/{action}`, `POST /mcp` and
+`GET /openapi.json` on `127.0.0.1:47830` for the Node and Python clients, n8n and anything else
+that speaks HTTP. Everything binds to loopback and requires the pairing token as a bearer token.
+
+Add `--fake` to any `serve` to run the whole surface without a LinkedIn account: real envelopes,
+real error codes, demo data, no network calls.
+
+## `lit` cheat-sheet
+
+```bash
+lit serve --http                       # run the bridge + HTTP API (add --fake for demo mode)
+lit status                             # connection, quotas, business hours, queue depth
+lit config get token --reveal          # the pairing token
+lit search "CTO fintech London" --json # sourcing; --csv also works
+lit profile ada-lovelace --json
+lit invite ada-lovelace --note "…"     # queues for approval in Copilot mode
+lit queue list                         # what is waiting for you
+lit queue approve <id>                 # you, at your own terminal
+lit sync && lit sql "select * from profiles limit 5"
+lit research rows.csv --out packs/     # research packs from a CSV
+```
+
+`lit --help` lists everything.
+
+## Safety
+
+Copilot mode is on by default: invites, messages, InMails and comments from an agent wait in an
+approval queue until a human approves them in the popup. Views, follows and likes are metered
+against the visit bucket and go out directly. Daily hard caps live in the extension and cannot be
+raised by this server, the CLI, an agent or a config file.
+
+Automating your LinkedIn account may breach LinkedIn's User Agreement, and accounts are restricted
+and banned for it. That risk is yours. Read
+[docs/safety.md](https://github.com/FormatixAI/linkedin-toolkit/blob/main/docs/safety.md) before
+you point anything at an account you care about.
+
+## Documentation
+
+- [Action contract](https://github.com/FormatixAI/linkedin-toolkit/blob/main/docs/actions.md) —
+  every action, param, result, error code and event.
+- [Agent setup](https://github.com/FormatixAI/linkedin-toolkit/blob/main/docs/agents/README.md) —
+  Claude Code, OpenAI Agents, LangChain, n8n and the rest.
+- [Safety](https://github.com/FormatixAI/linkedin-toolkit/blob/main/docs/safety.md).
+
+MIT licensed. Issues and pull requests:
+<https://github.com/FormatixAI/linkedin-toolkit>

package/dist/bridge.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The localhost WebSocket bridge between this server and the Chrome extension.
+ *
+ * Protocol (docs/actions.md, "Bridge protocol"):
+ *   extension -> server  { type: 'hello', token, extensionVersion }
+ *   server -> extension  { type: 'hello_ok', serverVersion }   or close 4001
+ *   server -> extension  { id, action, params }
+ *   extension -> server  { id, ok: true, data, rateLimit? } | { id, ok: false, error }
+ *   extension -> server  { event, payload }
+ *
+ * Exactly one extension connection is active at a time; a newer hello replaces
+ * the older socket.
+ */
+import { EventEmitter } from 'node:events';
+import type { ErrorCode, EventName, RequestOrigin } from './contract.js';
+export declare const SERVER_VERSION = "2.0.0";
+export declare const OFFLINE_HOW_TO_FIX: string;
+export declare class BridgeError extends Error {
+    readonly code: ErrorCode;
+    readonly retryAfter?: number;
+    readonly howToFix?: string;
+    constructor(code: ErrorCode, message: string, extra?: {
+        retryAfter?: number;
+        howToFix?: string;
+    });
+    toJSON(): {
+        code: ErrorCode;
+        message: string;
+        retryAfter?: number;
+        howToFix?: string;
+    };
+}
+export declare function offlineError(): BridgeError;
+/**
+ * What the extension answered: the action's data, plus the quota snapshot it
+ * attaches to an outreach write. The envelope in docs/actions.md has always
+ * carried `rateLimit`; carrying it here is what lets every surface pass it on.
+ */
+export type BridgeResponse = {
+    data: unknown;
+    rateLimit?: Record<string, number>;
+};
+export type BridgeOptions = {
+    port?: number;
+    token: string;
+    host?: string;
+    pingIntervalMs?: number;
+    defaultTimeoutMs?: number;
+};
+export declare class BridgeServer extends EventEmitter {
+    /** Typed listeners for the three events this server emits. */
+    on(event: 'event', fn: (name: EventName, payload: unknown) => void): this;
+    on(event: 'connected', fn: (info: {
+        extensionVersion: string;
+    }) => void): this;
+    on(event: 'disconnected', fn: () => void): this;
+    on(event: string | symbol, fn: (...args: any[]) => void): this;
+    readonly token: string;
+    private readonly host;
+    private readonly pingIntervalMs;
+    private readonly defaultTimeoutMs;
+    private requestedPort;
+    private wss;
+    private socket;
+    private pending;
+    private pingTimer;
+    private extensionVersion;
+    constructor(options: BridgeOptions);
+    /** The port actually bound (differs from the requested port when 0 was passed). */
+    get port(): number;
+    isConnected(): boolean;
+    connectedExtensionVersion(): string | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Send an action to the extension and wait for its whole response, quota
+     * snapshot included. Rejects with a BridgeError carrying the contract error
+     * code.
+     */
+    requestFull(action: string, params?: unknown, options?: {
+        timeoutMs?: number;
+        origin?: RequestOrigin;
+    }): Promise<BridgeResponse>;
+    /** `requestFull` for callers that only want the data. */
+    request(action: string, params?: unknown, options?: {
+        timeoutMs?: number;
+        origin?: RequestOrigin;
+    }): Promise<unknown>;
+    private handleConnection;
+    /** A newer authenticated connection replaces the older one. */
+    private adopt;
+    /** Reject and clear every in-flight request. */
+    private failPending;
+    private handleFrame;
+}

package/dist/bridge.js

@@ -0,0 +1,259 @@
+/**
+ * The localhost WebSocket bridge between this server and the Chrome extension.
+ *
+ * Protocol (docs/actions.md, "Bridge protocol"):
+ *   extension -> server  { type: 'hello', token, extensionVersion }
+ *   server -> extension  { type: 'hello_ok', serverVersion }   or close 4001
+ *   server -> extension  { id, action, params }
+ *   extension -> server  { id, ok: true, data, rateLimit? } | { id, ok: false, error }
+ *   extension -> server  { event, payload }
+ *
+ * Exactly one extension connection is active at a time; a newer hello replaces
+ * the older socket.
+ */
+import { EventEmitter } from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { WebSocketServer, WebSocket } from 'ws';
+export const SERVER_VERSION = '2.0.0';
+export const OFFLINE_HOW_TO_FIX = 'Install the extension from GitHub Releases, open the popup → Settings → Local bridge, ' +
+    'paste the pairing token printed by `lit serve`, and enable the bridge.';
+export class BridgeError extends Error {
+    code;
+    retryAfter;
+    howToFix;
+    constructor(code, message, extra = {}) {
+        super(message);
+        this.name = 'BridgeError';
+        this.code = code;
+        this.retryAfter = extra.retryAfter;
+        this.howToFix = extra.howToFix;
+    }
+    toJSON() {
+        const out = {
+            code: this.code,
+            message: this.message,
+        };
+        if (this.retryAfter !== undefined)
+            out.retryAfter = this.retryAfter;
+        if (this.howToFix !== undefined)
+            out.howToFix = this.howToFix;
+        return out;
+    }
+}
+export function offlineError() {
+    return new BridgeError('EXTENSION_OFFLINE', 'The LinkedIn Toolkit Chrome extension is not connected to this server.', { howToFix: OFFLINE_HOW_TO_FIX });
+}
+export class BridgeServer extends EventEmitter {
+    on(event, fn) {
+        return super.on(event, fn);
+    }
+    token;
+    host;
+    pingIntervalMs;
+    defaultTimeoutMs;
+    requestedPort;
+    wss = null;
+    socket = null;
+    pending = new Map();
+    pingTimer = null;
+    extensionVersion = null;
+    constructor(options) {
+        super();
+        this.requestedPort = options.port ?? 47829;
+        this.token = options.token;
+        this.host = options.host ?? '127.0.0.1';
+        this.pingIntervalMs = options.pingIntervalMs ?? 20_000;
+        this.defaultTimeoutMs = options.defaultTimeoutMs ?? 60_000;
+    }
+    /** The port actually bound (differs from the requested port when 0 was passed). */
+    get port() {
+        const address = this.wss?.address();
+        if (address && typeof address === 'object')
+            return address.port;
+        return this.requestedPort;
+    }
+    isConnected() {
+        return this.socket !== null && this.socket.readyState === WebSocket.OPEN;
+    }
+    connectedExtensionVersion() {
+        return this.isConnected() ? this.extensionVersion : null;
+    }
+    async start() {
+        if (this.wss)
+            return;
+        await new Promise((resolve, reject) => {
+            const wss = new WebSocketServer({ port: this.requestedPort, host: this.host });
+            const onError = (err) => reject(err);
+            wss.once('error', onError);
+            wss.once('listening', () => {
+                wss.off('error', onError);
+                this.wss = wss;
+                this.requestedPort = this.port;
+                resolve();
+            });
+            wss.on('connection', (ws) => this.handleConnection(ws));
+        });
+        // Two pings, on purpose. The protocol-level ping keeps the socket itself
+        // alive and is answered by the browser, invisibly to the extension. But an
+        // MV3 service worker is killed after ~30 s of no *JavaScript* activity, and
+        // a frame the browser answers for it is not activity — so the worker dies
+        // holding an open socket. The JSON ping is a message the worker has to
+        // wake up and handle; it answers `{type:'pong'}`, which resets its timer.
+        this.pingTimer = setInterval(() => {
+            if (!this.socket || this.socket.readyState !== WebSocket.OPEN)
+                return;
+            this.socket.ping();
+            try {
+                this.socket.send(JSON.stringify({ type: 'ping' }));
+            }
+            catch {
+                /* the socket is going away; 'close' handles it */
+            }
+        }, this.pingIntervalMs);
+        this.pingTimer.unref?.();
+    }
+    async stop() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        this.failPending(() => new BridgeError('INTERNAL', 'Bridge server stopped'));
+        const socket = this.socket;
+        this.socket = null;
+        socket?.close();
+        const wss = this.wss;
+        this.wss = null;
+        if (!wss)
+            return;
+        await new Promise((resolve) => {
+            for (const client of wss.clients)
+                client.terminate();
+            wss.close(() => resolve());
+        });
+    }
+    /**
+     * Send an action to the extension and wait for its whole response, quota
+     * snapshot included. Rejects with a BridgeError carrying the contract error
+     * code.
+     */
+    async requestFull(action, params = {}, options = {}) {
+        const socket = this.socket;
+        if (!socket || socket.readyState !== WebSocket.OPEN)
+            throw offlineError();
+        const id = randomUUID();
+        const timeoutMs = options.timeoutMs ?? this.defaultTimeoutMs;
+        const origin = options.origin;
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new BridgeError('INTERNAL', `The extension did not answer ${action} within ${timeoutMs}ms.`, { howToFix: 'Check the extension service worker in chrome://extensions and retry.' }));
+            }, timeoutMs);
+            timer.unref?.();
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                socket.send(JSON.stringify({ id, action, params: params ?? {}, ...(origin ? { origin } : {}) }));
+            }
+            catch (err) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(new BridgeError('INTERNAL', `Failed to send ${action}: ${String(err)}`));
+            }
+        });
+    }
+    /** `requestFull` for callers that only want the data. */
+    async request(action, params = {}, options = {}) {
+        return (await this.requestFull(action, params, options)).data;
+    }
+    /* ---------------------------------------------------------------- */
+    handleConnection(ws) {
+        let helloDone = false;
+        ws.on('message', (raw) => {
+            let frame;
+            try {
+                frame = JSON.parse(raw.toString());
+            }
+            catch {
+                return;
+            }
+            if (!helloDone) {
+                if (frame?.type !== 'hello') {
+                    ws.close(4001, 'UNAUTHORIZED');
+                    return;
+                }
+                if (frame.token !== this.token) {
+                    ws.close(4001, 'UNAUTHORIZED');
+                    return;
+                }
+                helloDone = true;
+                this.extensionVersion = String(frame.extensionVersion ?? 'unknown');
+                this.adopt(ws);
+                ws.send(JSON.stringify({ type: 'hello_ok', serverVersion: SERVER_VERSION }));
+                this.emit('connected', { extensionVersion: this.extensionVersion });
+                return;
+            }
+            this.handleFrame(frame);
+        });
+        ws.on('close', () => {
+            if (this.socket === ws) {
+                this.socket = null;
+                this.extensionVersion = null;
+                // Nothing can answer these any more; failing now beats a 60 s timeout.
+                this.failPending(offlineError);
+                this.emit('disconnected');
+            }
+        });
+        ws.on('error', () => {
+            /* a dead socket is handled by 'close' */
+        });
+    }
+    /** A newer authenticated connection replaces the older one. */
+    adopt(ws) {
+        const previous = this.socket;
+        this.socket = ws;
+        if (previous && previous !== ws) {
+            // Requests in flight belong to the socket being replaced: the extension
+            // that is going away will never answer them, and the new one has never
+            // seen them. Fail them now rather than letting them time out.
+            this.failPending(() => new BridgeError('EXTENSION_OFFLINE', 'The extension reconnected while this request was in flight. Retry it.', { howToFix: 'Retry the call; the new extension connection is already live.' }));
+            previous.close(1000, 'replaced');
+        }
+    }
+    /** Reject and clear every in-flight request. */
+    failPending(makeError) {
+        if (this.pending.size === 0)
+            return;
+        const pending = [...this.pending.values()];
+        this.pending.clear();
+        for (const entry of pending) {
+            clearTimeout(entry.timer);
+            entry.reject(makeError());
+        }
+    }
+    handleFrame(frame) {
+        // The extension's answer to the JSON keepalive, and any other typed
+        // housekeeping frame. Nothing to do, and nothing worth logging.
+        if (typeof frame?.type === 'string')
+            return;
+        if (typeof frame?.event === 'string') {
+            this.emit('event', frame.event, frame.payload);
+            return;
+        }
+        if (typeof frame?.id !== 'string')
+            return;
+        const pending = this.pending.get(frame.id);
+        if (!pending)
+            return;
+        this.pending.delete(frame.id);
+        clearTimeout(pending.timer);
+        if (frame.ok === true) {
+            pending.resolve({
+                data: frame.data,
+                ...(frame.rateLimit ? { rateLimit: frame.rateLimit } : {}),
+            });
+            return;
+        }
+        const error = frame.error ?? {};
+        pending.reject(new BridgeError((error.code ?? 'INTERNAL'), String(error.message ?? 'The extension returned an error.'), { retryAfter: error.retryAfter, howToFix: error.howToFix }));
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAgB,MAAM,IAAI,CAAC;AAG9D,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,kBAAkB,GAC7B,wFAAwF;IACxF,wEAAwE,CAAC;AAE3E,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAY;IAChB,UAAU,CAAU;IACpB,QAAQ,CAAU;IAE3B,YACE,IAAe,EACf,OAAe,EACf,QAAoD,EAAE;QAEtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,MAAM,GAAG,GAAiF;YACxF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;QACF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACpE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,WAAW,CACpB,mBAAmB,EACnB,wEAAwE,EACxE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CACjC,CAAC;AACJ,CAAC;AA0BD,MAAM,OAAO,YAAa,SAAQ,YAAY;IAMnC,EAAE,CAAC,KAAsB,EAAE,EAA4B;QAC9D,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAEQ,KAAK,CAAS;IACN,IAAI,CAAS;IACb,cAAc,CAAS;IACvB,gBAAgB,CAAS;IAElC,aAAa,CAAS;IACtB,GAAG,GAA2B,IAAI,CAAC;IACnC,MAAM,GAAqB,IAAI,CAAC;IAChC,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrC,SAAS,GAA0B,IAAI,CAAC;IACxC,gBAAgB,GAAkB,IAAI,CAAC;IAE/C,YAAY,OAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;QACvD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC;IAC7D,CAAC;IAED,mFAAmF;IACnF,IAAI,IAAI;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;QACpC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC;QAChE,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,CAAC;IAC3E,CAAC;IAED,yBAAyB;QACvB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO;QACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBACzB,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;gBACf,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;gBAC/B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,yEAAyE;QACzE,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,uEAAuE;QACvE,0EAA0E;QAC1E,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,OAAO;YACtE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;YACpD,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO;gBAAE,MAAM,CAAC,SAAS,EAAE,CAAC;YACrD,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAAkB,EAAE,EACpB,UAA0D,EAAE;QAE5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YAAE,MAAM,YAAY,EAAE,CAAC;QAE1E,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAE9B,OAAO,MAAM,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CACJ,IAAI,WAAW,CACb,UAAU,EACV,gCAAgC,MAAM,WAAW,SAAS,KAAK,EAC/D,EAAE,QAAQ,EAAE,sEAAsE,EAAE,CACrF,CACF,CAAC;YACJ,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACpF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,WAAW,CAAC,UAAU,EAAE,kBAAkB,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAClF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,OAAO,CACX,MAAc,EACd,SAAkB,EAAE,EACpB,UAA0D,EAAE;QAE5D,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED,sEAAsE;IAE9D,gBAAgB,CAAC,EAAa;QACpC,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAY,EAAE,EAAE;YAChC,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YAED,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC5B,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;oBAC/B,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC/B,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;oBAC/B,OAAO;gBACT,CAAC;gBACD,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,IAAI,SAAS,CAAC,CAAC;gBACpE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACf,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;gBAC7E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACpE,OAAO;YACT,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;gBACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAC7B,uEAAuE;gBACvE,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,yCAAyC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IACvD,KAAK,CAAC,EAAa;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;YAChC,wEAAwE;YACxE,uEAAuE;YACvE,8DAA8D;YAC9D,IAAI,CAAC,WAAW,CACd,GAAG,EAAE,CACH,IAAI,WAAW,CACb,mBAAmB,EACnB,uEAAuE,EACvE,EAAE,QAAQ,EAAE,+DAA+D,EAAE,CAC9E,CACJ,CAAC;YACF,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,gDAAgD;IACxC,WAAW,CAAC,SAA4B;QAC9C,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAU;QAC5B,oEAAoE;QACpE,gEAAgE;QAChE,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO;QAE5C,IAAI,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,EAAE,EAAE,KAAK,QAAQ;YAAE,OAAO;QAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9B,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE5B,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,OAAO,CAAC;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CACZ,IAAI,WAAW,CACb,CAAC,KAAK,CAAC,IAAI,IAAI,UAAU,CAAc,EACvC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,kCAAkC,CAAC,EAC3D,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAC3D,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/cli.d.ts

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * `lit` — the command line for the LinkedIn Toolkit.
+ *
+ * `lit serve` runs the server (bridge plus MCP over stdio); `lit serve --http`
+ * adds the HTTP surface. Every other command talks to that running server over
+ * HTTP, so the CLI and an agent see exactly the same data through exactly the
+ * same code path.
+ */
+import { Command } from 'commander';
+import { type ServerConfig } from './config.js';
+import { FakeExtensionClient } from './fake-extension.js';
+import { HttpServer } from './http.js';
+import { Toolkit } from './toolkit.js';
+export declare const NOT_RUNNING = "linkedin-toolkit server is not running. Start it with: lit serve --http";
+export type Io = {
+    out: (text: string) => void;
+    err: (text: string) => void;
+};
+/** Thrown to end a command with a message and a non-zero exit code. */
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function publicIdFrom(input: string): string;
+export declare function universalNameFrom(input: string): string;
+/** `24h`, `7d`, `30m`, or an epoch-milliseconds number. */
+export declare function parseSince(input: string | undefined, now?: number): number | undefined;
+export declare function toCsv(rows: Record<string, unknown>[], columns?: string[]): string;
+/** A small RFC-4180-ish reader: quoted fields, doubled quotes, CRLF. */
+export declare function fromCsv(text: string): Record<string, string>[];
+export declare function slugify(input: string): string;
+/** The note column of `lit endpoints check`. */
+export declare function endpointNote(result: string, clientVersion: string, error?: string): string;
+/** Fixed-width table for human output. */
+export declare function table(rows: Record<string, unknown>[], columns: string[]): string;
+/** Settable keys of the local server config. `token` is deliberately absent. */
+export declare const SETTABLE_KEYS: readonly ["bridgePort", "httpPort", "webhookUrl", "dbPath", "researchTimeoutMs"];
+export type SettableKey = (typeof SETTABLE_KEYS)[number];
+/** Show only the last four characters, so a shoulder or a screen share leaks nothing. */
+export declare function maskToken(token: string): string;
+/** Parse and validate one `lit config set` value. Throws CliError on bad input. */
+export declare function coerceSetting(key: string, raw: string): {
+    key: SettableKey;
+    value: unknown;
+};
+export declare class ServerClient {
+    readonly baseUrl: string;
+    readonly token: string;
+    constructor(baseUrl: string, token: string);
+    /**
+     * Where to find the server, most specific first:
+     *   1. `LINKEDIN_TOOLKIT_URL` / `LINKEDIN_TOOLKIT_TOKEN` — the same names the
+     *      docs and the Node and Python clients use, so one export points them
+     *      all at the same place;
+     *   2. the port a running `lit serve` actually bound, so
+     *      `lit serve --http --port 9000` does not strand every other command;
+     *   3. the configured default.
+     */
+    static fromConfig(config: ServerConfig): ServerClient;
+    private post;
+    action(action: string, params?: unknown): Promise<any>;
+    tool(tool: string, args?: unknown): Promise<any>;
+    health(): Promise<{
+        ok: boolean;
+        extensionConnected: boolean;
+        version: string;
+    }>;
+}
+export type ServeHandles = {
+    toolkit: Toolkit;
+    http?: HttpServer;
+    fake?: FakeExtensionClient;
+    stop: () => Promise<void>;
+};
+export declare function serve(options: {
+    http?: boolean;
+    port?: number;
+    bridgePort?: number;
+    fake?: boolean;
+}, io: Io): Promise<ServeHandles>;
+export declare function buildProgram(io?: Io): Command;
+export declare function run(argv: string[], io?: Io): Promise<number>;