@cuylabs/agent-core 0.11.0 → 0.13.0

package/dist/{chunk-GFTW23FV.js → chunk-BGG2HVIR.js}

@@ -1,7 +1,7 @@
 import {
   createSkillRegistry,
   emptySkillRegistry
-} from "./chunk-SPILYYDF.js";
+} from "./chunk-I7EJGKUP.js";
 import {
   extractModelId,
   extractProvider
@@ -311,7 +311,9 @@ function formatInstructions(files, basePath) {
   for (const file of files) {
     const displayPath = basePath ? file.path.replace(basePath + sep, "").replace(basePath, "") : basename2(file.path);
     blocks.push("");
-    blocks.push(`<instructions source="${displayPath}" scope="${file.source}">`);
+    blocks.push(
+      `<instructions source="${displayPath}" scope="${file.source}">`
+    );
     blocks.push(file.content);
     blocks.push("</instructions>");
   }

package/dist/{chunk-TOTDGK3P.js → chunk-CSR75JVC.js}

@@ -16,7 +16,9 @@ ${skillList}
 
 Only load a skill when the current task clearly matches its description. Skills provide detailed workflows, reference material, and scripts.`,
       parameters: z.object({
-        name: z.string().describe("The name of the skill to load (must match one of the available skills)")
+        name: z.string().describe(
+          "The name of the skill to load (must match one of the available skills)"
+        )
       }),
       execute: async ({ name }) => {
         const content = await registry.loadContent(name);
@@ -78,10 +80,7 @@ function createSkillResourceTool(registry) {
 }
 function createSkillTools(registry) {
   if (registry.size === 0) return [];
-  return [
-    createSkillTool(registry),
-    createSkillResourceTool(registry)
-  ];
+  return [createSkillTool(registry), createSkillResourceTool(registry)];
 }
 
 export {

package/dist/{chunk-ICZ66572.js → chunk-CZ5XOVDV.js}

@@ -44,7 +44,8 @@ function serializeMessage(message) {
     if ("tokens" in message) serialized.tokens = message.tokens;
     if ("cost" in message) serialized.cost = message.cost;
     if ("error" in message) serialized.error = message.error;
-    if ("toolCalls" in message && message.toolCalls) serialized.toolCalls = message.toolCalls;
+    if ("toolCalls" in message && message.toolCalls)
+      serialized.toolCalls = message.toolCalls;
   }
   if (message.role === "tool") {
     if ("toolCallId" in message) serialized.toolCallId = message.toolCallId;
@@ -163,7 +164,9 @@ function getLeafId(entries) {
   const hasChildren = /* @__PURE__ */ new Set();
   for (const children of childMap.values()) {
     for (const child of children) {
-      const entry = entries.find((e) => e.type !== "header" && e.id === child);
+      const entry = entries.find(
+        (e) => e.type !== "header" && e.id === child
+      );
       if (entry && entry.type !== "header") {
         const parentId = entry.parentId;
         if (parentId) hasChildren.add(parentId);
@@ -281,7 +284,15 @@ var MemoryStorage = class {
 };
 
 // src/storage/file/helpers.ts
-import { appendFile, mkdir, readFile, readdir, stat, unlink, writeFile } from "fs/promises";
+import {
+  appendFile,
+  mkdir,
+  readFile,
+  readdir,
+  stat,
+  unlink,
+  writeFile
+} from "fs/promises";
 import { existsSync } from "fs";
 import { basename, join } from "path";
 async function ensureStorageDirectory(directory) {
@@ -391,7 +402,10 @@ var FileStorage = class {
     if (this.useCache && this.cache.has(sessionId)) {
       return this.cache.get(sessionId);
     }
-    const entries = await loadEntriesFromDisk(this.getPath(sessionId), sessionId);
+    const entries = await loadEntriesFromDisk(
+      this.getPath(sessionId),
+      sessionId
+    );
     if (this.useCache) {
       this.cache.set(sessionId, entries);
     }
@@ -448,9 +462,15 @@ var FileStorage = class {
   async list() {
     await this.ensureDir();
     const infos = [];
-    for (const sessionId of await listSessionIds(this.directory, this.extension)) {
+    for (const sessionId of await listSessionIds(
+      this.directory,
+      this.extension
+    )) {
       try {
-        const info = extractSessionInfo(await this.getEntries(sessionId), this.getPath(sessionId));
+        const info = extractSessionInfo(
+          await this.getEntries(sessionId),
+          this.getPath(sessionId)
+        );
         if (info) {
           infos.push(info);
         }
@@ -490,7 +510,10 @@ function getDataDir(appName = "cuylabs") {
     return join2(homedir(), `.${appName}`);
   }
   if (platform === "win32") {
-    return join2(process.env.APPDATA || join2(homedir(), "AppData", "Roaming"), appName);
+    return join2(
+      process.env.APPDATA || join2(homedir(), "AppData", "Roaming"),
+      appName
+    );
   }
   const xdgData = process.env.XDG_DATA_HOME || join2(homedir(), ".local", "share");
   return join2(xdgData, appName);
@@ -575,7 +598,11 @@ var SessionManager = class {
     if (!this.currentSessionId) {
       throw new Error("No session loaded");
     }
-    const entry = createMessageEntry(message, this.currentLeafId, this.idsCache);
+    const entry = createMessageEntry(
+      message,
+      this.currentLeafId,
+      this.idsCache
+    );
     await this.storage.append(this.currentSessionId, entry);
     this.entriesCache.push(entry);
     this.idsCache.add(entry.id);
@@ -690,7 +717,11 @@ var SessionManager = class {
     if (!this.currentSessionId) {
       throw new Error("No session loaded");
     }
-    const entry = createMetadataEntry(updates, this.currentLeafId, this.idsCache);
+    const entry = createMetadataEntry(
+      updates,
+      this.currentLeafId,
+      this.idsCache
+    );
     await this.storage.append(this.currentSessionId, entry);
     this.entriesCache.push(entry);
     this.idsCache.add(entry.id);

package/dist/{chunk-2O4MCSQS.js → chunk-FYC33XFI.js}

@@ -1,9 +1,9 @@
 import {
   Profiles
-} from "./chunk-6HZBHFOL.js";
+} from "./chunk-TPZ37IWI.js";
 import {
   createLocalDispatchRuntime
-} from "./chunk-SSFBF3US.js";
+} from "./chunk-JPBFAQNS.js";
 import {
   Tool
 } from "./chunk-Q742PSH3.js";
@@ -168,7 +168,9 @@ Guidelines:
 }
 function toCompletedResult(record) {
   if (!record.result || !record.sessionId) {
-    throw new Error(`Dispatch "${record.id}" did not produce a completed result.`);
+    throw new Error(
+      `Dispatch "${record.id}" did not produce a completed result.`
+    );
   }
   return {
     response: record.result.response,
@@ -200,7 +202,9 @@ function formatTerminalFailure(record) {
     );
   }
   return formatWaitErrorResult(
-    new Error(`Subagent "${record.id}" is in unexpected state "${record.status}".`)
+    new Error(
+      `Subagent "${record.id}" is in unexpected state "${record.status}".`
+    )
   );
 }
 function createInvokeAgentTool(runtime, roles, options) {
@@ -238,7 +242,11 @@ function createInvokeAgentTool(runtime, roles, options) {
         );
       }
       if (isAsync) {
-        return formatAsyncSpawnedResult(started.id, role.name, started.sessionId);
+        return formatAsyncSpawnedResult(
+          started.id,
+          role.name,
+          started.sessionId
+        );
       }
       try {
         const finished = await waitForTerminalDispatch(runtime, started.id);
@@ -377,7 +385,9 @@ function getConfiguredSubAgents(agent) {
   return installedSubAgents.get(agent)?.config;
 }
 function getInstalledSubAgentBackend(agent) {
-  const backend = installedSubAgents.get(agent)?.backend;
+  const backend = installedSubAgents.get(
+    agent
+  )?.backend;
   return backend && backend !== "uninstalled" ? backend : void 0;
 }
 function clearInstalledSubAgents(agent) {
@@ -517,7 +527,9 @@ function parseSubAgentToolSpec(raw) {
   if (parts.length === 0) {
     return { mode: "inherit" };
   }
-  const hasModified = parts.some((part) => part.startsWith("+") || part.startsWith("-"));
+  const hasModified = parts.some(
+    (part) => part.startsWith("+") || part.startsWith("-")
+  );
   if (hasModified) {
     return {
       mode: "modifiers",
@@ -553,7 +565,10 @@ function toSubAgentRole(parsed, resolvers = {}) {
   const toolSpec = parseSubAgentToolSpec(frontmatter.tools);
   if (toolSpec.mode === "explicit" || toolSpec.mode === "modifiers") {
     resolvedProfile = {
-      ...resolvedProfile ?? { name: "custom", description: "Markdown-defined role" }
+      ...resolvedProfile ?? {
+        name: "custom",
+        description: "Markdown-defined role"
+      }
     };
     if (toolSpec.mode === "explicit") {
       resolvedProfile.allowTools = toolSpec.patterns;
@@ -643,7 +658,10 @@ function loadRoleDir(dir, source, resolvers, errors, onRole) {
       const content = readFileSync(filePath, "utf-8");
       const parsed = parseMarkdownSubAgentRole(content, filePath);
       if (!parsed) {
-        errors.push({ path: filePath, error: "Missing required frontmatter (name, description)" });
+        errors.push({
+          path: filePath,
+          error: "Missing required frontmatter (name, description)"
+        });
         continue;
       }
       const role = toSubAgentRole(parsed, resolvers);
@@ -668,7 +686,10 @@ function loadRoleFile(filePath, source, resolvers, errors, onRole) {
     const content = readFileSync(filePath, "utf-8");
     const parsed = parseMarkdownSubAgentRole(content, filePath);
     if (!parsed) {
-      errors.push({ path: filePath, error: "Missing required frontmatter (name, description)" });
+      errors.push({
+        path: filePath,
+        error: "Missing required frontmatter (name, description)"
+      });
       return null;
     }
     const role = toSubAgentRole(parsed, resolvers);

package/dist/{chunk-WBPOZ7CL.js → chunk-HNEI7JVE.js}

@@ -1,19 +1,17 @@
 import {
   Inference,
   buildModelCallContext
-} from "./chunk-CMYN2RCB.js";
+} from "./chunk-NWQUZWLT.js";
 import {
-  PRUNE_PROTECTED_TOOLS,
-  accumulateUsage,
   currentScope,
   executeAgentToolCall,
   snapshotScope,
   streamWithinScope,
   withinScope
-} from "./chunk-5NVVNXPQ.js";
+} from "./chunk-ZKEC7MFQ.js";
 import {
   LLMError
-} from "./chunk-N3VX7FEE.js";
+} from "./chunk-STDJYXYK.js";
 import {
   extractModelId,
   extractProvider
@@ -23,7 +21,7 @@ import {
 } from "./chunk-FII65CN7.js";
 import {
   silentLogger
-} from "./chunk-T4UIX5D7.js";
+} from "./chunk-S6AKEPAX.js";
 
 // src/execution/task/observer.ts
 function defaultAgentTaskCheckpointStrategy(input) {
@@ -321,13 +319,21 @@ function createAgentTaskRunner(agent, options = {}) {
             event,
             createdAt: turnState.updatedAt
           };
-          await notifyObservers(baseObservers, async (observer) => {
-            await observer.onCheckpoint?.(checkpoint);
-          }, log);
+          await notifyObservers(
+            baseObservers,
+            async (observer) => {
+              await observer.onCheckpoint?.(checkpoint);
+            },
+            log
+          );
         };
-        await notifyObservers(baseObservers, async (observer) => {
-          await observer.onTaskStart?.(run, createSnapshot());
-        }, log);
+        await notifyObservers(
+          baseObservers,
+          async (observer) => {
+            await observer.onTaskStart?.(run, createSnapshot());
+          },
+          log
+        );
         await emitCheckpoint("task-start");
         const activateCtx = baseObservers.find((o) => o.activateContext)?.activateContext?.bind(void 0, sessionId, executionId);
         try {
@@ -341,9 +347,13 @@ function createAgentTaskRunner(agent, options = {}) {
                 toolCalls.push({ name: event.toolName, result: event.result });
               }
               const snapshot = createSnapshot();
-              await notifyObservers(baseObservers, async (observer) => {
-                await observer.onTaskEvent?.(run, event, snapshot);
-              }, log);
+              await notifyObservers(
+                baseObservers,
+                async (observer) => {
+                  await observer.onTaskEvent?.(run, event, snapshot);
+                },
+                log
+              );
               const checkpointReason = checkpointStrategy({
                 run,
                 event,
@@ -368,16 +378,28 @@ function createAgentTaskRunner(agent, options = {}) {
             usage: { ...turnState.usage },
             toolCalls
           };
-          await notifyObservers(baseObservers, async (observer) => {
-            await observer.onTaskComplete?.(run, result, createSnapshot());
-          }, log);
+          await notifyObservers(
+            baseObservers,
+            async (observer) => {
+              await observer.onTaskComplete?.(run, result, createSnapshot());
+            },
+            log
+          );
           return result;
         } catch (error) {
           const normalizedError = error instanceof Error ? error : new Error(String(error));
           turnState = failAgentTurnState(turnState, normalizedError, nowIso());
-          await notifyObservers(baseObservers, async (observer) => {
-            await observer.onTaskError?.(run, normalizedError, createSnapshot());
-          }, log);
+          await notifyObservers(
+            baseObservers,
+            async (observer) => {
+              await observer.onTaskError?.(
+                run,
+                normalizedError,
+                createSnapshot()
+              );
+            },
+            log
+          );
           await emitCheckpoint("task-error");
           throw normalizedError;
         }
@@ -633,6 +655,9 @@ function estimateConversationTokens(messages) {
   return total;
 }
 
+// src/types/compaction.ts
+var PRUNE_PROTECTED_TOOLS = ["skill"];
+
 // src/agent/context/pruning.ts
 var DEFAULT_CONTEXT_LIMITS = {
   contextWindow: 128e3,
@@ -744,18 +769,36 @@ async function pruneContext(messages, options = {}) {
   let summary;
   const initialTokens = estimateConversationTokens(currentMessages);
   if (!shouldPruneContext(initialTokens, limits)) {
-    return { messages: currentMessages, removedCount: 0, tokensRemoved: 0, summarized: false };
+    return {
+      messages: currentMessages,
+      removedCount: 0,
+      tokensRemoved: 0,
+      summarized: false
+    };
   }
-  const prunedMessages = pruneToolResults(currentMessages, limits.protectedTokens);
+  const prunedMessages = pruneToolResults(
+    currentMessages,
+    limits.protectedTokens
+  );
   const afterPruneTokens = estimateConversationTokens(prunedMessages);
   tokensRemoved = initialTokens - afterPruneTokens;
   currentMessages = prunedMessages;
   if (!isContextOverflowing(afterPruneTokens, limits)) {
-    return { messages: currentMessages, removedCount: 0, tokensRemoved, summarized: false };
+    return {
+      messages: currentMessages,
+      removedCount: 0,
+      tokensRemoved,
+      summarized: false
+    };
   }
   const cutIndex = findCutPoint(currentMessages, limits.protectedTokens);
   if (cutIndex === 0) {
-    return { messages: currentMessages, removedCount: 0, tokensRemoved, summarized: false };
+    return {
+      messages: currentMessages,
+      removedCount: 0,
+      tokensRemoved,
+      summarized: false
+    };
   }
   const toSummarize = currentMessages.slice(0, cutIndex);
   const toKeep = currentMessages.slice(cutIndex);
@@ -779,7 +822,13 @@ ${summary}`,
   } else {
     currentMessages = toKeep;
   }
-  return { messages: currentMessages, removedCount, tokensRemoved, summarized, summary };
+  return {
+    messages: currentMessages,
+    removedCount,
+    tokensRemoved,
+    summarized,
+    summary
+  };
 }
 
 // src/agent/context/manager.ts
@@ -1327,6 +1376,29 @@ async function* runModelStep(options) {
   );
 }
 
+// src/types/messages.ts
+function accumulateUsage(current, next) {
+  if (!next) return current;
+  if (!current) {
+    return {
+      inputTokens: next.inputTokens ?? 0,
+      outputTokens: next.outputTokens ?? 0,
+      totalTokens: next.totalTokens ?? 0,
+      cacheReadTokens: (next.cacheReadTokens ?? 0) || void 0,
+      cacheWriteTokens: (next.cacheWriteTokens ?? 0) || void 0
+    };
+  }
+  const cacheRead = (current.cacheReadTokens ?? 0) + (next.cacheReadTokens ?? 0);
+  const cacheWrite = (current.cacheWriteTokens ?? 0) + (next.cacheWriteTokens ?? 0);
+  return {
+    inputTokens: (current.inputTokens ?? 0) + (next.inputTokens ?? 0),
+    outputTokens: (current.outputTokens ?? 0) + (next.outputTokens ?? 0),
+    totalTokens: (current.totalTokens ?? 0) + (next.totalTokens ?? 0),
+    cacheReadTokens: cacheRead || void 0,
+    cacheWriteTokens: cacheWrite || void 0
+  };
+}
+
 // src/execution/turn-runner/tool-batch.ts
 function cloneToolResultRecord(options) {
   return new Map(
@@ -1453,11 +1525,7 @@ async function runToolBatch(options) {
     let safe = false;
     let initialized;
     try {
-      const result = await isParallelSafe(
-        tool,
-        toolCall.args,
-        options.cwd
-      );
+      const result = await isParallelSafe(tool, toolCall.args, options.cwd);
       safe = result.safe;
       initialized = result.initialized;
     } catch {
@@ -1586,7 +1654,11 @@ function cloneAgentWorkflowTurnState(state) {
     ...state,
     systemPrompts: [...state.systemPrompts],
     messages: state.messages.map(cloneMessageSnapshot),
-    ...state.pendingInput ? { pendingInput: cloneMessageSnapshot(state.pendingInput) } : {},
+    ...state.pendingInput ? {
+      pendingInput: cloneMessageSnapshot(
+        state.pendingInput
+      )
+    } : {},
     ...state.usage ? { usage: cloneUsage(state.usage) } : {},
     ...state.turnState ? { turnState: structuredClone(state.turnState) } : {},
     ...state.lastModelStep ? { lastModelStep: structuredClone(state.lastModelStep) } : {},
@@ -1612,12 +1684,14 @@ function applyWorkflowInterventions(state, interventions, updatedAt) {
   if (interventions.length === 0) {
     return state;
   }
-  const injected = interventions.map((intervention) => ({
-    id: intervention.id,
-    role: "user",
-    createdAt: intervention.createdAt,
-    content: intervention.message
-  }));
+  const injected = interventions.map(
+    (intervention) => ({
+      id: intervention.id,
+      role: "user",
+      createdAt: intervention.createdAt,
+      content: intervention.message
+    })
+  );
   return {
     ...state,
     messages: [...state.messages, ...injected],
@@ -1982,6 +2056,7 @@ export {
   estimateTokens,
   estimateMessageTokens,
   estimateConversationTokens,
+  PRUNE_PROTECTED_TOOLS,
   DEFAULT_CONTEXT_LIMITS,
   getUsableTokenLimit,
   findCutPoint,
@@ -1991,6 +2066,7 @@ export {
   ContextOverflowError,
   processStepStream,
   runModelStep,
+  accumulateUsage,
   runToolBatch,
   commitStep,
   commitOutput,

package/dist/{chunk-SPILYYDF.js → chunk-I7EJGKUP.js}

@@ -118,9 +118,14 @@ async function loadSkillMetadata(filePath, scope, source, maxSize) {
 import { readFile as readFile2, readdir, stat as stat2 } from "fs/promises";
 import { extname, join as join2, relative } from "path";
 async function loadSkillContent(metadata) {
+  if (!metadata.filePath) {
+    throw new Error(
+      `Cannot load skill content for "${metadata.name}": no file path. Pack-contributed skills must have content pre-cached via SkillRegistry.register(metadata, content).`
+    );
+  }
   const raw = await readFile2(metadata.filePath, "utf-8");
   const { body } = parseFrontmatter(raw);
-  const resources = await scanSkillResources(metadata.baseDir);
+  const resources = await scanSkillResources(metadata.baseDir ?? "");
   return {
     ...metadata,
     body,
@@ -128,6 +133,14 @@ async function loadSkillContent(metadata) {
   };
 }
 async function loadResourceContent(resource) {
+  if (resource.content !== void 0) {
+    return resource.content;
+  }
+  if (!resource.absolutePath) {
+    throw new Error(
+      `Resource "${resource.relativePath}" has no content or absolute path.`
+    );
+  }
   return readFile2(resource.absolutePath, "utf-8");
 }
 async function scanSkillResources(baseDir) {
@@ -158,7 +171,14 @@ async function collectFiles(dirPath, baseDir, type, resources, maxDepth = 3, cur
           absolutePath: fullPath
         });
       } else if (entry.isDirectory()) {
-        await collectFiles(fullPath, baseDir, type, resources, maxDepth, currentDepth + 1);
+        await collectFiles(
+          fullPath,
+          baseDir,
+          type,
+          resources,
+          maxDepth,
+          currentDepth + 1
+        );
       }
     }
   } catch {
@@ -197,7 +217,9 @@ function deduplicateSkills(skills) {
       byName.set(skill.name, skill);
     }
   }
-  return Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
+  return Array.from(byName.values()).sort(
+    (a, b) => a.name.localeCompare(b.name)
+  );
 }
 
 // src/skill/discovery/fs.ts
@@ -256,7 +278,9 @@ async function scanRoot(root, maxDepth, maxFileSize = DEFAULT_SKILL_MAX_SIZE) {
     dirsScanned++;
     try {
       const entries = await readdir2(dirPath, { withFileTypes: true });
-      const hasSkillFile = entries.some((entry) => entry.isFile() && entry.name === SKILL_FILENAME);
+      const hasSkillFile = entries.some(
+        (entry) => entry.isFile() && entry.name === SKILL_FILENAME
+      );
       if (hasSkillFile) {
         const filePath = join4(dirPath, SKILL_FILENAME);
         const metadata = await loadSkillMetadata(
@@ -304,7 +328,11 @@ async function discoverSkills(cwd, config) {
   if (config?.roots) {
     for (const root of config.roots) {
       const absRoot = resolve2(resolvedCwd, root);
-      roots.push({ path: absRoot, scope: "global", source: { type: "local", root: absRoot } });
+      roots.push({
+        path: absRoot,
+        scope: "global",
+        source: { type: "local", root: absRoot }
+      });
     }
   }
   const home = homedir();
@@ -488,9 +516,13 @@ var SkillRegistry = class {
       lines.push("");
       lines.push(`<skill name="${skill.name}" scope="${skill.scope}">`);
       lines.push(`  <description>${skill.description}</description>`);
-      lines.push(`  <file>${skill.filePath}</file>`);
+      if (skill.filePath) {
+        lines.push(`  <file>${skill.filePath}</file>`);
+      }
       if (skill.dependencies && skill.dependencies.length > 0) {
-        lines.push(`  <depends-on>${skill.dependencies.join(", ")}</depends-on>`);
+        lines.push(
+          `  <depends-on>${skill.dependencies.join(", ")}</depends-on>`
+        );
       }
       lines.push("</skill>");
     }
@@ -546,6 +578,46 @@ var SkillRegistry = class {
   // ==========================================================================
   // Cache Management
   // ==========================================================================
+  // ==========================================================================
+  // External Registration (for capability packs)
+  // ==========================================================================
+  /**
+   * Register an externally defined skill with optional pre-loaded content.
+   *
+   * Intended for capability packs that contribute skills without placing
+   * files on disk — the pack's inline body is stored directly in the
+   * content cache so the agent can load it without a file read.
+   *
+   * **Priority:** registered skills have lower priority than discovered
+   * skills. If a skill with the same name was already found during
+   * discovery, the discovered skill wins and this call is a no-op.
+   *
+   * @param metadata  L1 metadata describing the skill.
+   * @param content   Pre-built content (L2). When provided, this is stored
+   *                  in the cache so `loadContent()` never reads a file.
+   */
+  register(metadata, content) {
+    const existing = this.skills.get(metadata.name);
+    if (existing) {
+      const protectedExisting = existing.scope === "builtin" || existing.source.type === "local" || existing.filePath !== void 0 || existing.baseDir !== void 0;
+      if (protectedExisting) {
+        return "skipped";
+      }
+      this.skills.set(metadata.name, metadata);
+      if (content) {
+        this.contentCache.set(metadata.name, content);
+      }
+      return "updated";
+    }
+    this.skills.set(metadata.name, metadata);
+    if (content) {
+      this.contentCache.set(metadata.name, content);
+    }
+    return "registered";
+  }
+  // ==========================================================================
+  // Cache Management
+  // ==========================================================================
   /** Clear the content cache, forcing reloads on next access. */
   clearContentCache() {
     this.contentCache.clear();