@usecrow/client 0.1.46 → 0.1.47

package/dist/index.cjs

@@ -1 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index.native.cjs"),l=require("./workflowExecutor-D1pVvfZw.cjs");function c(s,i,t){const r=s.find(o=>o.name.toLowerCase()===i.toLowerCase());if(!r)return null;let n=r.path;if(t)for(const[o,a]of Object.entries(t))n=n.replace(`:${o}`,String(a));return n}function d(s,i){return async t=>{try{const r=t.page,n=t.params,o=t.url;let a=null;if(r){if(a=c(s,r,n),!a)return{status:"error",error:`Unknown page: "${r}". Available pages: ${s.map(g=>g.name).join(", ")}`}}else if(o)a=o;else return{status:"error",error:'Either "page" or "url" parameter is required'};const u=a.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);return u?{status:"error",error:`Missing parameters: ${u.join(", ")}. Please provide values for these parameters.`}:i?(i(a),{status:"success",data:{navigated_to:a,page:r||void 0,method:"spa_router"}}):typeof window<"u"?(window.location.href=a,{status:"success",data:{navigated_to:a,page:r||void 0,method:"full_navigation"}}):{status:"error",error:"No navigateFn provided and window.location is unavailable (non-browser runtime). Pass a navigateFn to createNavigateToPageTool."}}catch(r){return{status:"error",error:String(r)}}}}exports.ConversationManager=e.ConversationManager;exports.CrowClient=e.CrowClient;exports.DEFAULT_TOOLS=e.DEFAULT_TOOLS;exports.DEFAULT_TOOL_NAMES=e.DEFAULT_TOOL_NAMES;exports.IdentityManager=e.IdentityManager;exports.ToolManager=e.ToolManager;exports.createLocalStorageAdapter=e.createLocalStorageAdapter;exports.createMemoryStorageAdapter=e.createMemoryStorageAdapter;exports.parseSSEChunk=e.parseSSEChunk;exports.parseSSEData=e.parseSSEData;exports.streamResponse=e.streamResponse;exports.CrowBrowserUse=l.CrowBrowserUse;exports.WorkflowExecutor=l.WorkflowExecutor;exports.createNavigateToPageTool=d;exports.resolveRoute=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./index.native.cjs"),A=require("./workflowExecutor-D1pVvfZw.cjs");function C(l){const{apiUrl:c,productId:o,query:r,conversationId:n=null,context:s={},onChunk:e,onNavigate:u,onCheckingDocs:i,onToolResult:g,onDone:d,onError:p}=l,w=new AbortController;return(async()=>{var _;try{const f=await fetch(`${c}/api/chat/message`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({product_id:o,message:r,conversation_id:n??null,context:s??{}}),signal:w.signal});if(!f.ok||!f.body){p==null||p();return}const b=f.body.getReader(),E=new TextDecoder;let v="",m=n??null;for(;;){const{done:L,value:M}=await b.read();if(L)break;v+=E.decode(M,{stream:!0});const y=v.split(`
+`);v=y.pop()??"";for(const S of y){if(!S.startsWith("data: "))continue;const T=S.slice(6);if(T==="[DONE]"){d==null||d(m);return}try{const t=JSON.parse(T);if(t.type==="conversation_id"&&t.conversation_id)m=t.conversation_id;else if(t.type==="content"&&t.content)e==null||e(t.content);else if(t.type==="client_tool_call"&&t.tool_name==="navigateToPage"){const h=((_=t.arguments)==null?void 0:_.url)??null;h&&(u==null||u(h))}else t.type==="tool_call_start"?i==null||i(!0):t.type==="tool_call_complete"?i==null||i(!1):t.type==="tool_result"&&(g==null||g(t.tool_name,t))}catch{}}}d==null||d(m)}catch(f){f.name!=="AbortError"&&(p==null||p())}})(),w}function O(l,c,o){const r=l.find(s=>s.name.toLowerCase()===c.toLowerCase());if(!r)return null;let n=r.path;if(o)for(const[s,e]of Object.entries(o))n=n.replace(`:${s}`,String(e));return n}function P(l,c){return async o=>{try{const r=o.page,n=o.params,s=o.url;let e=null;if(r){if(e=O(l,r,n),!e)return{status:"error",error:`Unknown page: "${r}". Available pages: ${l.map(i=>i.name).join(", ")}`}}else if(s)e=s;else return{status:"error",error:'Either "page" or "url" parameter is required'};const u=e.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);return u?{status:"error",error:`Missing parameters: ${u.join(", ")}. Please provide values for these parameters.`}:c?(c(e),{status:"success",data:{navigated_to:e,page:r||void 0,method:"spa_router"}}):typeof window<"u"?(window.location.href=e,{status:"success",data:{navigated_to:e,page:r||void 0,method:"full_navigation"}}):{status:"error",error:"No navigateFn provided and window.location is unavailable (non-browser runtime). Pass a navigateFn to createNavigateToPageTool."}}catch(r){return{status:"error",error:String(r)}}}}exports.ConversationManager=a.ConversationManager;exports.CrowClient=a.CrowClient;exports.DEFAULT_TOOLS=a.DEFAULT_TOOLS;exports.DEFAULT_TOOL_NAMES=a.DEFAULT_TOOL_NAMES;exports.IdentityManager=a.IdentityManager;exports.ToolManager=a.ToolManager;exports.createLocalStorageAdapter=a.createLocalStorageAdapter;exports.createMemoryStorageAdapter=a.createMemoryStorageAdapter;exports.parseSSEChunk=a.parseSSEChunk;exports.parseSSEData=a.parseSSEData;exports.streamResponse=a.streamResponse;exports.CrowBrowserUse=A.CrowBrowserUse;exports.WorkflowExecutor=A.WorkflowExecutor;exports.createNavigateToPageTool=P;exports.crowAsk=C;exports.resolveRoute=O;

package/dist/index.d.ts

@@ -9,6 +9,42 @@ export declare interface ActiveWorkflow {
     isComplete?: boolean;
 }
 
+/**
+ * crowAsk - Headless AI query function
+ *
+ * Streams a question to the Crow API and delivers results via callbacks.
+ * Works without any React or UI dependency — usable anywhere window.crow('ask') is called.
+ * Returns an AbortController so the caller can cancel mid-stream.
+ */
+export declare interface AskOptions {
+    /** Crow API base URL (e.g. "https://api.usecrow.ai") */
+    apiUrl: string;
+    /** Product ID from your Crow dashboard */
+    productId: string;
+    /** The user's question */
+    query: string;
+    /** Conversation ID for follow-up messages; null for a new conversation */
+    conversationId?: string | null;
+    /** Page context sent with the request (e.g. { page: "/settings/teams" }) */
+    context?: Record<string, unknown>;
+    /** Called incrementally as the AI streams text tokens */
+    onChunk?: (text: string) => void;
+    /** Called when the AI emits a navigateToPage tool call with the target URL */
+    onNavigate?: (href: string) => void;
+    /** Called with true when an MCP/doc-search tool starts, false when it completes */
+    onCheckingDocs?: (checking: boolean) => void;
+    /**
+     * Called when a server-side tool result arrives.
+     * The raw SSE event object is passed so callers can extract custom data
+     * (e.g. extracting source URLs from MCP search blobs).
+     */
+    onToolResult?: (toolName: string, result: unknown) => void;
+    /** Called when the stream ends; receives the conversation ID for follow-up messages */
+    onDone?: (conversationId: string | null) => void;
+    /** Called on non-abort errors (network failures, non-2xx responses) */
+    onError?: () => void;
+}
+
 /**
  * Structured browser state for LLM consumption
  */
@@ -136,6 +172,8 @@ export declare function createMemoryStorageAdapter(): StorageAdapter;
  */
 export declare function createNavigateToPageTool(routes: NavigationRoute[], navigateFn?: (path: string) => void): (args: Record<string, unknown>) => Promise<ToolResult>;
 
+export declare function crowAsk(opts: AskOptions): AbortController;
+
 export declare class CrowBrowserUse {
     private config;
     private pageController;

package/dist/index.js

@@ -1,78 +1,147 @@
-import { ConversationManager as g, CrowClient as f, DEFAULT_TOOLS as m, DEFAULT_TOOL_NAMES as v, IdentityManager as w, ToolManager as h, createLocalStorageAdapter as S, createMemoryStorageAdapter as T, parseSSEChunk as _, parseSSEData as A, streamResponse as C } from "./index.native.js";
-import { C as L, W as y } from "./workflowExecutor-ijFlX3nx.js";
-function l(n, s, a) {
-  const e = n.find(
-    (t) => t.name.toLowerCase() === s.toLowerCase()
+import { ConversationManager as E, CrowClient as M, DEFAULT_TOOLS as U, DEFAULT_TOOL_NAMES as $, IdentityManager as j, ToolManager as I, createLocalStorageAdapter as k, createMemoryStorageAdapter as F, parseSSEChunk as W, parseSSEData as q, streamResponse as z } from "./index.native.js";
+import { C as R, W as Z } from "./workflowExecutor-ijFlX3nx.js";
+function x(i) {
+  const {
+    apiUrl: l,
+    productId: a,
+    query: r,
+    conversationId: o = null,
+    context: n = {},
+    onChunk: e,
+    onNavigate: c,
+    onCheckingDocs: s,
+    onToolResult: f,
+    onDone: u,
+    onError: d
+  } = i, v = new AbortController();
+  return (async () => {
+    var _;
+    try {
+      const p = await fetch(`${l}/api/chat/message`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          product_id: a,
+          message: r,
+          conversation_id: o ?? null,
+          context: n ?? {}
+        }),
+        signal: v.signal
+      });
+      if (!p.ok || !p.body) {
+        d == null || d();
+        return;
+      }
+      const T = p.body.getReader(), b = new TextDecoder();
+      let g = "", m = o ?? null;
+      for (; ; ) {
+        const { done: A, value: O } = await T.read();
+        if (A) break;
+        g += b.decode(O, { stream: !0 });
+        const y = g.split(`
+`);
+        g = y.pop() ?? "";
+        for (const w of y) {
+          if (!w.startsWith("data: ")) continue;
+          const h = w.slice(6);
+          if (h === "[DONE]") {
+            u == null || u(m);
+            return;
+          }
+          try {
+            const t = JSON.parse(h);
+            if (t.type === "conversation_id" && t.conversation_id)
+              m = t.conversation_id;
+            else if (t.type === "content" && t.content)
+              e == null || e(t.content);
+            else if (t.type === "client_tool_call" && t.tool_name === "navigateToPage") {
+              const S = ((_ = t.arguments) == null ? void 0 : _.url) ?? null;
+              S && (c == null || c(S));
+            } else t.type === "tool_call_start" ? s == null || s(!0) : t.type === "tool_call_complete" ? s == null || s(!1) : t.type === "tool_result" && (f == null || f(t.tool_name, t));
+          } catch {
+          }
+        }
+      }
+      u == null || u(m);
+    } catch (p) {
+      p.name !== "AbortError" && (d == null || d());
+    }
+  })(), v;
+}
+function P(i, l, a) {
+  const r = i.find(
+    (n) => n.name.toLowerCase() === l.toLowerCase()
   );
-  if (!e) return null;
-  let o = e.path;
+  if (!r) return null;
+  let o = r.path;
   if (a)
-    for (const [t, r] of Object.entries(a))
-      o = o.replace(`:${t}`, String(r));
+    for (const [n, e] of Object.entries(a))
+      o = o.replace(`:${n}`, String(e));
   return o;
 }
-function c(n, s) {
+function C(i, l) {
   return async (a) => {
     try {
-      const e = a.page, o = a.params, t = a.url;
-      let r = null;
-      if (e) {
-        if (r = l(n, e, o), !r)
+      const r = a.page, o = a.params, n = a.url;
+      let e = null;
+      if (r) {
+        if (e = P(i, r, o), !e)
           return {
             status: "error",
-            error: `Unknown page: "${e}". Available pages: ${n.map((u) => u.name).join(", ")}`
+            error: `Unknown page: "${r}". Available pages: ${i.map((s) => s.name).join(", ")}`
           };
-      } else if (t)
-        r = t;
+      } else if (n)
+        e = n;
       else
         return {
           status: "error",
           error: 'Either "page" or "url" parameter is required'
         };
-      const i = r.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
-      return i ? {
+      const c = e.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
+      return c ? {
         status: "error",
-        error: `Missing parameters: ${i.join(", ")}. Please provide values for these parameters.`
-      } : s ? (s(r), {
+        error: `Missing parameters: ${c.join(", ")}. Please provide values for these parameters.`
+      } : l ? (l(e), {
         status: "success",
         data: {
-          navigated_to: r,
-          page: e || void 0,
+          navigated_to: e,
+          page: r || void 0,
           method: "spa_router"
         }
-      }) : typeof window < "u" ? (window.location.href = r, {
+      }) : typeof window < "u" ? (window.location.href = e, {
         status: "success",
         data: {
-          navigated_to: r,
-          page: e || void 0,
+          navigated_to: e,
+          page: r || void 0,
           method: "full_navigation"
         }
       }) : {
         status: "error",
         error: "No navigateFn provided and window.location is unavailable (non-browser runtime). Pass a navigateFn to createNavigateToPageTool."
       };
-    } catch (e) {
+    } catch (r) {
       return {
         status: "error",
-        error: String(e)
+        error: String(r)
       };
     }
   };
 }
 export {
-  g as ConversationManager,
-  L as CrowBrowserUse,
-  f as CrowClient,
-  m as DEFAULT_TOOLS,
-  v as DEFAULT_TOOL_NAMES,
-  w as IdentityManager,
-  h as ToolManager,
-  y as WorkflowExecutor,
-  S as createLocalStorageAdapter,
-  T as createMemoryStorageAdapter,
-  c as createNavigateToPageTool,
-  _ as parseSSEChunk,
-  A as parseSSEData,
-  l as resolveRoute,
-  C as streamResponse
+  E as ConversationManager,
+  R as CrowBrowserUse,
+  M as CrowClient,
+  U as DEFAULT_TOOLS,
+  $ as DEFAULT_TOOL_NAMES,
+  j as IdentityManager,
+  I as ToolManager,
+  Z as WorkflowExecutor,
+  k as createLocalStorageAdapter,
+  F as createMemoryStorageAdapter,
+  C as createNavigateToPageTool,
+  x as crowAsk,
+  W as parseSSEChunk,
+  q as parseSSEData,
+  P as resolveRoute,
+  z as streamResponse
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usecrow/client",
-  "version": "0.1.46",
+  "version": "0.1.47",
   "description": "Headless client for Crow AI agents - streaming, auth, tools",
   "type": "module",
   "main": "./dist/index.cjs",