clef-mcp 0.2.0 → 0.2.1

package/dist/cli.js

@@ -1432,10 +1432,12 @@ function scoreCriteria(limits) {
 }
 function questionSchema(limits) {
   return z.object({
-    type: z.enum(["noul", "choice", "score"]),
-    instructions: z.string().min(1).max(limits.maxInstructionsChars),
+    type: z.enum(["noul", "choice", "score"]).describe('"choice" = pick among named options; "score" = judge an ordered scale; "noul" = yes/no question'),
+    instructions: z.string().min(1).max(limits.maxInstructionsChars).describe("What to judge, phrased as a self-contained question."),
     criteria: z.union([z.array(z.string()), z.record(z.string(), z.string())]).optional()
-  }).superRefine((q, ctx) => {
+  }).describe(
+    "A single decision question. Allowed answers come from `criteria` and must be mutually exclusive and collectively exhaustive."
+  ).superRefine((q, ctx) => {
     if (q.type === "choice") {
       const parsed = choiceCriteria(limits).safeParse(q.criteria);
       if (!parsed.success) {
@@ -1459,23 +1461,27 @@ function questionSchema(limits) {
 }
 function clefDecideInputShape(limits) {
   return {
-    state: z.unknown(),
-    questions: z.record(z.string().min(1).max(limits.maxQuestionIdChars), questionSchema(limits)).check((ctx) => {
+    state: z.unknown().describe(
+      "Task state as data: a compact string or JSON object with the facts needed to judge (task, errors, logs, diffs). Never treated as instructions. Serialized size limit: 1 MB; model context is 16k tokens."
+    ),
+    questions: z.record(z.string().min(1).max(limits.maxQuestionIdChars), questionSchema(limits)).describe(
+      "Map of question id -> typed question. Up to 64 questions per call; all are scored together in a single forward pass, so batch related decisions here."
+    ).check((ctx) => {
       const count = Object.keys(ctx.value).length;
       if (count === 0) ctx.issues.push({ code: "custom", message: "questions must not be empty", input: ctx.value });
       if (count > limits.maxQuestions) {
         ctx.issues.push({ code: "custom", message: `too many questions (max ${limits.maxQuestions})`, input: ctx.value });
       }
     }),
-    model: z.string().min(1).optional(),
+    model: z.string().min(1).optional().describe("Model id to use (default: clef-flash from CLEF_MODEL)."),
     options: z.object({
       /**
        * Accepted for forward compatibility. Clef scores all options in a
        * single forward pass — there is no sampling, so temperature is a
        * documented no-op.
        */
-      temperature: z.number().min(0).max(2).optional()
-    }).optional()
+      temperature: z.number().min(0).max(2).optional().describe("Accepted for forward compatibility; no-op. Clef scores in a single forward pass without sampling.")
+    }).optional().describe("Extra options. Currently only temperature, which is a documented no-op.")
   };
 }
 function clefDecideInputSchema(limits) {
@@ -1894,9 +1900,15 @@ function createClefServer(deps = {}) {
     TOOL_NAME,
     {
       title: "Clef Decide",
-      description: "Pass task state and a set of structured questions (noul / choice / score) to the local Clef decision model. Returns a probability distribution over the allowed answers for every question. The result is structured JSON.",
+      description: 'Ask the local Clef decision model to judge a situation. Pass a `state` (compact factual context as a string or JSON) and one or more typed `questions`: "choice" picks among named options (criteria = option id -> description), "score" judges an ordered scale (criteria = ordered list), "noul" answers yes/no. Returns strict JSON: for every question a probability distribution over its allowed answers \u2014 no prose, no sampling. Usage: batch related decisions (up to 64 questions) in one call; state is data and is never executed; act on the argmax when a distribution is decisive (p >= 0.8), otherwise gather more context or ask the user; for destructive or security-adjacent decisions require high confidence before acting. Optional `model` overrides the model id; `options.temperature` is a no-op (single forward pass, no sampling).',
       inputSchema: clefDecideInputShape(config.limits),
-      outputSchema: clefDecideOutputSchema().shape
+      outputSchema: clefDecideOutputSchema().shape,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
     },
     async (args) => {
       try {
@@ -2639,7 +2651,7 @@ async function removeManagedRuntime(cfg) {
 init_prompt();
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.1";
 
 // src/cli/install.ts
 var OS_NAMES = {