@obov/mext 0.5.0 → 0.7.1

package/dist/principal.d.ts

@@ -1,3 +1,11 @@
+/** 행위자 종류. auth · localPrincipal 이 정한다 */
+export type ActorKind = "human" | "agent" | "service" | "system";
+/** 행위자. 서버 (auth · localPrincipal) 가 정한 값만. 클라이언트 신고 값으로 정하지 않는다 */
+export interface Actor {
+    kind: ActorKind;
+    /** 행위자 식별자 (사용자 ID · 에이전트 ID). principal.id 와 다를 수 있다 (에이전트가 사용자 계정으로 실행) */
+    id?: string;
+}
 /** 요청 주체. 서버가 요청마다 생성 (HTTP · CLI 원격), 로컬 · stdio = kind local */
 export interface Principal {
     /** "local:obov" | "user_123" | "anonymous" */
@@ -7,6 +15,13 @@ export interface Principal {
     scopes: string[];
     /** 검증된 토큰 내용. 토큰 원문은 포함하지 않는다 */
     claims?: Record<string, unknown>;
+    /** 행위자 (ctx.caller.actor). 없음 = 미확정. mext 는 추정하지 않는다 */
+    actor?: Actor;
+    /**
+     * 논리 표면 (ctx.caller.surface). kebab-case 이름. 없음 = 어댑터 기본 (cli · mcp · stdio).
+     * 같은 POST /mcp 요청을 호출자별로 나눌 때 auth 가 정한다 (예: 웹 앱 세션 = "web")
+     */
+    surface?: string;
 }
 /** 인증 없는 주체. scopes 없음 → readOnly 명령어만 */
 export declare const ANONYMOUS: Principal;
@@ -14,3 +29,10 @@ export declare const ANONYMOUS: Principal;
 export declare function localPrincipal(user?: string): Principal;
 /** "*" = 전체 */
 export declare function hasScope(principal: Principal, scope: string): boolean;
+/**
+ * principal.actor · surface 형식 문제. 없으면 undefined.
+ * id · kind · scopes 는 검사하지 않는다 (auth 결과를 검사하지 않던 기존 동작 유지)
+ */
+export declare function callerFieldsProblem(value: unknown): string | undefined;
+/** callerFieldsProblem 이 있으면 TypeError ("<source>: principal <문제>"). source = "auth" · "localPrincipal" */
+export declare function assertCallerFields(value: unknown, source: string): asserts value is Principal;

package/dist/principal.js

@@ -1,4 +1,6 @@
 import { userInfo } from "node:os";
+import { isSegment } from "./ids.js";
+const ACTOR_KINDS = ["human", "agent", "service", "system"];
 /** 인증 없는 주체. scopes 없음 → readOnly 명령어만 */
 export const ANONYMOUS = Object.freeze({
     id: "anonymous",
@@ -13,6 +15,33 @@ export function localPrincipal(user = osUser()) {
 export function hasScope(principal, scope) {
     return principal.scopes.includes("*") || principal.scopes.includes(scope);
 }
+/**
+ * principal.actor · surface 형식 문제. 없으면 undefined.
+ * id · kind · scopes 는 검사하지 않는다 (auth 결과를 검사하지 않던 기존 동작 유지)
+ */
+export function callerFieldsProblem(value) {
+    const p = value;
+    if (typeof p !== "object" || p === null)
+        return "must be an object ({ id, kind, scopes })";
+    if (p.surface !== undefined && (typeof p.surface !== "string" || !isSegment(p.surface))) {
+        return 'surface must be a kebab-case name (e.g. "web")';
+    }
+    if (p.actor !== undefined) {
+        const a = p.actor;
+        if (typeof a !== "object" || a === null || !ACTOR_KINDS.includes(a.kind)) {
+            return 'actor.kind must be "human", "agent", "service" or "system"';
+        }
+        if (a.id !== undefined && typeof a.id !== "string")
+            return "actor.id must be a string";
+    }
+    return undefined;
+}
+/** callerFieldsProblem 이 있으면 TypeError ("<source>: principal <문제>"). source = "auth" · "localPrincipal" */
+export function assertCallerFields(value, source) {
+    const problem = callerFieldsProblem(value);
+    if (problem !== undefined)
+        throw new TypeError(`${source}: principal ${problem}`);
+}
 function osUser() {
     try {
         return userInfo().username;

package/dist/principal.js.map

@@ -1 +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"]}
+{"version":3,"file":"principal.js","sourceRoot":"","sources":["../src/principal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAYpC,MAAM,WAAW,GAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;AAoB9E,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;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,CAAC,GAAG,KAAkC,CAAA;IAC5C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,0CAA0C,CAAA;IAC1F,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,gDAAgD,CAAA;IACzD,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,KAA8B,CAAA;QAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAc,CAAC,EAAE,CAAC;YACnF,OAAO,4DAA4D,CAAA;QACrE,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO,2BAA2B,CAAA;IACxF,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,MAAc;IAC/D,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,MAAM,eAAe,OAAO,EAAE,CAAC,CAAA;AACnF,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\"\nimport { isSegment } from \"./ids.ts\"\n\n/** 행위자 종류. auth · localPrincipal 이 정한다 */\nexport type ActorKind = \"human\" | \"agent\" | \"service\" | \"system\"\n\n/** 행위자. 서버 (auth · localPrincipal) 가 정한 값만. 클라이언트 신고 값으로 정하지 않는다 */\nexport interface Actor {\n  kind: ActorKind\n  /** 행위자 식별자 (사용자 ID · 에이전트 ID). principal.id 와 다를 수 있다 (에이전트가 사용자 계정으로 실행) */\n  id?: string\n}\n\nconst ACTOR_KINDS: readonly string[] = [\"human\", \"agent\", \"service\", \"system\"]\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  /** 행위자 (ctx.caller.actor). 없음 = 미확정. mext 는 추정하지 않는다 */\n  actor?: Actor\n  /**\n   * 논리 표면 (ctx.caller.surface). kebab-case 이름. 없음 = 어댑터 기본 (cli · mcp · stdio).\n   * 같은 POST /mcp 요청을 호출자별로 나눌 때 auth 가 정한다 (예: 웹 앱 세션 = \"web\")\n   */\n  surface?: string\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\n/**\n * principal.actor · surface 형식 문제. 없으면 undefined.\n * id · kind · scopes 는 검사하지 않는다 (auth 결과를 검사하지 않던 기존 동작 유지)\n */\nexport function callerFieldsProblem(value: unknown): string | undefined {\n  const p = value as Partial<Principal> | null\n  if (typeof p !== \"object\" || p === null) return \"must be an object ({ id, kind, scopes })\"\n  if (p.surface !== undefined && (typeof p.surface !== \"string\" || !isSegment(p.surface))) {\n    return 'surface must be a kebab-case name (e.g. \"web\")'\n  }\n  if (p.actor !== undefined) {\n    const a = p.actor as Partial<Actor> | null\n    if (typeof a !== \"object\" || a === null || !ACTOR_KINDS.includes(a.kind as string)) {\n      return 'actor.kind must be \"human\", \"agent\", \"service\" or \"system\"'\n    }\n    if (a.id !== undefined && typeof a.id !== \"string\") return \"actor.id must be a string\"\n  }\n  return undefined\n}\n\n/** callerFieldsProblem 이 있으면 TypeError (\"<source>: principal <문제>\"). source = \"auth\" · \"localPrincipal\" */\nexport function assertCallerFields(value: unknown, source: string): asserts value is Principal {\n  const problem = callerFieldsProblem(value)\n  if (problem !== undefined) throw new TypeError(`${source}: principal ${problem}`)\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

@@ -90,6 +90,11 @@ export declare function createLazyRegistry(input: {
     commands: readonly LazyCommandInput[];
     namespaces?: readonly RegistryNamespaceInput[];
 }): Registry;
+/**
+ * keep 을 통과한 명령어만 남긴 Registry (expose 의 표면별 보기). 별칭 · 네임스페이스를 다시 계산한다:
+ * 남은 명령어가 없는 네임스페이스는 없어지고, 남은 네임스페이스의 설명은 유지. 명령어 항목 · 자원 · 프롬프트는 원본과 같은 객체
+ */
+export declare function filterRegistry(registry: Registry, keep: (entry: RegisteredCommand) => boolean): Registry;
 /** 실행 가능한 명령어. eager = entry.command, lazy = entry.load() (모듈 import) */
 export declare function loadCommand(entry: RegisteredCommand): Promise<Command>;
 /** 정식 ID 또는 별칭으로 명령어 찾기 */

package/dist/registry.js

@@ -134,6 +134,27 @@ export function createLazyRegistry(input) {
     }
     return { commands, aliases, namespaces: namespaceTable(namespaceIds, [...commands.keys()], input.namespaces) };
 }
+/**
+ * keep 을 통과한 명령어만 남긴 Registry (expose 의 표면별 보기). 별칭 · 네임스페이스를 다시 계산한다:
+ * 남은 명령어가 없는 네임스페이스는 없어지고, 남은 네임스페이스의 설명은 유지. 명령어 항목 · 자원 · 프롬프트는 원본과 같은 객체
+ */
+export function filterRegistry(registry, keep) {
+    const commands = new Map();
+    for (const [id, entry] of registry.commands)
+        if (keep(entry))
+            commands.set(id, entry);
+    const aliases = new Map();
+    for (const [alias, id] of registry.aliases)
+        if (commands.has(id))
+            aliases.set(alias, id);
+    const namespaceIds = new Set([""]);
+    for (const id of commands.keys()) {
+        for (let ns = parentNamespace(id); ns !== ""; ns = parentNamespace(ns))
+            namespaceIds.add(ns);
+    }
+    const descriptions = [...registry.namespaces.values()].flatMap((n) => (n.description === undefined ? [] : [{ id: n.id, description: n.description }]));
+    return { ...registry, commands, aliases, namespaces: namespaceTable(namespaceIds, [...commands.keys()], descriptions) };
+}
 /** 실행 가능한 명령어. eager = entry.command, lazy = entry.load() (모듈 import) */
 export function loadCommand(entry) {
     return entry.load ? entry.load() : Promise.resolve(entry.command);

package/dist/registry.js.map

@@ -1 +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\"\nimport type { PromptSet } from \"./prompt.ts\"\nimport type { ResourceSet } from \"./resource.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  /** MCP 자원 (resources/, §12.3). 없음 = 기능 없음 (capability 미선언). 명령어 Map 과 별개 */\n  readonly resources?: ResourceSet\n  /** MCP 프롬프트 (prompts/, §12.3). 없음 = 기능 없음 (capability 미선언). 이름 순 */\n  readonly prompts?: PromptSet\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"]}
+{"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\"\nimport type { PromptSet } from \"./prompt.ts\"\nimport type { ResourceSet } from \"./resource.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  /** MCP 자원 (resources/, §12.3). 없음 = 기능 없음 (capability 미선언). 명령어 Map 과 별개 */\n  readonly resources?: ResourceSet\n  /** MCP 프롬프트 (prompts/, §12.3). 없음 = 기능 없음 (capability 미선언). 이름 순 */\n  readonly prompts?: PromptSet\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/**\n * keep 을 통과한 명령어만 남긴 Registry (expose 의 표면별 보기). 별칭 · 네임스페이스를 다시 계산한다:\n * 남은 명령어가 없는 네임스페이스는 없어지고, 남은 네임스페이스의 설명은 유지. 명령어 항목 · 자원 · 프롬프트는 원본과 같은 객체\n */\nexport function filterRegistry(registry: Registry, keep: (entry: RegisteredCommand) => boolean): Registry {\n  const commands = new Map<string, RegisteredCommand>()\n  for (const [id, entry] of registry.commands) if (keep(entry)) commands.set(id, entry)\n  const aliases = new Map<string, string>()\n  for (const [alias, id] of registry.aliases) if (commands.has(id)) aliases.set(alias, id)\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  const descriptions = [...registry.namespaces.values()].flatMap((n) => (n.description === undefined ? [] : [{ id: n.id, description: n.description }]))\n  return { ...registry, commands, aliases, namespaces: namespaceTable(namespaceIds, [...commands.keys()], descriptions) }\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/client.d.ts

@@ -4,7 +4,8 @@
  * Mcp-Name · Mcp-Param-* 헤더. 응답 = application/json 또는 text/event-stream (progress 알림 → onNotification).
  * MRTR (InputRequiredResult) 재시도 루프는 callTool 의 onInputRequired 가 담당.
  * tasks 확장 (§12.6) 선언: tools/call 이 CreateTaskResult (resultType "task") 를 그대로 돌려주고, 폴링 · 답 · 취소 =
- * getTask · updateTask · cancelTask (Mcp-Name = taskId). 폴링 루프는 client/task.ts
+ * getTask · updateTask · cancelTask (Mcp-Name = taskId). 폴링 루프는 client/task.ts.
+ * subscriptions/listen (mext.md §12.5) = listen: 응답 SSE 를 ack 뒤에도 계속 읽는다 (타입 client subscribe)
  */
 export declare const PROTOCOL_VERSION = "2026-07-28";
 export declare const META_KEYS: {
@@ -61,6 +62,8 @@ export interface RequestOptions {
 export interface CallToolOptions extends RequestOptions {
     /** input_required 응답 처리 → 이번 라운드의 inputResponses. 없으면 RemoteInputRequiredError */
     onInputRequired?: (request: InputRequired, round: number) => Promise<InputResponses>;
+    /** tools/call 요청 params._meta 에 실을 값 (예: 확인 표시 "dev.mext/approval"). 재시도 라운드에도 같은 값 */
+    meta?: Record<string, unknown>;
 }
 /** HTTP 401. challenge = WWW-Authenticate 파싱 결과, data = JSON-RPC error.data (mext 는 UNAUTHENTICATED toJSON) */
 export declare class RemoteUnauthorizedError extends Error {
@@ -103,9 +106,31 @@ export interface ToolsListResult {
     ttlMs?: number;
     cacheScope?: string;
 }
+/** subscriptions/listen 스트림 종료. client = close · signal, server = 완료 result · 스트림 끝, error = 연결 오류 · JSON-RPC 오류 */
+export type ListenEnd = {
+    reason: "client";
+} | {
+    reason: "server";
+} | {
+    reason: "error";
+    error: unknown;
+};
+/** ack 를 받은 subscriptions/listen 스트림 */
+export interface RemoteListen {
+    /** ack (notifications/subscriptions/acknowledged) 의 notifications. ack 없이 완료 = {} */
+    readonly acknowledged: Record<string, unknown>;
+    /** 스트림 종료 (reject 하지 않는다) */
+    readonly done: Promise<ListenEnd>;
+    close(): void;
+}
 export interface RemoteClient {
     readonly url: string;
     request(method: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * subscriptions/listen. ack 까지 기다린 뒤 스트림을 계속 읽는다 (알림 = onNotification).
+     * ack 전 실패 = reject (401 · JSON-RPC 오류 · 연결 실패 · ack 전 abort = signal.reason)
+     */
+    listen(notifications: Record<string, unknown>, options?: RequestOptions): Promise<RemoteListen>;
     listTools(options?: RequestOptions): Promise<RemoteTool[]>;
     listToolsResult(options?: RequestOptions): Promise<ToolsListResult>;
     callTool(tool: RemoteTool, args: Record<string, unknown>, options?: CallToolOptions): Promise<CallToolResult>;

package/dist/remote/client.js

@@ -1,11 +1,12 @@
-import { VERSION } from "../version.js";
+import { VERSION } from "../version-constant.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 가 담당.
  * tasks 확장 (§12.6) 선언: tools/call 이 CreateTaskResult (resultType "task") 를 그대로 돌려주고, 폴링 · 답 · 취소 =
- * getTask · updateTask · cancelTask (Mcp-Name = taskId). 폴링 루프는 client/task.ts
+ * getTask · updateTask · cancelTask (Mcp-Name = taskId). 폴링 루프는 client/task.ts.
+ * subscriptions/listen (mext.md §12.5) = listen: 응답 SSE 를 ack 뒤에도 계속 읽는다 (타입 client subscribe)
  */
 export const PROTOCOL_VERSION = "2026-07-28";
 export const META_KEYS = {
@@ -66,7 +67,8 @@ 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 = {}) => {
+    /** POST 1회. 401 = RemoteUnauthorizedError. 응답 본문은 호출자가 읽는다 */
+    const send = async (method, params, opts, extraHeaders) => {
         const id = nextId++;
         const meta = {
             ...(isRecord(params._meta) ? params._meta : {}),
@@ -101,20 +103,114 @@ export function createRemoteClient(options) {
                 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 { res, id };
+    };
+    const request = async (method, params = {}, opts = {}, extraHeaders = {}) => {
+        const { res, id } = await send(method, params, opts, extraHeaders);
+        if (isEventStream(res)) {
             return handleMessage(await readSse(res, id, opts), id, res.status);
         }
+        return handleMessage(await jsonMessage(res), id, res.status);
+    };
+    const jsonMessage = async (res) => {
         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);
+        return payload;
+    };
+    const listen = async (notifications, opts = {}) => {
+        const { signal } = opts;
+        signal?.throwIfAborted();
+        const { res, id } = await send("subscriptions/listen", { notifications }, opts, {});
+        if (!isEventStream(res)) {
+            // JSON 응답 = 오류 (handleMessage 가 던진다) 또는 ack 없는 완료
+            handleMessage(await jsonMessage(res), id, res.status);
+            return { acknowledged: {}, done: Promise.resolve({ reason: "server" }), close() { } };
+        }
+        const stream = sseStream(res);
+        let closed = false;
+        const close = () => {
+            if (closed)
+                return;
+            closed = true;
+            void stream.cancel();
+        };
+        signal?.addEventListener("abort", close, { once: true });
+        const notify = (message) => {
+            try {
+                opts.onNotification?.(message.method, isRecord(message.params) ? message.params : {});
+            }
+            catch {
+                // 수신자 예외는 스트림에 영향 없음
+            }
+        };
+        // ack 까지. 그 전의 완료 result = ack 없는 완료, 오류 = reject
+        let acknowledged;
+        try {
+            while (acknowledged === undefined) {
+                const message = await stream.next();
+                if (message === undefined)
+                    throw new RemoteTransportError("Event stream ended before subscriptions/listen was acknowledged.");
+                if (message.method === "notifications/subscriptions/acknowledged") {
+                    const params = isRecord(message.params) ? message.params : {};
+                    acknowledged = isRecord(params.notifications) ? params.notifications : {};
+                }
+                else if (isNotification(message))
+                    notify(message);
+                else if (message.id === id) {
+                    handleMessage(message, id, res.status);
+                    signal?.removeEventListener("abort", close);
+                    await stream.cancel();
+                    return { acknowledged: {}, done: Promise.resolve({ reason: "server" }), close() { } };
+                }
+            }
+        }
+        catch (error) {
+            signal?.removeEventListener("abort", close);
+            await stream.cancel();
+            if (signal?.aborted)
+                throw signal.reason;
+            throw error;
+        }
+        const done = (async () => {
+            try {
+                for (;;) {
+                    let message;
+                    try {
+                        message = await stream.next();
+                    }
+                    catch (error) {
+                        return closed ? { reason: "client" } : { reason: "error", error };
+                    }
+                    if (closed)
+                        return { reason: "client" };
+                    if (message === undefined)
+                        return { reason: "server" };
+                    if (isNotification(message))
+                        notify(message);
+                    else if (message.id === id) {
+                        try {
+                            handleMessage(message, id, res.status);
+                            return { reason: "server" };
+                        }
+                        catch (error) {
+                            return { reason: "error", error };
+                        }
+                    }
+                }
+            }
+            finally {
+                signal?.removeEventListener("abort", close);
+                await stream.cancel();
+            }
+        })();
+        return { acknowledged, done, close };
     };
     const handleMessage = (message, id, status) => {
         if (!isRecord(message))
@@ -154,8 +250,9 @@ export function createRemoteClient(options) {
     const callTool = async (tool, args, opts = {}) => {
         const headers = { "Mcp-Name": tool.name, ...paramHeaders(tool, args) };
         let retry = {};
+        const meta = opts.meta ? { _meta: opts.meta } : {};
         for (let round = 0;; round++) {
-            const result = await request("tools/call", { name: tool.name, arguments: args, ...retry }, opts, headers);
+            const result = await request("tools/call", { name: tool.name, arguments: args, ...retry, ...meta }, opts, headers);
             if (result.resultType !== "input_required")
                 return result;
             const required = {};
@@ -182,6 +279,7 @@ export function createRemoteClient(options) {
     return {
         url: options.url,
         request: (method, params, opts) => request(method, params, opts),
+        listen,
         listTools: async (opts) => (await listToolsResult(opts)).tools,
         listToolsResult,
         callTool,
@@ -211,77 +309,104 @@ function paramHeaders(tool, args) {
     return out;
 }
 /* SSE */
+function isEventStream(res) {
+    return (res.headers.get("content-type") ?? "").includes("text/event-stream");
+}
+function isNotification(message) {
+    return typeof message.method === "string" && message.id === undefined;
+}
 /** 응답 스트림에서 id 의 응답 메시지가 올 때까지 읽는다. 알림은 콜백, 응답 후 스트림을 닫는다 */
 async function readSse(res, id, opts) {
+    const stream = sseStream(res);
+    try {
+        for (let message = await stream.next(); message !== undefined; message = await stream.next()) {
+            if (isNotification(message)) {
+                try {
+                    opts.onNotification?.(message.method, isRecord(message.params) ? message.params : {});
+                }
+                catch {
+                    // 표시 오류는 응답에 영향 없음
+                }
+                continue;
+            }
+            if (message.id === id && ("result" in message || "error" in message))
+                return message;
+        }
+    }
+    finally {
+        await stream.cancel();
+    }
+    if (opts.signal?.aborted)
+        throw opts.signal.reason;
+    throw new RemoteTransportError("Event stream ended without a response.");
+}
+function sseStream(res) {
     if (!res.body)
         throw new RemoteTransportError("Empty event stream.");
     const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
     let buffer = "";
     let data = [];
+    let ended = false;
     const dispatch = () => {
         if (data.length === 0)
             return undefined;
         const text = data.join("\n");
         data = [];
-        let message;
         try {
-            message = JSON.parse(text);
+            const message = JSON.parse(text);
+            return isRecord(message) ? message : undefined;
         }
         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 {
-                // 표시 오류는 응답에 영향 없음
+    };
+    /** buffer 의 완성된 줄을 처리. 이벤트 경계에서 메시지가 나오면 그 메시지 */
+    const drain = () => {
+        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;
             }
-            return undefined;
+            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);
         }
-        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;
+    return {
+        async next() {
+            for (;;) {
+                const found = drain();
+                if (found !== undefined)
+                    return found;
+                if (ended)
+                    return undefined;
+                const { done, value } = await reader.read();
+                if (done) {
+                    ended = true;
+                    return dispatch();
                 }
-                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);
+                buffer += 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 cancel() {
+            ended = true;
+            buffer = "";
+            data = [];
+            await reader.cancel().catch(() => { });
+        },
+    };
 }
 async function readJson(res) {
     const text = await res.text().catch(() => "");