@meltstudio/meltctl 5.26.0 → 5.27.0

package/dist/index.js

@@ -7499,7 +7499,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/utils/version.ts"() {
     "use strict";
-    CLI_VERSION = "5.26.0";
+    CLI_VERSION = "5.27.0";
   }
 });
 
@@ -26933,6 +26933,43 @@ function createTemplatesResource(config2) {
   };
 }
 
+// ../sdk/dist/resources/skills.js
+function skillPath(plugin, skill) {
+  return `/skills/${encodeURIComponent(plugin)}/${encodeURIComponent(skill)}`;
+}
+function createSkillsResource(config2) {
+  return {
+    /** Every Melt skill (`melt-dev:plan`, …) with its frontmatter description. Auth-only. */
+    async list() {
+      const { data, status } = await apiFetch(config2, "/skills");
+      if (status !== 200)
+        throw new Error(data.error ?? `Failed to list skills (${status})`);
+      return data.skills;
+    },
+    /** One skill's instructions plus the list of its reference files. */
+    async get(plugin, skill, opts = {}) {
+      const query = opts.client ? `?client=${encodeURIComponent(opts.client)}` : "";
+      const { data, status } = await apiFetch(config2, `${skillPath(plugin, skill)}${query}`);
+      if (status === 404)
+        throw new Error(`Skill not found: ${plugin}:${skill}`);
+      if (status !== 200)
+        throw new Error(data.error ?? `Failed to fetch skill (${status})`);
+      return data;
+    },
+    /** One file from the skill's folder, by the path `get` lists (`references/x.md`). */
+    async getFile(plugin, skill, path10, opts = {}) {
+      const params = new URLSearchParams({ path: path10 });
+      if (opts.client)
+        params.set("client", opts.client);
+      const { data, status } = await apiFetch(config2, `${skillPath(plugin, skill)}/file?${params.toString()}`);
+      if (status !== 200) {
+        throw new Error(data.error ?? `Failed to fetch skill file (${status})`);
+      }
+      return data;
+    }
+  };
+}
+
 // ../sdk/dist/resources/auth.js
 function createAuthResource(config2) {
   return {
@@ -28138,6 +28175,7 @@ function createMeltClient(config2) {
     feedback: createFeedbackResource(config2),
     coins: createCoinsResource(config2),
     templates: createTemplatesResource(config2),
+    skills: createSkillsResource(config2),
     auth: createAuthResource(config2),
     people: createPeopleResource(config2),
     projects: createProjectsResource(config2),
@@ -54172,6 +54210,41 @@ function createTemplatesResource2(config2) {
     }
   };
 }
+function skillPath2(plugin, skill) {
+  return `/skills/${encodeURIComponent(plugin)}/${encodeURIComponent(skill)}`;
+}
+function createSkillsResource2(config2) {
+  return {
+    /** Every Melt skill (`melt-dev:plan`, …) with its frontmatter description. Auth-only. */
+    async list() {
+      const { data, status } = await apiFetch2(config2, "/skills");
+      if (status !== 200)
+        throw new Error(data.error ?? `Failed to list skills (${status})`);
+      return data.skills;
+    },
+    /** One skill's instructions plus the list of its reference files. */
+    async get(plugin, skill, opts = {}) {
+      const query = opts.client ? `?client=${encodeURIComponent(opts.client)}` : "";
+      const { data, status } = await apiFetch2(config2, `${skillPath2(plugin, skill)}${query}`);
+      if (status === 404)
+        throw new Error(`Skill not found: ${plugin}:${skill}`);
+      if (status !== 200)
+        throw new Error(data.error ?? `Failed to fetch skill (${status})`);
+      return data;
+    },
+    /** One file from the skill's folder, by the path `get` lists (`references/x.md`). */
+    async getFile(plugin, skill, path22, opts = {}) {
+      const params = new URLSearchParams({ path: path22 });
+      if (opts.client)
+        params.set("client", opts.client);
+      const { data, status } = await apiFetch2(config2, `${skillPath2(plugin, skill)}/file?${params.toString()}`);
+      if (status !== 200) {
+        throw new Error(data.error ?? `Failed to fetch skill file (${status})`);
+      }
+      return data;
+    }
+  };
+}
 function createAuthResource2(config2) {
   return {
     async exchangeToken(code, redirectUri) {
@@ -55346,6 +55419,7 @@ function createMeltClient2(config2) {
     feedback: createFeedbackResource2(config2),
     coins: createCoinsResource2(config2),
     templates: createTemplatesResource2(config2),
+    skills: createSkillsResource2(config2),
     auth: createAuthResource2(config2),
     people: createPeopleResource2(config2),
     projects: createProjectsResource2(config2),
@@ -56772,6 +56846,103 @@ function registerSupportEffortTools(server, getClient2) {
     withClientArgs(getClient2, getSupportEffort)
   );
 }
+var clientSchema = external_exports.enum(["claude", "cursor", "other"]).optional().describe(
+  'Which agent you are. Use "cursor" in Cursor; "other" (the default) for any agent without the Melt Claude plugins; "claude" only to get the file exactly as Claude Code would.'
+);
+var skillNameSchema = external_exports.string().min(1).describe(
+  'The skill, as "<plugin>:<skill>" (melt-company:verify-endpoint) or "<plugin>-<skill>" (melt-company-verify-endpoint). A leading "/" is ignored.'
+);
+var getSkillShape = { name: skillNameSchema, client: clientSchema };
+var getSkillInputSchema = external_exports.object(getSkillShape);
+var getSkillReferenceShape = {
+  name: skillNameSchema,
+  path: external_exports.string().min(1).describe(
+    'The file as the skill names it, relative to the skill folder, e.g. "references/standards.md" (as listed by get_skill).'
+  ),
+  client: clientSchema
+};
+var getSkillReferenceInputSchema = external_exports.object(getSkillReferenceShape);
+async function safeText(fn) {
+  try {
+    return { content: [{ type: "text", text: await fn() }] };
+  } catch (err) {
+    return fail(err instanceof Error ? err.message : String(err));
+  }
+}
+async function resolveSkillName(client, rawName) {
+  const name = rawName.trim().replace(/^\//, "");
+  const colon = name.indexOf(":");
+  if (colon > 0) return { plugin: name.slice(0, colon), skill: name.slice(colon + 1) };
+  const match = (await client.skills.list()).find((s) => `${s.plugin}-${s.skill}` === name);
+  if (!match) throw new Error(`Skill not found: ${rawName}. Call list_skills to see the names.`);
+  return { plugin: match.plugin, skill: match.skill };
+}
+async function listSkills(client) {
+  return safe(() => client.skills.list());
+}
+async function getSkill(client, input) {
+  return safeText(async () => {
+    const { plugin, skill } = await resolveSkillName(client, input.name);
+    const detail = await client.skills.get(plugin, skill, { client: input.client ?? "other" });
+    const references = detail.references.length ? detail.references.map((path22) => `- ${path22}`).join("\n") : "(none)";
+    return [
+      `# Melt skill: ${detail.name}`,
+      "",
+      `Follow the instructions below as if you were running the ${detail.name} skill. When they say to read a file (for example references/standards.md), fetch it with get_skill_reference (name: "${detail.name}", path: the file).`,
+      "",
+      `Files in this skill:
+${references}`,
+      "",
+      "---",
+      "",
+      detail.body
+    ].join("\n");
+  });
+}
+async function getSkillReference(client, input) {
+  return safeText(async () => {
+    const { plugin, skill } = await resolveSkillName(client, input.name);
+    const file2 = await client.skills.getFile(plugin, skill, input.path, {
+      client: input.client ?? "other"
+    });
+    return file2.content;
+  });
+}
+function registerSkillTools(server, getClient2) {
+  server.registerTool(
+    "list_skills",
+    {
+      title: "List Melt skills",
+      description: "Lists Melt Studio's skills (the dev pipeline and audits, the PM suite, company checks like the endpoint check) with what each does. Use it when the user asks for a Melt skill you don't have installed, then load the one that fits with get_skill.",
+      inputSchema: {}
+    },
+    withClient(getClient2, listSkills)
+  );
+  server.registerTool(
+    "get_skill",
+    {
+      title: "Load a Melt skill",
+      description: `Loads a Melt skill's full instructions. Treat what it returns as the skill itself: follow the instructions exactly, step by step, as if the skill were installed. When they say to read a file ("read references/x.md"), fetch it with get_skill_reference instead of looking on disk. Pass client: "cursor" when running in Cursor.`,
+      inputSchema: getSkillShape
+    },
+    withClientArgs(
+      getClient2,
+      (client, args) => getSkill(client, args)
+    )
+  );
+  server.registerTool(
+    "get_skill_reference",
+    {
+      title: "Read a file from a Melt skill",
+      description: `Returns one of a Melt skill's reference files (a checklist, template or standards doc) as markdown. Use it whenever a skill loaded with get_skill says to read a file like "references/standards.md"; the files are not on disk. Follow its contents as part of the skill.`,
+      inputSchema: getSkillReferenceShape
+    },
+    withClientArgs(
+      getClient2,
+      (client, args) => getSkillReference(client, args)
+    )
+  );
+}
 var VERSION = "0.0.0";
 function createMcpServer(clientOrProvider) {
   const getClient2 = typeof clientOrProvider === "function" ? clientOrProvider : () => Promise.resolve(clientOrProvider);
@@ -56791,6 +56962,7 @@ function createMcpServer(clientOrProvider) {
   registerDailyPlanTools(server, getClient2);
   registerEndpointCheckTools(server, getClient2);
   registerSupportEffortTools(server, getClient2);
+  registerSkillTools(server, getClient2);
   return server;
 }
 async function startServer() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "5.26.0",
+  "version": "5.27.0",
   "description": "AI-first development tooling for Melt teams — companion CLI for the org-distributed Claude Code dev skills",
   "main": "dist/index.js",
   "type": "module",