@invarn/cli 0.1.8 → 0.2.0

package/README.md

@@ -153,6 +153,45 @@ invarn secrets rm STRIPE_KEY
 
 There is no read command — once set, values cannot be retrieved through the CLI or MCP.
 
+## In-process SDK (for agent hosts)
+
+If you're embedding Claude in your own Node application via `@anthropic-ai/claude-agent-sdk`, skip the subprocess and register invarn as an in-process MCP server instead:
+
+```js
+import { query } from '@anthropic-ai/claude-agent-sdk'
+import { createInvarnMcpServer } from '@invarn/cli/sdk'
+
+const invarn = createInvarnMcpServer({
+  token: process.env.INVARN_API_KEY,   // or INVARN_TOKEN env / disk profile
+  tools: ['invarn_build_list', 'invarn_agent_run', 'invarn_agent_result'],
+})
+
+for await (const msg of query({
+  prompt: 'Build the iOS app and report status.',
+  options: {
+    mcpServers: { invarn },
+    allowedTools: [
+      'mcp__invarn__invarn_build_list',
+      'mcp__invarn__invarn_agent_run',
+      'mcp__invarn__invarn_agent_result',
+    ],
+  },
+})) { /* ... */ }
+```
+
+**Options**
+
+| Option | Default | Notes |
+|---|---|---|
+| `token` | `process.env.INVARN_TOKEN` → disk profile | Invarn human API key (`inv_human_...`) |
+| `baseUrl` | `process.env.INVARN_URL` → `https://invarn.com` | Override for self-hosted deployments |
+| `tools` | all 13 | Allowlist by tool name. |
+| `version` | CLI version | Reported as the MCP server version |
+
+Responses from the SDK path are JSON (`JSON.stringify(result, null, 2)` in a single text block), not the formatted prose the stdio CLI emits — LLMs parse structured data more reliably. The stdio server (`invarn mcp serve`) is unchanged.
+
+The Agent SDK is a **peer dependency**; the consuming host resolves its version.
+
 ## Requirements
 
 - Node.js 22+