@noodleseed/assistant 1.7.0 → 1.9.0

package/dist/react/client.d.cts

@@ -0,0 +1,24 @@
+import { A as AssistantPageContext, a as AssistantContext, C as CreateAssistantClientOptions, b as AssistantChatState, c as AssistantClient } from '../client-CsmtpD1z.cjs';
+import '../appearance-Cc-eqSbp.cjs';
+import 'ai';
+
+interface UseNoodleAssistantOptions<TPageContext extends AssistantPageContext = AssistantContext> extends CreateAssistantClientOptions<TPageContext> {
+    /**
+     * Browser-local identity for the authenticated principal/tenant.
+     * Changing it discards the previous in-memory session and transcript; it is never sent to Noodle.
+     */
+    readonly principalKey: string;
+}
+type UseNoodleAssistantResult<TPageContext extends AssistantPageContext = AssistantContext> = AssistantChatState & {
+    /** Canonical controller for turns, interactions, context, Apps requests, and aborts. */
+    readonly client: AssistantClient<TPageContext>;
+};
+/**
+ * Subscribe a customer-owned React renderer to the DOM-free assistant client.
+ *
+ * The hook owns only client lifetime and React state projection. Session exchange, transport,
+ * retries, interaction continuations, and transcript construction remain client responsibilities.
+ */
+declare function useNoodleAssistant<TPageContext extends AssistantPageContext = AssistantContext>(options: UseNoodleAssistantOptions<TPageContext>): UseNoodleAssistantResult<TPageContext>;
+
+export { type UseNoodleAssistantOptions, type UseNoodleAssistantResult, useNoodleAssistant };

package/dist/react/client.d.ts

@@ -0,0 +1,24 @@
+import { A as AssistantPageContext, a as AssistantContext, C as CreateAssistantClientOptions, b as AssistantChatState, c as AssistantClient } from '../client-B803xZVn.js';
+import '../appearance-Cc-eqSbp.js';
+import 'ai';
+
+interface UseNoodleAssistantOptions<TPageContext extends AssistantPageContext = AssistantContext> extends CreateAssistantClientOptions<TPageContext> {
+    /**
+     * Browser-local identity for the authenticated principal/tenant.
+     * Changing it discards the previous in-memory session and transcript; it is never sent to Noodle.
+     */
+    readonly principalKey: string;
+}
+type UseNoodleAssistantResult<TPageContext extends AssistantPageContext = AssistantContext> = AssistantChatState & {
+    /** Canonical controller for turns, interactions, context, Apps requests, and aborts. */
+    readonly client: AssistantClient<TPageContext>;
+};
+/**
+ * Subscribe a customer-owned React renderer to the DOM-free assistant client.
+ *
+ * The hook owns only client lifetime and React state projection. Session exchange, transport,
+ * retries, interaction continuations, and transcript construction remain client responsibilities.
+ */
+declare function useNoodleAssistant<TPageContext extends AssistantPageContext = AssistantContext>(options: UseNoodleAssistantOptions<TPageContext>): UseNoodleAssistantResult<TPageContext>;
+
+export { type UseNoodleAssistantOptions, type UseNoodleAssistantResult, useNoodleAssistant };

package/dist/react/client.js

@@ -0,0 +1,76 @@
+"use client";
+import {
+  createAssistantClient
+} from "../chunk-RYQBXTLR.js";
+import "../chunk-3YYTUJPJ.js";
+import "../chunk-5FUTL2UF.js";
+
+// src/react-client.ts
+import { useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from "react";
+var useCommittedLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+function useNoodleAssistant(options) {
+  const optionsRef = useRef(options);
+  const { fetch: injectedFetch, principalKey, sessionEndpoint } = options;
+  const client = useMemo(() => {
+    if (!principalKey.trim()) throw new Error("principalKey is required");
+    return createAssistantClient({
+      sessionEndpoint,
+      ...injectedFetch ? { fetch: injectedFetch } : {},
+      clientContext: () => readProvider(optionsRef.current.clientContext),
+      pageContext: () => readProvider(optionsRef.current.pageContext)
+    });
+  }, [injectedFetch, principalKey, sessionEndpoint]);
+  const store = useMemo(() => createAssistantReactStore(client), [client]);
+  const state = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+  const synchronized = useRef(void 0);
+  useCommittedLayoutEffect(() => {
+    optionsRef.current = options;
+    const previous = synchronized.current;
+    if (previous?.client === client) {
+      if (previous.context !== options.context) {
+        client.updateContext(options.context ?? {});
+      }
+      if (previous.modelContext !== options.modelContext) {
+        client.updateModelContext(options.modelContext ?? {});
+      }
+    } else {
+      if (options.context !== void 0) client.updateContext(options.context);
+      if (options.modelContext !== void 0) client.updateModelContext(options.modelContext);
+    }
+    synchronized.current = {
+      client,
+      context: options.context,
+      modelContext: options.modelContext
+    };
+  }, [client, options]);
+  useCommittedLayoutEffect(
+    () => () => {
+      client.abort();
+      client.resetSession();
+    },
+    [client]
+  );
+  return useMemo(() => ({ client, ...state }), [client, state]);
+}
+function createAssistantReactStore(client) {
+  let snapshot = client.getChatState();
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(listener) {
+      let subscribing = true;
+      const unsubscribe = client.subscribeChat((next) => {
+        snapshot = next;
+        if (!subscribing) listener();
+      });
+      subscribing = false;
+      return unsubscribe;
+    }
+  };
+}
+function readProvider(value) {
+  return typeof value === "function" ? value() : value;
+}
+export {
+  useNoodleAssistant
+};
+//# sourceMappingURL=client.js.map

package/dist/react/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react-client.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport {\n  type AssistantChatState,\n  type AssistantClient,\n  type AssistantContext,\n  type AssistantModelContextUpdate,\n  type AssistantPageContext,\n  type CreateAssistantClientOptions,\n  createAssistantClient,\n} from './client.js';\n\nexport interface UseNoodleAssistantOptions<\n  TPageContext extends AssistantPageContext = AssistantContext,\n> extends CreateAssistantClientOptions<TPageContext> {\n  /**\n   * Browser-local identity for the authenticated principal/tenant.\n   * Changing it discards the previous in-memory session and transcript; it is never sent to Noodle.\n   */\n  readonly principalKey: string;\n}\n\nexport type UseNoodleAssistantResult<TPageContext extends AssistantPageContext = AssistantContext> =\n  AssistantChatState & {\n    /** Canonical controller for turns, interactions, context, Apps requests, and aborts. */\n    readonly client: AssistantClient<TPageContext>;\n  };\n\ninterface AssistantReactStore {\n  readonly getSnapshot: () => AssistantChatState;\n  readonly subscribe: (listener: () => void) => () => void;\n}\n\nconst useCommittedLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\n/**\n * Subscribe a customer-owned React renderer to the DOM-free assistant client.\n *\n * The hook owns only client lifetime and React state projection. Session exchange, transport,\n * retries, interaction continuations, and transcript construction remain client responsibilities.\n */\nexport function useNoodleAssistant<TPageContext extends AssistantPageContext = AssistantContext>(\n  options: UseNoodleAssistantOptions<TPageContext>,\n): UseNoodleAssistantResult<TPageContext> {\n  const optionsRef = useRef(options);\n  const { fetch: injectedFetch, principalKey, sessionEndpoint } = options;\n\n  const client = useMemo(() => {\n    if (!principalKey.trim()) throw new Error('principalKey is required');\n    return createAssistantClient<TPageContext>({\n      sessionEndpoint,\n      ...(injectedFetch ? { fetch: injectedFetch } : {}),\n      clientContext: () => readProvider(optionsRef.current.clientContext),\n      pageContext: () => readProvider(optionsRef.current.pageContext),\n    });\n  }, [injectedFetch, principalKey, sessionEndpoint]);\n  const store = useMemo(() => createAssistantReactStore(client), [client]);\n  const state = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);\n  const synchronized = useRef<\n    | {\n        readonly client: AssistantClient<TPageContext>;\n        readonly context: AssistantContext | undefined;\n        readonly modelContext: AssistantModelContextUpdate | undefined;\n      }\n    | undefined\n  >(undefined);\n\n  useCommittedLayoutEffect(() => {\n    optionsRef.current = options;\n    const previous = synchronized.current;\n    if (previous?.client === client) {\n      if (previous.context !== options.context) {\n        client.updateContext(options.context ?? {});\n      }\n      if (previous.modelContext !== options.modelContext) {\n        client.updateModelContext(options.modelContext ?? {});\n      }\n    } else {\n      if (options.context !== undefined) client.updateContext(options.context);\n      if (options.modelContext !== undefined) client.updateModelContext(options.modelContext);\n    }\n    synchronized.current = {\n      client,\n      context: options.context,\n      modelContext: options.modelContext,\n    };\n  }, [client, options]);\n\n  useCommittedLayoutEffect(\n    () => () => {\n      client.abort();\n      client.resetSession();\n    },\n    [client],\n  );\n\n  return useMemo(() => ({ client, ...state }), [client, state]);\n}\n\nfunction createAssistantReactStore<TPageContext extends AssistantPageContext>(\n  client: AssistantClient<TPageContext>,\n): AssistantReactStore {\n  let snapshot = client.getChatState();\n  return {\n    getSnapshot: () => snapshot,\n    subscribe(listener) {\n      let subscribing = true;\n      const unsubscribe = client.subscribeChat((next) => {\n        snapshot = next;\n        if (!subscribing) listener();\n      });\n      subscribing = false;\n      return unsubscribe;\n    },\n  };\n}\n\nfunction readProvider<T>(value: T | (() => T | undefined) | undefined): T | undefined {\n  return typeof value === 'function' ? (value as () => T | undefined)() : value;\n}\n"],"mappings":";;;;;;;;AAEA,SAAS,WAAW,iBAAiB,SAAS,QAAQ,4BAA4B;AAgClF,IAAM,2BAA2B,OAAO,WAAW,cAAc,YAAY;AAQtE,SAAS,mBACd,SACwC;AACxC,QAAM,aAAa,OAAO,OAAO;AACjC,QAAM,EAAE,OAAO,eAAe,cAAc,gBAAgB,IAAI;AAEhE,QAAM,SAAS,QAAQ,MAAM;AAC3B,QAAI,CAAC,aAAa,KAAK,EAAG,OAAM,IAAI,MAAM,0BAA0B;AACpE,WAAO,sBAAoC;AAAA,MACzC;AAAA,MACA,GAAI,gBAAgB,EAAE,OAAO,cAAc,IAAI,CAAC;AAAA,MAChD,eAAe,MAAM,aAAa,WAAW,QAAQ,aAAa;AAAA,MAClE,aAAa,MAAM,aAAa,WAAW,QAAQ,WAAW;AAAA,IAChE,CAAC;AAAA,EACH,GAAG,CAAC,eAAe,cAAc,eAAe,CAAC;AACjD,QAAM,QAAQ,QAAQ,MAAM,0BAA0B,MAAM,GAAG,CAAC,MAAM,CAAC;AACvE,QAAM,QAAQ,qBAAqB,MAAM,WAAW,MAAM,aAAa,MAAM,WAAW;AACxF,QAAM,eAAe,OAOnB,MAAS;AAEX,2BAAyB,MAAM;AAC7B,eAAW,UAAU;AACrB,UAAM,WAAW,aAAa;AAC9B,QAAI,UAAU,WAAW,QAAQ;AAC/B,UAAI,SAAS,YAAY,QAAQ,SAAS;AACxC,eAAO,cAAc,QAAQ,WAAW,CAAC,CAAC;AAAA,MAC5C;AACA,UAAI,SAAS,iBAAiB,QAAQ,cAAc;AAClD,eAAO,mBAAmB,QAAQ,gBAAgB,CAAC,CAAC;AAAA,MACtD;AAAA,IACF,OAAO;AACL,UAAI,QAAQ,YAAY,OAAW,QAAO,cAAc,QAAQ,OAAO;AACvE,UAAI,QAAQ,iBAAiB,OAAW,QAAO,mBAAmB,QAAQ,YAAY;AAAA,IACxF;AACA,iBAAa,UAAU;AAAA,MACrB;AAAA,MACA,SAAS,QAAQ;AAAA,MACjB,cAAc,QAAQ;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,QAAQ,OAAO,CAAC;AAEpB;AAAA,IACE,MAAM,MAAM;AACV,aAAO,MAAM;AACb,aAAO,aAAa;AAAA,IACtB;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,SAAO,QAAQ,OAAO,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,KAAK,CAAC;AAC9D;AAEA,SAAS,0BACP,QACqB;AACrB,MAAI,WAAW,OAAO,aAAa;AACnC,SAAO;AAAA,IACL,aAAa,MAAM;AAAA,IACnB,UAAU,UAAU;AAClB,UAAI,cAAc;AAClB,YAAM,cAAc,OAAO,cAAc,CAAC,SAAS;AACjD,mBAAW;AACX,YAAI,CAAC,YAAa,UAAS;AAAA,MAC7B,CAAC;AACD,oBAAc;AACd,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAEA,SAAS,aAAgB,OAA6D;AACpF,SAAO,OAAO,UAAU,aAAc,MAA8B,IAAI;AAC1E;","names":[]}