@webless/agent 0.8.0 → 0.9.1

package/dist/presentation.js

@@ -0,0 +1,553 @@
+import {
+  parseAgentToolResultEnvelope,
+  toolResultFailed
+} from "./chunk-TCO62TRN.js";
+
+// src/runtime/search-discovery.ts
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function text(value, max = 500) {
+  return typeof value === "string" && value.trim().length > 0 && value.trim().length <= max;
+}
+function safeSearchUrl(value) {
+  if (typeof value !== "string") return void 0;
+  try {
+    const url = new URL(value);
+    return (url.protocol === "https:" || url.protocol === "http:") && !url.username && !url.password ? url.href : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function parseAgentSearchReferences(value) {
+  const data = record(value);
+  if (!data || !Array.isArray(data.sources) || data.sources.length > 20)
+    return null;
+  const sources = [];
+  for (const value2 of data.sources) {
+    const source = record(value2);
+    if (!source || Object.keys(source).some(
+      (key) => !["id", "title", "url"].includes(key)
+    ) || !text(source.id, Infinity) || !text(source.title) || source.url !== void 0 && typeof source.url !== "string")
+      return null;
+    const url = safeSearchUrl(source.url);
+    sources.push({
+      id: source.id.trim(),
+      title: source.title.trim(),
+      ...url ? { url } : {}
+    });
+  }
+  let cta;
+  if (data.cta !== void 0) {
+    const action = record(data.cta);
+    if (!action || Object.keys(action).some((key) => !["label", "url"].includes(key)) || !text(action.label) || action.url !== void 0 && typeof action.url !== "string")
+      return null;
+    const url = safeSearchUrl(action.url);
+    cta = { label: action.label.trim(), ...url ? { url } : {} };
+  }
+  return { sources, ...cta ? { cta } : {} };
+}
+function parseAgentSearchDiscoveryOutput(value) {
+  let decoded = value;
+  if (typeof value === "string") {
+    try {
+      decoded = JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  const data = record(decoded);
+  if (!data || Object.keys(data).some(
+    (key) => !["answer", "sources", "cta", "suggestions"].includes(key)
+  ) || !text(data.answer, 5e4) || !Array.isArray(data.suggestions) || data.suggestions.length > 8 || !data.suggestions.every((item) => text(item)))
+    return null;
+  const references = parseAgentSearchReferences(data);
+  return references ? {
+    ...references,
+    answer: data.answer.trim(),
+    suggestions: data.suggestions.map((item) => item.trim())
+  } : null;
+}
+
+// src/react/lib/composer-form.ts
+var MAX_FORM_FIELDS = 5;
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function isFieldKind(value) {
+  return value === "text" || value === "email" || value === "tel" || value === "textarea";
+}
+function parseVisitorFormFields(value) {
+  if (!Array.isArray(value)) return [];
+  const fields = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of value) {
+    const record2 = asRecord(item);
+    const id = asString(record2?.id).toLowerCase().replace(/[^a-z0-9_-]/g, "");
+    const kind = asString(record2?.kind);
+    if (!record2 || !id || seen.has(id) || !isFieldKind(kind)) continue;
+    seen.add(id);
+    const label = asString(record2.label) || id;
+    fields.push({
+      id,
+      kind,
+      label,
+      placeholder: asString(record2.placeholder) || label,
+      required: record2.required !== false,
+      ...asString(record2.autocomplete) ? { autocomplete: asString(record2.autocomplete) } : {}
+    });
+    if (fields.length >= MAX_FORM_FIELDS) break;
+  }
+  return fields;
+}
+
+// src/react/lib/tool-card.ts
+function asRecord2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asString2(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function isEventUri(value) {
+  return /^https:\/\/api\.calendly\.com\/scheduled_events\/[^/]+$/i.test(value);
+}
+function isEventTypeUri(value) {
+  return /^https:\/\/api\.calendly\.com\/event_types\/[^/]+$/i.test(value);
+}
+function parseToolCard(value) {
+  const record2 = asRecord2(value);
+  if (!record2) return null;
+  if (record2.booking_offer && asString2(record2.type) !== "booking_offer") {
+    const nested = parseToolCard(record2.booking_offer);
+    if (nested) return nested;
+  }
+  if (record2.visitor_booking && asString2(record2.type) !== "booking_confirmed") {
+    const nested = parseToolCard(record2.visitor_booking);
+    if (nested) return nested;
+  }
+  const type = asString2(record2.type);
+  if (type === "booking_offer") {
+    const eventTypes = Array.isArray(record2.eventTypes) ? record2.eventTypes.flatMap((item) => {
+      const entry = asRecord2(item);
+      const uri = asString2(entry?.uri);
+      if (!entry || !uri) return [];
+      const duration = entry.duration;
+      const locationKind = asString2(entry.locationKind);
+      const location = asString2(entry.location);
+      return [
+        {
+          name: asString2(entry.name) || "Meeting",
+          uri,
+          ...typeof duration === "number" ? { duration } : {},
+          ...locationKind ? { locationKind } : {},
+          ...location ? { location } : {}
+        }
+      ];
+    }) : [];
+    const slots = Array.isArray(record2.slots) ? record2.slots.flatMap((item) => {
+      const entry = asRecord2(item);
+      const startTime = asString2(entry?.startTime);
+      if (!entry || !startTime) return [];
+      const eventTypeUri = asString2(entry.eventTypeUri);
+      return [
+        {
+          startTime,
+          ...isEventTypeUri(eventTypeUri) ? { eventTypeUri } : {}
+        }
+      ];
+    }) : [];
+    if (eventTypes.length === 0 && slots.length === 0) return null;
+    return { type: "booking_offer", eventTypes, slots };
+  }
+  if (type === "booking_confirmed") {
+    const eventUri = asString2(record2.eventUri);
+    if (!isEventUri(eventUri)) return null;
+    const inviteeUri = asString2(record2.inviteeUri);
+    const inviteeEmail = asString2(record2.inviteeEmail);
+    const startTime = asString2(record2.startTime);
+    return {
+      type: "booking_confirmed",
+      eventUri,
+      ...inviteeUri ? { inviteeUri } : {},
+      ...inviteeEmail ? { inviteeEmail } : {},
+      ...startTime ? { startTime } : {}
+    };
+  }
+  if (type === "booking_canceled") {
+    const eventUri = asString2(record2.eventUri);
+    if (!isEventUri(eventUri)) return null;
+    return { type: "booking_canceled", eventUri };
+  }
+  if (type === "visitor_form") {
+    const fields = parseVisitorFormFields(record2.fields);
+    if (fields.length < 2) return null;
+    return { type: "visitor_form", fields };
+  }
+  return null;
+}
+function bookingCardFromActionOutput(output) {
+  const record2 = asRecord2(output);
+  const data = asRecord2(record2?.output) ?? asRecord2(record2?.data) ?? record2;
+  return parseToolCard(data);
+}
+
+// src/react/lib/tool-result.ts
+var MAX_TEXT_LENGTH = 240;
+var MAX_DETAILS = 6;
+var MAX_LINKS = 4;
+var MAX_COLLECTION_ITEMS = 8;
+var INTERNAL_FACT_LABEL = /^(hs\b|createdate|created at|updatedate|updated at|firstname|first name|lastname|last name|vid|objectid|object id|all contact)/iu;
+function safeText(value) {
+  if (typeof value !== "string") return "";
+  return value.trim().slice(0, MAX_TEXT_LENGTH);
+}
+function safeHref(value) {
+  const text2 = safeText(value);
+  if (!text2) return "";
+  try {
+    const url = new URL(text2);
+    return url.protocol === "https:" ? url.toString() : "";
+  } catch {
+    return "";
+  }
+}
+function fallbackTitle(result) {
+  if (result.status === "failed") return "Couldn\u2019t complete this action";
+  if (result.status === "rejected") return "Action not approved";
+  return "Action completed";
+}
+function bookingPresenter(kind) {
+  return {
+    kind,
+    present: ({ envelope }) => {
+      const card = bookingCardFromActionOutput(envelope.output);
+      return card && card.type === kind ? { kind: "booking", card } : null;
+    }
+  };
+}
+function providerErrorPresenter() {
+  return {
+    kind: "provider_error",
+    present: ({ envelope }) => {
+      const output = asRecord3(envelope.output);
+      const providerError = asRecord3(output?.providerError);
+      const message = safeText(providerError?.message);
+      const action = safeText(providerError?.action);
+      if (!message || !action) return null;
+      const resourceLabels = Array.isArray(providerError?.resourceLabels) ? providerError.resourceLabels.map(safeText).filter(Boolean).slice(0, MAX_DETAILS) : [];
+      return {
+        kind: "summary",
+        status: "failed",
+        title: message,
+        description: action,
+        ...resourceLabels.length ? {
+          details: [
+            { label: "Affected", value: resourceLabels.join(", ") }
+          ]
+        } : {}
+      };
+    }
+  };
+}
+function asRecord3(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function parseFacts(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((item) => {
+    const fact = asRecord3(item);
+    const label = safeText(fact?.label);
+    const factValue = safeText(fact?.value);
+    if (!label || !factValue) return [];
+    if (INTERNAL_FACT_LABEL.test(label)) return [];
+    return [{ label, value: factValue }];
+  });
+}
+function parseLinks(output, defaultLabel) {
+  const href = safeHref(output.href);
+  const linkLabel = safeText(output.linkLabel) || defaultLabel;
+  return href ? [{ label: linkLabel, href }] : [];
+}
+function entityResultPresenter() {
+  return {
+    kind: "entity_result",
+    present: ({ envelope, result }) => {
+      const output = asRecord3(envelope.output);
+      if (!output) return null;
+      const title = safeText(output.title) || fallbackTitle(result);
+      const description = safeText(output.description);
+      const facts = parseFacts(output.facts).filter((fact) => fact.value !== description && fact.value !== title).slice(0, MAX_DETAILS);
+      return {
+        kind: "entity",
+        title,
+        ...description && description !== title ? { description } : {},
+        ...facts.length ? { details: facts } : {},
+        ...parseLinks(output, "Open record").length ? { links: parseLinks(output, "Open record") } : {}
+      };
+    }
+  };
+}
+function collectionResultPresenter() {
+  return {
+    kind: "collection",
+    present: ({ envelope, result }) => {
+      const output = asRecord3(envelope.output);
+      if (!output) return null;
+      const title = safeText(output.title) || fallbackTitleFromKind("collection");
+      const items = Array.isArray(output.items) ? output.items.slice(0, MAX_COLLECTION_ITEMS).flatMap((item) => {
+        const entry = asRecord3(item);
+        if (!entry) return [];
+        const itemTitle = safeText(entry.title);
+        if (!itemTitle) return [];
+        const description = safeText(entry.description);
+        const details = parseFacts(entry.facts).slice(0, MAX_DETAILS);
+        const href = safeHref(entry.href);
+        return [
+          {
+            title: itemTitle,
+            ...description ? { description } : {},
+            ...details.length ? { details } : {},
+            ...href ? { href } : {}
+          }
+        ];
+      }) : [];
+      return {
+        kind: "collection",
+        title,
+        items
+      };
+    }
+  };
+}
+function signatureResultPresenter() {
+  return {
+    kind: "signature",
+    present: ({ envelope, result }) => {
+      const output = asRecord3(envelope.output);
+      if (!output) return null;
+      const title = safeText(output.title) || fallbackTitleFromKind("signature");
+      const description = safeText(output.description);
+      const statusLabel = safeText(output.status);
+      return {
+        kind: "signature",
+        title,
+        ...description ? { description } : {},
+        ...statusLabel ? { statusLabel } : {},
+        ...parseLinks(output, "Sign now").length ? { links: parseLinks(output, "Sign now") } : {}
+      };
+    }
+  };
+}
+function resultCardPresenter(kind) {
+  return {
+    kind,
+    present: ({ envelope, result }) => {
+      const output = asRecord3(envelope.output);
+      if (!output) return null;
+      const title = safeText(output.title) || fallbackTitleFromKind(kind);
+      const description = safeText(output.description);
+      const facts = parseFacts(output.facts).slice(0, MAX_DETAILS);
+      return {
+        kind: "summary",
+        title,
+        ...description && description !== title ? { description } : {},
+        ...facts.length ? { details: facts } : {},
+        ...parseLinks(output, "Open").length ? { links: parseLinks(output, "Open") } : {}
+      };
+    }
+  };
+}
+function fallbackTitleFromKind(kind) {
+  if (kind === "document") return "Document ready";
+  if (kind === "signature") return "Ready to sign";
+  if (kind === "payment") return "Payment link";
+  if (kind === "collection") return "Results";
+  if (kind === "confirmation_result") return "Confirmed";
+  return "Saved";
+}
+var builtInVisitorToolResultRegistry = [
+  providerErrorPresenter(),
+  bookingPresenter("booking_offer"),
+  bookingPresenter("booking_confirmed"),
+  bookingPresenter("booking_canceled"),
+  entityResultPresenter(),
+  collectionResultPresenter(),
+  signatureResultPresenter(),
+  resultCardPresenter("document"),
+  resultCardPresenter("payment"),
+  resultCardPresenter("confirmation_result")
+];
+function resolvePresenterOutput(result, envelope, registry) {
+  const presenters = [...registry, ...builtInVisitorToolResultRegistry];
+  for (const presentationKind of envelope.presentationKinds) {
+    const presenter = presenters.find(
+      (candidate) => candidate.kind === presentationKind
+    );
+    if (!presenter) continue;
+    try {
+      const presented = presenter.present({
+        envelope,
+        presentationKind,
+        result
+      });
+      if (presented) return presented;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+function finalizeSummaryPresentation(result, proposed) {
+  const title = safeText(proposed.title) || fallbackTitle(result);
+  const description = safeText(proposed.description);
+  const details = proposed.details?.slice(0, MAX_DETAILS).flatMap((detail) => {
+    const label = safeText(detail.label);
+    const value = safeText(detail.value);
+    if (!label || !value) return [];
+    if (INTERNAL_FACT_LABEL.test(label)) return [];
+    if (value === title || value === description) return [];
+    return [{ label, value }];
+  });
+  const links = proposed.links?.slice(0, MAX_LINKS).flatMap((link) => {
+    const label = safeText(link.label);
+    const href = safeHref(link.href);
+    return label && href ? [{ label, href }] : [];
+  });
+  return {
+    id: result.callId,
+    toolName: result.toolName,
+    status: proposed.status ?? result.status,
+    kind: "summary",
+    title,
+    ...description && description !== title ? { description } : {},
+    ...details?.length ? { details } : {},
+    ...links?.length ? { links } : {}
+  };
+}
+function presentVisitorToolResult(result, registry = []) {
+  if (result.status === "completed" && toolResultFailed(result)) {
+    result = { ...result, status: "failed" };
+  }
+  if (result.toolName === "search_discovery" && result.status === "completed") {
+    const envelope2 = parseAgentToolResultEnvelope(result.output);
+    const search = parseAgentSearchDiscoveryOutput(
+      envelope2?.output ?? result.output
+    );
+    if (search) {
+      return {
+        id: result.callId,
+        toolName: "search_discovery",
+        status: "completed",
+        kind: "search",
+        sources: search.sources,
+        ...search.cta ? { cta: search.cta } : {}
+      };
+    }
+  }
+  const envelope = parseAgentToolResultEnvelope(result.output) ?? providerErrorEnvelope(result.output) ?? legacyBookingEnvelope(result.output);
+  const proposed = envelope ? resolvePresenterOutput(result, envelope, registry) : null;
+  if (proposed?.kind === "booking") {
+    return {
+      id: result.callId,
+      toolName: result.toolName,
+      status: result.status,
+      kind: "booking",
+      card: proposed.card
+    };
+  }
+  if (envelope?.ui && envelope.presentationKinds.includes("tool_input")) {
+    return {
+      id: result.callId,
+      toolName: result.toolName,
+      status: result.status,
+      kind: "input",
+      surface: envelope.ui
+    };
+  }
+  if (!proposed || result.status !== "completed" && proposed.kind !== "summary") {
+    if (result.status === "failed" || result.status === "rejected") {
+      return {
+        id: result.callId,
+        toolName: result.toolName,
+        status: result.status,
+        kind: "summary",
+        title: fallbackTitle(result)
+      };
+    }
+    return {
+      id: result.callId,
+      toolName: result.toolName,
+      status: result.status,
+      kind: "hidden"
+    };
+  }
+  if (proposed.kind === "entity") {
+    return {
+      id: result.callId,
+      toolName: result.toolName,
+      status: result.status,
+      ...proposed
+    };
+  }
+  if (proposed.kind === "collection") {
+    return {
+      id: result.callId,
+      toolName: result.toolName,
+      status: result.status,
+      ...proposed
+    };
+  }
+  if (proposed.kind === "signature") {
+    return {
+      id: result.callId,
+      toolName: result.toolName,
+      status: result.status,
+      ...proposed
+    };
+  }
+  return finalizeSummaryPresentation(result, proposed);
+}
+function providerErrorEnvelope(output) {
+  const record2 = asRecord3(output);
+  const providerError = asRecord3(record2?.providerError);
+  const message = safeText(providerError?.message);
+  const action = safeText(providerError?.action);
+  if (!message || !action) return null;
+  const resourceLabels = Array.isArray(providerError?.resourceLabels) ? providerError.resourceLabels.map(safeText).filter(Boolean).slice(0, MAX_DETAILS) : [];
+  return {
+    schemaVersion: "webless.tool-result.v1",
+    output: {
+      providerError: {
+        action,
+        message,
+        ...resourceLabels.length ? { resourceLabels } : {}
+      }
+    },
+    presentationKinds: ["provider_error"]
+  };
+}
+function legacyBookingEnvelope(output) {
+  const card = bookingCardFromActionOutput(output);
+  return card ? {
+    schemaVersion: "webless.tool-result.v1",
+    output: card,
+    presentationKinds: [card.type]
+  } : null;
+}
+
+// src/presentation.ts
+function presentTranscriptToolResult(result) {
+  const output = parseAgentToolResultEnvelope(result.output)?.output ?? result.output;
+  const legacyError = output !== null && typeof output === "object" && "error" in output && typeof output.error === "string" && output.error.trim().length > 0;
+  return presentVisitorToolResult(
+    legacyError ? { ...result, status: "failed" } : result
+  );
+}
+export {
+  presentTranscriptToolResult,
+  presentVisitorToolResult
+};
+//# sourceMappingURL=presentation.js.map