@ryuhq/sdk 0.1.3 → 0.1.5

package/dist/chunk-G6FLVEC4.js

@@ -0,0 +1,210 @@
+// src/agent-plugin.ts
+var AGENT_PLUGINS_SPEC_VERSION = "1.0.0";
+var AGENT_PLUGIN_SCHEMA_URL = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+var AGENT_PLUGIN_MCP_SCHEMA_URL = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+var AGENT_PLUGIN_EXTENSION_NS = "com.ryuhq.ryu";
+var AGENT_PLUGIN_MANIFEST_FILE = "plugin.json";
+var AGENT_PLUGIN_MCP_FILE = "mcp.json";
+function isAgentPluginManifest(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  const schema = value.$schema;
+  return typeof schema === "string" && schema.startsWith("https://agent-plugins.org/schemas/");
+}
+var SPEC_NAME_MAX = 64;
+var ILLEGAL_NAME_CHARS = /[^a-z0-9.-]+/g;
+var REPEATED_HYPHENS = /-{2,}/g;
+var REPEATED_DOTS = /\.{2,}/g;
+var LEADING_NON_ALNUM = /^[^a-z0-9]+/;
+var TRAILING_NON_ALNUM = /[^a-z0-9]+$/;
+var WHITESPACE = /\s/;
+function toSpecName(id) {
+  const normalized = id.trim().toLowerCase().replace(/^@/, "").replace(/[/_]/g, ".").replace(ILLEGAL_NAME_CHARS, "-").replace(REPEATED_HYPHENS, "-").replace(REPEATED_DOTS, ".").replace(LEADING_NON_ALNUM, "").replace(TRAILING_NON_ALNUM, "").slice(0, SPEC_NAME_MAX).replace(TRAILING_NON_ALNUM, "");
+  if (!normalized) {
+    throw new Error(
+      `plugin id ${JSON.stringify(id)} has no spec-legal name projection`
+    );
+  }
+  return normalized;
+}
+function asString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function asStringArray(value) {
+  if (!Array.isArray(value)) {
+    return;
+  }
+  const strings = value.filter((v) => typeof v === "string");
+  return strings.length > 0 ? strings : void 0;
+}
+function toSpecAuthor(value) {
+  const bare = asString(value);
+  if (bare) {
+    return { name: bare };
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  const source = value;
+  const author = {};
+  const name = asString(source.name);
+  const email = asString(source.email);
+  const url = asString(source.url);
+  if (name) {
+    author.name = name;
+  }
+  if (email) {
+    author.email = email;
+  }
+  if (url) {
+    author.url = url;
+  }
+  return Object.keys(author).length > 0 ? author : void 0;
+}
+function toSpecEnv(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  const env = {};
+  for (const [key, raw] of Object.entries(value)) {
+    if (typeof raw === "string") {
+      env[key] = raw;
+    }
+  }
+  return Object.keys(env).length > 0 ? env : void 0;
+}
+function toSpecServer(name, decl) {
+  const extras = {};
+  const commandEnv = asString(decl.command_env);
+  const description = asString(decl.description);
+  if (commandEnv) {
+    extras.command_env = commandEnv;
+  }
+  if (description) {
+    extras.description = description;
+  }
+  if (decl.enabled === false) {
+    extras.enabled = false;
+    return {
+      extras,
+      note: `mcp server '${name}' is disabled in the native manifest and was omitted from ${AGENT_PLUGIN_MCP_FILE}`
+    };
+  }
+  const command = asString(decl.command);
+  if (!command) {
+    return {
+      extras,
+      note: `mcp server '${name}' has no command and was omitted`
+    };
+  }
+  if (WHITESPACE.test(command)) {
+    return {
+      extras,
+      note: `mcp server '${name}' command ${JSON.stringify(command)} is not a single executable token and was omitted`
+    };
+  }
+  if (command.startsWith("/") || command.startsWith("~")) {
+    return {
+      extras,
+      note: `mcp server '${name}' command ${JSON.stringify(command)} is an absolute path (spec allows a bare name or './' relative path) and was omitted`
+    };
+  }
+  const server = { type: "stdio", command };
+  const args = asStringArray(decl.args);
+  if (args) {
+    server.args = args;
+  }
+  const env = toSpecEnv(decl.env);
+  if (env) {
+    server.env = env;
+  }
+  return { server, extras };
+}
+function toAgentPlugin(manifest) {
+  const id = asString(manifest.id);
+  if (!id) {
+    throw new Error("manifest has no id");
+  }
+  const notes = [];
+  const ryu = {
+    id,
+    displayName: asString(manifest.name) ?? id
+  };
+  const plugin = {
+    $schema: AGENT_PLUGIN_SCHEMA_URL,
+    name: toSpecName(id)
+  };
+  const version = asString(manifest.version);
+  if (version) {
+    plugin.version = version;
+  }
+  const description = asString(manifest.description) ?? asString(manifest.tagline);
+  if (description) {
+    plugin.description = description;
+  }
+  const author = toSpecAuthor(manifest.author);
+  if (author) {
+    plugin.author = author;
+  }
+  const homepage = asString(manifest.homepage);
+  if (homepage) {
+    plugin.homepage = homepage;
+  }
+  const repository = asString(manifest.repository);
+  if (repository) {
+    plugin.repository = repository;
+  }
+  const license = asString(manifest.license);
+  if (license) {
+    plugin.license = license;
+  }
+  const keywords = asStringArray(manifest.keywords);
+  if (keywords) {
+    plugin.keywords = keywords;
+  }
+  const declared = manifest.mcp_servers;
+  const servers = {};
+  const mcpExtras = {};
+  if (declared && typeof declared === "object" && !Array.isArray(declared)) {
+    for (const [name, raw] of Object.entries(
+      declared
+    )) {
+      if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        notes.push(`mcp server '${name}' is not an object and was omitted`);
+        continue;
+      }
+      const { server, extras, note } = toSpecServer(
+        name,
+        raw
+      );
+      if (Object.keys(extras).length > 0) {
+        mcpExtras[name] = extras;
+      }
+      if (note) {
+        notes.push(note);
+      }
+      if (server) {
+        servers[name] = server;
+      }
+    }
+  }
+  if (Object.keys(mcpExtras).length > 0) {
+    ryu.mcp = mcpExtras;
+  }
+  plugin.extensions = { [AGENT_PLUGIN_EXTENSION_NS]: ryu };
+  const mcp = Object.keys(servers).length > 0 ? { $schema: AGENT_PLUGIN_MCP_SCHEMA_URL, mcpServers: servers } : null;
+  return { plugin, mcp, notes };
+}
+
+export {
+  AGENT_PLUGINS_SPEC_VERSION,
+  AGENT_PLUGIN_SCHEMA_URL,
+  AGENT_PLUGIN_MCP_SCHEMA_URL,
+  AGENT_PLUGIN_EXTENSION_NS,
+  AGENT_PLUGIN_MANIFEST_FILE,
+  AGENT_PLUGIN_MCP_FILE,
+  isAgentPluginManifest,
+  toSpecName,
+  toAgentPlugin
+};

package/dist/cli.cjs

@@ -28,6 +28,204 @@ var import_node_crypto = require("crypto");
 var import_node_fs = require("fs");
 var import_node_path = require("path");
 
+// src/agent-plugin.ts
+var AGENT_PLUGIN_SCHEMA_URL = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+var AGENT_PLUGIN_MCP_SCHEMA_URL = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+var AGENT_PLUGIN_EXTENSION_NS = "com.ryuhq.ryu";
+var AGENT_PLUGIN_MANIFEST_FILE = "plugin.json";
+var AGENT_PLUGIN_MCP_FILE = "mcp.json";
+function isAgentPluginManifest(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  const schema = value.$schema;
+  return typeof schema === "string" && schema.startsWith("https://agent-plugins.org/schemas/");
+}
+var SPEC_NAME_MAX = 64;
+var ILLEGAL_NAME_CHARS = /[^a-z0-9.-]+/g;
+var REPEATED_HYPHENS = /-{2,}/g;
+var REPEATED_DOTS = /\.{2,}/g;
+var LEADING_NON_ALNUM = /^[^a-z0-9]+/;
+var TRAILING_NON_ALNUM = /[^a-z0-9]+$/;
+var WHITESPACE = /\s/;
+function toSpecName(id) {
+  const normalized = id.trim().toLowerCase().replace(/^@/, "").replace(/[/_]/g, ".").replace(ILLEGAL_NAME_CHARS, "-").replace(REPEATED_HYPHENS, "-").replace(REPEATED_DOTS, ".").replace(LEADING_NON_ALNUM, "").replace(TRAILING_NON_ALNUM, "").slice(0, SPEC_NAME_MAX).replace(TRAILING_NON_ALNUM, "");
+  if (!normalized) {
+    throw new Error(
+      `plugin id ${JSON.stringify(id)} has no spec-legal name projection`
+    );
+  }
+  return normalized;
+}
+function asString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function asStringArray(value) {
+  if (!Array.isArray(value)) {
+    return;
+  }
+  const strings = value.filter((v) => typeof v === "string");
+  return strings.length > 0 ? strings : void 0;
+}
+function toSpecAuthor(value) {
+  const bare = asString(value);
+  if (bare) {
+    return { name: bare };
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  const source = value;
+  const author = {};
+  const name = asString(source.name);
+  const email = asString(source.email);
+  const url = asString(source.url);
+  if (name) {
+    author.name = name;
+  }
+  if (email) {
+    author.email = email;
+  }
+  if (url) {
+    author.url = url;
+  }
+  return Object.keys(author).length > 0 ? author : void 0;
+}
+function toSpecEnv(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  const env = {};
+  for (const [key, raw] of Object.entries(value)) {
+    if (typeof raw === "string") {
+      env[key] = raw;
+    }
+  }
+  return Object.keys(env).length > 0 ? env : void 0;
+}
+function toSpecServer(name, decl) {
+  const extras = {};
+  const commandEnv = asString(decl.command_env);
+  const description = asString(decl.description);
+  if (commandEnv) {
+    extras.command_env = commandEnv;
+  }
+  if (description) {
+    extras.description = description;
+  }
+  if (decl.enabled === false) {
+    extras.enabled = false;
+    return {
+      extras,
+      note: `mcp server '${name}' is disabled in the native manifest and was omitted from ${AGENT_PLUGIN_MCP_FILE}`
+    };
+  }
+  const command2 = asString(decl.command);
+  if (!command2) {
+    return {
+      extras,
+      note: `mcp server '${name}' has no command and was omitted`
+    };
+  }
+  if (WHITESPACE.test(command2)) {
+    return {
+      extras,
+      note: `mcp server '${name}' command ${JSON.stringify(command2)} is not a single executable token and was omitted`
+    };
+  }
+  if (command2.startsWith("/") || command2.startsWith("~")) {
+    return {
+      extras,
+      note: `mcp server '${name}' command ${JSON.stringify(command2)} is an absolute path (spec allows a bare name or './' relative path) and was omitted`
+    };
+  }
+  const server = { type: "stdio", command: command2 };
+  const args2 = asStringArray(decl.args);
+  if (args2) {
+    server.args = args2;
+  }
+  const env = toSpecEnv(decl.env);
+  if (env) {
+    server.env = env;
+  }
+  return { server, extras };
+}
+function toAgentPlugin(manifest) {
+  const id = asString(manifest.id);
+  if (!id) {
+    throw new Error("manifest has no id");
+  }
+  const notes = [];
+  const ryu = {
+    id,
+    displayName: asString(manifest.name) ?? id
+  };
+  const plugin = {
+    $schema: AGENT_PLUGIN_SCHEMA_URL,
+    name: toSpecName(id)
+  };
+  const version = asString(manifest.version);
+  if (version) {
+    plugin.version = version;
+  }
+  const description = asString(manifest.description) ?? asString(manifest.tagline);
+  if (description) {
+    plugin.description = description;
+  }
+  const author = toSpecAuthor(manifest.author);
+  if (author) {
+    plugin.author = author;
+  }
+  const homepage = asString(manifest.homepage);
+  if (homepage) {
+    plugin.homepage = homepage;
+  }
+  const repository = asString(manifest.repository);
+  if (repository) {
+    plugin.repository = repository;
+  }
+  const license = asString(manifest.license);
+  if (license) {
+    plugin.license = license;
+  }
+  const keywords = asStringArray(manifest.keywords);
+  if (keywords) {
+    plugin.keywords = keywords;
+  }
+  const declared = manifest.mcp_servers;
+  const servers = {};
+  const mcpExtras = {};
+  if (declared && typeof declared === "object" && !Array.isArray(declared)) {
+    for (const [name, raw] of Object.entries(
+      declared
+    )) {
+      if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        notes.push(`mcp server '${name}' is not an object and was omitted`);
+        continue;
+      }
+      const { server, extras, note } = toSpecServer(
+        name,
+        raw
+      );
+      if (Object.keys(extras).length > 0) {
+        mcpExtras[name] = extras;
+      }
+      if (note) {
+        notes.push(note);
+      }
+      if (server) {
+        servers[name] = server;
+      }
+    }
+  }
+  if (Object.keys(mcpExtras).length > 0) {
+    ryu.mcp = mcpExtras;
+  }
+  plugin.extensions = { [AGENT_PLUGIN_EXTENSION_NS]: ryu };
+  const mcp = Object.keys(servers).length > 0 ? { $schema: AGENT_PLUGIN_MCP_SCHEMA_URL, mcpServers: servers } : null;
+  return { plugin, mcp, notes };
+}
+
 // src/cli/dev.ts
 var import_node_readline = require("readline");
 
@@ -404,6 +602,20 @@ var PiExtensionContributionSchema = import_zod.z.object({
   /** Optional one-liner describing what the extension adds to the agent. */
   description: import_zod.z.string().optional()
 });
+var OutputStyleContributionSchema = import_zod.z.object({
+  /** Stable id for this style within the plugin (`[a-z0-9][a-z0-9._-]*`). It is
+   *  also the persisted selection key, so it must survive a settings key and a URL
+   *  path. */
+  id: import_zod.z.string().min(1),
+  /** SOURCE form: path to the Markdown file, relative to the plugin root —
+   *  exactly `output-styles/<name>.md`. `ryu pack` replaces this with `source`. */
+  file: import_zod.z.string().min(1).optional(),
+  /** WIRE form: the file's contents verbatim, frontmatter INCLUDED. The whole file
+   *  rather than a pre-split body plus mirrored `name`/`description` keys, so a
+   *  plugin style and a user's own `output-styles/*.md` go through one parser and
+   *  the frontmatter stays the single source of truth for a style's metadata. */
+  source: import_zod.z.string().optional()
+});
 var DEFAULT_WIDGET_MIME = "text/html+skybridge";
 var DEFAULT_WIDGET_DISPLAY_MODE = "inline";
 var WidgetContributionSchema = import_zod.z.object({
@@ -494,7 +706,15 @@ var ContributesSchema = import_zod.z.object({
    *  Typed (not a loose record) because Ryu owns this vocabulary — three fields,
    *  all of them Core-interpreted — unlike `lsp_servers`, whose entry shape is
    *  Claude Code's to extend. */
-  pi_extensions: import_zod.z.array(PiExtensionContributionSchema).default([])
+  pi_extensions: import_zod.z.array(PiExtensionContributionSchema).default([]),
+  /** Output styles the plugin ships — Markdown files that rewrite the system
+   *  prompt's voice. Mirrors the Rust-side `Contributes.output_styles`; without it
+   *  the CLI's zod parse would strip the declaration, and `ryu pack` would sign a
+   *  bundle whose styles simply do not exist. Worse than the usual case of that
+   *  bug: the styles' `.md` files are not carried by the bundle either, so there
+   *  would be no residue to notice — the plugin would install clean and contribute
+   *  nothing. */
+  output_styles: import_zod.z.array(OutputStyleContributionSchema).default([])
 });
 var SetupStepSchema = import_zod.z.object({
   /** Card heading (e.g. the companion app name). */
@@ -728,6 +948,8 @@ function printUsage() {
       "  bunx ryu pack <dir>      Validate and bundle a manifest.json Plugin",
       "  bunx ryu publish <dir>   Validate and publish a manifest.json Plugin to the Ryu Marketplace",
       "  bunx ryu dev <entry>     Run a Runnable locally with an interactive chat loop",
+      "  bunx ryu agent-plugin <dir>",
+      "                           Emit the Agent Plugins v1 interop pair (plugin.json + mcp.json)",
       ""
     ].join("\n")
   );
@@ -742,10 +964,20 @@ var MANIFEST_FILE_NAMES = [
   "plugin.json",
   "ryu.json"
 ];
+function resolveNativeManifestPath(dir) {
+  return MANIFEST_FILE_NAMES.map((name) => (0, import_node_path.join)(dir, name)).find((candidate) => {
+    if (!(0, import_node_fs.existsSync)(candidate)) {
+      return false;
+    }
+    try {
+      return !isAgentPluginManifest(JSON.parse((0, import_node_fs.readFileSync)(candidate, "utf8")));
+    } catch {
+      return true;
+    }
+  });
+}
 function loadManifest(dir) {
-  const manifestPath = MANIFEST_FILE_NAMES.map((name) => (0, import_node_path.join)(dir, name)).find(
-    (candidate) => (0, import_node_fs.existsSync)(candidate)
-  );
+  const manifestPath = resolveNativeManifestPath(dir);
   if (!manifestPath) {
     exitError(`manifest.json not found in: ${dir}`);
   }
@@ -768,7 +1000,7 @@ function loadManifest(dir) {
     const message = first?.message ?? "validation failed";
     exitError(`manifest.json validation failed at '${field}': ${message}`);
   }
-  return inlineCodeFiles(result.data, dir);
+  return inlineOutputStyleFiles(inlineCodeFiles(result.data, dir), dir);
 }
 var CODE_FILE_DIRS = ["hooks", "adapters"];
 var CODE_FILE_PATH = /^(hooks|adapters)\/[A-Za-z0-9_][A-Za-z0-9._-]*\.m?js$/;
@@ -810,6 +1042,42 @@ function inlineCodeFiles(manifest, dir) {
   }
   return out;
 }
+var MAX_OUTPUT_STYLE_BYTES = 64 * 1024;
+var OUTPUT_STYLE_DIR = "output-styles";
+var OUTPUT_STYLE_PATH = /^output-styles\/[A-Za-z0-9_-][A-Za-z0-9._-]*\.md$/;
+function inlineOutputStyleFiles(manifest, dir) {
+  const out = manifest;
+  for (const style of out.contributes?.output_styles ?? []) {
+    const rel = style.file;
+    if (typeof rel !== "string") {
+      continue;
+    }
+    const label = `output style '${String(style.id)}'`;
+    if (!OUTPUT_STYLE_PATH.test(rel) || rel.includes("..")) {
+      exitError(
+        `${label}: file '${rel}' must be exactly '${OUTPUT_STYLE_DIR}/<name>.md' with no traversal`
+      );
+    }
+    let body;
+    try {
+      body = (0, import_node_fs.readFileSync)((0, import_node_path.join)(dir, rel), "utf8");
+    } catch (err) {
+      exitError(`${label}: could not read file '${rel}': ${String(err)}`);
+    }
+    if (!body.trim()) {
+      exitError(`${label}: file '${rel}' is empty`);
+    }
+    const bytes = Buffer.byteLength(body, "utf8");
+    if (bytes > MAX_OUTPUT_STYLE_BYTES) {
+      exitError(
+        `${label}: file '${rel}' is ${bytes} bytes, over the ${MAX_OUTPUT_STYLE_BYTES}-byte limit`
+      );
+    }
+    style.source = body;
+    style.file = void 0;
+  }
+  return out;
+}
 function resolveUiEntry(manifest) {
   for (const runnable of manifest.runnables) {
     if (runnable.kind !== "companion") {
@@ -868,6 +1136,48 @@ async function bundleUiEntry(dir, uiEntry) {
   }
   return await output.text();
 }
+function emitAgentPlugin(dir) {
+  const manifestPath = resolveNativeManifestPath(dir);
+  if (!manifestPath) {
+    exitError(`manifest.json not found in: ${dir}`);
+  }
+  let manifest;
+  try {
+    manifest = JSON.parse((0, import_node_fs.readFileSync)(manifestPath, "utf8"));
+  } catch (err) {
+    exitError(`could not read ${manifestPath}: ${String(err)}`);
+  }
+  let plugin;
+  let mcp;
+  let notes;
+  try {
+    ({ plugin, mcp, notes } = toAgentPlugin(manifest));
+  } catch (err) {
+    exitError(`could not derive ${AGENT_PLUGIN_MANIFEST_FILE}: ${String(err)}`);
+  }
+  const pluginPath = (0, import_node_path.join)(dir, AGENT_PLUGIN_MANIFEST_FILE);
+  (0, import_node_fs.writeFileSync)(pluginPath, `${JSON.stringify(plugin, null, 2)}
+`, "utf8");
+  const mcpPath = (0, import_node_path.join)(dir, AGENT_PLUGIN_MCP_FILE);
+  if (mcp) {
+    (0, import_node_fs.writeFileSync)(mcpPath, `${JSON.stringify(mcp, null, 2)}
+`, "utf8");
+  } else if ((0, import_node_fs.existsSync)(mcpPath)) {
+    (0, import_node_fs.rmSync)(mcpPath);
+  }
+  const emitted = mcp ? `${AGENT_PLUGIN_MANIFEST_FILE} + ${AGENT_PLUGIN_MCP_FILE}` : AGENT_PLUGIN_MANIFEST_FILE;
+  process.stdout.write(`agent-plugin: ${emitted} \u2192 ${dir}
+`);
+  for (const note of notes) {
+    process.stdout.write(`agent-plugin: note: ${note}
+`);
+  }
+}
+function commandAgentPlugin(rawDir) {
+  const dir = (0, import_node_path.resolve)(rawDir);
+  loadManifest(dir);
+  emitAgentPlugin(dir);
+}
 async function commandPack(rawDir) {
   const dir = (0, import_node_path.resolve)(rawDir);
   const manifest = loadManifest(dir);
@@ -881,6 +1191,7 @@ async function commandPack(rawDir) {
   const outPath = (0, import_node_path.join)(outDir, "plugin.bundle.json");
   const bundle = uiCode ? { ...manifestWithHash, ui_code: uiCode } : manifestWithHash;
   (0, import_node_fs.writeFileSync)(outPath, JSON.stringify(bundle, null, 2), "utf8");
+  emitAgentPlugin(dir);
   const codeNote = uiCode ? ` (+${uiCode.length}B ui_code)` : "";
   process.stdout.write(
     `packed ${manifest.id}@${manifest.version}${codeNote} \u2192 ${outPath}
@@ -997,6 +1308,14 @@ if (command === "pack") {
   commandPublish(dir).catch((err) => {
     exitError(String(err));
   });
+} else if (command === "agent-plugin") {
+  const dir = args[0];
+  if (!dir) {
+    exitError(
+      "agent-plugin requires a directory argument: bunx ryu agent-plugin <dir>"
+    );
+  }
+  commandAgentPlugin(dir);
 } else if (command === "dev") {
   const entry = args[0];
   if (!entry) {