@obov/mext 0.0.0-stage → 0.1.0

package/dist/principal.js

@@ -0,0 +1,24 @@
+import { userInfo } from "node:os";
+/** 인증 없는 주체. scopes 없음 → readOnly 명령어만 */
+export const ANONYMOUS = Object.freeze({
+    id: "anonymous",
+    kind: "anonymous",
+    scopes: Object.freeze([]),
+});
+/** 로컬 · stdio 실행의 기본 주체: { id: "local:<OS 사용자>", kind: "local", scopes: ["*"] } */
+export function localPrincipal(user = osUser()) {
+    return { id: `local:${user}`, kind: "local", scopes: ["*"] };
+}
+/** "*" = 전체 */
+export function hasScope(principal, scope) {
+    return principal.scopes.includes("*") || principal.scopes.includes(scope);
+}
+function osUser() {
+    try {
+        return userInfo().username;
+    }
+    catch {
+        return process.env.USER ?? process.env.USERNAME ?? "unknown";
+    }
+}
+//# sourceMappingURL=principal.js.map

package/dist/principal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal.js","sourceRoot":"","sources":["../src/principal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAalC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAc,MAAM,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAwB;CACjD,CAAc,CAAA;AAEf,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,IAAI,GAAW,MAAM,EAAE;IACpD,OAAO,EAAE,EAAE,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAA;AAC9D,CAAC;AAED,eAAe;AACf,MAAM,UAAU,QAAQ,CAAC,SAAoB,EAAE,KAAa;IAC1D,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC3E,CAAC;AAED,SAAS,MAAM;IACb,IAAI,CAAC;QACH,OAAO,QAAQ,EAAE,CAAC,QAAQ,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,SAAS,CAAA;IAC9D,CAAC;AACH,CAAC","sourcesContent":["import { userInfo } from \"node:os\"\n\n/** 요청 주체. 서버가 요청마다 생성 (HTTP · CLI 원격), 로컬 · stdio = kind local */\nexport interface Principal {\n  /** \"local:obov\" | \"user_123\" | \"anonymous\" */\n  id: string\n  kind: \"local\" | \"token\" | \"anonymous\"\n  /** \"*\" = 전체 */\n  scopes: string[]\n  /** 검증된 토큰 내용. 토큰 원문은 포함하지 않는다 */\n  claims?: Record<string, unknown>\n}\n\n/** 인증 없는 주체. scopes 없음 → readOnly 명령어만 */\nexport const ANONYMOUS: Principal = Object.freeze({\n  id: \"anonymous\",\n  kind: \"anonymous\",\n  scopes: Object.freeze([]) as unknown as string[],\n}) as Principal\n\n/** 로컬 · stdio 실행의 기본 주체: { id: \"local:<OS 사용자>\", kind: \"local\", scopes: [\"*\"] } */\nexport function localPrincipal(user: string = osUser()): Principal {\n  return { id: `local:${user}`, kind: \"local\", scopes: [\"*\"] }\n}\n\n/** \"*\" = 전체 */\nexport function hasScope(principal: Principal, scope: string): boolean {\n  return principal.scopes.includes(\"*\") || principal.scopes.includes(scope)\n}\n\nfunction osUser(): string {\n  try {\n    return userInfo().username\n  } catch {\n    return process.env.USER ?? process.env.USERNAME ?? \"unknown\"\n  }\n}\n"]}

package/dist/registry.d.ts

@@ -0,0 +1,90 @@
+import { type Command } from "./command.ts";
+import { type BuildIssue } from "./errors.ts";
+export type JsonSchema = Record<string, unknown>;
+export interface RegistryCommandInput {
+    /** 정식 ID. 점 구분 kebab-case 세그먼트 */
+    id: string;
+    command: Command;
+    /** commands/ 기준 상대 경로 (posix). 스캔 결과에만 있음 */
+    file?: string;
+}
+export interface RegistryNamespaceInput {
+    /** "" = 루트 */
+    id: string;
+    description?: string;
+}
+export interface RegistryInput {
+    commands: readonly RegistryCommandInput[];
+    namespaces?: readonly RegistryNamespaceInput[];
+}
+export interface RegisteredCommand {
+    id: string;
+    /**
+     * 메타데이터 (description · 안전성 · scopes · examples · positional · aliases) 의 원본.
+     * eager (createRegistry) = 실행 가능한 명령어 그대로. lazy (createLazyRegistry) = manifest 로 만든 메타데이터만
+     * (input · execute 는 load() 결과에서)
+     */
+    command: Command;
+    /** lazy Registry: 명령어 모듈 import (1회 캐시) → 실행 가능한 명령어. 없음 = command 가 실행 가능. loadCommand 로 호출 */
+    load?: () => Promise<Command>;
+    /** 별칭의 전체 ID (정렬) */
+    aliases: readonly string[];
+    file: string | undefined;
+    /** input 의 JSON Schema 2020-12 (io: input) */
+    inputSchema: JsonSchema;
+    /** output 의 JSON Schema 2020-12 (io: output) */
+    outputSchema: JsonSchema | undefined;
+}
+export interface NamespaceInfo {
+    /** "" = 루트 */
+    id: string;
+    /** _index.md 내용 */
+    description: string | undefined;
+    /** 직속 명령어 정식 ID (정렬). index.ts 명령어 (네임스페이스와 같은 ID) 는 상위 네임스페이스에 속한다 */
+    commands: readonly string[];
+    /** 직속 하위 네임스페이스 ID (정렬) */
+    namespaces: readonly string[];
+}
+export interface Registry {
+    /** 정식 ID → 명령어. ID 순 */
+    readonly commands: ReadonlyMap<string, RegisteredCommand>;
+    /** 별칭 전체 ID → 정식 ID */
+    readonly aliases: ReadonlyMap<string, string>;
+    /** 네임스페이스 ID → 정보. 루트 ("") 포함, ID 순 */
+    readonly namespaces: ReadonlyMap<string, NamespaceInfo>;
+}
+/** 명령어 목록에서 Registry 생성. ID · 별칭 · 스키마 규칙 위반은 MextBuildError */
+export declare function createRegistry(input: RegistryInput): Registry;
+/**
+ * createRegistry 의 수집형 (mext build 의 일괄 검증용). 던지지 않는다.
+ * registry = 규칙을 통과한 명령어만, issues = 위반 전부
+ */
+export declare function collectRegistry(input: RegistryInput): {
+    registry: Registry;
+    issues: BuildIssue[];
+};
+/** lazy Registry 의 명령어: manifest 메타데이터 + 모듈 로더 (규칙 검증은 mext build 가 이미 함) */
+export interface LazyCommandInput {
+    id: string;
+    /** 메타데이터만 있는 명령어 (input · execute 는 load 결과). RegisteredCommand.command */
+    command: Command;
+    /** 별칭의 전체 ID */
+    aliases: readonly string[];
+    file?: string;
+    inputSchema: JsonSchema;
+    outputSchema?: JsonSchema;
+    /** 실행 시 1회 호출 (결과 캐시, 실패는 다음 호출에서 재시도) */
+    load: () => Promise<Command>;
+}
+/**
+ * manifest (mext build 산출) 로 Registry 생성. 명령어 모듈을 import 하지 않는다 (mext start · handler.js).
+ * help · tools/list · UNKNOWN_COMMAND · 권한 검사 = 메타데이터만, 입력 검증 · execute = loadCommand 후
+ */
+export declare function createLazyRegistry(input: {
+    commands: readonly LazyCommandInput[];
+    namespaces?: readonly RegistryNamespaceInput[];
+}): Registry;
+/** 실행 가능한 명령어. eager = entry.command, lazy = entry.load() (모듈 import) */
+export declare function loadCommand(entry: RegisteredCommand): Promise<Command>;
+/** 정식 ID 또는 별칭으로 명령어 찾기 */
+export declare function resolveCommand(registry: Registry, id: string): RegisteredCommand | undefined;

package/dist/registry.js

@@ -0,0 +1,169 @@
+import * as z from "zod";
+import { isCommand } from "./command.js";
+import { MextBuildError } from "./errors.js";
+import { isSegment, parentNamespace, RESERVED_ROOT_SEGMENTS } from "./ids.js";
+/** 명령어 목록에서 Registry 생성. ID · 별칭 · 스키마 규칙 위반은 MextBuildError */
+export function createRegistry(input) {
+    const { registry, issues } = collectRegistry(input);
+    if (issues.length > 0)
+        throw new MextBuildError(issues);
+    return registry;
+}
+/**
+ * createRegistry 의 수집형 (mext build 의 일괄 검증용). 던지지 않는다.
+ * registry = 규칙을 통과한 명령어만, issues = 위반 전부
+ */
+export function collectRegistry(input) {
+    const issues = [];
+    const accepted = [];
+    const seen = new Map();
+    for (const entry of input.commands) {
+        const where = { id: entry.id, file: entry.file };
+        if (!isCommand(entry.command)) {
+            issues.push({ code: "INVALID_COMMAND", message: "not a defineCommand result", ...where });
+            continue;
+        }
+        const segments = entry.id.split(".");
+        const bad = segments.find((s) => !isSegment(s));
+        if (bad !== undefined) {
+            issues.push({ code: "INVALID_SEGMENT", message: `segment "${bad}" is not kebab-case`, ...where });
+            continue;
+        }
+        if (RESERVED_ROOT_SEGMENTS.includes(segments[0])) {
+            issues.push({ code: "RESERVED_ID", message: `root segment "${segments[0]}" is reserved`, ...where });
+            continue;
+        }
+        const prev = seen.get(entry.id);
+        if (prev) {
+            issues.push({ code: "DUPLICATE_ID", message: `duplicate ID (also ${prev.file ?? prev.id})`, ...where });
+            continue;
+        }
+        seen.set(entry.id, entry);
+        accepted.push(entry);
+    }
+    // 네임스페이스 = 명령어 ID 의 모든 상위 경로
+    const namespaceIds = new Set([""]);
+    for (const { id } of accepted) {
+        for (let ns = parentNamespace(id); ns !== ""; ns = parentNamespace(ns))
+            namespaceIds.add(ns);
+    }
+    const aliases = new Map();
+    const aliasesOf = new Map();
+    for (const entry of accepted) {
+        const where = { id: entry.id, file: entry.file };
+        const parent = parentNamespace(entry.id);
+        const own = [];
+        for (const alias of entry.command.aliases) {
+            if (!isSegment(alias)) {
+                issues.push({ code: "INVALID_ALIAS", message: `alias "${alias}" is not a kebab-case segment`, ...where });
+                continue;
+            }
+            if (parent === "") {
+                issues.push({ code: "INVALID_ALIAS", message: `alias "${alias}": aliases are not allowed at the root`, ...where });
+                continue;
+            }
+            const full = `${parent}.${alias}`;
+            const owner = seen.has(full) ? full : aliases.get(full);
+            if (owner !== undefined || namespaceIds.has(full)) {
+                issues.push({
+                    code: "DUPLICATE_ID",
+                    message: `alias ${full} duplicates ${owner !== undefined ? owner : "a namespace"}`,
+                    ...where,
+                });
+                continue;
+            }
+            aliases.set(full, entry.id);
+            own.push(full);
+        }
+        aliasesOf.set(entry.id, own.sort());
+    }
+    const commands = new Map();
+    for (const entry of [...accepted].sort((a, b) => compareIds(a.id, b.id))) {
+        const where = { id: entry.id, file: entry.file };
+        let inputSchema;
+        let outputSchema;
+        try {
+            inputSchema = toJsonSchema(entry.command.input, "input");
+            outputSchema = entry.command.output ? toJsonSchema(entry.command.output, "output") : undefined;
+        }
+        catch (error) {
+            issues.push({ code: "SCHEMA_UNREPRESENTABLE", message: errorMessage(error), ...where });
+            continue;
+        }
+        commands.set(entry.id, {
+            id: entry.id,
+            command: entry.command,
+            aliases: aliasesOf.get(entry.id) ?? [],
+            file: entry.file,
+            inputSchema,
+            outputSchema,
+        });
+    }
+    const namespaces = namespaceTable(namespaceIds, [...commands.keys()], input.namespaces);
+    return { registry: { commands, aliases, namespaces }, issues };
+}
+/**
+ * manifest (mext build 산출) 로 Registry 생성. 명령어 모듈을 import 하지 않는다 (mext start · handler.js).
+ * help · tools/list · UNKNOWN_COMMAND · 권한 검사 = 메타데이터만, 입력 검증 · execute = loadCommand 후
+ */
+export function createLazyRegistry(input) {
+    const commands = new Map();
+    const aliases = new Map();
+    for (const entry of [...input.commands].sort((a, b) => compareIds(a.id, b.id))) {
+        const load = entry.load;
+        let pending;
+        commands.set(entry.id, {
+            id: entry.id,
+            command: entry.command,
+            aliases: [...entry.aliases].sort(),
+            file: entry.file,
+            inputSchema: entry.inputSchema,
+            outputSchema: entry.outputSchema,
+            load: () => (pending ??= load().catch((error) => {
+                pending = undefined;
+                throw error;
+            })),
+        });
+        for (const alias of entry.aliases)
+            aliases.set(alias, entry.id);
+    }
+    const namespaceIds = new Set([""]);
+    for (const id of commands.keys()) {
+        for (let ns = parentNamespace(id); ns !== ""; ns = parentNamespace(ns))
+            namespaceIds.add(ns);
+    }
+    return { commands, aliases, namespaces: namespaceTable(namespaceIds, [...commands.keys()], input.namespaces) };
+}
+/** 실행 가능한 명령어. eager = entry.command, lazy = entry.load() (모듈 import) */
+export function loadCommand(entry) {
+    return entry.load ? entry.load() : Promise.resolve(entry.command);
+}
+function namespaceTable(namespaceIds, commandIds, inputs) {
+    const descriptions = new Map();
+    for (const ns of inputs ?? [])
+        descriptions.set(ns.id, ns.description);
+    const namespaces = new Map();
+    for (const id of [...namespaceIds].sort(compareIds)) {
+        namespaces.set(id, {
+            id,
+            description: descriptions.get(id),
+            commands: commandIds.filter((c) => parentNamespace(c) === id),
+            namespaces: [...namespaceIds].filter((n) => n !== "" && parentNamespace(n) === id).sort(compareIds),
+        });
+    }
+    return namespaces;
+}
+/** 정식 ID 또는 별칭으로 명령어 찾기 */
+export function resolveCommand(registry, id) {
+    return registry.commands.get(id) ?? registry.commands.get(registry.aliases.get(id) ?? "");
+}
+function toJsonSchema(schema, io) {
+    return z.toJSONSchema(schema, { target: "draft-2020-12", io, unrepresentable: "throw" });
+}
+function compareIds(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import * as z from \"zod\"\nimport { isCommand, type Command } from \"./command.ts\"\nimport { MextBuildError, type BuildIssue } from \"./errors.ts\"\nimport { isSegment, parentNamespace, RESERVED_ROOT_SEGMENTS } from \"./ids.ts\"\n\nexport type JsonSchema = Record<string, unknown>\n\nexport interface RegistryCommandInput {\n  /** 정식 ID. 점 구분 kebab-case 세그먼트 */\n  id: string\n  command: Command\n  /** commands/ 기준 상대 경로 (posix). 스캔 결과에만 있음 */\n  file?: string\n}\n\nexport interface RegistryNamespaceInput {\n  /** \"\" = 루트 */\n  id: string\n  description?: string\n}\n\nexport interface RegistryInput {\n  commands: readonly RegistryCommandInput[]\n  namespaces?: readonly RegistryNamespaceInput[]\n}\n\nexport interface RegisteredCommand {\n  id: string\n  /**\n   * 메타데이터 (description · 안전성 · scopes · examples · positional · aliases) 의 원본.\n   * eager (createRegistry) = 실행 가능한 명령어 그대로. lazy (createLazyRegistry) = manifest 로 만든 메타데이터만\n   * (input · execute 는 load() 결과에서)\n   */\n  command: Command\n  /** lazy Registry: 명령어 모듈 import (1회 캐시) → 실행 가능한 명령어. 없음 = command 가 실행 가능. loadCommand 로 호출 */\n  load?: () => Promise<Command>\n  /** 별칭의 전체 ID (정렬) */\n  aliases: readonly string[]\n  file: string | undefined\n  /** input 의 JSON Schema 2020-12 (io: input) */\n  inputSchema: JsonSchema\n  /** output 의 JSON Schema 2020-12 (io: output) */\n  outputSchema: JsonSchema | undefined\n}\n\nexport interface NamespaceInfo {\n  /** \"\" = 루트 */\n  id: string\n  /** _index.md 내용 */\n  description: string | undefined\n  /** 직속 명령어 정식 ID (정렬). index.ts 명령어 (네임스페이스와 같은 ID) 는 상위 네임스페이스에 속한다 */\n  commands: readonly string[]\n  /** 직속 하위 네임스페이스 ID (정렬) */\n  namespaces: readonly string[]\n}\n\nexport interface Registry {\n  /** 정식 ID → 명령어. ID 순 */\n  readonly commands: ReadonlyMap<string, RegisteredCommand>\n  /** 별칭 전체 ID → 정식 ID */\n  readonly aliases: ReadonlyMap<string, string>\n  /** 네임스페이스 ID → 정보. 루트 (\"\") 포함, ID 순 */\n  readonly namespaces: ReadonlyMap<string, NamespaceInfo>\n}\n\n/** 명령어 목록에서 Registry 생성. ID · 별칭 · 스키마 규칙 위반은 MextBuildError */\nexport function createRegistry(input: RegistryInput): Registry {\n  const { registry, issues } = collectRegistry(input)\n  if (issues.length > 0) throw new MextBuildError(issues)\n  return registry\n}\n\n/**\n * createRegistry 의 수집형 (mext build 의 일괄 검증용). 던지지 않는다.\n * registry = 규칙을 통과한 명령어만, issues = 위반 전부\n */\nexport function collectRegistry(input: RegistryInput): { registry: Registry; issues: BuildIssue[] } {\n  const issues: BuildIssue[] = []\n  const accepted: RegistryCommandInput[] = []\n  const seen = new Map<string, RegistryCommandInput>()\n\n  for (const entry of input.commands) {\n    const where = { id: entry.id, file: entry.file }\n    if (!isCommand(entry.command)) {\n      issues.push({ code: \"INVALID_COMMAND\", message: \"not a defineCommand result\", ...where })\n      continue\n    }\n    const segments = entry.id.split(\".\")\n    const bad = segments.find((s) => !isSegment(s))\n    if (bad !== undefined) {\n      issues.push({ code: \"INVALID_SEGMENT\", message: `segment \"${bad}\" is not kebab-case`, ...where })\n      continue\n    }\n    if (RESERVED_ROOT_SEGMENTS.includes(segments[0]!)) {\n      issues.push({ code: \"RESERVED_ID\", message: `root segment \"${segments[0]}\" is reserved`, ...where })\n      continue\n    }\n    const prev = seen.get(entry.id)\n    if (prev) {\n      issues.push({ code: \"DUPLICATE_ID\", message: `duplicate ID (also ${prev.file ?? prev.id})`, ...where })\n      continue\n    }\n    seen.set(entry.id, entry)\n    accepted.push(entry)\n  }\n\n  // 네임스페이스 = 명령어 ID 의 모든 상위 경로\n  const namespaceIds = new Set<string>([\"\"])\n  for (const { id } of accepted) {\n    for (let ns = parentNamespace(id); ns !== \"\"; ns = parentNamespace(ns)) namespaceIds.add(ns)\n  }\n\n  const aliases = new Map<string, string>()\n  const aliasesOf = new Map<string, string[]>()\n  for (const entry of accepted) {\n    const where = { id: entry.id, file: entry.file }\n    const parent = parentNamespace(entry.id)\n    const own: string[] = []\n    for (const alias of entry.command.aliases) {\n      if (!isSegment(alias)) {\n        issues.push({ code: \"INVALID_ALIAS\", message: `alias \"${alias}\" is not a kebab-case segment`, ...where })\n        continue\n      }\n      if (parent === \"\") {\n        issues.push({ code: \"INVALID_ALIAS\", message: `alias \"${alias}\": aliases are not allowed at the root`, ...where })\n        continue\n      }\n      const full = `${parent}.${alias}`\n      const owner = seen.has(full) ? full : aliases.get(full)\n      if (owner !== undefined || namespaceIds.has(full)) {\n        issues.push({\n          code: \"DUPLICATE_ID\",\n          message: `alias ${full} duplicates ${owner !== undefined ? owner : \"a namespace\"}`,\n          ...where,\n        })\n        continue\n      }\n      aliases.set(full, entry.id)\n      own.push(full)\n    }\n    aliasesOf.set(entry.id, own.sort())\n  }\n\n  const commands = new Map<string, RegisteredCommand>()\n  for (const entry of [...accepted].sort((a, b) => compareIds(a.id, b.id))) {\n    const where = { id: entry.id, file: entry.file }\n    let inputSchema: JsonSchema\n    let outputSchema: JsonSchema | undefined\n    try {\n      inputSchema = toJsonSchema(entry.command.input, \"input\")\n      outputSchema = entry.command.output ? toJsonSchema(entry.command.output, \"output\") : undefined\n    } catch (error) {\n      issues.push({ code: \"SCHEMA_UNREPRESENTABLE\", message: errorMessage(error), ...where })\n      continue\n    }\n    commands.set(entry.id, {\n      id: entry.id,\n      command: entry.command,\n      aliases: aliasesOf.get(entry.id) ?? [],\n      file: entry.file,\n      inputSchema,\n      outputSchema,\n    })\n  }\n\n  const namespaces = namespaceTable(namespaceIds, [...commands.keys()], input.namespaces)\n  return { registry: { commands, aliases, namespaces }, issues }\n}\n\n/** lazy Registry 의 명령어: manifest 메타데이터 + 모듈 로더 (규칙 검증은 mext build 가 이미 함) */\nexport interface LazyCommandInput {\n  id: string\n  /** 메타데이터만 있는 명령어 (input · execute 는 load 결과). RegisteredCommand.command */\n  command: Command\n  /** 별칭의 전체 ID */\n  aliases: readonly string[]\n  file?: string\n  inputSchema: JsonSchema\n  outputSchema?: JsonSchema\n  /** 실행 시 1회 호출 (결과 캐시, 실패는 다음 호출에서 재시도) */\n  load: () => Promise<Command>\n}\n\n/**\n * manifest (mext build 산출) 로 Registry 생성. 명령어 모듈을 import 하지 않는다 (mext start · handler.js).\n * help · tools/list · UNKNOWN_COMMAND · 권한 검사 = 메타데이터만, 입력 검증 · execute = loadCommand 후\n */\nexport function createLazyRegistry(input: {\n  commands: readonly LazyCommandInput[]\n  namespaces?: readonly RegistryNamespaceInput[]\n}): Registry {\n  const commands = new Map<string, RegisteredCommand>()\n  const aliases = new Map<string, string>()\n  for (const entry of [...input.commands].sort((a, b) => compareIds(a.id, b.id))) {\n    const load = entry.load\n    let pending: Promise<Command> | undefined\n    commands.set(entry.id, {\n      id: entry.id,\n      command: entry.command,\n      aliases: [...entry.aliases].sort(),\n      file: entry.file,\n      inputSchema: entry.inputSchema,\n      outputSchema: entry.outputSchema,\n      load: () =>\n        (pending ??= load().catch((error: unknown) => {\n          pending = undefined\n          throw error\n        })),\n    })\n    for (const alias of entry.aliases) aliases.set(alias, entry.id)\n  }\n  const namespaceIds = new Set<string>([\"\"])\n  for (const id of commands.keys()) {\n    for (let ns = parentNamespace(id); ns !== \"\"; ns = parentNamespace(ns)) namespaceIds.add(ns)\n  }\n  return { commands, aliases, namespaces: namespaceTable(namespaceIds, [...commands.keys()], input.namespaces) }\n}\n\n/** 실행 가능한 명령어. eager = entry.command, lazy = entry.load() (모듈 import) */\nexport function loadCommand(entry: RegisteredCommand): Promise<Command> {\n  return entry.load ? entry.load() : Promise.resolve(entry.command)\n}\n\nfunction namespaceTable(\n  namespaceIds: ReadonlySet<string>,\n  commandIds: readonly string[],\n  inputs: readonly RegistryNamespaceInput[] | undefined,\n): Map<string, NamespaceInfo> {\n  const descriptions = new Map<string, string | undefined>()\n  for (const ns of inputs ?? []) descriptions.set(ns.id, ns.description)\n  const namespaces = new Map<string, NamespaceInfo>()\n  for (const id of [...namespaceIds].sort(compareIds)) {\n    namespaces.set(id, {\n      id,\n      description: descriptions.get(id),\n      commands: commandIds.filter((c) => parentNamespace(c) === id),\n      namespaces: [...namespaceIds].filter((n) => n !== \"\" && parentNamespace(n) === id).sort(compareIds),\n    })\n  }\n  return namespaces\n}\n\n/** 정식 ID 또는 별칭으로 명령어 찾기 */\nexport function resolveCommand(registry: Registry, id: string): RegisteredCommand | undefined {\n  return registry.commands.get(id) ?? registry.commands.get(registry.aliases.get(id) ?? \"\")\n}\n\nfunction toJsonSchema(schema: z.ZodType, io: \"input\" | \"output\"): JsonSchema {\n  return z.toJSONSchema(schema, { target: \"draft-2020-12\", io, unrepresentable: \"throw\" }) as JsonSchema\n}\n\nfunction compareIds(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n"]}

package/dist/remote/browser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * login 의 브라우저 판정 · 열기 (spec §5 login 브라우저 판정 · headless).
+ * 열지 않음 = SSH 세션 (SSH_CONNECTION · SSH_CLIENT · SSH_TTY) · Linux 에서 DISPLAY · WAYLAND_DISPLAY 없음.
+ * 여는 명령 = BROWSER (있으면) → open (macOS) · start (Windows) · xdg-open.
+ */
+export interface BrowserDecision {
+    open: boolean;
+    /** 열지 않는 이유 (안내 출력용) */
+    reason?: "ssh" | "no-display";
+}
+/** URL 을 브라우저로 연다. 실패는 무시 (URL 은 항상 stderr 에 출력) */
+export type BrowserOpener = (url: string) => void;
+export declare function browserDecision(env: Record<string, string | undefined>, platform?: NodeJS.Platform): BrowserDecision;
+/** 기본 opener. BROWSER = 명령 (공백 구분 인자, %s 가 있으면 URL 로 치환 · 없으면 끝에 URL) */
+export declare function systemBrowserOpener(env: Record<string, string | undefined>, platform?: NodeJS.Platform): BrowserOpener;

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>;