@n24q02m/hull 0.4.0 → 0.5.0-beta.1

package/build/relay/tool-helpers.js

@@ -1,103 +0,0 @@
-/**
- * Helper to register `config__open_relay` MCP tool — HTTP-only mode.
- *
- * After the stdio-pure + http-multi-user split, the relay config form is
- * served by the HTTP server itself at ``<PUBLIC_URL>/authorize``. The
- * ``config__open_relay`` tool directs the user to that URL.
- *
- * When the connected client declares URL-mode elicitation
- * (``capabilities.elicitation.url``, SEP-1036), the tool asks the client to
- * present a consent prompt and open the URL via ``Server.elicitInput`` so the
- * credential form is opened out-of-band without the LLM in the loop. Clients
- * that do NOT declare the capability fall back to the legacy behaviour: the
- * tool returns the URL and best-effort opens the user's default browser
- * server-side. There is no daemon-bridge discovery, no respawn, and no
- * session deduplication — the HTTP server's own session tracking handles
- * concurrent setup attempts.
- *
- * In stdio mode, the relay form does not exist; the tool returns
- * ``stdio_unsupported`` so plugin code can render a "switch to HTTP mode"
- * message instead of misleading the user with an unreachable URL.
- */
-import { randomUUID } from 'node:crypto';
-import { tryOpenBrowser } from './browser.js';
-// Maps the client's ElicitResult.action to the tool's outcome field.
-const ELICIT_ACTION_MAP = {
-    accept: 'accepted',
-    decline: 'declined',
-    cancel: 'cancelled'
-};
-function clientSupportsUrlElicitation(server) {
-    return server.getClientCapabilities()?.elicitation?.url != null;
-}
-/**
- * Build the `open_relay` handler closure. Tests can call
- * ``buildOpenRelayHandler({ serverName, publicUrl })`` directly without
- * needing a real MCP server instance.
- *
- * When `elicitation` is supplied AND the client declared URL-mode
- * elicitation, the handler drives `elicitInput` and returns the accept /
- * decline / cancel outcome. Otherwise it returns the legacy dict
- * (`{ url, browserOpened, status }`) unchanged.
- */
-export function buildOpenRelayHandler(options) {
-    return async function openRelay() {
-        if (!options.publicUrl) {
-            return { url: '', browserOpened: false, status: 'stdio_unsupported' };
-        }
-        const url = `${options.publicUrl.replace(/\/$/, '')}/authorize`;
-        const { elicitation } = options;
-        if (elicitation && clientSupportsUrlElicitation(elicitation)) {
-            const message = `Open the ${options.serverName} configuration page to enter your credentials securely in your browser.`;
-            const result = await elicitation.elicitInput({
-                mode: 'url',
-                message,
-                url,
-                elicitationId: randomUUID()
-            });
-            return {
-                url,
-                browserOpened: false,
-                status: 'unconfigured',
-                elicitation: ELICIT_ACTION_MAP[result.action] ?? 'accepted'
-            };
-        }
-        const opened = await tryOpenBrowser(url);
-        return { url, browserOpened: !!opened, status: 'unconfigured' };
-    };
-}
-/**
- * Register `config__open_relay` on the given MCP server instance.
- *
- * Consumer servers add this single line in their tool registry after the
- * other `config__*` registrations:
- *
- * ```ts
- * import { registerOpenRelayTool } from '@n24q02m/hull'
- * registerOpenRelayTool(mcp, SERVER_NAME, PUBLIC_URL, mcp.server)
- * ```
- *
- * Pass ``null`` for ``publicUrl`` when the server is running in stdio mode;
- * the tool will return ``status: 'stdio_unsupported'`` so the caller can
- * surface a clear "switch to HTTP mode" message.
- *
- * Pass the low-level `Server` (`mcp.server`) as ``elicitation`` to enable
- * URL-mode elicitation for capable clients. When omitted, the tool keeps
- * the legacy browser-open behaviour for every client.
- */
-export function registerOpenRelayTool(mcp, serverName, publicUrl, elicitation) {
-    const handler = buildOpenRelayHandler({ serverName, publicUrl, elicitation });
-    mcp.tool({
-        name: 'config__open_relay',
-        // Deliberately conditional. The handler returns `browserOpened: false`
-        // whenever no browser could be launched (headless, CI, the env-guard, no
-        // desktop session), and this text is read by a model that then speaks for
-        // the tool. "Open the ... form in the user's browser" reads as a
-        // guarantee, so a model can report "opened it in your browser" while the
-        // result says otherwise -- the user is then waiting on a tab that will
-        // never appear. The URL is what the tool always delivers; the browser is
-        // a convenience on top, and the wording says so in that order.
-        description: `Get the relay configuration URL for ${serverName}, opening it in the user's browser when possible.`
-    }, handler);
-}
-//# sourceMappingURL=tool-helpers.js.map

package/build/relay/tool-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../../src/relay/tool-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAyB7C,qEAAqE;AACrE,MAAM,iBAAiB,GAA0D;IAC/E,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,WAAW;CACpB,CAAA;AAED,SAAS,4BAA4B,CAAC,MAAyB;IAC7D,OAAO,MAAM,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,GAAG,IAAI,IAAI,CAAA;AACjE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgC;IACpE,OAAO,KAAK,UAAU,SAAS;QAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;QACvE,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAA;QAC/D,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;QAC/B,IAAI,WAAW,IAAI,4BAA4B,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,YAAY,OAAO,CAAC,UAAU,yEAAyE,CAAA;YACvH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC;gBAC3C,IAAI,EAAE,KAAK;gBACX,OAAO;gBACP,GAAG;gBACH,aAAa,EAAE,UAAU,EAAE;aAC5B,CAAC,CAAA;YACF,OAAO;gBACL,GAAG;gBACH,aAAa,EAAE,KAAK;gBACpB,MAAM,EAAE,cAAc;gBACtB,WAAW,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,UAAU;aAC5D,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;QACxC,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;IACjE,CAAC,CAAA;AACH,CAAC;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAkB,EAClB,UAAkB,EAClB,SAAwB,EACxB,WAA+B;IAE/B,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAA;IAC7E,GAAG,CAAC,IAAI,CACN;QACE,IAAI,EAAE,oBAAoB;QAC1B,uEAAuE;QACvE,yEAAyE;QACzE,0EAA0E;QAC1E,iEAAiE;QACjE,yEAAyE;QACzE,uEAAuE;QACvE,yEAAyE;QACzE,+DAA+D;QAC/D,WAAW,EAAE,uCAAuC,UAAU,mDAAmD;KAClH,EACD,OAAO,CACR,CAAA;AACH,CAAC"}

package/build/relay/wordlist.d.ts

@@ -1,2 +0,0 @@
-export declare const WORDLIST: string[];
-//# sourceMappingURL=wordlist.d.ts.map

package/build/relay/wordlist.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wordlist.d.ts","sourceRoot":"","sources":["../../src/relay/wordlist.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,EAAE,MAAM,EAimP5B,CAAA"}