@longtable/mcp 0.1.21 → 0.1.23

package/README.md

@@ -14,7 +14,7 @@ longtable-state
 Run:
 
 ```bash
-npx -y @longtable/mcp@0.1.14
+npx -y @longtable/mcp@0.1.22
 ```
 
 Self-test:
@@ -22,3 +22,12 @@ Self-test:
 ```bash
 longtable-state --self-test
 ```
+
+Codex UI Researcher Checkpoints are opt-in from the CLI:
+
+```bash
+longtable mcp install --provider codex --checkpoint-ui strong --write
+```
+
+If MCP elicitation is unavailable or not approved, the server returns the same
+pending `QuestionRecord` as a numbered fallback.

package/dist/server.js

@@ -11,7 +11,7 @@ import { renderQuestionRecordInput } from "@longtable/provider-claude";
 import { renderQuestionRecordPrompt } from "@longtable/provider-codex";
 import { answerWorkspaceQuestion, createWorkspaceQuestion, inspectProjectWorkspace, loadProjectContextFromDirectory, loadWorkspaceState, syncCurrentWorkspaceView } from "@longtable/cli";
 const SERVER_NAME = "longtable-state";
-const SERVER_VERSION = "0.1.14";
+const SERVER_VERSION = "0.1.22";
 const TOOL_NAMES = [
     "read_project",
     "read_session",
@@ -19,6 +19,7 @@ const TOOL_NAMES = [
     "pending_questions",
     "evaluate_checkpoint",
     "create_question",
+    "elicit_question",
     "render_question",
     "append_decision",
     "regenerate_current"
@@ -64,6 +65,67 @@ function findQuestion(records, questionId) {
     }
     return records.filter((record) => record.status === "pending").at(-1) ?? null;
 }
+function renderQuestionFallback(record, provider = "codex") {
+    return provider === "claude"
+        ? renderQuestionRecordInput(record)
+        : renderQuestionRecordPrompt(record);
+}
+function buildElicitationParams(record) {
+    const choices = [
+        ...record.prompt.options.map((option) => ({
+            const: option.value,
+            title: [
+                option.label,
+                option.recommended ? "(Recommended)" : ""
+            ].filter(Boolean).join(" ")
+        })),
+        ...(record.prompt.allowOther
+            ? [{
+                    const: "other",
+                    title: record.prompt.otherLabel ?? "Other"
+                }]
+            : [])
+    ];
+    return {
+        mode: "form",
+        message: [
+            record.prompt.title,
+            record.prompt.question,
+            ...record.prompt.rationale.slice(0, 2).map((entry) => `Why now: ${entry}`)
+        ].join("\n"),
+        requestedSchema: {
+            type: "object",
+            properties: {
+                answer: {
+                    type: "string",
+                    title: "Decision",
+                    oneOf: choices,
+                    default: choices[0]?.const
+                },
+                rationale: {
+                    type: "string",
+                    title: "Rationale",
+                    description: "Optional short note for the LongTable decision log."
+                }
+            },
+            required: ["answer"]
+        }
+    };
+}
+function acceptedAnswer(result) {
+    if (result.action !== "accept") {
+        return null;
+    }
+    const answer = result.content?.answer;
+    if (typeof answer !== "string" || answer.length === 0) {
+        return null;
+    }
+    const rationale = result.content?.rationale;
+    return {
+        answer,
+        ...(typeof rationale === "string" && rationale.length > 0 ? { rationale } : {})
+    };
+}
 async function readAllowedProjectFiles(context) {
     const current = existsSync(context.currentFilePath)
         ? await readFile(context.currentFilePath, "utf8")
@@ -216,6 +278,78 @@ export function createLongTableMcpServer() {
             return errorResult(error instanceof Error ? error.message : String(error));
         }
     });
+    server.registerTool("elicit_question", {
+        title: "Elicit Researcher Checkpoint",
+        description: "Create a QuestionRecord, then try MCP form elicitation for a provider-native UI checkpoint. Falls back to rendered LongTable transport when unsupported.",
+        inputSchema: cwdSchema.extend({
+            prompt: z.string().min(1),
+            title: z.string().optional(),
+            question: z.string().optional(),
+            provider: z.enum(["codex", "claude"]).default("codex"),
+            required: z.boolean().optional(),
+            fallbackOnly: z.boolean().default(false).describe("Create and render the checkpoint without calling MCP elicitation.")
+        })
+    }, async ({ cwd: inputCwd, prompt, title, question, provider, required, fallbackOnly }) => {
+        try {
+            const context = await requireContext(inputCwd);
+            const created = await createWorkspaceQuestion({
+                context,
+                prompt,
+                title,
+                question,
+                provider,
+                required
+            });
+            const fallback = renderQuestionFallback(created.question, provider);
+            if (fallbackOnly) {
+                return textResult({
+                    question: created.question,
+                    elicitation: { attempted: false, reason: "fallbackOnly" },
+                    fallback,
+                    nextAction: `longtable decide --question ${created.question.id} --answer <value>`
+                });
+            }
+            try {
+                const elicited = await server.server.elicitInput(buildElicitationParams(created.question));
+                const accepted = acceptedAnswer(elicited);
+                if (!accepted) {
+                    return textResult({
+                        question: created.question,
+                        elicitation: { attempted: true, action: elicited.action },
+                        fallback,
+                        nextAction: `longtable decide --question ${created.question.id} --answer <value>`
+                    });
+                }
+                const decided = await answerWorkspaceQuestion({
+                    context,
+                    questionId: created.question.id,
+                    answer: accepted.answer,
+                    rationale: accepted.rationale,
+                    provider: provider
+                });
+                return textResult({
+                    question: decided.question,
+                    decision: decided.decision,
+                    elicitation: { attempted: true, action: elicited.action }
+                });
+            }
+            catch (elicitationError) {
+                return textResult({
+                    question: created.question,
+                    elicitation: {
+                        attempted: true,
+                        supported: false,
+                        error: elicitationError instanceof Error ? elicitationError.message : String(elicitationError)
+                    },
+                    fallback,
+                    nextAction: `longtable decide --question ${created.question.id} --answer <value>`
+                });
+            }
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
     server.registerTool("render_question", {
         title: "Render Researcher Checkpoint",
         description: "Render a pending QuestionRecord for Codex numbered prompt or Claude structured question transport.",
@@ -232,9 +366,7 @@ export function createLongTableMcpServer() {
             if (!question) {
                 return errorResult("No matching pending LongTable question was found.");
             }
-            const transport = provider === "claude"
-                ? renderQuestionRecordInput(question)
-                : renderQuestionRecordPrompt(question);
+            const transport = renderQuestionFallback(question, provider);
             return textResult({ provider, question, transport });
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/mcp",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "private": false,
   "description": "LongTable MCP transport for workspace state and Researcher Checkpoints",
   "type": "module",
@@ -26,11 +26,11 @@
     "self-test": "node ./dist/server.js --self-test"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.21",
-    "@longtable/cli": "0.1.21",
-    "@longtable/core": "0.1.21",
-    "@longtable/provider-claude": "0.1.21",
-    "@longtable/provider-codex": "0.1.21",
+    "@longtable/checkpoints": "0.1.23",
+    "@longtable/cli": "0.1.23",
+    "@longtable/core": "0.1.23",
+    "@longtable/provider-claude": "0.1.23",
+    "@longtable/provider-codex": "0.1.23",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.0.0"
   },