@theokit/sdk 5.0.0-next.1 → 5.0.0-next.3

package/dist/{chunk-WMH2MSOP.cjs → chunk-K6VDRJ6I.cjs}

@@ -2,16 +2,16 @@
 
 var chunkKVSAY6NZ_cjs = require('./chunk-KVSAY6NZ.cjs');
 var chunkY2KYR2ED_cjs = require('./chunk-Y2KYR2ED.cjs');
-var chunk2NE7DTOK_cjs = require('./chunk-2NE7DTOK.cjs');
-var chunkHWSALKOR_cjs = require('./chunk-HWSALKOR.cjs');
+var chunkKBXADFBJ_cjs = require('./chunk-KBXADFBJ.cjs');
+var chunkH6YM3PV6_cjs = require('./chunk-H6YM3PV6.cjs');
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
 var chunkD6POWE7E_cjs = require('./chunk-D6POWE7E.cjs');
 var chunkTMKTSYDS_cjs = require('./chunk-TMKTSYDS.cjs');
-var chunkLHSWHYF3_cjs = require('./chunk-LHSWHYF3.cjs');
+var chunkRXZSVNDG_cjs = require('./chunk-RXZSVNDG.cjs');
 var chunk7FDKWDA2_cjs = require('./chunk-7FDKWDA2.cjs');
 var chunk2HPNT6HH_cjs = require('./chunk-2HPNT6HH.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
-var chunkRHZ6HP23_cjs = require('./chunk-RHZ6HP23.cjs');
+var chunkIU5N5224_cjs = require('./chunk-IU5N5224.cjs');
 var chunkRQMCOFAI_cjs = require('./chunk-RQMCOFAI.cjs');
 var chunkAA27GEYS_cjs = require('./chunk-AA27GEYS.cjs');
 var chunkYSTXFWQE_cjs = require('./chunk-YSTXFWQE.cjs');
@@ -26,8 +26,8 @@ var chunkGZV6AVRL_cjs = require('./chunk-GZV6AVRL.cjs');
 var chunkBJUJT5ED_cjs = require('./chunk-BJUJT5ED.cjs');
 var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
 var chunkJLRLCBJ4_cjs = require('./chunk-JLRLCBJ4.cjs');
-var chunkG4ZGYKJG_cjs = require('./chunk-G4ZGYKJG.cjs');
-var chunkCEILSTWB_cjs = require('./chunk-CEILSTWB.cjs');
+var chunkSYVWE64W_cjs = require('./chunk-SYVWE64W.cjs');
+var chunkGGZ5GPE3_cjs = require('./chunk-GGZ5GPE3.cjs');
 var chunkHW7SEELD_cjs = require('./chunk-HW7SEELD.cjs');
 var chunkATT276RD_cjs = require('./chunk-ATT276RD.cjs');
 var chunk3EE6LVWT_cjs = require('./chunk-3EE6LVWT.cjs');
@@ -39,10 +39,10 @@ var chunk6LHQPOMI_cjs = require('./chunk-6LHQPOMI.cjs');
 var promises = require('fs/promises');
 var crypto = require('crypto');
 var path = require('path');
+var fs = require('fs');
 var child_process = require('child_process');
 var zod = require('zod');
 var module$1 = require('module');
-var fs = require('fs');
 var os = require('os');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -272,7 +272,7 @@ function enabledPluginNames(plugins) {
 // src/internal/runtime/registry/agent-registry-store.ts
 var SCHEMA_VERSION = 1;
 var LEGACY_SCHEMA_VERSION_STRING = "1.0";
-var REGISTRY_RELATIVE_PATH = path.join(".theokit", "agents", "registry.json");
+var REGISTRY_RELATIVE_SUFFIX = path.join("agents", "registry.json");
 function stripSecretsFromOptions(options) {
   return assignDefined({
     name: options.name,
@@ -382,7 +382,7 @@ function serializeAgents(agents2) {
   return out;
 }
 function registryPath(cwd) {
-  return path.join(cwd, REGISTRY_RELATIVE_PATH);
+  return path.join(chunkGGZ5GPE3_cjs.theokitConfigRoot(cwd), REGISTRY_RELATIVE_SUFFIX);
 }
 async function loadRegistry(cwd) {
   void chunkJLRLCBJ4_cjs.sweepStaleAtomicTemps(registryPath(cwd)).catch(() => void 0);
@@ -817,7 +817,7 @@ async function readLegacyFacts(jsonPath) {
 }
 async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
-    for (const fact of facts) await chunkLHSWHYF3_cjs.appendFactToMarkdown(cwd, fact);
+    for (const fact of facts) await chunkRXZSVNDG_cjs.appendFactToMarkdown(cwd, fact);
     await promises.unlink(jsonPath).catch(() => void 0);
     chunk6LHQPOMI_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
 `);
@@ -834,11 +834,11 @@ async function migrateLegacyJson(cwd, config) {
   const key = `${cwd}::${config.namespace ?? "default"}::${config.scope ?? "agent"}::${config.userId ?? "default"}`;
   if (migrationRun.has(key)) return { migrated: false, factCount: 0, reason: "already-migrated" };
   migrationRun.add(key);
-  const jsonPath = chunkLHSWHYF3_cjs.legacyMemoryJsonPath(cwd, config);
+  const jsonPath = chunkRXZSVNDG_cjs.legacyMemoryJsonPath(cwd, config);
   if (!await fileExists(jsonPath)) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
-  if (await fileExists(chunkLHSWHYF3_cjs.memoryMdPath(chunkLHSWHYF3_cjs.resolveMemoryRoot(cwd, config)))) {
+  if (await fileExists(chunkRXZSVNDG_cjs.memoryMdPath(chunkRXZSVNDG_cjs.resolveMemoryRoot(cwd, config)))) {
     chunk6LHQPOMI_cjs.diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
@@ -867,19 +867,19 @@ function unstoredRememberWarning(message) {
   if (isMemoryWritePrompt(message) && extractMemoryFact(message).length > 0) return void 0;
   const trimmed = message.trim();
   const quoted = trimmed.length > QUOTED_MESSAGE_MAX ? `${trimmed.slice(0, QUOTED_MESSAGE_MAX)}\u2026` : trimmed;
-  return `[theokit-sdk] NOTHING WAS STORED \u2014 this message does not match the memory capture pattern: ${JSON.stringify(quoted)}. Supported: "Remember: <fact>" or "Remember (${chunkLHSWHYF3_cjs.MEMORY_KINDS.join("|")}): <fact>". It still reaches the session transcript, so a follow-up may answer from it \u2014 that is search over transcripts, not a durable memory.`;
+  return `[theokit-sdk] NOTHING WAS STORED \u2014 this message does not match the memory capture pattern: ${JSON.stringify(quoted)}. Supported: "Remember: <fact>" or "Remember (${chunkRXZSVNDG_cjs.MEMORY_KINDS.join("|")}): <fact>". It still reaches the session transcript, so a follow-up may answer from it \u2014 that is search over transcripts, not a durable memory.`;
 }
 function extractMemoryKind(message) {
   const match = REMEMBER_PATTERN.exec(message);
   const declared = match?.[1];
   if (declared === void 0) return void 0;
   const lowered = declared.toLowerCase();
-  return chunkLHSWHYF3_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
+  return chunkRXZSVNDG_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
 }
 async function readMemoryFacts(cwd, config) {
   if (!config.enabled) return [];
   await migrateLegacyJson(cwd, config);
-  return chunkLHSWHYF3_cjs.readFacts(cwd, config);
+  return chunkRXZSVNDG_cjs.readFacts(cwd, config);
 }
 async function appendMemoryFact(cwd, config, fact) {
   if (!config.enabled) return;
@@ -888,7 +888,7 @@ async function appendMemoryFact(cwd, config, fact) {
     text: chunk6LHQPOMI_cjs.redactSecrets(fact.text),
     ...fact.kind === void 0 ? {} : { kind: fact.kind }
   };
-  await chunkLHSWHYF3_cjs.appendFact(cwd, config, sanitized);
+  await chunkRXZSVNDG_cjs.appendFact(cwd, config, sanitized);
 }
 
 // src/internal/runtime/fixtures/fixture-scripts.ts
@@ -2121,14 +2121,14 @@ async function readState(filePath) {
   try {
     parsed = JSON.parse(raw);
   } catch {
-    chunkHWSALKOR_cjs.warnOnce(
+    chunkH6YM3PV6_cjs.warnOnce(
       "personality-store-json-parse",
       "[theokit-sdk] personality.json is malformed; treating as empty"
     );
     return emptyState();
   }
   if (!isStateV1(parsed)) {
-    chunkHWSALKOR_cjs.warnOnce(
+    chunkH6YM3PV6_cjs.warnOnce(
       "personality-store-bad-version",
       `[theokit-sdk] personality.json has unknown version; treating as empty (file kept untouched)`
     );
@@ -2159,7 +2159,7 @@ var PersonalityStore = class {
       try {
         await this.#persist(agentId, slug);
       } catch (err) {
-        chunkHWSALKOR_cjs.warnOnce(
+        chunkH6YM3PV6_cjs.warnOnce(
           `personality-store-persist-failure-${agentId}`,
           `[theokit-sdk] personality persist failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
             err.message
@@ -2176,7 +2176,7 @@ var PersonalityStore = class {
     try {
       state = await readState(filePath);
     } catch (err) {
-      chunkHWSALKOR_cjs.warnOnce(
+      chunkH6YM3PV6_cjs.warnOnce(
         `personality-store-hydrate-failure-${agentId}`,
         `[theokit-sdk] personality hydrate failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
           err.message
@@ -2205,7 +2205,7 @@ var PersonalityStore = class {
     });
   }
   #filePath() {
-    return path.join(chunkCEILSTWB_cjs.getTheokitHome(this.#cwd), FILE_NAME);
+    return path.join(chunkGGZ5GPE3_cjs.getTheokitHome(this.#cwd), FILE_NAME);
   }
 };
 
@@ -2521,6 +2521,37 @@ function removeAll(arr, toRemove) {
     if (idx !== -1) arr.splice(idx, 1);
   }
 }
+function readCompatConfigFile(cwd) {
+  const path$1 = path.join(chunkGGZ5GPE3_cjs.theokitConfigRoot(cwd), "config.json");
+  if (!fs.existsSync(path$1)) return [];
+  let raw;
+  try {
+    raw = fs.readFileSync(path$1, "utf8");
+  } catch {
+    return [];
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (cause) {
+    chunk6LHQPOMI_cjs.diag(
+      `[theokit] ${path$1} is not valid JSON \u2014 ignoring its "compat.adapters" (${cause.message}).
+`
+    );
+    return [];
+  }
+  const adapters = parsed.compat?.adapters;
+  if (adapters === void 0) return [];
+  if (!Array.isArray(adapters)) {
+    chunk6LHQPOMI_cjs.diag(`[theokit] ${path$1}: "compat.adapters" must be an array \u2014 ignoring it.
+`);
+    return [];
+  }
+  return adapters;
+}
+function resolveCompatSources(options, cwd) {
+  return options.local?.compatSources ?? readCompatConfigFile(cwd);
+}
 function spawnAndCollect(options) {
   return new Promise((resolve) => {
     const timeoutMs = options.timeoutMs ?? 3e4;
@@ -2583,7 +2614,7 @@ var HooksExecutor = class {
       this.config = {};
       return;
     }
-    this.config = await chunkHWSALKOR_cjs.loadHookConfig(this.cwd, this.compatSources);
+    this.config = await chunkH6YM3PV6_cjs.loadHookConfig(this.cwd, this.compatSources);
   }
   /** Fire every hook registered for `event` and aggregate the decisions. */
   async run(payload) {
@@ -2636,7 +2667,7 @@ var HooksExecutor = class {
     if (result.exitCode !== 0) {
       const stderr = result.stderr.trim();
       const base = stderr.length > 0 ? stderr : `Hook exited with code ${result.exitCode}`;
-      const missing = chunkCEILSTWB_cjs.undefinedVariablesIn(command.command, env);
+      const missing = chunkGGZ5GPE3_cjs.undefinedVariablesIn(command.command, env);
       if (missing.length === 0) return { decision: "deny", reason: base };
       return {
         decision: "deny",
@@ -2648,7 +2679,7 @@ var HooksExecutor = class {
 };
 function runtimeEnvFor(sourcePath, cwd) {
   if (sourcePath === void 0) return {};
-  return chunkCEILSTWB_cjs.adapterForConfigPath(sourcePath)?.runtimeEnv(cwd) ?? {};
+  return chunkGGZ5GPE3_cjs.adapterForConfigPath(sourcePath)?.runtimeEnv(cwd) ?? {};
 }
 function parseDecisionFromStdout(stdout) {
   const trimmed = stdout.trim();
@@ -2757,7 +2788,7 @@ async function runPostRunLifecycle(inputs) {
       cwd: workspaceCwd,
       // Resolved once, here, and handed to both writers. Recomputing it inside either one is how
       // the summary ended up in a directory the indexer never scanned (#463).
-      memoryRoot: chunkLHSWHYF3_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
+      memoryRoot: chunkRXZSVNDG_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
       runId: result.id,
       agentId,
       userText,
@@ -2769,7 +2800,7 @@ async function runPostRunLifecycle(inputs) {
       if (memoryProvider?.recordSessionSummary !== void 0) {
         await memoryProvider.recordSessionSummary(summaryArgs);
       } else {
-        await chunkLHSWHYF3_cjs.writeSessionSummary(summaryArgs);
+        await chunkRXZSVNDG_cjs.writeSessionSummary(summaryArgs);
       }
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
@@ -2821,8 +2852,10 @@ var SkillsManager = class {
   }
   async refresh() {
     const roots = this.skillsDir === void 0 ? [
-      ...chunkCEILSTWB_cjs.projectConfigRoots(this.cwd, this.compatSources).map((root) => path.join(root, "skills")),
-      ...(await chunkG4ZGYKJG_cjs.pluginBundleDirs(this.cwd, this.compatSources)).map((b) => path.join(b, "skills"))
+      ...chunkGGZ5GPE3_cjs.projectConfigRoots(this.cwd, this.compatSources, "skills").map(
+        (root) => path.join(root, "skills")
+      ),
+      ...(await chunkSYVWE64W_cjs.pluginBundleDirs(this.cwd, this.compatSources)).map((b) => path.join(b, "skills"))
     ] : [this.skillsDir];
     const discovered = [];
     const seen = /* @__PURE__ */ new Set();
@@ -2966,7 +2999,7 @@ async function resolveSendSkills(inputs, userText, memoryFacts) {
     inputs.settingSourcesIncludeProject,
     settings.skillsDir,
     settings.inline,
-    inputs.options.local?.compatSources ?? []
+    resolveCompatSources(inputs.options, inputs.workspaceCwd)
   );
   await manager.initialize();
   return { manager, autoInject: settings.autoInject ?? true };
@@ -3406,7 +3439,7 @@ var HISTOGRAM_NAMES = {
 };
 function safeRequire(moduleName) {
   try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-WMH2MSOP.cjs', document.baseURI).href)));
+    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-K6VDRJ6I.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3649,7 +3682,7 @@ var cachedOtel;
 function loadOtel() {
   if (cachedOtel === void 0) {
     try {
-      const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-WMH2MSOP.cjs', document.baseURI).href)));
+      const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-K6VDRJ6I.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -3968,7 +4001,7 @@ function applyAggregateCap(sources, maxTotal) {
     }
     const remaining = maxTotal - totalBytes;
     if (remaining > 0) {
-      const { finalContent } = chunkRHZ6HP23_cjs.truncateWithMarker(s.content, remaining);
+      const { finalContent } = chunkIU5N5224_cjs.truncateWithMarker(s.content, remaining);
       kept.push({ ...s, content: finalContent, truncated: true });
       totalBytes = maxTotal;
     } else {
@@ -4042,9 +4075,9 @@ var FileContextManager = class {
     this.lastScope = [...touchedFiles];
     const config = await loadContextConfig(this.cwd);
     const legacy = await loadSources(config, this.cwd);
-    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkRHZ6HP23_cjs.DEFAULT_MAX_BYTES_PER_FILE;
+    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkIU5N5224_cjs.DEFAULT_MAX_BYTES_PER_FILE;
     const maxBytesTotal = this.settings.maxBytesTotal ?? DEFAULT_MAX_BYTES_TOTAL;
-    const discovered = await chunkRHZ6HP23_cjs.runDiscovery({
+    const discovered = await chunkIU5N5224_cjs.runDiscovery({
       cwd: this.cwd,
       maxBytesPerFile,
       skipLegacyTheokitContext: true,
@@ -4103,8 +4136,8 @@ var FileContextManager = class {
   }
 };
 async function loadContextConfig(cwd) {
-  const mdDir = path.join(cwd, ".theokit", "context");
-  const jsonPath = path.join(cwd, ".theokit", "context.json");
+  const mdDir = path.join(chunkGGZ5GPE3_cjs.theokitConfigRoot(cwd), "context");
+  const jsonPath = path.join(chunkGGZ5GPE3_cjs.theokitConfigRoot(cwd), "context.json");
   const mdEntities = await loadMarkdownEntities({
     dir: mdDir,
     schema: ContextSourceFrontmatterSchema,
@@ -4113,7 +4146,7 @@ async function loadContextConfig(cwd) {
   });
   if (mdEntities.length > 0) {
     if (fs.existsSync(jsonPath)) {
-      chunkHWSALKOR_cjs.warnOnce(
+      chunkH6YM3PV6_cjs.warnOnce(
         "context-both-present",
         "[theokit-sdk] both .theokit/context/ and .theokit/context.json detected \u2014 using markdown; remove context.json"
       );
@@ -4123,7 +4156,7 @@ async function loadContextConfig(cwd) {
     };
   }
   if (!fs.existsSync(jsonPath)) return { sources: [] };
-  chunkHWSALKOR_cjs.warnOnce(
+  chunkH6YM3PV6_cjs.warnOnce(
     "context-json-deprecated",
     // Names no command: `theokit-migrate-config` was unpublished with the `bin` entry, and a warning
     // that tells you to run something the package does not ship is worse than one that tells you
@@ -4264,7 +4297,7 @@ var PluginsManager = class {
   }
   async refresh() {
     this.plugins = [];
-    for (const pluginsRoot of chunkCEILSTWB_cjs.pluginBundleRoots(this.cwd, this.compatSources)) {
+    for (const pluginsRoot of chunkGGZ5GPE3_cjs.pluginBundleRoots(this.cwd, this.compatSources)) {
       await this.refreshRoot(pluginsRoot);
     }
   }
@@ -4276,7 +4309,7 @@ var PluginsManager = class {
       const folderName = entry.name;
       const cliPath = path.join(pluginsRoot, folderName, ".claude-plugin", "plugin.json");
       if (fs.existsSync(cliPath)) {
-        const cliMetadata = await loadPluginManifestFromJson(cliPath, folderName);
+        const cliMetadata = await loadPluginManifestFromJson(this.cwd, cliPath, folderName);
         if (this.enabled === void 0 || this.enabled.includes(cliMetadata.name)) {
           this.plugins.push(cliMetadata);
         }
@@ -4284,22 +4317,22 @@ var PluginsManager = class {
       }
       const mdPath = path.join(pluginsRoot, folderName, "PLUGIN.md");
       const jsonPath = path.join(pluginsRoot, folderName, "plugin.json");
-      const metadata = fs.existsSync(mdPath) ? await loadPluginManifestFromMarkdown(pluginsRoot, folderName) : await loadPluginManifestFromJson(jsonPath, folderName);
+      const metadata = fs.existsSync(mdPath) ? await loadPluginManifestFromMarkdown(this.cwd, pluginsRoot, folderName) : await loadPluginManifestFromJson(this.cwd, jsonPath, folderName);
       if (fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunkHWSALKOR_cjs.warnOnce(
+        chunkH6YM3PV6_cjs.warnOnce(
           `plugin-${folderName}-both`,
           `[theokit-sdk] both ${folderName}/PLUGIN.md and ${folderName}/plugin.json detected \u2014 using markdown; remove plugin.json`
         );
       }
       if (!fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunkHWSALKOR_cjs.warnOnce(
+        chunkH6YM3PV6_cjs.warnOnce(
           "plugin-json-deprecated",
           // Same reason as the context.json warning: the CLI it used to name is no longer published.
           "[theokit-sdk] plugin.json manifests are deprecated; replace each with a PLUGIN.md"
         );
       }
       if (this.enabled === void 0 || this.enabled.includes(metadata.name)) {
-        await this.assertEntryFileExists(metadata, folderName);
+        await this.assertEntryFileExists(metadata, folderName, pluginsRoot);
         this.plugins.push(metadata);
       }
     }
@@ -4307,10 +4340,10 @@ var PluginsManager = class {
   list() {
     return Promise.resolve(this.plugins);
   }
-  async assertEntryFileExists(metadata, folderName) {
+  async assertEntryFileExists(metadata, folderName, pluginsRoot) {
     const entry = metadata.entry;
     if (entry === void 0) return;
-    const pluginRoot = path.join(this.cwd, ".theokit", "plugins", folderName);
+    const pluginRoot = path.join(pluginsRoot, folderName);
     const entryPath = chunk7A6535RA_cjs.safePathJoin(pluginRoot, entry);
     try {
       await promises.readFile(entryPath, "utf8");
@@ -4346,7 +4379,7 @@ var PluginsManager = class {
     }
   }
 };
-async function loadPluginManifestFromJson(manifestPath, folderName) {
+async function loadPluginManifestFromJson(cwd, manifestPath, folderName) {
   let raw;
   try {
     raw = await promises.readFile(manifestPath, "utf8");
@@ -4374,12 +4407,12 @@ async function loadPluginManifestFromJson(manifestPath, folderName) {
   const name = typeof record.name === "string" ? record.name : folderName;
   const version = typeof record.version === "string" ? record.version : "0.0.0";
   const capabilities = Array.isArray(record.capabilities) ? record.capabilities.filter((cap) => typeof cap === "string") : [];
-  const source = manifestPath.slice(manifestPath.indexOf(".theokit/"));
+  const source = path.relative(cwd, manifestPath);
   const metadata = { name, version, capabilities, source };
   if (typeof record.entry === "string") metadata.entry = record.entry;
   return metadata;
 }
-async function loadPluginManifestFromMarkdown(pluginsRoot, folderName) {
+async function loadPluginManifestFromMarkdown(cwd, pluginsRoot, folderName) {
   const mdPath = path.join(pluginsRoot, folderName, "PLUGIN.md");
   let raw;
   try {
@@ -4405,7 +4438,7 @@ async function loadPluginManifestFromMarkdown(pluginsRoot, folderName) {
     });
   }
   const fm = entity.frontmatter;
-  const source = mdPath.slice(mdPath.indexOf(".theokit/"));
+  const source = path.relative(cwd, mdPath);
   const metadata = {
     name: fm.name ?? folderName,
     version: fm.version ?? "0.0.0",
@@ -4461,14 +4494,20 @@ function buildSkills(args, out) {
     staticSkills?.inline,
     // #524 — the same declaration the per-send manager reads. Omitting it here would make
     // `agent.skills` disagree with the system prompt about which skills exist.
-    args.options.local?.compatSources ?? []
+    resolveCompatSources(args.options, args.workspaceCwd)
   );
   const localSkills = out.skillsManager;
   out.skills = {
     // Project to the public shape (name + description only). Inline skills carry
     // their body + references on the object; `list()` must never leak them —
     // the body is reachable exclusively through `get()`.
-    list: async () => (await localSkills.list()).map((s) => ({ name: s.name, description: s.description })),
+    list: async () => (await localSkills.list()).map((s) => ({
+      name: s.name,
+      description: s.description,
+      // The PATH, never the body. Dropping it with the body answered a question nobody asked and
+      // silenced the one #524 is about: which root did this skill come from.
+      ...s.source === void 0 ? {} : { source: s.source }
+    })),
     get: (name) => localSkills.get(name)
   };
 }
@@ -4482,7 +4521,7 @@ function buildPlugins(args, out) {
     args.settingSourcesIncludePlugins,
     false,
     void 0,
-    args.options.local?.compatSources ?? []
+    resolveCompatSources(args.options, args.workspaceCwd)
   );
   const localPlugins = out.pluginsManager;
   out.plugins = { list: () => localPlugins.list() };
@@ -7170,7 +7209,7 @@ function applyPersonalityFilter(exposedTools, whitelist, opts) {
     if (exposedSet.has(name)) continue;
     const hint = suggestClosest(name, exposedSet);
     const message = hint !== void 0 ? `[theokit-sdk] personality "${opts?.personalityName ?? "?"}" references unknown tool "${name}"; did you mean "${hint}"?` : `[theokit-sdk] personality "${opts?.personalityName ?? "?"}" references unknown tool "${name}" (not exposed)`;
-    chunkHWSALKOR_cjs.warnOnce(
+    chunkH6YM3PV6_cjs.warnOnce(
       `personality-tool-missing|${opts?.agentId ?? "?"}|${opts?.personalityName ?? "?"}|${name}`,
       message
     );
@@ -7613,7 +7652,7 @@ async function dispatchLocalRun(args) {
   });
 }
 async function readProjectMcpServers(cwd) {
-  const path$1 = path.join(cwd, ".theokit", "mcp.json");
+  const path$1 = path.join(chunkGGZ5GPE3_cjs.theokitConfigRoot(cwd), "mcp.json");
   try {
     const raw = await promises.readFile(path$1, "utf8");
     const parsed = JSON.parse(raw);
@@ -7855,7 +7894,7 @@ async function reloadLocalAgent(agent) {
   if (agent.context !== void 0) await agent.context.refresh();
   if (agent.skillsManager !== void 0) await agent.skillsManager.refresh();
   if (agent.pluginsManager !== void 0) await agent.pluginsManager.refresh();
-  return await chunkG4ZGYKJG_cjs.loadSubagents(
+  return await chunkSYVWE64W_cjs.loadSubagents(
     agent.workspaceCwd,
     agent.settingSourcesIncludeProject,
     agent.options.agents
@@ -8101,7 +8140,7 @@ async function finalize(args, queryMode, result) {
   };
   args.cache?.set(args.userText, queryMode, result, tenantCtx);
   if (args.persistTranscripts === true && args.cwd !== void 0) {
-    await chunkTMKTSYDS_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkLHSWHYF3_cjs.resolveMemoryRoot(args.cwd), {
+    await chunkTMKTSYDS_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkRXZSVNDG_cjs.resolveMemoryRoot(args.cwd), {
       runId: args.runId ?? `run-${Date.now()}`,
       startedAtMs: Date.now() - result.durationMs,
       userText: args.userText,
@@ -8692,7 +8731,7 @@ var LocalAgentMemory = class {
       const openOpts = { cwd: this.workspaceCwd, memoryRoot };
       if (embedding !== void 0) openOpts.embedding = embedding;
       if (cfg?.backend !== void 0) openOpts.backend = cfg.backend;
-      this.index = await chunk2NE7DTOK_cjs.IndexManager.open(openOpts);
+      this.index = await chunkKBXADFBJ_cjs.IndexManager.open(openOpts);
       await this.index.sync();
       this.toolsCache = [
         createMemorySearchTool({ index: this.index }),
@@ -8736,7 +8775,7 @@ var LocalAgentMemory = class {
    * and the active-memory transcript writer. Three separate resolutions is how they drifted (#463).
    */
   memoryRoot() {
-    this.memoryRootCache ??= chunkLHSWHYF3_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
+    this.memoryRootCache ??= chunkRXZSVNDG_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
     return this.memoryRootCache;
   }
   buildActiveMemoryOptions(cfg) {
@@ -8851,7 +8890,7 @@ function createLocalAgentMemoryProvider(opts) {
       return { facts: [], systemPromptAdditions: summary };
     },
     async recordSessionSummary(args) {
-      await chunkLHSWHYF3_cjs.writeSessionSummary(args);
+      await chunkRXZSVNDG_cjs.writeSessionSummary(args);
     },
     async sync(handle) {
       const state = handle[INTERNAL_LAM_KEY];
@@ -8874,7 +8913,7 @@ var PersonalityFrontmatterSchema = zod.z.object({
 var RESERVED_CLEAR_SLUGS = ["none", "default", "neutral"];
 
 // src/internal/personality/registry.ts
-var PROJECT_SUBDIR = ".theokit/personalities";
+var PERSONALITIES_SUFFIX = "personalities";
 var USER_SUBDIR = ".theokit/personalities";
 var PersonalityRegistry = class _PersonalityRegistry {
   #byName;
@@ -8889,7 +8928,7 @@ var PersonalityRegistry = class _PersonalityRegistry {
    * @internal
    */
   static async load(cwd) {
-    const projectDir = path.join(cwd, PROJECT_SUBDIR);
+    const projectDir = path.join(chunkGGZ5GPE3_cjs.theokitConfigRoot(cwd), PERSONALITIES_SUFFIX);
     const userDir = path.join(os.homedir(), USER_SUBDIR);
     const [userEntities, projectEntities] = await Promise.all([
       loadMarkdownEntities({
@@ -8941,7 +8980,7 @@ function addEntity(byName, entity, origin, collisionMap) {
     );
   }
   if (origin === "project" && collisionMap?.has(fm.name)) {
-    chunkHWSALKOR_cjs.warnOnce(
+    chunkH6YM3PV6_cjs.warnOnce(
       `personality-collision-${fm.name}`,
       `[theokit-sdk] personality "${fm.name}" overridden by project preset`
     );
@@ -8991,14 +9030,14 @@ async function performPersonalitySwitch(args) {
 
 // src/internal/local-agent/local-agent-personality-extensions.ts
 function resolveActivePersonalityPreset(args) {
-  const forkCtx = chunkHWSALKOR_cjs.currentPersonalityContext();
+  const forkCtx = chunkH6YM3PV6_cjs.currentPersonalityContext();
   const slug = forkCtx !== void 0 ? forkCtx.slug : args.personalityStore.active(args.agentId);
   if (slug === void 0) return void 0;
   return args.personalityRegistry?.get(slug);
 }
 async function ensurePersonalityRegistryIfNeeded(args) {
   if (args.personalityRegistry !== void 0) return args.personalityRegistry;
-  const forkSlug = chunkHWSALKOR_cjs.currentPersonalityContext()?.slug;
+  const forkSlug = chunkH6YM3PV6_cjs.currentPersonalityContext()?.slug;
   const ownSlug = args.personalityStore.active(args.agentId);
   if (forkSlug === void 0 && ownSlug === void 0) return void 0;
   return await PersonalityRegistry.load(args.workspaceCwd);
@@ -9011,8 +9050,8 @@ function applyPersonalityOverlay(preset, base) {
 ${preset.systemPrompt}`;
 }
 async function localAgentUsePersonality(agent, name, opts) {
-  if (chunkHWSALKOR_cjs.currentPersonalityContext() !== void 0) {
-    chunkHWSALKOR_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
+  if (chunkH6YM3PV6_cjs.currentPersonalityContext() !== void 0) {
+    chunkH6YM3PV6_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
     return null;
   }
   if (agent.personalityRegistry === void 0) {
@@ -9073,7 +9112,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-WAEQI2DL.cjs');
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
-  const { withPersonalityContext } = await import('./context-74SBFD27.cjs');
+  const { withPersonalityContext } = await import('./context-NI33FS2R.cjs');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9864,8 +9903,8 @@ var LocalAgent = class {
     this.pluginsManager = sub.pluginsManager;
     if (sub.plugins !== void 0) this.plugins = sub.plugins;
     reportUnknownLocalOptions(options.local);
-    const compatSources = options.local?.compatSources ?? [];
-    chunkCEILSTWB_cjs.reportUndeclaredSources(this.workspaceCwd, compatSources);
+    const compatSources = resolveCompatSources(options, this.workspaceCwd);
+    chunkGGZ5GPE3_cjs.reportUndeclaredSources(this.workspaceCwd, compatSources);
     this.hooksExecutor = new HooksExecutor(this.workspaceCwd, compatSources);
     this.defaultMemoryProviderForLoop = createLocalAgentMemoryProvider({
       agentOptions: options,
@@ -9893,11 +9932,11 @@ var LocalAgent = class {
     if (this.pluginsManager !== void 0) await this.pluginsManager.initialize();
     const codePlugins = chunkBV2MWEMV_cjs.extractCodePlugins(this.options.plugins);
     await this.pluginManagerCode.initialize(codePlugins);
-    this.resolvedSubagents = await chunkG4ZGYKJG_cjs.loadSubagents(
+    this.resolvedSubagents = await chunkSYVWE64W_cjs.loadSubagents(
       this.workspaceCwd,
       this.settingSourcesIncludeProject,
       this.options.agents,
-      this.options.local?.compatSources ?? []
+      resolveCompatSources(this.options, this.workspaceCwd)
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
@@ -10846,7 +10885,7 @@ var Agent = class _Agent {
    */
   static async describe(agentId) {
     const agent = await getRegisteredAgentOrThrow(agentId);
-    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-YWFE7KYE.cjs');
+    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-TPZLTXYZ.cjs');
     const settingSources = agent.options.local?.settingSources;
     const subagents = await loadSubagents2(
       agent.cwd ?? process.cwd(),
@@ -10944,5 +10983,5 @@ exports.computeCost = computeCost;
 exports.generateCronId = generateCronId;
 exports.getPricingEntry = getPricingEntry;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
-//# sourceMappingURL=chunk-WMH2MSOP.cjs.map
-//# sourceMappingURL=chunk-WMH2MSOP.cjs.map
+//# sourceMappingURL=chunk-K6VDRJ6I.cjs.map
+//# sourceMappingURL=chunk-K6VDRJ6I.cjs.map