ai.matey.react.hooks 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AI Matey Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * AI Matey React Hooks
+ *
+ * Additional specialized React hooks for AI applications.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStream = exports.MODEL_TOKEN_LIMITS = exports.getModelTokenLimit = exports.useTokenCount = exports.useAssistant = void 0;
+// Hooks
+var use_assistant_js_1 = require("./use-assistant.js");
+Object.defineProperty(exports, "useAssistant", { enumerable: true, get: function () { return use_assistant_js_1.useAssistant; } });
+var use_token_count_js_1 = require("./use-token-count.js");
+Object.defineProperty(exports, "useTokenCount", { enumerable: true, get: function () { return use_token_count_js_1.useTokenCount; } });
+Object.defineProperty(exports, "getModelTokenLimit", { enumerable: true, get: function () { return use_token_count_js_1.getModelTokenLimit; } });
+Object.defineProperty(exports, "MODEL_TOKEN_LIMITS", { enumerable: true, get: function () { return use_token_count_js_1.MODEL_TOKEN_LIMITS; } });
+var use_stream_js_1 = require("./use-stream.js");
+Object.defineProperty(exports, "useStream", { enumerable: true, get: function () { return use_stream_js_1.useStream; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,QAAQ;AACR,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AACrB,2DAA6F;AAApF,mHAAA,aAAa,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAC9D,iDAA4C;AAAnC,0GAAA,SAAS,OAAA"}

package/dist/cjs/use-assistant.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * useAssistant Hook
+ *
+ * React hook for OpenAI Assistants API compatible interfaces.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAssistant = useAssistant;
+const react_1 = require("react");
+/**
+ * useAssistant - React hook for OpenAI Assistants API.
+ *
+ * Provides state management for conversations with OpenAI Assistants,
+ * including thread management and run status tracking.
+ *
+ * @example
+ * ```tsx
+ * import { useAssistant } from 'ai.matey.react.hooks';
+ *
+ * function AssistantChat() {
+ *   const { messages, input, handleInputChange, handleSubmit, status } = useAssistant({
+ *     api: '/api/assistant',
+ *     assistantId: 'asst_xxx',
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map((m) => (
+ *         <div key={m.id}>{m.role}: {m.content}</div>
+ *       ))}
+ *       <form onSubmit={handleSubmit}>
+ *         <input value={input} onChange={handleInputChange} />
+ *         <button type="submit" disabled={status === 'in_progress'}>Send</button>
+ *       </form>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useAssistant(options = {}) {
+    const { api = '/api/assistant', assistantId, threadId: initialThreadId, headers = {}, body = {}, onStatus, onError, } = options;
+    // State
+    const [messages, setMessages] = (0, react_1.useState)([]);
+    const [input, setInput] = (0, react_1.useState)('');
+    const [threadId, setThreadId] = (0, react_1.useState)(initialThreadId);
+    const [status, setStatus] = (0, react_1.useState)('awaiting_message');
+    const [error, setError] = (0, react_1.useState)(undefined);
+    // Refs for abort control
+    const abortControllerRef = (0, react_1.useRef)(null);
+    /**
+     * Update status and call callback.
+     */
+    const updateStatus = (0, react_1.useCallback)((newStatus) => {
+        setStatus(newStatus);
+        onStatus?.(newStatus);
+    }, [onStatus]);
+    /**
+     * Handle input change from form elements.
+     */
+    const handleInputChange = (0, react_1.useCallback)((e) => {
+        setInput(e.target.value);
+    }, []);
+    /**
+     * Stop current run.
+     */
+    const stop = (0, react_1.useCallback)(() => {
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+            abortControllerRef.current = null;
+            updateStatus('cancelled');
+        }
+    }, [updateStatus]);
+    /**
+     * Generate unique ID.
+     */
+    const generateId = (0, react_1.useCallback)(() => {
+        return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }, []);
+    /**
+     * Send a message to the assistant.
+     */
+    const append = (0, react_1.useCallback)(async (message) => {
+        try {
+            setError(undefined);
+            updateStatus('in_progress');
+            // Create abort controller
+            abortControllerRef.current = new AbortController();
+            const { signal } = abortControllerRef.current;
+            // Create user message
+            const userMessage = typeof message === 'string'
+                ? {
+                    id: generateId(),
+                    role: 'user',
+                    content: message,
+                    createdAt: new Date(),
+                }
+                : { ...message, id: message.id ?? generateId() };
+            setMessages((prev) => [...prev, userMessage]);
+            // Prepare request body
+            const requestBody = {
+                message: typeof message === 'string' ? message : message.content,
+                assistantId,
+                threadId,
+                ...body,
+            };
+            // Make request
+            const response = await fetch(api, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers,
+                },
+                body: JSON.stringify(requestBody),
+                signal,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const data = await response.json();
+            // Update thread ID if new
+            if (data.threadId && !threadId) {
+                setThreadId(data.threadId);
+            }
+            // Add assistant message
+            if (data.message) {
+                const assistantMessage = {
+                    id: data.message.id ?? generateId(),
+                    role: 'assistant',
+                    content: data.message.content ?? '',
+                    createdAt: new Date(),
+                    threadId: data.threadId,
+                    runId: data.runId,
+                    annotations: data.message.annotations,
+                };
+                setMessages((prev) => [...prev, assistantMessage]);
+            }
+            updateStatus('completed');
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                return;
+            }
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            onError?.(error);
+            updateStatus('failed');
+        }
+        finally {
+            abortControllerRef.current = null;
+        }
+    }, [api, assistantId, body, generateId, headers, onError, threadId, updateStatus]);
+    /**
+     * Handle form submission.
+     */
+    const handleSubmit = (0, react_1.useCallback)((e) => {
+        e?.preventDefault();
+        if (!input.trim() || status === 'in_progress') {
+            return;
+        }
+        const message = input;
+        setInput('');
+        append(message);
+    }, [append, input, status]);
+    return {
+        messages,
+        input,
+        setInput,
+        handleInputChange,
+        handleSubmit,
+        append,
+        threadId,
+        status,
+        stop,
+        setMessages,
+        error,
+    };
+}
+//# sourceMappingURL=use-assistant.js.map

package/dist/cjs/use-assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assistant.js","sourceRoot":"","sources":["../../src/use-assistant.ts"],"names":[],"mappings":"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"}

package/dist/cjs/use-stream.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * useStream Hook
+ *
+ * React hook for generic text streaming with state management.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStream = useStream;
+const react_1 = require("react");
+/**
+ * useStream - React hook for generic text streaming.
+ *
+ * Provides state management for streaming text from various sources
+ * including fetch responses, ReadableStreams, and async iterables.
+ *
+ * @example
+ * ```tsx
+ * import { useStream } from 'ai.matey.react.hooks';
+ *
+ * function StreamingComponent() {
+ *   const { text, isStreaming, startStream, stop } = useStream({
+ *     onComplete: (fullText) => console.log('Completed:', fullText),
+ *   });
+ *
+ *   const handleClick = async () => {
+ *     const response = await fetch('/api/stream');
+ *     await startStream(response);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleClick} disabled={isStreaming}>Start</button>
+ *       <button onClick={stop} disabled={!isStreaming}>Stop</button>
+ *       <pre>{text}</pre>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useStream(options = {}) {
+    const { onChunk, onComplete, onError, initialText = '' } = options;
+    // State
+    const [text, setText] = (0, react_1.useState)(initialText);
+    const [isStreaming, setIsStreaming] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(undefined);
+    // Refs
+    const abortControllerRef = (0, react_1.useRef)(null);
+    const textRef = (0, react_1.useRef)(initialText);
+    /**
+     * Stop streaming.
+     */
+    const stop = (0, react_1.useCallback)(() => {
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+            abortControllerRef.current = null;
+        }
+        setIsStreaming(false);
+    }, []);
+    /**
+     * Reset state.
+     */
+    const reset = (0, react_1.useCallback)(() => {
+        stop();
+        setText(initialText);
+        textRef.current = initialText;
+        setError(undefined);
+    }, [initialText, stop]);
+    /**
+     * Start streaming from a fetch Response.
+     */
+    const startStream = (0, react_1.useCallback)(async (response) => {
+        if (!response.body) {
+            throw new Error('Response body is null');
+        }
+        return startReadableStream(response.body);
+    }, []);
+    /**
+     * Start streaming from a ReadableStream.
+     */
+    const startReadableStream = (0, react_1.useCallback)(async (stream) => {
+        try {
+            setIsStreaming(true);
+            setError(undefined);
+            setText('');
+            textRef.current = '';
+            // Create abort controller
+            abortControllerRef.current = new AbortController();
+            const reader = stream.getReader();
+            const decoder = new TextDecoder();
+            while (true) {
+                // Check if aborted
+                if (abortControllerRef.current?.signal.aborted) {
+                    reader.cancel();
+                    break;
+                }
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                const chunk = decoder.decode(value, { stream: true });
+                textRef.current += chunk;
+                setText(textRef.current);
+                onChunk?.(chunk);
+            }
+            onComplete?.(textRef.current);
+            return textRef.current;
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                return textRef.current;
+            }
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            onError?.(error);
+            throw error;
+        }
+        finally {
+            setIsStreaming(false);
+            abortControllerRef.current = null;
+        }
+    }, [onChunk, onComplete, onError]);
+    /**
+     * Start streaming from an async iterable.
+     */
+    const startAsyncIterable = (0, react_1.useCallback)(async (iterable) => {
+        try {
+            setIsStreaming(true);
+            setError(undefined);
+            setText('');
+            textRef.current = '';
+            // Create abort controller
+            abortControllerRef.current = new AbortController();
+            for await (const chunk of iterable) {
+                // Check if aborted
+                if (abortControllerRef.current?.signal.aborted) {
+                    break;
+                }
+                textRef.current += chunk;
+                setText(textRef.current);
+                onChunk?.(chunk);
+            }
+            onComplete?.(textRef.current);
+            return textRef.current;
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                return textRef.current;
+            }
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            onError?.(error);
+            throw error;
+        }
+        finally {
+            setIsStreaming(false);
+            abortControllerRef.current = null;
+        }
+    }, [onChunk, onComplete, onError]);
+    return {
+        text,
+        isStreaming,
+        error,
+        startStream,
+        startReadableStream,
+        startAsyncIterable,
+        stop,
+        reset,
+        setText,
+    };
+}
+//# sourceMappingURL=use-stream.js.map

package/dist/cjs/use-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stream.js","sourceRoot":"","sources":["../../src/use-stream.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAwEH,8BA0JC;AAhOD,iCAAsD;AAwCtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,SAAS,CAAC,UAA4B,EAAE;IACtD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEnE,QAAQ;IACR,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAA,gBAAQ,EAAS,WAAW,CAAC,CAAC;IACtD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,EAAU,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAoB,SAAS,CAAC,CAAC;IAEjE,OAAO;IACP,MAAM,kBAAkB,GAAG,IAAA,cAAM,EAAyB,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAA,cAAM,EAAS,WAAW,CAAC,CAAC;IAE5C;;OAEG;IACH,MAAM,IAAI,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC5B,IAAI,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAC/B,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnC,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;QACpC,CAAC;QACD,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP;;OAEG;IACH,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC7B,IAAI,EAAE,CAAC;QACP,OAAO,CAAC,WAAW,CAAC,CAAC;QACrB,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC;QAC9B,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IAExB;;OAEG;IACH,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,KAAK,EAAE,QAAkB,EAAmB,EAAE;QAC5E,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP;;OAEG;IACH,MAAM,mBAAmB,GAAG,IAAA,mBAAW,EACrC,KAAK,EAAE,MAAkC,EAAmB,EAAE;QAC5D,IAAI,CAAC;YACH,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,QAAQ,CAAC,SAAS,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;YAErB,0BAA0B;YAC1B,kBAAkB,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;YAEnD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAElC,OAAO,IAAI,EAAE,CAAC;gBACZ,mBAAmB;gBACnB,IAAI,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/C,MAAM,CAAC,MAAM,EAAE,CAAC;oBAChB,MAAM;gBACR,CAAC;gBAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAE5C,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM;gBACR,CAAC;gBAED,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;gBACzB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACzB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YAED,UAAU,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACtD,OAAO,OAAO,CAAC,OAAO,CAAC;YACzB,CAAC;YAED,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;QACpC,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAC/B,CAAC;IAEF;;OAEG;IACH,MAAM,kBAAkB,GAAG,IAAA,mBAAW,EACpC,KAAK,EAAE,QAA+B,EAAmB,EAAE;QACzD,IAAI,CAAC;YACH,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,QAAQ,CAAC,SAAS,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;YAErB,0BAA0B;YAC1B,kBAAkB,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;YAEnD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBACnC,mBAAmB;gBACnB,IAAI,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/C,MAAM;gBACR,CAAC;gBAED,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;gBACzB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACzB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YAED,UAAU,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACtD,OAAO,OAAO,CAAC,OAAO,CAAC;YACzB,CAAC;YAED,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;QACpC,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAC/B,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,WAAW;QACX,KAAK;QACL,WAAW;QACX,mBAAmB;QACnB,kBAAkB;QAClB,IAAI;QACJ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/cjs/use-token-count.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * useTokenCount Hook
+ *
+ * React hook for estimating token counts.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_TOKEN_LIMITS = void 0;
+exports.useTokenCount = useTokenCount;
+exports.getModelTokenLimit = getModelTokenLimit;
+const react_1 = require("react");
+/**
+ * Default tokenizer using rough estimation.
+ *
+ * Uses ~4 characters per token as a rough estimate,
+ * which is approximately accurate for GPT models with English text.
+ */
+function defaultTokenizer(text) {
+    if (!text)
+        return 0;
+    // More sophisticated estimation:
+    // - Count words (average ~1.3 tokens per word)
+    // - Count special characters/punctuation (often separate tokens)
+    // - Account for whitespace
+    const words = text.split(/\s+/).filter(Boolean);
+    const wordTokens = words.length * 1.3;
+    // Count punctuation and special characters
+    const punctuation = (text.match(/[.,!?;:'"()\[\]{}<>@#$%^&*+=|\\/-]/g) || []).length;
+    // Count numbers as separate tokens
+    const numbers = (text.match(/\d+/g) || []).length;
+    return Math.ceil(wordTokens + punctuation * 0.5 + numbers);
+}
+/**
+ * useTokenCount - React hook for estimating token counts.
+ *
+ * Provides real-time token estimation for text input,
+ * useful for staying within model context limits.
+ *
+ * @example
+ * ```tsx
+ * import { useTokenCount } from 'ai.matey.react.hooks';
+ *
+ * function TokenCounter() {
+ *   const [text, setText] = useState('');
+ *   const { tokenCount, characterCount, wordCount } = useTokenCount({ text });
+ *
+ *   return (
+ *     <div>
+ *       <textarea value={text} onChange={(e) => setText(e.target.value)} />
+ *       <p>Tokens: ~{tokenCount} | Words: {wordCount} | Characters: {characterCount}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useTokenCount(options = {}) {
+    const { text = '', model: _model, // Reserved for future model-specific tokenizers
+    tokenizer = defaultTokenizer, debounceMs = 100, } = options;
+    const [tokenCount, setTokenCount] = (0, react_1.useState)(0);
+    const [isEstimating, setIsEstimating] = (0, react_1.useState)(false);
+    // Character count (memoized)
+    const characterCount = (0, react_1.useMemo)(() => text.length, [text]);
+    // Word count (memoized)
+    const wordCount = (0, react_1.useMemo)(() => {
+        if (!text.trim())
+            return 0;
+        return text.split(/\s+/).filter(Boolean).length;
+    }, [text]);
+    // Count tokens function
+    const countTokens = (0, react_1.useCallback)((inputText) => {
+        return tokenizer(inputText);
+    }, [tokenizer]);
+    // Debounced token counting effect
+    (0, react_1.useEffect)(() => {
+        if (!text) {
+            setTokenCount(0);
+            return;
+        }
+        setIsEstimating(true);
+        const timeoutId = setTimeout(() => {
+            const count = countTokens(text);
+            setTokenCount(count);
+            setIsEstimating(false);
+        }, debounceMs);
+        return () => {
+            clearTimeout(timeoutId);
+        };
+    }, [text, countTokens, debounceMs]);
+    return {
+        tokenCount,
+        characterCount,
+        wordCount,
+        isEstimating,
+        countTokens,
+    };
+}
+/**
+ * Model-specific token limits.
+ */
+exports.MODEL_TOKEN_LIMITS = {
+    'gpt-4': 8192,
+    'gpt-4-32k': 32768,
+    'gpt-4-turbo': 128000,
+    'gpt-4o': 128000,
+    'gpt-3.5-turbo': 16385,
+    'claude-3-opus': 200000,
+    'claude-3-sonnet': 200000,
+    'claude-3-haiku': 200000,
+    'gemini-pro': 30720,
+    'gemini-1.5-pro': 1000000,
+    'command-r': 128000,
+    'command-r-plus': 128000,
+    'mixtral-8x7b': 32768,
+    'llama-3-70b': 8192,
+    'llama-3.1-405b': 128000,
+};
+/**
+ * Get token limit for a model.
+ */
+function getModelTokenLimit(model) {
+    // Try exact match
+    if (exports.MODEL_TOKEN_LIMITS[model]) {
+        return exports.MODEL_TOKEN_LIMITS[model];
+    }
+    // Try prefix match
+    for (const [key, value] of Object.entries(exports.MODEL_TOKEN_LIMITS)) {
+        if (model.startsWith(key) || model.includes(key)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=use-token-count.js.map

package/dist/cjs/use-token-count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-token-count.js","sourceRoot":"","sources":["../../src/use-token-count.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+/**
+ * AI Matey React Hooks
+ *
+ * Additional specialized React hooks for AI applications.
+ *
+ * @packageDocumentation
+ */
+// Hooks
+export { useAssistant } from './use-assistant.js';
+export { useTokenCount, getModelTokenLimit, MODEL_TOKEN_LIMITS } from './use-token-count.js';
+export { useStream } from './use-stream.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}