@ghostpaw/questlog 0.9.1 → 0.9.2

package/dist/index.js

@@ -3181,8 +3181,153 @@ function translateToolError(error, options = {}) {
   );
 }
 
+// src/surfaces/schema_actions.ts
+var requirements = /* @__PURE__ */ new WeakMap();
+function registerSchemaActions(schema, actions) {
+  requirements.set(schema, actions);
+}
+function requiredForAction(schema, action) {
+  return requirements.get(schema)?.[String(action)] ?? [];
+}
+
+// src/surfaces/schema_examples.ts
+function minimalInput(schema, action, name = "") {
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0) return constant;
+  if (schema.enum)
+    return action !== void 0 && schema.enum.includes(action) ? action : schema.enum[0];
+  const branch = schema.oneOf?.[0];
+  if (schema.type === "object" || schema.properties) {
+    action ??= schema.properties?.action?.enum?.[0];
+    const properties = { ...schema.properties, ...branch?.properties };
+    return Object.fromEntries(
+      [
+        .../* @__PURE__ */ new Set([
+          ...schema.required ?? [],
+          ...requiredForAction(schema, action),
+          ...schema.properties?.outcome && ["finish", "abandon", "abandon_and_spawn_followups"].includes(String(action)) ? ["outcome"] : [],
+          ...branch?.required ?? []
+        ])
+      ].map((key) => [
+        key,
+        minimalInput(properties[key] ?? {}, key === "action" ? action : void 0, key)
+      ])
+    );
+  }
+  if (branch) return minimalInput(branch, action, name);
+  if (schema.type === "array") return [minimalInput(schema.items ?? {}, void 0, name)];
+  if (schema.type === "integer" || schema.type === "number")
+    return name === "anchorAt" ? 18e11 : name === "toQuestId" ? 2 : 1;
+  if (schema.type === "boolean") return false;
+  if (schema.type === "null") return null;
+  if (name === "rrule") return "FREQ=WEEKLY";
+  if (name === "title") return "Review release notes";
+  if (name === "objective") return "Check changes against the release";
+  return "release";
+}
+
+// src/surfaces/validate_input.ts
+function validateInput(schema, input, path = "$") {
+  const errors = [];
+  const matchesType = (type) => {
+    switch (type) {
+      case "object":
+        return typeof input === "object" && input !== null && !Array.isArray(input);
+      case "array":
+        return Array.isArray(input);
+      case "integer":
+        return typeof input === "number" && Number.isInteger(input);
+      case "number":
+        return typeof input === "number" && Number.isFinite(input);
+      case "null":
+        return input === null;
+      default:
+        return typeof input === type;
+    }
+  };
+  if (schema.type && !(Array.isArray(schema.type) ? schema.type : [schema.type]).some(matchesType)) {
+    return [`${path}: expected ${String(schema.type)}`];
+  }
+  if (schema.enum && !schema.enum.some((value) => JSON.stringify(value) === JSON.stringify(input)))
+    errors.push(`${path}: expected one of ${JSON.stringify(schema.enum)}`);
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0 && constant !== input)
+    errors.push(`${path}: expected ${JSON.stringify(constant)}`);
+  if (schema.oneOf) {
+    const branches = schema.oneOf.map((branch) => validateInput(branch, input, path));
+    if (!branches.some((errors2) => errors2.length === 0)) {
+      errors.push(
+        ...branches.sort((a, b) => a.length - b.length)[0] ?? [
+          `${path}: must match at least one schema branch`
+        ]
+      );
+    }
+  }
+  if (typeof input === "object" && input !== null && !Array.isArray(input)) {
+    const record = input;
+    for (const name of [...schema.required ?? [], ...requiredForAction(schema, record.action)])
+      if (!Object.hasOwn(record, name)) errors.push(`${path}.${name}: required`);
+    for (const [name, property] of Object.entries(schema.properties ?? {}))
+      if (Object.hasOwn(record, name))
+        errors.push(...validateInput(property, record[name], `${path}.${name}`));
+  }
+  if (Array.isArray(input) && schema.items)
+    input.forEach((value, index) => {
+      errors.push(...validateInput(schema.items, value, `${path}[${index}]`));
+    });
+  return errors;
+}
+
+// src/tools/action_requirements.ts
+var actionRequirements = {
+  shape_work: {
+    create_quest: ["quest"],
+    create_questline: ["questline"],
+    attach_quest_to_questline: ["questId", "questlineId"],
+    detach_quest_from_questline: ["questId"],
+    dismiss_rumor: ["rumorId"],
+    reopen_rumor: ["rumorId"],
+    settle_rumor: ["rumorId"],
+    update_rumor: ["rumorId"]
+  },
+  manage_repeatable: {
+    create: ["repeatableQuest"],
+    archive: ["repeatableQuestId"],
+    update: ["repeatableQuestId"],
+    spawn_due: ["now"]
+  },
+  organize_work: {
+    add_unlock: ["fromQuestId", "toQuestId"],
+    remove_unlock: ["fromQuestId", "toQuestId"],
+    replace_unlocks: ["fromQuestIds", "toQuestId"],
+    archive_questline: ["questlineId"],
+    set_questline_fields: ["questlineId"]
+  },
+  plan_quest: { revise_objective: ["objective"] },
+  run_quest: {
+    abandon_and_spawn_followups: ["followups"],
+    log_effort: ["effortSeconds"]
+  },
+  reward_work: { add: ["reward"], update: ["reward"], replace_repeatable_template: ["rewards"] }
+};
+
 // src/tools/tool_metadata.ts
 function defineQuestlogTool(definition) {
+  const requirements2 = actionRequirements[definition.name];
+  if (requirements2) registerSchemaActions(definition.inputSchema, requirements2);
+  const handler = definition.handler;
+  definition.handler = (db, input) => {
+    const errors = validateInput(definition.inputSchema, input);
+    if (errors.length) {
+      const action = input?.action;
+      const example = minimalInput(definition.inputSchema, action);
+      const message = errors.join("; ");
+      return toolFailure("protocol", "invalid_input", message, message, {
+        recovery: `${message}; pass ${JSON.stringify(example)}`
+      });
+    }
+    return handler(db, input);
+  };
   return definition;
 }
 function stringSchema(description, options = {}) {
@@ -4725,7 +4870,7 @@ var rewardWorkTool = defineQuestlogTool({
           name: stringSchema("Reward name."),
           now: integerSchema("Optional update timestamp for the update action.")
         },
-        []
+        ["kind", "name"]
       ),
       rewards: arraySchema(
         objectSchema(
@@ -5391,7 +5536,7 @@ var shapeWorkTool = defineQuestlogTool({
           title: stringSchema("Questline title."),
           description: stringSchema("Optional questline description.")
         },
-        []
+        ["title"]
       ),
       rumorId: integerSchema("Rumor to settle, dismiss, or reopen."),
       dismissedAt: integerSchema("Optional dismissal timestamp."),

package/dist/mcp-server.js

@@ -5,14 +5,74 @@ import { homedir } from 'node:os';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/surfaces/schema_actions.ts
+function registerSchemaActions(schema, actions) {
+  requirements.set(schema, actions);
+}
+function requiredForAction(schema, action) {
+  return requirements.get(schema)?.[String(action)] ?? [];
+}
+var requirements;
+var init_schema_actions = __esm({
+  "src/surfaces/schema_actions.ts"() {
+    requirements = /* @__PURE__ */ new WeakMap();
+  }
+});
+
+// src/surfaces/schema_examples.ts
+function minimalInput(schema, action, name = "") {
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0) return constant;
+  if (schema.enum)
+    return action !== void 0 && schema.enum.includes(action) ? action : schema.enum[0];
+  const branch = schema.oneOf?.[0];
+  if (schema.type === "object" || schema.properties) {
+    action ??= schema.properties?.action?.enum?.[0];
+    const properties = { ...schema.properties, ...branch?.properties };
+    return Object.fromEntries(
+      [
+        .../* @__PURE__ */ new Set([
+          ...schema.required ?? [],
+          ...requiredForAction(schema, action),
+          ...schema.properties?.outcome && ["finish", "abandon", "abandon_and_spawn_followups"].includes(String(action)) ? ["outcome"] : [],
+          ...branch?.required ?? []
+        ])
+      ].map((key) => [
+        key,
+        minimalInput(properties[key] ?? {}, key === "action" ? action : void 0, key)
+      ])
+    );
+  }
+  if (branch) return minimalInput(branch, action, name);
+  if (schema.type === "array") return [minimalInput(schema.items ?? {}, void 0, name)];
+  if (schema.type === "integer" || schema.type === "number")
+    return name === "anchorAt" ? 18e11 : name === "toQuestId" ? 2 : 1;
+  if (schema.type === "boolean") return false;
+  if (schema.type === "null") return null;
+  if (name === "rrule") return "FREQ=WEEKLY";
+  if (name === "title") return "Review release notes";
+  if (name === "objective") return "Check changes against the release";
+  return "release";
+}
+var init_schema_examples = __esm({
+  "src/surfaces/schema_examples.ts"() {
+    init_schema_actions();
+  }
+});
+
 // src/surfaces/surface_types.ts
 function isErrorResult(result) {
   return typeof result === "object" && result !== null && "ok" in result && result.ok === false;
@@ -46,11 +106,22 @@ function validateInput(schema, input, path = "$") {
   }
   if (schema.enum && !schema.enum.some((value) => JSON.stringify(value) === JSON.stringify(input)))
     errors.push(`${path}: expected one of ${JSON.stringify(schema.enum)}`);
-  if (schema.oneOf && !schema.oneOf.some((branch) => validateInput(branch, input, path).length === 0))
-    errors.push(`${path}: must match at least one schema branch`);
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0 && constant !== input)
+    errors.push(`${path}: expected ${JSON.stringify(constant)}`);
+  if (schema.oneOf) {
+    const branches = schema.oneOf.map((branch) => validateInput(branch, input, path));
+    if (!branches.some((errors2) => errors2.length === 0)) {
+      errors.push(
+        ...branches.sort((a, b) => a.length - b.length)[0] ?? [
+          `${path}: must match at least one schema branch`
+        ]
+      );
+    }
+  }
   if (typeof input === "object" && input !== null && !Array.isArray(input)) {
     const record = input;
-    for (const name of schema.required ?? [])
+    for (const name of [...schema.required ?? [], ...requiredForAction(schema, record.action)])
       if (!Object.hasOwn(record, name)) errors.push(`${path}.${name}: required`);
     for (const [name, property] of Object.entries(schema.properties ?? {}))
       if (Object.hasOwn(record, name))
@@ -64,6 +135,7 @@ function validateInput(schema, input, path = "$") {
 }
 var init_validate_input = __esm({
   "src/surfaces/validate_input.ts"() {
+    init_schema_actions();
   }
 });
 
@@ -158,7 +230,15 @@ Not for: ${tool.whenNotToUse}` : ""),
         const input = params.arguments === void 0 ? {} : params.arguments;
         const errors = validateInput(tool.inputSchema, input);
         if (errors.length)
-          return result({ content: [{ type: "text", text: errors.join("\n") }], isError: true });
+          return result({
+            content: [
+              {
+                type: "text",
+                text: `${errors.join("\n")}; pass ${JSON.stringify(minimalInput(tool.inputSchema, input?.action))}`
+              }
+            ],
+            isError: true
+          });
         try {
           context ??= Promise.resolve().then(options.context);
           const value = await tool.handler(await context, input);
@@ -197,6 +277,7 @@ Not for: ${tool.whenNotToUse}` : ""),
 var MCP_LATEST_PROTOCOL_VERSION, MCP_SUPPORTED_PROTOCOL_VERSIONS;
 var init_mcp_server = __esm({
   "src/surfaces/mcp_server.ts"() {
+    init_schema_examples();
     init_surface_types();
     init_validate_input();
     MCP_LATEST_PROTOCOL_VERSION = "2026-07-28";
@@ -677,7 +758,7 @@ var init_open_questlog_db = __esm({
 var questlogVersion;
 var init_version = __esm({
   "src/version.ts"() {
-    questlogVersion = "0.9.1";
+    questlogVersion = "0.9.2";
   }
 });
 
@@ -979,8 +1060,61 @@ var init_tool_errors = __esm({
   }
 });
 
+// src/tools/action_requirements.ts
+var actionRequirements;
+var init_action_requirements = __esm({
+  "src/tools/action_requirements.ts"() {
+    actionRequirements = {
+      shape_work: {
+        create_quest: ["quest"],
+        create_questline: ["questline"],
+        attach_quest_to_questline: ["questId", "questlineId"],
+        detach_quest_from_questline: ["questId"],
+        dismiss_rumor: ["rumorId"],
+        reopen_rumor: ["rumorId"],
+        settle_rumor: ["rumorId"],
+        update_rumor: ["rumorId"]
+      },
+      manage_repeatable: {
+        create: ["repeatableQuest"],
+        archive: ["repeatableQuestId"],
+        update: ["repeatableQuestId"],
+        spawn_due: ["now"]
+      },
+      organize_work: {
+        add_unlock: ["fromQuestId", "toQuestId"],
+        remove_unlock: ["fromQuestId", "toQuestId"],
+        replace_unlocks: ["fromQuestIds", "toQuestId"],
+        archive_questline: ["questlineId"],
+        set_questline_fields: ["questlineId"]
+      },
+      plan_quest: { revise_objective: ["objective"] },
+      run_quest: {
+        abandon_and_spawn_followups: ["followups"],
+        log_effort: ["effortSeconds"]
+      },
+      reward_work: { add: ["reward"], update: ["reward"], replace_repeatable_template: ["rewards"] }
+    };
+  }
+});
+
 // src/tools/tool_metadata.ts
 function defineQuestlogTool(definition) {
+  const requirements2 = actionRequirements[definition.name];
+  if (requirements2) registerSchemaActions(definition.inputSchema, requirements2);
+  const handler = definition.handler;
+  definition.handler = (db, input) => {
+    const errors = validateInput(definition.inputSchema, input);
+    if (errors.length) {
+      const action = input?.action;
+      const example = minimalInput(definition.inputSchema, action);
+      const message = errors.join("; ");
+      return toolFailure("protocol", "invalid_input", message, message, {
+        recovery: `${message}; pass ${JSON.stringify(example)}`
+      });
+    }
+    return handler(db, input);
+  };
   return definition;
 }
 function stringSchema(description, options = {}) {
@@ -1023,6 +1157,11 @@ function objectSchema(properties, required, description) {
 }
 var init_tool_metadata = __esm({
   "src/tools/tool_metadata.ts"() {
+    init_schema_actions();
+    init_schema_examples();
+    init_validate_input();
+    init_action_requirements();
+    init_tool_types();
   }
 });
 
@@ -4599,7 +4738,7 @@ var init_reward_work_tool = __esm({
               name: stringSchema("Reward name."),
               now: integerSchema("Optional update timestamp for the update action.")
             },
-            []
+            ["kind", "name"]
           ),
           rewards: arraySchema(
             objectSchema(
@@ -5513,7 +5652,7 @@ var init_shape_work_tool = __esm({
               title: stringSchema("Questline title."),
               description: stringSchema("Optional questline description.")
             },
-            []
+            ["title"]
           ),
           rumorId: integerSchema("Rumor to settle, dismiss, or reopen."),
           dismissedAt: integerSchema("Optional dismissal timestamp."),
@@ -5867,7 +6006,7 @@ var init_questlog_surface_tools = __esm({
         whenNotToUse: tool.whenNotToUse ?? "",
         readOnly: tool.readOnly,
         sideEffects: tool.sideEffects,
-        inputSchema: { ...tool.inputSchema, type: "object" },
+        inputSchema: tool.inputSchema,
         handler: tool.handler
       })
     );

package/dist/mcp.cjs

@@ -386,7 +386,7 @@ async function openQuestlogDb(path) {
 }
 
 // src/version.ts
-var questlogVersion = "0.9.1";
+var questlogVersion = "0.9.2";
 
 // src/surface/questlog_mcp_instructions.ts
 var questlogMcpInstructions = "Questlog manages local tasks, calendar commitments, and recurring work. Search before creating work, inspect before changing it, and keep uncertain work as rumors. Use unlock prerequisites to sequence work. run_quest refuses blocked starts unless force is true. Review commitments and resolve work with an honest outcome.";
@@ -632,8 +632,153 @@ function translateToolError(error, options = {}) {
   );
 }
 
+// src/surfaces/schema_actions.ts
+var requirements = /* @__PURE__ */ new WeakMap();
+function registerSchemaActions(schema, actions) {
+  requirements.set(schema, actions);
+}
+function requiredForAction(schema, action) {
+  return requirements.get(schema)?.[String(action)] ?? [];
+}
+
+// src/surfaces/schema_examples.ts
+function minimalInput(schema, action, name = "") {
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0) return constant;
+  if (schema.enum)
+    return action !== void 0 && schema.enum.includes(action) ? action : schema.enum[0];
+  const branch = schema.oneOf?.[0];
+  if (schema.type === "object" || schema.properties) {
+    action ??= schema.properties?.action?.enum?.[0];
+    const properties = { ...schema.properties, ...branch?.properties };
+    return Object.fromEntries(
+      [
+        .../* @__PURE__ */ new Set([
+          ...schema.required ?? [],
+          ...requiredForAction(schema, action),
+          ...schema.properties?.outcome && ["finish", "abandon", "abandon_and_spawn_followups"].includes(String(action)) ? ["outcome"] : [],
+          ...branch?.required ?? []
+        ])
+      ].map((key) => [
+        key,
+        minimalInput(properties[key] ?? {}, key === "action" ? action : void 0, key)
+      ])
+    );
+  }
+  if (branch) return minimalInput(branch, action, name);
+  if (schema.type === "array") return [minimalInput(schema.items ?? {}, void 0, name)];
+  if (schema.type === "integer" || schema.type === "number")
+    return name === "anchorAt" ? 18e11 : name === "toQuestId" ? 2 : 1;
+  if (schema.type === "boolean") return false;
+  if (schema.type === "null") return null;
+  if (name === "rrule") return "FREQ=WEEKLY";
+  if (name === "title") return "Review release notes";
+  if (name === "objective") return "Check changes against the release";
+  return "release";
+}
+
+// src/surfaces/validate_input.ts
+function validateInput(schema, input, path = "$") {
+  const errors = [];
+  const matchesType = (type) => {
+    switch (type) {
+      case "object":
+        return typeof input === "object" && input !== null && !Array.isArray(input);
+      case "array":
+        return Array.isArray(input);
+      case "integer":
+        return typeof input === "number" && Number.isInteger(input);
+      case "number":
+        return typeof input === "number" && Number.isFinite(input);
+      case "null":
+        return input === null;
+      default:
+        return typeof input === type;
+    }
+  };
+  if (schema.type && !(Array.isArray(schema.type) ? schema.type : [schema.type]).some(matchesType)) {
+    return [`${path}: expected ${String(schema.type)}`];
+  }
+  if (schema.enum && !schema.enum.some((value) => JSON.stringify(value) === JSON.stringify(input)))
+    errors.push(`${path}: expected one of ${JSON.stringify(schema.enum)}`);
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0 && constant !== input)
+    errors.push(`${path}: expected ${JSON.stringify(constant)}`);
+  if (schema.oneOf) {
+    const branches = schema.oneOf.map((branch) => validateInput(branch, input, path));
+    if (!branches.some((errors2) => errors2.length === 0)) {
+      errors.push(
+        ...branches.sort((a, b) => a.length - b.length)[0] ?? [
+          `${path}: must match at least one schema branch`
+        ]
+      );
+    }
+  }
+  if (typeof input === "object" && input !== null && !Array.isArray(input)) {
+    const record = input;
+    for (const name of [...schema.required ?? [], ...requiredForAction(schema, record.action)])
+      if (!Object.hasOwn(record, name)) errors.push(`${path}.${name}: required`);
+    for (const [name, property] of Object.entries(schema.properties ?? {}))
+      if (Object.hasOwn(record, name))
+        errors.push(...validateInput(property, record[name], `${path}.${name}`));
+  }
+  if (Array.isArray(input) && schema.items)
+    input.forEach((value, index) => {
+      errors.push(...validateInput(schema.items, value, `${path}[${index}]`));
+    });
+  return errors;
+}
+
+// src/tools/action_requirements.ts
+var actionRequirements = {
+  shape_work: {
+    create_quest: ["quest"],
+    create_questline: ["questline"],
+    attach_quest_to_questline: ["questId", "questlineId"],
+    detach_quest_from_questline: ["questId"],
+    dismiss_rumor: ["rumorId"],
+    reopen_rumor: ["rumorId"],
+    settle_rumor: ["rumorId"],
+    update_rumor: ["rumorId"]
+  },
+  manage_repeatable: {
+    create: ["repeatableQuest"],
+    archive: ["repeatableQuestId"],
+    update: ["repeatableQuestId"],
+    spawn_due: ["now"]
+  },
+  organize_work: {
+    add_unlock: ["fromQuestId", "toQuestId"],
+    remove_unlock: ["fromQuestId", "toQuestId"],
+    replace_unlocks: ["fromQuestIds", "toQuestId"],
+    archive_questline: ["questlineId"],
+    set_questline_fields: ["questlineId"]
+  },
+  plan_quest: { revise_objective: ["objective"] },
+  run_quest: {
+    abandon_and_spawn_followups: ["followups"],
+    log_effort: ["effortSeconds"]
+  },
+  reward_work: { add: ["reward"], update: ["reward"], replace_repeatable_template: ["rewards"] }
+};
+
 // src/tools/tool_metadata.ts
 function defineQuestlogTool(definition) {
+  const requirements2 = actionRequirements[definition.name];
+  if (requirements2) registerSchemaActions(definition.inputSchema, requirements2);
+  const handler = definition.handler;
+  definition.handler = (db, input) => {
+    const errors = validateInput(definition.inputSchema, input);
+    if (errors.length) {
+      const action = input?.action;
+      const example = minimalInput(definition.inputSchema, action);
+      const message = errors.join("; ");
+      return toolFailure("protocol", "invalid_input", message, message, {
+        recovery: `${message}; pass ${JSON.stringify(example)}`
+      });
+    }
+    return handler(db, input);
+  };
   return definition;
 }
 function stringSchema(description, options = {}) {
@@ -3583,7 +3728,7 @@ var rewardWorkTool = defineQuestlogTool({
           name: stringSchema("Reward name."),
           now: integerSchema("Optional update timestamp for the update action.")
         },
-        []
+        ["kind", "name"]
       ),
       rewards: arraySchema(
         objectSchema(
@@ -4410,7 +4555,7 @@ var shapeWorkTool = defineQuestlogTool({
           title: stringSchema("Questline title."),
           description: stringSchema("Optional questline description.")
         },
-        []
+        ["title"]
       ),
       rumorId: integerSchema("Rumor to settle, dismiss, or reopen."),
       dismissedAt: integerSchema("Optional dismissal timestamp."),
@@ -4692,7 +4837,7 @@ var questlogSurfaceTools = questlogTools.map(
     whenNotToUse: tool.whenNotToUse ?? "",
     readOnly: tool.readOnly,
     sideEffects: tool.sideEffects,
-    inputSchema: { ...tool.inputSchema, type: "object" },
+    inputSchema: tool.inputSchema,
     handler: tool.handler
   })
 );
@@ -4727,47 +4872,6 @@ function isErrorResult(result) {
   return typeof result === "object" && result !== null && "ok" in result && result.ok === false;
 }
 
-// src/surfaces/validate_input.ts
-function validateInput(schema, input, path = "$") {
-  const errors = [];
-  const matchesType = (type) => {
-    switch (type) {
-      case "object":
-        return typeof input === "object" && input !== null && !Array.isArray(input);
-      case "array":
-        return Array.isArray(input);
-      case "integer":
-        return typeof input === "number" && Number.isInteger(input);
-      case "number":
-        return typeof input === "number" && Number.isFinite(input);
-      case "null":
-        return input === null;
-      default:
-        return typeof input === type;
-    }
-  };
-  if (schema.type && !(Array.isArray(schema.type) ? schema.type : [schema.type]).some(matchesType)) {
-    return [`${path}: expected ${String(schema.type)}`];
-  }
-  if (schema.enum && !schema.enum.some((value) => JSON.stringify(value) === JSON.stringify(input)))
-    errors.push(`${path}: expected one of ${JSON.stringify(schema.enum)}`);
-  if (schema.oneOf && !schema.oneOf.some((branch) => validateInput(branch, input, path).length === 0))
-    errors.push(`${path}: must match at least one schema branch`);
-  if (typeof input === "object" && input !== null && !Array.isArray(input)) {
-    const record = input;
-    for (const name of schema.required ?? [])
-      if (!Object.hasOwn(record, name)) errors.push(`${path}.${name}: required`);
-    for (const [name, property] of Object.entries(schema.properties ?? {}))
-      if (Object.hasOwn(record, name))
-        errors.push(...validateInput(property, record[name], `${path}.${name}`));
-  }
-  if (Array.isArray(input) && schema.items)
-    input.forEach((value, index) => {
-      errors.push(...validateInput(schema.items, value, `${path}[${index}]`));
-    });
-  return errors;
-}
-
 // src/surfaces/mcp_server.ts
 var MCP_LATEST_PROTOCOL_VERSION = "2026-07-28";
 var MCP_SUPPORTED_PROTOCOL_VERSIONS = [
@@ -4867,7 +4971,15 @@ Not for: ${tool.whenNotToUse}` : ""),
         const input = params.arguments === void 0 ? {} : params.arguments;
         const errors = validateInput(tool.inputSchema, input);
         if (errors.length)
-          return result({ content: [{ type: "text", text: errors.join("\n") }], isError: true });
+          return result({
+            content: [
+              {
+                type: "text",
+                text: `${errors.join("\n")}; pass ${JSON.stringify(minimalInput(tool.inputSchema, input?.action))}`
+              }
+            ],
+            isError: true
+          });
         try {
           context ??= Promise.resolve().then(options.context);
           const value = await tool.handler(await context, input);