@elicitkit/renderers 0.1.0

package/dist/elicitation.js

@@ -0,0 +1,345 @@
+/**
+ * `elicitation` tier — no custom UI; drive the host's *native* MCP
+ * elicitation primitive (form mode). Unlike the panel tiers this resolves
+ * inline against the host's elicitInput; the server is responsible for
+ * driving each step from `elicit` / `elicit_next`. Each Ask maps to one
+ * or more elicitInputs (`ask_code_diff` issues one confirm per hunk per
+ * SPEC §7.4); the bound is "one elicitInput per tool call" so the
+ * per-call MCP timeout is never the gating factor.
+ *
+ * action → status:  accept → answered · decline → declined · cancel → deferred
+ */
+/**
+ * Compile an Ask into the *sequence* of elicitInputs needed to fully
+ * elicit it on the elicitation tier. The list is almost always length-1;
+ * `ask_code_diff` is the v0.1 exception (one confirm per hunk so the
+ * user reviews each change separately — SPEC §7.4).
+ */
+export function compileAskToInputs(ask) {
+    switch (ask.type) {
+        case "ask_text":
+            return [
+                {
+                    message: msg(ask),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: {
+                                type: "string",
+                                title: ask.prompt,
+                                ...(ask.spec.maxLen ? { maxLength: ask.spec.maxLen } : {}),
+                            },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        case "ask_confirm":
+            return [
+                {
+                    message: ask.spec.consequence
+                        ? `${msg(ask)}\n\n${ask.spec.consequence}`
+                        : msg(ask),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "boolean", title: ask.prompt },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        case "ask_select": {
+            const s = ask.spec;
+            const branches = s.options.map((o) => ({ const: o.id, title: o.label }));
+            const ids = s.options.map((o) => o.id);
+            const descLines = s.options
+                .filter((o) => !!o.description)
+                .map((o) => `- ${o.label}: ${o.description}`);
+            const message = descLines.length > 0
+                ? `${msg(ask)}\n\n${descLines.join("\n")}`
+                : msg(ask);
+            return [
+                {
+                    message,
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: s.multiple
+                                ? {
+                                    type: "array",
+                                    title: ask.prompt,
+                                    items: { anyOf: branches },
+                                    ...(s.min ? { minItems: s.min } : {}),
+                                    ...(s.max ? { maxItems: s.max } : {}),
+                                }
+                                : {
+                                    type: "string",
+                                    title: ask.prompt,
+                                    oneOf: branches,
+                                    default: ids[0],
+                                },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        case "ask_code_diff": {
+            // One confirm per hunk, sequential (SPEC §7.4).
+            const inputs = [];
+            for (const file of ask.spec.files) {
+                for (const h of file.hunks) {
+                    inputs.push({
+                        message: `${ask.prompt}\n\n${file.path}` +
+                            (h.header ? ` — ${h.header}` : ` — hunk ${h.id}`) +
+                            `\n\n${h.after}`,
+                        requestedSchema: {
+                            type: "object",
+                            properties: {
+                                accept: {
+                                    type: "boolean",
+                                    title: `Accept this hunk (${h.id})?`,
+                                    default: true,
+                                },
+                            },
+                            required: ["accept"],
+                        },
+                    });
+                }
+            }
+            return inputs;
+        }
+        case "ask_number": {
+            const s = ask.spec ?? {};
+            return [
+                {
+                    message: msg(ask) + (s.unit ? `\n\n(unit: ${s.unit})` : ""),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: {
+                                type: s.integer ? "integer" : "number",
+                                title: ask.prompt,
+                                ...(typeof s.min === "number" ? { minimum: s.min } : {}),
+                                ...(typeof s.max === "number" ? { maximum: s.max } : {}),
+                            },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        case "ask_slider": {
+            const s = ask.spec;
+            return [
+                {
+                    message: msg(ask) + `\n\n(${s.min}–${s.max}${s.unit ? " " + s.unit : ""})`,
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "number", title: ask.prompt, minimum: s.min, maximum: s.max },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        case "ask_rating": {
+            const max = ask.spec?.max ?? 5;
+            return [
+                {
+                    message: msg(ask) + `\n\n(1 = lowest, ${max} = highest)`,
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "integer", title: ask.prompt, minimum: 1, maximum: max },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        case "ask_date": {
+            return [
+                {
+                    message: msg(ask),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: {
+                                type: "string",
+                                title: ask.prompt,
+                                format: ask.spec?.time ? "date-time" : "date",
+                            },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        case "ask_rank": {
+            const items = ask.spec.items;
+            const branches = items.map((i) => ({ const: i.id, title: i.label }));
+            return [
+                {
+                    message: `${msg(ask)}\n\nRank by listing every option in order, best first:\n` +
+                        items.map((i) => `- ${i.id}: ${i.label}`).join("\n"),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: {
+                                type: "array",
+                                title: ask.prompt,
+                                items: { anyOf: branches },
+                                minItems: items.length,
+                                maxItems: items.length,
+                            },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        case "ask_color": {
+            const pal = ask.spec?.palette ?? [];
+            const fixed = pal.length > 0 && ask.spec?.allowCustom !== true;
+            const branches = pal.map((c) => ({ const: c, title: c }));
+            return [
+                {
+                    message: fixed
+                        ? msg(ask)
+                        : `${msg(ask)}\n\nEnter a CSS color (e.g. #1d4ed8)` +
+                            (pal.length ? `\nSuggested: ${pal.join(", ")}` : ""),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: fixed
+                                ? { type: "string", title: ask.prompt, oneOf: branches }
+                                : { type: "string", title: ask.prompt },
+                        },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+        default: {
+            const a = ask;
+            return [
+                {
+                    message: msg(a),
+                    requestedSchema: {
+                        type: "object",
+                        properties: { value: { type: "string", title: a.prompt } },
+                        required: ["value"],
+                    },
+                },
+            ];
+        }
+    }
+}
+/**
+ * Assemble an Answer from the collected ElicitResults for a single Ask.
+ * `responses.length === compileAskToInputs(ask).length`. For asks with a
+ * single elicitInput this is a one-shot decode; `ask_code_diff` folds N
+ * per-hunk confirms into one `{ accepted, rejected }` value.
+ *
+ * The decline-on-first-non-accept rule (SPEC §7.4) is implemented here:
+ * the server passes through every collected response, including the
+ * non-accepts, and the decoder turns the first non-accept into the
+ * ask's final status.
+ */
+export function decodeAskAnswer(ask, responses) {
+    // Common short-circuit: a non-accept on the first elicitInput is the
+    // ask's outcome for everything except ask_code_diff (which we handle
+    // hunk-by-hunk below).
+    if (ask.type !== "ask_code_diff") {
+        const r = responses[0];
+        if (!r)
+            return answer(ask, "deferred");
+        return answer(ask, statusFor(r.action), readValue(ask, r));
+    }
+    // ask_code_diff: one confirm per hunk. A non-accept on any hunk ends
+    // the ask with that hunk's outcome; previously-decided hunks are kept.
+    const accepted = [];
+    const rejected = [];
+    let i = 0;
+    for (const file of ask.spec.files) {
+        for (const h of file.hunks) {
+            const r = responses[i++];
+            if (!r)
+                return answer(ask, "deferred", { accepted, rejected });
+            if (r.action !== "accept") {
+                return answer(ask, statusFor(r.action));
+            }
+            (r.content?.accept === false ? rejected : accepted).push(h.id);
+        }
+    }
+    return answer(ask, "answered", { accepted, rejected });
+}
+/** How many elicitInputs an ask compiles to on the elicitation tier. */
+export function askInputCount(ask) {
+    if (ask.type === "ask_code_diff") {
+        return ask.spec.files.reduce((n, f) => n + (f.hunks?.length ?? 0), 0);
+    }
+    return 1;
+}
+/**
+ * The legacy whole-set runner — kept as a thin wrapper over the new
+ * per-ask compile + decode primitives, used by tests and adapters that
+ * want a one-call "drive the elicitation tier end-to-end" path.
+ */
+export async function runElicitation(set, elicit) {
+    const out = [];
+    for (const ask of set.asks) {
+        const inputs = compileAskToInputs(ask);
+        const responses = [];
+        for (const params of inputs) {
+            const r = await elicit(params);
+            responses.push(r);
+            // Mirror the per-hunk early-exit for ask_code_diff: stop on the
+            // first non-accept so we don't keep asking after the user
+            // declines (SPEC §7.4). For other asks there's only one input
+            // anyway, so the early-exit is a no-op.
+            if (r.action !== "accept" && ask.type === "ask_code_diff")
+                break;
+        }
+        out.push(decodeAskAnswer(ask, responses));
+    }
+    return out;
+}
+function statusFor(action) {
+    return action === "accept"
+        ? "answered"
+        : action === "decline"
+            ? "declined"
+            : "deferred";
+}
+function msg(ask) {
+    return ask.help ? `${ask.prompt}\n\n${ask.help}` : ask.prompt;
+}
+function answer(ask, status, value) {
+    return {
+        id: ask.id,
+        type: ask.type,
+        status,
+        ...(status === "answered" ? { value } : {}),
+        meta: { tier: "elicitation", specVersion: ask.meta?.specVersion },
+    };
+}
+/** Read the `value` (or `accept`, for ask_code_diff) field from the
+ *  elicitInput response, normalising ask_rank's degraded
+ *  comma-separated-string fallback into the canonical id[] permutation. */
+function readValue(ask, r) {
+    if (ask.type === "ask_rank") {
+        const raw = r.content?.value;
+        return Array.isArray(raw)
+            ? raw.map((x) => String(x))
+            : String(raw ?? "")
+                .split(/[,\s]+/)
+                .map((x) => x.trim())
+                .filter(Boolean);
+    }
+    return r.content?.value;
+}
+//# sourceMappingURL=elicitation.js.map

package/dist/elicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { renderApps } from "./apps.js";
+export { renderUrl } from "./url.js";
+export { renderTui } from "./tui.js";
+export { runElicitation, compileAskToInputs, decodeAskAnswer, askInputCount, } from "./elicitation.js";
+export { buildPanelHtml, SAFE_COLOR_PATTERN, SAFE_COLOR_RE } from "./panel.js";
+export type { PanelOptions } from "./panel.js";
+export type { RenderedPanel, UiBlock, ElicitFn, ElicitParams, ElicitResult, ElicitFormProperty, } from "./contract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { renderApps } from "./apps.js";
+export { renderUrl } from "./url.js";
+export { renderTui } from "./tui.js";
+export { runElicitation, compileAskToInputs, decodeAskAnswer, askInputCount, } from "./elicitation.js";
+export { buildPanelHtml, SAFE_COLOR_PATTERN, SAFE_COLOR_RE } from "./panel.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/panel.d.ts

@@ -0,0 +1,36 @@
+import type { AskSet, Tier } from "@elicitkit/core";
+/**
+ * The ONE canonical safe-color grammar — identical to the JSON Schema
+ * `safeColor` pattern, the conformance corpus, and SPEC §7.y. Accepts
+ * `#hex` (3/4/6/8), a CSS named/keyword color, and the common functional
+ * notations with a safe inner charset; it structurally cannot express
+ * `url(`, `var(`, `image-set(`, `element(`, gradients, quotes, `;`, or a
+ * nested `(` — i.e. no CSS value-injection / exfiltration / breakout. Held
+ * as a string so it round-trips through `jsonForScript` into the panel
+ * script with layer-proof escaping (regex literals in a template string
+ * mangle backslashes; a JSON string + `new RegExp` does not).
+ */
+export declare const SAFE_COLOR_PATTERN = "^(?:#[0-9a-fA-F]{3,8}|[a-zA-Z]+|(?:rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color)\\([0-9a-zA-Z.,%/ +\\-]*\\))$";
+export declare const SAFE_COLOR_RE: RegExp;
+/**
+ * The shared interactive panel HTML used by the `apps` and `url` tiers (one
+ * source of truth for rich rendering). The DOM is built client-side from
+ * embedded JSON via textContent, so ask content can never inject markup.
+ * Icons are a curated, static inline-SVG set keyed by name — never sourced
+ * from ask content (unknown names fall back to textContent). Self-contained,
+ * dependency-free, CSP-safe (inline CSS/JS only).
+ *
+ * Display is progressively enhanced and fully backward-compatible:
+ *  - `set.meta.layout`: "auto" (default) | "single" | "grid"
+ *  - `ask.meta.span`:   "half" | "full"  (overrides the auto heuristic)
+ *  - `ask.spec.display` (ask_select): "list" | "cards" | "segmented" | "grid"
+ *  - `option.icon` / `option.color`: optional per-option adornments
+ * Older renderers ignore all of the above and still render correctly.
+ */
+export interface PanelOptions {
+    /** If set, the panel POSTs `{token,answers}` here (hosted url tier) in
+     *  addition to the mcp-ui postMessage + copy-paste fallbacks. */
+    submitUrl?: string;
+}
+export declare function buildPanelHtml(set: AskSet, token: string, tier: Tier, opts?: PanelOptions): string;
+//# sourceMappingURL=panel.d.ts.map

package/dist/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,qHACqF,CAAC;AACrH,eAAO,MAAM,aAAa,QAAiC,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B;qEACiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,YAAiB,GACtB,MAAM,CAklBR"}