@webless/agent 0.8.0 → 0.9.1

package/README.md

@@ -12,7 +12,6 @@ Sign up at [app.webless.ai](https://app.webless.ai).
 
 An index is the content your agent answers from. Add your sources (URLs, sitemaps, docs), then publish the index.
 
-
 ### 3. Configure your agent in Agent Studio
 
 Open **Agent Studio** for your index. Customize the launcher position, appearance, and behavior, then build a preview bundle.
@@ -27,13 +26,14 @@ After building the bundle, copy the **install snippet** — a single script tag:
 
 Paste it into your site's HTML, before the closing `</body>` tag. That's the full integration.
 
-
 ## What you get
 
 - A collapsible Agent panel on your site.
 - Edge tab launcher, positioned where you configure it in Agent Studio.
 - Session continuity for returning visitors.
 - Search & Discovery source cards and call-to-action links beneath each answer, retained in the current browser session history. Sources without a usable web URL stay readable; unavailable action links are omitted.
+- Connected actions show task-focused progress and confirmed results. Receipts stay with the answer in the conversation.
+- Long answers keep their beginning visible; source links are collapsed until opened.
 - Page content shifts to make room for the desktop side rail.
 
 ## Preview before you install
@@ -54,11 +54,45 @@ import "@webless/agent/react.css";
 
 <AgentTranscript
   messages={[
-    { id: "1", role: "visitor", text: "Can I book a demo?", createdAt: 1789056000000 },
-    { id: "2", role: "agent", text: "What day works for you?", createdAt: 1789056001000 },
+    {
+      id: "1",
+      role: "visitor",
+      text: "Can I book a demo?",
+      createdAt: 1789056000000,
+    },
+    {
+      id: "2",
+      role: "agent",
+      text: "What day works for you?",
+      createdAt: 1789056001000,
+    },
   ]}
   colorScheme="light"
-/>
+/>;
 ```
 
 The host owns fetching, authorization, pagination, scrolling, and review controls. Pass `ConversationMessage` snapshots with stable IDs and millisecond timestamps. Optional `theme`, `agentLabel`, `visitorLabel`, `label`, and `formatTimestamp` props adapt the presentation to the host. Timestamps default to UTC. Structured references render when supplied in the message; the component does not fetch missing history or tool results.
+
+Pass `activities` alongside `messages` to include recorded tool calls and specialist routing. Entries are ordered by their timestamps. Tool result details expand locally; forms and booking controls remain disabled. No runtime connection is created.
+
+```tsx
+<AgentTranscript
+  messages={messages}
+  activities={[
+    {
+      id: "handoff-1",
+      callId: "specialist-1",
+      createdAt: 1789084800000,
+      category: "specialist",
+      label: "Product specialist",
+      status: "completed",
+    },
+  ]}
+/>
+```
+
+Use `presentTranscriptToolResult` from `@webless/agent/presentation` on the server to project stored tool output into the SDK's visitor-facing result cards. This entry point contains no React or CSS imports. Only send the projected presentation to a browser; keep raw tool arguments, provider payloads, and internal prompts server-side. Historical provider errors are represented as failures even when the runtime execution status was completed.
+
+### Custom composer submit handlers
+
+When using `AgentRail` directly, forward both arguments from `onSubmit(message, options)` to the chat controller. `message` is the visitor-visible text; `options.runtimeText` carries form submissions and the visitor's decision to skip a details form. A form submission uses an empty `message` so the transcript shows one collapsed confirmation instead of echoing the fields. Keep that runtime context out of the visible transcript.