@ycodium-ai/agent-claude 0.2.2672 → 0.2.2690

package/dist/index.js

@@ -19900,18 +19900,37 @@ function withClaudeCredentialsDir(input) {
   const variable = CLAUDE_CREDENTIALS_DIR_ENVIRONMENT_VARIABLE;
   return input.platform === "win32" ? `$env:${variable}=${quotePowerShellValue(input.credentialsDirPath)}; ${input.command}` : `${variable}=${quotePosixShellValue(input.credentialsDirPath)} ${input.command}`;
 }
-function claudeSignInCommand(credentialsPath, platform) {
+function claudeSignInCommand(credentialsPath, platform2) {
   const command = "claude auth login";
   const credentialsDirPath = resolveClaudeCredentialsDirPath(credentialsPath);
   if (credentialsDirPath === null) return command;
-  return withClaudeCredentialsDir({ command, credentialsDirPath, platform });
+  return withClaudeCredentialsDir({ command, credentialsDirPath, platform: platform2 });
 }
 
 // src/claudeSkills.ts
 import * as NodeFSP from "node:fs/promises";
 import * as NodePath5 from "node:path";
-var FRONT_MATTER_KEY = /^(name|description):[ \t]*(.*)$/;
+import * as NodeProcess from "node:process";
+var FRONT_MATTER_KEY = /^(description|disable-model-invocation|user-invocable):[ \t]*(.*)$/;
 var BLOCK_SCALAR = /^[|>][+-]?$/;
+function parseFrontMatterBoolean(value) {
+  switch (value?.trim().toLowerCase()) {
+    case "true":
+    case "yes":
+    case "on":
+    case "y":
+    case "1":
+      return true;
+    case "false":
+    case "no":
+    case "off":
+    case "n":
+    case "0":
+      return false;
+    default:
+      return void 0;
+  }
+}
 function parseSkillFrontMatter(contents) {
   const lines = contents.split(/\r?\n/);
   if (lines[0]?.trim() !== "---") return {};
@@ -19933,30 +19952,156 @@ function parseSkillFrontMatter(contents) {
       }
       value = block.join(value.startsWith("|") ? "\n" : " ");
     } else {
+      if (key !== "description") value = value.replace(/\s+#.*$/, "");
       value = value.replace(/^(["'])(.*)\1$/, "$2").trim();
     }
     if (value.length > 0 && values[key] === void 0) values[key] = value;
   }
-  return values;
+  const description = values["description"];
+  return {
+    ...description === void 0 ? {} : { description },
+    ...parseFrontMatterBoolean(values["disable-model-invocation"]) === true ? { userInvocationOnly: true } : {},
+    ...parseFrontMatterBoolean(values["user-invocable"]) === false ? { userInvocable: false } : {}
+  };
 }
-async function discoverClaudeSkills(configDirPath) {
-  const root = NodePath5.join(configDirPath, "skills");
-  const entries = await NodeFSP.readdir(root).catch(() => []);
-  const skills = /* @__PURE__ */ new Map();
-  for (const entry of entries.toSorted()) {
-    const skillPath = NodePath5.join(root, entry, "SKILL.md");
-    const contents = await NodeFSP.readFile(skillPath, "utf8").catch(() => void 0);
+function claudeManagedSettingsPath(platform2, environment) {
+  if (platform2 === "darwin") {
+    return "/Library/Application Support/ClaudeCode/managed-settings.json";
+  }
+  if (platform2 === "win32") {
+    const programData = environment["PROGRAMDATA"]?.trim();
+    return programData ? NodePath5.join(programData, "ClaudeCode", "managed-settings.json") : void 0;
+  }
+  return "/etc/claude-code/managed-settings.json";
+}
+function skillOverrideSettingsPaths(configDirPath, cwd, platform2, environment, repositoryRoot) {
+  const managedPath = claudeManagedSettingsPath(platform2, environment);
+  const root = repositoryRoot !== void 0 && repositoryRoot !== cwd ? repositoryRoot : void 0;
+  return [
+    NodePath5.join(configDirPath, "settings.json"),
+    ...cwd ? [
+      NodePath5.join(cwd, ".claude", "settings.json"),
+      NodePath5.join(cwd, ".claude", "settings.local.json")
+    ] : [],
+    ...root ? [NodePath5.join(root, ".claude", "settings.local.json")] : [],
+    ...managedPath ? [managedPath] : []
+  ];
+}
+async function findRepositoryRoot(cwd) {
+  let current = NodePath5.resolve(cwd);
+  for (; ; ) {
+    const found = await NodeFSP.stat(NodePath5.join(current, ".git")).then(
+      () => true,
+      () => false
+    );
+    if (found) return current;
+    const parent = NodePath5.dirname(current);
+    if (parent === current) return void 0;
+    current = parent;
+  }
+}
+function parseLenientJson(text) {
+  let output = "";
+  let index = 0;
+  while (index < text.length) {
+    const char = text[index];
+    const next = text[index + 1];
+    if (char === '"') {
+      let end = index + 1;
+      while (end < text.length && text[end] !== '"') end += text[end] === "\\" ? 2 : 1;
+      output += text.slice(index, end + 1);
+      index = end + 1;
+    } else if (char === "/" && next === "/") {
+      while (index < text.length && text[index] !== "\n") index += 1;
+    } else if (char === "/" && next === "*") {
+      const end = text.indexOf("*/", index + 2);
+      index = end === -1 ? text.length : end + 2;
+    } else {
+      output += char;
+      index += 1;
+    }
+  }
+  return JSON.parse(output.replace(/,(\s*[}\]])/g, "$1"));
+}
+var SKILL_OVERRIDE_BY_VALUE = {
+  off: { enabled: false, userInvocationOnly: false },
+  // 与 `disable-model-invocation` 一样对 agent 隐藏，所以与普通开关分开记。
+  "user-invocable-only": { enabled: true, userInvocationOnly: true },
+  on: { enabled: true, userInvocationOnly: false },
+  "name-only": { enabled: true, userInvocationOnly: false }
+};
+function readOverridesFromSettings(text) {
+  let parsed;
+  try {
+    parsed = parseLenientJson(text);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return void 0;
+  const overrides = parsed["skillOverrides"];
+  if (typeof overrides !== "object" || overrides === null || Array.isArray(overrides)) {
+    return void 0;
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const [name, value] of Object.entries(overrides)) {
+    const override = typeof value === "string" ? SKILL_OVERRIDE_BY_VALUE[value] : void 0;
+    if (override === void 0) return void 0;
+    result.set(name, override);
+  }
+  return result;
+}
+async function readSkillOverrides(configDirPath, cwd, platform2, environment) {
+  const repositoryRoot = cwd === void 0 ? void 0 : await findRepositoryRoot(cwd);
+  const merged = /* @__PURE__ */ new Map();
+  for (const settingsPath of skillOverrideSettingsPaths(
+    configDirPath,
+    cwd,
+    platform2,
+    environment,
+    repositoryRoot
+  )) {
+    const contents = await NodeFSP.readFile(settingsPath, "utf8").catch(() => void 0);
     if (contents === void 0) continue;
-    const frontMatter = parseSkillFrontMatter(contents);
-    const name = frontMatter.name ?? entry.trim();
-    if (name.length === 0) continue;
-    skills.set(name, {
-      name,
-      path: skillPath,
-      enabled: true,
-      scope: "user",
-      ...frontMatter.description === void 0 ? {} : { description: frontMatter.description }
-    });
+    for (const [name, override] of readOverridesFromSettings(contents) ?? []) {
+      merged.set(name, override);
+    }
+  }
+  return merged;
+}
+async function discoverClaudeSkills(configDirPath, options = {}) {
+  const { cwd } = options;
+  const overrides = await readSkillOverrides(
+    configDirPath,
+    cwd,
+    options.platform ?? NodeProcess.platform,
+    options.environment ?? NodeProcess.env
+  );
+  const roots = [
+    { directory: NodePath5.join(configDirPath, "skills"), scope: "user" },
+    ...cwd ? [{ directory: NodePath5.join(cwd, ".claude", "skills"), scope: "project" }] : []
+  ];
+  const skills = /* @__PURE__ */ new Map();
+  for (const root of roots) {
+    const entries = await NodeFSP.readdir(root.directory).catch(() => []);
+    for (const entry of entries.toSorted()) {
+      const name = entry.trim();
+      if (name.length === 0 || skills.has(name)) continue;
+      const skillPath = NodePath5.join(root.directory, entry, "SKILL.md");
+      const contents = await NodeFSP.readFile(skillPath, "utf8").catch(() => void 0);
+      if (contents === void 0) continue;
+      const frontMatter = parseSkillFrontMatter(contents);
+      const override = overrides.get(name);
+      const userInvocationOnly = frontMatter.userInvocationOnly === true || override?.userInvocationOnly === true;
+      skills.set(name, {
+        name,
+        path: skillPath,
+        enabled: override?.enabled ?? true,
+        scope: root.scope,
+        ...frontMatter.description === void 0 ? {} : { description: frontMatter.description },
+        ...userInvocationOnly ? { userInvocationOnly: true } : {},
+        ...frontMatter.userInvocable === false ? { userInvocable: false } : {}
+      });
+    }
   }
   return [...skills.values()].toSorted((left, right) => left.name.localeCompare(right.name));
 }
@@ -19974,14 +20119,14 @@ function readTrimmed(value) {
 }
 function readEnvironment(value) {
   if (!Array.isArray(value)) return {};
-  const env = {};
+  const env2 = {};
   for (const entry of value) {
     if (!isRecord2(entry)) continue;
     const name = readTrimmed(entry["name"]);
     if (name.length === 0) continue;
-    env[name] = readString(entry["value"]);
+    env2[name] = readString(entry["value"]);
   }
-  return env;
+  return env2;
 }
 function readCustomModels(value) {
   if (!Array.isArray(value)) return [];
@@ -20167,8 +20312,8 @@ var EventBus = class {
         const queued = this.#queued.shift();
         if (queued !== void 0) return Promise.resolve({ done: false, value: queued });
         if (this.#closed) return Promise.resolve({ done: true, value: void 0 });
-        return new Promise((resolve3) => {
-          this.#waiters.push(resolve3);
+        return new Promise((resolve4) => {
+          this.#waiters.push(resolve4);
         });
       }
     };
@@ -20355,9 +20500,9 @@ var claudeCatalogFromSdk = (models) => {
 };
 var silentPrompt = (signal) => ({
   [Symbol.asyncIterator]: () => ({
-    next: () => new Promise((resolve3) => {
-      if (signal.aborted) resolve3({ done: true, value: void 0 });
-      signal.addEventListener("abort", () => resolve3({ done: true, value: void 0 }), {
+    next: () => new Promise((resolve4) => {
+      if (signal.aborted) resolve4({ done: true, value: void 0 });
+      signal.addEventListener("abort", () => resolve4({ done: true, value: void 0 }), {
         once: true
       });
     }),
@@ -20587,10 +20732,10 @@ function inputDiffStat(input) {
   let deletions = 0;
   for (const edit of input.edits) {
     if (edit === null || typeof edit !== "object" || Array.isArray(edit)) return void 0;
-    const stat = replacementDiffStat(edit, budget);
-    if (!stat) return void 0;
-    additions += stat.additions;
-    deletions += stat.deletions;
+    const stat2 = replacementDiffStat(edit, budget);
+    if (!stat2) return void 0;
+    additions += stat2.additions;
+    deletions += stat2.deletions;
   }
   return { additions, deletions };
 }
@@ -21223,7 +21368,7 @@ function claudeReadAllowRules(directories) {
 import * as NodeFS3 from "node:fs";
 import * as NodeOS6 from "node:os";
 import * as NodePath6 from "node:path";
-import * as NodeProcess from "node:process";
+import * as NodeProcess2 from "node:process";
 
 // ../../packages/ycodium-jsonl-stream/src/jsonlStream.ts
 var DEFAULT_MAX_RETAINED_CHARS = 8e6;
@@ -21859,17 +22004,17 @@ function listTranscriptFiles(transcriptDir, directory) {
       continue;
     }
     for (const name of names) {
-      let stat;
+      let stat2;
       try {
-        stat = NodeFS3.statSync(NodePath6.join(projectDir, name));
+        stat2 = NodeFS3.statSync(NodePath6.join(projectDir, name));
       } catch {
         continue;
       }
       found.push({
         path: NodePath6.join(projectDir, name),
         sessionId: name.slice(0, -TRANSCRIPT_SUFFIX.length),
-        size: stat.size,
-        mtimeMs: Number.isFinite(stat.mtimeMs) ? stat.mtimeMs : 0
+        size: stat2.size,
+        mtimeMs: Number.isFinite(stat2.mtimeMs) ? stat2.mtimeMs : 0
       });
     }
   }
@@ -21895,7 +22040,7 @@ function readClaudeLiveSessionIds(configDir) {
     const typed = marker;
     if (typeof typed.pid !== "number" || typeof typed.sessionId !== "string") continue;
     try {
-      NodeProcess.kill(typed.pid, 0);
+      NodeProcess2.kill(typed.pid, 0);
     } catch {
       continue;
     }
@@ -23103,6 +23248,30 @@ function createClaudeTextGeneration(recipe, host, modelCatalog) {
   };
 }
 
+// src/claudeSkillDispatch.ts
+var SKILL_MENTION_PATTERN = /(^|\s)\$([a-zA-Z][a-zA-Z0-9:_-]*)(?=\s|$)/g;
+function planClaudeSkillDispatch(prompt, skillNames) {
+  const mentions = [...prompt.matchAll(SKILL_MENTION_PATTERN)].flatMap((match) => {
+    const name = match[2] ?? "";
+    if (!skillNames.has(name)) return [];
+    const start = (match.index ?? 0) + (match[1]?.length ?? 0);
+    return [{ name, start, end: start + name.length + 1 }];
+  });
+  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();
+  return {
+    leadingText: leadingWithInlineSlashes.length > 0 ? leadingWithInlineSlashes : void 0,
+    commandText: `/${last.name}${trailing}`.trimEnd(),
+    skillName: last.name
+  };
+}
+
 // src/imageMime.ts
 var IMAGE_EXTENSION_BY_MIME_TYPE = {
   "image/avif": ".avif",
@@ -23183,9 +23352,9 @@ var PromptQueue = class {
     const queued = this.#queued.shift();
     if (queued !== void 0) return Promise.resolve(queued);
     if (this.#closed) return Promise.resolve(void 0);
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       this.#waiters.push((result) => {
-        resolve3(result.done ? void 0 : result.value);
+        resolve4(result.done ? void 0 : result.value);
       });
     });
   }
@@ -23266,6 +23435,10 @@ 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 });
+  }
   for (const attachment of input.attachments ?? []) {
     if (!attachment || typeof attachment !== "object" || Array.isArray(attachment)) continue;
     const rec = attachment;
@@ -23284,7 +23457,9 @@ async function buildUserMessageFromTurn(input) {
     const bytes = await input.attachmentsApi.read(id2);
     sdkContent.push(buildClaudeImageContentBlock({ mimeType, bytes }));
   }
-  if (input.text.length > 0) {
+  if (dispatch !== void 0) {
+    sdkContent.push({ type: "text", text: dispatch.commandText });
+  } else if (input.text.length > 0) {
     sdkContent.push({ type: "text", text: input.text });
   }
   return buildUserMessage({ sdkContent });
@@ -23304,10 +23479,10 @@ async function persistProducedImage(input) {
 }
 
 // src/claudeInstance.ts
-function compactEnv(env) {
+function compactEnv(env2) {
   const out = {};
-  if (!env) return out;
-  for (const [key, value] of Object.entries(env)) {
+  if (!env2) return out;
+  for (const [key, value] of Object.entries(env2)) {
     if (value !== void 0) out[key] = value;
   }
   return out;
@@ -25071,7 +25246,7 @@ function createClaudeAdapter(recipe, host, options) {
       if (streamFiber) {
         await Promise.race([
           streamFiber.catch(() => void 0),
-          new Promise((resolve3) => setTimeout(resolve3, 1e3))
+          new Promise((resolve4) => setTimeout(resolve4, 1e3))
         ]);
       }
       const updatedAt = nowIso();
@@ -25282,7 +25457,7 @@ function createClaudeAdapter(recipe, host, options) {
         return await Promise.race([
           contextDeferred.promise,
           new Promise(
-            (resolve3) => setTimeout(() => resolve3(void 0), CLAUDE_SESSION_CONTEXT_WAIT_MS)
+            (resolve4) => setTimeout(() => resolve4(void 0), CLAUDE_SESSION_CONTEXT_WAIT_MS)
           )
         ]);
       } catch {
@@ -25839,10 +26014,20 @@ 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 message = await buildUserMessageFromTurn({
       text: buildPromptText(turnCapsForPrompt, input, boundInstanceId),
       attachments: input.attachments,
-      attachmentsApi: options?.attachments
+      attachmentsApi: options?.attachments,
+      skillNames: new Set(
+        skills.filter(
+          (skill) => skill.scope === "user" && skill.enabled && skill.userInvocable !== false
+        ).map((skill) => skill.name)
+      )
     });
     validateSteeringTarget();
     context.promptQueue.push({
@@ -25870,7 +26055,7 @@ function createClaudeAdapter(recipe, host, options) {
         context.query.interrupt().then(() => settled.promise).then(() => {
           acknowledged = true;
         }),
-        new Promise((resolve3) => setTimeout(resolve3, CLAUDE_INTERRUPT_GRACE_MS))
+        new Promise((resolve4) => setTimeout(resolve4, CLAUDE_INTERRUPT_GRACE_MS))
       ]);
     } catch (cause) {
       throw toRequestError(threadId, "turn/interrupt", cause);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-claude",
-  "version": "0.2.2672",
+  "version": "0.2.2690",
   "description": "Claude executor: Claude Code CLI via @anthropic-ai/claude-agent-sdk.",
   "keywords": [
     "ycodium",
@@ -25,7 +25,7 @@
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
     "ycodium-executor-testing": "0.0.0",
-    "@ycodium-ai/plugin-api": "0.2.2672",
+    "@ycodium-ai/plugin-api": "0.2.2690",
     "ycodium-jsonl-stream": "0.0.0"
   },
   "ycodium": {