impel-cli 0.14.0 → 0.14.1

package/README.md

@@ -630,8 +630,8 @@ every managed profile. This catalog is separate from automatic specialists: it
 may include truthfully declared write-capable agents, but those agents require
 explicit user selection before the server will start a run.
 
-- Claude Code: `<CLAUDE_CONFIG_DIR>/agents/impel-managed/*.md`
-- Codex / ChatGPT Codex mode: `<CODEX_HOME>/agents/impel-managed/*.toml`
+- Claude Code / Claude Desktop: `<CLAUDE_CONFIG_DIR>/agents/<agent-name>.md`
+- Codex / ChatGPT Codex mode: `<CODEX_HOME>/agents/impel-<tenant>-<agent-id>.toml`
 
 Each generated agent is bound to one exact `agentId` and
 `scopeParam`. It verifies that the exact agent is still available, starts one
@@ -643,8 +643,8 @@ when invoked.
 
 Visible agent names come from the registry title. Codex keeps that title as the
 custom-agent name; Claude uses the lowercase, hyphenated form required by its
-native agent schema. The generated filenames remain stable tenant-and-agent
-identifiers so title changes update in place without colliding with user files.
+native agent schema and Desktop's `@` picker requires the Markdown filename to
+match that name. Codex filenames remain stable tenant-and-agent identifiers.
 Duplicate or built-in-reserved titles receive a deterministic disambiguator.
 
 The sync writes atomically and records a manifest beside the generated files.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impel-cli",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Configure Claude Code and Codex CLI to talk to Impel's gateway, authenticated by an Impel Personal Access Token",
   "type": "module",
   "bin": {

package/src/agents.js

@@ -398,10 +398,16 @@ export function renderManagedAgents(client, tenantId, agents, invocation = impel
   return agents.map((agent, index) => {
     const name = names[index];
     const extension = client === "claude" ? ".md" : ".toml";
+    // Claude Desktop decides whether an SDK-reported agent is user-defined by
+    // comparing its reported name with the Markdown filename (without .md).
+    // A stable tenant/agent filename causes Desktop to classify the agent as a
+    // builtin and remove it from the @ mention picker. Claude names are already
+    // collision-safe, filesystem-safe identifiers, so use them as filenames.
+    const fileStem = client === "claude" ? name : fileStems[index];
     const contents = client === "claude"
       ? renderClaudeAgent({ tenantId: normalizedTenant, agent, name, invocation })
       : renderCodexAgent({ tenantId: normalizedTenant, agent, name, invocation });
-    return { agentId: agent.agentId, name, fileName: `${fileStems[index]}${extension}`, contents };
+    return { agentId: agent.agentId, name, fileName: `${fileStem}${extension}`, contents };
   });
 }
 
@@ -432,7 +438,7 @@ function readManifest(manifestPath) {
 
 function profileIsFresh(profile, tenantId, now, ttlMs) {
   const manifest = readManifest(path.join(profile.root, "agents", MANAGED_AGENT_DIRECTORY, MANAGED_AGENT_MANIFEST));
-  if (!manifest || manifest.version !== 2 || manifest.tenantId !== tenantId) return false;
+  if (!manifest || manifest.version !== 3 || manifest.tenantId !== tenantId) return false;
   const syncedAt = Date.parse(manifest.syncedAt || "");
   if (!Number.isFinite(syncedAt) || now - syncedAt >= ttlMs) return false;
   return manifest.files.every((fileName) =>
@@ -455,7 +461,7 @@ export function syncAgentProfile({ client, root, label, tenantId, agents, now =
   const prior = readManifest(manifestPath);
   const rendered = renderManagedAgents(client, tenantId, agents);
   const priorFiles = new Set(prior?.files || []);
-  const priorUsesDiscoveryRoot = prior?.version === 2;
+  const priorUsesDiscoveryRoot = prior?.version === 2 || prior?.version === 3;
 
   // Native clients discover standalone definitions directly under `agents/`.
   // Preflight every destination before writing so an unmanaged file with the
@@ -497,7 +503,7 @@ export function syncAgentProfile({ client, root, label, tenantId, agents, now =
     }
   }
   atomicPrivateWrite(manifestPath, `${JSON.stringify({
-    version: 2,
+    version: 3,
     tenantId,
     client,
     syncedAt: new Date(now).toISOString(),