@plucky-ai/react 0.3.3 → 0.5.0

package/README.md

@@ -29,7 +29,14 @@ function MyComponent(props: { temperature: number }) {
         defaultLoadingText: 'Checking the weather...',
         defaultSuccessText: 'Weather retrieved.',
         cb: async (_, { temperature }) => {
+          // Return a string:
           return `It's currently ${temperature} degrees.`
+
+          // Or return an object with custom success text:
+          // return {
+          //   content: `It's currently ${temperature} degrees.`,
+          //   successText: `Weather: ${temperature}°`,
+          // }
         },
       },
     ],

package/dist/index.cjs

@@ -26,6 +26,14 @@ __plucky_ai_chat_sdk = __toESM(__plucky_ai_chat_sdk);
 let react = require("react");
 react = __toESM(react);
 
+//#region src/hooks/useChat.ts
+function useChat(params) {
+	(0, react.useEffect)(() => {
+		(0, __plucky_ai_chat_sdk.Plucky)(params);
+	}, [params]);
+}
+
+//#endregion
 //#region src/hooks/useTools.ts
 function useLatest(value) {
 	const ref = (0, react.useRef)(value);
@@ -57,5 +65,6 @@ function useTools(params) {
 }
 
 //#endregion
+exports.useChat = useChat;
 exports.useTools = useTools;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/hooks/useTools.ts"],"sourcesContent":["import { UseToolsParams } from '@/types'\nimport { addTools, removeTools } from '@plucky-ai/chat-sdk'\nimport { useEffect, useMemo, useRef } from 'react'\nfunction useLatest<T>(value: T) {\n  const ref = useRef(value)\n  useEffect(() => {\n    ref.current = value\n  }, [value])\n  return ref\n}\n\nexport function useTools<TContext = Record<string, unknown>>(\n  params: UseToolsParams<TContext>,\n) {\n  const contextRef = useLatest(params.context)\n\n  const { tools } = params\n  const wrappedTools = useMemo(\n    () =>\n      tools.map((tool) => {\n        const originalCb = tool.cb\n        return {\n          ...tool,\n          cb: async (input: Record<string, unknown>) => {\n            if (!contextRef.current) return 'Tool not yet loaded.'\n            return originalCb(input, contextRef.current)\n          },\n        }\n      }),\n    [tools, contextRef],\n  )\n\n  useEffect(() => {\n    if (!tools || tools.length === 0) return\n    addTools(wrappedTools)\n    return () => {\n      removeTools(wrappedTools.map((tool) => tool.name))\n    }\n  }, [wrappedTools])\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,SAAS,UAAa,OAAU;CAC9B,MAAM,wBAAa,MAAM;AACzB,4BAAgB;AACd,MAAI,UAAU;IACb,CAAC,MAAM,CAAC;AACX,QAAO;;AAGT,SAAgB,SACd,QACA;CACA,MAAM,aAAa,UAAU,OAAO,QAAQ;CAE5C,MAAM,EAAE,UAAU;CAClB,MAAM,wCAEF,MAAM,KAAK,SAAS;EAClB,MAAM,aAAa,KAAK;AACxB,SAAO;GACL,GAAG;GACH,IAAI,OAAO,UAAmC;AAC5C,QAAI,CAAC,WAAW,QAAS,QAAO;AAChC,WAAO,WAAW,OAAO,WAAW,QAAQ;;GAE/C;GACD,EACJ,CAAC,OAAO,WAAW,CACpB;AAED,4BAAgB;AACd,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG;AAClC,qCAAS,aAAa;AACtB,eAAa;AACX,yCAAY,aAAa,KAAK,SAAS,KAAK,KAAK,CAAC;;IAEnD,CAAC,aAAa,CAAC"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/hooks/useChat.ts","../src/hooks/useTools.ts"],"sourcesContent":["import { UseChatParams } from '@/types'\nimport { Plucky } from '@plucky-ai/chat-sdk'\nimport { useEffect } from 'react'\n\nexport function useChat(params: UseChatParams) {\n  useEffect(() => {\n    Plucky(params)\n  }, [params])\n}\n","import { UseToolsParams } from '@/types'\nimport { addTools, removeTools } from '@plucky-ai/chat-sdk'\nimport { useEffect, useMemo, useRef } from 'react'\nfunction useLatest<T>(value: T) {\n  const ref = useRef(value)\n  useEffect(() => {\n    ref.current = value\n  }, [value])\n  return ref\n}\n\nexport function useTools<TContext = Record<string, unknown>>(\n  params: UseToolsParams<TContext>,\n) {\n  const contextRef = useLatest(params.context)\n\n  const { tools } = params\n  const wrappedTools = useMemo(\n    () =>\n      tools.map((tool) => {\n        const originalCb = tool.cb\n        return {\n          ...tool,\n          cb: async (input: Record<string, unknown>) => {\n            if (!contextRef.current) return 'Tool not yet loaded.'\n            return originalCb(input, contextRef.current)\n          },\n        }\n      }),\n    [tools, contextRef],\n  )\n\n  useEffect(() => {\n    if (!tools || tools.length === 0) return\n    addTools(wrappedTools)\n    return () => {\n      removeTools(wrappedTools.map((tool) => tool.name))\n    }\n  }, [wrappedTools])\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAAgB,QAAQ,QAAuB;AAC7C,4BAAgB;AACd,mCAAO,OAAO;IACb,CAAC,OAAO,CAAC;;;;;ACJd,SAAS,UAAa,OAAU;CAC9B,MAAM,wBAAa,MAAM;AACzB,4BAAgB;AACd,MAAI,UAAU;IACb,CAAC,MAAM,CAAC;AACX,QAAO;;AAGT,SAAgB,SACd,QACA;CACA,MAAM,aAAa,UAAU,OAAO,QAAQ;CAE5C,MAAM,EAAE,UAAU;CAClB,MAAM,wCAEF,MAAM,KAAK,SAAS;EAClB,MAAM,aAAa,KAAK;AACxB,SAAO;GACL,GAAG;GACH,IAAI,OAAO,UAAmC;AAC5C,QAAI,CAAC,WAAW,QAAS,QAAO;AAChC,WAAO,WAAW,OAAO,WAAW,QAAQ;;GAE/C;GACD,EACJ,CAAC,OAAO,WAAW,CACpB;AAED,4BAAgB;AACd,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG;AAClC,qCAAS,aAAa;AACtB,eAAa;AACX,yCAAY,aAAa,KAAK,SAAS,KAAK,KAAK,CAAC;;IAEnD,CAAC,aAAa,CAAC"}

package/dist/index.d.cts

@@ -1,24 +1,20 @@
 import { ToolConfig } from "@plucky-ai/chat-sdk";
+import { PluckySettingsParams, ToolCallbackResult } from "@plucky-ai/loader-types";
 
 //#region src/types.d.ts
-type UseChatParams = {
-  appId: string;
-  user?: {
-    id: string;
-    name?: string;
-  };
-  tools?: ToolConfig[];
-  tags?: string[];
-};
+type UseChatParams = PluckySettingsParams;
 type UseToolsParams<TContext = Record<string, unknown>> = {
   context?: TContext;
   tools: Array<Omit<ToolConfig, 'cb'> & {
-    cb: (input: Record<string, unknown>, context: TContext) => Promise<string> | string;
+    cb: (input: Record<string, unknown>, context: TContext) => Promise<ToolCallbackResult> | ToolCallbackResult;
   }>;
 };
 //#endregion
+//#region src/hooks/useChat.d.ts
+declare function useChat(params: UseChatParams): void;
+//#endregion
 //#region src/hooks/useTools.d.ts
 declare function useTools<TContext = Record<string, unknown>>(params: UseToolsParams<TContext>): void;
 //#endregion
-export { UseChatParams, UseToolsParams, useTools };
+export { UseChatParams, UseToolsParams, useChat, useTools };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,24 +1,20 @@
 import { ToolConfig } from "@plucky-ai/chat-sdk";
+import { PluckySettingsParams, ToolCallbackResult } from "@plucky-ai/loader-types";
 
 //#region src/types.d.ts
-type UseChatParams = {
-  appId: string;
-  user?: {
-    id: string;
-    name?: string;
-  };
-  tools?: ToolConfig[];
-  tags?: string[];
-};
+type UseChatParams = PluckySettingsParams;
 type UseToolsParams<TContext = Record<string, unknown>> = {
   context?: TContext;
   tools: Array<Omit<ToolConfig, 'cb'> & {
-    cb: (input: Record<string, unknown>, context: TContext) => Promise<string> | string;
+    cb: (input: Record<string, unknown>, context: TContext) => Promise<ToolCallbackResult> | ToolCallbackResult;
   }>;
 };
 //#endregion
+//#region src/hooks/useChat.d.ts
+declare function useChat(params: UseChatParams): void;
+//#endregion
 //#region src/hooks/useTools.d.ts
 declare function useTools<TContext = Record<string, unknown>>(params: UseToolsParams<TContext>): void;
 //#endregion
-export { UseChatParams, UseToolsParams, useTools };
+export { UseChatParams, UseToolsParams, useChat, useTools };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,6 +1,14 @@
-import { addTools, removeTools } from "@plucky-ai/chat-sdk";
+import { Plucky, addTools, removeTools } from "@plucky-ai/chat-sdk";
 import { useEffect, useMemo, useRef } from "react";
 
+//#region src/hooks/useChat.ts
+function useChat(params) {
+	useEffect(() => {
+		Plucky(params);
+	}, [params]);
+}
+
+//#endregion
 //#region src/hooks/useTools.ts
 function useLatest(value) {
 	const ref = useRef(value);
@@ -32,5 +40,5 @@ function useTools(params) {
 }
 
 //#endregion
-export { useTools };
+export { useChat, useTools };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/hooks/useTools.ts"],"sourcesContent":["import { UseToolsParams } from '@/types'\nimport { addTools, removeTools } from '@plucky-ai/chat-sdk'\nimport { useEffect, useMemo, useRef } from 'react'\nfunction useLatest<T>(value: T) {\n  const ref = useRef(value)\n  useEffect(() => {\n    ref.current = value\n  }, [value])\n  return ref\n}\n\nexport function useTools<TContext = Record<string, unknown>>(\n  params: UseToolsParams<TContext>,\n) {\n  const contextRef = useLatest(params.context)\n\n  const { tools } = params\n  const wrappedTools = useMemo(\n    () =>\n      tools.map((tool) => {\n        const originalCb = tool.cb\n        return {\n          ...tool,\n          cb: async (input: Record<string, unknown>) => {\n            if (!contextRef.current) return 'Tool not yet loaded.'\n            return originalCb(input, contextRef.current)\n          },\n        }\n      }),\n    [tools, contextRef],\n  )\n\n  useEffect(() => {\n    if (!tools || tools.length === 0) return\n    addTools(wrappedTools)\n    return () => {\n      removeTools(wrappedTools.map((tool) => tool.name))\n    }\n  }, [wrappedTools])\n}\n"],"mappings":";;;;AAGA,SAAS,UAAa,OAAU;CAC9B,MAAM,MAAM,OAAO,MAAM;AACzB,iBAAgB;AACd,MAAI,UAAU;IACb,CAAC,MAAM,CAAC;AACX,QAAO;;AAGT,SAAgB,SACd,QACA;CACA,MAAM,aAAa,UAAU,OAAO,QAAQ;CAE5C,MAAM,EAAE,UAAU;CAClB,MAAM,eAAe,cAEjB,MAAM,KAAK,SAAS;EAClB,MAAM,aAAa,KAAK;AACxB,SAAO;GACL,GAAG;GACH,IAAI,OAAO,UAAmC;AAC5C,QAAI,CAAC,WAAW,QAAS,QAAO;AAChC,WAAO,WAAW,OAAO,WAAW,QAAQ;;GAE/C;GACD,EACJ,CAAC,OAAO,WAAW,CACpB;AAED,iBAAgB;AACd,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG;AAClC,WAAS,aAAa;AACtB,eAAa;AACX,eAAY,aAAa,KAAK,SAAS,KAAK,KAAK,CAAC;;IAEnD,CAAC,aAAa,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/hooks/useChat.ts","../src/hooks/useTools.ts"],"sourcesContent":["import { UseChatParams } from '@/types'\nimport { Plucky } from '@plucky-ai/chat-sdk'\nimport { useEffect } from 'react'\n\nexport function useChat(params: UseChatParams) {\n  useEffect(() => {\n    Plucky(params)\n  }, [params])\n}\n","import { UseToolsParams } from '@/types'\nimport { addTools, removeTools } from '@plucky-ai/chat-sdk'\nimport { useEffect, useMemo, useRef } from 'react'\nfunction useLatest<T>(value: T) {\n  const ref = useRef(value)\n  useEffect(() => {\n    ref.current = value\n  }, [value])\n  return ref\n}\n\nexport function useTools<TContext = Record<string, unknown>>(\n  params: UseToolsParams<TContext>,\n) {\n  const contextRef = useLatest(params.context)\n\n  const { tools } = params\n  const wrappedTools = useMemo(\n    () =>\n      tools.map((tool) => {\n        const originalCb = tool.cb\n        return {\n          ...tool,\n          cb: async (input: Record<string, unknown>) => {\n            if (!contextRef.current) return 'Tool not yet loaded.'\n            return originalCb(input, contextRef.current)\n          },\n        }\n      }),\n    [tools, contextRef],\n  )\n\n  useEffect(() => {\n    if (!tools || tools.length === 0) return\n    addTools(wrappedTools)\n    return () => {\n      removeTools(wrappedTools.map((tool) => tool.name))\n    }\n  }, [wrappedTools])\n}\n"],"mappings":";;;;AAIA,SAAgB,QAAQ,QAAuB;AAC7C,iBAAgB;AACd,SAAO,OAAO;IACb,CAAC,OAAO,CAAC;;;;;ACJd,SAAS,UAAa,OAAU;CAC9B,MAAM,MAAM,OAAO,MAAM;AACzB,iBAAgB;AACd,MAAI,UAAU;IACb,CAAC,MAAM,CAAC;AACX,QAAO;;AAGT,SAAgB,SACd,QACA;CACA,MAAM,aAAa,UAAU,OAAO,QAAQ;CAE5C,MAAM,EAAE,UAAU;CAClB,MAAM,eAAe,cAEjB,MAAM,KAAK,SAAS;EAClB,MAAM,aAAa,KAAK;AACxB,SAAO;GACL,GAAG;GACH,IAAI,OAAO,UAAmC;AAC5C,QAAI,CAAC,WAAW,QAAS,QAAO;AAChC,WAAO,WAAW,OAAO,WAAW,QAAQ;;GAE/C;GACD,EACJ,CAAC,OAAO,WAAW,CACpB;AAED,iBAAgB;AACd,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG;AAClC,WAAS,aAAa;AACtB,eAAa;AACX,eAAY,aAAa,KAAK,SAAS,KAAK,KAAK,CAAC;;IAEnD,CAAC,aAAa,CAAC"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plucky-ai/react",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plucky-ai/react",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -13,15 +13,16 @@
     }
   },
   "dependencies": {
-    "react": "19.2.1",
+    "react": "^19.2.3",
     "zod": "^4.1.11",
-    "@plucky-ai/chat-sdk": "^0.3.3"
+    "@plucky-ai/chat-sdk": "^0.5.0"
   },
   "devDependencies": {
     "@types/react": "19.1.13",
     "tsdown": "^0.15.12",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@plucky-ai/loader-types": "^0.3.0"
   },
   "publishConfig": {
     "access": "public",