@obov/mext 0.5.0 → 0.6.0

package/dist/cli/types.js

@@ -0,0 +1,77 @@
+import { relative } from "node:path";
+import { loadConfig, resolveCommandsDir } from "../config.js";
+import { resolveTypesPath, TYPES_FILE, writeTypes } from "../typegen.js";
+import { table } from "./help.js";
+import { EXIT, exitCodeOf, formatError } from "./output.js";
+export const TYPES_PROG = "mext types";
+/**
+ * mext types [--out <path>] [--check] — 명령어 타입 생성 (specs/client.md §4).
+ * 위치 = --out > mext.config.ts types > ./mext.gen.ts. types 설정이 없어도 동작한다.
+ * --check = 쓰지 않고 비교, 다르거나 없으면 exit 1
+ */
+export async function typesCommand(argv, io) {
+    let out;
+    let check = false;
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (tok === "--help" || tok === "-h") {
+            io.stdout.write(typesHelp());
+            return EXIT.ok;
+        }
+        if (tok === "--check") {
+            check = true;
+            continue;
+        }
+        if (tok === "--out" || tok.startsWith("--out=")) {
+            const value = tok === "--out" ? argv[++i] : tok.slice("--out=".length);
+            if (value === undefined || value === "")
+                return usage(io, "--out requires a path");
+            out = value;
+            continue;
+        }
+        return usage(io, tok.startsWith("-") ? `unknown flag ${tok}` : `unexpected argument "${tok}"`);
+    }
+    try {
+        const config = await loadConfig(io.cwd);
+        const path = resolveTypesPath(io.cwd, config.types, out, TYPES_FILE);
+        const result = writeTypes(resolveCommandsDir(io.cwd, config), path, { check });
+        const shown = relative(io.cwd, result.path) || result.path;
+        const n = `${result.commands} command${result.commands === 1 ? "" : "s"}`;
+        if (check && result.changed) {
+            io.stderr.write(`error: ${shown} is out of date. Run "${TYPES_PROG}" and commit the result.\n`);
+            return EXIT.error;
+        }
+        io.stdout.write(check ? `${shown} is up to date (${n})\n` : `${result.changed ? "Wrote" : "Unchanged"} ${shown} (${n})\n`);
+        return EXIT.ok;
+    }
+    catch (error) {
+        io.stderr.write(formatError(error, TYPES_PROG));
+        return exitCodeOf(error);
+    }
+}
+function usage(io, message) {
+    io.stderr.write(`error: ${message}\nRun "${TYPES_PROG} --help" for usage.\n`);
+    return EXIT.usage;
+}
+export function typesHelp() {
+    const lines = [
+        'Generate command types for the typed client (createClient<Commands>() from "@obov/mext/client").',
+        "",
+        "Usage:",
+        `  ${TYPES_PROG} [--out <path>] [--check]`,
+        "",
+        "The generated file maps each command ID to the types of its command module. Input and output types follow",
+        "the command definitions; regenerate only after adding, removing or renaming a command file.",
+        "",
+        "Flags:",
+        ...table([
+            ["--out <path>", `Output file (default: mext.config.ts types, or ./${TYPES_FILE})`],
+            ["--check", "Do not write; exit 1 when the file is missing or out of date (CI)"],
+            ["-h, --help", "Show help"],
+        ]).map((l) => `  ${l}`),
+        "",
+        'mext dev and mext build regenerate the file when mext.config.ts sets types (true or a path).',
+    ];
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"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","sourcesContent":["import { relative } from \"node:path\"\nimport { loadConfig, resolveCommandsDir } from \"../config.ts\"\nimport { resolveTypesPath, TYPES_FILE, writeTypes } from \"../typegen.ts\"\nimport { table } from \"./help.ts\"\nimport type { CliIo } from \"./io.ts\"\nimport { EXIT, exitCodeOf, formatError } from \"./output.ts\"\n\nexport const TYPES_PROG = \"mext types\"\n\n/**\n * mext types [--out <path>] [--check] — 명령어 타입 생성 (specs/client.md §4).\n * 위치 = --out > mext.config.ts types > ./mext.gen.ts. types 설정이 없어도 동작한다.\n * --check = 쓰지 않고 비교, 다르거나 없으면 exit 1\n */\nexport async function typesCommand(argv: readonly string[], io: CliIo): Promise<number> {\n  let out: string | undefined\n  let check = false\n  for (let i = 0; i < argv.length; i++) {\n    const tok = argv[i]!\n    if (tok === \"--help\" || tok === \"-h\") {\n      io.stdout.write(typesHelp())\n      return EXIT.ok\n    }\n    if (tok === \"--check\") {\n      check = true\n      continue\n    }\n    if (tok === \"--out\" || tok.startsWith(\"--out=\")) {\n      const value = tok === \"--out\" ? argv[++i] : tok.slice(\"--out=\".length)\n      if (value === undefined || value === \"\") return usage(io, \"--out requires a path\")\n      out = value\n      continue\n    }\n    return usage(io, tok.startsWith(\"-\") ? `unknown flag ${tok}` : `unexpected argument \"${tok}\"`)\n  }\n  try {\n    const config = await loadConfig(io.cwd)\n    const path = resolveTypesPath(io.cwd, config.types, out, TYPES_FILE)!\n    const result = writeTypes(resolveCommandsDir(io.cwd, config), path, { check })\n    const shown = relative(io.cwd, result.path) || result.path\n    const n = `${result.commands} command${result.commands === 1 ? \"\" : \"s\"}`\n    if (check && result.changed) {\n      io.stderr.write(`error: ${shown} is out of date. Run \"${TYPES_PROG}\" and commit the result.\\n`)\n      return EXIT.error\n    }\n    io.stdout.write(check ? `${shown} is up to date (${n})\\n` : `${result.changed ? \"Wrote\" : \"Unchanged\"} ${shown} (${n})\\n`)\n    return EXIT.ok\n  } catch (error) {\n    io.stderr.write(formatError(error, TYPES_PROG))\n    return exitCodeOf(error)\n  }\n}\n\nfunction usage(io: CliIo, message: string): number {\n  io.stderr.write(`error: ${message}\\nRun \"${TYPES_PROG} --help\" for usage.\\n`)\n  return EXIT.usage\n}\n\nexport function typesHelp(): string {\n  const lines = [\n    'Generate command types for the typed client (createClient<Commands>() from \"@obov/mext/client\").',\n    \"\",\n    \"Usage:\",\n    `  ${TYPES_PROG} [--out <path>] [--check]`,\n    \"\",\n    \"The generated file maps each command ID to the types of its command module. Input and output types follow\",\n    \"the command definitions; regenerate only after adding, removing or renaming a command file.\",\n    \"\",\n    \"Flags:\",\n    ...table([\n      [\"--out <path>\", `Output file (default: mext.config.ts types, or ./${TYPES_FILE})`],\n      [\"--check\", \"Do not write; exit 1 when the file is missing or out of date (CI)\"],\n      [\"-h, --help\", \"Show help\"],\n    ]).map((l) => `  ${l}`),\n    \"\",\n    'mext dev and mext build regenerate the file when mext.config.ts sets types (true or a path).',\n  ]\n  return `${lines.join(\"\\n\")}\\n`\n}\n"]}

package/dist/client/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @obov/mext/client — 타입 client (specs/client.md). 브라우저 · Node.js · Bun.
+ * 이 entry 의 import 그래프에는 Node 내장 모듈 · Zod · MCP 서버 SDK · 핸들러 코드가 없다 (타입 import 는 지워진다).
+ * 같은 폴더의 main.ts · runner.ts · cache.ts (고객 CLI 런타임, Node 전용) 는 여기서 export 하지 않는다
+ */
+export { APPROVAL_META_KEY, CallError, createClient, isCallError } from "./typed.ts";
+export type { MextClient } from "./typed.ts";
+export type { AnyCommands, CallArgs, CallOptions, ClientOptions, CommandInfo, CommandList, CommandMap, CommandShape, CommandSummary, CommandTypes, InputAnswer, InputOf, InputRequestInfo, JsonSchema, Jsonify, NamespaceSummary, OutputOf, ProgressUpdate, RequestOptions, SafeResult, ServerInfo, TaskHandle, TaskStatus, } from "./types.ts";
+export type { ToolExposure } from "../mcp/dispatch.ts";
+export type { Help } from "../mcp/help.ts";

package/dist/client/index.js

@@ -0,0 +1,7 @@
+/**
+ * @obov/mext/client — 타입 client (specs/client.md). 브라우저 · Node.js · Bun.
+ * 이 entry 의 import 그래프에는 Node 내장 모듈 · Zod · MCP 서버 SDK · 핸들러 코드가 없다 (타입 import 는 지워진다).
+ * 같은 폴더의 main.ts · runner.ts · cache.ts (고객 CLI 런타임, Node 전용) 는 여기서 export 하지 않는다
+ */
+export { APPROVAL_META_KEY, CallError, createClient, isCallError } from "./typed.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA","sourcesContent":["/**\n * @obov/mext/client — 타입 client (specs/client.md). 브라우저 · Node.js · Bun.\n * 이 entry 의 import 그래프에는 Node 내장 모듈 · Zod · MCP 서버 SDK · 핸들러 코드가 없다 (타입 import 는 지워진다).\n * 같은 폴더의 main.ts · runner.ts · cache.ts (고객 CLI 런타임, Node 전용) 는 여기서 export 하지 않는다\n */\nexport { APPROVAL_META_KEY, CallError, createClient, isCallError } from \"./typed.ts\"\nexport type { MextClient } from \"./typed.ts\"\nexport type {\n  AnyCommands,\n  CallArgs,\n  CallOptions,\n  ClientOptions,\n  CommandInfo,\n  CommandList,\n  CommandMap,\n  CommandShape,\n  CommandSummary,\n  CommandTypes,\n  InputAnswer,\n  InputOf,\n  InputRequestInfo,\n  JsonSchema,\n  Jsonify,\n  NamespaceSummary,\n  OutputOf,\n  ProgressUpdate,\n  RequestOptions,\n  SafeResult,\n  ServerInfo,\n  TaskHandle,\n  TaskStatus,\n} from \"./types.ts\"\nexport type { ToolExposure } from \"../mcp/dispatch.ts\"\nexport type { Help } from \"../mcp/help.ts\"\n"]}

package/dist/client/manifest.js

@@ -8,7 +8,8 @@ export function clientManifest(manifest) {
         ...(manifest.tools !== undefined ? { tools: manifest.tools } : {}),
         namespaces: manifest.namespaces.map((n) => ({ ...n })),
         commands: manifest.commands.map((c) => {
-            const { file: _file, module: _module, ...rest } = c;
+            // expose = 서버 판정용 (내장 manifest 는 이미 mcp 표면 기준으로 걸러진 목록)
+            const { file: _file, module: _module, expose: _expose, ...rest } = c;
             return rest;
         }),
     };
@@ -41,6 +42,8 @@ export function manifestFromTools(tools) {
             examples: Array.isArray(meta.examples) ? [...meta.examples] : [],
             inputSchema: tool.inputSchema ?? { type: "object" },
         };
+        if (meta.needsApproval === "conditional")
+            command.needsApproval = "conditional";
         if (isRecord(tool.outputSchema))
             command.outputSchema = tool.outputSchema;
         if (isRecord(meta.task) && typeof meta.task.ttlMs === "number")
@@ -97,6 +100,7 @@ function commandSummary(c) {
         readOnly: c.readOnly,
         destructive: c.destructive,
         requiresConfirmation: c.requiresConfirmation,
+        ...(c.needsApproval !== undefined ? { needsApproval: c.needsApproval } : {}),
     };
 }
 /** mcp/help.ts commandHelp 와 같은 errors 규칙 */
@@ -104,7 +108,7 @@ function commandHelp(c) {
     const errors = ["INVALID_ARGUMENT"];
     if (!c.readOnly || c.scopes.length > 0)
         errors.push("UNAUTHENTICATED", "PERMISSION_DENIED");
-    if (c.requiresConfirmation)
+    if (c.requiresConfirmation || c.needsApproval !== undefined)
         errors.push("INPUT_UNAVAILABLE", "INPUT_DECLINED");
     return { kind: "command", ...c, errors };
 }

package/dist/client/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/client/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { parentNamespace } from \"../ids.ts\"\nimport { COMMAND_META_KEY } from \"../mcp/constants.ts\"\nimport { isRecord, type RemoteTool } from \"../remote/client.ts\"\nimport { unknownCommand } from \"../lookup.ts\"\nimport type { Manifest, ManifestCommand, ManifestNamespace } from \"../manifest.ts\"\nimport type { ToolExposure } from \"../mcp/dispatch.ts\"\nimport type { CommandHelp, Help, HelpCommandSummary, HelpNamespaceSummary, NamespaceHelp, RootHelp } from \"../mcp/help.ts\"\n\n/**\n * 고객 CLI 번들 형태의 내장 manifest = 빌드 manifest 에서 서버 전용 항목 (file · module · 빌드 경로) 을 뺀 것.\n * help 결과는 서버 help (mcp/help.ts help()) 와 같은 모양 (split 노출의 tool 필드 제외)\n */\n\nexport type ClientManifestCommand = Omit<ManifestCommand, \"file\">\n\nexport interface ClientManifest {\n  /** 서버 도구 노출 방식 (빌드 manifest tools). command = 명령어 ID 를 도구 이름으로 호출. 없음 = dispatcher (execute · split) */\n  tools?: ToolExposure\n  /** commands/_index.md */\n  description?: string\n  /** 루트 제외, ID 순 */\n  namespaces: ManifestNamespace[]\n  /** ID 순 */\n  commands: ClientManifestCommand[]\n}\n\n/** 빌드 manifest → 내장 manifest (mext build 가 호출) */\nexport function clientManifest(\n  manifest: Pick<Manifest, \"description\" | \"namespaces\" | \"commands\"> & { tools?: ToolExposure },\n): ClientManifest {\n  const out: ClientManifest = {\n    ...(manifest.tools !== undefined ? { tools: manifest.tools } : {}),\n    namespaces: manifest.namespaces.map((n) => ({ ...n })),\n    commands: manifest.commands.map((c) => {\n      const { file: _file, module: _module, ...rest } = c as ManifestCommand & { module?: string }\n      return rest\n    }),\n  }\n  if (manifest.description !== undefined) out.description = manifest.description\n  return out\n}\n\n/**\n * command 노출 서버의 tools/list → manifest (범용 형태 · stale 번들의 help · 플래그 파싱, §12.2).\n * 명령어 = 도구 (이름 = ID · description · inputSchema · outputSchema) + _meta[COMMAND_META_KEY] (별칭 · 안전성 · scopes ·\n * positional · examples · task, 없으면 annotations 의 readOnlyHint · destructiveHint). 네임스페이스 = ID 의 상위 경로 (설명 없음)\n */\nexport function manifestFromTools(tools: readonly RemoteTool[]): ClientManifest {\n  const commands: ClientManifestCommand[] = []\n  const namespaces = new Set<string>()\n  for (const tool of tools) {\n    const meta = isRecord(tool._meta) && isRecord(tool._meta[COMMAND_META_KEY]) ? tool._meta[COMMAND_META_KEY] : {}\n    const hints = isRecord(tool.annotations) ? tool.annotations : {}\n    const flag = (key: string, hint: unknown): boolean => (typeof meta[key] === \"boolean\" ? meta[key] : hint === true)\n    const strings = (key: string): string[] =>\n      Array.isArray(meta[key]) ? meta[key].filter((v): v is string => typeof v === \"string\") : []\n    const command: ClientManifestCommand = {\n      id: tool.name,\n      description: tool.description ?? \"\",\n      aliases: strings(\"aliases\"),\n      readOnly: flag(\"readOnly\", hints.readOnlyHint),\n      destructive: flag(\"destructive\", hints.readOnlyHint === true ? false : hints.destructiveHint),\n      requiresConfirmation: flag(\"requiresConfirmation\", false),\n      scopes: strings(\"scopes\"),\n      positional: strings(\"positional\"),\n      examples: Array.isArray(meta.examples) ? [...meta.examples] : [],\n      inputSchema: tool.inputSchema ?? { type: \"object\" },\n    }\n    if (isRecord(tool.outputSchema)) command.outputSchema = tool.outputSchema\n    if (isRecord(meta.task) && typeof meta.task.ttlMs === \"number\") command.task = { ttlMs: meta.task.ttlMs }\n    commands.push(command)\n    for (let ns = parentNamespace(tool.name); ns !== \"\"; ns = parentNamespace(ns)) namespaces.add(ns)\n  }\n  const byId = (a: { id: string }, b: { id: string }) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)\n  return {\n    tools: \"command\",\n    namespaces: [...namespaces].map((id) => ({ id })).sort(byId),\n    commands: commands.sort(byId),\n  }\n}\n\n/** 내장 manifest 의 help (target \"\" = 루트 · 네임스페이스 · 명령어 ID · 별칭). 없는 target = UNKNOWN_COMMAND */\nexport function manifestHelp(manifest: ClientManifest, target: string): Help {\n  const id = target.trim()\n  const namespaces = new Map(manifest.namespaces.map((n) => [n.id, n]))\n  const children = (ns: string) => ({\n    namespaces: manifest.namespaces.filter((n) => parentNamespace(n.id) === ns).map(namespaceSummary),\n    commands: manifest.commands.filter((c) => parentNamespace(c.id) === ns).map(commandSummary),\n  })\n  // 키 순서 = 서버 help (--help --json 출력이 같은 텍스트)\n  if (id === \"\") {\n    const out: RootHelp = { kind: \"root\", ...children(\"\") }\n    if (manifest.description !== undefined) out.description = manifest.description\n    return out\n  }\n  const ns = namespaces.get(id)\n  if (ns) {\n    const out: NamespaceHelp = { kind: \"namespace\", id, ...children(id) }\n    if (ns.description !== undefined) out.description = ns.description\n    const self = manifest.commands.find((c) => c.id === id)\n    if (self) out.command = commandHelp(self)\n    return out\n  }\n  const command = manifest.commands.find((c) => c.id === id) ?? manifest.commands.find((c) => c.aliases.includes(id))\n  if (command) return commandHelp(command)\n  throw unknownCommand(\n    id,\n    manifest.commands.flatMap((c): [string, string][] => [[c.id, c.id], ...c.aliases.map((a): [string, string] => [a, c.id])]),\n    (n) => namespaces.has(n),\n  )\n}\n\nfunction namespaceSummary(ns: ManifestNamespace): HelpNamespaceSummary {\n  const first = ns.description?.split(\"\\n\").find((l) => l.trim() !== \"\")\n  return first === undefined ? { id: ns.id } : { id: ns.id, description: first.replace(/^#+\\s*/, \"\").trim() }\n}\n\nfunction commandSummary(c: ClientManifestCommand): HelpCommandSummary {\n  return {\n    id: c.id,\n    description: c.description,\n    readOnly: c.readOnly,\n    destructive: c.destructive,\n    requiresConfirmation: c.requiresConfirmation,\n  }\n}\n\n/** mcp/help.ts commandHelp 와 같은 errors 규칙 */\nfunction commandHelp(c: ClientManifestCommand): CommandHelp {\n  const errors = [\"INVALID_ARGUMENT\"]\n  if (!c.readOnly || c.scopes.length > 0) errors.push(\"UNAUTHENTICATED\", \"PERMISSION_DENIED\")\n  if (c.requiresConfirmation) errors.push(\"INPUT_UNAVAILABLE\", \"INPUT_DECLINED\")\n  return { kind: \"command\", ...c, errors }\n}\n"]}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/client/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { parentNamespace } from \"../ids.ts\"\nimport { COMMAND_META_KEY } from \"../mcp/constants.ts\"\nimport { isRecord, type RemoteTool } from \"../remote/client.ts\"\nimport { unknownCommand } from \"../lookup.ts\"\nimport type { Manifest, ManifestCommand, ManifestNamespace } from \"../manifest.ts\"\nimport type { ToolExposure } from \"../mcp/dispatch.ts\"\nimport type { CommandHelp, Help, HelpCommandSummary, HelpNamespaceSummary, NamespaceHelp, RootHelp } from \"../mcp/help.ts\"\n\n/**\n * 고객 CLI 번들 형태의 내장 manifest = 빌드 manifest 에서 서버 전용 항목 (file · module · 빌드 경로) 을 뺀 것.\n * help 결과는 서버 help (mcp/help.ts help()) 와 같은 모양 (split 노출의 tool 필드 제외)\n */\n\nexport type ClientManifestCommand = Omit<ManifestCommand, \"file\">\n\nexport interface ClientManifest {\n  /** 서버 도구 노출 방식 (빌드 manifest tools). command = 명령어 ID 를 도구 이름으로 호출. 없음 = dispatcher (execute · split) */\n  tools?: ToolExposure\n  /** commands/_index.md */\n  description?: string\n  /** 루트 제외, ID 순 */\n  namespaces: ManifestNamespace[]\n  /** ID 순 */\n  commands: ClientManifestCommand[]\n}\n\n/** 빌드 manifest → 내장 manifest (mext build 가 호출) */\nexport function clientManifest(\n  manifest: Pick<Manifest, \"description\" | \"namespaces\" | \"commands\"> & { tools?: ToolExposure },\n): ClientManifest {\n  const out: ClientManifest = {\n    ...(manifest.tools !== undefined ? { tools: manifest.tools } : {}),\n    namespaces: manifest.namespaces.map((n) => ({ ...n })),\n    commands: manifest.commands.map((c) => {\n      // expose = 서버 판정용 (내장 manifest 는 이미 mcp 표면 기준으로 걸러진 목록)\n      const { file: _file, module: _module, expose: _expose, ...rest } = c as ManifestCommand & { module?: string; expose?: unknown }\n      return rest\n    }),\n  }\n  if (manifest.description !== undefined) out.description = manifest.description\n  return out\n}\n\n/**\n * command 노출 서버의 tools/list → manifest (범용 형태 · stale 번들의 help · 플래그 파싱, §12.2).\n * 명령어 = 도구 (이름 = ID · description · inputSchema · outputSchema) + _meta[COMMAND_META_KEY] (별칭 · 안전성 · scopes ·\n * positional · examples · task, 없으면 annotations 의 readOnlyHint · destructiveHint). 네임스페이스 = ID 의 상위 경로 (설명 없음)\n */\nexport function manifestFromTools(tools: readonly RemoteTool[]): ClientManifest {\n  const commands: ClientManifestCommand[] = []\n  const namespaces = new Set<string>()\n  for (const tool of tools) {\n    const meta = isRecord(tool._meta) && isRecord(tool._meta[COMMAND_META_KEY]) ? tool._meta[COMMAND_META_KEY] : {}\n    const hints = isRecord(tool.annotations) ? tool.annotations : {}\n    const flag = (key: string, hint: unknown): boolean => (typeof meta[key] === \"boolean\" ? meta[key] : hint === true)\n    const strings = (key: string): string[] =>\n      Array.isArray(meta[key]) ? meta[key].filter((v): v is string => typeof v === \"string\") : []\n    const command: ClientManifestCommand = {\n      id: tool.name,\n      description: tool.description ?? \"\",\n      aliases: strings(\"aliases\"),\n      readOnly: flag(\"readOnly\", hints.readOnlyHint),\n      destructive: flag(\"destructive\", hints.readOnlyHint === true ? false : hints.destructiveHint),\n      requiresConfirmation: flag(\"requiresConfirmation\", false),\n      scopes: strings(\"scopes\"),\n      positional: strings(\"positional\"),\n      examples: Array.isArray(meta.examples) ? [...meta.examples] : [],\n      inputSchema: tool.inputSchema ?? { type: \"object\" },\n    }\n    if (meta.needsApproval === \"conditional\") command.needsApproval = \"conditional\"\n    if (isRecord(tool.outputSchema)) command.outputSchema = tool.outputSchema\n    if (isRecord(meta.task) && typeof meta.task.ttlMs === \"number\") command.task = { ttlMs: meta.task.ttlMs }\n    commands.push(command)\n    for (let ns = parentNamespace(tool.name); ns !== \"\"; ns = parentNamespace(ns)) namespaces.add(ns)\n  }\n  const byId = (a: { id: string }, b: { id: string }) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)\n  return {\n    tools: \"command\",\n    namespaces: [...namespaces].map((id) => ({ id })).sort(byId),\n    commands: commands.sort(byId),\n  }\n}\n\n/** 내장 manifest 의 help (target \"\" = 루트 · 네임스페이스 · 명령어 ID · 별칭). 없는 target = UNKNOWN_COMMAND */\nexport function manifestHelp(manifest: ClientManifest, target: string): Help {\n  const id = target.trim()\n  const namespaces = new Map(manifest.namespaces.map((n) => [n.id, n]))\n  const children = (ns: string) => ({\n    namespaces: manifest.namespaces.filter((n) => parentNamespace(n.id) === ns).map(namespaceSummary),\n    commands: manifest.commands.filter((c) => parentNamespace(c.id) === ns).map(commandSummary),\n  })\n  // 키 순서 = 서버 help (--help --json 출력이 같은 텍스트)\n  if (id === \"\") {\n    const out: RootHelp = { kind: \"root\", ...children(\"\") }\n    if (manifest.description !== undefined) out.description = manifest.description\n    return out\n  }\n  const ns = namespaces.get(id)\n  if (ns) {\n    const out: NamespaceHelp = { kind: \"namespace\", id, ...children(id) }\n    if (ns.description !== undefined) out.description = ns.description\n    const self = manifest.commands.find((c) => c.id === id)\n    if (self) out.command = commandHelp(self)\n    return out\n  }\n  const command = manifest.commands.find((c) => c.id === id) ?? manifest.commands.find((c) => c.aliases.includes(id))\n  if (command) return commandHelp(command)\n  throw unknownCommand(\n    id,\n    manifest.commands.flatMap((c): [string, string][] => [[c.id, c.id], ...c.aliases.map((a): [string, string] => [a, c.id])]),\n    (n) => namespaces.has(n),\n  )\n}\n\nfunction namespaceSummary(ns: ManifestNamespace): HelpNamespaceSummary {\n  const first = ns.description?.split(\"\\n\").find((l) => l.trim() !== \"\")\n  return first === undefined ? { id: ns.id } : { id: ns.id, description: first.replace(/^#+\\s*/, \"\").trim() }\n}\n\nfunction commandSummary(c: ClientManifestCommand): HelpCommandSummary {\n  return {\n    id: c.id,\n    description: c.description,\n    readOnly: c.readOnly,\n    destructive: c.destructive,\n    requiresConfirmation: c.requiresConfirmation,\n    ...(c.needsApproval !== undefined ? { needsApproval: c.needsApproval } : {}),\n  }\n}\n\n/** mcp/help.ts commandHelp 와 같은 errors 규칙 */\nfunction commandHelp(c: ClientManifestCommand): CommandHelp {\n  const errors = [\"INVALID_ARGUMENT\"]\n  if (!c.readOnly || c.scopes.length > 0) errors.push(\"UNAUTHENTICATED\", \"PERMISSION_DENIED\")\n  if (c.requiresConfirmation || c.needsApproval !== undefined) errors.push(\"INPUT_UNAVAILABLE\", \"INPUT_DECLINED\")\n  return { kind: \"command\", ...c, errors }\n}\n"]}

package/dist/client/runner.js

@@ -1,5 +1,5 @@
 import { COMMAND } from "../command.js";
-import { MextError } from "../errors.js";
+import { inputDeclined, MextError } from "../errors.js";
 import { isSegment } from "../ids.js";
 import { createRemoteClient, isRecord, RemoteInputRequiredError, RemoteRpcError, RemoteTransportError, RemoteUnauthorizedError, } from "../remote/client.js";
 import { credentialStore, envPrefix } from "../remote/credentials.js";
@@ -9,7 +9,7 @@ import { cliPath, renderHelp } from "../cli/help.js";
 import { askUrl } from "../cli/ask-url.js";
 import { createLineReader, readAll } from "../cli/io.js";
 import { CliInterrupted, emitError, EXIT, errorJson, exitCodeOf, formatError, formatJson, formatProgress, formatResult, } from "../cli/output.js";
-import { MANIFEST_HASH_META_KEY, TOOLS_META_KEY } from "../mcp/constants.js";
+import { APPROVAL_META_KEY, MANIFEST_HASH_META_KEY, TOOLS_META_KEY } from "../mcp/constants.js";
 import { VERSION } from "../version.js";
 import { openSchema, schemaCacheDir, schemaCacheFile } from "./cache.js";
 import { manifestFromTools, manifestHelp } from "./manifest.js";
@@ -122,8 +122,10 @@ export async function runRemote(options, argv, io) {
         const input = planned.input;
         const args = exposed ? input : { command: entry.id, args: input };
         const onInputRequired = inputHandler(io, lines, yes, json, entry.id, controller.signal);
-        let result = await s.call((o) => s.client.callTool(tool, args, {
+        // 승인 (§4 승인 원격 CLI): --yes = 확인 표시 (client 방식 표면) + confirm 입력 요청 승인 (ask 방식, inputHandler)
+        const callOnce = (confirmed) => s.call((o) => s.client.callTool(tool, args, {
             ...o,
+            ...(confirmed ? { meta: { [APPROVAL_META_KEY]: { confirmed: true } } } : {}),
             progressToken: "mext-cli",
             onNotification: (method, params) => {
                 if (method !== "notifications/progress" || typeof params.progress !== "number")
@@ -137,6 +139,16 @@ export async function runRemote(options, argv, io) {
             },
             onInputRequired,
         }));
+        let result = await callOnce(yes);
+        // 확인 표시 없이 client 방식 표면에 닿음 = TTY 면 로컬 ask 와 같은 프롬프트 → 승인 = 확인 표시를 실어 1회 다시 호출
+        if (!yes && io.isTTY && approvalReason(result) === "unconfirmed") {
+            const answer = await lines.question(`${confirmationPrompt(command, input)} [y/N] `, controller.signal);
+            if (controller.signal.aborted)
+                throw new CliInterrupted();
+            if (!/^y(es)?$/i.test((answer ?? "").trim()))
+                throw inputDeclined(entry.id, "confirm");
+            result = await callOnce(true);
+        }
         // tasks 확장 (§12.6): 종료까지 폴링 → completed result = 동기 결과와 같은 경로 (출력 · exit code)
         if (isTaskResult(result)) {
             result = await awaitTask(result, {
@@ -172,6 +184,18 @@ export async function runRemote(options, argv, io) {
 async function exposureOf(options, schema) {
     return options.manifest ? options.manifest.tools : schema.exposure();
 }
+/** isError 결과가 APPROVAL_REQUIRED 면 그 reason (§4 승인) */
+function approvalReason(result) {
+    if (result.isError !== true)
+        return undefined;
+    const sc = result.structuredContent;
+    const body = isRecord(sc) && isRecord(sc.error) ? sc.error : undefined;
+    return body?.code === "APPROVAL_REQUIRED" && typeof body.reason === "string" ? body.reason : undefined;
+}
+/** 승인 프롬프트 문구. 로컬 ask (invoke.ts confirmationMessage) 와 같은 형식, 입력 = CLI 가 보낸 값 (invoke.ts 는 Zod 를 import 해 번들에 넣지 않는다) */
+function confirmationPrompt(command, input) {
+    return `Run ${command.id} with ${JSON.stringify(input)}?${command.destructive ? " This command is destructive." : ""}`;
+}
 /** 서버 help 재조회 대상 로컬 오류 */
 function isLocalParseFailure(error) {
     return error instanceof MextError && (error.code === "UNKNOWN_COMMAND" || error.code === "INVALID_ARGUMENT");
@@ -387,11 +411,16 @@ function commandOf(meta) {
         examples: [...(meta.examples ?? [])],
         positional: [...(meta.positional ?? [])],
         aliases: [],
+        // 조건부 승인 (help 의 needsApproval: "conditional") = help 렌더러용 자리 표시 (호출하지 않는다)
+        ...(meta.needsApproval === "conditional" ? { needsApproval: remoteOnly } : {}),
         execute() {
             throw new Error("remote command");
         },
     };
 }
+function remoteOnly() {
+    throw new Error("remote command");
+}
 /** 원격 명령어 help → RegisteredCommand (CLI 필드 = inputSchema 분석) */
 export function entryFromHelp(help) {
     const entry = {
@@ -458,6 +487,7 @@ const MEXT_CODES = [
     "UNAUTHENTICATED",
     "PERMISSION_DENIED",
     "INPUT_UNAVAILABLE",
+    "APPROVAL_REQUIRED",
 ];
 /** 서버 핸들러 예외 등 mext 구조화 오류 외의 도구 오류. --json = 서버 오류 본문 그대로, exit 1 */
 export class RemoteExecutionError extends Error {
@@ -511,6 +541,10 @@ function report(error, io, prog, json, ctx) {
         if (reason === "anonymous")
             text += `Run "${ctx.login}" to log in.\n`;
     }
+    // 확인 표시 없이 거부 (TTY 없음): 로컬 ask 의 안내와 같은 문구
+    if (e instanceof MextError && e.code === "APPROVAL_REQUIRED" && e.details.reason === "unconfirmed") {
+        text += "Pass --yes to approve.\n";
+    }
     return emitError(io, { body: errorBody(e), text, exitCode: exitCodeOf(e), json }, ctx.formatter);
 }
 function errorBody(error) {