chainlesschain 0.166.131 → 0.166.133

package/src/lib/personal-data-hub-wiring.js

@@ -644,35 +644,44 @@ async function initHub() {
       // collector can pull WebView cookies from the user's Android Bilibili
       // App. The factory is a pure function — no side effects until the
       // handler is invoked, so cost of always-registering is zero.
-      const { createBilibiliCookiesExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/social-bilibili-adb");
+      const { createBilibiliCookiesExtension } = await import(
+        "@chainlesschain/personal-data-hub/adapters/social-bilibili-adb"
+      );
       // Phase 2a: register `douyin.pull-im-db` extension so the
       // douyinAdbSync hub method can pull <uid>_im.db cohort from the
       // user's Android Douyin App.
       const { createDouyinDbExtension, createDouyinWatchExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/social-douyin-adb");
+        await import(
+          "@chainlesschain/personal-data-hub/adapters/social-douyin-adb"
+        );
       // Phase 3a: register `weibo.cookies` extension for the Weibo
       // C-path collector (m.weibo.cn cookies + 4 HTTP endpoints).
-      const { createWeiboCookiesExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/social-weibo-adb");
+      const { createWeiboCookiesExtension } = await import(
+        "@chainlesschain/personal-data-hub/adapters/social-weibo-adb"
+      );
       // Phase 3c: register `xhs.cookies` extension for the Xhs C-path
       // collector (xiaohongshu.com cookies + 4 endpoints with X-S sign).
-      const { createXhsCookiesExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/social-xiaohongshu-adb");
+      const { createXhsCookiesExtension } = await import(
+        "@chainlesschain/personal-data-hub/adapters/social-xiaohongshu-adb"
+      );
       // Phase 6c: register `toutiao.cookies` extension for the Toutiao
       // C-path collector (www.toutiao.com cookies + 4 endpoints, 3 of
       // which need _signature signing — CLI context falls back to -99
       // short-circuit, desktop wiring upgrades via ToutiaoSignBridge).
       const { createToutiaoCookiesExtension, createToutiaoAccountExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/social-toutiao-adb");
+        await import(
+          "@chainlesschain/personal-data-hub/adapters/social-toutiao-adb"
+        );
       // Phase 6d: register `kuaishou.cookies` extension. Profile from
       // cookie's api_ph payload (no HTTP); 3 GraphQL POST endpoints need
       // __NS_sig3 + kpf/kpn — CLI short-circuits, desktop upgrades via
       // KuaishouSignBridge.
-      const { createKuaishouCookiesExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/social-kuaishou-adb");
-      const { createWhatsAppBackupExtension } =
-        await import("@chainlesschain/personal-data-hub/adapters/messaging-whatsapp");
+      const { createKuaishouCookiesExtension } = await import(
+        "@chainlesschain/personal-data-hub/adapters/social-kuaishou-adb"
+      );
+      const { createWhatsAppBackupExtension } = await import(
+        "@chainlesschain/personal-data-hub/adapters/messaging-whatsapp"
+      );
       hostAdbBridge = createHostAdbBridge({
         extensions: {
           "bilibili.cookies": createBilibiliCookiesExtension(),
@@ -1105,16 +1114,20 @@ async function initHub() {
     alipayAccountsPath,
     entityResolver,
     aichatAccountsStore,
-    async drainResolver(options = {}, factory = null) {
-      if (typeof factory !== "function") {
+    async drainResolver(options = {}, factory = null, modelTurnOptions = {}) {
+      if (
+        typeof factory !== "function" &&
+        !(factory === null && modelTurnOptions.evolutionDisabled === true)
+      ) {
         const error = new Error(
           "Personal Data Hub resolver egress requires an authenticated evolution composition factory",
         );
         error.code = "CC_AGENT_EVOLUTION_INGRESS_FAILED";
         throw error;
       }
-      const { createGovernedHubResolver } =
-        await import("./evolution/governed-hub-resolver.js");
+      const { createGovernedHubResolver } = await import(
+        "./evolution/governed-hub-resolver.js"
+      );
       const scoped = createGovernedHubResolver(
         {
           resolver: entityResolver,
@@ -1125,6 +1138,8 @@ async function initHub() {
           LLMStage: EntityResolverLLMStage,
         },
         factory,
+        undefined,
+        modelTurnOptions,
       );
       return scoped.drain(options);
     },
@@ -1656,8 +1671,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-bilibili-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-bilibili-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -1708,8 +1724,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-douyin-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-douyin-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -1752,8 +1769,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-douyin-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-douyin-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -1799,8 +1817,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-weibo-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-weibo-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -1852,8 +1871,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-xiaohongshu-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-xiaohongshu-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -1905,8 +1925,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-toutiao-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-toutiao-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -1960,8 +1981,9 @@ async function initHub() {
       }
       let collector;
       try {
-        const mod =
-          await import("@chainlesschain/personal-data-hub/adapters/social-kuaishou-adb");
+        const mod = await import(
+          "@chainlesschain/personal-data-hub/adapters/social-kuaishou-adb"
+        );
         collector = mod.default ? mod.default : mod;
       } catch (err) {
         return {
@@ -2149,11 +2171,19 @@ export async function getHub() {
   return _initPromise;
 }
 
-export async function getGovernedAnalysisHub(evolutionCompositionFactory) {
+export async function getGovernedAnalysisHub(
+  evolutionCompositionFactory,
+  modelTurnOptions = {},
+) {
   const hub = await getHub();
-  const { createGovernedHubLlm } =
-    await import("./evolution/governed-hub-llm.js");
-  const llm = createGovernedHubLlm(hub.engine.llm, evolutionCompositionFactory);
+  const { createGovernedHubLlm } = await import(
+    "./evolution/governed-hub-llm.js"
+  );
+  const llm = createGovernedHubLlm(
+    hub.engine.llm,
+    evolutionCompositionFactory,
+    modelTurnOptions,
+  );
   const engine = new AnalysisEngine({
     vault: hub.engine.vault,
     llm,
@@ -2162,8 +2192,9 @@ export async function getGovernedAnalysisHub(evolutionCompositionFactory) {
     maxQueryLimit: hub.engine.maxQueryLimit,
     systemPrompt: hub.engine.systemPrompt,
   });
-  const { runGovernedHubSkill } =
-    await import("./evolution/governed-hub-skill.js");
+  const { runGovernedHubSkill } = await import(
+    "./evolution/governed-hub-skill.js"
+  );
   return Object.freeze({
     ...hub,
     llm,
@@ -2175,6 +2206,8 @@ export async function getGovernedAnalysisHub(evolutionCompositionFactory) {
         runAnalysisSkill,
         name,
         options,
+        undefined,
+        modelTurnOptions,
       ),
   });
 }

package/src/lib/provider-protocol.js

@@ -4,6 +4,29 @@ export function normalizeProviderBaseUrl(baseUrl) {
   return String(baseUrl || "").replace(/\/+$/u, "");
 }
 
+/** Validate custom targets without assuming a vendor, path, model, or key. */
+export function assertCustomProviderConnection(provider, { baseUrl, model }) {
+  if (provider !== "custom") return;
+  let url;
+  try {
+    url = new URL(baseUrl);
+  } catch {
+    throw new Error("Custom provider requires an HTTP(S) API base URL");
+  }
+  if (
+    !["http:", "https:"].includes(url.protocol) ||
+    url.username ||
+    url.password ||
+    url.search ||
+    url.hash
+  )
+    throw new Error(
+      "Custom provider requires an HTTP(S) API base URL without credentials, query or fragment",
+    );
+  if (typeof model !== "string" || !model.trim())
+    throw new Error("Custom provider requires an explicit model name");
+}
+
 /**
  * Google's OpenAI-compatible API lives below `/v1beta/openai`. The provider
  * registry stores the native API root (`/v1beta`), so adapt only that exact
@@ -28,7 +51,11 @@ export function openAICompatibleBaseUrl(provider, baseUrl) {
   return base;
 }
 
-export function geminiGenerateContentUrl(baseUrl, model, { stream = false } = {}) {
+export function geminiGenerateContentUrl(
+  baseUrl,
+  model,
+  { stream = false } = {},
+) {
   const action = stream ? "streamGenerateContent" : "generateContent";
   const endpoint = `${normalizeProviderBaseUrl(baseUrl)}/models/${encodeURIComponent(model)}:${action}`;
   return stream ? `${endpoint}?alt=sse` : endpoint;
@@ -58,7 +85,10 @@ export function geminiRequestBody(
       continue;
     }
     contents.push({
-      role: message.role === "assistant" || message.role === "model" ? "model" : "user",
+      role:
+        message.role === "assistant" || message.role === "model"
+          ? "model"
+          : "user",
       parts,
     });
   }
@@ -66,7 +96,9 @@ export function geminiRequestBody(
   if (Number.isFinite(temperature)) generationConfig.temperature = temperature;
   return {
     contents,
-    ...(systemParts.length ? { systemInstruction: { parts: systemParts } } : {}),
+    ...(systemParts.length
+      ? { systemInstruction: { parts: systemParts } }
+      : {}),
     generationConfig,
   };
 }

package/src/lib/provider-stream.js

@@ -8,10 +8,11 @@ import {
  * of token deltas suitable for piping through session-core StreamRouter.
  */
 
-import { BUILT_IN_PROVIDERS } from "./llm-providers.js";
+import { resolveProviderDefinition } from "./llm-providers.js";
 import { normalizeOllamaBaseUrl } from "./ollama-base-url.js";
 import { ollamaProviderFetch } from "./ollama-provider-fetch.js";
 import {
+  assertCustomProviderConnection,
   geminiGenerateContentUrl,
   geminiRequestBody,
   normalizeProviderBaseUrl,
@@ -111,7 +112,7 @@ export async function* openAIStream({
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        Authorization: `Bearer ${apiKey}`,
+        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
       },
       body: JSON.stringify({
         model,
@@ -276,6 +277,7 @@ export async function* anthropicTokenStream({
  * Throws on unsupported provider / missing API key.
  */
 export function buildProviderSource(provider, opts = {}) {
+  assertCustomProviderConnection(provider, opts);
   const {
     model,
     baseUrl,
@@ -295,11 +297,11 @@ export function buildProviderSource(provider, opts = {}) {
       requireCompletion,
     });
   }
-  const def = BUILT_IN_PROVIDERS[provider];
+  const def = resolveProviderDefinition(provider);
   if (!def) throw new Error(`Unsupported provider: ${provider}`);
   const finalKey =
     apiKey || (def.apiKeyEnv ? process.env[def.apiKeyEnv] : null);
-  if (!finalKey) {
+  if (!finalKey && provider !== "custom") {
     throw new Error(
       `API key required for ${provider} (--api-key or ${def.apiKeyEnv})`,
     );

package/src/lib/runnable-provider.js

@@ -146,6 +146,8 @@ export function makeRunnableProviderFallback(
   // react to an auth failure AND pre-empt the known-bad attempt on later turns.
   const computeFallback = (options) => {
     const failed = options.provider;
+    // A custom protocol selection is intentional, including on localhost.
+    if (failed === "custom") return null;
     const inferred = inferProviderFromBaseUrl(options.baseUrl);
     if (inferred && inferred !== failed) {
       return {
@@ -269,6 +271,8 @@ export function hasUsableKey(
   provider,
   { apiKey, isActive = true, env = process.env } = {},
 ) {
+  // Custom platforms may be keyless; connection validation checks their target.
+  if (provider === "custom") return true;
   const def = BUILT_IN_PROVIDERS[provider];
   if (!def) return false;
   if (!def.apiKeyEnv) return true; // keyless local provider (e.g. ollama)

package/src/lib/ws-chat-handler.js

@@ -14,7 +14,12 @@ export class WSChatHandler {
    * @param {import("./ws-session-manager.js").Session} options.session
    * @param {import("./interaction-adapter.js").WebSocketInteractionAdapter} options.interaction
    */
-  constructor({ session, interaction, evolutionCompositionFactory = null }) {
+  constructor({
+    session,
+    interaction,
+    evolutionCompositionFactory = null,
+    prepareUiModelTurn = null,
+  }) {
     if (
       evolutionCompositionFactory !== null &&
       typeof evolutionCompositionFactory !== "function"
@@ -22,6 +27,9 @@ export class WSChatHandler {
       throw new TypeError("evolutionCompositionFactory must be a function");
     }
     this._evolutionCompositionFactory = evolutionCompositionFactory;
+    if (prepareUiModelTurn !== null && typeof prepareUiModelTurn !== "function")
+      throw new TypeError("prepareUiModelTurn must be a function");
+    this._prepareUiModelTurn = prepareUiModelTurn;
     this.session = session;
     this.interaction = interaction;
     this._processing = false;
@@ -64,17 +72,22 @@ export class WSChatHandler {
       });
       runRecorded = true;
 
-      const turn = await prepareGovernedModelTurn(
-        this._evolutionCompositionFactory,
-        {
-          mode: "ws-chat-session",
-          messages: session.messages,
-        },
-      );
+      const turn = await (
+        this._prepareUiModelTurn ||
+        ((context) =>
+          prepareGovernedModelTurn(this._evolutionCompositionFactory, context))
+      )({
+        mode: "ws-chat-session",
+        messages: session.messages,
+      });
       const options = {
         provider: session.provider,
         model: session.model,
-        baseUrl: session.baseUrl || "http://localhost:11434",
+        baseUrl:
+          session.baseUrl ||
+          (session.provider === "ollama"
+            ? "http://localhost:11434"
+            : undefined),
         apiKey: session.apiKey,
         // Phase J — pipe WS session id so chat-core records token_usage
         // into the JSONL session store; visible via `cc session usage`.