@obov/mext 0.0.0-stage → 0.1.0

package/dist/client/manifest.js

@@ -0,0 +1,68 @@
+import { parentNamespace } from "../ids.js";
+import { unknownCommand } from "../lookup.js";
+/** 빌드 manifest → 내장 manifest (mext build 가 호출) */
+export function clientManifest(manifest) {
+    const out = {
+        namespaces: manifest.namespaces.map((n) => ({ ...n })),
+        commands: manifest.commands.map((c) => {
+            const { file: _file, module: _module, ...rest } = c;
+            return rest;
+        }),
+    };
+    if (manifest.description !== undefined)
+        out.description = manifest.description;
+    return out;
+}
+/** 내장 manifest 의 help (target "" = 루트 · 네임스페이스 · 명령어 ID · 별칭). 없는 target = UNKNOWN_COMMAND */
+export function manifestHelp(manifest, target) {
+    const id = target.trim();
+    const namespaces = new Map(manifest.namespaces.map((n) => [n.id, n]));
+    const children = (ns) => ({
+        namespaces: manifest.namespaces.filter((n) => parentNamespace(n.id) === ns).map(namespaceSummary),
+        commands: manifest.commands.filter((c) => parentNamespace(c.id) === ns).map(commandSummary),
+    });
+    // 키 순서 = 서버 help (--help --json 출력이 같은 텍스트)
+    if (id === "") {
+        const out = { kind: "root", ...children("") };
+        if (manifest.description !== undefined)
+            out.description = manifest.description;
+        return out;
+    }
+    const ns = namespaces.get(id);
+    if (ns) {
+        const out = { kind: "namespace", id, ...children(id) };
+        if (ns.description !== undefined)
+            out.description = ns.description;
+        const self = manifest.commands.find((c) => c.id === id);
+        if (self)
+            out.command = commandHelp(self);
+        return out;
+    }
+    const command = manifest.commands.find((c) => c.id === id) ?? manifest.commands.find((c) => c.aliases.includes(id));
+    if (command)
+        return commandHelp(command);
+    throw unknownCommand(id, manifest.commands.flatMap((c) => [[c.id, c.id], ...c.aliases.map((a) => [a, c.id])]), (n) => namespaces.has(n));
+}
+function namespaceSummary(ns) {
+    const first = ns.description?.split("\n").find((l) => l.trim() !== "");
+    return first === undefined ? { id: ns.id } : { id: ns.id, description: first.replace(/^#+\s*/, "").trim() };
+}
+function commandSummary(c) {
+    return {
+        id: c.id,
+        description: c.description,
+        readOnly: c.readOnly,
+        destructive: c.destructive,
+        requiresConfirmation: c.requiresConfirmation,
+    };
+}
+/** mcp/help.ts commandHelp 와 같은 errors 규칙 */
+function commandHelp(c) {
+    const errors = ["INVALID_ARGUMENT"];
+    if (!c.readOnly || c.scopes.length > 0)
+        errors.push("UNAUTHENTICATED", "PERMISSION_DENIED");
+    if (c.requiresConfirmation)
+        errors.push("INPUT_UNAVAILABLE", "INPUT_DECLINED");
+    return { kind: "command", ...c, errors };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/client/manifest.js.map

@@ -0,0 +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 { unknownCommand } from \"../lookup.ts\"\nimport type { Manifest, ManifestCommand, ManifestNamespace } from \"../manifest.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  /** 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(manifest: Pick<Manifest, \"description\" | \"namespaces\" | \"commands\">): ClientManifest {\n  const out: ClientManifest = {\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/** 내장 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"]}

package/dist/client/runner.d.ts

@@ -0,0 +1,49 @@
+import type { CommandHelp, Help } from "../mcp/help.ts";
+import type { RegisteredCommand } from "../registry.ts";
+import { type CliIo } from "../cli/io.ts";
+import { type ClientManifest } from "./manifest.ts";
+/**
+ * 원격 실행 공용 runner: mext run --url (bin = mext) 과 고객 CLI (bin = cli.bin) 가 같은 코드 경로.
+ * 서버 MCP 엔드포인트의 dispatcher 도구 (execute · split 의 query · mutate) 호출. 권한 검사는 서버만.
+ * 경로 해석 · help · 플래그 파싱 = HelpSource (캐시 · 내장 manifest · 서버 help, client/cache.ts) 의 입력 스키마 (JSON Schema).
+ * 로컬 파싱 실패 (UNKNOWN_COMMAND · INVALID_ARGUMENT) = 서버 help 로 1회 재시도. tools/call 결과의 manifestHash 로 drift 감지.
+ * 토큰 = <BIN>_TOKEN, 없으면 저장된 토큰 (<bin> login). 출력 · exit code 는 로컬 모드와 같다.
+ *
+ * 이 모듈 (와 import 대상) 은 고객 CLI 번들에 들어간다: Zod · MCP 서버 SDK · 핸들러 · 스캔 · 빌드 코드 import 금지.
+ */
+export interface RemoteRunOptions {
+    /** 실행 파일 이름. 토큰 환경변수 (<BIN>_TOKEN) · 자격 증명 위치 (credentialStore bin) · clientInfo.name */
+    bin: string;
+    /** MCP 엔드포인트 */
+    url: string;
+    /** help · 오류 안내의 명령 접두. "mext run --url <url>" · "myapp" */
+    prog: string;
+    /** login 안내 명령. "mext login --url <url>" · "myapp login" */
+    login: string;
+    /** clientInfo.version */
+    version: string;
+    /**
+     * 번들 형태: 내장 manifest 로 help · 경로 해석 · 플래그 파싱 (help 에 네트워크 없음, 명령어 실행만 tools/list · tools/call).
+     * 없음 = 범용 형태: 서버 help 조회
+     */
+    manifest?: ClientManifest;
+    /** 내장 manifest 의 manifestHash (빌드 시). manifest 와 같이 지정 */
+    manifestHash?: string;
+    /** 사람용 루트 help 뒤에 붙일 텍스트 (고객 CLI 의 login · logout · mcp install 목록) */
+    rootHelpFooter?: string;
+}
+/** help 출처. 서버 (tools/list → dispatcher help 호출) · 내장 manifest · 스키마 캐시 (client/cache.ts Schema) */
+export interface HelpSource {
+    /** 대상 ("" = 루트) → help. 없는 대상 = MextError UNKNOWN_COMMAND */
+    help(target: string): Promise<Help>;
+}
+export declare function runRemote(options: RemoteRunOptions, argv: readonly string[], io: CliIo): Promise<number>;
+/** 번들 형태: 내장 manifest (네트워크 없음) */
+export declare function manifestHelpSource(manifest: ClientManifest): HelpSource;
+/** 원격 명령어 help → RegisteredCommand (CLI 필드 = inputSchema 분석) */
+export declare function entryFromHelp(help: CommandHelp): RegisteredCommand;
+/** 서버 핸들러 예외 등 mext 구조화 오류 외의 도구 오류. --json = 서버 오류 본문 그대로, exit 1 */
+export declare class RemoteExecutionError extends Error {
+    readonly body: Record<string, unknown>;
+    constructor(body: Record<string, unknown>);
+}