@obov/mext 0.0.0-stage → 0.2.0

package/dist/remote/browser.js

@@ -0,0 +1,47 @@
+import { spawn } from "node:child_process";
+export function browserDecision(env, platform = process.platform) {
+    if (["SSH_CONNECTION", "SSH_CLIENT", "SSH_TTY"].some((k) => nonEmpty(env[k])))
+        return { open: false, reason: "ssh" };
+    if (platform === "linux" && !nonEmpty(env.DISPLAY) && !nonEmpty(env.WAYLAND_DISPLAY)) {
+        return { open: false, reason: "no-display" };
+    }
+    return { open: true };
+}
+/** 기본 opener. BROWSER = 명령 (공백 구분 인자, %s 가 있으면 URL 로 치환 · 없으면 끝에 URL) */
+export function systemBrowserOpener(env, platform = process.platform) {
+    return (url) => {
+        let command;
+        let args;
+        const browser = env.BROWSER?.trim();
+        if (browser) {
+            const parts = browser.split(/\s+/);
+            command = parts[0];
+            const rest = parts.slice(1);
+            args = rest.some((p) => p.includes("%s")) ? rest.map((p) => p.replace(/%s/g, url)) : [...rest, url];
+        }
+        else if (platform === "darwin") {
+            command = "open";
+            args = [url];
+        }
+        else if (platform === "win32") {
+            command = "cmd";
+            args = ["/c", "start", '""', url.replace(/&/g, "^&")];
+        }
+        else {
+            command = "xdg-open";
+            args = [url];
+        }
+        try {
+            const child = spawn(command, args, { detached: true, stdio: "ignore" });
+            child.on("error", () => { });
+            child.unref();
+        }
+        catch {
+            // 브라우저 없음
+        }
+    };
+}
+function nonEmpty(value) {
+    return value !== undefined && value !== "";
+}
+//# sourceMappingURL=browser.js.map

package/dist/remote/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/remote/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAiB1C,MAAM,UAAU,eAAe,CAC7B,GAAuC,EACvC,QAAQ,GAAoB,OAAO,CAAC,QAAQ;IAE5C,IAAI,CAAC,gBAAgB,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IACpH,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACrF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;IAC9C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CACjC,GAAuC,EACvC,QAAQ,GAAoB,OAAO,CAAC,QAAQ;IAE5C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,IAAI,OAAe,CAAA;QACnB,IAAI,IAAc,CAAA;QAClB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;QACnC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAClC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAA;QACrG,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,GAAG,MAAM,CAAA;YAChB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACd,CAAC;aAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,GAAG,KAAK,CAAA;YACf,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,UAAU,CAAA;YACpB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;YACvE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC3B,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAA;AAC5C,CAAC","sourcesContent":["import { spawn } from \"node:child_process\"\n\n/**\n * login 의 브라우저 판정 · 열기 (spec §5 login 브라우저 판정 · headless).\n * 열지 않음 = SSH 세션 (SSH_CONNECTION · SSH_CLIENT · SSH_TTY) · Linux 에서 DISPLAY · WAYLAND_DISPLAY 없음.\n * 여는 명령 = BROWSER (있으면) → open (macOS) · start (Windows) · xdg-open.\n */\n\nexport interface BrowserDecision {\n  open: boolean\n  /** 열지 않는 이유 (안내 출력용) */\n  reason?: \"ssh\" | \"no-display\"\n}\n\n/** URL 을 브라우저로 연다. 실패는 무시 (URL 은 항상 stderr 에 출력) */\nexport type BrowserOpener = (url: string) => void\n\nexport function browserDecision(\n  env: Record<string, string | undefined>,\n  platform: NodeJS.Platform = process.platform,\n): BrowserDecision {\n  if ([\"SSH_CONNECTION\", \"SSH_CLIENT\", \"SSH_TTY\"].some((k) => nonEmpty(env[k]))) return { open: false, reason: \"ssh\" }\n  if (platform === \"linux\" && !nonEmpty(env.DISPLAY) && !nonEmpty(env.WAYLAND_DISPLAY)) {\n    return { open: false, reason: \"no-display\" }\n  }\n  return { open: true }\n}\n\n/** 기본 opener. BROWSER = 명령 (공백 구분 인자, %s 가 있으면 URL 로 치환 · 없으면 끝에 URL) */\nexport function systemBrowserOpener(\n  env: Record<string, string | undefined>,\n  platform: NodeJS.Platform = process.platform,\n): BrowserOpener {\n  return (url) => {\n    let command: string\n    let args: string[]\n    const browser = env.BROWSER?.trim()\n    if (browser) {\n      const parts = browser.split(/\\s+/)\n      command = parts[0]!\n      const rest = parts.slice(1)\n      args = rest.some((p) => p.includes(\"%s\")) ? rest.map((p) => p.replace(/%s/g, url)) : [...rest, url]\n    } else if (platform === \"darwin\") {\n      command = \"open\"\n      args = [url]\n    } else if (platform === \"win32\") {\n      command = \"cmd\"\n      args = [\"/c\", \"start\", '\"\"', url.replace(/&/g, \"^&\")]\n    } else {\n      command = \"xdg-open\"\n      args = [url]\n    }\n    try {\n      const child = spawn(command, args, { detached: true, stdio: \"ignore\" })\n      child.on(\"error\", () => {})\n      child.unref()\n    } catch {\n      // 브라우저 없음\n    }\n  }\n}\n\nfunction nonEmpty(value: string | undefined): boolean {\n  return value !== undefined && value !== \"\"\n}\n"]}

package/dist/remote/client.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 원격 실행용 최소 MCP 클라이언트 (Streamable HTTP, 프로토콜 2026-07-28, stateless).
+ * 요청마다 POST 1회: _meta envelope (버전 · clientInfo · clientCapabilities) + MCP-Protocol-Version · Mcp-Method ·
+ * Mcp-Name · Mcp-Param-* 헤더. 응답 = application/json 또는 text/event-stream (progress 알림 → onNotification).
+ * MRTR (InputRequiredResult) 재시도 루프는 callTool 의 onInputRequired 가 담당.
+ */
+export declare const PROTOCOL_VERSION = "2026-07-28";
+export declare const META_KEYS: {
+    readonly protocolVersion: "io.modelcontextprotocol/protocolVersion";
+    readonly clientInfo: "io.modelcontextprotocol/clientInfo";
+    readonly clientCapabilities: "io.modelcontextprotocol/clientCapabilities";
+};
+/** 클라이언트가 처리하는 입력 요청 = elicitation form 만 (sampling · roots 없음) */
+export declare const CLIENT_CAPABILITIES: {
+    readonly elicitation: {
+        readonly form: {};
+    };
+};
+/** MRTR 재시도 상한 (같은 요청의 input_required 연속 횟수) */
+export declare const MAX_INPUT_ROUNDS = 8;
+export interface RemoteTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}
+export interface CallToolResult {
+    content?: unknown[];
+    structuredContent?: unknown;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/** InputRequiredResult (resultType: input_required) */
+export interface InputRequired {
+    inputRequests?: Record<string, InputRequestObject>;
+    requestState?: string;
+}
+export interface InputRequestObject {
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** 입력 요청 key → 응답 (ElicitResult 등). 이번 라운드 요청에 대한 것만 */
+export type InputResponses = Record<string, unknown>;
+export interface RequestOptions {
+    signal?: AbortSignal;
+    /** 서버 → 클라이언트 알림 (notifications/progress 등) */
+    onNotification?: (method: string, params: Record<string, unknown>) => void;
+    /** _meta.progressToken. 있으면 서버가 SSE 로 응답 */
+    progressToken?: string | number;
+}
+export interface CallToolOptions extends RequestOptions {
+    /** input_required 응답 처리 → 이번 라운드의 inputResponses. 없으면 RemoteInputRequiredError */
+    onInputRequired?: (request: InputRequired, round: number) => Promise<InputResponses>;
+}
+/** HTTP 401. challenge = WWW-Authenticate 파싱 결과, data = JSON-RPC error.data (mext 는 UNAUTHENTICATED toJSON) */
+export declare class RemoteUnauthorizedError extends Error {
+    readonly challenge: BearerChallenge;
+    readonly data: unknown;
+    constructor(message: string, challenge: BearerChallenge, data: unknown);
+}
+/** JSON-RPC 오류 응답 (HTTP 400 · 403 · 500 포함) */
+export declare class RemoteRpcError extends Error {
+    readonly code: number;
+    readonly data: unknown;
+    readonly status: number;
+    constructor(message: string, code: number, data: unknown, status: number);
+}
+/** 연결 실패 · JSON-RPC 가 아닌 응답 */
+export declare class RemoteTransportError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** onInputRequired 없이 input_required 를 받음 · 라운드 상한 초과 */
+export declare class RemoteInputRequiredError extends Error {
+    readonly request: InputRequired;
+    constructor(message: string, request: InputRequired);
+}
+export interface RemoteClientOptions {
+    /** MCP 엔드포인트 (http(s)://host/mcp) */
+    url: string;
+    /** 요청마다 호출. 없으면 Authorization 헤더 없음 */
+    token?: () => string | undefined | Promise<string | undefined>;
+    fetch?: typeof fetch;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+}
+/** tools/list 전체 페이지 + 첫 페이지의 캐시 힌트 (2026-07-28 ttlMs · cacheScope) */
+export interface ToolsListResult {
+    tools: RemoteTool[];
+    ttlMs?: number;
+    cacheScope?: string;
+}
+export interface RemoteClient {
+    readonly url: string;
+    request(method: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<Record<string, unknown>>;
+    listTools(options?: RequestOptions): Promise<RemoteTool[]>;
+    listToolsResult(options?: RequestOptions): Promise<ToolsListResult>;
+    callTool(tool: RemoteTool, args: Record<string, unknown>, options?: CallToolOptions): Promise<CallToolResult>;
+}
+export declare function createRemoteClient(options: RemoteClientOptions): RemoteClient;
+export interface BearerChallenge {
+    /** Bearer challenge 가 있었는지 */
+    bearer: boolean;
+    error?: string;
+    scope?: string;
+    resourceMetadata?: string;
+}
+/** WWW-Authenticate 의 Bearer challenge 파라미터 (RFC 6750 · RFC 9728 resource_metadata) */
+export declare function parseBearerChallenge(header: string | null): BearerChallenge;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/remote/client.js

@@ -0,0 +1,312 @@
+import { VERSION } from "../version.js";
+/**
+ * 원격 실행용 최소 MCP 클라이언트 (Streamable HTTP, 프로토콜 2026-07-28, stateless).
+ * 요청마다 POST 1회: _meta envelope (버전 · clientInfo · clientCapabilities) + MCP-Protocol-Version · Mcp-Method ·
+ * Mcp-Name · Mcp-Param-* 헤더. 응답 = application/json 또는 text/event-stream (progress 알림 → onNotification).
+ * MRTR (InputRequiredResult) 재시도 루프는 callTool 의 onInputRequired 가 담당.
+ */
+export const PROTOCOL_VERSION = "2026-07-28";
+export const META_KEYS = {
+    protocolVersion: "io.modelcontextprotocol/protocolVersion",
+    clientInfo: "io.modelcontextprotocol/clientInfo",
+    clientCapabilities: "io.modelcontextprotocol/clientCapabilities",
+};
+/** 클라이언트가 처리하는 입력 요청 = elicitation form 만 (sampling · roots 없음) */
+export const CLIENT_CAPABILITIES = { elicitation: { form: {} } };
+/** MRTR 재시도 상한 (같은 요청의 input_required 연속 횟수) */
+export const MAX_INPUT_ROUNDS = 8;
+/** HTTP 401. challenge = WWW-Authenticate 파싱 결과, data = JSON-RPC error.data (mext 는 UNAUTHENTICATED toJSON) */
+export class RemoteUnauthorizedError extends Error {
+    challenge;
+    data;
+    constructor(message, challenge, data) {
+        super(message);
+        this.name = "RemoteUnauthorizedError";
+        this.challenge = challenge;
+        this.data = data;
+    }
+}
+/** JSON-RPC 오류 응답 (HTTP 400 · 403 · 500 포함) */
+export class RemoteRpcError extends Error {
+    code;
+    data;
+    status;
+    constructor(message, code, data, status) {
+        super(message);
+        this.name = "RemoteRpcError";
+        this.code = code;
+        this.data = data;
+        this.status = status;
+    }
+}
+/** 연결 실패 · JSON-RPC 가 아닌 응답 */
+export class RemoteTransportError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "RemoteTransportError";
+    }
+}
+/** onInputRequired 없이 input_required 를 받음 · 라운드 상한 초과 */
+export class RemoteInputRequiredError extends Error {
+    request;
+    constructor(message, request) {
+        super(message);
+        this.name = "RemoteInputRequiredError";
+        this.request = request;
+    }
+}
+export function createRemoteClient(options) {
+    const doFetch = options.fetch ?? fetch;
+    const clientInfo = options.clientInfo ?? { name: "mext", version: VERSION };
+    let nextId = 1;
+    const request = async (method, params = {}, opts = {}, extraHeaders = {}) => {
+        const id = nextId++;
+        const meta = {
+            ...(isRecord(params._meta) ? params._meta : {}),
+            [META_KEYS.protocolVersion]: PROTOCOL_VERSION,
+            [META_KEYS.clientInfo]: clientInfo,
+            [META_KEYS.clientCapabilities]: CLIENT_CAPABILITIES,
+        };
+        if (opts.progressToken !== undefined)
+            meta.progressToken = opts.progressToken;
+        const body = { jsonrpc: "2.0", id, method, params: { ...params, _meta: meta } };
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/event-stream",
+            "MCP-Protocol-Version": PROTOCOL_VERSION,
+            "Mcp-Method": method,
+            ...extraHeaders,
+        };
+        const token = await options.token?.();
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        let res;
+        try {
+            res = await doFetch(options.url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                ...(opts.signal ? { signal: opts.signal } : {}),
+            });
+        }
+        catch (error) {
+            if (opts.signal?.aborted)
+                throw error;
+            throw new RemoteTransportError(`Cannot reach ${options.url}: ${errorMessage(error)}`, { cause: error });
+        }
+        const type = res.headers.get("content-type") ?? "";
+        if (res.status === 401) {
+            const payload = await readJson(res);
+            const err = isRecord(payload) && isRecord(payload.error) ? payload.error : {};
+            throw new RemoteUnauthorizedError(typeof err.message === "string" ? err.message : "Authentication required.", parseBearerChallenge(res.headers.get("www-authenticate")), err.data);
+        }
+        if (type.includes("text/event-stream")) {
+            return handleMessage(await readSse(res, id, opts), id, res.status);
+        }
+        const payload = await readJson(res);
+        if (payload === undefined) {
+            throw new RemoteTransportError(`${options.url} returned HTTP ${res.status} without a JSON-RPC response.`);
+        }
+        return handleMessage(payload, id, res.status);
+    };
+    const handleMessage = (message, id, status) => {
+        if (!isRecord(message))
+            throw new RemoteTransportError(`Invalid JSON-RPC response (HTTP ${status}).`);
+        if (isRecord(message.error)) {
+            const e = message.error;
+            throw new RemoteRpcError(typeof e.message === "string" ? e.message : "JSON-RPC error", typeof e.code === "number" ? e.code : -32_603, e.data, status);
+        }
+        if (message.id !== id || !isRecord(message.result)) {
+            throw new RemoteTransportError(`Invalid JSON-RPC response (HTTP ${status}).`);
+        }
+        return message.result;
+    };
+    const listToolsResult = async (opts = {}) => {
+        const tools = [];
+        const out = { tools };
+        let cursor;
+        for (let page = 0; page < 100; page++) {
+            const result = await request("tools/list", cursor === undefined ? {} : { cursor }, opts);
+            if (page === 0) {
+                if (typeof result.ttlMs === "number" && Number.isFinite(result.ttlMs) && result.ttlMs >= 0)
+                    out.ttlMs = result.ttlMs;
+                if (typeof result.cacheScope === "string")
+                    out.cacheScope = result.cacheScope;
+            }
+            if (Array.isArray(result.tools)) {
+                for (const t of result.tools)
+                    if (isRecord(t) && typeof t.name === "string")
+                        tools.push(t);
+            }
+            if (typeof result.nextCursor !== "string" || result.nextCursor === "")
+                break;
+            cursor = result.nextCursor;
+        }
+        return out;
+    };
+    const callTool = async (tool, args, opts = {}) => {
+        const headers = { "Mcp-Name": tool.name, ...paramHeaders(tool, args) };
+        let retry = {};
+        for (let round = 0;; round++) {
+            const result = await request("tools/call", { name: tool.name, arguments: args, ...retry }, opts, headers);
+            if (result.resultType !== "input_required")
+                return result;
+            const required = {};
+            if (isRecord(result.inputRequests))
+                required.inputRequests = result.inputRequests;
+            if (typeof result.requestState === "string")
+                required.requestState = result.requestState;
+            if (!opts.onInputRequired)
+                throw new RemoteInputRequiredError(`${tool.name} requires input.`, required);
+            if (round >= MAX_INPUT_ROUNDS) {
+                throw new RemoteInputRequiredError(`${tool.name} still required input after ${MAX_INPUT_ROUNDS} rounds.`, required);
+            }
+            // 요청이 있으면 응답을 만든 뒤 재시도. requestState 는 그대로 되돌려 보내고, 없으면 보내지 않는다
+            const responses = required.inputRequests ? await opts.onInputRequired(required, round) : undefined;
+            retry = {};
+            if (responses !== undefined)
+                retry.inputResponses = responses;
+            if (required.requestState !== undefined)
+                retry.requestState = required.requestState;
+        }
+    };
+    return {
+        url: options.url,
+        request: (method, params, opts) => request(method, params, opts),
+        listTools: async (opts) => (await listToolsResult(opts)).tools,
+        listToolsResult,
+        callTool,
+    };
+}
+/** inputSchema 의 x-mcp-header 속성 → Mcp-Param-<Name> 헤더 (SEP-2243). 문자열 · 숫자 · boolean 값만 */
+function paramHeaders(tool, args) {
+    const props = tool.inputSchema?.properties;
+    if (!isRecord(props))
+        return {};
+    const out = {};
+    for (const [key, schema] of Object.entries(props)) {
+        if (!isRecord(schema) || typeof schema["x-mcp-header"] !== "string")
+            continue;
+        const value = args[key];
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            out[`Mcp-Param-${schema["x-mcp-header"]}`] = String(value);
+        }
+    }
+    return out;
+}
+/* SSE */
+/** 응답 스트림에서 id 의 응답 메시지가 올 때까지 읽는다. 알림은 콜백, 응답 후 스트림을 닫는다 */
+async function readSse(res, id, opts) {
+    if (!res.body)
+        throw new RemoteTransportError("Empty event stream.");
+    const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
+    let buffer = "";
+    let data = [];
+    const dispatch = () => {
+        if (data.length === 0)
+            return undefined;
+        const text = data.join("\n");
+        data = [];
+        let message;
+        try {
+            message = JSON.parse(text);
+        }
+        catch {
+            return undefined;
+        }
+        if (!isRecord(message))
+            return undefined;
+        if (typeof message.method === "string" && message.id === undefined) {
+            try {
+                opts.onNotification?.(message.method, isRecord(message.params) ? message.params : {});
+            }
+            catch {
+                // 표시 오류는 응답에 영향 없음
+            }
+            return undefined;
+        }
+        if (message.id === id && ("result" in message || "error" in message))
+            return message;
+        return undefined;
+    };
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += value;
+            let nl;
+            while ((nl = buffer.search(/\r\n|\r|\n/)) >= 0) {
+                const line = buffer.slice(0, nl);
+                buffer = buffer.slice(nl + (buffer.startsWith("\r\n", nl) ? 2 : 1));
+                if (line === "") {
+                    const found = dispatch();
+                    if (found !== undefined)
+                        return found;
+                    continue;
+                }
+                if (line.startsWith(":"))
+                    continue;
+                const colon = line.indexOf(":");
+                const field = colon < 0 ? line : line.slice(0, colon);
+                let value = colon < 0 ? "" : line.slice(colon + 1);
+                if (value.startsWith(" "))
+                    value = value.slice(1);
+                if (field === "data")
+                    data.push(value);
+            }
+        }
+        const found = dispatch();
+        if (found !== undefined)
+            return found;
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+    }
+    if (opts.signal?.aborted)
+        throw opts.signal.reason;
+    throw new RemoteTransportError("Event stream ended without a response.");
+}
+async function readJson(res) {
+    const text = await res.text().catch(() => "");
+    if (text === "")
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** WWW-Authenticate 의 Bearer challenge 파라미터 (RFC 6750 · RFC 9728 resource_metadata) */
+export function parseBearerChallenge(header) {
+    if (!header)
+        return { bearer: false };
+    const m = /(?:^|,\s*)Bearer\b(.*)$/i.exec(header);
+    if (!m)
+        return { bearer: false };
+    const params = {};
+    const re = /([A-Za-z_][\w-]*)\s*=\s*(?:"((?:[^"\\]|\\.)*)"|([^\s,]+))/g;
+    for (let p = re.exec(m[1]); p !== null; p = re.exec(m[1])) {
+        params[p[1].toLowerCase()] = p[2] !== undefined ? p[2].replace(/\\(.)/g, "$1") : p[3];
+    }
+    const out = { bearer: true };
+    if (params.error !== undefined)
+        out.error = params.error;
+    if (params.scope !== undefined)
+        out.scope = params.scope;
+    if (params.resource_metadata !== undefined)
+        out.resourceMetadata = params.resource_metadata;
+    return out;
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        const cause = error.cause;
+        return cause instanceof Error && cause.message ? cause.message : error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=client.js.map

package/dist/remote/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/remote/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { VERSION } from \"../version.ts\"\n\n/**\n * 원격 실행용 최소 MCP 클라이언트 (Streamable HTTP, 프로토콜 2026-07-28, stateless).\n * 요청마다 POST 1회: _meta envelope (버전 · clientInfo · clientCapabilities) + MCP-Protocol-Version · Mcp-Method ·\n * Mcp-Name · Mcp-Param-* 헤더. 응답 = application/json 또는 text/event-stream (progress 알림 → onNotification).\n * MRTR (InputRequiredResult) 재시도 루프는 callTool 의 onInputRequired 가 담당.\n */\n\nexport const PROTOCOL_VERSION = \"2026-07-28\"\n\nexport const META_KEYS = {\n  protocolVersion: \"io.modelcontextprotocol/protocolVersion\",\n  clientInfo: \"io.modelcontextprotocol/clientInfo\",\n  clientCapabilities: \"io.modelcontextprotocol/clientCapabilities\",\n} as const\n\n/** 클라이언트가 처리하는 입력 요청 = elicitation form 만 (sampling · roots 없음) */\nexport const CLIENT_CAPABILITIES = { elicitation: { form: {} } } as const\n\n/** MRTR 재시도 상한 (같은 요청의 input_required 연속 횟수) */\nexport const MAX_INPUT_ROUNDS = 8\n\nexport interface RemoteTool {\n  name: string\n  description?: string\n  inputSchema?: Record<string, unknown>\n  annotations?: Record<string, unknown>\n}\n\nexport interface CallToolResult {\n  content?: unknown[]\n  structuredContent?: unknown\n  isError?: boolean\n  [key: string]: unknown\n}\n\n/** InputRequiredResult (resultType: input_required) */\nexport interface InputRequired {\n  inputRequests?: Record<string, InputRequestObject>\n  requestState?: string\n}\n\nexport interface InputRequestObject {\n  method: string\n  params?: Record<string, unknown>\n}\n\n/** 입력 요청 key → 응답 (ElicitResult 등). 이번 라운드 요청에 대한 것만 */\nexport type InputResponses = Record<string, unknown>\n\nexport interface RequestOptions {\n  signal?: AbortSignal\n  /** 서버 → 클라이언트 알림 (notifications/progress 등) */\n  onNotification?: (method: string, params: Record<string, unknown>) => void\n  /** _meta.progressToken. 있으면 서버가 SSE 로 응답 */\n  progressToken?: string | number\n}\n\nexport interface CallToolOptions extends RequestOptions {\n  /** input_required 응답 처리 → 이번 라운드의 inputResponses. 없으면 RemoteInputRequiredError */\n  onInputRequired?: (request: InputRequired, round: number) => Promise<InputResponses>\n}\n\n/** HTTP 401. challenge = WWW-Authenticate 파싱 결과, data = JSON-RPC error.data (mext 는 UNAUTHENTICATED toJSON) */\nexport class RemoteUnauthorizedError extends Error {\n  readonly challenge: BearerChallenge\n  readonly data: unknown\n  constructor(message: string, challenge: BearerChallenge, data: unknown) {\n    super(message)\n    this.name = \"RemoteUnauthorizedError\"\n    this.challenge = challenge\n    this.data = data\n  }\n}\n\n/** JSON-RPC 오류 응답 (HTTP 400 · 403 · 500 포함) */\nexport class RemoteRpcError extends Error {\n  readonly code: number\n  readonly data: unknown\n  readonly status: number\n  constructor(message: string, code: number, data: unknown, status: number) {\n    super(message)\n    this.name = \"RemoteRpcError\"\n    this.code = code\n    this.data = data\n    this.status = status\n  }\n}\n\n/** 연결 실패 · JSON-RPC 가 아닌 응답 */\nexport class RemoteTransportError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options)\n    this.name = \"RemoteTransportError\"\n  }\n}\n\n/** onInputRequired 없이 input_required 를 받음 · 라운드 상한 초과 */\nexport class RemoteInputRequiredError extends Error {\n  readonly request: InputRequired\n  constructor(message: string, request: InputRequired) {\n    super(message)\n    this.name = \"RemoteInputRequiredError\"\n    this.request = request\n  }\n}\n\nexport interface RemoteClientOptions {\n  /** MCP 엔드포인트 (http(s)://host/mcp) */\n  url: string\n  /** 요청마다 호출. 없으면 Authorization 헤더 없음 */\n  token?: () => string | undefined | Promise<string | undefined>\n  fetch?: typeof fetch\n  clientInfo?: { name: string; version: string }\n}\n\n/** tools/list 전체 페이지 + 첫 페이지의 캐시 힌트 (2026-07-28 ttlMs · cacheScope) */\nexport interface ToolsListResult {\n  tools: RemoteTool[]\n  ttlMs?: number\n  cacheScope?: string\n}\n\nexport interface RemoteClient {\n  readonly url: string\n  request(method: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<Record<string, unknown>>\n  listTools(options?: RequestOptions): Promise<RemoteTool[]>\n  listToolsResult(options?: RequestOptions): Promise<ToolsListResult>\n  callTool(tool: RemoteTool, args: Record<string, unknown>, options?: CallToolOptions): Promise<CallToolResult>\n}\n\nexport function createRemoteClient(options: RemoteClientOptions): RemoteClient {\n  const doFetch = options.fetch ?? fetch\n  const clientInfo = options.clientInfo ?? { name: \"mext\", version: VERSION }\n  let nextId = 1\n\n  const request = async (\n    method: string,\n    params: Record<string, unknown> = {},\n    opts: RequestOptions = {},\n    extraHeaders: Record<string, string> = {},\n  ): Promise<Record<string, unknown>> => {\n    const id = nextId++\n    const meta: Record<string, unknown> = {\n      ...(isRecord(params._meta) ? params._meta : {}),\n      [META_KEYS.protocolVersion]: PROTOCOL_VERSION,\n      [META_KEYS.clientInfo]: clientInfo,\n      [META_KEYS.clientCapabilities]: CLIENT_CAPABILITIES,\n    }\n    if (opts.progressToken !== undefined) meta.progressToken = opts.progressToken\n    const body = { jsonrpc: \"2.0\", id, method, params: { ...params, _meta: meta } }\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json, text/event-stream\",\n      \"MCP-Protocol-Version\": PROTOCOL_VERSION,\n      \"Mcp-Method\": method,\n      ...extraHeaders,\n    }\n    const token = await options.token?.()\n    if (token) headers.Authorization = `Bearer ${token}`\n\n    let res: Response\n    try {\n      res = await doFetch(options.url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(body),\n        ...(opts.signal ? { signal: opts.signal } : {}),\n      })\n    } catch (error) {\n      if (opts.signal?.aborted) throw error\n      throw new RemoteTransportError(`Cannot reach ${options.url}: ${errorMessage(error)}`, { cause: error })\n    }\n\n    const type = res.headers.get(\"content-type\") ?? \"\"\n    if (res.status === 401) {\n      const payload = await readJson(res)\n      const err = isRecord(payload) && isRecord(payload.error) ? payload.error : {}\n      throw new RemoteUnauthorizedError(\n        typeof err.message === \"string\" ? err.message : \"Authentication required.\",\n        parseBearerChallenge(res.headers.get(\"www-authenticate\")),\n        err.data,\n      )\n    }\n    if (type.includes(\"text/event-stream\")) {\n      return handleMessage(await readSse(res, id, opts), id, res.status)\n    }\n    const payload = await readJson(res)\n    if (payload === undefined) {\n      throw new RemoteTransportError(`${options.url} returned HTTP ${res.status} without a JSON-RPC response.`)\n    }\n    return handleMessage(payload, id, res.status)\n  }\n\n  const handleMessage = (message: unknown, id: number, status: number): Record<string, unknown> => {\n    if (!isRecord(message)) throw new RemoteTransportError(`Invalid JSON-RPC response (HTTP ${status}).`)\n    if (isRecord(message.error)) {\n      const e = message.error\n      throw new RemoteRpcError(\n        typeof e.message === \"string\" ? e.message : \"JSON-RPC error\",\n        typeof e.code === \"number\" ? e.code : -32_603,\n        e.data,\n        status,\n      )\n    }\n    if (message.id !== id || !isRecord(message.result)) {\n      throw new RemoteTransportError(`Invalid JSON-RPC response (HTTP ${status}).`)\n    }\n    return message.result\n  }\n\n  const listToolsResult = async (opts: RequestOptions = {}): Promise<ToolsListResult> => {\n    const tools: RemoteTool[] = []\n    const out: ToolsListResult = { tools }\n    let cursor: string | undefined\n    for (let page = 0; page < 100; page++) {\n      const result = await request(\"tools/list\", cursor === undefined ? {} : { cursor }, opts)\n      if (page === 0) {\n        if (typeof result.ttlMs === \"number\" && Number.isFinite(result.ttlMs) && result.ttlMs >= 0) out.ttlMs = result.ttlMs\n        if (typeof result.cacheScope === \"string\") out.cacheScope = result.cacheScope\n      }\n      if (Array.isArray(result.tools)) {\n        for (const t of result.tools) if (isRecord(t) && typeof t.name === \"string\") tools.push(t as unknown as RemoteTool)\n      }\n      if (typeof result.nextCursor !== \"string\" || result.nextCursor === \"\") break\n      cursor = result.nextCursor\n    }\n    return out\n  }\n\n  const callTool = async (\n    tool: RemoteTool,\n    args: Record<string, unknown>,\n    opts: CallToolOptions = {},\n  ): Promise<CallToolResult> => {\n    const headers: Record<string, string> = { \"Mcp-Name\": tool.name, ...paramHeaders(tool, args) }\n    let retry: { inputResponses?: InputResponses; requestState?: string } = {}\n    for (let round = 0; ; round++) {\n      const result = await request(\"tools/call\", { name: tool.name, arguments: args, ...retry }, opts, headers)\n      if (result.resultType !== \"input_required\") return result as CallToolResult\n      const required: InputRequired = {}\n      if (isRecord(result.inputRequests)) required.inputRequests = result.inputRequests as InputRequired[\"inputRequests\"]\n      if (typeof result.requestState === \"string\") required.requestState = result.requestState\n      if (!opts.onInputRequired) throw new RemoteInputRequiredError(`${tool.name} requires input.`, required)\n      if (round >= MAX_INPUT_ROUNDS) {\n        throw new RemoteInputRequiredError(`${tool.name} still required input after ${MAX_INPUT_ROUNDS} rounds.`, required)\n      }\n      // 요청이 있으면 응답을 만든 뒤 재시도. requestState 는 그대로 되돌려 보내고, 없으면 보내지 않는다\n      const responses = required.inputRequests ? await opts.onInputRequired(required, round) : undefined\n      retry = {}\n      if (responses !== undefined) retry.inputResponses = responses\n      if (required.requestState !== undefined) retry.requestState = required.requestState\n    }\n  }\n\n  return {\n    url: options.url,\n    request: (method, params, opts) => request(method, params, opts),\n    listTools: async (opts) => (await listToolsResult(opts)).tools,\n    listToolsResult,\n    callTool,\n  }\n}\n\n/** inputSchema 의 x-mcp-header 속성 → Mcp-Param-<Name> 헤더 (SEP-2243). 문자열 · 숫자 · boolean 값만 */\nfunction paramHeaders(tool: RemoteTool, args: Record<string, unknown>): Record<string, string> {\n  const props = tool.inputSchema?.properties\n  if (!isRecord(props)) return {}\n  const out: Record<string, string> = {}\n  for (const [key, schema] of Object.entries(props)) {\n    if (!isRecord(schema) || typeof schema[\"x-mcp-header\"] !== \"string\") continue\n    const value = args[key]\n    if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n      out[`Mcp-Param-${schema[\"x-mcp-header\"]}`] = String(value)\n    }\n  }\n  return out\n}\n\n/* SSE */\n\n/** 응답 스트림에서 id 의 응답 메시지가 올 때까지 읽는다. 알림은 콜백, 응답 후 스트림을 닫는다 */\nasync function readSse(res: Response, id: number, opts: RequestOptions): Promise<unknown> {\n  if (!res.body) throw new RemoteTransportError(\"Empty event stream.\")\n  const reader = res.body.pipeThrough(new TextDecoderStream()).getReader()\n  let buffer = \"\"\n  let data: string[] = []\n  const dispatch = (): unknown => {\n    if (data.length === 0) return undefined\n    const text = data.join(\"\\n\")\n    data = []\n    let message: unknown\n    try {\n      message = JSON.parse(text)\n    } catch {\n      return undefined\n    }\n    if (!isRecord(message)) return undefined\n    if (typeof message.method === \"string\" && message.id === undefined) {\n      try {\n        opts.onNotification?.(message.method, isRecord(message.params) ? message.params : {})\n      } catch {\n        // 표시 오류는 응답에 영향 없음\n      }\n      return undefined\n    }\n    if (message.id === id && (\"result\" in message || \"error\" in message)) return message\n    return undefined\n  }\n  try {\n    for (;;) {\n      const { done, value } = await reader.read()\n      if (done) break\n      buffer += value\n      let nl: number\n      while ((nl = buffer.search(/\\r\\n|\\r|\\n/)) >= 0) {\n        const line = buffer.slice(0, nl)\n        buffer = buffer.slice(nl + (buffer.startsWith(\"\\r\\n\", nl) ? 2 : 1))\n        if (line === \"\") {\n          const found = dispatch()\n          if (found !== undefined) return found\n          continue\n        }\n        if (line.startsWith(\":\")) continue\n        const colon = line.indexOf(\":\")\n        const field = colon < 0 ? line : line.slice(0, colon)\n        let value = colon < 0 ? \"\" : line.slice(colon + 1)\n        if (value.startsWith(\" \")) value = value.slice(1)\n        if (field === \"data\") data.push(value)\n      }\n    }\n    const found = dispatch()\n    if (found !== undefined) return found\n  } finally {\n    await reader.cancel().catch(() => {})\n  }\n  if (opts.signal?.aborted) throw opts.signal.reason\n  throw new RemoteTransportError(\"Event stream ended without a response.\")\n}\n\nasync function readJson(res: Response): Promise<unknown> {\n  const text = await res.text().catch(() => \"\")\n  if (text === \"\") return undefined\n  try {\n    return JSON.parse(text)\n  } catch {\n    return undefined\n  }\n}\n\n/* WWW-Authenticate */\n\nexport interface BearerChallenge {\n  /** Bearer challenge 가 있었는지 */\n  bearer: boolean\n  error?: string\n  scope?: string\n  resourceMetadata?: string\n}\n\n/** WWW-Authenticate 의 Bearer challenge 파라미터 (RFC 6750 · RFC 9728 resource_metadata) */\nexport function parseBearerChallenge(header: string | null): BearerChallenge {\n  if (!header) return { bearer: false }\n  const m = /(?:^|,\\s*)Bearer\\b(.*)$/i.exec(header)\n  if (!m) return { bearer: false }\n  const params: Record<string, string> = {}\n  const re = /([A-Za-z_][\\w-]*)\\s*=\\s*(?:\"((?:[^\"\\\\]|\\\\.)*)\"|([^\\s,]+))/g\n  for (let p = re.exec(m[1]!); p !== null; p = re.exec(m[1]!)) {\n    params[p[1]!.toLowerCase()] = p[2] !== undefined ? p[2].replace(/\\\\(.)/g, \"$1\") : p[3]!\n  }\n  const out: BearerChallenge = { bearer: true }\n  if (params.error !== undefined) out.error = params.error\n  if (params.scope !== undefined) out.scope = params.scope\n  if (params.resource_metadata !== undefined) out.resourceMetadata = params.resource_metadata\n  return out\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n\nfunction errorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    const cause = (error as { cause?: unknown }).cause\n    return cause instanceof Error && cause.message ? cause.message : error.message\n  }\n  return String(error)\n}\n"]}

package/dist/remote/credentials.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 서버 URL 별 토큰 저장 (D6). OS 키체인 = 시스템 CLI (child_process, 네이티브 의존성 없음):
+ * macOS `security` (login keychain, generic password) · Linux `secret-tool` (Secret Service).
+ * 키체인을 쓸 수 없으면 (그 외 OS · 명령 없음 · 실패) 또는 <BIN>_NO_KEYRING 이면 ~/.config/<bin>/credentials.json (0600).
+ * <BIN>_CREDENTIALS_FILE 환경변수 = 그 파일만 사용 (키체인 · 홈 디렉터리 미사용. 테스트 · CI 용).
+ */
+/**
+ * 저장 항목. OAuth (login) = issuer · token_endpoint · client_id · resource 가 있다.
+ * API key (login --with-token) = access_token (· token_type) 만.
+ */
+export interface StoredCredentials {
+    access_token: string;
+    token_type?: string;
+    refresh_token?: string;
+    /** epoch ms. 없으면 만료 모름 */
+    expires_at?: number;
+    scope?: string;
+    /** 토큰을 발급한 인가 서버 (RFC 8414 issuer) */
+    issuer?: string;
+    token_endpoint?: string;
+    client_id?: string;
+    client_secret?: string;
+    token_endpoint_auth_method?: string;
+    /** RFC 8707 resource (토큰 대상 MCP 서버) */
+    resource?: string;
+}
+export interface CredentialStore {
+    /** 표시용: "macOS keychain" · "Secret Service" · 파일 경로 */
+    readonly location: string;
+    get(serverUrl: string): Promise<StoredCredentials | undefined>;
+    set(serverUrl: string, credentials: StoredCredentials): Promise<void>;
+    delete(serverUrl: string): Promise<void>;
+}
+export interface CredentialStoreOptions {
+    env: Record<string, string | undefined>;
+    /** 실행 파일 이름. 환경변수 접두 (<BIN>_CREDENTIALS_FILE · <BIN>_NO_KEYRING) · 설정 폴더 · 키체인 service. 기본 mext */
+    bin?: string;
+    /** 기본 process.platform */
+    platform?: NodeJS.Platform;
+}
+/** 서버 URL 정규화 (저장 키 · RFC 8707 resource): scheme · host 소문자 (URL 파서), fragment 제거, 끝 / 제거 */
+export declare function canonicalServerUrl(url: string): string;
+/** 실행 파일 이름 → 환경변수 접두. mext → MEXT, my-app → MY_APP */
+export declare function envPrefix(bin: string): string;
+/** 환경변수 플래그: 비어 있지 않고 0 · false 가 아니면 켜짐 */
+export declare function envFlag(value: string | undefined): boolean;
+export declare function credentialStore(options: CredentialStoreOptions): CredentialStore;
+export declare function fileStore(path: string): CredentialStore;