@vinaverse/react 0.0.0-stage → 0.1.0-alpha.11

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,44 @@
-# Temporary Holding Version
+# @vinaverse/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React bindings of the Vinaverse conversation store (`@vinaverse/client/conversation`), and the copy and formatting
+every Vinaverse React UI shares. No `react-native` or DOM import: the same hooks serve React Native and the web. The
+styled React Native kit is `@vinaverse/react-native`.
+
+```tsx
+import { createConversation } from '@vinaverse/client/conversation';
+import { CopyProvider, useConversationSelector, useStreamingText } from '@vinaverse/react';
+
+const conversation = createConversation({ getSession: (req) => api.vinaverseSession(req), locale: 'es-US' });
+conversation.start();
+
+function Messages() {
+  const items = useConversationSelector(conversation, (v) => v.items); // re-renders only when items change
+  return items.map((item) => <Row key={item.key} item={item} />);
+}
+
+function Streaming({ id }: { id: string }) {
+  return <Text>{useStreamingText(conversation, id)}</Text>; // only this re-renders as the reply arrives
+}
+```
+
+- `useConversationSelector`, `useStreamingText`, `useConversation`: subscriptions, nothing more; every protocol rule
+  is in the store.
+- `CopyProvider` / `useCopy`: the words in English, Spanish and Brazilian Portuguese with the tenant's overrides on
+  top, from `@vinaverse/tokens/copy` (shared with the Angular kit and re-exported here with `createTranslate`,
+  `formatMoney`, `formatTimeRange`, `formatDate` and `textDirection`). The AI disclosure is never reworded in a
+  built-in language, and in another language only by a translation that still discloses.
+
+How it fits with the other kits: [docs/architecture/ui-kits.md](../../docs/architecture/ui-kits.md).
+
+## Install
+
+```sh
+npm install @vinaverse/react@alpha @vinaverse/client@alpha
+```
+
+Alphas are published under the `alpha` tag. Keep every `@vinaverse/*` package on the same version, so your app and the
+hooks share one copy of `@vinaverse/client`.
+
+## License
+
+Apache-2.0

package/dist/agent.cjs

@@ -0,0 +1,174 @@
+'use strict';
+
+var agent = require('@vinaverse/client/agent');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/agent.tsx
+var RuntimeContext = /* @__PURE__ */ react.createContext(null);
+function AgentRuntimeProvider(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx(RuntimeContext.Provider, { value: props.runtime, children: props.children });
+}
+function useAgentRuntime() {
+  const runtime = react.useContext(RuntimeContext);
+  if (!runtime)
+    throw new Error("Agent hooks render inside <AgentRuntimeProvider>.");
+  return runtime;
+}
+function useAgentConversation(key, open = {}) {
+  const runtime = useAgentRuntime();
+  const keyRef = react.useRef(key);
+  keyRef.current = key;
+  const k = agent.agentKey(key);
+  const read = react.useCallback(() => runtime.peek(keyRef.current), [runtime, k]);
+  const conversation = react.useSyncExternalStore(runtime.subscribe, read, read);
+  const openRef = react.useRef(open);
+  openRef.current = open;
+  react.useLayoutEffect(() => conversation.show(openRef.current), [conversation]);
+  const { place, entryPoint } = open;
+  const screen = place?.screen;
+  const entityType = place?.entity?.type;
+  const entityId = place?.entity?.id;
+  const filters = place?.filters ? JSON.stringify(place.filters) : null;
+  const cleared = place === null;
+  react.useLayoutEffect(() => {
+    conversation.tell(openRef.current);
+  }, [
+    conversation,
+    screen,
+    entityType,
+    entityId,
+    filters,
+    cleared,
+    entryPoint
+  ]);
+  const state = react.useSyncExternalStore(
+    conversation.subscribe,
+    conversation.getState,
+    conversation.getState
+  );
+  const startNew = react.useCallback(
+    () => runtime.startNew(keyRef.current),
+    [runtime]
+  );
+  return { conversation, state, startNew };
+}
+function useAgentStatus() {
+  const runtime = useAgentRuntime();
+  react.useEffect(() => {
+    runtime.status().catch(() => void 0);
+  }, [runtime]);
+  return react.useSyncExternalStore(
+    runtime.subscribe,
+    runtime.getStatus,
+    runtime.getStatus
+  );
+}
+function useAgentStatusState() {
+  const runtime = useAgentRuntime();
+  react.useEffect(() => {
+    runtime.status().catch(() => void 0);
+  }, [runtime]);
+  return react.useSyncExternalStore(
+    runtime.subscribe,
+    runtime.getStatusState,
+    runtime.getStatusState
+  );
+}
+function useAgentName(fallback) {
+  const runtime = useAgentRuntime();
+  return react.useSyncExternalStore(runtime.subscribe, runtime.getName, runtime.getName) ?? fallback;
+}
+function useAgentFeatures() {
+  const status = useAgentStatus();
+  return {
+    available: status?.available === true,
+    launcher: status?.launcher === true,
+    history: status?.features.history === true,
+    memory: status?.features.memory === true,
+    businessAgent: status?.features.businessAgent === true,
+    businessSetup: status?.features.businessSetup === true
+  };
+}
+function useAgentProfile(fallback) {
+  const status = useAgentStatus();
+  return { name: useAgentName(fallback), avatarUrl: status?.avatarUrl ?? null };
+}
+async function forgetGreeting(storage, subject, modes, storageKey = agent.greetedKey) {
+  for (const mode of modes) await storage.removeItem(storageKey(subject, mode));
+}
+var MEMORY = /* @__PURE__ */ new Map();
+var memory = {
+  getItem: (k) => MEMORY.get(k) ?? null,
+  setItem: (k, v) => void MEMORY.set(k, v),
+  removeItem: (k) => void MEMORY.delete(k)
+};
+function useAgentLauncher(options) {
+  const runtime = useAgentRuntime();
+  const status = useAgentStatus();
+  const { subject, mode, onOpen } = options;
+  const storage = options.storage ?? runtime.greetings ?? memory;
+  const shows = status?.launcher === true && options.visible !== false;
+  const key = (options.storageKey ?? agent.greetedKey)(subject, mode);
+  const [greeted, setGreeted] = react.useState(
+    null
+  );
+  const [due, setDue] = react.useState(null);
+  react.useEffect(() => {
+    let live = true;
+    Promise.resolve(storage.getItem(key)).then(
+      (value) => {
+        if (live) setGreeted({ key, done: value === "1" });
+      },
+      () => {
+        if (live) setGreeted({ key, done: false });
+      }
+    );
+    return () => {
+      live = false;
+    };
+  }, [storage, key]);
+  const pending = shows && greeted?.key === key && !greeted.done;
+  react.useEffect(() => {
+    if (!pending) return;
+    const timer = setTimeout(() => {
+      setDue(key);
+      runtime.emit({ type: "launcher_greeted" });
+    }, options.delayMs ?? 1200);
+    return () => clearTimeout(timer);
+  }, [pending, key, runtime, options.delayMs]);
+  const done = react.useCallback(() => {
+    setGreeted({ key, done: true });
+    void Promise.resolve(storage.setItem(key, "1")).catch(() => void 0);
+  }, [storage, key]);
+  const open = react.useCallback(() => {
+    done();
+    runtime.emit({ type: "launcher_opened" });
+    onOpen();
+  }, [done, runtime, onOpen]);
+  const dismiss = react.useCallback(() => {
+    done();
+    runtime.emit({ type: "greeting_closed" });
+  }, [done, runtime]);
+  react.useEffect(() => {
+    if (shows) runtime.emit({ type: "launcher_shown" });
+  }, [shows, runtime]);
+  return { shows, greets: pending && due === key, open, dismiss };
+}
+
+Object.defineProperty(exports, "greetedKey", {
+  enumerable: true,
+  get: function () { return agent.greetedKey; }
+});
+exports.AgentRuntimeProvider = AgentRuntimeProvider;
+exports.forgetGreeting = forgetGreeting;
+exports.useAgentConversation = useAgentConversation;
+exports.useAgentFeatures = useAgentFeatures;
+exports.useAgentLauncher = useAgentLauncher;
+exports.useAgentName = useAgentName;
+exports.useAgentProfile = useAgentProfile;
+exports.useAgentRuntime = useAgentRuntime;
+exports.useAgentStatus = useAgentStatus;
+exports.useAgentStatusState = useAgentStatusState;
+//# sourceMappingURL=agent.cjs.map
+//# sourceMappingURL=agent.cjs.map

package/dist/agent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent.tsx"],"names":["jsx","useContext","useRef","agentKey","useCallback","useSyncExternalStore","useLayoutEffect","useEffect","greetedKey","useState"],"mappings":"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","file":"agent.cjs","sourcesContent":["// React bindings of the agent runtime (@vinaverse/client/agent): a provider and hooks, thin by design. The runtime holds\n// every rule; these subscribe, show a conversation while a component is mounted, and read the launcher's state. No\n// react-native or DOM import.\nimport type {\n  AgentConversation,\n  AgentConversationState,\n  AgentKey,\n  AgentPlace,\n  AgentRuntime,\n  AgentStatus,\n  AgentStatusState,\n} from '@vinaverse/client/agent';\nimport { agentKey, greetedKey } from '@vinaverse/client/agent';\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\n\nconst RuntimeContext = /* @__PURE__ */ createContext<AgentRuntime | null>(null);\n\n/** The app's agent runtime, made once (module level, or memoized) and given to everything below. */\nexport function AgentRuntimeProvider(props: {\n  readonly runtime: AgentRuntime;\n  readonly children?: ReactNode;\n}): ReactNode {\n  return (\n    <RuntimeContext.Provider value={props.runtime}>\n      {props.children}\n    </RuntimeContext.Provider>\n  );\n}\n\nexport function useAgentRuntime(): AgentRuntime {\n  const runtime = useContext(RuntimeContext);\n  if (!runtime)\n    throw new Error('Agent hooks render inside <AgentRuntimeProvider>.');\n  return runtime;\n}\n\nexport interface UseAgentConversation {\n  readonly conversation: AgentConversation;\n  readonly state: AgentConversationState;\n  /** A new conversation for this key (the old one let go and forgotten). */\n  readonly startNew: () => void;\n}\n\n/**\n * The key's conversation, shown while the component is mounted (kept across screens; released when it unmounts), told\n * the place and the way in as they change. A start over or its end hands the component the key's next conversation.\n */\nexport function useAgentConversation(\n  key: AgentKey,\n  open: {\n    readonly place?: AgentPlace | null;\n    readonly entryPoint?: string | null;\n  } = {},\n): UseAgentConversation {\n  const runtime = useAgentRuntime();\n  const keyRef = useRef(key);\n  keyRef.current = key;\n  const k = agentKey(key);\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the key's string reads it again when the key changes\n  const read = useCallback(() => runtime.peek(keyRef.current), [runtime, k]);\n  const conversation = useSyncExternalStore(runtime.subscribe, read, read);\n  const openRef = useRef(open);\n  openRef.current = open;\n  // Layout effects: they run before any passive effect, a child's included, so a chat below that starts the\n  // conversation early (`VinaverseChat`) finds it shown and told the place.\n  useLayoutEffect(() => conversation.show(openRef.current), [conversation]);\n  const { place, entryPoint } = open;\n  const screen = place?.screen;\n  const entityType = place?.entity?.type;\n  const entityId = place?.entity?.id;\n  const filters = place?.filters ? JSON.stringify(place.filters) : null;\n  const cleared = place === null;\n  // biome-ignore lint/correctness/useExhaustiveDependencies: told by value, so a place made again each render is the same\n  useLayoutEffect(() => {\n    conversation.tell(openRef.current);\n  }, [\n    conversation,\n    screen,\n    entityType,\n    entityId,\n    filters,\n    cleared,\n    entryPoint,\n  ]);\n  const state = useSyncExternalStore(\n    conversation.subscribe,\n    conversation.getState,\n    conversation.getState,\n  );\n  const startNew = useCallback(\n    () => runtime.startNew(keyRef.current),\n    [runtime],\n  );\n  return { conversation, state, startNew };\n}\n\n/** The agent's status (read once, then at most every few minutes); null until the first read. */\nexport function useAgentStatus(): AgentStatus | null {\n  const runtime = useAgentRuntime();\n  useEffect(() => {\n    runtime.status().catch(() => undefined); // an unread status is no agent: the launcher stays hidden\n  }, [runtime]);\n  return useSyncExternalStore(\n    runtime.subscribe,\n    runtime.getStatus,\n    runtime.getStatus,\n  );\n}\n\n/**\n * The status with where its read stands (`{ status, reading, failed }`): a screen tells \"still reading\" from \"could\n * not read\" and draws each its own way. Reads the status, as `useAgentStatus` does.\n */\nexport function useAgentStatusState(): AgentStatusState {\n  const runtime = useAgentRuntime();\n  useEffect(() => {\n    runtime.status().catch(() => undefined); // said through `failed`\n  }, [runtime]);\n  return useSyncExternalStore(\n    runtime.subscribe,\n    runtime.getStatusState,\n    runtime.getStatusState,\n  );\n}\n\n/** The agent's name: the newest session's, else the status's, else `fallback`. */\nexport function useAgentName(fallback: string): string {\n  const runtime = useAgentRuntime();\n  return (\n    useSyncExternalStore(runtime.subscribe, runtime.getName, runtime.getName) ??\n    fallback\n  );\n}\n\n/** What the agent can do, from the status (all off until it is read, and when the agent is off). */\nexport function useAgentFeatures(): AgentStatus['features'] & {\n  readonly available: boolean;\n  readonly launcher: boolean;\n} {\n  const status = useAgentStatus();\n  return {\n    available: status?.available === true,\n    launcher: status?.launcher === true,\n    history: status?.features.history === true,\n    memory: status?.features.memory === true,\n    businessAgent: status?.features.businessAgent === true,\n    businessSetup: status?.features.businessSetup === true,\n  };\n}\n\n/** The agent as an entry shows it before any session: its name (`fallback` until known) and avatar. */\nexport function useAgentProfile(fallback: string): {\n  readonly name: string;\n  readonly avatarUrl: string | null;\n} {\n  const status = useAgentStatus();\n  return { name: useAgentName(fallback), avatarUrl: status?.avatarUrl ?? null };\n}\n\n/**\n * Where the launcher remembers that it greeted a person in a mode (sync or async; the app's preferences store). A\n * sign-out keeps it on purpose (a person is not greeted again after signing back in). Given to the runtime as\n * `greetingStorage`, `runtime.erase()` erases it; `forgetGreeting` is the low-level helper for a storage of the app's.\n */\nexport interface GreetingStorage {\n  getItem(key: string): string | null | Promise<string | null>;\n  setItem(key: string, value: string): void | Promise<void>;\n  /** Erasure removes the record, never leaves a key that names the person. */\n  removeItem(key: string): void | Promise<void>;\n}\n\n/** Where the greeting is remembered, per person and mode: the default the storage sees, unless the app maps its own. */\nexport { greetedKey };\n\n/** Removes the launcher's record of greeting this person in these modes (`runtime.erase()` does it for `greetingStorage`). */\nexport async function forgetGreeting(\n  storage: GreetingStorage,\n  subject: string | null,\n  modes: readonly string[],\n  storageKey: (subject: string | null, mode: string) => string = greetedKey,\n): Promise<void> {\n  for (const mode of modes) await storage.removeItem(storageKey(subject, mode));\n}\n\nconst MEMORY = new Map<string, string>();\nconst memory: GreetingStorage = {\n  getItem: (k) => MEMORY.get(k) ?? null,\n  setItem: (k, v) => void MEMORY.set(k, v),\n  removeItem: (k) => void MEMORY.delete(k),\n};\n\nexport interface UseAgentLauncher {\n  /** The status offers the launcher, and the app shows it here. */\n  readonly shows: boolean;\n  /** Its greeting bubble: once per person and mode, a moment after the launcher shows. */\n  readonly greets: boolean;\n  /** The person opens the agent (the greeting is done too). */\n  readonly open: () => void;\n  /** The person closes the greeting. */\n  readonly dismiss: () => void;\n}\n\n/** The floating launcher's state: whether it shows and greets, and its two actions. */\nexport function useAgentLauncher(options: {\n  readonly subject: string | null;\n  readonly mode: string;\n  /** The app's own rule (the tabs it shows on, no keyboard up…); default true. */\n  readonly visible?: boolean;\n  readonly storage?: GreetingStorage;\n  /** The storage's key for a person and mode, to reuse a record the app already keeps. Default `greetedKey`. */\n  readonly storageKey?: (subject: string | null, mode: string) => string;\n  /** How long after showing the greeting appears. Default 1200 ms. */\n  readonly delayMs?: number;\n  readonly onOpen: () => void;\n}): UseAgentLauncher {\n  const runtime = useAgentRuntime();\n  const status = useAgentStatus();\n  const { subject, mode, onOpen } = options;\n  // The app's own store, else the runtime's (`greetingStorage`: fenced by a sign-out, reached by `erase()`).\n  const storage = options.storage ?? runtime.greetings ?? memory;\n  const shows = status?.launcher === true && options.visible !== false;\n  const key = (options.storageKey ?? greetedKey)(subject, mode);\n  const [greeted, setGreeted] = useState<{ key: string; done: boolean } | null>(\n    null,\n  );\n  const [due, setDue] = useState<string | null>(null);\n  useEffect(() => {\n    let live = true;\n    Promise.resolve(storage.getItem(key)).then(\n      (value) => {\n        if (live) setGreeted({ key, done: value === '1' });\n      },\n      () => {\n        if (live) setGreeted({ key, done: false });\n      },\n    );\n    return () => {\n      live = false;\n    };\n  }, [storage, key]);\n  const pending = shows && greeted?.key === key && !greeted.done;\n  useEffect(() => {\n    if (!pending) return;\n    const timer = setTimeout(() => {\n      setDue(key);\n      runtime.emit({ type: 'launcher_greeted' });\n    }, options.delayMs ?? 1200);\n    return () => clearTimeout(timer);\n  }, [pending, key, runtime, options.delayMs]);\n  const done = useCallback(() => {\n    setGreeted({ key, done: true });\n    void Promise.resolve(storage.setItem(key, '1')).catch(() => undefined);\n  }, [storage, key]);\n  const open = useCallback(() => {\n    done();\n    runtime.emit({ type: 'launcher_opened' });\n    onOpen();\n  }, [done, runtime, onOpen]);\n  const dismiss = useCallback(() => {\n    done();\n    runtime.emit({ type: 'greeting_closed' });\n  }, [done, runtime]);\n  useEffect(() => {\n    if (shows) runtime.emit({ type: 'launcher_shown' });\n  }, [shows, runtime]);\n  return { shows, greets: pending && due === key, open, dismiss };\n}\n"]}

package/dist/agent.d.cts

@@ -0,0 +1,82 @@
+import { AgentRuntime, AgentConversation, AgentConversationState, AgentKey, AgentPlace, AgentStatus, AgentStatusState } from '@vinaverse/client/agent';
+export { greetedKey } from '@vinaverse/client/agent';
+import { ReactNode } from 'react';
+
+/** The app's agent runtime, made once (module level, or memoized) and given to everything below. */
+declare function AgentRuntimeProvider(props: {
+    readonly runtime: AgentRuntime;
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function useAgentRuntime(): AgentRuntime;
+interface UseAgentConversation {
+    readonly conversation: AgentConversation;
+    readonly state: AgentConversationState;
+    /** A new conversation for this key (the old one let go and forgotten). */
+    readonly startNew: () => void;
+}
+/**
+ * The key's conversation, shown while the component is mounted (kept across screens; released when it unmounts), told
+ * the place and the way in as they change. A start over or its end hands the component the key's next conversation.
+ */
+declare function useAgentConversation(key: AgentKey, open?: {
+    readonly place?: AgentPlace | null;
+    readonly entryPoint?: string | null;
+}): UseAgentConversation;
+/** The agent's status (read once, then at most every few minutes); null until the first read. */
+declare function useAgentStatus(): AgentStatus | null;
+/**
+ * The status with where its read stands (`{ status, reading, failed }`): a screen tells "still reading" from "could
+ * not read" and draws each its own way. Reads the status, as `useAgentStatus` does.
+ */
+declare function useAgentStatusState(): AgentStatusState;
+/** The agent's name: the newest session's, else the status's, else `fallback`. */
+declare function useAgentName(fallback: string): string;
+/** What the agent can do, from the status (all off until it is read, and when the agent is off). */
+declare function useAgentFeatures(): AgentStatus['features'] & {
+    readonly available: boolean;
+    readonly launcher: boolean;
+};
+/** The agent as an entry shows it before any session: its name (`fallback` until known) and avatar. */
+declare function useAgentProfile(fallback: string): {
+    readonly name: string;
+    readonly avatarUrl: string | null;
+};
+/**
+ * Where the launcher remembers that it greeted a person in a mode (sync or async; the app's preferences store). A
+ * sign-out keeps it on purpose (a person is not greeted again after signing back in). Given to the runtime as
+ * `greetingStorage`, `runtime.erase()` erases it; `forgetGreeting` is the low-level helper for a storage of the app's.
+ */
+interface GreetingStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    /** Erasure removes the record, never leaves a key that names the person. */
+    removeItem(key: string): void | Promise<void>;
+}
+
+/** Removes the launcher's record of greeting this person in these modes (`runtime.erase()` does it for `greetingStorage`). */
+declare function forgetGreeting(storage: GreetingStorage, subject: string | null, modes: readonly string[], storageKey?: (subject: string | null, mode: string) => string): Promise<void>;
+interface UseAgentLauncher {
+    /** The status offers the launcher, and the app shows it here. */
+    readonly shows: boolean;
+    /** Its greeting bubble: once per person and mode, a moment after the launcher shows. */
+    readonly greets: boolean;
+    /** The person opens the agent (the greeting is done too). */
+    readonly open: () => void;
+    /** The person closes the greeting. */
+    readonly dismiss: () => void;
+}
+/** The floating launcher's state: whether it shows and greets, and its two actions. */
+declare function useAgentLauncher(options: {
+    readonly subject: string | null;
+    readonly mode: string;
+    /** The app's own rule (the tabs it shows on, no keyboard up…); default true. */
+    readonly visible?: boolean;
+    readonly storage?: GreetingStorage;
+    /** The storage's key for a person and mode, to reuse a record the app already keeps. Default `greetedKey`. */
+    readonly storageKey?: (subject: string | null, mode: string) => string;
+    /** How long after showing the greeting appears. Default 1200 ms. */
+    readonly delayMs?: number;
+    readonly onOpen: () => void;
+}): UseAgentLauncher;
+
+export { AgentRuntimeProvider, type GreetingStorage, type UseAgentConversation, type UseAgentLauncher, forgetGreeting, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState };

package/dist/agent.d.ts

@@ -0,0 +1,82 @@
+import { AgentRuntime, AgentConversation, AgentConversationState, AgentKey, AgentPlace, AgentStatus, AgentStatusState } from '@vinaverse/client/agent';
+export { greetedKey } from '@vinaverse/client/agent';
+import { ReactNode } from 'react';
+
+/** The app's agent runtime, made once (module level, or memoized) and given to everything below. */
+declare function AgentRuntimeProvider(props: {
+    readonly runtime: AgentRuntime;
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function useAgentRuntime(): AgentRuntime;
+interface UseAgentConversation {
+    readonly conversation: AgentConversation;
+    readonly state: AgentConversationState;
+    /** A new conversation for this key (the old one let go and forgotten). */
+    readonly startNew: () => void;
+}
+/**
+ * The key's conversation, shown while the component is mounted (kept across screens; released when it unmounts), told
+ * the place and the way in as they change. A start over or its end hands the component the key's next conversation.
+ */
+declare function useAgentConversation(key: AgentKey, open?: {
+    readonly place?: AgentPlace | null;
+    readonly entryPoint?: string | null;
+}): UseAgentConversation;
+/** The agent's status (read once, then at most every few minutes); null until the first read. */
+declare function useAgentStatus(): AgentStatus | null;
+/**
+ * The status with where its read stands (`{ status, reading, failed }`): a screen tells "still reading" from "could
+ * not read" and draws each its own way. Reads the status, as `useAgentStatus` does.
+ */
+declare function useAgentStatusState(): AgentStatusState;
+/** The agent's name: the newest session's, else the status's, else `fallback`. */
+declare function useAgentName(fallback: string): string;
+/** What the agent can do, from the status (all off until it is read, and when the agent is off). */
+declare function useAgentFeatures(): AgentStatus['features'] & {
+    readonly available: boolean;
+    readonly launcher: boolean;
+};
+/** The agent as an entry shows it before any session: its name (`fallback` until known) and avatar. */
+declare function useAgentProfile(fallback: string): {
+    readonly name: string;
+    readonly avatarUrl: string | null;
+};
+/**
+ * Where the launcher remembers that it greeted a person in a mode (sync or async; the app's preferences store). A
+ * sign-out keeps it on purpose (a person is not greeted again after signing back in). Given to the runtime as
+ * `greetingStorage`, `runtime.erase()` erases it; `forgetGreeting` is the low-level helper for a storage of the app's.
+ */
+interface GreetingStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    /** Erasure removes the record, never leaves a key that names the person. */
+    removeItem(key: string): void | Promise<void>;
+}
+
+/** Removes the launcher's record of greeting this person in these modes (`runtime.erase()` does it for `greetingStorage`). */
+declare function forgetGreeting(storage: GreetingStorage, subject: string | null, modes: readonly string[], storageKey?: (subject: string | null, mode: string) => string): Promise<void>;
+interface UseAgentLauncher {
+    /** The status offers the launcher, and the app shows it here. */
+    readonly shows: boolean;
+    /** Its greeting bubble: once per person and mode, a moment after the launcher shows. */
+    readonly greets: boolean;
+    /** The person opens the agent (the greeting is done too). */
+    readonly open: () => void;
+    /** The person closes the greeting. */
+    readonly dismiss: () => void;
+}
+/** The floating launcher's state: whether it shows and greets, and its two actions. */
+declare function useAgentLauncher(options: {
+    readonly subject: string | null;
+    readonly mode: string;
+    /** The app's own rule (the tabs it shows on, no keyboard up…); default true. */
+    readonly visible?: boolean;
+    readonly storage?: GreetingStorage;
+    /** The storage's key for a person and mode, to reuse a record the app already keeps. Default `greetedKey`. */
+    readonly storageKey?: (subject: string | null, mode: string) => string;
+    /** How long after showing the greeting appears. Default 1200 ms. */
+    readonly delayMs?: number;
+    readonly onOpen: () => void;
+}): UseAgentLauncher;
+
+export { AgentRuntimeProvider, type GreetingStorage, type UseAgentConversation, type UseAgentLauncher, forgetGreeting, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState };

package/dist/agent.js

@@ -0,0 +1,3 @@
+export { AgentRuntimeProvider, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState } from './chunk-V4UBOVTK.js';
+//# sourceMappingURL=agent.js.map
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent.js"}