@longtable/provider-claude 0.1.49 → 0.1.50

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderCapabilities, QuestionRecord } from "@longtable/core";
+import type { ProviderCapabilities, QuestionPromptType, QuestionRecord } from "@longtable/core";
 import type { CheckpointSignal, ResearcherProfile, ResolvedCheckpointPolicy, RuntimeGuidance } from "@longtable/checkpoints";
 import type { NumberedCheckpointSpec, SetupPersistedOutput } from "@longtable/setup";
 export interface ClaudeChoice {
@@ -19,6 +19,9 @@ export interface ClaudeStructuredCheckpoint {
     title: string;
     instructions?: string;
     choices: ClaudeChoice[];
+    inputMode?: QuestionPromptType;
+    multiSelect?: boolean;
+    fallbackPrompt?: string;
     guidance?: {
         closureDisposition: RuntimeGuidance["closureDisposition"];
         minimumQuestions: number;
@@ -35,14 +38,17 @@ export interface ClaudeCheckpointResult {
     policy: ResolvedCheckpointPolicy;
     guidance: RuntimeGuidance;
     structuredPrompt: ClaudeStructuredCheckpoint;
-    askUserQuestionInput: ClaudeAskUserQuestionInput;
+    askUserQuestionInput?: ClaudeAskUserQuestionInput;
+    nativeStructured: boolean;
     blocking: boolean;
 }
 export interface ClaudeRenderedQuestionRecord {
     questionId: string;
     checkpointKey: string;
     structuredPrompt: ClaudeStructuredCheckpoint;
-    askUserQuestionInput: ClaudeAskUserQuestionInput;
+    askUserQuestionInput?: ClaudeAskUserQuestionInput;
+    fallbackPrompt?: string;
+    nativeStructured: boolean;
 }
 export interface ClaudeRuntimeDefaults {
     askAtLeastTwoQuestionsInExplore: boolean;

package/dist/index.js

@@ -1,5 +1,6 @@
 import { resolveCheckpointPolicy } from "@longtable/checkpoints";
 import { resolveRuntimeGuidance } from "@longtable/checkpoints";
+import { buildNumberedCheckpointPrompt } from "@longtable/setup";
 export const CLAUDE_PROVIDER_CAPABILITIES = {
     provider: "claude",
     nativeStructuredQuestions: true,
@@ -41,13 +42,23 @@ export function renderStructuredCheckpoint(spec, guidance) {
     if (guidance) {
         instructions.push(`Closure: ${guidance.closureDisposition}. Minimum questions before closure: ${guidance.minimumQuestions}.`);
     }
+    const inputMode = spec.selectionMode === "multi"
+        ? "multi_choice"
+        : spec.selectionMode === "free_text"
+            ? "free_text"
+            : "single_choice";
     return {
         title: spec.title,
         instructions: instructions.filter(Boolean).join(" "),
-        choices: spec.options.map((option) => ({
-            id: option.value,
-            label: option.label
-        })),
+        choices: inputMode === "free_text"
+            ? []
+            : spec.options.map((option) => ({
+                id: option.value,
+                label: option.label
+            })),
+        inputMode,
+        multiSelect: inputMode === "multi_choice",
+        ...(inputMode === "free_text" ? { fallbackPrompt: buildNumberedCheckpointPrompt(spec) } : {}),
         guidance: guidance
             ? {
                 closureDisposition: guidance.closureDisposition,
@@ -59,6 +70,9 @@ export function renderStructuredCheckpoint(spec, guidance) {
     };
 }
 export function renderAskUserQuestionInput(checkpoint) {
+    if (checkpoint.inputMode === "free_text") {
+        throw new Error("Claude AskUserQuestion choice payload cannot render free-text LongTable checkpoints.");
+    }
     return {
         questions: [
             {
@@ -67,7 +81,7 @@ export function renderAskUserQuestionInput(checkpoint) {
                 options: checkpoint.choices.map((choice) => ({
                     label: choice.label
                 })),
-                multiSelect: false
+                multiSelect: checkpoint.multiSelect ?? false
             }
         ]
     };
@@ -89,36 +103,59 @@ export function renderStructuredQuestionRecord(record) {
                 }]
             : [])
     ];
+    const instructions = [
+        record.prompt.question,
+        record.prompt.displayReason ? `Decision context: ${record.prompt.displayReason}` : undefined,
+        `Question id: ${record.id}`,
+        `Checkpoint: ${record.prompt.checkpointKey ?? "manual"}`,
+        `Required: ${record.prompt.required ? "yes" : "no"}`
+    ].filter(Boolean).join(" ");
+    const fallbackSpec = {
+        title: record.prompt.title,
+        instructions,
+        options: [],
+        allowRationale: false,
+        selectionMode: "free_text"
+    };
     return {
         title: record.prompt.title,
-        instructions: [
-            record.prompt.question,
-            record.prompt.displayReason ? `Decision context: ${record.prompt.displayReason}` : undefined,
-            `Question id: ${record.id}`,
-            `Checkpoint: ${record.prompt.checkpointKey ?? "manual"}`,
-            `Required: ${record.prompt.required ? "yes" : "no"}`
-        ].filter(Boolean).join(" "),
-        choices
+        instructions,
+        choices: record.prompt.type === "free_text" ? [] : choices,
+        inputMode: record.prompt.type,
+        multiSelect: record.prompt.type === "multi_choice",
+        ...(record.prompt.type === "free_text" ? { fallbackPrompt: buildNumberedCheckpointPrompt(fallbackSpec) } : {})
     };
 }
 export function renderQuestionRecordInput(record) {
     const structuredPrompt = renderStructuredQuestionRecord(record);
+    if (structuredPrompt.inputMode === "free_text") {
+        return {
+            questionId: record.id,
+            checkpointKey: record.prompt.checkpointKey ?? "manual",
+            structuredPrompt,
+            fallbackPrompt: structuredPrompt.fallbackPrompt,
+            nativeStructured: false
+        };
+    }
     return {
         questionId: record.id,
         checkpointKey: record.prompt.checkpointKey ?? "manual",
         structuredPrompt,
-        askUserQuestionInput: renderAskUserQuestionInput(structuredPrompt)
+        askUserQuestionInput: renderAskUserQuestionInput(structuredPrompt),
+        nativeStructured: true
     };
 }
 export function createClaudeCheckpoint(context) {
     const policy = resolveCheckpointPolicy(context.profile, context.signal);
     const guidance = resolveRuntimeGuidance(context.profile, context.signal, policy);
     const structuredPrompt = renderStructuredCheckpoint(context.spec, guidance);
+    const nativeStructured = structuredPrompt.inputMode !== "free_text";
     return {
         policy,
         guidance,
         structuredPrompt,
-        askUserQuestionInput: renderAskUserQuestionInput(structuredPrompt),
+        ...(nativeStructured ? { askUserQuestionInput: renderAskUserQuestionInput(structuredPrompt) } : {}),
+        nativeStructured,
         blocking: policy.blocking
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-claude",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "private": false,
   "description": "Claude adapter surface for LongTable",
   "type": "module",
@@ -21,9 +21,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.49",
-    "@longtable/core": "0.1.49",
-    "@longtable/setup": "0.1.49"
+    "@longtable/checkpoints": "0.1.50",
+    "@longtable/core": "0.1.50",
+    "@longtable/setup": "0.1.50"
   },
   "devDependencies": {
     "typescript": "^5.6.0"