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

package/dist/{chunk-NCGWJ3HS.js → chunk-GO5QW4YL.js}

@@ -1,15 +1,15 @@
 import { submit, emitRunEvent } from './chunk-K2VMFZQ5.js';
 import { enqueueSessionWrite, hydrateSession, persistTurnToTranscript, flushSessionWrites, appendSessionMessage, getSessionMessages, discardSession, clearSession } from './chunk-AWINL3ZC.js';
-import { IndexManager } from './chunk-2ZLVT7H3.js';
-import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-IJM7UGS5.js';
+import { IndexManager } from './chunk-CYKKYNOT.js';
+import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-XJZEBGXD.js';
 import { extractCodePlugins } from './chunk-2SFBB54R.js';
 import { createOpenAiCompatibleRuntime } from './chunk-55GB6JYQ.js';
 import { persistActiveMemoryTranscript } from './chunk-OR6XIWLB.js';
-import { writeSessionSummary, resolveMemoryRoot, MEMORY_KINDS, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-UNK4HNJH.js';
+import { writeSessionSummary, resolveMemoryRoot, MEMORY_KINDS, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-J2SH3PNH.js';
 import { FsSessionStore } from './chunk-AAEZSPTC.js';
 import { discoverProviderPlugins, validateApiKeyShape, getConfiguredBaseUrl, httpRequest, isFixtureApiKey, presentProviderCredentialEnvVars, buildDefaultSummarizer, shouldUseRealLocalRuntime, parseSseStream, CircuitBreaker, resolveRunProvider, mergeExplicitApiKey, resolveProviderChain, abortError, tryFirstEvent, relayStream, renderToolResultContentText } from './chunk-K3NH62DG.js';
 import { resolveChildEnv } from './chunk-HKCKOAIO.js';
-import { DEFAULT_MAX_BYTES_PER_FILE, runDiscovery, truncateWithMarker } from './chunk-ILGZ2ZZV.js';
+import { DEFAULT_MAX_BYTES_PER_FILE, runDiscovery, truncateWithMarker } from './chunk-N6OOOYFZ.js';
 import { readVersionedJson, writeVersionedJson } from './chunk-SVQIW5RJ.js';
 import { toJsonSchema } from './chunk-7I5Z3UBJ.js';
 import { sanitizeToolInput } from './chunk-FJWQP6EE.js';
@@ -24,8 +24,8 @@ import { expandTilde, defaultBaseDir } from './chunk-JOFVLOFY.js';
 import { withFileLock } from './chunk-TA3K7SBK.js';
 import { withCwdMutex } from './chunk-Q5EWJPRY.js';
 import { sweepStaleAtomicTemps, atomicWriteJson } from './chunk-3JHIFQ4I.js';
-import { loadSubagents, pluginBundleDirs } from './chunk-XCCGNU3D.js';
-import { reportUndeclaredSources, undefinedVariablesIn, getTheokitHome, adapterForConfigPath, projectConfigRoots, pluginBundleRoots } from './chunk-JTZ74HFD.js';
+import { loadSubagents, pluginBundleDirs } from './chunk-4S5TWFIZ.js';
+import { reportUndeclaredSources, theokitConfigRoot, undefinedVariablesIn, getTheokitHome, adapterForConfigPath, projectConfigRoots, pluginBundleRoots } from './chunk-67ADYSTW.js';
 import { readWorkspaceDir, parseSimpleYaml } from './chunk-JNAA4G4H.js';
 import { resolveEffectiveContextWindow, CONTEXT_WINDOW_FLOOR, CONTEXT_WINDOW_MARGIN } from './chunk-6M2OIS4Y.js';
 import { parseModelId } from './chunk-R7WIIPUR.js';
@@ -36,11 +36,11 @@ import { AgentRunError, coerceToKnownAgentRunErrorCode, UnknownAgentError, Confi
 import { diag, resolveApiKey, API_KEY_ENV_VAR, redactSecrets, diagFailure } from './chunk-CZJ6Q7CW.js';
 import { stat, mkdir, readFile, readdir, access, unlink } from 'fs/promises';
 import { randomUUID, createHash } from 'crypto';
-import { join, dirname, resolve, isAbsolute } from 'path';
+import { join, dirname, resolve, relative, isAbsolute } from 'path';
+import { existsSync, readFileSync } from 'fs';
 import { spawn } from 'child_process';
 import { z } from 'zod';
 import { createRequire } from 'module';
-import { existsSync } from 'fs';
 import { homedir } from 'os';
 
 // src/agent-builder.ts
@@ -269,7 +269,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 = join(".theokit", "agents", "registry.json");
+var REGISTRY_RELATIVE_SUFFIX = join("agents", "registry.json");
 function stripSecretsFromOptions(options) {
   return assignDefined({
     name: options.name,
@@ -379,7 +379,7 @@ function serializeAgents(agents2) {
   return out;
 }
 function registryPath(cwd) {
-  return join(cwd, REGISTRY_RELATIVE_PATH);
+  return join(theokitConfigRoot(cwd), REGISTRY_RELATIVE_SUFFIX);
 }
 async function loadRegistry(cwd) {
   void sweepStaleAtomicTemps(registryPath(cwd)).catch(() => void 0);
@@ -2518,6 +2518,37 @@ function removeAll(arr, toRemove) {
     if (idx !== -1) arr.splice(idx, 1);
   }
 }
+function readCompatConfigFile(cwd) {
+  const path = join(theokitConfigRoot(cwd), "config.json");
+  if (!existsSync(path)) return [];
+  let raw;
+  try {
+    raw = readFileSync(path, "utf8");
+  } catch {
+    return [];
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (cause) {
+    diag(
+      `[theokit] ${path} 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)) {
+    diag(`[theokit] ${path}: "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;
@@ -2818,7 +2849,9 @@ var SkillsManager = class {
   }
   async refresh() {
     const roots = this.skillsDir === void 0 ? [
-      ...projectConfigRoots(this.cwd, this.compatSources).map((root) => join(root, "skills")),
+      ...projectConfigRoots(this.cwd, this.compatSources, "skills").map(
+        (root) => join(root, "skills")
+      ),
       ...(await pluginBundleDirs(this.cwd, this.compatSources)).map((b) => join(b, "skills"))
     ] : [this.skillsDir];
     const discovered = [];
@@ -2963,7 +2996,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 };
@@ -4100,8 +4133,8 @@ var FileContextManager = class {
   }
 };
 async function loadContextConfig(cwd) {
-  const mdDir = join(cwd, ".theokit", "context");
-  const jsonPath = join(cwd, ".theokit", "context.json");
+  const mdDir = join(theokitConfigRoot(cwd), "context");
+  const jsonPath = join(theokitConfigRoot(cwd), "context.json");
   const mdEntities = await loadMarkdownEntities({
     dir: mdDir,
     schema: ContextSourceFrontmatterSchema,
@@ -4273,7 +4306,7 @@ var PluginsManager = class {
       const folderName = entry.name;
       const cliPath = join(pluginsRoot, folderName, ".claude-plugin", "plugin.json");
       if (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);
         }
@@ -4281,7 +4314,7 @@ var PluginsManager = class {
       }
       const mdPath = join(pluginsRoot, folderName, "PLUGIN.md");
       const jsonPath = join(pluginsRoot, folderName, "plugin.json");
-      const metadata = existsSync(mdPath) ? await loadPluginManifestFromMarkdown(pluginsRoot, folderName) : await loadPluginManifestFromJson(jsonPath, folderName);
+      const metadata = existsSync(mdPath) ? await loadPluginManifestFromMarkdown(this.cwd, pluginsRoot, folderName) : await loadPluginManifestFromJson(this.cwd, jsonPath, folderName);
       if (existsSync(mdPath) && existsSync(jsonPath)) {
         warnOnce(
           `plugin-${folderName}-both`,
@@ -4296,7 +4329,7 @@ var PluginsManager = class {
         );
       }
       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);
       }
     }
@@ -4304,10 +4337,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 = join(this.cwd, ".theokit", "plugins", folderName);
+    const pluginRoot = join(pluginsRoot, folderName);
     const entryPath = safePathJoin(pluginRoot, entry);
     try {
       await readFile(entryPath, "utf8");
@@ -4343,7 +4376,7 @@ var PluginsManager = class {
     }
   }
 };
-async function loadPluginManifestFromJson(manifestPath, folderName) {
+async function loadPluginManifestFromJson(cwd, manifestPath, folderName) {
   let raw;
   try {
     raw = await readFile(manifestPath, "utf8");
@@ -4371,12 +4404,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 = 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 = join(pluginsRoot, folderName, "PLUGIN.md");
   let raw;
   try {
@@ -4402,7 +4435,7 @@ async function loadPluginManifestFromMarkdown(pluginsRoot, folderName) {
     });
   }
   const fm = entity.frontmatter;
-  const source = mdPath.slice(mdPath.indexOf(".theokit/"));
+  const source = relative(cwd, mdPath);
   const metadata = {
     name: fm.name ?? folderName,
     version: fm.version ?? "0.0.0",
@@ -4458,14 +4491,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)
   };
 }
@@ -4479,7 +4518,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() };
@@ -7610,7 +7649,7 @@ async function dispatchLocalRun(args) {
   });
 }
 async function readProjectMcpServers(cwd) {
-  const path = join(cwd, ".theokit", "mcp.json");
+  const path = join(theokitConfigRoot(cwd), "mcp.json");
   try {
     const raw = await readFile(path, "utf8");
     const parsed = JSON.parse(raw);
@@ -8871,7 +8910,7 @@ var PersonalityFrontmatterSchema = 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;
@@ -8886,7 +8925,7 @@ var PersonalityRegistry = class _PersonalityRegistry {
    * @internal
    */
   static async load(cwd) {
-    const projectDir = join(cwd, PROJECT_SUBDIR);
+    const projectDir = join(theokitConfigRoot(cwd), PERSONALITIES_SUFFIX);
     const userDir = join(homedir(), USER_SUBDIR);
     const [userEntities, projectEntities] = await Promise.all([
       loadMarkdownEntities({
@@ -9070,7 +9109,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-S2EPIML7.js');
   const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
-  const { withPersonalityContext } = await import('./context-NZ2AC6S7.js');
+  const { withPersonalityContext } = await import('./context-Y7B7SI5X.js');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9861,7 +9900,7 @@ var LocalAgent = class {
     this.pluginsManager = sub.pluginsManager;
     if (sub.plugins !== void 0) this.plugins = sub.plugins;
     reportUnknownLocalOptions(options.local);
-    const compatSources = options.local?.compatSources ?? [];
+    const compatSources = resolveCompatSources(options, this.workspaceCwd);
     reportUndeclaredSources(this.workspaceCwd, compatSources);
     this.hooksExecutor = new HooksExecutor(this.workspaceCwd, compatSources);
     this.defaultMemoryProviderForLoop = createLocalAgentMemoryProvider({
@@ -9894,7 +9933,7 @@ var LocalAgent = class {
       this.workspaceCwd,
       this.settingSourcesIncludeProject,
       this.options.agents,
-      this.options.local?.compatSources ?? []
+      resolveCompatSources(this.options, this.workspaceCwd)
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
@@ -10843,7 +10882,7 @@ var Agent = class _Agent {
    */
   static async describe(agentId) {
     const agent = await getRegisteredAgentOrThrow(agentId);
-    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-LSKM2UIK.js');
+    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-Y6JFYXAY.js');
     const settingSources = agent.options.local?.settingSources;
     const subagents = await loadSubagents2(
       agent.cwd ?? process.cwd(),
@@ -10931,5 +10970,5 @@ async function openLocalStore(reg) {
 }
 
 export { Agent, AgentBuilder, DEFAULT_AGENTIC_MODEL_ID, MEMORY_EMBEDDING_ADAPTERS, Tool, ToolError, UsageAccumulator, computeCost, generateCronId, getPricingEntry, openRouterMemoryEmbeddingProviderAdapter };
-//# sourceMappingURL=chunk-NCGWJ3HS.js.map
-//# sourceMappingURL=chunk-NCGWJ3HS.js.map
+//# sourceMappingURL=chunk-GO5QW4YL.js.map
+//# sourceMappingURL=chunk-GO5QW4YL.js.map