@vinaverse/client 0.1.0-alpha.10 → 0.1.0-alpha.12

package/dist/history/index.d.ts

@@ -0,0 +1,91 @@
+import { h as AgentFailureReason, j as AgentKey, o as AgentRuntime, A as AgentBackend } from '../runtime-CZyVCueC.js';
+import { T as TimelineItem } from '../store-CGRSxVcL.js';
+import { S as Schemas } from '../session-D0ijOQX3.js';
+
+type ConversationSummary = Schemas['ConversationSummary'];
+type HistoryItem = Schemas['TimelineItem'];
+/**
+ * The key a past conversation continues under for this person: its side and business as it was bound when it started
+ * (`experience_mode`, `business_scope_id`), the `thread` given (default `chat`). For `runtime.continue(key, id)` and
+ * `deleteConversation(key, id)`, so the device forgets it only where that key still continues it.
+ */
+declare function continueKey(conversation: ConversationSummary, subject: string | null, thread?: string): AgentKey;
+/**
+ * A past conversation's items as the kits draw them: messages as sent (an `assistant` reply is the agent's, cut-off
+ * replies and refusals marked), cards restored (drawn as they were, taking no answer or action), a proposal with the
+ * outcome it had. Keyed by the server's ids, so pages merge without doubles.
+ */
+declare function historyItems(data: readonly HistoryItem[]): TimelineItem[];
+interface AgentHistoryState {
+    readonly conversations: readonly ConversationSummary[];
+    /** A page is being read. */
+    readonly loading: boolean;
+    /** Why the last page could not be read; null when it was. `off` when the backend serves no history. */
+    readonly failure: AgentFailureReason | null;
+    /** Every page is read. */
+    readonly done: boolean;
+    /** The first page was asked for. */
+    readonly started: boolean;
+}
+interface AgentHistory {
+    getSnapshot(): AgentHistoryState;
+    subscribe(listener: () => void): () => void;
+    /** Reads the first page anew: the first time, after a failure, or to see what changed. */
+    refresh(): void;
+    /** The next older page, when there is one and none is being read. */
+    loadMore(): void;
+    /** Reads again the page that failed: the first (as `refresh`), or the next. */
+    retry(): void;
+    /**
+     * Deletes a past conversation (the runtime's `deleteConversation` for the key that holds it, so the device forgets
+     * it only where the key still continues it) and drops its row. One already gone (`not_found`) is dropped too.
+     */
+    remove(key: AgentKey, conversationId: string): Promise<void>;
+}
+interface AgentHistoryOptions {
+    readonly runtime: AgentRuntime;
+    /** Default: the runtime's. */
+    readonly backend?: AgentBackend;
+    /** The app's side: `customer` or `business`. */
+    readonly mode: string;
+    /** The business acted for, with `business`. */
+    readonly scope?: string | null;
+    /** The agent, for a backend that serves more than one. */
+    readonly agent?: string | null;
+    /** Conversations per page (1–50). Default 20. */
+    readonly pageSize?: number;
+}
+/** A person's past conversations, newest activity first. */
+declare function createAgentHistory(options: AgentHistoryOptions): AgentHistory;
+interface AgentTranscriptState {
+    /** The conversation's items, oldest first, as the kits draw them (`historyItems`). */
+    readonly items: readonly TimelineItem[];
+    readonly loading: boolean;
+    /** Why the last page could not be read: `not_found` (deleted, or never theirs), `expired`, … */
+    readonly failure: AgentFailureReason | null;
+    /** Nothing earlier to read. */
+    readonly done: boolean;
+    readonly started: boolean;
+}
+interface AgentTranscript {
+    getSnapshot(): AgentTranscriptState;
+    subscribe(listener: () => void): () => void;
+    /** Reads the newest page anew. */
+    load(): void;
+    /** The page before the earliest read, prepended. */
+    loadEarlier(): void;
+    /** Reads again the page that failed: the newest (as `load`), or the earlier one. */
+    retry(): void;
+}
+interface AgentTranscriptOptions {
+    readonly runtime: AgentRuntime;
+    /** Default: the runtime's. */
+    readonly backend?: AgentBackend;
+    readonly conversationId: string;
+    /** Items per page. Default 30. */
+    readonly pageSize?: number;
+}
+/** A past conversation's transcript, read-only: newest page first, earlier pages prepended. */
+declare function createAgentTranscript(options: AgentTranscriptOptions): AgentTranscript;
+
+export { type AgentHistory, type AgentHistoryOptions, type AgentHistoryState, type AgentTranscript, type AgentTranscriptOptions, type AgentTranscriptState, type ConversationSummary, continueKey, createAgentHistory, createAgentTranscript, historyItems };

package/dist/history/index.js

@@ -0,0 +1,261 @@
+import { isRefusal } from '../chunk-5THD6XC7.js';
+import '../chunk-46D3FSLU.js';
+import '../chunk-GWLLUOFY.js';
+
+// src/history/index.ts
+function continueKey(conversation, subject, thread) {
+  return {
+    subject,
+    mode: conversation.experience_mode,
+    scope: conversation.business_scope_id ?? null,
+    ...thread ? { thread } : {}
+  };
+}
+function historyItems(data) {
+  return data.map((item, seq) => {
+    if (item.type === "card") {
+      const outcome = item.proposal_outcome;
+      const card = {
+        type: "card",
+        key: item.card.id,
+        busy: false,
+        restored: true,
+        card: {
+          id: item.card.id,
+          kind: item.card.kind,
+          card: item.card,
+          locked: [],
+          turnId: item.turn_id,
+          outcome: outcome && outcome !== "pending" ? outcome : null,
+          seq
+        }
+      };
+      return card;
+    }
+    const message = {
+      type: "message",
+      key: `h:${item.id}`,
+      role: item.role === "assistant" ? "agent" : item.role,
+      text: item.text,
+      state: "sent",
+      ...item.interrupted ? { partial: "interrupted" } : {},
+      ...item.refusal ? { refusal: true } : {}
+    };
+    return message;
+  });
+}
+function reasonOf(error) {
+  if (isRefusal(error)) return error.reason;
+  const given = error?.reason;
+  return typeof given === "string" ? given : "unknown";
+}
+function staleCursor(error) {
+  const e = error;
+  return e?.outcome === "unavailable" && e.gatewayCode === "invalid_request" && e.retryable === false;
+}
+function paged(runtime, empty) {
+  let state = empty;
+  let epoch = runtime.epoch();
+  let asked = 0;
+  const listeners = /* @__PURE__ */ new Set();
+  const set = (next) => {
+    state = { ...state, ...next };
+    for (const l of [...listeners]) l();
+  };
+  const fresh = () => {
+    if (runtime.epoch() === epoch) return;
+    epoch = runtime.epoch();
+    asked++;
+    state = empty;
+  };
+  let off = null;
+  return {
+    get: () => {
+      fresh();
+      return state;
+    },
+    set,
+    subscribe(listener) {
+      listeners.add(listener);
+      off ??= runtime.subscribe(() => {
+        const before = state;
+        fresh();
+        if (state !== before) for (const l of [...listeners]) l();
+      });
+      return () => {
+        listeners.delete(listener);
+        if (listeners.size === 0) {
+          off?.();
+          off = null;
+        }
+      };
+    },
+    /** Reads a page; `apply` lands only for the newest read, under the same person. */
+    read(call, apply, failed) {
+      fresh();
+      const mine = ++asked;
+      const under = epoch;
+      set({ loading: true });
+      call().then(
+        (value) => {
+          if (mine === asked && under === runtime.epoch()) apply(value);
+        },
+        (error) => {
+          if (mine === asked && under === runtime.epoch()) failed(error);
+        }
+      );
+    }
+  };
+}
+var NO_HISTORY = {
+  conversations: [],
+  loading: false,
+  failure: null,
+  done: false,
+  started: false
+};
+function createAgentHistory(options) {
+  const { runtime } = options;
+  const backend = options.backend ?? runtime.backend;
+  const store = paged(runtime, NO_HISTORY);
+  let cursor = null;
+  let restarted = false;
+  const page = (from) => {
+    const list = backend.listConversations?.bind(backend);
+    if (!list) {
+      store.set({ started: true, failure: "off", done: true });
+      return;
+    }
+    store.read(
+      () => list({
+        mode: options.mode,
+        scope: options.scope ?? null,
+        agent: options.agent ?? null,
+        limit: options.pageSize ?? 20,
+        cursor: from
+      }),
+      (got) => {
+        const known = new Set(
+          from ? store.get().conversations.map((c) => c.id) : []
+        );
+        cursor = got.next_cursor;
+        store.set({
+          conversations: [
+            ...from ? store.get().conversations : [],
+            ...got.data.filter((c) => !known.has(c.id))
+          ],
+          loading: false,
+          failure: null,
+          done: cursor === null
+        });
+      },
+      (error) => {
+        if (from !== null && staleCursor(error) && !restarted) {
+          restarted = true;
+          cursor = null;
+          page(null);
+          return;
+        }
+        store.set({ loading: false, failure: reasonOf(error) });
+      }
+    );
+  };
+  const refresh = () => {
+    cursor = null;
+    restarted = false;
+    store.set({ started: true });
+    page(null);
+  };
+  const loadMore = () => {
+    const s = store.get();
+    if (!s.started || s.loading || s.done || cursor === null) return;
+    page(cursor);
+  };
+  return {
+    getSnapshot: store.get,
+    subscribe: store.subscribe,
+    refresh,
+    loadMore,
+    retry: () => cursor === null ? refresh() : loadMore(),
+    async remove(key, conversationId) {
+      try {
+        await runtime.deleteConversation(key, conversationId);
+      } catch (error) {
+        if (!(isRefusal(error) && error.reason === "not_found")) throw error;
+      }
+      store.set({
+        conversations: store.get().conversations.filter((c) => c.id !== conversationId)
+      });
+    }
+  };
+}
+var NO_TRANSCRIPT = {
+  items: [],
+  loading: false,
+  failure: null,
+  done: false,
+  started: false
+};
+function createAgentTranscript(options) {
+  const { runtime } = options;
+  const backend = options.backend ?? runtime.backend;
+  const store = paged(runtime, NO_TRANSCRIPT);
+  let cursor = null;
+  let restarted = false;
+  const page = (from) => {
+    const read = backend.readConversation?.bind(backend);
+    if (!read) {
+      store.set({ started: true, failure: "off", done: true });
+      return;
+    }
+    store.read(
+      () => read(options.conversationId, {
+        limit: options.pageSize ?? 30,
+        cursor: from
+      }),
+      (got) => {
+        const earlier = historyItems(got.data);
+        const held = from ? store.get().items : [];
+        const keys = new Set(held.map((i) => i.key));
+        cursor = got.next_cursor;
+        store.set({
+          items: [...earlier.filter((i) => !keys.has(i.key)), ...held],
+          loading: false,
+          failure: null,
+          done: cursor === null
+        });
+      },
+      (error) => {
+        if (from !== null && staleCursor(error) && !restarted) {
+          restarted = true;
+          cursor = null;
+          page(null);
+          return;
+        }
+        store.set({ loading: false, failure: reasonOf(error) });
+      }
+    );
+  };
+  const load = () => {
+    cursor = null;
+    restarted = false;
+    store.set({ started: true });
+    page(null);
+  };
+  const loadEarlier = () => {
+    const s = store.get();
+    if (!s.started || s.loading || s.done || cursor === null) return;
+    page(cursor);
+  };
+  return {
+    getSnapshot: store.get,
+    subscribe: store.subscribe,
+    load,
+    loadEarlier,
+    retry: () => cursor === null ? load() : loadEarlier()
+  };
+}
+
+export { continueKey, createAgentHistory, createAgentTranscript, historyItems };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/history/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// @vinaverse/client/history: a person's past conversations with the agent (C2), through the tenant's backend\n// (`AgentBackend.listConversations`, `readConversation`): the list, newest activity first, a page at a time; a past\n// conversation's transcript, newest page first, earlier pages prepended; delete through the runtime. No React: the\n// kits bind to it. Nothing begun before a sign-out lands after it (the runtime's `epoch`).\nimport {\n  type AgentBackend,\n  type AgentFailureReason,\n  type AgentKey,\n  type AgentRuntime,\n  isRefusal,\n} from '../agent/runtime.js';\nimport type {\n  CardItem,\n  MessageItem,\n  TimelineItem,\n} from '../conversation/view.js';\nimport type { Schemas } from '../events.js';\n\nexport type ConversationSummary = Schemas['ConversationSummary'];\ntype HistoryItem = Schemas['TimelineItem'];\n\n/**\n * The key a past conversation continues under for this person: its side and business as it was bound when it started\n * (`experience_mode`, `business_scope_id`), the `thread` given (default `chat`). For `runtime.continue(key, id)` and\n * `deleteConversation(key, id)`, so the device forgets it only where that key still continues it.\n */\nexport function continueKey(\n  conversation: ConversationSummary,\n  subject: string | null,\n  thread?: string,\n): AgentKey {\n  return {\n    subject,\n    mode: conversation.experience_mode,\n    scope: conversation.business_scope_id ?? null,\n    ...(thread ? { thread } : {}),\n  };\n}\n\n/**\n * A past conversation's items as the kits draw them: messages as sent (an `assistant` reply is the agent's, cut-off\n * replies and refusals marked), cards restored (drawn as they were, taking no answer or action), a proposal with the\n * outcome it had. Keyed by the server's ids, so pages merge without doubles.\n */\nexport function historyItems(data: readonly HistoryItem[]): TimelineItem[] {\n  return data.map((item, seq): TimelineItem => {\n    if (item.type === 'card') {\n      const outcome = item.proposal_outcome;\n      const card: CardItem = {\n        type: 'card',\n        key: item.card.id,\n        busy: false,\n        restored: true,\n        card: {\n          id: item.card.id,\n          kind: item.card.kind,\n          card: item.card as unknown as Readonly<Record<string, unknown>>,\n          locked: [],\n          turnId: item.turn_id,\n          outcome: outcome && outcome !== 'pending' ? outcome : null,\n          seq,\n        },\n      };\n      return card;\n    }\n    const message: MessageItem = {\n      type: 'message',\n      key: `h:${item.id}`,\n      role: item.role === 'assistant' ? 'agent' : item.role,\n      text: item.text,\n      state: 'sent',\n      ...(item.interrupted ? { partial: 'interrupted' as const } : {}),\n      ...(item.refusal ? { refusal: true as const } : {}),\n    };\n    return message;\n  });\n}\n\n/** Why a page could not be read, as the runtime says it. */\nfunction reasonOf(error: unknown): AgentFailureReason {\n  if (isRefusal(error)) return error.reason;\n  const given = (error as { reason?: unknown } | null)?.reason;\n  return typeof given === 'string' ? (given as AgentFailureReason) : 'unknown';\n}\n\n/**\n * The cursor restart (`vinaverse.agent-backend/1`): a page asked with a cursor, refused `unavailable`, not retryable,\n * with the gateway's `invalid_request`, had a cursor the gateway no longer takes (stale, or of other filters). Asked\n * again from the first page, once. Any other refusal is said as it is.\n */\nfunction staleCursor(error: unknown): boolean {\n  const e = error as {\n    outcome?: unknown;\n    gatewayCode?: unknown;\n    retryable?: unknown;\n  } | null;\n  return (\n    e?.outcome === 'unavailable' &&\n    e.gatewayCode === 'invalid_request' &&\n    e.retryable === false\n  );\n}\n\n/** A paged store: one page read at a time, dropped when it lands after a newer read or a sign-out. */\nfunction paged<S extends { readonly loading: boolean }>(\n  runtime: AgentRuntime,\n  empty: S,\n) {\n  let state = empty;\n  let epoch = runtime.epoch();\n  let asked = 0;\n  const listeners = new Set<() => void>();\n  const set = (next: Partial<S>) => {\n    state = { ...state, ...next };\n    for (const l of [...listeners]) l();\n  };\n  // A sign-out empties what the last person had, as soon as anyone listens again.\n  const fresh = () => {\n    if (runtime.epoch() === epoch) return;\n    epoch = runtime.epoch();\n    asked++;\n    state = empty;\n  };\n  let off: (() => void) | null = null;\n  return {\n    get: () => {\n      fresh();\n      return state;\n    },\n    set,\n    subscribe(listener: () => void) {\n      listeners.add(listener);\n      off ??= runtime.subscribe(() => {\n        const before = state;\n        fresh();\n        if (state !== before) for (const l of [...listeners]) l();\n      });\n      return () => {\n        listeners.delete(listener);\n        if (listeners.size === 0) {\n          off?.();\n          off = null;\n        }\n      };\n    },\n    /** Reads a page; `apply` lands only for the newest read, under the same person. */\n    read<T>(\n      call: () => Promise<T>,\n      apply: (value: T) => void,\n      failed: (error: unknown) => void,\n    ) {\n      fresh();\n      const mine = ++asked;\n      const under = epoch;\n      set({ loading: true } as Partial<S>);\n      call().then(\n        (value) => {\n          if (mine === asked && under === runtime.epoch()) apply(value);\n        },\n        (error: unknown) => {\n          if (mine === asked && under === runtime.epoch()) failed(error);\n        },\n      );\n    },\n  };\n}\n\nexport interface AgentHistoryState {\n  readonly conversations: readonly ConversationSummary[];\n  /** A page is being read. */\n  readonly loading: boolean;\n  /** Why the last page could not be read; null when it was. `off` when the backend serves no history. */\n  readonly failure: AgentFailureReason | null;\n  /** Every page is read. */\n  readonly done: boolean;\n  /** The first page was asked for. */\n  readonly started: boolean;\n}\n\nexport interface AgentHistory {\n  getSnapshot(): AgentHistoryState;\n  subscribe(listener: () => void): () => void;\n  /** Reads the first page anew: the first time, after a failure, or to see what changed. */\n  refresh(): void;\n  /** The next older page, when there is one and none is being read. */\n  loadMore(): void;\n  /** Reads again the page that failed: the first (as `refresh`), or the next. */\n  retry(): void;\n  /**\n   * Deletes a past conversation (the runtime's `deleteConversation` for the key that holds it, so the device forgets\n   * it only where the key still continues it) and drops its row. One already gone (`not_found`) is dropped too.\n   */\n  remove(key: AgentKey, conversationId: string): Promise<void>;\n}\n\nexport interface AgentHistoryOptions {\n  readonly runtime: AgentRuntime;\n  /** Default: the runtime's. */\n  readonly backend?: AgentBackend;\n  /** The app's side: `customer` or `business`. */\n  readonly mode: string;\n  /** The business acted for, with `business`. */\n  readonly scope?: string | null;\n  /** The agent, for a backend that serves more than one. */\n  readonly agent?: string | null;\n  /** Conversations per page (1–50). Default 20. */\n  readonly pageSize?: number;\n}\n\nconst NO_HISTORY: AgentHistoryState = {\n  conversations: [],\n  loading: false,\n  failure: null,\n  done: false,\n  started: false,\n};\n\n/** A person's past conversations, newest activity first. */\nexport function createAgentHistory(options: AgentHistoryOptions): AgentHistory {\n  const { runtime } = options;\n  const backend = options.backend ?? runtime.backend;\n  const store = paged(runtime, NO_HISTORY);\n  let cursor: string | null = null;\n  let restarted = false;\n  const page = (from: string | null) => {\n    const list = backend.listConversations?.bind(backend);\n    if (!list) {\n      store.set({ started: true, failure: 'off', done: true });\n      return;\n    }\n    store.read(\n      () =>\n        list({\n          mode: options.mode,\n          scope: options.scope ?? null,\n          agent: options.agent ?? null,\n          limit: options.pageSize ?? 20,\n          cursor: from,\n        }),\n      (got) => {\n        const known = new Set(\n          from ? store.get().conversations.map((c) => c.id) : [],\n        );\n        cursor = got.next_cursor;\n        store.set({\n          conversations: [\n            ...(from ? store.get().conversations : []),\n            ...got.data.filter((c) => !known.has(c.id)),\n          ],\n          loading: false,\n          failure: null,\n          done: cursor === null,\n        });\n      },\n      (error) => {\n        if (from !== null && staleCursor(error) && !restarted) {\n          restarted = true;\n          cursor = null;\n          page(null);\n          return;\n        }\n        store.set({ loading: false, failure: reasonOf(error) });\n      },\n    );\n  };\n  const refresh = () => {\n    cursor = null;\n    restarted = false;\n    store.set({ started: true });\n    page(null);\n  };\n  const loadMore = () => {\n    const s = store.get();\n    if (!s.started || s.loading || s.done || cursor === null) return;\n    page(cursor);\n  };\n  return {\n    getSnapshot: store.get,\n    subscribe: store.subscribe,\n    refresh,\n    loadMore,\n    retry: () => (cursor === null ? refresh() : loadMore()),\n    async remove(key, conversationId) {\n      try {\n        await runtime.deleteConversation(key, conversationId);\n      } catch (error) {\n        if (!(isRefusal(error) && error.reason === 'not_found')) throw error;\n      }\n      store.set({\n        conversations: store\n          .get()\n          .conversations.filter((c) => c.id !== conversationId),\n      });\n    },\n  };\n}\n\nexport interface AgentTranscriptState {\n  /** The conversation's items, oldest first, as the kits draw them (`historyItems`). */\n  readonly items: readonly TimelineItem[];\n  readonly loading: boolean;\n  /** Why the last page could not be read: `not_found` (deleted, or never theirs), `expired`, … */\n  readonly failure: AgentFailureReason | null;\n  /** Nothing earlier to read. */\n  readonly done: boolean;\n  readonly started: boolean;\n}\n\nexport interface AgentTranscript {\n  getSnapshot(): AgentTranscriptState;\n  subscribe(listener: () => void): () => void;\n  /** Reads the newest page anew. */\n  load(): void;\n  /** The page before the earliest read, prepended. */\n  loadEarlier(): void;\n  /** Reads again the page that failed: the newest (as `load`), or the earlier one. */\n  retry(): void;\n}\n\nexport interface AgentTranscriptOptions {\n  readonly runtime: AgentRuntime;\n  /** Default: the runtime's. */\n  readonly backend?: AgentBackend;\n  readonly conversationId: string;\n  /** Items per page. Default 30. */\n  readonly pageSize?: number;\n}\n\nconst NO_TRANSCRIPT: AgentTranscriptState = {\n  items: [],\n  loading: false,\n  failure: null,\n  done: false,\n  started: false,\n};\n\n/** A past conversation's transcript, read-only: newest page first, earlier pages prepended. */\nexport function createAgentTranscript(\n  options: AgentTranscriptOptions,\n): AgentTranscript {\n  const { runtime } = options;\n  const backend = options.backend ?? runtime.backend;\n  const store = paged(runtime, NO_TRANSCRIPT);\n  let cursor: string | null = null;\n  let restarted = false;\n  const page = (from: string | null) => {\n    const read = backend.readConversation?.bind(backend);\n    if (!read) {\n      store.set({ started: true, failure: 'off', done: true });\n      return;\n    }\n    store.read(\n      () =>\n        read(options.conversationId, {\n          limit: options.pageSize ?? 30,\n          cursor: from,\n        }),\n      (got) => {\n        const earlier = historyItems(got.data);\n        const held = from ? store.get().items : [];\n        const keys = new Set(held.map((i) => i.key));\n        cursor = got.next_cursor;\n        store.set({\n          items: [...earlier.filter((i) => !keys.has(i.key)), ...held],\n          loading: false,\n          failure: null,\n          done: cursor === null,\n        });\n      },\n      (error) => {\n        // An earlier page's cursor went stale: read back from the newest page, once.\n        if (from !== null && staleCursor(error) && !restarted) {\n          restarted = true;\n          cursor = null;\n          page(null);\n          return;\n        }\n        store.set({ loading: false, failure: reasonOf(error) });\n      },\n    );\n  };\n  const load = () => {\n    cursor = null;\n    restarted = false;\n    store.set({ started: true });\n    page(null);\n  };\n  const loadEarlier = () => {\n    const s = store.get();\n    if (!s.started || s.loading || s.done || cursor === null) return;\n    page(cursor);\n  };\n  return {\n    getSnapshot: store.get,\n    subscribe: store.subscribe,\n    load,\n    loadEarlier,\n    retry: () => (cursor === null ? load() : loadEarlier()),\n  };\n}\n"]}

package/dist/index.cjs

@@ -2,8 +2,8 @@
 
 // src/contract.ts
 var CONTRACT = {
-  api: "v1-draft.22",
-  commit: "4695e3dc042e6e0cf1936aae24fcb093eacd27c8"
+  api: "v1-draft.24",
+  commit: "a7fd1e0f13093b50c1ebdb5d5d0fe8b724daae39"
 };
 
 // src/engine.ts