orchid-ai 2.0.1 → 2.0.3

package/orchid-ai.css

@@ -244,6 +244,9 @@
   border: 1px solid #e5e7eb;
   border-radius: 12px;
   padding: 16px 20px;
+  width: 100%;
+  max-width: 420px;
+  box-sizing: border-box;
 }
 
 .ai-chat-suggestions span {
@@ -260,6 +263,7 @@
   display: flex;
   flex-direction: column;
   gap: 8px;
+  padding: 0;
 }
 
 .ai-chat-suggestions li {
@@ -271,6 +275,8 @@
   border-radius: 8px;
   cursor: pointer;
   transition: background 0.15s, border-color 0.15s, color 0.15s;
+  width: 100%;
+  box-sizing: border-box;
 }
 
 .ai-chat-suggestions li:hover {
@@ -279,6 +285,17 @@
   color: #1eaaf1;
 }
 
+.ai-chat-suggestions--disabled li {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.ai-chat-suggestions--disabled li:hover {
+  background: #f9fafb;
+  border-color: #e5e7eb;
+  color: #4b5563;
+}
+
 /* ── Messages ── */
 
 .ai-chat-message {
@@ -347,6 +364,16 @@
   border-bottom-right-radius: 4px;
 }
 
+.ai-chat-bubble.user .ai-chat-user-link {
+  color: #e0f2fe;
+  text-decoration: underline;
+  word-break: break-all;
+}
+
+.ai-chat-bubble.user .ai-chat-user-link:hover {
+  color: #ffffff;
+}
+
 .ai-chat-bubble.assistant {
   position: relative;
   background: #ffffff;
@@ -355,6 +382,323 @@
   border-bottom-left-radius: 4px;
 }
 
+/* ── Tool / preamble trace (Claude-style timeline, light theme) ── */
+
+.ai-chat-process-trace {
+  --ai-process-bg: #f4f6f8;
+  --ai-process-border: #e4e8ed;
+  --ai-process-rail: #d8dde4;
+  --ai-process-text: #5c6570;
+  --ai-process-text-strong: #2d3748;
+  --ai-process-dot: #9aa5b1;
+  --ai-process-dot-tool: #059669;
+  --ai-process-dot-compile: #4f46e5;
+  --ai-process-dot-mind: #94a3b8;
+  --ai-process-interim-fg: #475569;
+
+  margin: 0 0 12px;
+  border-radius: 12px;
+  border: 1px solid transparent;
+  background: transparent;
+  box-shadow: none;
+  font-size: 12.5px;
+  line-height: 1.45;
+  color: var(--ai-process-text);
+  overflow: visible;
+  transition:
+    background 0.22s ease,
+    border-color 0.22s ease,
+    box-shadow 0.22s ease;
+}
+
+/* Collapsed: no chrome — summary reads as muted underlined text on the bubble background */
+.ai-chat-process-trace:not([open]) {
+  overflow: visible;
+}
+
+.ai-chat-process-trace[open] {
+  overflow: hidden;
+  border-color: var(--ai-process-border);
+  background: linear-gradient(165deg, var(--ai-process-bg) 0%, #eef1f4 100%);
+  box-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
+}
+
+.ai-chat-process-trace__summary {
+  cursor: pointer;
+  list-style: none;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 4px 0 10px;
+  margin: 0;
+  font-weight: 500;
+  font-size: 13px;
+  letter-spacing: 0.01em;
+  text-transform: none;
+  color: #6b7280;
+  text-decoration: none;
+  user-select: none;
+  background: transparent;
+  border-bottom: none;
+  transition:
+    color 0.18s ease,
+    padding 0.2s ease,
+    font-size 0.2s ease,
+    font-weight 0.2s ease,
+    letter-spacing 0.2s ease,
+    background 0.22s ease,
+    border-color 0.22s ease;
+}
+
+/* Collapsed: underline only the label — chevron / dots sit beside it, not underlined */
+.ai-chat-process-trace:not([open]) > .ai-chat-process-trace__summary {
+  gap: 5px;
+  width: fit-content;
+  max-width: 100%;
+}
+
+.ai-chat-process-trace:not([open]) > .ai-chat-process-trace__summary:hover {
+  color: #4b5563;
+}
+
+.ai-chat-process-trace:not([open]) > .ai-chat-process-trace__summary:hover .ai-chat-process-trace__summary-text {
+  text-decoration-color: #4b5563;
+}
+
+.ai-chat-process-trace:not([open]) > .ai-chat-process-trace__summary:focus-visible {
+  outline: 2px solid #93c5fd;
+  outline-offset: 2px;
+  border-radius: 4px;
+}
+
+/* Expanded: restore panel header strip inside the tinted card */
+.ai-chat-process-trace[open] > .ai-chat-process-trace__summary {
+  padding: 10px 14px;
+  font-weight: 600;
+  font-size: 12px;
+  letter-spacing: 0.02em;
+  text-transform: uppercase;
+  color: var(--ai-process-text-strong);
+  text-decoration: none;
+  background: rgba(255, 255, 255, 0.45);
+  border-bottom: 1px solid var(--ai-process-border);
+}
+
+.ai-chat-process-trace__summary::-webkit-details-marker {
+  display: none;
+}
+
+.ai-chat-process-trace__summary-text {
+  flex: 1;
+  text-decoration: none;
+}
+
+.ai-chat-process-trace:not([open]) .ai-chat-process-trace__summary-text {
+  flex: 0 1 auto;
+  text-decoration: underline;
+  text-underline-offset: 3px;
+  text-decoration-thickness: 1px;
+  transition: text-decoration-color 0.18s ease;
+}
+
+.ai-chat-process-trace[open] .ai-chat-process-trace__summary-text {
+  flex: 1;
+  text-decoration: none;
+}
+
+/* Single expand chevron (right); hidden while streaming — dots replace it. */
+.ai-chat-process-trace__summary-chevron {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  min-width: 1.25em;
+  font-size: 15px;
+  font-weight: 700;
+  line-height: 1;
+  opacity: 0.55;
+  text-decoration: none;
+  transition: transform 0.18s ease, opacity 0.15s ease;
+}
+
+.ai-chat-process-trace:not([open]) .ai-chat-process-trace__summary-chevron {
+  opacity: 0.45;
+  min-width: auto;
+}
+
+.ai-chat-process-trace:not([open]) .ai-chat-process-trace__mini-typing span {
+  opacity: 0.72;
+}
+
+.ai-chat-process-trace[open] > .ai-chat-process-trace__summary .ai-chat-process-trace__summary-chevron {
+  transform: rotate(90deg);
+  opacity: 0.78;
+}
+
+.ai-chat-process-trace__mini-typing {
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
+  gap: 3px;
+}
+
+.ai-chat-process-trace__mini-typing span {
+  width: 4px;
+  height: 4px;
+  border-radius: 50%;
+  background: var(--ai-process-dot-tool);
+  opacity: 0.85;
+  animation: ai-chat-process-mini-dot 1.05s ease-in-out infinite;
+}
+
+.ai-chat-process-trace__mini-typing span:nth-child(2) {
+  animation-delay: 0.12s;
+}
+
+.ai-chat-process-trace__mini-typing span:nth-child(3) {
+  animation-delay: 0.24s;
+}
+
+@keyframes ai-chat-process-mini-dot {
+  0%,
+  80%,
+  100% {
+    transform: translateY(0);
+    opacity: 0.35;
+  }
+  40% {
+    transform: translateY(-2px);
+    opacity: 1;
+  }
+}
+
+@keyframes ai-chat-process-pulse {
+  0% {
+    box-shadow: 0 0 0 0 rgba(5, 150, 105, 0.35);
+  }
+  70% {
+    box-shadow: 0 0 0 6px rgba(5, 150, 105, 0);
+  }
+  100% {
+    box-shadow: 0 0 0 0 rgba(5, 150, 105, 0);
+  }
+}
+
+.ai-chat-process-trace__panel {
+  padding: 10px 12px 12px 8px;
+}
+
+.ai-chat-process-trace__timeline {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.ai-chat-process-trace__step {
+  display: flex;
+  align-items: stretch;
+  gap: 10px;
+  margin: 0;
+  padding: 0 0 14px;
+}
+
+.ai-chat-process-trace__step:last-child {
+  padding-bottom: 0;
+}
+
+.ai-chat-process-trace__rail {
+  position: relative;
+  width: 18px;
+  flex-shrink: 0;
+  display: flex;
+  justify-content: center;
+  padding-top: 4px;
+}
+
+.ai-chat-process-trace__rail::after {
+  content: "";
+  position: absolute;
+  top: 13px;
+  bottom: -14px;
+  left: 50%;
+  width: 1px;
+  transform: translateX(-50%);
+  background: var(--ai-process-rail);
+}
+
+.ai-chat-process-trace__step:last-child .ai-chat-process-trace__rail::after {
+  display: none;
+}
+
+.ai-chat-process-trace__dot {
+  position: relative;
+  z-index: 1;
+  width: 7px;
+  height: 7px;
+  border-radius: 50%;
+  background: var(--ai-process-dot);
+  box-shadow: 0 0 0 2px rgba(255, 255, 255, 0.85);
+}
+
+.ai-chat-process-trace__step--tool .ai-chat-process-trace__dot {
+  background: var(--ai-process-dot-tool);
+}
+
+.ai-chat-process-trace__step--compile .ai-chat-process-trace__dot {
+  background: var(--ai-process-dot-compile);
+}
+
+.ai-chat-process-trace__step--mind .ai-chat-process-trace__dot {
+  background: var(--ai-process-dot-mind);
+}
+
+.ai-chat-process-trace__step--text .ai-chat-process-trace__dot {
+  background: var(--ai-process-dot);
+}
+
+.ai-chat-process-trace__step--interim .ai-chat-process-trace__dot {
+  background: var(--ai-process-dot);
+  animation: ai-chat-process-pulse 1.4s ease-out infinite;
+}
+
+.ai-chat-process-trace__step--live .ai-chat-process-trace__dot {
+  animation: ai-chat-process-pulse 1.2s ease-out infinite;
+}
+
+.ai-chat-process-trace__body {
+  flex: 1;
+  min-width: 0;
+  padding-top: 1px;
+}
+
+.ai-chat-process-trace__line {
+  display: block;
+  color: var(--ai-process-text-strong);
+  font-weight: 500;
+}
+
+.ai-chat-process-trace__step--tool .ai-chat-process-trace__line {
+  color: #047857;
+}
+
+.ai-chat-process-trace__step--compile .ai-chat-process-trace__line {
+  color: #4338ca;
+}
+
+.ai-chat-process-trace__prose {
+  margin: 0;
+  white-space: pre-wrap;
+  word-break: break-word;
+  color: var(--ai-process-interim-fg);
+  font-weight: 400;
+}
+
+.ai-chat-process-trace__step--interim .ai-chat-process-trace__prose {
+  border-left: 2px solid var(--ai-process-rail);
+  padding-left: 10px;
+  margin-left: 2px;
+}
+
 /* ── Markdown Typography (assistant bubbles) ── */
 
 .ai-chat-bubble.assistant p {
@@ -1789,6 +2133,29 @@
   animation-delay: 0.4s;
 }
 
+/* Smaller dots for inline status (next to “Compiling…”) */
+.ai-chat-typing--inline {
+  gap: 4px;
+  padding: 0;
+}
+
+.ai-chat-typing--inline span {
+  width: 5px;
+  height: 5px;
+}
+
+.ai-chat-streaming-status {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+  margin-bottom: 8px;
+}
+
+.ai-chat-streaming-status .ai-chat-status-text {
+  margin: 0;
+}
+
 @keyframes typing {
   0%,
   60%,
@@ -1802,6 +2169,48 @@
   }
 }
 
+/* ── Building Block (streaming code-block placeholder) ── */
+
+.ai-building-block {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+  padding: 8px 12px;
+  border-radius: 8px;
+  margin: 6px 0 0;
+  background: #f3f4f6;
+  border: 1px solid #e5e7eb;
+}
+
+.ai-building-block__label {
+  font-size: 13px;
+  font-weight: 600;
+  color: #4b5563;
+}
+
+.ai-building-block__dots {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.ai-building-block__dot {
+  width: 5px;
+  height: 5px;
+  border-radius: 50%;
+  background: #9ca3af;
+  animation: typing 1.4s infinite;
+}
+
+.ai-building-block__dots .ai-building-block__dot:nth-child(2) {
+  animation-delay: 0.2s;
+}
+
+.ai-building-block__dots .ai-building-block__dot:nth-child(3) {
+  animation-delay: 0.4s;
+}
+
 /* ── Input Area ── */
 
 .ai-chat-input-form {
@@ -1917,47 +2326,61 @@
 /* ── Print (Single Response) ── */
 
 @media print {
-  @page {
-    margin: 12mm;
+  @page { margin: 12mm; }
+
+  /*
+   * visibility:hidden on body allows #ai-cortex-print-section descendants to
+   * override with visibility:visible — this is a CSS guarantee that display:none
+   * does NOT offer (Chrome's print engine ignores the specificity override for
+   * display:none !important on body > *).
+   *
+   * Siblings are collapsed to height:0 so no blank space precedes the section.
+   * position:absolute (not fixed) allows content to paginate across pages.
+   */
+  body.ai-chat-printing {
+    visibility: hidden !important;
+    position: relative !important;
   }
 
-  /* Hide everything on the page; show only the isolated print section. */
-  body.ai-chat-printing > * {
-    display: none !important;
+  body.ai-chat-printing > *:not(#ai-cortex-print-section) {
+    height: 0 !important;
+    overflow: hidden !important;
   }
 
   body.ai-chat-printing #ai-cortex-print-section {
+    visibility: visible !important;
     display: block !important;
+    position: absolute !important;
+    top: 0 !important;
+    left: 0 !important;
+    width: 100% !important;
+    padding: 0 !important;
+    background: #ffffff;
+    color: #1f2937;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    font-size: 14px;
+    line-height: 1.6;
   }
 
-  /*
-   * Kill all CSS animations and transitions inside the print section.
-   * Browsers reset animations during the print reflow, catching elements at
-   * their `from` keyframe (opacity: 0, scale: 0) rather than their final state.
-   * Disabling animations lets elements fall back to their base CSS styles,
-   * which are always the fully-visible final appearance.
-   *
-   * print-color-adjust: exact forces Chrome to render background colours and
-   * images — without it Chrome strips inline background fills (e.g. dot colours
-   * on scatter/dot charts) and the dots appear as white outlines only.
-   */
   body.ai-chat-printing #ai-cortex-print-section * {
+    visibility: visible !important;
     animation: none !important;
     transition: none !important;
+    /* Kill any opacity:0 left by a stopped animation */
+    opacity: 1 !important;
     -webkit-print-color-adjust: exact !important;
     print-color-adjust: exact !important;
   }
 
-  /* Clean up the bubble for print */
   body.ai-chat-printing #ai-cortex-print-section .ai-chat-bubble.assistant {
-    max-width: none;
-    width: 100%;
-    border: none;
-    border-radius: 0;
-    padding: 0;
-    background: #ffffff;
-    color: #111827;
-    box-shadow: none;
+    max-width: none !important;
+    width: 100% !important;
+    border: none !important;
+    border-radius: 0 !important;
+    padding: 0 !important;
+    background: #ffffff !important;
+    color: #1f2937 !important;
+    box-shadow: none !important;
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchid-ai",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Shared Orchid AI chat UI and visualization components",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/components/ChatWindow.jsx

@@ -1,8 +1,14 @@
 import React, { useRef, useEffect } from 'react';
 import Message from './Message';
 
+const DEFAULT_SUGGESTIONS = [
+  'Give me brief tips for navigating iLink.',
+  'What should I check before starting a dispatch?',
+  'How do I narrow down a search in Hermes command search (⌘K)?',
+];
+
 /**
- * Hermes chat window (Markdown + optional orchid-ai-chart fenced blocks).
+ * Orchid AI chat window (Markdown + optional orchid-ai-chart fenced blocks).
  */
 export default function ChatWindow({
   messages,
@@ -11,15 +17,24 @@ export default function ChatWindow({
   onSuggestionClick,
   aiEnabled,
   organisationName,
+  appName = "Hermes Chat",
+  unavailableMessage,
+  emptyDescription,
+  suggestions = DEFAULT_SUGGESTIONS,
+  suggestionsDisabled = false,
+  showProcessTracePanel = true,
 }) {
+  const exportPrefix = appName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
   const bottomRef = useRef(null);
 
   useEffect(() => {
     bottomRef.current?.scrollIntoView({ behavior: 'smooth' });
-  }, [messages, loading]);
+  }, [messages, loading, statusText]);
 
   const renderEmptyState = () => {
     if (!aiEnabled) {
+      const msg = unavailableMessage ??
+        `${appName} needs an Anthropic API key on the server. Contact your administrator if this persists.`;
       return (
         <div className="ai-chat-empty">
           <div className="ai-chat-empty-icon">
@@ -37,16 +52,14 @@ export default function ChatWindow({
               <line x1="4.93" y1="4.93" x2="19.07" y2="19.07" />
             </svg>
           </div>
-          <h2>Hermes Chat unavailable</h2>
-          <p>
-            Hermes Chat needs an Anthropic API key on the server and an active organisation. Contact your administrator
-            if this persists.
-          </p>
+          <h2>{appName} unavailable</h2>
+          <p>{msg}</p>
         </div>
       );
     }
 
     const scope = organisationName || 'your organisation';
+    const description = emptyDescription ?? `Ask about ${scope} — shipments, schedules, data insights, or what to explore next.`;
 
     return (
       <div className="ai-chat-empty">
@@ -67,32 +80,53 @@ export default function ChatWindow({
           </svg>
         </div>
         <h2>How can I help?</h2>
-        <p>{`Ask about ${scope} — jobs, routes, schedules, reminders, or what to explore next.`}</p>
-        <div className="ai-chat-suggestions">
-          <span>Try asking:</span>
-          <ul>
-            <li onClick={() => onSuggestionClick('Give me brief tips for navigating iLink.')}>
-              Give me brief tips for navigating iLink.
-            </li>
-            <li onClick={() => onSuggestionClick('What should I check before starting a dispatch?')}>
-              What should I check before starting a dispatch?
-            </li>
-            <li onClick={() => onSuggestionClick('How do I narrow down a search in Hermes command search (⌘K)?')}>
-              How do I narrow down a search in Hermes command search (⌘K)?
-            </li>
-          </ul>
-        </div>
+        <p>{description}</p>
+        {suggestions.length > 0 && (
+          <div className={`ai-chat-suggestions${suggestionsDisabled ? ' ai-chat-suggestions--disabled' : ''}`}>
+            <span>Try asking:</span>
+            <ul>
+              {suggestions.map((s) => (
+                <li
+                  key={s}
+                  onClick={suggestionsDisabled ? undefined : () => onSuggestionClick(s)}
+                  aria-disabled={suggestionsDisabled || undefined}
+                >
+                  {s}
+                </li>
+              ))}
+            </ul>
+          </div>
+        )}
       </div>
     );
   };
 
+  const lastMsg = messages?.[messages.length - 1];
+  const hasStreamingMessage = lastMsg?.isStreaming === true;
+
   return (
     <div className="ai-chat-window">
       {messages?.length === 0 && !loading && renderEmptyState()}
-      {(messages ?? []).map((msg, i) => (
-        <Message key={i} role={msg.role} content={msg.content} truncated={msg.truncated} />
-      ))}
-      {loading && (
+      {(messages ?? []).map((msg, i) => {
+        const isLast = i === (messages?.length ?? 0) - 1;
+        const streamingStatusText =
+          loading && isLast && msg.role === 'assistant' && msg.isStreaming ? statusText : undefined;
+        return (
+          <Message
+            key={i}
+            role={msg.role}
+            content={msg.content}
+            truncated={msg.truncated}
+            exportPrefix={exportPrefix}
+            isStreaming={msg.isStreaming}
+            streamingStatusText={streamingStatusText}
+            processTrace={msg.processTrace}
+            processInterimLive={msg.processInterimLive}
+            showProcessTracePanel={showProcessTracePanel}
+          />
+        );
+      })}
+      {loading && !hasStreamingMessage && (
         <div className="ai-chat-message assistant">
           <div className="ai-chat-avatar assistant">AI</div>
           <div className="ai-chat-bubble assistant">