@invarn/cli 0.1.9 → 0.2.1

package/dist/sdk.d.mts

@@ -0,0 +1,36 @@
+import type { McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+
+export interface CreateInvarnMcpServerOptions {
+  /**
+   * Invarn human API key (`inv_human_…`). When omitted, resolves from the
+   * `INVARN_TOKEN` env var, then the on-disk profile at
+   * `~/.config/invarn/config.json`. Factory throws at construction time if
+   * none of these yield a token.
+   */
+  token?: string;
+  /**
+   * API base URL. Defaults to the `INVARN_URL` env var or `https://invarn.com`.
+   * Override for self-hosted deployments.
+   */
+  baseUrl?: string;
+  /**
+   * Allowlist by tool name. Default: all 13 tools. See the package README
+   * for the full list of tool names.
+   */
+  tools?: string[];
+  /** Reported as the MCP server version. Defaults to the CLI version. */
+  version?: string;
+}
+
+/**
+ * Build an in-process MCP server exposing invarn's tools to the Claude
+ * Agent SDK. The returned object plugs straight into `mcpServers` on the
+ * agent's `query()` options.
+ *
+ * Responses are structured JSON (`JSON.stringify(result, null, 2)` in a
+ * single text block) so the LLM parses fields reliably. The stdio CLI
+ * (`invarn mcp serve`) keeps its formatted prose for interactive use.
+ */
+export function createInvarnMcpServer(
+  options?: CreateInvarnMcpServerOptions,
+): McpSdkServerConfigWithInstance;