@hasna/skills 0.10.68 → 0.10.69

package/bin/index.js

@@ -36888,7 +36888,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.10.68",
+    version: "0.10.69",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -36954,6 +36954,7 @@ var init_package = __esm(() => {
       "verify:release": "bun run scripts/release-guard.ts",
       "verify:release-review": "bun run scripts/verify-release-review.ts",
       "verify:consumer-types": "bun run scripts/consumer-types.ts",
+      "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
       prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
       prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
       "verify:producer": "bun run scripts/release-dependencies.ts",
@@ -113534,23 +113535,120 @@ var init_remote_customer_tools = __esm(() => {
   init_remote_files();
 });
 
+// src/mcp/package-tool-list.ts
+function servePackageZodToolList(server) {
+  const tools = new Map;
+  let installed = false;
+  const track = (name, tool, input2, output2) => {
+    tools.set(name, { tool, input: input2, output: output2 });
+    const update2 = tool.update.bind(tool);
+    tool.update = (updates) => {
+      update2(updates);
+      const entry = tools.get(name);
+      if (!entry)
+        return;
+      if (updates.paramsSchema !== undefined)
+        entry.input = updates.paramsSchema;
+      if (updates.outputSchema !== undefined)
+        entry.output = updates.outputSchema;
+      if (updates.name !== undefined && updates.name !== name) {
+        tools.delete(name);
+        if (updates.name) {
+          name = updates.name;
+          tools.set(name, entry);
+        }
+      }
+    };
+    if (!installed) {
+      installed = true;
+      server.server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: listTools(tools) }));
+    }
+  };
+  const registerTool = server.registerTool.bind(server);
+  server.registerTool = (name, config2, cb) => {
+    const tool = registerTool(name, config2, cb);
+    track(name, tool, config2.inputSchema, config2.outputSchema);
+    return tool;
+  };
+  const legacyTool = server.tool.bind(server);
+  server.tool = (name, ...rest2) => {
+    const tool = legacyTool(name, ...rest2);
+    track(name, tool, legacyInputSchema(rest2), undefined);
+    return tool;
+  };
+}
+function listTools(tools) {
+  return [...tools].filter(([, entry]) => entry.tool.enabled).map(([name, { tool, input: input2, output: output2 }]) => {
+    const definition = {
+      name,
+      title: tool.title,
+      description: tool.description,
+      inputSchema: jsonSchema(input2, "input") ?? EMPTY_OBJECT_JSON_SCHEMA2,
+      annotations: tool.annotations,
+      execution: tool.execution,
+      _meta: tool._meta
+    };
+    const outputSchema = jsonSchema(output2, "output");
+    if (outputSchema)
+      definition.outputSchema = outputSchema;
+    return definition;
+  });
+}
+function isZodTypeLike2(value) {
+  return typeof value === "object" && value !== null && typeof value.parse === "function" && typeof value.safeParse === "function";
+}
+function isRawShape(value) {
+  if (typeof value !== "object" || value === null || "_def" in value || "_zod" in value || isZodTypeLike2(value))
+    return false;
+  const values2 = Object.values(value);
+  return values2.length === 0 || values2.some(isZodTypeLike2);
+}
+function legacyInputSchema(rest2) {
+  const args = [...rest2];
+  if (typeof args[0] === "string")
+    args.shift();
+  return args.length > 1 && isRawShape(args[0]) ? args[0] : undefined;
+}
+function jsonSchema(schema, io) {
+  if (schema === undefined || schema === null)
+    return;
+  const object10 = isRawShape(schema) ? exports_external.object(schema) : schema;
+  const def = object10._zod?.def;
+  if (!def)
+    throw new Error("Skills MCP tool schemas must be built with this package's zod 4");
+  if (def.type !== "object" && def.shape === undefined)
+    return;
+  return exports_external.toJSONSchema(object10, { target: "draft-7", io });
+}
+var EMPTY_OBJECT_JSON_SCHEMA2;
+var init_package_tool_list = __esm(() => {
+  init_types2();
+  init_zod();
+  EMPTY_OBJECT_JSON_SCHEMA2 = { type: "object", properties: {} };
+});
+
 // src/mcp/server.ts
 var exports_server = {};
 __export(exports_server, {
   server: () => server,
+  registerSkillsTools: () => registerSkillsTools,
   buildServer: () => buildServer
 });
-function buildServer() {
-  const server = new McpServer({
-    name: "skills",
-    version: package_default.version
-  });
+function registerSkillsTools(server) {
   registerDiscoveryTools(server);
   registerOperationTools(server);
   registerScheduleTools(server);
   registerStorageTools(server);
   registerResourceMetaTools(server);
   registerRemoteCustomerTools(server);
+}
+function buildServer() {
+  const server = new McpServer({
+    name: "skills",
+    version: package_default.version
+  });
+  servePackageZodToolList(server);
+  registerSkillsTools(server);
   return server;
 }
 var server;
@@ -113563,6 +113661,7 @@ var init_server3 = __esm(() => {
   init_schedule_tools();
   init_storage_tools();
   init_remote_customer_tools();
+  init_package_tool_list();
   server = buildServer();
 });
 

package/bin/mcp.js

@@ -23,7 +23,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.10.68",
+    version: "0.10.69",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -89,6 +89,7 @@ var init_package = __esm(() => {
       "verify:release": "bun run scripts/release-guard.ts",
       "verify:release-review": "bun run scripts/verify-release-review.ts",
       "verify:consumer-types": "bun run scripts/consumer-types.ts",
+      "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
       prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
       prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
       "verify:producer": "bun run scripts/release-dependencies.ts",
@@ -47922,24 +47923,121 @@ var init_remote_customer_tools = __esm(() => {
   init_remote_files();
 });
 
+// src/mcp/package-tool-list.ts
+import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+function servePackageZodToolList(server) {
+  const tools = new Map;
+  let installed = false;
+  const track = (name, tool, input2, output2) => {
+    tools.set(name, { tool, input: input2, output: output2 });
+    const update = tool.update.bind(tool);
+    tool.update = (updates) => {
+      update(updates);
+      const entry = tools.get(name);
+      if (!entry)
+        return;
+      if (updates.paramsSchema !== undefined)
+        entry.input = updates.paramsSchema;
+      if (updates.outputSchema !== undefined)
+        entry.output = updates.outputSchema;
+      if (updates.name !== undefined && updates.name !== name) {
+        tools.delete(name);
+        if (updates.name) {
+          name = updates.name;
+          tools.set(name, entry);
+        }
+      }
+    };
+    if (!installed) {
+      installed = true;
+      server.server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: listTools(tools) }));
+    }
+  };
+  const registerTool = server.registerTool.bind(server);
+  server.registerTool = (name, config2, cb) => {
+    const tool = registerTool(name, config2, cb);
+    track(name, tool, config2.inputSchema, config2.outputSchema);
+    return tool;
+  };
+  const legacyTool = server.tool.bind(server);
+  server.tool = (name, ...rest) => {
+    const tool = legacyTool(name, ...rest);
+    track(name, tool, legacyInputSchema(rest), undefined);
+    return tool;
+  };
+}
+function listTools(tools) {
+  return [...tools].filter(([, entry]) => entry.tool.enabled).map(([name, { tool, input: input2, output: output2 }]) => {
+    const definition = {
+      name,
+      title: tool.title,
+      description: tool.description,
+      inputSchema: jsonSchema(input2, "input") ?? EMPTY_OBJECT_JSON_SCHEMA,
+      annotations: tool.annotations,
+      execution: tool.execution,
+      _meta: tool._meta
+    };
+    const outputSchema = jsonSchema(output2, "output");
+    if (outputSchema)
+      definition.outputSchema = outputSchema;
+    return definition;
+  });
+}
+function isZodTypeLike(value) {
+  return typeof value === "object" && value !== null && typeof value.parse === "function" && typeof value.safeParse === "function";
+}
+function isRawShape(value) {
+  if (typeof value !== "object" || value === null || "_def" in value || "_zod" in value || isZodTypeLike(value))
+    return false;
+  const values = Object.values(value);
+  return values.length === 0 || values.some(isZodTypeLike);
+}
+function legacyInputSchema(rest) {
+  const args = [...rest];
+  if (typeof args[0] === "string")
+    args.shift();
+  return args.length > 1 && isRawShape(args[0]) ? args[0] : undefined;
+}
+function jsonSchema(schema, io) {
+  if (schema === undefined || schema === null)
+    return;
+  const object7 = isRawShape(schema) ? exports_external.object(schema) : schema;
+  const def = object7._zod?.def;
+  if (!def)
+    throw new Error("Skills MCP tool schemas must be built with this package's zod 4");
+  if (def.type !== "object" && def.shape === undefined)
+    return;
+  return exports_external.toJSONSchema(object7, { target: "draft-7", io });
+}
+var EMPTY_OBJECT_JSON_SCHEMA;
+var init_package_tool_list = __esm(() => {
+  init_zod();
+  EMPTY_OBJECT_JSON_SCHEMA = { type: "object", properties: {} };
+});
+
 // src/mcp/server.ts
 var exports_server = {};
 __export(exports_server, {
   server: () => server,
+  registerSkillsTools: () => registerSkillsTools,
   buildServer: () => buildServer
 });
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
-function buildServer() {
-  const server = new McpServer2({
-    name: "skills",
-    version: package_default.version
-  });
+function registerSkillsTools(server) {
   registerDiscoveryTools(server);
   registerOperationTools(server);
   registerScheduleTools(server);
   registerStorageTools(server);
   registerResourceMetaTools(server);
   registerRemoteCustomerTools(server);
+}
+function buildServer() {
+  const server = new McpServer2({
+    name: "skills",
+    version: package_default.version
+  });
+  servePackageZodToolList(server);
+  registerSkillsTools(server);
   return server;
 }
 var server;
@@ -47951,6 +48049,7 @@ var init_server = __esm(() => {
   init_schedule_tools();
   init_storage_tools();
   init_remote_customer_tools();
+  init_package_tool_list();
   server = buildServer();
 });
 
@@ -47985,7 +48084,8 @@ var init_invitation_recovery_target = __esm(() => {
 // src/mcp/invitation-recovery.ts
 var exports_invitation_recovery = {};
 __export(exports_invitation_recovery, {
-  startInvitationRecoveryMcp: () => startInvitationRecoveryMcp
+  startInvitationRecoveryMcp: () => startInvitationRecoveryMcp,
+  registerInvitationRecoveryTools: () => registerInvitationRecoveryTools
 });
 import { McpServer as McpServer3 } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -47994,9 +48094,14 @@ async function startInvitationRecoveryMcp(args, env = process.env) {
     throw new Error("Use only --invitation-recovery --stdio with an explicit Skills API URL.");
   const target = prepareInvitationRecoveryTarget(env);
   const server2 = new McpServer3({ name: "skills-invitation-recovery", version: package_default.version });
+  servePackageZodToolList(server2);
+  registerInvitationRecoveryTools(server2, new RemoteSkillsAuthClient(target.origin), target);
+  target.unchanged();
+  await server2.connect(new StdioServerTransport);
+}
+function registerInvitationRecoveryTools(server2, client, target) {
   const uuid9 = exports_external.string().regex(/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/);
   const proof = { invitationId: uuid9, challengeId: uuid9, token: exports_external.string().regex(/^[A-Za-z0-9_-]{43}$/).describe("Invitation secret, only in this request; never logged or persisted."), confirm: exports_external.literal(true) };
-  const client = new RemoteSkillsAuthClient(target.origin);
   server2.registerTool("request_invitation_email_challenge", {
     title: "Request Invitation Recovery Code",
     description: "Existing accounts without usable memberships only. Retain the caller challenge UUID before this single request. The response does not confirm eligibility or email delivery. No automatic retry or credential writes.",
@@ -48025,8 +48130,6 @@ async function startInvitationRecoveryMcp(args, env = process.env) {
       return mcpError(result.code, result.error);
     }
   });
-  target.unchanged();
-  await server2.connect(new StdioServerTransport);
 }
 var init_invitation_recovery = __esm(() => {
   init_zod();
@@ -48036,6 +48139,7 @@ var init_invitation_recovery = __esm(() => {
   init_remote_auth();
   init_remote_invitation_recovery();
   init_helpers();
+  init_package_tool_list();
 });
 
 // src/mcp/http.ts

package/bin/migrate.js

@@ -25,7 +25,7 @@ import { join as join5 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.68",
+  version: "0.10.69",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -91,6 +91,7 @@ var package_default = {
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",

package/bin/server.js

@@ -24140,7 +24140,7 @@ restoreLaunchCwd();
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.68",
+  version: "0.10.69",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -24206,6 +24206,7 @@ var package_default = {
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",

package/bin/worker.js

@@ -24143,7 +24143,7 @@ import { randomUUID as randomUUID6 } from "crypto";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.68",
+  version: "0.10.69",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -24209,6 +24209,7 @@ var package_default = {
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",

package/dist/index.js

@@ -11923,7 +11923,7 @@ function replaceSkillSession(expected, replacement, plan, options = {}, beforeCo
   });
 }
 // package.json
-var version = "0.10.68";
+var version = "0.10.69";
 var package_default = {
   name: "@hasna/skills",
   version,
@@ -11992,6 +11992,7 @@ var package_default = {
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",

package/dist/mcp/invitation-recovery.d.ts

@@ -1,2 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RemoteSkillsAuthClient } from "../lib/remote-auth.js";
 /** Dedicated anonymous proof surface. Ordinary tools and credential resolution are not initialized. */
 export declare function startInvitationRecoveryMcp(args: string[], env?: Record<string, string | undefined>): Promise<void>;
+/** Register the two anonymous invitation recovery tools on `server`. */
+export declare function registerInvitationRecoveryTools(server: McpServer, client: RemoteSkillsAuthClient, target: {
+    unchanged(): void;
+}): void;

package/dist/mcp/package-tool-list.d.ts

@@ -0,0 +1,19 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Serve tools/list with JSON Schema converted by this package's own zod.
+ *
+ * bin/mcp.js bundles zod but loads the MCP SDK from the consumer's
+ * node_modules, and the SDK may resolve a different zod. The SDK's own
+ * tools/list converts each input schema with its zod; when that zod is older
+ * than the one that built the schema it fails (`ctx.deferred.push`) or
+ * advertises degraded schemas. This records the schemas each tool is
+ * registered with and converts them exactly as the SDK does (draft-7, `io`
+ * input/output, raw shapes as objects), but with the zod that built them.
+ * Argument validation for tools/call stays with the SDK.
+ *
+ * Call it right after constructing the server and before registering tools.
+ * Both `registerTool` and the positional `tool()` form are covered.
+ */
+export declare function servePackageZodToolList(server: McpServer): void;
+/** The input schema the SDK's positional `tool()` form takes from its arguments. */
+export declare function legacyInputSchema(rest: readonly unknown[]): unknown;

package/dist/mcp/server.d.ts

@@ -1,4 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register every Skills tool and resource on `server`. */
+export declare function registerSkillsTools(server: McpServer): void;
 export declare function buildServer(): McpServer;
 /** @deprecated Use buildServer() — kept for internal imports during migration */
 export declare const server: McpServer;

package/dist/runtime-prerequisites.js

@@ -49,7 +49,7 @@ var __require = import.meta.require;
 // src/runtime-prerequisites.ts
 import { isAbsolute as isAbsolute5 } from "path";
 // package.json
-var version = "0.10.68";
+var version = "0.10.69";
 var package_default = {
   name: "@hasna/skills",
   version,
@@ -118,6 +118,7 @@ var package_default = {
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",

package/dist/sdk/index.js

@@ -32371,7 +32371,7 @@ var init_event_sink = __esm(() => {
   init_dist();
 });
 // package.json
-var version = "0.10.68";
+var version = "0.10.69";
 var package_default = {
   name: "@hasna/skills",
   version,
@@ -32440,6 +32440,7 @@ var package_default = {
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     prepack: "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     prepublishOnly: "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.10.68",
+  "version": "0.10.69",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
@@ -66,6 +66,7 @@
     "verify:release": "bun run scripts/release-guard.ts",
     "verify:release-review": "bun run scripts/verify-release-review.ts",
     "verify:consumer-types": "bun run scripts/consumer-types.ts",
+    "verify:consumer-mcp": "bun run scripts/consumer-mcp.ts",
     "prepack": "bun run verify:generated && bun run verify:release && bun run verify:consumer-types",
     "prepublishOnly": "bun run verify:producer && bun run typecheck && bun run test",
     "verify:producer": "bun run scripts/release-dependencies.ts",