@kodiak-finance/orderly-sdk-docs 1.0.2

package/dist/mcp-cli.js

@@ -0,0 +1,424 @@
+#!/usr/bin/env node
+import {
+  createAiDocsFacade,
+  defaultClientAdapterRegistry,
+  errResult,
+  loadBundle
+} from "./chunk-EPLR7UGM.js";
+
+// src/mcp-cli.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/install/fs-write.ts
+import fs from "fs";
+import path from "path";
+function readJsonConfig(configPath) {
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  const rawText = fs.readFileSync(configPath, "utf8").trim();
+  if (!rawText) return {};
+  try {
+    const parsed = JSON.parse(rawText);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error("Root value must be an object");
+    }
+    return parsed;
+  } catch (error) {
+    throw new Error(
+      `Invalid JSON at ${configPath}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function writeJsonAtomic(configPath, data) {
+  const dir = path.dirname(configPath);
+  fs.mkdirSync(dir, { recursive: true });
+  const tempPath = `${configPath}.tmp`;
+  fs.writeFileSync(tempPath, `${JSON.stringify(data, null, 2)}
+`, "utf8");
+  fs.renameSync(tempPath, configPath);
+}
+function backupIfExists(configPath) {
+  if (!fs.existsSync(configPath)) return void 0;
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const backupPath = `${configPath}.${stamp}.bak`;
+  fs.copyFileSync(configPath, backupPath);
+  return backupPath;
+}
+
+// src/install/report.ts
+function printInstallReport(report, dryRun) {
+  const prefix = dryRun ? "[dry-run]" : "[install]";
+  for (const item of report.results) {
+    const backup = item.backupPath ? ` (backup: ${item.backupPath})` : "";
+    console.warn(
+      `${prefix} ${item.client}: ${item.action} -> ${item.path}${backup}`
+    );
+  }
+  if (report.errors.length > 0) {
+    for (const msg of report.errors) {
+      console.error(`${prefix} error: ${msg}`);
+    }
+  }
+}
+
+// src/install/spec.ts
+function buildServerEntry(opts) {
+  const v = opts.sdkDocsVersion?.trim();
+  const pkg = v ? `@orderly.network/sdk-docs@${v}` : "@orderly.network/sdk-docs";
+  return {
+    command: "npx",
+    args: ["-y", pkg, "orderly-sdk-docs-mcp"]
+  };
+}
+
+// src/install/install.command.ts
+var ALL_CLIENTS = ["claude", "codex", "cursor", "opencode"];
+function assertSafeSdkDocsVersionSpecifier(raw) {
+  if (!raw.trim()) {
+    throw new Error("Empty --sdk-docs-version");
+  }
+  if (/[\s'"\\]/.test(raw)) {
+    throw new Error(
+      `Invalid --sdk-docs-version: "${raw}" (no spaces, quotes, or backslashes)`
+    );
+  }
+}
+var MCP_INSTALL_DEBUG = process.env.ORDERLY_MCP_INSTALL_DEBUG === "1" || process.env.ORDERLY_MCP_INSTALL_DEBUG === "true";
+function debugInstallRun(...args) {
+  if (!MCP_INSTALL_DEBUG) return;
+  console.error("[sdk-docs runInstallCommand:debug]", ...args);
+}
+function parseInstallArgs(argv) {
+  const getValue = (flag) => {
+    const index = argv.indexOf(flag);
+    if (index === -1) return void 0;
+    return argv[index + 1];
+  };
+  const clientArg = getValue("--client") ?? "all";
+  const scopeArg = getValue("--scope") ?? "user";
+  const nameArg = getValue("--name") ?? "orderly-sdk-docs";
+  const sdkDocsVerRaw = getValue("--sdk-docs-version");
+  if (scopeArg !== "user" && scopeArg !== "project") {
+    throw new Error(`Invalid --scope: ${scopeArg}`);
+  }
+  const clients = clientArg === "all" ? ALL_CLIENTS : clientArg.split(",").map((x) => x.trim()).filter(Boolean);
+  for (const c of clients) {
+    if (!ALL_CLIENTS.includes(c)) {
+      throw new Error(`Invalid --client value: ${c}`);
+    }
+  }
+  let sdkDocsVersion;
+  if (sdkDocsVerRaw !== void 0) {
+    const trimmed = sdkDocsVerRaw.trim();
+    if (trimmed.length > 0) {
+      assertSafeSdkDocsVersionSpecifier(trimmed);
+      sdkDocsVersion = trimmed;
+    }
+  }
+  return {
+    clients,
+    scope: scopeArg,
+    dryRun: argv.includes("--dry-run"),
+    force: argv.includes("--force"),
+    name: nameArg,
+    sdkDocsVersion
+  };
+}
+function runInstallCommand(options, cwd = process.cwd()) {
+  debugInstallRun(
+    "cwd",
+    cwd,
+    "HOME",
+    process.env.HOME,
+    "USERPROFILE",
+    process.env.USERPROFILE
+  );
+  debugInstallRun("options", options);
+  const entry = buildServerEntry({
+    name: options.name,
+    sdkDocsVersion: options.sdkDocsVersion
+  });
+  const results = [];
+  const errors = [];
+  const phasePrefix = options.dryRun ? "[dry-run]" : "[install]";
+  for (const client of options.clients) {
+    const adapter = defaultClientAdapterRegistry.get(client);
+    if (!adapter) {
+      errors.push(`${client}: no adapter registered for this client`);
+      continue;
+    }
+    const configPath = adapter.resolvePath(options.scope, cwd);
+    console.warn(
+      `${phasePrefix} merging ${client} (${options.scope} scope) -> ${configPath}`
+    );
+    try {
+      const rawConfig = readJsonConfig(configPath);
+      const beforeExists = Object.keys(rawConfig).length > 0;
+      const merged = adapter.mergeConfig(
+        rawConfig,
+        options.name,
+        entry,
+        options.force
+      );
+      let backupPath;
+      if (merged.action === "updated" && !options.dryRun) {
+        backupPath = backupIfExists(configPath);
+        writeJsonAtomic(configPath, merged.merged);
+      }
+      results.push({
+        client,
+        path: configPath,
+        action: merged.action === "noop" ? "noop" : beforeExists ? "updated" : "created",
+        backupPath,
+        changed: merged.action === "updated"
+      });
+    } catch (error) {
+      errors.push(
+        `${client} (${configPath}): ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  const report = {
+    ok: errors.length === 0,
+    results,
+    errors
+  };
+  printInstallReport(report, options.dryRun);
+  return report;
+}
+
+// src/mcp-tools/registerDocsTools.ts
+import { z } from "zod";
+function jsonContent(payload) {
+  return {
+    content: [
+      { type: "text", text: JSON.stringify(payload, null, 2) }
+    ]
+  };
+}
+var DOCS_TOOLS = [
+  {
+    name: "orderly_docs_health",
+    description: "Returns Orderly SDK docs bundle metadata (gitSha, generatedAt, paths). Use to verify repo-local or embedded generated artifacts.",
+    run(_args, facade2) {
+      const b = facade2.bundle;
+      return {
+        ok: true,
+        gitSha: b.manifest.gitSha,
+        generatedAt: b.manifest.generatedAt,
+        releaseVersion: b.manifest.releaseVersion,
+        repoRoot: b.repoRoot,
+        generatedRoot: b.generatedRoot
+      };
+    }
+  },
+  {
+    name: "orderly_docs_search",
+    description: "Search Orderly SDK documentation (narrative markdown, recipes, workflows). Returns a DocsResult with ranked narrativeHits; when present, matchedEntityId or keywordSingletonId point to a concrete symbol \u2014 call orderly_docs_get_component, orderly_docs_get_type, or orderly_docs_get_hook next (check matchedEntityKind for the right tool). Response may also include queryVariants, inferredPackages, and packageSurfaceHints to guide follow-up exact lookups. Optional filters: k (max hits), kinds, packages.",
+    inputSchema: {
+      query: z.string().min(1).describe("Free-text search query"),
+      k: z.number().int().min(1).max(50).optional().describe("Max hits (1-50)"),
+      kinds: z.array(z.string()).optional(),
+      packages: z.array(z.string()).optional()
+    },
+    run(args, facade2) {
+      return facade2.searchDocs({
+        query: String(args?.query ?? ""),
+        k: args?.k,
+        kinds: args?.kinds,
+        packages: args?.packages
+      });
+    }
+  },
+  {
+    name: "orderly_docs_get_component",
+    description: "Exact component metadata (props, etc.) by symbol, @package/name:Export, component.* entity id, or interceptor target path (e.g. Trading.OrderEntry.SubmitSection). For interceptor targets without a concrete component entity, returns a type-backed fallback with propsType metadata. Returns DocsResult JSON.",
+    inputSchema: {
+      query: z.string().min(1).describe("Symbol, @package/name:Export, or component.* id")
+    },
+    run(args, facade2) {
+      return facade2.getComponent(String(args?.query ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_component_doc",
+    description: "Component markdown (examples / narrative) by symbol, @package/name:Export, or component.* id. For props/types use orderly_docs_get_component first.",
+    inputSchema: {
+      query: z.string().min(1).describe("Symbol, @package/name:Export, or component.* id")
+    },
+    run(args, facade2) {
+      return facade2.getComponentDoc(String(args?.query ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_type",
+    description: "Exact type / enum metadata by symbol, @package/name:Name, or type.* entity id. Returns DocsResult JSON.",
+    inputSchema: { query: z.string().min(1) },
+    run(args, facade2) {
+      return facade2.getType(String(args?.query ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_hook",
+    description: "Exact hook metadata (params, returns, jsDoc) by symbol name, @package/name:HookName, or hook.* entity id. Hooks (`useMarkPrice`, `useOrderEntry`, etc.) are the primary API for plugin developers. Hook `returns` types may be unions that are not valid React children until narrowed (e.g. `typeof x === 'number'` before rendering in JSX). Returns DocsResult JSON.",
+    inputSchema: {
+      query: z.string().min(1).describe("Symbol name, @package/name:HookName, or hook.* id")
+    },
+    run(args, facade2) {
+      return facade2.getHook(String(args?.query ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_package_surface",
+    description: "Lists export names for an npm package (e.g. @orderly.network/ui). Returns DocsResult JSON.",
+    inputSchema: { packageName: z.string().min(1) },
+    run(args, facade2) {
+      return facade2.getPackageSurface(String(args?.packageName ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_release_context",
+    description: "Manifest + optional build-stamp.json for gitSha / generatedAt. Returns DocsResult JSON.",
+    run(_args, facade2) {
+      return facade2.getReleaseContext();
+    }
+  },
+  {
+    name: "orderly_docs_get_workflow",
+    description: "Curated workflow markdown (slug without .md). Returns DocsResult JSON.",
+    inputSchema: {
+      slug: z.string().min(1).describe("e.g. wallet-connect for workflows/wallet-connect.md")
+    },
+    run(args, facade2) {
+      return facade2.getWorkflow(String(args?.slug ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_recipe",
+    description: "Minimal recipe markdown (name without .md). Returns DocsResult JSON.",
+    inputSchema: { name: z.string().min(1) },
+    run(args, facade2) {
+      return facade2.getRecipe(String(args?.name ?? ""));
+    }
+  },
+  {
+    name: "orderly_docs_get_guardrails",
+    description: "Guardrails and safety constraints markdown. Returns DocsResult JSON.",
+    run(_args, facade2) {
+      return facade2.getGuardrails();
+    }
+  },
+  {
+    name: "orderly_docs_fetch_sdk_source",
+    description: "Fetch source file text from the public Orderly JS SDK GitHub repo (OrderlyNetwork/js-sdk). Default ref is branch `main` unless `ORDERLY_SDK_GITHUB_REF` is set. If that ref returns HTTP 404 (e.g. unpublished local SHA), the tool retries once on `main`. Repo-relative paths only (e.g. packages/ui/src/button/button.tsx). Optional line/endLine returns excerpt; data.text is always full file.",
+    inputSchema: {
+      relPath: z.string().min(1).describe("Repo-relative path, e.g. packages/ui/src/avatar/avatar.tsx"),
+      line: z.number().int().min(1).optional().describe("1-based line for excerpt center or range start"),
+      endLine: z.number().int().min(1).optional().describe("1-based inclusive end line (range with line)"),
+      contextLines: z.number().int().min(0).max(200).optional().describe("Half-window around line when only line is set (default 15)")
+    },
+    run(args, facade2) {
+      return facade2.fetchSdkSource({
+        relPath: String(args?.relPath ?? ""),
+        line: args?.line,
+        endLine: args?.endLine,
+        contextLines: args?.contextLines
+      });
+    }
+  }
+];
+function registerDocsTools(server2, ctx) {
+  for (const tool of DOCS_TOOLS) {
+    server2.registerTool(
+      tool.name,
+      {
+        description: tool.description,
+        ...tool.inputSchema ? { inputSchema: tool.inputSchema } : {}
+      },
+      async (args) => {
+        const guard = ctx.guardFacade();
+        if (!guard.ok)
+          return { content: [{ type: "text", text: guard.payload }] };
+        const payload = await tool.run(
+          args,
+          guard.facade
+        );
+        return jsonContent(payload);
+      }
+    );
+  }
+}
+
+// src/mcp-cli.ts
+var facade = null;
+var loadError = null;
+try {
+  facade = createAiDocsFacade(loadBundle());
+} catch (e) {
+  loadError = e instanceof Error ? e.message : String(e);
+}
+function guardFacade() {
+  if (!facade || loadError) {
+    return {
+      ok: false,
+      payload: JSON.stringify(
+        errResult(
+          "INVALID_INDEX_SHAPE",
+          loadError ?? "SDK docs bundle failed to load.",
+          "Set ORDERLY_AI_DOCS_REPO_ROOT or run pnpm --filter @orderly.network/ai-docs generate, then pnpm --filter @orderly.network/sdk-docs sync:bundle.",
+          null
+        ),
+        null,
+        2
+      )
+    };
+  }
+  return { ok: true, facade };
+}
+var server = new McpServer({
+  name: "orderly-sdk-docs",
+  version: "0.1.0"
+});
+registerDocsTools(server, { guardFacade });
+var MCP_INSTALL_DEBUG2 = process.env.ORDERLY_MCP_INSTALL_DEBUG === "1" || process.env.ORDERLY_MCP_INSTALL_DEBUG === "true";
+function debugInstall(...args) {
+  if (!MCP_INSTALL_DEBUG2) return;
+  console.error("[orderly-sdk-docs-mcp install:debug]", ...args);
+}
+function argvStartingAtInstall(argv) {
+  const idx = argv.indexOf("install");
+  if (idx === -1) return null;
+  return argv.slice(idx);
+}
+async function maybeRunInstallCommand() {
+  const sliced = process.argv.slice(2);
+  debugInstall("process.argv.slice(2)", sliced);
+  const argv = argvStartingAtInstall(sliced);
+  debugInstall("argvStartingAtInstall", argv);
+  if (!argv || argv[0] !== "install") {
+    debugInstall(
+      "not entering install branch (expected literal subcommand install)"
+    );
+    return false;
+  }
+  console.warn("Starting MCP config installation...");
+  const options = parseInstallArgs(argv.slice(1));
+  const report = runInstallCommand(options);
+  if (!report.ok) {
+    process.exitCode = 1;
+  }
+  return true;
+}
+async function main() {
+  const handledInstall = await maybeRunInstallCommand();
+  if (handledInstall) return;
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=mcp-cli.js.map

package/dist/mcp-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-cli.ts","../src/install/fs-write.ts","../src/install/report.ts","../src/install/spec.ts","../src/install/install.command.ts","../src/mcp-tools/registerDocsTools.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { loadBundle } from \"./bundle.js\";\nimport { errResult } from \"./envelope.js\";\nimport { createAiDocsFacade, type AiDocsFacade } from \"./facade.js\";\nimport {\n  parseInstallArgs,\n  runInstallCommand,\n} from \"./install/install.command.js\";\nimport { registerDocsTools } from \"./mcp-tools/registerDocsTools.js\";\n\nlet facade: AiDocsFacade | null = null;\nlet loadError: string | null = null;\n\ntry {\n  facade = createAiDocsFacade(loadBundle());\n} catch (e) {\n  loadError = e instanceof Error ? e.message : String(e);\n}\n\nfunction guardFacade():\n  | { ok: true; facade: AiDocsFacade }\n  | { ok: false; payload: string } {\n  if (!facade || loadError) {\n    return {\n      ok: false,\n      payload: JSON.stringify(\n        errResult(\n          \"INVALID_INDEX_SHAPE\",\n          loadError ?? \"SDK docs bundle failed to load.\",\n          \"Set ORDERLY_AI_DOCS_REPO_ROOT or run pnpm --filter @orderly.network/ai-docs generate, then pnpm --filter @orderly.network/sdk-docs sync:bundle.\",\n          null,\n        ),\n        null,\n        2,\n      ),\n    };\n  }\n  return { ok: true, facade };\n}\n\nconst server = new McpServer({\n  name: \"orderly-sdk-docs\",\n  version: \"0.1.0\",\n});\n\nregisterDocsTools(server, { guardFacade });\n\nconst MCP_INSTALL_DEBUG =\n  process.env.ORDERLY_MCP_INSTALL_DEBUG === \"1\" ||\n  process.env.ORDERLY_MCP_INSTALL_DEBUG === \"true\";\n\n/** stderr-only diagnostics when ORDERLY_MCP_INSTALL_DEBUG is set */\nfunction debugInstall(...args: unknown[]): void {\n  if (!MCP_INSTALL_DEBUG) return;\n  console.error(\"[orderly-sdk-docs-mcp install:debug]\", ...args);\n}\n\n/**\n * Resolve argv after `node …/mcp-cli.js …` so the install subcommand is argv[0].\n * npx/npm often passes the shim path as the first token (e.g. `.bin/orderly-sdk-docs-mcp`),\n * so checking only argv[0] === \"install\" misses install and we fall through to MCP stdio —\n * the child never exits and orderly-devkit appears hung after spawning npx.\n */\nfunction argvStartingAtInstall(argv: string[]): string[] | null {\n  const idx = argv.indexOf(\"install\");\n  if (idx === -1) return null;\n  return argv.slice(idx);\n}\n\n/**\n * Run MCP install flow when user executes:\n * `orderly-sdk-docs-mcp install ...`\n */\nasync function maybeRunInstallCommand(): Promise<boolean> {\n  const sliced = process.argv.slice(2);\n  debugInstall(\"process.argv.slice(2)\", sliced);\n\n  const argv = argvStartingAtInstall(sliced);\n  debugInstall(\"argvStartingAtInstall\", argv);\n\n  if (!argv || argv[0] !== \"install\") {\n    debugInstall(\n      \"not entering install branch (expected literal subcommand install)\",\n    );\n    return false;\n  }\n\n  console.warn(\"Starting MCP config installation...\");\n  const options = parseInstallArgs(argv.slice(1));\n  const report = runInstallCommand(options);\n  if (!report.ok) {\n    process.exitCode = 1;\n  }\n  return true;\n}\n\nasync function main() {\n  const handledInstall = await maybeRunInstallCommand();\n  if (handledInstall) return;\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((err: unknown) => {\n  console.error(err);\n  process.exit(1);\n});\n","import fs from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Read JSON config if it exists; otherwise return empty object.\n */\nexport function readJsonConfig(configPath: string): Record<string, unknown> {\n  if (!fs.existsSync(configPath)) {\n    return {};\n  }\n  const rawText = fs.readFileSync(configPath, \"utf8\").trim();\n  if (!rawText) return {};\n  try {\n    const parsed = JSON.parse(rawText);\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      throw new Error(\"Root value must be an object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (error) {\n    throw new Error(\n      `Invalid JSON at ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n}\n\n/**\n * Write JSON atomically via temp-file + rename.\n */\nexport function writeJsonAtomic(\n  configPath: string,\n  data: Record<string, unknown>,\n): void {\n  const dir = path.dirname(configPath);\n  fs.mkdirSync(dir, { recursive: true });\n  const tempPath = `${configPath}.tmp`;\n  fs.writeFileSync(tempPath, `${JSON.stringify(data, null, 2)}\\n`, \"utf8\");\n  fs.renameSync(tempPath, configPath);\n}\n\n/**\n * Create timestamped backup when target already exists.\n */\nexport function backupIfExists(configPath: string): string | undefined {\n  if (!fs.existsSync(configPath)) return undefined;\n  const stamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const backupPath = `${configPath}.${stamp}.bak`;\n  fs.copyFileSync(configPath, backupPath);\n  return backupPath;\n}\n","import type { InstallReport } from \"./types.js\";\n\n/**\n * Render a concise install summary for terminal output.\n */\nexport function printInstallReport(\n  report: InstallReport,\n  dryRun: boolean,\n): void {\n  const prefix = dryRun ? \"[dry-run]\" : \"[install]\";\n\n  for (const item of report.results) {\n    const backup = item.backupPath ? ` (backup: ${item.backupPath})` : \"\";\n    console.warn(\n      `${prefix} ${item.client}: ${item.action} -> ${item.path}${backup}`,\n    );\n  }\n\n  if (report.errors.length > 0) {\n    for (const msg of report.errors) {\n      console.error(`${prefix} error: ${msg}`);\n    }\n  }\n}\n","import type { BuildEntryOptions } from \"./types.js\";\nimport type { McpServerConfigEntry } from \"./types_internal.js\";\n\n/**\n * Build the canonical MCP server config entry used across all clients.\n * Uses npx to avoid hard-coding platform-specific executable paths.\n */\nexport function buildServerEntry(\n  opts: BuildEntryOptions,\n): McpServerConfigEntry {\n  const v = opts.sdkDocsVersion?.trim();\n  const pkg = v\n    ? `@orderly.network/sdk-docs@${v}`\n    : \"@orderly.network/sdk-docs\";\n  return {\n    command: \"npx\",\n    args: [\"-y\", pkg, \"orderly-sdk-docs-mcp\"],\n  };\n}\n","import { defaultClientAdapterRegistry } from \"./clients.js\";\nimport { backupIfExists, readJsonConfig, writeJsonAtomic } from \"./fs-write.js\";\nimport { printInstallReport } from \"./report.js\";\nimport { buildServerEntry } from \"./spec.js\";\nimport type {\n  InstallClient,\n  InstallOptions,\n  InstallReport,\n  InstallResult,\n  InstallScope,\n} from \"./types.js\";\n\nconst ALL_CLIENTS: InstallClient[] = [\"claude\", \"codex\", \"cursor\", \"opencode\"];\n\n/** Reject characters that break npx/npm package@version parsing or shell wrappers. */\nfunction assertSafeSdkDocsVersionSpecifier(raw: string): void {\n  if (!raw.trim()) {\n    throw new Error(\"Empty --sdk-docs-version\");\n  }\n  // No whitespace, quotes, or backslashes — keeps npx argv and merged JSON stable.\n  if (/[\\s'\"\\\\]/.test(raw)) {\n    throw new Error(\n      `Invalid --sdk-docs-version: \"${raw}\" (no spaces, quotes, or backslashes)`,\n    );\n  }\n}\n\nconst MCP_INSTALL_DEBUG =\n  process.env.ORDERLY_MCP_INSTALL_DEBUG === \"1\" ||\n  process.env.ORDERLY_MCP_INSTALL_DEBUG === \"true\";\n\n/** stderr-only when ORDERLY_MCP_INSTALL_DEBUG is set */\nfunction debugInstallRun(...args: unknown[]): void {\n  if (!MCP_INSTALL_DEBUG) return;\n  console.error(\"[sdk-docs runInstallCommand:debug]\", ...args);\n}\n\n/**\n * Parse install options from argv list (excluding node/script path).\n */\nexport function parseInstallArgs(argv: string[]): InstallOptions {\n  const getValue = (flag: string): string | undefined => {\n    const index = argv.indexOf(flag);\n    if (index === -1) return undefined;\n    return argv[index + 1];\n  };\n\n  const clientArg = getValue(\"--client\") ?? \"all\";\n  const scopeArg = (getValue(\"--scope\") ?? \"user\") as InstallScope;\n  const nameArg = getValue(\"--name\") ?? \"orderly-sdk-docs\";\n  const sdkDocsVerRaw = getValue(\"--sdk-docs-version\");\n\n  if (scopeArg !== \"user\" && scopeArg !== \"project\") {\n    throw new Error(`Invalid --scope: ${scopeArg}`);\n  }\n\n  const clients =\n    clientArg === \"all\"\n      ? ALL_CLIENTS\n      : (clientArg\n          .split(\",\")\n          .map((x) => x.trim())\n          .filter(Boolean) as InstallClient[]);\n\n  for (const c of clients) {\n    if (!ALL_CLIENTS.includes(c)) {\n      throw new Error(`Invalid --client value: ${c}`);\n    }\n  }\n\n  let sdkDocsVersion: string | undefined;\n  if (sdkDocsVerRaw !== undefined) {\n    const trimmed = sdkDocsVerRaw.trim();\n    if (trimmed.length > 0) {\n      assertSafeSdkDocsVersionSpecifier(trimmed);\n      sdkDocsVersion = trimmed;\n    }\n  }\n\n  return {\n    clients,\n    scope: scopeArg,\n    dryRun: argv.includes(\"--dry-run\"),\n    force: argv.includes(\"--force\"),\n    name: nameArg,\n    sdkDocsVersion,\n  };\n}\n\n/**\n * Execute config installation for all requested clients.\n */\nexport function runInstallCommand(\n  options: InstallOptions,\n  cwd = process.cwd(),\n): InstallReport {\n  debugInstallRun(\n    \"cwd\",\n    cwd,\n    \"HOME\",\n    process.env.HOME,\n    \"USERPROFILE\",\n    process.env.USERPROFILE,\n  );\n  debugInstallRun(\"options\", options);\n\n  const entry = buildServerEntry({\n    name: options.name,\n    sdkDocsVersion: options.sdkDocsVersion,\n  });\n  const results: InstallResult[] = [];\n  const errors: string[] = [];\n\n  const phasePrefix = options.dryRun ? \"[dry-run]\" : \"[install]\";\n  for (const client of options.clients) {\n    const adapter = defaultClientAdapterRegistry.get(client);\n    if (!adapter) {\n      errors.push(`${client}: no adapter registered for this client`);\n      continue;\n    }\n    const configPath = adapter.resolvePath(options.scope, cwd);\n\n    console.warn(\n      `${phasePrefix} merging ${client} (${options.scope} scope) -> ${configPath}`,\n    );\n\n    try {\n      const rawConfig = readJsonConfig(configPath);\n      const beforeExists = Object.keys(rawConfig).length > 0;\n      const merged = adapter.mergeConfig(\n        rawConfig,\n        options.name,\n        entry,\n        options.force,\n      );\n\n      let backupPath: string | undefined;\n      if (merged.action === \"updated\" && !options.dryRun) {\n        backupPath = backupIfExists(configPath);\n        writeJsonAtomic(configPath, merged.merged);\n      }\n\n      results.push({\n        client,\n        path: configPath,\n        action:\n          merged.action === \"noop\"\n            ? \"noop\"\n            : beforeExists\n              ? \"updated\"\n              : \"created\",\n        backupPath,\n        changed: merged.action === \"updated\",\n      });\n    } catch (error) {\n      errors.push(\n        `${client} (${configPath}): ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n\n  const report: InstallReport = {\n    ok: errors.length === 0,\n    results,\n    errors,\n  };\n\n  printInstallReport(report, options.dryRun);\n  return report;\n}\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { AiDocsFacade } from \"../facade.js\";\n\ntype GuardFacadeResult =\n  | { ok: true; facade: AiDocsFacade }\n  | { ok: false; payload: string };\n\ntype ToolContext = {\n  /** Provides a validated facade or a serialized error payload. */\n  guardFacade: () => GuardFacadeResult;\n};\n\ntype ToolDefinition = {\n  /** MCP tool identifier exposed to clients. */\n  name: string;\n  /** Human-readable tool contract for model/tooling selection. */\n  description: string;\n  /** Optional zod input schema used by MCP SDK validation. */\n  inputSchema?: Record<string, z.ZodTypeAny>;\n  /** Executes the tool and returns JSON-serializable payload. */\n  run(args: Record<string, unknown> | undefined, facade: AiDocsFacade): unknown;\n};\n\n/** Normalizes all tool outputs into plain text JSON blocks. */\nfunction jsonContent(payload: unknown) {\n  return {\n    content: [\n      { type: \"text\" as const, text: JSON.stringify(payload, null, 2) },\n    ],\n  };\n}\n\n/** Declarative MCP tool catalog for orderly-sdk-docs runtime. */\nconst DOCS_TOOLS: ToolDefinition[] = [\n  {\n    name: \"orderly_docs_health\",\n    description:\n      \"Returns Orderly SDK docs bundle metadata (gitSha, generatedAt, paths). Use to verify repo-local or embedded generated artifacts.\",\n    run(_args, facade) {\n      const b = facade.bundle;\n      return {\n        ok: true as const,\n        gitSha: b.manifest.gitSha,\n        generatedAt: b.manifest.generatedAt,\n        releaseVersion: b.manifest.releaseVersion,\n        repoRoot: b.repoRoot,\n        generatedRoot: b.generatedRoot,\n      };\n    },\n  },\n  {\n    name: \"orderly_docs_search\",\n    description:\n      \"Search Orderly SDK documentation (narrative markdown, recipes, workflows). Returns a DocsResult with ranked narrativeHits; when present, matchedEntityId or keywordSingletonId point to a concrete symbol — call orderly_docs_get_component, orderly_docs_get_type, or orderly_docs_get_hook next (check matchedEntityKind for the right tool). Response may also include queryVariants, inferredPackages, and packageSurfaceHints to guide follow-up exact lookups. Optional filters: k (max hits), kinds, packages.\",\n    inputSchema: {\n      query: z.string().min(1).describe(\"Free-text search query\"),\n      k: z.number().int().min(1).max(50).optional().describe(\"Max hits (1-50)\"),\n      kinds: z.array(z.string()).optional(),\n      packages: z.array(z.string()).optional(),\n    },\n    run(args, facade) {\n      return facade.searchDocs({\n        query: String(args?.query ?? \"\"),\n        k: args?.k as number | undefined,\n        kinds: args?.kinds as string[] | undefined,\n        packages: args?.packages as string[] | undefined,\n      });\n    },\n  },\n  {\n    name: \"orderly_docs_get_component\",\n    description:\n      \"Exact component metadata (props, etc.) by symbol, @package/name:Export, component.* entity id, or interceptor target path (e.g. Trading.OrderEntry.SubmitSection). For interceptor targets without a concrete component entity, returns a type-backed fallback with propsType metadata. Returns DocsResult JSON.\",\n    inputSchema: {\n      query: z\n        .string()\n        .min(1)\n        .describe(\"Symbol, @package/name:Export, or component.* id\"),\n    },\n    run(args, facade) {\n      return facade.getComponent(String(args?.query ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_component_doc\",\n    description:\n      \"Component markdown (examples / narrative) by symbol, @package/name:Export, or component.* id. For props/types use orderly_docs_get_component first.\",\n    inputSchema: {\n      query: z\n        .string()\n        .min(1)\n        .describe(\"Symbol, @package/name:Export, or component.* id\"),\n    },\n    run(args, facade) {\n      return facade.getComponentDoc(String(args?.query ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_type\",\n    description:\n      \"Exact type / enum metadata by symbol, @package/name:Name, or type.* entity id. Returns DocsResult JSON.\",\n    inputSchema: { query: z.string().min(1) },\n    run(args, facade) {\n      return facade.getType(String(args?.query ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_hook\",\n    description:\n      \"Exact hook metadata (params, returns, jsDoc) by symbol name, @package/name:HookName, or hook.* entity id. Hooks (`useMarkPrice`, `useOrderEntry`, etc.) are the primary API for plugin developers. Hook `returns` types may be unions that are not valid React children until narrowed (e.g. `typeof x === 'number'` before rendering in JSX). Returns DocsResult JSON.\",\n    inputSchema: {\n      query: z\n        .string()\n        .min(1)\n        .describe(\"Symbol name, @package/name:HookName, or hook.* id\"),\n    },\n    run(args, facade) {\n      return facade.getHook(String(args?.query ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_package_surface\",\n    description:\n      \"Lists export names for an npm package (e.g. @orderly.network/ui). Returns DocsResult JSON.\",\n    inputSchema: { packageName: z.string().min(1) },\n    run(args, facade) {\n      return facade.getPackageSurface(String(args?.packageName ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_release_context\",\n    description:\n      \"Manifest + optional build-stamp.json for gitSha / generatedAt. Returns DocsResult JSON.\",\n    run(_args, facade) {\n      return facade.getReleaseContext();\n    },\n  },\n  {\n    name: \"orderly_docs_get_workflow\",\n    description:\n      \"Curated workflow markdown (slug without .md). Returns DocsResult JSON.\",\n    inputSchema: {\n      slug: z\n        .string()\n        .min(1)\n        .describe(\"e.g. wallet-connect for workflows/wallet-connect.md\"),\n    },\n    run(args, facade) {\n      return facade.getWorkflow(String(args?.slug ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_recipe\",\n    description:\n      \"Minimal recipe markdown (name without .md). Returns DocsResult JSON.\",\n    inputSchema: { name: z.string().min(1) },\n    run(args, facade) {\n      return facade.getRecipe(String(args?.name ?? \"\"));\n    },\n  },\n  {\n    name: \"orderly_docs_get_guardrails\",\n    description:\n      \"Guardrails and safety constraints markdown. Returns DocsResult JSON.\",\n    run(_args, facade) {\n      return facade.getGuardrails();\n    },\n  },\n  {\n    name: \"orderly_docs_fetch_sdk_source\",\n    description:\n      \"Fetch source file text from the public Orderly JS SDK GitHub repo (OrderlyNetwork/js-sdk). Default ref is branch `main` unless `ORDERLY_SDK_GITHUB_REF` is set. If that ref returns HTTP 404 (e.g. unpublished local SHA), the tool retries once on `main`. Repo-relative paths only (e.g. packages/ui/src/button/button.tsx). Optional line/endLine returns excerpt; data.text is always full file.\",\n    inputSchema: {\n      relPath: z\n        .string()\n        .min(1)\n        .describe(\"Repo-relative path, e.g. packages/ui/src/avatar/avatar.tsx\"),\n      line: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"1-based line for excerpt center or range start\"),\n      endLine: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"1-based inclusive end line (range with line)\"),\n      contextLines: z\n        .number()\n        .int()\n        .min(0)\n        .max(200)\n        .optional()\n        .describe(\"Half-window around line when only line is set (default 15)\"),\n    },\n    run(args, facade) {\n      return facade.fetchSdkSource({\n        relPath: String(args?.relPath ?? \"\"),\n        line: args?.line as number | undefined,\n        endLine: args?.endLine as number | undefined,\n        contextLines: args?.contextLines as number | undefined,\n      });\n    },\n  },\n];\n\n/** Registers all docs tools from a single declarative registry. */\nexport function registerDocsTools(server: McpServer, ctx: ToolContext): void {\n  for (const tool of DOCS_TOOLS) {\n    server.registerTool(\n      tool.name,\n      {\n        description: tool.description,\n        ...(tool.inputSchema ? { inputSchema: tool.inputSchema } : {}),\n      },\n      async (args) => {\n        const guard = ctx.guardFacade();\n        if (!guard.ok)\n          return { content: [{ type: \"text\" as const, text: guard.payload }] };\n        const payload = await tool.run(\n          args as Record<string, unknown> | undefined,\n          guard.facade,\n        );\n        return jsonContent(payload);\n      },\n    );\n  }\n}\n"],"mappings":"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","names":["facade","server","MCP_INSTALL_DEBUG"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kodiak-finance/orderly-sdk-docs",
+  "version": "1.0.2",
+  "type": "module",
+  "description": "Orderly SDK documentation runtime: MCP server, exact indexes, and narrative (QMD) retrieval",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "orderly-sdk-docs-mcp": "./dist/mcp-cli.js"
+  },
+  "files": [
+    "dist",
+    "bundled"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@tobilu/qmd": "^2.0.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.6.3",
+    "@kodiak-finance/orderly-ai-docs": "1.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "sync:bundle": "node scripts/sync-bundled-generated.mjs",
+    "build": "pnpm run sync:bundle && tsup",
+    "dev": "tsup --watch",
+    "start:mcp": "node dist/mcp-cli.js",
+    "smoke": "pnpm run build && node scripts/smoke.mjs",
+    "exercise": "pnpm run build && node scripts/exercise-facade.mjs",
+    "search-nl": "pnpm run build && node scripts/search-nl.mjs"
+  }
+}