@theokit/sdk 4.61.0 → 4.63.0

package/dist/index.cjs

@@ -3,22 +3,24 @@
 var chunkROYPRJH4_cjs = require('./chunk-ROYPRJH4.cjs');
 var chunkOBA6YK2R_cjs = require('./chunk-OBA6YK2R.cjs');
 var chunkGWC3HADL_cjs = require('./chunk-GWC3HADL.cjs');
+var chunkIRCJ7EHV_cjs = require('./chunk-IRCJ7EHV.cjs');
 var chunkP6A3M6VD_cjs = require('./chunk-P6A3M6VD.cjs');
 require('./chunk-QDED6YO6.cjs');
 var chunk6SBW4QR2_cjs = require('./chunk-6SBW4QR2.cjs');
 require('./chunk-XWL6O3SW.cjs');
 require('./chunk-VTYY7XL5.cjs');
-var chunk5IT6DUOO_cjs = require('./chunk-5IT6DUOO.cjs');
-var chunkR7YIVL3K_cjs = require('./chunk-R7YIVL3K.cjs');
+var chunkCASUEY42_cjs = require('./chunk-CASUEY42.cjs');
+var chunkNLXOGBRJ_cjs = require('./chunk-NLXOGBRJ.cjs');
 var chunkNGESVVJN_cjs = require('./chunk-NGESVVJN.cjs');
 require('./chunk-2DG7KW4L.cjs');
 require('./chunk-BUUUWQMB.cjs');
-var chunk6OBIWHDR_cjs = require('./chunk-6OBIWHDR.cjs');
+require('./chunk-UUP3MUZ6.cjs');
 require('./chunk-P6H23T43.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-EI2Q7SJ5.cjs');
 require('./chunk-GHX4P3V2.cjs');
-var chunk2UCFUSPW_cjs = require('./chunk-2UCFUSPW.cjs');
+require('./chunk-A4VHSE56.cjs');
+var chunkEHJEZAOO_cjs = require('./chunk-EHJEZAOO.cjs');
 require('./chunk-QI7WE46I.cjs');
 var chunkP5LCASTC_cjs = require('./chunk-P5LCASTC.cjs');
 require('./chunk-F3YZMOAU.cjs');
@@ -44,7 +46,8 @@ require('./chunk-ILCGLTSA.cjs');
 require('./chunk-CQGYNZ3K.cjs');
 require('./chunk-4I55V454.cjs');
 require('./chunk-BUIK7GUA.cjs');
-require('./chunk-SKXBJ2NU.cjs');
+require('./chunk-A4RAL2ER.cjs');
+require('./chunk-NXH4GPAQ.cjs');
 require('./chunk-2ADR2GSO.cjs');
 var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
 var chunk2C72DXQF_cjs = require('./chunk-2C72DXQF.cjs');
@@ -66,13 +69,12 @@ var crypto = require('crypto');
 var zod = require('zod');
 var promises = require('fs/promises');
 var path = require('path');
-var fs = require('fs');
 
 // src/agent-factory.ts
 function createAgentFactory(common) {
   return {
-    forSession: (agentId, overrides) => chunkR7YIVL3K_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
-    getOrCreate: (agentId, overrides) => chunkR7YIVL3K_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
+    forSession: (agentId, overrides) => chunkNLXOGBRJ_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
+    getOrCreate: (agentId, overrides) => chunkNLXOGBRJ_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
   };
 }
 function mergeAgentOptions(common, overrides, agentId) {
@@ -1019,47 +1021,6 @@ function foldLayers(entries, accumulatingKeys = []) {
   }
   return combined;
 }
-function diaryPath(cwd) {
-  return path.join(chunk2UCFUSPW_cjs.memoryDir(cwd), "dream-diary.md");
-}
-function renderDiaryEntry(entry) {
-  const stamp = new Date(entry.timestampMs).toISOString();
-  const hash = entryHash(entry).slice(0, 8);
-  return [
-    `## ${stamp}`,
-    "",
-    `- entry-hash: ${hash}`,
-    `- facts before: ${entry.factsBefore}`,
-    `- facts after: ${entry.factsAfter}`,
-    `- duplicates removed: ${entry.duplicatesRemoved}`,
-    `- clusters created: ${entry.clustersCreated}`,
-    `- notes written: ${entry.notesWritten}`,
-    ""
-  ].join("\n");
-}
-async function appendDiaryEntry(cwd, entry) {
-  const path = diaryPath(cwd);
-  let raw = "";
-  try {
-    raw = await promises.readFile(path, "utf8");
-  } catch {
-    raw = "# Dream Diary\n\n";
-  }
-  const next = `${raw.endsWith("\n") ? raw : `${raw}
-`}${renderDiaryEntry(entry)}`;
-  await chunkI6TGFUCO_cjs.replaceFileAtomic(path, next);
-}
-function entryHash(entry) {
-  return crypto.createHash("sha256").update(
-    [
-      entry.factsBefore,
-      entry.factsAfter,
-      entry.duplicatesRemoved,
-      entry.clustersCreated,
-      entry.notesWritten
-    ].join("|")
-  ).digest("hex");
-}
 
 // src/internal/memory/dreaming/phases.ts
 var DEFAULT_DEDUP_THRESHOLD = 0.95;
@@ -1200,13 +1161,17 @@ async function runInner(options) {
   const now = options.now ?? Date.now;
   const timestampMs = now();
   try {
-    const facts = await chunk2UCFUSPW_cjs.readFactsFromMarkdown(options.cwd);
+    const root = options.memoryRoot ?? chunkEHJEZAOO_cjs.resolveMemoryRoot(options.cwd);
+    const facts = await chunkEHJEZAOO_cjs.readFactsFromMarkdown(
+      options.cwd,
+      options.memoryRoot ? { directory: options.memoryRoot } : void 0
+    );
     if (facts.length === 0) {
       return emptyResult("skipped");
     }
     const dedup = await lightPhase(facts, options.embedding, options.dedupThreshold);
     const rem = await remPhase(dedup.kept, options.embedding, options.clusterThreshold);
-    const notesWritten = await writeConsolidatedNotes(options.cwd, rem.clusters, timestampMs);
+    const notesWritten = await writeConsolidatedNotes(root, rem.clusters, timestampMs);
     const result = {
       status: "ok",
       factsBefore: facts.length,
@@ -1216,7 +1181,7 @@ async function runInner(options) {
       notesWritten,
       diaryEntryHash: void 0
     };
-    await appendDiaryEntry(options.cwd, {
+    await chunkIRCJ7EHV_cjs.appendDiaryEntry(root, {
       timestampMs,
       factsBefore: result.factsBefore,
       factsAfter: result.factsAfter,
@@ -1232,9 +1197,9 @@ async function runInner(options) {
     return emptyResult("error");
   }
 }
-async function writeConsolidatedNotes(cwd, clusters, timestampMs) {
+async function writeConsolidatedNotes(root, clusters, timestampMs) {
   if (clusters.length === 0) return 0;
-  const notesDir = path.join(chunk2UCFUSPW_cjs.memoryDir(cwd), "notes");
+  const notesDir = path.join(root, "notes");
   await promises.mkdir(notesDir, { recursive: true });
   const isoSlug = new Date(timestampMs).toISOString().replace(/[^\dT]/g, "-");
   const file = path.join(notesDir, `dreamed-${isoSlug}.md`);
@@ -1300,8 +1265,8 @@ var Memory = {
       openArgs.embedding = await resolveEmbedding(opts.embedding, peer.MEMORY_EMBEDDING_ADAPTERS);
       return await peer.IndexManager.open(openArgs);
     }
-    const { IndexManager } = await import('./index-manager-RHPFVFSC.cjs');
-    openArgs.embedding = await resolveEmbedding(opts.embedding, chunkR7YIVL3K_cjs.MEMORY_EMBEDDING_ADAPTERS);
+    const { IndexManager } = await import('./index-manager-6TEEIWM7.cjs');
+    openArgs.embedding = await resolveEmbedding(opts.embedding, chunkNLXOGBRJ_cjs.MEMORY_EMBEDDING_ADAPTERS);
     return await IndexManager.open(openArgs);
   },
   /**
@@ -1312,7 +1277,7 @@ var Memory = {
    */
   async runDreamingSweep(opts) {
     const peer = await tryLoadSdkMemoryPeer();
-    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunkR7YIVL3K_cjs.MEMORY_EMBEDDING_ADAPTERS;
+    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunkNLXOGBRJ_cjs.MEMORY_EMBEDDING_ADAPTERS;
     const sweepArgs = await buildDreamingSweepArgs(opts, catalog);
     const result = peer !== null ? (
       // biome-ignore lint/suspicious/noExplicitAny: peer is dynamically loaded — structural compat ensured by sdk-memory
@@ -1346,6 +1311,7 @@ async function buildDreamingSweepArgs(opts, catalog) {
   const runtime = await resolveEmbedding(opts.embedding, catalog);
   return {
     cwd: opts.cwd,
+    memoryRoot: chunkEHJEZAOO_cjs.resolveMemoryRoot(opts.cwd, { directory: opts.directory }),
     embedding: runtime,
     ...opts.dedupThreshold !== void 0 ? { dedupThreshold: opts.dedupThreshold } : {},
     ...opts.clusterThreshold !== void 0 ? { clusterThreshold: opts.clusterThreshold } : {}
@@ -1377,145 +1343,6 @@ function extractRawId(id, expectedAdapterId) {
   }
   return id.slice(prefix.length);
 }
-async function readAllSqliteFacts(cwd) {
-  const dbPath = chunk6OBIWHDR_cjs.defaultIndexPath(cwd);
-  if (!fs.existsSync(dbPath)) return [];
-  const db = await chunk6OBIWHDR_cjs.openMemoryDb({ filePath: dbPath });
-  try {
-    const stmt = db.prepare("SELECT id, path, source, start_line, end_line, text FROM chunks");
-    const rows = stmt.all();
-    return rows.map((r) => ({
-      ...r,
-      namespace: "default",
-      scope: "agent",
-      user_id: "default"
-    }));
-  } finally {
-    db.close();
-  }
-}
-function nfcEqual(a, b) {
-  return a.normalize("NFC") === b.normalize("NFC");
-}
-async function migrateSqliteToLance(opts) {
-  const cwd = opts.cwd;
-  const finalPath = chunk6OBIWHDR_cjs.lanceStoragePath(cwd);
-  const newPath = path.join(cwd, ".theokit", "memory", "lance-new");
-  const rawLog = opts.logger ?? ((m) => console.log(m));
-  const log = (m) => rawLog(chunkJTB5Q42C_cjs.redactSecrets(m));
-  if (fs.existsSync(finalPath)) {
-    throw new chunkK3FW2XZD_cjs.ConfigurationError(
-      `Destination already exists: ${finalPath}. Remove it manually (\`rm -rf ${finalPath}\`) and re-run.`,
-      { code: "migration_destination_exists" }
-    );
-  }
-  if (fs.existsSync(newPath)) {
-    log(`Removing stale ${newPath} from a previous run...`);
-    fs.rmSync(newPath, { recursive: true, force: true });
-  }
-  log(`Reading SQLite facts from ${cwd}/.theokit/memory/index.sqlite ...`);
-  const sqliteFacts = await readAllSqliteFacts(cwd);
-  log(`SQLite has ${sqliteFacts.length} facts.`);
-  if (sqliteFacts.length === 0) {
-    return {
-      countSqlite: 0,
-      countLance: 0,
-      validated: true,
-      sampleComparisons: [],
-      lancePath: finalPath,
-      committed: false
-    };
-  }
-  const placeholderEmbedding = {
-    id: "migration-placeholder",
-    model: "deterministic-hash",
-    dimension: 8,
-    embed: async (texts) => {
-      return texts.map((t) => {
-        const arr = new Array(8).fill(0);
-        for (let i = 0; i < t.length; i += 1) {
-          arr[i % 8] += t.charCodeAt(i);
-        }
-        return arr.map((x) => x / 1e3);
-      });
-    },
-    stats: () => ({ cacheHits: 0, cacheMisses: 0, httpCalls: 0, retries: 0 })
-  };
-  fs.mkdirSync(newPath, { recursive: true });
-  log(`Writing Lance index to ${newPath} ...`);
-  const lance = await chunk6OBIWHDR_cjs.LanceIndex.open({
-    cwd,
-    embedding: placeholderEmbedding,
-    storagePath: newPath
-  });
-  const batchSize = opts.batchSize ?? 100;
-  for (let i = 0; i < sqliteFacts.length; i += batchSize) {
-    const batch = sqliteFacts.slice(i, i + batchSize).map((f) => ({
-      id: f.id,
-      text: f.text,
-      source: f.source,
-      namespace: f.namespace ?? "default",
-      scope: f.scope ?? "agent",
-      user_id: f.user_id ?? "default",
-      timestamp: 0
-    }));
-    await lance.addFacts(batch);
-    log(`  Migrated ${Math.min(i + batchSize, sqliteFacts.length)}/${sqliteFacts.length}`);
-  }
-  const lanceCount = await lance.countFacts("default");
-  log(`Lance has ${lanceCount} facts (expected ${sqliteFacts.length}).`);
-  const sampleSize = Math.min(10, sqliteFacts.length);
-  const sampleComparisons = [];
-  for (let i = 0; i < sampleSize; i += 1) {
-    const sqliteFact = sqliteFacts[Math.floor(i * sqliteFacts.length / sampleSize)];
-    if (sqliteFact === void 0) continue;
-    const hits = await lance.search(sqliteFact.text, {
-      namespace: sqliteFact.namespace ?? "default",
-      limit: 1
-    });
-    const hit = hits[0];
-    const match = hit !== void 0 && nfcEqual(hit.text, sqliteFact.text);
-    sampleComparisons.push({ id: sqliteFact.id, match });
-  }
-  const allMatch = sampleComparisons.every((c) => c.match);
-  const countMatch = lanceCount === sqliteFacts.length;
-  const validated = allMatch && countMatch;
-  await lance.close();
-  if (opts.dryRun === true) {
-    log("Dry-run mode \u2014 discarding Lance staging dir.");
-    fs.rmSync(newPath, { recursive: true, force: true });
-    return {
-      countSqlite: sqliteFacts.length,
-      countLance: lanceCount,
-      validated,
-      sampleComparisons,
-      lancePath: finalPath,
-      committed: false
-    };
-  }
-  if (!validated) {
-    log("Validation FAILED \u2014 leaving SQLite intact, removing Lance staging dir.");
-    fs.rmSync(newPath, { recursive: true, force: true });
-    return {
-      countSqlite: sqliteFacts.length,
-      countLance: lanceCount,
-      validated: false,
-      sampleComparisons,
-      lancePath: finalPath,
-      committed: false
-    };
-  }
-  fs.renameSync(newPath, finalPath);
-  log(`Migration committed to ${finalPath}.`);
-  return {
-    countSqlite: sqliteFacts.length,
-    countLance: lanceCount,
-    validated: true,
-    sampleComparisons,
-    lancePath: finalPath,
-    committed: true
-  };
-}
 
 // src/migrate.ts
 async function migrateSqliteToLance2(options) {
@@ -1523,7 +1350,7 @@ async function migrateSqliteToLance2(options) {
   if (peer !== null) {
     return peer.migrateSqliteToLance(options);
   }
-  return migrateSqliteToLance(options);
+  return chunkIRCJ7EHV_cjs.migrateSqliteToLance(options);
 }
 
 // src/permission-engine.ts
@@ -1874,7 +1701,7 @@ function isBuiltAgent(m) {
   return typeof m.send === "function";
 }
 async function materialize(def, index) {
-  const { Agent: Agent2 } = await import('./agent-M53C3PAA.cjs');
+  const { Agent: Agent2 } = await import('./agent-5KYMG63I.cjs');
   return Agent2.create({
     // `AgentDefinition.model` admits the sentinel `'inherit'`, which is not a model id. Inheriting
     // here means "declare nothing and let the default apply" — forwarding the literal would create
@@ -2016,7 +1843,7 @@ var FIXTURE_USER = {
 };
 var FIXTURE_MODELS = [
   {
-    id: chunkR7YIVL3K_cjs.DEFAULT_AGENTIC_MODEL_ID,
+    id: chunkNLXOGBRJ_cjs.DEFAULT_AGENTIC_MODEL_ID,
     name: "Gemini 2.0 Flash",
     displayName: "Gemini 2.0 Flash",
     parameters: [
@@ -2219,7 +2046,7 @@ var Theokit = class {
         envVars: p.envVars
       }));
     },
-    embeddingAdapters: () => Object.entries(chunkR7YIVL3K_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
+    embeddingAdapters: () => Object.entries(chunkNLXOGBRJ_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
       id,
       transport: adapter.transport,
       defaultModel: adapter.defaultModel
@@ -2438,35 +2265,35 @@ Object.defineProperty(exports, "fn", {
 });
 Object.defineProperty(exports, "Cron", {
   enumerable: true,
-  get: function () { return chunk5IT6DUOO_cjs.Cron; }
+  get: function () { return chunkCASUEY42_cjs.Cron; }
 });
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.Agent; }
+  get: function () { return chunkNLXOGBRJ_cjs.Agent; }
 });
 Object.defineProperty(exports, "AgentBuilder", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.AgentBuilder; }
+  get: function () { return chunkNLXOGBRJ_cjs.AgentBuilder; }
 });
 Object.defineProperty(exports, "Tool", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.Tool; }
+  get: function () { return chunkNLXOGBRJ_cjs.Tool; }
 });
 Object.defineProperty(exports, "ToolError", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.ToolError; }
+  get: function () { return chunkNLXOGBRJ_cjs.ToolError; }
 });
 Object.defineProperty(exports, "UsageAccumulator", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.UsageAccumulator; }
+  get: function () { return chunkNLXOGBRJ_cjs.UsageAccumulator; }
 });
 Object.defineProperty(exports, "computeCost", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.computeCost; }
+  get: function () { return chunkNLXOGBRJ_cjs.computeCost; }
 });
 Object.defineProperty(exports, "getPricingEntry", {
   enumerable: true,
-  get: function () { return chunkR7YIVL3K_cjs.getPricingEntry; }
+  get: function () { return chunkNLXOGBRJ_cjs.getPricingEntry; }
 });
 Object.defineProperty(exports, "emitRunEvent", {
   enumerable: true,