@candor-ui/react 1.0.0 → 1.0.1

package/dist/adapters/ag-ui.js

@@ -1,5 +1,5 @@
 import { EventType } from "@ag-ui/core";
-import { markdownBlocks } from "../lib/safe-markdown.js";
+import { markdownBlocks, plainBlocks } from "../lib/safe-markdown.js";
 /**
  * Turns AG-UI events into Candor messages, waiting approvals and usage.
  * Pure (given `now`), so it can run on every render; useAgUi calls it for you.
@@ -58,7 +58,7 @@ export function fromAgUiEvents(events, options) {
             continue;
         switch (e.type) {
             case "candor_user":
-                turns.push({ user: { id: e.id, author: { role: "user" }, status: "complete", blocks: markdownBlocks(e.text) } });
+                turns.push({ user: { id: e.id, author: { role: "user" }, status: "complete", blocks: plainBlocks(e.text) } });
                 break;
             case "candor_answer": {
                 answers.set(e.interruptId, { approved: e.approved, reason: e.reason });
@@ -261,7 +261,7 @@ function applySnapshot(previous, snapshot) {
         if (m.subagentRunId)
             continue;
         if (m.role === "user") {
-            turns.push({ user: { id: m.id, author: { role: "user" }, status: "complete", blocks: markdownBlocks(resultText(m.content)) }, reply: byUser.get(m.id) });
+            turns.push({ user: { id: m.id, author: { role: "user" }, status: "complete", blocks: plainBlocks(resultText(m.content)) }, reply: byUser.get(m.id) });
             continue;
         }
         if (m.role !== "assistant" && m.role !== "tool" && m.role !== "reasoning")

package/dist/adapters/ai-sdk.d.ts

@@ -1,7 +1,7 @@
 import type { UIMessage } from "ai";
 import type { AgentIdentity, Message } from "../lib/chat.js";
-import { inline, markdownBlocks } from "../lib/safe-markdown.js";
-export { inline, markdownBlocks };
+import { inline, markdownBlocks, plainBlocks } from "../lib/safe-markdown.js";
+export { inline, markdownBlocks, plainBlocks };
 export type FromAiSdkOptions = {
     /** Who the assistant is. Candor always names the agent. */
     agent: AgentIdentity;

package/dist/adapters/ai-sdk.js

@@ -1,6 +1,6 @@
-import { inline, markdownBlocks } from "../lib/safe-markdown.js";
-// Re-exported for apps that used them from here. (Imported first: shadcn rewrites import paths, not export-from paths.)
-export { inline, markdownBlocks };
+import { inline, markdownBlocks, plainBlocks } from "../lib/safe-markdown.js";
+// Re-exported for apps that use them from here. (Imported first: shadcn rewrites import paths, not export-from paths.)
+export { inline, markdownBlocks, plainBlocks };
 /** Convert a whole useChat message list. */
 export function fromAiSdkMessages(messages, options) {
     const lastAssistant = messages.findLastIndex((m) => m.role === "assistant");
@@ -26,17 +26,18 @@ export function fromAiSdkMessage(message, options) {
         flushTools();
         switch (part.type) {
             case "text":
-                blocks.push(...markdownBlocks(part.text));
+                // A person's own words are kept as typed; only the assistant's text is read as markdown.
+                blocks.push(...(message.role === "user" ? plainBlocks(part.text) : markdownBlocks(part.text)));
                 break;
             case "reasoning":
                 if (part.text.trim())
                     reasoning.push(reasoningEntry(part.id ?? `r${reasoning.length}`, part.text, part.state === "streaming"));
                 break;
             case "source-url":
-                sources.push({ id: part.sourceId, marker: sources.length + 1, kind: "doc", label: part.title ?? part.url, origin: host(part.url) });
+                sources.push({ id: part.sourceId, marker: sources.length + 1, kind: "web", label: part.title ?? part.url, origin: host(part.url) });
                 break;
             case "source-document":
-                sources.push({ id: part.sourceId, marker: sources.length + 1, kind: "doc", label: part.title, origin: part.filename });
+                sources.push({ id: part.sourceId, marker: sources.length + 1, kind: "document", label: part.title, origin: part.filename });
                 break;
             case "file":
                 blocks.push({ kind: "paragraph", nodes: [{ kind: "text", text: "Attached " }, { kind: "code", text: part.filename ?? part.mediaType }] });

package/dist/adapters/claude-agent-sdk.js

@@ -1,4 +1,4 @@
-import { markdownBlocks } from "../lib/safe-markdown.js";
+import { markdownBlocks, plainBlocks } from "../lib/safe-markdown.js";
 /**
  * Turns Claude Agent SDK events into Candor messages, waiting approvals and usage.
  * Pure, so it can run on every render; useClaudeAgent calls it for you.
@@ -26,7 +26,7 @@ export function fromClaudeAgentEvents(events, options) {
         switch (e.type) {
             case "candor_user":
                 close(false);
-                messages.push({ id: e.id, author: { role: "user" }, status: "complete", blocks: markdownBlocks(e.text) });
+                messages.push({ id: e.id, author: { role: "user" }, status: "complete", blocks: plainBlocks(e.text) });
                 notice = undefined;
                 break;
             case "candor_approval": {

package/dist/chat/message-content.js

@@ -28,6 +28,7 @@ function Inline({ nodes, }) {
                     return _jsx("em", { children: n.text }, i);
                 case "code":
                     return (_jsx("code", { className: "rounded-xs bg-muted px-1 py-px font-mono text-[0.88em]", children: n.text }, i));
+                case "measured":
                 case "orgData":
                     return (_jsx("span", { title: n.source ? `From the ${terms.environment}: ${n.source}` : `From the ${terms.environment}`, className: "font-medium tabular-nums text-foreground", children: n.text }, i));
                 case "provisional":
@@ -50,6 +51,15 @@ function Block({ block, }) {
     switch (block.kind) {
         case "paragraph":
             return (_jsx("p", { children: _jsx(Inline, { nodes: block.nodes }) }));
+        case "plain":
+            return _jsx("p", { className: "whitespace-pre-wrap break-words", children: block.text });
+        case "heading": {
+            // Levels are relative to the message: the thread page owns h1 and h2.
+            // Blocks can arrive as JSON, so an out-of-range level is clamped rather than trusted.
+            const level = Math.min(Math.max(Math.round(block.level) || 1, 1), 3);
+            const H = ["h3", "h4", "h5"][level - 1];
+            return (_jsx(H, { className: cn("font-semibold tracking-tight text-foreground", level === 1 ? "mt-1 text-lg" : level === 2 ? "mt-1 text-base" : "text-sm"), children: _jsx(Inline, { nodes: block.nodes }) }));
+        }
         case "list": {
             const List = block.ordered ? "ol" : "ul";
             return (_jsx(List, { className: cn("flex flex-col gap-1 pl-5", block.ordered ? "list-decimal" : "list-disc marker:text-faint-foreground"), children: block.items.map((item, i) => (_jsx("li", { className: "pl-0.5", children: _jsx(Inline, { nodes: item }) }, i))) }));
@@ -90,7 +100,10 @@ export function blocksToText(blocks, sources = []) {
         .map((b) => {
         switch (b.kind) {
             case "paragraph":
+            case "heading":
                 return inline(b.nodes);
+            case "plain":
+                return b.text;
             case "list":
                 return b.items.map((it, i) => `${b.ordered ? `${i + 1}.` : "-"} ${inline(it)}`).join("\n");
             case "payload":

package/dist/lib/chat.d.ts

@@ -65,6 +65,12 @@ export type InlineNode = {
     text: string;
 }
 /** A value read from the environment (a count, a setting). Shown with its source on hover. */
+ | {
+    kind: "measured";
+    text: string;
+    source?: string;
+}
+/** @deprecated Renamed `measured`; still rendered the same way until 2.0. */
  | {
     kind: "orgData";
     text: string;
@@ -136,6 +142,20 @@ export type PayloadLanguage = string;
 export type MessageBlock = {
     kind: "paragraph";
     nodes: InlineNode[];
+}
+/**
+ * Text exactly as someone typed it: line breaks and spacing kept, nothing parsed. For a person's own words, so
+ * `*this*` stays `*this*` and a pasted list keeps its lines.
+ */
+ | {
+    kind: "plain";
+    text: string;
+}
+/** A heading inside a reply. Levels are relative to the message, 1 the largest; the page's own headings sit above. */
+ | {
+    kind: "heading";
+    level: 1 | 2 | 3;
+    nodes: InlineNode[];
 } | {
     kind: "list";
     ordered?: boolean;

package/dist/lib/safe-markdown.d.ts

@@ -1,7 +1,12 @@
 import type { InlineNode, MessageBlock } from "./chat.js";
 /**
- * Reads model text as safe markdown: paragraphs, lists and fenced code. Never HTML.
+ * Reads model text as safe markdown: paragraphs, lists and fenced code. Never HTML. `#` lines are bold paragraphs
+ * unless `headings` is set, when `#`, `##` and `###` (and deeper, as level 3) become heading blocks.
  */
-export declare function markdownBlocks(text: string): MessageBlock[];
+export declare function markdownBlocks(text: string, { headings }?: {
+    headings?: boolean;
+}): MessageBlock[];
 /** `code`, **strong**, *em* and links (as text). Everything else stays literal. */
 export declare function inline(text: string): InlineNode[];
+/** A person's own words as one block, exactly as typed. Adapters use this for user messages: what someone typed is never read as markdown. */
+export declare function plainBlocks(text: string): MessageBlock[];

package/dist/lib/safe-markdown.js

@@ -7,9 +7,10 @@
  */
 const fenceLanguage = (lang) => (lang === "json" ? "json" : lang === "xml" || lang === "html" ? "xml" : "text");
 /**
- * Reads model text as safe markdown: paragraphs, lists and fenced code. Never HTML.
+ * Reads model text as safe markdown: paragraphs, lists and fenced code. Never HTML. `#` lines are bold paragraphs
+ * unless `headings` is set, when `#`, `##` and `###` (and deeper, as level 3) become heading blocks.
  */
-export function markdownBlocks(text) {
+export function markdownBlocks(text, { headings = false } = {}) {
     const blocks = [];
     const lines = text.replace(/\r\n/g, "\n").split("\n");
     let para = [];
@@ -53,10 +54,12 @@ export function markdownBlocks(text) {
             continue;
         }
         flushList();
-        const heading = /^\s*#{1,6}\s+(.*)$/.exec(line);
+        const heading = /^\s*(#{1,6})\s+(.*)$/.exec(line);
         if (heading) {
             flushPara();
-            blocks.push({ kind: "paragraph", nodes: [{ kind: "strong", text: heading[1] }] });
+            blocks.push(headings
+                ? { kind: "heading", level: Math.min(heading[1].length, 3), nodes: inline(heading[2]) }
+                : { kind: "paragraph", nodes: [{ kind: "strong", text: heading[2] }] });
             continue;
         }
         para.push(line.replace(/^\s*>\s?/, "").trim());
@@ -87,3 +90,9 @@ export function inline(text) {
         nodes.push({ kind: "text", text: text.slice(at) });
     return nodes;
 }
+/** A person's own words as one block, exactly as typed. Adapters use this for user messages: what someone typed is never read as markdown. */
+export function plainBlocks(text) {
+    // Blank lines at the ends would show as empty space in the bubble; inside, they're the person's.
+    const t = text.replace(/\r\n/g, "\n").replace(/^\n+|\n+$/g, "");
+    return t.trim() ? [{ kind: "plain", text: t }] : [];
+}

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@candor-ui/react",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Candor UI's free tier as an npm package: React components for agents that do real work, on shadcn/ui and Tailwind 4.",
   "license": "MIT",
   "author": "Methodic LLC",
   "homepage": "https://candor.themethodic.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/MethodicDev/candor-ui.git",
-    "directory": "packages/react"
+    "url": "git+https://github.com/MethodicDev/candor.git"
   },
   "keywords": ["react", "agent", "chat", "ai", "shadcn", "tailwindcss", "claude", "ai-sdk", "ag-ui"],
   "type": "module",