@falkenslab/agent-kit 0.23.0 → 0.24.0

package/dist/chat/extensions.js

@@ -38,7 +38,7 @@ export function describeCapabilities(status) {
 /** One line for a catalog entry: what installs it, its version, whether it's installed or has an update, what it is. */
 export function describeEntry(entry) {
     const state = entry.installed ? (entry.update ? ` ${t().extensionUpdateAvailable(entry.installed.manifest?.version ?? "?")}` : ` ${t().extensionIsInstalled}`) : "";
-    return `${entry.spec}${entry.version ? ` ${entry.version}` : ""}${state}${entry.plugin.description ? `  ${entry.plugin.description}` : ""}`;
+    return `${entry.spec}${entry.version ? ` ${entry.version}` : ""}${state}${entry.description ? `  ${entry.description}` : ""}`;
 }
 /** An installed extension's options, one line each: its value, its default, or whether a sensitive one is set (never its value). */
 export async function describeOptions(extension) {

package/dist/core/extensionCatalog.d.ts

@@ -22,6 +22,8 @@ export interface CatalogEntry {
     /** From the agent's own marketplace: installed without a confirmation. */
     official: boolean;
     plugin: MarketplacePlugin;
+    /** What it is, in the kit's language (#67): its own there, else the marketplace entry's, else its `plugin.json`'s, in English. */
+    description: string;
     /** The version it offers: its `plugin.json`'s when the marketplace has its folder, else the marketplace's entry's. */
     version?: string;
     /** Installed (and used: not shadowed), from wherever it came. */

package/dist/core/extensionCatalog.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { addExtension, codeStoreDir, hashExtension, inKitRange, installTarget, isGitSource, listInstalled, readExternalManifest, readLock, storedCodeDir } from "./externalExtensions.js";
 import { cachePackage, cachedPackageDir } from "./npxPackages.js";
 import { trustWorkspace } from "./workspaceTrust.js";
-import { describeCapability } from "./extensions.js";
+import { describeCapability, describeInLanguage } from "./extensions.js";
 import { getLanguage } from "./messages/index.js";
 import { addMarketplace, findPlugin, installFromMarketplace, listMarketplaces, resolvePluginSource, updateMarketplace } from "./marketplaces.js";
 /**
@@ -68,13 +68,14 @@ async function offered(marketplace, plugin) {
             const version = manifest?.version ?? plugin.version;
             const capabilities = (manifest?.capabilities ?? []).map((capability) => describeCapability(capability, getLanguage()));
             const requirements = (manifest?.requirements ?? []).map((requirement) => ({ name: requirement.name, for: requirement.for }));
-            return { ...(version ? { version } : {}), keywords: manifest?.keywords ?? [], ...(logo ? { logo } : {}), ...(banner ? { banner } : {}), capabilities, requirements };
+            const description = describeInLanguage(plugin.description ?? manifest?.description ?? "", manifest?.descriptions, getLanguage());
+            return { ...(version ? { version } : {}), keywords: manifest?.keywords ?? [], ...(logo ? { logo } : {}), ...(banner ? { banner } : {}), capabilities, requirements, description };
         }
     }
     catch {
         // A source the kit doesn't install: the entry's own fields.
     }
-    return { ...(plugin.version ? { version: plugin.version } : {}), keywords: [], capabilities: [], requirements: [] };
+    return { ...(plugin.version ? { version: plugin.version } : {}), keywords: [], capabilities: [], requirements: [], description: plugin.description ?? "" };
 }
 /** Whether `offered` is newer than `installed` (x.y.z); a version that can't be compared isn't. */
 export function isNewer(offered, installed) {
@@ -96,7 +97,7 @@ export async function extensionCatalog(dirs, options = {}) {
             if (wanted && !topics.some((topic) => wanted.has(topic)))
                 continue;
             // Its capabilities count too: a search for "grading" finds what grades.
-            const text = [plugin.name, plugin.description, ...topics, ...look.capabilities.flatMap(({ id, label, description }) => [id, label, description])].join(" ").toLowerCase();
+            const text = [plugin.name, plugin.description, look.description, ...topics, ...look.capabilities.flatMap(({ id, label, description }) => [id, label, description])].join(" ").toLowerCase();
             if (!words.every((word) => text.includes(word)))
                 continue;
             const version = look.version;
@@ -104,6 +105,7 @@ export async function extensionCatalog(dirs, options = {}) {
             const fromHere = mine?.lock.marketplace === `${plugin.name}@${marketplace.name}`;
             entries.push({
                 spec: `${plugin.name}@${marketplace.name}`,
+                description: look.description,
                 marketplace: marketplace.name,
                 official: marketplace.official,
                 plugin,

package/dist/core/extensions.d.ts

@@ -135,6 +135,13 @@ export declare function describeCapability(capability: ExtensionCapability, lang
  * one is missing.
  */
 export declare function capabilitiesProblem(pluginRoot: string, capabilities: readonly ExtensionCapability[]): Promise<string | undefined>;
+/**
+ * A manifest's `metadata["agent-kit"].description` (#67): its description in other languages than
+ * English, which stays the top-level `description` Claude Code reads. Only languages the kit speaks.
+ */
+export declare function parseDescriptions(raw: unknown): Partial<Record<Language, string>>;
+/** An extension's description in `language`: its own there, else the English one. */
+export declare function describeInLanguage(english: string, descriptions: Partial<Record<Language, string>> | undefined, language: Language): string;
 /** An extension's manifest, as the kit reads it. */
 export interface ExtensionManifest {
     name: string;

package/dist/core/extensions.js

@@ -49,6 +49,19 @@ export async function capabilitiesProblem(pluginRoot, capabilities) {
     }
     return undefined;
 }
+/**
+ * A manifest's `metadata["agent-kit"].description` (#67): its description in other languages than
+ * English, which stays the top-level `description` Claude Code reads. Only languages the kit speaks.
+ */
+export function parseDescriptions(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return {};
+    return Object.fromEntries(Object.entries(raw).filter(([language, text]) => SUPPORTED_LANGUAGES.includes(language) && typeof text === "string" && text.length > 0));
+}
+/** An extension's description in `language`: its own there, else the English one. */
+export function describeInLanguage(english, descriptions, language) {
+    return descriptions?.[language] ?? english;
+}
 /** Reads an extension's manifest from its plugin. */
 export function readExtensionManifest(pluginRoot) {
     const file = path.join(pluginRoot, ".claude-plugin", "plugin.json");

package/dist/core/externalExtensions.d.ts

@@ -49,7 +49,10 @@ export interface ExtensionAuthor {
  */
 export interface ExternalManifest {
     name: string;
+    /** Its description in English: `plugin.json`'s, which Claude Code reads. */
     description: string;
+    /** Its description in other languages (#67), from `metadata["agent-kit"].description`. */
+    descriptions: Partial<Record<Language, string>>;
     version?: string;
     author?: ExtensionAuthor;
     homepage?: string;

package/dist/core/externalExtensions.js

@@ -5,7 +5,7 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
-import { capabilitiesProblem, parseCapabilities, providedBy } from "./extensions.js";
+import { capabilitiesProblem, parseCapabilities, parseDescriptions, providedBy } from "./extensions.js";
 import { getLanguage } from "./messages/index.js";
 import { truncate } from "./toolLabels.js";
 import { agentKitVersion } from "./version.js";
@@ -97,6 +97,7 @@ export async function readExternalManifest(dir) {
     return {
         name,
         description: typeof raw.description === "string" ? raw.description : "",
+        descriptions: parseDescriptions(kit.description),
         ...text("version"),
         ...(author && typeof author === "object" && typeof author.name === "string"
             ? { author: { name: author.name, ...(author.email ? { email: author.email } : {}), ...(author.url ? { url: author.url } : {}) } }

package/dist/tui/extensionCommand.js

@@ -6,7 +6,7 @@ import { addExtension, extensionOptionStates, installTarget, folderSize, isGitSo
 import { describe, describeOptions } from "../chat/extensions.js";
 import { extensionCatalog, knownMarketplaces as catalogMarketplaces, restoreExtensions, updateExtension } from "../core/extensionCatalog.js";
 import { trustWorkspace } from "../core/workspaceTrust.js";
-import { describeCapability } from "../core/extensions.js";
+import { describeCapability, describeInLanguage } from "../core/extensions.js";
 import { getLanguage } from "../core/messages/index.js";
 export { chatExtensionsCommand, describe } from "../chat/extensions.js";
 /**
@@ -402,10 +402,13 @@ async function info(extension) {
     if (!manifest)
         return [describe(extension), "Its manifest can't be read."];
     const author = manifest.author ? [manifest.author.name, manifest.author.email && `<${manifest.author.email}>`, manifest.author.url && `(${manifest.author.url})`].filter(Boolean).join(" ") : undefined;
-    const readme = path.join(extension.dir, "README.md");
+    // Its README in the kit's language when it has one (README.es.md), else the English (#67).
+    const language = getLanguage();
+    const translated = path.join(extension.dir, `README.${language}.md`);
+    const readme = language !== "en" && (await stat(translated).catch(() => null))?.isFile() ? translated : path.join(extension.dir, "README.md");
     const field = (label, value) => (value ? [`${label.padEnd(13)}${value}`] : []);
     return [
-        `${manifest.name}${manifest.version ? ` ${manifest.version}` : ""}: ${manifest.description}`,
+        `${manifest.name}${manifest.version ? ` ${manifest.version}` : ""}: ${describeInLanguage(manifest.description, manifest.descriptions, language)}`,
         ...field("Author", author),
         ...field("License", manifest.license),
         ...field("Homepage", manifest.homepage),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkenslab/agent-kit",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Library for building an agent on top of the Claude Agent SDK",
   "author": "Francisco Vargas Ruiz",
   "license": "MIT",

package/schemas/agent-kit-metadata.schema.json

@@ -11,6 +11,12 @@
       "type": "string",
       "pattern": "^\\s*(?:(?:>=|<=|>|<|=)?\\s*v?\\d+(?:\\.\\d+){0,2})(?:\\s+(?:>=|<=|>|<|=)?\\s*v?\\d+(?:\\.\\d+){0,2})*\\s*$"
     },
+    "description": {
+      "description": "Its description in other languages than English, which stays plugin.json's own description (Claude Code reads that one).",
+      "type": "object",
+      "propertyNames": { "enum": ["es", "fr", "de"] },
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
     "provides": { "description": "Capabilities it lets the agent use, by name only. Its capabilities' ids count as provided too.", "type": "array", "items": { "type": "string", "minLength": 1 } },
     "capabilities": {
       "description": "What it lets the agent do, for the person: each one's skills and tools together, described per language. Its id is what requires names; neutral ids (lms-grading) let skills depend on what can be done, not on which extension does it.",

package/schemas/marketplace-catalog.schema.json

@@ -35,7 +35,14 @@
       "properties": {
         "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
         "version": { "description": "Its plugin.json's, the same as its marketplace entry's.", "type": "string", "minLength": 1 },
-        "description": { "type": "string" },
+        "description": { "description": "In English: its marketplace entry's, else its plugin.json's.", "type": "string" },
+        "descriptions": {
+          "description": "Its description per language, English among them; only when it has one in another language.",
+          "type": "object",
+          "propertyNames": { "enum": ["en", "es", "fr", "de"] },
+          "required": ["en"],
+          "additionalProperties": { "type": "string" }
+        },
         "category": { "type": ["string", "null"] },
         "topics": {
           "description": "Its plugin.json's keywords and its entry's tags, keywords and category, lowercased, without repeats.",
@@ -47,6 +54,13 @@
         "license": { "type": ["string", "null"] },
         "homepage": { "$ref": "#/$defs/url" },
         "readme": { "$ref": "#/$defs/url" },
+        "readmes": {
+          "description": "Its README per language (README.md, README.es.md…), as URLs; only when it has one in another language.",
+          "type": "object",
+          "propertyNames": { "enum": ["en", "es", "fr", "de"] },
+          "required": ["en"],
+          "additionalProperties": { "$ref": "#/$defs/url" }
+        },
         "install": {
           "type": "object",
           "additionalProperties": false,