muonroi-cli 1.2.3 → 1.3.2

package/dist/src/providers/endpoints.js

@@ -0,0 +1,58 @@
+/**
+ * Single source of truth for provider API base URLs and console URLs.
+ *
+ * Every other module should import from here — never inline a provider URL.
+ * If a provider changes domain (e.g. region split), this is the only file
+ * that needs to update.
+ *
+ * `apiBase`     — base URL the SDK / fetch hits for chat/completions, etc.
+ * `consoleUrl`  — human dashboard for issuing API keys (used by the wizard).
+ */
+export const PROVIDER_ENDPOINTS = {
+    anthropic: {
+        apiBase: "https://api.anthropic.com",
+        consoleUrl: "https://console.anthropic.com/settings/keys",
+    },
+    openai: {
+        apiBase: "https://api.openai.com/v1",
+        consoleUrl: "https://platform.openai.com/api-keys",
+    },
+    google: {
+        apiBase: "https://generativelanguage.googleapis.com/v1beta",
+        consoleUrl: "https://aistudio.google.com/app/apikey",
+    },
+    deepseek: {
+        apiBase: "https://api.deepseek.com",
+        consoleUrl: "https://platform.deepseek.com/api_keys",
+    },
+    siliconflow: {
+        apiBase: "https://api.siliconflow.com/v1",
+        consoleUrl: "https://cloud.siliconflow.com/account/ak",
+    },
+    xai: {
+        apiBase: "https://api.x.ai/v1",
+        consoleUrl: "https://console.x.ai/",
+    },
+    ollama: {
+        apiBase: "http://localhost:11434",
+        consoleUrl: "(no key needed for Ollama)",
+    },
+};
+/** Fast lookup: provider id → API base URL. */
+export function apiBaseFor(provider) {
+    return PROVIDER_ENDPOINTS[provider].apiBase;
+}
+/** Fast lookup: provider id → human console URL for issuing keys. */
+export function consoleUrlFor(provider) {
+    return PROVIDER_ENDPOINTS[provider].consoleUrl;
+}
+/**
+ * Default base URLs for OpenAI-compatible providers only. Used by adapters
+ * that share the OpenAI SDK shape (deepseek, siliconflow, xai).
+ */
+export const OPENAI_COMPATIBLE_BASE_URLS = {
+    deepseek: PROVIDER_ENDPOINTS.deepseek.apiBase,
+    siliconflow: PROVIDER_ENDPOINTS.siliconflow.apiBase,
+    xai: PROVIDER_ENDPOINTS.xai.apiBase,
+};
+//# sourceMappingURL=endpoints.js.map

package/dist/src/providers/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../../src/providers/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,CAAC,MAAM,kBAAkB,GAA0C;IACvE,SAAS,EAAE;QACT,OAAO,EAAE,2BAA2B;QACpC,UAAU,EAAE,6CAA6C;KAC1D;IACD,MAAM,EAAE;QACN,OAAO,EAAE,2BAA2B;QACpC,UAAU,EAAE,sCAAsC;KACnD;IACD,MAAM,EAAE;QACN,OAAO,EAAE,kDAAkD;QAC3D,UAAU,EAAE,wCAAwC;KACrD;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0BAA0B;QACnC,UAAU,EAAE,wCAAwC;KACrD;IACD,WAAW,EAAE;QACX,OAAO,EAAE,gCAAgC;QACzC,UAAU,EAAE,0CAA0C;KACvD;IACD,GAAG,EAAE;QACH,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,uBAAuB;KACpC;IACD,MAAM,EAAE;QACN,OAAO,EAAE,wBAAwB;QACjC,UAAU,EAAE,4BAA4B;KACzC;CACF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,QAAoB;IAC7C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,QAAoB;IAChD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuD;IAC7F,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,OAAO;IAC7C,WAAW,EAAE,kBAAkB,CAAC,WAAW,CAAC,OAAO;IACnD,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC,OAAO;CACpC,CAAC"}

package/dist/src/providers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/providers/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAI,GAAW,EAAE,MAAM,IAAK,GAAW,EAAE,UAAU,CAAC;IAEhE,IAAI,IAAI,GAAwB,SAAS,CAAC;IAE1C,IAAI,IAAI,KAAK,gBAAgB,IAAI,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,IAAI,GAAG,YAAY,CAAC;IACtB,CAAC;SAAM,IACL,IAAI,KAAK,qBAAqB;QAC9B,MAAM,KAAK,GAAG;QACd,MAAM,KAAK,GAAG;QACd,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,EACpC,CAAC;QACD,IAAI,GAAG,MAAM,CAAC;IAChB,CAAC;SAAM,IAAI,wCAAwC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,IAAI,GAAG,gBAAgB,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACvD,IAAI,GAAG,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IACtE,OAAO,GAAsB,CAAC;AAChC,CAAC"}

package/dist/src/providers/errors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../../src/providers/errors.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACrG,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACtG,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/providers/gemini.js

@@ -0,0 +1,38 @@
+/**
+ * src/providers/gemini.ts
+ *
+ * Gemini adapter implementation behind the Adapter interface.
+ * Uses @ai-sdk/google + AI SDK v6 streamText/fullStream.
+ */
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { streamText } from "ai";
+import { redactor } from "../utils/redactor.js";
+import { streamFromFullStream } from "./stream-loop.js";
+/**
+ * Create a Gemini (Google) adapter.
+ */
+export function createGeminiAdapter(config) {
+    if (config.apiKey && !config.oauthHeaders) {
+        redactor.enrollSecret(config.apiKey);
+    }
+    // When OAuth headers are present, route auth through extraHeaders. The Gemini
+    // SDK still wants a non-empty apiKey for config validation; the Authorization
+    // header takes precedence on the wire.
+    const provider = config.oauthHeaders
+        ? createGoogleGenerativeAI({ apiKey: "oauth", headers: config.oauthHeaders })
+        : createGoogleGenerativeAI({ apiKey: config.apiKey });
+    return {
+        id: "google",
+        async *stream(req) {
+            const result = streamText({
+                model: provider(config.model),
+                messages: req.messages,
+                tools: req.tools,
+                toolChoice: req.toolChoice,
+                abortSignal: req.abortSignal,
+            });
+            yield* streamFromFullStream(result.fullStream);
+        },
+    };
+}
+//# sourceMappingURL=gemini.js.map

package/dist/src/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC1C,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY;QAClC,CAAC,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7E,CAAC,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAExD,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,KAAK,CAAC,CAAC,MAAM,CAAC,GAAmB;YAC/B,MAAM,MAAM,GAAG,UAAU,CAAC;gBACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK,EAAE,GAAG,CAAC,KAAY;gBACvB,UAAU,EAAE,GAAG,CAAC,UAAiB;gBACjC,WAAW,EAAE,GAAG,CAAC,WAAW;aAC7B,CAAC,CAAC;YACH,KAAK,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/providers/gemini.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/gemini.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.test.js","sourceRoot":"","sources":["../../../src/providers/gemini.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAG3F,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACnB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;CACpB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,wBAAwB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;CACtF,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,cAAc,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAE7C,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,OAAO,GAAG,mBAAmB,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAC5G,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1D,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAS,CAAC,CAAC;QAEpF,MAAM,OAAO,GAAG,mBAAmB,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAC5G,MAAM,SAAS,GAAkB,EAAE,CAAC;QACpC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9F,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAClE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAE,SAAS,CAAC,CAAC,CAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/providers/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * src/providers/index.ts
+ *
+ * Barrel export for the providers module.
+ * Multi-provider support via shared runtime + adapter factories.
+ */
+export { ALL_PROVIDER_IDS, createAdapter } from "./adapter.js";
+export { AnthropicKeyMissingError, loadAnthropicKey, streamAnthropicMessage, } from "./anthropic.js";
+export { firstAvailableProvider, loadKeyForProvider, ProviderKeyMissingError } from "./keychain.js";
+export { createProviderFactory, detectProviderForModel, type ProviderFactory, type ProviderFactoryResult, type ResolvedModelRuntime, resolveModelRuntime, } from "./runtime.js";
+export type { ProviderId, ProviderRequest, ProviderStream, StreamChunk } from "./types.js";

package/dist/src/providers/index.js

@@ -0,0 +1,15 @@
+/**
+ * src/providers/index.ts
+ *
+ * Barrel export for the providers module.
+ * Multi-provider support via shared runtime + adapter factories.
+ */
+// Adapter factory
+export { ALL_PROVIDER_IDS, createAdapter } from "./adapter.js";
+// Back-compat Phase 0 exports (still used by some callers)
+export { AnthropicKeyMissingError, loadAnthropicKey, streamAnthropicMessage, } from "./anthropic.js";
+// Keychain
+export { firstAvailableProvider, loadKeyForProvider, ProviderKeyMissingError } from "./keychain.js";
+// Multi-provider runtime
+export { createProviderFactory, detectProviderForModel, resolveModelRuntime, } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kBAAkB;AAClB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,2DAA2D;AAC3D,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,WAAW;AACX,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACpG,yBAAyB;AACzB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EAItB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/src/providers/keychain.d.ts

@@ -0,0 +1,66 @@
+/**
+ * src/providers/keychain.ts
+ *
+ * Per-provider keychain loader with env-var fallback.
+ * Extends the Phase 0 loadAnthropicKey pattern to all 6 providers.
+ * PROV-02 / PROV-03 requirements.
+ *
+ * Priority: OS keychain (keytar) > environment variable > settings.json > ProviderKeyMissingError.
+ * Exception: ollama is keyless by default.
+ */
+import type { ProviderId } from "./types.js";
+/**
+ * Thrown when no API key can be found for a provider.
+ */
+export declare class ProviderKeyMissingError extends Error {
+    readonly provider: ProviderId;
+    constructor(provider: ProviderId);
+}
+/**
+ * Providers that store an API key in the OS keychain.
+ * Phase 12.2-G5: derived from `ALL_PROVIDER_IDS` by excluding ollama
+ * (keyless local server). Preserves the original ordering.
+ */
+export declare const KEYCHAIN_PROVIDER_IDS: readonly ProviderId[];
+/**
+ * Store a provider API key in the OS keychain. Returns true on success.
+ * Falls back to false (silent) if keytar is unavailable on this platform.
+ */
+export declare function setKeyForProvider(provider: ProviderId, key: string): Promise<boolean>;
+/**
+ * Delete a stored key. Returns true if a key was deleted, false if none was
+ * present or keytar is unavailable.
+ */
+export declare function deleteKeyForProvider(provider: ProviderId): Promise<boolean>;
+/**
+ * List provider IDs that currently have a key stored in the keychain.
+ * Empty array if keytar is unavailable.
+ */
+export declare function listStoredProviders(): Promise<ProviderId[]>;
+/**
+ * Load the API key for a given provider.
+ * Priority: OS keychain (keytar) > environment variable.
+ * Ollama returns '' when no key is found (keyless).
+ *
+ * @throws {ProviderKeyMissingError} when no key found for non-ollama providers.
+ */
+export declare function loadKeyForProvider(provider: ProviderId): Promise<string>;
+/**
+ * Return the list of providers that currently have credentials available — checked across
+ * OS keychain, environment variables, and user-settings.json. `ollama` is always included
+ * because it is keyless. Order is stable for UI rendering.
+ */
+export declare function getConfiguredProviders(): Promise<ProviderId[]>;
+/**
+ * Load OAuth tokens for a provider with auto-refresh.
+ * Returns null if no OAuth tokens are stored for that provider.
+ * This is a thin helper over token-store + openai-oauth; exported here so
+ * higher-level code (CLI, adapter) has a single import point.
+ */
+export declare function getOAuthTokens(provider: ProviderId): Promise<import("./auth/types.js").OAuthTokens | null>;
+/**
+ * Find the first provider with an available API key.
+ * Checks in priority order: anthropic, openai, google, deepseek, siliconflow, ollama.
+ * Returns null if no provider has a key (unlikely — ollama is keyless fallback).
+ */
+export declare function firstAvailableProvider(): Promise<ProviderId | null>;

package/dist/src/providers/keychain.js

@@ -0,0 +1,250 @@
+/**
+ * src/providers/keychain.ts
+ *
+ * Per-provider keychain loader with env-var fallback.
+ * Extends the Phase 0 loadAnthropicKey pattern to all 6 providers.
+ * PROV-02 / PROV-03 requirements.
+ *
+ * Priority: OS keychain (keytar) > environment variable > settings.json > ProviderKeyMissingError.
+ * Exception: ollama is keyless by default.
+ */
+import { redactor } from "../utils/redactor.js";
+import { ALL_PROVIDER_IDS } from "./types.js";
+const SETTINGS_KEY_MAP = {
+    anthropic: "anthropic",
+    openai: "openai",
+    google: "google",
+    deepseek: "deepseek",
+    siliconflow: "siliconflow",
+    xai: "xai",
+};
+const KEYCHAIN_SERVICE = "muonroi-cli";
+const ACCOUNT_BY_PROVIDER = {
+    anthropic: "anthropic",
+    openai: "openai",
+    google: "google",
+    deepseek: "deepseek",
+    siliconflow: "siliconflow",
+    xai: "xai",
+    ollama: "ollama",
+};
+const ENV_BY_PROVIDER = {
+    anthropic: "ANTHROPIC_API_KEY",
+    openai: "OPENAI_API_KEY",
+    google: "GOOGLE_API_KEY",
+    deepseek: "DEEPSEEK_API_KEY",
+    siliconflow: "SILICONFLOW_API_KEY",
+    xai: "XAI_API_KEY",
+    ollama: "OLLAMA_API_KEY",
+};
+/**
+ * Thrown when no API key can be found for a provider.
+ */
+export class ProviderKeyMissingError extends Error {
+    provider;
+    constructor(provider) {
+        super(`No API key found for provider '${provider}'.`);
+        this.provider = provider;
+        this.name = "ProviderKeyMissingError";
+    }
+}
+async function loadKeytar() {
+    try {
+        return (await import("keytar"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Providers that store an API key in the OS keychain.
+ * Phase 12.2-G5: derived from `ALL_PROVIDER_IDS` by excluding ollama
+ * (keyless local server). Preserves the original ordering.
+ */
+export const KEYCHAIN_PROVIDER_IDS = ALL_PROVIDER_IDS.filter((p) => p !== "ollama");
+/**
+ * Store a provider API key in the OS keychain. Returns true on success.
+ * Falls back to false (silent) if keytar is unavailable on this platform.
+ */
+export async function setKeyForProvider(provider, key) {
+    if (!key || key.length < 20) {
+        throw new Error(`Key for '${provider}' is too short (< 20 chars).`);
+    }
+    const kt = await loadKeytar();
+    if (!kt?.setPassword)
+        return false;
+    redactor.enrollSecret(key);
+    await kt.setPassword(KEYCHAIN_SERVICE, ACCOUNT_BY_PROVIDER[provider], key);
+    return true;
+}
+/**
+ * Delete a stored key. Returns true if a key was deleted, false if none was
+ * present or keytar is unavailable.
+ */
+export async function deleteKeyForProvider(provider) {
+    const kt = await loadKeytar();
+    if (!kt?.deletePassword)
+        return false;
+    return await kt.deletePassword(KEYCHAIN_SERVICE, ACCOUNT_BY_PROVIDER[provider]);
+}
+/**
+ * List provider IDs that currently have a key stored in the keychain.
+ * Empty array if keytar is unavailable.
+ */
+export async function listStoredProviders() {
+    const kt = await loadKeytar();
+    if (!kt?.findCredentials)
+        return [];
+    try {
+        const creds = await kt.findCredentials(KEYCHAIN_SERVICE);
+        const validAccounts = new Set(Object.values(ACCOUNT_BY_PROVIDER));
+        return creds.filter((c) => validAccounts.has(c.account)).map((c) => c.account);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Load the API key for a given provider.
+ * Priority: OS keychain (keytar) > environment variable.
+ * Ollama returns '' when no key is found (keyless).
+ *
+ * @throws {ProviderKeyMissingError} when no key found for non-ollama providers.
+ */
+export async function loadKeyForProvider(provider) {
+    const kt = await loadKeytar();
+    if (kt) {
+        try {
+            const k = await kt.getPassword(KEYCHAIN_SERVICE, ACCOUNT_BY_PROVIDER[provider]);
+            if (k && k.length >= 20) {
+                redactor.enrollSecret(k);
+                return k;
+            }
+        }
+        catch {
+            /* ignore keytar backend failures */
+        }
+    }
+    const envKey = process.env[ENV_BY_PROVIDER[provider]];
+    if (envKey && envKey.length >= 20) {
+        redactor.enrollSecret(envKey);
+        return envKey;
+    }
+    // Fallback: check user-settings.json providers config (lazy import to avoid circular deps)
+    const settingsField = SETTINGS_KEY_MAP[provider];
+    if (settingsField) {
+        try {
+            const { loadUserSettings } = await import("../utils/settings.js");
+            const providers = loadUserSettings().providers;
+            const settingsKey = providers?.[settingsField]?.apiKey;
+            if (settingsKey && settingsKey.length >= 20) {
+                redactor.enrollSecret(settingsKey);
+                return settingsKey;
+            }
+        }
+        catch {
+            /* settings load failed — continue to error */
+        }
+    }
+    // Ollama may be keyless
+    if (provider === "ollama")
+        return "";
+    throw new ProviderKeyMissingError(provider);
+}
+/**
+ * Return the list of providers that currently have credentials available — checked across
+ * OS keychain, environment variables, and user-settings.json. `ollama` is always included
+ * because it is keyless. Order is stable for UI rendering.
+ */
+export async function getConfiguredProviders() {
+    const order = ALL_PROVIDER_IDS;
+    const stored = new Set(await listStoredProviders());
+    let settingsProviders = {};
+    try {
+        const { loadUserSettings } = await import("../utils/settings.js");
+        settingsProviders = (loadUserSettings().providers ?? {});
+    }
+    catch {
+        /* settings unreadable — keychain + env still work */
+    }
+    // OAuth-authenticated providers (no API key, but tokens stored via `keys
+    // login`) need to count as configured — otherwise the model picker silently
+    // hides them. Source the eligible provider list from the OAuth registry so
+    // adding a new OAuth provider in registry.ts automatically wires it up here.
+    const oauthAuthenticated = new Set();
+    try {
+        const { listOAuthProviderIds } = await import("./auth/registry.js");
+        const { loadTokens } = await import("./auth/token-store.js");
+        for (const p of await listOAuthProviderIds()) {
+            const t = await loadTokens(p).catch(() => null);
+            if (t?.accessToken)
+                oauthAuthenticated.add(p);
+        }
+    }
+    catch {
+        /* registry/token-store unreadable — fall through */
+    }
+    const configured = [];
+    for (const p of order) {
+        if (p === "ollama") {
+            configured.push(p);
+            continue;
+        }
+        if (stored.has(p) || oauthAuthenticated.has(p)) {
+            configured.push(p);
+            continue;
+        }
+        const envKey = process.env[ENV_BY_PROVIDER[p]];
+        if (envKey && envKey.length >= 20) {
+            configured.push(p);
+            continue;
+        }
+        const settingsField = SETTINGS_KEY_MAP[p];
+        if (settingsField) {
+            const k = settingsProviders[settingsField]?.apiKey;
+            if (k && k.length >= 20) {
+                configured.push(p);
+            }
+        }
+    }
+    return configured;
+}
+/**
+ * Load OAuth tokens for a provider with auto-refresh.
+ * Returns null if no OAuth tokens are stored for that provider.
+ * This is a thin helper over token-store + openai-oauth; exported here so
+ * higher-level code (CLI, adapter) has a single import point.
+ */
+export async function getOAuthTokens(provider) {
+    if (provider !== "openai")
+        return null; // only openai supported in Phase 18
+    try {
+        const { loadTokensWithRefresh } = await import("./auth/openai-oauth.js");
+        return await loadTokensWithRefresh("openai");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the first provider with an available API key.
+ * Checks in priority order: anthropic, openai, google, deepseek, siliconflow, ollama.
+ * Returns null if no provider has a key (unlikely — ollama is keyless fallback).
+ */
+export async function firstAvailableProvider() {
+    // firstAvailableProvider intentionally excludes xai: priority list for legacy
+    // fallback paths that pre-date xai integration. Derived from ALL_PROVIDER_IDS
+    // to keep ordering in sync if new providers are added.
+    const order = ALL_PROVIDER_IDS.filter((p) => p !== "xai");
+    for (const p of order) {
+        try {
+            await loadKeyForProvider(p);
+            return p;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=keychain.js.map

package/dist/src/providers/keychain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.js","sourceRoot":"","sources":["../../../src/providers/keychain.ts"],"names":[],"mappings":"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"}

package/dist/src/providers/keychain.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/providers/keychain.test.js

@@ -0,0 +1,84 @@
+/**
+ * Tests for src/providers/keychain.ts
+ * Mocks keytar and env vars to verify loadKeyForProvider + firstAvailableProvider.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// We'll mock keytar at the module level
+vi.mock("keytar", () => ({
+    getPassword: vi.fn().mockResolvedValue(null),
+}));
+// Mock settings so the settings.json providers fallback doesn't interfere
+vi.mock("../utils/settings.js", () => ({
+    loadUserSettings: () => ({ providers: {} }),
+}));
+import { firstAvailableProvider, loadKeyForProvider, ProviderKeyMissingError } from "./keychain.js";
+describe("loadKeyForProvider", () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        // Clear env vars
+        delete process.env.ANTHROPIC_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        delete process.env.GOOGLE_API_KEY;
+        delete process.env.DEEPSEEK_API_KEY;
+        delete process.env.SILICONFLOW_API_KEY;
+        delete process.env.OLLAMA_API_KEY;
+    });
+    afterEach(() => {
+        // Restore
+        Object.assign(process.env, originalEnv);
+        vi.restoreAllMocks();
+    });
+    it("returns key from env var when keytar returns null", async () => {
+        process.env.OPENAI_API_KEY = "sk-test-openai-key-longer-than-20-chars";
+        const key = await loadKeyForProvider("openai");
+        expect(key).toBe("sk-test-openai-key-longer-than-20-chars");
+    });
+    it("throws ProviderKeyMissingError when no key found for non-ollama provider", async () => {
+        await expect(loadKeyForProvider("openai")).rejects.toThrow(ProviderKeyMissingError);
+    });
+    it("returns empty string for ollama when no key set (keyless)", async () => {
+        const key = await loadKeyForProvider("ollama");
+        expect(key).toBe("");
+    });
+    it("reads from ANTHROPIC_API_KEY env var", async () => {
+        process.env.ANTHROPIC_API_KEY = "sk-ant-test-key-long-enough-for-validation";
+        const key = await loadKeyForProvider("anthropic");
+        expect(key).toBe("sk-ant-test-key-long-enough-for-validation");
+    });
+    it("reads from GOOGLE_API_KEY env var", async () => {
+        process.env.GOOGLE_API_KEY = "AIzaSyB_test_key_longer_than_twenty";
+        const key = await loadKeyForProvider("google");
+        expect(key).toBe("AIzaSyB_test_key_longer_than_twenty");
+    });
+});
+describe("firstAvailableProvider", () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        delete process.env.ANTHROPIC_API_KEY;
+        delete process.env.OPENAI_API_KEY;
+        delete process.env.GOOGLE_API_KEY;
+        delete process.env.DEEPSEEK_API_KEY;
+        delete process.env.SILICONFLOW_API_KEY;
+        delete process.env.OLLAMA_API_KEY;
+    });
+    afterEach(() => {
+        Object.assign(process.env, originalEnv);
+        vi.restoreAllMocks();
+    });
+    it("returns anthropic when ANTHROPIC_API_KEY is set", async () => {
+        process.env.ANTHROPIC_API_KEY = "sk-ant-test-key-long-enough-for-validation";
+        const p = await firstAvailableProvider();
+        expect(p).toBe("anthropic");
+    });
+    it("returns openai when only OPENAI_API_KEY is set", async () => {
+        process.env.OPENAI_API_KEY = "sk-test-openai-key-longer-than-20-chars";
+        const p = await firstAvailableProvider();
+        expect(p).toBe("openai");
+    });
+    it("returns ollama as fallback (keyless)", async () => {
+        // No keys set — ollama is keyless so it should be found
+        const p = await firstAvailableProvider();
+        expect(p).toBe("ollama");
+    });
+});
+//# sourceMappingURL=keychain.test.js.map

package/dist/src/providers/keychain.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.test.js","sourceRoot":"","sources":["../../../src/providers/keychain.test.ts"],"names":[],"mappings":"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"}

package/dist/src/providers/mcp-vision-bridge.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Vision Bridge — universal image intelligence layer for text-only models.
+ *
+ * This is NOT limited to Playwright. Any task involving images flows through here:
+ * 1. MCP tool results containing images (Playwright, Figma, any MCP server)
+ * 2. Proactive image analysis from file paths or URLs
+ * 3. Follow-up questions about previously seen images
+ * 4. Image comparison and diff detection
+ *
+ * Text-only models (DeepSeek, etc.) call the vision proxy PROACTIVELY —
+ * they don't wait for images to appear, they request analysis when needed.
+ */
+/**
+ * Structured layout schema returned for `design` context.
+ * Downstream agents consume this JSON directly instead of re-parsing markdown.
+ * Kept embedded in the prompt (not strict JSON-schema mode) for cross-provider portability.
+ */
+export declare const UI_LAYOUT_SCHEMA_HINT = "{\n  \"viewport\": { \"width\": number, \"height\": number, \"deviceClass\": \"mobile\" | \"tablet\" | \"desktop\" },\n  \"tokens\": {\n    \"colors\": [{ \"name\": string, \"hex\": string, \"role\": \"primary\" | \"secondary\" | \"accent\" | \"bg\" | \"fg\" | \"border\" | \"muted\" }],\n    \"typography\": [{ \"role\": \"heading\" | \"body\" | \"caption\" | \"label\", \"fontFamily\": string, \"sizePx\": number, \"weight\": number }],\n    \"spacingScalePx\": number[],\n    \"radiusScalePx\": number[]\n  },\n  \"layout\": { \"type\": \"stack\" | \"grid\" | \"flex\" | \"absolute\", \"direction\": \"row\" | \"column\", \"gapPx\": number, \"columns\": number | null },\n  \"components\": [{\n    \"id\": string,\n    \"role\": \"button\" | \"input\" | \"card\" | \"nav\" | \"header\" | \"footer\" | \"image\" | \"icon\" | \"text\" | \"list\" | \"modal\" | \"tabs\" | \"table\" | \"chart\" | \"container\" | \"other\",\n    \"label\": string,\n    \"text\": string | null,\n    \"bbox\": { \"x\": number, \"y\": number, \"w\": number, \"h\": number },\n    \"style\": { \"bgHex\": string | null, \"fgHex\": string | null, \"borderHex\": string | null, \"radiusPx\": number | null, \"shadow\": string | null },\n    \"state\": \"default\" | \"hover\" | \"active\" | \"disabled\" | \"focus\" | \"error\",\n    \"children\": string[]\n  }],\n  \"hierarchy\": [{ \"level\": 1 | 2 | 3, \"text\": string, \"componentId\": string }],\n  \"notes\": string[]\n}";
+export declare function listCachedImages(): Array<{
+    id: string;
+    source: string;
+    label: string;
+    age: string;
+    hasDescription: boolean;
+}>;
+export interface McpVisionBridgeResult {
+    output: unknown;
+    proxied: boolean;
+    description?: string;
+    cachedImageIds?: string[];
+}
+/**
+ * Intercept any tool result and proxy images for text-only models.
+ * Works for ALL MCP tools, built-in tools, or any tool returning image data.
+ */
+export declare function bridgeMcpToolResult(toolName: string, toolOutput: unknown, modelId: string, signal?: AbortSignal, toolCallId?: string): Promise<McpVisionBridgeResult>;
+/**
+ * Proactively analyze an image from a file path, URL, or raw base64.
+ * Text-only models call this when they KNOW an image exists and need to understand it.
+ */
+export declare function analyzeImageFromSource(source: string, question?: string, cwd?: string, signal?: AbortSignal): Promise<string>;
+/**
+ * Ask a follow-up question about a previously cached image,
+ * or provide a file path to analyze a new image with a specific question.
+ */
+export declare function askVisionProxy(question: string, imageIdOrPath?: string, cwd?: string, signal?: AbortSignal): Promise<string>;
+/**
+ * System prompt guidance for text-only models — UNIVERSAL, not Playwright-specific.
+ */
+export declare function getVisionGuidanceForTextOnly(modelId: string): string;
+export declare const getPlaywrightGuidanceForTextOnly: typeof getVisionGuidanceForTextOnly;
+export declare function isImageFile(filePath: string): boolean;
+/**
+ * Walk an arbitrary message tree and replace any oversized base64 string
+ * leaves (typically Playwright screenshot payloads) with a stable placeholder.
+ * Used by the orchestrator to scrub `response.messages` BEFORE persisting,
+ * so 1.5MB image bytes don't end up baked into the conversation history
+ * (which would overflow the next turn's context window).
+ */
+export declare function scrubImagePayloadsInMessages<T>(messages: T[]): T[];