@ycodium-ai/agent-claude 0.2.2896 → 0.2.2898

package/dist/index.js

@@ -58,6 +58,8 @@ var CLAUDE_CARD = {
     turnSteering: true,
     // 子代理、workflow 与其成员经 SDK 的 task_* 系统消息报成 task.*（claudeInstance.ts）。
     reportsSpawnedAgents: true,
+    // 用户点名的技能：最后一个原生 `/name` 派发，更早的读 SKILL.md 内联展开（claudeSkillDispatch.ts）。
+    handlesSkillInvocations: true,
     // 出处：Anthropic Messages API 的视觉文档——单张图片 5 MB、宽高各不超过 8000 像素，超了
     // API 直接拒掉整轮。5 MB 量的是 base64 之后的长度（SDK 把图片以 base64 块发出），所以
     // 原始字节上限是它的 3/4。宿主据此把更大的图退化成路径（Claude 自己的 Read 工具会读那个
@@ -180,7 +182,7 @@ var CLAUDE_CARD = {
 
 // src/claudeInstance.ts
 import * as NodeOS8 from "node:os";
-import * as NodePath13 from "node:path";
+import * as NodePath14 from "node:path";
 
 // ../../node_modules/.pnpm/@anthropic-ai+claude-agent-sdk@0.3.170_@anthropic-ai+sdk@0.93.0_zod@4.6.5__@modelcontex_64204813d4dba2ebc464c3aa751485a4/node_modules/@anthropic-ai/claude-agent-sdk/sdk.mjs
 import { createRequire as xz } from "node:module";
@@ -19875,13 +19877,16 @@ function parseFrontMatterBoolean(value) {
       return void 0;
   }
 }
+function splitSkillFrontMatter(contents) {
+  const lines = contents.split(/\r?\n/u);
+  const close = lines[0]?.trim() === "---" ? lines.findIndex((line, index) => index > 0 && line.trim() === "---") : -1;
+  return close === -1 ? { header: [], body: contents } : { header: lines.slice(1, close), body: lines.slice(close + 1).join("\n") };
+}
 function parseSkillFrontMatter(contents) {
-  const lines = contents.split(/\r?\n/);
-  if (lines[0]?.trim() !== "---") return {};
+  const lines = splitSkillFrontMatter(contents).header;
   const values = {};
-  for (let index = 1; index < lines.length; index += 1) {
+  for (let index = 0; index < lines.length; index += 1) {
     const line = lines[index] ?? "";
-    if (line.trim() === "---") break;
     const match = FRONT_MATTER_KEY.exec(line);
     if (match === null) continue;
     const key = match[1];
@@ -19890,7 +19895,7 @@ function parseSkillFrontMatter(contents) {
       const block = [];
       while (index + 1 < lines.length) {
         const next = lines[index + 1] ?? "";
-        if (next.trim() === "---" || next.trim().length > 0 && !/^[ \t]/.test(next)) break;
+        if (next.trim().length > 0 && !/^[ \t]/.test(next)) break;
         index += 1;
         if (next.trim().length > 0) block.push(next.trim());
       }
@@ -20503,35 +20508,342 @@ function findSkillTokens(text) {
   });
 }
 var SKILL_TOKEN_AT = new RegExp(String.raw`([$/])(${SKILL_TOKEN_NAME_PATTERN})(?=\s|$)`, "y");
+function resolveSkillName(name, known) {
+  if (known.has(name)) return name;
+  if (!name.startsWith(SESSION_SKILL_PREFIX)) return void 0;
+  const bare = name.slice(SESSION_SKILL_PREFIX.length);
+  return known.has(bare) ? bare : void 0;
+}
+function lookupSkill(name, index) {
+  const exact = index.get(name);
+  if (exact !== void 0) return exact;
+  if (!name.startsWith(SESSION_SKILL_PREFIX)) return void 0;
+  const session = index.get(name.slice(SESSION_SKILL_PREFIX.length));
+  return session?.scope === SESSION_SKILL_NAMESPACE ? session : void 0;
+}
 var SLASH_SKILL_TOKEN = new RegExp(String.raw`^/(${SKILL_TOKEN_NAME_PATTERN})$`);
+function matchSkillTokens(text, index) {
+  if (index.size === 0) return [];
+  return findSkillTokens(text).flatMap((token) => {
+    const skill = lookupSkill(token.name, index);
+    return skill === void 0 ? [] : [{ ...token, skill }];
+  });
+}
+function skillInvocationNotice(names) {
+  return `The user invoked these skills in this message; run them as requested: ${names.map((name) => `$${name}`).join(", ")}.`;
+}
 
 // src/claudeSkillDispatch.ts
-function planClaudeSkillDispatch(prompt, skillNames) {
-  const mentions = findSkillTokens(prompt).filter((token) => skillNames.has(token.name));
+import { EXECUTOR_SEND_TURN_MAX_INPUT_CHARS as EXECUTOR_SEND_TURN_MAX_INPUT_CHARS2 } from "@ycodium-ai/plugin-api/executor";
+
+// src/claudeInlineSkill.ts
+import * as NodeFSP2 from "node:fs/promises";
+import * as NodePath6 from "node:path";
+import { EXECUTOR_SEND_TURN_MAX_INPUT_CHARS } from "@ycodium-ai/plugin-api/executor";
+
+// src/shellWords.ts
+function tokenizeShellWords(value) {
+  const input = value.trim();
+  if (!input) return [];
+  const tokens = [];
+  let current = "";
+  let quote;
+  let quoted = false;
+  for (let index = 0; index < input.length; index++) {
+    const char = input[index];
+    if (char === void 0) continue;
+    if (quote) {
+      if (char === quote) {
+        quote = void 0;
+        quoted = true;
+      } else if (char === "\\" && quote === '"') {
+        const next = input[index + 1];
+        if (next !== void 0 && ['"', "\\", "$", "`"].includes(next)) {
+          current += next;
+          index++;
+        } else {
+          current += char;
+        }
+      } else {
+        current += char;
+      }
+      continue;
+    }
+    if (char === "'" || char === '"') {
+      quote = char;
+      quoted = true;
+    } else if (/\s/.test(char)) {
+      if (current || quoted) {
+        tokens.push(current);
+        current = "";
+        quoted = false;
+      }
+    } else if (char === "\\") {
+      const next = input[index + 1];
+      if (next !== void 0 && /\s/.test(next)) {
+        current += next;
+        index++;
+      } else {
+        current += char;
+      }
+    } else {
+      current += char;
+    }
+  }
+  if (current || quoted) tokens.push(current);
+  return tokens;
+}
+
+// src/claudeSkillArguments.ts
+var escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+function substituteSkillArguments(body, args, argumentNames) {
+  const values = tokenizeShellWords(args);
+  const named = argumentNames.map(escapeRegExp).toSorted((left, right) => right.length - left.length);
+  const pattern = new RegExp(
+    String.raw`(\\*)\$(?:ARGUMENTS\[(\d+)\]|(ARGUMENTS)(?![A-Za-z0-9_])|(\d+)` + (named.length > 0 ? String.raw`|(${named.join("|")})(?![A-Za-z0-9_-])` : "") + ")",
+    "gu"
+  );
+  let received = false;
+  const substituted = body.replace(
+    pattern,
+    (match, slashes, bracketIndex, all, shortIndex, name) => {
+      if (slashes.length === 1) return match.slice(1);
+      if (all !== void 0) {
+        received = true;
+        return slashes + args;
+      }
+      const index = bracketIndex ?? shortIndex;
+      if (index !== void 0) {
+        const value = values[Number(index)];
+        if (value === void 0) return match;
+        received = true;
+        return slashes + value;
+      }
+      received = true;
+      return slashes + (values[argumentNames.indexOf(name ?? "")] ?? "");
+    }
+  );
+  return received || args.length === 0 ? substituted : `${substituted}
+
+ARGUMENTS: ${args}`;
+}
+
+// src/claudeInlineSkill.ts
+var MAX_INLINE_SKILLS = 4;
+var MAX_INLINE_SKILL_BYTES = 64 * 1024;
+var EXECUTION_FIELDS = [
+  "model",
+  "effort",
+  "context",
+  "agent",
+  "hooks",
+  "allowed-tools",
+  "disallowed-tools"
+];
+var TOP_LEVEL_KEY = /^([A-Za-z_][\w-]*):[ \t]*(.*)$/u;
+var DYNAMIC_COMMAND = /(?:^|\s)!`[^`\n]+`|^```!/mu;
+var CLAUDE_VARIABLE = /\$\{(CLAUDE_[A-Z0-9_]+)\}/gu;
+var unquote = (value) => value.trim().replace(/^(["'])(.*)\1$/u, "$2");
+var parseArgumentNames = (value, following) => {
+  const inline = value.replace(/\s+#.*$/u, "").trim();
+  if (inline.startsWith("[")) {
+    return inline.replace(/^\[|\]$/gu, "").split(",").map(unquote).filter((name) => name.length > 0);
+  }
+  if (inline.length > 0) return unquote(inline).split(/\s+/u);
+  const names = [];
+  for (const line of following) {
+    const item = /^[ \t]+-[ \t]*(.+)$/u.exec(line);
+    if (item === null) break;
+    names.push(unquote(item[1] ?? ""));
+  }
+  return names.filter((name) => name.length > 0);
+};
+function readSkillSource(contents) {
+  const { header, body: rawBody } = splitSkillFrontMatter(contents);
+  const body = rawBody.replace(/^\n+/u, "").trimEnd();
+  let argumentNames = [];
+  const fields = /* @__PURE__ */ new Set();
+  header.forEach((line, index) => {
+    const match = TOP_LEVEL_KEY.exec(line);
+    if (match === null) return;
+    const key = match[1] ?? "";
+    fields.add(key);
+    if (key === "arguments")
+      argumentNames = parseArgumentNames(match[2] ?? "", header.slice(index + 1));
+  });
+  return {
+    body,
+    argumentNames,
+    ignored: [
+      ...EXECUTION_FIELDS.filter((field) => fields.has(field)),
+      ...DYNAMIC_COMMAND.test(body) ? ["!`command` injection (not run)"] : []
+    ]
+  };
+}
+var loadSkill = async (path) => {
+  try {
+    const bytes = await NodeFSP2.readFile(path);
+    if (bytes.byteLength > MAX_INLINE_SKILL_BYTES) {
+      return { ok: false, reason: `${path} is larger than ${MAX_INLINE_SKILL_BYTES / 1024} KB` };
+    }
+    return { ok: true, source: readSkillSource(bytes.toString("utf8")) };
+  } catch (error) {
+    const code = error.code;
+    return {
+      ok: false,
+      reason: `could not read ${path} (${typeof code === "string" ? code : String(error)})`
+    };
+  }
+};
+var skillBlock = (name, lines) => `<ycodium-skill name="${name}">
+${lines.join("\n")}
+</ycodium-skill>`;
+var notLoadedBlock = (name, reason) => skillBlock(name, [
+  `The user invoked the skill "${name}" in this message, but it could not be included: ${reason}. It is not applied; don't assume its instructions.`
+]);
+var renderLoaded = (invocation, source, variables) => {
+  const skillDir = NodePath6.dirname(invocation.path);
+  const known = {
+    CLAUDE_SKILL_DIR: skillDir,
+    CLAUDE_PROJECT_DIR: variables.projectDir,
+    CLAUDE_SESSION_ID: variables.sessionId
+  };
+  const unresolved = /* @__PURE__ */ new Set();
+  const body = substituteSkillArguments(source.body, invocation.args, source.argumentNames).replace(
+    CLAUDE_VARIABLE,
+    (match, variable) => {
+      const value = known[variable];
+      if (value !== void 0) return value;
+      unresolved.add(`\${${variable}} (left as is)`);
+      return match;
+    }
+  );
+  const ignored = [...source.ignored, ...unresolved];
+  return {
+    block: skillBlock(invocation.name, [
+      `The user invoked the skill "${invocation.name}" in this message. Its SKILL.md is included below and already loaded: follow it for this request, and don't load "${invocation.name}" again with the Skill tool.`,
+      `Base directory for this skill: ${skillDir}`,
+      ...ignored.length > 0 ? [`Not applied when included this way: ${ignored.join(", ")}.`] : [],
+      "",
+      body
+    ]),
+    ignored
+  };
+};
+async function renderInlineSkills(invocations, variables, maxChars) {
+  const loads = /* @__PURE__ */ new Map();
+  const blocks = [];
+  const warnings = [];
+  let used = 0;
+  const append = (block) => {
+    if (used + block.length + 2 > maxChars) return false;
+    used += block.length + 2;
+    blocks.push(block);
+    return true;
+  };
+  const notLoaded = (name, reason) => {
+    append(notLoadedBlock(name, reason));
+    warnings.push(`Skill "${name}" was not applied: ${reason}.`);
+  };
+  for (const [index, invocation] of invocations.entries()) {
+    if (index >= MAX_INLINE_SKILLS) {
+      notLoaded(
+        invocation.name,
+        `a message can include at most ${MAX_INLINE_SKILLS} skills before the last one`
+      );
+      continue;
+    }
+    const load = loads.get(invocation.path) ?? loadSkill(invocation.path);
+    loads.set(invocation.path, load);
+    const loaded = await load;
+    if (!loaded.ok) {
+      notLoaded(invocation.name, loaded.reason);
+      continue;
+    }
+    const rendered = renderLoaded(invocation, loaded.source, variables);
+    if (!append(rendered.block)) {
+      notLoaded(
+        invocation.name,
+        `including it would make the message longer than ${EXECUTOR_SEND_TURN_MAX_INPUT_CHARS} characters`
+      );
+      continue;
+    }
+    if (rendered.ignored.length > 0) {
+      warnings.push(
+        `Skill "${invocation.name}" was included in the message rather than run by Claude Code; not applied: ${rendered.ignored.join(", ")}.`
+      );
+    }
+  }
+  return { blocks, warnings };
+}
+
+// src/claudeSkillDispatch.ts
+function planClaudeSkillDispatch(prompt, skills) {
+  const mentions = matchSkillTokens(prompt, skills);
+  const first = mentions[0];
   const last = mentions.at(-1);
-  if (last === void 0) return void 0;
-  const leading = prompt.slice(0, last.start);
-  const trailing = prompt.slice(last.end);
-  const leadingWithInlineSlashes = mentions.slice(0, -1).reduceRight(
-    (text, mention) => `${text.slice(0, mention.start)}/${text.slice(mention.start + 1)}`,
-    leading
-  ).trimEnd();
+  if (first === void 0 || last === void 0) return void 0;
   return {
-    leadingText: leadingWithInlineSlashes.length > 0 ? leadingWithInlineSlashes : void 0,
-    commandText: `/${last.name}${trailing}`.trimEnd(),
+    prefix: prompt.slice(0, first.start).trimEnd(),
+    inline: mentions.slice(0, -1).map((mention, index) => ({
+      name: mention.skill.name,
+      path: mention.skill.path,
+      args: prompt.slice(mention.end, mentions[index + 1]?.start ?? prompt.length).trim()
+    })),
+    commandText: `/${last.name}${prompt.slice(last.end)}`.trimEnd(),
     skillName: last.name
   };
 }
-function dispatchableSkillNames(discovered, sessionSkills) {
+function dispatchableSkills(discovered, sessionSkills) {
   const hostExpanded = new Set(sessionSkills?.names ?? []);
-  return new Set(
-    discovered.filter((skill) => skill.enabled && skill.userInvocable !== false).map((skill) => skill.name).filter((name) => !hostExpanded.has(name))
+  return new Map(
+    discovered.filter((skill) => skill.enabled && skill.userInvocable !== false).filter((skill) => !hostExpanded.has(skill.name)).map((skill) => [skill.name, { name: skill.name, path: skill.path }])
   );
 }
+function unhandledSkillMentions(prompt, discovered, sessionSkills) {
+  const discoveredNames = new Set(discovered.map((skill) => skill.name));
+  const sessionNames = new Set(sessionSkills?.names ?? []);
+  const names = findSkillTokens(prompt).filter((token) => token.sigil === "$" && !discoveredNames.has(token.name)).filter((token) => resolveSkillName(token.name, sessionNames) === void 0).map((token) => token.name);
+  return [...new Set(names)];
+}
+var joinParagraphs = (parts) => parts.filter((part) => part.length > 0).join("\n\n");
+async function prepareClaudeTurnText(input) {
+  const { session, sessionSkills, resumeSessionId } = input.context;
+  const cwd = session.cwd;
+  const environment = { ...process.env, ...input.recipe.environment };
+  const discovered = await discoverClaudeSkills(
+    resolveClaudeConfigDirPath(input.recipe.homePath, environment, cwd),
+    { environment, ...cwd ? { cwd } : {} }
+  );
+  const preamble = input.preamble ?? "";
+  const unhandled = unhandledSkillMentions(input.prompt, discovered, sessionSkills);
+  const plan = planClaudeSkillDispatch(input.prompt, dispatchableSkills(discovered, sessionSkills));
+  const tail = plan === void 0 ? [input.prompt] : [plan.prefix, plan.commandText];
+  const room = (parts) => EXECUTOR_SEND_TURN_MAX_INPUT_CHARS2 - joinParagraphs([preamble, ...parts]).length;
+  const candidate = unhandled.length > 0 ? skillInvocationNotice(unhandled) : "";
+  const notice = room([candidate, ...tail]) >= 0 ? candidate : "";
+  if (plan === void 0) {
+    return {
+      leadingText: joinParagraphs([preamble, notice, input.prompt]),
+      commandText: void 0,
+      warnings: []
+    };
+  }
+  const rendered = await renderInlineSkills(
+    plan.inline,
+    { projectDir: cwd, sessionId: resumeSessionId },
+    room([notice, ...tail])
+  );
+  return {
+    leadingText: joinParagraphs([preamble, notice, plan.prefix, ...rendered.blocks]),
+    commandText: plan.commandText,
+    warnings: rendered.warnings
+  };
+}
 
 // src/claudeWorkspaceInventory.ts
-import * as NodeFSP2 from "node:fs/promises";
-import * as NodePath6 from "node:path";
+import * as NodeFSP3 from "node:fs/promises";
+import * as NodePath7 from "node:path";
 var MAX_COMMAND_DEPTH = 5;
 var MAX_COMMAND_FILES = 500;
 var MAX_DESCRIPTION_LENGTH = 200;
@@ -20549,7 +20861,7 @@ var firstBodyLine = (contents) => {
   return void 0;
 };
 var scanCommands = async (claudeDir) => {
-  const root = NodePath6.join(claudeDir, "commands");
+  const root = NodePath7.join(claudeDir, "commands");
   const commands = /* @__PURE__ */ new Map();
   const watched = [root];
   let level = [root];
@@ -20557,9 +20869,9 @@ var scanCommands = async (claudeDir) => {
   for (let depth = 0; depth < MAX_COMMAND_DEPTH && level.length > 0; depth += 1) {
     const next = [];
     for (const directory of level) {
-      const entries = await NodeFSP2.readdir(directory, { withFileTypes: true }).catch(() => []);
+      const entries = await NodeFSP3.readdir(directory, { withFileTypes: true }).catch(() => []);
       for (const entry of entries.toSorted((left, right) => left.name.localeCompare(right.name))) {
-        const entryPath = NodePath6.join(directory, entry.name);
+        const entryPath = NodePath7.join(directory, entry.name);
         if (entry.isDirectory()) {
           next.push(entryPath);
           watched.push(entryPath);
@@ -20571,7 +20883,7 @@ var scanCommands = async (claudeDir) => {
         files += 1;
         const name = entry.name.slice(0, -".md".length).trim();
         if (name.length === 0 || commands.has(name)) continue;
-        const contents = await NodeFSP2.readFile(entryPath, "utf8").catch(() => void 0);
+        const contents = await NodeFSP3.readFile(entryPath, "utf8").catch(() => void 0);
         if (contents === void 0) continue;
         const frontMatter = parseSkillFrontMatter(contents);
         const description = frontMatter.description ?? firstBodyLine(contents);
@@ -20587,13 +20899,13 @@ var scanCommands = async (claudeDir) => {
   return { commands: [...commands.values()], watched };
 };
 var watchSkillsRoot = async (claudeDir) => {
-  const root = NodePath6.join(claudeDir, "skills");
-  const entries = await NodeFSP2.readdir(root).catch(() => []);
+  const root = NodePath7.join(claudeDir, "skills");
+  const entries = await NodeFSP3.readdir(root).catch(() => []);
   return [
     root,
     ...entries.flatMap((entry) => [
-      NodePath6.join(root, entry),
-      NodePath6.join(root, entry, "SKILL.md")
+      NodePath7.join(root, entry),
+      NodePath7.join(root, entry, "SKILL.md")
     ])
   ];
 };
@@ -20604,7 +20916,7 @@ var mergeByName = (base, preferred) => {
   return [...merged.values()].toSorted((left, right) => left.name.localeCompare(right.name));
 };
 var discoverClaudeWorkspaceInventory = async (input) => {
-  const projectClaudeDir = NodePath6.join(input.cwd, ".claude");
+  const projectClaudeDir = NodePath7.join(input.cwd, ".claude");
   const [userCommands, projectCommands, skills, userSkillWatch, projectSkillWatch] = await Promise.all([
     scanCommands(input.configDirPath),
     scanCommands(projectClaudeDir),
@@ -20626,9 +20938,9 @@ var discoverClaudeWorkspaceInventory = async (input) => {
       ...userSkillWatch,
       ...projectSkillWatch,
       // `skillOverrides` 在这几个设置文件里：开关一个技能也要重查。
-      NodePath6.join(input.configDirPath, "settings.json"),
-      NodePath6.join(projectClaudeDir, "settings.json"),
-      NodePath6.join(projectClaudeDir, "settings.local.json")
+      NodePath7.join(input.configDirPath, "settings.json"),
+      NodePath7.join(projectClaudeDir, "settings.json"),
+      NodePath7.join(projectClaudeDir, "settings.local.json")
     ]
   };
 };
@@ -20749,59 +21061,8 @@ function parseClaudeInstanceConfig(config) {
     envelopeDriver: readTrimmed(config["driver"]) || void 0
   };
 }
-function tokenizeLaunchArgs(value) {
-  const input = value.trim();
-  if (!input) return [];
-  const tokens = [];
-  let current = "";
-  let quote;
-  let quoted = false;
-  for (let index = 0; index < input.length; index++) {
-    const char = input[index];
-    if (char === void 0) continue;
-    if (quote) {
-      if (char === quote) {
-        quote = void 0;
-        quoted = true;
-      } else if (char === "\\" && quote === '"') {
-        const next = input[index + 1];
-        if (next !== void 0 && ['"', "\\", "$", "`"].includes(next)) {
-          current += next;
-          index++;
-        } else {
-          current += char;
-        }
-      } else {
-        current += char;
-      }
-      continue;
-    }
-    if (char === "'" || char === '"') {
-      quote = char;
-      quoted = true;
-    } else if (/\s/.test(char)) {
-      if (current || quoted) {
-        tokens.push(current);
-        current = "";
-        quoted = false;
-      }
-    } else if (char === "\\") {
-      const next = input[index + 1];
-      if (next !== void 0 && /\s/.test(next)) {
-        current += next;
-        index++;
-      } else {
-        current += char;
-      }
-    } else {
-      current += char;
-    }
-  }
-  if (current || quoted) tokens.push(current);
-  return tokens;
-}
 function parseCliArgs(args, options) {
-  const tokens = typeof args === "string" ? tokenizeLaunchArgs(args) : Array.from(args);
+  const tokens = typeof args === "string" ? tokenizeShellWords(args) : Array.from(args);
   const booleanSet = options?.booleanFlags ? new Set(options.booleanFlags) : void 0;
   const flags = {};
   const positionals = [];
@@ -21687,7 +21948,7 @@ function claudeReadAllowRules(directories) {
 // src/sessions.ts
 import * as NodeFS3 from "node:fs";
 import * as NodeOS6 from "node:os";
-import * as NodePath7 from "node:path";
+import * as NodePath8 from "node:path";
 import * as NodeProcess2 from "node:process";
 
 // ../../packages/ycodium-jsonl-stream/src/jsonlStream.ts
@@ -22316,7 +22577,7 @@ function listTranscriptFiles(transcriptDir, directory) {
   const scanned = matched.length > 0 ? matched : dirs;
   const found = [];
   for (const dir of scanned) {
-    const projectDir = NodePath7.join(transcriptDir, dir);
+    const projectDir = NodePath8.join(transcriptDir, dir);
     let names;
     try {
       names = NodeFS3.readdirSync(projectDir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(TRANSCRIPT_SUFFIX)).map((entry) => entry.name);
@@ -22326,12 +22587,12 @@ function listTranscriptFiles(transcriptDir, directory) {
     for (const name of names) {
       let stat2;
       try {
-        stat2 = NodeFS3.statSync(NodePath7.join(projectDir, name));
+        stat2 = NodeFS3.statSync(NodePath8.join(projectDir, name));
       } catch {
         continue;
       }
       found.push({
-        path: NodePath7.join(projectDir, name),
+        path: NodePath8.join(projectDir, name),
         sessionId: name.slice(0, -TRANSCRIPT_SUFFIX.length),
         size: stat2.size,
         mtimeMs: Number.isFinite(stat2.mtimeMs) ? stat2.mtimeMs : 0
@@ -22342,7 +22603,7 @@ function listTranscriptFiles(transcriptDir, directory) {
 }
 function readClaudeLiveSessionIds(configDir) {
   const live = /* @__PURE__ */ new Set();
-  const markerDir = NodePath7.join(configDir, "sessions");
+  const markerDir = NodePath8.join(configDir, "sessions");
   let entries;
   try {
     entries = NodeFS3.readdirSync(markerDir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => entry.name);
@@ -22352,7 +22613,7 @@ function readClaudeLiveSessionIds(configDir) {
   for (const entry of entries) {
     let marker;
     try {
-      marker = JSON.parse(NodeFS3.readFileSync(NodePath7.join(markerDir, entry), "utf8"));
+      marker = JSON.parse(NodeFS3.readFileSync(NodePath8.join(markerDir, entry), "utf8"));
     } catch {
       continue;
     }
@@ -22406,7 +22667,7 @@ async function scanClaudeSessions(input) {
 function resolveTranscriptPath(input) {
   const fileName = `${input.sessionId}${TRANSCRIPT_SUFFIX}`;
   if (input.cwd !== void 0 && input.cwd.length > 0) {
-    const direct = NodePath7.join(
+    const direct = NodePath8.join(
       input.transcriptDir,
       encodeClaudeProjectDirName(input.cwd),
       fileName
@@ -22423,7 +22684,7 @@ function resolveTranscriptPath(input) {
     return null;
   }
   for (const dir of dirs) {
-    const candidate = NodePath7.join(input.transcriptDir, dir, fileName);
+    const candidate = NodePath8.join(input.transcriptDir, dir, fileName);
     try {
       if (NodeFS3.statSync(candidate).isFile()) return candidate;
     } catch {
@@ -22901,9 +23162,9 @@ function normalizeClaudeTaskProgressTokenUsage(value, memory) {
 }
 
 // src/textGeneration.ts
-import * as NodeFSP3 from "node:fs/promises";
+import * as NodeFSP4 from "node:fs/promises";
 import * as NodeOS7 from "node:os";
-import * as NodePath8 from "node:path";
+import * as NodePath9 from "node:path";
 import { mergeLaunchEnv } from "@ycodium-ai/plugin-api/executor";
 
 // src/textGenerationUtils.ts
@@ -23372,13 +23633,13 @@ function createClaudeTextGeneration(recipe, host, modelCatalog) {
       return decodeStructuredOutput(stdout, input.operation);
     };
     if (input.operation !== "generateThreadTitle") return runIn(input.cwd);
-    const scratchDirectory = await NodeFSP3.mkdtemp(
-      NodePath8.join(NodeOS7.tmpdir(), "ycodium-claude-title-")
+    const scratchDirectory = await NodeFSP4.mkdtemp(
+      NodePath9.join(NodeOS7.tmpdir(), "ycodium-claude-title-")
     );
     try {
       return await runIn(scratchDirectory);
     } finally {
-      await NodeFSP3.rm(scratchDirectory, { recursive: true, force: true }).catch(() => void 0);
+      await NodeFSP4.rm(scratchDirectory, { recursive: true, force: true }).catch(() => void 0);
     }
   };
   const asRecord2 = (value, operation) => {
@@ -23528,11 +23789,11 @@ function createClaudeTextGeneration(recipe, host, modelCatalog) {
 }
 
 // src/usageRead/index.ts
-import * as NodePath12 from "node:path";
+import * as NodePath13 from "node:path";
 
 // src/usageRead/quota.ts
 import * as NodeFS4 from "node:fs";
-import * as NodePath9 from "node:path";
+import * as NodePath10 from "node:path";
 import { mergeLaunchEnv as mergeLaunchEnv2, setsOwnModelConnection } from "@ycodium-ai/plugin-api/executor";
 import {
   parseRetryAfterMs
@@ -23555,14 +23816,14 @@ var claudeCredentialFileCandidates = (recipe) => {
   const credentialsDir = resolveClaudeCredentialsDirPath(
     environment[CLAUDE_CREDENTIALS_DIR_ENVIRONMENT_VARIABLE] ?? ""
   );
-  if (credentialsDir !== null) return [NodePath9.join(credentialsDir, ".credentials.json")];
+  if (credentialsDir !== null) return [NodePath10.join(credentialsDir, ".credentials.json")];
   const configDir = resolveClaudeConfigDirPath(recipe.homePath, environment);
   const home = resolveClaudeHomePath(recipe.homePath);
   return [
     .../* @__PURE__ */ new Set([
-      NodePath9.join(configDir, ".credentials.json"),
-      NodePath9.join(home, ".claude", ".credentials.json"),
-      NodePath9.join(home, ".credentials.json")
+      NodePath10.join(configDir, ".credentials.json"),
+      NodePath10.join(home, ".claude", ".credentials.json"),
+      NodePath10.join(home, ".credentials.json")
     ])
   ];
 };
@@ -23723,11 +23984,11 @@ var claudeQuotaFromRateLimitEvent = (message) => {
 };
 
 // src/usageRead/scanCache.ts
-import * as NodePath11 from "node:path";
+import * as NodePath12 from "node:path";
 
 // src/usageRead/transcriptScan.ts
 import * as NodeFS5 from "node:fs";
-import * as NodePath10 from "node:path";
+import * as NodePath11 from "node:path";
 
 // src/usageRead/transcriptLine.ts
 var int = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : 0;
@@ -23789,7 +24050,7 @@ async function listTranscriptFiles2(root, sinceMs) {
       return;
     }
     for (const entry of entries) {
-      const child = NodePath10.join(dir, entry.name);
+      const child = NodePath11.join(dir, entry.name);
       if (entry.isDirectory()) {
         await walk(child);
         continue;
@@ -24026,8 +24287,8 @@ function pruneScanCache(cache, options) {
   for (const [path, entry] of cache) {
     const agedOut = entry.mtimeMs < options.retentionCutoffMs;
     const underWalkedRoot = options.walkedRoots.some((root) => {
-      const relative2 = NodePath11.relative(root, path);
-      return relative2 === "" || relative2 !== ".." && !relative2.startsWith(`..${NodePath11.sep}`) && !NodePath11.isAbsolute(relative2);
+      const relative2 = NodePath12.relative(root, path);
+      return relative2 === "" || relative2 !== ".." && !relative2.startsWith(`..${NodePath12.sep}`) && !NodePath12.isAbsolute(relative2);
     });
     const deleted = underWalkedRoot && entry.mtimeMs >= options.windowStartMs && !options.livePaths.has(path);
     if (agedOut || deleted) {
@@ -24203,7 +24464,7 @@ var createClaudeUsage = (input) => {
   });
   const tokens = createClaudeTokenReader({
     configDir,
-    transcriptRoot: NodePath12.join(configDir, "projects"),
+    transcriptRoot: NodePath13.join(configDir, "projects"),
     cache: input.cache
   });
   return {
@@ -24373,9 +24634,9 @@ function nativeProviderRefs(_context, options) {
 }
 async function buildUserMessageFromTurn(input) {
   const sdkContent = [];
-  const dispatch = input.skillNames === void 0 ? void 0 : planClaudeSkillDispatch(input.text, input.skillNames);
-  if (dispatch?.leadingText !== void 0) {
-    sdkContent.push({ type: "text", text: dispatch.leadingText });
+  const { leadingText, commandText } = input.text;
+  if (commandText !== void 0 && leadingText.length > 0) {
+    sdkContent.push({ type: "text", text: leadingText });
   }
   for (const attachment of input.attachments ?? []) {
     if (!attachment || typeof attachment !== "object" || Array.isArray(attachment)) continue;
@@ -24395,10 +24656,10 @@ async function buildUserMessageFromTurn(input) {
     const bytes = await input.attachmentsApi.read(id2);
     sdkContent.push(buildClaudeImageContentBlock({ mimeType, bytes }));
   }
-  if (dispatch !== void 0) {
-    sdkContent.push({ type: "text", text: dispatch.commandText });
-  } else if (input.text.length > 0) {
-    sdkContent.push({ type: "text", text: input.text });
+  if (commandText !== void 0) {
+    sdkContent.push({ type: "text", text: commandText });
+  } else if (leadingText.length > 0) {
+    sdkContent.push({ type: "text", text: leadingText });
   }
   return buildUserMessage({ sdkContent });
 }
@@ -25520,7 +25781,7 @@ function createClaudeAdapter(recipe, host, options) {
       claudeFailureHint({
         authenticationFailed: context.turnState?.authenticationFailed === true,
         environment: buildLaunchEnvironment(),
-        cwd: NodePath13.resolve(context.session.cwd ?? "."),
+        cwd: NodePath14.resolve(context.session.cwd ?? "."),
         ...context.turnState === void 0 ? {} : {
           usageLimit: {
             rejected: context.turnState.rejectedRateLimits,
@@ -27010,16 +27271,17 @@ function createClaudeAdapter(recipe, host, options) {
         providerRefs: {}
       });
     }
-    const cliEnvironment = { ...process.env, ...recipe.environment };
-    const skills = await discoverClaudeSkills(
-      resolveClaudeConfigDirPath(recipe.homePath, cliEnvironment, context.session.cwd),
-      { environment: cliEnvironment, ...context.session.cwd ? { cwd: context.session.cwd } : {} }
-    );
+    const turnText = await prepareClaudeTurnText({
+      prompt: buildPromptText(turnCapsForPrompt, input, boundInstanceId),
+      preamble: input.inputPreamble,
+      recipe,
+      context
+    });
+    for (const warning of turnText.warnings) await emitRuntimeWarning(context, warning);
     const message = await buildUserMessageFromTurn({
-      text: buildPromptText(turnCapsForPrompt, input, boundInstanceId),
+      text: turnText,
       attachments: input.attachments,
-      attachmentsApi: options?.attachments,
-      skillNames: dispatchableSkillNames(skills, context.sessionSkills)
+      attachmentsApi: options?.attachments
     });
     validateSteeringTarget();
     context.promptQueue.push({
@@ -27195,7 +27457,7 @@ function createClaudeInstance(config, host, attachments, overrides, usageCache)
     );
     return {
       configDir,
-      transcriptDir: NodePath13.join(configDir, "projects")
+      transcriptDir: NodePath14.join(configDir, "projects")
     };
   };
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-claude",
-  "version": "0.2.2896",
+  "version": "0.2.2898",
   "description": "Claude executor: Claude Code CLI via @anthropic-ai/claude-agent-sdk.",
   "keywords": [
     "ycodium",
@@ -24,7 +24,7 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "@ycodium-ai/plugin-api": "0.2.2896",
+    "@ycodium-ai/plugin-api": "0.2.2898",
     "ycodium-executor-testing": "0.0.0",
     "ycodium-jsonl-stream": "0.0.0",
     "ycodium-composer-tokens": "0.0.0"