@webless/agent 0.7.5 → 0.9.0

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { e as AgentIndexVersion, k as AgentPlacementConfig, d as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, X as VisitorToolResultRegistry, i as AgentMessageFeedback, T as ToolStep, m as AgentRailState, n as AgentRailTheme, H as ConversationMessage, h as AgentInputResponse, C as AgentToolUiSurface, v as AgentToolResultJsonValue, J as FollowUpSuggestion, l as AgentRailPhase, V as VisitorBooking } from './manifest-DgjT8-tW.js';
-export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, f as AgentInputOption, g as AgentInputRequest, o as AgentSearchReferences, p as AgentSearchSource, q as AgentStructuredToolInput, u as AgentToolResult, w as AgentToolUiAction, x as AgentToolUiField, y as AgentToolUiFieldKind, z as AgentToolUiOption, B as AgentToolUiStep, D as AssistEdgeTab, E as AssistTabSide, F as AssistTabVariant, G as Citation, I as DEFAULT_AGENT_PLACEMENT, K as JourneyContext, R as ResolvedVisitorToolResultPresentation, L as ToolStepState, M as VisitorBookingResultPresentation, O as VisitorSearchResultPresentation, P as VisitorToolInputResultPresentation, Q as VisitorToolResultLink, S as VisitorToolResultPresentation, U as VisitorToolResultPresenter, W as VisitorToolResultPresenterOutput, Y as builtInVisitorToolResultRegistry, Z as defaultAgentRailTheme, _ as defaultDarkAgentRailTheme, $ as formatAgentStructuredToolInput, a0 as normalizeAgentPlacement, a2 as presentVisitorToolResult } from './manifest-DgjT8-tW.js';
+import { e as AgentIndexVersion, k as AgentPlacementConfig, d as AgentColorScheme, c as AgentBrandingConfig, b as AgentAnalyticsConfig, X as VisitorToolResultRegistry, i as AgentMessageFeedback, T as ToolStep, m as AgentRailState, n as AgentRailTheme, H as ConversationMessage, h as AgentInputResponse, C as AgentToolUiSurface, v as AgentToolResultJsonValue, J as FollowUpSuggestion, l as AgentRailPhase, V as VisitorBooking, R as ResolvedVisitorToolResultPresentation } from './manifest-DgjT8-tW.js';
+export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, f as AgentInputOption, g as AgentInputRequest, o as AgentSearchReferences, p as AgentSearchSource, q as AgentStructuredToolInput, u as AgentToolResult, w as AgentToolUiAction, x as AgentToolUiField, y as AgentToolUiFieldKind, z as AgentToolUiOption, B as AgentToolUiStep, D as AssistEdgeTab, E as AssistTabSide, F as AssistTabVariant, G as Citation, I as DEFAULT_AGENT_PLACEMENT, K as JourneyContext, L as ToolStepState, M as VisitorBookingResultPresentation, O as VisitorSearchResultPresentation, P as VisitorToolInputResultPresentation, Q as VisitorToolResultLink, S as VisitorToolResultPresentation, U as VisitorToolResultPresenter, W as VisitorToolResultPresenterOutput, Y as builtInVisitorToolResultRegistry, Z as defaultAgentRailTheme, _ as defaultDarkAgentRailTheme, $ as formatAgentStructuredToolInput, a0 as normalizeAgentPlacement, a2 as presentVisitorToolResult } from './manifest-DgjT8-tW.js';
 
 type AgentWidgetProps = {
     indexId: string;
@@ -135,4 +135,27 @@ declare function buildAgentAnswerFeedbackEvent(input: {
  */
 declare function sendAgentAnswerFeedback(eventUrl: string, event: Record<string, unknown>): void;
 
-export { AGENT_ANSWER_FEEDBACK_EVENT_TYPE, AgentColorScheme, AgentInputResponse, AgentMessageFeedback, AgentPlacementConfig, AgentRail, AgentRailPhase, type AgentRailProps, AgentRailState, AgentRailTheme, AgentToolUiSurface, AgentWidget, type AgentWidgetProps, ConversationMessage, FollowUpSuggestion, MessageActions, ToolStep, type UseAgentChatOptions, VisitorToolResultRegistry, buildAgentAnswerFeedbackEvent, createIdleSuggestions, findPrecedingVisitorText, hasVisitorMessages, isAgentBusy, sendAgentAnswerFeedback, useAgentChat };
+type AgentTranscriptActivity = {
+    id: string;
+    createdAt: number;
+    callId: string;
+    category: "tool" | "specialist";
+    label: string;
+    status: "started" | "completed" | "failed" | "rejected";
+    result?: ResolvedVisitorToolResultPresentation;
+};
+
+type AgentTranscriptProps = {
+    messages: readonly ConversationMessage[];
+    activities?: readonly AgentTranscriptActivity[];
+    theme?: Partial<AgentRailTheme>;
+    colorScheme?: AgentColorScheme;
+    agentLabel?: string;
+    visitorLabel?: string;
+    label?: string;
+    formatTimestamp?: (createdAt: number) => string;
+};
+/** Renders a stored snapshot; never creates a session or exposes chat actions. */
+declare function AgentTranscript({ messages, activities, theme, colorScheme, agentLabel, visitorLabel, label, formatTimestamp, }: AgentTranscriptProps): react.JSX.Element;
+
+export { AGENT_ANSWER_FEEDBACK_EVENT_TYPE, AgentColorScheme, AgentInputResponse, AgentMessageFeedback, AgentPlacementConfig, AgentRail, AgentRailPhase, type AgentRailProps, AgentRailState, AgentRailTheme, AgentToolUiSurface, AgentTranscript, type AgentTranscriptActivity, type AgentTranscriptProps, AgentWidget, type AgentWidgetProps, ConversationMessage, FollowUpSuggestion, MessageActions, ResolvedVisitorToolResultPresentation, ToolStep, type UseAgentChatOptions, VisitorToolResultRegistry, buildAgentAnswerFeedbackEvent, createIdleSuggestions, findPrecedingVisitorText, hasVisitorMessages, isAgentBusy, sendAgentAnswerFeedback, useAgentChat };

package/dist/react.js

@@ -6,8 +6,13 @@ import {
   AgentRail,
   AgentWidget,
   AssistEdgeTab,
+  BookingCard,
   DEFAULT_AGENT_PLACEMENT,
   MessageActions,
+  MessageBubble,
+  SearchReferences,
+  VisitorToolResultView,
+  agentThemeStyle,
   buildAgentAnswerFeedbackEvent,
   builtInVisitorToolResultRegistry,
   createIdleSuggestions,
@@ -20,13 +25,169 @@ import {
   normalizeAgentPlacement,
   presentVisitorToolResult,
   sendAgentAnswerFeedback,
-  useAgentChat
-} from "./chunk-CD6TKXGT.js";
+  useAgentChat,
+  useAgentColorScheme
+} from "./chunk-QMTI5646.js";
+
+// src/react/components/AgentTranscript/TranscriptActivity.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var statusLabels = {
+  started: "No result recorded",
+  completed: "",
+  failed: "Failed",
+  rejected: "Rejected"
+};
+function RecordedResult({
+  result
+}) {
+  if (result.kind === "search") return /* @__PURE__ */ jsx(SearchReferences, { results: [result] });
+  if (result.kind === "booking") {
+    const card = result.card;
+    if (card.type === "booking_offer")
+      return /* @__PURE__ */ jsx(BookingCard, { readOnly: true, offer: card });
+    if (card.type === "booking_confirmed")
+      return /* @__PURE__ */ jsxs("p", { children: [
+        "Booking confirmed",
+        card.startTime ? ` \xB7 ${card.startTime}` : ""
+      ] });
+    if (card.type === "booking_canceled") return /* @__PURE__ */ jsx("p", { children: "Booking canceled" });
+    return /* @__PURE__ */ jsx("p", { children: "Information requested" });
+  }
+  return /* @__PURE__ */ jsx(VisitorToolResultView, { disabled: true, result });
+}
+function TranscriptActivity({
+  activity,
+  formatTimestamp
+}) {
+  const date = new Date(activity.createdAt);
+  const validTimestamp = Number.isFinite(date.getTime());
+  const result = activity.result?.kind === "hidden" ? void 0 : activity.result;
+  const heading = /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("span", { children: activity.category === "specialist" ? `Specialist \xB7 ${activity.label}` : activity.label }),
+    activity.status !== "completed" ? /* @__PURE__ */ jsx("span", { className: "agent-transcript__activity-status", children: statusLabels[activity.status] }) : null,
+    validTimestamp ? /* @__PURE__ */ jsx("time", { dateTime: date.toISOString(), children: formatTimestamp(activity.createdAt) }) : null
+  ] });
+  return /* @__PURE__ */ jsx("li", { className: "agent-transcript__activity", "data-status": activity.status, children: result ? /* @__PURE__ */ jsxs("details", { children: [
+    /* @__PURE__ */ jsx("summary", { className: "agent-transcript__activity-heading", children: heading }),
+    /* @__PURE__ */ jsx("div", { className: "agent-transcript__activity-result", children: /* @__PURE__ */ jsx(RecordedResult, { result }) })
+  ] }) : /* @__PURE__ */ jsx("div", { className: "agent-transcript__activity-heading", children: heading }) });
+}
+
+// src/react/components/AgentTranscript/group-activities.ts
+function groupTranscriptActivities(activities) {
+  const calls = /* @__PURE__ */ new Map();
+  for (const activity of activities) {
+    const key = `${activity.category}:${activity.callId}`;
+    const previous = calls.get(key);
+    if (!previous) {
+      calls.set(key, {
+        latest: activity,
+        id: activity.id,
+        startedAt: activity.createdAt,
+        label: activity.label
+      });
+      continue;
+    }
+    const previousHasResult = previous.latest.status !== "started";
+    const nextHasResult = activity.status !== "started";
+    const useNext = nextHasResult && !previousHasResult || nextHasResult === previousHasResult && activity.createdAt >= previous.latest.createdAt;
+    const latest = useNext ? activity : previous.latest;
+    calls.set(key, {
+      latest,
+      id: previous.id,
+      startedAt: Math.min(previous.startedAt, activity.createdAt),
+      label: activity.createdAt < previous.startedAt ? activity.label : previous.label
+    });
+  }
+  return [...calls.values()].map(({ latest, id, startedAt, label }) => ({
+    ...latest,
+    id,
+    label,
+    createdAt: startedAt
+  }));
+}
+
+// src/react/components/AgentTranscript/AgentTranscript.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var timestampFormat = new Intl.DateTimeFormat("en-US", {
+  month: "short",
+  day: "numeric",
+  hour: "numeric",
+  minute: "2-digit",
+  timeZone: "UTC"
+});
+function defaultTimestamp(createdAt) {
+  return `${timestampFormat.format(createdAt)} UTC`;
+}
+function AgentTranscript({
+  messages,
+  activities = [],
+  theme,
+  colorScheme,
+  agentLabel = "Agent",
+  visitorLabel = "Visitor",
+  label = "Conversation transcript",
+  formatTimestamp = defaultTimestamp
+}) {
+  const scheme = useAgentColorScheme(colorScheme);
+  const entries = [
+    ...messages.map((message) => ({ kind: "message", ...message })),
+    ...groupTranscriptActivities(activities).map((activity) => ({
+      kind: "activity",
+      ...activity
+    }))
+  ].sort((left, right) => left.createdAt - right.createdAt);
+  return /* @__PURE__ */ jsx2(
+    "ol",
+    {
+      className: "webless-agent-root agent-transcript not-typeset",
+      "data-not-typeset": "",
+      "data-color-scheme": scheme,
+      "aria-label": label,
+      style: agentThemeStyle(theme, scheme),
+      children: entries.map((message) => {
+        if (message.kind === "activity")
+          return /* @__PURE__ */ jsx2(
+            TranscriptActivity,
+            {
+              activity: message,
+              formatTimestamp
+            },
+            message.id
+          );
+        const date = new Date(message.createdAt);
+        const validTimestamp = Number.isFinite(date.getTime());
+        return /* @__PURE__ */ jsxs2(
+          "li",
+          {
+            className: `agent-transcript__message agent-transcript__message--${message.role}`,
+            children: [
+              /* @__PURE__ */ jsxs2("div", { className: "agent-transcript__meta", children: [
+                /* @__PURE__ */ jsx2("span", { children: message.role === "visitor" ? visitorLabel : agentLabel }),
+                validTimestamp ? /* @__PURE__ */ jsx2("time", { dateTime: date.toISOString(), children: formatTimestamp(message.createdAt) }) : null
+              ] }),
+              /* @__PURE__ */ jsx2(
+                MessageBubble,
+                {
+                  message: message.role === "agent" ? { ...message, streaming: false } : message,
+                  bookingReadOnly: true,
+                  bookingDisabled: true
+                }
+              )
+            ]
+          },
+          message.id
+        );
+      })
+    }
+  );
+}
 export {
   AGENT_ANSWER_FEEDBACK_EVENT_TYPE,
   AGENT_STRUCTURED_TOOL_INPUT_HEADER,
   AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION,
   AgentRail,
+  AgentTranscript,
   AgentWidget,
   AssistEdgeTab,
   DEFAULT_AGENT_PLACEMENT,

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/react/components/AgentTranscript/TranscriptActivity.tsx","../src/react/components/AgentTranscript/group-activities.ts","../src/react/components/AgentTranscript/AgentTranscript.tsx"],"sourcesContent":["import type { ResolvedVisitorToolResultPresentation } from \"../../lib/tool-result\";\nimport { VisitorToolResultView } from \"../VisitorToolResultView/VisitorToolResultView\";\nimport { SearchReferences } from \"../SearchReferences/SearchReferences\";\nimport { BookingCard } from \"../BookingCard/BookingCard\";\n\nexport type AgentTranscriptActivity = {\n  id: string;\n  createdAt: number;\n  callId: string;\n  category: \"tool\" | \"specialist\";\n  label: string;\n  status: \"started\" | \"completed\" | \"failed\" | \"rejected\";\n  result?: ResolvedVisitorToolResultPresentation;\n};\n\nconst statusLabels = {\n  started: \"No result recorded\",\n  completed: \"\",\n  failed: \"Failed\",\n  rejected: \"Rejected\",\n};\n\nfunction RecordedResult({\n  result,\n}: {\n  result: ResolvedVisitorToolResultPresentation;\n}) {\n  if (result.kind === \"search\") return <SearchReferences results={[result]} />;\n  if (result.kind === \"booking\") {\n    const card = result.card;\n    if (card.type === \"booking_offer\")\n      return <BookingCard readOnly offer={card} />;\n    if (card.type === \"booking_confirmed\")\n      return (\n        <p>Booking confirmed{card.startTime ? ` · ${card.startTime}` : \"\"}</p>\n      );\n    if (card.type === \"booking_canceled\") return <p>Booking canceled</p>;\n    return <p>Information requested</p>;\n  }\n  return <VisitorToolResultView disabled result={result} />;\n}\n\nexport function TranscriptActivity({\n  activity,\n  formatTimestamp,\n}: {\n  activity: AgentTranscriptActivity;\n  formatTimestamp: (createdAt: number) => string;\n}) {\n  const date = new Date(activity.createdAt);\n  const validTimestamp = Number.isFinite(date.getTime());\n  const result =\n    activity.result?.kind === \"hidden\" ? undefined : activity.result;\n  const heading = (\n    <>\n      <span>\n        {activity.category === \"specialist\"\n          ? `Specialist · ${activity.label}`\n          : activity.label}\n      </span>\n      {activity.status !== \"completed\" ? (\n        <span className=\"agent-transcript__activity-status\">\n          {statusLabels[activity.status]}\n        </span>\n      ) : null}\n      {validTimestamp ? (\n        <time dateTime={date.toISOString()}>\n          {formatTimestamp(activity.createdAt)}\n        </time>\n      ) : null}\n    </>\n  );\n  return (\n    <li className=\"agent-transcript__activity\" data-status={activity.status}>\n      {result ? (\n        <details>\n          <summary className=\"agent-transcript__activity-heading\">\n            {heading}\n          </summary>\n          <div className=\"agent-transcript__activity-result\">\n            <RecordedResult result={result} />\n          </div>\n        </details>\n      ) : (\n        <div className=\"agent-transcript__activity-heading\">{heading}</div>\n      )}\n    </li>\n  );\n}\n","import type { AgentTranscriptActivity } from \"./TranscriptActivity\";\n\n/** A paginated snapshot may deliver a call and its result on different pages. */\nexport function groupTranscriptActivities(\n  activities: readonly AgentTranscriptActivity[],\n) {\n  const calls = new Map<\n    string,\n    {\n      latest: AgentTranscriptActivity;\n      id: string;\n      startedAt: number;\n      label: string;\n    }\n  >();\n  for (const activity of activities) {\n    const key = `${activity.category}:${activity.callId}`;\n    const previous = calls.get(key);\n    if (!previous) {\n      calls.set(key, {\n        latest: activity,\n        id: activity.id,\n        startedAt: activity.createdAt,\n        label: activity.label,\n      });\n      continue;\n    }\n    const previousHasResult = previous.latest.status !== \"started\";\n    const nextHasResult = activity.status !== \"started\";\n    const useNext =\n      (nextHasResult && !previousHasResult) ||\n      (nextHasResult === previousHasResult &&\n        activity.createdAt >= previous.latest.createdAt);\n    const latest = useNext ? activity : previous.latest;\n    calls.set(key, {\n      latest,\n      id: previous.id,\n      startedAt: Math.min(previous.startedAt, activity.createdAt),\n      label:\n        activity.createdAt < previous.startedAt\n          ? activity.label\n          : previous.label,\n    });\n  }\n  return [...calls.values()].map(({ latest, id, startedAt, label }) => ({\n    ...latest,\n    id,\n    label,\n    createdAt: startedAt,\n  }));\n}\n","import type {\n  ConversationMessage,\n  AgentColorScheme,\n  AgentRailTheme,\n} from \"../../types/conversation\";\nimport { useAgentColorScheme } from \"../../hooks/useAgentColorScheme\";\nimport { agentThemeStyle } from \"../../lib/agent-theme\";\nimport { MessageBubble } from \"../MessageBubble/MessageBubble\";\nimport {\n  TranscriptActivity,\n  type AgentTranscriptActivity,\n} from \"./TranscriptActivity\";\nimport { groupTranscriptActivities } from \"./group-activities\";\nimport \"./AgentTranscript.css\";\n\nexport type { AgentTranscriptActivity } from \"./TranscriptActivity\";\n\nexport type AgentTranscriptProps = {\n  messages: readonly ConversationMessage[];\n  activities?: readonly AgentTranscriptActivity[];\n  theme?: Partial<AgentRailTheme>;\n  colorScheme?: AgentColorScheme;\n  agentLabel?: string;\n  visitorLabel?: string;\n  label?: string;\n  formatTimestamp?: (createdAt: number) => string;\n};\n\nconst timestampFormat = new Intl.DateTimeFormat(\"en-US\", {\n  month: \"short\",\n  day: \"numeric\",\n  hour: \"numeric\",\n  minute: \"2-digit\",\n  timeZone: \"UTC\",\n});\nfunction defaultTimestamp(createdAt: number) {\n  return `${timestampFormat.format(createdAt)} UTC`;\n}\n\n/** Renders a stored snapshot; never creates a session or exposes chat actions. */\nexport function AgentTranscript({\n  messages,\n  activities = [],\n  theme,\n  colorScheme,\n  agentLabel = \"Agent\",\n  visitorLabel = \"Visitor\",\n  label = \"Conversation transcript\",\n  formatTimestamp = defaultTimestamp,\n}: AgentTranscriptProps) {\n  const scheme = useAgentColorScheme(colorScheme);\n  const entries = [\n    ...messages.map((message) => ({ kind: \"message\" as const, ...message })),\n    ...groupTranscriptActivities(activities).map((activity) => ({\n      kind: \"activity\" as const,\n      ...activity,\n    })),\n  ].sort((left, right) => left.createdAt - right.createdAt);\n  return (\n    <ol\n      className=\"webless-agent-root agent-transcript not-typeset\"\n      data-not-typeset=\"\"\n      data-color-scheme={scheme}\n      aria-label={label}\n      style={agentThemeStyle(theme, scheme)}\n    >\n      {entries.map((message) => {\n        if (message.kind === \"activity\")\n          return (\n            <TranscriptActivity\n              key={message.id}\n              activity={message}\n              formatTimestamp={formatTimestamp}\n            />\n          );\n        const date = new Date(message.createdAt);\n        const validTimestamp = Number.isFinite(date.getTime());\n        return (\n          <li\n            key={message.id}\n            className={`agent-transcript__message agent-transcript__message--${message.role}`}\n          >\n            <div className=\"agent-transcript__meta\">\n              <span>\n                {message.role === \"visitor\" ? visitorLabel : agentLabel}\n              </span>\n              {validTimestamp ? (\n                <time dateTime={date.toISOString()}>\n                  {formatTimestamp(message.createdAt)}\n                </time>\n              ) : null}\n            </div>\n            <MessageBubble\n              message={\n                message.role === \"agent\"\n                  ? { ...message, streaming: false }\n                  : message\n              }\n              bookingReadOnly\n              bookingDisabled\n            />\n          </li>\n        );\n      })}\n    </ol>\n  );\n}\n"],"mappings":"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","names":["jsx","jsxs"]}

package/dist/types-ohWeTG9i.d.cts

@@ -0,0 +1,181 @@
+declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
+declare const AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION: "webless.structured-tool-input.v1";
+declare const AGENT_STRUCTURED_TOOL_INPUT_HEADER: "Webless-Structured-Tool-Input-JSON:";
+type AgentToolUiFieldKind = "text" | "textarea" | "email" | "number" | "select" | "multi-select" | "checkbox" | "confirmation" | "radio" | "date" | "time" | "date-time" | "calendar" | "range" | "json";
+type AgentToolUiOption = {
+    label: string;
+    value: AgentToolResultJsonValue;
+};
+type AgentToolUiField = {
+    description?: string;
+    kind: AgentToolUiFieldKind;
+    label: string;
+    max?: number;
+    maxItems?: number;
+    maxLength?: number;
+    min?: number;
+    minLength?: number;
+    options?: readonly AgentToolUiOption[];
+    path: string;
+    placeholder?: string;
+    required?: boolean;
+    step?: number;
+    defaultValue?: AgentToolResultJsonValue;
+};
+type AgentToolUiStep = {
+    description?: string;
+    fieldPaths: readonly string[];
+    id: string;
+    label: string;
+};
+type AgentToolUiAction = {
+    id: "submit" | "back" | "next" | "reset";
+    label: string;
+};
+type AgentToolUiSurface = {
+    actions?: readonly AgentToolUiAction[];
+    description?: string;
+    fields: readonly AgentToolUiField[];
+    id: string;
+    operationId?: string;
+    requestId?: string;
+    schemaVersion: typeof AGENT_TOOL_UI_SCHEMA_VERSION;
+    steps?: readonly AgentToolUiStep[];
+    submitLabel?: string;
+    title: string;
+    toolSlug: string;
+    values?: Readonly<Record<string, AgentToolResultJsonValue>>;
+};
+type AgentStructuredToolInput = {
+    schemaVersion: typeof AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION;
+    operationId?: string;
+    toolSlug: string;
+    values: Readonly<Record<string, AgentToolResultJsonValue>>;
+};
+declare function formatAgentStructuredToolInput(surface: AgentToolUiSurface, values: Readonly<Record<string, AgentToolResultJsonValue>>): string;
+declare function parseAgentToolUiSurface(value: unknown): AgentToolUiSurface | null;
+
+type AgentToolResultJsonValue = null | boolean | number | string | AgentToolResultJsonValue[] | {
+    [key: string]: AgentToolResultJsonValue;
+};
+type AgentToolResultEnvelope = {
+    schemaVersion: "webless.tool-result.v1";
+    output: AgentToolResultJsonValue;
+    presentationKinds: string[];
+    ui?: AgentToolUiSurface;
+};
+declare function parseAgentToolResultEnvelope(value: unknown): AgentToolResultEnvelope | null;
+
+type AgentIndexVersion = "published" | "unpublished";
+type AgentRuntimeConfig = {
+    origin: string;
+    indexId: string;
+    version: AgentIndexVersion;
+    host: string;
+};
+type AgentWorkItem = {
+    id: string;
+    kind: "planning" | "search" | "specialist";
+    label: string;
+    state: "completed" | "active" | "pending" | "error";
+    detail?: string;
+};
+type AgentInputOption = {
+    id: string;
+    label: string;
+    description?: string;
+    style?: "default" | "primary" | "danger";
+};
+type AgentInputRequest = {
+    requestId: string;
+    kind: "question" | "session-limit" | "tool-approval";
+    prompt: string;
+    display?: "confirmation" | "select" | "text";
+    allowFreeform?: boolean;
+    options?: readonly AgentInputOption[];
+    ui?: AgentToolUiSurface;
+    action: {
+        callId: string;
+        kind: "tool-call";
+        toolName: string;
+    };
+};
+type AgentInputResponse = {
+    requestId: string;
+    optionId?: string;
+    text?: string;
+    value?: AgentToolResultJsonValue;
+};
+type AgentToolResult = {
+    callId: string;
+    toolName: string;
+    status: "completed" | "failed" | "rejected";
+    output?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+type AgentStreamHandlers = {
+    onWork?: (item: AgentWorkItem) => void;
+    /** @deprecated Use onWork for semantic progress events. */
+    onStep?: (label: string, detail?: string) => void;
+    onDelta: (delta: string) => void;
+    onComplete?: () => void;
+    onActionResult?: (output: unknown) => void;
+    onToolResult?: (result: AgentToolResult) => void;
+    onInputRequest?: (requests: readonly AgentInputRequest[]) => void;
+};
+type AgentSendTurnOptions = {
+    signal?: AbortSignal;
+    handlers: AgentStreamHandlers;
+};
+type AgentResumeTurnOptions = AgentSendTurnOptions & {
+    initialText?: string;
+    message: string;
+};
+type AgentRespondTurnOptions = AgentSendTurnOptions & {
+    responses: readonly AgentInputResponse[];
+};
+type PersistedAgentSession = {
+    sessionId: string;
+    streamIndex: number;
+    lastMessage?: string;
+};
+type AgentClientOptions = {
+    /** Index id sent as `indexId` query param to the runtime. */
+    indexId: string;
+    /** Selects the published index by default, or its unpublished preview. */
+    version?: AgentIndexVersion;
+    /** Supplies a fresh Console authorization grant for unpublished previews. */
+    getUnpublishedPreviewGrant?: () => Promise<string>;
+    /** Ready unpublished build id carried by a generated preview URL. */
+    previewBuildId?: string;
+    /** Customer id used to isolate browser session storage when omitted from storageKeyPrefix. */
+    customerId?: string;
+    /** Agent runtime origin, e.g. `https://runtime.staging.webless.ai`. */
+    runtimeOrigin?: string;
+    /** Stable browser conversation id; generated and stored when omitted. */
+    visitorSessionId?: string;
+    /** Override sessionStorage key prefix (derived from agent identity when omitted). */
+    storageKeyPrefix?: string;
+};
+type AgentClient = {
+    readonly indexId: string;
+    readonly version: AgentIndexVersion;
+    readonly runtimeOrigin: string;
+    readonly visitorSessionId: string;
+    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    regenerateTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    resumeTurn: (options: AgentResumeTurnOptions) => Promise<string | null>;
+    respondTurn: (options: AgentRespondTurnOptions) => Promise<string>;
+    reset: () => void;
+    cancelActive: () => void;
+    getActiveSessionId: () => string | undefined;
+};
+type AgentHealthResult = {
+    ok: boolean;
+    detail: string;
+};
+
+export { AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, parseAgentToolResultEnvelope as B, parseAgentToolUiSurface as C, type PersistedAgentSession as P, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, AGENT_TOOL_UI_SCHEMA_VERSION as b, type AgentClient as c, type AgentClientOptions as d, type AgentHealthResult as e, type AgentIndexVersion as f, type AgentInputOption as g, type AgentInputRequest as h, type AgentInputResponse as i, type AgentRespondTurnOptions as j, type AgentResumeTurnOptions as k, type AgentRuntimeConfig as l, type AgentSendTurnOptions as m, type AgentStreamHandlers as n, type AgentStructuredToolInput as o, type AgentToolResult as p, type AgentToolResultEnvelope as q, type AgentToolResultJsonValue as r, type AgentToolUiAction as s, type AgentToolUiField as t, type AgentToolUiFieldKind as u, type AgentToolUiOption as v, type AgentToolUiStep as w, type AgentToolUiSurface as x, type AgentWorkItem as y, formatAgentStructuredToolInput as z };

package/dist/types-ohWeTG9i.d.ts

@@ -0,0 +1,181 @@
+declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
+declare const AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION: "webless.structured-tool-input.v1";
+declare const AGENT_STRUCTURED_TOOL_INPUT_HEADER: "Webless-Structured-Tool-Input-JSON:";
+type AgentToolUiFieldKind = "text" | "textarea" | "email" | "number" | "select" | "multi-select" | "checkbox" | "confirmation" | "radio" | "date" | "time" | "date-time" | "calendar" | "range" | "json";
+type AgentToolUiOption = {
+    label: string;
+    value: AgentToolResultJsonValue;
+};
+type AgentToolUiField = {
+    description?: string;
+    kind: AgentToolUiFieldKind;
+    label: string;
+    max?: number;
+    maxItems?: number;
+    maxLength?: number;
+    min?: number;
+    minLength?: number;
+    options?: readonly AgentToolUiOption[];
+    path: string;
+    placeholder?: string;
+    required?: boolean;
+    step?: number;
+    defaultValue?: AgentToolResultJsonValue;
+};
+type AgentToolUiStep = {
+    description?: string;
+    fieldPaths: readonly string[];
+    id: string;
+    label: string;
+};
+type AgentToolUiAction = {
+    id: "submit" | "back" | "next" | "reset";
+    label: string;
+};
+type AgentToolUiSurface = {
+    actions?: readonly AgentToolUiAction[];
+    description?: string;
+    fields: readonly AgentToolUiField[];
+    id: string;
+    operationId?: string;
+    requestId?: string;
+    schemaVersion: typeof AGENT_TOOL_UI_SCHEMA_VERSION;
+    steps?: readonly AgentToolUiStep[];
+    submitLabel?: string;
+    title: string;
+    toolSlug: string;
+    values?: Readonly<Record<string, AgentToolResultJsonValue>>;
+};
+type AgentStructuredToolInput = {
+    schemaVersion: typeof AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION;
+    operationId?: string;
+    toolSlug: string;
+    values: Readonly<Record<string, AgentToolResultJsonValue>>;
+};
+declare function formatAgentStructuredToolInput(surface: AgentToolUiSurface, values: Readonly<Record<string, AgentToolResultJsonValue>>): string;
+declare function parseAgentToolUiSurface(value: unknown): AgentToolUiSurface | null;
+
+type AgentToolResultJsonValue = null | boolean | number | string | AgentToolResultJsonValue[] | {
+    [key: string]: AgentToolResultJsonValue;
+};
+type AgentToolResultEnvelope = {
+    schemaVersion: "webless.tool-result.v1";
+    output: AgentToolResultJsonValue;
+    presentationKinds: string[];
+    ui?: AgentToolUiSurface;
+};
+declare function parseAgentToolResultEnvelope(value: unknown): AgentToolResultEnvelope | null;
+
+type AgentIndexVersion = "published" | "unpublished";
+type AgentRuntimeConfig = {
+    origin: string;
+    indexId: string;
+    version: AgentIndexVersion;
+    host: string;
+};
+type AgentWorkItem = {
+    id: string;
+    kind: "planning" | "search" | "specialist";
+    label: string;
+    state: "completed" | "active" | "pending" | "error";
+    detail?: string;
+};
+type AgentInputOption = {
+    id: string;
+    label: string;
+    description?: string;
+    style?: "default" | "primary" | "danger";
+};
+type AgentInputRequest = {
+    requestId: string;
+    kind: "question" | "session-limit" | "tool-approval";
+    prompt: string;
+    display?: "confirmation" | "select" | "text";
+    allowFreeform?: boolean;
+    options?: readonly AgentInputOption[];
+    ui?: AgentToolUiSurface;
+    action: {
+        callId: string;
+        kind: "tool-call";
+        toolName: string;
+    };
+};
+type AgentInputResponse = {
+    requestId: string;
+    optionId?: string;
+    text?: string;
+    value?: AgentToolResultJsonValue;
+};
+type AgentToolResult = {
+    callId: string;
+    toolName: string;
+    status: "completed" | "failed" | "rejected";
+    output?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+type AgentStreamHandlers = {
+    onWork?: (item: AgentWorkItem) => void;
+    /** @deprecated Use onWork for semantic progress events. */
+    onStep?: (label: string, detail?: string) => void;
+    onDelta: (delta: string) => void;
+    onComplete?: () => void;
+    onActionResult?: (output: unknown) => void;
+    onToolResult?: (result: AgentToolResult) => void;
+    onInputRequest?: (requests: readonly AgentInputRequest[]) => void;
+};
+type AgentSendTurnOptions = {
+    signal?: AbortSignal;
+    handlers: AgentStreamHandlers;
+};
+type AgentResumeTurnOptions = AgentSendTurnOptions & {
+    initialText?: string;
+    message: string;
+};
+type AgentRespondTurnOptions = AgentSendTurnOptions & {
+    responses: readonly AgentInputResponse[];
+};
+type PersistedAgentSession = {
+    sessionId: string;
+    streamIndex: number;
+    lastMessage?: string;
+};
+type AgentClientOptions = {
+    /** Index id sent as `indexId` query param to the runtime. */
+    indexId: string;
+    /** Selects the published index by default, or its unpublished preview. */
+    version?: AgentIndexVersion;
+    /** Supplies a fresh Console authorization grant for unpublished previews. */
+    getUnpublishedPreviewGrant?: () => Promise<string>;
+    /** Ready unpublished build id carried by a generated preview URL. */
+    previewBuildId?: string;
+    /** Customer id used to isolate browser session storage when omitted from storageKeyPrefix. */
+    customerId?: string;
+    /** Agent runtime origin, e.g. `https://runtime.staging.webless.ai`. */
+    runtimeOrigin?: string;
+    /** Stable browser conversation id; generated and stored when omitted. */
+    visitorSessionId?: string;
+    /** Override sessionStorage key prefix (derived from agent identity when omitted). */
+    storageKeyPrefix?: string;
+};
+type AgentClient = {
+    readonly indexId: string;
+    readonly version: AgentIndexVersion;
+    readonly runtimeOrigin: string;
+    readonly visitorSessionId: string;
+    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    regenerateTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    resumeTurn: (options: AgentResumeTurnOptions) => Promise<string | null>;
+    respondTurn: (options: AgentRespondTurnOptions) => Promise<string>;
+    reset: () => void;
+    cancelActive: () => void;
+    getActiveSessionId: () => string | undefined;
+};
+type AgentHealthResult = {
+    ok: boolean;
+    detail: string;
+};
+
+export { AGENT_STRUCTURED_TOOL_INPUT_HEADER as A, parseAgentToolResultEnvelope as B, parseAgentToolUiSurface as C, type PersistedAgentSession as P, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION as a, AGENT_TOOL_UI_SCHEMA_VERSION as b, type AgentClient as c, type AgentClientOptions as d, type AgentHealthResult as e, type AgentIndexVersion as f, type AgentInputOption as g, type AgentInputRequest as h, type AgentInputResponse as i, type AgentRespondTurnOptions as j, type AgentResumeTurnOptions as k, type AgentRuntimeConfig as l, type AgentSendTurnOptions as m, type AgentStreamHandlers as n, type AgentStructuredToolInput as o, type AgentToolResult as p, type AgentToolResultEnvelope as q, type AgentToolResultJsonValue as r, type AgentToolUiAction as s, type AgentToolUiField as t, type AgentToolUiFieldKind as u, type AgentToolUiOption as v, type AgentToolUiStep as w, type AgentToolUiSurface as x, type AgentWorkItem as y, formatAgentStructuredToolInput as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webless/agent",
-  "version": "0.7.5",
+  "version": "0.9.0",
   "description": "Webless Agent SDK — Eve runtime client, React UI, and embed bundle.",
   "type": "module",
   "license": "MIT",
@@ -31,7 +31,12 @@
       "require": "./dist/embed.cjs"
     },
     "./react.css": "./dist/react.css",
-    "./embed.css": "./dist/embed.css"
+    "./embed.css": "./dist/embed.css",
+    "./presentation": {
+      "types": "./dist/presentation.d.ts",
+      "import": "./dist/presentation.js",
+      "require": "./dist/presentation.cjs"
+    }
   },
   "scripts": {
     "build": "tsup && node ./scripts/ensure-css-imports.mjs",