@vinaverse/client 0.0.0-stage → 0.1.0-alpha.10

package/dist/agent/index.d.cts

@@ -0,0 +1,57 @@
+import { S as Schemas, C as CardLink } from '../session-CPz4pcPu.cjs';
+export { A as AgentBackend, a as AgentClock, b as AgentConversation, c as AgentConversationState, d as AgentEntryPoint, e as AgentEvent, f as AgentEventType, g as AgentFailure, h as AgentFailureReason, i as AgentInsecureAddresses, j as AgentKey, k as AgentPlace, l as AgentRating, m as AgentRefusal, n as AgentRetryPolicy, o as AgentRuntime, p as AgentRuntimeOptions, q as AgentSessionRequest, r as AgentStatus, s as AgentStatusRead, t as AgentStatusState, u as AgentWarning, v as agentKey, w as createAgentRuntime, x as greetedKey, y as hashKey, z as isRefusal } from '../runtime-CISPp9nJ.cjs';
+import '../store-BxiicOKG.cjs';
+
+/** An amount in minor units with its ISO 4217 currency. */
+interface AgentMoney {
+    readonly amount: number;
+    readonly currency: string;
+}
+interface AgentCardAction {
+    readonly action: string;
+    readonly label: string;
+    readonly deepLink: string | null;
+}
+/** What a card is about, as the tenant's tools name it: a UI routes a tap on the card here. */
+interface AgentCardTarget {
+    readonly type: string;
+    readonly id: string;
+}
+interface ReadCard {
+    readonly id: string;
+    readonly kind: Schemas['Card']['kind'];
+    /** `professional` and `workspace`: drawn as a listing (photo, rating, price from, next open time). */
+    readonly listing: boolean;
+    readonly title: string;
+    readonly subtitle: string | null;
+    readonly body: string | null;
+    readonly badges: readonly string[];
+    readonly actions: readonly AgentCardAction[];
+    readonly target: AgentCardTarget | null;
+    /** The hero photo: the first https image, else `image_url`; `ratio` is width / height when both are known. */
+    readonly hero: {
+        readonly url: string;
+        readonly ratio: number | null;
+    } | null;
+    readonly rating: {
+        readonly stars: number;
+        readonly count: number;
+    } | null;
+    readonly priceFrom: AgentMoney | null;
+    readonly price: AgentMoney | null;
+    readonly nextAvailable: string | null;
+    readonly startsAt: string | null;
+    /** Cards one turn draws together; `carousel` draws them in a row, anything else a list. */
+    readonly group: {
+        readonly id: string;
+        readonly layout: 'list' | 'carousel';
+    } | null;
+    /** A `links` card's links, each with a label of at most 40 code points and a known purpose. */
+    readonly links: readonly CardLink[];
+    /** A `proposal` card's proposal id. */
+    readonly proposalId: string | null;
+}
+/** The contract's card (a `HeldCard`'s `card`, or a frame's), read for drawing; null for a kind this client skips. */
+declare function readCard(value: unknown): ReadCard | null;
+
+export { type AgentCardAction, type AgentCardTarget, type AgentMoney, type ReadCard, readCard };

package/dist/agent/index.d.ts

@@ -0,0 +1,57 @@
+import { S as Schemas, C as CardLink } from '../session-CPz4pcPu.js';
+export { A as AgentBackend, a as AgentClock, b as AgentConversation, c as AgentConversationState, d as AgentEntryPoint, e as AgentEvent, f as AgentEventType, g as AgentFailure, h as AgentFailureReason, i as AgentInsecureAddresses, j as AgentKey, k as AgentPlace, l as AgentRating, m as AgentRefusal, n as AgentRetryPolicy, o as AgentRuntime, p as AgentRuntimeOptions, q as AgentSessionRequest, r as AgentStatus, s as AgentStatusRead, t as AgentStatusState, u as AgentWarning, v as agentKey, w as createAgentRuntime, x as greetedKey, y as hashKey, z as isRefusal } from '../runtime-Z1RI10lU.js';
+import '../store-DZka9T2-.js';
+
+/** An amount in minor units with its ISO 4217 currency. */
+interface AgentMoney {
+    readonly amount: number;
+    readonly currency: string;
+}
+interface AgentCardAction {
+    readonly action: string;
+    readonly label: string;
+    readonly deepLink: string | null;
+}
+/** What a card is about, as the tenant's tools name it: a UI routes a tap on the card here. */
+interface AgentCardTarget {
+    readonly type: string;
+    readonly id: string;
+}
+interface ReadCard {
+    readonly id: string;
+    readonly kind: Schemas['Card']['kind'];
+    /** `professional` and `workspace`: drawn as a listing (photo, rating, price from, next open time). */
+    readonly listing: boolean;
+    readonly title: string;
+    readonly subtitle: string | null;
+    readonly body: string | null;
+    readonly badges: readonly string[];
+    readonly actions: readonly AgentCardAction[];
+    readonly target: AgentCardTarget | null;
+    /** The hero photo: the first https image, else `image_url`; `ratio` is width / height when both are known. */
+    readonly hero: {
+        readonly url: string;
+        readonly ratio: number | null;
+    } | null;
+    readonly rating: {
+        readonly stars: number;
+        readonly count: number;
+    } | null;
+    readonly priceFrom: AgentMoney | null;
+    readonly price: AgentMoney | null;
+    readonly nextAvailable: string | null;
+    readonly startsAt: string | null;
+    /** Cards one turn draws together; `carousel` draws them in a row, anything else a list. */
+    readonly group: {
+        readonly id: string;
+        readonly layout: 'list' | 'carousel';
+    } | null;
+    /** A `links` card's links, each with a label of at most 40 code points and a known purpose. */
+    readonly links: readonly CardLink[];
+    /** A `proposal` card's proposal id. */
+    readonly proposalId: string | null;
+}
+/** The contract's card (a `HeldCard`'s `card`, or a frame's), read for drawing; null for a kind this client skips. */
+declare function readCard(value: unknown): ReadCard | null;
+
+export { type AgentCardAction, type AgentCardTarget, type AgentMoney, type ReadCard, readCard };

package/dist/agent/index.js

@@ -0,0 +1,99 @@
+export { AgentRefusal, agentKey, createAgentRuntime, greetedKey, hashKey, isRefusal } from '../chunk-O3NLAZGZ.js';
+import '../chunk-46D3FSLU.js';
+import { isKnownCard } from '../chunk-GWLLUOFY.js';
+
+// src/agent/cards.ts
+var LISTING = /* @__PURE__ */ new Set(["professional", "workspace"]);
+var PURPOSES = /* @__PURE__ */ new Set(["help", "support", "policy", "contact", "feedback"]);
+var GROUP_ID = /^[A-Za-z0-9_-]{1,64}$/;
+var CURRENCY = /^[A-Z]{3}$/;
+var isFields = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var text = (v) => typeof v === "string" ? v : null;
+var whole = (v) => typeof v === "number" && Number.isInteger(v) ? v : null;
+var list = (v) => Array.isArray(v) ? v : [];
+var https = (v) => {
+  const url = text(v);
+  return url !== null && /^https:\/\//i.test(url) ? url : null;
+};
+var instant = (v) => {
+  const at = text(v);
+  return at !== null && !Number.isNaN(Date.parse(at)) ? at : null;
+};
+function money(v) {
+  if (!isFields(v)) return null;
+  const amount = whole(v.amount);
+  const currency = text(v.currency);
+  return amount !== null && amount >= 0 && currency !== null && CURRENCY.test(currency) ? { amount, currency } : null;
+}
+function hero(card) {
+  for (const image of list(card.images)) {
+    if (!isFields(image)) continue;
+    const url = https(image.url);
+    if (url === null) continue;
+    const width = whole(image.width);
+    const height = whole(image.height);
+    return {
+      url,
+      ratio: width && height && width > 0 && height > 0 ? width / height : null
+    };
+  }
+  const legacy = https(card.image_url);
+  return legacy === null ? null : { url: legacy, ratio: null };
+}
+function readCard(value) {
+  if (!isFields(value)) return null;
+  const id = text(value.id);
+  const kind = text(value.kind);
+  const title = text(value.title);
+  if (id === null || kind === null || title === null) return null;
+  if (!isKnownCard({ kind })) return null;
+  const rating = isFields(value.rating) ? value.rating : null;
+  const ppm = whole(rating?.value_ppm);
+  const count = whole(rating?.count);
+  const group = isFields(value.group) ? value.group : null;
+  const groupId = text(group?.id);
+  const ref = isFields(value.ref) ? value.ref : null;
+  const refType = text(ref?.type);
+  const refId = text(ref?.id);
+  const proposal = isFields(value.proposal) ? value.proposal : null;
+  return {
+    id,
+    kind,
+    listing: LISTING.has(kind),
+    title,
+    subtitle: text(value.subtitle),
+    body: text(value.body),
+    badges: list(value.badges).filter(
+      (b) => typeof b === "string"
+    ),
+    actions: list(value.actions).flatMap((a) => {
+      if (!isFields(a)) return [];
+      const action = text(a.action);
+      const label = text(a.label);
+      return action === null || label === null ? [] : [{ action, label, deepLink: text(a.deep_link) }];
+    }),
+    target: refType !== null && refId !== null ? { type: refType, id: refId } : null,
+    hero: hero(value),
+    rating: ppm !== null && count !== null && ppm >= 0 && ppm <= 5e6 && count >= 0 ? { stars: ppm / 1e6, count } : null,
+    priceFrom: money(value.price_from),
+    price: money(value.price),
+    nextAvailable: instant(value.next_available),
+    startsAt: instant(value.starts_at),
+    group: groupId !== null && GROUP_ID.test(groupId) ? {
+      id: groupId,
+      layout: group?.layout === "carousel" ? "carousel" : "list"
+    } : null,
+    links: list(value.links).flatMap((l) => {
+      if (!isFields(l)) return [];
+      const label = text(l.label);
+      const url = text(l.url)?.trim() ?? "";
+      const purpose = text(l.purpose);
+      return label && [...label].length <= 40 && url && purpose && PURPOSES.has(purpose) ? [{ label, url, purpose }] : [];
+    }),
+    proposalId: kind === "proposal" ? text(proposal?.id) : null
+  };
+}
+
+export { readCard };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/cards.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// A card as a UI draws it: the contract's card read once, every field checked, so a renderer never meets a bad value\n// (a photo that is not https, a rating out of range, a group id the contract would refuse). A kind this client does not\n// know is null: the UI skips it (§5).\nimport type { CardLink, Schemas } from '../events.js';\nimport { isKnownCard } from '../events.js';\n\ntype Fields = Readonly<Record<string, unknown>>;\n\n/** An amount in minor units with its ISO 4217 currency. */\nexport interface AgentMoney {\n  readonly amount: number;\n  readonly currency: string;\n}\n\nexport interface AgentCardAction {\n  readonly action: string;\n  readonly label: string;\n  readonly deepLink: string | null;\n}\n\n/** What a card is about, as the tenant's tools name it: a UI routes a tap on the card here. */\nexport interface AgentCardTarget {\n  readonly type: string;\n  readonly id: string;\n}\n\nexport interface ReadCard {\n  readonly id: string;\n  readonly kind: Schemas['Card']['kind'];\n  /** `professional` and `workspace`: drawn as a listing (photo, rating, price from, next open time). */\n  readonly listing: boolean;\n  readonly title: string;\n  readonly subtitle: string | null;\n  readonly body: string | null;\n  readonly badges: readonly string[];\n  readonly actions: readonly AgentCardAction[];\n  readonly target: AgentCardTarget | null;\n  /** The hero photo: the first https image, else `image_url`; `ratio` is width / height when both are known. */\n  readonly hero: { readonly url: string; readonly ratio: number | null } | null;\n  readonly rating: { readonly stars: number; readonly count: number } | null;\n  readonly priceFrom: AgentMoney | null;\n  readonly price: AgentMoney | null;\n  readonly nextAvailable: string | null;\n  readonly startsAt: string | null;\n  /** Cards one turn draws together; `carousel` draws them in a row, anything else a list. */\n  readonly group: {\n    readonly id: string;\n    readonly layout: 'list' | 'carousel';\n  } | null;\n  /** A `links` card's links, each with a label of at most 40 code points and a known purpose. */\n  readonly links: readonly CardLink[];\n  /** A `proposal` card's proposal id. */\n  readonly proposalId: string | null;\n}\n\nconst LISTING = new Set(['professional', 'workspace']);\nconst PURPOSES = new Set(['help', 'support', 'policy', 'contact', 'feedback']);\nconst GROUP_ID = /^[A-Za-z0-9_-]{1,64}$/;\nconst CURRENCY = /^[A-Z]{3}$/;\n\nconst isFields = (v: unknown): v is Fields =>\n  typeof v === 'object' && v !== null && !Array.isArray(v);\nconst text = (v: unknown): string | null => (typeof v === 'string' ? v : null);\nconst whole = (v: unknown): number | null =>\n  typeof v === 'number' && Number.isInteger(v) ? v : null;\nconst list = (v: unknown): readonly unknown[] => (Array.isArray(v) ? v : []);\nconst https = (v: unknown): string | null => {\n  const url = text(v);\n  return url !== null && /^https:\\/\\//i.test(url) ? url : null;\n};\nconst instant = (v: unknown): string | null => {\n  const at = text(v);\n  return at !== null && !Number.isNaN(Date.parse(at)) ? at : null;\n};\n\nfunction money(v: unknown): AgentMoney | null {\n  if (!isFields(v)) return null;\n  const amount = whole(v.amount);\n  const currency = text(v.currency);\n  return amount !== null &&\n    amount >= 0 &&\n    currency !== null &&\n    CURRENCY.test(currency)\n    ? { amount, currency }\n    : null;\n}\n\nfunction hero(card: Fields): ReadCard['hero'] {\n  for (const image of list(card.images)) {\n    if (!isFields(image)) continue;\n    const url = https(image.url);\n    if (url === null) continue;\n    const width = whole(image.width);\n    const height = whole(image.height);\n    return {\n      url,\n      ratio: width && height && width > 0 && height > 0 ? width / height : null,\n    };\n  }\n  const legacy = https(card.image_url);\n  return legacy === null ? null : { url: legacy, ratio: null };\n}\n\n/** The contract's card (a `HeldCard`'s `card`, or a frame's), read for drawing; null for a kind this client skips. */\nexport function readCard(value: unknown): ReadCard | null {\n  if (!isFields(value)) return null;\n  const id = text(value.id);\n  const kind = text(value.kind);\n  const title = text(value.title);\n  if (id === null || kind === null || title === null) return null;\n  if (!isKnownCard({ kind })) return null;\n  const rating = isFields(value.rating) ? value.rating : null;\n  const ppm = whole(rating?.value_ppm);\n  const count = whole(rating?.count);\n  const group = isFields(value.group) ? value.group : null;\n  const groupId = text(group?.id);\n  const ref = isFields(value.ref) ? value.ref : null;\n  const refType = text(ref?.type);\n  const refId = text(ref?.id);\n  const proposal = isFields(value.proposal) ? value.proposal : null;\n  return {\n    id,\n    kind: kind as ReadCard['kind'],\n    listing: LISTING.has(kind),\n    title,\n    subtitle: text(value.subtitle),\n    body: text(value.body),\n    badges: list(value.badges).filter(\n      (b): b is string => typeof b === 'string',\n    ),\n    actions: list(value.actions).flatMap((a) => {\n      if (!isFields(a)) return [];\n      const action = text(a.action);\n      const label = text(a.label);\n      return action === null || label === null\n        ? []\n        : [{ action, label, deepLink: text(a.deep_link) }];\n    }),\n    target:\n      refType !== null && refId !== null ? { type: refType, id: refId } : null,\n    hero: hero(value),\n    rating:\n      ppm !== null &&\n      count !== null &&\n      ppm >= 0 &&\n      ppm <= 5_000_000 &&\n      count >= 0\n        ? { stars: ppm / 1_000_000, count }\n        : null,\n    priceFrom: money(value.price_from),\n    price: money(value.price),\n    nextAvailable: instant(value.next_available),\n    startsAt: instant(value.starts_at),\n    group:\n      groupId !== null && GROUP_ID.test(groupId)\n        ? {\n            id: groupId,\n            layout: group?.layout === 'carousel' ? 'carousel' : 'list',\n          }\n        : null,\n    links: list(value.links).flatMap((l) => {\n      if (!isFields(l)) return [];\n      const label = text(l.label);\n      const url = text(l.url)?.trim() ?? '';\n      const purpose = text(l.purpose);\n      return label &&\n        [...label].length <= 40 &&\n        url &&\n        purpose &&\n        PURPOSES.has(purpose)\n        ? [{ label, url, purpose: purpose as CardLink['purpose'] }]\n        : [];\n    }),\n    proposalId: kind === 'proposal' ? text(proposal?.id) : null,\n  };\n}\n"]}

package/dist/backend/index.cjs

@@ -0,0 +1,268 @@
+'use strict';
+
+// src/agent/runtime.ts
+var AgentRefusal = class extends Error {
+  constructor(kind, options = {}) {
+    super(
+      options.message ?? (kind === "ended" ? "The conversation is over." : "No agent now.")
+    );
+    this.kind = kind;
+    this.name = "AgentRefusal";
+    this.reason = options.reason ?? (kind === "ended" ? "ended" : "unknown");
+    this.code = options.code ?? null;
+  }
+  kind;
+  reason;
+  code;
+};
+
+// src/backend/index.ts
+var OUTCOMES = {
+  conversation_not_found: { status: 404, client: "end", reason: "not_found" },
+  conversation_expired: { status: 410, client: "end", reason: "expired" },
+  conversation_mismatch: { status: 409, client: "end", reason: "mismatch" },
+  conversation_completed: { status: 409, client: "end", reason: "completed" },
+  session_closed: { status: 409, client: "rollover", reason: "ended" },
+  feature_off: { status: 403, client: "off", reason: "off" },
+  rate_limited: { status: 429, client: "wait", reason: "rate_limited" },
+  unauthorized: { status: 401, client: "sign_in", reason: "auth" },
+  forbidden_ownership: { status: 403, client: "refuse", reason: "forbidden" },
+  context_conflict: { status: 409, client: "resend", reason: "conflict" },
+  unavailable: { status: 503, client: "retry", reason: "server" },
+  unknown_open: { status: 409, client: "keep_open_id", reason: "unknown_open" }
+};
+var header = (headers, name) => {
+  if (!headers) return null;
+  if (typeof headers.get === "function")
+    return headers.get(name);
+  const found = Object.entries(headers).find(
+    ([k]) => k.toLowerCase() === name.toLowerCase()
+  );
+  return found ? found[1] : null;
+};
+function uncappedRetryAfterMs(body, headers) {
+  const given = body?.retry_after;
+  if (typeof given === "number" && given >= 0) return given * 1e3;
+  const raw = header(headers, "retry-after");
+  if (!raw) return void 0;
+  const seconds = Number(raw);
+  if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1e3;
+  const at = Date.parse(raw);
+  return Number.isNaN(at) ? void 0 : Math.max(0, at - Date.now());
+}
+function parsed(body) {
+  let value = body;
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function unreachable(reason, extra, message) {
+  return Object.assign(new Error(message), {
+    name: "AgentUnreachable",
+    retryable: true,
+    reason,
+    ...extra
+  });
+}
+function decodeBackendFailure(status, body, headers) {
+  if (typeof status !== "number")
+    return unreachable(
+      "network",
+      { outcome: "unavailable" },
+      status instanceof Error ? status.message : "No answer from the backend."
+    );
+  const json = parsed(body);
+  const named = json?.version === 1 ? json.outcome : void 0;
+  const known = typeof named === "string" && Object.hasOwn(OUTCOMES, named) && OUTCOMES[named].status === status ? named : null;
+  const outcome = known ?? (status === 401 ? "unauthorized" : status === 429 ? "rate_limited" : "unavailable");
+  const retryable = known ? outcome === "rate_limited" || outcome === "unavailable" && json?.retryable === true : status === 429 || status === 408 || status >= 500;
+  const wait = retryAfterMs(known ? json : null, headers);
+  const extra = {
+    status,
+    outcome,
+    ...known && typeof json?.code === "string" ? { gatewayCode: json.code } : {},
+    ...known && typeof json?.open_id === "string" ? { openId: json.open_id } : {},
+    ...known === "context_conflict" && typeof json?.current_revision === "number" ? { currentRevision: json.current_revision } : {},
+    ...wait !== void 0 ? { retryAfterMs: wait } : {}
+  };
+  const message = `Backend answered ${status} (${outcome}).`;
+  const { client, reason } = OUTCOMES[outcome];
+  const said = known || outcome !== "unavailable" || retryable ? reason : "unknown";
+  if (retryable) return unreachable(said, extra, message);
+  return Object.assign(
+    new AgentRefusal(
+      client === "end" || client === "rollover" ? "ended" : "unavailable",
+      {
+        reason: said,
+        code: outcome,
+        message
+      }
+    ),
+    extra,
+    { retryable: false }
+  );
+}
+function backendRoutes(base) {
+  const at = (path) => `${base.replace(/\/$/, "")}/vinaverse/agent/${path}`;
+  return {
+    session: at("session"),
+    refresh: at("session/refresh"),
+    status: at("status"),
+    feedback: at("feedback"),
+    end: at("end"),
+    context: at("context"),
+    delete: at("conversations/{conversation_id}")
+  };
+}
+var screenContext = (place, revision) => place ? {
+  screen: place.screen,
+  ...place.entity ? { entity: place.entity } : {},
+  ...place.filters ? { filters: place.filters } : {},
+  revision
+} : null;
+function backendFromFetch(options) {
+  const { routes } = options;
+  const doFetch = options.fetch ?? ((input, init) => fetch(input, init));
+  const call = async (method, url, body, field, signal) => {
+    let response;
+    try {
+      response = await doFetch(url, {
+        method,
+        headers: {
+          accept: "application/json",
+          ...body === void 0 ? {} : { "content-type": "application/json" },
+          ...await options.headers?.()
+        },
+        ...body === void 0 ? {} : { body: JSON.stringify(body) },
+        ...signal ? { signal } : {}
+      });
+    } catch (error) {
+      throw decodeBackendFailure(error);
+    }
+    const text = await response.text().catch(() => "");
+    if (!response.ok)
+      throw decodeBackendFailure(response.status, text, response.headers);
+    if (!field) return void 0;
+    const got = parsed(text);
+    if (got?.version !== 1 || typeof got[field] !== "object" || !got[field])
+      throw decodeBackendFailure(response.status, text, response.headers);
+    return got[field];
+  };
+  const backend = {
+    openSession: async (request) => await call(
+      "POST",
+      routes.session,
+      {
+        open_id: request.openId,
+        conversation_id: request.conversationId,
+        reason: request.reason,
+        mode: request.key.mode,
+        scope: request.key.scope ?? null,
+        thread: request.key.thread ?? "chat",
+        agent: request.agent,
+        screen_context: screenContext(request.place, request.placeRevision),
+        entry_point: request.entryPoint,
+        ...request.locale !== void 0 ? { locale: request.locale } : {},
+        ...request.timeZone !== void 0 ? { time_zone: request.timeZone } : {}
+      },
+      "session",
+      request.signal
+    )
+  };
+  const { refresh, status, feedback, end, context } = routes;
+  const remove = routes.delete;
+  return {
+    ...backend,
+    ...refresh ? {
+      async refreshSecret(sessionId) {
+        const s = await call(
+          "POST",
+          refresh,
+          { session_id: sessionId },
+          "client_secret"
+        );
+        if (typeof s.value !== "string" || typeof s.expires_at !== "string")
+          throw decodeBackendFailure(200);
+        return { value: s.value, expires_at: s.expires_at };
+      }
+    } : {},
+    ...status ? {
+      async status(signal) {
+        const s = await call(
+          "GET",
+          status,
+          void 0,
+          "status",
+          signal
+        );
+        const f = s.features ?? {};
+        const name = typeof s.display_name === "string" ? s.display_name : null;
+        const avatar = typeof s.avatar_url === "string" ? s.avatar_url : null;
+        return {
+          available: s.available === true,
+          launcher: s.launcher === true,
+          displayName: name,
+          avatarUrl: avatar,
+          features: {
+            history: f.history === true,
+            memory: f.memory === true,
+            businessAgent: f.business_agent === true,
+            businessSetup: f.business_setup === true
+          }
+        };
+      }
+    } : {},
+    ...feedback ? {
+      async sendFeedback(given) {
+        await call("POST", feedback, {
+          session_id: given.sessionId,
+          turn_id: given.turnId,
+          rating: given.rating
+        });
+      }
+    } : {},
+    ...end ? {
+      async endSessions() {
+        await call("POST", end, {});
+      }
+    } : {},
+    ...remove ? {
+      async deleteConversation(conversationId) {
+        await call(
+          "DELETE",
+          remove.replace(
+            "{conversation_id}",
+            encodeURIComponent(conversationId)
+          ),
+          void 0
+        );
+      }
+    } : {},
+    ...context ? {
+      async updateContext(sessionId, place, revision) {
+        await call("PUT", context, {
+          session_id: sessionId,
+          screen_context: screenContext(place, revision)
+        });
+      }
+    } : {}
+  };
+}
+var MAX_RETRY_AFTER_MS = 6e4;
+function retryAfterMs(body, headers) {
+  const ms = uncappedRetryAfterMs(body, headers);
+  return ms === void 0 ? void 0 : Math.min(ms, MAX_RETRY_AFTER_MS);
+}
+
+exports.MAX_RETRY_AFTER_MS = MAX_RETRY_AFTER_MS;
+exports.OUTCOMES = OUTCOMES;
+exports.backendFromFetch = backendFromFetch;
+exports.backendRoutes = backendRoutes;
+exports.decodeBackendFailure = decodeBackendFailure;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map