idiolect-mcp 0.5.0 → 0.5.1

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "idiolect-mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "mcpName": "app.idiolect/idiolect-ai",
   "type": "module",
   "bin": {
     "idiolect-mcp": "server.mjs"
   },
-  "description": "MCP server that gives any MCP-compatible AI (Claude, etc.) your Idiolect AI voice — make AI write as you. https://idiolect.app",
+  "description": "MCP server that gives any MCP-compatible AI (Claude, etc.) your Idiolect AI voice \u2014 make AI write as you. https://idiolect.app",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -24,6 +24,7 @@
   "license": "MIT",
   "files": [
     "server.mjs",
+    "public-contract.js",
     "progressive-catalog.json",
     "README.md"
   ],

package/public-contract.js

@@ -0,0 +1,85 @@
+// Generated from lib/mcp/public-contract.js by `npm run mcp:generate-public-artifacts`. Do not edit.
+export const PUBLIC_MCP_TOOL_NAMES = Object.freeze([
+  "get_my_voice",
+  "create_my_voice",
+  "draft_in_voice",
+  "rewrite_in_voice",
+  "score_voice",
+  "record_voice_feedback",
+  "learn_writing_style",
+  "list_writing_profiles",
+  "list_writing_profile_samples",
+  "create_writing_profile",
+  "add_samples_to_writing_profile",
+  "replace_samples_in_writing_profile",
+  "remove_sample_from_writing_profile",
+  "set_current_writing_profile",
+  "delete_writing_profile",
+]);
+
+// Decision for the 2026-08-10 high-arrival review: keep measurement available,
+// but tell hosts to invoke it only when the user explicitly asks for a check.
+// Unmeasured results must continue to say why and expose scorer provenance.
+export const SCORE_VOICE_ADVERTISING_DECISION = Object.freeze({
+  advertised: true,
+  invocation: "explicit_request_only",
+});
+
+const PUBLIC_STATES = new Set([
+  "ready",
+  "missing",
+  "thin",
+  "stale",
+  "complete",
+  "failed",
+]);
+const NEXT_ACTIONS = new Set([
+  "collect_evidence",
+  "reload_voice",
+  "continue_writing",
+  "ask_feedback",
+  "retry",
+  "done",
+]);
+const NEXT_TOOLS = new Set([
+  "create_my_voice",
+  "get_my_voice",
+  "record_voice_feedback",
+  null,
+]);
+const SERVER_ONLY_KEYS = new Set([
+  "workflowId",
+  "baseVersion",
+  "idempotencyKey",
+  "onboardingIdempotencyKey",
+  "leaseToken",
+  "fencingToken",
+  "attemptToken",
+  "buildBindingId",
+]);
+
+function stripServerOnly(value) {
+  if (Array.isArray(value)) return value.map(stripServerOnly);
+  if (!value || typeof value !== "object") return value;
+  return Object.fromEntries(
+    Object.entries(value)
+      .filter(([key]) => !SERVER_ONLY_KEYS.has(key))
+      .map(([key, nested]) => [key, stripServerOnly(nested)]),
+  );
+}
+
+/**
+ * Build the only model-visible state/continuation envelope. Details are copied
+ * through a denylist so internal coordination receipts cannot leak by spread.
+ */
+export function publicMcpState(state, message, next, details = {}) {
+  if (!PUBLIC_STATES.has(state)) throw new TypeError(`Unknown public MCP state: ${state}`);
+  if (!next || !NEXT_ACTIONS.has(next.action) || !NEXT_TOOLS.has(next.tool)) {
+    throw new TypeError("Invalid public MCP next action");
+  }
+  const safeDetails = stripServerOnly(details);
+  delete safeDetails.state;
+  delete safeDetails.message;
+  delete safeDetails.next;
+  return { state, message, ...safeDetails, next: { action: next.action, tool: next.tool } };
+}

package/server.mjs

@@ -34,7 +34,7 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import {
   publicMcpState,
-} from "../lib/mcp/public-contract.js";
+} from "./public-contract.js";
 
 const progressiveCatalog = JSON.parse(
   readFileSync(new URL("./progressive-catalog.json", import.meta.url), "utf8"),
@@ -489,6 +489,18 @@ const BRIEF_AUTHOR_SCHEMA = {
   description:
     "Who wrote the brief. `user` only when the person wrote it themselves; `host` when you (the assistant) drafted it; `other` for a third party's text. Leave it out if unsure.",
 };
+const CALIBRATION_SCHEMA = {
+  type: "object",
+  properties: {
+    direction: {
+      type: "string",
+      enum: ["direct", "balanced", "gentle"],
+      description: "The user's answer to the single task-local calibration question.",
+    },
+  },
+  required: ["direction"],
+  additionalProperties: false,
+};
 
 /** Validates `sourceAuthor`/`briefAuthor` and defaults an absent one to `"unknown"` on the
  * returned copy of `args`. Returns a tool error, never throws. */
@@ -1052,6 +1064,7 @@ const accountToolDefinitions = [
         changeScope: CHANGE_SCOPE_SCHEMA,
         effects: EFFECTS_SCHEMA,
         sourceAuthor: SOURCE_AUTHOR_SCHEMA,
+        calibration: CALIBRATION_SCHEMA,
         profileId: { type: "string", format: "uuid", description: "Use this owned Writing Profile for this piece only. Select an exact profileId; this does not change the account default." },
       },
       required: ["text"],
@@ -1090,6 +1103,7 @@ const accountToolDefinitions = [
         },
         effects: EFFECTS_SCHEMA,
         briefAuthor: BRIEF_AUTHOR_SCHEMA,
+        calibration: CALIBRATION_SCHEMA,
         profileId: { type: "string", format: "uuid", description: "Use this owned Writing Profile for this piece only. Select an exact profileId; this does not change the account default." },
       },
       required: ["brief"],
@@ -1618,6 +1632,7 @@ export async function handleToolRequest(req) {
       const changeScope = args.changeScope === "polish" ? "light_edit" : args.changeScope;
       const effects = args.effects;
       const sourceAuthor = args.sourceAuthor;
+      const calibration = args.calibration;
       if (!text) {
         return { content: [{ type: "text", text: "rewrite_in_voice: provide `text` to rewrite." }], isError: true };
       }
@@ -1643,6 +1658,7 @@ export async function handleToolRequest(req) {
             ...(changeScope !== undefined ? { changeScope } : {}),
             ...(effects !== undefined ? { effects } : {}),
             ...(sourceAuthor !== undefined ? { sourceAuthor } : {}),
+            ...(calibration !== undefined ? { calibration } : {}),
           },
           toolName: "rewrite_in_voice",
         });
@@ -1678,6 +1694,7 @@ export async function handleToolRequest(req) {
       const changeScope = args.changeScope === "polish" ? "light_edit" : args.changeScope;
       const effects = args.effects;
       const briefAuthor = args.briefAuthor;
+      const calibration = args.calibration;
       if (!brief) {
         return { content: [{ type: "text", text: "draft_in_voice: provide `brief` to draft from." }], isError: true };
       }
@@ -1703,6 +1720,7 @@ export async function handleToolRequest(req) {
             ...(changeScope !== undefined ? { changeScope } : {}),
             ...(effects !== undefined ? { effects } : {}),
             ...(briefAuthor !== undefined ? { briefAuthor } : {}),
+            ...(calibration !== undefined ? { calibration } : {}),
           },
           toolName: "draft_in_voice",
         });