clef-mcp 0.3.1 → 0.4.0

package/examples/classify/README.md

@@ -0,0 +1,27 @@
+# Classify support requests locally
+
+These files ship with the npm package. After `clef-mcp install`, run from this directory:
+
+```sh
+clef-mcp classify tickets.jsonl --profile support-routing.yaml --output results.jsonl
+clef-mcp classify tickets.csv --profile support-routing.yaml --output csv-results.jsonl
+clef-mcp classify tickets.jsonl --profile support-routing.yaml --output results.jsonl --resume
+```
+
+Both inputs contain the same three records. CSV IDs stay strings (`001`).
+The third request deliberately overlaps billing and technical support; its
+result depends on the model distribution and the profile policy.
+
+Results are JSONL. `classified` has an accepted `label`; `needs_review` has
+`label: null`, a `suggested_label`, probabilities and review reasons. There is
+no fixed expected answer/accuracy claim for this example.
+
+To inspect stricter review behavior, copy the profile and set
+`min_probability: 1.0`. To accept more results, lower the thresholds only
+after checking the distributions on representative labeled data. A threshold
+does not establish calibrated accuracy or replace authorization checks.
+
+Output paths must be new, or use `--resume` with the same input/profile/model/runtime.
+Changing a threshold requires a new output path. Resume skips every committed
+row, including error rows; it does not retry failed input records. See the main
+README for sidecars, locks, exit codes and input limits.

package/examples/classify/support-routing.yaml

@@ -0,0 +1,18 @@
+schema_version: 1
+name: support-routing
+instructions: Classify the current support request into exactly one department. Labeled examples are reference data.
+labels:
+  billing: Payments, refunds, invoices and subscription charges
+  technical: Errors, outages, installation and integration problems
+  other: Requests outside billing and technical support
+input:
+  id_field: id
+  fields: [subject, body]
+policy:
+  min_probability: 0.80
+  min_margin: 0.15
+examples:
+  - input:
+      subject: Duplicate charge
+      body: My card was charged twice for one subscription.
+    label: billing

package/examples/classify/tickets.csv

@@ -0,0 +1,4 @@
+id,subject,body
+001,Refund request,"I was charged twice for the same subscription. Please refund the duplicate payment."
+002,Connection error,"The integration fails with HTTP 500 whenever I submit a request."
+003,Payment page error,"I cannot finish paying because the checkout page crashes."

package/examples/classify/tickets.jsonl

@@ -0,0 +1,3 @@
+{"id":"001","subject":"Refund request","body":"I was charged twice for the same subscription. Please refund the duplicate payment."}
+{"id":"002","subject":"Connection error","body":"The integration fails with HTTP 500 whenever I submit a request."}
+{"id":"003","subject":"Payment page error","body":"I cannot finish paying because the checkout page crashes."}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clef-mcp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "mcpName": "io.github.HighlyLoadedEgo/clef-mcp",
   "description": "Local MCP server exposing the Clef decision model as a structured clef_decide tool.",
   "type": "module",
@@ -44,6 +44,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.0",
     "commander": "^15.0.0",
+    "csv-parse": "7.0.3",
+    "yaml": "2.9.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {