@theokit/sdk 4.15.1 → 4.15.3

package/dist/index.js

@@ -1790,19 +1790,51 @@ async function openConcrete(options) {
   await options.onOpen?.(db);
   return db;
 }
+function adaptNodeSqlite(db) {
+  const pragma = (statement, options) => {
+    const stmt = db.prepare(`PRAGMA ${statement}`);
+    const row = stmt.get();
+    if (options?.simple === true) {
+      return row === void 0 ? void 0 : Object.values(row)[0];
+    }
+    return row === void 0 ? [] : [row];
+  };
+  return new Proxy(db, {
+    get(target, prop, receiver) {
+      if (prop === "pragma") return pragma;
+      if (prop === "loadExtension" && typeof db.loadExtension !== "function") {
+        return () => {
+          throw new Error(
+            "SQLite extension loading is unavailable on the node:sqlite fallback \u2014 install better-sqlite3 for sqlite-vec"
+          );
+        };
+      }
+      const value = Reflect.get(target, prop, receiver);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+}
 async function loadDriver(filePath) {
+  let betterSqliteCause;
   try {
-    const mod = await import('better-sqlite3');
+    const mod = await (driverLoaderOverrides?.betterSqlite3?.() ?? import('better-sqlite3'));
     const Ctor = mod.default ?? mod;
     if (typeof Ctor !== "function") {
       throw new Error(`better-sqlite3 export is not a constructor (got ${typeof Ctor})`);
     }
     return new Ctor(filePath);
   } catch (cause) {
-    const message = cause instanceof Error ? cause.message : String(cause);
+    betterSqliteCause = cause;
+  }
+  try {
+    const mod = await (driverLoaderOverrides?.nodeSqlite?.() ?? import('sqlite'));
+    return adaptNodeSqlite(new mod.DatabaseSync(filePath));
+  } catch (nodeSqliteCause) {
+    const b = betterSqliteCause instanceof Error ? betterSqliteCause.message : String(betterSqliteCause);
+    const n = nodeSqliteCause instanceof Error ? nodeSqliteCause.message : String(nodeSqliteCause);
     throw new ConfigurationError(
-      `Failed to load SQLite driver. Install \`better-sqlite3\` or run on Node 22.5+ for built-in \`node:sqlite\`. Cause: ${message}`,
-      { code: "sqlite_driver_unavailable", cause }
+      `Failed to load SQLite driver. Install \`better-sqlite3\` or run on Node 22.5+ for built-in \`node:sqlite\`. better-sqlite3: ${b}; node:sqlite: ${n}`,
+      { code: "sqlite_driver_unavailable", cause: nodeSqliteCause }
     );
   }
 }
@@ -1821,6 +1853,7 @@ async function renameAside(filePath, label) {
 `
   );
 }
+var driverLoaderOverrides;
 var init_sqlite_open = __esm({
   "src/internal/persistence/sqlite-open.ts"() {
     init_errors();
@@ -9723,7 +9756,7 @@ var SkillsManager = class {
   }
   async refresh() {
     const skillsRoot = this.skillsDir ?? join(this.cwd, ".theokit", "skills");
-    const discovered2 = await discoverSkills(skillsRoot, {
+    const discovered = await discoverSkills(skillsRoot, {
       onInvalidSkill: (info) => {
         process.stderr.write(
           `[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
@@ -9731,13 +9764,13 @@ var SkillsManager = class {
         );
       }
     });
-    this.skills = this.mergeInline(discovered2);
+    this.skills = this.mergeInline(discovered);
   }
   /** M22 — merge inline skills over discovered ones; inline wins on a name conflict. */
-  mergeInline(discovered2) {
-    if (this.inline === void 0 || this.inline.length === 0) return discovered2;
+  mergeInline(discovered) {
+    if (this.inline === void 0 || this.inline.length === 0) return discovered;
     const inlineNames = new Set(this.inline.map((s) => s.name));
-    return [...discovered2.filter((s) => !inlineNames.has(s.name)), ...this.inline];
+    return [...discovered.filter((s) => !inlineNames.has(s.name)), ...this.inline];
   }
   list() {
     return Promise.resolve(this.skills);
@@ -11298,7 +11331,7 @@ var FileContextManager = class {
     const legacy = await loadSources(config, this.cwd);
     const maxBytesPerFile = this.settings.maxBytesPerFile ?? DEFAULT_MAX_BYTES_PER_FILE;
     const maxBytesTotal = this.settings.maxBytesTotal ?? DEFAULT_MAX_BYTES_TOTAL;
-    const discovered2 = await runDiscovery({
+    const discovered = await runDiscovery({
       cwd: this.cwd,
       maxBytesPerFile,
       touchedFiles
@@ -11311,7 +11344,7 @@ var FileContextManager = class {
       // matches DEFAULT_DISCOVERY_SPECS theokit-context
       truncated: false
     }));
-    const { kept } = applyAggregateCap([...discovered2, ...legacyAsAggregator], maxBytesTotal);
+    const { kept } = applyAggregateCap([...discovered, ...legacyAsAggregator], maxBytesTotal);
     const loadedSources = kept.map((s) => ({
       name: s.id,
       path: s.source,
@@ -14632,7 +14665,15 @@ function registerBuiltins() {
   registerProvider(CEREBRAS);
   registerCatalogProviders();
 }
-var discovered = false;
+function globalSingleton3(key2, create) {
+  const g = globalThis;
+  const sym = Symbol.for(key2);
+  if (g[sym] === void 0) g[sym] = create();
+  return g[sym];
+}
+var discoveryState = globalSingleton3("theokit-sdk.providers.discovered", () => ({
+  done: false
+}));
 function pluginsRoot() {
   return join(homedir(), ".theokit", "plugins", "model-providers");
 }
@@ -14646,8 +14687,16 @@ function loadTrustedNames() {
     try {
       const parsed = JSON.parse(readFileSync(path, "utf-8"));
       if (Array.isArray(parsed)) {
+        let discarded = 0;
         for (const name of parsed) {
           if (typeof name === "string" && name.length > 0) trusted.add(name);
+          else discarded += 1;
+        }
+        if (discarded > 0) {
+          process.stderr.write(
+            `[theokit-sdk] WARN: ${path} contains ${discarded} non-string entr${discarded === 1 ? "y" : "ies"} \u2014 discarded (entries must be plugin-name strings)
+`
+          );
         }
       } else {
         process.stderr.write(
@@ -14669,8 +14718,8 @@ function loadTrustedNames() {
   return trusted;
 }
 async function discoverProviderPlugins() {
-  if (discovered) return;
-  discovered = true;
+  if (discoveryState.done) return;
+  discoveryState.done = true;
   const root = pluginsRoot();
   if (!existsSync(root)) return;
   let entries;
@@ -14683,7 +14732,7 @@ async function discoverProviderPlugins() {
   for (const entry of entries) {
     if (!trusted.has(entry)) {
       process.stderr.write(
-        `[theokit-sdk] WARN: provider plugin "${entry}" is present but NOT trusted \u2014 skipped. To trust it, add "${entry}" to ${trustFilePath()} (JSON array) or THEOKIT_TRUSTED_PROVIDERS.
+        `[theokit-sdk] WARN: provider plugin "${entry}" is present but NOT trusted \u2014 skipped. To trust it, add "${entry}" to ${trustFilePath()} (JSON array of names) or THEOKIT_TRUSTED_PROVIDERS (comma-separated), then restart the process.
 `
       );
       continue;
@@ -18928,8 +18977,14 @@ var LocalAgentMemory = class {
       return this.toolsCache;
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(`[theokit-sdk] memory tools unavailable: ${message}
+      const g = globalThis;
+      const sym = /* @__PURE__ */ Symbol.for("theokit-sdk.memory.warned");
+      const warned3 = g[sym] ??= /* @__PURE__ */ new Set();
+      if (!warned3.has(message)) {
+        warned3.add(message);
+        process.stderr.write(`[theokit-sdk] memory tools unavailable: ${message}
 `);
+      }
       return void 0;
     }
   }
@@ -20315,6 +20370,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
+  await discoverProviderPlugins();
   await validateRehydratedAgent(agentId, existing);
   const mergedLocal = options.local !== void 0 && existing.options.local !== void 0 ? { ...existing.options.local, ...options.local } : options.local ?? existing.options.local;
   const mergedOptions = {
@@ -23393,6 +23449,7 @@ var Theokit = class {
 };
 async function maybeListLocalModels(providerName) {
   registerBuiltins();
+  await discoverProviderPlugins();
   const profile = getProviderProfile(providerName);
   if (profile === void 0) return void 0;
   if (profile.authType !== "none") return void 0;