@promte/app-library 0.1.3 → 0.1.5

package/README.md

@@ -68,6 +68,10 @@ You can fetch configured models/capabilities from backend:
 const client = usePromteClient();
 const allModels = await client.models();
 const llmsOnly = await client.models({ type: "llm", configuredOnly: true });
+const embeddingsOnly = await client.models({
+  type: "embedding",
+  configuredOnly: true,
+});
 ```
 
 Or use the built-in hook:
@@ -81,6 +85,26 @@ const { models, loading, error, reload } = usePromteModels({
 
 Each model includes `id`, `label`, `type` (`llm` | `embedding` | `image` | `stt` | `tts`) and `configured`.
 
+## Embeddings
+
+Embeddings use the same app token/auth flow as LLM requests. Fetch an available
+embedding model, then create embeddings:
+
+```ts
+const client = usePromteClient();
+const [model] = await client.models({
+  type: "embedding",
+  configuredOnly: true,
+});
+
+const response = await client.embeddings.create({
+  model: model.id,
+  input: ["First text", "Second text"],
+});
+
+const vectors = response.data.map((item) => item.embedding);
+```
+
 ## Return behavior
 
 - `get()` returns the value at the current path, or `null` if missing.

package/dist/index.d.ts

@@ -73,6 +73,32 @@ export declare type ChatMessage = {
     content: string;
 };
 
+export declare type EmbeddingItem = {
+    object?: string;
+    embedding: number[] | string;
+    index: number;
+};
+
+export declare type EmbeddingsRequest = {
+    model: string;
+    input: string | string[];
+    encoding_format?: "float" | "base64";
+    dimensions?: number;
+    user?: string;
+};
+
+export declare type EmbeddingsResponse = {
+    object?: string;
+    data: EmbeddingItem[];
+    model?: string;
+    usage?: {
+        prompt_tokens?: number;
+        total_tokens?: number;
+        [key: string]: any;
+    };
+    [key: string]: any;
+};
+
 export declare function PromteAppProvider({ children, expectedParentOrigin, initTargetOrigin, retryInit, }: PromteAppProviderProps): JSX_2.Element;
 
 export declare type PromteAppProviderProps = {
@@ -92,11 +118,17 @@ export declare type PromteClient = {
     models(req?: PromteModelsRequest): Promise<PromteModelInfo[]>;
     chatCompletions(req: ChatCompletionsRequest): Promise<ChatCompletionsResponse>;
     chatText(req: ChatCompletionsRequest): Promise<string>;
+    embeddings: {
+        create(req: EmbeddingsRequest): Promise<EmbeddingsResponse>;
+    };
     audio: {
         tts(req: AudioTtsRequest): Promise<AudioTtsResponse>;
         stt(req: AudioSttRequest): Promise<AudioSttResponse>;
         voices(req?: AudioVoicesRequest): Promise<AudioVoiceInfo[]>;
     };
+    web: {
+        scrapeUrl(req: ScrapeUrlRequest): Promise<ScrapeUrlResponse>;
+    };
     data(scope?: AppDataScope): AppDataRef;
 };
 
@@ -145,6 +177,29 @@ export declare type PromteUser = {
 
 export declare type ReasoningEffort = "minimal" | "low" | "medium" | "high";
 
+export declare type ScrapeUrlRequest = {
+    url: string;
+    maxChars?: number;
+};
+
+export declare type ScrapeUrlResponse = {
+    requestedUrl: string;
+    url: string;
+    label: string;
+    text: string;
+    title?: string;
+    status?: number;
+    extractor?: string;
+    warning?: string;
+    cached?: boolean;
+    fallback?: {
+        provider?: string;
+        enabled?: boolean;
+        attempted?: boolean;
+        used?: boolean;
+    };
+};
+
 export declare function usePromte(): PromteCtxValue;
 
 export declare function usePromteClient(): PromteClient;

package/dist/index.mjs

@@ -1,275 +1,304 @@
 import { jsx as B } from "react/jsx-runtime";
-import { createContext as L, useState as j, useMemo as P, useCallback as M, useEffect as S, useContext as D } from "react";
-const U = L(null);
-function z({
-  children: f,
-  expectedParentOrigin: p,
-  initTargetOrigin: E,
-  retryInit: d = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
+import { createContext as L, useState as k, useMemo as x, useCallback as U, useEffect as T, useContext as D } from "react";
+const O = L(null);
+function N({
+  children: p,
+  expectedParentOrigin: d,
+  initTargetOrigin: v,
+  retryInit: l = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
 }) {
-  const [m, x] = j(null), [h, g] = j(null), [k, b] = j(null), [t, r] = j(null), [n, e] = j(null), o = P(() => n ? "booting" : m ? h ? "ready" : "waiting_for_token" : "waiting_for_settings", [m, h, n]), u = o === "ready", s = P(() => E || p || "*", [E, p]), i = M(() => {
-    var v;
+  const [m, $] = k(null), [y, j] = k(null), [h, b] = k(null), [E, t] = k(null), [r, e] = k(null), n = x(() => r ? "booting" : m ? y ? "ready" : "waiting_for_token" : "waiting_for_settings", [m, y, r]), s = n === "ready", c = x(() => v || d || "*", [v, d]), a = U(() => {
+    var o;
     try {
       const w = { type: "init" };
-      (v = window.parent) == null || v.postMessage(w, s);
+      (o = window.parent) == null || o.postMessage(w, c);
     } catch (w) {
       e((w == null ? void 0 : w.message) || "Failed to post init");
     }
-  }, [s]);
-  S(() => {
-    i();
-  }, [i]), S(() => {
-    if (!(d != null && d.enabled) || m) return;
-    const v = d.intervalMs ?? 500, w = d.maxAttempts ?? 20;
-    let c = 0;
-    const l = window.setInterval(() => {
+  }, [c]);
+  T(() => {
+    a();
+  }, [a]), T(() => {
+    if (!(l != null && l.enabled) || m) return;
+    const o = l.intervalMs ?? 500, w = l.maxAttempts ?? 20;
+    let i = 0;
+    const f = window.setInterval(() => {
       if (m) {
-        window.clearInterval(l);
+        window.clearInterval(f);
         return;
       }
-      if (c += 1, c > w) {
-        window.clearInterval(l);
+      if (i += 1, i > w) {
+        window.clearInterval(f);
         return;
       }
-      i();
-    }, v);
-    return () => window.clearInterval(l);
-  }, [d, m, i]), S(() => {
-    const v = (w) => {
-      if (p && w.origin !== p) return;
-      const c = w.data;
-      if (!(!c || typeof c != "object")) {
-        if (c.type === "set-settings") {
-          const l = c.value;
-          if (!(l != null && l.backendUrl) || l.parentOrigin && p && l.parentOrigin !== p)
+      a();
+    }, o);
+    return () => window.clearInterval(f);
+  }, [l, m, a]), T(() => {
+    const o = (w) => {
+      if (d && w.origin !== d) return;
+      const i = w.data;
+      if (!(!i || typeof i != "object")) {
+        if (i.type === "set-settings") {
+          const f = i.value;
+          if (!(f != null && f.backendUrl) || f.parentOrigin && d && f.parentOrigin !== d)
             return;
-          x(l), l != null && l.user && r(l.user), e(null);
+          $(f), f != null && f.user && t(f.user), e(null);
           return;
         }
-        if (c.type === "set-token" && typeof c.value == "string") {
-          g(c.value), e(null);
+        if (i.type === "set-token" && typeof i.value == "string") {
+          j(i.value), e(null);
           return;
         }
-        if (c.type === "set-dark-mode" && typeof c.value == "boolean") {
-          b(c.value);
+        if (i.type === "set-dark-mode" && typeof i.value == "boolean") {
+          b(i.value);
           return;
         }
-        if (c.type === "set-user" && typeof c.value == "object") {
-          r(c.value);
+        if (i.type === "set-user" && typeof i.value == "object") {
+          t(i.value);
           return;
         }
       }
     };
-    return window.addEventListener("message", v), () => window.removeEventListener("message", v);
-  }, [p]);
-  const y = P(() => O(
+    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
+  }, [d]);
+  const u = x(() => _(
     () => m,
-    () => h
-  ), [m, h]), a = P(
+    () => y
+  ), [m, y]), g = x(
     () => ({
       settings: m,
-      token: h,
-      isDarkMode: k,
-      user: t,
-      ready: u,
-      state: o,
-      error: n,
-      client: y
+      token: y,
+      isDarkMode: h,
+      user: E,
+      ready: s,
+      state: n,
+      error: r,
+      client: u
     }),
-    [m, h, k, t, u, o, n, y]
+    [m, y, h, E, s, n, r, u]
   );
-  return /* @__PURE__ */ B(U.Provider, { value: a, children: f });
+  return /* @__PURE__ */ B(O.Provider, { value: g, children: p });
 }
-function $() {
-  const f = D(U);
-  if (!f)
+function S() {
+  const p = D(O);
+  if (!p)
     throw new Error("usePromte must be used inside <PromteAppProvider>");
-  return f;
+  return p;
 }
-function J() {
-  return $().settings;
+function z() {
+  return S().settings;
 }
-function N() {
-  return $().token;
+function I() {
+  return S().token;
 }
 function V() {
-  return $().isDarkMode;
+  return S().isDarkMode;
 }
-function I() {
-  return $().user;
+function W() {
+  return S().user;
 }
 function F() {
-  return $().client;
+  return S().client;
 }
-function K(f = {}) {
-  const { ready: p } = $(), E = F(), [d, m] = j([]), [x, h] = j(!1), [g, k] = j(null), b = P(() => (Array.isArray(f.type) ? f.type : f.type ? [f.type] : []).filter(Boolean).map((o) => String(o)).join(","), [f.type]), t = f.configuredOnly === !0, r = f.auto !== !1, n = M(async () => {
-    if (!p) return [];
-    h(!0), k(null);
+function K(p = {}) {
+  const { ready: d } = S(), v = F(), [l, m] = k([]), [$, y] = k(!1), [j, h] = k(null), b = x(() => (Array.isArray(p.type) ? p.type : p.type ? [p.type] : []).filter(Boolean).map((n) => String(n)).join(","), [p.type]), E = p.configuredOnly === !0, t = p.auto !== !1, r = U(async () => {
+    if (!d) return [];
+    y(!0), h(null);
     try {
-      const e = b ? b.split(",").filter(Boolean) : void 0, o = await E.models({ type: e, configuredOnly: t });
-      return m(o), o;
+      const e = b ? b.split(",").filter(Boolean) : void 0, n = await v.models({ type: e, configuredOnly: E });
+      return m(n), n;
     } catch (e) {
-      const o = e instanceof Error ? e.message : String(e);
-      throw k(o), e;
+      const n = e instanceof Error ? e.message : String(e);
+      throw h(n), e;
     } finally {
-      h(!1);
+      y(!1);
     }
-  }, [E, t, p, b]);
-  return S(() => {
-    !r || !p || n().catch(() => {
+  }, [v, E, d, b]);
+  return T(() => {
+    !t || !d || r().catch(() => {
     });
-  }, [r, p, n]), { models: d, loading: x, error: g, reload: n };
+  }, [t, d, r]), { models: l, loading: $, error: j, reload: r };
 }
-function O(f, p) {
-  const E = (t) => typeof t == "string" && t.startsWith("gpt-5");
-  async function d(t, r) {
-    const n = f(), e = p();
-    if (!n) throw new Error("Promte settings not received yet");
-    if (!e) throw new Error("Promte token not received yet");
-    const o = n.backendUrl.replace(/\/+$/, ""), u = String(t || "").replace(/^\/+/, ""), s = `${o}/${u}`;
-    return await fetch(s, {
+function _(p, d) {
+  const v = (t) => typeof t == "string" && t.startsWith("gpt-5");
+  async function l(t, r) {
+    const e = p(), n = d();
+    if (!e) throw new Error("Promte settings not received yet");
+    if (!n) throw new Error("Promte token not received yet");
+    const s = e.backendUrl.replace(/\/+$/, ""), c = String(t || "").replace(/^\/+/, ""), a = `${s}/${c}`;
+    return await fetch(a, {
       ...r,
       headers: {
         ...r.headers || {},
-        Authorization: `Bearer ${e}`
+        Authorization: `Bearer ${n}`
       }
     });
   }
   async function m(t, r) {
-    const n = await d(`/app-api/data/${t}`, {
+    const e = await l(`/app-api/data/${t}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(r)
-    }), e = await n.json().catch(() => ({}));
-    if (!n.ok)
+    }), n = await e.json().catch(() => ({}));
+    if (!e.ok)
       throw new Error(
-        (e == null ? void 0 : e.error) || `Request failed (${n.status})`
+        (n == null ? void 0 : n.error) || `Request failed (${e.status})`
       );
-    return e == null ? void 0 : e.value;
+    return n == null ? void 0 : n.value;
   }
-  async function x(t) {
+  async function $(t) {
     const r = new URLSearchParams();
     t.scope && r.set("scope", t.scope), t.path && r.set("path", t.path);
-    const n = await d(`/app-api/data?${r.toString()}`, {
+    const e = await l(`/app-api/data?${r.toString()}`, {
       method: "GET"
-    }), e = await n.json().catch(() => ({}));
-    if (!n.ok)
-      throw new Error((e == null ? void 0 : e.error) || `Request failed (${n.status})`);
-    return e == null ? void 0 : e.value;
+    }), n = await e.json().catch(() => ({}));
+    if (!e.ok)
+      throw new Error((n == null ? void 0 : n.error) || `Request failed (${e.status})`);
+    return n == null ? void 0 : n.value;
   }
-  async function h(t) {
-    const r = new URLSearchParams(), n = Array.isArray(t == null ? void 0 : t.type) ? t == null ? void 0 : t.type : t != null && t.type ? [t.type] : [];
-    n.length > 0 && r.set("type", n.join(",")), t != null && t.configuredOnly && r.set("configuredOnly", "true");
-    const e = await d(
+  async function y(t) {
+    const r = new URLSearchParams(), e = Array.isArray(t == null ? void 0 : t.type) ? t == null ? void 0 : t.type : t != null && t.type ? [t.type] : [];
+    e.length > 0 && r.set("type", e.join(",")), t != null && t.configuredOnly && r.set("configuredOnly", "true");
+    const n = await l(
       `/app-api/models${r.toString() ? `?${r.toString()}` : ""}`,
       { method: "GET" }
-    ), o = await e.json().catch(() => ({}));
-    if (!e.ok)
-      throw new Error((o == null ? void 0 : o.error) || `Request failed (${e.status})`);
-    return (Array.isArray(o == null ? void 0 : o.models) ? o.models : []).map((s) => {
-      if (!s || typeof s != "object") return null;
-      const i = typeof s.id == "string" ? s.id.trim() : "", y = typeof s.label == "string" ? s.label.trim() : i, a = s.type, v = s.configured === !0, w = typeof s.source == "string" && s.source.trim() ? s.source.trim() : void 0;
-      return !i || a !== "llm" && a !== "embedding" && a !== "image" && a !== "stt" && a !== "tts" ? null : {
-        id: i,
-        label: y || i,
-        type: a,
-        configured: v,
-        source: w
+    ), s = await n.json().catch(() => ({}));
+    if (!n.ok)
+      throw new Error((s == null ? void 0 : s.error) || `Request failed (${n.status})`);
+    return (Array.isArray(s == null ? void 0 : s.models) ? s.models : []).map((a) => {
+      if (!a || typeof a != "object") return null;
+      const u = typeof a.id == "string" ? a.id.trim() : "", g = typeof a.label == "string" ? a.label.trim() : u, o = a.type, w = a.configured === !0, i = typeof a.source == "string" && a.source.trim() ? a.source.trim() : void 0;
+      return !u || o !== "llm" && o !== "embedding" && o !== "image" && o !== "stt" && o !== "tts" ? null : {
+        id: u,
+        label: g || u,
+        type: o,
+        configured: w,
+        source: i
       };
     }).filter(
-      (s) => !!s
+      (a) => !!a
     );
   }
-  const g = (t) => t ? t.split("/").map((r) => r.trim()).filter(Boolean).join("/") : "", k = (t, r) => {
-    const n = g(t), e = g(r);
-    return n ? e ? `${n}/${e}` : n : e;
-  }, b = (t, r) => {
-    const n = { scope: t };
+  async function j(t, r) {
+    const e = await l(t, r), s = (e.headers.get("content-type") || "").includes("application/json") ? await e.json().catch(() => ({})) : await e.text();
+    if (!e.ok)
+      throw new Error(
+        typeof s == "string" ? s || `Request failed (${e.status})` : (s == null ? void 0 : s.error) || (s == null ? void 0 : s.message) || `Request failed (${e.status})`
+      );
+    return s;
+  }
+  const h = (t) => t ? t.split("/").map((r) => r.trim()).filter(Boolean).join("/") : "", b = (t, r) => {
+    const e = h(t), n = h(r);
+    return e ? n ? `${e}/${n}` : e : n;
+  }, E = (t, r) => {
+    const e = { scope: t };
     return {
       async get() {
-        const e = g(r);
-        return x({ ...n, path: e || void 0 });
+        const n = h(r);
+        return $({ ...e, path: n || void 0 });
       },
-      async set(e) {
-        const o = g(r);
+      async set(n) {
+        const s = h(r);
         return m("set", {
-          ...n,
-          path: o || void 0,
-          value: e
+          ...e,
+          path: s || void 0,
+          value: n
         });
       },
-      async update(e) {
-        if (!e || typeof e != "object")
+      async update(n) {
+        if (!n || typeof n != "object")
           throw new Error("update requires an object");
-        const o = {};
-        for (const [u, s] of Object.entries(e)) {
-          const i = k(r, u);
-          if (!i)
+        const s = {};
+        for (const [c, a] of Object.entries(n)) {
+          const u = b(r, c);
+          if (!u)
             throw new Error("update paths must be non-empty");
-          o[i] = s;
+          s[u] = a;
         }
-        return m("update", { ...n, updates: o });
+        return m("update", { ...e, updates: s });
       },
       async remove() {
-        const e = g(r);
-        return m("remove", { ...n, path: e || void 0 });
+        const n = h(r);
+        return m("remove", { ...e, path: n || void 0 });
       },
-      async push(e) {
-        const o = g(r);
-        if (!o) throw new Error("push requires a path");
-        return m("array-push", { ...n, path: o, value: e });
+      async push(n) {
+        const s = h(r);
+        if (!s) throw new Error("push requires a path");
+        return m("array-push", { ...e, path: s, value: n });
       },
-      ref(e) {
-        const o = k(r, e);
-        if (!o) throw new Error("ref requires a path");
-        return b(t, o);
+      ref(n) {
+        const s = b(r, n);
+        if (!s) throw new Error("ref requires a path");
+        return E(t, s);
       }
     };
   };
   return {
     isReady() {
-      return !!f() && !!p();
+      return !!p() && !!d();
     },
     getBackendUrl() {
       var t;
-      return ((t = f()) == null ? void 0 : t.backendUrl) ?? null;
+      return ((t = p()) == null ? void 0 : t.backendUrl) ?? null;
     },
     async models(t) {
-      return h(t);
+      return y(t);
     },
     async chatCompletions(t) {
-      var a;
+      var o;
       const {
         reasoningEffort: r,
-        reasoning_effort: n,
-        ...e
-      } = t, o = r ?? n, u = {
-        ...e,
+        reasoning_effort: e,
+        ...n
+      } = t, s = r ?? e, c = {
+        ...n,
         stream: !1
       };
-      o && E(t.model) && (u.reasoning_effort = o);
-      const s = await d("/openai/chat/completions", {
+      s && v(t.model) && (c.reasoning_effort = s);
+      const a = await l("/openai/chat/completions", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(u)
-      }), y = (s.headers.get("content-type") || "").includes("application/json") ? await s.json() : await s.text();
-      if (!s.ok)
+        body: JSON.stringify(c)
+      }), g = (a.headers.get("content-type") || "").includes("application/json") ? await a.json() : await a.text();
+      if (!a.ok)
         throw new Error(
-          typeof y == "string" ? y : ((a = y == null ? void 0 : y.error) == null ? void 0 : a.message) || `Request failed (${s.status})`
+          typeof g == "string" ? g : ((o = g == null ? void 0 : g.error) == null ? void 0 : o.message) || `Request failed (${a.status})`
         );
-      return y;
+      return g;
     },
     async chatText(t) {
-      var n, e, o;
+      var e, n, s;
       const r = await this.chatCompletions(t);
-      return ((o = (e = (n = r == null ? void 0 : r.choices) == null ? void 0 : n[0]) == null ? void 0 : e.message) == null ? void 0 : o.content) ?? "";
+      return ((s = (n = (e = r == null ? void 0 : r.choices) == null ? void 0 : e[0]) == null ? void 0 : n.message) == null ? void 0 : s.content) ?? "";
+    },
+    embeddings: {
+      async create(t) {
+        var s;
+        const r = (s = t == null ? void 0 : t.model) == null ? void 0 : s.trim();
+        if (!r) throw new Error("embeddings.create requires a model");
+        const e = t == null ? void 0 : t.input;
+        if (!(typeof e == "string" ? e.length > 0 : Array.isArray(e) && e.length > 0 && e.every((c) => typeof c == "string")))
+          throw new Error(
+            "embeddings.create requires input as a string or string[]"
+          );
+        return j("/openai/embeddings", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            ...t,
+            model: r,
+            input: e
+          })
+        });
+      }
     },
     audio: {
       async tts(t) {
-        var o;
-        const r = (o = t == null ? void 0 : t.text) == null ? void 0 : o.trim();
+        var s;
+        const r = (s = t == null ? void 0 : t.text) == null ? void 0 : s.trim();
         if (!r) throw new Error("audio.tts requires non-empty text");
-        const n = await d("/app-api/audio/tts", {
+        const e = await l("/app-api/audio/tts", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
@@ -278,67 +307,85 @@ function O(f, p) {
             lang: t.lang
           })
         });
-        if (!n.ok) {
-          const u = await n.text();
-          throw new Error(u || `Request failed (${n.status})`);
+        if (!e.ok) {
+          const c = await e.text();
+          throw new Error(c || `Request failed (${e.status})`);
         }
         return {
-          audio: await n.arrayBuffer(),
-          contentType: n.headers.get("content-type")
+          audio: await e.arrayBuffer(),
+          contentType: e.headers.get("content-type")
         };
       },
       async stt(t) {
-        var w, c, l;
+        var i, f, P;
         if (!(t != null && t.file)) throw new Error("audio.stt requires a file");
         const r = (R) => {
           if (!R) return;
-          const T = R.trim();
-          if (!T) return;
-          const A = T.toLowerCase(), C = A.split("-")[0];
-          return C.length === 2 ? C : A;
-        }, n = typeof File < "u" && t.file instanceof File, e = n && t.file.name.split(".").pop() || "webm", o = t.ext || e, u = new FormData();
-        n ? u.set("file", t.file) : u.set("file", t.file, `audio.${o}`);
-        const s = r(t.language);
-        s && u.set("language", s), t.prompt && u.set("prompt", t.prompt);
-        const i = await d(
-          `/app-api/audio/stt?ext=${encodeURIComponent(o)}`,
+          const C = R.trim();
+          if (!C) return;
+          const A = C.toLowerCase(), M = A.split("-")[0];
+          return M.length === 2 ? M : A;
+        }, e = typeof File < "u" && t.file instanceof File, n = e && t.file.name.split(".").pop() || "webm", s = t.ext || n, c = new FormData();
+        e ? c.set("file", t.file) : c.set("file", t.file, `audio.${s}`);
+        const a = r(t.language);
+        a && c.set("language", a), t.prompt && c.set("prompt", t.prompt);
+        const u = await l(
+          `/app-api/audio/stt?ext=${encodeURIComponent(s)}`,
           {
             method: "POST",
-            body: u
+            body: c
           }
-        ), a = (i.headers.get("content-type") || "").includes("application/json") ? await i.json() : await i.text();
-        if (!i.ok)
+        ), o = (u.headers.get("content-type") || "").includes("application/json") ? await u.json() : await u.text();
+        if (!u.ok)
           throw new Error(
-            typeof a == "string" ? a : ((w = a == null ? void 0 : a.error) == null ? void 0 : w.message) || `Request failed (${i.status})`
+            typeof o == "string" ? o : ((i = o == null ? void 0 : o.error) == null ? void 0 : i.message) || `Request failed (${u.status})`
           );
-        return { text: typeof a == "string" ? a : (a == null ? void 0 : a.text) || (a == null ? void 0 : a.original) || ((l = (c = a == null ? void 0 : a.results) == null ? void 0 : c[0]) == null ? void 0 : l.text) || "", raw: a };
+        return { text: typeof o == "string" ? o : (o == null ? void 0 : o.text) || (o == null ? void 0 : o.original) || ((P = (f = o == null ? void 0 : o.results) == null ? void 0 : f[0]) == null ? void 0 : P.text) || "", raw: o };
       },
       async voices(t) {
         const r = new URLSearchParams();
         t != null && t.locale && r.set("locale", t.locale);
-        const n = await d(
+        const e = await l(
           `/app-api/audio/tts/voices${r.toString() ? `?${r}` : ""}`,
           { method: "GET" }
-        ), e = await n.json().catch(() => []);
-        if (!n.ok)
+        ), n = await e.json().catch(() => []);
+        if (!e.ok)
           throw new Error(
-            (e == null ? void 0 : e.error) || `Request failed (${n.status})`
+            (n == null ? void 0 : n.error) || `Request failed (${e.status})`
           );
-        return Array.isArray(e) ? e : (e == null ? void 0 : e.voices) || [];
+        return Array.isArray(n) ? n : (n == null ? void 0 : n.voices) || [];
+      }
+    },
+    web: {
+      async scrapeUrl(t) {
+        var e;
+        const r = (e = t == null ? void 0 : t.url) == null ? void 0 : e.trim();
+        if (!r) throw new Error("web.scrapeUrl requires a url");
+        return j(
+          "/app-api/web/scrape-url",
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              url: r,
+              maxChars: t.maxChars
+            })
+          }
+        );
       }
     },
     data(t = "private") {
-      return b(t, "");
+      return E(t, "");
     }
   };
 }
 export {
-  z as PromteAppProvider,
-  $ as usePromte,
+  N as PromteAppProvider,
+  S as usePromte,
   F as usePromteClient,
   V as usePromteDarkMode,
   K as usePromteModels,
-  J as usePromteSettings,
-  N as usePromteToken,
-  I as usePromteUser
+  z as usePromteSettings,
+  I as usePromteToken,
+  W as usePromteUser
 };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(y,M){typeof exports=="object"&&typeof module<"u"?M(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],M):(y=typeof globalThis<"u"?globalThis:y||self,M(y.PromteAppLibrary={},y.jsxRuntime,y.react))})(this,function(y,M,i){"use strict";const T=i.createContext(null);function L({children:p,expectedParentOrigin:d,initTargetOrigin:P,retryInit:m={enabled:!0,intervalMs:500,maxAttempts:20}}){const[w,$]=i.useState(null),[v,E]=i.useState(null),[b,S]=i.useState(null),[t,s]=i.useState(null),[n,e]=i.useState(null),o=i.useMemo(()=>n?"booting":w?v?"ready":"waiting_for_token":"waiting_for_settings",[w,v,n]),f=o==="ready",r=i.useMemo(()=>P||d||"*",[P,d]),u=i.useCallback(()=>{var k;try{const h={type:"init"};(k=window.parent)==null||k.postMessage(h,r)}catch(h){e((h==null?void 0:h.message)||"Failed to post init")}},[r]);i.useEffect(()=>{u()},[u]),i.useEffect(()=>{if(!(m!=null&&m.enabled)||w)return;const k=m.intervalMs??500,h=m.maxAttempts??20;let c=0;const l=window.setInterval(()=>{if(w){window.clearInterval(l);return}if(c+=1,c>h){window.clearInterval(l);return}u()},k);return()=>window.clearInterval(l)},[m,w,u]),i.useEffect(()=>{const k=h=>{if(d&&h.origin!==d)return;const c=h.data;if(!(!c||typeof c!="object")){if(c.type==="set-settings"){const l=c.value;if(!(l!=null&&l.backendUrl)||l.parentOrigin&&d&&l.parentOrigin!==d)return;$(l),l!=null&&l.user&&s(l.user),e(null);return}if(c.type==="set-token"&&typeof c.value=="string"){E(c.value),e(null);return}if(c.type==="set-dark-mode"&&typeof c.value=="boolean"){S(c.value);return}if(c.type==="set-user"&&typeof c.value=="object"){s(c.value);return}}};return window.addEventListener("message",k),()=>window.removeEventListener("message",k)},[d]);const g=i.useMemo(()=>G(()=>w,()=>v),[w,v]),a=i.useMemo(()=>({settings:w,token:v,isDarkMode:b,user:t,ready:f,state:o,error:n,client:g}),[w,v,b,t,f,o,n,g]);return M.jsx(T.Provider,{value:a,children:p})}function j(){const p=i.useContext(T);if(!p)throw new Error("usePromte must be used inside <PromteAppProvider>");return p}function B(){return j().settings}function D(){return j().token}function O(){return j().isDarkMode}function F(){return j().user}function R(){return j().client}function _(p={}){const{ready:d}=j(),P=R(),[m,w]=i.useState([]),[$,v]=i.useState(!1),[E,b]=i.useState(null),S=i.useMemo(()=>(Array.isArray(p.type)?p.type:p.type?[p.type]:[]).filter(Boolean).map(o=>String(o)).join(","),[p.type]),t=p.configuredOnly===!0,s=p.auto!==!1,n=i.useCallback(async()=>{if(!d)return[];v(!0),b(null);try{const e=S?S.split(",").filter(Boolean):void 0,o=await P.models({type:e,configuredOnly:t});return w(o),o}catch(e){const o=e instanceof Error?e.message:String(e);throw b(o),e}finally{v(!1)}},[P,t,d,S]);return i.useEffect(()=>{!s||!d||n().catch(()=>{})},[s,d,n]),{models:m,loading:$,error:E,reload:n}}function G(p,d){const P=t=>typeof t=="string"&&t.startsWith("gpt-5");async function m(t,s){const n=p(),e=d();if(!n)throw new Error("Promte settings not received yet");if(!e)throw new Error("Promte token not received yet");const o=n.backendUrl.replace(/\/+$/,""),f=String(t||"").replace(/^\/+/,""),r=`${o}/${f}`;return await fetch(r,{...s,headers:{...s.headers||{},Authorization:`Bearer ${e}`}})}async function w(t,s){const n=await m(`/app-api/data/${t}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)}),e=await n.json().catch(()=>({}));if(!n.ok)throw new Error((e==null?void 0:e.error)||`Request failed (${n.status})`);return e==null?void 0:e.value}async function $(t){const s=new URLSearchParams;t.scope&&s.set("scope",t.scope),t.path&&s.set("path",t.path);const n=await m(`/app-api/data?${s.toString()}`,{method:"GET"}),e=await n.json().catch(()=>({}));if(!n.ok)throw new Error((e==null?void 0:e.error)||`Request failed (${n.status})`);return e==null?void 0:e.value}async function v(t){const s=new URLSearchParams,n=Array.isArray(t==null?void 0:t.type)?t==null?void 0:t.type:t!=null&&t.type?[t.type]:[];n.length>0&&s.set("type",n.join(",")),t!=null&&t.configuredOnly&&s.set("configuredOnly","true");const e=await m(`/app-api/models${s.toString()?`?${s.toString()}`:""}`,{method:"GET"}),o=await e.json().catch(()=>({}));if(!e.ok)throw new Error((o==null?void 0:o.error)||`Request failed (${e.status})`);return(Array.isArray(o==null?void 0:o.models)?o.models:[]).map(r=>{if(!r||typeof r!="object")return null;const u=typeof r.id=="string"?r.id.trim():"",g=typeof r.label=="string"?r.label.trim():u,a=r.type,k=r.configured===!0,h=typeof r.source=="string"&&r.source.trim()?r.source.trim():void 0;return!u||a!=="llm"&&a!=="embedding"&&a!=="image"&&a!=="stt"&&a!=="tts"?null:{id:u,label:g||u,type:a,configured:k,source:h}}).filter(r=>!!r)}const E=t=>t?t.split("/").map(s=>s.trim()).filter(Boolean).join("/"):"",b=(t,s)=>{const n=E(t),e=E(s);return n?e?`${n}/${e}`:n:e},S=(t,s)=>{const n={scope:t};return{async get(){const e=E(s);return $({...n,path:e||void 0})},async set(e){const o=E(s);return w("set",{...n,path:o||void 0,value:e})},async update(e){if(!e||typeof e!="object")throw new Error("update requires an object");const o={};for(const[f,r]of Object.entries(e)){const u=b(s,f);if(!u)throw new Error("update paths must be non-empty");o[u]=r}return w("update",{...n,updates:o})},async remove(){const e=E(s);return w("remove",{...n,path:e||void 0})},async push(e){const o=E(s);if(!o)throw new Error("push requires a path");return w("array-push",{...n,path:o,value:e})},ref(e){const o=b(s,e);if(!o)throw new Error("ref requires a path");return S(t,o)}}};return{isReady(){return!!p()&&!!d()},getBackendUrl(){var t;return((t=p())==null?void 0:t.backendUrl)??null},async models(t){return v(t)},async chatCompletions(t){var a;const{reasoningEffort:s,reasoning_effort:n,...e}=t,o=s??n,f={...e,stream:!1};o&&P(t.model)&&(f.reasoning_effort=o);const r=await m("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(f)}),g=(r.headers.get("content-type")||"").includes("application/json")?await r.json():await r.text();if(!r.ok)throw new Error(typeof g=="string"?g:((a=g==null?void 0:g.error)==null?void 0:a.message)||`Request failed (${r.status})`);return g},async chatText(t){var n,e,o;const s=await this.chatCompletions(t);return((o=(e=(n=s==null?void 0:s.choices)==null?void 0:n[0])==null?void 0:e.message)==null?void 0:o.content)??""},audio:{async tts(t){var o;const s=(o=t==null?void 0:t.text)==null?void 0:o.trim();if(!s)throw new Error("audio.tts requires non-empty text");const n=await m("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:s,voice:t.voice,lang:t.lang})});if(!n.ok){const f=await n.text();throw new Error(f||`Request failed (${n.status})`)}return{audio:await n.arrayBuffer(),contentType:n.headers.get("content-type")}},async stt(t){var h,c,l;if(!(t!=null&&t.file))throw new Error("audio.stt requires a file");const s=x=>{if(!x)return;const A=x.trim();if(!A)return;const C=A.toLowerCase(),U=C.split("-")[0];return U.length===2?U:C},n=typeof File<"u"&&t.file instanceof File,e=n&&t.file.name.split(".").pop()||"webm",o=t.ext||e,f=new FormData;n?f.set("file",t.file):f.set("file",t.file,`audio.${o}`);const r=s(t.language);r&&f.set("language",r),t.prompt&&f.set("prompt",t.prompt);const u=await m(`/app-api/audio/stt?ext=${encodeURIComponent(o)}`,{method:"POST",body:f}),a=(u.headers.get("content-type")||"").includes("application/json")?await u.json():await u.text();if(!u.ok)throw new Error(typeof a=="string"?a:((h=a==null?void 0:a.error)==null?void 0:h.message)||`Request failed (${u.status})`);return{text:typeof a=="string"?a:(a==null?void 0:a.text)||(a==null?void 0:a.original)||((l=(c=a==null?void 0:a.results)==null?void 0:c[0])==null?void 0:l.text)||"",raw:a}},async voices(t){const s=new URLSearchParams;t!=null&&t.locale&&s.set("locale",t.locale);const n=await m(`/app-api/audio/tts/voices${s.toString()?`?${s}`:""}`,{method:"GET"}),e=await n.json().catch(()=>[]);if(!n.ok)throw new Error((e==null?void 0:e.error)||`Request failed (${n.status})`);return Array.isArray(e)?e:(e==null?void 0:e.voices)||[]}},data(t="private"){return S(t,"")}}}y.PromteAppProvider=L,y.usePromte=j,y.usePromteClient=R,y.usePromteDarkMode=O,y.usePromteModels=_,y.usePromteSettings=B,y.usePromteToken=D,y.usePromteUser=F,Object.defineProperty(y,Symbol.toStringTag,{value:"Module"})});
+(function(w,T){typeof exports=="object"&&typeof module<"u"?T(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],T):(w=typeof globalThis<"u"?globalThis:w||self,T(w.PromteAppLibrary={},w.jsxRuntime,w.react))})(this,function(w,T,a){"use strict";const M=a.createContext(null);function L({children:d,expectedParentOrigin:m,initTargetOrigin:E,retryInit:l={enabled:!0,intervalMs:500,maxAttempts:20}}){const[y,$]=a.useState(null),[v,j]=a.useState(null),[g,S]=a.useState(null),[P,t]=a.useState(null),[s,e]=a.useState(null),n=a.useMemo(()=>s?"booting":y?v?"ready":"waiting_for_token":"waiting_for_settings",[y,v,s]),r=n==="ready",c=a.useMemo(()=>E||m||"*",[E,m]),i=a.useCallback(()=>{var o;try{const h={type:"init"};(o=window.parent)==null||o.postMessage(h,c)}catch(h){e((h==null?void 0:h.message)||"Failed to post init")}},[c]);a.useEffect(()=>{i()},[i]),a.useEffect(()=>{if(!(l!=null&&l.enabled)||y)return;const o=l.intervalMs??500,h=l.maxAttempts??20;let u=0;const p=window.setInterval(()=>{if(y){window.clearInterval(p);return}if(u+=1,u>h){window.clearInterval(p);return}i()},o);return()=>window.clearInterval(p)},[l,y,i]),a.useEffect(()=>{const o=h=>{if(m&&h.origin!==m)return;const u=h.data;if(!(!u||typeof u!="object")){if(u.type==="set-settings"){const p=u.value;if(!(p!=null&&p.backendUrl)||p.parentOrigin&&m&&p.parentOrigin!==m)return;$(p),p!=null&&p.user&&t(p.user),e(null);return}if(u.type==="set-token"&&typeof u.value=="string"){j(u.value),e(null);return}if(u.type==="set-dark-mode"&&typeof u.value=="boolean"){S(u.value);return}if(u.type==="set-user"&&typeof u.value=="object"){t(u.value);return}}};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[m]);const f=a.useMemo(()=>J(()=>y,()=>v),[y,v]),b=a.useMemo(()=>({settings:y,token:v,isDarkMode:g,user:P,ready:r,state:n,error:s,client:f}),[y,v,g,P,r,n,s,f]);return T.jsx(M.Provider,{value:b,children:d})}function k(){const d=a.useContext(M);if(!d)throw new Error("usePromte must be used inside <PromteAppProvider>");return d}function B(){return k().settings}function D(){return k().token}function F(){return k().isDarkMode}function _(){return k().user}function C(){return k().client}function G(d={}){const{ready:m}=k(),E=C(),[l,y]=a.useState([]),[$,v]=a.useState(!1),[j,g]=a.useState(null),S=a.useMemo(()=>(Array.isArray(d.type)?d.type:d.type?[d.type]:[]).filter(Boolean).map(n=>String(n)).join(","),[d.type]),P=d.configuredOnly===!0,t=d.auto!==!1,s=a.useCallback(async()=>{if(!m)return[];v(!0),g(null);try{const e=S?S.split(",").filter(Boolean):void 0,n=await E.models({type:e,configuredOnly:P});return y(n),n}catch(e){const n=e instanceof Error?e.message:String(e);throw g(n),e}finally{v(!1)}},[E,P,m,S]);return a.useEffect(()=>{!t||!m||s().catch(()=>{})},[t,m,s]),{models:l,loading:$,error:j,reload:s}}function J(d,m){const E=t=>typeof t=="string"&&t.startsWith("gpt-5");async function l(t,s){const e=d(),n=m();if(!e)throw new Error("Promte settings not received yet");if(!n)throw new Error("Promte token not received yet");const r=e.backendUrl.replace(/\/+$/,""),c=String(t||"").replace(/^\/+/,""),i=`${r}/${c}`;return await fetch(i,{...s,headers:{...s.headers||{},Authorization:`Bearer ${n}`}})}async function y(t,s){const e=await l(`/app-api/data/${t}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)}),n=await e.json().catch(()=>({}));if(!e.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${e.status})`);return n==null?void 0:n.value}async function $(t){const s=new URLSearchParams;t.scope&&s.set("scope",t.scope),t.path&&s.set("path",t.path);const e=await l(`/app-api/data?${s.toString()}`,{method:"GET"}),n=await e.json().catch(()=>({}));if(!e.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${e.status})`);return n==null?void 0:n.value}async function v(t){const s=new URLSearchParams,e=Array.isArray(t==null?void 0:t.type)?t==null?void 0:t.type:t!=null&&t.type?[t.type]:[];e.length>0&&s.set("type",e.join(",")),t!=null&&t.configuredOnly&&s.set("configuredOnly","true");const n=await l(`/app-api/models${s.toString()?`?${s.toString()}`:""}`,{method:"GET"}),r=await n.json().catch(()=>({}));if(!n.ok)throw new Error((r==null?void 0:r.error)||`Request failed (${n.status})`);return(Array.isArray(r==null?void 0:r.models)?r.models:[]).map(i=>{if(!i||typeof i!="object")return null;const f=typeof i.id=="string"?i.id.trim():"",b=typeof i.label=="string"?i.label.trim():f,o=i.type,h=i.configured===!0,u=typeof i.source=="string"&&i.source.trim()?i.source.trim():void 0;return!f||o!=="llm"&&o!=="embedding"&&o!=="image"&&o!=="stt"&&o!=="tts"?null:{id:f,label:b||f,type:o,configured:h,source:u}}).filter(i=>!!i)}async function j(t,s){const e=await l(t,s),r=(e.headers.get("content-type")||"").includes("application/json")?await e.json().catch(()=>({})):await e.text();if(!e.ok)throw new Error(typeof r=="string"?r||`Request failed (${e.status})`:(r==null?void 0:r.error)||(r==null?void 0:r.message)||`Request failed (${e.status})`);return r}const g=t=>t?t.split("/").map(s=>s.trim()).filter(Boolean).join("/"):"",S=(t,s)=>{const e=g(t),n=g(s);return e?n?`${e}/${n}`:e:n},P=(t,s)=>{const e={scope:t};return{async get(){const n=g(s);return $({...e,path:n||void 0})},async set(n){const r=g(s);return y("set",{...e,path:r||void 0,value:n})},async update(n){if(!n||typeof n!="object")throw new Error("update requires an object");const r={};for(const[c,i]of Object.entries(n)){const f=S(s,c);if(!f)throw new Error("update paths must be non-empty");r[f]=i}return y("update",{...e,updates:r})},async remove(){const n=g(s);return y("remove",{...e,path:n||void 0})},async push(n){const r=g(s);if(!r)throw new Error("push requires a path");return y("array-push",{...e,path:r,value:n})},ref(n){const r=S(s,n);if(!r)throw new Error("ref requires a path");return P(t,r)}}};return{isReady(){return!!d()&&!!m()},getBackendUrl(){var t;return((t=d())==null?void 0:t.backendUrl)??null},async models(t){return v(t)},async chatCompletions(t){var o;const{reasoningEffort:s,reasoning_effort:e,...n}=t,r=s??e,c={...n,stream:!1};r&&E(t.model)&&(c.reasoning_effort=r);const i=await l("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(c)}),b=(i.headers.get("content-type")||"").includes("application/json")?await i.json():await i.text();if(!i.ok)throw new Error(typeof b=="string"?b:((o=b==null?void 0:b.error)==null?void 0:o.message)||`Request failed (${i.status})`);return b},async chatText(t){var e,n,r;const s=await this.chatCompletions(t);return((r=(n=(e=s==null?void 0:s.choices)==null?void 0:e[0])==null?void 0:n.message)==null?void 0:r.content)??""},embeddings:{async create(t){var r;const s=(r=t==null?void 0:t.model)==null?void 0:r.trim();if(!s)throw new Error("embeddings.create requires a model");const e=t==null?void 0:t.input;if(!(typeof e=="string"?e.length>0:Array.isArray(e)&&e.length>0&&e.every(c=>typeof c=="string")))throw new Error("embeddings.create requires input as a string or string[]");return j("/openai/embeddings",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({...t,model:s,input:e})})}},audio:{async tts(t){var r;const s=(r=t==null?void 0:t.text)==null?void 0:r.trim();if(!s)throw new Error("audio.tts requires non-empty text");const e=await l("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:s,voice:t.voice,lang:t.lang})});if(!e.ok){const c=await e.text();throw new Error(c||`Request failed (${e.status})`)}return{audio:await e.arrayBuffer(),contentType:e.headers.get("content-type")}},async stt(t){var u,p,R;if(!(t!=null&&t.file))throw new Error("audio.stt requires a file");const s=x=>{if(!x)return;const A=x.trim();if(!A)return;const U=A.toLowerCase(),O=U.split("-")[0];return O.length===2?O:U},e=typeof File<"u"&&t.file instanceof File,n=e&&t.file.name.split(".").pop()||"webm",r=t.ext||n,c=new FormData;e?c.set("file",t.file):c.set("file",t.file,`audio.${r}`);const i=s(t.language);i&&c.set("language",i),t.prompt&&c.set("prompt",t.prompt);const f=await l(`/app-api/audio/stt?ext=${encodeURIComponent(r)}`,{method:"POST",body:c}),o=(f.headers.get("content-type")||"").includes("application/json")?await f.json():await f.text();if(!f.ok)throw new Error(typeof o=="string"?o:((u=o==null?void 0:o.error)==null?void 0:u.message)||`Request failed (${f.status})`);return{text:typeof o=="string"?o:(o==null?void 0:o.text)||(o==null?void 0:o.original)||((R=(p=o==null?void 0:o.results)==null?void 0:p[0])==null?void 0:R.text)||"",raw:o}},async voices(t){const s=new URLSearchParams;t!=null&&t.locale&&s.set("locale",t.locale);const e=await l(`/app-api/audio/tts/voices${s.toString()?`?${s}`:""}`,{method:"GET"}),n=await e.json().catch(()=>[]);if(!e.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${e.status})`);return Array.isArray(n)?n:(n==null?void 0:n.voices)||[]}},web:{async scrapeUrl(t){var e;const s=(e=t==null?void 0:t.url)==null?void 0:e.trim();if(!s)throw new Error("web.scrapeUrl requires a url");return j("/app-api/web/scrape-url",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({url:s,maxChars:t.maxChars})})}},data(t="private"){return P(t,"")}}}w.PromteAppProvider=L,w.usePromte=k,w.usePromteClient=C,w.usePromteDarkMode=F,w.usePromteModels=G,w.usePromteSettings=B,w.usePromteToken=D,w.usePromteUser=_,Object.defineProperty(w,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promte/app-library",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "private": false,
   "type": "module",
   "files": [