@takara-ai/miru-code 0.4.2 → 0.4.4

package/README.md

@@ -25,7 +25,7 @@ miru setup --key YOUR_TOKEN   # non-interactive
 miru setup --clear            # remove stored key
 ```
 
-For MCP in an IDE, export `TAKARA_API_KEY` or paste your token into the MCP `env` block after install.
+MCP loads your key from `credentials.json` automatically. Set `TAKARA_API_KEY` in MCP config only to override.
 
 ## Add to your IDE
 
@@ -120,7 +120,7 @@ const results = await index.search({ query: "BM25 tokenize", topK: 10 });
 | Variable | Notes |
 |----------|-------|
 | `TAKARA_API_KEY` | Required |
-| `MIRU_OPENAI_BASE_URL` | Default `https://infer.dev.takara.ai/v1` |
+| `MIRU_OPENAI_BASE_URL` | Default `https://infer.takara.ai/v1` |
 | `MIRU_MCP_WATCH` | Set `0` to disable MCP file watch |
 | `NO_COLOR` | Disable CLI colors |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takara-ai/miru-code",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Miru (見る) — hybrid code search for agents. Bun, TypeScript, Takara embeddings.",
   "type": "module",
   "license": "MIT",

package/src/cli.ts

@@ -13,6 +13,7 @@ import {
 } from "./cli-ui.ts";
 import { loadStoredCredentials } from "./credentials.ts";
 import { loadEnvFiles } from "./env-files.ts";
+import { normalizeTakaraApiKeyEnv } from "./env.ts";
 import {
   AGENT_IDS,
   formatUnknownAgent,
@@ -29,6 +30,7 @@ import type { ContentType, SearchResult } from "./types.ts";
 import { formatResults, resolveChunk, resolveContent } from "./utils.ts";
 
 loadEnvFiles();
+normalizeTakaraApiKeyEnv();
 await loadStoredCredentials();
 
 const CLI_COMMANDS = new Set([

package/src/credentials.ts

@@ -1,6 +1,6 @@
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { hasTakaraApiKeyInEnv } from "./env.ts";
+import { hasTakaraApiKeyInEnv, normalizeTakaraApiKeyEnv } from "./env.ts";
 
 const CREDENTIALS_FILENAME = "credentials.json";
 const CREDENTIALS_VERSION = 1;
@@ -49,6 +49,7 @@ export async function readStoredCredentials(): Promise<StoredCredentials | null>
 
 /** Set TAKARA_API_KEY from the user credentials file when env is unset. */
 export async function loadStoredCredentials(): Promise<boolean> {
+  normalizeTakaraApiKeyEnv();
   if (hasTakaraApiKeyInEnv()) {
     return false;
   }

package/src/embeddings/openai.ts

@@ -2,7 +2,7 @@ import { mapPool, resolveWorkerConcurrency } from "../concurrency.ts";
 import { envFirstString, envOptionalInt, resolveEmbeddingApiKey } from "../env.ts";
 
 const DEFAULT_MODEL = "ds1-potion-code-16m";
-const DEFAULT_BASE_URL = "https://infer.dev.takara.ai/v1";
+const DEFAULT_BASE_URL = "https://infer.takara.ai/v1";
 const DEFAULT_BATCH_SIZE = 32;
 const DEFAULT_MAX_EMBED_CHARS = 1300;
 const WINDOW_OVERLAP_CHARS = 120;

package/src/env.ts

@@ -33,13 +33,31 @@ export function envOptionalInt(names: string[], min = 1): number | undefined {
 
 export const TAKARA_API_KEY_ENV = "TAKARA_API_KEY";
 
+const TAKARA_API_KEY_PLACEHOLDERS = new Set(["${TAKARA_API_KEY}", "$TAKARA_API_KEY"]);
+
+/** True when the value is a real key, not empty or an unexpanded MCP env placeholder. */
+export function isUsableTakaraApiKey(value: string | undefined): boolean {
+  const key = value?.trim() ?? "";
+  if (!key) {
+    return false;
+  }
+  return !TAKARA_API_KEY_PLACEHOLDERS.has(key);
+}
+
+/** Drop placeholder values so credentials.json can supply the key for MCP. */
+export function normalizeTakaraApiKeyEnv(): void {
+  if (!isUsableTakaraApiKey(process.env[TAKARA_API_KEY_ENV])) {
+    delete process.env[TAKARA_API_KEY_ENV];
+  }
+}
+
 export function hasTakaraApiKeyInEnv(): boolean {
-  return Boolean(process.env[TAKARA_API_KEY_ENV]?.trim());
+  return isUsableTakaraApiKey(process.env[TAKARA_API_KEY_ENV]);
 }
 
 export function resolveEmbeddingApiKey(): string {
   const key = process.env[TAKARA_API_KEY_ENV]?.trim() ?? "";
-  if (!key) {
+  if (!isUsableTakaraApiKey(key)) {
     throw new Error(
       "Takara API key required. Run `miru setup`, or set TAKARA_API_KEY in your MCP server env or .env.local.",
     );

package/src/help.ts

@@ -53,7 +53,7 @@ export function printEnvHelp(): void {
   writeStdout("  TAKARA_API_KEY");
   writeStdout("      Takara bearer token for embeddings");
   writeStdout("  MIRU_OPENAI_BASE_URL");
-  writeStdout("      Default: https://infer.dev.takara.ai/v1");
+  writeStdout("      Default: https://infer.takara.ai/v1");
   writeStdout("  MIRU_CONCURRENCY");
   writeStdout("      Parallel workers (default: CPUs − 2)");
   writeStdout("");

package/src/installer/agents.ts

@@ -54,7 +54,7 @@ A \`miru\` MCP server is available with two tools:
 
 Always call \`search\` before using Grep, Glob, or Read to explore the codebase. Use Grep/Glob/Read only for exact path lookup, exhaustive literal matches, or when the returned chunk lacks enough context.
 
-Set \`TAKARA_API_KEY\` in your MCP config (or run \`miru setup\` for CLI use). MCP does not inherit shell env reliably.
+Run \`miru setup\` once to store your API key — the MCP server loads it from \`credentials.json\`. Optionally set \`TAKARA_API_KEY\` in MCP config to override.
 
 Pass \`--content docs\` to search documentation, \`--content config\` for config files, or \`--content all\` for everything.
 

package/src/installer/installer.ts

@@ -246,7 +246,7 @@ export async function runInstaller(mode: InstallMode): Promise<void> {
     install ? "Done! Restart your agents to pick up changes." : "Done! Configuration removed.",
   );
   if (install) {
-    hint("Run miru setup or export TAKARA_API_KEY for MCP env expansion.");
+    hint("Run miru setup — MCP loads the key from credentials.json automatically.");
   }
   writeStdout("");
 }

package/src/setup.ts

@@ -73,7 +73,7 @@ export async function runSetup(options: RunSetupOptions = {}): Promise<string> {
   process.env.TAKARA_API_KEY = apiKey;
   writeStderr("");
   success(`Saved credentials to ${path}`);
-  hint("Set TAKARA_API_KEY in MCP config for IDE integrations.");
+  hint("MCP loads this key from credentials.json automatically.");
   writeStderr("");
   return path;
 }