@vinaverse/client 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/agent/index.d.cts

@@ -0,0 +1,57 @@
+import { S as Schemas, C as CardLink } from '../session-8W3fRNeb.cjs';
+export { A as AgentBackend, a as AgentClock, b as AgentConversation, c as AgentConversationState, d as AgentEvent, e as AgentEventType, f as AgentFailure, g as AgentFailureReason, h as AgentInsecureAddresses, i as AgentKey, j as AgentPlace, k as AgentRating, l as AgentRefusal, m as AgentRetryPolicy, n as AgentRuntime, o as AgentRuntimeOptions, p as AgentSessionRequest, q as AgentStatus, r as AgentStatusRead, s as agentKey, t as createAgentRuntime } from '../runtime-DDxwWBBr.cjs';
+import '../store-C7FtS5AY.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-8W3fRNeb.js';
+export { A as AgentBackend, a as AgentClock, b as AgentConversation, c as AgentConversationState, d as AgentEvent, e as AgentEventType, f as AgentFailure, g as AgentFailureReason, h as AgentInsecureAddresses, i as AgentKey, j as AgentPlace, k as AgentRating, l as AgentRefusal, m as AgentRetryPolicy, n as AgentRuntime, o as AgentRuntimeOptions, p as AgentSessionRequest, q as AgentStatus, r as AgentStatusRead, s as agentKey, t as createAgentRuntime } from '../runtime-B4nKwOTF.js';
+import '../store-DFk0ayh8.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 } from '../chunk-3WR2SUG2.js';
+import '../chunk-ZWG2TMUL.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/chunk-3WR2SUG2.js

@@ -0,0 +1,416 @@
+import { createConversation } from './chunk-ZWG2TMUL.js';
+
+// 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;
+};
+var NOT_KEPT = /* @__PURE__ */ new Set(["starting", "unavailable", "unauthorized", "closed"]);
+var NO_FEATURES = {
+  history: false,
+  memory: false,
+  businessAgent: false,
+  businessSetup: false
+};
+var SYSTEM_CLOCK = { now: () => Date.now() };
+function agentKey(key) {
+  return `${key.subject ?? "guest"}|${key.mode}|${key.scope ?? "-"}|${key.thread ?? "chat"}`;
+}
+var samePlace = (a, b) => a?.screen === b?.screen && (a?.entity?.type ?? null) === (b?.entity?.type ?? null) && (a?.entity?.id ?? null) === (b?.entity?.id ?? null) && JSON.stringify(a?.filters ?? null) === JSON.stringify(b?.filters ?? null);
+function usable(session, insecure) {
+  return typeof session.id === "string" && session.id !== "" && (insecure.realtime === true || /^wss:\/\//i.test(session.realtime_url ?? "")) && (insecure.turns === true || /^https:\/\//i.test(session.turns_url ?? "")) && Boolean(session.client_secret);
+}
+function warnInsecure(insecure) {
+  if (!(insecure.realtime || insecure.turns)) return;
+  if (globalThis.__DEV__ === true) return;
+  console.warn(
+    "@vinaverse/client/agent: insecureAddresses lets sessions use plaintext ws:// or http:// addresses. It is for mocks and local development only; remove it from release builds."
+  );
+}
+function createAgentRuntime(options) {
+  const { backend } = options;
+  const policy = {
+    delays: options.retry?.delays ?? [500, 1500, 3500],
+    isRetryable: options.retry?.isRetryable ?? retryable
+  };
+  const clock = options.clock ?? SYSTEM_CLOCK;
+  const keepAlive = options.keepAlive ?? "session";
+  const staleMs = options.statusStaleMs ?? 5 * 6e4;
+  const insecure = options.insecureAddresses ?? {};
+  warnInsecure(insecure);
+  const live = /* @__PURE__ */ new Map();
+  const current = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  let status = null;
+  let reading = null;
+  let sessionName = null;
+  const emit = (event) => options.onEvent?.(event);
+  const changed = () => {
+    for (const l of [...listeners]) l();
+  };
+  const update = (entry, next) => {
+    entry.state = { ...entry.state, ...next };
+    for (const l of [...entry.listeners]) l();
+  };
+  const end = (k) => {
+    const entry = live.get(k);
+    if (!entry) return;
+    live.delete(k);
+    entry.store.dispose();
+    emit({ type: "conversation_ended", key: k });
+    changed();
+  };
+  const patiently = (run, signal, key) => retrying(
+    run,
+    policy,
+    signal,
+    (attempt) => emit({ type: "session_retried", key, attempt })
+  );
+  async function open(entry, key, request) {
+    if (live.get(entry.key) !== entry) throw new AgentRefusal("unavailable");
+    const told = entry.place;
+    const conversationId = request.conversationId ?? current.get(entry.key) ?? null;
+    let session;
+    try {
+      session = await patiently(
+        () => backend.openSession({
+          ...request,
+          conversationId,
+          key,
+          place: told,
+          entryPoint: entry.entryPoint
+        }),
+        request.signal,
+        entry.key
+      );
+      if (!usable(session, insecure))
+        throw new AgentRefusal("unavailable", {
+          reason: "invalid_session",
+          message: "The session is not usable (an id, a secret, a wss:// realtime_url and an https:// turns_url)."
+        });
+    } catch (error) {
+      if (live.get(entry.key) === entry) {
+        const failure = error instanceof AgentRefusal ? error.kind === "ended" && conversationId !== null ? "ended" : "unavailable" : policy.isRetryable(error) ? "unreachable" : "unavailable";
+        const reason = reasonOf(error, failure);
+        const code = error instanceof AgentRefusal ? error.code : codeOf(error);
+        update(entry, { failure, reason, code });
+        emit({ type: "session_failed", key: entry.key, failure, reason });
+      }
+      throw error;
+    }
+    if (live.get(entry.key) !== entry) throw new AgentRefusal("unavailable");
+    entry.told = told;
+    entry.expiresAt = session.expires_at ? Date.parse(session.expires_at) : null;
+    if (session.conversation_id)
+      current.set(entry.key, session.conversation_id);
+    const name = session.agent?.display_name?.trim();
+    if (name && name !== sessionName) {
+      sessionName = name;
+      changed();
+    }
+    update(entry, {
+      failure: null,
+      reason: null,
+      code: null,
+      sessionId: session.id,
+      moved: !samePlace(told, entry.place)
+    });
+    emit({
+      type: conversationId === null ? "session_opened" : "session_resumed",
+      key: entry.key,
+      sessionId: session.id,
+      ...entry.entryPoint ? { from: entry.entryPoint } : {}
+    });
+    return session;
+  }
+  const kept = (k) => `${options.conversation?.persistenceKey ?? "vinaverse.agent"}.${k}`;
+  function make(key) {
+    const k = agentKey(key);
+    const own = options.conversation ?? {};
+    const refresh = backend.refreshSecret?.bind(backend);
+    const entry = {
+      key: k,
+      store: createConversation({
+        ...own,
+        ...own.persistence ? {
+          persistenceKey: kept(k)
+        } : {},
+        getSession: (request) => open(entry, key, request),
+        ...refresh ? {
+          refreshSecret: (id) => patiently(() => refresh(id), void 0, k)
+        } : {},
+        clock,
+        onError: (error) => {
+          if (!(error instanceof AgentRefusal)) own.onError?.(error);
+        }
+      }),
+      listeners: /* @__PURE__ */ new Set(),
+      state: {
+        failure: null,
+        reason: null,
+        code: null,
+        moved: false,
+        ratings: /* @__PURE__ */ new Map(),
+        sessionId: null
+      },
+      place: null,
+      told: null,
+      revision: 0,
+      entryPoint: null,
+      expiresAt: null,
+      shown: 0,
+      started: false,
+      suspended: false,
+      sentOnce: /* @__PURE__ */ new Set()
+    };
+    return entry;
+  }
+  const over = (entry) => entry.expiresAt !== null && entry.expiresAt <= clock.now();
+  const tell = (entry, at) => {
+    entry.place = at.place ?? null;
+    entry.entryPoint = at.entryPoint ?? null;
+    const sessionId = entry.state.sessionId;
+    const moved = sessionId !== null && !samePlace(entry.told, entry.place);
+    update(entry, { moved });
+    const place = entry.place;
+    if (!moved || !place || !backend.updateContext || sessionId === null)
+      return;
+    const revision = ++entry.revision;
+    backend.updateContext(sessionId, place, revision).then(
+      () => {
+        if (live.get(entry.key) !== entry || entry.revision !== revision)
+          return;
+        entry.told = place;
+        update(entry, { moved: !samePlace(entry.told, entry.place) });
+        emit({ type: "context_updated", key: entry.key, sessionId });
+      },
+      () => void 0
+      // not served, or refused: the question about this place stays the way to say it
+    );
+  };
+  function handle(entry) {
+    return {
+      key: entry.key,
+      store: entry.store,
+      show(at = {}) {
+        if (live.get(entry.key) !== entry) return () => void 0;
+        if (entry.shown === 0 && over(entry)) {
+          end(entry.key);
+          return () => void 0;
+        }
+        entry.shown++;
+        if (entry.suspended) {
+          entry.suspended = false;
+          entry.store.setForeground(true);
+        }
+        tell(entry, at);
+        if (!entry.started) {
+          entry.started = true;
+          entry.store.start();
+        }
+        let released = false;
+        return () => {
+          if (released) return;
+          released = true;
+          entry.shown--;
+          if (entry.shown > 0 || live.get(entry.key) !== entry) return;
+          if (keepAlive === "view" || NOT_KEPT.has(entry.store.getSnapshot().status) || entry.expiresAt === null || over(entry)) {
+            end(entry.key);
+            return;
+          }
+          entry.suspended = true;
+          entry.store.setForeground(false);
+        };
+      },
+      tell: (at) => tell(entry, at),
+      getState: () => entry.state,
+      subscribe(listener) {
+        entry.listeners.add(listener);
+        return () => entry.listeners.delete(listener);
+      },
+      retry() {
+        update(entry, { failure: null, reason: null, code: null });
+        entry.store.start();
+      },
+      rate(turnId, rating) {
+        const sessionId = entry.state.sessionId;
+        if (sessionId === null || entry.state.ratings.get(turnId) === rating)
+          return;
+        update(entry, {
+          ratings: new Map(entry.state.ratings).set(turnId, rating)
+        });
+        emit({ type: "rated", key: entry.key, sessionId, turnId, rating });
+        void backend.sendFeedback?.({ sessionId, turnId, rating }).catch(() => void 0);
+      },
+      sendOnce(text) {
+        if (entry.sentOnce.has(text)) return;
+        entry.sentOnce.add(text);
+        entry.store.send(text);
+      }
+    };
+  }
+  const handles = /* @__PURE__ */ new WeakMap();
+  const lookup = (key) => {
+    const k = agentKey(key);
+    let entry = live.get(k);
+    if (!entry) {
+      entry = make(key);
+      live.set(k, entry);
+    }
+    let h = handles.get(entry);
+    if (!h) {
+      h = handle(entry);
+      handles.set(entry, h);
+    }
+    return h;
+  };
+  return {
+    conversation(key) {
+      const k = agentKey(key);
+      const entry = live.get(k);
+      if (entry && entry.shown === 0 && over(entry)) end(k);
+      return lookup(key);
+    },
+    peek: lookup,
+    startNew(key) {
+      const k = agentKey(key);
+      current.delete(k);
+      end(k);
+    },
+    dispose(key) {
+      end(agentKey(key));
+    },
+    continue(key, conversationId) {
+      const k = agentKey(key);
+      if (current.get(k) !== conversationId) {
+        current.set(k, conversationId);
+        const entry = live.get(k);
+        if (entry) {
+          entry.store.clear();
+          end(k);
+        } else {
+          try {
+            void Promise.resolve(
+              options.conversation?.persistence?.removeItem(kept(k))
+            ).catch(() => void 0);
+          } catch {
+          }
+        }
+      }
+      return lookup(key);
+    },
+    async signOut() {
+      for (const entry of live.values()) entry.store.clear();
+      live.clear();
+      current.clear();
+      sessionName = null;
+      changed();
+      await backend.endSessions?.().catch(() => void 0);
+    },
+    status() {
+      if (status && clock.now() - status.at < staleMs)
+        return Promise.resolve(status.value);
+      reading ??= readStatus(backend).then(
+        (value) => {
+          reading = null;
+          status = { value, at: clock.now() };
+          changed();
+          return value;
+        },
+        (error) => {
+          reading = null;
+          throw error;
+        }
+      );
+      return reading;
+    },
+    getStatus: () => status?.value ?? null,
+    getName: () => sessionName ?? status?.value.displayName ?? null,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    emit
+  };
+}
+async function readStatus(backend) {
+  const read = backend.status ? await backend.status() : { available: true };
+  const available = read.available === true;
+  const features = read.features ?? NO_FEATURES;
+  return {
+    available,
+    launcher: available && read.launcher === true,
+    displayName: read.displayName?.trim() || null,
+    avatarUrl: read.avatarUrl?.startsWith("https://") ? read.avatarUrl : null,
+    features: {
+      history: available && features.history === true,
+      memory: available && features.memory === true,
+      businessAgent: available && features.businessAgent === true,
+      businessSetup: available && features.businessSetup === true
+    }
+  };
+}
+var field = (error, name) => typeof error === "object" && error !== null ? error[name] : void 0;
+var retryable = (error) => field(error, "retryable") === true;
+var REASONS = /* @__PURE__ */ new Set([
+  "ended",
+  "auth",
+  "off",
+  "rate_limited",
+  "network",
+  "server",
+  "invalid_session",
+  "unknown"
+]);
+function reasonOf(error, failure) {
+  if (error instanceof AgentRefusal) return error.reason;
+  const given = field(error, "reason");
+  if (typeof given === "string" && REASONS.has(given))
+    return given;
+  const status = field(error, "status");
+  if (status === 401 || status === 403) return "auth";
+  if (status === 429) return "rate_limited";
+  if (typeof status === "number" && status >= 500) return "server";
+  return failure === "unreachable" ? "network" : "unknown";
+}
+function codeOf(error) {
+  const code = field(error, "code");
+  return typeof code === "string" ? code : null;
+}
+async function retrying(run, policy, signal, onRetry) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      return await run();
+    } catch (error) {
+      const wait = policy.delays[attempt];
+      if (wait === void 0 || !policy.isRetryable(error) || signal?.aborted)
+        throw error;
+      await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+          signal?.removeEventListener("abort", stop);
+          resolve();
+        }, wait);
+        function stop() {
+          clearTimeout(timer);
+          reject(error);
+        }
+        signal?.addEventListener("abort", stop, { once: true });
+      });
+      onRetry(attempt + 1);
+    }
+  }
+}
+
+export { AgentRefusal, agentKey, createAgentRuntime };
+//# sourceMappingURL=chunk-3WR2SUG2.js.map
+//# sourceMappingURL=chunk-3WR2SUG2.js.map