clef-mcp 0.1.1 → 0.1.3

package/README.md

@@ -63,6 +63,18 @@ args = []
 }
 ```
 
+**ZCode** — `~/.zcode/cli/config.json` (user scope; servers auto-connect in new sessions):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "clef-mcp": { "command": "clef-mcp", "args": [], "type": "stdio" }
+    }
+  }
+}
+```
+
 **Generic MCP client** — any client that speaks MCP over stdio: run `clef-mcp` as the server command.
 
 Ready-made snippets live in [`examples/`](examples/).
@@ -104,7 +116,7 @@ Ready-made snippets live in [`examples/`](examples/).
 
 | Type | Criteria | Meaning |
 |------|----------|---------|
-| `choice` | map of `option id → description` | Pick among named options |
+| `choice` | map of `option id → description`, or a plain list of options (ids = the strings) | Pick among named options |
 | `score` | ordered list of descriptions | Ordered scale (index = score) |
 | `noul` | optional `{"true": "...", "false": "..."}` | Yes/no question |
 
@@ -131,6 +143,22 @@ Strictly structured — the server never turns the result into prose:
 
 `state` is treated strictly as **data**: it is never interpreted as instructions for the MCP server itself (see [Security](#security--data-handling)).
 
+## Teach your agent (skill)
+
+The tool schema tells the client *what* `clef_decide` accepts; agents also need to know *when* to reach for it and *how* to frame decisions. The bundled skill covers that: decision patterns (next action / routing / classification / noul / score), batching up to 64 questions into one forward pass, writing mutually exclusive criteria, interpreting distributions (argmax vs flat), thresholds for safety-adjacent calls, and error recovery.
+
+Install it for your agent(s):
+
+```bash
+# from this repo
+cp -r skills/clef-decisions ~/.agents/skills/
+
+# or from the npm package
+cp -r "$(npm root -g)/clef-mcp/skills/clef-decisions" ~/.agents/skills/
+```
+
+`~/.agents/skills/` is the shared location for ZCode / Claude Code / Codex-style agents.
+
 ## CLI
 
 ```bash

package/dist/cli.js

@@ -74,7 +74,9 @@ function toSystemOneRequest(input, defaultModel) {
   const questions = {};
   for (const [qid, q] of Object.entries(input.questions)) {
     const question = { type: q.type, instructions: q.instructions };
-    if (q.criteria !== void 0) question.criteria = q.criteria;
+    if (q.criteria !== void 0) {
+      question.criteria = q.type === "choice" && Array.isArray(q.criteria) ? Object.fromEntries(q.criteria.map((c) => [c, c])) : q.criteria;
+    }
     questions[qid] = question;
   }
   return {
@@ -804,14 +806,23 @@ import { z } from "zod";
 function criteriaDescription(limits) {
   return z.string().min(1).max(limits.maxCriteriaDescChars);
 }
+function countIssues(count, limits) {
+  if (count === 0) return "criteria must not be empty";
+  if (count > limits.maxCriteriaPerQuestion) return `too many criteria (max ${limits.maxCriteriaPerQuestion})`;
+  return void 0;
+}
 function choiceCriteria(limits) {
-  return z.record(z.string().min(1).max(limits.maxCriteriaDescChars), criteriaDescription(limits)).check((ctx) => {
-    const count = Object.keys(ctx.value).length;
-    if (count === 0) ctx.issues.push({ code: "custom", message: "criteria must not be empty", input: ctx.value });
-    if (count > limits.maxCriteriaPerQuestion) {
-      ctx.issues.push({ code: "custom", message: `too many criteria (max ${limits.maxCriteriaPerQuestion})`, input: ctx.value });
-    }
-  });
+  return z.union([
+    // Plain list: option ids equal to the strings themselves.
+    z.array(criteriaDescription(limits)).check((ctx) => {
+      const problem = countIssues(ctx.value.length, limits);
+      if (problem) ctx.issues.push({ code: "custom", message: problem, input: ctx.value });
+    }),
+    z.record(z.string().min(1).max(limits.maxCriteriaDescChars), criteriaDescription(limits)).check((ctx) => {
+      const problem = countIssues(Object.keys(ctx.value).length, limits);
+      if (problem) ctx.issues.push({ code: "custom", message: problem, input: ctx.value });
+    })
+  ]);
 }
 function scoreCriteria(limits) {
   return z.array(criteriaDescription(limits)).check((ctx) => {
@@ -832,7 +843,7 @@ function questionSchema(limits) {
       if (!parsed.success) {
         ctx.addIssue({
           code: "custom",
-          message: `"choice" questions require non-empty criteria as a map of option id -> description (${parsed.error.issues[0]?.message ?? "invalid criteria"})`
+          message: `"choice" questions require non-empty criteria as a map of option id -> description, or a plain list of options (${parsed.error.issues[0]?.message ?? "invalid criteria"})`
         });
       }
     } else if (q.type === "score") {
@@ -1736,7 +1747,7 @@ async function confirm(question, yes) {
 }
 
 // src/version.ts
-var VERSION = "0.1.1";
+var VERSION = "0.1.3";
 
 // src/cli/install.ts
 var OS_NAMES = {